dvalincode 0.12.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 (152) hide show
  1. package/README.md +278 -81
  2. package/README.zh-CN.md +219 -74
  3. package/THIRD_PARTY_NOTICES.md +295 -147
  4. package/dist/agent/compact.d.ts +4 -2
  5. package/dist/agent/compact.js +41 -7
  6. package/dist/agent/compact.js.map +1 -1
  7. package/dist/agent/loop.d.ts +8 -0
  8. package/dist/agent/loop.js +38 -32
  9. package/dist/agent/loop.js.map +1 -1
  10. package/dist/agent/modes.d.ts +2 -2
  11. package/dist/agent/modes.js +6 -3
  12. package/dist/agent/modes.js.map +1 -1
  13. package/dist/agent/runner.d.ts +15 -6
  14. package/dist/agent/runner.js +379 -75
  15. package/dist/agent/runner.js.map +1 -1
  16. package/dist/agent/session.d.ts +26 -2
  17. package/dist/agent/session.js +85 -12
  18. package/dist/agent/session.js.map +1 -1
  19. package/dist/agent/types.d.ts +12 -5
  20. package/dist/agent/types.js +12 -2
  21. package/dist/agent/types.js.map +1 -1
  22. package/dist/audit/log.d.ts +7 -1
  23. package/dist/audit/log.js.map +1 -1
  24. package/dist/audit/report.js +7 -0
  25. package/dist/audit/report.js.map +1 -1
  26. package/dist/cli.js +30 -3
  27. package/dist/cli.js.map +1 -1
  28. package/dist/commands/chat.js +1 -1
  29. package/dist/commands/chat.js.map +1 -1
  30. package/dist/commands/dvalin.d.ts +9 -0
  31. package/dist/commands/dvalin.js +234 -0
  32. package/dist/commands/dvalin.js.map +1 -0
  33. package/dist/commands/mcpServe.d.ts +2 -0
  34. package/dist/commands/mcpServe.js +36 -0
  35. package/dist/commands/mcpServe.js.map +1 -0
  36. package/dist/commands/policy.js +12 -0
  37. package/dist/commands/policy.js.map +1 -1
  38. package/dist/commands/provider.js +3 -3
  39. package/dist/commands/provider.js.map +1 -1
  40. package/dist/commands/run.d.ts +30 -0
  41. package/dist/commands/run.js +229 -0
  42. package/dist/commands/run.js.map +1 -0
  43. package/dist/commands/tui.js +2 -2
  44. package/dist/commands/tui.js.map +1 -1
  45. package/dist/commands/update.d.ts +2 -0
  46. package/dist/commands/update.js +238 -0
  47. package/dist/commands/update.js.map +1 -0
  48. package/dist/core/context.d.ts +4 -0
  49. package/dist/core/context.js +8 -1
  50. package/dist/core/context.js.map +1 -1
  51. package/dist/core/guiUpdate.d.ts +27 -0
  52. package/dist/core/guiUpdate.js +65 -0
  53. package/dist/core/guiUpdate.js.map +1 -0
  54. package/dist/core/policy.d.ts +27 -3
  55. package/dist/core/policy.js +40 -1
  56. package/dist/core/policy.js.map +1 -1
  57. package/dist/core/selfUpdate.d.ts +108 -0
  58. package/dist/core/selfUpdate.js +180 -0
  59. package/dist/core/selfUpdate.js.map +1 -0
  60. package/dist/core/subprocessSandbox.d.ts +59 -0
  61. package/dist/core/subprocessSandbox.js +274 -23
  62. package/dist/core/subprocessSandbox.js.map +1 -1
  63. package/dist/core/trust.d.ts +8 -0
  64. package/dist/core/trust.js +13 -10
  65. package/dist/core/trust.js.map +1 -1
  66. package/dist/core/workspace.js +2 -1
  67. package/dist/core/workspace.js.map +1 -1
  68. package/dist/harness/run.d.ts +70 -0
  69. package/dist/harness/run.js +185 -0
  70. package/dist/harness/run.js.map +1 -0
  71. package/dist/mcp/client.d.ts +12 -0
  72. package/dist/mcp/client.js +2 -2
  73. package/dist/mcp/client.js.map +1 -1
  74. package/dist/mcp/config.d.ts +33 -3
  75. package/dist/mcp/config.js +32 -3
  76. package/dist/mcp/config.js.map +1 -1
  77. package/dist/mcp/register.d.ts +23 -6
  78. package/dist/mcp/register.js +42 -8
  79. package/dist/mcp/register.js.map +1 -1
  80. package/dist/mcp/server.d.ts +35 -0
  81. package/dist/mcp/server.js +230 -0
  82. package/dist/mcp/server.js.map +1 -0
  83. package/dist/mcp/stdio.d.ts +34 -0
  84. package/dist/mcp/stdio.js +183 -0
  85. package/dist/mcp/stdio.js.map +1 -0
  86. package/dist/providers/anthropic.d.ts +14 -0
  87. package/dist/providers/anthropic.js +244 -0
  88. package/dist/providers/anthropic.js.map +1 -0
  89. package/dist/providers/manager.d.ts +3 -0
  90. package/dist/providers/manager.js +13 -2
  91. package/dist/providers/manager.js.map +1 -1
  92. package/dist/providers/openaiCompatible.d.ts +12 -1
  93. package/dist/providers/openaiCompatible.js +21 -6
  94. package/dist/providers/openaiCompatible.js.map +1 -1
  95. package/dist/providers/pool.js +3 -4
  96. package/dist/providers/pool.js.map +1 -1
  97. package/dist/providers/trustedBaseUrls.js +1 -0
  98. package/dist/providers/trustedBaseUrls.js.map +1 -1
  99. package/dist/providers/types.d.ts +20 -4
  100. package/dist/remediation/automate.d.ts +18 -0
  101. package/dist/remediation/automate.js +78 -0
  102. package/dist/remediation/automate.js.map +1 -0
  103. package/dist/remediation/localScan.js +9 -1
  104. package/dist/remediation/localScan.js.map +1 -1
  105. package/dist/remediation/sarif.js +18 -4
  106. package/dist/remediation/sarif.js.map +1 -1
  107. package/dist/remediation/sarifExport.d.ts +7 -0
  108. package/dist/remediation/sarifExport.js +102 -0
  109. package/dist/remediation/sarifExport.js.map +1 -0
  110. package/dist/remediation/scannerSuite.d.ts +43 -0
  111. package/dist/remediation/scannerSuite.js +258 -0
  112. package/dist/remediation/scannerSuite.js.map +1 -0
  113. package/dist/server/configStore.d.ts +2 -8
  114. package/dist/server/configStore.js +12 -7
  115. package/dist/server/configStore.js.map +1 -1
  116. package/dist/server/routes/config.js +2 -3
  117. package/dist/server/routes/config.js.map +1 -1
  118. package/dist/server/routes/remediation.js +34 -0
  119. package/dist/server/routes/remediation.js.map +1 -1
  120. package/dist/server/scannerWorkspaceGrants.d.ts +7 -0
  121. package/dist/server/scannerWorkspaceGrants.js +48 -0
  122. package/dist/server/scannerWorkspaceGrants.js.map +1 -0
  123. package/dist/server/security.js +20 -6
  124. package/dist/server/security.js.map +1 -1
  125. package/dist/server/wsHandler.js +8 -0
  126. package/dist/server/wsHandler.js.map +1 -1
  127. package/dist/skills/store.js +28 -0
  128. package/dist/skills/store.js.map +1 -1
  129. package/dist/tools/registry.d.ts +7 -0
  130. package/dist/tools/registry.js +30 -0
  131. package/dist/tools/registry.js.map +1 -1
  132. package/dist/tools/runCheck.js +1 -0
  133. package/dist/tools/runCheck.js.map +1 -1
  134. package/dist/tools/runSecuritySuite.d.ts +14 -0
  135. package/dist/tools/runSecuritySuite.js +35 -0
  136. package/dist/tools/runSecuritySuite.js.map +1 -0
  137. package/dist/tools/shell.d.ts +3 -1
  138. package/dist/tools/shell.js +16 -6
  139. package/dist/tools/shell.js.map +1 -1
  140. package/dist/tui/app.d.ts +1 -0
  141. package/dist/tui/app.js +114 -17
  142. package/dist/tui/app.js.map +1 -1
  143. package/dist/tui/presets.d.ts +2 -2
  144. package/dist/tui/presets.js +1 -0
  145. package/dist/tui/presets.js.map +1 -1
  146. package/dist/tui/render.d.ts +1 -0
  147. package/dist/tui/render.js +13 -1
  148. package/dist/tui/render.js.map +1 -1
  149. package/dist/version.d.ts +8 -0
  150. package/dist/version.js +9 -0
  151. package/dist/version.js.map +1 -0
  152. package/package.json +7 -5
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-203%20%2F%20203%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
+ ```
37
32
 
38
- ## ⏱️ 60 秒自证
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
+ ```
39
50
 
