falsify-dsh

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

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

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：awesome-dsh-plugins#8 已于 2026-08-13 合并。

参与贡献

参见 [CONTRIBUTING.md](CONTRIBUTING.md)。中文：[CONTRIBUTING.zh.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](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](LICENSE)

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