Install
Inside DeepSeek Harness, with dsh-market
dsh plugin --profile web add dshmarket
Or from the command line
dsh plugin --profile web add dsh-tiddlywiki
Installing runs third-party code with your own permissions — it can read your files, use your credentials and reach the network. Review the source first, and pin a commit (github:owner/repo#sha) when you can.
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等
Comments
Comments live in GitHub Discussions. Sign in with GitHub to post or react.