refactor: 精简 CLAUDE.md + 分层上下文管理

根 CLAUDE.md 从 80 行压缩到 15 行,详细规则拆分到按需加载位置:

- .claude/rules/development.md — 开发规则、测试要求、commit 规范
- .claude/rules/release.md — 发版流程、纪律、Release Notes 格式、构建说明
- docs/CLAUDE.md — docs 目录导航,要求检索前先读子目录 README
- src/lib/bridge/CLAUDE.md — bridge 模块关键约定(runAdapterLoop 时序、
  bridgeModeActive 互斥、offset 安全水位、adapter 扩展方式)

目的:减少每次会话的固定上下文消耗,非相关模块的文档不加载到上下文。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
7418andClaude Opus 4.6 committed 2026-03-01 22:59:00 +08:00
1 parent d9c4ad2c95
commit ead5cfcf8b
5 files changed
+54 -66

No files matched your search

+14
View File
@@ -0,0 +1,14 @@
# Bridge 模块
多 IM 远程桥接系统,通过 Telegram(后续可扩展)远程操控 CodePilot 中的 Claude 会话。
## 关键约定
- `bridge-manager.ts` 中 `runAdapterLoop()` 必须在 `state.running = true` 之后调用(async IIFE 的 while 条件在首个 await 前同步求值)
- `telegram-bot.ts`(通知模式)与 bridge adapter 互斥,通过 `globalThis` 上的 `bridgeModeActive` 标志协调,防止 HMR 重置
- Offset 安全水位:`fetchOffset`(API 调用)与 `committedOffset`(持久化)分离,仅 handleMessage 完成后才推进 committed
- 新增 adapter 只需实现 `BaseChannelAdapter` + 调用 `registerAdapterFactory()` 自注册 + `adapters/index.ts` 加 import
## 详细架构
见 `docs/handover/bridge-system.md`