dvalincode 0.17.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +320 -46
  2. package/README.zh-CN.md +277 -39
  3. package/THIRD_PARTY_NOTICES.md +98 -43
  4. package/dist/cli.js +4 -0
  5. package/dist/cli.js.map +1 -1
  6. package/dist/commands/dvalin.d.ts +41 -1
  7. package/dist/commands/dvalin.js +219 -37
  8. package/dist/commands/dvalin.js.map +1 -1
  9. package/dist/commands/mcpInstall.d.ts +2 -0
  10. package/dist/commands/mcpInstall.js +69 -0
  11. package/dist/commands/mcpInstall.js.map +1 -0
  12. package/dist/commands/run.js +21 -0
  13. package/dist/commands/run.js.map +1 -1
  14. package/dist/commands/security.d.ts +47 -0
  15. package/dist/commands/security.js +415 -0
  16. package/dist/commands/security.js.map +1 -0
  17. package/dist/dvalinCli.d.ts +3 -0
  18. package/dist/dvalinCli.js +36 -0
  19. package/dist/dvalinCli.js.map +1 -0
  20. package/dist/dvalinIndex.d.ts +2 -0
  21. package/dist/dvalinIndex.js +9 -0
  22. package/dist/dvalinIndex.js.map +1 -0
  23. package/dist/evidence/pack.d.ts +8 -0
  24. package/dist/evidence/pack.js +16 -0
  25. package/dist/evidence/pack.js.map +1 -1
  26. package/dist/harness/run.d.ts +15 -0
  27. package/dist/harness/run.js +45 -19
  28. package/dist/harness/run.js.map +1 -1
  29. package/dist/harness/verification.d.ts +56 -0
  30. package/dist/harness/verification.js +90 -0
  31. package/dist/harness/verification.js.map +1 -0
  32. package/dist/mcp/install.d.ts +48 -0
  33. package/dist/mcp/install.js +74 -0
  34. package/dist/mcp/install.js.map +1 -0
  35. package/dist/mcp/server.d.ts +10 -1
  36. package/dist/mcp/server.js +251 -34
  37. package/dist/mcp/server.js.map +1 -1
  38. package/dist/remediation/automate.d.ts +4 -1
  39. package/dist/remediation/automate.js +35 -18
  40. package/dist/remediation/automate.js.map +1 -1
  41. package/dist/remediation/diffScope.d.ts +29 -0
  42. package/dist/remediation/diffScope.js +107 -0
  43. package/dist/remediation/diffScope.js.map +1 -0
  44. package/dist/remediation/executor.d.ts +60 -0
  45. package/dist/remediation/executor.js +144 -0
  46. package/dist/remediation/executor.js.map +1 -0
  47. package/dist/remediation/localScan.d.ts +2 -1
  48. package/dist/remediation/localScan.js +73 -3
  49. package/dist/remediation/localScan.js.map +1 -1
  50. package/dist/remediation/sarif.d.ts +6 -0
  51. package/dist/remediation/sarif.js +36 -14
  52. package/dist/remediation/sarif.js.map +1 -1
  53. package/dist/remediation/scannerSuite.d.ts +21 -0
  54. package/dist/remediation/scannerSuite.js +65 -4
  55. package/dist/remediation/scannerSuite.js.map +1 -1
  56. package/dist/remediation/verify.d.ts +38 -0
  57. package/dist/remediation/verify.js +116 -0
  58. package/dist/remediation/verify.js.map +1 -0
  59. package/dist/security/baseline.d.ts +7 -0
  60. package/dist/security/baseline.js +26 -0
  61. package/dist/security/baseline.js.map +1 -0
  62. package/dist/security/config.d.ts +32 -0
  63. package/dist/security/config.js +131 -0
  64. package/dist/security/config.js.map +1 -0
  65. package/dist/security/contracts.d.ts +149 -0
  66. package/dist/security/contracts.js +231 -0
  67. package/dist/security/contracts.js.map +1 -0
  68. package/dist/security/fixRecord.d.ts +231 -0
  69. package/dist/security/fixRecord.js +327 -0
  70. package/dist/security/fixRecord.js.map +1 -0
  71. package/dist/security/fixRecordFile.d.ts +8 -0
  72. package/dist/security/fixRecordFile.js +37 -0
  73. package/dist/security/fixRecordFile.js.map +1 -0
  74. package/dist/security/fixRecordStore.d.ts +23 -0
  75. package/dist/security/fixRecordStore.js +74 -0
  76. package/dist/security/fixRecordStore.js.map +1 -0
  77. package/dist/security/render.d.ts +8 -0
  78. package/dist/security/render.js +20 -0
  79. package/dist/security/render.js.map +1 -0
  80. package/dist/security/suppressions.d.ts +12 -0
  81. package/dist/security/suppressions.js +60 -0
  82. package/dist/security/suppressions.js.map +1 -0
  83. package/dist/security/verifyRun.d.ts +21 -0
  84. package/dist/security/verifyRun.js +74 -0
  85. package/dist/security/verifyRun.js.map +1 -0
  86. package/dist/security/workflow.d.ts +98 -0
  87. package/dist/security/workflow.js +276 -0
  88. package/dist/security/workflow.js.map +1 -0
  89. package/dist/server/routes/remediation.d.ts +19 -0
  90. package/dist/server/routes/remediation.js +90 -18
  91. package/dist/server/routes/remediation.js.map +1 -1
  92. package/dist/tools/runCheck.d.ts +6 -0
  93. package/dist/tools/runCheck.js +1 -1
  94. package/dist/tools/runCheck.js.map +1 -1
  95. package/dist/tools/runSecuritySuite.d.ts +3 -0
  96. package/dist/tools/runSecuritySuite.js +18 -11
  97. package/dist/tools/runSecuritySuite.js.map +1 -1
  98. package/dist/tui/app.js +21 -2
  99. package/dist/tui/app.js.map +1 -1
  100. package/dist/tui/render.js +2 -0
  101. package/dist/tui/render.js.map +1 -1
  102. package/dist/version.d.ts +1 -1
  103. package/dist/version.js +1 -1
  104. package/package.json +17 -10
