前言¶

在 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 文件，可单独阅读或纳入版本管理。

核心功能¶

双入口与三个页签¶

1. 左侧栏知识图标：打开整页「知识中心」面板（Qoder 风格）。
2. Settings → 知识中心：同一套 UI；Settings 左侧导航图标受 Harness 硬编码限制，第三方分区会显示为齿轮，日常更推荐侧栏入口。

三个页签分别对应：知识库（多库、搜索、渲染/源码、编辑、导出）、生成知识（扫描 → 勾选 → 逐篇提炼）、权限与设置（按工作区开关模型调用、语言、数据目录等）。

从工作区提炼知识¶

• 支持 Markdown / TXT / CSV / HTML / JSON、现代 Office（.docx / .xlsx / .pptx）、PDF，以及经 Harness office-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 要求模型「被拒绝时不要重试、不要绕过」。授权后可用的工具：

Host 侧 RPC 仅本机 owner 可调用；插件以当前 DSH 进程权限运行，安装前宜自行审阅 源码 与 MIT 许可证。

环境要求¶

PDF 文本优先使用系统可解析的 pdftotext（可用环境变量 PDFTOTEXT_PATH 指定路径）；旧版 Office 依赖 profile 中的 office-to-pdf 服务。

安装与启用¶

官方 README 推荐通过 Harness Plugin Manager 安装本地 bundle（由 profile 完成安装与启用），而不是凭插件名拼接远程安装命令。

1. 将仓库放到本机任意目录（例如从 GitHub 获取源码包或你已有的副本路径）。

2. 在 Harness 会话中安装本地 bundle。具备权限时可调用 plugin_manager 工具：

{ "action": "install_bundle", "target": "/absolute/path/to/dsh-knowledge-center" }

也可按 README 说明使用 plugin_manager 的 install_bundle，目标为插件目录的绝对路径。

3. 安装后 Settings 左侧应出现「知识中心」；若未出现，刷新 Harness 页面。Host 侧代码更新需重启 Harness；仅 client.js 改动通常刷新即可。

卸载：在 Plugin Manager 移除 dsh-knowledge-center bundle；知识数据不会自动删除，彻底清理需自行删除 $DSH_HOME/knowledge-center/。

典型用法¶

1. 点击侧栏知识图标（或打开 Settings → 知识中心）。
2. 在「生成知识」中选择工作区 →「扫描文档」→ 勾选文件 → 选择目标知识库与语言（简体中文 / English）→「生成知识」。
3. 在「知识库」页签查看渲染结果，必要时编辑、复制或下载。
4. 在「权限与设置」中为需要使用知识的工作区打开「允许模型调用」。
5. 在该工作区会话中向模型说明意图，例如：

请先检索知识中心里关于发布流程的笔记，再按其中的清单检查这次改动。

模型会先 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 式预览，以及四套受工作区授权约束的检索与提炼工具。进一步了解与下载：

• 目录页：https://www.skillhub.cn/plugins/lightporta/dsh-knowledge-center
• 源码与文档：https://github.com/lightporta/dsh-knowledge-center