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…

Что это?Это книга (Zhijian AI Bluebook ZJBB-003), которая проводит реверс-инжиниринг WorkBuddy — приложения ИИ-агентов: она прослеживает поведение UI до локальных файлов, которые он пишет, и запросов, которые отправляет модели, охватывая промпты, память, плагины, экспертов, Skills и границы безопасности.
Это ПО, которое я устанавливаю, или то, что я читаю?Это самодостаточная электронная книга, а не приложение. Читать её можно онлайн через GitHub Pages, как PDF или как один офлайн HTML-файл.
Как её читать?Откройте онлайн-версию GitHub Pages в браузере, скачайте book.pdf для чтения в формате A4 или возьмите самодостаточный book.html для офлайна; всё это также приложено к релизу v0.1.0-pilot.
Это официальное руководство по WorkBuddy или оно устареет?Анализ привязан к конкретной сборке WorkBuddy, наблюдавшейся локально на macOS, и является независимым исследованием без связи с создателем WorkBuddy, поэтому пути и значения по умолчанию могут расходиться по мере обновлений WorkBuddy.
Для кого эта книга?Для тех, кто ежедневно пользуется WorkBuddy и сталкивается с необъяснимым поведением; для практиков Agent, желающих понять, как промпты, память и плагины складываются в запрос; и для инженеров или тренеров, которым нужно преподавать механику Harness, особенно уже знакомых с Claude Code или Codex.
Как устроена книга?В ней 15 глав в 5 частях плюс 4 приложения: от поведения UI к локальным файлам, как собирается запрос, как возможности (эксперты, плагины, Skills, Connectors, MCP) попадают в основной поток, сравнения безопасности и экосистемы с Claude Code и Codex, а также практический workflow поиска неисправностей.
Рассказывается ли там про 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