40
- 别听宣传——在你自己的机器上验证:
51
+ 扫描结果会直接标注在 PR 的 diff 上,同时进入仓库的 Security 页。不需要 API Key、
52
+ 不需要任何 secret、不调用模型 —— 扫描是确定性的,且只在 runner 本地进行。
53
+ [完整示例 →](docs/examples/dvalin-scan.yml)
54
+
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,18 +104,34 @@ 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>
134
+ <tr><td><b>🖥️ 原生桌面应用</b></td><td><code>DvalinCode.app</code> —— 真正的 Dock 应用(系统原生 webview,非 Electron),驱动同一套引擎。macOS 上一行安装命令会自动装进 <code>/Applications</code>,从启动台直接打开。</td></tr>
73
135
  <tr><td><b>🪶 零依赖二进制</b></td><td>每平台单文件可执行程序 ~25MB。无需 Node、Python、Docker。</td></tr>
74
136
  <tr><td><b>🔐 本地优先</b></td><td>Session、配置、Profile、审计日志均保存在 <code>~/.dvalincode/</code>。<code>.dvalincodeignore</code> 阻止 Agent 访问敏感文件。仓库根目录的 <code>AGENTS.md</code> 作为项目级持久指令自动加载。</td></tr>
75
137
  <tr><td><b>💾 可导出、可迁移</b></td><td>把<b>所有</b>本地数据(记忆、Session、配置、审计)导出为一个文件,在另一台机器导入 —— 整套环境随身带走。任意对话都能下载为干净的 <b>Markdown</b> 记录。</td></tr>
