Workspace
以 Univer Office SDK 建構的開源工作區:雲端試用、私有部署,透過 Workspace CLI 接入既有 Agent,或在 Desktop 中進行對話式辦公。
Univer Workspace 是基於 Univer Office SDK 建置的開源辦公空間,供人與 Agent 協同工作。可編輯的 Office 內容與繫結資料的 Web App 放在個人與團隊 Space 中,分享、協同、版本和變更審閱也一併在這些空間中提供。開源倉庫包含應用、部署方案、CLI 和桌面客戶端。
你可以把 Workspace 部署在自己的基礎設施上,也可以先從雲端線上試用開始。已有 Agent 透過 Workspace CLI 接入。Workspace Desktop 把 Agent 對話和同一套工作區整合進本地應用。這幾種方式使用的是同一個服務和同一批檔案。
雲端試用 · 連接既有 Agent · 私有部署 · Desktop 體驗 · 儲存庫與客製
先在雲端體驗完整的 Workspace
開啟雲端線上試用,登入後進入個人空間或有權限訪問的團隊 Space。建立或開啟文件,體驗直接編輯、整理檔案和分享。該 Workspace 服務已經在執行,因此也可以用下文的 CLI 接入 Agent。試用面向範例資料,這些資料可能被重置。
Workspace Server 管理身分、空間、權限、儲存、協同和版本。Web 是瀏覽器中的編輯與審閱介面。私有部署執行同一套 Server 與 Web 應用。
讓既有 Agent 連接雲端 Workspace
在 Agent 的執行環境中安裝 CLI 和發現入口 Skill。需要 Node.js 22.12 或更新版本,推薦 Node.js 24。能執行命令的 Agent 可以使用這些工具,模型和對話仍由該 Agent 提供。請顯式設定雲端服務地址,使瀏覽器和 Agent 操作同一個 Workspace:
npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.ai首次連接:完成一次瀏覽器登入
已有有效會話時可以跳過這一步。如果需要登入,執行:
uvw auth login開啟返回的連結,在瀏覽器中登入並確認驗證碼。待使用者確認完成後,執行:
uvw auth login --complete這一步只在建立會話時需要。完整命令與認證說明見 Workspace CLI 指南。
瀏覽器完成首次授權後,CLI 會在後續任務中複用該會話。不需要為特定 Agent 編寫登入頁面或鑑權整合。給已連線的 Agent 下達任務,開啟它返回的連結,即可在 Web 中看到同一份內容,並在合入前審閱 Agent 對原生 Office 內容的修改。
從可計算、可審閱的文件開始
在我的 Workspace 個人空間建立英文月度開銷試算表,包含日期、類別、金額與 5 筆示例資料,加入總額公式與分類圖表。將變更放在獨立草稿,檢查資料、公式與顯示效果,提供預覽或審閱連結,在我確認前不要合入。可以把這段文字發給已連線的 Agent,或在 Desktop 中使用。Agent 負責建立並檢查文件,你提出修改、審閱結果,再決定是否合入。同一份內容也可以在線上版中開啟。
把相同流程搬到私有部署
開源倉庫包含 Server 和 Web。按照部署指南建置應用,再配置自己的域名、登入方式、持久化儲存和執行參數。從原始碼開發使用 Node.js 24 和 pnpm 11,生產部署細節以該指南為準。
部署前需要準備四個部分:
| 部分 | 需要設定什麼 |
|---|---|
| 服務 | 可訪問的 Workspace 地址,以及 Server + Web 應用。Desktop 和 CLI 都連線這套部署。 |
| 持久化資料 | 產品資料庫、協同資料庫和上傳檔案需要一起保留。預設部署將它們存放在 .data 下;使用 Docker 時需要掛載持久化卷。 |
| 身分 | 配置登入方式。接入 Desktop 時,註冊 Agent OAuth 客戶端,回撥地址必須完全匹配。 |
| SDK 授權 | 為部署網域建置 Web 時提供 VITE_UNIVER_LICENSE,並另外設定 Node.js 內容執行環境所需的授權。 |
模型憑據由 Agent 宿主管理,與 Workspace 登入分開配置。當前設定見部署指南和 Agent 接入說明。
繼續使用同一個 CLI,把服務地址指向自己的部署,並在該服務中授權一個賬號。把下面的範例地址替換為實際的服務地址:
uvw config set workspace.origin https://workspace.example.comuvw auth loginAgent 使用的工具和 Skills 不變,操作物件變為私有服務中的檔案和權限。Desktop 也可以連線該服務。客戶端註冊和回撥配置見 Agent 連線指南。
把 Workspace 放進本機 Desktop 客戶端
Workspace Desktop 把 Workspace、Agent 執行時、Office 工具和內容預覽整合進一個本地客戶端。辦公過程採用與 Codex 或 Cowork 類似的對話與預覽配合方式:描述所需結果,在對話旁檢視文件或 Web App,提出修改,再審閱結果。
Desktop 可以連線前文試用的雲端 Workspace、私有部署,也可以連線本機執行的 Workspace 服務。模型和對話透過配置好的 Agent 宿主執行,檔案和訪問權限由所連線的 Workspace 管理。下面的桌面案例展示生成、管理與協作如何銜接。
把 Agent 工作方式帶進日常辦公
辦公工作不會在對話返回一個可下載檔案後結束。人還需要繼續編輯、基於真實資料計算、與同事協作,並決定接受哪些修改。Desktop 把這些環節放在同一個工作環境中。
- 保持上下文: 對話、檔案、本地引用和工作區資料始終可以訪問。
- 原生 Office 內容與 Web App: 可以建立、預覽和編輯電子表格、文件、簡報、Relational Tables 和 Canvases,也可以建置由 Office 資料支撐的互動頁面。
- 檢視並修改結果: 在對話旁開啟內容,檢查公式和排版,再提出具體修改。
- 經審閱後交付: Agent 對原生 Office 內容的修改保留在 Worktree 中,直到有人審閱併合入共享工作區。
從需求到可審閱的辦公成果
在普通對話中生成和修改 Office 文件與 Web App,再到 Space 中統一管理和分享。原生 Office 變更先經過 Worktree 審閱,再合入。HTML 頁面釋出和繫結寫回遵循各自的儲存與授權流程。後續對話可以引用同一份檔案和資料。
桌面應用整合的能力
| 能力 | 使用體驗 |
|---|---|
| Agent 工作階段 | 對話和任務上下文儲存在本地,模型服務商與模型也在本地配置。 |
| 檔案與資料引用 | 瀏覽有權限訪問的空間。使用 @ 引用 Workspace 檔案或資料夾,以及本地資料。 |
| 內容預覽 | 在對話旁開啟原生 Office 檔案或 Web App,檢查內容、互動和資料。 |
| 審閱與交付 | 檢視 Worktree 新增、修改或刪除的文件,然後提出修改、合入或放棄。 |
| 本機與線上空間 | 連線團隊的線上服務,或在本機執行 Workspace 服務。 |
| Space 管理與協作 | 整理對話生成的檔案,管理分享,並與同事編輯同一份內容。 |
工作區與 Agent 的實際配合
下面的截圖來自一臺真實的 macOS Desktop,連線的是本地 Workspace,使用的是虛構的釋出專案資料。該整合預覽由可擴充套件的 Agent 宿主、Space 能力外掛和 Univer 品牌皮膚組合而成,可用功能取決於專案釋出的版本。
在一般對話中產生內容並查看結果
在普通對話中說明需求,Agent 會建立或修改 Office 文件和 Web App。預覽顯示在右側,後續可以透過對話繼續完善。內容儲存在 Workspace 中,由 Space 負責檔案管理、分享和協同。
01 Launch Budget 把預算、實際支出、預測、差額公式和合計放進同一張表。圖表對比預算與實際支出,並顯示每條工作流的差額。
02 Launch Brief 把目標、釋出計劃、成功指標和負責人任務整理成可編輯的文件。
03 Launch Story 把計劃做成簡報,包含釋出階段、審批關卡和成功指標,可用於團隊評審。
04 Launch Plan 按階段、狀態、優先順序和負責人管理任務,並支援隨工作推進在表格、狀態看板和階段檢視之間切換。
05 Launch Map 在畫布上連線釋出階段,把交付物、負責人和審批檢查點納入同一份視覺化計劃。
同樣的對話流程也可以生成 Web App。06 Launch Dashboard 用指標卡、圖表和工作流明細展示預算、實際支出和差額。HTML View 繫結讓頁面可以讀取表格資料,團隊可以在 Office 檔案旁使用互動式報告。雙向繫結仍為實驗性功能。
在 Space 中管理產生的成果
對話成果會成為團隊持續使用的檔案。Space 把 Office 內容和 Web App 集中存放,提供產品分類、最近檔案、收藏以及個人和團隊空間。下圖的 All 檢視彙總了 Aurora Launch Studio 和 Team Invitations 的資料。
從 Space 繼續編輯與協作
從 Space 開啟 01 Launch Budget,即可在原生表格編輯器中繼續工作。預算明細、公式和合計都可以編輯,評論、編輯歷史和分享也在同一檢視中提供。Web 和 Desktop 讀取同一套 Workspace 檔案。Agent 後續的修訂可以保留在獨立 Worktree 中,等待審閱。
Worktree 與 Compare:審閱後再合併
在 Intelligent Workbench 中,Compare 把正式預算與 Agent 的修改稿並排展示。草稿新增兩條明細並更新合計,變更列表和高亮標出受影響的單元格。檢查內容、格式或公式後,可以合入或放棄草稿。Worktree 負責隔離草稿,Compare 展示差異。
將文件或 Web App 分享給團隊
在儀表盤上開啟 Share,檢視誰能訪問該頁面並複製其連結。在這個團隊 Space 中,頁面繼承 Space 的成員權限,Manage Space access 會開啟這些權限的管理入口。複製連結不會額外授予訪問權限。
安裝並連接工作區
如果已經在使用可擴充套件的 Agent 桌面,整合方式是安裝並啟用 Space 能力外掛,從 Space 連線服務、配置模型,再新增品牌皮膚。本頁截圖使用這套組合。完整的 Workspace Desktop 發行版和外掛預覽遵循不同的交付路徑,請按所安裝版本的釋出內容或倉庫說明操作。
-
從 GitHub Releases 選擇 Desktop 安裝包。桌面版使用 agent-v 標籤,按平臺選擇 Windows x64、macOS Apple Silicon 或 Linux x64 建置產物。桌面交付仍為實驗性,可用版本以已釋出的內容為準。
-
在 Settings → Workspace 中選擇 Workspace 服務,透過瀏覽器登入並授權。可以連線已部署的服務,也可以按照本地執行說明在本機執行一個 Workspace 服務。
-
在 Models 設定中配置支援的服務商、模型和憑據。Workspace 登入與模型訪問分開配置,詳見模型配置說明。
-
新增有權限訪問的個人或團隊 Space,開始對話,並使用 @ 引用源資料。執行下面的任務,然後開啟內容預覽和變更審閱。
安裝包包含 Agent 應用和 Office 工具。Workspace 服務獨立執行,可以在本機或遠端伺服器上;模型訪問使用所配置的服務商。
體驗任務:用兩份原生內容完成預算審閱
在目前空間建立英文 Budget Review 試算表,包含 8 行部門範例資料:Department、Budget、Actual、Variance。差異與合計使用公式,加入預算與實際支出比較圖。再建立簡短文件,總結超支情況並連結至表格。原生 Office 變更放在同一 Worktree,檢查資料、公式與成果,開啟預覽與變更審閱,等待我確認後才合入。隨後可以補充:“將 Marketing 的預算減少 10%,並更新總結。”檢查調整後的數值和文件變更,再決定是否接受草稿。
以儲存庫建構自己的 Workspace
前面使用的應用是一套可調整的 Office SDK 組合。從 Workspace 倉庫開始,複用內容執行時和協同能力,再圍繞自己的團隊重建工作流程、Skills、工具和介面。
找到要客製的部分
| 儲存庫位置 | 責任 |
|---|---|
apps/workspace | Server、Web、產品 API 與部署設定。 |
apps/cli | 把已有 Agent 接入已部署的 Workspace。 |
apps/agent | Agent 宿主、連接生命週期與原生 Desktop 外殼。 |
skills/univer-workspace-cli | 安裝到既有 Agent 的發現入口 Skill。 |
packages/client-core | Node 宿主共享的 Workspace 內容操作。 |
packages/dsh-univer-workspace-plugin | Agent 宿主的 Office 工具、原生預覽和任務指引。 |
packages/dsh-univer-workspace-skin-plugin | Workspace 品牌外觀與視覺令牌。 |
packages/workspace-html-viewer | Web App 的 HTML View 沙箱與綁定宿主。 |
Skills:讓 Agent 理解工作區並完成任務
這組 Skills 讓已有 Agent 在已連線的 Workspace 中建立和編輯 Office 內容與 Web App,再把修改交付審閱。請先把 Agent 連線到 Workspace;下面的指引操作該服務中的檔案,並遵循其權限。
讓既有 Agent 學會使用 Workspace
安裝到已有 Agent 中的 univer-workspace-cli Skill 是發現入口,說明如何連線 Workspace、定位目標和載入操作指引。完整的執行時 Skills 隨 CLI 釋出,與命令和 Facade API 保持一致。Desktop 內建的能力外掛也提供任務指引和工具。
| 指引 | 涵蓋內容 |
|---|---|
core | 定位空間和檔案、在任務草稿中工作、檢查內容並交付審閱。 |
sheet · doc · slide · base · board | 試算表、文件、簡報、關聯式表格(Relational Table)與畫布(Canvases)。 |
blob | 原始檔案的上傳、下載與替換。 |
html-view | 建立和管理用於互動式 Web App 的即時 HTML 頁面。 |
embed · cross-unit-formula | 嵌入其他內容,以及跨內容型別連線資料和公式。 |
uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-view先載入 core,再按任務載入所需的產品或主題。skills get 列出參考路徑;讀取單份文件可使用 uvw skills read <name> <path>,新增 --full 可以全部讀取。已有 Agent 透過 CLI 使用這些能力,Desktop 則把工具和指引整合進對話流程。
Desktop 內建的任務指引
Desktop 的能力外掛套件含 univer Skill 及其參考資料。它說明空間與文件之間的關係、如何使用 Office API,以及如何建立、檢查並交付 Worktree。這些說明與可執行工具配套,Agent 可以查詢 API、在原生內容上執行並檢查結果。
能力外掛把檔案發現、Headless Facade 編輯、結構化檢查、匯入匯出和 Worktree 生命週期工具組合在一起。當前預覽把草稿準備到可審閱狀態;正式釋出經過所部署應用的審閱與合入流程。自己的應用可以在同一 Office 執行時上增加行業 Skills、模板和業務工具。
預覽外掛套件含九個 Skills。通用 Skill 說明發現、身分和交付,各產品 Skill 說明其 API 和結果驗證方式。Agent 按當前任務讀取相應部分。
| Skill | 操作指引 |
|---|---|
univer | 空間、檔案、草稿生命週期與交付 |
univer-sheet | 公式、樣式、圖表與試算表驗證 |
univer-doc | 文件結構、段落與表格 |
univer-slide | 簡報製作與視覺版面檢查 |
univer-base | 欄位、記錄與檢視 |
univer-board | 圖形、連接線與畫布版面 |
univer-embed | 在一個 Office 產品內嵌入另一個產品 |
univer-cross-unit-formula | 跨 Unit 引用與計算 |
univer-html-view | 構建及檢查綁定 Office 資料的 HTML 頁面 |
Office SDK 如何支撐 Workspace
Workspace 把原生編輯器、Agent 對內容的操作和團隊協同連線到同一套文件與權限上。可以基於這套開源應用和 Office SDK 開發,把精力集中在自己的業務流程、介面和整合上。
Agent 透過 CLI 或 Desktop 在 Node.js 中操作內容,使用者在 Web 或 Desktop 編輯器中檢視、編輯和審閱。Workspace Server 儲存共享文件、草稿和協同狀態,可以執行在本機、自己的伺服器或雲端。
| 層次 | 負責什麼 |
|---|---|
| Web SDK | 內容模型、公式、公開 Facade API 和原生編輯器。 |
| AI SDK | API 查詢、結構化內容檢查,以及針對指定文件執行 Facade 程式碼。 |
| Server SDK | 協同、修訂版本、Worktree 草稿和檔案轉換。 |
| 應用層 | Workspace 負責空間、檔案、權限、分享和審閱。Agent 宿主負責會話、模型呼叫與工具編排。 |
CLI 和 Desktop 共用同一個內容操作層。它的執行時池在宿主執行期間保持已載入的文件,並在執行前同步版本。不同客戶端因此複用同一套編輯與提交邏輯,詳見執行時複用。
視覺檢查補充結構化檢查無法覆蓋的內容。截圖來自瀏覽器渲染,自動版面配置診斷目前能發現簡報中的文字溢位與重疊。
Agent 的修改如何成為可審閱的變更
以預算審閱為例,Agent 編輯的是一張包含公式和樣式的電子表格。原生 Office 的編輯路徑如下:
- 定位並載入。 Agent 選擇文件和 Worktree,載入快照與 changeset,同步到選定的修訂版本。Unit 指一個文件例項,例如一個工作簿。
- 透過 Facade 編輯。 Node.js 執行時對該 Unit 執行公開 Facade 呼叫。內容變更產生 mutation,這些 mutation 會被收集為 changeset 並提交到草稿。
- 檢查結果。 Agent 讀回數值和公式,必要時檢查渲染結果。Agent 繼續在同一草稿中編輯,直到結果可以交付審閱。
- 審閱並合入。 人員在內容比較中檢查變更,再決定是否將 Worktree 合入共用版本。
把 changeset 儲存到草稿並不等於合入。 只有提交得到確認,Workspace 才報告寫入成功;衝突和未確認的提交會返回錯誤。在 Desktop 外掛中,合入和放棄工具也需要使用者批准,這一要求由應用的工具流程執行。
Web App 如何連接同一份辦公資料
釋出儀表盤和預算編輯器使用同一份電子表格。HTML View 在沙箱 iframe 中渲染頁面。Workspace 宿主解析使用者可訪問的源文件,並提供其已授權的內容引擎。指標卡和圖表訂閱源資料,因此不需要維護另一份預算副本。
對於可編輯繫結,寫入需要已登入身分和源文件的編輯權限。離開頁面時,宿主等待未完成的寫入和協同確認,並報告儲存失敗。HTML 頁面釋出和繫結寫回使用各自的儲存路徑,不會自動遵循原生 Office 的 Worktree 合入流程。詳見實驗性雙向繫結和 HTML View 宿主實現。
依自己的業務流程繼續擴充
| 目標 | 起點 |
|---|---|
| 產業文件與專屬任務 | 增加行業 Skills、模板和工具指引,並保留內容與視覺檢查。 |
| 自己的身分、儲存與分享方式 | 擴充套件 Workspace 應用及其伺服器端產品策略。 |
| 自己的 Agent 辦公客戶端 | 組合 Agent 宿主、能力外掛和品牌皮膚,再接入所需的模型和業務工具。 |
例如:增加預算審閱 Skill
行業 Skill 可以承載團隊的審閱規則,同時複用已有的 Office 工具:
- 定位源工作簿、賬期和預算/實際支出列,編輯前詢問缺失的業務定義。
- 載入表格操作指引,建立 Worktree,並使用 Facade 更新公式、準備審閱文件。
- 檢查合計、公式結果和展示效果,報告變更檔案和已執行的檢查,再把草稿交給審閱人。
業務規則和模板放在 Skill 中,訪問檢查、草稿儲存和合入批准留在應用層。接入 ERP 或 CRM 時,增加一個返回所需資料的應用工具,然後複用同一套 Office 編輯與審閱流程。Skill 負責指導執行,不授予檔案訪問權限。
繼續查看實作
你覺得這篇文檔如何?