任务提醒 lolipop-1x1/dsh-you-should-know

You Should Know：在任务进行时，提醒值得了解的事实与方案取舍

You Should Know

English · 简体中文

DeepSeek Harness 的任务提醒插件。在任务进行时，观察已有会话中的重要事实、方案取舍和必要知识，帮助你理解可能遗漏的事项。

- 简短提醒：在输入框上方悬浮展示，可收起，不挤占聊天内容。
- 按需解释：展开了解原因和影响；已经知道的主题可以标记为已了解。
- 继续讨论：把提醒和解释带回主会话，保留已有草稿和附件，由你决定是否发送。
- 自主设置：选择语言、观察模型、检查频率和每轮上限，管理跨会话主题记录。

中文提醒与展开解释：Promise.all 不会回滚已成功的远程写入

实际 Harness 验收截图，使用虚构任务。头图为 AI 生成的概念插画。

安装 · 使用 · 设置 · 工作方式 · 用量与数据 · 开发与贡献

安装

环境要求

| 项目 | 要求 |
| DeepSeek Harness | >=0.2.0-rc.2 <0.3.0-0 |
| Node.js | >=22.19.0 |
| 界面 | Web，以及使用相同会话输入区的桌面端 |

开发依赖锁定在 0.2.0-rc.2，CI 同时覆盖 0.2.0-rc.2 与 0.2.1-alpha.1。兼容声明覆盖 0.2 系列；其他版本仍可能存在预览 API 差异，0.3 系列尚不支持。没有可展示输入区的 profile 不自动观察。

从源码构建安装包

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

将生成的安装包添加到你的 Harness profile：

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

将 web 替换为实际 profile 名称，并修改安装包的绝对路径。-w 允许 pnpm 在 profile 的 workspace 根安装。桌面端可使用其插件安装入口或随附 CLI。

安装后重启目标 Harness profile，让宿主加载插件的服务端与客户端模块。打开 设置 → You Should Know 确认插件已加载。

已构建的安装包无需在安装时编译源码。通过 Git 地址安装源码时，prepare 会安装开发依赖并构建；pnpm 10 及以上可能需要为本包单独授权构建。

使用

自动观察默认开启，观察模型默认跟随主会话。已保存的设置会继续保留。正常发起任务即可；短任务通常不会触发检查，也不会保证每轮都有提醒。

| 操作 | 结果 |
| 展开解释 | 查看事项的原因与实际影响；优先复用已生成的同语言解释 |
| 已经知道 / 已了解 | 保存主题，减少后续重复提醒 |
| 带回主会话 | 输入框没有草稿或附件时，填入提醒和解释；由你发送 |
| 关闭 | 关闭提醒，并短暂提供反馈选项 |
| 收起 / 再次展开 | 改变浮层显示，不提交反馈或标记已了解 |

提醒用于帮助理解任务，并非事实核验或执行审查。它可能遗漏重要事项，也可能判断不准确；需要时可带回主会话进一步讨论。

设置

在 设置 → You Should Know 中调整，下列设置会自动保存。

| 设置 | 默认值 | 可选项 |
| 自动观察 | 开启 | 开启、关闭 |
| 语言 | 跟随系统 | 跟随系统、中文、English |
| 观察模型 | 跟随主会话模型 | 独立选择 Harness 已配置的模型 |
| 观察步长 | 6 个模型步骤 | 6、12、18 或自定义正整数 |
| 每轮检查次数上限 | 不限（0） | 不限、1、3、5 或自定义非负整数 |
| 主题记录 | 已展示、已了解各最多 50 条 | 分别查看、刷新和确认清空 |

You Should Know 设置菜单：语言、模型、步长、检查上限与主题记录

菜单示例选用了 GPT-6-Luna、每轮最多检查 1 次，并关闭了自动观察；出厂默认值见上表。

语言控制插件菜单及后续提醒、解释的提示词。“跟随系统”使用 Harness 当前界面语言，中文界面使用简体中文，其余语言使用英文。已有提醒保留原文。单独选择观察模型不会改变主会话模型。

