dsh-you-should-know：DeepSeek Harness 任务运行中的提醒插件

在 DeepSeek Harness (DSH) 中开发任务时，随着对话的推进，关键约束或背景信息容易被淹没。dsh-you-should-know 是一个任务提醒插件，它会在任务运行期间观察对话上下文，并提示你注意那些可能被遗漏的重要事实、权衡和背景知识。

核心功能¶

该插件通过一个悬浮面板提供交互，不推挤对话内容。

1. 悬浮面板：位于输入框上方，包含最小化控制，不会改变对话内容的滚动位置。
2. 解释按需：可以查看为什么一条笔记很重要，或者将已熟悉的主题标记为“已理解”，以减少重复提醒。
3. 继续讨论：将笔记和解释带入选定的主会话中，便于继续深入探讨，且不会覆盖现有的草稿或附件。
4. 配置项：
   • 语言：跟随系统或指定中文/英文。
   • 观察者模型：独立选择模型，不改变主会话模型。
   • 检查频率：默认每 6 个模型步长检查一次。
   • 单轮限制：控制单轮对话显示笔记的最大数量。
   • 主题历史：管理“已见”和“已知”列表，避免重复提醒。
5. 自动观察：默认启用，观察者会跟随主会话的模型运行。

安装与启用¶

安装前请确保环境满足要求：
* DeepSeek Harness: >=0.2.0-rc.2 <0.3.0-0
* Node.js: >=22.19.0

从源码构建并安装¶

1. 克隆仓库并构建安装包：

    git clone https://github.com/lolipop-1x1/dsh-you-should-know.git
    cd dsh-you-should-know
    npm ci
    npm run check
    npm pack

这将生成 `dsh-you-should-know-0.1.0.tgz` 文件。

2. 将生成的包添加到 Harness 配置文件：

    dsh plugin --profile web add -w /absolute/path/dsh-you-should-know-0.1.0.tgz

将 `web` 替换为你的配置文件名称，并将路径替换为实际的绝对路径。

3. 重启 Harness 后，进入 Settings → You Should Know 确认插件已加载。

典型用法¶

启动任务后，插件会自动运行观察。请注意，短任务通常不会触发检查，且并非每个回合都会显示笔记。

在悬浮面板中，你可以执行以下操作：

• Learn more：查看笔记的理由和影响。如果存在相同语言的解释，会复用现有解释。
• Knew this already / Understood：将当前话题标记为已知，减少后续重复提醒。
• Chat in main session：将笔记和解释插入主会话。仅当当前没有草稿或附件时才会执行，发送动作由用户手动触发。
• Dismiss：关闭笔记并提供反馈选项。
• Minimize / Open note：仅切换面板显示状态，不提交反馈或标记已理解。

注意事项与限制¶

1. 性质定位：笔记并非事实核查或执行审查，它们可能遗漏重要细节或包含不准确信息。仅在需要进一步讨论时将其带入主会话。
2. 检查逻辑：
   • 检查次数按“用户-任务”回合单独计数。插件重新加载不会重置当前回合的计数。
   • 检查频率基于模型步长（非单个工具调用）。
3. 跳过场景：以下情况会跳过检查：子代理会话、无在线显示的会话、已存在笔记、检查正在进行中、该回合已显示过笔记、或处于主动忽略退避中。
4. 退避机制：
   • 未展开的笔记在收到两个有效用户输入后会关闭。
   • 如果连续三次忽略笔记，退避序列将从 1、2、4、8 开始，最多跳过 16 次检查。用户的主动交互会重置退避。
5. 去重与清理：
   • 主题去重取决于模型对相同话题不同表述的识别能力，无法保证完全去重。
   • 清理主题历史需要确认，且仅影响选中的列表。清除一个列表不会保证该主题在另一个列表中出现。
   • 清理后，该话题在当前会话中仍可能以不同形式再次出现。

总结¶

dsh-you-should-know 通过后台独立的观察模型，在任务运行时保持对上下文的敏感度，帮助开发者保持对关键信息的关注。对于需要处理复杂逻辑或多轮对话的 DSH 任务，这是一个辅助保持上下文连贯性的工具。

更多详情与源码，请访问：GitHub 仓库