本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-chat-import

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-chat-import

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 外部 → DSH：按间隔巡检 Claude / Codex / Grok 的新增或增长会话，走既有幂等续写。
• DSH → 外部：把 DSH 新增完整轮次写回对应 agent。导入源追加到原文件；原生 DSH 会话在该 agent 默认根下落一份副本。
• 两个方向默认关闭，必须在面板里打开开关，或点「立即同步」。配置在 $DSH_HOME/dsh-chat-import/sync.json。
• Watch 懒检查模式 — 开启后，打开面板即按 mtime 检查已导入源，增长者增量续写（幂等，无常驻监听）。
• preview: true（别名 dryRun: true）— 只读运行：照常解析 / 读取 / 转换，但零副作用、不落盘。去掉该参数再调一次即正式导入。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要额外配置吗?

不需要。装好后重启 dsh 即可,插件默认消费 host 公开服务;可选的环境变量(DSH_IMPORT_CONTEXT_BUDGET、DSH_IMPORT_SESSION_HINT、DSH_IMPORT_CONTEXT_BRIDGE)用于调整上下文预算、关闭会话起始提示、开启 Claude 上下文桥接。

数据存在哪里?会改写源文件吗?

不会改写任何源文件。导入结果写到 DSH 会话目录,导入元数据落到 $DSH_HOME/dsh-chat-import/imports.json($DSH_HOME 默认 ~/.dsh);源 transcript 与 SQLite 数据库全程只读。

重复导入同一份历史会重复写入吗?

不会。源文件未变会幂等跳过,只读取不写;源文件增长会把新增轮次追加到同一会话;源文件缩小会被检测并报告,不静默覆盖。force:true 可以用新 id 另存一份完整副本。

导入的会话能继续聊天吗?

能。导入时尽量走 agents.create 路径并挂载默认 preset scope 和默认模型,工具面与原生 DSH 会话一致,刷新会话列表后打开即可接着聊。

怎么撤销导入的会话?

用 retract_import({ sessionId }) 移除 registry 记录并返回手动删除引导;插件从不调用任何删除,需要按引导手动删除会话工件后再 force:true 重导即可获得全新会话。

支持哪些 AI 编码工具?

15 种来源:Claude Code、Claude-3p 新客户端、Codex/ChatGPT CLI、ChatGPT 网页导出、Cursor、Gemini CLI、Reasonix(含桌面版)、opencode、ZCode(z.ai CLI)、Grok Build、OpenClaw、Pi Coding Agent、Hermes、Kimi CLI/Kimi Code、Qoder CLI,以及任意本地 JSONL(自动识别)。

可以把 DSH 会话导回到其他 agent 吗?

可以。export_claude 把 DSH 会话序列化为 Claude Code JSONL;export_codex 与 export_kimi 写出 Codex rollout 与 Kimi wire 格式;export_bundle 写出带 SHA-256 双指纹的可移植交换包,restore_bundle 在另一台机器还原。

超长历史怎么办?

默认按 550k token 上下文预算裁剪(参数 budget 或环境变量 DSH_IMPORT_CONTEXT_BUDGET 可覆盖,优先级 工具参数 > 环境变量 > 动态模型窗口 > 550k);Claude 会话可用 compacted:true 只导最后一次压缩摘要+尾部。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+ (peer @deepseek-ai/dsh-tools ^0.1.0-rc.6)
• Node: >=22.13 (engines.node)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则