@@ -116,6 +178,12 @@ DvalinCode 的差异化在于 **可审批性**。它面向那些必须先通过
116
178
 
117
179
  ## 🛡️ 安全与治理
118
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
+
119
187
  DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审。这是面向
120
188
  高合规团队的核心差异化:AI 编码工具进入生产仓库前,必须先能过安全审批。
121
189
 
@@ -141,7 +209,54 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
141
209
 
142
210
  ---
143
211
 
144
- ## ⭐ v0.9.0 新功能 —— 🛡️ 安全修复闭环 · Skills · CodeQL 加固
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
+
227
+ ## ⭐ v0.12.3 新功能 —— 长时间 Code 模式更可靠
228
+
229
+ - **长编程任务持续执行** —— Code 模式现在会在工具循环执行过程中动态压缩上下文,
230
+ Token 估算覆盖完整 provider 请求,并将默认迭代检查点从 10 提升到 40。
231
+ - **中断后可以续接** —— 回合被中断或连接关闭时,会保存已经完成的工具状态;后续发送
232
+ `continue` 即可从工作区的真实进度继续。
233
+ - **Agent 活动清晰而安静** —— 运行中的 session 会在侧栏显示 loading 状态;每次回复
234
+ 显示工作耗时,点击即可查看 Action 时间线,原始 Tool Call 默认保持折叠。
235
+ - **Code 模式支持 GitHub 工作流** —— 具备网络感知的 `git` 与 GitHub CLI(`gh`)
236
+ 操作现在可通过受控 shell 审批路径执行 pull、push、创建 PR,以及 Actions / 仓库命令。
237
+ - **更安全的发布流程** —— package 与 CLI 版本保持同步,`prepublishOnly` 会在发布前运行
238
+ 构建、类型检查和完整测试。
239
+ - **简单需求保持简单** —— Action 预算现在对整轮生效,不再每次模型迭代重置;Code 模式
240
+ 会优先选择最短直接路径,并在针对性验证通过后停止。
241
+
242
+ ---
243
+
244
+ ## ⭐ v0.12.2 新功能 —— 🖥️ 桌面应用里程碑:开箱即用
245
+
246
+ - **🖥️ 原生桌面应用在 macOS 上开箱即用** —— `DvalinCode.app` 现在能真正打开
247
+ 一个原生 Dock 窗口(WKWebView,非 Electron),驱动内嵌引擎。修复了此前所有
248
+ 桌面构建都存在的两个线程问题:阻塞式 webview 循环不再饿死内嵌服务器(空白
249
+ 窗口),webview 按 macOS 要求跑在主线程(否则窗口根本不出现)—— 服务器改由
250
+ 同一二进制的子进程承载。
251
+ - **📦 一行安装命令即装桌面应用** —— macOS 上 `curl … install.sh | bash`
252
+ 现在会把带 DvalinCode 图标的 `DvalinCode.app` 装进 `/Applications`,
253
+ CLI 装完即可从启动台直接打开桌面窗口。`DVALINCODE_NO_APP=1` 可跳过,
254
+ `DVALINCODE_GUI_VERSION` 可固定版本。
255
+ - **✅ macOS 桌面版不再是"实验性"** —— 窗口与内嵌服务器均已验证可用;
256
+ Windows 与 Linux 桌面构建为交叉编译,仍属预览。
257
+
258
+ <details>
259
+ <summary>v0.9.0 —— 🛡️ 安全修复闭环 · Skills · CodeQL 加固</summary>
145
260
 
