wecomcli-smartpage

企業微信智能文檔管理

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

資源型 Skill，負責智能文檔（原名智能主頁，/smartpage/*）的建立與內容匯出。

呼叫方式

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

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

回傳格式說明

所有 API 皆回傳 JSON 物件，包含以下通用欄位：

欄位	型別	說明
errcode	integer	回傳碼，0 表示成功，非 0 表示失敗
errmsg	string	錯誤訊息，成功時為 "ok"

當 errcode 不為 0 時，表示 API 呼叫失敗，可重試 1 次；若依然失敗，請將 errcode 和 errmsg 呈現給使用者。

特殊錯誤碼

errcode	errmsg	含義	處理方式
851002	incompatible doc type	文檔類別與呼叫的 API 不符合	確認目標 URL 為 /smartpage/*；若不是，請切換至對應類別的 Skill

API 詳細說明

建立智能文檔

建立智能文檔（原名智能主頁），支援傳入標題與多個子頁面。每個子頁面可指定標題、內容類型及本機檔案路徑。建立成功後回傳 docid 與 url。

特殊語法：此指令必須使用 +smartpage_create（帶有 + 字首），加號不可省略；該 + 僅適用於此指令，請勿混用到其他 doc 子指令。

指令

wecom-cli doc +smartpage_create '<JSON 參數>'

參數

參數	型別	必填	預設值	說明
title	string	否	—	智能文檔標題
pages	array	是	—	子頁面清單
pages[].page_title	string	否	—	子頁面標題
pages[].content_type	int	否	1	內容類型：1-Markdown，0-Text（純文字）
pages[].page_filepath	string	否	—	子頁面內容對應的本機檔案路徑

注意事項

• content_type 必須與檔案實際內容符合：.md 檔案或包含 Markdown 語法的內容必須傳 1，僅純文字才傳 0。絕大多數情境皆應傳 1。
• docid 僅在建立時回傳，請妥善保存。
• 每個子頁面的 Markdown 檔案容量不得超過 10MB，超過將導致建立失敗；若檔案過大，需先拆分至多個子頁面再進行建立。
• 智能文檔亦支援背景區塊（<card>）、分欄（<grid>）等擴充語法，詳情請參閱 references/smartpage-create.md。

匯出智能文檔內容

取得智能文檔的完整內容並匯出為 Markdown。採用非同步兩步驟操作：先透過 smartpage_export_task 送出匯出任務以取得 task_id，再透過 smartpage_get_export_result 輪詢任務狀態，直到 task_done 為 true 時回傳 content。

第一步：送出匯出任務

# 透過 docid
wecom-cli doc smartpage_export_task '{"docid": "DOCID", "content_type": 1}'
# 透過 url
wecom-cli doc smartpage_export_task '{"url": "https://doc.weixin.qq.com/smartpage/xxx", "content_type": 1}'

參數	型別	必填	預設值	說明
docid	string	與 url 二選一	—	智能文檔的 docid
url	string	與 docid 二選一	—	智能文檔的存取連結
content_type	int	是	—	匯出內容格式，目前僅支援 1（Markdown）

第二步：輪詢匯出結果

wecom-cli doc smartpage_get_export_result '{"task_id": "TASK_ID"}'

參數	型別	必填	預設值	說明
task_id	string	是	—	由 smartpage_export_task 回傳的任務 ID

使用規則

• 第一步取得 task_id 後，帶入並呼叫第二步；若 task_done 為 false 則繼續輪詢，直到 task_done 為 true，回傳的 content 欄位即為完整 Markdown 內容。

參閱 API 詳細資訊。

跨 Skill 依賴

依賴 Skill	典型協作情境	資料流向
wecomcli-msg	使用者要求將智能文檔連結傳送給某人/某群組	本 Skill 建立後回傳 url → wecomcli-msg 傳送連結