对话历史导入 Slowdownnn/dsh-read-history

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"|"codex"} 只导入单一来源） |
| GET | /dsh-history/api/imported | 累积已导入会话清单 |