146
261
  - **🛡️ 安全修复闭环** —— 支持运行内置本地扫描,或导入 CodeQL、GitHub
147
262
  Code Scanning、Semgrep 及兼容扫描器的 SARIF;发现项会转成本地修复 case,
@@ -153,6 +268,8 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
153
268
  现在都经过显式 root-containment 校验,并新增路径遍历与 skill 导入边界回归测试。
154
269
  - **🎨 应用图标** —— Web bundle 与桌面构建输入现在包含暗色和亮色主题应用图标。
155
270
 
271
+ </details>
272
+
156
273
  <details>
157
274
  <summary>v0.8.0 —— 🔒 治理:可控 · 透明 · 可审计</summary>
158
275
 
@@ -219,53 +336,29 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
219
336
 
220
337
  ## 📸 预览
221
338
 
222
- <p align="center">
223
- <img src="assets/hero.png" alt="DvalinCode UI" width="100%">
224
- </p>
225
-
226
- **切换模式 —— 每种模式都有不同的侧边栏:**
227
-
228
- <p align="center">
229
- <img src="assets/modes.gif" alt="切换模式" width="100%">
230
- </p>
231
-
232
- **输入框中的斜杠命令与文件引用:**
233
-
234
- <p align="center">
235
- <img src="assets/slash.gif" alt="斜杠命令与文件引用" width="100%">
236
- </p>
237
-
238
- ### 🔒 命令行里的治理
239
-
240
- **`dvalincode trust` —— 本次安装的实时安全姿态(解析后的策略、各边界的强制状态、审计情况),安全评审可直接阅读。** 字段语义和可复制策略配方见:[docs/POLICY-REFERENCE.md](docs/POLICY-REFERENCE.md)。
339
+ **真实漏洞代码的 Dvalin 扫描——安全健康分 22/100 · F,以及引擎实际报出的
340
+ 10 条发现,逐行定位:**
241
341
 
242
342
  <p align="center">
