dsh-knowledge-tree

一个「把散落知识捋成自己的教程」的个人知识管理系统。在与 AI 的对话中收集零散知识（树叶），AI 自动归类到知识树，长期积累最终形成个人独有的知识体系。

文件结构

dsh-knowledge-tree/           # 包名 dsh-knowledge-tree
├── src/
│   └── index.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	用户说"整理知识树""归档待整理"

安装

最省事的做法：直接把源码目录、tarball 或下面的 GitHub 链接发给 DeepSeek Harness 智能体，让它帮你装。

目前 DSH 的插件安装流程仍然比较繁琐——profile、bundle、allowBuilds、--dump-config 这些概念都要先弄明白，报错也未必直白。而智能体恰好擅长这类「读文档 → 跑命令 → 看报错 → 重试」的活，交给它比对着文档手动折腾快得多。

下面的内容既是手动安装步骤，也是交给智能体时它可以参考的信息。

这是一个 DSH bundle：包内自带配置层 cordis.patch.yml，装进 profile 后会插入两行——四个工具，以及一行只贡献本包 skills/ 的技能提供方。装完不需要手改任何配置。

npm 安装（推荐）

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

tarball 安装（不触发任何构建脚本）

pnpm --dir dsh-knowledge-tree pack
pnpm dsh plugin --profile <profile> add ./dsh-knowledge-tree-1.0.1.tgz

GitHub 安装

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 版本的主要差异

维度	DeepAgents	DSH
语言	Python	TypeScript
工具注册	@tool 装饰器	ctx.tools.register()
技能格式	SKILL.md（含 tools 字段）	SKILL.md（name + description + whenToUse）
文件权限	FilesystemPermission 虚拟文件系统	自行实现路径安全检查
HITL	interrupt_on 配置	DSH 内置 HITL 机制
搜索	DDGS（需翻墙）	需自行接入国内数据源