前言¶

DeepSeek Harness（DSH）本地插件，由 jackeyunjie 维护。插件将分散在各层的规则文件（AGENTS.md、rules/*.md）进行统一管理，提供加载可视化、预算治理、硬拦截与合规性审计能力。

核心功能¶

• 分层规则发现与注入
• 写回防护
• FORBID 硬规则
• 规则 Lint
• 注入日志与遵守率
• Web 面板

安装与启用¶

1. 确保环境 Node >= 22。
2. 在插件目录执行 npm install 安装依赖。
3. 挂载到 web profile：dsh plugin --profile web add link:"$PWD"。
4. 验证配置：dsh --profile web --dump-config | grep -A3 rule-lens。
5. 启动 DSH：dsh --profile web，访问面板 http://127.0.0.1:3080/rule-lens。

配置与规则写法¶

YAML 配置¶

全局开关存储于 ~/.dsh/settings.yaml：

rule-lens:
  writeGuard: true        # 写回防护开关
  budgetBytes: 65536      # 注入预算（字节）
  whitelistDirs: ['.cursor']  # 白名单目录

FORBID 硬规则写法¶

在任何被加载的规则文件里写一行：

FORBID: write *.env
FORBID: * **/secrets/**
FORBID: bash *rm -rf*

工具名 glob 匹配 exec.name（如 write、bash），路径 glob 同时匹配原始参数、绝对路径、相对路径。

分层规则注入机制¶

插件按层级与顺序注入规则，多文件按数字前缀排序（00-*.md 先于 01-*.md）：
- L1：~/.agents/AGENTS.md，会话启动即注入。
- L2：~/.agents/rules/*.md，会话启动即注入。
- L4：<工作区>/.agents/rules/*.md，会话启动即注入。
- L5：<子目录>/rules/*.md，在该目录首次被 read/write/edit 触达后按需注入。

预算治理¶

注入预算默认 64KB。当内容超限时，从作用域最宽的文件开始淘汰（L1 优先），淘汰会写日志并在面板告警。

日志与合规¶

• 日志路径：~/.dsh/rule-lens/log.jsonl、compliance.jsonl。
• 面板功能：展示各层状态、预算条、Lint 结果、遵守率、预热开关及日志下载。

生态与链接¶

• 依赖仅限 @deepseek-ai/* peer 与 Node 内置模块，零构建、纯 ESM。
• GitHub：https://github.com/jackeyunjie/dsh-rule-lens
• 目录：https://www.skillhub.cn/plugins/jackeyunjie/dsh-rule-lens