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…

What is this?This is a book (Zhijian AI Bluebook ZJBB-003) that reverse-engineers WorkBuddy, an AI agent app, tracing its UI behavior back to the local files it writes and the requests it sends to the model, covering prompts, memory, plugins, experts, Skills and security boundaries.
Is this software I install, or something I read?It is a self-contained ebook, not an application. You read it online via GitHub Pages, as a PDF, or as a single offline HTML file.
How do I read it?Open the GitHub Pages online version in a browser, download book.pdf for A4 reading, or grab the self-contained book.html for offline use; all are also attached to the v0.1.0-pilot Release.
Is this an official WorkBuddy manual, or will it go stale?The analysis is pinned to a specific WorkBuddy build observed locally on macOS and is independent research with no affiliation to WorkBuddy's maker, so paths and defaults may drift as WorkBuddy updates.
Who is this book for?People who use WorkBuddy daily and hit unexplained behavior, Agent practitioners who want to understand how prompts/memory/plugins combine into a request, and engineers or trainers who need to teach Harness mechanics, especially those already familiar with Claude Code or Codex.
How is the book organized?It has 15 chapters in 5 parts plus 4 appendices: from UI behavior to local files, how a request is assembled, how capabilities (experts, plugins, Skills, Connectors, MCP) enter the main thread, security/ecosystem comparisons with Claude Code and Codex, and a practical troubleshooting workflow.
Does it cover MCP and Connectors?Yes, part three (chapters 7-11) explains experts, plugins, Skills, session evidence, Connectors and MCP, and how they inject capabilities into WorkBuddy's main thread.
What exact WorkBuddy version does the research target?The bluebook's findings are pinned to WorkBuddy 5.3.13 (build 20fd9da5c9a0cac41feb61b133f7bce4fe183a89), observed locally on macOS, with research cut off on 2026-08-15 and backed by 12 sources and 27 claims.
Where should I start if I just want WorkBuddy to work reliably?The recommended quick path is chapters 1 to 3, 5, 7 and 12, then 14 for the five-step troubleshooting method; deeper customization or teaching adds chapters 4, 6, 8-10, 13 and 15.
Creator
zjp1997720
Size
82 MB
Stars
240
Age
2mo
Commits · 90 Days