前言¶
在 DeepSeek Harness（DSH）里做智能体或日常脚本时，笔记往往散落在 Obsidian Vault、Notion 页面、飞书文档，待办又在滴答清单。各自打开应用查统计、搜标题、对任务，和在同一侧边栏里看总览、预览 Markdown、深链回源相比，切换成本更高。下面介绍社区插件 dsh-knowledge-board（仓库 PowehiG/dsh-knowledge-board）：把上述来源接到同一块 Web 看板，并提供 Host 侧 Agent 工具 knowledge_board 只读查询。
这是什么¶
dsh-knowledge-board 由维护者 PowehiG 发布，分类为客户端插件。形态是 Host 数据连接器加 DSH Web 侧边栏面板「知识看板」，无第三方运行时依赖；界面主题跟随 DSH 深色或浅色。未配置的来源用演示数据兜底，便于先熟悉布局再填 Token。
- 插件包名：
dsh-knowledge-board - 当前版本（package.json）：
1.0.0 - 许可证：MIT
核心功能¶
总览与文档库¶
总览侧展示文档总数、总字数、本周更新、待办，以及 12 周趋势、来源分布、最近更新、今日焦点、标签分布。文档库支持跨来源搜索、筛选、排序；行内可预览 Markdown，或通过深链打开原应用。
知识地图与待办¶
知识地图提供来源卡（路径、数量、字数）、目录树、12 周热力图、格式分布、90 天未更新等视图。待办按已逾期、今天、本周、以后四列展示；可勾选完成，快速添加会写回滴答清单。
设置与 Agent¶
设置里可配置 Obsidian Vault、Notion Token、飞书应用、滴答 Token，每个来源支持测试连接。Agent 工具名为 knowledge_board，供模型查询文档统计、搜索结果、待办并触发刷新；按 README 说明，该工具只读统计、标题、路径、任务，不返回 Token。
安装与启用¶
要求：DeepSeek Harness >= 0.2.0-rc.2，Node.js 22+。
方式 A：npm（README 推荐给最终用户）¶
发布方需先执行（维护者侧）：
npm publish --access public
在 DSH Web 打开 Plugins → Add，填入包名：
dsh-knowledge-board
安装后刷新页面，侧边栏出现「知识看板」图标。
方式 B：GitHub¶
仓库需已构建并提交 client.js。在 Plugins → Add 中填写（将 your-name 换为实际用户名）：
github:your-name/dsh-knowledge-board
方式 C：本地目录或开发¶
cd ~/.dsh/profiles/<your-profile>
pnpm add link:/absolute/path/to/dsh-knowledge-board
在该 profile 的 package.json 中加入 bundle：
{
"dsh": {
"profile": {
"bundles": ["dsh-knowledge-board"]
}
}
}
重启 DSH 或重新加载 profile。Client 改动需刷新页面；pnpm run dev:web 时支持 Web 热更新。
插件以当前 DSH 进程权限运行；安装前建议查看仓库源码与 MIT 许可证。
典型用法：连接各来源¶
打开看板 → 设置，按来源逐步配置。
Obsidian¶
自动探测常见 Vault 路径（如 ~/Documents/Obsidian Vault、iCloud 下的 Obsidian 目录）；也可手动填写 Vault 路径，一行一个。只读 Markdown，不修改本地文件。本地图片附件 ![[...]] 仅显示占位，README 标明不提供附件服务。
Notion¶
- 在 Notion Integrations 创建 Internal Integration，复制 Token。
- 在目标页面右上角
···→「连接」中加入该集成。 - 填入看板设置并测试连接。
飞书文档¶
- 在 飞书开放平台 创建企业自建应用，获取 App ID / App Secret。
- 权限管理开通：
drive:drive、docx:document:readonly、wiki:wiki:readonly、offline_access。 - 安全设置中重定向 URL 添加：
http://127.0.0.1:17890/knowledge-board/oauth/callback。 - 发布版本后，在看板设置中完成「授权读取我的飞书文档」。
授权后同步个人「我的空间」和知识库；「知识库空间」可填空间名称或 space_id 限定单一知识库，留空表示全部。租户 token 无法看到个人「我的空间」，须完成个人 OAuth。
滴答清单¶
使用 滴答清单 Web → 头像 → 设置 → 账户 → API Token（非开发者后台 Client ID / Secret），创建后填入设置。
数据与安全¶
- 配置路径：
~/.dsh/storages/knowledge-board/config.json（目录权限 700，文件 600）。 - 快照：
snapshot.json用于秒开，过期后后台刷新。 - Token 仅在本机 Host 进程使用，接口返回时脱敏；请求从本机直连各官方 API。
适用场景与已知限制¶
适合需要在 DSH 内统一浏览多源笔记、查看统计与热力图，并把滴答待办与文档上下文放在一起的操作习惯。飞书个人空间或滴答账号内容很少时，看板条目也会偏少；知识库需 wiki:wiki:readonly，权限未发布时可能出现 99991679 / 20027。本机应用唤起（open -a）目前仅 macOS，文档同步跨平台可用。演示数据仅在未配置任何来源时出现。
结尾¶
dsh-knowledge-board 把 Obsidian、Notion、飞书文档与滴答清单收进 DSH 侧边栏，配合 knowledge_board 工具便于智能体侧只读检索。目录页：skillhub.cn 插件条目；源码与完整配置说明：GitHub README。
