日常工作

工作區 Archibot 與共用磁碟機

在 Console 中透過五個索引標籤管理共用磁碟機——瀏覽和編輯檔案、建立資料夾、上傳證據、授予範圍化的 Archibot 存取權、要求暫存還原以及建立客戶磁碟機。

客戶管理員客戶成員平台維運人員

最後更新 2026年6月18日

共用磁碟機是持久的帳戶儲存，Archibot 可在 Chat、VS Code、API 工作階段、工作區、審查和 QA 中使用它。您從 Console 的 共用磁碟機 路由進行管理，而不是在工作區編輯器內部。個人磁碟機的範圍僅限於您本人；客戶磁碟機由帳戶管理員建立和管理。

本指南從頭到尾介紹 Console 介面：五個索引標籤、檔案和資料夾管理、上傳、範圍化的 Archibot 存取授權、備份和暫存還原，以及建立客戶磁碟機。

開啟共用磁碟機

1. 登入 Console 並從左側導覽開啟 共用磁碟機。
2. 標題顯示兩個狀態徽章——共用儲存 和 可擴充的個人儲存——並為管理員顯示 NFS 服務、備份 和 代理授權 的快速狀態標籤。
3. 隨時使用標題中的 重新整理 來重新載入磁碟機、檔案和備份狀態。

標題下方是一列索引標籤。每個索引標籤旁的計數反映為您的帳戶載入的內容：

您能變更的內容取決於您的角色。成員可以讀寫自己的個人磁碟機。客戶磁碟機寫入操作、建立客戶磁碟機表單和維運範圍的控制項僅對客戶管理員和平台維運人員顯示。

檢視您的磁碟機

共用磁碟機 索引標籤按範圍分組列出您的磁碟機。每張卡片顯示磁碟機名稱、擁有者、個人 或 客戶 徽章，以及 可用 或 待處理 狀態徽章。

每張磁碟機卡片包括：

• 配額、已用 和 儲存 指標。
• 已連線介面 徽章，顯示可存取磁碟機的位置（Chat、VS Code、API 工作階段、工作區、審查、QA）。
• 開啟磁碟機，直接跳轉到該磁碟機的最近檔案檢視。
• 要求擴充，以儲存為焦點開啟目錄。

良好的共用磁碟機內容應是經過淨化且持久的：簡短的工作階段筆記和交接摘要、重現步驟、客戶已核准的截圖或文字證據，以及您希望從其他介面和未來工作區中可用的草稿交付物。

請勿在共用磁碟機中儲存密碼、API 金鑰、Cookie、原始憑證負載、私密對話記錄、客戶資料傾印或授權檔案。

瀏覽和管理檔案

選擇 最近檔案，或點擊卡片上的 開啟磁碟機，以開啟單一磁碟機的檔案工作台。

工作台有兩個區域：

• 左側的 目前位置 資料夾樹狀結構。點擊資料夾可將檔案清單的範圍限定到它；檔案清單上方的麵包屑導覽顯示您所在的位置。
• 右側的檔案窗格，帶有三個子索引標籤：瀏覽、資料夾 和 上傳。

在 瀏覽 子索引標籤上，您可以：

1. 使用資料夾捷徑標籤（例如 uploads/、uploads/notes/）在常用位置之間跳轉。
2. 使用 搜尋檔案 和 篩選資料夾 進行篩選，然後執行搜尋或 清除 它。
3. 對於每個檔案，使用 下載 將其儲存到本機。
4. 擁有寫入權限時，使用 重新命名 變更檔案名稱或將其移動到其他資料夾，然後 儲存。
5. 擁有寫入權限時，使用 移除 刪除檔案。該按鈕在刪除前會要求再次點擊以確認。

長清單會按視窗顯示。通知會告訴您顯示的檔案數與已載入的檔案數之比；要尋找特定檔案，請縮小路徑前綴或搜尋，而不是捲動。

建立和整理資料夾

切換到 資料夾 子索引標籤來組織磁碟機結構：

1. 輸入資料夾路徑，例如 archibot/sessions/，或使用作用中資料夾捷徑從目前位置填入該欄位。
2. 建立資料夾。新路徑成為作用中位置。
3. 現有資料夾可以重新命名（這會移動其內容）或移除，兩者都受寫入權限和確認步驟的限制。

為保持工作井然有序的建議資料夾：

• archibot/sessions/，用於簡短的工作階段摘要和復原筆記。
• ci-review/evidence/，用於經過淨化的審查或 QA 證據。
• workspace-backups/，用於應比工作區存續更久的小型使用者產生產物。

上傳證據檔案

使用 上傳 子索引標籤新增經過淨化的筆記、報告或文字產物，以便 Archibot 和您的隊友以後可以參照它們。

