dsh-wiki

基于 DeepSeek Harness (DSH) + Obsidian 的个人知识库体系（源自 Karpathy LLM Knowledge Bases）：LLM 负责编译与维护，人类负责选材、审核与提问。

单一事实源 = Markdown vault（git 版本化），不引入数据库。

安装（官方 bundle 机制，推荐）

本仓库是一个 DSH bundle：dsh plugin 一条命令装进任意 profile。

# 方式 1：npm（推荐）
dsh plugin --profile <你的profile> add dsh-wiki

# 方式 2：GitHub（本仓库未发布 npm 前）
dsh plugin --profile <你的profile> add github:skillre/dsh-wiki

# 方式 3：本地 tarball（私有分发）
pnpm pack && dsh plugin --profile <你的profile> add ./dsh-wiki-0.1.0.tgz

验证安装（应看到 # == dsh-wiki 层）：

dsh --profile <你的profile> --dump-config

bundle 提供：schedule 定时能力（每周自动巡检/周报的前提）+ skills/scripts/templates 资源。

初始化你的 vault（一条命令，指定任意目录）

npx dsh-wiki-init ~/mywiki     # 初始化到 ~/mywiki（任意路径都行）
dsh-wiki-init                  # 省略路径 = 当前目录

命令把 5 个 wiki skills、巡检脚本（gen-index.py / maintain.py）、笔记模板复制到 <vault>/.dsh/ 与 <vault>/templates/。 skills 通过 project 级发现（rank 100）只对该 vault 的会话可见——不污染全局；脚本自动定位 vault 根，零配置。

已知冲突（先读）

bundle 会 insert time-context 与 schedule 两个插件行。如果目标 profile 的 cordis.patch.yml（或已装的另一个 bundle）已经手动 insert 过这两个 id，启动会报：

Error: ... duplicate loader entry id: time-context

解决：删除 profile 里手动加的 time-context/schedule 行（schedule 只保留一个来源），再重启。

方式 2：模板 vault（clone 即用）

vault-template/ 是完整的 vault 骨架 + 示例笔记：

cp -r vault-template my-wiki

Obsidian Open folder as vault 打开 → DSH GUI "选择工作区"添加 → 新建会话即获得：vault 沙箱围栏 + 5 个 wiki skills。

日常使用

① 丢：链接/PDF/一句话想法丢给 agent
② 审：agent 起草到 inbox/，你在 Obsidian 看
③ 过：说"通过" → 自动 promote 到 notes/ + 挂 MOC + git commit
④ 查：问"库里关于 X 说了什么？"
⑤ 养：说"跑一下巡检"；或让 agent 建每周提醒自动巡检+周报

包内容

package.json          dsh.bundle manifest
cordis.patch.yml      schedule 能力（每周提醒）
skills/               5 个 wiki skills（conventions/ingest/write/maintain/digest）
scripts/              gen-index.py + maintain.py（巡检 + L2 索引）
templates/            frontmatter 笔记模板
vault-template/       完整 vault 模板（含示例笔记）

设计要点

• 文件夹按生命周期分，不按主题分；主题结构由 mocs/ + tags + related 承担
• 防冗余铁律：写之前先检索，已有就扩写不新建
• agent 只写 inbox/ + .wiki/；正式区只读；每步 git commit 审计
• 维护自动化：脚本化巡检 + 周报 + schedule 每周提醒

许可

MIT。随意使用、修改、再分发。