Appendix
Engineering Specification
給工程師看的硬知識：資料結構、引擎流程、檔案格式
📁 目錄結構
.memory/neural/ ├── ARCHITECTURE.md ← 系統藍圖（本附錄的完整版） ├── graph/ │ ├── nodes.jsonl ← 知識節點（append-only） │ ├── edges.jsonl ← 關係連線（append-only） │ └── index.md ← 標籤索引（人工維護） ├── engines/ │ ├── writeback.md ← 回流引擎 SOP │ ├── confidence.md ← 信心引擎 SOP │ ├── contradiction.md ← 矛盾偵測 SOP │ ├── compression.md ← 壓縮引擎 SOP │ ├── graph-ops.md ← 圖譜引擎 SOP │ ├── emergence.md ← 湧現引擎 SOP │ └── alignment.md ← 對焦校準 SOP └── logs/ ├── checkpoint.jsonl ← 每日引擎健康日報 ├── writeback.jsonl ← 回流審計軌跡 ├── contradictions.jsonl ← 矛盾偵測記錄 ├── compressions.jsonl ← 壓縮事件記錄 ├── emergence.jsonl ← 湧現追蹤（emergence_id + 採用率） ├── alignment.jsonl ← 對焦校準記錄 └── rollbacks.jsonl ← 回溯修正記錄
🧬 Node Schema（知識節點）
{
"id": "n_20260412_001",
"content": "寵物展4月場全攤成本虧98K，但攤提後毛利37%",
"type": "fact", // fact | insight | pain | decision | person | event | pattern | principle
"confidence": 0.85,
"source": "conversation#40",
"tags": ["寵物展", "財務", "4月展"],
"created": "2026-04-12",
"last_accessed": "2026-04-12",
"access_count": 1,
"access_detail": { "boz_confirmed": 0, "auto_retrieved": 1 },
"decay_protected": false,
"context_window_days": 7 // 矛盾偵測時間窗口（預設30，按類型覆蓋）
}
weighted_access_count = (boz_confirmed × 3) + (auto_retrieved × 1)
升級門檻：weighted_access_count ≥ 5
🔗 Edge Schema（關係連線）
{
"source": "n_20260412_001",
"target": "n_20260410_003",
"relation": "caused_by", // 見下方關係類型表
"weight": 0.7,
"created": "2026-04-12",
"context": "4月展虧損因攤位費佔比過高"
}
📊 信心分數規則
初始分數
0.90 數據驗證
0.60 語嫣推論
0.50 外部未驗證
0.40 第三方轉述
分數變動
→0.95 Boz 確認直升
-0.15 矛盾偵測標記
-0.05 每30天未引用
0.10 下限（不刪除）
⚙️ 六引擎流水線
🗜️ 壓縮引擎決策樹
觸發：MEMORY.md > 2KB 或 每月 1 日全員健檢 │ ├─ 升級候選 │ weighted_access_count ≥ 5 │ confidence > 0.7 │ 同標籤 3+ 相關節點 │ → 情節濃縮為語義 → 寫入 BRAIN.md │ → 建立 derived_from 邊 │ ├─ 衰減候選 │ 60 天未引用 │ confidence < 0.5 │ 非 decay_protected │ → 降低 confidence → 移入 _archive/ │ └─ 保持不動 不符合以上任一條件 → 原地不動，等下次掃描
⏪ Rollback 回溯流程
發現通則跑偏（對焦會議 / Boz 指出 / 矛盾偵測） │ ▼ Step 1 confidence → 0，標記 invalidated │ ▼ Step 2 回 _archive/ 挖出原始情節記憶 │ ▼ Step 3 從原始資料重新壓縮（排除跑偏那條） │ ▼ Step 4 連帶 edges 全標 stale，重新評估 │ ▼ Step 5 員工 BRAIN.md 對應通則刪除重寫 │ ▼ Step 6 全程記錄 → logs/rollbacks.jsonl
🎯 冷啟動畢業條件（四項全過）
矛盾率
< 1 次/週
contradictions.jsonl 統計
灰色地帶正確率
> 70%
Boz 抽查 confidence 0.4-0.6 節點
孤立節點
< 15%
無任何 edge 的節點佔比
HR 週 Review
連續 4 週
無 major 異常
📋 Checkpoint 日報格式
日期：2026-04-12 [Writeback] 新增節點：3 / 新增關係：5 / 分發員工：2 / reasoning：✓ [Confidence] 引用更新：4 / Boz 確認：1 [Contradiction] 偵測矛盾：0（minor:0 / major:0 / critical:0）/ 狀態更新：1 [Compression] 升級候選：1 / 衰減候選：0 / 歸檔：0 [Graph] 孤立節點：12% / 平均邊數：2.3 [Emergence] 浮出：2 / 被採用：1 / 採用率：50% / depth：1 [Alignment] （月度）偏離：-- 空白欄 = 該引擎今天沒跑 → 連續 3 天空白 → HR 標記
💡 四項獨創機制
立場翻譯 Perspective Translation
同一事實進入不同 Agent 時，用該 Agent 的偏見重新解讀再存。解決「多 Agent 共享記憶但不失去個性」
湧現引擎 Emergence Engine
不是「你問它答」，是「你沒問它主動浮出」。帶時機門控制，只在開場和收尾兩個窗口觸發
建築式分層 Architectural Layering
四層樓對應記憶穩定度（程序→語義→情節→工作），地基是共享知識圖譜。穩定度由下往上遞減
信心衰減不刪除 Decay Without Deletion
知識不會真正消失，只會淡化。保留完整演變軌跡，任何時候都能追溯回原始記錄
🔄 完整機制流程圖
從一句話進入系統，到知識沉澱為記憶的完整路徑
Phase 1 — Input
📥 對話進入系統
Phase 2 — Emergence Engine（開場窗口）
🔮 湧現引擎：主動浮出相關知識
查詢 graph/index.md → 找到直接相關節點
延伸 沿 edges 走 depth 步 → 間接相關節點
Phase 1: depth=1 / 採用率<30% → +1 / 降了 → 回退
篩選 confidence > 0.5 + 90天內引用過
標記 每條帶 emergence_id → 追蹤採用結果
浮出 0-3 條背景知識（自然融入，不標記）
⏸️ 時機門關閉 — 任務中途不打擾
Phase 3 — Task Execution
⚡ 任務執行（工作記憶運作中）
Phase 4 — Writeback Engine（總結 Step 2-3 觸發）
📝 回流引擎：萃取知識寫入圖譜
建檔 每條知識 → 節點寫入 nodes.jsonl（含 context_window_days）
連線 比對現有節點 tags → 關係寫入 edges.jsonl
定分 初始 confidence（Boz說=0.95 / 數據=0.90 / 推論=0.60）
索引 更新 graph/index.md 標籤
審計 writeback.jsonl 記錄 reasoning（為什麼給他/不給他）
5A 矛盾偵測
掃描同標籤節點
↓
時間差判斷 context_window_days
↓
比對是否衝突
↓
minor → 語嫣裁決
major → 通知 Boz
critical → 立刻上報
↓
→ contradictions.jsonl
5B 立場翻譯
讀 team-index.md
↓
判斷誰需要知道
↓
用員工偏見重寫
↓
分發至 MEMORY.md
↓
reasoning 記錄決策理由
5C 信心引擎
設定初始信心分數
↓
引用 → +0.05
Boz 確認 → = 0.95
被推翻 → = 0.10
↓
30天未引用 -0.05
下限 0.10（不刪除）
Phase 6 — Compression Engine（MEMORY > 2KB 或每月 1 日觸發）
🗜️ 壓縮引擎：情節 → 語義升級
升級候選（數據驅動，非主觀判斷）：
├ weighted_access_count ≥ 5
├ confidence > 0.7
└ 同標籤 ≥ 3 個相關節點
→ 情節濃縮為語義 → 寫入 BRAIN.md
衰減候選：
├ 60天未引用 + confidence < 0.3
└ 非 decay_protected
→ 移入 _archive/（不刪除）
Phase 7 — Checkpoint
📋 日報自檢 + 校準
每日（冷啟動期）
Checkpoint 日報每引擎一欄
空白 = 漏跑
連續 3 天空白 → HR 標記
每月（對焦會議）
高頻節點抽查員工詮釋 vs 地基原文
偏離 → 重寫/上報
信心衰減全掃描
Safeguard — Rollback（異常時觸發）
🔙 六步撤銷流程
觸發條件：對焦偏離 / Boz 指正 / 新事實推翻舊通則
冷啟動 → 穩定期畢業條件（四項全過）
< 1
矛盾率（次/週）
> 70%
灰色地帶抽樣正確率
< 15%
孤立節點比例
4 週
HR Review 連續無異常