From e3f454dbd12237c6e26cc5e076275b5640188af7 Mon Sep 17 00:00:00 2001 From: micklife Date: Thu, 20 Aug 2026 16:09:12 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=20workbuddy=20?= =?UTF-8?q?=E6=8E=A5=E5=85=A5=E5=88=B0=20README=20=E4=B8=8E=E6=9E=B6?= =?UTF-8?q?=E6=9E=84=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README：支持列表加入 WorkBuddy；"与 agent 集成"章节补充 mex integrate workbuddy 命令与对接文档链接；顺带修正过时的 "hook 配置"文案（PR #1 起已改为 skill 承载） - architecture.md §8.4：补 workbuddy 命令示例，说明其 skill 写入 位置（base 即 skill 根目录，直接写 mex/SKILL.md） - dsh-integration.md：§8 引用的 agent 列表加入 workbuddy --- README.md | 8 +++++--- docs/architecture.md | 6 +++++- docs/dsh-integration.md | 2 +- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 62f8ace..24dd82e 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ AI agent 越来越强，但它记不住你：新开一段对话，agent 就"失 ## meX 的核心优势 - 完全的数据掌控：meX 部署于你的本地设备，隐私不泄露 -- 不同的 agent 之间共享：让你的不同 agent 之间共享同一份记忆（已支持deepseek-harness) +- 不同的 agent 之间共享：让你的不同 agent 之间共享同一份记忆（已支持 Claude Code / OpenCode / WorkBuddy / DeepSeek Harness） - 个人画像系统：由 schema 定义个人画像，记忆遵循唯一事实原则，可扩展，易维护，易使用 - 易于管理：提供增删改查、遗忘、人工 review 等 cli 命令，便于 agent 调用； - 证据关联：可溯源记忆的生成原因、遗忘原因、操作历史，可恢复 @@ -151,13 +151,14 @@ topics: AI 抽取时只能打后四档；`confirmed` 只能由人产生。低置信条目在 `mex profile` 输出中标注"（待确认）"。 -## 与 agent 集成（OpenCode / Claude Code / dsh） +## 与 agent 集成（Claude Code / OpenCode / WorkBuddy / dsh） -`mex integrate` 一键生成与 agent 的对接文件（hook 配置 + skill 说明书 / DSH 插件 bundle），详细对接步骤见对应内层文档： +`mex integrate` 一键生成与 agent 的对接文件（skill 说明书 + README / DSH 插件 bundle），详细对接步骤见对应内层文档： ```bash mex integrate claude --scope global # 全局：所有项目生效（默认） mex integrate opencode --scope project # 仅当前项目生效 +mex integrate workbuddy --scope project # 生成 WorkBuddy skill 到 ./.workbuddy/skills/ mex integrate dsh --scope project # 生成 DSH 插件 bundle ./mex-dsh-plugin ``` @@ -165,6 +166,7 @@ mex integrate dsh --scope project # 生成 DSH 插件 bundle ./mex-dsh-plu |---|---| | Claude Code | [src/mex/integration/claude/README.md](src/mex/integration/claude/README.md) | | OpenCode | [src/mex/integration/opencode/README.md](src/mex/integration/opencode/README.md) | +| WorkBuddy | [src/mex/integration/workbuddy/README.md](src/mex/integration/workbuddy/README.md) | | DeepSeek Harness（dsh） | [src/mex/integration/dsh/README.md](src/mex/integration/dsh/README.md)（含开发者更新插件流程） | ## 配置 diff --git a/docs/architecture.md b/docs/architecture.md index 009137a..e64ed40 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -781,11 +781,15 @@ mex integrate claude --scope global # 生成到 ~/.claude/ mex integrate claude --scope project # 生成到 ./.claude/ mex integrate opencode --scope global # 生成到 ~/.config/opencode/ mex integrate opencode --scope project # 生成到 ./.opencode/ +mex integrate workbuddy --scope global # 生成到 ~/.workbuddy/skills/ +mex integrate workbuddy --scope project # 生成到 ./.workbuddy/skills/ ``` - `--scope project`（项目级）：配置生成到当前项目目录，只对该目录下的 agent 会话生效。 - `--scope global`（全局，**默认**）：生成到用户级配置目录，对所有项目的会话生效。 -- 生成内容：skill 说明书（写入官方 `skills//SKILL.md` 发现路径）+ README（对接步骤）。 +- 生成内容：skill 说明书 + README（对接步骤）。skill 的写入位置按 agent 不同： + claude/opencode 写入官方 `skills//SKILL.md` 发现路径；workbuddy 的目标目录 + （`~/.workbuddy/skills` / `./.workbuddy/skills`）本身就是 skill 根目录，直接写 `mex/SKILL.md`。 不再生成 hook 配置——OpenCode 官方配置 schema 无 hooks 字段，会话结束自动抽取留待后续扩展（ADR-12）。 - 执行后输出实际写入的文件路径清单，便于检查；重复执行覆盖旧文件（幂等）。 diff --git a/docs/dsh-integration.md b/docs/dsh-integration.md index 870f28e..cd72c68 100644 --- a/docs/dsh-integration.md +++ b/docs/dsh-integration.md @@ -2,7 +2,7 @@ > 适用对象：mex-dsh-plugin（DeepSeek Harness 插件）。 > 本文档记录 dsh 侧集成**实现细节**，与 `architecture.md` §8 的 agent 集成章节互补： -> §8 描述 claude/opencode 的 skill 机制（即时写 + 会话结束 hook 留待扩展）； +> §8 描述 claude/opencode/workbuddy 的 skill 机制（即时写 + 会话结束 hook 留待扩展）； > 本文描述 dsh 特有形态——浏览器 UI 面板 + 用户主动触发的"每轮对话后抽取"。 > 接口以代码 docstring 为准；本文是设计说明，不替代代码。 From 5a0a386d1a17b6ef8de24e50e29c929e689f059e Mon Sep 17 00:00:00 2001 From: MickLife <77223103+MickLife@users.noreply.github.com> Date: Thu, 20 Aug 2026 16:11:52 +0800 Subject: [PATCH 2/2] Update dsh-integration.md --- docs/dsh-integration.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/dsh-integration.md b/docs/dsh-integration.md index cd72c68..b52c8df 100644 --- a/docs/dsh-integration.md +++ b/docs/dsh-integration.md @@ -2,7 +2,6 @@ > 适用对象：mex-dsh-plugin（DeepSeek Harness 插件）。 > 本文档记录 dsh 侧集成**实现细节**，与 `architecture.md` §8 的 agent 集成章节互补： -> §8 描述 claude/opencode/workbuddy 的 skill 机制（即时写 + 会话结束 hook 留待扩展）； > 本文描述 dsh 特有形态——浏览器 UI 面板 + 用户主动触发的"每轮对话后抽取"。 > 接口以代码 docstring 为准；本文是设计说明，不替代代码。