hg Discord Bot Architecture Packet

Agent Memory ×
Bot Organs

把「記憶分層」、「常駐 bot」、「腦內器官」、「一次性 worker 小鬼」整合成一套可治理、可派工、可升級的 Roy local agent system。

Conversation → Atom → Scenario → Persona Bot = 常駐身體 Specialist = 腦內器官 Worker = 短命小鬼 memory-cli = 唯一 CRUD

一句話總模型

三隻 bot 是常駐身體；specialist 是腦內器官；worker 是一次性放出去幹活的小鬼。記憶不是每個器官私藏，而是受治理的共享血液。

Body
Independent Bots

長期存在、有身份、有權限邊界。負責高頻、跨專案、權限敏感的工作。

Organs
Specialist Modes

判斷器官 / lens。提供觀點、風險、策略、taste，不直接取得最終主權。

Imps
Worker Pool

一次性任務單位。做一件事、交 result 或 artifact、消失。

記憶分層：不要把暫時情緒寫成人格

Agent memory 的難點不是記更多，而是決定什麼有資格升級。Persona 不應直接從單次對話摘要生成。

L0 Conversation
原始對話 / session
→
L1 Atom
具體可審核觀察
→
L2 Scenario
重複出現的場景
→
L3 Persona
長期偏好 / 身份層
層級放什麼治理規則
L0 Conversation完整對話、工具 logs、raw trace保留 evidence，不急著抽象化
L1 Atom短、具體、有來源的觀察禁止寫「Roy 就是怎樣的人」這種人格判斷
L2 Scenario反覆出現的工作模式 / 任務情境需要多次 evidence，標註日期與衝突
L3 Persona穩定偏好、長期工作規則、身份層候選 → review → 才能更新 SOUL / llm-context

記憶系統分類：三條路線

A

Extract-then-Store

LLM 從對話抽取摘要 / preference 再存。快，但有損、容易固化錯誤。

B

Store-then-Search

Verbatim 原文保存 + embedding / BM25 搜尋。笨拙但可靠，evidence 不斷線。

C

Hybrid Tiered

工作記憶、短期、長期分層路由。強但治理與實作複雜。

對 Roy 的 vault：優先 verbatim-first + 分層治理；讓模型產生候選，不讓模型自動出版身份層。

Agent 身體：最小常駐 bot set

Main Brain

🧠 hg腦魔

Dispatcher / synthesis / final answer / boundary-aware triage。對 Roy 負責。

Maker

🛠 hg工匠

Drafts、prototypes、decks、documents、local deliverables。把東西做出來。

Guardian

🛡 hg哨兵

Permissions、dry-run、risk、QA、red-team。專門擋災難。

可擴充：hg索引 做 research/wiki/source context；hg記憶 做 memory curator/audit，但實際 CRUD 仍只走 memory-cli。

腦內器官：判斷 organs / lenses

總編腦取捨、選擇、keep/cut/delay
星核策略、未來路徑、盲點
機械心工程結構、工具、維護性
靈視監美術方向、創意一致性
索引眼研究路線、來源、證據
🧠😈

hg腦魔

主腦負責召喚器官、整合輸出、做最後判斷。

像素靈視覺層級、UI taste
造夢艙敘事、deck/prototype framing
幻光影像風格、分鏡、motion prompt
記憶棧context compression、memory hygiene
邊界哨權限、成本、外部寫入、secrets

Worker 小鬼：一次性工單，不給主權

Worker law

  • One task only
  • Temporary workspace by default
  • No final authority
  • No hidden writes
  • Return result / artifact / risks

候選小鬼

文咒師、名鑄師、圖鑑靈、規格鬼、毒舌評審、咒語監、工具獵、原型匠、動線師、聲紋守、素材庫守、回聲儀。

模型分流：強腦用在刀口上

Tier用途適合角色
Tier A 強推理架構、風險、final synthesis、memory decisionshg腦魔、總編腦、機械心、邊界哨、記憶棧
Tier B 平衡一般草稿、摘要、production packethg工匠、造夢艙、索引眼、聲紋守
Tier C 快便宜命名、copy variants、brainstorm、分類初稿名鑄師、文咒師、變體小鬼
Tier D 工具/工程CLI、code、tests、維護機械心、工具獵、opencode 參謀
Tier E 研究來源搜尋、證據、current info索引眼、researcher、wiki-reader

高風險高判斷用強腦；大量低風險變體用便宜快腦；能驗證的工作可用小腦加 reviewer。

記憶治理角色：誰能寫？誰只能建議？

角色定位權限
記憶棧腦內器官：壓縮 context、檢查 memory hygiene建議，不直接 CRUD
memory-curator / audit短命 worker：判斷哪些記憶值得保存、哪些過期產 candidate / audit report
hg記憶未來獨立 bot：若記憶治理變高頻才升級仍需透過 memory-cli
memory-cli唯一 source of truth唯一真實 save / delete / update 路徑

建議 namespace：user.preference system.boundary system.routing project.context team.decision

升級規則：小鬼何時長出器官？器官何時長成身體？

Worker
→
Specialist Mode
→
Independent Bot

升級條件

  • 高頻使用
  • 需要 persistent memory / stable identity
  • 需要獨立工具權限
  • 影響跨專案決策
  • 反覆提升品質或安全

保持降級

  • 只偶爾用
  • 媒介專用
  • 只產 artifact、不做判斷
  • 增加 runtime 複雜度大於收益

目前實作缺口

CLI 分模型

hg-team task 目前尚未完整支援 --model；文件設計已超前。

Memory staging

需要把 Atom / Scenario / Persona candidate 做成可審核流程，而不是對話完自動寫人格。

Bot runtime 分身

目前主腦可調 worker/參謀；三 bot 常駐 runtime 還是未來實作。