Runs TiddlyWiki 5 as the DSH persistent knowledge base: ten tiddlywiki_* agent tools (filtered search, read/write/batch/rename/delete, recent, tags, git sync with conflict resolve), a full TiddlyWiki editor embedded in the GUI center column over a same-origin proxy, a right-side wiki tab, a per-session tab summarizing the notes a session read or wrote, a quick-note card with draft auto-save, and an optional clip bookmarklet with image attachment — all backed by an auto-committing git repository.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-tiddlywiki
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:bbqisbbq/dsh-tiddlywiki
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
给 DSH 装一个你自己的知识库：你在界面里读、写、记日记，Agent 用同一批笔记干活。 纯文本 + git，能读、能改、能带走。
它不是自动记忆插件。 不后台抓取、不向量召回、不在你不知道的情况下"记住"什么——每条笔记都是你能打开、能审、能 git diff 的文件。要不要让 Agent 看，由你决定。
⚡ 30 秒上手
dsh plugin --profile web add dsh-tiddlywiki
重启 dsh web。首次启动自动完成：建 wiki 目录、git init 提交基线、写入起步文档（插件说明 + 示例与文档）。不需要先配任何东西。
- 侧边栏 TiddlyWiki → 中央列打开完整 TW 编辑器
- 输入框上方 📝 或右下角 知识库 → 快速记一条（写完即进 git）
- 直接说「把这段存进知识库」→ Agent 用
tiddlywiki_*工具读写 - 收工点 🔁 同步 → pull → commit → push
想用已有的文件夹当库？设置页「知识库位置」里切换，不用改配置、不用重装。
🎯 适合谁 / 不适合谁
适合：想要一个本地、纯文本、能随时带走的长期笔记库，并且愿意让 Agent 读写同一批文件的人；已经在用 Obsidian / Logseq、但缺"Agent 也能进"这一层的人。
不适合：想要"装完就自动记住我说过的一切"的人（那是另一类插件：自动抽取 + 向量召回 + 后台注入；本插件不做后台抓取）；完全不想碰 TiddlyWiki 心智模型的人——它需要一次五分钟的理解。
✨ 它好在哪
| 👥 人和 Agent 同一份库 | 你在 TW 里读写的，就是 Agent 读写的；不是"我写给你看"，也不是"它记它的" |
| 🛡 写入不会吃掉你的东西 | 所有写路径先读后写：不传 tags 就保留原标签/字段/内容类型；同名默认拒绝覆盖；删除进回收站可恢复；可选 expectedModified 乐观并发（读后被改过就拒绝写入，而不是静默覆盖） |
| 🚰 重启不丢写入 | 停/重启 TW 只有一条路：先排干 syncer 队列再停，排不干净会如实报 drained:false |
| 🕰 可审计、可回溯 | 库本身就是 git 仓库（自动 commit + 一键同步）；反向链接、标签、体检（lint）；阶段性内容可标 valid-until / superseded-by，淘汰永远由人决定，插件不自动删 |
| 📦 数据可带走 | 磁盘上就是 .md + .meta + .tid + files/，不需要这个插件也能读 |
| 📮 可选发布 | 打开后能把笔记一键发到微信公众号草稿箱（默认关闭，不打扰） |
🤖 Agent 工具（15 个）
search（先在工作区内查、0 条才扩全库） · get · put · batch_put · append（增量追加，可指定标题段落） · rename（含引用改写） · delete（默认进回收站） · trash · backlinks · attach（图片/PDF 入库） · lint（死链/空笔记/时效） · recent · list_tags · git_sync · git_resolve
每个工具的完整参数与语义见 docs/usage.md。
🔧 配置
插件向每个会话注入一段可配置的提示词（默认精简版 ~1.9KB，可整体关掉或替换），其余配置在设置页：知识库位置、git（自动提交/远端/分支）、笔记标签与工作区标记、快速笔记、剪藏桥、公众号发布、界面语言、访问口令。
完整配置项与远程访问（Tailscale / 内网 / 域名）见 docs/usage.md。
📚 文档
| 想看什么 | 去哪 |
|---|---|
| 完整能力清单（每条的为什么） | docs/features.md |
| 使用指南 / 工具参考 / 配置 / 远程访问 | docs/usage.md |
| 发布到微信公众号（可选，需额外安装） | docs/wechat-publish-setup.md |
| 把知识库拆成几个独立的小库（含可复制给 Agent 的提示词） | docs/wiki-split.md |
| 开发与发布流程（给维护者） | docs/development.md |
| 版本变更历史（逐版本、含"为什么"；README 不再重复它） | docs/CHANGELOG.md |
🔗 仓库与发布元数据
- GitHub：https://github.com/bbqisbbq/dsh-tiddlywiki ｜ npm：
dsh-tiddlywiki - 用得不顺请来提 issue：https://github.com/bbqisbbq/dsh-tiddlywiki/issues —— 这插件原本是作者给自己做的，现在有同道人用；你不报，我就不知道哪里不对。
- MIT；Node ≥ 22；GitHub topics：
dshdsh-plugintiddlywikiknowledge-baseknowledge-managementnote-takingjournalgit-synclocal-firstagent-toolspublishingwechat等
Links
More in this category
vectorize-io/hindsight#coding-agents★ 51706
Hindsight, agent memory that learns: long-term project memory with auto recall and retain, knowledge pages, deep reflection, and per-repo memory banks.
volcengine/OpenViking#examples/dsh-memory-plugin★ 40368
OpenViking memory and context bundle for DeepSeek Harness: pre-step auto-recall and profile injection, session capture, `viking://` URI guarding, and recall/write memory tools backed by an OpenViking server.
agentscope-ai/ReMe#dsh★ 3655
Connects DeepSeek Harness to ReMe's local-first, self-evolving personal knowledge base: automatically captures completed main-agent conversations as user-owned Markdown memory, searches conversations and source material through reme_search with BM25, optional embeddings, and wikilink expansion, and schedules daily memory consolidation.
zilliztech/memsearch#MemSearch★ 2763
Shared Markdown memory for DSH and other coding agents, with automatic capture, pre-step context injection, searchable recall, and memory-to-skill self-evolution through a review panel.
vshulcz/deja-vu#extensions/dsh★ 1254
Reads the session files thirty-three other coding agents on this machine already wrote — Claude Code, Codex, Cursor, VS Code Copilot Chat, opencode, OpenClaw, Hermes, Kimi, Cline, Zed and more — including sessions from before it was installed: six tools (deja_recall, deja_session, deja_blame, deja_fix, deja_how, deja_remember), a /deja command, and optional automatic recall added to the runtime context. Local BM25 index, no LLM, no embeddings, no network (dsh plugin --profile web add dsh-deja).
adoresever/graph-memory★ 655
Traceable, searchable cross-session memory for DeepSeek Harness — conversation knowledge as typed graph nodes (TASK/SKILL/EVENT) and typed edges.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.