前言¶
做 DSH 相关开发时,如果本地已经有一批 Codex 会话,想把这些历史带到 DSH 里继续处理,常见做法是手动导出再粘贴,容易丢失上下文。下面介绍 life1996cou 维护的 dsh-codex 插件:它从本地 Codex 会话目录读取会话,并在 DSH 中生成一个带完整对话历史的新会话。
这是什么¶
- 插件仓库:
life1996cou/dsh-codex - 许可证:
MIT - 一句话定位:从本地 Codex(
~/.codex/)导入会话,生成一个带完整对话历史的新 DeepSeek Harness 会话。 - 平台声明:
package.json中dsh.client.platform为web,并注入@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-api-gateway。
核心功能¶
下面列出已核实的能力:
- 从本地 Codex(
~/.codex/)导入会话 - 生成一个带完整对话历史的新 DeepSeek Harness 会话
- 支持在设置中配置 Codex 会话目录
- 支持从会话列表点击「导入到新会话」并切过去
安装与启用¶
先安装插件:
dsh plugin --profile web add github:life1996cou/dsh-codex
然后启动 DSH Web 客户端:
dsh web
如果使用本地目录安装,资料建议使用 file: 做复制安装,避免使用裸路径:
dsh plugin --profile web add file:.
原因是裸路径会创建软链,导致依赖解析失败。
典型用法¶
1、打开 DSH Web 设置。
2、在设置页左侧点击「Codex」。
3、选择「使用默认 ~/.codex/sessions」,或点击「选择目录…」定位 Codex 会话目录。
4、在会话列表中找到目标会话,点击「导入到新会话」。
5、插件会生成一个包含完整 Codex 对话历史的新会话,并自动切换到该会话。
卸载与名称说明¶
当前资料中的卸载命令为:
dsh plugin --profile web remove @deepseek-ai/dsh-codex-importer
安装命令使用 github:life1996cou/dsh-codex,卸载命令使用 @deepseek-ai/dsh-codex-importer;package.json 的 name 也是 @deepseek-ai/dsh-codex-importer。资料未说明 GitHub 仓库安装名与包名之间的映射关系。
适用场景与注意¶
适合本地已有 Codex 会话、希望在 DSH Web 中复用历史上下文的人。使用前建议:
- 确认 Codex 会话目录可访问,默认路径是
~/.codex/sessions - 安装前检查源码与许可证;当前许可证为
MIT - 插件以当前
dsh进程权限运行,安装前确认对来源仓库和依赖可信 - 本地目录安装使用
file:,不要使用裸路径
结尾¶
dsh-codex 的价值在于把本地 Codex 会话以新 DSH 会话的形式带入 Web 端,保留完整对话历史。
DSH 的扩展思路是「一切皆插件」,社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。
GitHub 仓库:https://github.com/life1996cou/dsh-codex
目录页 URL 未出现在当前已核实资料中,这里不给出具体地址。