← 返回列表
✓ 可直接安装
DSH 插件：把 openwiki 的代码库知识库能力搬进 DeepSeek Harness —— 一键生成 / 阅读…
自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node >=20）；该结论来自程序自动检查，未经人工实机验证。 · 最近上游提交 2026/9/5 · 已提供中文文档
DSH 插件：把 openwiki 的代码库知识库能力搬进 DeepSeek Harness —— 一键生成 / 阅读 / 更新仓库 Wiki 与 Grounded Claims（溯源知识卡片），直接复用 DSH 已配置的模型，无需二次填 Key。
综合分
36.9
GitHub 分
36.9
用户评分
—
★ Stars
1
周下载量
—
兼容 / 相关生态插件（非 dsh 原生，请按其对应运行时安装）
git clone https://github.com/D2Moqi/dsh-openwiki.git数据截至 2026/9/18（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查✓ 自动检查通过
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-openwiki @ 2.0.5
✓Node 引擎要求 >=20 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 16:15:56
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/schemastery用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
简体中文 | English
dsh-openwiki
DSH 插件：把 openwiki 的代码库知识库能力搬进 DeepSeek Harness —— 一键生成 / 阅读 / 更新仓库 Wiki 与 Grounded Claims（溯源知识卡片），直接复用 DSH 已配置的模型，无需二次填 Key。
dsh-openwiki 是 DeepSeek Harness（Cordis 全插件架构）的 Web profile 包插件：Host 半部托管 openwiki CLI 运行时并驱动生成任务，Client 半部在 DSH 主界面提供知识库入口、浮动窗口、目录树、文档阅读等交互。核心思路是把 openwiki 当作增量生成引擎（命令行 + 磁盘产物契约），DSH 侧负责 UI、任务编排、模型桥接与触发器。
📑 目录
* 🚀 安装
* 🛠️ 开发与维护
* ✨ 功能一览
* 🧱 架构设计
* 🖼️ 特性巡礼
* 🧠 关键逻辑
* 📡 RPC API
* ⚠️ 已知限制
* 🧪 验证脚本
🚀 安装
前置依赖：Node ≥ 20、openwiki CLI（插件可自动安装）、DSH 已配置模型与凭证。
方式一：npm 包（推荐）
dsh plugin --profile web add dsh-openwiki
方式二：本地源码
1. 获取源码到本地任意目录（下文以 指代）
git clone
2. 构建产物（lib/ 与 client/）
cd
npm run build
3. 以本地目录方式安装到 DSH web profile
dsh plugin --profile web add
安装后配置（两种方式相同）
编辑 \profiles\web\cordis.patch.yml，追加：
- id: dsh-openwiki
name: 'dsh-openwiki'
重启 dsh web
说明：
* 本地目录方式安装时，dsh plugin add 会在 profile 的 node_modules 下建立指向 的链接（pnpm 目录安装默认行为），改源码 + npm run build 后重启 dsh web 即生效
* dsh.profile.bundles 需含 dsh-openwiki（dsh.client manifest：platform web，peerDependency schemastery）
🛠️ 开发与维护
目录结构
/
├── src/host/index.js # Host 权威源码（动态/包共用）
├── src/client/index.js # Client 权威源码
├── scripts/build-host.mjs # → lib/index.js（ESM 入口）
├── scripts/build-client.mjs # → client/client.js（ModuleLoader bundle）
├── lib/ client/ # 构建产物
├── tests/ # Playwright / 离线验证脚本 + screenshots/
└── package.json # dsh.client manifest（platform web）
面向 AI 的注意事项
* 构建脚本改写：build-host 把 harness.handle 换成 rpc.handle 并注入 webServer/settings；build-client 把 host.call 换成 rpc.call。新增 Host handler 用 harness.handle(...)，新增 Client 交互用 host.call(...)，构建自动适配
* readBytes 限制：fs.readBytes 超限会抛错（不是截断）——读文件头用 readText + slice
* manifest 缺失是常态：所有 wiki 读取都要走 disk-scan fallback（readWikiTree/readWikiOverview/readWikiClaims）
* shim EPERM：Windows 下不要 spawn .cmd，解析 shim 内脚本路径直接 spawn node
* not found 静默：可选状态文件缺失（.page-manifest.json/.run.json/.last-update.json）不要 console.error，否则轮询刷屏
* settings 命名空间：settings.register('openwiki', schema) 依赖 @deepseek-ai/schemastery，从 profile 动态 import 可能失败（settings namespace skipped）——不依赖它，用内存态 + localStorage
* client 服务注册表每次刷新重建：better-sidebar 注册必须自动重注册（autoRegisterSidebar），不能依赖用户点击
* openwiki 无 git 触发器：自动更新靠插件轮询 git rev-parse HEAD
* 非 git 仓库无法生成：startJob 前置校验已拦截并报明确错误
* Markdown 渲染：fence 检测必须 startsWith('
* 性能：空闲轮询只刷 jobs + overview（轻量），有运行任务才全量 refreshWorkspace；避免每 3s 全量磁盘扫描
✨ 功能一览
* 📚 知识库入口：DSH 主界面左下角「设置」上方「openwiki知识库」入口（可关闭，localStorage 持久化），点击打开可拖拽/可缩放的浮动窗口；另有「conversation.view」会话视图 Tab 与 better-sidebar 侧边页面两种嵌入形态。工作区列表每次打开知识库/点击「刷新」都实时重新拉取（新增工作区无需刷新页面）
知识库浮动窗口
* 🗂️ 三模式视图：Open Wiki（仓库 Wiki 文档树）、知识卡片（Grounded Claims 溯源抽点）与 知识库（personal 模式个人知识库）三个常驻 Tab，选中高亮；另有「忽略文件」「刷新」按钮；左栏宽度可拖动调整
左栏、三模式 Tab 与按钮行
* 🧠 知识库（personal 模式）：第三个 Tab「知识库」——上传本地文件（文本格式，含文件类型提示；新增/删除文件的行为说明见「生成知识库」按钮下方）生成个人知识库，输出到 /openwiki-kb/wiki（OPENWIKI_CONFIG_DIR 注入），树形阅读复用文档视图；模型凭据单点化：从 ~/.openwiki/.env 注入子进程，项目内不重复配置，openwiki-kb/ 一条 gitignore 排除全部 personal 产物
知识库（personal 模式）视图
* 📄 文档阅读：预览 / 代码双视图 + 目录分栏（点击「目录」在工具栏下方分出左侧目录面板，独立竖滚动条、sticky 不随正文滚动；点条目平滑滚动到对应标题）
文档阅读（预览 / 代码 / 目录分栏）
目录分栏面板
* 🗂️ 知识卡片：Grounded Claims 溯源抽点（statement + evidence），点「知识卡片」Tab 查看
知识卡片视图
* 🔗 应用内链接导航：md 内链（含 /openwiki/... 绝对路径）点击后在应用内跳转，绝不把浏览器带走到 file://；目录链接（尾 /）进入文件夹浏览
* ⚡ 生成任务：生成 / 重新生成（增量更新）/ 取消，实时进度（已完成 X/Y (Z%)，处理中: N，失败: M），断点续跑依赖 openwiki 的 .run.json；非 git 仓库明确报错
* 📊 生成状态卡：右侧展示文件数 / 成功 / 失败 / 更新时间 / 文档位置（openwiki/）与「重新生成」按钮
* 🔌 模型复用：读取 DSH 默认模型（agentDefaultModel）与凭证，映射为 openwiki 的 provider 配置写入 ~/.openwiki/.env（openai-compatible / anthropic / gemini / openrouter）
* 🖥️ 运行时托管：自动检测 openwiki CLI（解析 npm shim）、版本检查（registry）、安装 / 升级 / 自检（--help）
* 🔔 自动更新：轮询各工作区 git HEAD，检测到新提交自动跑增量更新（openwiki 无原生 git 触发器，由插件补上）；安装后默认对所有工作区开启——开关在知识库面板左栏「刷新」旁（仅 Open Wiki Tab 显示，知识卡片/知识库不涉及），按工作区独立，手动关闭某个工作区后不会自动重开
* 🧩 better-sidebar 集成：检测到 dsh-better-sidebar 服务即自动注册一个侧边页面（刷新后自动重注册，等效持久化）；未安装时设置页给出安装指引
* 🛡️ 忽略文件：.openwikiignore（gitignore 语法）图形化编辑保存
* ⚙️ 设置页：运行时 / 模型 / better-sidebar 注册 / 入口显隐（自动更新开关已移至知识库面板，按工作区独立）
openwiki 设置页
🔌 核心理念：openwiki 是 CLI 引擎，DSH 是宿主。一切状态（openwiki/ 目录下的 .page-manifest.json / .run.json / .last-update.json / .claims/）都是磁盘契约，插件只做读取 + 展示 + 触发，不干预生成算法本身。
🧱 架构设计
双半结构（Host / Client）
Cordis 插件分两半，各自有权威源码，构建脚本生成包产物：
| 半部 | 权威源码 | 构建产物 | 职责 |
| ------ | --------------------- | ------------------------------------------- | ----------------------------------------------------------- |
| Host | src/host/index.js | lib/index.js（ESM 入口） | openwiki 运行时托管、模型桥接、生成任务、wiki/claims 磁盘读取、忽略文件、自动更新、RPC 服务端 |
| Client | src/client/index.js | client/client.js（Web ModuleLoader bundle） | 全部 UI：入口、浮动窗口、目录树、文档渲染、设置页、better-sidebar 注册 |
构建脚本（scripts/build-host.mjs / build-client.mjs）把源码中的自由标识符改写为包形态：
* Host：harness.handle( → rpc.handle(；lib/index.js 注入 webServer/settings 硬依赖并注册 /dsh-openwiki/rpc 同源 JSON-RPC 路由
* Client：host.call( → rpc.call(（fetch('/dsh-openwiki/rpc', { headers: {'x-dsh-openwiki':'1'} })）；styles.insert → 本地 注入
开发期还可用「插件开发模式」的 cordis\_define/run 把 src/ 当动态插件直接跑，两种形态共用同一份源码。
通信桥（Client ↔ Host RPC）
Client bundle ──fetch──▶ /dsh-openwiki/rpc (webServer, kind: exact)
├─ 请求头 x-dsh-openwiki: 1（防 CSRF，跨站无法自设）
├─ body: { method, args }
└─ 响应: JSON（handler 返回值或 { ok:false, error }）
Host 侧 handlers Map 注册 20+ 方法（见「📡 RPC API」），全部 fiber 绑定（ctx.effect 自动回收）。
客户端状态管理（closure store）
Client 用轻量订阅 store（createKbStore，非 Redux）承载全部 UI 状态，各 Slot 组件通过 useKb() 订阅：
state = {
open, runtime, model, busy, action, lastOutput,
workspaces[], selected, overview, tree, page, claims, jobs[],
tab ('wiki'|'cards'), search, tabs[] (文档多 Tab), activeTab,
browseDir, docView, tocOpen, showIgnore, ignoreContent, error,
win {x,y,w,h,max} ← 浮动窗口几何
expandedDirs {} ← 目录树折叠状态
sidebar, sidebarRegistered, showEntry,
autoUpdate {enabled}
}
Slot 注册清单（Client）
| Slot | id | 说明 |
| ----------------------- | -------------------- | ------------------------------------------- |
| sidebar.footer.action | openwiki（order 10） | 左下角「设置」上方入口（showEntry=false 时隐藏） |
| shell.overlay | openwiki-kb | 浮动窗口宿主（.owk-win，可拖拽/缩放/最大化） |
| conversation.view | openwiki（order 20） | 会话区域的知识库视图 Tab |
| settings.section | openwiki（order 30） | 设置页：运行时 / 模型 / better-sidebar / 入口显示（自动更新开关在知识库面板） |
🖼️ 特性巡礼
浮动窗口（shell.overlay）
知识库不是全屏层而是可拖拽/可缩放窗口，便于边看文档边对话：
* 几何存于 kb.win {x,y,w,h,max}；header onMouseDown 起拖动（document mousemove/mouseup 跟随），右下角 .owk-win-resize 手柄缩放（东南角锚定），□/▣ 最大化
* 视口 clamp：拖动/缩放都经 clampWin(x,y,w,h)——窗口顶/左边永远 >= 0，尺寸 clamp 360..vw × 240..vh，超视口时收缩。避免标题栏被拖出浏览器顶部导致窗口不可抓回
* 窗口 z-index 99999，CSS 见 .owk-win
关闭按钮放标题旁（避开 better-sidebar 右上角 rail 的遮挡）
双模式 Tab 与按钮布局
* 左栏第一行：Open Wiki / 知识卡片 常驻 Tab（.owk-tab.sel 高亮，无 emoji）
* 左栏第二行：忽略文件 / 刷新
* 左栏宽度可拖：.owk-kb-resizer 分隔条（col-resize 光标），拖动更新 kb.leftWidth（clamp 220–520px，状态存内存）
* 搜索框 placeholder「🔍 搜索 Open Wiki」，对树做前缀父目录冒泡过滤（filterPages）
可折叠目录树
* buildTree(pages) 把相对路径构造成 {path, dirs{}, pages[]} 树，目录节点带稳定 path key
* expandedDirs {} 记录折叠态，toggleDir 切换；expandAllDirs 在树加载时默认全展开
* 排序：页面 index/quickstart（根级）权重最优先渲染在目录之前，其余按 title 字母序
* 点击文档 → openPage(path)（保留 .md 后缀，host 侧对无后缀输入有兜底）；点击目录 → browseDirectory 在右侧列出该目录文件
文档阅读与目录分栏
* 视图切换顺序 目录 / 预览 / 代码；「目录」toggle tocOpen，在工具栏下方分栏：左侧 .owk-toc-pane 目录面板（overflow-y: auto 独立竖滚动条 + position: sticky 不随正文滚动，max-height: calc(100vh - 240px)），右侧 .owk-doc-main 为正文
* 点目录条目 → goToHeading(i)：切回预览、setTimeout 后 scrollIntoView('owk-h-i')（锚点由 renderMarkdown 按 h2-h4 顺序编号），面板保持打开可连续跳转
* 代码视图原样展示 Markdown 源文
应用内链接导航
md 渲染（renderInline）把内部链接渲染为 .owk-wiki-link（onClick + preventDefault 拦截）：
href 判定:
http(s)/mailto/… → 新窗口
尾 "/" 或 /openwiki/xxx/ → browseDirectory（文件夹浏览）
其它 → openWikiLink(href)
├─ 剥离 /openwiki/ 前缀（与 host 树读取同一约定）
├─ 绝对路径不拼当前页目录；相对路径拼当前页目录
└─ 归一化 ./ ../ → openPage(目标)
生成任务（Host JobDriver）
startJob({workspaceId, mode, language})：
1. 前置校验：workspace 存在、无并发任务、readGitHead 非空（非 git 仓库直接报错）、模型桥接就绪（写 .env）、CLI 可解析
2. subprocess.spawn(openwiki --init|--update -p -l )，cwd=工作区路径
3. 每 2s 轮询 openwiki/.run.json（readRunState）更新 phase/total/done/pending/failed；结束读 .last-update.json
4. 完成后 120s 延迟从 jobs Map 清理；client 每 3s refreshJobs 拉状态
5. Client 检测到 error 状态的 job → 写 kb.error（醒目红字提示，避免"生成中很快消失无提示"）
Wiki 读取（manifest 缺失 fallback）
openwiki 正常产出 .page-manifest.json，但边缘场景（init 中途 finalize）该文件缺失——此时所有读取走递归磁盘扫描：
| 数据 | manifest 缺失时的来源 |
| ------------------ | ------------------------------------------------------------- |
| readWikiTree | 递归扫 openwiki/ 下 .md，逐文件读 frontmatter title |
| readWikiOverview | 递归计数 .md 得 pageCount/successCount；failedCount 取最近 run |
| readWikiClaims | 扫 openwiki/.claims/.json（与 manifest 页面清单对应） |
模型桥接（M2 核心）
buildOpenWikiEnv()：
agentDefaultModel.currentSelection() → {provider, model}
├─ deepseek-official/deepseek → openai-compatible + DEEPSEEK_API_KEY
└─ pi-ai providers[provider] → 按 api 字段映射 anthropic/gemini/openrouter/openai-compatible
credentials.resolve(apiKeyEnv) → 真实 Key（source: env/credentials.yaml/user-env）
applyEnvUpdates() → 写 ~/.openwiki/.env（只更新 MANAGED_ENV_KEYS，保留其它键）
自动更新（git HEAD 轮询）
openwiki 没有 git 提交触发（无 hook/无文件监听，仅自带每日 CI cron 工作流）；DSH 也没有 git 钩子服务。插件自实现：
Host startAutoUpdate(workspaceId)：每 15s readGitHead（git rev-parse --verify HEAD），与上次比较；变化即 startJob({mode:'update'})（增量：openwiki 按 lastUpdate.gitHead 与 git diff 只重生成变更页）
* 开关在知识库面板左栏「刷新」旁（仅 Open Wiki Tab 显示），openwiki/autoupdate/set|status RPC（status 支持按 workspaceId 查询单个工作区状态）
* 0.2.1 起按工作区独立：每个工作区有独立开关/轮询/上次 HEAD（autoUpdates Map）；关闭某工作区（userDisabled）不影响其他工作区，也不会被默认行为自动重开；无参 status 返回全部工作区状态；状态为进程内存态，重启 DSH 后重新进入即恢复默认开启（手动关闭过的除外）
better-sidebar 自动注册
ctx.get('betterSidebar') 是 better-sidebar 插件提供的客户端 Cordis 服务（registerTab/getTabs/…）：
* 自动注册：apply 尾部 timer.interval(400ms, ≤12 次) 轮询服务出现，出现即 registerTab({id:'openwiki', title, icon, order:50, single:true, component: SidebarKbView})
* 客户端服务注册表每次页面加载重建，所以刷新后自动重注册 = “持久化”；设置页手动按钮保留（幂等，注册后显示「已注册侧边页」）
* 未检测到时设置页给出安装指引与仓库地址
🧠 关键逻辑
Host 端（src/host/index.js）
| 区域 | 行号（约） | 说明 |
| ----------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------ |
| readText | 24 | 统一读文件；not found 静默返回 null（可选状态文件缺失是常态，避免刷屏） |
| resolveCli | 47 | 解析 openwiki 可执行：Windows npm shim 里解析 node "%~dp0\...\cli.js" 直接 spawn node（spawn .cmd 会 EPERM） |
| resolveNpm / readVersion / readLatest | 105 / 137 / 152 | npm 解析、版本读取、registry 最新版（失败只记一次） |
| runtimeStatus / install / update / ensure / probe | 217–272 | 运行时状态、npm 安装/升级、惰性确保、--help 自检 |
| buildOpenWikiEnv / applyEnvUpdates / readOpenWikiEnvStatus | 331 / 426 / 453 | 模型桥接三件套 |
| readGitHead / startAutoUpdate / stopAutoUpdate | 484 / 500 / 492 | 自动更新守护 |
| startJob / killJob / jobStatus | 569 / 684 / 697 | 生成任务驱动 |
| readWikiTree / readWikiPage / readWikiOverview / readWikiClaims | 751 / 899 / 928 / 1008 | 磁盘读取（含 fallback） |
| readIgnore / saveIgnore | 1063 / 1072 | .openwikiignore |
| workspaceOf / readRunState / readLastUpdate | 525 / 535 / 558 | workspace 解析、.run.json 进度、.last-update.json |
安全约定：readWikiPage 对路径做 replace(/^\/+/,'').replace(/\.\./g,'') 防穿越；saveIgnore 限工作区路径。
Client 端（src/client/index.js）
| 区域 | 行号（约） | 说明 |
| -------------------------------------------------- | --------------- | --------------------- |
| createKbStore / useKb | 14 / 72 | 订阅式状态 store |
| openPage / browseDirectory / closeTab | 231 / 254 / 262 | 文档 Tab、文件夹浏览、关闭 |
| startJob / killJob | 281 / 294 | 任务触发（含 git 校验错误透传） |
| openWikiLink / renderInline / renderMarkdown | 341 / 379 / 424 | 轻量 Markdown 渲染 + 内链导航 |
| buildTree / expandAllDirs / renderTree | 558 / 578 / 592 | 目录树（折叠、index 置顶） |
| renderDoc / renderKb | 676 / 778 | 文档区（目录分栏）/ 知识库主面板 |
| registerSidebarTab / autoRegisterSidebar | 1009 / 1037 | better-sidebar 注册 |
| toggleShowEntry / SidebarKbView | 975 / 983 | 入口显隐 / 侧边页视图 |
Markdown 渲染注意（维护必读）：renderMarkdown 的 fenced code block 检测必须是 line.startsWith('')（曾用 /^(\S)\s$/，对 ts type-equiv 这类带空格语言串匹配失败，行落入 paragraph 分支又被 !/^/ 排除 → i 永不前进 → 无限循环卡死，已在 M6.1 修复）。
📡 RPC API
全部 POST /dsh-openwiki/rpc，需 x-dsh-openwiki: 1 头。Client 的 call(method, args) 封装。
| 方法 | 参数 | 返回要点 | | | |
| ----------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | :----- | :----- | :------------------------------------- |
| openwiki/runtime/status | — | {installed, version, latestVersion, hasUpdate, exePath, scriptPath, error} | | | |
| openwiki/runtime/install / update / probe | — | \{ok, version | from | to | output}；probe 返回 --help\ 前 600 字符 |
| openwiki/runtime/ensure / checkUpdate | — | 惰性确保 / 版本对比 | | | |
| openwiki/model/status | — | {selection, owProvider, apiKeyEnv, keyConfigured, keySource, envExists, envProvider, envModel, warnings} | | | |
| openwiki/model/sync | — | 执行 .env 写入 | | | |
| openwiki/model/env | — | 已管理 env 键值（密钥掩码） | | | |
| openwiki/workspaces | — | {workspaces:[{id,path,title}]}（workspaceRegistry） | | | |
| openwiki/job/start | {workspaceId, mode('init'\|'update'), language} | {ok, jobId}；非 git 仓库报明确错误 | | | |
| openwiki/job/kill | {workspaceId} | {ok} | | | |
| openwiki/job/status | — | {jobs:[{jobId, workspaceId, status, phase, total, done, failed, message}]} | | | |
| openwiki/wiki/tree | {workspaceId} | {pages:[{path,title,status}], inProgress[], scanError} | | | |
| openwiki/wiki/page | {workspaceId, path} | {content, frontmatter}（无 .md 输入有兜底） | | | |
| openwiki/wiki/overview | {workspaceId} | {pageCount, successCount, failedCount, wikiDirRelative, runActive, runPhase, runProgress, lastUpdate} | | | |
| openwiki/wiki/claims | {workspaceId} | {claims:[{id,statement,evidenceCount,firstEvidence,page}]} | | | |
| openwiki/ignore/get / save | {workspaceId, content?} | 忽略文件读写 | | | |
| openwiki/autoupdate/set / status | {workspaceId, enabled?} | 按工作区自动更新开关 / 状态（status 带 workspaceId 查单工作区，无参返回全部） | | | |
| openwiki/logs/tail | — | 占位（当前返回空） | | | |
| openwiki/kb/config / config/save | {workspaceId, prompt?} | personal 目录约定（configDirName/sourceRel/wikiDir/sourceDir）+ 可配置生成提示词 | | | |
| openwiki/kb/import / files / delete | {workspaceId, files?\|path?} | 上传文件到 openwiki-kb/source/files（路径穿越防护）/ 递归列表 / 删除 | | | |
| openwiki/kb/tree / page / overview | {workspaceId, path?} | personal 模式知识库树 / 页面 / 状态（openwiki-kb/wiki 为根，.last-update.json 在其下） | | | |
⚠️ 已知限制
| 项 | 说明 |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| settings 命名空间持久化 | openwiki 命名空间注册依赖 schemastery，从 profile node\_modules 动态 import 可能失败；当前实际配置走内存态 + localStorage，核心功能不受影响 |
| latestVersion | 无可用 web provider 时 readLatest 返回 null（只记一次日志），"最新版本"提示为空 |
| Markdown 渲染 | 轻量实现（标题/代码块/表格/列表/引用/行内样式），Mermaid 围栏按代码块展示，不做完整 Markdown 方言 |
| personal 模式 | ✅ 已支持（openwiki/kb/ + job/start {kind:'personal'}）：输出 /openwiki-kb/wiki（OPENWIKI_CONFIG_DIR 注入）；personal 模式无 .run.json 断点/无逐页进度；知识卡（Grounded Claims）仍为 code（仓库）模式专属 |
| 自动更新粒度 | HEAD 轮询间隔 15s，非即时；检测到新提交才触发增量更新 |
| openwiki/logs/tail | 占位实现（返回空），后续可接 openwiki 运行日志 |
**
🧪 验证脚本
| 脚本 | 覆盖 |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| tests/verify-host-entry.mjs | Host 入口离线测试（name/inject/RPC 路由/鉴权/分发） |
| tests/redesign-verify.mjs | M4：浮动窗口/双 Tab/折叠树/内链跳转/设置页（23 项） |
| tests/link-nav-verify.mjs | 内链跳转专项 |
| tests/sidebar-reg-verify.mjs | better-sidebar 手动注册专项 |
| tests/autoreg-verify.mjs | 自动注册 + 刷新持久化专项 |
| tests/round2-verify.mjs | M5：按钮改名/排序/右侧状态卡/文件夹浏览/自动更新卡（16 项） |
| tests/round3-verify.mjs | M6：目录分栏/按钮两行/trae 生成错误（11 项） |
| tests/fixverify.mjs | 状态误判/左侧路径/渲染回归 |
| tests/verify-scan.mjs / verify-claims-scan.mjs / verify-frontmatter.mjs / verify-reader.mjs / verify-final.mjs | 离线解析验证 |
| tests/verify-kb-host.mjs | 知识库（personal）host 半部：目录约定/导入（穿越防护、二进制）/文件管理/personal job env 注入与 argv/来源 RPC 已移除断言 |
Playwright 用法：$env:DSH_GUI_BASE='http://127.0.0.1:3081'; node tests/.mjs（headless Chrome + playwright-core，createRequire('C:/nvm4w/nodejs/package.json')）。
本文档基于插件开发过程整理，供后续维护与 AI 开发使用；接口契约以源码与 Cordis Inspect Provider 实时查询为准。扫码进群