返回產品博客

S3 三層數據隔離 + 模板單一權威:TeGo v3.0.0 是怎麼把治理邊界講清楚的

本文發佈於 2026年4月25日。產品當前能力參見產品能力。

S3 三層數據隔離 + 模板單一權威:TeGo v3.0.0 是怎麼把治理邊界講清楚的

S3 三層數據隔離 + 模板單一權威:TeGo v3.0.0 是怎麼把治理邊界講清楚的

模板歸模板,運行時歸用戶;治理邊界,從靠規範升級為靠協議。


v2 時代的兩個老問題

如果你在企業裡跑過幾個數字分身,應該會熟悉這兩類問題:

  1. 數據切片太粗:S3 上的所有數據都堆在 {avatarId}/... 這一個前綴下,模板、共享運行時、各用戶的運行時全混在一起;
  2. 配置治理失控:技能、提示詞、模板、工作區配置,誰有權限就能改,改完互相覆蓋、版本飄移、回滾困難。

這兩件事看起來是「兩個問題」,但本質是同一個:沒有一個清晰的「誰能寫、寫到哪裡」的協議。

v3.0.0 做的事,就是把這條協議從「靠規範、靠口頭約定」升級為「靠 S3 路徑、靠網關、靠 JWT」的硬約束。


全新的 S3 命名空間佈局

{avatarId}/{key}                       ← 分身级模板(admin 可写、所有用户只读)
{avatarId}/shared/{key}                ← shared 模式的运行时备份
{avatarId}/per-user/{userId}/{key}     ← per_user 模式下每个用户的独立备份

三件事的核心區別:

區域 誰能寫 何時同步 何時清理
模板 template/* admin / owner(控制台) 寫入即下發到所有副本 幾乎不清理(需要保留可回滾的歷史)
shared 運行時 該分身的所有用戶 實時 分身停用 / 重置時清理
per-user 運行時 單個用戶 實時 用戶離職 / 一鍵重置時清理

這三種數據的生命週期完全不同,混在一起就一定會出問題。v3.0.0 把它們物理上分前綴,是後續所有治理能力的前提。


三層 fallback 讀取

模板和運行時分開後,業務代碼讀數據怎麼辦?答案是網關在讀側統一做三層 fallback:

flowchart LR
  R[業務請求 read key=K] --> A{runtime/<K> 存在?}
  A -- 是 --> RT[讀 runtime]
  A -- 否 --> B{template/<K> 存在?}
  B -- 是 --> TP[讀 template]
  B -- 否 --> C[讀老 seed 路徑]

這條 fallback 讓我們做到:

  • 新分身:直接命中 template,由模板下發;
  • 老分身:走老 seed 路徑繼續工作,灰度遷移期不阻塞業務;
  • per_user 用戶:runtime 裡沒有的 key 自動落到 template,新員工拿到的是「最新模板的副本」。

業務代碼不需要關心這條 fallback,所有改寫都在網關完成。


JWT 攜帶 instanceUserId

要讓 S3 路徑自動改寫,前提是「網關知道這個請求是哪個用戶的」。v3.0.0 在 JWT 里加了一個字段:

{
  "sub": "u_123",
  "tenant": "tnt_xxx",
  "avatar": "av_yyy",
  "instanceUserId": "u_123",   // ← 新字段
  "scope": ["chat:read", "chat:write", ...]
}

instanceUserId 在網關入口被解出,然後隨每個 RPC 調用透傳。任何下游服務(包括 S3 網關、技能調度器、記憶服務)都能識別請求歸屬。


模板 / 運行時單一權威

權限層是 v3.0.0 最大的協議改動。新模型只允許兩種寫:

flowchart LR
  Admin[管理員 / Owner] -->|寫| Template[模板 template/*]
  Template -->|只讀| User[普通用戶]
  User -->|寫| Runtime[各用戶 runtime/*]
  User -.->|試圖寫模板| Block[403 Forbidden]

四項設計要點:

1. 模板路徑只能由 admin / owner 改

只能通過控制台來改,寫入即自動 bump 三個版本號:

  • configVersion:分身配置;
  • workspaceVersion:工作區結構;
  • skillsVersion:技能集。

副本看到版本號變化,會主動拉取新模板。

2. 網關寫側強制攔截

普通用戶的 token 一旦試圖寫 template/* 路徑,網關直接 403。這是協議級的硬隔離,不是 UI 級的「按鈕灰掉」。

3. 雙寫一致性

控制台改模板時,先 RPC 改本地副本(操作員無延遲可見),再 admin REST 寫 S3 模板(其他副本通過心跳最終一致)。這樣既保證了控制台體驗,又保證了多副本一致性。

4. 回填腳本

為了讓老分身平滑遷移,v3.0.0 提供了:

pnpm db:backfill-template

冪等地把老分身的 seed 數據遷移到新模板路徑。可以反覆跑,結果一致。


一鍵重置全部用戶實例

S3 三層 + 單一權威後,「重置」這件事的語義終於清楚了:

  • 模板:不動(這是分身的「身份」);
  • shared 運行時:清空;
  • per-user 運行時:清空全部用戶分支,可選保留某些。

v3.0.0 提供了一鍵操作,停容器、刪編排資源、清 volume、清 deployment 記錄,乾淨徹底。


對企業的真實意義

這套機制對企業意味著:

1. 真正的「我的數據」

同一個分身被一群用戶用起來,每個人的會話、記憶、工作區、媒體文件,都是真正「我的」——可獨立備份、獨立恢復、獨立銷燬。

2. 離職 / 退出乾淨

員工離職時,只需要清理 per-user/<userId>/... 這一支,乾淨徹底。審計材料裡能寫出明確的「數據銷燬路徑」。

3. 治理邊界終於講得清楚

「誰能改模板?」「誰能改運行時?」「我能不能把同事的配置覆蓋掉?」這些問題在 v3.0.0 之前都靠口頭約定,現在全部由協議層強制。

4. 災備 / 合規可按用戶切片

恢復某個用戶的工作區?只恢復 per-user/<userId>/...。 導出某個用戶的全部數據?只導出 per-user/<userId>/...。 監管審計某個用戶的訪問?只查 per-user/<userId>/...。

這正是受監管行業(政務、金融、醫療)反覆要求的能力。


工程小結

S3 三層 + 單一權威,是 v3.0.0 把「企業數字分身」從一個概念,落到一套可治理、可審計、可演進的真實系統的關鍵轉折。

它不是一個讓人「眼前一亮」的功能,但它是後續所有更性感的功能(per_user 獨享實例、BusinessMonitor 大屏、自動備份恢復、合規審計)能成立的底座。


渠道 方式
申請演示 30 分鐘看完 4 個核心場景
私有化部署諮詢 support@zhama.com
完整平臺 https://app.zhama.com

深度解析:TeGo v3.0.0 的 per_user 獨享實例是怎麼落地的

v3.0.0 引入了 per_user 獨享實例,讓同一個數字分身能被一群人放心地、互不打擾地一起用。本文從調度模型、生命週期、容量護欄、Stale 鎖清理、Warm Pool 路線圖五個維度,解釋這套機制是怎麼真正跑穩的。

微信交流群二維碼 微信公眾號二維碼