dvalincode 0.14.0 → 0.15.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 (75) hide show
  1. package/README.md +159 -60
  2. package/README.zh-CN.md +169 -72
  3. package/THIRD_PARTY_NOTICES.md +295 -147
  4. package/dist/agent/loop.d.ts +8 -0
  5. package/dist/agent/loop.js +8 -1
  6. package/dist/agent/loop.js.map +1 -1
  7. package/dist/agent/runner.d.ts +1 -0
  8. package/dist/agent/runner.js +10 -1
  9. package/dist/agent/runner.js.map +1 -1
  10. package/dist/agent/session.d.ts +23 -1
  11. package/dist/agent/session.js +63 -11
  12. package/dist/agent/session.js.map +1 -1
  13. package/dist/agent/types.d.ts +2 -0
  14. package/dist/audit/log.d.ts +3 -0
  15. package/dist/audit/log.js.map +1 -1
  16. package/dist/audit/report.js +2 -0
  17. package/dist/audit/report.js.map +1 -1
  18. package/dist/cli.js +24 -2
  19. package/dist/cli.js.map +1 -1
  20. package/dist/commands/dvalin.js +12 -0
  21. package/dist/commands/dvalin.js.map +1 -1
  22. package/dist/commands/mcpServe.d.ts +2 -0
  23. package/dist/commands/mcpServe.js +36 -0
  24. package/dist/commands/mcpServe.js.map +1 -0
  25. package/dist/commands/policy.js +12 -0
  26. package/dist/commands/policy.js.map +1 -1
  27. package/dist/commands/run.d.ts +30 -0
  28. package/dist/commands/run.js +229 -0
  29. package/dist/commands/run.js.map +1 -0
  30. package/dist/core/policy.d.ts +21 -0
  31. package/dist/core/policy.js +32 -0
  32. package/dist/core/policy.js.map +1 -1
  33. package/dist/core/subprocessSandbox.d.ts +49 -6
  34. package/dist/core/subprocessSandbox.js +175 -64
  35. package/dist/core/subprocessSandbox.js.map +1 -1
  36. package/dist/core/trust.js +12 -0
  37. package/dist/core/trust.js.map +1 -1
  38. package/dist/harness/run.d.ts +70 -0
  39. package/dist/harness/run.js +185 -0
  40. package/dist/harness/run.js.map +1 -0
  41. package/dist/mcp/client.d.ts +12 -0
  42. package/dist/mcp/client.js +2 -2
  43. package/dist/mcp/client.js.map +1 -1
  44. package/dist/mcp/config.d.ts +33 -3
  45. package/dist/mcp/config.js +32 -3
  46. package/dist/mcp/config.js.map +1 -1
  47. package/dist/mcp/register.d.ts +23 -6
  48. package/dist/mcp/register.js +42 -8
  49. package/dist/mcp/register.js.map +1 -1
  50. package/dist/mcp/server.d.ts +35 -0
  51. package/dist/mcp/server.js +230 -0
  52. package/dist/mcp/server.js.map +1 -0
  53. package/dist/mcp/stdio.d.ts +34 -0
  54. package/dist/mcp/stdio.js +183 -0
  55. package/dist/mcp/stdio.js.map +1 -0
  56. package/dist/remediation/sarifExport.d.ts +7 -0
  57. package/dist/remediation/sarifExport.js +102 -0
  58. package/dist/remediation/sarifExport.js.map +1 -0
  59. package/dist/remediation/scannerSuite.js +11 -1
  60. package/dist/remediation/scannerSuite.js.map +1 -1
  61. package/dist/server/configStore.d.ts +2 -8
  62. package/dist/server/configStore.js +12 -7
  63. package/dist/server/configStore.js.map +1 -1
  64. package/dist/server/wsHandler.js +8 -0
  65. package/dist/server/wsHandler.js.map +1 -1
  66. package/dist/tools/shell.js +1 -1
  67. package/dist/tools/shell.js.map +1 -1
  68. package/dist/tui/app.js +4 -1
  69. package/dist/tui/app.js.map +1 -1
  70. package/dist/tui/render.d.ts +1 -0
  71. package/dist/tui/render.js +11 -0
  72. package/dist/tui/render.js.map +1 -1
  73. package/dist/version.d.ts +1 -1
  74. package/dist/version.js +1 -1
  75. package/package.json +4 -3
package/README.zh-CN.md CHANGED
@@ -9,48 +9,94 @@
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-229%20%2F%20229%20%E2%9C%93-success?style=for-the-badge" alt="Tests"></a>
12
+ <a href="#-测试"><img src="https://img.shields.io/badge/Tests-323%20%2F%20323%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
- <a href="docs/governance/ISO-42001-AIMS.md"><img src="https://img.shields.io/badge/ISO%2FIEC%2042001-AIMS%20Aligned-0F766E?style=for-the-badge" alt="ISO/IEC 42001 AIMS aligned"></a>
16
- <a href="docs/EVIDENCE-PACK.md"><img src="https://img.shields.io/badge/Compliance-Evidence%20Pack-2563EB?style=for-the-badge" alt="Compliance evidence pack"></a>
17
- <a href="docs/security/OPENSSF-SCORECARD.md"><img src="https://img.shields.io/badge/DevSecOps-Native-B91C1C?style=for-the-badge" alt="DevSecOps native"></a>
18
15
  <a href="#-一行安装"><img src="https://img.shields.io/badge/Platforms-macOS%20·%20Windows%20·%20Linux-blue?style=for-the-badge" alt="Platforms"></a>
