dsh-kb-sync

中文 ｜ English ｜ 使用说明 ｜ 更新日志

DeepSeek Harness 插件：把你自己已有的同步流水线搬到一个同源控制页——一键运行、看状态、看日志、跑完整性体检。

典型的流水线是「网页端对话历史 → 本地知识库」，但插件本身不关心你同步什么。

定位：一个插件，三块能力。 ① 自己拉取：用你存在 DSH 凭据服务里的网页端 userToken 调 chat.deepseek.com，把对话规范化落到本地知识库，并在插件内检索 —— 这一块读凭据值、会出网（见下方能力披露，dsh-trust-check 判为红线）。 ② 编排：起你已有的同步/体检命令、读状态与日志 —— 这一块不读凭据、不出网。 ③ 整理（模型判断）：把管线里「让模型做判断」那一步搬进进程内（准备输入 → 调宿主 llm 服务拿一份 JSON → 校验通过才落盘/重建）—— 不读凭据；出网走宿主 llm 适配器，域名由你配的提供方决定，插件自己不写死。 三块都不注入提示词、都不改核心 bundle、都没有安装脚本（逐项对照见 docs/CAPABILITY-DISCLOSURE.md 第一节）。

另外三张（整页的分步表格、检索命中、英文界面）在 assets/screenshots/，清单是 screenshots.json。 重新生成：node tools/make-screenshots.mjs —— 它起一个只喂假数据的本地演示服务再截真实页面， 所以图里的路径（D:\demo\...）与对话都是编的，不含你的任何数据。

_{⚠️ 这张图只画编排半（阶段 1 的画法）：虚线框里是插件当时对外的 5 个路由与只读状态文件，出网与凭据都在绿色框里 —— 你自己那条命令中。拉取半（读凭据、连 chat.deepseek.com）与整理（调宿主模型）都不在图上，别把它当成全部作用域；全部路由见下方路由表。}

它做什么 / 不做什么

	说明