243
- <img src="assets/cli-trust.gif" alt="dvalincode trust —— 组织策略下的实时安全姿态" width="100%">
343
+ <img src="assets/hero.png" alt="Dvalin 安全健康分显示 22/100 F、4 条高危与 6 条中危,Findings 列表把每处 eval 定位到 NodeGoat 改编路由的具体行" width="100%">
244
344
  </p>
245
345
 
246
- **`dvalincode policy check` —— 在 CI 中校验 `dvalin.policy.json`:模式校验、经机器层收紧后的解析策略及其规范哈希。**
346
+ **验证后的结果——3 处 `eval` 调用改为受约束的数值解析、新增 1 条注入回归测试、
347
+ 4 个开源引擎均完成,0 条发现,100/100 · A:**
247
348
 
248
349
  <p align="center">
249
- <img src="assets/cli-policy.gif" alt="dvalincode policy check —— 校验并检视解析后的组织策略" width="100%">
350
+ <img src="assets/dvalin-scan-after.jpg" alt="Dvalin 验证复扫显示 100/100 A、0 条发现,以及产生该结果的修复会话" width="100%">
250
351
  </p>
251
352
 
252
- **防篡改审计 —— 每次 agent 运行都是一条哈希链式、已最小化的报告,可离线验证:**
353
+ **Home → Code → Dvalin——当前三个工作区:**
253
354
 
254
355
  <p align="center">
255
- <img src="assets/cli-audit.gif" alt="dvalincode report —— 运行报告,随后 report verify 证明哈希链完整" width="100%">
356
+ <img src="assets/modes.gif" alt="DvalinCode 在 Home、Code 与 Dvalin 之间切换" width="100%">
256
357
  </p>
257
358
 
258
- **证据包 —— 一条命令把策略、安全姿态与审计证明打包成单个文件,评审可完全离线验证:**
259
-
260
- <p align="center">
261
- <img src="assets/cli-evidence.gif" alt="dvalincode evidence export 与 verify —— 可离线验证的治理证据" width="100%">
262
- </p>
263
-
264
- **项目情报 —— `dvalincode scan` 在 agent 动手之前先摸清工作区:**
265
-
266
- <p align="center">
267
- <img src="assets/cli-scan.gif" alt="dvalincode scan —— 项目情报" width="100%">
268
- </p>
359
+ 以上扫描画面是文档所述 NodeGoat 改编案例上一次真实运行的未修图截图:先运行扫描器,
360
+ 再由模型修复源码,然后运行项目测试并复扫。没有任何摆拍;100/A 只代表所配置的引擎
361
+ 未发现问题,不代表代码已被证明安全。
269
362
 
270
363
  ---
271
364
 
@@ -291,15 +384,22 @@ DvalinCode 维护项目级治理证据,便于开源用户和企业安全评审
291
384
  curl -fsSL https://raw.githubusercontent.com/arthurpanhku/dvalincode/main/scripts/install.sh | bash
292
385
  ```
293
386
 
294
- 自动检测系统和架构、下载对应二进制、安装到 `~/.dvalincode/`、添加到 `PATH`。重新加载 shell 后:
387
+ 自动检测系统和架构、下载对应二进制、安装到 `~/.dvalincode/`、添加到 `PATH`。macOS 上还会把原生桌面应用 **DvalinCode.app** 装进 `/Applications`(可用 `DVALINCODE_NO_APP=1` 跳过),装完即可直接从启动台打开图形界面。重新加载 shell 后:
295
388
 
296
389
  ```sh
297
390
  source ~/.zshrc # 或 ~/.bashrc
298
391
  dvalincode # 交互式终端代理
392
+ dvalincode dvalin . # 白盒安全扫描
393
+ dvalincode dvalin . --fix --verify --draft-pr # 隔离修复、验证并创建草稿 PR
299
394
  dvalincode serve # 启动 Web GUI 并打开浏览器