package/README.zh-CN.md CHANGED
@@ -9,7 +9,7 @@
9
9
  <p align="center">
10
10
  <a href="https://github.com/arthurpanhku/dvalincode/releases/latest"><img src="https://img.shields.io/github/v/release/arthurpanhku/dvalincode?style=for-the-badge&color=818cf8&label=Release" alt="Release"></a>
11
11
  <a href="https://github.com/arthurpanhku/dvalincode/releases"><img src="https://img.shields.io/github/downloads/arthurpanhku/dvalincode/total?style=for-the-badge&color=blue&label=Downloads" alt="Downloads"></a>
12
- <a href="#-测试"><img src="https://img.shields.io/badge/Tests-357%20%2F%20357%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
12
+ <a href="#-测试"><img src="https://img.shields.io/badge/Tests-584%20%2F%20584%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
13
13
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License"></a>
14
14
  <a href="https://scorecard.dev/viewer/?uri=github.com/arthurpanhku/dvalincode"><img src="https://api.scorecard.dev/projects/github.com/arthurpanhku/dvalincode/badge" alt="OpenSSF Scorecard"></a>
15
15
  <a href="#-一行安装"><img src="https://img.shields.io/badge/Platforms-macOS%20·%20Windows%20·%20Linux-blue?style=for-the-badge" alt="Platforms"></a>
@@ -18,21 +18,79 @@
18
18
  </p>
19
19
 
20
20
  <p align="center">
21
- <b>找出仓库里的安全漏洞,修掉它,并且证明确实修好了 —— 一条命令。</b><br>
22
- 每一处修复都会先出 diff、跑测试、重新扫描,并写入防篡改审计日志,然后才允许变成 PR。
21
+ <b>为人类和 AI Agent 编写的代码提供开放安全工程能力。</b><br>
22
+ <b>每一次修复,都自带证明。</b>
23
23
  </p>
24
24
 
