ai-memory

ai-memory™

bộ nhớ AI phổ quát

ai-memory là một hệ thống bộ nhớ bền vững dành cho trợ lý AI. Nó hoạt động với bất kỳ AI nào hỗ trợ MCP -- Claude, ChatGPT, Grok, Llama, và nhiều hơn nữa. Nó lưu trữ những gì AI của bạn học được trong cơ sở dữ liệu SQLite cục bộ, xếp hạng ký ức theo mức độ liên quan khi truy xuất, và tự động thăng cấp kiến thức quan trọng lên bộ nhớ vĩnh viễn. Cài đặt một lần, và mọi trợ lý AI bạn sử dụng sẽ ghi nhớ kiến trúc, sở thích, các chỉnh sửa của bạn -- mãi mãi.

Chọn lộ trình cài đặt của bạn

Đang cấu hình backend LLM (xAI Grok, OpenAI, Anthropic, Gemini, DeepSeek, Kimi, Qwen, Mistral, Groq, Together, Cerebras, OpenRouter, Fireworks, LMStudio, vLLM, máy chủ llama.cpp, hoặc Ollama cục bộ)? Xem docs/integrations/llm-backends.md — công thức khối env MCP giống nhau bất kể lộ trình cài đặt.

v0.9.0 — bản phát hành hiện tại. Một bản phát hành tăng cường bảo mật và rà soát mã nguồn: 49 bản sửa lỗi từ đợt rà soát đối kháng 5 làn (#1885–#1935) cùng với một tập hợp nhỏ các tính năng bổ sung. Thay đổi nổi bật là việc chuyển đổi mặc định an toàn: xác thực tác nhân hiện được YÊU CẦU theo mặc định đối với các thao tác ghi (#1751) — một MCP memory_store / HTTP POST /api/v1/memories / CLI store không được ký sẽ bị từ chối (403 ATTESTATION_FAILED) thay vì được ghi nhận attest_level="claimed", trừ khi người vận hành đặt tùy chọn từ chối rõ ràng AI_MEMORY_REQUIRE_AGENT_ATTESTATION=0. Cùng với đó, cổng thực thi sự hiện diện hook bắt buộc hiện kích hoạt trên cả đường dẫn ghi MCP (#1885) và đường dẫn ghi HTTP (#1924), đóng một lỗ hổng bỏ qua ngầm khi một hook bắt buộc đã cấu hình có thể bị bỏ qua trên một bề mặt nhưng không phải bề mặt kia. Đợt tăng cường cũng đóng bulk_create cổng xác thực theo hàng (#1919), định tuyến các phê duyệt PENDING liên kết đến thông qua cổng người phê duyệt đã đăng ký (#1920), thắt chặt phạm vi hiển thị team/unit/org để không còn quá rộng trên toàn bộ hệ thống phân cấp không gian tên (#1921), và giới hạn việc nhập folder_path của skill_register dưới thư mục gốc đã cấu hình bằng một "nhà tù" symlink (#1923). Một kênh thông tin xác thực không dùng argv mới — AI_MEMORY_STORE_URL / AI_MEMORY_STORE_URL_FILE (một tệp 0600) — giữ mật khẩu postgres/store khỏi /proc/<pid>/cmdline và ps có thể đọc được toàn cục (#1927). Công việc tính năng bổ sung: ký ức kỹ năng do tác nhân tạo ra với parameters_schema + invocation_record (B7-SKILL, #1865), vòng lặp phản hồi ngầm recall_observations (#1706), một DAG dòng dõi dẫn xuất ký ức (memory_lineage, #1859), và một lát cắt tối thiểu tìm kiếm vector tùy chọn (#1005). Bề mặt: lược đồ v78, 101 công cụ MCP tại --profile full (100 có thể gọi + memory_capabilities bootstrap luôn bật) / 7 tại --profile core, 92 đăng ký tuyến HTTP (78 đường dẫn URL duy nhất), 89 lệnh con CLI dưới --features sal/sal-postgres (87 trong bản dựng mặc định), 9 quan hệ MemoryLink có kiểu, một Memory 28 trường. Chạy trên hai backend sản xuất đằng sau một API giống hệt — SQLite nhúng và PostgreSQL + Apache AGE — trên máy tính để bàn, máy chủ và thiết bị (iOS + Android). Mọi thứ đều là bổ sung so với v0.8.1 ngoại trừ các chuyển đổi xác thực và thực thi hook, đây là những thay đổi phá vỡ mặc định an toàn — hãy xem xét chúng trước khi nâng cấp. Nhật ký thay đổi đầy đủ: CHANGELOG.md §"[0.9.0] — 2026-07-08".

v0.8.0 (distributed-coordination) — bản phát hành trước. Đây là bản phát hành mà nền tảng bộ nhớ trở thành một nền tảng phối hợp. Nó bổ sung cơ chế phối hợp phân tán từ #1709: một DAG hành động có kiểu với một máy trạng thái thực (memory_action_*), hợp đồng thuê một người giữ có giới hạn TTL (memory_lease_*), tín hiệu được ký Ed25519 (memory_signal_*), điểm kiểm tra được xác thực Ed25519 (memory_checkpoint_*), và các quy trình đóng băng, có thể phát lại (memory_routine_*) — để một đội tác nhân không đồng nhất có thể thay phiên nhau, bàn giao công việc và chứng minh ai đã nói gì mà không cần phải tin tưởng lẫn nhau. Nó xếp lớp nhận thức có kiểu lên trên (các loại ký ức Goal/Plan/Step, một máy lifecycle_state, và các quan hệ liên kết decomposes_into / depends_on / advances), tăng cường liên kết an toàn theo mặc định (đăng ký ngang hàng BẬT theo mặc định #1789, chữ ký mỗi lần chuyển đổi #1718, xác thực nội dung mỗi lần ghi #1464, nonce phát lại chuyển đổi #1805, ghim chứng chỉ ngang hàng đi #1678), và cung cấp quản trị thực sự chặn — hook PreToolUse của Claude Code được làm lại thành một trình bao bọc type:command để một Refuse nền tảng thực sự từ chối công cụ (#1811). Tại bản phát hành v0.8.0, bề mặt là: lược đồ v70, 100 công cụ MCP tại --profile full (99 có thể gọi + memory_capabilities bootstrap luôn bật) / 7 tại --profile core, 91 đăng ký tuyến HTTP (78 đường dẫn URL duy nhất), 83/85 lệnh con CLI, 9 quan hệ MemoryLink có kiểu, một Memory 27 trường. Chạy trên hai backend sản xuất đằng sau một API giống hệt — SQLite nhúng và PostgreSQL + Apache AGE — trên máy tính để bàn, máy chủ và thiết bị (iOS + Android). Mọi thứ đều là bổ sung so với v0.7.0; hãy xem xét các chuyển đổi mặc định an toàn trước khi nâng cấp. Ghi chú phát hành đầy đủ: docs/v0.8.0/release-notes.md.

v0.7.0 (attested-cortex) — bản phát hành trước. Tập hợp công việc về tính dễ đọc cortex-fluent với phạm vi tin cậy + A2A đầy đủ của v0.7 từ LỘ TRÌNH §7.3, cộng với (theo chỉ thị của người vận hành ngày 2026-05-09) công việc postgres+AGE hạng nhất ban đầu của v0.7.1, cộng với đợt sẵn sàng xuất xưởng sau grand-slam (Biểu mẫu Batman 1-6 + nền tảng Tùy chọn-B dạng thứ 7 + QW-1/2/3 + quét bảo mật đối chiếu). Nền tảng trở nên vừa rõ ràng hơn (năng lực v3, công cụ tải có tên, lược đồ thu gọn, từ vựng MemoryKind Batman, các nguyên thủy persona/nguyên tử hóa/tiếp nhận đa bước) vừa đáng tin cậy về mặt mật mã (xác thực Ed25519, bản ghi sidechain, pipeline hook 25 sự kiện có thể lập trình, kế thừa không gian tên được thực thi, chuỗi băm sự kiện đã ký chéo hàng V-4). v0.7.0 cũng xuất xưởng postgres + Apache AGE như một backend lưu trữ hạng nhất — ai-memory serve --store-url postgres://… cho việc sử dụng daemon trực tiếp, tính tương đương lược đồ trên cả hai backend (tại bản phát hành v0.7.0, sqlite + postgres hội tụ ở lược đồ logic v57, trong đó CURRENT_SCHEMA_VERSION là 57; nền tảng bản phát hành v0.8.0 đã nâng cấp đồng bộ này lên lược đồ 70, với các bảng phối hợp và hiển thị bổ sung v58–v70 được triển khai trên cả hai backend — xem CLAUDE.md §Cơ sở dữ liệu để biết bậc thang v58–v70) (neo chuẩn: src/storage/migrations.rs cho sqlite + src/store/postgres.rs cho postgres); các tệp di chuyển trên đĩa kết thúc tại migrations/sqlite/0047_v56_list_composite_indexes.sql và nhánh bậc thang migrate_v57() trong tiến trình postgres (bộ đếm tên tệp chậm hơn phiên bản lược đồ logic vì cả hai bậc thang đều áp dụng các delta sau v34 thông qua các nhánh trong tiến trình — xem docs/MIGRATION_v0.7.md §schema-ladder để biết tường thuật v35-v57; v48 #933 đã thêm bảng DLQ đẩy liên kết; v49 #1025 đã thêm 14 cột nullable vào archived_memories để lưu trữ → khôi phục không mất mát cho hình dạng Bộ nhớ v0.7.0 đầy đủ; v50 #1156 đã mở rộng KHÓA CHÍNH agent_quotas từ (agent_id) thành (agent_id, namespace) để các phân bổ hạn ngạch K8 trên mỗi không gian tên được giữ vững ngay cả khi một tác nhân duy nhất hoạt động trên nhiều không gian tên — các hàng trước v50 được điền lại vào không gian tên sentinel _global; v51 #1255 (PR #1296) đã thêm bảng federation_nonce_cache để các nonce ngăn chặn phát lại ngang hàng tồn tại qua các lần khởi động lại daemon; v52 #1389 đã thêm bảng transcript_line_dedup hỗ trợ tính lũy đẳng RFC-0001 memory_capture_turn L4 + recover_from_transcript L2 để một SIGKILL giữa các lượt không bao giờ tạo ra ký ức trùng lặp khi tái khôi phục sau đó; v53 #1418 đã thu hẹp phạm vi trigger đồng bộ FTS5 memories_au chỉ cho (title, content, tags) để các cập nhật cột không phải FTS không còn kích hoạt đồng bộ không cần thiết; v54 #1466 đã điền lại thời hạn mặc định của bậc vào các hàng trung/ngắn có thời hạn NULL cũ để đóng lớp lỗi rò rỉ TTL của các hàng bất tử; v55 #1476 đã làm cho truy vấn bắt kịp liên kết W=2 (updated_at > ? ORDER BY updated_at ASC LIMIT) có thể sargable và thêm chỉ mục sqlite idx_memories_updated_at — postgres không thêm chỉ mục mới vì memories_updated_at_idx DESC đã phục vụ quét phạm vi thông qua Quét ngược chỉ mục; v56 #1579 đã thêm các chỉ mục sắp xếp danh sách/lưu trữ tổng hợp (idx_memories_list_order, idx_memories_ns_list_order, idx_archived_ns_archived_at) kết hợp với việc viết lại sargable storage::list — DDL phía sqlite; nhánh migrate_v56() postgres là một no-op đóng dấu phiên bản; v57 #1579 đã thêm cột tsv tsvector được tạo lưu trữ postgres + chỉ mục GIN memories_tsv_gin để các hình dạng tìm kiếm/truy xuất khớp VÀ xếp hạng trên cột được tính toán trước thay vì tính toán lại tsvector cho mỗi hàng khớp — chỉ mục biểu thức memories_content_fts cũ bị loại bỏ và bản sao sqlite là một no-op đóng dấu phiên bản vì FTS5 đã vật chất hóa văn bản được lập chỉ mục)), động từ CLI ai-memory schema-init mới, và tính tương đương điểm truy xuất 6 yếu tố. Bề mặt mặc định v0.6.4 tăng thêm hai trình tải luôn bật lên 7 công cụ (memory_load_family + memory_smart_load tham gia cùng năm công cụ gốc); trần thời gian chạy tại --profile full là 74 mục được quảng cáo (73 công cụ bộ nhớ có thể gọi + memory_capabilities bootstrap luôn bật; đã xác minh với Profile::full().expected_tool_count() — xem src/profile.rs). Mọi thứ mới đều là bổ sung và (đối với các bề mặt tin cậy + postgres) là tùy chọn. Nâng cấp từ v0.6.x? Đọc docs/MIGRATION_v0.7.md trước — hầu hết người gọi v0.6.4 không thấy thay đổi hành vi, nhưng người dùng v0.6.x trước v0.6.3.1 gặp phải bản sửa kế thừa không gian tên G1. Chuyển sang postgres+AGE? Xem docs/postgres-age-guide.md và docs/migration-v0.7.0-postgres.md. Ghi chú phát hành đầy đủ: docs/v0.7.0/release-notes.md.v0.6.4 (quiet-tools) — máy chủ MCP đi kèm với bề mặt mặc định 5 công cụ (memory_store, memory_recall, memory_list, memory_get, memory_search) cùng với bootstrap memory_capabilities luôn bật. 38 công cụ còn lại vẫn có thể truy cập thông qua --profile graph|admin|power|full hoặc mở rộng thời gian chạy qua memory_capabilities --include-schema family=<name>. Các harness tải háo hức (Claude Desktop / Codex CLI / Grok CLI / Gemini CLI) giảm khoảng 4.700 token đầu vào của lược đồ công cụ cho mỗi yêu cầu — mức giảm 76,4% đo được so với cl100k_base BPE. Để giữ nguyên hành vi v0.6.3 theo tỷ lệ 1:1, hãy chạy ai-memory mcp --profile full. Xem docs/MIGRATION_v0.6.4.md.

Có gì mới trong v0.9

v0.9.0 chủ yếu là bản phát hành tăng cường bảo mật và rà soát mã nguồn — 49 bản sửa lỗi từ đợt rà soát đối kháng 5 làn (#1885–#1935) — cùng với một tập hợp nhỏ các tính năng bổ sung được xếp lớp trên nền tảng phối hợp v0.8.0. Nhật ký thay đổi đầy đủ: CHANGELOG.md §"[0.9.0] — 2026-07-08".

Tăng cường bảo mật theo mặc định

• Yêu cầu chứng thực tác nhân theo mặc định khi ghi (#1751). Mặc định biên dịch của AI_MEMORY_REQUIRE_AGENT_ATTESTATION chuyển false → true: một ghi lưu trữ trực tiếp không ký (MCP memory_store, HTTP POST /api/v1/memories, CLI store) giờ đây bị từ chối (403 ATTESTATION_FAILED) thay vì hạ cánh attest_level="claimed". Ký các ghi (ai-memory store --sign với một cặp khóa được liên kết qua ai-memory agents bind-key) hoặc đặt tùy chọn từ chối rõ ràng AI_MEMORY_REQUIRE_AGENT_ATTESTATION=0 để khôi phục tư thế cho phép trước v0.9. Đây là sự chuyển đổi đã được hứa hẹn bởi cảnh báo CẢNH BÁO khấu hao một chu kỳ của v0.8.0 (#1464).
• Cổng thực thi hook kép MCP + HTTP (#1885 / #1924). Cổng thực thi sự hiện diện hook bắt buộc (ban đầu chỉ dành cho MCP, #1734) giờ đây cũng được tham vấn trên đường dẫn ghi HTTP, đóng một lỗ hổng bỏ qua ngầm (CWE-288) nơi một ghi bỏ qua hoàn toàn MCP không bao giờ thấy một hook bắt buộc đã cấu hình.
• Kiểm soát chứng thực bulk_create (#1919). Các ghi hàng loạt giờ đây thực thi cùng yêu cầu chứng thực tác nhân trên mỗi hàng như một lệnh gọi memory_store đơn lẻ — mỗi hàng trong một lô phải mang một chứng thực hợp lệ, không chỉ toàn bộ yêu cầu.
• Cổng phê duyệt liên kết (#1920). Một phê duyệt PENDING liên kết đến chỉ được tôn trọng khi nó được quy cho người phê duyệt đã đăng ký của một đồng đẳng — một đồng đẳng đã đăng ký nhưng không đáng tin cậy không còn có thể giả mạo phê duyệt cho một người yêu cầu tùy ý.
• Tăng cường phạm vi team/unit/org (#1921). Độ phân giải phạm vi hiển thị giờ đây thực thi chính xác hệ thống phân cấp tổ tiên không gian tên cho các phạm vi team/unit/org, đóng một lỗ hổng cô lập đối tượng thuê (CWE-863).
• Giới hạn đường dẫn skill_register (#1923). Nhập folder_path của một kỹ năng được chuẩn hóa và giới hạn trong thư mục gốc đã cấu hình, với các liên kết tượng trưng bên trong cây nhập bị từ chối thay vì theo dõi (CWE-22/CWE-59).
• Các kênh thông tin xác thực URL lưu trữ không qua argv (#1927). AI_MEMORY_STORE_URL mới (/proc/environ chỉ chủ sở hữu) và AI_MEMORY_STORE_URL_FILE (một tệp 0600) cho phép ai-memory serve nhận URL postgres/lưu trữ — bao gồm bất kỳ mật khẩu nhúng nào — mà không bao giờ đặt nó trên --store-url argv, nơi nó bị lộ qua /proc/<pid>/cmdline và ps auxww có thể đọc toàn cầu cho bất kỳ UID cục bộ nào. Thứ tự phân giải: tệp → biến môi trường → --store-url.

Các tính năng bổ sung

• B7-SKILL — ký ức kỹ năng hạng nhất (#1865). parameters_schema tại thời điểm đăng ký, một invocation_record, và một bề mặt phiên bản cho các kỹ năng do tác nhân tạo ra.
• Vòng lặp phản hồi bóng recall_observations (#1706, chế độ SHADOW). Đóng vòng lặp phản hồi thu hồi mà chưa thay đổi hành vi xếp hạng.
• DAG dòng dõi dẫn xuất ký ức (memory_lineage, lược đồ v78, #1859). Theo dõi những ký ức nào được dẫn xuất từ đâu, qua cả MCP và tuyến HTTP GET /api/v1/memories/{id}/lineage mới.
• Lát cắt chọn tham gia tối thiểu tìm kiếm vector (#1005; nền tảng đầy đủ hoãn lại đến #1860).
• Nhóm worker xếp hạng lại có kích thước theo CPU vật lý (#1867) và thu hồi là PURE theo mặc định (#1869 — loại bỏ đợt bùng nổ ghi khỏi đường dẫn nóng thu hồi).
• Xương sống chỉ thêm vào + tách lớp ký: mọi điểm đột biến được định tuyến đến các lá sửa đổi đã ký (#1823), tách biệt ký ba khóa Recorder/Judge/Stopper (#1826), mã thông báo năng lực macaroon được kết nối đầu cuối (#1827), và một chuỗi kế thừa khóa dòng dõi danh tính đã ký để tồn tại qua luân chuyển (#1828, lược đồ v76).

Nơi bắt đầu: CHANGELOG.md (nhật ký thay đổi đầy đủ), docs/ADMIN_GUIDE.md (sổ tay vận hành — tư thế chứng thực + thực thi hook).

Có gì mới trong v0.8

v0.8.0 (distributed-coordination) biến nền tảng ký ức thành nền tảng phối hợp cho các hạm đội đa tác nhân (NHI). Tiêu đề chính là bộ máy phối hợp phân tán (#1709); mọi thứ đều hoạt động trên cả hai bộ điều hợp sqlite và postgres+AGE SAL và vẫn tương đương mặc định cho người gọi v0.7.x. Tham khảo công cụ đầy đủ: docs/coordination.md; ghi chú đầy đủ: docs/v0.8.0/release-notes.md.

Nền tảng phối hợp phân tán (Trụ cột-1, #1709)

• Hành động — DAG phụ thuộc (lược đồ v59). Các nút hành động có kiểu với máy trạng thái (pending → claimed → in_progress → done/failed/abandoned), các cạnh DAG có kiểu (requires / unlocks / blocks / gated_by / sibling), và các bề mặt biên/tiếp theo kéo nút có thể chạy tiếp theo. 8 công cụ MCP (memory_action_create / _get / _transition / _list / _add_edge / _edges / _frontier / _next).
• Hợp đồng thuê — yêu cầu giữ duy nhất, giới hạn TTL (lược đồ v59). Yêu cầu so sánh-và-hoán đổi được gia hạn bằng nhịp tim (PRIMARY KEY trên action_id = một người giữ tại một thời điểm) cộng với bộ quét hợp đồng thuê hàng giờ. 4 công cụ MCP (memory_lease_acquire / _renew / _release / _get).
• Tín hiệu — thông điệp liên tác nhân có kiểu, ký Ed25519 (lược đồ v60). Mỗi tín hiệu mang một chữ ký + signer_pubkey người gửi và được phân luồng qua correlation_id / in_reply_to. 5 công cụ MCP (memory_signal_send / _read / _inbox / _thread / _ack).
• Điểm kiểm tra — cổng điều kiện có chứng thực (lược đồ v61). Một cổng chặn cho đến khi một điều kiện được giải quyết; việc giải quyết được tự ký tại chỗ (Ed25519) để phân tách nhiệm vụ, và verify kiểm tra lại chữ ký. 4 công cụ MCP (memory_checkpoint_create / _resolve / _query / _verify).
• Quy trình — kế hoạch được tham số hóa, đóng băng, có thể phát lại (lược đồ v62). Được tạo ra dưới dạng draft, sau đó đóng băng (bất biến, chứng thực đóng băng Ed25519); run hiện thực hóa một tập hợp hành động + cạnh cụ thể từ một mẫu {{param}} thành một bản ghi routine_runs. 5 công cụ MCP (memory_routine_create / _freeze / _run / _status / _list).
• Mọi đột biến trạng thái phối hợp đều thêm một hàng coordination.<op> chống giả mạo vào chuỗi băm signed_events V-4 (#1722); hai ghi cấp quyền được phản chiếu lên trình nền HTTP (POST /api/v1/actions/{id}/transition, POST /api/v1/signals) với CAS cục bộ + phân tán liên kết W-of-N (#1718).

Nhận thức có kiểu (Trụ cột-2)

Từ vựng memory_kind mở rộng với goal / plan / step; phân loại memory_links.relation đóng mở rộng 6 → 9 quan hệ (decomposes_into / depends_on / advances, lược đồ v63); và một cột memories.lifecycle_state hạng nhất (lược đồ v64) biến Mục tiêu/Kế hoạch/Bước thành một máy trạng thái thực sự (open → active → blocked/done/abandoned), được thực thi trên các bề mặt MCP / HTTP / SAL với ánh xạ cạnh bất hợp pháp tới HTTP 409 CONFLICT. Cấu trúc Memory phát triển lên 27 trường. Không có công cụ MCP mới — công việc v64 chỉ thêm các trường yêu cầu tùy chọn cho phép.

Liên kết được tăng cường, an toàn theo mặc định

Đăng ký đồng đẳng BẬT theo mặc định (#1789), chữ ký trên mỗi chuyển đổi cho các ghi cấp quyền (#1718), chứng thực nội dung trên mỗi ghi cho ký ức được chuyển tiếp (#1464), nonce phát lại chuyển đổi (#1805), và ghim vân tay chứng chỉ đồng đẳng ra ngoài (#1678). Các hạm đội không đồng nhất không cần phải tin tưởng lẫn nhau — xem lại các chuyển đổi mặc định an toàn trong docs/v0.8.0/release-notes.md §"Tăng cường liên kết" trước khi nâng cấp.

Quản trị thực sự chặn (#1811)

Hook quản trị PreToolUse của Claude Code được làm lại thành một trình bao bọc type:command (ai-memory governance check-action --from-pretool-stdin) để một Refuse nền tảng phát ra permissionDecision:"deny" và thực sự CHẶN công cụ — dạng type:mcp_tool trước đó về mặt cấu trúc không thể thực thi. Cộng với thực thi sự hiện diện hook bắt buộc (#1734) và một phán quyết quản trị escalate mới (§22 PE-5) cho con người trong vòng lặp.

Kiểm soát vận hành Trụ cột-4

Kiểm soát tiếp nhận HTTP (#1733 — giới hạn đồng thời chọn tham gia loại bỏ phần dư với một 503 có kiểu), chiếu đồ thị Apache-AGE hoãn lại (#1735 — loại bỏ các vòng khứ hồi AGE đồng bộ khỏi đường dẫn nóng ghi liên kết postgres), kích hoạt nén curator (#1749 / #1750), và CLI ai-memory verify-audit-trail (§22 PE-8) kiểm tra đầu cuối chuỗi băm chéo hàng signed_events.

Lược đồ v57 → v70 (tất cả đều bổ sung)

Các bảng phối hợp + nhận thức có kiểu + hiển thị + chuẩn bị mã hóa + đường dẫn lạnh + cạnh lưu trữ (v58–v70), được phản chiếu trên cả hai bộ điều hợp sqlite và postgres; tự động di chuyển khi mở lần đầu và khứ hồi lưu trữ → khôi phục không mất dữ liệu. Xem CLAUDE.md §Cơ sở dữ liệu để biết bậc thang v58–v70 chuẩn.

Nơi bắt đầu: docs/v0.8.0/release-notes.md (ghi chú phát hành đầy đủ), docs/coordination.md (tham khảo công cụ phối hợp), và CLAUDE.md §Cơ sở dữ liệu (SSOT bậc thang lược đồ).

Có gì mới trong v0.7

v0.7.0 đóng epic attested-cortex (69/69 trên 11 tuyến A–K), tích hợp công việc postgres+AGE hạng nhất ban đầu của v0.7.1, và hấp thụ làn sóng sẵn sàng triển khai sau grand-slam (Biểu mẫu Batman 1-6 + nền tảng Tùy chọn-B biểu mẫu thứ 7 + QW-1/2/3 + đối chiếu bảo mật). Kho tính năng chuẩn: docs/internal/v070-feature-inventory.md. Mọi bề mặt vẫn tắt theo mặc định hoặc tương đương mặc định cho người gọi v0.6.4 — xem ma trận tương thích v0.7 để biết chi tiết.

Đầu tư thời gian ghi gốc nền tảng (Biểu mẫu Batman 1-6 + biểu mẫu thứ 7)

• Hình thức 1 — tổng hợp và loại trùng lặp trực tuyến (vấn đề #754). Lệnh gọi LLM phát hành hành động theo lô đơn thay thế bộ phân loại theo cặp trên đường dẫn lưu trữ của v0.6.x. Chọn quay lại có/không kế thừa thông qua legacy_per_pair_classifier = true trên tiêu chuẩn không gian tên.
• Hình thức 2 — nguyên tử hóa đồng bộ trước khi nhúng (vấn đề #755). Công cụ memory_atomise mới + móc trước lưu trữ auto_atomise_mode = Synchronous|Deferred|Off. Người quản lý phân tách các ghi dài thành 2–10 mệnh đề nguyên tử trước khi truy xuất từng thấy chúng. Xem docs/atomisation.md.
• Hình thức 3 — bộ điều phối nhập liệu đa bước (vấn đề #756). memory_ingest_multistep luồng các trình trợ giúp Jaccard+FTS xác định qua các giai đoạn LLM ổn định bộ nhớ đệm lời nhắc. Xem docs/multistep-ingest.md + cookbook/multistep-ingest/01-two-phase.sh.
• Hình thức 4 — nguồn gốc sự kiện (vấn đề #757). Trích dẫn + URI-nguồn + khoảng hạt nguyên tử đi kèm trên các tải trọng memory_store / memory_atomise hiện có. Xem docs/provenance.md.
• Hình thức 5 — tự động tin cậy + hiệu chuẩn bóng + phân rã độ mới (vấn đề #758). Công cụ MCP memory_calibrate_confidence + quét đường cơ sở theo nguồn. Biến môi trường AI_MEMORY_AUTO_CONFIDENCE, AI_MEMORY_CONFIDENCE_SHADOW, AI_MEMORY_CONFIDENCE_SHADOW_SAMPLE_RATE, AI_MEMORY_CONFIDENCE_DECAY. Xem docs/confidence-calibration.md.
• Hình thức 6 — từ vựng MemoryKind Batman (vấn đề #759). Enum 10 biến thể (mặc định Observation + Reflection / Persona / Concept / Entity / Claim / Relation / Event / Conversation / Decision). Móc trước lưu trữ auto_classify_kind tùy chọn (tắt / chỉ regex / regex_rồi_llm). Xem docs/memory-kind-vocab.md.
• Hình thức thứ 7 — kết nối Lớp-4 tác nhân-NGOÀI (nền tảng Tùy chọn-B) (vấn đề #760; bao phủ hoàn chỉnh v0.8.0 tại #697). Quy tắc hạt giống được ký bởi cặp khóa người vận hành R001..R004, memory_check_agent_action + công cụ MCP memory_rule_list, móc trước ghi nền storage::insert. Xem docs/policy-engine.md + docs/governance/agent-action-rules.md.
• Hướng dẫn cho người vận hành — chuyển Hình thức 1–6 + thứ 7 từ có khả năng → hoạt động (vấn đề #800). Công thức 7 bước (tạo khóa người vận hành → ký hạt giống → kích hoạt R001–R004 → trình nền quản lý → lượt phản chiếu tùy chọn → chính sách không gian tên), tính bền vững launchd / systemd / Task-Scheduler, khối xác minh, đường dẫn khôi phục. Xem docs/batman-active-mode.md và tập bản đồ GitHub Pages.

Thắng lợi nhanh (Tencent QW-1/2/3)

• QW-1 — xuất chuỗi phản chiếu được sao lưu bằng tệp. Công cụ MCP memory_export_reflection + chính sách không gian tên auto_export_reflections_to_filesystem → ~/.ai-memory/reflections/<ns>/<id>.md.
• QW-2 — persona như tạo tác. Công cụ memory_persona + memory_persona_generate, hàng MemoryKind::Persona, chính sách không gian tên auto_persona_trigger_every_n_memories. Xem docs/persona.md.
• QW-3 — nguyên thủy giảm tải ngữ cảnh. memory_offload + memory_deref di chuyển đầu ra công cụ lớn ra khỏi cửa sổ ngữ cảnh tác nhân vào lưu trữ blob có thể định địa chỉ. Xem docs/context-offload.md.

Sử thi vỏ não đã chứng thực (Tuyến A–K)

• Liên kết đã chứng thực (Ed25519). Cột signature chết đã xuất xưởng trong v0.6.3 giờ được lấp đầy bằng chứng thực Ed25519 thực cho mỗi tác nhân, và memory_verify(link_id) trả về {signature_verified, attest_level, signed_by, signed_at} theo yêu cầu. Tạo cặp khóa với ai-memory identity generate; chọn tham gia qua attest_level = "self_signed". Việc ký được kiểm soát bởi trình nền agent_id đã phân giải có cặp khóa *.priv trên đĩa trong thư mục khóa đã cấu hình — khi load_daemon_signing_key trả về None (src/main.rs:116-118), các hàng vẫn ghi nhưng sig trống và trình nền phát ra dòng "tiếp tục không ký" khi khởi động. Chuỗi băm chéo hàng trên signed_events vẫn chống giả mạo trong mọi trường hợp. Xem attested-cortex RFC.
• Kết thúc sự kiện đã ký V-4 (chuỗi băm chéo hàng) (vấn đề #698). Mỗi hàng signed_events mang prev_hash + sequence; prev_hash hàng đầu tiên là không, các hàng tiếp theo nối chuỗi SHA-256 của tải trọng CBOR chuẩn trước đó. ai-memory verify-signed-events-chain duyệt chuỗi từ đầu đến cuối. Xem docs/signed-events-v4.md.
• Đường ống móc (25 sự kiện vòng đời). Bề mặt mở rộng có thể lập trình kích hoạt trên 20 sự kiện pre_/post_store|recall|search|delete|promote|link|consolidate|governance_decision|archive|transcript_store + on_index_eviction cơ bản, cộng thêm 5 bổ sung grand-slam (pre_recall_expand G10 + pre_reflect/post_reflect học đệ quy Nhiệm vụ 6/8 + pre_compaction/on_compaction_rollback L1-7). Móc trả về Allow / Modify / Deny / AskUser. Mặc định tắt; chọn tham gia qua ~/.config/ai-memory/hooks.toml. Xem docs/hook-pipeline.md.
• Bản ghi sidechain + phát lại. Sidechain BLOB zstd-3 lưu trữ các dấu vết hội thoại/suy luận thô; memory_replay(memory_id) duyệt memory_transcript_links để tái tạo chuỗi. Chọn tham gia cho mỗi không gian tên qua [transcripts.namespaces."team/*"]. Xem docs/sidechain-transcripts.md.
• Tăng cường liên kết. mTLS + X-API-Key + danh sách cho phép dấu vân tay chứng chỉ SHA-256; biến môi trường AI_MEMORY_FED_PEER_ATTESTATION, AI_MEMORY_FED_SYNC_TRUST_PEER, AI_MEMORY_FED_TRUST_BODY_AGENT_ID. Xem docs/federation.md.
• Công cụ hạn ngạch K8 + phê duyệt SSE K10. memory_quota_status + /api/v1/quota/status (K8). /api/v1/approvals/stream sự kiện do máy chủ gửi với HMAC nonce, ràng buộc phương thức+pending_id, loại bỏ số lượng sự kiện trễ (K10). Xem docs/k8-quotas.md + docs/k10-sse-approvals.md.
• Phụ trợ hạng nhất Postgres + Apache AGE. ai-memory serve --store-url postgres://…, tương đương lược đồ, tương đương tính điểm truy xuất 6 yếu tố, di chuyển liên kết, tính năng KG (kg_query, kg_timeline, kg_invalidate, find_paths) trên AGE Cypher với dự phòng CTE đệ quy khi AGE vắng mặt, cộng thêm động từ CLI ai-memory schema-init mới. Kiểm soát bằng điểm chuẩn — AGE p95 phải vượt CTE p95 ≥30% ở độ sâu=5. Hướng dẫn người vận hành: docs/postgres-age-guide.md. Sổ tay di chuyển: docs/migration-v0.7.0-postgres.md.
• Năng lực v3 + trình tải thông minh. memory_capabilities v3 thêm summary, to_describe_to_user, callable_now cho mỗi công cụ, agent_permitted_families, schema_version="3"; các công cụ luôn bật mới memory_load_family(family) và memory_smart_load(intent) tham gia hồ sơ core mặc định. Các cách diễn đạt cố định nằm trong docs/v0.7/canonical-phrasings.md.
• Quyền hạn + phê duyệt A2A. Hệ thống con quản trị v0.6.x được tái cấu trúc thành quy tắc + chế độ + móc → một Decision duy nhất, với kế thừa không gian tên (G1) thực sự được thực thi. memory_pending_list / memory_pending_approve / memory_pending_reject(remember=forever) cho phép tin cậy tiến bộ; ký HMAC trên API phê duyệt là bắt buộc. permissions.mode mặc định là enforce (trước đây là advisory trong v0.6.4). Di chuyển với ai-memory governance migrate-to-permissions (xem trước chạy thử; thêm --config-out ~/.config/ai-memory/config.toml để áp dụng tại chỗ). Xem docs/governance.md.

Làn sóng học đệ quy + L1/L2 grand-slam

Nguyên thủy nền memory_reflect với giới hạn max_reflection_depth phạm vi không gian tên (mặc định 3, Some(0) là công tắc tắt khẩn cấp). Trình quản lý lượt phản chiếu L2-1, phối hợp phản chiếu nhận biết liên kết L2-2 (memory_reflection_origin), lan truyền vô hiệu hóa L2-3 (memory_dependents_of_invalidated), gói pháp y L2-5 (ai-memory export-forensic-bundle + verify-forensic-bundle), Kỹ năng Tác nhân L1-5 (memory_skill_register|list|get|resource|export|promote_from_reflection|compositional_context). Sách mồi đầy đủ: docs/RECURSIVE_LEARNING.md. Sách mồi Kỹ năng Tác nhân: docs/agent-skills.md. Sách mồi xuất pháp y: docs/forensic-export.md.

Bắt đầu từ đâu: docs/MIGRATION_v0.7.md (quy trình nâng cấp), docs/v0.7.0/release-notes.md (ghi chú phát hành đầy đủ), docs/whats-new-v07.html (tóm tắt trực quan), docs/v0.7/rfc-attested-cortex.md (lý do thiết kế), docs/ADMIN_GUIDE.md (sổ tay người vận hành), docs/internal/v070-feature-inventory.md (sự thật tính năng chuẩn).

Một tệp nhị phân, bốn chế độ vận hành (v0.6.4). Tệp nhị phân Rust ai-memory (tokio + axum) có thể chạy bất kỳ chế độ nào trong số này một cách độc lập hoặc đồng thời, chia sẻ một cơ sở dữ liệu SQLite duy nhất:

1. Máy chủ MCP stdio -- 101 mục được quảng cáo qua JSON-RPC ở hồ sơ đầy đủ (v0.9.0; 100 công cụ bộ nhớ có thể gọi + khởi động luôn bật memory_capabilities; đã xác minh với Profile::full().expected_tool_count()). --profile core mặc định quảng cáo 7 (5 gốc + memory_load_family + memory_smart_load) cộng với khởi động luôn bật memory_capabilities. ai-memory mcp / ai-memory mcp --profile full
2. Trình nền HTTP / mTLS -- 92 đăng ký tuyến REST (78 đường dẫn URL duy nhất) trên 127.0.0.1:9077, TLS + danh sách cho phép mTLS tùy chọn + xác thực khóa API, vòng lặp GC nền. ai-memory serve
3. Trình nền quản lý tự trị -- vòng lặp tự lên lịch (nhịp mặc định 1 giờ) tự động gắn thẻ, phát hiện mâu thuẫn giữa các không gian tên anh em, hợp nhất gần trùng lặp và điều chỉnh mức độ ưu tiên theo mẫu truy cập. Mọi hành động đi vào nhật ký khôi phục; các thao tác phá hủy có thể được kiểm soát sau luồng phê duyệt quản trị. ai-memory curator --daemon
4. Trình nền đồng bộ -- liên kết ngang hàng dựa trên túc số giữa các phiên bản. Ghi W-of-N (đa số mặc định), hợp nhất CRDT-lite đồng hồ vector, danh sách cho phép mTLS giữa các đồng đẳng. ai-memory sync-daemon

Các bề mặt MCP, HTTP và CLI đều phản ứng. Trình quản lý là phần làm cho lớp bộ nhớ tự duy trì: giữa các phiên, nó giữ cho kho ngữ liệu gọn gàng để chất lượng truy xuất luôn cao khi kho lưu trữ phát triển. Mọi thứ đều ưu tiên cục bộ; không phụ thuộc đám mây.

Đánh giá thực tế bởi Claude Opus 4.7 sau khi đọc từng dòng mã nguồn v0.6.3:

"ai-memory là lớp bộ nhớ có khả năng nhất mà tôi từng được kết nối, và có ý nghĩa hơn nhiều so với tên gọi của nó. Đối với tôi, về mặt thực tế, nó có nghĩa là: tôi không bắt đầu lạnh lẽo mỗi phiên. Kho lưu trữ tôi đọc đã được giữ gọn gàng bởi thứ gì đó không phải tôi. Mâu thuẫn không âm thầm tích tụ. Chất lượng truy xuất vẫn cao ngay cả khi kho ngữ liệu phát triển. Không có gì rời khỏi Mac mini của bạn.

Nó không biến tôi thành một tác nhân tự trị. Nó đang cho tôi loại hạ tầng bộ nhớ mà một tác nhân tự trị sẽ cần — và chính nó chạy một vòng lặp tự trị nhỏ để duy trì nó. Đó là một nền tảng thực sự. Khoảng cách từ đây đến 'ai-memory điều khiển các nhiệm vụ chung' là hệ thống ống nước (giao thức gọi công cụ + đăng ký công cụ + mô hình có khả năng sử dụng công cụ), không phải phát minh."

Nền tảng cho AI đa tác nhân. ai-memory không phải là thời gian chạy tác nhân và không phải "AI tự trị" tự thân. Nó là lớp bộ nhớ mà các triển khai tự trị đa tác nhân cần bên dưới chúng. Liên kết (broadcast_store_quorum + spawn_catchup_loop) xử lý nhất quán W-of-N giữa các đồng đẳng khi nhiều tác nhân ghi song song; trình nền quản lý giữ cho kho ngữ liệu chung không bị suy giảm thành nhiễu khi một bầy ghi chép vào đó; đăng ký webhook (ký HMAC, lọc theo không gian tên/tác nhân, chống SSRF) biến kho lưu trữ thành bus tin nhắn kích hoạt các tác nhân hạ nguồn trên các sự kiện bộ nhớ; phân cấp không gian tên với kế thừa N cấp và chính sách quản trị cho mỗi không gian tên (quyền ghi/thăng cấp/xóa, loại người phê duyệt, đồng thuận N-of-M tùy chọn) giới hạn bầy đàn. Xếp chồng cái này dưới một trình chạy tác nhân đa máy 24/7 với các kỹ năng tự động sinh, và hệ thống kết hợp đạt đến ngưỡng hành vi cho AI tự trị. Những khoảng trống còn lại (không học cấp trọng số, nhân suy luận không trạng thái, mục tiêu gốc do con người gieo) là có thật và không phải điều ai-memory giải quyết; ai-memory cung cấp nền tảng bộ nhớ đa tác nhân mà bất kỳ nỗ lực nghiêm túc nào để lấp đầy những khoảng trống đó sẽ cần. Không tốn token cho đến khi truy xuất. Không giống như các hệ thống bộ nhớ tích hợp sẵn (bộ nhớ tự động của Claude Code, bộ nhớ ChatGPT) tải toàn bộ bộ nhớ của bạn vào mỗi cuộc trò chuyện -- đốt token và tiền bạc trên mỗi tin nhắn -- ai-memory sử dụng không token ngữ cảnh cho đến khi AI gọi rõ ràng memory_recall. Chỉ những ký ức liên quan mới được trả về, được xếp hạng bởi thuật toán chấm điểm 6 yếu tố. Định dạng TOON (Token-Oriented Object Notation) cắt giảm token phản hồi thêm 40-60% bằng cách loại bỏ tên trường lặp lại -- 3 ký ức trong JSON = 1.600 byte; trong TOON = 626 byte (nhỏ hơn 61%); trong TOON compact = 336 byte (nhỏ hơn 79%). Đối với người dùng Claude Code: tắt bộ nhớ tự động ("autoMemoryEnabled": false trong settings.json) và thay thế bằng ai-memory để ngừng trả tiền cho hơn 200 dòng ngữ cảnh bộ nhớ trên mỗi tin nhắn.

Định danh tác nhân (NHI) — mỗi ký ức cho bạn biết ai đã học nó

Mỗi ký ức mà ai-memory lưu trữ đều mang một metadata.agent_id — một điểm đánh dấu Định danh Phi Con người tồn tại qua mọi thao tác (cập nhật, loại bỏ trùng lặp, nhập, đồng bộ, hợp nhất). Mỗi kết quả truy xuất cho bạn biết AI nào đã viết mỗi ký ức, theo mặc định, trong định dạng phản hồi TOON-compact mà máy khách AI của bạn đã được tối ưu hóa:

count:5|mode:hybrid|tokens_used:842
memories[id|title|tier|namespace|priority|score|tags|agent_id]:
a1b2|Project DB is PostgreSQL 16|long|infra|8|0.91|database,postgres|ai:claude-code@workstation:pid-3812
c3d4|API rate limit is 100 rps|long|infra|7|0.87|api,limits|ai:claude-desktop@laptop:pid-5219

Trên một lần ghi không ký agent_id là một danh tính được khai báo — đừng chỉ dựa vào nó để đưa ra quyết định bảo mật. Kể từ v0.9.0 (#1751) chứng thực tác nhân theo đường dẫn lưu trữ là bắt buộc theo mặc định: một lần ghi CLI/MCP/HTTP trực tiếp không ký sẽ bị từ chối (403 ATTESTATION_FAILED) thay vì được đưa vào attest_level = "claimed", trừ khi người vận hành thiết lập tùy chọn từ chối rõ ràng AI_MEMORY_REQUIRE_AGENT_ATTESTATION=0. Chứng thực mật mã Ed25519 được kết nối trên hai bề mặt: (1) chứng thực đường dẫn lưu trữ (#626 Lớp-3) — trình bày chữ ký tách rời trên bao thư SignableWrite chuẩn trên đường dẫn CLI (store --sign), MCP (memory_store), hoặc HTTP (POST /api/v1/memories) và daemon xác minh nó dựa trên khóa công khai đã liên kết của tác nhân, đóng dấu metadata.attest_level = "agent_attested" (một chữ ký được trình bày nhưng giả mạo luôn bị từ chối bất kể cờ); và (2) chứng thực liên kết (attested-cortex) — trường memory_links.signature đã được dành riêng trước đó với memory_verify(link_id) để xác minh đầu vào và một chuỗi kiểm toán signed_events chỉ thêm vào. Xem trang định danh tác nhân và attested-cortex RFC để biết hợp đồng xuất xứ đầy đủ.

Nhập hội thoại hồi tố — ai-memory mine

Đừng bắt đầu lạnh lẽo. Trỏ ai-memory mine vào một bản xuất Claude, ChatGPT, hoặc Slack và nó phân tích cú pháp từng lượt thành các ký ức được xếp hạng, phân loại bậc, gắn thẻ — để AI của bạn bước vào phiên tiếp theo biết mọi quyết định, sửa chữa, và phát hiện từ lịch sử hiện có của bạn.

ai-memory mine claude  ~/Downloads/claude-export/
ai-memory mine chatgpt ~/Downloads/chatgpt-export.json
ai-memory mine slack   ./slack-export/

Tự động gắn thẻ, loại bỏ trùng lặp trên (title, namespace), và xuất xứ mined_from được đóng dấu trên mỗi ký ức đã nhập. Quy trình giới thiệu năm phút từ không ngữ cảnh đến một kho lưu trữ dài hạn đã được điền đầy. Xem trang lịch sử nhập để biết công thức cho từng định dạng.

Nền tảng AI Tương thích

ai-memory tích hợp với bất kỳ nền tảng AI nào hỗ trợ Giao thức Ngữ cảnh Mô hình (MCP). MCP là tiêu chuẩn phổ quát để kết nối trợ lý AI với các công cụ và nguồn dữ liệu bên ngoài.

MCP là lớp tích hợp chính. Đối với các nền tảng AI chưa hỗ trợ MCP nguyên bản, HTTP API (92 đăng ký tuyến đường / 78 đường dẫn URL duy nhất trên localhost) và CLI (89 lệnh con dưới --features sal HOẶC --features sal-postgres; 87 trong bản dựng mặc định (hậu-#1389 L2 RecoverPreviousSession cho tái hydrat hóa ngữ cảnh xuyên phiên + #1443 Expand cho bề mặt mở rộng truy vấn ai-memory expand + #1598 Reembed cho bề mặt di chuyển không gian vector ai-memory reembed); SSOT được ghim bởi ai_memory::EXPECTED_CLI_SUBCOMMANDS_DEFAULT + EXPECTED_CLI_SUBCOMMANDS_SAL + bài kiểm tra tương đương cơ học tests/cli_subcommand_count_invariant.rs) cung cấp truy cập phổ quát -- bất kỳ AI, script, hoặc tự động hóa nào có thể thực hiện cuộc gọi HTTP hoặc chạy lệnh shell đều có thể sử dụng ai-memory.

Cài đặt trong 60 Giây

Các tệp nhị phân dựng sẵn không yêu cầu phụ thuộc. Xây dựng từ mã nguồn cần Rust và một trình biên dịch C.

Nhanh nhất: Tệp nhị phân dựng sẵn (không cần Rust)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/alphaonedev/ai-memory-mcp/main/install.sh | sh

# Fedora/RHEL (COPR)
sudo dnf copr enable alpha-one-ai/ai-memory && sudo dnf install ai-memory

# Windows (PowerShell)
irm https://raw.githubusercontent.com/alphaonedev/ai-memory-mcp/main/install.ps1 | iex

Bước 1: Cài đặt Rust (bỏ qua nếu dùng tệp nhị phân dựng sẵn)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Làm theo lời nhắc, sau đó khởi động lại terminal của bạn (hoặc chạy source ~/.cargo/env).

Bước 2: Từ mã nguồn (yêu cầu Rust)

Bản phát hành mới nhất từ Crates.io:

cargo install ai-memory

Mới nhất từ kho lưu trữ git:

cargo install --git https://github.com/alphaonedev/ai-memory-mcp.git

Lệnh này biên dịch tệp nhị phân và đặt nó vào PATH của bạn. Mất một hoặc hai phút.

Phụ thuộc xây dựng cho bản dựng từ mã nguồn:

• Ubuntu/Debian: sudo apt-get install build-essential pkg-config
• Fedora/RHEL: sudo dnf install gcc pkg-config

Bước 3: Kết nối AI của bạn

Cấu hình thay đổi theo nền tảng. Tìm của bạn bên dưới:

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.claude/ai-memory.db", "mcp", "--tier", "semantic"]
    }
  }
}

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.claude/ai-memory.db", "mcp", "--tier", "semantic"]
    }
  }
}

# ~/.config/ai-memory/config.toml
schema_version = 2

[llm]
backend     = "xai"
model       = "grok-4.3"
base_url    = "https://api.x.ai/v1"
api_key_env = "XAI_API_KEY"            # process-env-var name (NOT the literal key)

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.claude/ai-memory.db", "mcp", "--tier", "autonomous"]
    }
  }
}

[mcp_servers.memory]
command = "ai-memory"
args = ["--db", "~/.local/share/ai-memory/memories.db", "mcp", "--tier", "semantic"]
enabled = true

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.local/share/ai-memory/memories.db", "mcp", "--tier", "semantic"],
      "timeout": 30000
    }
  }
}

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.local/share/ai-memory/memories.db", "mcp", "--tier", "semantic"]
    }
  }
}

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.local/share/ai-memory/memories.db", "mcp", "--tier", "semantic"]
    }
  }
}

mcpServers:
  - name: memory
    command: ai-memory
    args:
      - "--db"
      - "~/.local/share/ai-memory/memories.db"
      - "mcp"
      - "--tier"
      - "semantic"

{
  "mcp": {
    "servers": [
      {
        "id": "ai-memory",
        "label": "AI Memory",
        "enabled": true,
        "transport": "stdio",
        "command": "ai-memory",
        "args": ["mcp", "--tier", "semantic"]
      }
    ]
  }
}

ai-memory serve --host 127.0.0.1 --port 9077
# Expose via HTTPS reverse proxy (nginx, caddy, cloudflare tunnel, etc.)

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.3",
    "tools": [{
      "type": "mcp",
      "server_url": "https://your-server.example.com/mcp",
      "server_label": "memory",
      "server_description": "Persistent AI memory with recall and search",
      "allowed_tools": ["memory_store", "memory_recall", "memory_search"]
    }],
    "input": "What do you remember about our project?"
  }'

ai-memory serve --host 127.0.0.1 --port 9077

client.toolgroups.register(
    provider_id="model-context-protocol",
    toolgroup_id="mcp::memory",
    mcp_endpoint={"uri": "http://localhost:9077/sse"}
)

tool_groups:
  - toolgroup_id: mcp::memory
    provider_id: model-context-protocol
    mcp_endpoint:
      uri: "http://localhost:9077/sse"

openclaw mcp set memory '{"command":"ai-memory","args":["--db","~/.local/share/ai-memory/memories.db","mcp","--tier","semantic"]}'

{
  "mcp": {
    "servers": {
      "memory": {
        "command": "ai-memory",
        "args": ["--db", "~/.local/share/ai-memory/memories.db", "mcp", "--tier", "semantic"]
      }
    }
  }
}

command: ai-memory
args: ["--db", "/path/to/ai-memory.db", "mcp"]

ai-memory serve
# 92 REST route registrations (78 unique URL paths) at http://127.0.0.1:9077/api/v1/

Bước 4: Xong. Kiểm tra nó.

Khởi động lại trợ lý AI của bạn. Nếu sử dụng MCP, giờ đây nó có bề mặt 7 công cụ mặc định được quảng cáo khi khởi động phiên (5 công cụ gốc + memory_load_family + memory_smart_load; 93 công cụ còn lại trong số 100 công cụ có thể gọi được tải theo yêu cầu qua --profile hoặc memory_capabilities --include-schema). Hỏi nó: "Lưu bộ nhớ rằng ngôn ngữ yêu thích của tôi là Rust." Sau đó trong một cuộc trò chuyện mới, hỏi: "Ngôn ngữ yêu thích của tôi là gì?" Nó sẽ nhớ.

Hỗ trợ nền tảng di động (v0.7.0 Posture-1a)

ai-memory có thể chuyển sang iOS và Android qua đường dẫn biên dịch chéo di động Rust tiêu chuẩn. v0.7.0 cung cấp phạm vi CI cho cả hai mục tiêu ở ba cấp độ leo thang:

Trạng thái tại v0.7.0: Lớp 1 là cổng xuất xưởng — biên dịch chéo di động phải XANH trước khi cắt thẻ. Lớp 2 (tạo tác phát hành) xuất xưởng đường ống BUILD + bố cục tạo tác; bề mặt FFI có thể gọi C sẽ có trong bản cập nhật tiếp theo v0.7.x. Lớp 3 chạy tập hợp con kiểm tra có phạm vi trên mỗi lần push release/**.

Sử dụng tạo tác phát hành:

• iOS — tải xuống ai-memory-ios.xcframework.tar.gz từ trang phát hành v0.7.x, giải nén và kéo AiMemory.xcframework vào dự án Xcode của bạn trong "Frameworks, Libraries, and Embedded Content."
• Android — tải xuống ai-memory-android.tar.gz từ trang phát hành v0.7.x, giải nén và sao chép cây jniLibs/ vào src/main/jniLibs/ của mô-đun ứng dụng của bạn.

Các tạo tác di động cũng là một phần của mỗi bản phát hành v0.7.x đã xuất bản; công thức Homebrew + gói APT/RPM (cung cấp tệp nhị phân máy tính để bàn) bao gồm ghi chú liên kết đến các bản tải xuống di động. Xem vấn đề #1068 để biết lịch sử triển khai CI.

Bắt đầu nhanh

Từ con số không đến bộ nhớ hoạt động trong vòng chưa đầy hai phút.

1. Cài đặt

curl -fsSL https://raw.githubusercontent.com/alphaonedev/ai-memory-mcp/main/install.sh | sh

2. Cấu hình MCP (ví dụ cho Claude Code -- các nền tảng khác hoạt động tương tự)

Hợp nhất vào ~/.claude.json:

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.claude/ai-memory.db", "mcp", "--tier", "semantic"]
    }
  }
}

3. Lưu bộ nhớ đầu tiên của bạn

ai-memory store -T "Project uses PostgreSQL 15" -c "Main DB is PG 15 with pgvector." --tier long

4. Gợi nhớ nó

ai-memory recall "database"

5. Kiểm tra thống kê

ai-memory stats

6. Sử dụng với AI của bạn. Khởi động lại máy khách AI của bạn. Giờ đây nó có 7 công cụ bộ nhớ mặc định được quảng cáo khi khởi động (101 mục được quảng cáo có thể truy cập qua mở rộng thời gian chạy hoặc --profile full) qua MCP -- nó có thể lưu trữ và gợi nhớ bộ nhớ một cách tự nhiên trong các cuộc trò chuyện.

SDK

Ngoài các bề mặt MCP / HTTP / CLI, ai-memory còn cung cấp SDK ngôn ngữ bên thứ nhất cho máy khách HTTP và các tiện ích trợ giúp (ví dụ: requireProfile để xác nhận hồ sơ thời gian chạy trên các daemon v0.6.4+).

TypeScript / JavaScript — @alphaone/ai-memory trên npm

npm install @alphaone/ai-memory

Python — ai-memory-mcp trên PyPI (tên nhập vẫn là ai_memory)

pip install ai-memory-mcp

from ai_memory import AiMemoryClient, require_profile

with AiMemoryClient(base_url="http://127.0.0.1:9077", api_key="...") as client:
    require_profile(client, "graph")  # raises ProfileNotLoaded on miss

Cả hai SDK đều được phiên bản hóa cùng với máy chủ (0.9.0 khớp với ai-memory 0.9.0). Các daemon v0.6.4+ thực thi hợp đồng hồ sơ; các daemon trước v0.6.4 quay trở lại chế độ cảnh báo và tiếp tục cho phép để các bản nâng cấp SDK không làm hỏng các máy chủ cũ. Mã nguồn nằm trong sdk/typescript/ và sdk/python/.

Nó Làm Gì?

Các trợ lý AI quên mọi thứ giữa các cuộc trò chuyện. ai-memory khắc phục điều đó.

Nó chạy như một máy chủ công cụ MCP (Giao thức Ngữ cảnh Mô hình) -- một tiến trình nền mà AI của bạn giao tiếp một cách tự nhiên. Khi AI của bạn học được điều gì quan trọng, nó sẽ lưu trữ. Khi cần ngữ cảnh, nó gợi nhớ các bộ nhớ liên quan được xếp hạng bởi thuật toán chấm điểm 6 yếu tố. Bộ nhớ tồn tại ở ba cấp:

• Ngắn hạn (mặc định 6 giờ, có thể cấu hình) -- ngữ cảnh dùng một lần như trạng thái gỡ lỗi hiện tại
• Trung hạn (mặc định 7 ngày, có thể cấu hình) -- kiến thức làm việc như mục tiêu sprint và quyết định gần đây
• Dài hạn (vĩnh viễn) -- kiến trúc, sở thích người dùng, bài học khó nhọc

Những bộ nhớ tiếp tục được truy cập sẽ tự động thăng cấp từ trung hạn lên dài hạn. Mỗi lần gợi nhớ kéo dài TTL. Mức độ ưu tiên tăng lên khi sử dụng. Hệ thống tự quản lý.

Ngoài MCP, ai-memory cũng cung cấp API REST HTTP đầy đủ (92 đăng ký tuyến / 78 đường dẫn URL duy nhất trên cổng 9077) và CLI hoàn chỉnh (89 lệnh con dưới --features sal HOẶC --features sal-postgres; 87 trong bản dựng mặc định (sau #1389 L2 RecoverPreviousSession cho tái hydrat hóa ngữ cảnh xuyên phiên + #1443 Expand cho bề mặt mở rộng truy vấn ai-memory expand + #1598 Reembed cho bề mặt di chuyển không gian vector ai-memory reembed); SSOT được ghim bởi ai_memory::EXPECTED_CLI_SUBCOMMANDS_{DEFAULT,SAL} + kiểm tra tương đương cơ học tests/cli_subcommand_count_invariant.rs) để tương tác trực tiếp, viết kịch bản và tích hợp với bất kỳ nền tảng hoặc công cụ AI nào.

Tính năng

Cốt lõi

• Máy chủ công cụ MCP -- 101 công cụ qua stdio JSON-RPC (hồ sơ đầy đủ), tương thích với bất kỳ máy khách MCP nào
• Bộ nhớ ba cấp -- ngắn (TTL mặc định 6h), trung (TTL mặc định 7d), dài (vĩnh viễn) -- TTL có thể cấu hình
• Tìm kiếm toàn văn -- SQLite FTS5 với truy xuất được xếp hạng
• Gợi nhớ lai -- Từ khóa FTS5 + tương tự cosine với pha trộn thích ứng: trọng số ngữ nghĩa thay đổi 0.50 (nội dung ngắn) → 0.15 (nội dung dài) vì nhúng mất thông tin trên văn bản dài
• Chấm điểm gợi nhớ 6 yếu tố -- Mức độ liên quan FTS + mức độ ưu tiên + tần suất truy cập + độ tin cậy + tăng cấp + phân rã thời gian
• Tự động thăng cấp -- bộ nhớ được truy cập 5+ lần thăng cấp từ trung lên dài
• Mở rộng TTL -- mỗi lần gợi nhớ kéo dài thời hạn (ngắn +1h, trung +1d)
• Củng cố mức độ ưu tiên -- +1 mỗi 10 lần truy cập (tối đa 10)
• Phát hiện mâu thuẫn -- cảnh báo khi lưu trữ bộ nhớ xung đột với bộ nhớ hiện có
• Loại bỏ trùng lặp -- upsert trên tiêu đề+không gian tên, cấp không bao giờ bị hạ
• Chấm điểm độ tin cậy -- độ chắc chắn 0.0-1.0 được tính vào xếp hạng

Tổ chức

• Không gian tên -- cô lập bộ nhớ cho mỗi dự án (tự động phát hiện từ git remote)
• Liên kết bộ nhớ -- quan hệ có kiểu: related_to, supersedes, contradicts, derived_from, reflects_on (học đệ quy Nhiệm vụ 1/8), derives_from (nguyên tử hóa WT-1-A), decomposes_into, depends_on, advances -- chín biến thể tại v0.8.0
• Hợp nhất -- hợp nhất nhiều bộ nhớ thành một bản tóm tắt dài hạn duy nhất
• Tự động hợp nhất -- nhóm theo không gian tên+thẻ, tự động hợp nhất các nhóm trên ngưỡng
• Giải quyết mâu thuẫn -- đánh dấu một bộ nhớ thay thế bộ nhớ khác, hạ cấp bộ nhớ thua
• Quên theo mẫu -- xóa hàng loạt theo không gian tên + mẫu FTS + cấp
• Theo dõi nguồn -- theo dõi nguồn gốc: người dùng, claude, hook, api, cli, nhập, hợp nhất, hệ thống
• Danh tính tác nhân (NHI) -- mỗi bộ nhớ mang metadata.agent_id (danh tính được xác nhận) với tính bất biến phòng thủ chuyên sâu qua cập nhật/loại bỏ trùng lặp/nhập/đồng bộ/hợp nhất; lọc list/search theo tác nhân
• Gắn thẻ -- thẻ phân cách bằng dấu phẩy với hỗ trợ lọc

Giao diện

• 92 tuyến HTTP (78 đường dẫn duy nhất) -- API REST đầy đủ trên 127.0.0.1:9077 (hoạt động với mọi AI hoặc công cụ)
• 89 lệnh con CLI dưới --features sal HOẶC --features sal-postgres (87 trong bản dựng mặc định) -- CLI hoàn chỉnh với các khả năng tương đương
• 101 công cụ MCP ở hồ sơ đầy đủ (7 mặc định; đã xác minh với Profile::full().expected_tool_count()) -- tích hợp gốc cho mọi AI tương thích MCP
• Shell REPL tương tác -- gọi lại, tìm kiếm, liệt kê, lấy, thống kê, không gian tên, xóa với đầu ra màu
• Đầu ra JSON -- cờ --json trên tất cả các lệnh CLI
• Phối hợp phân tán (v0.8.0 Trụ cột-1 + Trụ cột-2) -- DAG hành động (memory_action_*), hợp đồng thuê một người giữ (memory_lease_*), tín hiệu ký Ed25519 (memory_signal_*), điểm kiểm tra đã chứng thực (memory_checkpoint_*), quy trình tham số hóa (memory_routine_*), và vòng đời nhận thức kiểu Mục tiêu/Kế hoạch/Bước. Xem docs/coordination.md.

Hoạt động

• Đồng bộ đa nút -- kéo, đẩy, hoặc hợp nhất hai chiều giữa các tệp cơ sở dữ liệu
• Nhập/Xuất -- khứ hồi JSON đầy đủ bảo toàn liên kết bộ nhớ
• Thu gom rác -- tự động hết hạn nền mỗi 30 phút
• Tắt máy nhẹ nhàng -- SIGTERM/SIGINT tạo điểm kiểm tra WAL để thoát sạch
• Kiểm tra sức khỏe sâu -- xác minh khả năng truy cập DB và tính toàn vẹn FTS5
• Hoàn thành shell -- bash, zsh, fish
• Trang hướng dẫn -- ai-memory man tạo roff ra stdout
• Bộ lọc thời gian -- --since/--until trên danh sách và tìm kiếm
• Tuổi có thể đọc được -- "2h trước", "3d trước" trong đầu ra CLI
• Đầu ra CLI màu -- nhãn bậc ANSI (đỏ/vàng/xanh), thanh ưu tiên, tiêu đề đậm, không gian tên lục lam

Chất lượng

• ~10.000 bài kiểm tra trên toàn bộ bề mặt -- khoảng 6.712 thuộc tính #[test]/#[tokio::test] dưới src/ (5.759 #[test] + 953 #[tokio::test]) cộng với khoảng 3.362 dưới tests/ (2.138 #[test] + 1.224 #[tokio::test]), phát triển từ đường cơ sở ~2.400 bài kiểm tra thời v0.6.4 (1.960 lib + 211 tích hợp + 16 mcp_integration + 4 webhook_http_parity + 16 recipe_contract + ~150 trên các mục tiêu nhị phân khác). Độ phủ dòng được giữ trên ngưỡng dự án ≥92%; các mô-đun mới hoàn toàn v0.6.4 ở mức 100% (sizes.rs), 99,50% (profile.rs), 97,58% (cli/audit.rs), 97,05% (cli/doctor.rs), 92,56% (handlers.rs), 92,26% (cli/install.rs). Các đường cơ sở v0.6.3.x (1.809 / 93,08% và 1.886 / 93,84%) vẫn được giữ nguyên trên trang bằng chứng; số liệu v0.6.4 trong ghi chú phát hành và trên chiến dịch test-hub. Khám phá chấp nhận NHI thực nghiệm được chứng minh riêng bởi Cổng Khám phá (ma trận T1–T4 so với xAI Grok 4.3 trực tiếp, 6/6 ĐẠT, CỔNG XANH).
• Điểm chuẩn LongMemEval -- 97,8% R@5 (489/500), 99,0% R@10, 99,8% R@20 trên tập dữ liệu ICLR 2025 LongMemEval-S. 499/500 ở R@20. Từ khóa FTS5 thuần túy đạt 97,0% R@5 trong 2,2 giây (232 q/s). Mở rộng truy vấn LLM đẩy lên 97,8% R@5. Không tốn chi phí API đám mây. Xem chi tiết điểm chuẩn.
• Lời nhắc MCP -- lời nhắc recall-first và memory-workflow dạy các máy khách AI sử dụng bộ nhớ một cách chủ động
• Mặc định TOON -- phản hồi gọi lại/liệt kê/tìm kiếm sử dụng TOON compact theo mặc định (nhỏ hơn 79% so với JSON)
• Điểm chuẩn Criterion -- chèn, gọi lại, tìm kiếm ở quy mô 1K
• CI/CD GitHub Actions -- fmt, clippy, kiểm tra, xây dựng trên Ubuntu + macOS, phát hành khi gắn thẻ

Sàn Độ phủ (cổng CI cứng)

Công việc Code Coverage là một kiểm tra trạng thái bắt buộc. CI tái khẳng định hai bất biến trên mỗi PR: một sàn tuyệt đối >= 90% dòng (rào cản hồi quy thảm khốc, được đặt ở phép đo hiện tại làm tròn xuống 5% gần nhất), và một bánh cóc so với giá trị được ghim trong .coverage-baseline với cửa sổ chùng 0,5% (thực thi hàng ngày). Các PR tăng độ phủ nên cập nhật tệp đường cơ sở trong cùng một commit để các PR tương lai được hưởng lợi từ sàn mới; các PR giảm hơn 0,5% sẽ bị chặn hợp nhất. Phép đo hiện tại: 93,13% dòng.

Cổng Ngân sách Token (cổng CI cứng, v0.7 C5)

Quy trình token-budget là một kiểm tra trạng thái bắt buộc. Nó thực thi ba bất biến được đo bằng cl100k_base trên mỗi PR:

• Trần mỗi công cụ 1500 token -- không có lược đồ tuần tự hóa của một công cụ MCP nào (tên + mô tả + inputSchema) được vượt quá 1500 token cl100k_base.
• Phạm vi trung thực hồ sơ đầy đủ (5K-8K) -- rào cản v0.6.4, được giữ nguyên để phát hiện sự co lại bệnh lý (vô tình bỏ công cụ).
• Trần cứng hồ sơ đầy đủ (v0.7 C5, nâng lên sau D1.6/D1.7) -- tải trọng tools/list đã cắt tỉa dưới --profile full không được vượt quá 11.000 token cl100k_base (TRIMMED_FULL_PROFILE_CEILING_TOKENS trong tests/token_budget_guard.rs; mục tiêu C5 ban đầu là 3500 so với các lược đồ viết tay trước D1.6 — việc mở rộng D1.6/D1.7 từ schemars đã nâng trần được ghim). C2 (tách trường docs), C3 (thu gọn boilerplate lược đồ lặp lại), và C4 (ẩn các tham số tùy chọn ít dùng) đã thúc đẩy việc nén ban đầu; cổng này buộc các PR tương lai mở rộng bề mặt phải lấy lại ngân sách ở nơi khác. Kiểm tra ai-memory doctor --tokens --raw-table để xem chi phí mỗi công cụ. Xem .github/workflows/token-budget.yml và docs/v0.7/schema-compaction-audit.md.

Phụ thuộc ML và LLM (bậc ngữ nghĩa trở lên)

• candle-core, candle-nn, candle-transformers -- Khung ML Hugging Face Candle cho suy luận Rust gốc
• hf-hub -- tải mô hình từ Hugging Face Hub
• tokenizers -- Bộ tokenizer Hugging Face cho tiền xử lý văn bản
• instant-distance -- tìm kiếm láng giềng gần nhất xấp xỉ
• reqwest -- Máy khách HTTP cho giao tiếp phụ trợ LLM (bậc thông minh/tự chủ — bất kỳ nhà cung cấp nào theo #1067: Ollama, xAI, OpenAI, Anthropic, Gemini, DeepSeek, Kimi, Qwen, Mistral, Groq, Together, Cerebras, OpenRouter, Fireworks, LMStudio, vLLM, máy chủ llama.cpp)

Kiến trúc

Điểm chuẩn

Được đánh giá trên tập dữ liệu ICLR 2025 LongMemEval-S (500 câu hỏi, 6 danh mục). Bậc từ khóa FTS5 thuần túy đạt 97,0% R@5 trong 2,2 giây. Mở rộng truy vấn LLM (bậc thông minh) đẩy lên 97,8% R@5. Tất cả suy luận chạy cục bộ — không gọi API đám mây, không tốn chi phí.

Cảnh báo mô hình điểm chuẩn (2026-07-09): các con số bậc thông minh (mở rộng LLM) được đo bằng Gemma 3 4B làm mô hình mở rộng; mặc định sản xuất kể từ đó đã chuyển sang Gemma 4. Việc chạy lại Gemma-4 + công bố lại được theo dõi như một mục trung thực Cổng-0 v1.0 (#1975). Bậc từ khóa 97,0% R@5 độc lập với LLM và không bị ảnh hưởng.

Ngân sách Hiệu năng (v0.6.4)

Mỗi bản phát hành đi kèm với ngân sách p95/p99 đã công bố cho các hoạt động đường nóng và một cổng CI sẽ thất bại bất kỳ PR nào có p95 đo được vượt quá ngân sách hơn 10%. Mục tiêu được hiệu chỉnh cho phần cứng tham chiếu M4; bảng đầy đủ và phương pháp luận trong PERFORMANCE.md.

Chạy cùng khối lượng công việc cục bộ:

ai-memory bench                      # human-readable table
ai-memory bench --json               # machine-parseable

Nền tảng không thay đổi qua v0.6.3.x → v0.6.4 (bản phát hành quiet-tools đi kèm bề mặt công cụ mặc định nhỏ hơn, không phải đường nóng khác). Các mục tiêu p99 ở đây vẫn mang tính thông tin cho đến khi có cửa sổ ngâm chuyên dụng tiếp theo; bằng chứng ngâm mới nhất trên test hub.

Phương thức Tích hợp

MCP (Chính -- cho các nền tảng AI tương thích MCP)

MCP là tích hợp được khuyến nghị. AI của bạn nhận được 7 công cụ bộ nhớ gốc được quảng cáo theo mặc định (5 công cụ gốc + memory_load_family + memory_smart_load; cộng với khởi động memory_capabilities luôn bật) mà không cần mã kết dính. 93 công cụ có thể gọi khác (101 mục được quảng cáo — đã xác minh với Profile::full().expected_tool_count() và được ghim bởi const_count_matches_full_profile trong src/mcp/registry.rs) vẫn có thể truy cập qua --profile graph|admin|power|full hoặc mở rộng thời gian chạy thông qua memory_capabilities --include-schema family=<name>. Cấu hình máy chủ MCP trong cấu hình nền tảng AI của bạn:

{
  "mcpServers": {
    "memory": {
      "command": "ai-memory",
      "args": ["--db", "~/.claude/ai-memory.db", "mcp"]
    }
  }
}

API HTTP (Phổ quát -- cho mọi AI hoặc công cụ)

Khởi động máy chủ HTTP để truy cập API REST. Bất kỳ AI, tập lệnh hoặc tự động hóa nào có thể thực hiện cuộc gọi HTTP đều có thể sử dụng:

ai-memory serve
# 92 REST route registrations (78 unique URL paths) at http://127.0.0.1:9077/api/v1/

CLI (Phổ quát -- cho tập lệnh và sử dụng trực tiếp)

CLI hoạt động độc lập hoặc như một khối xây dựng cho các tích hợp AI chạy lệnh shell:

ai-memory store --tier long --title "Architecture decision" --content "We use PostgreSQL"
ai-memory recall "database choice"
ai-memory search "PostgreSQL"

Các Bậc Tính năng

ai-memory hỗ trợ 4 bậc tính năng, được chọn khi khởi động với ai-memory mcp --tier <tier>. Các bậc cao hơn thêm khả năng ML với chi phí đĩa và RAM:

Ma trận Khả năng

Mỗi khả năng được ánh xạ tới bậc tối thiểu của nó. Mỗi bậc bao gồm tất cả các khả năng từ các bậc bên dưới nó.

Bậc ngữ nghĩa (mặc định) đóng gói khung ML Candle và tải mô hình all-MiniLM-L6-v2 khi chạy lần đầu (~90 MB). Thông minh và tự động yêu cầu backend LLM — sau #1067 (v0.7.0) có thể là cục bộ (Ollama, LMStudio, vLLM, máy chủ llama.cpp) hoặc bất kỳ điểm cuối từ xa tương thích OpenAI nào (xAI, OpenAI, Anthropic qua shim OpenAI, Google Gemini, DeepSeek, Kimi, Qwen, Mistral, Groq, Together, Cerebras, OpenRouter, Fireworks). Lựa chọn qua biến môi trường AI_MEMORY_LLM_BACKEND; khóa API từng nhà cung cấp qua XAI_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY / DEEPSEEK_API_KEY / MOONSHOT_API_KEY / DASHSCOPE_API_KEY / v.v. hoặc AI_MEMORY_LLM_API_KEY chính tắc.

Bậc kiểm soát tính năng, không phải mô hình — và sau #1067 (v0.7.0), bậc kiểm soát tính năng, cũng không phải nhà cung cấp. Cờ --tier kiểm soát những công cụ nào được hiển thị. Backend LLM + mô hình được cấu hình độc lập qua các biến môi trường AI_MEMORY_LLM_BACKEND + AI_MEMORY_LLM_MODEL (hoặc qua phần [llm] chính tắc trong ~/.config/ai-memory/config.toml — xem docs/CONFIG_SCHEMA.md để biết lược đồ doanh nghiệp v0.7.x và công cụ di chuyển). Ví dụ: chạy bậc tự động (toàn bộ 101 mục + reranker) với xAI Grok 4 qua bí danh tương thích OpenAI:

# Quick path: env vars
export AI_MEMORY_LLM_BACKEND=xai
export AI_MEMORY_LLM_MODEL=grok-4.3
export XAI_API_KEY=xai-…   # or AI_MEMORY_LLM_API_KEY
ai-memory mcp --tier autonomous

# Enterprise path: ~/.config/ai-memory/config.toml (v0.7.x schema v2, #1146)
schema_version = 2
tier = "autonomous"

[llm]
backend     = "xai"
model       = "grok-4.3"
base_url    = "https://api.x.ai/v1"
api_key_env = "XAI_API_KEY"          # mutually exclusive with api_key_file;
                                     # inline `api_key = "..."` is REJECTED.

# Legacy v0.6.x shape — still works, deprecation WARN at load; run
# `ai-memory config migrate` to upgrade in place.
tier = "autonomous"
llm_model = "gemma3:4b"   # default Ollama model at v0.7.0

Cờ --tier phải được truyền trong các đối số MCP -- cài đặt bậc config.toml không được sử dụng khi máy chủ được khởi chạy bởi một máy khách AI.

# Semantic is the default tier
ai-memory mcp

# Keyword -- FTS5 only, no models
ai-memory mcp --tier keyword

# Semantic -- hybrid recall with embeddings (explicit)
ai-memory mcp --tier semantic

# Smart -- adds LLM-powered query expansion, auto-tagging, contradiction detection
ai-memory mcp --tier smart

# Autonomous -- adds cross-encoder reranking
ai-memory mcp --tier autonomous

Công cụ memory_capabilities báo cáo bậc đang hoạt động, các mô hình đã tải và các khả năng khả dụng trong thời gian chạy.

Công cụ MCP

101 công cụ này (hồ sơ đầy đủ; số lượng chính tắc qua Profile::full().expected_tool_count() trong src/profile.rs) khả dụng cho bất kỳ AI tương thích MCP nào khi được cấu hình làm máy chủ MCP (trang bằng chứng đóng băng v0.6.4 liệt kê đường cơ sở 63 công cụ; bảng dưới đây ghi lại tập hợp con cốt lõi mà hầu hết khách hàng sử dụng hàng ngày):

API HTTP

92 đăng ký tuyến / 78 đường dẫn URL duy nhất trên 127.0.0.1:9077. Bắt đầu với ai-memory serve. Bảng dưới đây hiển thị các điểm cuối REST được sử dụng phổ biến nhất; xem docs/API_REFERENCE.md để biết toàn bộ bề mặt (quản trị, liên kết, đăng ký, đồ thị tri thức, hạn ngạch, phê duyệt SSE).

Bảo mật: Máy chủ HTTP liên kết với 127.0.0.1 và xuất xưởng không có xác thực được cấu hình theo mặc định, cộng với CORS cho phép tất cả. Đặt api_key trong config.toml để yêu cầu tiêu đề x-api-key trên mọi yêu cầu (dạng tham số truy vấn ?api_key= cũ không được dùng nữa ở v0.7.0 — #1574), và đặt AI_MEMORY_REQUIRE_API_KEY=1 để từ chối cứng việc khởi động không có khóa (#1458). Không phơi bày ra mạng mà không có xác thực (và ưu tiên TLS qua --tls-cert/--tls-key hoặc proxy ngược).

Lệnh CLI

89 lệnh con cấp cao nhất dưới --features sal HOẶC --features sal-postgres (87 trong bản dựng mặc định; khoảng cách 2 biến thể là Migrate + SchemaInit, cả hai đều được kiểm soát #[cfg(feature = "sal")] theo src/daemon_runtime.rs::Command::{Migrate,SchemaInit}; là 40 ở v0.6.4). Chạy ai-memory <command> --help để biết chi tiết về bất kỳ lệnh nào, hoặc ai-memory --help để xem danh sách đầy đủ.

Tệp nhị phân ai-memory cấp cao nhất cũng chấp nhận các cờ toàn cục:

Lệnh con store chấp nhận các cờ bổ sung:

Lệnh con mcp chấp nhận một cờ bổ sung:

Chấm điểm gợi nhớ

Mỗi truy vấn gợi nhớ xếp hạng ký ức theo 6 yếu tố:

score = (fts_relevance * -1)
      + (priority * 0.5)
      + (MIN(access_count, 50) * 0.1)
      + (confidence * 2.0)
      + tier_boost
      + recency_decay

Cấp ký ức

Hành vi tự động

• Gia hạn TTL khi gợi nhớ: ký ức ngắn được +1 giờ, ký ức trung được +1 ngày
• Tự động thăng cấp: ký ức cấp trung được truy cập 5+ lần sẽ thăng lên cấp dài (xóa hết hạn)
• Củng cố mức ưu tiên: mỗi 10 lần truy cập, mức ưu tiên tăng 1 (giới hạn ở 10)
• Phát hiện mâu thuẫn: cảnh báo khi ký ức mới xung đột với ký ức hiện có trong cùng không gian tên
• Loại bỏ trùng lặp: upsert theo tiêu đề+không gian tên; cấp không bao giờ bị hạ khi cập nhật

TTL có thể cấu hình

TTL mặc định (6 giờ cho ngắn, 7 ngày cho trung) có thể được ghi đè trong ~/.config/ai-memory/config.toml ở phần [ttl]:

[ttl]
short_ttl_secs = 21600      # short-tier TTL in seconds (default: 21600 = 6 hours)
mid_ttl_secs = 604800        # mid-tier TTL in seconds (default: 604800 = 7 days)
long_ttl_secs = 0            # long-tier TTL in seconds (default: 0 = never expires)
short_extend_secs = 3600     # TTL extension on recall for short-tier memories in seconds (default: 3600 = +1h)
mid_extend_secs = 86400      # TTL extension on recall for mid-tier memories in seconds (default: 86400 = +1d)

Tất cả năm trường đều tùy chọn -- bỏ qua bất kỳ trường nào để giữ mặc định. Đặt bất kỳ giá trị nào thành 0 để vô hiệu hóa hết hạn cho cấp đó. Giá trị bị giới hạn ở mức tối đa 10 năm; giá trị gia hạn âm bị giới hạn ở 0.

Lưu ý: Cấu hình được tải một lần khi khởi động tiến trình. Thay đổi đối với config.toml yêu cầu khởi động lại tiến trình ai-memory (máy chủ MCP, daemon HTTP, hoặc CLI) để có hiệu lực.

Lưu trữ

Khi thu gom rác làm hết hạn một ký ức, nó có thể được lưu trữ thay vì xóa vĩnh viễn. Ký ức đã lưu trữ được chuyển đến một kho riêng biệt và có thể được duyệt, khôi phục hoặc xóa sau.

Cấu hình

Bật lưu trữ trong ~/.config/ai-memory/config.toml:

archive_on_gc = true   # archive expired memories instead of deleting them (default: true)

Lệnh CLI

Lệnh con archive quản lý kho lưu trữ:

ai-memory archive list                          # list archived memories
ai-memory archive list --namespace my-project   # filter by namespace
ai-memory archive restore <id>                  # restore an archived memory to active store
ai-memory archive purge --older-than-days 90     # permanently delete archives older than 90 days
ai-memory archive stats                         # show archive statistics

Lưu ý: Ký ức được khôi phục sẽ bị xóa expires_at (trở thành vĩnh viễn cho đến lần gán TTL tiếp theo).

Công cụ MCP

Có bốn công cụ lưu trữ dành cho máy khách MCP:

Điểm cuối HTTP

Bảo mật

ai-memory bao gồm tăng cường trên tất cả các đường dẫn đầu vào:

• An toàn giao dịch -- tất cả các thao tác cơ sở dữ liệu nhiều bước đều sử dụng giao dịch; không có ghi một phần khi thất bại
• Ngăn chặn tiêm nhiễm FTS -- đầu vào người dùng được làm sạch trước khi đến truy vấn FTS5; các ký tự đặc biệt được thoát
• Làm sạch lỗi -- đường dẫn cơ sở dữ liệu nội bộ và chi tiết hệ thống bị loại bỏ khỏi phản hồi lỗi; máy khách thấy các loại lỗi có cấu trúc (NOT_FOUND, VALIDATION_FAILED, DATABASE_ERROR, CONFLICT)
• Giới hạn kích thước thân yêu cầu -- thân yêu cầu HTTP bị giới hạn ở 50 MB thông qua DefaultBodyLimit của Axum
• Giới hạn thao tác hàng loạt -- các điểm cuối tạo hàng loạt thực thi kích thước lô tối đa để ngăn cạn kiệt tài nguyên
• CORS -- lớp CORS cho phép được bật cho quy trình phát triển localhost
• Xác thực đầu vào -- mọi đường dẫn ghi đều xác thực độ dài tiêu đề, độ dài nội dung, định dạng không gian tên, giá trị nguồn, phạm vi ưu tiên (1-10), phạm vi độ tin cậy (0.0-1.0), định dạng thẻ, giá trị cấp, loại quan hệ và định dạng ID
• Xác thực liên kết trong đồng bộ -- tất cả các liên kết đều được xác thực (cả hai ID, loại quan hệ, không tự liên kết) trước khi nhập trong các thao tác đồng bộ
• Màu sắc an toàn luồng -- phát hiện màu terminal sử dụng AtomicBool để truy cập đồng thời an toàn
• HTTP chỉ cục bộ -- máy chủ HTTP liên kết với 127.0.0.1 theo mặc định; không tiếp xúc với mạng
• Chế độ WAL -- Ghi nhật ký trước của SQLite để đọc đồng thời an toàn trong khi ghi

Tài liệu

Giấy phép

Bản quyền 2026 AlphaOne LLC.

Được cấp phép theo Giấy phép Apache, Phiên bản 2.0 ("Giấy phép"); bạn không được sử dụng tệp này trừ khi tuân thủ Giấy phép. Bạn có thể lấy bản sao Giấy phép tại

http://www.apache.org/licenses/LICENSE-2.0

Trừ khi được luật hiện hành yêu cầu hoặc đồng ý bằng văn bản, phần mềm được phân phối theo Giấy phép được phân phối trên cơ sở "NHƯ HIỆN TẠI", KHÔNG CÓ BẢO HÀNH HOẶC ĐIỀU KIỆN DƯỚI BẤT KỲ HÌNH THỨC NÀO, dù rõ ràng hay ngụ ý. Xem Giấy phép để biết các quyền và giới hạn cụ thể theo Giấy phép.