前言¶

團隊協作文檔落在企業微信在線文檔上時，常見做法是人工打開鏈接、複製表格或段落，再貼回對話裏讓 AI 分析或改寫。鏈接在 doc.weixin.qq.com，沒有官方面向 Agent 的讀寫 API，自動化往往停在「截圖 + OCR」或半手工導出。

下面介紹 SkillHub 上的 企微文檔讀寫全能小助手 skill（座標 @user_5f5835e5/wecom-doc-skill，當前版本 1.0.17）。它把企業微信文檔 MCP 服務的源碼和安裝腳本打包進 Skill，安裝後由 Playwright 驅動瀏覽器完成掃碼登錄，並通過 MCP 工具讀取、寫入、截圖在線文檔，無需自行 git clone 拉倉庫。

這是什麼¶

一句話定位：面向 AI Agent 的企業微信在線文檔 MCP 服務安裝與使用指南 Skill。

• 發佈渠道：SkillHub 社區技能，分類 office-efficiency，發佈者 user_5f5835e5；頁面標註 requires_api_key=false，不依賴額外 API Key。
• 解決的問題：在 Cursor、CodeBuddy、Windsurf、Claude Desktop 等支持 MCP 的客戶端裏，讓 Agent 能處理 doc.weixin.qq.com 鏈接——讀表格、追寫文檔、按單元格改表、對幻燈片/導圖等做只讀提取或截圖。
• 實現方式：Skill 內置 source/ 與 scripts/setup.sh，將服務安裝到 ~/wecom-doc-mcp，註冊名爲 wecom-doc 的 MCP Server（node 啓動 src/index.js）。

核心功能¶

以下能力均來自 Skill 自帶的 SKILL.md 與 references/tool_reference.md。

文檔類型¶

MCP 工具¶

運行環境要求（Skill 元數據）：Node.js 18+、首次掃碼需要桌面環境；支持 macOS 與 Linux；Playwright Chromium 由安裝腳本自動安裝。

安裝與啓用¶

1. 在 SkillHub 安裝 Skill¶

先按 SkillHub 安裝說明 準備 skillhub CLI（未安裝時可執行官方安裝腳本）。安裝技能時需用 --dir 指向當前 Agent 的 skills 目錄，例如 Cursor 爲 ~/.cursor/skills/：

skillhub install @user_5f5835e5/wecom-doc-skill --dir ~/.cursor/skills/

也可在 SkillHub 技能頁，將提示詞發給 AI：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_5f5835e5/wecom-doc-skill。」

安裝完成後，Agent 會加載 Skill 內的 SKILL.md 決策流程。

2. 安裝 MCP 服務（首次使用企微文檔能力）¶

Skill 要求 Agent 在用戶使用文檔功能前，檢測 ~/wecom-doc-mcp 是否已安裝：

test -f ~/wecom-doc-mcp/package.json && echo "已安裝" || echo "未安裝"

若未安裝，在 Skill 目錄下執行捆綁腳本（路徑以你本機 Skill 解壓位置爲準）：

bash scripts/setup.sh

腳本會：把內置 source/ 複製到 ~/wecom-doc-mcp → npm install → npx playwright install chromium → 探測本機 AI 工具並寫入 MCP 配置。默認安裝目錄可通過 bash setup.sh [install_dir] 覆蓋。

安裝成功後需重啓 AI 客戶端（完全退出再打開），否則 MCP 工具可能不可用。

3. MCP 配置（手動備用）¶

自動配置失敗時，可在對應工具的 MCP 配置中加入（args 請改爲本機 index.js 絕對路徑）：

"wecom-doc": {
    "command": "node",
    "args": ["/Users/yourname/wecom-doc-mcp/src/index.js"],
    "timeout": 180000
}

Skill 文檔給出的配置文件位置包括：

setup.sh 還會在未檢測到上述目錄時，默認寫入 CodeBuddy 的 mcp.json。

4. 登錄¶

重啓後再次發起企微文檔相關請求時，Agent 應先調 wecom_doc_status；未登錄則調 wecom_doc_login，在彈出瀏覽器中用企業微信掃碼。Cookie 有效期約數天，過期後按同樣流程重登。終端備用命令：

cd ~/wecom-doc-mcp && npm run login

典型用法¶

下列示例與官方工具參考一致，便於在對話中復現。

讀取整張表格

用戶給出 https://doc.weixin.qq.com/sheet/e3_xxx，Agent 調用 wecom_doc_fetch，url 爲完整鏈接；返回中的 sheetList 爲工作表列表，sheets 爲數據。

讀取指定工作表

先 wecom_doc_fetch 不帶 tab 拿到 sheetList 裏各表的 tab ID，再帶 tab 參數讀取「項目排期」等指定表。

文檔末尾追加段落

對 /doc/ 鏈接調用 wecom_doc_write，傳入 url 與 content（僅純文本，不支持富文本或中間插入）。

表格單元格寫入

wecom_doc_write_sheet(url=..., cell="A5", content="完成", mode="overwrite")

批量追加一行

先 wecom_doc_fetch 確認最後一行行號 N，再對 A{N+1}、B{N+1} … 逐格 wecom_doc_write_sheet，mode 用 overwrite；完成後可再次 fetch 校驗。

幻燈片截圖

對 /slide/ 等鏈接調用 wecom_doc_screenshot，可選 output_path。

當工具返回「未登錄或登錄已過期」時，應先 wecom_doc_login，登錄成功後重試原操作。

適用場景與注意¶

適合誰

• 日常在企微文檔、在線表格裏協作，希望 Cursor / CodeBuddy 等 Agent 直接讀表、寫單元格、追寫會議紀要的團隊。
• 願意在本機跑 Node + Playwright、並接受首次掃碼登錄的開發者。

限制與注意

• 依賴瀏覽器自動化，表格寫入是逐單元格操作，大批量寫入會較慢；type_delay / line_delay 可調輸入節奏。
• doc 寫入只能在末尾追加；slide / mindmap / flowchart 只讀。
• 文檔權限仍受企業微信側控制；頁面未加載完可能導致表格爲空，需重試或檢查權限。
• SkillHub 頁面提供維護者微信 tbj18234127547 用於問題私聊；Skill 內 MIT 許可源碼作者標註爲 baojiantang，上游倉庫見 Skill 元數據中的 git.woa.com/baojiantang/wecom-doc-mcp（安裝本 Skill 不強制訪問該倉庫）。

SkillHub 統計（以技能頁與抓取數據爲準）：評分 100000，下載約 21735 次，安裝 72 次。

結尾¶

企微文檔讀寫全能小助手把「安裝 MCP + 掃碼登錄 + 讀寫 doc.weixin.qq.com」收斂成一條 Skill 工作流：先裝 @user_5f5835e5/wecom-doc-skill，再跑 setup.sh，重啓客戶端後即可用自然語言丟鏈接讓 Agent 調 MCP 工具。

• SkillHub 技能頁：https://www.skillhub.cn/skills/user_5f5835e5/wecom-doc-skill
• API 座標頁：https://api.skillhub.cn/user_5f5835e5/wecom-doc-skill