dsh-recheck:给项目结论绑定依据,依据变化后提醒复核

前言

在 DSH 里做智能体或工作流时,结论往往写在对话或笔记里,真正支撑结论的却是仓库里的若干文件。文件一改,旧结论是否还成立,通常要靠人工记起来再查一遍。Recheck 是社区维护的非官方 DSH 插件,把「结论」和「依据文件路径」绑在一起,在依据变化时提示复核,并在原生右侧栏里完成检查、阅读、选意见与历史导出;卡片侧操作不额外调用模型。

下面介绍插件定位、能力边界、安装方式与典型用法。安装命令与版本组合以仓库 README 与安装指南为准。

这是什么

Recheck(包名 dsh-recheck)由社区成员 InInNHD 独立开发与维护,在 SkillHub 目录中归类为工作流。当前正式版本为 0.1.0(MIT License)。维护者说明:原计划的 3 名用户、各一周真实项目试用尚未完成;2026-10-14 起按已有技术验收范围发布 0.1.0,版本号不表示试用目标已达成。

插件提供 recheck 工具与 DSH 原生右侧栏 UI,核心行为是:为项目结论绑定 1–8 个相对路径作为依据,执行「检查 → 阅读 → 选择复核意见 → 保存」,并保留复核历史。数据仅存于项目 .dsh/recheck/cards.json,不存依据正文,不发送业务网络请求,也不自动跑测试或判定结论真假。

核心功能

结论卡片与依据绑定

每张卡片包含标题、结论(claim),以及最多 8 个项目相对文件路径作为依据。Agent 可通过工具创建卡片,例如:

{"action":"create","title":"重试不会重复扣款","claim":"相同 requestId 的重试只扣款一次。","files":["src/payment.ts","tests/retry.test.ts"]}

八种业务动作

工具支持 create、list、get、edit、check、review、archive、export。edit、review、archive 与单卡 check 使用最新 expectedRevision;review 同时引用最新持久检查的 checkId。beta.1 起支持 check 的 scope:selected,可传入 1–100 个 {cardId, expectedRevision},逐卡返回冲突与实际保存情况。列表支持按复核意见筛选,以及 attention、checked、updated 等稳定排序。

检查与人工复核

点击检查后,插件对比依据文件指纹/修订状态:未变化时提示「依据未变化」;变化时提示「依据已变化」。依据未变化不证明结论正确;文件新鲜度与复核意见是独立维度。复核前会重新读取依据,并拒绝过期的 revision 或 checkId。用户阅读依据后,可主动选择支持、否定或不确定,并填写复核说明。

侧栏与历史

原生右侧栏承载筛选、排序、选中批量检查,以及 Markdown 预览、复制或导出为新文件。草稿仅存在客户端内存,刷新或关闭会丢失。

安全与上限(摘要)

业务 I/O 走宿主 ctx.fs 与观察策略;拒绝路径逃逸、符号链接、目录联接和插件存储作为依据。只读模式支持读取、复制导出和 persist:false 的临时检查。活动卡片上限 100、总卡片 200、每卡 20 版本、每依据 2 MiB、存储约 8 MiB;批量检查最多 200 个唯一文件、64 MiB、10 秒。各文件分别观察,不提供全项目同一时刻快照。

安装与启用

README 固定 插件 0.1.0 与基线宿主 @deepseek-ai/dsh@0.2.0-rc.2。其他组合及 beta.1、alpha.6 回退见仓库 安装指南。也可从 Releases 下载 dsh-recheck-0.1.0.tgz 及同名 .sha256 校验后安装。

普通 Web 用户从 npm 安装固定版本并启动 Web:

npx.cmd --yes --package=@deepseek-ai/dsh@0.2.0-rc.2 dsh plugin --profile web add dsh-recheck@0.1.0
npx.cmd --yes --package=@deepseek-ai/dsh@0.2.0-rc.2 dsh web

使用本地 tgz 时,在安装包所在目录执行:

npx.cmd --yes --package=@deepseek-ai/dsh@0.2.0-rc.2 dsh plugin --profile web add './dsh-recheck-0.1.0.tgz'
npx.cmd --yes --package=@deepseek-ai/dsh@0.2.0-rc.2 dsh web

桌面用户应通过桌面应用自带 CLI 或插件管理入口安装到 desktop 配置后重启应用;不要使用与宿主不匹配的全局 CLI。备份、卸载与回退步骤见安装指南。发布包含构建产物;GitHub 自动生成的源码 ZIP 需自行构建。

典型用法(一分钟流程)

README 建议先在专用样例项目中操作。演示中修改样例 evidence.txt(例如 API_VERSION=v1 改为 v2),流程如下:

  1. 创建卡片:标题如「重试不会重复扣款」,填写结论,绑定 1–8 个项目相对文件路径。
  2. 点击检查,若依据未改,显示「依据未变化」。
  3. 修改依据文件后再次检查,显示「依据已变化」。
  4. 阅读依据并确认已阅读,选择支持、否定或不确定,保存复核说明。
  5. 在历史中生成 Markdown 预览、复制或导出为新文件。

适用场景与注意

适合谁: 需要在同一仓库里长期维护「业务结论 + 代码/配置依据」、并在文件变更后系统化触发人工复核的 DSH 用户或 Agent 工作流。

权限与信任: 插件以当前 DSH 进程权限读写工作区;安装前应阅读源码与 MIT 许可证,确认观察策略与数据路径(.dsh/recheck/cards.json)符合团队规范。备份前宜停用插件或确认无并发写入;恢复前保留当前文件并核对 schema。

生态说明: DSH 强调「一切皆插件」;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系。本插件为非官方项目。CI 发布说明针对 Windows/Ubuntu × 两个精确宿主的验收;Web 验收不代表其他 Desktop 组合均已验证,未验证组合见仓库 compatibility.json。

结尾

Recheck 把结论和依据文件绑在一起,在依据变化时用侧栏与工具链走通「检查 → 阅读 → 复核 → 历史」,且不依赖额外模型调用做卡片操作。进一步了解可查看 SkillHub 插件页 与 GitHub 仓库(含英文 README、变更记录与试用/备份恢复文档)。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye