前言¶
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 倉庫 或 技能庫目錄。
