前言¶
在 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
返回：
PASSPASS_WITH_DEBTBLOCK
这是 epistemic document review。
falsify_gate¶
调用：
python -m falsify gate --json
它作为 public gate receipt 使用。production / quant 在没有 Pro adapter 时会 fail closed。
判决边界¶
插件只负责：
- 提供路径
- 运行
python -m falsify - 返回 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 filegate 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
因此，安装前应检查源码、依赖和许可证。
配置项¶
下面是插件相关的配置项和环境变量：
| 配置项 / 环境变量 | 说明 |
|---|---|
python / FALSIFY_PYTHON |
指定能运行 python -m falsify 的解释器 |
timeoutMs / FALSIFY_DSH_TIMEOUT_MS |
超时控制 |
DEEPSEEK_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY |
透传给 public CLI，用于 review |
FALSIFY_PROVIDER / FALSIFY_MODEL / FALSIFY_BASE |
可选的 CLI 默认值 |
Review 是 BYOK。没有 Falsify cloud key。
限制¶
- DSH 当前处于 developer preview，迭代较快，可能出现 compatibility-breaking changes。
- 目前还没有 frozen DSH SHA runtime proof；可用的是 static contract 和 wrapper tests。
production/quantgate 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 来自插件线索，未在已抓取正文中直接出现）