25
+ Agent 修好了一个安全问题之后,总得有人判断它到底修好没有。市面上几乎所有工具都是
26
+ 去问那个写下修复的模型 —— 而这恰恰是模型最无法违背自身利益去诚实回答的问题。
27
+
28
+ **Dvalin 自己来判断,并把证明交给你。** 它重新扫描、亲自跑你项目的测试,看的是它
29
+ 自己启动的进程返回的退出码。修复是谁写的 —— 我们的 agent、Claude Code、Codex、
30
+ Copilot,还是人 —— 只被记录,绝不参与判定。产物是一份 **Verified Fix Record**:
31
+ 一个很小的 JSON,任何人都能离线复验,不需要联网,也不需要任何 Dvalin 的本地状态。
32
+
33
+ ```sh
34
+ dvalin verify-fix fix-record.json
35
+ ```
36
+ ```
37
+ Fix record 2c9d71ac03e0 · VERIFIED · scan-and-checks
38
+ executor: claude-code (recorded, not consulted)
39
+ targets: 1 before · 0 remaining
40
+ coverage: complete → complete
41
+ introduced: 0 (gate high/new)
42
+ outcome: verified
43
+ ✓ test: npm run test (exit 0)
44
+ audit: run verify-36509f42 @ 414644c75af0
45
+ ```
46
+
47
+ 这份记录声称的东西刻意很窄:*这些 finding 消失了,这些检查被观察到通过了。* 它不是
48
+ 「你的代码安全了」这种断言,Dvalin 也不允许它被这样解读 —— 每份记录都带着这次扫描
49
+ 究竟覆盖了什么,而一个没有任何检查能确认的修复,不会通过。
50
+ [开放规范 →](docs/spec/FIX-VERIFICATION.md)
51
+
52
+ 修复本身也是一次改动,而改动既会移除问题,也可能带来新问题。所以记录里还带着复扫
53
+ 看到、而首扫没有看到的东西,以及这次判定所依据的门禁阈值:一个删掉了 `eval`、却引入
54
+ 了 SQL 注入的修复,会被记为 `regressed`,不予通过。签发方根本没去看的记录同样不通过
55
+ —— `introduced: not determined` 直接失败,因为「不去查」绝不能比「查了并且查出问题」
56
+ 得分更高。
57
+
58
+ Dvalin 是放在“代码生成”和“允许合并”之间的独立安全运行时。人类开发者、Coding
59
+ Agent 和 CI 调用同一套版本化协议完成发现、修复与验证。它既可以独立运行,也可以通过
60
+ 可移植的 SARIF 与 Codex Security 等专业系统互操作。内置 Coding 能力只负责可靠地执行
61
+ 聚焦修复,不是安全结论的信任边界,也不以打败所有通用 Coding Agent 为目标。
62
+ 详见[安全 Agent 战略](docs/SECURITY-AGENT-STRATEGY.md)。
63
+
25
64
  ---
26
65
 
27
66
  ## ⏱️ 30 秒,免安装,不需要 API Key
28
67
 
29
68
  ```sh
30
- npx dvalincode dvalin .
69
+ npx dvalincode security scan .
70
+ # 安装 npm 包后也可直接运行:dvalin scan .
31
71
  ```
32
72
 
33
73
  就这一条。它用内置规则扫描当前目录里的注入、硬编码密钥、XSS、`eval` 和不安全的
34
74
  shell 调用,然后把结果打出来。不需要注册、不需要模型、不需要配置,代码不出本机。
35
- 想接入你已经装好的引擎,加上 `--scanners builtin,semgrep,trivy,osv-scanner` 即可。
75
+ 默认只启用一定存在的 Dvalin Built-in;可选引擎必须显式启用,其固定安装命令可以先审查:
76
+
77
+ ```sh
78
+ dvalin scanners list
79
+ dvalin scanners install semgrep # 只显示并审查命令
80
+ dvalin scanners install semgrep --yes # 在 Dvalin 策略约束下执行
81
+ ```
82
+
83
+ 要建立“禁止新增高风险问题”的增量门禁,把策略和基线一并提交到仓库:
84
+
85
+ ```sh
86
+ dvalin init
87
+ dvalin baseline
88
+ dvalin scan
89
+ ```
90
+
91
+ 这会创建 `dvalin.security.json` 和 `.dvalin/baseline.json`。每条 suppression 都必须
92
+ 写原因,还可以设置 owner 和过期时间。扫描输出是版本化 envelope,包含确定性 gate
93
+ 结果和可恢复的 workflow ID。
36
94
 
37
95
  ### 或者挂到每个 PR 上 —— 完全不用装任何东西
38
96
 
@@ -43,15 +101,61 @@ permissions:
43
101
  security-events: write
44
102
  steps:
45
103
  - uses: actions/checkout@v5
46
- - uses: arthurpanhku/dvalincode@v0.17.0
104
+ with:
105
+ fetch-depth: 0 # 让扫描能取到 base commit
106
+ - uses: arthurpanhku/dvalincode@v0.18.0
47
107
  with:
48
108
  fail-on: high
