Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 调用;
- 证据关联:可溯源记忆的生成原因、遗忘原因、操作历史,可恢复
Expand Down Expand Up @@ -151,20 +151,22 @@ 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
```

| Agent | 对接文档 |
|---|---|
| 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)(含开发者更新插件流程) |

## 配置
Expand Down
6 changes: 5 additions & 1 deletion docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<name>/SKILL.md` 发现路径)+ README(对接步骤)。
- 生成内容:skill 说明书 + README(对接步骤)。skill 的写入位置按 agent 不同:
claude/opencode 写入官方 `skills/<name>/SKILL.md` 发现路径;workbuddy 的目标目录
(`~/.workbuddy/skills` / `./.workbuddy/skills`)本身就是 skill 根目录,直接写 `mex/SKILL.md`。
不再生成 hook 配置——OpenCode 官方配置 schema 无 hooks 字段,会话结束自动抽取留待后续扩展(ADR-12)。
- 执行后输出实际写入的文件路径清单,便于检查;重复执行覆盖旧文件(幂等)。

Expand Down
1 change: 0 additions & 1 deletion docs/dsh-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@

> 适用对象:mex-dsh-plugin(DeepSeek Harness 插件)。
> 本文档记录 dsh 侧集成**实现细节**,与 `architecture.md` §8 的 agent 集成章节互补:
> §8 描述 claude/opencode 的 skill 机制(即时写 + 会话结束 hook 留待扩展);
> 本文描述 dsh 特有形态——浏览器 UI 面板 + 用户主动触发的"每轮对话后抽取"。
> 接口以代码 docstring 为准;本文是设计说明,不替代代码。

Expand Down
Loading