WorkBuddy Harness 拆解
把 UI 上的按钮，翻译回磁盘上的文件与发给模型的请求
智见 AI 蓝皮书 · ZJBB-003 · 公开测试版 v0.1.0
在线阅读 · 下载 PDF · 离线 HTML · 反馈问题
WorkBuddy 很容易上手，也很容易在深入使用后碰到一堵看不见的墙：它为什么记住了这件事？插件往主线程里注入了什么？改了配置为什么不生效？专家、Skill、Connector、SubAgent 和 Agents Team 到底是什么关系？
这本书不复述按钮怎么点。它沿着一条更有用的路径往下拆：从界面行为找到本地文件，再从本地文件还原一次请求是怎样被拼装出来的。
| 版本 | 规模 | 图解 | 证据边界 |
|---|---|---|---|
| 公开测试版 v0.1.0 | 60 页 · 15 章 + 4 附录 | 18 张机制图 | WorkBuddy 5.3.13 · macOS 本地实测 |
直接阅读
| 形式 | 入口 | 适合场景 |
|---|---|---|
| 在线版 | 打开 GitHub Pages → | 浏览器直接阅读，无需下载 |
| 下载 book.pdf → | A4 排版，适合本地阅读与转发 | |
| 单文件 HTML | 下载 book.html | 自包含离线版，保存后可直接打开 |
| Release | 查看 v0.1.0-pilot | 版本化下载、发布说明与资产校验 |
PDF 文件较大，GitHub 在线预览可能加载不完整，建议下载后阅读。
适合谁
- 天天在用 WorkBuddy，但遇到“不生效、行为怪、插件装完反而变笨”时不知道从哪里排查的人。
- 想弄懂系统提示词、身份、记忆、插件和项目上下文如何共同进入一次请求的 Agent 实践者。
- 需要安全定制 WorkBuddy，或要把 Harness 机制讲给学员、同事和客户的工程师与讲师。
- 用过 Claude Code、Codex 等 Coding Agent，想理解 WorkBuddy 图形界面背后运行机制的人。
读完能解决什么
- 建立一套可迁移的 Harness 心智模型，而不是背功能菜单。
- 在本机找到 WorkBuddy 关键目录，并理解每一层文件负责什么。
- 说清插件、专家、Skill、Connector、SubAgent 与 Agents Team 的关系。
- 看懂身份、记忆、插件注入和项目上下文如何拼成系统提示词。
- 用“层级 → 优先级 → 缓存 → 同步 → 版本”五步路径排查为什么配置没有生效。
- 在安装插件或修改配置前，先判断注入面、权限面与隐私风险。
全书结构
| 部分 | 章节 | 你会得到什么 |
|---|---|---|
| 一、从按钮走向文件 | 第 1—3 章 | 一次对话的拆解方法、五层 Harness 模型、本地目录地图 |
| 二、请求是怎样拼出来的 | 第 4—6 章 | 三层记忆、系统提示词拼装、身份四件套与边界 |
| 三、能力如何进入主线程 | 第 7—11 章 | 专家、插件、Skill、会话证据、Connector 与 MCP |
| 四、安全与生态坐标 | 第 12—13 章 | 插件供应链、隐私边界，以及与 Claude Code / Codex 的设计对照 |
| 五、从理解走向实战 | 第 14—15 章 | 五步排查手册，以及课程、团队和组织复用方法 |
| 附录 | A—D | 目录速查、故障排查卡、术语表、版本冻结与研究方法 |
两条推荐阅读路线
- 只想把 WorkBuddy 用稳： 1 → 2 → 3 → 5 → 7 → 12 → 14。
- 想做深度定制或讲课： 在主路线基础上补 4 → 6 → 8 → 9 → 10 → 13 → 15。
书中一页
这张图概括了全书的方法：每一个产品层级，都要能落回本地证据，并在书中找到对应解释。
版本与证据边界
- 目标版本： WorkBuddy 5.3.13（build
20fd9da5c9a0cac41feb61b133f7bce4fe183a89）。 - 声明环境： macOS 本地安装与运行时观测。
- 资料截止： 2026-08-15。
- 证据规模： 12 个来源、27 条 Claim，关键结论覆盖率 100%。
- 研究边界： 只解释本地文件、官方资料和可观测运行时能够支持的结论；不把闭源内部实现的推断写成事实。
WorkBuddy 更新很快。书中的路径、字段和默认行为都应放在上述版本边界内理解；使用更新版本时，请同时核对官方文档和本机实际结果。
本书是独立研究与实践指南，与 WorkBuddy 及相关厂商无隶属或官方合作关系。
许可
- 原创正文与确定性知识图：
CC BY-SA 4.0。 - 原创示例代码：
MIT。 - 第三方材料遵循其原始许可。
- 智见 AI 名称、Logo、智见小蓝角色设定与品牌母资产保留权利，不随正文许可开放。
完整边界见 LICENSES.md。文件完整性可通过 CHECKSUMS.sha256 核验。
关于作者
大鹏｜智见 AI
智见科技创始人，AI 落地顾问、企业与高校培训讲师，长期研究 Agent、Skill、Context Engineering 与 AI 编程工作流。
- GitHub：@zjp1997720
仓库边界
这个仓库只发布读者交付物：自包含 HTML、PDF、许可、校验和与经批准的展示图片。它不包含内部写书 Skill、作者画像、研究控制面、审稿记录、构建中间件或生产工作流。
如果你发现版本差异、事实错误或阅读问题，请直接提交 Issue。