安装与数据接入
RecoScan 是「零联网、零第三方依赖」的本地工具：体检引擎只用 Node.js 内置模块，克隆仓库即用。先克隆：
bash
git clone https://github.com/wusongwwss-collab/recoscan.git cd recoscan
GitHub 国内访问可能不稳定；若打不开，可用加速代理或稍后重试，Gitee 镜像筹备中。
01跑起来需要什么
| 需要 | 版本 | 说明 |
|---|---|---|
| Node.js | 18 或更高 | stdio MCP 服务器与体检引擎（core/js/）都是纯 Node 内置模块，无需 npm 装包 |
以下都不是必需的：任何 API key、任何云账号、任何大模型、数据库服务。
02唯一的接法：stdio MCP
json
{
"mcpServers": {
"recoscan-project": {
"command": "node",
"args": ["/你的路径/recoscan/hosts/mcp/project_server.mjs"]
}
}
}重启宿主后确认三个工具真实可见：
| 工具 | 输入 → 输出 |
|---|---|
check.analyze | 项目台账（JSON/CSV 文本）→ 体检卡：风险等级 / 归因理由 / 证据行 / 下一步建议（逐条带证据引用） |
plan.suggest | 台账状态 / 截止 / 依赖 → 排期建议（完成殿后、阻塞前置、临期优先，每条必挂证据行） |
rules.validate | 规则包结构校验，每次改规则后先跑它 |
apply 类的写动作刻意没有——RecoScan 只读你的台账、只出报告，不动你的任何项目文件。
03台账输入格式
JSON 数组或 CSV 文本，字段五列：
| 字段 | 含义 | 缺了会怎样 |
|---|---|---|
name | 项目名 | 缺了整行跳过 |
status | 状态（进行中 / 阻塞中 / 已完成 …） | 按「无状态」处理，权重降档 |
deadline | 截止日（如 2026-11-03） | 不参与临期优先 |
depends | 前置依赖（其他项目名） | 依赖未闭合指标不计 |
evidence | 证据或说明 | 该行结论不带证据引用 |
最小可用数据集就是这三列：name + status + evidence 就能出第一张体检卡。数据从哪来它不管——人工维护的台账表、项目管理工具导出的 CSV、会议纪要里整理的几行，喂进来就体检。
04配置在哪
packs/project/rules.example.yaml：五个指标的权重（默认 3/2/1/1/2）、风险阈值、护栏 300/450/600、抽取参数，字段全中文注释，示例权重即引擎默认口径。改完先跑 rules.validate。
05接进你现有的流程
周会前自动跑一次：把导出的台账 CSV 喂给 check.analyze，结果 findings.json 可直接进 CI 或周报——按一下出一张表，剩下的讨论时间还给项目本身。