前言¶
DeepSeek Harness (DSH) 插件，用于编排用户拥有的 DeepSeek 网页历史到本地知识库的同步流水线。它把已有的同步逻辑搬到同源控制页，实现一键运行、查看状态与日志、跑完整性体检。
核心能力¶
- 使用 DSH subprocess：起你配置的命令。
- 读状态与日志：展示进度。
- 完整性体检：跑你指定的体检命令。
- 拉取会话：用 DSH 凭据服务里的
userToken调chat.deepseek.com，拉取会话列表。只取新增/续聊的线程，规范化成conversations/*.md+conversations.l+catalog.json。 - 插件内检索：对知识库进行检索。
- 全量回填：支持全量回填。
安装¶
安装标准 dsh.bundle 插件，零依赖、无客户端构建步骤。
dsh plugin --profile web add github:284022719/dsh-kb-sync
安装后重启 DSH。要求 DSH 提供 webServer 与 subprocess 服务（0.2.x 默认都有），Node ≥ 20。
使用¶
打开控制页：http://127.0.0.1:<DSH Web 端口>/__dsh-kb-sync/。
- 粘贴 userToken：粘贴一次，它只进 DSH 凭据服务，不落明文文件。
- 拉取新对话（增量）：只取新增或续聊的线程，生成文件。
- 全量回填：走官方导出包，解析后合并到知识库。
- 检索：在页面内检索知识库。
- 运行已有同步脚本 / 体检 / 刷新状态：通过控制页操作。
安全与限制¶
插件分为两半：一半读凭据值、会出网；另一半不读凭据、不出网。
红线：读凭据值 + 有网络。这是“自己拉取”那一半的必然结果。红线默认应挡住，如需继续使用需在设置中确认风险。
不做什么：
* 不把 token 写进任何文件/日志/响应。
* 不访问 chat.deepseek.com 之外的任何地址。
* 不读凭据文件正文，只读修改时间。
* 不注册提示词段落，不改核心 bundle，无安装脚本。
限制：
* 纯 host 半部，需要宿主提供 subprocess 服务。
* 状态是轮询（运行中 3 秒一次）。
* 界面文案目前是中文。
* Node >= 20。
更多信息¶
- 目录：https://www.skillhub.cn/plugins/284022719/dsh-kb-sync
- 仓库：https://github.com/284022719/dsh-kb-sync
