kinyokun/dsh-session-import
DSH(DeepSeek Harness)会话日志导入插件:把 /export 导出的会话 zip 或裸 .jsonl 日志导入为新的会话,导入前做结构真实性验证与 SHA-256 指纹校验,并可按需同步模型/思考深度/Agent 预设/权限/沙箱等状态。自带浏览器端 UI —— 新对话界面「模式选择」右侧的「导入对话」按钮 + 完整导入对话框,导入/删除实时推送到页面,无需刷新。
catalog 简介 / catalog descriptioncatalog description：DSH 会话日志导入插件:解析 /export 的 zip/jsonl,结构真实性验证 + SHA-256 指纹校验,同步模型/预设/权限等状态,导入/删除实时推送免刷新
安装Install
dsh plugin --profile web add github:kinyokun/dsh-session-import把 kinyokun/dsh-session-import 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-session-import
DSH(DeepSeek Harness)会话日志导入插件:把 /export 导出的会话 zip 或裸 .jsonl 日志导入为新的会话,导入前做结构真实性验证与 SHA-256 指纹校验,并可按需同步模型/思考深度/Agent 预设/权限/沙箱等状态。自带浏览器端 UI —— 新对话界面「模式选择」右侧的**「导入对话」**按钮 + 完整导入对话框,导入/删除实时推送到页面,无需刷新。
Overview
解决什么问题:DSH 的 /export 产物没有原生的导入通道;会话的"分享 / 迁移 / 备份回灌"只能靠手工摆弄 session 目录。本插件提供一键导入,并在导入前把"这是不是被改过的文件"讲清楚。
适合谁:
- 想在另一台机器 / 另一个部署上继续他人会话的人;
- 想备份后回灌、或把一个会话复制成多个分支做对照实验的人;
- 需要审计会话日志真伪(是否被删改)的人。
双面结构(与 DSH 的 dsh.client 插件包约定一致):
| 端 | 文件 | 职责 |
|---|---|---|
| 宿主 | host.js |
/session-import/* HTTP 接口:zip/jsonl 解析、结构真实性验证、SHA-256、导入(含 dryRun 预演、open=1 实时恢复)、删除 |
| 浏览器 | client.js |
hero 界面导入按钮、拖拽/选择文件、验证与同步项预览、导入并打开 |
Compatibility
| 项目 | 声明 |
|---|---|
| 支持的 DSH 版本 | @deepseek-ai/dsh 0.1.0-rc.6(2026-08-14 安装/加载/导入/删除全流程实测) |
| 已验证环境 | macOS + Node.js 25,dsh web profile patch 挂载,zstd 与明文两种持久化编码 |
| 最后验证日期 | 2026-08-14 |
| 已知耦合点 | 解析器内置的 KNOWN_SESSION_EVENT_TYPES 白名单与开发时构建一致;DSH 升级引入新事件类型后,新格式日志会被判 error 拒绝导入(DSH 自身的冷读校验同样会拒绝),届时同步白名单并升级版本即可 |
DSH mainline 变化很快:升级前建议先跑 test/smoke.sh 验证。
Install / Uninstall
安装
把本仓库放进 profile 的
node_modules(包名即目录名):PROFILE_DIR=~/.dsh/profiles/web # profile 名按实际部署调整 mkdir -p "$PROFILE_DIR/node_modules/dsh-session-import" cp host.js client.js package.json "$PROFILE_DIR/node_modules/dsh-session-import/"在
$PROFILE_DIR/cordis.patch.yml追加插件行:- insert: - id: session-import name: dsh-session-import目录名用
session-import时写name: session-import,二者等价。重启
dsh web(宿主代码在模块缓存中,需进程重启生效;launchd 等托管方式会自动拉起)。刷新浏览器页面 —— 新对话界面出现「导入对话」按钮。
升级
覆盖 host.js / client.js / package.json 后重启 dsh web 并刷新页面。已导入的会话不受影响。
禁用
在 patch 中追加 - id: session-import + disabled: true(保留文件,随时可重新启用)。
彻底移除
删除 patch 中的 insert 条目与 node_modules/dsh-session-import/ 目录,重启 dsh web。已导入的会话日志保留在 DSH 的 sessions 目录中(它们是普通会话,可用 POST /session-import/delete 删除或留用)。
Quick start
图形界面(推荐):新对话界面 → 「导入对话」→ 拖入 .zip/.jsonl → 查看验证结果与可同步项 → 选目标工作区 → 「开始导入」→ 会话实时出现在侧栏并自动打开。
命令行最小示例:
# 预览与验证(不落盘)
curl -X POST --data-binary @session.zip \
-H 'content-type: application/octet-stream' \
'http://127.0.0.1:3080/session-import/analyze?name=session.zip'
# 导入到指定工作区:置顶时间戳、同步全部状态、导入即恢复(页面实时可见)
curl -X POST --data-binary @session.zip \
-H 'content-type: application/octet-stream' \
'http://127.0.0.1:3080/session-import/import?name=session.zip&workspace=%2FUsers%2Falice%2Fprojects%2Fdemo&restamp=1&open=1'
# 删除导入产物(测试/撤销)
curl -X POST 'http://127.0.0.1:3080/session-import/delete?sessionId=session-xxx'
Configuration
本插件没有持久化设置;全部行为由导入时的一次性参数控制(接口参数即配置,UI 中的勾选项一一对应):
| 参数 | 默认 | 说明 |
|---|---|---|
workspace |
—(必填) | 目标工作区绝对路径,或 original(沿用日志原始 cwd,需本机存在) |
restamp |
1 |
置顶显示:事件时间戳平移到当前,保持相对间隔 |
sync |
全部 | model,preset,permission,sandbox,approval,plan 的逗号子集;未列出的组被过滤,seq 引用自动重写 |
title |
空 | 自定义标题(UTF-8 截断至 100 字节) |
expectedHash |
空 | 期望 SHA-256;不匹配拒绝导入(强校验) |
open |
0 |
1 导入后立即恢复为活跃会话,侧栏免刷新可见 |
dryRun |
0 |
1 只校验与计算,不落盘 |
资源上限:上传原始字节 ≤ 256 MB;zip 单条目解压后 ≤ 1 GiB;拒绝加密 zip。
环境变量:无。插件不读取任何环境变量,不产生新的持久化文件(导入的会话写入 DSH 自身的会话存储,删除接口可整体移除)。
Permissions & data
| 维度 | 说明 |
|---|---|
| 读取 | 仅读取你上传的文件(内存中处理,上限 256 MB);导入校验时读取 DSH 自身的会话存储与工作区注册表 |
| 写入 | 只写入 DSH 会话持久化目录(目标工作区下的新会话产物)与工作区记账(挂载/解除);删除接口移除自己导入的产物 |
| 网络 | 无任何出站请求;全部接口走 DSH 本机 webServer 回环地址 |
| 凭据 | 不接触任何 API Key/凭据;SHA-256 在本地计算 |
| 删除行为 | 只删除本插件导入的会话;内存活跃且非本插件导入的会话会被拒绝(409 live) |
Troubleshooting
| 现象 | 原因与处理 |
|---|---|
400 bad-file |
文件不可解析:非 zip/jsonl、zip 损坏/加密/超限、首行不是合法会话头、version ≠ 0(未来格式)、JSON 行损坏 —— 换原始导出文件重试 |
409 hash-mismatch |
文件指纹与「预期 SHA-256」不一致:疑似被篡改,或粘贴的指纹来自另一个文件 |
422 structure |
结构校验存在 error(seq 断裂/未知类型/非法引用),或导入后装载校验失败 —— 后者已自动回滚,不会留下半成品 |
409 live |
删除目标在内存中活跃且不是本插件导入的:先在界面中离开该会话再删 |
400 workspace / 500 workspace-attach |
目标工作区不存在/不是目录;挂载失败会自动回滚 |
503 persistence / workspace |
宿主组合缺少对应服务(检查 profile 的 bundle) |
resumed: false |
open=1 恢复失败(如 preset 组合失效),导入本身成功,会话为冷状态,刷新列表即可见 |
| 导入后侧栏没有新会话 | 未用 open=1 且页面未刷新:点会话列表的刷新或直接刷新页面 |
日志位置:插件告警走宿主 logger(与 dsh web 的标准输出/日志文件一致);接口错误都随 HTTP 响应返回,无需翻日志。
回滚:导入失败会回滚;已成功的导入用 POST /session-import/delete 整体移除;插件本身出问题按「禁用」章节操作即可。
Development
node --check host.js && node --check client.js # 语法检查
BASE_URL=http://127.0.0.1:3080 bash test/smoke.sh # 冒烟测试(无副作用)
BASE_URL=… SMOKE_IMPORT=1 bash test/smoke.sh # 追加真实导入 + 删除闭环
test/fixtures/提供合法样本与被删行篡改样本,用于验证结构校验与指纹逻辑;- 开发调试建议用
analyze与dryRun=1(不落盘),再用open=1+delete做完整闭环; - 贡献:欢迎 issue / PR;改动请同步更新
CHANGELOG.md并跑通冒烟测试。
License & security
- 许可证:MIT © 2026 kinyokun
- 安全报告:见 SECURITY.md(请勿在公开 issue 中贴敏感内容)
- 能力边界(诚实声明):结构验证 + SHA-256 指纹能发现多数篡改,但当前 DSH 导出不含签名,无法证明作者身份;需要不可伪造的保证时,配合导出方另行公布的指纹使用,或等待导出端签名能力。详见 docs/security.md
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…