指南

P0 實作架構 · IMPLEMENTATION SPEC

Mac mini Hub 實作藍圖
agentmemory × DeepSeek V4 Flash × Tailscale

NETEON // BUILD P0 · Mac mini HUB · IMPLEMENTATION SPEC LOCKED P0 實作架構 · IMPLEMENTATION SPEC Mac mini Hub 實作藍圖agentmemory × DeepSeek V4 Flash × Tailscale 這是把 P0 定案後的實際落地藍圖:一台 Mac mini 跑 agentmemory hub,OpenRouter 上的 Deep...

這是把 P0 定案後的實際落地藍圖:一台 Mac mini 跑 agentmemory hub,OpenRouter 上的 DeepSeek V4 Flash 當過濾/加速/routing 引擎,Tailscale 讓全公司異地連入。搭配的 Claude Code build prompt 會照這張藍圖一次把主機 build 完。

閱讀時間
6 分
更新日期
開啟原始報告
主機
Mac mini(launchd 常駐)
LLM 引擎
deepseek/deepseek-v4-flash
連線
Tailscale 私網
建置方式
Claude Code 一次 build

01HOW TO USE

怎麼用這份東西

你會拿到兩個檔案:這份 HTML(給人看的架構藍圖)+ 一份 claude-code-build-prompt.md(給 Claude Code 執行的建置指令)。

一次 build 完主機

在這台 Mac mini 上打開 Claude Code,把 claude-code-build-prompt.md 裡「PROMPT 開始/結束」之間的內容整段貼進去執行。它會逐步安裝、設定、常駐化、測試,並在需要時互動式向你要 OpenRouter key。

claude-code-build-prompt.md

02FINAL DATA FLOW

最終資料流

最終資料流
  1. SRC

    知識現場

    • Email/簡報/會議記錄
  2. HERMES

    擷取代理

    • 排程讀入原文
  3. DEEPSEEK V4 FLASH

    抽取+分類

    • 結構化事實/PII/信心/分級
  4. GATE

    治理閘門

    • 你的政策:擋/降級/寫入
  5. HUB · Mac mini

    agentmemory

    • 共享命名空間 :3111

↑ 全公司 agent 經 Tailscale 讀取共享知識 · DeepSeek V4 Flash 同時負責 agentmemory 內部的壓縮/摘要與 routing

同一顆 DeepSeek V4 Flash 身兼三職:擷取代理的事實抽取、治理閘門的分類(PII/信心/機密級)、以及 agentmemory 內部的記憶壓縮與 routing。便宜(約 US$0.09/0.18 每百萬 token)又快,正好扛高量。

03THE LLM WORKHORSE

DeepSeek V4 Flash:過濾與 routing 引擎

項目設定
主模型 slugdeepseek/deepseek-v4-flash
Fallback slugdeepseek/deepseek-v4-pro
端點https://openrouter.ai/api/v1/chat/completions
Context1M token(可整份會議記錄一次餵)
價格(約)US$0.09 / M 輸入 · US$0.18 / M 輸出
能力tool use、function calling、結構化輸出、thinking/non-thinking
在本系統的三個角色擷取抽取 · 治理分類 · agentmemory 內部壓縮/routing

04INSTALL & KEEPALIVE

安裝與 launchd 常駐

核心安裝就三行;關鍵是別漏繁中斷詞,以及用 launchd 讓 hub 開機自啟、掛掉自動重拉。

install(Claude Code 會逐步跑並驗證)

bash
npm install -g @agentmemory/agentmemory \
  @xenova/transformers \          # 本地 embedding(免費/離線)
  @node-rs/jieba tiny-segmenter   # 繁中斷詞(不裝=中文檢索退化)

agentmemory doctor   # 確認 iii-engine v0.11.2、embedding、team 設定

~/Library/LaunchAgents/net.neteon.agentmemory.plist

xml
<dict>
  <key>Label</key><string>net.neteon.agentmemory</string>
  <key>ProgramArguments</key>
  <array><string>AGENTMEMORY_BIN</string></array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>       # 掛掉自動重拉
  <key>StandardOutPath</key><string>.../logs/hub.log</string>
