dsh-code-security 0.3.6 → 0.3.8

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# 更新记录
+
+[返回简介](README.md) · [使用说明](docs/USAGE.md) · [验证记录](docs/VALIDATION.md)
+
+[历史英文记录](docs/CHANGELOG.en.md)
+
+## 0.3.8 (2026-10-12)
+
+- 修复增量扫描遗漏中文/转义文件名、私钥、`.env` 敏感项和禁用依赖审计配置的问题，报告真实证据行号。
+- 结合有限上下文识别已有豁免和跨行配置，仅报告涉及新增行的问题；校验差异块行数，格式错误或不完整时明确报错。
+- 全量、单文件与增量扫描统一排除策略和工作区相对路径，兼容旧记录中 `./` 前缀的基线指纹。
+- 固定 Git 输出格式与当前工作区范围，禁用外部 diff/textconv，拒绝被误当成 Git 选项的基线参数和错误类型的 `staged` 参数。
+- 补充隔离 Git 回归场景；范围、兼容注意事项及后续计划见[本轮迭代记录](docs/ITERATION-2026-10-12.md)。
+
+## 0.3.7 (2026-10-05)
+
+- 扫描、策略、报告和 git diff 使用当前会话工作区；支持取消并跳过目录联接。锁定合并历史与基线写入，损坏记录和无效策略明确报错并保留原文件。
+
+## 0.3.6 (2026-09-28)
+
+- 更新官方 Harness 0.2.0-rc.1 的兼容声明和共同加载验证；运行时代码未变。验证范围见[验证记录](docs/VALIDATION.md)。
+
+## 0.3.5 (2026-09-28)
+
+扫描参数写错时明确报错，避免把 `paths`、`files` 或空目标误当成扫描整个工作区。修复标准模式中结果卡片误显示“0 个文件、未通过”的问题；文件数量、结论与问题列表现在使用实际扫描结果。
+
+## 更早的改动
+
+完整历史可查阅 [GitHub 提交记录](https://github.com/STARDUSTLC666/dsh-code-security/commits/master)。

package/README.en.md

@@ -1,44 +1,48 @@
 # dsh-code-security
 
-## 0.3.5 update (2026-09-28)
+[中文](README.md)
 
-Rejects unknown scan arguments and empty targets before scanning or replacing state, preventing misspelled scopes from expanding to the whole workspace. Fixes standard-mode output incorrectly displaying zero files and a failed verdict: counts, verdicts and findings now come from the actual scan result.
+![dsh-code-security whale girl plugin cover](https://raw.githubusercontent.com/STARDUSTLC666/dsh-code-security/master/assets/cover-whale-girl.png)
 
-Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 31 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 10 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
+Run local static security checks on code or Git changes and verify fixes.
 
-![npm](https://img.shields.io/npm/v/dsh-code-security) ![downloads](https://img.shields.io/npm/dm/dsh-code-security) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-code-security) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-code-security?style=social)
+[![npm](https://img.shields.io/npm/v/dsh-code-security)](https://www.npmjs.com/package/dsh-code-security) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-code-security-downloads.svg)](https://www.npmjs.com/package/dsh-code-security)
 
-> Every agent code change passes a local security scan before delivery.
+Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-code-security/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-code-security/pulls).
 
-A DeepSeek Harness plugin for AI code security review: deterministic rule engine, git-diff incremental review, fix-verify loop, and policy gate. Methodology borrows from Codex security skills (evidence-first findings, severity ordering, supply-chain layers). Zero runtime dependencies.
+## What it does
 
-## Compatibility
+- Scan files, directories or Git diffs with locations and code evidence.
+- Recheck fixes and manage baselines or scan policy.
+- Export Markdown or SARIF reports and inspect dependency manifests.
 
-Verified with official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: all 18 components load alongside Modlens, with passing tool-schema, skill-registration and offline read-only invocation checks. Uses the `cordis.patch.yml` + `dsh.bundle.patch` bundle model. Node requirements match this Harness release: 22.19 or later within 22.x, or 24 or later. Live external-service workflows require separate configuration and validation.
+## Install
 
-2026-09-13 fix: retain the service receiver when calling `subprocess.spawn`, preventing failures caused by passing the method as an unbound callback. Verified with official `0.1.5-rc.1` and `0.1.5-rc.2` on Node `24.16.0`. `secure_diff` reads a real isolated Git repository through the host subprocess service and reports the changed file and added line.
+In DSH Desktop, install `dsh-code-security` from the Plugins panel. If the bundled dsh command is available:
 
-## Tools
+```bash
+dsh plugin --profile desktop add dsh-code-security
+```
 
-| Tool | Purpose | Write |
-| :-- | :-- | :-- |
-| `secure_scan` | Scan files with CWE/severity/line/snippet evidence | state |
-| `secure_diff` | Review only added lines of git diff | state |
-| `secure_fix_verify` | Compare with baseline: closed / remaining / fresh | state |
-| `secure_report` | Aggregate by rule/file with gate verdict | no |
-| `secure_export` | Export SARIF 2.1.0 / Markdown | file write approval |
-| `secure_baseline` | Accept current findings as baseline; gate on new issues only | approval |
-| `secure_deps` | SBOM-lite: parse dependency manifests and version-risk flags | no |
-| `secure_policy_show` | Show .code-security.json | no |
-| `secure_policy_set` | Replace policy JSON | approval |
+For the web version, replace `desktop` with `web`. Restart DSH after installation.
 
-40+ deterministic rules: injection, deserialization, weak crypto (including shell TLS bypass flags), secrets, dangerous config, sensitive logging, path traversal, SSRF.
+## Start using it
 
-```bash
-dsh plugin --profile web add dsh-code-security
-```
+Ask: “Review the current Git diff for security findings, show evidence and recheck the fixes.”
+
+## Requirements and configuration
+
+Deterministic rules run locally. See the usage guide for rule coverage, baselines and policy configuration.
+
+Detailed configuration, tool arguments and troubleshooting are in the [usage guide](docs/USAGE.en.md). For standalone development, follow the Node requirement in [package.json](package.json).
+
+## Documentation
+
+- [Usage and troubleshooting](docs/USAGE.en.md)
+- [Changelog](CHANGELOG.md)
+- [Validation scope and history](docs/VALIDATION.md)
+- [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-code-security/issues)
 
-MIT
 ## License
 
-MIT (see [LICENSE](LICENSE))
+[MIT](LICENSE)

package/README.md

@@ -1,91 +1,48 @@
 # dsh-code-security
 
-## 0.3.5 更新（2026-09-28）
+[English](README.en.md)
 
-扫描参数写错时明确报错，避免把 `paths`、`files` 或空目标误当成扫描整个工作区。修复标准模式中结果卡片误显示“0 个文件、未通过”的问题；文件数量、结论与问题列表现在使用实际扫描结果。
+![dsh-code-security 鲸鱼娘插件封面](https://raw.githubusercontent.com/STARDUSTLC666/dsh-code-security/master/assets/cover-whale-girl.png)
 
-验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。31 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 10 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
+对代码与 Git 改动进行本地静态安全检查，并追踪修复结果。
 
-![npm](https://img.shields.io/npm/v/dsh-code-security) ![downloads](https://img.shields.io/npm/dm/dsh-code-security) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-code-security) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-code-security?style=social)
+[![npm](https://img.shields.io/npm/v/dsh-code-security)](https://www.npmjs.com/package/dsh-code-security) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-code-security-downloads.svg)](https://www.npmjs.com/package/dsh-code-security)
 
-> 让 agent 每次改完代码，先过一道本地安全扫描，修复完了才准交付。
+欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-code-security/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-code-security/pulls)。
 
-DeepSeek Harness AI 代码安全审查插件：确定性规则引擎 + git diff 增量审查 + 修复闭环 + 策略门禁。借鉴 Codex 安全技能的方法论（漏洞分级、证据优先、供应链分层、Agent 安全），实现为可复现工具。零运行时依赖。
+## 功能
 
-## 工具
-
-| 工具 | 作用 | 写操作 |
-| :-- | :-- | :-- |
-| `secure_scan` | 扫描文件/目录，输出 CWE/严重度/行号/代码片段证据 | 写状态 |
-| `secure_diff` | 只审查 git diff 新增行 | 写状态 |
-| `secure_fix_verify` | 修复后复扫：关闭 / 仍存在 / 新引入 | 写状态 |
-| `secure_report` | 按规则/文件聚合 + 门禁结论 | 否 |
-| `secure_export` | 导出 SARIF 2.1.0 / Markdown 报告 | 写文件审批 |
-| `secure_baseline` | 接受当前已知问题为基线，之后只按新增判定 | 审批门 |
-| `secure_deps` | SBOM-lite：解析依赖清单与版本约束风险 | 否 |
-| `secure_policy_show` | 查看 .code-security.json 策略 | 否 |
-| `secure_policy_set` | 写入策略（排除/忽略/阈值） | 审批门 |
-
-## 规则覆盖（40+）
-
-- 注入：eval / exec / shell=True / SQL 拼接 / innerHTML
-- 反序列化：pickle / yaml.load / ObjectInputStream / Marshal / unserialize
-- 加密：弱哈希、ECB、硬编码 IV/密钥、JWT none、TLS 校验关闭、Shell TLS 绕过（curl -k / wget --no-check-certificate / git sslVerify=false）
-- 凭据：硬编码密码、令牌、私钥、高熵密钥
-- 配置：chmod 777、Docker privileged / latest、npm audit=false、CORS *
-- 泄露：敏感日志、错误堆栈外发、路径穿越、SSRF
-
-发现只包含客观证据与 CWE 编号，不附修复建议——修复方案由 agent 基于证据生成。
-
-## 兼容性
-
-已在官方 `@deepseek-ai/dsh@0.1.5-rc.1`、Node `24.16.0` 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 `cordis.patch.yml` + `dsh.bundle.patch` 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
-
-2026-09-13 修复：保留宿主 `subprocess.spawn` 的服务对象，避免方法独立传递后因 `this` 丢失而报错。已在官方 `0.1.5-rc.1` 和 `0.1.5-rc.2`、Node `24.16.0` 上验证。`secure_diff` 已通过真实宿主进程服务读取隔离 Git 仓库差异，正确识别变更文件和新增行。
+- 扫描文件、目录或 Git diff，报告规则、位置与代码证据。
+- 复扫修复结果，维护问题基线和检查策略。
+- 导出 Markdown / SARIF 报告，检查依赖清单。
 
 ## 安装
 
-```bash
-dsh plugin --profile web add dsh-code-security
-```
-
-## 卸载
+桌面版可在「插件」面板按包名 `dsh-code-security` 安装。已配置 dsh 命令时也可使用：
 
 ```bash
-dsh plugin --profile web remove dsh-code-security
+dsh plugin --profile desktop add dsh-code-security
 ```
 
-卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。
+网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
 
+## 开始使用
 
-## 使用
+安装后可说：“审查当前 Git 改动的安全问题，给出位置和证据，再复查修复结果。”
 
-```text
-secure_scan { target: src }
-secure_diff { base: HEAD }
-secure_fix_verify { target: src }
-secure_baseline { reason: 历史遗留 }
-secure_deps { target: . }
-```
+## 依赖与配置
 
-策略示例（`.code-security.json`）：
+默认在本机执行确定性规则检查。规则覆盖与基线、策略配置见使用说明。
 
-```json
-{
-  "version": 1,
-  "exclude": ["vendor/**", "generated/**"],
-  "ignore": [{ "ruleId": "SEC-206", "file": "test/**", "reason": "非安全敏感" }],
-  "failOn": "high"
-}
-```
+详细配置、工具参数与排错见[使用说明](docs/USAGE.md)。从源码独立开发时，Node 要求以 [package.json](package.json) 为准。
 
-## 工程
+## 文档
 
-```bash
-pnpm test       # 构建 + 24 个测试
-```
+- [使用与排错](docs/USAGE.md)
+- [更新记录](CHANGELOG.md)
+- [验证范围与历史记录](docs/VALIDATION.md)
+- [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-code-security/issues)
 
-MIT
 ## License
 
-MIT（见 [LICENSE](LICENSE)）
+[MIT](LICENSE)

package/docs/CHANGELOG.en.md

@@ -0,0 +1,15 @@
+# Historical release notes
+
+[Current changelog](../CHANGELOG.md) · [Overview](../README.en.md)
+
+These English notes preserve the earlier translations. The main changelog contains the consolidated version history.
+
+## 0.3.7 (2026-10-05)
+
+- Use the session workspace for scans, policy, reports and git diff. Respect cancellation and skip directory junctions. Lock history/baseline merges and preserve damaged files with explicit errors.
+
+## 0.3.5 (2026-09-28)
+
+Rejects unknown scan arguments and empty targets before scanning or replacing state, preventing misspelled scopes from expanding to the whole workspace. Fixes standard-mode output incorrectly displaying zero files and a failed verdict: counts, verdicts and findings now come from the actual scan result.
+
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 31 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 10 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.

package/docs/ITERATION-2026-10-12.md

@@ -0,0 +1,53 @@
+# dsh-code-security 第一轮迭代
+
+日期：2026-10-12。基于 `91d4d8c770cfaa796d07b7b770a627c3bce8f49e`，本轮版本为 `0.3.8`。此页记录源码迭代和本地验证；发布 CI、npm 完整性及隔离安装结果在发布后独立核验。
+
+这轮先解决增量审查的漏报、范围和证据一致性。原有 37 项测试全部通过，但新增回归测试在旧实现上复现了中文路径、文件级规则等问题被误判为通过。
+
+## 已实现
+
+| 场景 | 原行为 | 当前行为 |
+| :-- | :-- | :-- |
+| 中文/转义文件名 | Git 引号与八进制路径解析失败，可能返回零发现并通过 | 解码 UTF-8 与 Git 的 C 转义，保留正确文件和行号 |
+| 新增私钥、`.env` 敏感项、`audit=false` | 增量扫描跳过文件级规则 | 全量和增量共用匹配，定位实际证据；保留跨行配置检测 |
+| 未改动的豁免注释、危险代码 | 缺少上下文，已有 next-line 豁免失效 | 读取少量上下文，只报告证据涉及新增行的问题 |
+| 仓库子目录作为会话工作区 | 带入兄弟目录改动，路径基准偏离工作区 | Git 范围和证据路径均相对当前会话工作区 |
+| 策略排除 | 增量扫描未应用排除，直接选择文件也绕过排除 | 三种扫描入口统一排除；报告实际扫描和跳过数量 |
+| 基线一致性 | 全量的 `./src/a.js` 与增量的 `src/a.js` 指纹不同 | 规范相对路径，并从保存的证据重算旧基线指纹 |
+| Git 个性化配置/参数 | 颜色、前缀影响解析；`--quiet` 可误当基线 | 固定输出格式，禁用外部 diff/textconv，校验参数类型 |
+| 差异块缺失行 | 接受不完整差异并给出部分结果 | 校验差异块行数，异常时保留原扫描状态并报错 |
+
+主要代码：[diff.ts](../src/diff.ts)、[scanner.ts](../src/scanner.ts)、[tools.ts](../src/tools.ts)、[state.ts](../src/state.ts)。已同步仓库跟踪的 `lib/` 构建产物。
+
+## 验证
+
+- `pnpm test`：53/53 通过，0 失败，0 跳过；包含 TypeScript 构建。
+- 新增 16 项回归测试，其中 9 项使用本地隔离 Git 仓库。覆盖中文路径、暂存区与工作树不一致、Git 输出偏好、子工作区、基线兼容、外部转换器与排除计数等。
+- 工具调用链覆盖 `secure_scan` / `secure_diff` / `secure_baseline` / `secure_fix_verify` / `secure_report` / `secure_export`，验证写入状态、结果渲染文本和 SARIF 路径。
+- 环境：Windows，Node `24.16.0`，pnpm `11.7.0`，Git `2.54.0.windows.1`。
+- 本页所列测试未在真实 DSH Web/桌面界面执行点击、输入或视觉验收；本地运行环境为 Windows/Node 24，Linux CI 与 npm 发布验收另行记录。
+
+回归入口：[diff.test.mjs](../test/diff.test.mjs)、[git-diff.test.mjs](../test/git-diff.test.mjs)。测试仓库位于 E 盘项目内的 `test/.tmp/`，测试结束后仅清理经过路径校验的自建子目录。
+
+## 兼容注意
+
+未新增依赖；继续沿用项目已有的 MIT 许可与 `proper-lockfile@4.1.2`（MIT），Node 声明保持 `^22.19.0 || >=24.0.0`。原工具名和参数结构保留，增量输出增加明确的扫描/跳过计数。
+
+旧记录的 `./` 前缀兼容已验证。`SEC-303`、`SEC-305`、`SEC-404` 的证据由“整个文件开头”改成“实际匹配片段”；旧基线若使用前一种片段，可能被视为新增。应复扫并人工确认后重新接受，不能自动把新证据全部豁免。
+
+增量检查只涵盖 Git 显示的文本差异，仍不包含未跟踪文件。上下文为前后各 3 行；超出上下文的跨行结构、通用数据流和复杂语言语义未由本轮解决。差异块校验可以发现块内截断，但不代表已解决所有收集上限下的完整性判断。
+
+## 下一轮优先项
+
+以下来自当前代码静态检查，尚未在本轮实现或验收。
+
+1. **扫描完整性门禁。** `scanPath` 遇到不存在目标、读取失败或文件数上限时，应返回明确的完整性状态；`passed` 不能仅因发现为空而为真。还应检查宿主 stdout 收集上限带来的整体截断。
+2. **复扫范围校验。** `secure_fix_verify` 应核对上次与本次目标/覆盖范围，避免把没有重新扫描的问题误报为关闭；部分复扫应输出“未验证”。
+3. **规则准确性与隐私。** 补充安全/危险样例集，优先处理普通字符串、块注释、已使用安全 Loader 等误报；为密钥证据增加默认脱敏，并设计不依赖明文片段的稳定指纹。
+4. **依赖清单解析。** 为标准 `pyproject.toml`、Cargo 依赖区段和损坏清单补测试，再评估采用 MIT/兼容许可的 TOML 解析器；当前 SBOM-lite 不能当作漏洞数据库扫描。
+
+后续功能迭代仍需补单插件真实 DSH 界面验收和更广的跨平台 CI；本版发布验证独立进行。
+
+## Git 行为依据
+
+输出格式、工作区相对范围和外部转换器开关按 [Git diff 官方文档](https://git-scm.com/docs/git-diff) 实现；文件名转义依据 [core.quotePath 官方说明](https://git-scm.com/docs/git-config#Documentation/git-config.txt-corequotePath)。

package/docs/USAGE.en.md

@@ -0,0 +1,37 @@
+# dsh-code-security usage guide
+
+[Overview](../README.en.md) · [Changelog](../CHANGELOG.md) · [Validation](VALIDATION.md)
+
+## Current improvements
+
+Relative stateDir defaults to .code-security in the session workspace. Concurrent scans retain both histories. Damaged records must be inspected after backup rather than silently recreated. Scans skip symlinks and junctions; static rules do not replace a full security audit.
+
+0.3.8 (2026-10-12): incremental reviews decode Git's quoted paths and check added private keys, `.env` secrets and disabled audit settings. Three context lines on each side support existing next-line suppressions and multiline settings; only evidence intersecting added lines is reported. Multiline locations point to the match's first line. Staged reviews use index content rather than later working-tree edits.
+
+Full, directly selected file and incremental scans share default and policy exclusions. Paths and Git scope are relative to the session workspace, including nested workspaces. `filesScanned` counts reviewed files and `filesSkipped` includes exclusions; incremental results also provide `filesChanged` and reviewed `addedLines`. Git output uses fixed colors/prefixes and disables external diff/textconv helpers. Invalid `base`/`staged` arguments and malformed or incomplete hunks fail without replacing scan state.
+
+Saved evidence with a legacy `./` path prefix still matches baselines. File-level findings now use actual matching snippets; older baselines that saved the beginning of an entire file may require a fresh scan and human review before acceptance.
+
+## Tools
+
+| Tool | Purpose | Write |
+| :-- | :-- | :-- |
+| `secure_scan` | Scan files with CWE/severity/line/snippet evidence | state |
+| `secure_diff` | Review only added lines of git diff | state |
+| `secure_fix_verify` | Compare with baseline: closed / remaining / fresh | state |
+| `secure_report` | Aggregate by rule/file with gate verdict | no |
+| `secure_export` | Export SARIF 2.1.0 / Markdown | file write approval |
+| `secure_baseline` | Accept current findings as baseline; gate on new issues only | approval |
+| `secure_deps` | SBOM-lite: parse dependency manifests and version-risk flags | no |
+| `secure_policy_show` | Show .code-security.json | no |
+| `secure_policy_set` | Replace policy JSON | approval |
+
+40+ deterministic rules: injection, deserialization, weak crypto (including shell TLS bypass flags), secrets, dangerous config, sensitive logging, path traversal, SSRF.
+
+```bash
+dsh plugin --profile web add dsh-code-security
+```
+
+## License
+
+MIT (see [LICENSE](../LICENSE))

package/docs/USAGE.md

@@ -0,0 +1,85 @@
+# dsh-code-security 使用说明
+
+[返回简介](../README.md) · [更新记录](../CHANGELOG.md) · [验证记录](VALIDATION.md)
+
+## 本次改进
+
+相对 stateDir 默认在会话工作区的 .code-security。并发扫描保留双方历史；记录损坏时先备份排查，不会默默重建。扫描不跟随符号链接或目录联接；静态规则不能代替完整安全审计。
+
+0.3.8 改进（2026-10-12）：`secure_diff` 支持 Git 转义的中文/特殊文件名，并检查新增私钥、`.env` 敏感项与禁用审计配置。它读取前后各 3 行上下文以处理已有豁免和跨行配置，只报告证据涉及新增行的问题；跨行证据的行号指向匹配的起始行。暂存扫描以暂存区内容为准。
+
+全量、直接指定文件与增量扫描均遵守默认目录排除及策略 `exclude`。文件路径统一相对当前会话工作区；在仓库子目录作为工作区时，增量扫描不包含该目录外的改动。返回的 `filesScanned` 为实际审查的文件数，`filesSkipped` 包含排除项；增量结果另有 `filesChanged` 和实际审查的 `addedLines`。
+
+`base` 必须是非空 Git ref，不能以 `-` 开头；`staged` 必须是布尔值。差异块行数不完整或格式错误会报错，本次不会覆盖已有扫描记录。Git 的颜色/前缀偏好不会改变解析格式，外部 diff 和 textconv 转换器被禁用。
+
+旧记录的 `./` 路径前缀可继续匹配基线。私钥、`.env` 和禁用审计配置现在使用实际匹配片段；旧基线若保存的是文件开头的大段文本，可能被重新识别为新增，需复扫并人工复核后再接受。详见[本轮迭代记录](ITERATION-2026-10-12.md)。
+
+## 工具
+
+| 工具 | 作用 | 写操作 |
+| :-- | :-- | :-- |
+| `secure_scan` | 扫描文件/目录，输出 CWE/严重度/行号/代码片段证据 | 写状态 |
+| `secure_diff` | 只审查 git diff 新增行 | 写状态 |
+| `secure_fix_verify` | 修复后复扫：关闭 / 仍存在 / 新引入 | 写状态 |
+| `secure_report` | 按规则/文件聚合 + 门禁结论 | 否 |
+| `secure_export` | 导出 SARIF 2.1.0 / Markdown 报告 | 写文件审批 |
+| `secure_baseline` | 接受当前已知问题为基线，之后只按新增判定 | 审批门 |
+| `secure_deps` | SBOM-lite：解析依赖清单与版本约束风险 | 否 |
+| `secure_policy_show` | 查看 .code-security.json 策略 | 否 |
+| `secure_policy_set` | 写入策略（排除/忽略/阈值） | 审批门 |
+
+## 规则覆盖（40+）
+
+- 注入：eval / exec / shell=True / SQL 拼接 / innerHTML
+- 反序列化：pickle / yaml.load / ObjectInputStream / Marshal / unserialize
+- 加密：弱哈希、ECB、硬编码 IV/密钥、JWT none、TLS 校验关闭、Shell TLS 绕过（curl -k / wget --no-check-certificate / git sslVerify=false）
+- 凭据：硬编码密码、令牌、私钥、高熵密钥
+- 配置：chmod 777、Docker privileged / latest、npm audit=false、CORS *
+- 泄露：敏感日志、错误堆栈外发、路径穿越、SSRF
+
+发现只包含客观证据与 CWE 编号，不附修复建议——修复方案由 agent 基于证据生成。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-code-security
+```
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-code-security
+```
+
+卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。
+
+## 使用
+
+```text
+secure_scan { target: src }
+secure_diff { base: HEAD }
+secure_fix_verify { target: src }
+secure_baseline { reason: 历史遗留 }
+secure_deps { target: . }
+```
+
+策略示例（`.code-security.json`）：
+
+```json
+{
+  "version": 1,
+  "exclude": ["vendor/**", "generated/**"],
+  "ignore": [{ "ruleId": "SEC-206", "file": "test/**", "reason": "非安全敏感" }],
+  "failOn": "high"
+}
+```
+
+## 工程
+
+```bash
+pnpm test       # 构建并执行测试
+```
+
+## License
+
+MIT（见 [LICENSE](../LICENSE)）

package/docs/VALIDATION.md

@@ -0,0 +1,15 @@
+# dsh-code-security 验证记录
+
+本页整理原 README 的历史验证说明，保留当时的版本、日期与范围。自动测试、启动检查、浏览器操作和真实服务验收分别记录，不能相互替代。更详细的版本验收文件仍保留在仓库中。
+
+## 原中文记录
+
+2026-09-13 修复：保留宿主 `subprocess.spawn` 的服务对象，避免方法独立传递后因 `this` 丢失而报错。该路径已在隔离宿主进程服务中实测通过。`secure_diff` 已通过真实宿主进程服务读取隔离 Git 仓库差异，正确识别变更文件和新增行。
+
+## Original English record
+
+2026-09-13 fix: retain the service receiver when calling `subprocess.spawn`, preventing failures caused by passing the method as an unbound callback. Verified against a real isolated host subprocess service. `secure_diff` reads a real isolated Git repository through the host subprocess service and reports the changed file and added line.
+
+## 0.3.6 原验证说明
+
+验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。31 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 10 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。

package/lib/config.d.ts

@@ -15,6 +15,7 @@ export interface ResolvedSecureConfig {
     maxFileBytes: number;
     failOn: Severity;
     stateDir: string;
+    stateDirRelative?: string;
 }
 export declare const DEFAULT_EXCLUDE_DIRS: string[];
 export declare function resolveConfig(config: SecureConfig | undefined | null, cwd?: string): ResolvedSecureConfig;

package/lib/config.js

@@ -21,7 +21,8 @@ export function resolveConfig(config, cwd = process.cwd()) {
     }
     const failOn = cfg.failOn === 'critical' || cfg.failOn === 'high' || cfg.failOn === 'medium' || cfg.failOn === 'low' ? cfg.failOn : 'medium';
     const stateDir = typeof cfg.stateDir === 'string' && cfg.stateDir.trim() !== '' ? path.resolve(cwd, cfg.stateDir.trim()) : path.join(cwd, '.code-security');
-    return { maxFiles, maxFileBytes, failOn, stateDir };
+    const rawStateDir = typeof cfg.stateDir === 'string' && cfg.stateDir.trim() ? cfg.stateDir.trim() : '.code-security';
+    return { maxFiles, maxFileBytes, failOn, stateDir, ...(path.isAbsolute(rawStateDir) ? {} : { stateDirRelative: rawStateDir }) };
 }
 export function optionalString(args, key) {
     const value = args[key];

package/lib/diff.d.ts

@@ -13,10 +13,13 @@ export interface DiffLine {
 export interface DiffFile {
     file: string;
     added: DiffLine[];
+    context?: DiffLine[];
 }
 export interface DiffScanResult {
     base: string;
     filesChanged: number;
+    filesScanned: number;
+    filesSkipped: number;
     addedLines: number;
     findings: Finding[];
     diff: string;