前言¶
在 DeepSeek Harness（DSH）里做项目时，需求、设计、规范往往散在工作区的 Markdown、Office 与 PDF 里。模型每次任务都要重新读原文、重新归纳，既慢又容易漏上下文。社区插件 dsh-knowledge-center（维护者 lightporta）把这类文档一次性交给 Harness 默认模型提炼为结构化 Markdown 笔记，集中存放在本机知识库；界面侧栏与 Settings 里可以像 VS Code 一样预览与编辑，并在显式授权的工作区里，通过 agent 工具检索与引用。插件 MIT 许可，无第三方运行时依赖，当前版本 v1.8.4（2026-10-26）。
这是什么¶
dsh-knowledge-center 是 DSH 的「记忆」类插件：扫描工作区文档 → 生成可复用的知识 Markdown → 本地管理与渲染 → 授权工作区内的模型通过工具访问。交互思路参考 Qoder CN 知识中心等产品的工作流，README 明确说明这是独立社区实现，与 Qoder、阿里或 DeepSeek 源码无隶属关系。
数据落在 Harness 用户级目录 $DSH_HOME/knowledge-center/（macOS/Linux 常见为 ~/.dsh/knowledge-center/），条目为带 YAML front matter 的 .md 文件，可单独阅读或纳入版本管理。
核心功能¶
双入口与三个页签¶
- 左侧栏知识图标：打开整页「知识中心」面板（Qoder 风格）。
- Settings → 知识中心：同一套 UI；Settings 左侧导航图标受 Harness 硬编码限制，第三方分区会显示为齿轮，日常更推荐侧栏入口。
三个页签分别对应：知识库（多库、搜索、渲染/源码、编辑、导出）、生成知识（扫描 → 勾选 → 逐篇提炼）、权限与设置（按工作区开关模型调用、语言、数据目录等）。
从工作区提炼知识¶
- 支持 Markdown / TXT / CSV / HTML / JSON、现代 Office（
.docx/.xlsx/.pptx）、PDF，以及经 Harnessoffice-to-pdf转换的旧版.doc/.xls/.ppt（详见 README 与docs/EXTRACTION.md）。 - 逐篇调用 Settings → 模型 中的默认模型（
agentDefaultModel），输出含标题、摘要、核心要点、详细内容、适用场景、来源等结构。 - 长文自动分段再合并（最多 16 段，单篇约 192k 字符预算）；同一「工作区 + 来源相对路径」重复生成会更新原条目。
- 支持用户库、工作区库与 owner 授权的共享库；模型工具只能写入当前工作区库，共享与撤销由 owner 在 UI 完成。
类 VS Code 的 Markdown 渲染¶
预览采用 14px 正文、h1/h2 底边线、代码块与表格等样式，配色跟随 Harness 主题令牌（--dsw-alias-*），明暗主题自适应。
模型工具与权限¶
默认所有工作区均未授权；未授权时工具会明确拒绝，且 README 要求模型「被拒绝时不要重试、不要绕过」。授权后可用的工具：
| 工具 | 用途 |
|---|---|
knowledge_search |
按关键词检索条目（可限定知识库） |
knowledge_read |
读取一篇完整知识 Markdown |
knowledge_ingest |
在用户明确要求时，将工作区文档提炼入库（每次最多 3 个路径） |
knowledge_ingest_attachment |
提炼当前会话附件（每次最多 3 个，仅写当前工作区库） |
Host 侧 RPC 仅本机 owner 可调用；插件以当前 DSH 进程权限运行，安装前宜自行审阅 源码 与 MIT 许可证。
环境要求¶
| 项目 | 要求 |
|---|---|
| DeepSeek Harness | ≥ 0.2.1-rc.3 |
| Node.js | ≥ 20.3.0（由 Harness Host 提供） |
| 模型 | 已在 Harness 中配置默认模型 |
PDF 文本优先使用系统可解析的 pdftotext（可用环境变量 PDFTOTEXT_PATH 指定路径）；旧版 Office 依赖 profile 中的 office-to-pdf 服务。
安装与启用¶
官方 README 推荐通过 Harness Plugin Manager 安装本地 bundle（由 profile 完成安装与启用），而不是凭插件名拼接远程安装命令。
-
将仓库放到本机任意目录（例如从 GitHub 获取源码包或你已有的副本路径）。
-
在 Harness 会话中安装本地 bundle。具备权限时可调用
plugin_manager工具：
{ "action": "install_bundle", "target": "/absolute/path/to/dsh-knowledge-center" }
也可按 README 说明使用 plugin_manager 的 install_bundle，目标为插件目录的绝对路径。
- 安装后 Settings 左侧应出现「知识中心」；若未出现，刷新 Harness 页面。Host 侧代码更新需重启 Harness；仅
client.js改动通常刷新即可。
卸载：在 Plugin Manager 移除 dsh-knowledge-center bundle；知识数据不会自动删除，彻底清理需自行删除 $DSH_HOME/knowledge-center/。
典型用法¶
- 点击侧栏知识图标（或打开 Settings → 知识中心）。
- 在「生成知识」中选择工作区 →「扫描文档」→ 勾选文件 → 选择目标知识库与语言（简体中文 / English）→「生成知识」。
- 在「知识库」页签查看渲染结果，必要时编辑、复制或下载。
- 在「权限与设置」中为需要使用知识的工作区打开「允许模型调用」。
- 在该工作区会话中向模型说明意图，例如：
请先检索知识中心里关于发布流程的笔记，再按其中的清单检查这次改动。
模型会先 knowledge_search，再用 knowledge_read 读取全文并作答。
适用场景与注意¶
适合：文档多、规范重复引用、希望 agent 在授权工作区内稳定检索「已提炼笔记」而非每次重读原始 PDF/Word 的团队或个人。
注意：
- 文本类文件上限 10 MiB，二进制文档 25 MiB；提取与提炼有字符预算，超大文件可能在 front matter 标记
truncated: true。 - PDF 仅提取文本层；扫描件、嵌入图片内文字不在范围（需 OCR）。
- 索引损坏时插件会尝试从
index.json.bak恢复，并可能暂时关闭全部工作区授权；重要数据应备份整个knowledge-center目录。 - DSH 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装第三方插件前请核对来源与权限边界。
结尾¶
dsh-knowledge-center 把「读文档 → 记笔记 → agent 复用」收进 DSH 一条链路：本地 Markdown 知识库、VS Code 式预览，以及四套受工作区授权约束的检索与提炼工具。进一步了解与下载：