</dict>

05NETWORK & ACCESS

Tailscale 私網 + 各端接入

全公司裝 Tailscale,hub 只在 tailnet 內可達,公網零曝露。每位同事在自己 agent 的 MCP 設定貼一段、帶自己的 USER_ID 即可。

各 agent 通用 · mcpServers

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

Claude Code

  • /plugin install agentmemory 或直接用上面區塊。

  • AGENTMEMORY_URL 指向 hub。

OpenClaw

  • 併入 MCP 設定;或複製 integrations/openclaw 深整合。

Hermes

  • config.yaml 設 memory.provider: agentmemory。

  • 它同時是擷取代理(見 §05)。

06INGESTION & GOVERNANCE

Hermes 擷取代理 + 治理閘門

擷取代理讀入商業文字,交 DeepSeek V4 Flash 抽成結構化事實並分類,再過治理閘門,通過者才寫入 hub。抽取提示與治理規則都會被 build 成實體檔案。

extract.prompt.md · DeepSeek 抽取系統提示

text
# 角色:Neteon 知識擷取器
只抽「對公司有長期價值」的事實:決策、夥伴關係與層級、報價與條件、
產品規格、負責人、時程里程碑、客戶需求。略過寒暄與行程協調。

# 輸出:只回一個 JSON 陣列,每筆:
{ content: 單一可獨立理解的繁中事實,
  source: 來源出處,
  dept: sales|ops|eng|exec|marketing|support,
  confidentiality: public|internal|restricted,
  confidence: 0.0–1.0,
  contains_pii: true|false }

governance-rules.md · 治理閘門(逐條檢查,不過就擋)

text
1. 無 source → 丟棄
2. 無 dept 標籤 → 丟棄
3. confidence < 0.6 → 丟棄(寧缺勿濫)
4. contains_pii == true → 丟棄,記「已擋 PII」
5. confidentiality:
     public / internal → 寫入 neteon-shared
     restricted        → 不進共享池,轉待人工覆核佇列
6. content 須單一、可獨立理解 → 否則退回重抽
7. 24h 內同 hash 已寫過 → 略過(去重、省 API)

07OPS

備份與運維

備份

  • 每日 03:00 launchd 跑 backup.sh:rsync ~/.agentmemory → backups/。

  • 保留最近 14 份;建議再加一份異地(NAS/雲)。

  • 每季做一次「還原演練」,確認備份真能救。

健康與治理

  • launchd KeepAlive 自動重拉;hub.log 排錯。

  • SNAPSHOT_ENABLED=true:git 版本化快照,可回滾。

  • 治理工具:memory_audit/memory_verify/memory_governance_delete。

  • iii-engine 鎖 v0.11.2,升級走 staging,別盲升。

08AFTER THE BUILD

build 完之後的動作

  1. 驗收 build 報告:Claude Code 會列出 hub tailnet URL、同事設定區塊、Tailscale ACL 建議、產生的檔案清單。逐項確認。

  2. 加 Tailscale ACL:照建議片段,把 :3111 限定給團隊裝置。

  3. 接第一個知識源:拿幾份真實會議記錄,手動跑 extract.mjs,檢查抽取+閘門判斷。

  4. 找 3–5 人試點:把他們的 Claude Code/OpenClaw/Hermes 指向 hub,觀察多人寫入的隔離與矛盾處理。

  5. 治理政策成文:依部門/機密級調整 governance-rules.md,再放大到全公司。

**依據:**rohitg00/agentmemory README/deploy/api.ts(v0.9.18 · iii-engine v0.11.2,查證 2026/07);OpenRouter 模型頁 deepseek/deepseek-v4-flash(2026/04)。
**注意:**agentmemory 為 pre-1.0,環境變數名、CLI 子指令、/remember payload schema 可能隨版本變動;build prompt 已內建「以安裝版本實際確認」的指示。DeepSeek 價格為約值,以 OpenRouter 當前頁面為準。

NETEON · BUILD SPEC · v1.0