AI 编程工具
Archboard:面向编码代理的软件架构规划与评审工具
miklschmidt/archboard · Plan the next architecture with your coding agent. Archboard draws every proposal against what is built, keeps the record of why it changed, and walks your team through it out loud.
ELI5:它是什么,解决什么问题
Archboard 是一款供软件与云架构师配合编码代理(Claude Code、Codex)使用的架构规划工具。代理读取代码并向 Archboard 描述系统的服务、存储、队列及调用关系,渲染器据此绘制架构图,无需手动拖拽布局。它可对照现有架构绘制变更提案、并排比较多个方案、记录采纳理由并保留历史,还可借助 Git 历史统计模块变更频率与共同变更情况,按 Ousterhout 的软件设计哲学提示浅模块、传递方法、变更放大、信息泄漏等设计气味线索。它支持代码检查,用于发现源码链接失效、关系画反及架构遗漏的依赖,覆盖 TypeScript、Python、C#、Swift、Rust、Go、C、C++、Objective-C 及 Terraform、Kubernetes 清单等,并可生成带旁白的讲解视频和序列图,用于设计评审、新人上手和 PR 说明。
核心能力与快速开始
★ 0 · TypeScript
- 能做什么
- 结合编码代理维护架构模型并自动渲染架构图;将提案与现有架构对比;并排比较竞争方案;记录架构采纳及其变更原因;把 Git 提交映射到模块,统计变更频率和共同变更;依据 Ousterhout 的设计原则给出模块接口、隐藏部分、传递方法和耦合等度量事实(不直接评分);代码检查可发现失效源码链接、反向关系和遗漏依赖;支持多语言与基础设施代码分析;可生成带旁白的架构讲解视频和序列图。
- 适用场景
- 阅读陌生系统的架构并定位设计成本高的位置;在写代码前规划架构变更并评估多个选项;设计评审或 PR 中展示架构差异;新人逐步上手系统架构;沉淀架构决策历史与变更记录。
- 项目形态
- 可直接使用的工具
- 部署方式
- 未说明;README 提到需要本地运行 Archboard 服务器,快速开始章节未在摘录中完整给出
- 主要依赖
- 运行环境需 Bun 1.4.4 或更新版本;可使用 Claude Code 或 Codex 作为编码代理;代码检查在 Python、Swift、Rust、Go、C#、C、C++、Objective-C 上可配置语言服务器以增强证据
- 使用限制
- 度量基于模型与提交记录,不衡量实现行为,也不会判定模块是否浅;代码检查部分语言需配置语言服务器,否则证据较弱;语音讲解与视频功能依赖 Codex 语音,具体调用成本、硬件要求和 API 限制未说明;许认为 BUSL-1.1(非标准 OSI 许可证标签),商用条件未说明。
- 许可证
- NOASSERTION
- 最近推送
- 2026-11-05 06:58
资料检查:2026-11-05 07:00 · 卡片整理:2026-11-05 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证
职业应用
程序员
配合 Claude Code 或 Codex 等编码代理,读取代码并自动绘制系统架构图,用于架构规划、设计评审和 PR 说明;对照现有架构绘制变更提案、并排比较多个方案并记录采纳理由;借助 Git 历史统计模块变更频率与共同变更情况,按 Ousterhout 的软件设计哲学提示浅模块、传递方法、变更放大、信息泄漏等设计气味线索;通过代码检查发现源码链接失效、关系画反及架构遗漏的依赖;生成带旁白的讲解视频和序列图,用于设计评审、新人上手和 PR 说明。
查看内容依据
Archboard 是一款供软件与云架构师配合编码代理(Claude Code、Codex)使用的架构规划工具。代理读取代码并向 Archboard 描述系统的服务、存储、队列及调用关系,渲染器据此绘制架构图,无需手动拖拽布局。
由 AI 根据来源材料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。