两类主题记录跨会话共享，都会参与去重。清空需要确认，只处理所选列表，保留另一类记录和当前提醒。因此清空一类记录不保证相同主题再次出现；不同措辞的主题还需要模型判断，不能保证完全去重。

工作方式

1. 取得上下文：在主会话的模型请求扩展点获取完整请求快照，包含系统提示、用户消息、助手回答、已有工具调用与结果，以及工具声明。
2. 按步长检查：默认在每轮第 7、13、19 等模型步骤获得检查机会。一个模型步骤可能包含多个工具调用，工具调用本身不单独计步；开始新轮后重新计步。
3. 独立判断：复制主请求，再追加观察提示词作为最后一条用户消息，包含提醒规则、已展示和已了解的主题。观察在后台执行，主任务继续运行。
4. 选择性展示：没有值得提醒的事项时保持安静。同一轮最多展示一条提醒；用户可以展开、反馈或带回主会话。

观察者只读取已有上下文，不运行工具、不读取新文件，也不把观察请求和响应写入主会话记录。跟随模型时保留请求前缀，方便提供方尝试复用缓存；实际缓存命中和费用取决于提供方。

检查上限、跳过条件与忽略退避

- 每轮用户任务独立计算检查次数；实际发起的检查即使失败、取消或没有提醒也计入。展开解释不计入，重载插件不会清零本轮次数。
- 一次检查最多进行两次模型生成，因此“检查次数上限”不等于模型调用次数或 token 用量上限。
- 子 Agent 会话、没有在线展示界面、已有提醒、正在检查、当前轮已展示提醒，或处于忽略退避时，会跳过检查。轮次结束不会额外触发检查。
- 未展开的提醒经过两次有效用户输入后收起。连续忽略三次起，逐步跳过 1、2、4、8、16 次后续检查机会；主动交互重置退避。已展开的解释继续保留。
- 主动关闭后提供 20 秒反馈；开始新轮也会收起反馈。仅收起浮层不会被计为忽略。

用量与数据

自动观察会额外调用模型，即使没有展示提醒也可能产生用量。 当前固定使用完整会话上下文，不裁剪，也不额外生成摘要。可通过关闭自动观察、增大步长或设置每轮上限控制额外调用。缺少可用解释时，展开解释还会单独请求模型。取消请求不能保证远端停止计费。

插件通过 Harness 已配置的模型服务发起请求。选择独立观察模型时，完整上下文会发送给该模型提供方。插件不单独保存 API Key，不新增遥测，也不向外部上传反馈。

提醒、解释、主题与必要的交互状态保存在 Harness 存储域，路径和后端由宿主管理；完整请求快照仅保存在内存。提示词要求避免在提醒中复述凭证和个人信息，但这不会从发送给模型的完整上下文中移除这些内容。

开发与贡献

欢迎通过 Issues 提交问题或建议，通过 Pull Request 贡献改进。报告问题时，请提供 Harness 和插件版本、操作系统、profile、复现步骤及预期结果；去除凭证、私人会话和个人路径。

npm ci
npm run check

check 包含锁文件检查、类型检查、行为测试、构建与运行入口检查。修改客户端交互时，还可启动浏览器回归页面：

npm run test:browser

打开命令输出的地址，点击“运行回归”。默认端口为 3100，可通过 YSK_TEST_PORT 修改。此页面使用真实组件和模拟接口，不连接实际会话；模型质量、用量和实际宿主兼容性仍需在目标 Harness 中验证。

| 目录 | 职责 |
| src/core/ | 提示词、解析与状态规则 |
| src/host/ | 模型调用、调度与宿主接入 |
| src/client/ | 提醒浮层、设置菜单与中英文界面 |
| tests/ | 行为测试与客户端回归页面 |

完整约定见 贡献指南；行为规格、存储和高级配置见 设计文档。

许可证

本项目采用 MIT 许可证。