前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在 Web 環境下處理 Excel 文件，通常需要下載到本地編輯後再上傳，或者集成複雜的第三方組件。dsh-plugin-spreadjs-editor 將 GrapeCity 的 SpreadJS Designer 直接嵌入到 DSH 的 Web UI 右側文件樹中，允許用戶在不離開瀏覽器的情況下查看和編輯工作簿。

插件簡介¶

• 名稱：grapecityxa/dsh-plugin-spreadjs-editor
• 所有者：GrapeCityXA
• 類別：客戶端
• 許可證：插件代碼採用 MIT 許可證，內置的 SpreadJS 和 Designer 需商業授權（未配置時爲試用模式）。
• 核心價值：提供原子的保存機制、會話工作區限制和衝突檢測，將 Excel 編輯集成到 DSH 的工作流中。

安裝與前置要求¶

使用 DSH CLI 安裝插件。需要確保宿主 DSH 版本不低於 0.1.5-rc.3。

1. 執行安裝命令：

    dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor

2. 啓動 DSH：

    dsh --profile web

3. 在 Web UI 右側文件樹中打開 .xlsx、.xlsm、.csv、.sjs 或 .ss 文件即可使用。

核心功能¶

插件內置了 SpreadJS 和 Designer，提供了以下核心能力：

1. 文件支持：支持 .xlsx、.xlsm、.csv、.sjs、.ss 格式。
2. 編輯與查看：直接從文件樹打開工作簿，使用 SpreadJS Designer 進行表格編輯。
3. 保存機制：
   • 原子寫入：通過臨時文件重命名覆蓋，保證寫入完整性。
   • 衝突檢測：保存前比對文件哈希，防止覆蓋外部修改。
   • 會話限制：只允許保存到當前會話工作區內，防止越界。
   • UI 交互：保存按鈕位於 DSH 文檔頭部工具欄，未保存時按鈕前會出現標記點。同時支持 Ctrl+S 快捷鍵。
4. 另存爲：
   • 將工作簿寫入工作區另一個路徑，成功後就地切換到該文件。
   • 不覆蓋同名文件，提示用戶重命名。
5. 主題跟隨：編輯器自動跟隨 DSH 的淺色/深色主題。
6. 關於信息：在編輯器的“設置”標籤頁中包含“關於”按鈕，顯示內置版本與授權狀態。

使用指南¶

1. 打開文件：在 Web UI 右側文件樹中雙擊目標文件。
2. 保存改動：編輯完成後，點擊文檔頭部工具欄的“保存”按鈕，或按 Ctrl+S。未保存時按鈕前有標記點。
3. 另存爲：點擊“另存爲…”將工作簿複製到工作區其他位置並切換標籤頁。

配置與注意事項¶

1. DSH 版本要求：必須使用 DSH >=0.1.5-rc.3。低於此版本無法使用文檔頭部動作槽，保存入口可能受限。
2. Designer 隱藏：Designer 自帶的“文件”標籤頁已從 Ribbon 隱藏，以避免與 DSH 頭部的保存按鈕混淆。
3. 未保存狀態處理：
   • 切走再切回或關閉標籤頁，未保存的改動不會丟失（通過緩存實現）。
   • 如果磁盤上的文件已被外部修改，面板右下角會提示“存在未保存的改動緩存，但文件已在磁盤上被修改”，可選擇恢復或丟棄。
4. 許可證配置：如需正式部署，需在 web profile 的 cordis.patch.yml 中配置 licenseKey 和 designerLicenseKey。

    - id: spreadjs-editor
      config:
        licenseKey: 'YOUR_SPREADJS_KEY'
        designerLicenseKey: 'YOUR_DESIGNER_KEY'
        maxSaveBytes: 67108864
        trustedHosts: []

結尾¶

該插件通過將 SpreadJS 集成到 DSH 的右側欄，解決了 Web 環境下 Excel 編輯的集成問題。配合 DSH 原生的保存機制和衝突檢測，適合需要在智能體工作流中直接操作 Excel 的場景。

• 目錄頁：DSH 插件目錄
• 源碼地址：GitHub