DeepSeek Harness (DSH) 的理念是「一切皆插件」。在本地運行或手動監控智能體時，經常會遇到長時間等待的情況。此時屏幕上只有進度條或空白的等待界面，缺乏反饋。dsh-crumbs 插件專門用於填補這段空白，在長時間任務運行時，顯示與當前任務相關的簡短、覈實過的事實。
功能概覽¶
該插件提供三種主要的使用方式，核心目標是「爲人類觀察者提供信息」，而非干擾智能體運行。
- 自動填充：當長時間工具調用（如 shell 命令）運行超過
minTaskMs時，每隔intervalMs顯示一個與當前任務相關的 crumb。 - 命令調用：通過
/crumb命令按需獲取事實。 - 工具調用：模型或流程可以通過
crumb工具直接獲取事實。
安裝¶
使用官方安裝命令添加插件：
dsh plugin add dsh-crumbs
配置與使用¶
插件默認開啓，所有配置均爲可選項。
環境變量¶
設置環境變量可以禁用自動顯示功能（命令和工具仍然可用）：
DSH_CRUMBS_DISABLE=1
配置文件¶
在項目根目錄的 .dsh/crumbs.config.json 中可以調整具體參數：
{
"autoSurface": true,
"minTaskMs": 8000,
"intervalMs": 12000,
"mode": "fact",
"source": "auto",
"longTools": ["bash", "shell", "exec", "run"]
}
autoSurface：是否在長時間任務中自動顯示。minTaskMs：觸發自動顯示的最小任務時長（毫秒）。intervalMs：自動顯示的間隔時間（毫秒）。mode：事實模式或問答模式。source：事實來源（pool, model, auto）。longTools：判定爲“長時間工具”的名稱列表。
命令與工具¶
-
命令：
*/crumb：獲取隨機事實。
*/crumb <topic>：獲取特定主題的事實，例如/crumb git或/crumb concrete。 -
工具：
* 模型可調用crumb工具，參數包括：topic（可選）：主題提示。mode："fact"或"quiz"。
事實來源與驗證¶
插件支持三種事實來源，其驗證狀態和表現形式不同：
- pool（池）：來自
data/crumbs.json的 curated（精心策劃）事實。這些事實已驗證，標記爲verified: true，顯示符號爲💡。它們是離線的，零成本。 - model（模型）：由 side model（旁路模型）實時生成。這些事實未經驗證，標記爲
verified: false，顯示符號爲✨。生成的 trivia 可能不準確。 - auto（自動）：優先使用模型生成，若模型不可用或返回爲空，則回退到 pool。
重要注意：
* 自動生成的 crumb 通過 ctx.logger 顯示，目前僅作爲日誌行出現，暫未集成到 Web UI 卡片中。
* 模型生成的 crumb（帶 ✨）不應被引用或作爲事實依據，僅供娛樂。
* 插件不觸碰代理上下文或結果，僅用於人類注視。
相關鏈接¶
- GitHub 倉庫：https://github.com/MeghanBao/dsh-crumbs
- 社區目錄：https://www.skillhub.cn/plugins/MeghanBao/dsh-crumbs