19
16
  <a href="#-providers"><img src="https://img.shields.io/badge/LLM-OpenAI%20·%20Claude%20·%20DeepSeek%20·%20Ollama%20·%20Groq-7C3AED?style=for-the-badge" alt="LLM Support"></a>
20
17
  <a href="README.md"><img src="https://img.shields.io/badge/i18n-EN%20·%20中文-orange?style=for-the-badge" alt="English / 中文"></a>
21
18
  </p>
22
19
 
23
20
  <p align="center">
24
- <b>面向高合规团队、真正可审批的 AI 编码代理。</b><br>
25
- <b>适合金融、医疗、政企与高保密研发场景:AI 编码必须可控、透明、可审计。</b>
21
+ <b>找出仓库里的安全漏洞,修掉它,并且证明确实修好了 —— 一条命令。</b><br>
22
+ 每一处修复都会先出 diff、跑测试、重新扫描,并写入防篡改审计日志,然后才允许变成 PR。
26
23
  </p>
27
24
 
28
- <p align="center">
29
- <b>🔑 模型自由 · 本地优先 · 策略约束 · 审计就绪 —— 安全团队真正批得下来的编码代理。</b>
30
- </p>
25
+ ---
31
26
 
32
- <p align="center">
33
- 自带模型 —— DeepSeek、OpenAI、Claude (via OpenRouter)、Groq、Ollama,或任何 OpenAI 兼容端点。一键切换,无需改代码,无供应商绑定。
34
- </p>
27
+ ## ⏱️ 30 秒,免安装,不需要 API Key
35
28
 
36
- ---
29
+ ```sh
30
+ npx dvalincode dvalin .
31
+ ```
32
+
33
+ 就这一条。它用内置规则扫描当前目录里的注入、硬编码密钥、XSS、`eval` 和不安全的
34
+ shell 调用,然后把结果打出来。不需要注册、不需要模型、不需要配置,代码不出本机。
35
+ 想接入你已经装好的引擎,加上 `--scanners builtin,semgrep,trivy,osv-scanner` 即可。
36
+
37
+ ### 或者挂到每个 PR 上 —— 完全不用装任何东西
38
+
39
+ ```yaml
40
+ # .github/workflows/security.yml
41
+ permissions:
42
+ contents: read
43
+ security-events: write
44
+ steps:
45
+ - uses: actions/checkout@v5
46
+ - uses: arthurpanhku/dvalincode@v0.15.0
47
+ with:
48
+ fail-on: high
49
+ ```
37
50
 
38
- ## ⏱️ 60 秒自证
51
+ 扫描结果会直接标注在 PR 的 diff 上,同时进入仓库的 Security 页。不需要 API Key、
52
+ 不需要任何 secret、不调用模型 —— 扫描是确定性的,且只在 runner 本地进行。
53
+ [完整示例 →](docs/examples/dvalin-scan.yml)
39
54
 
40
- 别听宣传——在你自己的机器上验证:
55
+ ### 然后让它把找到的问题修掉
41
56
 
42
57
  ```sh
43
- curl -fsSL https://raw.githubusercontent.com/arthurpanhku/dvalincode/main/scripts/install.sh | bash
44
- dvalincode trust
58
+ dvalincode dvalin . --fix --verify --draft-pr
45
59
  ```
46
60
 
47
- `trust` 打印本机的**实时安全态势**:解析后的组织策略及其哈希、各边界的网络强制状态(provider · shell · MCP)、防篡改审计状态——安全评审需要的证据,由工具自己给出。
61
+ 这一步**才**会用到模型 —— 你自己的模型,任何 OpenAI 兼容端点。它在隔离的 worktree
62
+ 里准备聚焦修复,运行你的测试,并且必须通过一次干净的复扫,才允许进入 Draft PR。
63
+ 它不会自动合并,也不会把「扫描干净」当成「代码安全」的证明。
48
64
 
49
65
  <p align="center">
50
- <img src="assets/cli-trust.gif" alt="dvalincode trust —— 组织策略下的实时安全态势" width="100%">
66
+ <img src="assets/dvalin-remediation.gif" alt="Dvalin 扫描有漏洞的 OWASP NodeGoat 示例得到 22/100 F 与 10 条发现,修复后复扫为 100/100 A" width="100%">
51
67
  </p>
52
68
 
