From d6214f81696efe58e8e0397d710c58f3510143c5 Mon Sep 17 00:00:00 2001 From: yibo Date: Tue, 18 Aug 2026 17:45:54 +0800 Subject: [PATCH] docs(CLAUDE.md): 修掉目录速查 / 路由清单 / 计数三类失真，并标出 auto-dev 这个幽灵入口 --- CLAUDE.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index de3726f..07aafe7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -48,11 +48,15 @@ npm run spec:extract # 从 docs/prd/newfunction/*.html 重新生成 npm run spec:check # CI/pre-commit 用，校验 _spec/ 与 HTML 是否同步 # CLI / 工具 -npm run example # 单次 auto-dev：实现斐波那契 -npm run example-bmi # 单次 auto-dev：BMI 程序 npm run logs / analyze / parse # 查看 / 分析 / 解析 Agent 运行日志 npm run skills:sync # 同步 Skill 到 Claude CLI 配置目录 -auto-dev "" # bin 入口 → server/src/cli/auto-dev.js + +# ⚠️ 下面三条目前是坏的，别照抄：入口 server/src/cli/auto-dev.js 不存在 +# （`server/src/cli/` 整个目录都没有，且 git 历史里从未有过这个文件）， +# 跑起来是 MODULE_NOT_FOUND。package.json 的 scripts.example / example-bmi +# 和 bin.auto-dev 三处引用都还挂着，要么补文件要么删引用。 +# npm run example / example-bmi +# auto-dev "" ``` ## 架构 @@ -67,8 +71,8 @@ auto-dev "" # bin 入口 → server/src/cli/auto-dev.js | 入口 | 端口 | 启动方式 | 挂载路由 | |------|------|----------|----------| -| `server/index.js` | 3010 | `npm run dev` / `npm run server` / `bash start.sh` | 全量：`/api/claude-chat` `/api/config` `/api/evolution` `/api/innovator` `/api/master` `/api/open` `/api/arena` `/api/auth` `/api/users` `/api/whatsapp` `/api/agent` `/api/goals` `/api/company` `/api/tasks` `/api/devloop`，WS `/ws/claude`，插件 / 心跳 / 中断任务恢复，`NODE_ENV=production` 时托管 `web/dist/` 静态文件 | -| `server/agent-server.js` | 3010 | 仅手动 `node server/agent-server.js`（历史保留） | 子集：`/api/agent` `/api/company` `/api/goals` `/api/tasks` `/api/devloop` | +| `server/index.js` | 3010 | `npm run dev` / `npm run server` / `bash start.sh` | 全量：`/api/claude-chat` `/api/config` `/api/evolution` `/api/innovator` `/api/master` `/api/open` `/api/arena` `/api/auth` `/api/users` `/api/whatsapp` `/api/agent` `/api/okr`（`/api/goals` 是它的向后兼容别名）`/api/company` `/api/graph-runs` `/api/tasks` `/api/devloop`，WS `/ws/claude`，插件 / 心跳 / 中断任务恢复，`NODE_ENV=production` 时托管 `web/dist/` 静态文件 | +| `server/agent-server.js` | 3010 | 仅手动 `node server/agent-server.js`（历史保留） | 子集：`/api/agent` `/api/company` `/api/okr`（+ `/api/goals` 别名）`/api/graph-runs` `/api/tasks` `/api/devloop` | 两者**不要同时启动**（端口冲突）。默认走 `index.js`（`start.sh` / `npm run dev` 都指向它）；`agent-server.js` 只在你想跑无依赖最小子集时手动启动。 @@ -78,8 +82,8 @@ auto-dev "" # bin 入口 → server/src/cli/auto-dev.js |------|------| | `server/index.js` | 完整 ArenaSK 服务（API + WS + 插件 + 前端托管），`start.sh` / `npm run dev` 默认入口 | | `server/agent-server.js` | 历史保留的轻量子集入口（Agent / Company / Goals / Tasks / DevLoop），仅手动启动 | -| `server/routes/` | 15 个 API 路由 | -| `server/services/` | 26 个业务服务（skill-db, benchmark-runner, company-service, heartbeat, pipeline-service, retrain-pipeline, …） | +| `server/routes/` | 各 API 路由（挂载点见上表两个入口，以入口文件为准） | +| `server/services/` | 业务服务（skill-db, benchmark-runner, company-service, heartbeat-service, company-heartbeat-service, pipeline-service, retrain-pipeline, graph-engine, …） | | `server/src/core/` | Agent 引擎核心（orchestrator, master-session, agent-manager, scheduler, session-pool, prompt-builder, runtime-resolver, …） | | `server/src/engine/` | 进程层（command-queue, idle-timer, process-guard, run-registry, failover-error） | | `server/src/plugins/` | 插件系统（plugin-manager, agent-bridge, config-bridge, bootstrap） | @@ -87,14 +91,14 @@ auto-dev "" # bin 入口 → server/src/cli/auto-dev.js | `server/services/devloop/` | DevLoop 支撑服务：path-resolver, git-vault, unit-registry（FSM）, timeline-logger, bug-tracker, doc-store, changelog-writer, sse-broker | | `server/src/tools/devloop/` | DevLoop Agent 可调用工具（coder/tester/integrator/triager/doc/persistence-tools + tool-registry + sandbox） | | `server/routes/devloop.js` | DevLoop REST：`/api/devloop/projects` | -| `system/agents/` | **全部 Agent 本体的唯一目录**（75 个）。`_base/` 是元 Agent 骨架，`_registry.json` 只用于按 id 补 `benchmark_score`（**目录才是数据源头**，`graph-seed-service.seedAgents()` 直接扫目录）。`_` 前缀为保留 id，扫描时跳过 | +| `system/agents/` | **全部 Agent 本体的唯一目录**。`_base/` 是元 Agent 骨架，`_registry.json` 只用于按 id 补 `benchmark_score`（**目录才是数据源头**，`graph-seed-service.seedAgents()` 直接扫目录）。`_` 前缀为保留 id，扫描时跳过 | | `system/agents/devloop-*/` | 六个 DevLoop Agent（pm, architect, coder, tester, integrator, triager），每个含 `config.json` + `prompt.md` + 一份指路用的薄 `agent.md` | | `server/src/tools/` | Master Agent 可调用的工具（call-agent, marketplace, orchestrate, train-skill, …） | -| `web/src/views/` | 10 个页面：AgentChat, AgentList, CompanyDashboard, JobsPanel, OkrDashboard, PipelineEditor, QuotaMonitor, SkillsMarket, TaskTimeline, TemplateAgents | +| `web/src/views/` | 页面：AgentChat, AgentList, CompanyDashboard, GraphConsole, JobsPanel, OkrDashboard, PipelineEditor, QuotaMonitor, SkillsMarket, TaskTimeline, TemplateAgents + DevLoop 四页（Dashboard / Projects / NewRequirement / Ops） | | `packages/` | `acp-core`, `agent-core`, `evolution`, `plugin-bootstrap` | | `data/skills/` | Skill 仓库（代码外部目录，路径由 `config.skillsDataDir` 控制） | | `scripts/` | 运维脚本（含 `sync-skills.js`） | -| `docs/` | 设计文档（`LEMONBOSS-SYSTEM-DESIGN.md`, `architecture-v5.md`, `open-api-manual.md`, `system-design/`, `user-guides/` …） | +| `docs/` | 设计文档，**按状态分目录**：`done/`（已实现 / 长期参考手册，含 `system-design/` 01–26 章与 `user-guides/`）、`todo/`（当前主线，27/28 系列）、`todo/future/`（暂缓）、`_archive/`。另有 `prd/`（DevLoop 规格源，见上）。**索引在 [`docs/README.md`](docs/README.md)，逐条带状态说明 —— 找文档从那里进，别在本表里加文件名**（这一行曾经列了 5 个具体文件，文档移进 `done/` 之后全成了死链） | ### 关键 API 路由 @@ -105,7 +109,7 @@ auto-dev "" # bin 入口 → server/src/cli/auto-dev.js | `/api/innovator/skills` | Skill 管理（Admin） | | `/api/master/chat` | Master Agent 对话（SSE） | | `/api/agent/*` | LemonBoss Agent Chat | -| `/api/company/*` `/api/goals/*` `/api/tasks/*` | 公司 / OKR / Task 管理 | +| `/api/company/*` `/api/okr/*` `/api/tasks/*` | 公司 / OKR / Task 管理（`/api/goals/*` 是 OKR 的向后兼容别名） | | `/api/auth/*` | JWT + GitHub OAuth | | `/ws/claude` | Claude 实时对话（仅 `index.js`） | | `/api/health` `/api/plugins` | 健康检查 / 插件状态 | -- libgit2 0.21.4