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、變更記錄與試用/備份恢復文檔)。

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

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

小夜