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:
1 parent
d9c4ad2c95
commit
ead5cfcf8b
5 files changed
+54
-66
No files matched your search
@@ -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`
|
||||
Reference in new issue
Block a user