300
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 服务
301
398
  ```
302
399
 
400
+ 无头 `run` 和 `mcp-serve` 与交互客户端共用同一个策略与审计关卡。cron、CI
401
+ 和外部 Agent 示例见[无人值守配方](docs/RECIPES-UNATTENDED.md)。
402
+
303
403
  ### Windows
304
404
 
305
405
  从 [Releases](https://github.com/arthurpanhku/dvalincode/releases/latest) 下载 `dvalincode-v*-windows-x64.zip`,解压后双击 `start.bat`。
@@ -318,13 +418,34 @@ dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器,供远程/浏
318
418
 
319
419
  每个 release 都附带 `SHA256SUMS.txt` 用于校验。
320
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
+
321
431
  > **macOS Gatekeeper:** 二进制未签名。首次运行可执行 `xattr -dr com.apple.quarantine ~/.dvalincode`,或在 Finder 中右键 → 打开一次。
322
432
 
433
+ ### 保持更新
434
+
435
+ DvalinCode 可自我更新,无需重新运行安装脚本:
436
+
437
+ ```sh
438
+ dvalincode update --check # 检查是否有新版本(只读)
439
+ dvalincode update # 下载、校验并安装最新版本
440
+ ```
441
+
442
+ 它会在 GitHub 上找到最新 release;对二进制安装,会下载对应平台的归档,**在替换任何文件之前先用 release 的 `SHA256SUMS.txt` 校验**,然后就地替换 `~/.dvalincode/`。npm 安装通过 `npm i -g` 更新,源码检出则提示 `git pull`。可用 `-y` 跳过确认、`--prerelease` 跟踪预发布、`--json` 用于脚本。
443
+
323
444
  ---
324
445
 
325
446
  ## 🎬 首次配置
326
447
 
327
- **终端(默认):** 运行 `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` 查看命令。
328
449
 
329
450
  **Web GUI:** 运行 `dvalincode serve`:
330
451
 
@@ -341,17 +462,17 @@ dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器,供远程/浏
341
462
 
342
463
  | 类别 | 功能 | 说明 |
343
464
  |---|---|---|
344
- | **模式** | Chat / Cowork / Code | 各自独立的侧边栏(Templates / Projects / Routines)与工具权限策略 |
465
+ | **模式** | Home / Code / Dvalin | Home 包含只读 Ask 与审批式 Collaborate;Code 专注开发;Dvalin 是扫描到修复的安全工作区 |
345
466
  | **Code 权限** | Ask Permissions / Plan Mode / Auto Mode / Bypass permissions | 已验证行为:Ask 在写入/命令前请求批准,Plan 只读且不写文件,Auto 自动执行操作,Bypass 不再弹出确认 |
346
- | **工作区** | 打开文件夹 / 导入 Git / 添加 worktree | Cowork 与 Code 可在 UI 中切换到本地文件夹、克隆 Git 项目,或创建 Git worktree |
467
+ | **工作区** | 打开文件夹 / 导入 Git / 添加 worktree | Home、Code 与 Dvalin 可使用本地文件夹、Git 项目和隔离 remediation worktree |
347
468
  | **治理** | OpenSSF Scorecard / ISO 42001 AIMS 对齐 | Scorecard、CodeQL、Dependabot、固定 SHA 的 Actions、AI 影响评估、风险登记和审查节奏记录在 `docs/security/` 与 `docs/governance/` |
348
- | **安全修复** | 本地扫描 / 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 |
349
470
  | **Skills** | 上传 / 下载 / 内置安全 skills | Skills 保存在 `~/.dvalincode/skills`;内置 skills 用专门的 agent tools 引导安全扫描与修复。[格式 →](docs/SKILLS.md) |
350
471
  | **输入框** | `@` 文件引用 | 输入 `@` 触发模糊文件搜索,选中文件自动插入到 prompt |
351
472
  | | `/` 斜杠命令 | `/clear` `/compact` `/git` `/plan` `/undo` `/help` |
352
473
  | | 多行输入 + 中断 | <kbd>Shift</kbd>+<kbd>Enter</kbd> 换行,Stop 按钮中断生成 |
353
474
  | **工具 UI** | 行内 diff | `edit_file` 与 `write_file` 结果以红绿统一 diff 呈现,默认折叠 |
354
- | | 审批对话框含 diff | Cowork 模式下,文件变更在执行前显示 diff |
475
+ | | 审批对话框含 diff | Home → Collaborate 下,文件变更在执行前显示 diff |
355
476
  | | 实时工具计数 + Token + 费用 | 顶栏实时显示当前 session 累计数据 |
356
477
  | **Agent** | LLM 上下文压缩 | `/compact` 将历史压缩为 目标/已完成/决策/待办 结构化摘要 |
357
478
  | | 持久化 Undo 栈 | `/undo [N]` 撤销最近 N 个工具调用 |
@@ -361,7 +482,7 @@ dvalincode serve --host 0.0.0.0 --no-open # 部署到服务器,供远程/浏
361
482
  | **安全** | 防篡改审计日志 | 每次运行在 `~/.dvalincode/audit/` 生成哈希链 JSONL;`dvalincode report verify` 可检测修改 |
362
483
  | | macOS Shell 沙箱 | `sandbox-exec` 拒绝网络;写入仅限 cwd 与 `/tmp` |
363
484
  | | `.dvalincodeignore` | 类 gitignore 排除;阻止 `read_file` / `list_files` / `search_text` |
364
- | | 逐操作审批 | Cowork 模式下每次写入/删除/shell 都需用户批准 |
485
+ | | 逐操作审批 | Home → Collaborate 下每次写入/删除/shell 都需用户批准 |
365
486
  | **外观** | 主题切换 | 暗色 / 浅色 / 跟随系统,持久保存;`跟随系统` 实时跟随 OS |
366
487
  | **Providers** | OpenAI 兼容端点 | DeepSeek · OpenAI · Groq · OpenRouter · Ollama · 自定义 |
367
488
  | | 多 Profile 配置 | 保存并切换多组 (provider, model, API key) 命名配置 |
@@ -444,7 +565,7 @@ RESTORE → COMPACT → COMMAND → BUILD → RUN → SAVE → RESPOND → DONE
444
565
  npm test
445
566
  ```
