TiddlyWiki Cognee：可搜尋專案筆記的設計提案

專案狀態 — 2026 年 10 月 22 日： 這是 Cognee 議題 #6222 的設計提案。維護者指派尚未確定。連接器尚未實作或測試，也還沒有 PR。本文說明提出的範圍與驗證計畫。

專案 wiki 所保存的不只是文件。它記錄了團隊為何選擇某種做法、哪個服務擁有某項責任，以及事件發生時的經過。一個有用的記憶整合應該保留這些筆記及其來源連結，同時也要忘記作者已刪除的內容。

在 Mergetober 期間，提出的貢獻是一個 TiddlyWiki 與 Cognee 之間的唯讀連接器。初始目標是 TiddlyWiki 的官方 Node.js 伺服器，選取的文字筆記會透過 Cognee 現有的 document-source 路徑被攝取為文件。

以小型專案 wiki 作為範例

規劃的示範使用一個專用的本地 wiki，包含關於服務所有權、部署決策和事件的合成筆記。它應該能支援以下問題：「誰擁有帳單？」以及「這個專案為什麼選擇目前的部署方式？」

接著會修改所有權筆記、執行另一次同步，並檢查更新後的答案。最後會刪除一則筆記，並確認過時資訊已被遺忘。這些是規劃的檢查項目，並非目前已取得的結果。

TiddlyWiki 提供了筆記清單端點與單一筆記端點。連接器提案使用允許的預設清單功能，並在本機進行標題或標籤篩選。

每份文件應保留筆記標題、選取的標籤、文字內容，以及來源永久連結。第一版會排除系統/設定筆記與二進位附件。它會保留筆記文字，而不執行 wiki 巨集或追隨連結檔案。

提出的同步方式是所選筆記的完整快照。Cognee 可利用穩定的語意內容避免重新處理未變更的文件，而成功的快照則提供調和已刪除或重新命名筆記所需的清冊。

這也帶來一項責任：驗證失敗、格式錯誤的回應或筆記擷取失敗都必須中止執行。將部分擷取視為完整清冊，可能導致仍存在的內容被移除。

在清單與擷取之間消失的筆記需要有限次的重試或明確標記為失敗的執行。刪除最後一則筆記也需要真實的整合測試；僅通過 HTTP 單元測試無法確認圖譜清理是否正常運作。

檢查項目	目前狀態
HTTP 驗證、標題編碼、標籤剖析與錯誤處理	已規劃
真實的 dlt 管線與 Cognee 文件攝取	已規劃
在 loopback 上執行的官方 TiddlyWiki 伺服器	已規劃
未變更的同步、編輯、重新命名、範圍變更與刪除	已規劃
最後一則筆記的刪除與失敗執行保留	已規劃
端到端搜尋答案與來源出處	已規劃

完成的逐步說明將包含已測試的套件版本、可重現的設定指令、實際的 PR 連結，以及觀察到的結果。模擬測試與即時服務檢查將另外報告。

提案與指派請求包含套件佈局與驗收計畫。實作正等待指派以及澄清 Mergetober 對 AI 協助的期望。

AI 揭露： 本提案與文章是依我的要求由 Codex 研究與起草。文章標記為 Fully Autonomous 以反映此作者身分。實作細節與測試結果將在對應工作完成後才會報告。

Post Views: 547