線上文件 SDK 選型：私有環境中的可嵌入編輯能力

需要在自家產品中提供文件編輯能力的團隊，通常面臨三岔路：嵌入編輯 SDK、整合整套文件套件，或自行打造編輯器。每個選項的長期成本性質不同。

本文聚焦第一個選項——部署在私有環境中的可嵌入文件編輯 SDK——以及區分「可行選擇」與「昂貴選擇」的準則。

嵌入、整合，還是自建？

• 嵌入 SDK。 你取得編輯介面與協作模型，再把它整合進產品的導覽、權限與儲存。當文件只是更大工作流程中的一項能力時最合適。
• 整合文件套件。 你採用一套有自身 UI 與帳號模型的較大型產品。對標準辦公作業很快，但當體驗必須像原生功能時就不太合適。
• 自建編輯器。 控制力最大，成本也最高。唯有當編輯行為是核心差異化，且你能支撐長期路線圖時才合理。

這些區別在商業上同樣重要。WPS 這類產品是完整的辦公套件；可嵌入 SDK 則是元件。它們解決不同問題，元件不能取代套件，套件也不適合嵌入他人的工作流程。

可嵌入 SDK 必須提供什麼

1. 編輯保真度

使用者會拿他們慣用的工具來評斷編輯器。請檢查：

• 富文字結構：標題、清單、表格、圖片、註解，以及（若需要）追蹤修訂。
• 分頁與列印版面（若文件具合約性質或會被列印）。
• 從瀏覽器與辦公應用程式貼上的行為。
• 長文件的效能——數百頁、大型表格、大量圖片。

請用你自己的真實文件測試，而不是廠商挑選的範例檔。

2. 協作模型

多人編輯需要一致性模型。兩種常見做法：

• 操作轉換（OT）：將操作對並行操作進行轉換；對結構化文件很強，但需要中央權威。
• 以 CRDT 為基礎的做法：收斂式資料結構；對離線與同儕情境很強，但在記憶體與文件表示上有不同取捨。

正確答案取決於你的部署與離線需求。請詢問衝突如何解決、網路分裂時會發生什麼，以及當其他人同時編輯時，單一使用者的復原行為如何。

3. 格式相容性

匯入與匯出正是專案默默失敗之處。請確認：

• 匯入、匯出與往返轉換支援哪些格式。
• 往返轉換是否保留樣式、註解與修訂歷程。
• 不支援的功能如何處理——默默丟棄還是標示出來。
• 轉換發生在用戶端、伺服器端，或兩者。

若你的使用者會與 Microsoft Office 或 WPS 使用者交換檔案，往返保真度值得一套專屬測試集。

4. 權限與分享

文件通常沿用宿主產品的權限。SDK 必須支援文件層級角色、（必要時）分享連結，以及管理員覆寫——且不得在第二套系統中重複你的授權邏輯。

請詢問權限決策在哪一層強制執行：用戶端、協作服務，還是儲存層。唯有在伺服器端強制執行才有意義。

5. 儲存與部署

在私有化部署中，文件內容與版本歷程存放在你的物件儲存與資料庫。請釐清：

• 文件表示格式，以及是否可匯出。
• 版本歷程與保留控制。
• 備份與還原的預期。
• 元件清單、連接埠與對外連線需求。

6. 離線與弱網

若使用者在連線不穩的環境編輯，請定義預期行為：本機草稿保存、重連時的衝突處理，以及協作服務不可達時使用者能看到什麼。

7. 整合介面

SDK 應提供生命週期事件、自訂工具列動作、外掛點與主題化。請確認產品 UI 有多少必須重寫、多少可以設定，以及升級是否可能破壞你的客製。

評估計畫

一套簡短但貼近實況的評估：

1. 在自家應用程式外殼中的測試頁面嵌入編輯器。
2. 匯入 10–20 份具代表性的文件，並與來源檔比對呈現結果。
3. 執行 5–10 人的協作工作階段，其中包含一次強制斷線。
4. 以竄改過的用戶端請求嘗試繞過權限。
5. 匯出文件並驗證往返保真度。
6. 與基礎設施團隊檢視元件與網路需求。

對每個候選方案，都依相同準則記錄結果。展示會的照片不是證據。

成本與路線圖風險

• 授權模式。 按席位、按文件、按部署或平台授權，會隨用量成長大幅改變經濟結構。
• 格式維護。 辦公格式持續演進；請詢問相容性更新如何交付。
• 路線圖依賴。 若某項必要能力仍在「規劃中」，請約定合約檢查點或替代方案。
• 社群與招募。 廣泛使用的開源編輯器可降低鎖定；專有產品可能提供更好的支援。兩者都合理，但隱含的風險不同。

飛雁在線文檔的定位

飛雁在線文檔是我們的文件編輯 SDK，設計為可嵌入、可私有化部署。目前處於 Coming soon 階段：我們並未將其呈現為已可用的產品，也沒有客戶部署案例可引用。

若你現在正在評估這個類別，請用上述準則檢視任何候選方案，包括我們的方案——待預覽版推出之後。我們寧願被用可運行的版本評估，而不是用路線圖。