dsh-knowledge-tree
DeepSeek Harness 的知识树插件——将零散知识收集为叶节点，让代理将其整理成你自己的知识树。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:YunpengDon/dsh-knowledge-tree#6d0125f159d7d5c5d9db11a157f3784f6af8b3b8Knowledge Tree 以 dsh-knowledge-tree 发布，当前版本为 1.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个「把散落知识捋成自己的教程」的个人知识管理系统。在与 AI 的对话中收集零散知识（树叶），AI 自动归类到知识树，长期积累最终形成个人独有的知识体系。
dsh-knowledge-tree/ # 包名 dsh-knowledge-tree
├── src/
│ ├── index.ts # 工具实现 + 插件注册 + 配置
│ ├── hitl.ts # 四张决策卡的字段与预览（挂到 dsh-hitl）
│ ├── markdown.ts # Markdown 结构操作（纯函数：工具与预览共用同一组）
│ └── paths.ts # 知识树文件的定位规则（工具与预览共用）
├── skills/ # 随包技能（会打进分发包）
│ ├── append-leaf/
│ │ ├── SKILL.md # 记叶子技能
│ │ └── references/ # 格式示例
│ │ ├── knowledge-tree-example.md
│ │ └── index-example.md
│ └── organize-tree/
│ └── SKILL.md # 整理知识树技能
├── dist/ # 构建产物，包的实际入口（tsc 输出，不进 git）
├── cordis.patch.yml # bundle 配置层，被 dsh.bundle.patch 引用
├── package.json # 声明 dsh.bundle
├── tsconfig.json
├── CHANGELOG.md # 变更记录 / release note
└── README.md
| 工具 | 功能 |
|---|---|
append_leaf | 追加知识叶子到"待整理"区，文件不存在自动创建 |
organize_tree | 整理知识树（插入节点 / 移动节点） |
cleanup_organized_leaf | 从待整理区删除已整理的叶子 |
update_index | 更新索引文件 |
四个工具落盘前都会先要人点一次头，见下面的「人在环内」。
| 技能 | 触发场景 |
|---|---|
append-leaf | 用户说"记一下""保存到知识树" |
organize-tree | 用户说"整理知识树""归档待整理" |
四个工具都会改工作区里的文件，所以每个工具落盘前都挂一张决策卡。卡片由 dsh-hitl ≥ 0.2.0 提供——它是可选依赖：组合里没有它时，四个工具照常工作，只是少了人工确认这一环。
⚠️ 别配更旧的 dsh-hitl：0.2.0 才引入「计算字段」，卡上的 diff 与「将被删除的内容」要靠它把磁盘上的原文交给卡片；用旧版时这两类字段拿不到值（正文、标题这些参数字段不受影响）。升级 dsh-hitl 即可，本插件这边不用改配置。
| 工具 | 卡上给人看什么 |
|---|---|
append_leaf | 树叶正文按 Markdown 渲染（可编辑）。改好点【修改】：这次调用不会执行，模型拿你改的正文重新提交 |
organize_tree | 插入 / 搬移的正文，外加整理之后的整份文件 diff——落点是这一步最容易出错的地方，直接看结果比看 anchor 直观 |
update_index | 旧索引 vs 新索引的并排 diff，外加可编辑的新正文 |
cleanup_organized_leaf | 将被删掉的那片叶子的原文（只读）。删除不可撤销，这张卡只负责让你看清将要失去什么；不满意就拒绝，把原因写进反馈栏 |
卡上的预览不是另算一份：整理后的全文、将被删除的原文，都由工具实现用的同一组纯函数（src/markdown.ts）算出来，所以"卡上显示什么"与"将要写入什么"不会跑偏。算不出来时（锚点不存在、叶子不在待整理区、文件被删了）卡上直接写一句原因，而不是弹不出卡、或者装作没事。
配置（写在 profile 的 cordis.patch.yml）：
- id: knowledge-tree
name: 'dsh-knowledge-tree'
config:
hitl:
enabled: true # false = 完全不挂卡，四个工具直接落盘
whenUnavailable: reject # 没有任何浏览器连着时：reject（默认，fail-closed）/ wait
countdownSeconds: null # null = 不限时；给正整数则到点按"拒绝"处理
rejectFeedback: true # 拒绝时显示反馈栏
humanTurn / confirm / confirmTools / feedbackTools / confirmTimeoutSeconds 已废弃：仍然认得出来，但只会各报一句警告（其中 off 会映射成 hitl.enabled: false）。tools/pre-execute，也就是先问人：人同意之后，沙箱、审批等策略照常生效——用户同意不等于越权，别的执行前策略仍可能拒绝这次调用。在 DeepSeek Harness 前端界面进行下面的操作：
dsh-knowledge-tree；装好后按【立即启用】，面板会提示「更改将在下次启动生效」，重启 DSH 后四个工具与两个技能即全部就位。
命令行方式适合开发调试，或者需要装本地目录、tarball、Git 源码的场景。
嫌命令行繁琐的话：直接把源码目录、tarball 或下面的 GitHub 链接发给DeepSeek Harness 智能体，让它帮你装。
目前 DSH 的插件安装流程仍然比较繁琐——profile、bundle、
allowBuilds、--dump-config这些概念都要先弄明白，报错也未必直白。交给智能体比对着文档手动折腾快得多。
这是一个 DSH bundle：包内自带配置层 cordis.patch.yml，装进 profile 后会插入两行——四个工具，以及一行只贡献本包 skills/ 的技能提供方。装完不需要手改任何配置。
pnpm dsh plugin --profile <profile> add dsh-knowledge-tree
npm 上的包已经包含构建好的 dist/，安装时不会执行任何构建脚本，所以不需要 allowBuilds 授权，也不需要出网到 GitHub。装完直接按下面的「验证」启动一次即可。
pnpm --dir dsh-knowledge-tree install
pnpm --dir dsh-knowledge-tree build
# 路径会被 pnpm 链接安装，改完代码重新 build 即生效
pnpm dsh plugin --profile <profile> add ./dsh-knowledge-tree
pnpm --dir dsh-knowledge-tree pack
pnpm dsh plugin --profile <profile> add ./dsh-knowledge-tree-1.0.1.tgz
pnpm dsh plugin --profile <profile> add github:YunpengDon/dsh-knowledge-tree
git 安装拉的是源码，pnpm 会在安装时执行包里的 prepare（即 tsc）来构建 dist/。pnpm ≥10 默认拒绝执行依赖的构建脚本，第一次会失败并在报错里给出包名；把它加进该 profile 的 pnpm-workspace.yaml 后重试：
（这个文件人工找需要对DSH比较熟悉才行，也不好找，最优解还是扔给你的DSH智能体）
allowBuilds:
dsh-knowledge-tree: true
这等于允许该包在你的机器上以你的权限执行代码，只对信任的源码这么做，并尽量固定 commit（github:YunpengDon/dsh-knowledge-tree#<sha>）。
另外注意：直连 GitHub 可能超时（国内网络尤其如此）。遇到时优先改用上面的本地目录或 tarball 方式，它们不需要任何出网安装。
pnpm dsh --profile <profile> --dump-config | grep -n knowledge-tree
出现 knowledge-tree 与 knowledge-tree-skills 两行，说明配置层被应用了。但 --dump-config 不会求值 !!js 表达式，所以它证明不了 bundledSkillDir 的路径解析成功——真正的验收是启动一次，让 skill 工具列出 append-leaf / organize-tree。
pnpm dsh plugin --profile <profile> remove dsh-knowledge-tree
| 维度 | DeepAgents | DSH |
|---|---|---|
| 语言 | Python | TypeScript |
| 工具注册 | @tool 装饰器 | ctx.tools.register() |
| 技能格式 | SKILL.md（含 tools 字段） | SKILL.md（name + description + whenToUse） |
| 文件权限 | FilesystemPermission 虚拟文件系统 | 自行实现路径安全检查 |
| HITL | interrupt_on 配置 | 挂到 dsh-hitl 的决策卡上（四个工具各一张，见上文） |
| 搜索 | DDGS（需翻墙） | 需自行接入国内数据源 |