前言¶
DeepSeek Harness (DSH) 采用插件化架构。开发者需要管理代码库知识，复用已配置的模型。dsh-openwiki 是一个 DSH 插件，由 D2Moqi 维护。它将 openwiki 的代码库知识库能力搬进 DeepSeek Harness，一键生成 / 阅读 / 更新仓库 Wiki 与 Grounded Claims，直接复用 DSH 已配置的模型，无需二次填 Key。
核心功能¶
插件在 DSH 主界面提供知识库入口、浮动窗口、目录树、文档阅读等交互。
- 知识库入口：DSH 主界面左下角「设置」上方「openwiki知识库」入口（可关闭，
localStorage持久化）。 - 三模式视图：Open Wiki（仓库 Wiki 文档树）、知识卡片（Grounded Claims 溯源抽点）与知识库（personal 模式个人知识库）三个常驻 Tab。
- 文档阅读：预览 / 代码双视图，目录分栏（点击「目录」在工具栏下方分出左侧目录面板，独立竖滚动条、sticky 不随正文滚动）。
- 知识卡片：Grounded Claims 溯源抽点（statement + evidence）。
- 生成任务：实时进度（已完成 X/Y (Z%)，处理中: N，失败: M），断点续跑依赖 openwiki 的
.run.json。 - 模型复用：读取 DSH 默认模型（
agentDefaultModel）与凭证，映射为 openwiki 的 provider 配置写入~/.openwiki/.env。 - 运行时托管：自动检测 openwiki CLI（解析 npm shim）、版本检查（registry）、安装 / 升级 / 自检（
--help）。 - 自动更新：轮询各工作区 git HEAD，检测到新提交自动跑增量更新（openwiki 无原生 git 触发器，由插件补上）。
- better-sidebar 集成：检测到
dsh-better-sidebar服务即自动注册一个侧边页面。 - 忽略文件：
.openwikiignore（gitignore 语法）图形化编辑保存。 - 设置页：运行时 / 模型 / better-sidebar 注册 / 入口显隐。
安装与启用¶
前置依赖：Node ≥ 20、openwiki CLI（插件可自动安装）。
安装命令：
dsh plugin --profile web add dsh-openwiki
安装后配置：
# 编辑 <你的 DSH 用户目录>\profiles\web\cordis.patch.yml，追加：
- id: dsh-openwiki
name: 'dsh-openwiki'
典型用法¶
- 生成：点击刷新或重新生成按钮。
- 查看：点击知识库入口，使用 Tab 切换模式。
注意事项¶
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
fs.readBytes超限会抛错（不是截断）。- manifest 缺失时需走 disk-scan fallback。
- Windows 下不要 spawn
.cmd。 settings namespace依赖@deepseek-ai/schemastery，从 profile 动态 import 可能失败。- client 服务注册表每次刷新重建。
- openwiki 无 git 触发器，由插件补上。
- 非 git 仓库无法生成。
- Markdown fence 检测需
startsWith('```')。 - 性能：空闲轮询只刷 jobs + overview，有任务才全量 refreshWorkspace。
总结¶
该插件把 openwiki 当作增量生成引擎，DSH 侧负责 UI、任务编排、模型桥接与触发器。适合需要在 DSH 内直接管理代码库知识、复用模型配置的开发者。更多信息见 catalog_url 或 github_url。
