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
