前言¶
DSH 插件:读取本机 OpenAI Codex 的项目与会话,在 DSH 里无缝「继续」——Codex 5 小时限额到了,活不丢,换个环境接着干。
该插件由 zhoujianbin 维护,旨在解决在 Codex 限制或环境切换时,上下文丢失和会话中断的问题。它通过只读读取本机 Codex 数据目录,将历史会话转化为可继续的上下文。
核心功能¶
- 📂 项目/会话浏览:按工作目录聚合项目,标题(来自 session_index.l)、时间、模型、消息数一目了然;支持搜索。
- 🔎 会话预览:展示 goal / 最后消息 / 分色正文(用户 / Codex / 思考 / 工具调用)。
- ⚡ 续作包 resume bundle:在 token 预算内压缩正文(工具输出截尾、reasoning 只留摘要、按 callId 配对),附 cwd 存在性与 git status。
- ✍️ 一键继续:侧边栏点「⚡ 继续此会话」直接把续作指令注入输入框(不再需要复制粘贴);「📄 RESUME.md」在项目目录生成交接文档(换 agent / 给人看 / 跨机迁移都可用)。
- 🧰 两种用法:直接在对话里指挥 agent 调 codex 工具(主路径),或 DSH 2.0 原生右侧栏「Codex 续作」Tab 浏览后点继续。
- 🔍 浏览体验:项目/会话搜索、刷新、归档标记、goal/最后消息预览。
- 🔒 安全:只读 rollout JSONL + 索引;绝不读 auth. / config.toml / sqlite。
安装与启用¶
在运行 DSH web 的机器上执行以下命令:
dsh plugin --profile web add dsh-codex-continue
重启 dsh web 生效。
⚠️ 注意:插件发布后 24 小时内,pnpm 11 的供应链策略(
minimumReleaseAge=1440)会拦截安装。此时请在命令后加--config.minimumReleaseAge=0(单次生效,不改任何配置)。
兼容性¶
- 0.3.x:已迁移到 DSH 2.0 原生右侧栏扩展 API(
ctx.sidebarRightTabs+ctx.slots),并完成正式服务、真实浏览器和输入框注入验证。当前0.3.x已在 DSH0.2.0-rc.1上完成 host 启动、REST API、client 加载、真实浏览器 UI 和输入框注入验证。 - 0.2.2:仍面向旧版 DSH,不要直接装进 DSH 2.0。
使用方式¶
方式一:直接跟 Agent 说¶
在对话中输入指令,Agent 会调用 codex 工具拉回续作包。
继续我的 Codex 会话《设计会话同步工具》,先看看现场再接着做。
方式二:DSH 2.0 侧边栏浏览¶
- 右侧边栏 → 「✦ Codex 续作」Tab。
- 选择项目 → 选择会话 → 预览。
- 点击「⚡ 继续此会话」(续作指令直接注入输入框,回车即发送)。
- 同时会在项目目录生成「📄 RESUME.md」交接文档。
结尾¶
该插件通过复用本地 Codex 会话数据,降低了智能体开发中切换环境的成本。更多细节与源码可参考以下链接。