dsh-status-flair
DSH 网页插件：事件驱动的运行状态、自定义事件组、实时输出阶段、独立的外观/文本轮换，以及 DSH 原生默认设置。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:AkotaP/dsh-status-flair#cbc45bee815817c424728d43071654f8cd85a1ee
Status Flair 以 dsh-status-flair 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
当前插件版本：0.4.0（未发布）。
0.4.0 把大块配置迁到插件独立文件，并加入导入与备份。实际 profile 不会自动迁移，见迁移说明。
DSH（DeepSeek Harness）Web 运行状态装扮插件。
把对话里那条运行状态（深度求索中，用时 7秒 ···）换成自己定义的样子：文案、颜色、字号、图标、扫光节奏。
不重写聊天组件，也不改 DSH 安装目录：外观走注入的 CSS，文案走对 LocaleRuntime#translate 的一层包装。
| 层 | 官方来源（DSH 0.2.1-rc.2） | 本插件的做法 |
|---|---|---|
| 文案 | @deepseek-ai/dsh-client-ui-chat 的 chat.deepDiving / chat.deepDivingFor | 包装 locale.translate，只拦截这两个 key |
| 颜色 | .running 的 color: var(--dsw-alias-label-deep-diving) | 在 [data-chat-running] 上重设颜色与 --dsw-alias-label-shimmer |
| 字号 | .running 的 font-size: calc(var(--dsh-content-font-size) - 2px) | 覆盖 font-size，图标尺寸跟着字号走 |
| 图标 | 60 帧 APNG 当 mask（3 秒循环）+ 静态 SVG 降级 | 隐藏两层，容器自身用遮罩画预设图标（内置 SVG / 官方 APNG / 自定义 SVG·PNG） |
| 扫光 | TextShimmer 的 _dsh-row-shimmer-* 关键帧（1.5s，steps(48)，延迟 .3s） | 覆盖 animation-duration / play-state；0ms 即关闭 |
选择器只用稳定钩子：[data-chat-running]、[data-shimmer]、:has(> [data-shimmer])。构建期哈希类名（xz4KEq_、_1rdzk_）一律不用。
外观、文案组与组内句子独立选择，因此可以同时使用随机外观和随机文案。
切换时机：外观与文案分别配置全局 triggers。默认每轮抽取一次；也可开启固定/随机时间间隔或每 N 个步骤重新抽取。关闭某层的每轮触发后，该层保留上次选择，直到其它触发条件成立。开启事件策略后，匹配规则还可改变当前使用的选择策略。
外观和文案各有一个 default（UI 里叫「默认（DSH 自带）」）。
default 时，插件一个 CSS 变量都不设、<html> 标记也摘掉，运行行完全由 DSH 自己渲染。default 时，translate 原样放行，直接显示 DSH 自己的 chat.deepDivingFor。--dsw-alias-label-deep-diving、--dsh-content-font-size 与官方 locale 字符串；默认外观的预览还会从 DSH 注入的样式表里取出官方鲸鱼遮罩（APNG data URL），连动画一起还原。0.3.0 增加事件规则、自定义分组和实时输出状态。现有截图为旧版界面示意，不代表新的同级页签和规则操作布局。
activity）**沿用 DSH 原生活动的 14 类：thinking、read、readImage、search、write、edit、commands、code、webSearch、webFetch、subagents、plan、questions、tools。pulse）**表示工具结果：tool-error 或 tool-success。builtin:<活动类别>，结果组为 builtin:tool-error、builtin:tool-success；不写入 eventGroups。id、name、kind、activityKinds、toolNames、events。活动组按「原生类别命中 或 具体工具名命中」匹配；工具名为精确匹配。短暂提示组按结果类型匹配，填写工具名时进一步限制到这些工具。kind 必须相同，不能将活动组与结果组混用。未知扩展工具通常归入 tools；需要单独区分时，使用带具体工具名的自定义组，而非假设工具名会自动映射成原生类别。工具活动从当前 Chat 快照的 legacy.runningCalls 读取，并递归检查正在运行的 PTC 子调用。配置区显示「已识别的工具活动」，可用于区分没有识别到工具、规则顺序覆盖和插件工具尚未分组。外层代码执行与内层读取同时存在时，仍按规则顺序取首条匹配项；非常短的子调用可能被最短刷新间隔合并。插件工具名不硬编码为原生能力，应按实际工具名配置自定义分组。
运行中没有工具执行时，使用三个可直接选取的内置组：
builtin:waiting（等待响应）：尚无当前输出证据，或输出块、尝试、步骤已经结束。builtin:thinking（思考中）：当前尝试收到非空白的显式推理增量；不推测模型内部思考。builtin:responding（回复中）：当前尝试收到非空白的可见正文增量；包括过程说明，不保证是最终答案。状态读取当前主会话已有来源中的实时增量，不用历史正文或 partial.blocks 的尾块猜测。块结束、finish、消息结算、重试和会话切换会清除证据；首次接入和重连后先等待新信号。短暂的 token 间隙不使用额外超时猜测状态。工具仍在执行时继续按工具类别匹配。
自定义活动组的 activityKinds 也可以包含 waiting 和 responding。thinking 不再表示所有“无工具”状态；需要覆盖所有无工具状态时，在规则中同时选择这三个组。
规则按列表顺序取首条已启用且有效的匹配项，不叠加多条规则；同一规则引用的多个组按「或」匹配。没有匹配规则时使用全局 selection。
每条规则包含 id、name、enabled（默认 true）、kind、groupIds、holdMs（默认 2000ms）和完整 selection：
presetMode、fixedPresetId、presetIds；textPresetMode、fixedTextPresetId、textPresetIds；textMode（first / random / sequential）。规则复用现有外观和文案预设，也保留 default 官方哨兵，不复制官方素材。规则不单独配置触发器，统一继承全局 triggers；holdMs 控制短暂提示的匹配有效期，minRefreshMs 控制事件驱动切换的最小刷新间隔，默认 3000ms（3 秒），不是每 3 秒固定切换。显式保存的间隔不会被默认值覆盖。规则顺序决定优先级，需要优先显示的结果规则应放在可能同时命中的活动规则之前。
同一会话轮次中，状态行短暂卸载或重建不会重置规则计时，也不会重新抽取文案。只要共享来源仍有活动轮次，结束与清理由真实会话事件决定；缺少该来源时才使用状态行消失作为降级边界。
顶层以「默认选择」和「事件规则与分组」同级切换，默认打开前者。切换页签只改变显示，不改变启用状态或丢弃草稿；切换时机、预览和预设库为两页共用。规则收起时仍可启用、上移和下移，展开后编辑具体配置。
新配置默认提供四条可编辑的入门规则，总开关仍然关闭：
| 规则 | 事件范围 |
|---|---|
| 思考与交互 | 等待、显式思考、提问、待办与目标 |
| 信息获取 | 读取文件和图片、搜索、网页搜索及获取 |
| 执行与操作 | 写入、编辑、命令、代码、子代理、其他工具 |
| 回复 | 可见正文输出，包括过程说明 |
四条入门规则的外观与文案均固定使用 DSH 自带项（default），不复制当前全局选择；彼此独立，可展开调整。已有规则及显式保存的空列表 rules: [] 均不会被覆盖。「添加入门规则」按固定 ID 仅补缺少的入门项：没有时添加四条，已有两条入门规则时只补两条，齐全后按钮禁用。自定义规则不计入这四条，也不会被覆盖；已有入门规则改名后仍可识别，不重复添加。新增项仍使用 DSH 自带外观与文案，总开关保持不变。内置入门名称随界面语言显示，手动改名后保留自定义名称。
以下只示意独立文件内 flair 数据中的事件字段，不是 DSH 主配置或可直接覆盖内部文件的完整文档。省略 rules 会补入四条规则，旧配置不会自动开启事件策略：
{
"eventGroups": [],
"eventRules": { "enabled": false, "minRefreshMs": 3000 }
}
事件处理仅使用当前主会话的现有共享事件源，不新开 follow，也不增加宿主会话订阅。历史记录与重连恢复不重放工具结果的短暂提示。事件源不可用时保留原有全局策略。
配置入口为插件页的「事件规则与分组」：在「事件规则」中添加规则、用上移/下移设置优先级；在「管理分组」中复制内置组或新建自定义组。具体工具名每行一个，离开输入框时应用。被规则引用的分组必须先解除引用才能删除。试抽仅更新本地预览，不推进真实顺序游标。
tool-error / tool-success 以 DSH 的结构化工具错误标记为准，不解析命令输出；例如命令退出码非零不一定被 DSH 标为工具异常。
分组与规则同样遵守页内草稿和显式保存：编辑不等于落盘，只有「保存修改」写入配置；放弃或离开页面撤回未保存内容。健康路由仅增加自定义分组数量及规则总数、启用数量和总开关摘要，不返回分组或规则内容。
<svg>…</svg> 或上传 SVG / 透明 PNG。图标作为遮罩使用，只取 alpha 形状，颜色自动跟随预设配色；上传内容会清掉脚本、事件属性与外部引用。.png 即可）或改用 SVG。文案里可以写 DSH 原生模板语法：
{duration} —— 替换成 DSH 算好的用时（7秒 / 7s，跟着界面语言）；{name} 原样保留。例：正在深度求索 {duration} → 「正在深度求索 7秒」，用时每秒更新。
插件内置 zh / en 两套字典，界面语言跟随 DSH 的语言设置。出厂预设名（暖金色 / 梦幻紫 / 终端绿）、图标名、新建文案的默认句都会跟着翻译；用户自己改过的预设名保持原样，不会被翻译覆盖。
插件 → 本插件页面（设置 → 插件 → 状态装扮）。面板直接渲染在插件页上：
当前开发版通过 DSH 认证的插件接口保存到 <profile-dir>/dsh-status-flair/settings.json。首次保存会保留原始迁移备份并补上轻量 storage: file 标记；旧 flair 只读兼容，不再作为 volatile 写入目标。只有明确确认迁移后，才尝试清理本插件的旧主配置块。
数据区支持把当前配置备份成文件，以及导入他人分享的配置。迁移前界面会提示先手动备份。导入只识别本插件的外观、文案与规则，内容先进入页内草稿并显示数量摘要，确认后再点「保存修改」才落盘；坏 JSON 或其它插件的文档会被拒绝且不改变现有草稿。自定义图标以 data:image/...;base64 内嵌在配置里，导出文件自带图片字节，不含本地文件路径。写入失败或跨页面版本冲突会显示错误并保留草稿；损坏文件不会自动重置。仅修改仓库代码不会自动执行真实迁移。详见迁移说明。
安装会改动
%USERPROFILE%\.dsh下的 profile 配置，并且需要重启 DSH（重启会打断正在跑的会话）。请确认后执行。
仓库：https://github.com/AkotaP/dsh-status-flair
在「插件」页里装：侧边栏「插件」→「添加插件」，填入仓库地址 https://github.com/AkotaP/dsh-status-flair（同一个输入框也接受本地目录绝对路径和 tarball；发布到 npm 后也可以直接填包名 dsh-status-flair）。DSH 会先用 git ls-remote 探一次仓库再交给 pnpm，装完在列表里确认它是启用状态。
一条命令（等价写法）：
dsh plugin --profile desktop add https://github.com/AkotaP/dsh-status-flair
# 发布到 npm 之后可以直接用包名：dsh plugin --profile desktop add dsh-status-flair
让 agent 装（把下面这段发给 DSH 里的 agent）：
把这个仓库装进当前 DSH 的 desktop profile：
https://github.com/AkotaP/dsh-status-flair。用侧边栏「插件」页的「添加插件」，或dsh plugin --profile desktop add https://github.com/AkotaP/dsh-status-flair。装完确认 profile 的dsh.profile.bundles里已经有dsh-status-flair，然后先问我再重启 DSH，重启后确认插件页的「状态装扮」能打开配置面板。
本地开发（以 link 方式装进某个 profile，源码改动实时生效）：见下面的开发一节。
装好后重启 DSH，插件页的「状态装扮」里出现配置面板。卸载：侧边栏「插件」页里卸载，或 dsh plugin --profile desktop remove dsh-status-flair（并确认 dsh.profile.bundles 里已移除该项）。
<html> 挂标记并写几个 CSS 变量，DSH 自己的组件照常工作。默认外观时连标记都不挂。translate 包装：只拦截 chat.deepDiving / chat.deepDivingFor，其它 namespace/key 原样透传；默认文案时直接放行。GET /status-flair/health 仍仅返回摘要。presets[].texts 在首次读取时自动迁移成独立 textPresets；golden 预设的旧名「暖金色思考」会自动改名为「暖金色」。# 离线测试：假 DOM + 假 ctx + 迷你 React
node --test --test-isolation=none
沙箱环境必须带 --test-isolation=none（默认的每文件子进程走管道会被沙箱拒绝）。
以 link 方式装进 profile 做真机调试：
# profile 目录下
pnpm add link:<仓库绝对路径>
# 然后把 "dsh-status-flair" 追加到 profile package.json 的 dsh.profile.bundles，
# 改一次 cordis.patch.yml 内容触发热重组（HMR 比对内容，touch 无效）。
产物：lib/index.js（宿主半：Config schema + 只读健康路由）、lib/client.js（浏览器 bundle）。改 lib/client.js 由 client-hmr 轮询热更，页面不用刷新；改 lib/index.js 需要一次 profile 重组。
版本历史见 CHANGELOG.md。
>=20>=0.2.1-rc.2@deepseek-ai/dsh-client-ui-settings