# 对话桥 · Codex → WorkBuddy / DeepSeek Harness

**聊过的方案散落在不同 AI 里，执行任务又要来回复制？**
对话桥把本机对话整理成可搜索的归档，并让 Codex 通过 MCP 把任务交给真实 WorkBuddy / DeepSeek Harness 会话，读取回报、返工和验收。

[源码试用](#五分钟试用归档界面) · [WorkBuddy 接入](docs/WORKBUDDY_SETUP.md) · [DeepSeek 接入](docs/DEEPSEEK.md) · [反馈](https://github.com/lanjunyao/codex-workbuddy-gateway/issues) · [MIT](LICENSE)

![对话桥：搜索跨工具周报讨论并查看上下文](docs/images/history-demo.png)

*截图来自真实运行的网页，使用仓库内合成演示对话；不包含个人聊天记录。*

## 它能帮你做什么

- **找回聊过的内容**：归档 Codex / WorkBuddy 的本机正文日志，支持中文关键词、日期和来源筛选，查看完整上下文；可手动导入其他工具的记录。
- **换工具时带上上下文**：先预览引用内容，再执行目标客户端支持的续聊操作。各客户端能力不同，见[续聊范围](docs/HISTORY_ACTIONS.md)。
- **让原生 AI 会话实际执行**：Codex 派工，WorkBuddy / Harness 用各自的模型与工具完成任务；同一任务保留进度、返工和验收记录。
- **把受理和完成分开**：任务经过排队、执行、待验收等状态；回报结束不自动等同于验收通过。

这是 **v0.6.0-alpha.1 源码预发布**。主环境为 macOS；WorkBuddy 原生接口和 Harness 插件与版本有关，升级后可能需要适配。自动化测试和本次实测范围见[验证记录](docs/VALIDATION.md)。

## 五分钟试用归档界面

需要 Node.js **22.13 或以上**、npm 和 Git。首次安装需要网络；演示本身无需模型密钥或登录 AI 客户端。

```sh
git clone https://github.com/lanjunyao/codex-workbuddy-gateway.git
cd codex-workbuddy-gateway
npm ci
npm run build
npm run history:demo
```

打开终端提示的 `http://127.0.0.1:18493`，搜索 **周报**，点击结果查看上下文。演示启动器只载入合成记录，禁用原生客户端操作、附件读取和自动采集，不读取你已有的对话。按 `Ctrl+C` 退出。

演示验证的是归档与搜索，不代表 WorkBuddy / Harness 已接入。连接自己的客户端时：

| 目标 | 下一步 |
| --- | --- |
| 归档本机对话 | `npm run history:start`，访问 `http://127.0.0.1:18492`；详见[归档配置](docs/HISTORY.md) |
| Codex 指挥 WorkBuddy | [安装与首次绑定](docs/WORKBUDDY_SETUP.md)，需要已登录 WorkBuddy、Codex CLI 和原生权限 |
| Codex 指挥 DeepSeek Harness | [安装 Harness 插件与 MCP](docs/DEEPSEEK.md)，需要兼容 Host 与已配置模型 |
| 编译 macOS 窗口 | `npm run mac:build`；需要 Xcode Command Line Tools，生成本地 ad-hoc 签名应用，未做开发者公证 |

源码 ZIP 也可从 GitHub 的 **Code → Download ZIP** 下载。这里没有预装依赖的双击安装包；安装、原生权限和模型额度仍由使用者准备。

## 数据、权限与费用

归档数据库、全文索引和可选语义向量保存在本机。`history:start` 会读取本机 Codex / WorkBuddy 日志；只覆盖本机已有记录，不能保证云端或其他设备历史完整。豆包持续采集依赖可选桌面桥与权限，未接通时需手动导入。

关键词搜索不调用模型。可选语义检索首次从 Hugging Face 下载模型，在本机计算。选择续聊、审查或派工时，所选内容会进入目标 AI 客户端，并受该客户端的模型、云服务、权限和计费规则约束。本项目不提供共享 API key 或免费中转。[完整数据说明](docs/PRIVACY.md)。

数据库和备份不做应用级加密。不要把个人 `.env`、`data/`、日志、历史数据库或模型缓存上传 GitHub。请仅在可信本机环境运行，原生桌面调试接口不应暴露到局域网。

## 开发与验证

```sh
npm ci
npm run build
npm run history:readers:build  # macOS 的 PDF/OCR 测试前编译读取器
npm test
npm run deepseek:plugin:test
npm run workbuddy:identity:test
npm run package
```

Office 附件读取器需要 Python 3 的标准库；PDF/OCR 读取器依赖 macOS 系统框架。打包使用白名单，输出源码、编译 JS 和两个独立 Skill ZIP；依赖、模型及机器配置不随包分发。请在新环境中按上面步骤安装与构建。

## 来源与贡献

沿用 [dudu555-djiao/codex-workbuddy-gateway](https://github.com/dudu555-djiao/codex-workbuddy-gateway) 的项目身份与实现。本次由代码所有者授权以 MIT 发布，作者归属见 [NOTICE](NOTICE)。原发布的历史验证仅用于背景，本次验证单独记录，不代表所有客户端当前版本已重新实测。

欢迎提交可复现问题与改进；请使用合成数据，并删除日志中的账号、消息内容和凭据。如果它解决了你的问题，欢迎点右上角 ⭐ Star 收藏。