109
+ diff: true # 只报告这个 PR 改动的部分
49
110
  ```
50
111
 
51
112
  扫描结果会直接标注在 PR 的 diff 上,同时进入仓库的 Security 页。不需要 API Key、
52
113
  不需要任何 secret、不调用模型 —— 扫描是确定性的,且只在 runner 本地进行。
53
114
  [完整示例 →](docs/examples/dvalin-scan.yml)
54
115
 
116
+ `diff: true` 只报告 PR 改动到的行,因此这道门禁拦的是这次改动**新引入**的问题,
117
+ 而不是仓库里本来就有的一堆存量问题。这正是它能在一个并不干净的代码库上被接受的
118
+ 原因。去掉它就是全仓库扫描。
119
+
120
+ 每条评论都会在结论旁边写明这次扫描的**覆盖率** —— `complete` / `partial` /
121
+ `unknown`。因为「没发现问题」在半数引擎没装的情况下,和在完整扫描下,根本不是同一个
122
+ 答案。
123
+
124
+ ### 再把证明贴到 diff 旁边
125
+
126
+ 如果你的流水线产出了 fix record,把它交给同一个 action:
127
+
128
+ ```yaml
129
+ - uses: arthurpanhku/dvalincode@v0.18.0
130
+ with:
131
+ fix-record: fix-record.json
132
+ ```
133
+
134
+ runner 会仅凭这个文件本身重新推导它 —— 重算哈希,并从它自己的证据重新推出结论 ——
135
+ 然后把结果发到 PR 上。一份签发之后被改过的记录会在这里失败,并让整个 job 失败。
136
+ 审查者不需要信任产出它的流水线,也不需要信任我们。
137
+
138
+ ```
139
+ 🔏 Verified Fix Record
140
+ ✅ ce504a995395 · VERIFIED · scan-and-checks
141
+ - repaired by claude-code — recorded, and not consulted for this verdict
142
+ - targets: 1 before → 0 remaining
143
+ - coverage: complete → complete
144
+ - introduced: none (gate high/new)
145
+ - outcome: verified
146
+ - ✓ test: `npm run test` (exit 0)
147
+ - audit chain: verify-eeb1bae7 @ 80881867270d
148
+ ```
149
+
150
+ 引入了新问题的修复,会在同一个地方说清楚,并让这个 job 失败:
151
+
152
+ ```
153
+ ❌ 916e2eeaf065 · NOT VERIFIED · scan-and-checks
154
+ - introduced: 1 finding(s) the first scan did not report (gate high/new)
155
+ - critical dvalin/sql-injection — src/db.ts:31
156
+ - outcome: regressed
157
+ ```
158
+
55
159
  ### 或者让你的 agent 调用它
56
160
 
57
161
  如果代码是 agent 写的,那检查它的就不能是同一个 agent。DvalinCode 本身是个 MCP
@@ -61,12 +165,72 @@ server,任何支持 MCP 的 agent 都能接:
61
165
  claude mcp add dvalin -- npx -y dvalincode mcp-serve --workspace .
62
166
  ```
63
167
 