446
567
 
447
- **203 个测试 · 36 个文件 · 全部通过。**
568
+ **323 个测试 · 49 个文件 · 全部通过。**
448
569
 
449
570
  ---
450
571
 
@@ -515,13 +636,19 @@ DvalinCode 顶栏实时显示本 session 的费用 —— 在 **LLM Configuratio
515
636
  <details>
516
637
  <summary><b>为什么三种模式?只用一种不行吗?</b></summary>
517
638
  <br>
518
- 每种模式有不同的<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 完成安全加固。任何时候都可切换并保留项目上下文。
519
640
  </details>
520
641
 
521
642
  <details>
522
643
  <summary><b>Shell 工具有沙箱吗?</b></summary>
523
644
  <br>
524
- 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 规则引用可执行文件路径及参数。
525
652
  </details>
526
653
 
527
654
  <details>
@@ -533,7 +660,7 @@ macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec
533
660
  <details>
534
661
  <summary><b>会不会不经询问就覆盖我的文件?</b></summary>
535
662
  <br>
536
- 取决于模式。<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 只应在受信任工作区或隔离分支中使用。
537
664
  </details>
538
665
 
539
666
  <details>
@@ -545,9 +672,9 @@ macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec
545
672
  </details>
546
673
 
547
674
  <details>
548
- <summary><b>Code 模式怎么保存 Routine?</b></summary>
675
+ <summary><b>Dvalin 必须安装所有外部扫描器吗?</b></summary>
549
676
  <br>
550
- 切到 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 结果。
551
678
  </details>
552
679
 
553
680
  <details>
@@ -565,7 +692,7 @@ macOS 上有 —— 每次 <code>shell</code> 调用都包在 <code>sandbox-exec
565
692
  ```sh
566
693
  git clone https://github.com/arthurpanhku/dvalincode
567
694
  cd dvalincode && npm install
568
- npm test # 65/65 ✅
695
+ npm test # 323/323 ✅
569
696
  npm run typecheck
570
697
  ```
571
698
 
@@ -621,3 +748,21 @@ prompt、UI 文案、工具 schema、模块布局和产品实现均为原创;
621
748
  </picture>
622
749
  </a>
623
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>