dsh plugin --profile web add dsh-research-check

{ "transport": "stdio", "serverName": "research-check",
  "command": "node", "args": ["<plugin>/mcp/server.mjs"] }

# 1) 链接 DSH 的 peer 包（链接安装必须做，否则报 ERR_MODULE_NOT_FOUND: @deepseek-ai/dsh-tools）
node tests/link-peers.mjs

# 2) 装进某个 profile（会自动写进该 profile 的 dsh.profile.bundles）
dsh plugin --profile web add link:C:\path\to\dsh-research-check

# 3) 重启该 profile —— 工具在启动时注册，重启后模型即可调用

pip install pymupdf openpyxl pillow python-docx

cp skill/SKILL.md ~/.dsh/skills/research-evidence-check/        # DSH 用户级
cp skill/SKILL.md <project>/.dsh/skills/research-evidence-check/ # 项目级，随仓库共享
cp skill/SKILL.md ~/.agents/skills/research-evidence-check/      # .agents/skills 约定

# 论文
python python/spec_build.py --requirements format2026.doc --out specs/cumcm-2026.json \
    --profile academic --name "2026 全国大学生数学建模竞赛（论文格式规范）"
# 软件验收
python python/spec_build.py --requirements 验收标准.docx --out specs/acceptance.json \
    --profile software --name "软件交付验收标准"

python python/spec_build.py --list-profiles     # 查看可用类型与规则数

# 论文：源码 + 成稿 + 交付文件 + 压缩包
python python/check_spec.py --spec specs/cumcm-2026.json --root . \
    --doc paper/main.tex --pdf 论文初稿.pdf \
    --files 论文初稿.pdf support.zip --archive support.zip

# 软件交付：只看文件类规则
python python/check_spec.py --spec specs/acceptance.json --root . \
    --files README.md LICENSE CHANGELOG.md run.log

# 格式化输出（中文表格）
python tests/run_spec_check.py --spec specs/cumcm-2026.json

research_audit(paper="论文初稿.pdf", archives=["support.zip"], manifest=["result1.xlsx", "..."])
research_numbers(paper=["paper/main.tex"], ledger="paper-ledger.json")
research_ledger(action="add", key="q3.total_cost", value=1521.6, unit="万元",
                source="code/q3_rolling_mpc.py", anchor="全年费用")
research_spec(action="check", spec="specs/cumcm-2026.json", pdf="论文初稿.pdf")

{
  "id": "doc.body_pages",
  "title": "正文页数上限",
  "check": "max_pages",
  "scope": "body",
  "severity": "hard",
  "params": { "limit": 30, "appendix_marker": ["附录"] },
  "why": "页数是评委翻页时最先感知的硬约束，超一页即违规。",
  "source": "…第四条论文从第四页开始是正文内容（不要目录，不超过30页）…"
}

{
  "schema": 1,
  "entries": [
    {
      "key": "q3.total_cost",
      "value": 1521.6,
      "unit": "万元",
      "source": "code/q3_rolling_mpc.py",
      "anchor": "全年费用",
      "revision": 3
    }
  ]
}

[ok  ] hard  gen.archive_manifest   与清单逐条一致（清单 自动识别 13 项）
[ok  ] hard  doc.body_pages         正文（附录自第 31 页起）30 页 / 上限 30 页
[ok  ] hard  doc.abstract_within_page 摘要（含关键词）在 1 页内
[ok  ] hard  doc.margins            页边距 {top:2.5, bottom:2.5, left:2.5, right:2.5}
[ok  ] hard  doc.metadata_identity  属性未见身份信息
[skip] hard  gen.office_identity    未提供 docx/xlsx 文件（需 --files 传入）
→ 15 通过 / 0 错误 / 2 跳过

npm test                 # 语法 + 上架清单 + 依赖无关契约 + 规格 e2e + 离线回归 + 跨领域
npm run test:generality  # 只跑跨领域（软件/数据/文档，含负例）
npm run mcp:smoke        # MCP 协议层（stdio 真实报文）
npm run boot             # 真启动一个临时 profile，确认不会把 profile 启崩
npm run test:hygiene     # 负例：故意写入身份元数据，必须判 fail

lib/index.js        插件入口（apply / inject / Config / systemPrompt / skills）
lib/core.js         宿主无关执行核心 —— 插件与 MCP 服务器共用，避免两套逻辑漂移
lib/tools.js        四个 DSH 工具的注册与路径解析（不含业务逻辑）
lib/spec-tool.js    规则词汇表与交付物 profile 定义
lib/ledger.js       台账读写、逐条核对、锚点探针
lib/ledger-cli.js   命令行入口（不依赖 DSH）
lib/skill.js        读取并注册内嵌 skill
lib/util.js         Python 解释器发现、进程执行、结果汇总
mcp/server.mjs      零依赖 MCP 服务器（stdio JSON-RPC 2.0）
skill/SKILL.md      独立 agent skill（五阶段流程）
python/rule_packs.py   六类交付物规则包（模板 + 判定器 + 出处）
python/spec_build.py   要求文本 → 规格 JSON
python/check_spec.py   规格 → 判定报告（37 个判定器）
python/check_numbers.py 数字抽取与一致性
python/audit_paper.py   版面与文档卫生体检
python/check_hygiene.py 文档元数据专项
tests/                  九段验证（含负例与跨领域）