前言¶
在 DeepSeek Harness（DSH）里续聊网页端历史，常见做法是装导入类插件，用 userToken 拉取 chat.deepseek.com 上的会话并写成可恢复的本地会话。社区里 wpc0323/deepseek-web-import 已经打通了目录、Token、格式兼容和设置页；若对话里只有纯文本，用它通常就够。
一旦历史里带了截图、PDF 或 Word，原版导入往往只留下文字：图片和文档附件会丢，搜索回答末尾的 [reference:N] 会以字面量留在正文里，导入完成后还要手动刷新页面，侧边栏标题有时也要点开一次才显示。这些细节不决定「能不能导入」，但会决定「导进来能不能继续用」。
LingSuiYA/deepseek-web-import-f（目录页：SkillHub 插件条目）是在上游 0.2.0 基线上的功能补充：保留图片与附件，并顺带改善正文清洗、导入结果反馈和列表刷新。下文按定位、能力、安装与用法说明如何接入。
这是什么¶
维护者为 LingSuiYA，分类为 联网工具。包名仍为 deepseek-web-import，与上游 同名、同 Cordis row——安装本仓库会替换已装的上游包，二者二选一；对话目录、Token 存储、会话格式兼容、设置页与诊断能力来自上游，本仓库只补齐导入时会丢失的图片、文档附件，以及正文清洗与客户端体验。
项目通过非官方内部接口读取用户自己的对话数据，与 DeepSeek 官方无关，也不代表上游作者；使用风险由使用者承担。许可证为 MIT（继承上游）；当前资料中的版本号为 0.2.0-dlc.15。
核心功能¶
图片与文档附件¶
- 图片：从用户消息的
FILEfragment 取文件 ID，经fetch_files刷新签名路径，用ty=p下载预览图；按魔数识别格式后交给 DSH 附件服务，会话内可直接显示。预览接口单张上限 12 MB。 - 文档：PDF、Word、文本等按
ty=r取原件，流式落盘（临时文件再saveFileStream），导入侧保留 1 GiB 失控保护；网页端上传限制（如单文件 100 MB、最多 50 个）以 DeepSeek 网页为准。 - 失败隔离：单张图片或单个文档失败只跳过该项，文本与会话照常写入。
- 正文清洗：去掉
[reference:N]与孤立的<br>，围栏代码块内内容保持原样。
结果报告与自动刷新¶
导入完成后展示会话 ID、消息数、事件数、会话格式版本，以及 含图片 N 张 / 含附件 N 个；找到但未存下时显示 0/N，便于区分「本来就没有」与「有但失败」。成功后约 1.2 秒自动刷新页面，新会话出现在侧边栏。连续导入可勾选「批量导入」，最后点「完成导入并刷新（N 条）」；偏好记在 localStorage。
实现概要¶
上游将 history_messages 的 fragments 译为 DSH 会话事件；本补充在写会话前增加附件处理与正文清洗，再进入 buildSessionEvents。新增模块包括 lib/images.js、lib/files.js、lib/text.js，并扩展 lib/events.js、lib/index.js、lib/client.js。
安装与启用¶
前置条件（来自 README）：
- DSH 0.2.x（资料记载实测
0.2.1-rc.2），会话格式 v4。 - Node.js ≥ 18（路线 B/C 需要）。
- git：路线 A/B 需要；宿主 PATH 无
git时路线 A 可能失败。 - 能访问 GitHub（路线 A/B）；DeepSeek 网页账号用于获取
userToken。
路线 A：从 Git 仓库安装（推荐，市场可跟踪更新）¶
dsh plugin add LingSuiYA/deepseek-web-import-f
等价写法：
dsh plugin add github:LingSuiYA/deepseek-web-import-f
装完后重启 DSH。若报 git ls-remote failed，说明环境缺少可用 git，可改用路线 B 或 C。
路线 B：固定上游基线 + 本地补丁¶
先装上游提交 7727f18 的归档，再在本仓库执行补丁脚本（不通过 dsh plugin add 安装本仓库包，而是修改已安装的上游目录）：
dsh plugin add https://github.com/wpc0323/deepseek-web-import/archive/7727f18e3996713dec1b7046d07897c19efed5ae.tar.gz
git clone https://github.com/LingSuiYA/deepseek-web-import-f.git
cd deepseek-web-import-f
node tools/apply-dlc.mjs
默认补丁目标是 ~/.dsh/profiles/desktop/node_modules/deepseek-web-import；profile 不同时可传目录参数或设置 DSH_PLUGIN_DIR。
路线 C：离线本地 tgz¶
在内网或试用场景可 npm pack 后：
dsh plugin add file:/absolute/path/deepseek-web-import-0.2.0-dlc.15.tgz
（Windows 使用 file:C:/path/... 等形式，文件名需写实际打包结果，勿依赖 shell 展开 *。）
更新注意：重装上游、更换基线或从市场重装后，被修改过的文件可能被还原，路线 B 需重新执行 node tools/apply-dlc.mjs。只想纯文本导入时，直接用上游即可。
插件以当前 DSH 进程权限运行；安装前建议浏览仓库源码与 LICENSE、NOTICE，确认接受非官方接口与 Token 处理方式。
典型用法¶
经过上面的安装步骤并重启 DSH 后：
- 打开 设置 → 对话导入。
- 在浏览器登录 chat.deepseek.com，
F12→ Application → Local Storage，复制userToken的值，粘贴到插件设置并保存（插件会自动取出value字段）。 - 点击 获取对话目录，选择目标工作区，导入为会话。结果行会显示消息数及
含图片 N 张/含附件 N 个；默认会自动刷新，侧边栏直接出现新会话。
更完整的验收与故障排查见仓库 docs/INSTALL-FROM-ZERO.md 与 docs/TROUBLESHOOTING.md。启动期若出现 deepseek-web-import: import failed，可先通过启动对话框「禁用第三方插件」拉起 DSH，再按文档回滚客户端或重装上游。
适用场景与注意¶
适合：已在 DSH 0.2.x 使用或打算使用网页对话导入，且历史里含图片、PDF 等附件，希望在本地会话里保留附件并减少正文噪音与手动刷新的操作。
限制与兼容（以 README 为准）：
- 文档字节可完整保留，但模型上下文里仍只有 DeepSeek 当时存下的文本；解析后的文档正文若不在历史负载里，导入后也不会凭空出现。
- 带
file块的历史在续聊时，需要模型适配器接受该块，建议用一条含文档的对话验证。 userToken过期后需重新保存。- 错误码沿用上游（如
no_token、api、too_large、persist等）；附件环节失败不拖垮整次导入。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录独立于 DeepSeek / 幻方，并非官方应用商店。本插件在 GitHub 上星标数为 0（以目录页抓取为准），不代表质量结论，使用前仍以自述文档与源码为准。
结尾¶
若你的痛点是「网页对话能进 DSH，但图和附件没了」，deepseek-web-import-f 在上游导入链路上补了附件下载、正文清洗和导入后的反馈与刷新。安装首选 dsh plugin add LingSuiYA/deepseek-web-import-f，装完重启并按设置页完成 Token 与导入即可。
