前言¶
在 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
- 目錄頁爲社區插件頁,不等同於官方應用商店。