dsh-codex-continue

Readme

# dsh-codex-continue

> DSH 插件：读取本机 OpenAI Codex 的项目与会话，在 DSH 里无缝「继续」——Codex 5 小时限额到了，活不丢，换个环境接着干。

<div align="center">
  <img src="screenshots/banner.webp" alt="dsh-codex-continue banner" width="100%">
</div>

在 DSH（[DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)）里浏览你的 Codex 历史会话（`~/.codex/sessions/*.jsonl`，**只读**），选中任意会话后生成一份「续作包」——目标 + 最后消息 + 压缩正文 + 项目目录 + git 状态——交给 DSH agent，让它以原工作目录为基准继续完成 Codex 没做完的工作。

## 特性

- 📂 **项目/会话浏览**：按工作目录聚合项目，标题（来自 `session_index.jsonl`）、时间、模型、消息数一目了然；支持搜索
- 🔎 **会话预览**：goal / 最后消息 / 分色正文（你 / Codex / 思考 / 工具调用）
- ⚡ **续作包 resume bundle**：token 预算内压缩正文（工具输出截尾、reasoning 只留摘要、按 callId 配对），附 `cwd` 存在性与 `git status`
- ✍️ **一键继续**：侧边栏点「⚡ 继续此会话」直接把续作指令注入输入框（不再需要复制粘贴）；「📄 RESUME.md」在项目目录生成交接文档（换 agent / 给人看 / 跨机迁移都可用）
- 🧰 **两种用法**：直接在对话里指挥 agent 调 `codex` 工具（主路径），或侧边栏「Codex 续作」Tab 浏览后点继续（需 dsh-better-sidebar）
- 🔍 **浏览体验**：项目/会话搜索、刷新、归档标记、goal/最后消息预览
- 🔒 **安全**：只读 rollout JSONL + 索引；绝不读 `auth.json` / `config.toml` / sqlite

## 界面预览

侧边栏新增「✦ Codex 续作」Tab，按工作目录聚合你的 Codex 项目；点进任意会话即可预览目标与最近进展，点「⚡ 继续此会话」把续作指令注入输入框，一键在 DSH 里接着干活。

![侧边栏「Codex 续作」Tab 入口](screenshots/interface-tab.webp)

![会话预览与「继续此会话」按钮](screenshots/interface-button.webp)

## 安装

```bash
# 在运行 DSH web 的机器上
dsh plugin --profile web add dsh-codex-continue
# 重启 dsh web 生效
```

> ⚠️ 插件发布后 **24 小时内**，pnpm 11 的供应链策略（`minimumReleaseAge=1440`）会拦截安装；此时请在命令后加 `--config.minimumReleaseAge=0`（单次生效，不改任何配置）。

侧边栏 UI 需要 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)（没有也能用——`codex` 工具始终可用）。

## 使用

### 方式一：直接跟 Agent 说（推荐）

```
继续我的 Codex 会话《设计会话同步工具》，先看看现场再接着做。
```

Agent 会调 `codex(action: resume)` 拉回续作包，切到原项目目录核对现场后继续。

### 方式二：侧边栏浏览

右侧边栏 →「✦ Codex 续作」Tab → 项目 → 会话 → 预览 →「⚡ 继续此会话」（续作指令**直接注入输入框**，回车即发送）；「📄 RESUME.md」在项目目录生成交接文档。

### `codex` 工具

| action | 说明 |
|---|---|
| `list_projects` | 按工作目录聚合的项目列表 |
| `list_sessions` | 会话列表（`query` / `project` 过滤） |
| `show_session` | goal + 最后消息 + 预览片段 |
| `resume` | 完整续作包（目标/正文/cwd/git/统计），即上下文注入点 |
| `resume_doc` | 在项目目录生成 `RESUME.md` 交接文档 |

## 配置

`cordis.patch.yml` 的 `config` 块（或 profile 的 patch 层覆盖）：

| key | 默认 | 说明 |
|---|---|---|
| `codexHome` | `~/.codex` | Codex 数据目录 |
| `maxBundleTokens` | 60000 | 续作包正文 token 预算 |
| `toolOutputTail` | 400 | 工具输出保留尾部字符数 |
| `argsPreview` | 200 | 工具参数预览长度 |
| `messageMax` | 2000 | 单条消息在正文中的字符上限 |
| `includeGitStatus` | true | 续作时跑 `git status` |
| `maxAgeDays` | 0 | 只列出最近 N 天的会话（0=全部） |
| `resumeDocName` | `RESUME.md` | 交接文档文件名（写入项目目录） |

## 数据来源（只读）

- `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` —— 会话正文（JSONL 事件流）
- `~/.codex/session_index.jsonl` —— 标题/时间索引（`id` 与 rollout 的 `session_id` 同键）
- 项目 = 会话的 `cwd`

## 开发

```bash
pnpm install
pnpm test        # vitest（解析/索引/续作包）
pnpm typecheck
pnpm build       # tsc host + tsdown client bundle
./scripts/sync-installed.sh   # 把构建同步进 web profile 的安装副本（见下）
```

> **本地开发注意**：profile 的 pnpm 用 `nodeLinker: hoisted`，`file:` 依赖是**复制**进 node_modules 的（不是软链）——`pnpm build` 后必须跑 `scripts/sync-installed.sh` 同步（或重新 install）。client 改动同步后**浏览器强刷即可，无需重启 DSH**；host 改动仍需重启。

> 客户端 bundle 注意事项：client 半区必须以 **CJS + `window.__ModuleLoader__.load({id, factory})`** 形式打包注册（见 `tsdown.config.ts` 的 banner/footer），否则浏览器侧不会激活；`build` 末尾的 `verify-client-bundle.mjs` 会在 VM 里模拟加载器做回归校验。host 半区读配置必须用 `apply(ctx, rawConfig)` 的第二参数，不能读 `ctx.config`。

设计文档见 [DESIGN.md](DESIGN.md)；可交互界面原型见 [ui-mockup/](ui-mockup/)；解析原型见 [poc/](poc/)。

## 发布（npm）

CI 已配置：打 `v*` tag 自动构建并发布（需仓库 `NPM_TOKEN` secret）。

```bash
npm login                          # 本机登录（一次性）
git tag v0.2.1                     # 版本号与 package.json 一致
git push origin v0.2.1             # CI 自动发布
npm view dsh-codex-continue         # 验证
```

> 建议在**发布后满 24 小时之前**不要期望别人能立刻安装成功：pnpm 11 默认 `minimumReleaseAge=1440`（24h），刚发布的包会被供应链策略拦截。

## License

MIT