Falsify 裁决收据shi275773124/falsify-dsh

falsify-dsh

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：awesome-dsh-plugins#8 已于 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 账户路径。