前言¶
DeepSeek Harness (DSH) 的核心理念之一是“一切皆插件”。在智能体开发中，Agent 往往需要访问用户长期积累的文本数据，而不仅仅是依赖当前会话的上下文。传统做法通常是配置外部文件路径，或者引入专有的向量数据库。这里介绍 dsh-tiddlywiki，它通过将 TiddlyWiki 5 集成到 DSH 生态中，提供了一种基于纯文本和 Git 的解决方案，让用户和 Agent 共用同一份知识库。
插件介绍¶
该插件由 bbqisbbq 维护，开源协议为 MIT，要求 Node.js 版本不低于 22。它的核心定位是：给 DSH 装一个你自己的知识库。你在界面里读、写、记日记，Agent 用同一批笔记干活。数据以纯文本 + Git 形式存储，用户可以随时带走，且具备完整的可审计性。
核心能力¶
- 人与 Agent 共享库：你在 TiddlyWiki 界面中读写的内容，就是 Agent 工具能操作的内容，不存在“我写给你看”或“它记它的”两份数据。
- 写入安全机制：采用“先读后写”策略，不传
tags参数则保留原标签/字段；同名文件默认拒绝覆盖；删除操作进入回收站；支持expectedModified乐观并发控制，防止静默覆盖。 - 重启安全：写入操作前会先排干 syncer 队列，避免重启时丢失数据；若队列未排干，会如实报告
drained:false。 - 可审计与可回溯：知识库本质是 Git 仓库，支持自动提交、一键同步、体检（lint）以及通过
valid-until/superseded-by标记淘汰内容。 - 数据可带走：磁盘上直接生成
.md、.meta、.tid和files/目录，无需该插件即可直接读取。 - 可选发布：支持一键将笔记发布到微信公众号草稿箱（默认关闭）。
安装与启用¶
使用官方插件管理命令安装：
dsh plugin --profile web add dsh-tiddlywiki
安装完成后重启 dsh web。首次启动会自动完成以下操作：在指定位置创建 wiki 目录、执行 git init 提交基线、写入插件说明文档等起步内容，无需手动配置。
使用流程¶
- 编辑：侧边栏点击 TiddlyWiki，在中央列打开完整编辑器。在输入框上方或右下角 知识库 处，快速记录一条笔记（写完即自动进 git）。
- Agent 交互：对话中直接说“把这段存进知识库”，Agent 会调用
tiddlywiki_*系列工具进行读写。 - 同步：工作完成后，点击 🔁 同步，执行 pull -> commit -> push 流程。
适用范围与注意事项¶
- 适合人群：需要一个本地、纯文本、能随时带走的长期笔记库，并且希望 Agent 能参与读写的人。
- 注意：这不是“自动记忆”插件，不会后台抓取内容、不进行向量召回，也不会在用户不知情的情况下“记住”什么。所有操作都在用户可见的文件系统中。由于依赖 TiddlyWiki 的心智模型，初次使用需要花几分钟理解其结构。
结语¶
该插件将 TiddlyWiki 5 的编辑能力与 Git 的版本控制能力引入了 DSH 生态，实现了数据在人与 Agent 之间的双向流动与完全掌控。更多细节可查看 GitHub 仓库 或 技能库目录。
