SubLaneSubLane

工作空間

在同一個 SubLane 實例中隔離成員、資源與用量。

工作空間是一套獨立的成員和訂閱資源。目前空間的名稱顯示在左側欄頂部、SubLane 標識旁邊;點擊名稱即可切換正在管理的空間。

訂閱帳號、資源群組、成員權限、個人 API Key、用量分配、請求記錄、用量和稽核記錄都歸屬於目前工作空間。每位使用者只有一個登入帳號,但可以在不同空間擁有不同角色。

創建第一個工作空間

新安裝的初始化分兩步驟:先設定管理員登入訊息,再為第一個工作空間命名。提交第二步後才會一併創建兩者,管理員成為該空間的所有者並自動登入。

新空間沒有預置帳號或資源群組。接下來按順序操作:

  1. 在「訂閱帳號」存取並驗證訂閱。
  2. 在「資源群組」建立資源群組,把訂閱帳號加入池中。
  3. 在「成員管理」建立成員,並在每人所在行透過「資源群組權限」授予可使用的池。
  4. 成員在“API 金鑰”創建自己的 Key。需要限制用量時,管理員再為專用池添加用量分配。

第一次接取可依第一次使用完成調用,準備共享時再看成員與授權。

切換或新增空間

開啟 SubLane 標識旁的切換選單。選單列出你有權進入的空間、標示目前空間,並提供「創造工作空間」。切換時會重新載入所選空間的私有資料。新建空間的帳號、池、成員和金鑰都從空白開始。

每位使用者最多擁有 10 個工作空間,首位管理員的初始空間也計入。建立第 11 個空間時,介面返回 409 workspace_limit_reached。

Key 總是綁定建立時選定的工作空間和資源群組。切換瀏覽器中的空間不會移動 Key,也不會改變它的請求歸屬;若要使用另一個空間或池,請建立新 Key。

兩個演示工作空間的切換選單:

工作空间切换菜单,显示当前空间及创建工作空间入口

空間內的權限

目前空間的角色可以做什麼
所有者或管理員管理本空間的成員、帳號、資源群組、授權、額度、用量和稽核。
普通成員管理自己的 Key,查看自己的請求、用量和限制。

停用某人在目前空間的成員資格,會阻斷其在該空間的瀏覽器存取和 Key,不影響全域登入或其他空間。第一位管理員也負責實例級 Codex 版本設定和備份;其他空間管理員沒有這些平台權限。

哪些內容仍屬於整個實例

這些工作空間運作在同一個 Go 流程和 SQLite 資料庫中。備份包含整個實例的所有空間及加密金鑰,目前不能只導出或恢復其中一個空間。商業計費、PostgreSQL 儲存和應用多副本暫不包含在目前版本。

瀏覽器請求會攜帶所選空間 ID,但服務端仍會逐次檢查會話和成員資格。網關請求則根據個人 Key 已儲存的綁定確定空間,不能靠瀏覽器選擇頭改變歸屬。新請求和 WebSocket 回合也會重新檢查 Key、成員、資源群組及模型權限。

保留相同專案名稱及資料卷。啟動時會初始化新資料庫,並為受支援的既有資料庫執行缺少的增量遷移;包含 001_settings.sql 的早期不相容預發布結構會被拒絕,應保留舊目錄後另建資料目錄。升級前先匯出並驗證備份;僅切換映像不能回復已遷移的資料。