Column
PseudoClaude
A source-guided series on PseudoClaude's terminal runtime, model and tool ecosystem, context lifecycle, security boundaries, and multi-agent collaboration.
PseudoClaude 是一个使用 Go 和 Bubble Tea 编写的本地终端 Coding Agent。项目将模型流式输出、工具调用、权限审批、会话持久化、上下文压缩、长期记忆和多 Agent 协作整合进同一个 TUI 运行时,并通过 Provider、MCP、Skill、Task、Team 与 Worktree 扩展执行边界。这组文章进一步下钻每种状态怎样写入、恢复、筛选、控制体积,副作用怎样被约束,以及多个 Agent 如何隔离工作并交换结果。
/ Notes
- 从 main.go 看 PseudoClaude 的整体架构
- Bubble Tea 状态机:TUI 如何驱动 Agent 交互
- ReAct 执行循环:模型、工具与结果如何闭环
- Tool 系统:从模型契约到受控执行
- 上下文与记忆:四种状态的生命周期
- 安全边界:权限引擎与 Plan Mode
- Provider 抽象:归一不同模型的流式协议
- MCP 工具桥接:一个远端工具如何走进 Agent
- Skill 渐进披露:按需加载 SOP 与专用工具
- 会话持久化:JSONL 日志如何写入与恢复
- 分层指令:项目与用户规则如何进入 System Prompt
- 长期记忆:如何异步提取跨会话知识
- 长上下文治理:Tool Result 落盘与历史摘要
- 危险命令防线:黑名单如何检查 Tool Call
- 路径沙箱:如何把文件工具限制在工作区
- 分层权限规则:匹配、优先级与授权持久化
- 交互审批:Ask 如何往返 Agent 与 TUI
- Plan Mode:工具定义与执行阶段的双重只读
- Agent 委派:Fork 与预定义子 Agent 如何分工
- 任务生命周期:前台执行、超时转后台与完成通知
- Team Lead 协作:持久成员、共享任务与运行恢复
- Mailbox 通信:文件锁、未读消息与 Agent 唤醒
- Git Worktree 隔离:独立分支、工作目录与保守清理