dsh-kb-sync
中文 ｜ English ｜ 使用说明 ｜ 更新日志
DeepSeek Harness 插件：把你自己已有的同步流水线搬到一个同源控制页——一键运行、看状态、看日志、跑完整性体检。
典型的流水线是「网页端对话历史 → 本地知识库」，但插件本身不关心你同步什么。
定位：一个插件，三块能力。
① 自己拉取：用你存在 DSH 凭据服务里的网页端 userToken 调 chat.deepseek.com，把对话规范化落到本地知识库，并在插件内检索 —— 这一块读凭据值、会出网（见下方能力披露，dsh-trust-check 判为红线）。
② 编排：起你已有的同步/体检命令、读状态与日志 —— 这一块不读凭据、不出网。
③ 整理（模型判断）：把管线里「让模型做判断」那一步搬进进程内（准备输入 → 调宿主 llm 服务拿一份 JSON → 校验通过才落盘/重建）—— 不读凭据；出网走宿主 llm 适配器，域名由你配的提供方决定，插件自己不写死。
三块都不注入提示词、都不改核心 bundle、都没有安装脚本（逐项对照见 docs/CAPABILITY-DISCLOSURE.md 第一节）。
dsh-kb-sync 用法与边界：浏览器 → 插件路由 → 你的同步命令 → 状态文件与你的产物
控制页首屏
另外三张（整页的分步表格、检索命中、英文界面）在 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 全被忽略、 405 —— ，2026-10-12 实测，所以增量只保证「往后每天长」）；要用（官方导出包）。回填的解析器已对着真实导出包实测：2446 条会话全部解析，最后一条是助手回复的占 （若按时间戳找叶子，会有几百条停在提问上、丢掉最后一条回答——这正是导出包的已知坑）。
开发
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
