前言¶
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 會話數據,降低了智能體開發中切換環境的成本。更多細節與源碼可參考以下鏈接。