快速开始 · 02

快速开始

约 2 分钟阅读 Apache-2.0 本文基于 v0.1.0（2026-11-01）

这工具在不同市场里的叫法不一样。按你手上有什么挑一条，别混装——同一台机器上装两套会互相盖掉产物目录。

渠道	那个市场里它叫什么	怎么装	状态
DSH 插件市场	项目体检台`dsh-plugin-recoscan`	dsh plugin add dsh-plugin-recoscan	筹备中
WorkBuddy 开放平台	项目体检台`recoscan`	在市场里搜「项目体检台」	筹备中
GitHub Releases	RecoScan`recoscan`	`git clone https://github.com/wusongwwss-collab/recoscan.git`	已上架

搜不到就按包名搜。中文市场显示中文名，英文包管理器只认包名——这两列写得不一样不是笔误，是各市场的规矩。

这一篇只让你先跑出一张体检表，不解释指标怎么来的。

环境底线：Node.js 18 及以上——体检引擎只用 Node 内置模块，无需 npm 安装任何依赖，零联网。

01第一步：克隆仓库

bash

git clone https://github.com/wusongwwss-collab/recoscan.git
cd recoscan

GitHub 国内访问可能不稳定；若打不开，可用加速代理或稍后重试，Gitee 镜像筹备中。

服务器为 stdio 形态（hosts/mcp/project_server.mjs），由宿主负责拉起与关闭。把下面这段粘进宿主配置文件（Claude Desktop、VS Code 等），路径换成你本机的仓库路径：

json

{
  "mcpServers": {
    "recoscan-project": {
      "command": "node",
      "args": ["/你的路径/recoscan/hosts/mcp/project_server.mjs"]
    }
  }
}

配置保存后重启宿主，在工具列表确认 check.analyze / plan.suggest / rules.validate 真实可见（以宿主工具列表为准）。

check.analyze 的输入是项目台账（JSON 数组或 CSV 文本），字段：name 项目名 / status 状态 / deadline 截止日 / depends 前置依赖 / evidence 证据或说明。在宿主对话里直接喂：

text

用 check.analyze 体检这份台账：
灯塔项目,进行中,2026-11-03,围墙项目,"与对方确认了交付窗口"
围墙项目,阻塞中,2026-11-10,,"等对方排期，已等 5 天"

你会看到第一张体检卡：每个项目「风险等级 + 归因理由 + 证据行 + 下一步建议」——每条风险结论都带指向台账行的证据引用，无证据不出结论。

text

用 plan.suggest 给这份台账排下周的优先级

plan.suggest 按台账状态 / 截止 / 依赖给排期建议（完成殿后、阻塞前置、临期优先），每条建议必须挂证据行。

text

用 rules.validate 校验 packs/project/rules.example.yaml

体检规则包在 packs/project/rules.example.yaml（指标权重、风险阈值、护栏、抽取参数，字段全中文注释；示例权重即引擎默认口径）。每次改完规则先跑 rules.validate。