zhijian-ai-bluebook-workbuddy-harness README

The project's README from github.com/zjp1997720/zhijian-ai-bluebook-workbuddy-harness. As one markdown file: README.md.

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 → 浏览器直接阅读,无需下载
PDF 下载 book.pdf → A4 排版,适合本地阅读与转发
单文件 HTML 下载 book.html 自包含离线版,保存后可直接打开
Release 查看 v0.1.0-pilot 版本化下载、发布说明与资产校验

PDF 文件较大,GitHub 在线预览可能加载不完整,建议下载后阅读。

适合谁

读完能解决什么

  1. 建立一套可迁移的 Harness 心智模型,而不是背功能菜单。
  2. 在本机找到 WorkBuddy 关键目录,并理解每一层文件负责什么。
  3. 说清插件、专家、Skill、Connector、SubAgent 与 Agents Team 的关系。
  4. 看懂身份、记忆、插件注入和项目上下文如何拼成系统提示词。
  5. 用“层级 → 优先级 → 缓存 → 同步 → 版本”五步路径排查为什么配置没有生效。
  6. 在安装插件或修改配置前,先判断注入面、权限面与隐私风险。

全书结构

部分 章节 你会得到什么
一、从按钮走向文件 第 1—3 章 一次对话的拆解方法、五层 Harness 模型、本地目录地图
二、请求是怎样拼出来的 第 4—6 章 三层记忆、系统提示词拼装、身份四件套与边界
三、能力如何进入主线程 第 7—11 章 专家、插件、Skill、会话证据、Connector 与 MCP
四、安全与生态坐标 第 12—13 章 插件供应链、隐私边界,以及与 Claude Code / Codex 的设计对照
五、从理解走向实战 第 14—15 章 五步排查手册,以及课程、团队和组织复用方法
附录 A—D 目录速查、故障排查卡、术语表、版本冻结与研究方法

两条推荐阅读路线

书中一页

这张图概括了全书的方法:每一个产品层级,都要能落回本地证据,并在书中找到对应解释。

五层 Harness 与本地证据对照

版本与证据边界

WorkBuddy 更新很快。书中的路径、字段和默认行为都应放在上述版本边界内理解;使用更新版本时,请同时核对官方文档和本机实际结果。

本书是独立研究与实践指南,与 WorkBuddy 及相关厂商无隶属或官方合作关系。

许可

完整边界见 LICENSES.md。文件完整性可通过 CHECKSUMS.sha256 核验。

关于作者

大鹏|智见 AI

智见科技创始人,AI 落地顾问、企业与高校培训讲师,长期研究 Agent、Skill、Context Engineering 与 AI 编程工作流。

仓库边界

这个仓库只发布读者交付物:自包含 HTML、PDF、许可、校验和与经批准的展示图片。它不包含内部写书 Skill、作者画像、研究控制面、审稿记录、构建中间件或生产工作流。

如果你发现版本差异、事实错误或阅读问题,请直接提交 Issue。

zhijian-ai-bluebook-workbuddy-harness (zjp1997720/zhijian-ai-bluebook-workbuddy-harness)

Searching Database…

这是什么?这是一本逆向剖析 AI 代理应用 WorkBuddy 的书(Zhijian AI Bluebook ZJBB-003),把它的界面行为追溯到它写入的本地文件和发送给模型的请求,涵盖提示词、记忆、插件、专家、Skills 和安全边界。
这是需要安装的软件,还是用来看的东西?它是一本自包含的电子书,不是应用程序。你可以通过 GitHub Pages 在线阅读、读 PDF,或打开单个离线 HTML 文件。
怎么阅读它?在浏览器打开 GitHub Pages 在线版本、下载 book.pdf 用于 A4 阅读,或获取自包含的 book.html 离线阅读;所有版本也都附在 v0.1.0-pilot Release 里。
这是 WorkBuddy 官方手册吗?内容会不会过时?书中的分析针对在 macOS 上本地观察到的特定 WorkBuddy 构建,是与 WorkBuddy 开发方无关的独立研究,因此随着 WorkBuddy 更新,路径和默认值可能发生变化。
这本书是写给谁的?适合日常使用 WorkBuddy 却遇到莫名行为的人、想理解提示词/记忆/插件如何组合成一次请求的 Agent 实践者,以及需要讲解 Harness 机制的工程师或讲师,尤其是已经熟悉 Claude Code 或 Codex 的人。
这本书是怎么组织的?全书 15 章分为 5 部分,另有 4 个附录:从界面行为到本地文件、一次请求如何组装、能力(专家、插件、Skills、Connectors、MCP)如何进入主线程、与 Claude Code 和 Codex 的安全/生态对比,以及一套实用的排障流程。
它讲到 MCP 和 Connectors 了吗?讲了。第三部分(第 7-11 章)解释专家、插件、Skills、会话证据、Connectors 和 MCP,以及它们如何把能力注入 WorkBuddy 的主线程。
研究针对的具体 WorkBuddy 版本是哪个?蓝皮书的结论基于 WorkBuddy 5.3.13(构建号 20fd9da5c9a0cac41feb61b133f7bce4fe183a89),在 macOS 上本地观察所得,研究截至 2026-08-15,有 12 个来源和 27 条论断支撑。
如果我只想让 WorkBuddy 用得稳,该从哪里读起?推荐的快速路径是第 1 至 3、5、7 和 12 章,再看第 14 章的五步排障法;想深入定制或用于教学,再加上第 4、6、8-10、13 和 15 章。
Creator
zjp1997720
Size
82 MB
Stars
240
Age
2mo
Commits · 90 Days