前言¶

在 DSH 的工作流裏，agent 說“看起來沒問題”，並不等於一次可覈對的判斷；lint 全綠，也不直接等於可以發佈。falsify-dsh 針對的就是這個缺口：它不把 agent 的判斷包裝成第二意見，而是把公開的 Falsify CLI 包成 DSH 工具，調用 python -m falsify，再把 CLI 返回的 receipt 交還。

這是什麼¶

一句話定位¶

shi275773124/falsify-dsh 是 DeepSeek Harness（DSH）的一個 adapter，用於對接 public Falsify CLI。它的輸出是 PASS / PASS_WITH_DEBT / BLOCK 的 receipt，而不是讓 agent 自己給出最終結論。

維護與許可證¶

• 維護者：shi275773124
• 許可證：MIT
• 倉庫：https://github.com/shi275773124/falsify-dsh

核心功能¶

插件提供三個工具，分別對應 public Falsify CLI 的 lint、review、gate。

falsify_lint¶

調用：

python -m falsify lint

返回：

• L2_CLEAN / L2_DIRTY
• 靜態標籤
• blocker markers

這個工具的定位是靜態檢查，不替代完整 review。

falsify_review¶

調用：

python -m falsify review --json

返回：

• PASS
• PASS_WITH_DEBT
• BLOCK

這是 epistemic document review。

falsify_gate¶

調用：

python -m falsify gate --json

它作爲 public gate receipt 使用。production / quant 在沒有 Pro adapter 時會 fail closed。

判決邊界¶

插件只負責：

1. 提供路徑
2. 運行 python -m falsify
3. 返回 receipt

agent 不選擇 verdict。adapter 不會自行發明 PASS；如果 CLI 缺失，結果是 CLI_ERROR，不是 silent green。

安裝與啓用¶

環境要求¶

• Public Falsify CLI：Python 3.12+
• DSH 側 Node：^22.19.0 || >=24.0.0
• Public Falsify CLI 版本：>=0.6.0

安裝步驟¶

先安裝 public Falsify CLI：

pip install "falsify @ git+https://github.com/shi275773124/Falsify.git"

再添加插件：

dsh plugin --profile web add "github:shi275773124/falsify-dsh#v0.1.0"

最後重啓 profile：

dsh --profile web

可選項¶

如果默認的 python 不是安裝了 Falsify 的解釋器，可以配置 python / FALSIFY_PYTHON，讓 DSH 調用正確的 Python 環境。

典型用法¶

安裝並啓用後，可以直接告訴 agent：

• falsify this file
• gate this PR

也可以直接調用工具：

falsify_lint
falsify_review
falsify_gate

適用場景與注意¶

適合誰¶

適合希望在 DSH profile 中調用 public Falsify CLI 的開發者。它適合以下用途：

• 對單個文件做靜態檢查
• 對文檔做 epistemic review
• 對 PR 或文件做 gate receipt
• 在 agent 工作流中獲得一個明確 receipt，而不是自由文本判斷

運行權限¶

插件會作爲 DSH profile 的一部分運行，繼承當前 dsh 進程的權限環境。它的具體行爲包括：

• 啓動本地 Python 進程：python -m falsify ...
• 讀取 subject file 或 temp copy
• 爲 falsify_gate --json 寫 temp JSON file
• 轉發環境中已有的 provider API keys
• 不上傳 receipt
• 不自己打開網絡 sockets
• 不聲稱 production authority

因此，安裝前應檢查源碼、依賴和許可證。

配置項¶

下面是插件相關的配置項和環境變量：

Review 是 BYOK。沒有 Falsify cloud key。

限制¶

• DSH 當前處於 developer preview，迭代較快，可能出現 compatibility-breaking changes。
• 目前還沒有 frozen DSH SHA runtime proof；可用的是 static contract 和 wrapper tests。
• production / quant gate BLOCK 在 public CLI 下是預期行爲；Pro adapters closed。
• falsify_lint 返回 L2_CLEAN / L2_DIRTY 只是靜態標籤，不等同於發佈判斷。
• adapter 不會把缺失 CLI 的情況僞裝成 PASS；缺失時返回 CLI_ERROR。

結尾¶

falsify-dsh 的價值在於把 verdict 放回 CLI：agent 可以調用它，但不能改寫 receipt；插件負責接通 public Falsify CLI，而不是替用戶做最終裁決。

倉庫：https://github.com/shi275773124/falsify-dsh
目錄頁線索：https://www.skillhub.cn/plugins/shi275773124/falsify-dsh（該 URL 來自插件線索，未在已抓取正文中直接出現）