dsh-read-history

把 Claude Code 与 Codex CLI 的历史对话导入 DeepSeek Harness (DSH)：

• 每个历史会话 → 一个原生 DSH 会话：出现在左侧对应工作区的会话列表里（与现有会话并列）， 点击即可查看完整历史（用户/助手消息、轮次结构、标题），就像它们本来就是 DSH 的会话。
• 入口在「设置」页：新增「对话历史导入」设置区块（settings.section 插槽）， 提供导入按钮、导入状态与已导入会话列表。

安装

从 npm 安装（发布后）

# 安装到 web profile（pnpm 通过 corepack 提供）
dsh plugin --profile web add dsh-read-history

本地开发 / 从源码安装

# 本地路径安装（用于开发调试）
dsh plugin --profile web add D:\code\dsh-read-history

安装后在 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 注册：

cordis.patch.yml：

- insert:
    - id: read-history
      name: 'dsh-read-history'
      config:
        claudeRoot: ''        # 默认 ~/.claude/projects
        codexRoot: ''         # 默认 ~/.codex/sessions
        includeThinking: false
        autoImport: false      # 不开启自动导入（幂等）

⚠️ host 端代码（lib/index.js、lib/convert.js）改动需要重启 dsh web； client 端（lib/client.js）no-cache 实时服务，刷新浏览器即可。

使用方法（通过设置页导入）

安装并重启 dsh web 后，按下面的步骤导入历史会话：

1. 打开 DSH Web 界面（默认 http://127.0.0.1:3080）。
2. 点击左侧边栏底部的 「设置」 图标，进入设置页。
3. 在设置页里找到 「对话历史导入」 区块（标题下方有说明文字）。
4. 点击 「导入 Claude」 或 「导入 Codex」 按钮，分别导入对应工具的历史会话：
   • 只导 Claude Code 的历史 → 点 「导入 Claude」
   • 只导 Codex CLI 的历史 → 点 「导入 Codex」
   • 两个按钮各自独立，导入期间按钮会显示「导入中…」并暂时禁用。
5. 等待导入完成，区块里会显示结果：
   • 成功卡片：显示本次创建了多少个 DSH 会话（如「导入完成：创建 12 个 DSH 会话」）。
   • 统计行：上次导入时间、累计创建/跳过/失败会话数。
   • 已创建的会话列表：每个会话显示标题、所属工作区、轮次数与 DSH 会话 id。
6. 回到左侧边栏，在对应的工作区下就能看到导入的会话（与现有会话并列），点击即可查看完整历史（用户/助手消息、轮次结构、标题）。

提示：

• 导入是幂等的——同一个会话重复导入会自动跳过，不会产生重复。
• 导入的会话会出现在与其原始工作目录（cwd）匹配的工作区里，而不是「未分组」。
• 想同时清掉某次的导入？没有内置「撤销」，但可以直接删除对应工作区下的会话。

工作原理

1. 扫描解析：读取 ~/.claude/projects/**/*.jsonl、~/.codex/sessions/**/*.jsonl。
2. 转换为 DSH 会话（lib/convert.js）：每个历史会话先 sessions.prepare() 构造、直接写入持久化（sessionPersistence.create + append），不进入实时 store，因此不占内存、重启不会复活；标题以 session/title 事件写进日志； workspaceRegistry.create(cwd)（按 cwd 复用或新建工作区）+ attachSession() 挂到对应工作区， 因此每个历史会话都会出现在与其 cwd 相同的工作区里，而不是落到「未分组」。 幂等：按派生 id（session-<源会话id>）查重（一次 sessionPersistence.list() 缓存成集合，O(n) 而非逐行 O(n²)），重复导入自动跳过。
3. 内容清洗（lib/parse.js）：过滤 Claude/Codex 注入的噪声——斜杠命令（/clear、/compact 等）、 <command-name>/<local-command-*>/<bash-*>/<system-reminder>/<environment_context>/<instructions>/ AGENTS.md 与 Codex Desktop 审批脚手架（TRANSCRIPT DELTA、APPROVAL REQUEST 等），只保留真实的人机对话。

API（同源，设置面板调用）

方法	路径	说明
GET	/dsh-history/api/status	状态（目录、上次导入时间、统计）
POST	/dsh-history/api/import	执行导入（幂等；body 可带 `{"tool":"claude"
GET	/dsh-history/api/imported	累积已导入会话清单