wecomcli-sheet

企業微信線上表格管理

wecom-cli 是企業微信提供的命令列程式，所有操作皆透過執行 wecom-cli 指令完成。

資源型 Skill，負責線上表格（/sheet/*）的新增、內容讀寫以及子工作表管理。

呼叫方式

透過 wecom-cli 呼叫，類別為 doc：

wecom-cli doc <tool_name> '<json_params>'

介面路由表

硬性規則：第二欄為 references/xxx.md 連結者，命中該列後先 read 對應的 references 檔案，再構建指令。寫入/讀取子表資料前，先使用 sheet_get_info 取得目標子表的 sheet_id。

使用者意圖	參考位置
讀取線上表格完整內容（Markdown 概覽）	見下方「讀取完整內容」
讀取線上表格基礎資訊與子表清單	見下方「讀取基礎資訊」
從零新增線上表格（空白）	見下方「新增線上表格」
修改線上表格指定區域內容	references/sheet-update-range-data.md
線上表格末尾新增一列資料	references/sheet-append-data.md
新增線上表格子工作表	references/sheet-add-sub.md
刪除線上表格子工作表	references/sheet-delete-sub.md

介面詳述

新增線上表格

從零新增一份企微線上表格：空白。建立成功後回傳 docid 與 url。

指令

wecom-cli doc create_doc '<JSON 參數>'

參數

參數	類型	必填	預設值	說明
doc_type	int	是	—	固定帶入 4（線上表格）
doc_name	string	是	—	表格標題

注意事項

• 本介面僅建立空白線上表格，不支援帶入初始內容；如需寫入資料，請在建立後先用 sheet_get_info 取得子表 sheet_id，再透過 sheet_update_range_data / sheet_append_data 寫入。

讀取完整內容

取得線上表格的完整內容資料，統一以 Markdown 格式回傳。採用非同步輪詢機制：首次呼叫無須傳入 task_id，介面會回傳 task_id；若 task_done 為 false，需帶入該 task_id 再次呼叫，直到 task_done 為 true 時回傳完整內容。適合快速概覽或讀取整份表格內容。

指令

wecom-cli doc get_doc_content '<JSON 參數>'

參數

欄位	類型	必填	預設值	語意
docid	string	與 url 二選一	—	線上表格的 docid
url	string	與 docid 二選一	—	線上表格的存取連結
type	int	是	—	內容回傳格式，固定帶入 2（Markdown）
task_id	string	否	—	任務 ID，首次不傳，輪詢時帶入上次回傳的 task_id

回傳

欄位	類型	說明
content	string	task_done 為 true 時回傳的完整 Markdown 內容
task_id	string	任務 ID，未完成時用於下次輪詢
task_done	bool	任務是否完成，false 時需帶入 task_id 繼續輪詢

使用規則

• 首次呼叫不傳入 task_id；若 task_done 為 false，記錄 task_id 後帶入其再次呼叫，直到 task_done 為 true 取得 content。

讀取基礎資訊

讀取線上表格的基礎資訊，包含工作表清單、文件名稱與存取連結。所有後續需要 sheet_id 的介面（sheet_update_range_data / sheet_append_data / sheet_delete_sub 等）其 sheet_id 皆從本介面回傳的 sheets[] 中取得。

指令

wecom-cli doc sheet_get_info '<JSON 參數>'

參數

欄位	類型	必填	預設值	語意
docid	string	與 url 二選一	—	線上表格的 docid
url	string	與 docid 二選一	—	線上表格的存取連結

回傳

欄位	類型	說明
sheets	array	工作表清單；每項包含 sheet_id / title / row_count / column_count / data_range 等基礎資訊
url	string	文件存取連結
name	string	文件名稱

使用規則

• docid 與 url 二選一，至少帶入其一。
• 讀取 → 寫入 流程：當需要向特定子表寫入內容（sheet_update_range_data / sheet_append_data）時，應先用 get_doc_content 讀取並識別出各子表的標題與具體資料，再呼叫本介面取得 sheets[] 中每個子表的 sheet_id 與列數／欄數（row_count / column_count）；透過子表標題與 title 比對確定目標 sheet_id，並結合列數／欄數核對寫入區域範圍，進而打通「讀取 → 寫入」的完整流程。

跨 Skill 相依性

相依 Skill	典型協作場景	資料流向
wecomcli-contact	表格中需要寫入人員資訊時按姓名查詢 userid	get_userlist 查到 userid → 本 Skill 寫入
wecomcli-msg	使用者要求將線上表格連結發送給某人/某群組	本 Skill 新增後回傳 url → wecomcli-msg 發送連結