管理與分享 Specialists
使用包遷移配置好的角色,匯入後完成本地設定。Skills、Connector 引用與本機授權的可遷移範圍不同。
批次管理時,先在底部操作區核對選中數量,再執行操作。在同一位置閱讀完成或失敗反饋,並檢查條目的最終狀態;僅選中條目不會啟用、安裝或刪除它。
列表控制元件
| 控制元件 | 操作與預期結果 |
|---|---|
| Search specialists / 類別篩選 | 縮小已安裝列表,找不到已儲存角色時清除篩選 |
| Edit / 角色名稱 | 編輯已有角色;儲存後重新開啟檢查 |
| Change appearance | 修改圖示/顏色,不改指令 |
| Manage Tags | 新增整理標籤 |
| Toggle | 啟用或禁用,不刪除角色 |
| Actions → Duplicate | 開啟復制了指令和繫結的新草稿,名稱帶 Copy;仍須點選 Create specialist |
| Actions → Export ZIP | 選擇匯出內容並儲存可遷移包 |
| Actions → Delete | 永久刪除確認;單獨檢查可選的 Skill 刪除項 |
刪除角色前,檢查是否同時刪除其 Skills。其他角色仍在使用時保留共享 Skill;刪除副本不需要刪除原角色。

共享與匯入包
匯出所需 Skill 檔案
示例 分享包含 Skill 的複核角色
- 在角色上選擇 Actions → Export ZIP。
- 在 Choose Skills to include 明確勾選
rnaseq-count-qc;Personal/Imported Skill 不一定預設包含。 - 匯出後檢查歸檔內容。

實際含 Skill 的包包含 manifest.json、specialist.json、skills/rnaseq-count-qc/SKILL.md 及參考結構。最小匯出可只有兩個 JSON。Connector ID 只是引用,憑據、本機信任和 Full access 不會作為現成授權遷移。
匯入、解決衝突、完成設定
- Add specialist → Import ZIP → Choose ZIP,一個包恰好包含一個 Specialist。Download template 可下載模板。
- 檢查名稱、不可變 ID、版本、隨包 Skills、歸檔上限和診斷。
- Skill 衝突需逐項選擇 Keep installed Skill 或 Use package Skill。後者替換所有當前使用者的 Skill 檔案,應閱讀 Affected now。
- Specialist ID 已存在時點選 Review overwrite,比較版本,必要時先匯出當前包,再單獨確認 Overwrite and continue。
- 匯入后角色處於 disabled / SETUP INCOMPLETE。在編輯器檢查指令與能力,選擇訪問範圍,再 Save changes 完成設定並啟用。
- 重新開啟角色,執行小範圍任務驗收。

Version unchanged 仍可能伴隨 Skill 衝突。明確選擇 Skill 來源,匯入後重新開啟角色,核對能力繫結和訪問範圍。
| 預覽控制元件 | 檢查內容 |
|---|---|
| 展開隨包 Skill | 版本、處理方式、原因與檔案列表 |
| Archive limits | 本介面為壓縮 50 MB、展開 200 MB、2,000 檔案、單檔案 25 MB |
| Diagnostics | 阻斷錯誤、警告和資訊;警告可能需要明確選擇 |
| Copy report / Download JSON | 儲存診斷用於排錯,分享前檢查內容 |
| Cancel | 退出預覽,不安裝 |
| Next / Review overwrite | 必要選擇和校驗透過後繼續 |
從瀏覽器匯入: 透過 Import ZIP → Choose ZIP 選擇包,檢查內容、處理衝突並完成本地設定後再啟用。目標裝置仍需單獨配置憑據和信任。上傳失敗時保留錯誤,按故障排查處理。
使用市場
開啟 Browse Marketplace,搜尋角色,選擇 View details。檢查釋出者、來源、版本、許可證、下載大小、Skills 與 Connector 引用。Refresh Marketplace 重新整理目錄,Manage Marketplace sources 管理來源。All/Official/Community 表示來源型別,不表示執行環境已就緒。

點選 Install Specialist,確認角色出現在 Marketplace,核對啟用狀態與繫結。目錄中的包數量僅描述該包,不是應用能力總數。安裝不會執行研究任務,也不會準備全部外部依賴;使用前完成所需配置。

歸檔損壞、預覽過期、繫結缺失或下載失敗時,保留診斷程式碼、應用/包版本與來源 URL,透過故障排除反饋,不在 issue 中公開金鑰或研究資料。
實現依據: SpecialistsPanel.tsx。
分享前驗證
匯入或修改角色後,使用其已分配能力完成一個小任務,並開啟儲存結果核對。已有方法寫作、PCA 與矩陣案例見使用已安裝 Specialist 擴充套件分析。按所選路線檢查輸入要求和未解決限制。