64
- `dvalin_scan` 只读且确定性 —— 不跑模型、不需要任何凭据、不改文件 —— 所以 agent
65
- 可以每次改完就调一次。对一个真实漏洞样本的实测:约 170ms 返回,payload 约 600 字节。
66
- 同一个 server 还提供 `dvalin_run_task`(委派完整的受管任务)以及会话、审计证据工具。
168
+ 一条命令配好你实际在用的编辑器:
169
+
170
+ ```sh
171
+ npx dvalincode mcp-install cursor # .cursor/mcp.json
172
+ npx dvalincode mcp-install vscode # .vscode/mcp.json
173
+ npx dvalincode mcp-install claude-code # .mcp.json
174
+ ```
175
+
176
+ 这几家的格式不一样,而且写错不会报错——VS Code 的 key 是 `servers`,Cursor 是
177
+ `mcpServers`,填反了编辑器会照单全收然后当没看见。这条命令会写对,并且合并进已有
178
+ 配置而不是覆盖。[编辑器与 MCP →](integrations/mcp/)
179
+
180
+ `dvalin_scan` 支持 `diff: "uncommitted"`,只报告 agent 刚写的部分,而不是仓库里的全部存量问题。它不跑模型、不修改目标 workspace、也不持久化 Dvalin 状态,因此客户端可以默认允许这次预览。确认要修复某条发现后,Agent 再显式调用
181
+ `dvalin_begin_verification` 创建精简的本地安全 workflow,用 fingerprint 精确读取单条发现,再通过 `dvalin_get_finding` 和
182
+ `dvalin_verify_findings` 请求独立复扫。响应包含 MCP `structuredContent`,并可通过
183
+ `dvalin_list_scanners` 查询组件是否就绪。同一 server 也提供可选的 `dvalin_run_task`
184
+ 实现助手,以及 session 和审计证据工具。
185
+
186
+ 下面每一个客户端都被驱动到了真实的工具调用,而不只是握手成功 —— 具体是哪个客户端、
187
+ 哪个版本、哪一天验的,写成了表格而不是一句话,因为手写的版本号会悄无声息地过期。
188
+ [集成支持 ↓](#-集成支持) · [Agent 集成 →](integrations/)
189
+
190
+ 仓库还提供一份 [Codex/Claude 双兼容插件](integrations/dvalin-security/):同时包含两套
191
+ 原生 manifest、共享安全门禁 skill 和本地 MCP server 配置。安装后,agent 可根据任务
192
+ 上下文自动发现门禁,不再依赖每位开发者记住扫描提示词。
193
+ Codex 会采纳扫描工具的只读 MCP 标注;Claude Code 按其安全设计仍需显式授权一次。
194
+ 插件给出精确到只读扫描工具的 allow 规则,不要求用户绕过所有权限。
195
+
196
+ ### 你在哪儿干活,它就在哪儿
67
197
 
68
- Claude Code 与 Codex 均已用已发布的包做过端到端验证 —— 是真实发起工具调用,而不只是握手成功。
69
- [Agent 集成 →](integrations/)
198
+ 同一个 server,按每个工具各自的方式接进去:
199
+
200
+ | Harness | 怎么接 |
201
+ |---|---|
202
+ | **Claude Code** | [双兼容插件](integrations/dvalin-security/),或 `claude mcp add` · [独立 skill](integrations/claude-code/) |
203
+ | **Codex** | [双兼容插件](integrations/dvalin-security/),或 `codex mcp add` · 与 Codex Security 的 [SARIF 互操作](integrations/codex-security/) |
204
+ | **Cursor** | `dvalincode mcp-install cursor` |
205
+ | **VS Code** | `dvalincode mcp-install vscode` · 在 Problems、coverage/gate 状态和离线 VFR 校验中展示结果的[扩展](editors/vscode/) —— *已构建,尚未发布* |
206
+ | **Windsurf · Zed** | 在各自设置里配 stdio MCP —— [server 命令](integrations/mcp/) |
207
+ | **任意 MCP 客户端** | [MCP registry](https://registry.modelcontextprotocol.io/):`io.github.arthurpanhku/dvalincode` |
208
+ | **GitHub Actions** | [Marketplace action](https://github.com/marketplace/actions/dvalin-security-scan) —— 结果直接标在 PR diff 上 |
209
+ | **任意 CI** | `dvalin scan . --fail-on high`,输出 SARIF 供 code scanning 用 |
210
+
211
+ 各家的 MCP 配置格式并不通用——VS Code 的 key 是 `servers`,Cursor 是 `mcpServers`,
212
+ 填错了不会报错只会静默失效——所以 `mcp-install` 会写对格式,并合并进已有配置。
213
+ [编辑器与 MCP →](integrations/mcp/)
214
+
215
+ ### 或者和 Codex Security 互操作
216
+
217
+ [Codex Security](https://github.com/openai/codex-security) 可以把已完成且密封的扫描
218
+ 导出为 SARIF。Dvalin 只导入这个可移植投影,不耦合 Codex Security 的私有状态目录:
219
+
220
+ ```sh
221
+ DVALIN_CODEX_SCAN_DIR=/tmp/codex-security-results
222
+ npx @openai/codex-security scan . --output-dir "$DVALIN_CODEX_SCAN_DIR"
223
+ npx @openai/codex-security export "$DVALIN_CODEX_SCAN_DIR" \
224
+ --export-format sarif --source-root "$PWD" --output /tmp/codex-security.sarif
225
+
226
+ dvalin import /tmp/codex-security.sarif .
227
+ dvalin scan . --fail-on high
228
+ ```
229
+
230
+ 导入会生成稳定的 Dvalin remediation case;`--no-persist` 可以只校验交接件而不修改
231
+ backlog。请继续保存 Codex Security 原始的 manifest、findings 和 coverage 工件——Dvalin
232
+ 只导入 SARIF finding 投影,不会改写其密封 bundle,也不会重新解释其覆盖率。
233
+ [集成指南 →](integrations/codex-security/)
70
234
 
71
235
  ### 然后让它把找到的问题修掉
72
236
 
@@ -120,6 +284,72 @@ dvalincode report verify # 重新推导上次运行审计日志的哈希链
120
284
 
121
285
  ---
122
286
 
287
+ ## 🧩 集成支持
288
+
289
+ AI 协助写出来的代码,在合并之前会经过四道手:写它的 agent、开发者读它的编辑器、
290
+ 拦它的 Pull Request,以及最后必须相信这个结论的评审者。一个只存在于其中一处的安全
291
+ 结论不是门禁,只是一条下一环节可以无视的建议。
292
+
293
+ Dvalin 在这四处背后是同一个 MCP server、同一次确定性扫描 —— 所以答案不会因为谁在问
294
+ 而改变。
295
+
296
+ | 开发环节 | 你在哪儿 | Dvalin 怎么接进去 | 状态 |
297
+ |---|---|---|---|
298
+ | **写代码** | Claude Code | [双兼容插件](integrations/dvalin-security/) · `claude mcp add` · `mcp-install claude-code` | ✅ 会话已验证 |
299
+ | | Codex | [双兼容插件](integrations/dvalin-security/) · `codex mcp add` · [SARIF 互操作](integrations/codex-security/) | ✅ 会话已验证 · 截图待补 |
300
+ | | Cursor | `dvalincode mcp-install cursor` | ⚙️ 配置已验证 |
301
+ | | Windsurf · Zed | 通过它们自己的设置接 stdio MCP | ⚙️ 已文档化,未验证 |
302
+ | | 任意 MCP 客户端 | registry `io.github.arthurpanhku/dvalincode` | ⚙️ 已发布 |
303
+ | **回头读代码** | VS Code | `mcp-install vscode` · [扩展](editors/vscode/):Problems、覆盖度与门禁状态 | ✅ 编辑器内已验证 |
304
+ | **卡住合并** | GitHub Actions | [Marketplace action](https://github.com/marketplace/actions/dvalin-security-scan) —— finding 落在 diff 上,fix record 在 runner 上重新推导 | ✅ 本仓库自己的 CI 就在跑 |
305
+ | | 任意 CI | `dvalin scan . --fail-on high`,输出 SARIF | ✅ 退出码就是契约 |
306
+ | **相信这个结论** | 任何人,离线 | `dvalin verify-fix record.json` | ✅ 不需要 workspace、网络或任何 Dvalin 状态 |
307
+
308
+ **✅** 表示真实客户端被端到端驱动过,并且观察到了工具调用。
309
+ **⚙️** 表示配置能生成、格式经过测试,但还没有抓到会话记录。这个区别这里不含糊过去 ——
310
+ 一个能被加载的配置文件,不能证明工具真的被调用过。
311
+
312
+ ### 每一条结论的依据
313
+
314
+ | 客户端 | 版本 | 检查时间 | 怎么检查的 |
315
+ |---|---|---|---|
316
+ | Claude Code | CLI 2.1.260 | 2026-09-04 | server 连上,只放行 `dvalin_scan` 一个工具并被真实调用,返回 3 条 finding —— 见下方截图 |
317
+ | Claude Code | CLI 2.1.251 | 2026-08-31 | 每周的 [`harness-interop`](.github/workflows/harness-interop.yml):对构建产物做真实握手,这一步不需要任何凭据 |
318
+ | Codex | CLI 0.149.1 | 2026-09-03 | 在 macOS 上人工执行:`approval=never` 的只读沙箱里调用了 scan,没有写入任何 workflow 状态 |
319
+ | Codex | CLI 0.151.0 | 2026-08-31 | 每周的 `harness-interop`:server 配置被接受并按 stdio 存下。**这不是握手** —— 在设置 `CODEX_API_KEY` 之前,调用工具那一步一直是 skipped |
320
+ | VS Code | 1.134.0 · 扩展 0.18.0 | 2026-09-03 | 干净 profile 里安装打包好的 VSIX;finding、门禁和覆盖度都出现在编辑器里 —— 见下方截图 |
321
+ | Cursor | — | 2026-09-04 | `mcp-install cursor` 会把 `.cursor/mcp.json` 写成 `mcpServers` 结构;但还没有抓到会话记录 |
322
+
323
+ 那个每周任务之所以存在,是因为这段话的早期版本手写了两个 CLI 版本号,两个都在几周内
324
+ 过期,而没有任何东西提醒过。现在它每周对着这些工具的当周版本重跑一次 —— 上面这些日期
325
+ 要么自己往前走,要么就公开地停在那里。
326
+
327
+ ### 同一条 finding,在不同的地方
328
+
329
+ **Claude Code** —— 只放行了一个只读工具,以及那次 MCP 调用本身:
330
+
331
+ ![Claude Code 会话调用 Dvalin MCP server](docs/screenshots/10-claude-code-session.png)
332
+
333
+ **Codex** —— 截图待补。
334
+
335
+ <!--
336
+ Codex 的会话截图放这里,命名为 docs/screenshots/11-codex-session.png。
337
+ 在装好并认证过 Codex CLI 的机器上这样产出:
338
+
339
+ codex mcp add dvalin -- npx -y dvalincode mcp-serve --workspace .
340
+ codex exec --sandbox read-only \
341
+ "Scan this workspace with Dvalin and list every finding with rule id, file, line and severity."
342
+
343
+ 或者配好 CODEX_API_KEY 这个仓库 secret,.github/workflows/harness-interop.yml
344
+ 每周一就不会再跳过它的 "Codex calls a tool" 那一步。
345
+ -->
346
+
347
+ **VS Code** —— 同一套扫描器契约,变成波浪线和状态栏:
348
+
349
+ ![VS Code 里的 Dvalin finding 与覆盖度状态](docs/screenshots/09-vscode-dvalin-integration.png)
350
+
351
+ ---
352
+
123
353
  ## 🏛️ 而且它过得了安全评审
124
354
 
125
355
  当依赖这套工具的不止你一个人时,上面那条命令才是真正要紧的东西。DvalinCode 是一个
@@ -157,11 +387,12 @@ dvalincode report verify # 重新推导上次运行审计日志的哈希链
157
387
 
158
388
  ## 🎯 核心目标
159
389
 
160
- > **让高合规与安全敏感团队也能批准 AI 编码。**
390
+ > **让每一个写代码的人类或 Agent,都通过同一套独立安全门禁。**
161
391
 
162
- DvalinCode 的定位是 **可审批的 Agent 运行时(runtime)**,而不只是又一个
163
- 编码 Agent 应用。核心产品不只是“AI 能写代码”,而是金融、医疗、政企、内部平台
164
- 等高保密代码库在引入 AI 编码前所需要的安全、合规和审计证据。
392
+ DvalinCode 的定位是 **Agent 可调用的安全运行时**,而不是又一个通用 Coding Agent
393
+ 榜单参赛者。核心产品是扫描证据、策略、基线、确定性验证,以及能被人类、外部 Agent
394
+ 和 CI 共同调用的便携接口。自带 Coding Agent 只需保持可靠完成聚焦修复和测试的能力;
395
+ 模型的文字声明永远不能决定安全 gate 是否通过。
165
396
 
166
397
  - **模型自由** —— 任何 OpenAI 兼容端点都是一等公民,包括本地模型。你的工作流不应被任何一家厂商的定价、限流或质量波动绑架。
167
398
  - **默认安全** —— 三档审批 + diff 预审、撤销栈、沙箱化 shell 执行。一个敢放心开全自动的 Agent。
@@ -359,11 +590,11 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
359
590
  <img src="assets/hero.png" alt="Dvalin 安全健康分显示 22/100 F、4 条高危与 6 条中危,Findings 列表把每处 eval 定位到 NodeGoat 改编路由的具体行" width="100%">
360
591
  </p>
361
592
 
362
- **验证后的结果——3 处 `eval` 调用改为受约束的数值解析、新增 1 条注入回归测试、
363
- 4 个开源引擎均完成,0 条发现,100/100 · A:**
593
+ **验证后的结果——真实模型驱动的 Verify 回合检查修复、运行回归测试和 4 个开源引擎,
594
+ 随后服务端确定性复扫显示完整覆盖、gate 通过、0 条发现、100/100 · A:**
364
595
 
365
596
  <p align="center">
366
- <img src="assets/dvalin-scan-after.jpg" alt="Dvalin 验证复扫显示 100/100 A、0 条发现,以及产生该结果的修复会话" width="100%">
597
+ <img src="assets/dvalin-verify-local.jpg" alt="Dvalin 本地真实模型 Verify 回合及其确定性复扫:100/100 A、四引擎完整覆盖、gate 通过、0 条发现" width="100%">
367
598
  </p>
368
599
 
369
600
  **Home → Code → Dvalin——当前三个工作区:**
@@ -426,6 +657,18 @@ dvalincode mcp-serve # 供外部 Agent 调用的任务级 stdio MCP
426
657
  无头 `run` 和 `mcp-serve` 与交互客户端共用同一个策略与审计关卡。cron、CI
427
658
  和外部 Agent 示例见[无人值守配方](docs/RECIPES-UNATTENDED.md)。
428
659
 
660
+ 扫描过、或者产出过 fix record 的运行,还会在结果旁边带上一份 `verification` 信封 ——
661
+ `json`、`stream-json` 以及 MCP `dvalin_run_task` 的返回里都有。`coverageStatus` 取的
662
+ 是这次运行**有证据支持的最弱**覆盖度,因此一次完整扫描不能替一次部分扫描背书;产出
663
+ 的记录按路径列出,可离线复验。CI 门禁可以直接读它:
664
+
665
+ ```sh
666
+ jq -e '.verification.coverageStatus == "complete"' run.json || exit 1
667
+ ```
668
+
669
+ 这和 PR 评论用的是同一条规则,只是用在没有人盯着的那个界面上。
670
+ [Harness 模式 →](docs/HARNESS-MODE.md)
671
+
429
672
  ### Windows
430
673
 
431
674
  从 [Releases](https://github.com/arthurpanhku/dvalincode/releases/latest) 下载 `dvalincode-v*-windows-x64.zip`,解压后双击 `start.bat`。
@@ -591,7 +834,8 @@ RESTORE → COMPACT → COMMAND → BUILD → RUN → SAVE → RESPOND → DONE
591
834
  npm test
592
835
  ```
593
836
 
594
- **357 个测试 · 52 个文件 · 全部通过。**
837
+ **584 个核心测试 · 74 个文件 · 全部通过。** VS Code 扩展另有 37 个测试,
838
+ 以及一个可选的已发布包集成测试。
595
839
 
596
840
  ---
597
841
 
@@ -718,7 +962,7 @@ Linux 与 macOS 命令通过 <code>/bin/sh</code> 执行;Windows 命令通过
718
962
  ```sh
719
963
  git clone https://github.com/arthurpanhku/dvalincode
720
964
  cd dvalincode && npm install
721
- npm test # 357/357 ✅
965
+ npm test # 584/584 核心测试 ✅
722
966
  npm run typecheck
723
967
  ```
724
968
 
@@ -748,6 +992,9 @@ agentic coding 生态;DvalinCode 的产品方向和架构设计也受到了这
748
992
  - OpenAI Codex / Codex CLI、Claude Code、Aider、opencode、Cursor、Cline
749
993
  等编码 Agent 帮助明确了用户对终端 Agent、plan/build 模式、权限提示、
750
994
  项目本地上下文、沙箱、session lifecycle、MCP 集成和 diff-first 编辑工作流的期待。
995
+ - [OpenAI Codex Security](https://github.com/openai/codex-security) 及其公开文档为
996
+ Dvalin 的专业安全 Agent 研究和可移植 SARIF 交接提供了参考;Dvalin 仍是独立且参与
997
+ 竞争的安全运行时。
751
998
  - `AGENTS.md` 项目指令约定在编码 Agent 工具中较常见,也影响了 DvalinCode
752
999
  加载项目本地指令的行为设计。
753
1000
  - CodeQL、GitHub Code Scanning、Semgrep、SARIF、OpenSSF Scorecard 与
@@ -763,31 +1010,22 @@ prompt、UI 文案、工具 schema、模块布局和产品实现均为原创;
763
1010
 
764
1011
  ---
765
1012
 
766
- ## ⭐ Star 增长趋势
767
-
768
- <p align="center">
769
- <a href="https://www.star-history.com/#arthurpanhku/dvalincode&Date">
770
- <picture>
771
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=arthurpanhku/dvalincode&type=Date&theme=dark">
772
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=arthurpanhku/dvalincode&type=Date">
773
- <img alt="DvalinCode Star 增长趋势图" src="https://api.star-history.com/svg?repos=arthurpanhku/dvalincode&type=Date">
774
- </picture>
775
- </a>
776
- </p>
777
-
778
- ---
779
-
780
1013
  ## 💛 感谢每一位贡献者
781
1014
 
782
1015
  <p align="center">
783
1016
  每一个 Issue、想法、文档改进、测试和代码贡献,都在帮助 DvalinCode 变得更好。
784
1017
  </p>
785
1018
 
786
- <p align="center">
787
- <a href="https://github.com/arthurpanhku/dvalincode/graphs/contributors">
788
- <img src="https://contrib.rocks/image?repo=arthurpanhku/dvalincode" alt="DvalinCode 贡献者">
789
- </a>
790
- </p>
1019
+ | 贡献者 | GitHub 主页 |
1020
+ | --- | --- |
1021
+ | Arthur Pan | [@arthurpanhku](https://github.com/arthurpanhku) |
1022
+ | Shivas | [@shivasb42](https://github.com/shivasb42) |
1023
+ | Aditya | [@adity982](https://github.com/adity982) |
1024
+ | badhope | [@weed33834](https://github.com/weed33834) |
1025
+ | Samran Asif | [@webdevsamran](https://github.com/webdevsamran) |
1026
+ | dchaudhari7177 | [@dchaudhari7177](https://github.com/dchaudhari7177) |
1027
+
1028
+ 查看[完整贡献记录](https://github.com/arthurpanhku/dvalincode/graphs/contributors),其中也包含自动依赖更新和维护记录。
791
1029
 
792
1030
  <p align="center">
793
1031
  <sub>也想加入?阅读<a href="CONTRIBUTING.md">贡献指南</a>,提交你的第一个 Pull Request。</sub>