falsify-dsh

English | 中文

DeepSeek 负责写。Falsify 问：证据在哪？

装好后，对 agent 说「falsify 这个文件」或「gate 这个 PR」。 你会拿到收据：PASS / PASS_WITH_DEBT / BLOCK。 Agent 说「看起来没问题」不是收据。lint 变绿不是发版。

官方站点：https://falsify.site/

30 秒安装

1. 公开 Falsify CLI

需要 Python 3.12+：

pip install "falsify @ git+https://github.com/shi275773124/Falsify.git"
python -m falsify --help

2. 本 bundle

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

3. 重启 profile

dsh --profile web

只有声明了 dsh.bundle.patch 的包才会成为生效的 profile 层。本包有此声明。

可选：若带 Falsify 的解释器不是 python，设置 FALSIFY_PYTHON。

对 agent 说这些

插件启用后，直接对 agent 说：

• falsify 这个文件
• gate 这个 PR
• 静态检查这个文件

或直接调用工具：falsify_lint、falsify_review、falsify_gate。

裁决权在 CLI。插件只提供路径、调用 python -m falsify，并返回收据。Agent 不决定 verdict。

开发者预览

DeepSeek Harness 目前处于 开发者预览 阶段，正在快速迭代。未来将出现破坏兼容性的变更。

本适配器跟随该预览。lint / demo / selftest 变绿 不是 承重授权。dsh-inspect 负责找问题并修复；falsify-dsh 只包装公开 MIT Falsify CLI。

工具

工具	公开 CLI	允许的含义
falsify_lint	python -m falsify lint	L2_CLEAN / L2_DIRTY。静态标签 + blocker 标记。ceiling = NONE。
falsify_review	python -m falsify review --json	PASS / PASS_WITH_DEBT / BLOCK。认知层文档审查。不是 live。
falsify_gate	python -m falsify gate --json	公开闸门收据。无 Pro 适配器时，production / quant fail-closed。

适配器从不编造 PASS。CLI 缺失时 verdict 是 CLI_ERROR，不是静默变绿。

兼容性

部件	钉扎
DSH	开发者预览，最近对照 deepseek-ai/deepseek-harness 的日期为 2026-08-13。@deepseek-ai/dsh-tools 由 profile 提供，不在 npm。
Node	^22.19.0 || >=24.0.0
公开 Falsify CLI	shi275773124/Falsify >=0.6.0
已验证 DSH commit	尚未对冻结 DSH SHA 做过运行级实测 — 见「已知限制」

旧收据仍是收据，不会被升级成后来的授权。

卸载

dsh plugin --profile web remove falsify-dsh

或从 profile 的 package.json 删除依赖后执行 dsh plugin --profile web update。之后重启 profile。适配器自身不写持久状态。

从源码跑适配器测试

git clone https://github.com/shi275773124/falsify-dsh.git
cd falsify-dsh
npm install
npm test

配置

键 / 环境变量	默认	含义
python / FALSIFY_PYTHON	python	能执行 python -m falsify 的解释器
timeoutMs / FALSIFY_DSH_TIMEOUT_MS	180000	硬超时；中止是 CLI_ERROR，不是 PASS
DEEPSEEK_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY	未设置	转给公开 CLI，供 falsify_review 使用
FALSIFY_PROVIDER / FALSIFY_MODEL / FALSIFY_BASE	未设置	可选 CLI 默认值

没有 Falsify 云端 key。审查是 BYOK。

权限与数据

适配器会：

• 拉起本地 Python 进程（python -m falsify …）
• 读取 subject 文件，或把内联文本写成临时副本
• 为 falsify_gate --json 写临时 JSON
• 转发环境里已有的 provider API key
• 不上传收据、不自己开网络套接字、不声称生产授权

若你配置了模型 provider，子 CLI 可能会调用它。那是公开 Falsify CLI 的职责，不是本适配器的职责。

故障排查

现象	实际含义
verdict=CLI_ERROR	找不到 python -m falsify，或进程拉起失败。先装公开 CLI。
verdict=L2_CLEAN	只是静态 lint。不能凭这个发版。
falsify_review 得到 verdict=PASS	认知层文档 PASS。claim_bearing 仍为 false。
production / quant gate 得到 BLOCK	公开 CLI 的预期行为。Pro 适配器是闭源的。
插件在列表里，但没有工具	profile 没有加载 dsh.bundle.patch。重装并重启。

日志：工具结果包含 stdout、stderr、command 和 exit_code。回滚 = 卸载插件。

社区与支持

• 官方站点：https://falsify.site/
• 问题请提到 shi275773124/falsify-dsh。
• 插件已打 dsh-plugin 话题。
• 目录 listing： 已于 2026-08-13 合并。

参与贡献

参见 CONTRIBUTING.md。中文：CONTRIBUTING.zh.md。

开发

npm install
npm test
npm run typecheck

src/cli.ts 是可移植包装层，由 test/cli.test.mjs 覆盖。src/index.ts 是 Cordis 注册面，由 DSH 加载；它没有对着未发布的 @deepseek-ai/dsh-tools 做单元测试。

面向 agent：请遵循 AGENTS.md。

不是这个插件

• 不是 DSH 皮肤、侧栏或 TUI。
• 不是 dsh-inspect。inspect = 找茬 / 修复闭环。Falsify = 默认 BLOCK 的裁决器 + 收据。
• 不是闭源 Pro runtime、HMAC 承重签名器，或 live venue 适配器。
• 给 Python 主仓打 dsh-plugin 是 false-green。拿 topic 的是这个适配器。

已知限制

• 尚无冻结 DSH SHA 的运行级证明。目前只有静态契约 + 包装层测试。
• 公开 CLI 没有 doctor 子命令。不要在这里造一个假的。
• 本适配器上 capital_authority 恒为 NONE。这是故意的。

许可证

MIT

安全问题请私下联系 shi275773124/Falsify 维护者。不要在公开 issue 里贴密钥、带秘密的收据，或 live 账户路径。