内容
# 🕷️ RECLUSE
[](https://www.npmjs.com/package/recluse-mcp)
**自主网页合约验证** — 一个MCP服务器 + GitHub Action + 集体错误语料库，帮助您发现系统中的隐藏错误。
> RECLUSE 能够发现隐藏在系统缝隙中的错误。
Vibe 编码使得 *构建* 速度加快，但 *修复* 速度变慢。RECLUSE 跟踪系统的缝隙（生产者 → 存储 → 消费者合约），捕获其中的错误，阻止 PR，并将捕获的模式汇聚成一个 **集体语料库**，使每个人的“蜘蛛”都变得更聪明。
→ **实时页面与语料库：** https://eduverse-ai.app/recluse
---
## 快速入门
### ① GitHub Action — 审查每个 PR（阻止 🔴）
```yaml
# .github/workflows/recluse.yml
name: RECLUSE
on:
pull_request:
branches: [main]
jobs:
weave:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with: { fetch-depth: 0 }
- uses: vinsenzo83/recluse@v1.1
with: { base: origin/${{ github.base_ref }} }
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
```
如果没有密钥，则以 ** advisory** 模式运行（已知陷阱检查清单，非阻塞）。使用 `ANTHROPIC_API_KEY` 对差异进行实际编织 + 🔴 阻塞 + 为语料库贡献新模式。
### ② MCP 服务器 — 适用于您的编辑器（Cursor、Claude、任何 MCP 客户端）
一行命令，无需克隆 — 在 npm 上发布：
```json
{ "mcpServers": { "recluse": {
"command": "npx",
"args": ["-y", "recluse-mcp"],
"env": { "SPIDER_CORPUS_API": "https://eduverse-ai.app/api/corpus" }
} } }
```
**MCP 工具：** `spider_plan` · `spider_classify_tier` · `spider_checklist` · `spider_record_pattern`（本地 + 共享贡献）· `spider_pull_corpus`（集体拉取）。
**MCP 资源：** `spider://checklist` · `spider://queries` · `spider://corpus` · `spider://blackbox`.
---
## 工作原理 — 自主循环
```
WEB（检测）→ CATCH（合约不匹配）→ SPIDER（自主修复）→ RE-WEAVE（验证）→ 循环直到 🔴 = 0
```
多视角的“蜘蛛”跟踪每个端到端流程，并比较 *编写* 的内容（列 / 类型 / 枚举 / 单位 / 授权）与 *消费者期望* 的内容。缝隙中的不匹配 — 单个文件审查无法捕获的错误 — 通过实时证据捕获。
### 蜘蛛层级 — 按关键性划分资源
| 蜘蛛 | 模型 | 范围 |
|---|---|---|
| 🕷️ King | Opus | 支付 · 授权 · GDPR · 数据丢失 · 机密 |
| 🕸️ Mid | Sonnet | 业务逻辑 · 合约 · 国际化 · 门控 |
| 🐜 Baby | Haiku | 文档 · 死代码 · 校验 |
---
## 🧬 集体语料库（护城河）
使用的人越多，语料库就越厚 — 每个蜘蛛捕获的错误更多（数据网络效应）。模式按技术栈分类，因此在一个项目中捕获的错误可以帮助同一技术栈上的其他人。
- **先净化：** 文件路径、代码字面量、机密（密钥 / JWT / 高熵）、电子邮件、URL、IP 地址都被剥离；任何仍然可疑的内容都会被 **拒绝**。只有概括的 *技术* 被共享。
- **选择性加入和匿名：** 贡献者/项目仅存储为不可逆的哈希值 — 没有身份，没有原始文本。
### 语料库 API
- `POST /v1/patterns` `{klass,name,signal,fix,tags?,severity?,tier?}` → 净化 · 去重 · 可信度累积
- `GET /v1/patterns?tags=postgres,payment&class=unit&limit=50` → 集体语料库（已验证 · 按命中次数排序）
- `GET /healthz`
---
## 原则
不造假（仅实时证据）· 先净化（零代码/机密泄露）· 选择性加入和匿名 · 检测 = 只读，修复 = 隔离的蜘蛛。
## 仓库布局
```
src/index.js # MCP 服务器（stdio）
cli/recluse.mjs # CI 编织 CLI
action.yml # GitHub Action
```
集体语料库是一项托管服务（https://eduverse-ai.app/api/corpus）；其后端（模式、净化管道、摄入）是闭源的。
## License
UNLICENSED（专有）。
