前言¶

在 DSH Web 中，模型或智能体工作期间会显示 turnStatus 状态文字。DSH 支持插件扩展，dsh-turn-status-phrases 用于把这段状态文字替换为持续变化的自定义轮次状态短语。

插件定位¶

• 插件名称：dsh-turn-status-phrases
• 维护者：57ggfk
• 类型：DSH Web plugin / Cordis bundle
• 许可证：MIT
• 作用：让 DSH Web 的 turnStatus 状态文字显示不断变化的轮次状态短语。

核心功能¶

模型或智能体工作期间，状态文字会在短语之间轮换：

• 轮换时长按短语的 UTF-8 字节数计算，每字节 100 毫秒。
• 最短 1.8 秒，最长 8 秒。
• 不会连续显示同一句。

内置词库包括：

• “中国神话”：包含嫦娥奔月、精卫填海、夸父逐日、后羿射日、女娲补天等。
• “Claude Code”：收录 Claude Code CLI 的 187 条 spinner 状态词，如 Pondering、Noodling、Musing 等。

设置页支持：

• 切换词库。
• 暂停动态短语。
• 查看可复制的词库内容。

自定义词库编辑功能正在开发中。

安装与启用¶

在插件目录执行：

dsh plugin --profile web add .

重启 DSH Web 后，在设置中打开“轮次状态短语”。默认词库为“中国神话”。

典型用法¶

1、在设置页选择词库，例如“中国神话”或“Claude Code”。

2、在模型或智能体工作期间观察 turnStatus 状态文字按短语轮换。

3、如需暂时关闭动态效果，在设置页暂停动态短语。

4、如需使用某条短语，可查看设置页中的词库内容并复制。

新增内置词库¶

每个内置词库在 lib/builtin-libraries/ 中独占一个模块文件。新增词库时，先创建词库模块，再注册到列表，最后构建和测试客户端数据。

1、创建 lib/builtin-libraries/<library-id>.js，默认导出 id、name 和 phrases：

export default {
  id: "example-library",
  name: "Example Library",
  phrases: ["First phrase", "Second phrase"]
};

2、在 lib/builtin-libraries/index.js 导入模块，并将其加入 BUILTIN_LIBRARY_LIST。词库在设置页中的显示顺序与该数组一致；默认词库由列表首项决定。

3、执行 npm run build，从注册表更新 lib/client.js 中供 DSH Web 加载的内置词库数据。不要手动编辑该生成区块。

npm run build

4、执行 npm test；它会再次构建客户端数据，并验证词库注册表及短语逻辑。

npm test

内置词库更新后重新安装或更新插件，并刷新 DSH Web 页面即可生效。

使用注意¶

• 配置只保存在当前浏览器本地，不上传网络。
• 插件的 peerDependencies 要求 @deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-slots、@deepseek-ai/dsh-client-locale 和 react ^18.2.0。
• 插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证。

链接¶

• 目录页（来自插件线索）：https://www.skillhub.cn/plugins/57ggfk/dsh-turn-status-phrases
• GitHub：https://github.com/57ggfk/dsh-turn-status-phrases
• 目录页为社区插件页，不等同于官方应用商店。