---
## ⚡ 插件概览
**`dsh-shadow-auditor`** 为 **DeepSeek Harness** 智能体提供全时段后台安全审计与高危命令拦截防护。
智能体在编写代码、处理配置或执行 Shell 脚本时，存在误将 API 密钥、私钥凭据提交至代码库或执行破坏性终端命令（如无边界 `rm -rf /`、数据库删库、敏感权限覆写）的风险。
本插件作为进程级安全防火墙，实时扫描代码 Diff 中的敏感信息，并在终端命令执行前执行语法级安全拦截。
```mermaid
graph LR
subgraph AgentExecution [智能体操作执行流]
Agent[🤖 智能体: 编写代码 / 准备执行命令] --> Intercept{安全前置拦截器}
end
subgraph SecurityEngines [dsh-shadow-auditor 引擎]
Intercept --> SecretScan[🔑 敏感凭据与 API Key 扫描器]
Intercept --> CmdGuard[🛡️ 高危终端命令安全防火墙]
end
subgraph Enforcement [阻断与日志审计]
SecretScan -->|安全| Pass[✅ 放行执行]
SecretScan -->|检测到泄漏| Block1[⛔ 实时阻断并脱敏敏感信息]
CmdGuard -->|安全| Pass
CmdGuard -->|高危风险| Block2[⛔ 阻断执行并要求人工确认]
Block1 --> AuditLog[📋 安全审计日志与可视化面板]
Block2 --> AuditLog
end
style AgentExecution fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
style SecurityEngines fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
style Enforcement fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
```
---
## 📦 安装指南
```bash
dsh plugin --profile web add @goodandready/dsh-shadow-auditor
```
---
---
## 🔄 版本记录
### v0.2.9 (安全功能演进与规范语言支持)
- **规范语言标准**：代码及界面全面支持英文（`en`）与中文（`zh`）；俄语本地化通过 `goodandready/dsh-russian-lang` 维护。
- **发布包规范**：彻底清除 `AGENTS.md` 与 `index.md` 等非产品文件；严格执行单个文件 $\le 256$ KiB 上限。
- **实时拦截与审计日志流**：支持按全部、Shell 防护、差异网关和高风险进行分类过滤与刷新。
- **自定义安全策略**：支持命令与敏感路径的自定义正则表达式黑名单，并提供强制阻断与仅审计模式。
- **差异网关可视化检查与修复建议**：展示可疑代码行高亮及安全替代建议（Safe Remediation）。
- **文件完整性与敏感锚点监控**：主动拦截对 `.env`、`settings.yaml` 及密钥文件的读写尝试。
- **合规审计导出**：界面一键导出 JSON 日志或 Markdown 审计对账单。
### v0.2.8 (界面统一与设置同步)
* **统一UI设计风格（对齐 `dsh-clinebot`）**：采用原生 DSH 设计令牌，将设置页面重构为4个结构化卡片分区，提供一致的网格布局、状态徽标与表单控件。
* **完整的配置响应式同步**：草稿状态完整支持 `diffGateMode`、`enableSastScan` 和 `enablePromptInjectionScan` 的持久化保存。
* **异常处理增强**：消除静默 catch 代码块，增加规范的日志记录。
* **测试覆盖扩充**：新增 `test/ui-and-stability-028.test.mjs` 测试套件（26项测试全部通过）。
### v0.2.7 (稳定性与误报优化)
* **消除 secret-write 误报**：不再对 `check_token.js` 或 `test_secret.py` 误报拦截，仅严格保护 `.env`、`.credentials`、SSH密钥等核心凭据。
* **SAST 注释智能过滤**：包含 SQL 关键字或 eval 示例的注释不再触发误报；允许通过 `import.meta.url` 和 `__dirname` 进行安全相对路径解析。
* **Diff 门禁资源保护**：超长行（>2048字符）截断扫描防卡死；测试文件自动跳过 prompt injection 检查。
* **安全 /audit 命令**：默认加载最近 50 条记录，防止大日志导致内存溢出（支持 `--all`）。
* **后台标签页轮询节流**：网页不可见时自动暂停状态轮询。
### v0.2.4 (DSH 插件规范修复与设置卡片优化)
* **Web UI 设置卡片参数补齐**: 在前端卡片中完整支持审计日志参数 (`enableAuditLog` 启用日志、`maxFileSizeMb` 文件大小上限、`retentionDays` 归档保存天数)，并支持中英俄本地化 (#34)。
* **消除双重插槽注册**: 移除了针对 `settings.section` 的 `setTimeout` 延迟回退机制，确保卡片原子化、稳定注入至 `settings.plugin.item` (#35)。
* **配置不可用时禁用表单**: 当设置快照处于 `unavailable` 状态时，表单控件与保存按钮自动禁用 (`disabled: true`) 并显示不可用提示 (#32)。
* **清理无用对等依赖**: 从 `package.json` 的 `peerDependencies` 中移除了未引用的 `@deepseek-ai/dsh-credentials` (#33)。
* **样式隔离**: 为 `