53
- 然后让 agent 干活,事后证明它做过什么:
69
+ 这段动图来自真实应用,不是设计稿。输入代码改编自 Apache-2.0
70
+ 许可的 [OWASP NodeGoat](https://github.com/OWASP/NodeGoat/tree/c5cb68a7084e4ae7dcc60e6a98768720a81841e8/app/routes),
71
+ 原始 contribution route 会执行用户可控文本。
72
+
73
+ ## 🛡️ 上面那次运行到底做了什么
74
+
75
+ Dvalin 把开源扫描器的证据组织成受控的“扫描 → 修复 → 测试 → 复扫 → Draft PR”
76
+ 闭环。上面动图里那次运行,量化如下:
77
+
78
+ | NodeGoat 改编案例真实运行 | 修复前 | Dvalin 修复后 |
79
+ |---|---:|---:|
80
+ | 安全健康分(分诊启发式) | 22 / 100 · F | 100 / 100 · A |
81
+ | 发现项 | 10 条(2 个引擎、3 条规则命中 `eval`) | 0 条 |
82
+ | 测试 | 2 条通过 | 3 条通过,新增注入回归测试 |
83
+ | 扫描器 | 4 / 4 完成 | 4 / 4 完成 |
84
+
85
+ 扫描与加固的**控制平面**采用开源组件:
86
+
87
+ - [Semgrep CE](https://github.com/semgrep/semgrep) 与社区规则:语义 SAST。
88
+ - [Trivy](https://github.com/aquasecurity/trivy):文件系统漏洞、Secrets 与错误配置。
89
+ - [OSV-Scanner](https://github.com/google/osv-scanner) 与开放的
90
+ [OSV 数据库](https://osv.dev/):依赖漏洞。
91
+ - DvalinCode 自身 MIT 许可的内置规则、修复编排、测试/复扫门禁,以及用于接入
92
+ 其他扫描器的 [SARIF 2.1](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html)。
93
+
94
+ 扫描器负责发现和排序证据;配置的模型提出源码修改;DvalinCode 约束执行范围、
95
+ 记录 diff、运行项目测试、重新扫描变更树,并要求用户显式发布 PR。它不会自动合并,
96
+ 也不会把一次干净扫描宣称为“没有漏洞”。若修复建议也必须完全本地、开放,可通过
97
+ Ollama 选择开放权重模型;托管模型的许可取决于相应 provider。
98
+
99
+ 事后仍可证明 agent 做过什么:
54
100
 
55
101
  ```sh
56
102
  dvalincode report verify # 重新推导上次运行审计日志的哈希链
@@ -58,16 +104,31 @@ dvalincode report verify # 重新推导上次运行审计日志的哈希链
58
104
 
59
105
  ---
60
106
 
107
+ ## 🏛️ 而且它过得了安全评审
108
+
109
+ 当依赖这套工具的不止你一个人时,上面那条命令才是真正要紧的东西。DvalinCode 是一个
110
+ 完整的编码代理 —— 终端、Web GUI、桌面应用 —— 但它的设计前提是:**由组织、而不是
111
+ 开发者本人**来划定它能做什么。策略文件约束模式、命令、路径、工具和模型;每次运行
112
+ 都以哈希链写入防篡改审计日志;没有被出网守卫放行的东西不会到达任何 provider。
113
+ 仓库级策略只能**收紧**机器级策略,永远不能放宽。
114
+
115
+ 如果你正是那个需要审批这类工具的人,请从
116
+ [APPROVABILITY-PLAN.md](docs/APPROVABILITY-PLAN.md) 和每个版本随包发布的
117
+ [Evidence Pack](docs/EVIDENCE-PACK.md) 开始看。
118
+
119
+ ---
120
+
61
121
  <table>
62
- <tr><td><b>🗨️ Chat 模式</b></td><td>只读问答,附带一键提示词模板 —— 解释代码库、查找 TODO、审查变更、写测试。Agent 可读文件、可搜索,但绝不写入。</td></tr>
63
- <tr><td><b>👥 Cowork 模式</b></td><td>先规划后执行。Agent 写出编号步骤,你点 <b>Proceed</b>,每次文件写入都需要明确批准——批准前会看到红绿 diff。</td></tr>
64
- <tr><td><b>⚡ Code 模式</b></td><td>自主代理,全工具权限。一键运行测试、类型检查、构建、Lint(侧栏 <b>Routines</b> 面板)。macOS shell 调用在 <code>sandbox-exec</code> 沙箱内执行,网络被禁用。</td></tr>
122
+ <tr><td><b>🏠 Home</b></td><td>统一容纳只读 <b>Ask</b> 与逐操作审批的 <b>Collaborate</b>,切换意图时不离开当前项目和对话。</td></tr>
123
+ <tr><td><b>⚡ Code</b></td><td>专注自主编码,支持 Ask / Plan / Auto / Bypass 权限级别;旧 Security 与 Routines 已从 Code 移除。</td></tr>
124
+ <tr><td><b>🛡️ Dvalin</b></td><td>专用白盒安全工程工作区:编排内置扫描器、Semgrep CE、Trivy、OSV-Scanner,分诊并修复发现项,运行测试和复扫,最后显式发布可审查的 Draft PR。<a href="docs/DVALIN.md">Dvalin 指南 →</a></td></tr>
65
125
  <tr><td><b>🏦 高合规团队</b></td><td>为金融、医疗、安全敏感 SaaS、内部平台团队设计:AI 编码不仅要方便开发者,还要满足策略约束、审计、数据最小化和供应链审查。</td></tr>
66
126
  <tr><td><b>🛡️ 安全修复闭环</b></td><td>运行本地安全扫描,或导入 CodeQL、GitHub Code Scanning、Semgrep 及兼容扫描器的 SARIF;随后创建隔离 remediation worktree,把发现项转成带源码上下文和 PR 就绪报告的聚焦修复任务。<a href="docs/SECURE-REMEDIATION.md">流程 →</a></td></tr>
67
127
  <tr><td><b>📚 Skills</b></td><td>上传、下载和查看本地 skill bundle。DvalinCode 内置 secure-code-scan 与 secure-code-remediation skills,并提供列出 skill、读取 skill 说明、扫描、列出 case、准备 remediation worktree 的 agent tools。<a href="docs/SKILLS.md">格式 →</a></td></tr>
68
128
  <tr><td><b>🛡️ 审计日志</b></td><td>每次运行都生成防篡改、哈希链式的 JSONL 日志 —— 每次文件读写、每条命令、每次审批都被记录。Run Report 将其渲染为 Markdown;<code>dvalincode report verify</code> 可验证链条完好。<a href="docs/AUDIT-TRAIL.md">威胁模型 →</a></td></tr>
69
129
  <tr><td><b>🔒 组织级策略 &amp; <code>trust</code></b></td><td>由公司、而非开发者来约束 Agent。一个 <code>dvalin.policy.json</code> 限定模式、shell 命令、文件路径、工具与模型;仓库级策略只能让机器级策略<i>更严</i>、永不放宽。每次运行都记录所遵循策略的哈希。<code>dvalincode trust</code> 直接打印本机的实时安全态势 —— 生效策略 + 哈希、审计状态、运行时 —— 让审批人自行核验。<a href="docs/POLICY-REFERENCE.md">策略参考 →</a> · <a href="docs/APPROVABILITY-PLAN.md">可审批性方案 →</a></td></tr>
70
- <tr><td><b>🏛️ 治理证据</b></td><td>仓库维护 OpenSSF Scorecard、CodeQL、Dependabot、固定 SHA 的 GitHub Actions、CODEOWNERS,以及 ISO/IEC 42001 AIMS 对齐文档,作为可审查的项目治理证据。<a href="docs/security/OPENSSF-SCORECARD.md">Scorecard 映射 →</a> · <a href="docs/governance/ISO-42001-AIMS.md">ISO 42001 对齐 →</a></td></tr>
130
+ <tr><td><b>🏛️ 治理证据</b></td><td>仓库维护 OpenSSF Scorecard、CodeQL、Dependabot、固定 SHA 的 GitHub Actions、CODEOWNERS,以及 ISO/IEC 42001 AIMS 对齐文档,作为可审查的项目治理证据;每个 release 还附带一份由该二进制给自己生成的 Evidence Pack。<a href="docs/security/OPENSSF-SCORECARD.md">Scorecard 映射 →</a> · <a href="docs/governance/ISO-42001-AIMS.md">ISO 42001 对齐 →</a> · <a href="docs/RELEASE-EVIDENCE.md">发布证据 →</a></td></tr>
131
+ <tr><td><b>📐 开放规范</b></td><td><b>PCP-1</b> —— 把模型提供方边界的约束(出网收敛、凭据收敛、审计、策略绑定)写成与厂商无关、带测试步骤的开放规范,任何 agent 运行时都可以拿它跑自己的 adapter 并公开结果。它不是 DvalinCode 的一个测试文件,而是别人同样可以用来衡量我们的清单。<a href="docs/spec/PROVIDER-CONFORMANCE.md">Provider Conformance Profile →</a></td></tr>
71
132
  <tr><td><b>🖥️ 一流的 GUI</b></td><td>现代化 Web UI,包含代码语法高亮、<code>@</code> 文件引用、<code>/</code> 斜杠命令、Git 分支显示、实时 Token 与费用统计、多 LLM Profile,以及暗色 / 浅色 / 跟随系统的主题切换。</td></tr>
72
133
  <tr><td><b>🖥️ 终端或 Web,同一个二进制</b></td><td>直接运行进入交互式<b>终端代理</b>,支持流式输出、行内审批和红绿 diff;或 <code>dvalincode serve</code> 启动 <b>Web GUI</b> 供浏览器/远程使用。两个前端共用同一套 agent 内核。</td></tr>
73
134
  <tr><td><b>🖥️ 原生桌面应用</b></td><td><code>DvalinCode.app</code> —— 真正的 Dock 应用(系统原生 webview,非 Electron),驱动同一套引擎。macOS 上一行安装命令会自动装进 <code>/Applications</code>,从启动台直接打开。</td></tr>
@@ -117,6 +178,12 @@ DvalinCode 的差异化在于 **可审批性**。它面向那些必须先通过
117
178
 
118
179
  ## 🛡️ 安全与治理
119
180
 
181
+ <p align="center">
182
+ <a href="docs/governance/ISO-42001-AIMS.md"><img src="https://img.shields.io/badge/ISO%2FIEC%2042001-AIMS%20Aligned-0F766E?style=for-the-badge" alt="ISO/IEC 42001 AIMS aligned"></a>
183
+ <a href="docs/EVIDENCE-PACK.md"><img src="https://img.shields.io/badge/Compliance-Evidence%20Pack-2563EB?style=for-the-badge" alt="Compliance evidence pack"></a>
184
+ <a href="docs/security/OPENSSF-SCORECARD.md"><img src="https://img.shields.io/badge/DevSecOps-Native-B91C1C?style=for-the-badge" alt="DevSecOps native"></a>
185
+ </p>
186
+
120
187
  DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审。这是面向
121
188
  高合规团队的核心差异化:AI 编码工具进入生产仓库前,必须先能过安全审批。
122
189
 
@@ -142,6 +209,21 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
142
209
 
143
210
  ---
144
211
 
212
+ ## ⭐ v0.14.0 新功能 —— Dvalin 安全工程
213
+
214
+ - **Home 合并 Chat 与 Cowork** —— Home 统一提供只读 Ask 与审批式 Collaborate,
215
+ 保持同一个项目和对话上下文。
216
+ - **Code 回归专注开发** —— 旧 Security 与 Routines 面板已移除,侧栏只服务项目与
217
+ 自主实现工作流。
218
+ - **Dvalin 成为一等工作区** —— 编排内置扫描器、Semgrep CE、Trivy、OSV-Scanner;
219
+ 导入 SARIF;评分并分诊发现项;持久化 remediation case;创建隔离修复 worktree。
220
+ - **从证据到 Draft PR 的闭环** —— 选中的发现项可启动带源码证据的 Agent 修复,
221
+ 运行测试、类型检查、构建与复扫,审查 diff 后再显式发布 Draft PR,永不自动合并。
222
+ - **Agent loop 更早收敛、成本更低** —— 编辑前调查、停滞检测、统一工具输出上限、
223
+ append-only prompt 缓存,以及 provider cache hit/miss 统计均已落地。
224
+
225
+ ---
226
+
145
227
  ## ⭐ v0.12.3 新功能 —— 长时间 Code 模式更可靠
146
228
 
147
229
  - **长编程任务持续执行** —— Code 模式现在会在工具循环执行过程中动态压缩上下文,
@@ -254,53 +336,29 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
254
336
 
255
337
  ## 📸 预览
256
338
 
257
- <p align="center">
258
- <img src="assets/hero.png" alt="DvalinCode UI" width="100%">
259
- </p>
260
-
261
- **切换模式 —— 每种模式都有不同的侧边栏:**
339
+ **真实漏洞代码的 Dvalin 扫描——安全健康分 22/100 · F,以及引擎实际报出的
340
+ 10 条发现,逐行定位:**
262
341
 
263
342
  <p align="center">
264
- <img src="assets/modes.gif" alt="切换模式" width="100%">
343
+ <img src="assets/hero.png" alt="Dvalin 安全健康分显示 22/100 F、4 条高危与 6 条中危,Findings 列表把每处 eval 定位到 NodeGoat 改编路由的具体行" width="100%">
265
344
  </p>
266
345
 
267
- **输入框中的斜杠命令与文件引用:**
346
+ **验证后的结果——3 处 `eval` 调用改为受约束的数值解析、新增 1 条注入回归测试、
347
+ 4 个开源引擎均完成,0 条发现,100/100 · A:**
268
348
 
269
349
  <p align="center">
270
- <img src="assets/slash.gif" alt="斜杠命令与文件引用" width="100%">
350
+ <img src="assets/dvalin-scan-after.jpg" alt="Dvalin 验证复扫显示 100/100 A、0 条发现,以及产生该结果的修复会话" width="100%">
271
351
  </p>
272
352
 
273
- ### 🔒 命令行里的治理
274
-
275
- **`dvalincode trust` —— 本次安装的实时安全姿态(解析后的策略、各边界的强制状态、审计情况),安全评审可直接阅读。** 字段语义和可复制策略配方见:[docs/POLICY-REFERENCE.md](docs/POLICY-REFERENCE.md)。
276
-
277
- <p align="center">
278
- <img src="assets/cli-trust.gif" alt="dvalincode trust —— 组织策略下的实时安全姿态" width="100%">
279
- </p>
280
-
281
- **`dvalincode policy check` —— 在 CI 中校验 `dvalin.policy.json`:模式校验、经机器层收紧后的解析策略及其规范哈希。**
282
-
283
- <p align="center">
284
- <img src="assets/cli-policy.gif" alt="dvalincode policy check —— 校验并检视解析后的组织策略" width="100%">
285
- </p>
286
-
287
- **防篡改审计 —— 每次 agent 运行都是一条哈希链式、已最小化的报告,可离线验证:**
288
-
289
- <p align="center">
290
- <img src="assets/cli-audit.gif" alt="dvalincode report —— 运行报告,随后 report verify 证明哈希链完整" width="100%">
291
- </p>
292
-
293
- **证据包 —— 一条命令把策略、安全姿态与审计证明打包成单个文件,评审可完全离线验证:**
353
+ **Home → Code → Dvalin——当前三个工作区:**
294
354
 
295
355
  <p align="center">
296
- <img src="assets/cli-evidence.gif" alt="dvalincode evidence export 与 verify —— 可离线验证的治理证据" width="100%">
356
+ <img src="assets/modes.gif" alt="DvalinCode 在 Home、Code 与 Dvalin 之间切换" width="100%">
297
357
  </p>
298
358
 
299
- **项目情报 —— `dvalincode scan` 在 agent 动手之前先摸清工作区:**
300
-
301
- <p align="center">
302
- <img src="assets/cli-scan.gif" alt="dvalincode scan —— 项目情报" width="100%">
303
- </p>
359
+ 以上扫描画面是文档所述 NodeGoat 改编案例上一次真实运行的未修图截图:先运行扫描器,
360
+ 再由模型修复源码,然后运行项目测试并复扫。没有任何摆拍;100/A 只代表所配置的引擎
361
+ 未发现问题,不代表代码已被证明安全。
304
362
 
305
363
  ---
306
364
 
@@ -335,8 +393,13 @@ dvalincode dvalin . # 白盒安全扫描
335
393
  dvalincode dvalin . --fix --verify --draft-pr # 隔离修复、验证并创建草稿 PR
336
394
  dvalincode serve # 启动 Web GUI 并打开浏览器
337
395
  dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器,供远程/浏览器访问
396
+ echo "检查 src 并总结" | dvalincode run - --output-format stream-json
397
+ dvalincode mcp-serve # 供外部 Agent 调用的任务级 stdio MCP 服务
338
398
  ```
339
399
 
400
+ 无头 `run` 和 `mcp-serve` 与交互客户端共用同一个策略与审计关卡。cron、CI
401
+ 和外部 Agent 示例见[无人值守配方](docs/RECIPES-UNATTENDED.md)。
402
+
340
403
  ### Windows
341
404
 
342
405
  从 [Releases](https://github.com/arthurpanhku/dvalincode/releases/latest) 下载 `dvalincode-v*-windows-x64.zip`,解压后双击 `start.bat`。
@@ -355,6 +418,16 @@ dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器,供远程/浏
355
418
 
356
419
  每个 release 都附带 `SHA256SUMS.txt` 用于校验。
357
420
 
421
+ 每个 release 还附带 **`dvalincode-v*-evidence.json`** —— 由发布出去的那个二进制在构建机上给自己生成的
422
+ Evidence Pack:两次真实的受治理运行(一次放行、一次被策略拦截)及其哈希链。安装之前就可以自己核验本页的说法:
423
+
424
+ ```sh
425
+ dvalincode evidence verify dvalincode-v0.14.0-evidence.json # 离线,只读这一个文件
426
+ ```
427
+
428
+ 该文件的校验和写在 `SHA256SUMS.txt` 里,而 `SHA256SUMS.txt` 正是 release 构建溯源签名(build provenance
429
+ attestation)的签署对象。[生成方式 →](docs/RELEASE-EVIDENCE.md)
430
+
358
431
  > **macOS Gatekeeper:** 二进制未签名。首次运行可执行 `xattr -dr com.apple.quarantine ~/.dvalincode`,或在 Finder 中右键 → 打开一次。
359
432
 
360
433
  ### 保持更新
@@ -372,7 +445,7 @@ dvalincode update # 下载、校验并安装最新版本
372
445
 
373
446
  ## 🎬 首次配置
374
447
 
375
- **终端(默认):** 运行 `dvalincode`。首次启动会引导你完成一次性的 Provider 配置(选择 Provider、粘贴 API Key、选择模型),保存到 `~/.dvalincode/config.json`。随后即进入对话提示符 —— 直接输入即可对话,`/mode` 切换 Chat / Cowork / Code,`/help` 查看命令。
448
+ **终端(默认):** 运行 `dvalincode`。首次启动会引导你完成一次性的 Provider 配置(选择 Provider、粘贴 API Key、选择模型),保存到 `~/.dvalincode/config.json`。随后即进入对话提示符 —— 直接输入即可对话,`/mode` 切换 Home / Code / Dvalin,`/help` 查看命令。
376
449
 
377
450
  **Web GUI:** 运行 `dvalincode serve`:
378
451
 
@@ -389,17 +462,17 @@ dvalincode update # 下载、校验并安装最新版本
389
462
 
390
463
  | 类别 | 功能 | 说明 |
391
464
  |---|---|---|
392
- | **模式** | Chat / Cowork / Code | 各自独立的侧边栏(Templates / Projects / Routines)与工具权限策略 |
465
+ | **模式** | Home / Code / Dvalin | Home 包含只读 Ask 与审批式 Collaborate;Code 专注开发;Dvalin 是扫描到修复的安全工作区 |
393
466
  | **Code 权限** | Ask Permissions / Plan Mode / Auto Mode / Bypass permissions | 已验证行为:Ask 在写入/命令前请求批准,Plan 只读且不写文件,Auto 自动执行操作,Bypass 不再弹出确认 |
394
- | **工作区** | 打开文件夹 / 导入 Git / 添加 worktree | Cowork 与 Code 可在 UI 中切换到本地文件夹、克隆 Git 项目,或创建 Git worktree |
467
+ | **工作区** | 打开文件夹 / 导入 Git / 添加 worktree | Home、Code 与 Dvalin 可使用本地文件夹、Git 项目和隔离 remediation worktree |
395
468
  | **治理** | OpenSSF Scorecard / ISO 42001 AIMS 对齐 | Scorecard、CodeQL、Dependabot、固定 SHA 的 Actions、AI 影响评估、风险登记和审查节奏记录在 `docs/security/` 与 `docs/governance/` |
396
- | **安全修复** | 本地扫描 / SARIF 导入 / case 队列 / remediation worktree | Code 模式可扫描常见本地风险、导入 SARIF findings、持久化本地 cases,并创建带修复 prompt 的隔离 `dvalin/remediate/...` worktree |
469
+ | **安全修复** | 内置 + Semgrep CE + Trivy + OSV-Scanner / SARIF / 测试 / Draft PR | Dvalin 检测已安装引擎、统一 SARIF、风险评分、驱动证据化修复、验证变更,并只在用户显式操作后发布 Draft PR |
397
470
  | **Skills** | 上传 / 下载 / 内置安全 skills | Skills 保存在 `~/.dvalincode/skills`;内置 skills 用专门的 agent tools 引导安全扫描与修复。[格式 →](docs/SKILLS.md) |
398
471
  | **输入框** | `@` 文件引用 | 输入 `@` 触发模糊文件搜索,选中文件自动插入到 prompt |
399
472
  | | `/` 斜杠命令 | `/clear` `/compact` `/git` `/plan` `/undo` `/help` |
400
473
  | | 多行输入 + 中断 | <kbd>Shift</kbd>+<kbd>Enter</kbd> 换行,Stop 按钮中断生成 |
401
474
  | **工具 UI** | 行内 diff | `edit_file` 与 `write_file` 结果以红绿统一 diff 呈现,默认折叠 |
402
- | | 审批对话框含 diff | Cowork 模式下,文件变更在执行前显示 diff |
475
+ | | 审批对话框含 diff | Home → Collaborate 下,文件变更在执行前显示 diff |
403
476
  | | 实时工具计数 + Token + 费用 | 顶栏实时显示当前 session 累计数据 |
404
477
  | **Agent** | LLM 上下文压缩 | `/compact` 将历史压缩为 目标/已完成/决策/待办 结构化摘要 |
405
478
  | | 持久化 Undo 栈 | `/undo [N]` 撤销最近 N 个工具调用 |
@@ -409,7 +482,7 @@ dvalincode update # 下载、校验并安装最新版本
409
482
  | **安全** | 防篡改审计日志 | 每次运行在 `~/.dvalincode/audit/` 生成哈希链 JSONL;`dvalincode report verify` 可检测修改 |
410
483
  | | macOS Shell 沙箱 | `sandbox-exec` 拒绝网络;写入仅限 cwd 与 `/tmp` |
411
484
  | | `.dvalincodeignore` | 类 gitignore 排除;阻止 `read_file` / `list_files` / `search_text` |
412
- | | 逐操作审批 | Cowork 模式下每次写入/删除/shell 都需用户批准 |
485
+ | | 逐操作审批 | Home → Collaborate 下每次写入/删除/shell 都需用户批准 |
413
486
  | **外观** | 主题切换 | 暗色 / 浅色 / 跟随系统,持久保存;`跟随系统` 实时跟随 OS |
414
487
  | **Providers** | OpenAI 兼容端点 | DeepSeek · OpenAI · Groq · OpenRouter · Ollama · 自定义 |
415
488
  | | 多 Profile 配置 | 保存并切换多组 (provider, model, API key) 命名配置 |
@@ -492,7 +565,7 @@ RESTORE → COMPACT → COMMAND → BUILD → RUN → SAVE → RESPOND → DONE
492
565
  npm test
493
566
  ```
494
567
 
495
- **229 个测试 · 40 个文件 · 全部通过。**
568
+ **323 个测试 · 49 个文件 · 全部通过。**
496
569
 
497
570
  ---
498
571
 
@@ -563,13 +636,19 @@ DvalinCode 顶栏实时显示本 session 的费用 —— 在 **LLM Configuratio
563
636
  <details>
564
637
  <summary><b>为什么三种模式?只用一种不行吗?</b></summary>
565
638
  <br>
566
- 每种模式有不同的<b>工具权限</b>和<b>安全默认值</b>:Chat 只读;Cowork 每次写入都需要批准;Code 全自动。三种模式还有不同的侧边栏(Templates / Projects / Routines)面向不同工作流。任何时候都可切换 —— 对话延续。
639
+ 它们面向不同结果和安全默认值:<b>Home</b> 统一只读 Ask 与审批式 Collaborate;<b>Code</b> 专注软件开发;<b>Dvalin</b> 用扫描证据、修复 case、隔离 worktree、测试复扫与显式 Draft PR 完成安全加固。任何时候都可切换并保留项目上下文。
567
640
  </details>
568
641
 
569
642
  <details>
570
643
  <summary><b>Shell 工具有沙箱吗?</b></summary>
571
644
  <br>
572
- macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec</code> 里,profile <i>拒绝网络访问</i>,仅允许写入 <code>cwd</code>、<code>/tmp</code>、<code>/var</code>。Linux 和 Windows 沙箱已规划中。
645
+ macOS 使用 <code>sandbox-exec</code>;Linux 在限制性网络策略下会在已安装 Bubblewrap 时启用它。Windows 暂无受支持的子进程网络沙箱,因此限制性策略会安全关闭执行,不会静默降级为无限制运行。原生命令运行器本身支持这三个平台。
646
+ </details>
647
+
648
+ <details>
649
+ <summary><b>支持哪些操作系统终端?</b></summary>
650
+ <br>
651
+ Linux 与 macOS 命令通过 <code>/bin/sh</code> 执行;Windows 命令通过系统 <code>ComSpec</code>(默认为 <code>cmd.exe</code>)执行。完整原生命令行支持管道、重定向与条件操作符;拆分的 <code>command</code> + <code>args</code> 形式会按宿主 shell 规则引用可执行文件路径及参数。
573
652
  </details>
574
653
 
575
654
  <details>
@@ -581,7 +660,7 @@ macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec
581
660
  <details>
582
661
  <summary><b>会不会不经询问就覆盖我的文件?</b></summary>
583
662
  <br>
584
- 取决于模式。<b>Chat</b> 永不写入;<b>Cowork</b> 每个文件都需逐一批准(批准前可见红绿 diff);<b>Code</b> 全自动 —— 适合受信任的任务或在 feature 分支上使用。
663
+ 取决于模式。<b>Home → Ask</b> 永不写入;<b>Home → Collaborate</b> 每个文件都需逐一批准(批准前可见红绿 diff);<b>Code</b> 与 <b>Dvalin</b> 遵循所选权限级别,Auto 只应在受信任工作区或隔离分支中使用。
585
664
  </details>
586
665
 
587
666
  <details>
@@ -593,9 +672,9 @@ macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec
593
672
  </details>
594
673
 
595
674
  <details>
596
- <summary><b>Code 模式怎么保存 Routine?</b></summary>
675
+ <summary><b>Dvalin 必须安装所有外部扫描器吗?</b></summary>
597
676
  <br>
598
- 切到 Code 模式,点击侧栏 "ROUTINES" 旁的 <b>+</b>。输入名字(如 "Deploy preview")和 prompt 或斜杠命令(如 "<code>/git</code>" 或 "构建项目并部署到 staging")。Routine 保存在浏览器 <code>localStorage</code>。
677
+ 不需要。Dvalin 的内置扫描器始终可用;若 <code>PATH</code> 中检测到 Semgrep CE、Trivy 或 OSV-Scanner,工作区会自动加入相应引擎。也可以导入任意兼容的 SARIF 2.1 结果。
599
678
  </details>
600
679
 
601
680
  <details>
@@ -613,7 +692,7 @@ macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec
613
692
  ```sh
614
693
  git clone https://github.com/arthurpanhku/dvalincode
615
694
  cd dvalincode && npm install
616
- npm test # 65/65 ✅
695
+ npm test # 323/323 ✅
617
696
  npm run typecheck
618
697
  ```
619
698
 
@@ -669,3 +748,21 @@ prompt、UI 文案、工具 schema、模块布局和产品实现均为原创;
669
748
  </picture>
670
749
  </a>
671
750
  </p>
751
+
752
+ ---
753
+
754
+ ## 💛 感谢每一位贡献者
755
+
756
+ <p align="center">
757
+ 每一个 Issue、想法、文档改进、测试和代码贡献,都在帮助 DvalinCode 变得更好。
758
+ </p>
759
+
760
+ <p align="center">
761
+ <a href="https://github.com/arthurpanhku/dvalincode/graphs/contributors">
762
+ <img src="https://contrib.rocks/image?repo=arthurpanhku/dvalincode" alt="DvalinCode 贡献者">
763
+ </a>
764
+ </p>
765
+
766
+ <p align="center">
767
+ <sub>也想加入?阅读<a href="CONTRIBUTING.md">贡献指南</a>,提交你的第一个 Pull Request。</sub>
768
+ </p>