✅ 做（编排半）	用 DSH 的 subprocess 起你配置的命令；读状态文件与日志展示进度；跑你指定的完整性体检命令；全部通过一个本地控制页操作
✅ 做（拉取半）	用 DSH 凭据服务里的 userToken 调 chat.deepseek.com：拉会话列表 → 只取新增/续聊的线程（chat_session.current_message_id 权威定位末端）→ 规范化成 conversations/*.md + conversations.jsonl + catalog.json → 插件内检索
✅ 做（整理）	进程内跑管线的判断步骤：准备输入 → 调宿主 llm 服务拿 JSON → 用管线的 apply-extraction.mjs 校验 → 通过才落盘并重建；默认只校验不落盘
❌ 不做	不把 token 写进任何文件/日志/响应（只进凭据服务）；拉取半不访问 chat.deepseek.com 之外的任何地址（整理出网走宿主 llm 适配器，地址由宿主配置决定）；不读凭据文件（那个会过期的 .token）的正文、只 stat 它的修改时间；不注册提示词段落；不改核心 bundle；无安装脚本、无运行依赖

目录结构（一个自包含的文件夹）

dsh-kb-sync/
├─ lib/                  插件代码：index（路由+整链编排）/ client（客户端半部：设置页分节）/ locale（多语言）/ deepseek（接口）/ export（回填）/ store（落盘）/ page（控制页：结论条 + 收新对话/找内容/整理/诊断）/ pipeline（分步判定）/ process（整理）
├─ locale/               控制页译文（`en.json` —— 中文是源语言，键就是中文原文）
├─ docs/                 能力披露与架构图
├─ test/                 单测（node --test，91 例；文档一致性与随包卫生也在里面）
├─ tools/                发布脚本（publish.ps1 / publish.cmd）与发布前预检（preflight.mjs）
├─ config.example.json   配置样例 —— 复制成 config.json 就生效（配置跟着代码走）
├─ data/kb/              **知识库默认就落在这里**（不入库；可配 outDir 改到别处）
├─ CONTRIBUTING.md / SECURITY.md / AGENTS.md
├─ package.json / cordis.patch.yml / README.md / README.en.md / CHANGELOG.md / LICENSE

上面是源码仓库的样子。安装包（package.json 的 files 白名单；2026-10-16 实测 npm pack --dry-run 共 58 个文件 / 约 480 KB）里有 lib/、locale/、docs/、tools/pipeline/、 assets/screenshots/、screenshots.json、cordis.patch.yml、config.example.json、CHANGELOG.md、 README.md、README.en.md、CONTRIBUTING.md、SECURITY.md、LICENSE —— test/、tools/publish.*、AGENTS.md、data/ 不在其中（config.example.json 自 0.1.0 起随包发布； 更早装的快照里没有它，那就直接新建 config.json）。 管线目录里还有五项取反：pipeline.json（含本机绝对路径，随包会让用户读错数据目录）、 trigger.log / trigger.json / trigger-source.json（本机运行事实）、retired/（退役脚本留档） —— 有 files 字段时 .npmignore 不生效，取反是唯一手段（见 docs/PUBLISHING.md）。

适配你的流水线

插件对你现有的脚本只有一个硬要求：一个可执行的同步命令。其余都是可选的，缺了对应功能自动降级、不会报错崩掉：

你提供的东西	插件用它做什么	缺失时
同步命令：sync/sync-daily.{cmd,ps1,sh}，或 syncScript 显式指定	/run 按钮	/run 返回 sync-script-missing，其余功能照常
日志目录（默认 sync/logs/）	/log 与「最新日志」	状态里不显示日志
进度文件（默认 sync/LAST-SYNC.txt）	状态里的「最近几次结果」	跳过该栏
一个会过期的凭据文件（默认 .token）	只读它的 mtime，换算成「年龄天数 / 是否偏旧」	跳过该栏
体检命令（默认 <kbDir>/tools/kb.mjs doctor）	/doctor 按钮	找不到脚本时 /doctor 返回 doctor-script-missing（没有单独的关闭开关；doctorScript 留空只会回落到默认路径，不等于禁用）

这些默认值都来自一条真实流水线（sync/sync-daily.cmd、sync/logs/、LAST-SYNC.txt、.token、knowledge-base/tools/kb.mjs）， 但它们只是默认值：每一项都能用配置改成你自己的路径与命令，体检命令也可以是任何可执行脚本（doctorScript + doctorArgs）。

安装

标准 dsh.bundle 插件（host 半部、零依赖、无客户端构建步骤）：

dsh plugin --profile web add github:284022719/dsh-kb-sync

装完重启 DSH。要求：DSH 提供 webServer 与 subprocess 服务（0.2.x 默认都有），Node ≥ 20。

配置

插件不猜你的目录：没配置时它照常加载，控制页会直接告诉你缺什么。

方式一：profile patch（~/.dsh/profiles/<profile>/cordis.patch.yml，按 id 覆盖）

- id: dsh-kb-sync
  name: 'dsh-kb-sync'
  config:
    root: 'D:\path\to\pipeline'          # 流水线根目录；下面几项都能由它推出来
    # syncScript:   '...\sync\sync-daily.cmd'   # 默认自动发现 sync\sync-daily.{cmd,ps1,sh}
    # logDir:       '...\sync\logs'
    # lastSyncFile: '...\sync\LAST-SYNC.txt'
    # tokenFile:    '...\.token'                # 只读 mtime，不读内容
    # tokenOldDays: 21                          # 超过就标「token 偏旧」
    # kbDir:        '...\data\kb'               # 体检脚本的落点（默认＝知识库目录本身）
    # doctorScript: '...\tools\kb.mjs'          # 任何可执行脚本都行
    # doctorArgs:   ['doctor']
    # nodeBin: 'node'
    # timeoutMs: 3600000
    # —— 整理（进程内调宿主 llm 服务）——
    # pipelineDir:     '<插件目录>\tools\pipeline'  # 管线脚本目录（默认就推到这里）
    # processProvider: 'deepseek-official'          # 不配就取第一个已注册提供方
    # processModel:    'deepseek-v4-flash'          # 不配就取该提供方目录里的第一个模型
    # processMaxTokens: 4096
    # —— 更新知识库的新鲜度闸门 ——
    # chainMinIntervalMs: 21600000                  # 距上次成功不足这么久就 skipped（默认 6 小时；页面按钮用 force 绕过）

方式二：插件文件夹里的 config.json（推荐——配置跟着代码走，整包拷走也不丢）

// <插件目录>/config.json   （可先复制同目录的 config.example.json 改名；更早装的快照里没有那个样例文件，直接新建即可）
{ "root": "D:\\path\\to\\pipeline", "outDir": "data/kb", "tokenOldDays": 21 }

方式三：设置文件（有些 profile 会在重启时重写自己的 cordis.patch.yml，手写的 loader 行会丢；设置文件不会）

// $DSH_HOME/.dsh-kb-sync.json    （未设 DSH_HOME 时即 ~/.dsh/.dsh-kb-sync.json）
{ "root": "/srv/pipeline", "tokenOldDays": 14 }

方式四：环境变量 DSH_KB_SYNC_ROOT / DSH_KB_SYNC_OUT_DIR / DSH_PIPELINE_DIR。

优先级：loader config → 环境变量 → 用户设置文件 → 插件文件夹里的 config.json → 内置默认。文件缺失或 JSON 坏掉都按空处理（不影响加载），读到哪些会在 /status 的 configFile 字段里报告（used / localUsed）。

⚠️ 改完配置要重启应用才生效。 resolveSettings() 只在插件加载时跑一次，配置缓存 在内存里 —— 改文件后 /status 仍会报旧的 syncScript（2026-10-12 实测：把 syncScript 换成 trigger.cmd 后，/status 继续显示已退役的 sync-daily.cmd 并报 configured:false）。 页面上的其它按钮不受影响（它们读的是同一份内存配置），但"运行已有同步脚本"要等重启才切到新入口。

数据落在哪（自包含）

默认就是插件文件夹内：<插件目录>/data/kb/（conversations/*.md + conversations.jsonl + catalog.json）。 所以插件不与别的脚本共用知识库目录、也不会互相覆盖 —— 想复用别人的库才需要显式配 outDir。

// 例：把知识库放到别处（或复用一个已有库）
{ "outDir": "D:\\dsh\\knowledge-base" }

POSIX 示例（syncScript 指向 .sh 时用 /bin/sh 执行）：

{ "root": "/srv/kb-pipeline", "syncScript": "/srv/kb-pipeline/sync/daily.sh", "logDir": "/srv/kb-pipeline/sync/logs" }

使用

控制页在 http://127.0.0.1:<你的 DSH Web 端口>/__dsh-kb-sync/（与 GUI 同一个端口）。 页面按任务分四块 —— 结论条 / 收新对话 / 找内容 / 整理，重活收在「运行详情与诊断」的折叠里（2026-10-15 重排，见下）：

也可以不开这一页：应用内 设置 → dsh-kb-sync 有一份状态摘要（配置 / 根目录 / 知识库目录 / 凭据年龄 / 知识库规模 / 是否在跑）和两个动作——抓取新对话 / 更新知识库。它跟随界面语言显示中文或英文；不提供配置编辑（配置在插件加载时解析一次，改完要重启，页面能改反而会骗人），也不提供"打开控制页"（进哪一页只该有一个答案）。

本机（作者的流水线）从控制台的「同步」页签进 —— 那一页嵌的就是这张页面。

语言：控制页默认中文；?lang=en 强制英文，不带参数时跟随浏览器的 Accept-Language（不认识的语言回落中文），页面右上角可切换。中文是源语言——页面里写的就是译文表的键（locale/en.json），缺译自动回落中文，所以加语言不用改页面代码。

首屏的结论条 —— 一句话结论（正常 / 需要看一眼 / 上次没成功）+ 三个关键数字（知识库会话数、最近一次更新、登录态年龄）+ 主按钮「更新知识库」。真有事要办才会多出一块「要你处理」（登录态偏旧、上次更新失败、还没配 root）。

收新对话

• 抓取新对话（增量）：会话列表 → 只取「新增 / 续聊」的线程 → 写 conversations/*.md + conversations.jsonl + catalog.json；续聊就地更新、文件名不变。
• 补齐全量历史（默认折叠，只在需要时用）：走官方导出包（export_all → 轮询到就绪 → 下载 zip → 解析 conversations.json）。已有会话仅在导出内容更多时才更新；服务端生成导出可能要几分钟，所以它在后台跑，页面每 3 秒刷新进度：trigger → waiting-export → downloading → parsing → merging → done。

找内容 —— 关键词搜标题与正文，可勾「只看用户说的话」；每条命中都可点「展开全文」，直接在页面里读那个会话的完整 Markdown（思考过程与联网检索记录都在）。

整理（模型归类与提炼） —— 把抓进来的新对话交给宿主模型判断一次（话题归属、健康事实、财务候选）。两个按钮：

• 试运行（只看会改什么，不写入）：准备输入 → 调宿主 llm 服务拿一份 JSON 判断 → 写 sync/out/ → 跑管线自己的 apply-extraction.mjs 校验。默认就是这个模式，用来先看清"会写哪些文件、各几条"。
• 写入并重建：校验通过后才写入，并依次重建知识库（apply-update-topics / build-kb / build-specialties / map-specialties）与健康档案（build-health-profile / sync-knowledge）。

模型只做判断、产出是 JSON、先校验再用是刻意的：让模型直接改 health/ 或财务台账，钱的数字悄悄错掉很难发现。 （这套东西以前叫"段 2"，跑在一个独立的 dsh headless 运行时里；现在在插件进程内调宿主模型，名字也改成说人话的「整理」。）

更新知识库（首屏主按钮） —— 按顺序跑 登录态检查 → 查有没有新内容 → 抓取 → 整理 → 体检，每一步都有独立结论、退出码与耗时， 写在「运行详情与诊断 → 上次更新的每一步」表格里（原始步骤名 token/recon/fetch/process/doctor 只留在悬停提示里，方便对着日志排错）；失败时那一行直接写明原因 （token-expired / failed / spawn-failed / finished-with-crash）。

• 计划任务是可选的外部触发器，它只负责"戳一下"：DSH-KB-DailySync → tools\pipeline\trigger.cmd → POST /pipeline。 触发器从 trigger.json（插件按真实监听端口写）读地址，先轮询 /status 等宿主起来（登录时补跑不会误报失败）， 再把逐段结果追加进 trigger.log。它自己不编排任何东西。

  本机 2026-10-12 起已删除该计划任务（用户取消了每天 21:00 的自动抓取），所以现在只有手动入口： 页面上的「更新知识库」按钮，或双击 tools\pipeline\trigger.cmd。想恢复自动或换个时间，见 tools/pipeline/README.md 第三节的重建命令。

• 新鲜度闸门：距上次成功不足 chainMinIntervalMs（默认 6 小时）时返回 skipped， 不再重复抓取与轮转备份；页面按钮走 force:true 跳过这个闸门。
• 通知并入状态页：结论文案（chain.report.notify，与退役的 notify.ps1 逐句相同）显示在页面上； 桌面气泡不再是必需环节。

「运行详情与诊断」折叠里还有：当前状态（路径、登录态文件年龄、上次抓取/同步结果）、知识库规模、 最近日志尾部、跑体检、以及运行我配置的同步脚本（编排半的入口，命令由配置决定）。

页面版式约定（2026-10-15 重排，别再退回那一版）

• 首屏只回答"现在正常吗、要动手点什么"；明细收进 <details>。
• 分区按任务分（收新对话 / 找内容 / 整理 / 诊断），不编号（以前的 ①–⑤ 既不携带信息，也说糊了哪块重要）。
• 界面里不出现内部术语：段 1 / 段 2 / 整链 / 阶段 3 / dry-run / 落盘 / dsh headless 都是开发者视角， 界面上说人话（抓取 / 整理 / 更新知识库 / 试运行 / 写入）。有两条测试钉着这条（test/locale.test.mjs 与 test/plugin.test.mjs 各一条），爬回来会当场失败。
• 同一个动作只有一个按钮：以前工具栏和卡片里各摆一个「拉取」「回填」，互相抢焦点。

路由	方法	作用
/__dsh-kb-sync/	GET	控制页（单文件 HTML，无外部请求）
/__dsh-kb-sync/status	GET	状态 JSON：路径、凭据文件年龄、进度文件末 8 行、最新日志尾部、抓取/回填/整理/更新进度
/__dsh-kb-sync/pipeline	POST	更新知识库（登录态→查新增→抓取→整理→体检）；{"apply":true} 写入并重建，{"force":true} 跳过新鲜度闸门
/__dsh-kb-sync/token	GET / POST	查 / 存 userToken（GET 只回「配没配」，永不回值）
/__dsh-kb-sync/token/clear	POST	清除已存的 userToken
/__dsh-kb-sync/pull	POST	增量拉取，同步返回本轮摘要
/__dsh-kb-sync/backfill	POST	启动全量回填，立即返回 202（进度看 /status）
/__dsh-kb-sync/kb	GET	知识库状态（条数 / 大小 / 最近一次拉取）
/__dsh-kb-sync/search?q=&role=	GET	检索；role=user 只看用户发言
/__dsh-kb-sync/conversation?id=	GET	取一个会话的完整 Markdown（超过 400 KB 截断并标注）
/__dsh-kb-sync/run	POST	启动你已有的同步命令；已在运行时返回 409
/__dsh-kb-sync/process	POST	整理（模型判断）；默认只校验（不写入），{"apply":true} 才写入并重建。进行中返回 409
/__dsh-kb-sync/doctor	POST	运行体检命令，返回 stdout / stderr / 退出码
/__dsh-kb-sync/log?name=	GET	读日志目录下某个文件的尾部（文件名白名单 + 越界拒绝）

安全模型

• 只监听环回：Host 必须是 127.0.0.1 / localhost / ::1（挡住 DNS rebinding）；Sec-Fetch-Site 非同源一律 403。
• 写操作要自定义头：POST 必须带 x-dsh-kb-sync: 1，跨站表单设不了自定义头。
• 日志读取白名单：^[A-Za-z0-9._-]{1,120}$，且解析后必须落在日志目录内。
• argv 全显式：cmd.exe /c <脚本>（POSIX 走 /bin/sh），不做字符串拼 shell。
• 凭据文件只 stat 不读：状态里只有「是否存在 / 修改时间 / 年龄天数」，正文永不进响应（有单测守着）。

能力披露（dsh-trust-check）

代码判定、可复现、零 token：

npx dsh-trust-check --dir /path/to/dsh-kb-sync --exit-code

dir: <path-to-this-repo>
1 plugin(s) · 1 red · 0 accepted · 0 review · 0 expected · 0 clear

dsh-kb-sync 0.1.0 — red                    (退出码 2 = 有红线)
  Stop by default; confirm the risk in Settings if you still want to keep it.
  why be careful:
    · Detected in code: reads credential values and has network access
    · May touch secrets or sensitive env vars
    · Execute system commands
  capabilities: shell, fs-write, fs-read, network (outbound), credentials, env
  destinations (literal):
    … + 2 allowlisted/loopback destination(s)
  secret touches:
    read: creds.resolve(
  injections: 1 item(s)
    client-inject: @deepseek-ai/dsh-client-locale, @deepseek-ai/dsh-client-ui-settings
  source: unpinned | git+https://github.com/<owner>/dsh-kb-sync.git
  evidence: 40 hit(s)

怎么读这份报告（这次是真有红线，别跳过）：

• 红线：读凭据值 + 有网络 —— 这是"自己拉取"那一块的必然结果：credentials.resolve('DEEPSEEK_WEB_TOKEN') 取出 token，再用 fetch 发给 chat.deepseek.com。 这条无法通过改代码消除（除非不做拉取）；能做的只有约束范围：token 只进 DSH 凭据服务、只在这一次请求里用、永不写进文件/日志/响应；拉取半的出网目标只有 chat.deepseek.com 一个域名（整理出网走宿主 llm 适配器，见 docs/CAPABILITY-DISCLOSURE.md 第一节）。
• fs-write：写知识库（conversations/*.md、conversations.jsonl、catalog.json），全部落在配置的知识库目录内，越界即拒（有单测）。整理另有写入（管线的 sync/out/ 与档案候选 JSON），清单见能力披露第一节。
• network (outbound)：命中来自 lib/deepseek.js 里那两个接口调用；外加控制页在浏览器里的同源 fetch。
• credentials / env：前者是上面那条红线；后者是可选的根目录环境变量。
• 按该工具的规则，红线默认应挡住；你要继续用就得在 设置 → 插件体检 里对该插件点"确认风险"（指纹随代码变化会失效，需要重新确认）。
• 未检出不等于安全：静态扫描看不到运行时行为。逐条核对与局限见 docs/CAPABILITY-DISCLOSURE.md。

已知限制

• 应用内只有一个设置分节：lib/client.js 在 设置 → dsh-kb-sync 注册一节（状态几行 + 「抓取新对话 / 更新知识库 / 刷新」），手写、无构建步骤；完整的控制页仍是独立 URL（那里才有检索、全文展开、分步表格）。装配契约已逐条对宿主实现核对（__ModuleLoader__.load 的 id 必须等于包名、exports["./client"] 的合法形式、settings.section 的注册字段、immediately 只是预取提示）——见 docs/CLIENT-HALF.md；整条安装链路（insert 行 → loader 说明符 → 包目录 → 两侧代码）见 docs/INSTALL-PATH.md。
• 客户端分节不做配置编辑（配置读的是插件启动时解析的那一份，改配置要重启；页面上能改反而会骗人）。
• 控制页与应用内分节都支持中英：控制页默认中文、?lang=en 或浏览器 Accept-Language 切换；设置分节跟随宿主界面语言。服务端的诊断文案（/status 的 message、更新知识库各步输出、流水线脚本自身的输出）仍是中文——它们是排错信息，翻译收益低、改动面大，暂不翻。
• 需要宿主提供 subprocess 服务；缺失时 /run、/doctor 会明确报错，而不是静默失败。
• 状态是轮询（运行中 3 秒一次），不是推送。
• 已在 Windows + DSH 0.2.0-rc.2 上实测：控制页、/status、/doctor、越界与跨站拒绝；POSIX 执行分支已写但未实测。
• 2026-10-12 晚：页面那几条路也在真机跑过了（读数取自 /status）—— 一键更新知识库 21:21:04→21:21:09（5 步全 ok）、/process 21:21:39（自动选中 deepseek-official / deepseek-flash）、全量回填 21:23:04→21:25:23 跑完（真实导出包 25.6 MB / 2549 条会话，0 新增、0 更新、2549 skipped、errors: []）、/run 的成功路径跑通（trigger.log 有 rc=0；页面按钮与双击走的是同一条 trigger.cmd）。

  读法：这几轮上游没有新内容（fetch 报"没有需要更新的内容 ✔"、整理 报"本轮条目 0"），所以它们证明的是管道通 + 幂等 + 跳过路径，而不是"一次产出新内容的运行"；真正写盘的那几轮看 data\kb\catalog.json（2556 条）与 data\import\knowledge\*.backup-* 的轮转。

• 拉取有两条路：日常用增量（列表接口 chat_session/fetch_page 实测：count 上限 100，超过报 ILLEGAL_COUNT；page/offset/page_num/seq_id/cursor 全被忽略、POST 405 —— 这条路翻不了页，2026-10-12 实测，所以增量只保证「往后每天长」）；要完整历史用全量回填（官方导出包）。回填的解析器已对着真实导出包实测：2446 条会话全部解析，最后一条是助手回复的占 2442/2446（若按时间戳找叶子，会有几百条停在提问上、丢掉最后一条回答——这正是导出包的已知坑）。
• userToken 会过期（数小时~数天）：过期后拉取报错，重新粘一次即可；它是你的账号凭据，不要外传。
• 默认不共用知识库目录：插件的库在它自己的 data/kb。只有你显式把 outDir 指到与别的脚本同一个目录，才会出现两边互相重写 catalog.json / conversations.jsonl 的情况（各自读-改-写）。
• 检索是直接扫 JSONL、不建索引（几千会话够快）；会话量再涨一个量级要换方案。

开发

npm test           # node --test：全部 91 个用例
                   #   插件路由/同源守卫/越界拒绝/argv 构造/凭据文件不读正文/时间口径/语言接线/整理（模型判断）路由端到端（30）
                   # + 客户端半部契约：加载 id、字典中英对齐、settings.section 注册、守卫头、与宿主装配规则逐条对齐（9）
                   # + 多语言：译文表完整、键对齐、占位符一致、英文页无未翻译中文、内联脚本可解析、界面无内部术语（9）
                   # + 整理产出的 JSON 修复与出件合并（15）+ 更新知识库的分步判定（9）
                   # + 文档一致性：本地链接、路由表、代码头部路由清单、披露文档动作名、安装命令、script 名、用例数、截图、类型接线、安装行一致性（11）
                   # + 随包卫生：每个随包 JS 过 node --check、.cmd 纯 ASCII、files 取反项在位、无安装期钩子、无备份文件、同目录引用都存在、插件传的标志被脚本承认、判成不依赖措辞（8）
npm run check      # 逐文件语法检查 lib/*.js（含 client.js / locale.js）+ 管线两个入口 + ESM import 冒烟
npm run check:types # tsc --noEmit：编译 lib/index.d.ts + types/usage.ts（需先 npm install，仅开发期）
npm run pack:check # npm pack --dry-run：看发布包内容
npm run preflight  # 发布前预检：测试 + 语法 + 类型 + 发布包内容 + 能力披露，一条命令给结论
node tools/make-screenshots.mjs   # 重新生成 README 里的截图（起假数据演示服务 + 无头 Chrome）

English summary

A DeepSeek Harness plugin with three capability blocks. Pull: it reads the DeepSeek web userToken from the DSH credential service, calls chat.deepseek.com, and normalizes conversations into a local knowledge base (markdown + JSONL + catalog) with in-plugin search. Orchestrate: it runs and monitors a sync/integrity command you already own. Segment 2: it runs the pipeline's judgement step in process through the host llm service — prepare the inputs, get one JSON judgement, validate it with the pipeline's own script, and only then write and rebuild. Static capability disclosure (dsh-trust-check): 1 red line — "reads credential values and has network access", which the pull half cannot avoid; the token never leaves the credential service for any file, log, or response, and the pull half's only outbound host is chat.deepseek.com.

完整英文说明见 README.en.md。

License

MIT