1. 設定 檔案名稱（例如 release-notes.md）。
2. 選擇 目標資料夾，或選擇 使用目前位置 以上傳到您正在瀏覽的資料夾中。
3. 選擇 保留 類別，例如 實作證據，以便為檔案標記其用途。
4. 在表單中輸入或貼上內容，或使用 挑選本機檔案 從您的電腦附加檔案。小型文字檔案會自動讀取到表單中；較大或二進位檔案會被暫存以供直接上傳。
5. 儲存檔案。

本機檔案選擇有大小限制，因此請將上傳內容限制為小型工作產物，而不是完整的資料傾印。上傳成功後，檔案會出現在所選資料夾的「瀏覽」下。

授予範圍化的 Archibot 存取權

Archibot 存取 索引標籤是您讓 Archibot 讀取已核准檔案而不暴露整個磁碟機的地方。授權是有邊界的——它們不會交出原始儲存路徑或大量檔案內容，並且每次資訊清單讀取都會被稽核。

要建立授權：

1. 選擇授權針對的 介面：Chat、API、VS Code、工作區、審查或 QA。
2. 選擇 存取 模式——唯讀，或在您擁有寫入權限的地方讀寫。
3. 設定 授權資料夾 路徑前綴，可選擇使用 使用目前位置。
4. 可選地新增 檔案篩選器（檔案名稱、來源、保留或路徑）和 檔案限制。
5. 選擇 到期 時段：30 分鐘、4 小時、24 小時或 7 天。
6. 輸入 目的，例如 agent-context。
7. 選擇 建立授權。

建立授權後，資訊清單就緒 面板會顯示檔案數、資訊清單路由、到期時間以及所含檔案的預覽。您還可以使用 解析存取 來取得所選介面的預設資訊清單，而無需建立新授權。

將授權視為短暫的、最低權限的存取。將其範圍限定在一個資料夾和一個短時段內，並讓其到期，而不是授予廣泛、長期的讀取存取。

備份和暫存還原

備份與還原 索引標籤顯示磁碟機最新的備份狀態、大小和物件數量，外加經過稽核的還原工作流程。備份僅複製受管的磁碟機資料；原始工作區磁碟不屬於此快照。

要要求還原（需要寫入權限）：

1. 在依賴還原之前，確認備份狀態徽章顯示為 目前 或 正常。
2. 新增 還原備註，描述應復原或比較的內容。請勿包含機密或原始客戶資料。
3. 選擇 要求暫存還原。

還原會先暫存到單獨的審查路徑中——它們不會覆寫您的作用中磁碟機。還原要求 清單會追蹤待處理和過往要求及其暫存路徑和備份狀態，稽核追蹤 會記錄每次要求。將暫存檔案提升回作用中磁碟機的操作在暫存檔案經過審查之前保持手動。

工作區擷取

工作區擷取 索引標籤描述在您或客戶原則允許時可以複製到磁碟機中的工作區產生素材，例如 Archibot 工作階段、產生的產物和工作區筆記。它僅供參考——它設定對哪些內容會被擷取的預期，而不是提供執行擷取的按鈕。

對於重要工作，請自行將簡短的、經過淨化的摘要儲存到磁碟機資料夾中。相比依賴本機編輯器歷程記錄，這能為未來的 Chat、VS Code、API 和工作區工作階段提供更安全的連續性參考點。

建立客戶磁碟機

客戶管理員和平台維運人員會在 共用磁碟機 索引標籤上看到一個用於設定帳戶範圍儲存的 客戶磁碟機 面板。

1. 如果您管理多個客戶（或是平台維運人員），請選擇目標 客戶 ID。
2. 輸入 磁碟機名稱，例如 CI review evidence。
3. 選擇 預設存取 原則：成員可讀、管理員可寫 或 代理可讀取已核准資料夾。
4. 新增簡短的 目的，描述該磁碟機的用途。
5. 選擇 建立客戶磁碟機。

新磁碟機會出現在客戶範圍下的清單中，並根據您設定的預設存取對帳戶可用。客戶磁碟機在整個帳戶中共用；根據您的寫入權限，以與管理個人磁碟機相同的方式管理其授權和資料夾。

後續去向

• 初次接觸平台介面？請從 歡迎使用 Archibot 和 存取角色 開始。
• 正在執行中的工作區內部工作？請參閱 管理工作區 和 建立第一個工作區。
• 關於帳戶層級備份來源以及共用磁碟機快照如何融入其中，請參閱 備份與還原來源。
• 如果檔案、授權或還原操作失敗，請遵循 疑難排解，必要時附上磁碟機名稱、操作和時間，開啟 支援交接。