🦞

go-tiny-claw

4-Layer Architecture ReAct Loop File System Tools Shell Commands

1
入口交互层 Entry & UI Layer
⌨️ CLI (cobra)
runreplservefeishu ilinksessionconfigversion
🪷 飞书 Bot
WebSocket 长连接审批卡片 流式卡片编辑/stop /reset
📱 个人微信 Bot
iLink HTTP长轮询 DM 私聊流式回复
💬 企业微信 Bot
Webhook回调 审批流Markdown 推送
🔀 serve 多渠道
并发启动信号优雅退出 多 Bot 共存统一配置
📡 统一 Reporter
TerminalReporterFeishuReporter WechatReporterILinkReporter
统一 Reporter 接口：Terminal · Feishu · WeChat · ILink ｜ Bootstrap 引擎初始化栈 ｜ 管道模式
2
核心引擎层 Core Engine Layer
🔄 ReAct 循环
Thinking + Action并行/串行执行 死循环检测流式输出
🔌 Provider 适配
ClaudeOpenAI 重试装饰器限流器 StreamAccumulator
📋 Schema 定义
MessageToolCall ToolResultTokenUsage
Session 管理：JSONL 持久化 · 多用户隔离 · 断点续跑 ｜ Subagent 调度：异步 spawn · context 取消传播
3
上下文工程层 Context Engineering Layer
🧩 PromptComposer
三段式 System Prompt 技能元数据索引 AGENTS.md 加载
🗜️ Compactor
5 级自适应压缩 Token 利用率驱动 滑动窗口截断
📊 可观测性
CostTrackerSpan 树追踪 File ExporterLog Exporter OTel Exporter
SkillLoader 渐进式技能暴露 ｜ RecoveryManager 错误恢复注入 ｜ 压缩级别自动切换
4
工具与执行层 Tool Execution Layer
🛠️ 11 个内置工具
read_filewrite_fileedit_file bashsearch_filesfetch_url read_skillspawn_subagentcheck_subagent task_outputtask_stop
🔒 权限引擎
COW 无锁读取正则热重载 14 条规则5 deny5 ask4 allow 审批流集成
🤖 子代理 & 后台进程
SubagentManager只读隔离 context 传播TaskManager PCB 模型RingBuffer
只读并行（信号量=5）· 写入串行 · Workspace RWMutex ｜ 依赖方向严格自上而下，无循环引用