記憶系統
此技能提供專案本機記憶的持久化層,位於 <project_root>/memories/,透過 scripts/memory <cmd> 操作(底層由 references/memory_tool 作為此層的確定性真相來源 — 請勿修改其輸出或重新實作)。它不假設主機沒有其他記憶機制;如果存在其他記憶系統,則將其視為額外的檔案層。標準輸出為 JSON 格式;請使用 read 指令確認磁碟狀態。
自 1.1.0 版本起,init 還會在 <project_root>/.memsys-db 建立一個隱藏的 SQLite + FTS5 資料庫(使用 journal_mode=DELETE,單一檔案,無 -wal/-shm)— 可重新生成的索引和搜尋平面。Markdown 仍為真相來源。
請依序從此處開始:
- references/protocol.md — 完整的攝取 → 檢索 → 推理 → 反思 → 執行 → 包裝工作流程,以及指令和快速入門呼叫。
- references/layout.md — 儲存布局以及針對特定查詢應載入的內容。
- references/when-to-save.md — 分類:技能 vs. 索引 vs. 主題 vs. 拒絕,以及技能與記憶的路由。
- references/constitution.md — 硬性規則(絕不跳過密碼掃描、絕不超過 200 行、絕不寫入
memories/外部、絕不透過 bash 枚舉、絕不為分類帳啟用 WAL)。 - references/memsys-db.md —
.memsys-db分類帳合約:結構、search/reindex/forget,以及為何資料庫永遠不比 Markdown 優先。 - references/examples.md — 實例:快樂路徑、密碼拒絕、覆寫復原。
首次使用前,請執行 scripts/memory selftest 驗證安裝。