dsh-claude-move 0.2.2 → 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/README.es.md +285 -291
- package/README.hi.md +285 -292
- package/README.md +285 -317
- package/README.pt.md +285 -291
- package/README.zh.md +285 -311
- package/client/client.js +7 -3
- package/index.mjs +20 -10
- package/package.json +68 -4
package/README.zh.md
CHANGED
|
@@ -1,311 +1,285 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
[（MIT）。
|
|
239
|
-
-
|
|
240
|
-
-
|
|
241
|
-
|
|
242
|
-
##
|
|
243
|
-
|
|
244
|
-
```sh
|
|
245
|
-
npm install # peer 依赖：@deepseek-ai/
|
|
246
|
-
npm test # node --test
|
|
247
|
-
```
|
|
248
|
-
|
|
249
|
-
CI
|
|
250
|
-
|
|
251
|
-
##
|
|
252
|
-
|
|
253
|
-
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
-
|
|
259
|
-
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
-
|
|
268
|
-
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
## 📄 License
|
|
288
|
-
|
|
289
|
-
Apache License 2.0 — 见 [LICENSE](LICENSE) 与 [NOTICE](NOTICE)。第三方声明（含 MIT 组件的 MIT 原文）见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
|
|
290
|
-
|
|
291
|
-
## PerryLink DSH 插件家族
|
|
292
|
-
|
|
293
|
-
本项目是 [PerryLink](https://github.com/PerryLink) 维护的 [15 个 DeepSeek Harness 插件](https://github.com/PerryLink)之一。如果你觉得这个插件有用，其余的很可能同样有用：
|
|
294
|
-
|
|
295
|
-
| 插件 | 一句话说明 |
|
|
296
|
-
|---|---|
|
|
297
|
-
| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | 只读 MCP 运行时面板：/mcp 命令 + 设置页，状态/工具/错误一览 |
|
|
298
|
-
| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | 工程纪律守门：需求审讯、测试证据门、对抗评审 |
|
|
299
|
-
| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | 持久化后台子代理：Web 侧边栏进度、随时留言与打断 |
|
|
300
|
-
| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | 基于语言服务器的诊断/格式化/补全/代码动作/重命名 |
|
|
301
|
-
| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | 对标 Claude Code outputStyles 的运行时风格切换 |
|
|
302
|
-
| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | 对标 Claude Code /rewind：快照、会话 fork、一键回退 |
|
|
303
|
-
| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code 风格声明式 allow/deny/ask 权限规则，带审计 |
|
|
304
|
-
| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | 审批链上的第二模型自动审查，默认 fail-closed |
|
|
305
|
-
| [dsh-memento](https://github.com/PerryLink/dsh-memento) | 带审批门的跨会话记忆：ctx.memory + SQLite + memory 工具 |
|
|
306
|
-
| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | 安全审计技能包：密钥扫描、依赖与供应链审查 |
|
|
307
|
-
| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | 在 Web 侧边栏置顶会话，持久排序 |
|
|
308
|
-
| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web 作曲器终端式输入历史：方向键、Ctrl+R 搜索 |
|
|
309
|
-
| [dsh-github](https://github.com/PerryLink/dsh-github) | DSH 的 GitHub PR/issue 集成，所有写操作经审批门 |
|
|
310
|
-
| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | 插件开发知识库，随 bundle 安装的按需 agent 技能 |
|
|
311
|
-
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 把 Claude Code 会话、记忆、技能和 CLAUDE.md 迁入 DSH |
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# 🚚 dsh-claude-move
|
|
4
|
+
|
|
5
|
+
**将 Claude Code、Codex、OpenCode 和 Hermes 迁移到 DeepSeek Harness —— 将会话、记忆、技能、指令和斜杠命令复制为可续聊的 DSH 会话，只复制、审批门控。**
|
|
6
|
+
|
|
7
|
+
*迁移时保留你的 Claude Code 历史：一次安装、可续聊会话、与运行中的 Claude Code 实时同步，以及一个四来源迁移向导。*
|
|
8
|
+
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-claude-move/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-claude-move/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-claude-move)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-claude-move)
|
|
16
|
+
|
|
17
|
+
[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 兼容性
|
|
24
|
+
|
|
25
|
+
- 面向 `dsh 0.1.0-rc.6`（web profile）；peer 依赖锁定在 `0.1.0-rc.6`。Node `^22.19 || >=24`。
|
|
26
|
+
- 最近针对全新 tarball 安装验证：真实扫描、真实批量导入（幂等重导入）、工作区挂载与持久化产物均已确认；macOS/Linux 由 CI 矩阵覆盖。
|
|
27
|
+
|
|
28
|
+
### 兼容性矩阵（仅公开接缝）
|
|
29
|
+
|
|
30
|
+
| 接缝 | 使用 | 缺失时的回退 |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| Host 服务（`tools` / `sessionPersistence` / `workspaceRegistry` / `commands` / `systemPrompt` / `skills` / `webServer`） | 所列之处必需 | 可选服务响应式注册；缺失 `fs` 大声失败 |
|
|
33
|
+
| `sessionPersistence.listSnapshots` / `readFrom` / 支持 `streamText` 的 `fs` / `ctx.jobs` / `ctx.agents.resume` | 特性探测 | `list()` / 整文件读取并大声拒绝 / 自有 job map / 交接注入 |
|
|
34
|
+
| Client shell 服务（`sessions.refresh/open`、`workspaces.refresh`） | 面板 apply 时特性探测 | 整页刷新 |
|
|
35
|
+
| 较新的平台能力从不是硬性要求 —— 插件在 rc.6 上始终保持可启动。 | | |
|
|
36
|
+
|
|
37
|
+
## 你能获得什么
|
|
38
|
+
|
|
39
|
+
1. **自动发现** —— `claude_scan` 定位 Claude 数据根（`$CLAUDE_CONFIG_DIR`，回退 `~/.claude`）并索引每个项目/会话、记忆、技能、全局 `CLAUDE.md` 和 `settings.json`，带增量缓存和并行扫描（`scanConcurrency`）。
|
|
40
|
+
2. **全保真导入** —— `import_claude` 将 transcript 转换为均衡、可续聊的 DSH 会话（`turn/start → step/start → user/message → assistant/message → tool/call → tool/result → step/end → turn/end`），修复被中断的工具调用，并以分块流式导入超过 `maxTranscriptBytes` 的 transcript。
|
|
41
|
+
3. **一个 `claudecode` 工作区** —— 每个导入的会话都落到一个专用工作区（默认 `$DSH_HOME/claudecode`）；`workspaceMode: 'per-project'` 恢复每个项目一个工作区的分组方式。
|
|
42
|
+
4. **只复制且增量** —— 两侧都不会被移动、改写或删除；重新运行只追加新的轮次（`force: true` 以新 id 额外保存一份完整副本）。
|
|
43
|
+
5. **个人上下文，始终新鲜** —— 记忆作为实时提示词段落注入，Claude 技能注册为真正的 DSH 技能（全局 + 项目级），全局 + 项目 `CLAUDE.md` 提前注入。
|
|
44
|
+
6. **四来源迁移向导** —— `/move` 加上 `move_detect` / `move_preview` / `move_run` 迁移 Claude Code、Codex、OpenCode 和 Hermes，审批门控且幂等（`move.json`）。
|
|
45
|
+
7. **Web 面板与命令** —— `/claude-import-all`、`/resume-claude`、`/claude-move-reset`，以及一个浮动迁移面板。
|
|
46
|
+
|
|
47
|
+
## 四来源迁移向导
|
|
48
|
+
|
|
49
|
+
```text
|
|
50
|
+
/move # 一次性向导：检测 → 预览 → 执行 → 报告（全部四个来源）
|
|
51
|
+
move_detect # 扫描 Claude Code / Codex / OpenCode / Hermes
|
|
52
|
+
move_preview # 逐项计划：new | unchanged | changed | conflict（含 diff）| unsupported
|
|
53
|
+
move_run # 在审批门控之后执行；冲突解决：
|
|
54
|
+
# skip | overwrite | rename | merge （默认 skip —— 绝不猜测）
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
- **来源** —— Claude Code（`~/.claude`）、Codex（`~/.codex`）、OpenCode（数据 + 配置根）、Hermes（技能/记忆根）；每个来源都有自己的 parser + mapper。
|
|
58
|
+
- **映射** —— 记忆/指令 → 追加到 DSH 全局 `AGENTS.md` 的仅追加受管段落（每项一个标记段落）；技能 → 真正的 DSH 技能（`SKILL.md` 包原样复制，其他格式转换）；斜杠命令 → 已注册的 DSH 命令（重启后从 `move.json` 重建）；会话 → 可续聊的 DSH 会话（与阶段 1 相同的导入器）。
|
|
59
|
+
- **幂等** —— 每个已应用的计划都记录在 `$DSH_HOME/claude-move/move.json`（`digest` / `targetDigest` / `appliedAt`）；重新运行跳过未变更项，`force` 重新应用它们。
|
|
60
|
+
- **审批门控** —— 任何会写入内容的运行都先询问 `ctx.approval`；除 `allowed-once` 之外的任何结果都意味着零写入。
|
|
61
|
+
|
|
62
|
+
## 快速开始
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
# 1. 将 bundle 安装到你的 profile
|
|
66
|
+
dsh plugin --profile web add "github:PerryLink/dsh-claude-move#master"
|
|
67
|
+
|
|
68
|
+
# 或从 npm 安装（已发布版本）
|
|
69
|
+
dsh plugin --profile web add dsh-claude-move
|
|
70
|
+
|
|
71
|
+
# 2. 重启并验证该行
|
|
72
|
+
dsh --profile web --dump-config | grep -A4 'id: claude-move'
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
然后，在任意 DSH 会话中运行一条命令：
|
|
76
|
+
|
|
77
|
+
```sh
|
|
78
|
+
/claude-import-all # 扫描 → 复制每个 Claude 会话 → 报告
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
导入后无需重启 DSH —— 刷新一次已打开的 Web 页面，点击任意导入会话即可继续。
|
|
82
|
+
|
|
83
|
+
## 安装与卸载
|
|
84
|
+
|
|
85
|
+
- **git 渠道**（最新 `master`）：`dsh plugin --profile web add "github:PerryLink/dsh-claude-move#master"` —— 纯 ESM，无需 `prepare` 或 `allowBuilds` 步骤。
|
|
86
|
+
- **npm 渠道**（已发布版本）：`dsh plugin --profile web add dsh-claude-move`。
|
|
87
|
+
- **tarball 渠道**：在本仓库执行 `npm pack`，然后 `dsh plugin --profile web add ./dsh-claude-move-<version>.tgz`。
|
|
88
|
+
- **卸载**：从 profile 的 bundles 中删除 `claude-move` 行并重启 `dsh`。导入的会话保留在 DSH 的数据目录中；插件只写自己的缓存（`$DSH_HOME/claude-move/`）和 `claudecode` 工作区文件夹，绝不触碰 Claude 源数据。
|
|
89
|
+
|
|
90
|
+
## 迁移了什么
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
~/.claude（只读）
|
|
94
|
+
├─ projects/*/*.jsonl ──→ 可续聊的 DSH 会话，默认分组到一个 "claudecode" 工作区
|
|
95
|
+
├─ projects/*/memory/ ──→ 实时 system-prompt 记忆段落（每次请求重新读取）
|
|
96
|
+
├─ skills/** ──→ 真正的 DSH 技能
|
|
97
|
+
└─ CLAUDE.md + settings ──→ 早期提示词段落 + 配置建议（绝不自动应用）
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
| 在 Claude Code 中 | 在 DSH 中变为 |
|
|
101
|
+
|---|---|
|
|
102
|
+
| 会话 transcript（`projects/*/*.jsonl`） | 均衡、可续聊的 DSH 会话 —— `user`/`assistant`/`tool`/`thinking` 全保真映射并修复被中断的工具调用 —— 分组到一个 **`claudecode`** 工作区或每个项目一个 |
|
|
103
|
+
| 记忆文件（`projects/*/memory/*.md`） | 一个实时 system-prompt 上下文段落，每次请求重新读取（`feedback > project > reference > user`） |
|
|
104
|
+
| 技能（`~/.claude/skills/**`） | 真正的 DSH 技能（kebab-case 命名、冲突后缀、默认最多 30 个；`README.md`/`MEMORY.md` 及无描述的文件被跳过） |
|
|
105
|
+
| `CLAUDE.md`（全局 + 每个项目） | 一个早期提示词段落；项目文件优先 |
|
|
106
|
+
| `settings.json` | DSH 配置建议，附带明确的无法映射键列表 |
|
|
107
|
+
| 项目状态（目录、git 分支和脏计数） | 显示在扫描索引、Web 面板徽章和 `/resume-claude` 交接中 |
|
|
108
|
+
|
|
109
|
+
## 用法
|
|
110
|
+
|
|
111
|
+
在挂载了插件的任意会话中调用这些工具：
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
claude_scan # 完整扫描（增量缓存）
|
|
115
|
+
claude_scan { path: "~/.claude/projects/<slug>" } # 部分扫描
|
|
116
|
+
claude_scan { refresh: true } # 跳过缓存，重新扫描全部
|
|
117
|
+
claude_scan { projectsLimit: 10, sessionsLimit: 5, fields: "brief" } # 精简输出
|
|
118
|
+
|
|
119
|
+
import_claude { path: "~/.claude/projects/<slug>/<sessionId>.jsonl" } # 单个会话
|
|
120
|
+
import_claude { path: "~/.claude/projects" } # 目录（递归）
|
|
121
|
+
import_claude { path: "all" } # 全部
|
|
122
|
+
# 随时重新运行：未变更的文件被跳过，增长的 transcript 只追加新的轮次。
|
|
123
|
+
# 超过 maxTranscriptBytes 的文件以分块流式导入（无内存上限）。
|
|
124
|
+
import_claude { path: "...", force: true } # 全新的完整副本（保留之前的副本）
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
命令（用户触发，不占模型轮次）：
|
|
128
|
+
|
|
129
|
+
```
|
|
130
|
+
/claude-import-all # 一次性：扫描 → 导入全部 → 报告 → 注入当前会话
|
|
131
|
+
/resume-claude latest # 继续最近的 Claude 会话
|
|
132
|
+
/resume-claude <sessionId> # 按源会话 id 或 import-<src> id
|
|
133
|
+
/resume-claude <keyword> # 匹配标题；多个匹配会列出，绝不猜测
|
|
134
|
+
/claude-move-reset # 重置插件缓存（书签 + 导入映射）；导入的会话保留
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Web 面板：一个浮动迁移面板，包含项目/会话树、状态徽章（未导入 / 已导入 / 已导入并有新轮次 / 源缺失 / 目录缺失 / git 脏）、关键字过滤、分页渲染、每个会话的「导入并继续」+「打开会话」+「刷新会话列表」、带实时进度条和取消的批量导入，以及一个缓存重置按钮。文本跟随浏览器语言（zh/en）。通过插件自身的 `/api/claude-move/*` JSON 路由在公开 `ctx.webServer` 接缝上提供。
|
|
138
|
+
|
|
139
|
+
## 导入之后
|
|
140
|
+
|
|
141
|
+
**你无需重启 DSH。** 导入在完成的那一刻即通过公开的 `sessionPersistence` 服务持久化落地：
|
|
142
|
+
|
|
143
|
+
- 服务器端列表（`session.list` / `workspace.list` RPC、CLI、任何新的页面加载）会立即在 **`claudecode` 工作区**下显示导入的会话。
|
|
144
|
+
- 面板会自行刷新已打开页面的会话列表，并为每个导入的会话提供 **打开会话** 按钮。
|
|
145
|
+
- 导入的会话可以立即打开、读取和继续 —— `/resume-claude`，或点击列表中的会话。随时重新运行导入只会把新轮次同步到相同的会话中。
|
|
146
|
+
|
|
147
|
+
## 配置
|
|
148
|
+
|
|
149
|
+
全部可选，可在 cordis.yml 中覆盖。
|
|
150
|
+
|
|
151
|
+
| 键 | 默认值 | 含义 |
|
|
152
|
+
|---|---|---|
|
|
153
|
+
| `claudeHome` | `$CLAUDE_CONFIG_DIR` 或 `~/.claude` | Claude 数据根 |
|
|
154
|
+
| `workspaceMode` | `claudecode` | `claudecode`（一个专用工作区）· `per-project`（每个源 cwd 一个工作区） |
|
|
155
|
+
| `claudecodeDir` | `$DSH_HOME/claudecode` | `claudecode` 工作区文件夹（插件唯一会创建的文件夹） |
|
|
156
|
+
| `scanGit` | `true` | Git 探测级别：`true`（完整）· `'branch'`（零 git 调用）· `false` |
|
|
157
|
+
| `gitTimeoutMs` | `5000` | Git 子进程超时 |
|
|
158
|
+
| `scanConcurrency` | `8` | 并行项目扫描上限 |
|
|
159
|
+
| `maxTranscriptBytes` | `67108864` | 流式导入阈值（超过则分块） |
|
|
160
|
+
| `excludeProjects` | `[]` | 要跳过的 slug 子串 |
|
|
161
|
+
| `enableMemory` | `true` | 将记忆作为实时提示词段落注入 |
|
|
162
|
+
| `memoryMaxBytes` | `8192` | 记忆段落上限 |
|
|
163
|
+
| `memoryScope` | `current-project` | `current-project` · `all`（当前项目优先） |
|
|
164
|
+
| `enableSkills` | `true` | 将 Claude 技能注册为 DSH 技能 |
|
|
165
|
+
| `maxSkills` | `30` | 技能数量上限 |
|
|
166
|
+
| `extraSkillDirs` | `[]` | 额外的技能目录 |
|
|
167
|
+
| `enableInstructions` | `true` | 注入全局 + 项目 `CLAUDE.md` |
|
|
168
|
+
| `resumeMaxChars` | `2048` | 交接摘要字符上限 |
|
|
169
|
+
| `resumeMode` | `inject` | `inject`（交接摘要）· `agents`（ctx.agents.resume） |
|
|
170
|
+
| `enableWebPanel` | `true` | 注册 `/api/claude-move/*` 面板路由 |
|
|
171
|
+
| `importConcurrency` | `4` | 每批并行读取 + 转换 |
|
|
172
|
+
| `requireApproval` | `true` | 向导写入询问 `ctx.approval`（仅 allowed-once） |
|
|
173
|
+
| `codexHome` | `$CODEX_HOME` 或 `~/.codex` | Codex 数据根 |
|
|
174
|
+
| `opencodeDataHome` | 平台 XDG 数据目录/opencode | OpenCode 数据根 |
|
|
175
|
+
| `opencodeConfigHome` | 平台 XDG 配置目录/opencode | OpenCode 配置根 |
|
|
176
|
+
| `hermesHome` | `$HERMES_HOME` 或 `~/.hermes` | Hermes 数据根 |
|
|
177
|
+
| `skillsDir` | `$DSH_HOME/skills` | 向导技能目标 |
|
|
178
|
+
| `agentsMdPath` | `$DSH_HOME/AGENTS.md` | 向导记忆/指令目标 |
|
|
179
|
+
| `moveWorkspaceMode` | `per-source` | 向导导入的工作区分组：`per-source` · `single` |
|
|
180
|
+
|
|
181
|
+
## 工具与界面
|
|
182
|
+
|
|
183
|
+
| 界面 | 类型 | 说明 |
|
|
184
|
+
|---|---|---|
|
|
185
|
+
| `claude_scan` | 工具 | 项目/会话/记忆/技能/设置的结构化索引 |
|
|
186
|
+
| `import_claude` | 工具 | 导入单个会话、一个目录或 `all`（增量；`force` 生成全新副本） |
|
|
187
|
+
| `move_detect` / `move_preview` / `move_run` | 工具 | 四来源向导：扫描、带 diff 的逐项计划、在审批之后执行 |
|
|
188
|
+
| `/claude-import-all` | 命令 | 扫描 → 导入全部 → 报告 |
|
|
189
|
+
| `/resume-claude` | 命令 | 继续一个 Claude 会话（latest、id 或关键字） |
|
|
190
|
+
| `/claude-move-reset` | 命令 | 重置插件缓存（导入的会话保留） |
|
|
191
|
+
| `/move` | 命令 | 一次性四来源向导 |
|
|
192
|
+
| Web 迁移面板 | 客户端 | 带进度、取消、分页、打开会话的浮动面板 |
|
|
193
|
+
|
|
194
|
+
## 权限与数据
|
|
195
|
+
|
|
196
|
+
- **权限**：workshop 清单声明 `filesystem:read` 和 `filesystem:write`。
|
|
197
|
+
- **读取** `~/.claude`（transcript、记忆、技能、`CLAUDE.md`、`settings.json`）—— 严格只读 —— 以及它导入到的项目目录。
|
|
198
|
+
- **写入** 通过公开 `sessionPersistence` 服务写 DSH 会话日志（仅 create + append，绝不删除/改写/归档）、工作区注册表记录、`$DSH_HOME/claude-move/` 下的缓存，以及 `claudecode` 工作区文件夹。
|
|
199
|
+
- **绝不** 修改 Claude 源文件、触碰其他应用的数据或访问网络。**不读取或传输任何凭据**。
|
|
200
|
+
|
|
201
|
+
## 安全边界
|
|
202
|
+
|
|
203
|
+
- **源文件只读；DSH 日志只追加**（仅 `create` + `append`）。
|
|
204
|
+
- **外部 transcript 是不可信输入** —— 其中的任何内容都不会被执行；system/developer/thinking 内容绝不进入续聊交接。
|
|
205
|
+
- **仅公开服务** —— `sessionPersistence` / `workspaceRegistry` / `tools` / `commands` / `systemPrompt` / `skills` / `webServer`；不改引擎或 UI。
|
|
206
|
+
- **密钥仅按位置报告**（file:line:kind）；`permission`/`permission-mode`/`queue-operation` 记录只计数、不导入。
|
|
207
|
+
- **向导写入审批门控** —— 除 `allowed-once` 之外的任何结果都意味着零写入。
|
|
208
|
+
|
|
209
|
+
## 已知限制
|
|
210
|
+
|
|
211
|
+
- 标题来自 `custom-title`/`ai-title`/首条提示；Claude `summary` 记录会被报告，但不映射为 DSH 压缩节点（合成一个有效的压缩事务会伪造其 seq 范围和检查点消息）。
|
|
212
|
+
- `thinking` 块作为 `reasoning` 内容保留，但绝不进入续聊交接。
|
|
213
|
+
- 被中断的工具调用会以合成的错误结果修复（绝不丢弃），报告为 `repaired.synthesized`。
|
|
214
|
+
- 权限类记录只计数、不导入；DSH 权限预设建议在报告中生成。
|
|
215
|
+
- 在没有流式 `fs.streamText` 接口的宿主上，超过 `maxTranscriptBytes` 的 transcript 会大声失败，而不是部分导入。
|
|
216
|
+
- 在 `workspaceMode: 'per-project'` 下，源目录已删除的会话仍会导入，但工作区挂载失败（保持未分组；`workspace.attached: false` 加上一个 `reason`）。默认的 `claudecode` 工作区不依赖源目录。
|
|
217
|
+
- 如果 transcript 被就地截断或重置（轮次少于记录的导入），重新导入会跳过它并报告 `sourceShrunk`；用 `force: true` 生成全新的完整副本。
|
|
218
|
+
- Web 面板是由插件自身 JSON 路由驱动的零构建浮动面板；它不使用 shell 内部的 UI 插槽系统。
|
|
219
|
+
|
|
220
|
+
## 模型体验
|
|
221
|
+
|
|
222
|
+
- 面向模型的面是两个工具的描述/schema 及其输出：`claude_scan` 返回结构化索引，`import_claude` 返回逐文件摘要以及警告的位置。工具结果本身被记录为 `tool/result` 事件，因此一切都可以重建。
|
|
223
|
+
- 没有隐藏的面向模型的文本；记忆/`CLAUDE.md` 段落注册在 `ctx.systemPrompt` 上（提示词组装，可从会话日志重建）。
|
|
224
|
+
|
|
225
|
+
## 故障排查
|
|
226
|
+
|
|
227
|
+
- 该行未生效：`dsh --profile <p> --dump-config` 应打印 `# == dsh-claude-move`；重新运行 `dsh plugin --profile <p> add ...`。
|
|
228
|
+
- Web 能启动但静默挂起：由 `dsh plugin add` 初始化的新 profile 只包含 `dsh-base` —— 将 `@deepseek-ai/dsh-web-app` 添加到 `dsh.profile.bundles`。安装到已有的 `web` profile 则无需任何操作。
|
|
229
|
+
- 面板路由 404：只有当 `enableWebPanel: true` 且组合了 web 服务器时才会提供这些路由；检查启动日志中的 FAILED fiber。
|
|
230
|
+
- 导入失败并提示 "transcript 过大"：提高 `maxTranscriptBytes` 或单独导入该文件。
|
|
231
|
+
- 导入成功但侧边栏没有显示新会话：页面已经打开 —— 点击一次面板的刷新按钮（或重新加载页面）即可。永远不需要重启 DSH。
|
|
232
|
+
- 日志：启动失败会打印到 `dsh` 控制台；插件会为工作区/导入映射问题记录以 `[claude-move]` 为前缀的错误。
|
|
233
|
+
|
|
234
|
+
## 致谢（开源组件）
|
|
235
|
+
|
|
236
|
+
本项目采用 Apache License 2.0 许可；以下 MIT 许可组件保留其自身许可（全文见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)）：
|
|
237
|
+
|
|
238
|
+
- 转换核心 vendored 自 [Nwflower/dsh-chat-import](https://github.com/Nwflower/dsh-chat-import)（MIT）。
|
|
239
|
+
- 发现约定与安全模型来自 [Demogorgon314/dsh-resume-plugin](https://github.com/Demogorgon314/dsh-resume-plugin)（MIT）。
|
|
240
|
+
- 记忆/技能注入与 frontmatter 解析模式来自 [YYTbit/dsh-plugin-claude-bridge](https://github.com/YYTbit/dsh-plugin-claude-bridge)（MIT）。
|
|
241
|
+
|
|
242
|
+
## 开发
|
|
243
|
+
|
|
244
|
+
```sh
|
|
245
|
+
npm install # peer 依赖：@deepseek-ai/dsh-tools@0.1.0-rc.6、@deepseek-ai/cordis、schemastery
|
|
246
|
+
npm test # node --test test/*.test.mjs
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
CI 通过 GitHub Actions（[test.yml](.github/workflows/test.yml)）在 Linux/macOS/Windows 上以 Node 22 运行完整套件。
|
|
250
|
+
|
|
251
|
+
## 主题
|
|
252
|
+
|
|
253
|
+
`deepseek-harness`, `dsh-plugin`, `claude-code`, `migration`, `session-import`, `resume`
|
|
254
|
+
|
|
255
|
+
## 贡献者
|
|
256
|
+
|
|
257
|
+
- [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者：导入管线、四来源迁移向导、Web 面板、文档、CI/CD 与发布。
|
|
258
|
+
- [@OLDnana1](https://github.com/OLDnana1) —— 对被中断工具调用损坏的根因分析，该损坏曾使导入会话在续聊时永久返回 HTTP 400。
|
|
259
|
+
- [@GooodWei](https://github.com/GooodWei) —— 发现 `README.md`（以及任何无描述的 `.md`）被误注册为技能，从而破坏 DSH 的技能加载。
|
|
260
|
+
|
|
261
|
+
## PerryLink DSH 插件家族
|
|
262
|
+
|
|
263
|
+
本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也有用：
|
|
264
|
+
|
|
265
|
+
| 插件 | 一句话介绍 |
|
|
266
|
+
|---|---|
|
|
267
|
+
| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | 只读 MCP 运行时面板：/mcp 命令 + 带状态、工具和错误的设置标签页 |
|
|
268
|
+
| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | 工程纪律守卫：需求盘问、测试门、对手审查 |
|
|
269
|
+
| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | 带 Web UI 侧边栏、消息和中断的持久后台子代理 |
|
|
270
|
+
| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | 通过语言服务器提供 LSP 诊断、格式化、补全、代码操作与重命名 |
|
|
271
|
+
| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles 等价的运行时样式切换 |
|
|
272
|
+
| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind 等价物：快照、会话分叉、一次性恢复 |
|
|
273
|
+
| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 |
|
|
274
|
+
| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | 在审批链上的第二模型自动审查，默认 fail-closed |
|
|
275
|
+
| [dsh-memento](https://github.com/PerryLink/dsh-memento) | 审批门控的跨会话记忆：ctx.memory 接缝 + SQLite + 记忆工具 |
|
|
276
|
+
| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | 安全审计技能包：密钥扫描、依赖与供应链审查 |
|
|
277
|
+
| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | 在 Web 侧边栏固定会话，带持久排序 |
|
|
278
|
+
| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web 编辑器终端风格输入历史：方向键、Ctrl+R 搜索 |
|
|
279
|
+
| [dsh-github](https://github.com/PerryLink/dsh-github) | DSH 的 GitHub PR/issues 集成，每次写入都经审批门控 |
|
|
280
|
+
| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | 作为按需代理技能的插件开发知识库 |
|
|
281
|
+
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 将 Claude Code 会话、记忆、技能和 CLAUDE.md 迁移到 DSH |
|
|
282
|
+
|
|
283
|
+
## 许可证
|
|
284
|
+
|
|
285
|
+
[Apache License 2.0](LICENSE) © 2026 dsh-claude-move contributors
|