agentmemory 全公司
共享記憶層 · 部署計畫

# 1) iii-engine v0.11.2（Mac mini arm64）
mkdir -p ~/.local/bin
curl -fsSL https://github.com/iii-hq/iii/releases/download/iii/v0.11.2/iii-aarch64-apple-darwin.tar.gz \
  | tar -xz -C ~/.local/bin && chmod +x ~/.local/bin/iii
iii --version   # 應印出 0.11.2

# 2) agentmemory（全域安裝，之後 bare 指令到處可用）
npm install -g @agentmemory/agentmemory

# 3) 本地 embedding（免費、離線、資料不外流）＋ 繁中斷詞（必裝）
npm install -g @xenova/transformers
npm install -g @node-rs/jieba tiny-segmenter   # 中日韓斷詞，繁中檢索品質關鍵

# ── 驗證（共享 hub 必填）──
AGENTMEMORY_SECRET=<openssl rand -hex 32 產生的長字串>

# ── Port（預設即可）──
III_REST_PORT=3111

# ── Embedding：本地、免費、離線 ──
EMBEDDING_PROVIDER=local

# ── LLM 壓縮／摘要：走你的 OpenRouter，路由便宜模型 ──
OPENROUTER_API_KEY=<你的 key>
AGENTMEMORY_AUTO_COMPRESS=true    # 要壓縮才開；活躍寫入會有 token 花費

# ── Team：共享 ＋ 私有命名空間 ──
TEAM_ID=neteon
# USER_ID 由各使用者「端」帶入（見 §06），hub 端不寫死
# TEAM_MODE 可用值以你安裝版本的 `agentmemory doctor` / 文件為準

# ── 治理／運維 ──
GRAPH_EXTRACTION_ENABLED=true    # 開知識圖譜抽取
CONSOLIDATION_ENABLED=true
LESSON_DECAY_ENABLED=true
SNAPSHOT_ENABLED=true       # git 版本化快照，可回溯／diff
AGENTMEMORY_TOOLS=all        # 開滿 51 個 MCP 工具（含治理類）

agentmemory            # 啟動 hub（REST :3111 / viewer :3113）
agentmemory doctor     # 互動式診斷，確認 engine／embedding／team 設定
agentmemory demo       # 灌入樣本資料，驗證語意檢索真的會動

curl http://localhost:3111/agentmemory/health   # 應回 ok（此端點永遠公開）
open http://localhost:3113                       # viewer：看記憶即時長出來

curl -X POST http://memory-hub.<tailnet>.ts.net:3111/agentmemory/remember \
  -H "Authorization: Bearer $AGENTMEMORY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "neteon-shared",
    "content": "Moxa 於 2026 Q2 將 Neteon 升為 Gold Partner，適用北美區。",
    "source": "2026-04 業務週會記錄",
    "facets": { "dept": "sales", "confidentiality": "internal" }
  }'

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"],
      "env": {
        "AGENTMEMORY_URL": "http://memory-hub.<tailnet>.ts.net:3111",
        "AGENTMEMORY_SECRET": "<hub 的 secret>",
        "USER_ID": "hubert"
      }
    }
  }
}