據 AlphaMoat 統計,截至 2026-10,騰訊文件Markdown 累計下載 12,533 次、獲 9 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 2,209 位,在「辦公效率」分類(909 個)中排名第 255 位。
列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。
| 平台 | 累計下載 | 星標 | 評論 |
|---|---|---|---|
| ClawHub ↗ | 5807 | 9 | - |
| SkillHub ↗ | 1.3萬 | 9 | — |
各平台的計數口徑不同,統計時間不一致。
支援建立、讀取、下載、更新、重新命名和移入回收站。需登入並保護本地 Cookie;更新、刪除和重新命名前展示目標並確認,程式呼叫需 confirm=True。 工作階段 Cookie 具有帳號權限。更新、刪除與重新命名會修改文件,操作前核對目標與內容。CLI 的 --yes 可略過互動確認,未獲明確授權不要使用;不再需要時保護並清除 .cookies.json。
資料釋出於 2026-10-27
以下是根據技能文件生成的示例,不代表實際執行結果。
2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。
| 月份 | 累計下載 | 環比 | 星標 |
|---|---|---|---|
| 2026-10 | 1.3萬 | — | 9 |
| 2026-09 | 7036 | — | 9 |
| 2026-08 | 6068 | +6.3% | 9 |
| 2026-07 | 5706 | +6.8% | 9 |
| 2026-06 | 5343 | +5.5% | 9 |
| 2026-05 | 5066 | — | 9 |
| 2026-03 | 3927 | — | 3 |
以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。
--- name: 腾讯文档Markdown license: MIT description: 腾讯文档 Markdown 技能,支持新建 Markdown 并写入内容、下载、删除、读取、更新、重命名等操作。 --- # 腾讯文档 Markdown 技能 > **名称:** `tencent-docs-markdown` > **许可证:** MIT
> **简介:** 腾讯文档 Markdown 技能,支持新建 Markdown 并写入内容、下载、删除、读取、更新、重命名等操作。
---
## Agent 如何使用此技能
### 触发短语
当用户表达以下意图时,Agent 应激活此技能:
| 意图 | 示例短语 |
|------|----------|
| **新建并写入** | "新建一个Markdown到腾讯文档并写入内容[xxx]" / "帮我新建腾讯文档md,写入以下内容" / "上传xxx.md到腾讯文档" / "上传xxx.md文档" / "同步xxx.md文档" / "提交xxx.md文档" / "把本地文件同步到腾讯文档" |
| **新建空文档** | "帮我创建名为xxx.md" / "新建一个Markdown文档" |
| **下载** | "把https://docs.qq.com/markdown/[xxx]文档保存到本地" |
| **读取** | "读取https://docs.qq.com/markdown/[xxx]文档内容"|
| **更新** | "更新[xxx]到https://docs.qq.com/markdown/[xxx]" |
| **删除** | "删除https://docs.qq.com/markdown/[xxx]"|
| **重命名** | "重命名https://docs.qq.com/markdown/[xxx]文档为xxx" |
| **查看信息** | "获取https://docs.qq.com/markdown/[xxx]文档的详情" |
| **登录** | "登录腾讯文档" / "重新登录" / "Cookie过期了" |
### Agent 工作流程
```mermaid
flowchart TD
A[用户请求] --> B{Cookies 有效?}
B -->|是| C[执行操作]
B -->|否| D[通过扫码登录]
D --> E[保存 Cookies]
E --> C
C --> F[返回结果 + 文档链接]
```
---
## 快速开始
```bash
# 1. 安装依赖
pip install -r requirements.txt
playwright install chromium
# 2. 登录(使用微信/QQ 扫描二维码)
python -m src.main login
# 3. 新建文档并写入内容
python -m src.main write "我的文档" "# Hello World"
```
---
## 功能操作
### 1. 新建并写入文档
新建一个腾讯文档 Markdown,写入内容后返回文档链接。
**命令行:**
```bash
python -m src.main write "我的文档" "# Hello World\n这是我的文档内容。"
```
**编程接口:**
```python
from src.main import handle_create_and_write
result = handle_create_and_write('我的文档', '# Hello World\n这是内容。')
# result: {'docUrl': ..., 'padId': ..., 'globalPadId': ..., 'title': ...}
# → 将 result['docUrl'] 分享给用户
```
### 2. 新建空文档
创建一个新的空 Markdown 文档。
**命令行:**
```bash
python -m src.main create "我的新文档"
```
**编程接口:**
```python
from src.main import handle_create
result = handle_create('我的文档')
# result: {'docUrl': ..., 'padId': ..., 'globalPadId': ..., 'title': ...}
```
### 3. 下载文档
将腾讯文档 Markdown 下载为本地 `.md` 文件。
> **注意:** 系统会自动从文档页面解析真实的 `padId`(URL 中的标识符与 API 所需的真实 padId 不同)。
**命令行:**
```bash
python -m src.main download https://docs.qq.com/markdown/DQxxxxxxxx
python -m src.main download https://docs.qq.com/markdown/DQxxxxxxxx -o ./output.md
```
**编程接口:**
```python
from src.main import handle_download
result = handle_download('https://docs.qq.com/markdown/DQxxxxxxxx', './output.md')
# result: {'path': ..., 'content': ...}
```
### 4. 读取文档
读取并返回文档内容。
**命令行:**
```bash
python -m src.main read https://docs.qq.com/markdown/DQxxxxxxxx
```
**编程接口:**
```python
from src.main import handle_read
content = handle_read('https://docs.qq.com/markdown/DQxxxxxxxx')
```
### 5. 更新文档
覆盖已有文档的内容(支持直接传入文本或 `.md` 文件路径)。
> **⚠️ 安全提示:** 这是**破坏性操作**。交互模式下会显示目标文档标题与 URL 并要求确认 (`y/N`)。程序化调用须显式传入 `confirm=True`,否则操作会被拒绝。CLI 也可加 `-y/--yes` 跳过提示。
**命令行:**
```bash
python -m src.main update https://docs.qq.com/markdown/DQxxxxxxxx "# 新内容"
python -m src.main update https://docs.qq.com/markdown/DQxxxxxxxx ./updated.md
python -m src.main update https://docs.qq.com/markdown/DQxxxxxxxx ./updated.md -y # 跳过确认
```
**编程接口:**
```python
from src.main import handle_update
handle_update('https://docs.qq.com/markdown/DQxxxxxxxx', '# 更新后的内容', confirm=True)
```
### 6. 删除文档
将文档移入回收站。
> **⚠️ 安全提示:** 交互模式下会展示目标文档标题与 URL 并要求确认 (`y/N`)。程序化调用须显式传入 `confirm=True`,否则操作会被拒绝。CLI 也可加 `-y/--yes` 跳过提示。
**命令行:**
```bash
python -m src.main delete https://docs.qq.com/markdown/DQxxxxxxxx
python -m src.main delete https://docs.qq.com/markdown/DQxxxxxxxx -y # 跳过确认
```
**编程接口:**
```python
from src.main import handle_delete
result = handle_delete('https://docs.qq.com/markdown/DQxxxxxxxx', confirm=True)
# result: {'padId': ..., 'title': ..., 'deleted': True}
```
### 7. 重命名文档
> **⚠️ 安全提示:** 交互模式下会展示原标题、新标题与 URL 并要求确认 (`y/N`)。程序化调用须显式传入 `confirm=True`。
**命令行:**
```bash
python -m src.main rename https://docs.qq.com/markdown/DQxxxxxxxx "新标题"
python -m src.main rename https://docs.qq.com/markdown/DQxxxxxxxx "新标题" -y # 跳过确认
```
**编程接口:**
```python
from src.main import handle_rename
handle_rename('https://docs.qq.com/markdown/DQxxxxxxxx', '新标题', confirm=True)
```
### 8. 获取文档信息
**命令行:**
```bash
python -m src.main info https://docs.qq.com/markdown/DQxxxxxxxx
```
**编程接口:**
```python
from src.main import handle_info
info = handle_info('https://docs.qq.com/markdown/DQxxxxxxxx')
```
### 9. 登录
**命令行:**
```bash
python -m src.main login # 使用缓存的 Cookies(如有效)
python -m src.main login --force # 强制重新登录
```
### 10. 登出 / 清除 Cookies
删除本地 `.cookies.json` 凭证文件,在不再需要该会话时使用。
**命令行:**
```bash
python -m src.main logout
```
**编程接口:**
```python
from src.auth import clear_cookies
clear_cookies()
```
---
## 认证机制
首次使用需扫码登录,之后 Cookie 会缓存在 `.cookies.json` 中自动复用。
> **🔐 凭证管理:** `.cookies.json` 被明确声明为 **账户级凭证**。保存时会自动应用 POSIX `0600` 权限(仅当前用户可读写),并在终端提示用户其敏感性。**切勿**将此文件提交到版本控制或共享给他人;不再使用时请运行 `python -m src.main logout` 或手动删除。推荐使用专用的自动化账号,而非个人主账号。
支持两种登录方式:
1. **扫码登录** — 使用微信/QQ 扫描二维码
2. **微信快捷登录** — 如果之前在当前浏览器已有微信登录记录,系统会自动检测并点击"微信快捷登录"按钮,页面显示"登录中..."后自动完成登录
```mermaid
flowchart TD
A[开始] --> B{.cookies.json 存在?}
B -->|是| C{Cookies 有效?}
B -->|否| D[启动浏览器]
C -->|是| E[就绪]
C -->|否| D
D --> F{微信快捷登录可用?}
F -->|是| G[点击'微信快捷登录'按钮]
G --> H[页面显示'登录中...']
H --> I[每10秒轮询检测页面变化]
F -->|否| J[展示二维码供扫描]
J --> I
I --> K{检测到登录成功?}
K -->|是| L[获取并验证 Cookies]
K -->|否 / 超时| I
L --> M[保存 Cookies 到 .cookies.json]
M --> E
```
---
## API 参考
| 接口 | 方法 | 路径 | 关键参数 |
|------|------|------|----------|
| 创建文档 | GET | `/cgi-bin/online_docs/createdoc_new` | `doc_type=14`, `create_type=1`, `folder_id=/`, `title`, `xsrf` |
| 删除文档 | POST | `/cgi-bin/online_docs/doc_delete` | `pad_id`, `domain_id`, `xsrf` |
| 读取内容 | POST | `/api/markdown/read/data` | `file_id`(globalPadId) |
| 写入内容 | POST | `/api/markdown/write/data` | `file_id`, `mark_down` |
| 文档信息 | POST | `/cgi-bin/online_docs/doc_info` | `file_id` |
| 重命名 | POST | `/cgi-bin/online_docs/doc_changetitle` | `pad_id`, `title`, `xsrf` |
| 解析真实 padId | GET | 文档页面 HTML | 从 `basicClientVars` 中提取 `padId` |
---
## 项目结构
```
tencent-docs-markdown/
├── requirements.txt # Python 依赖
├── SKILL.md # 技能定义文件(本文件)
├── publish.sh # 版本发布脚本
├── .cookies.json # 保存的登录 Cookies(自动生成,已加入 .gitignore)
└── src/
├── __init__.py # Python 包初始化
├── main.py # 主入口 & CLI 命令
├── auth.py # 扫码登录 & Cookie 管理
├── api.py # 腾讯文档 Markdown API 客户端
└── login_with_polling.py # 轮询登录脚本
```
---
## 核心概念
### URL 标识符与真实 padId
腾讯文档 Markdown 的 URL 格式为 `https://docs.qq.com/markdown/DSxxxxxxxx`,其中 `DSxxxxxxxx` 是 **URL 标识符**,并非 API 所需的真实 `padId`。
系统通过 `resolve_real_pad_id()` 函数访问文档页面,从嵌入的 `basicClientVars` JSON 中提取真实的 `padId`,然后拼接为 `globalPadId`(格式:`{domainId}${padId}`)用于 API 调用。
此机制对 **下载(download)**、**读取(read)**、**更新(update)** 操作自动生效,用户无需关注。
---
## 错误处理
| 错误 | 原因 | 解决方案 |
|------|------|----------|
| Cookie 过期 | 会话超时 | 自动通过扫码重新登录 |
| `retcode !== 0` | API 返回错误 | 显示详细错误信息 |
| 无效 URL | 腾讯文档 URL 格式不正确 | 确保格式为:`https://docs.qq.com/markdown/xxxxx` |
| 资源不存在 | URL 标识符无法解析为真实 padId | 检查文档是否存在或是否有访问权限 |
---
## 备注
- Markdown 文档类型编号为 `14`(`doc_type=14`)
- 默认 `domain_id` 为 `300000000`
- XSRF Token 从 `TOK` Cookie 中提取
- Cookies 存储在 `.cookies.json` 中(已加入 .gitignore),保存时自动设置 `0600` 权限
- **安全提示:** `.cookies.json` 包含敏感的会话 Cookie,其作用等同于账户凭证。请勿提交到版本控制或分享给他人;文件自动设置 `0600` 权限,如需手动重置:`chmod 600 .cookies.json`。不再使用时请运行 `python -m src.main logout` 清除。
- **破坏性操作保护:** `update` / `delete` / `rename` 均为不可撤销或影响用户文档的操作;它们在执行前会解析并展示目标文档的标题与 URL,交互模式下要求 `y/N` 确认;程序化调用必须显式传入 `confirm=True`,否则操作会被拒绝。
- **隐私提示:** `download` / `read` 会将文档内容暴露给当前 agent 会话、终端输出或本地文件;请避免对高敏感文档使用这些操作。
- **依赖版本锁定:** `requirements.txt` 中所有运行时依赖都被锁定到确定版本以减少供应链风险;请在可信任的环境中安装并审查任何依赖更新。
- 删除操作会将文档移至回收站(可恢复)
- 下载/读取/更新操作会自动解析 URL 中的标识符为真实 padId
- 建议在受控或受信环境中运行此工具,因为 Playwright 会下载 Chromium 并使用浏览器自动化权限
- **Python 版本要求:** Python >= 3.10
---
## 所需配置
| 配置项 | 路径 | 说明 |
|--------|------|------|
| Cookie 存储(凭证) | `.cookies.json`(项目根目录,自动生成) | 存储腾讯文档会话 Cookie 的**账户级凭证文件**。首次登录后自动创建,保存时自动应用 `0600` 权限。**此文件包含敏感信息,请勿泄露;不再使用时请运行 `python -m src.main logout` 或手动删除。**透過 MCP 在騰訊文件裡新建、編輯與管理線上文件的完整操作手冊。
WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v5.1新增:kingdoc雲端橋接(白名單探測+配置預檢+subprocess上傳+差異檢查)、條件格式/資料驗證跨引擎IO(JSON中間格式保真往返)、會議紀要三段式要素化(待辦清單+決策記錄+風險異議)+說話人標註(MFCC聚類);v5.2新增:公文一鍵排版(GB/T 9704 規則庫約束+結構識別套版+紅頭預留位+聯合行文)、批次水印與敏感資訊打碼(身份證/手機號/銀行卡/電子郵件雙軌識別+黑色矩形覆蓋+打碼清單)、跨文件知識檢索與問答(本地TF-IDF零依賴+跳轉+可選zwjh記憶橋接);刪除:與contract-review重複的輕量合同審查模組,改為文件互鏈引導;v5.2.5修復:MS Office引擎下Excel/PPT建立必然失敗(錯用Word COM物件),新增get_ms_excel/get_ms_ppt及三槽位統一釋放release_ms,MS Office路徑透傳filepath引數;v5.3.5修復:SKILL.md frontmatter 修復 tags 塊序列誤混入聯絡方式行導致標準 YAML 解析失敗;v5.4.0新增:留存型功能——定時任務與報告中心(schedule_register 升級為三平台統一排程層 schtasks/cron/launchd,錯過策略 skip/run_once,登錄檔 JSON 可匯出匯入;新建 report_center.py 報告中心,templates/reports/*.json 引數化模板 + ECharts 單檔案 HTML 輸出(圖表內聯、無服務端、雙擊即開);report_generator 升級支援 --format html;wps.py CLI 統一埋點 SQLite,自動供 report_center 生成周度使用摘要附在報告末尾;watch.py 職責收窄為純事件採集);v5.3.0新增:統一CLI入口 wps(registry.json登錄檔分發,office --app/--action 與 convert 子命令、--list 一屏列出全部命令,薄路由層不改指令碼內部邏輯)、全命令 --json 機器可讀輸出(固定 ok/error_id/elapsed/data 四欄位,對齊 E001-E015,wps_error.py 新增 emit_json 統一齣口)、_worker 啟動最佳化(wps_pure 改惰性載入,pywin32/python-docx/openpyxl 經核查已惰性匯入,ENGINE_CACHE 程序級單例複用,COM 釋放統一走 release_ms 三槽位)、轉換三入口合併為 convert(format_converter/md_converter/wps_docx_to_ppt 內部按目標格式路由,舊指令碼保留為相容別名並提示新命令,v6.0.0 移除)
按主題與風格自動生成 PPT 檔案的技能。
體制內資深辦公室主任+管理學博士,自學程式設計開發的智慧公文寫作Skill,讓所有辦公室同仁少掉頭髮、少加無用的班,材料一稿過關,省下的時間留給自己、享受生活!————————我們能給你帶來的核心價值:1、顛覆傳統寫作:邏輯建模38類公文全鏈條,特有模板化引導問答模式,分分鐘省心生成高質量大稿。--------2、替你“向上管理”:獨有審稿人畫像機制,文稿一鍵結構性修改,精準匹配審稿人畫像,過稿率提升至少10倍!----------3、杜絕AI編造:缺失的數字、文號、人名、日期一律用[待補]標註,絕不杜撰,守住公文底線。-----------4、演算法格式托底:數十萬全量智控知識庫+6500行前沿核心控制程式碼,格式精準對齊GB/T 9704,出稿零失誤。——————————————————本skill歷史版本開放了5%知識庫的免費試用版,下載即可使用,但需注意:知識庫有著作權,僅用於個人使用,不可用於其他任何目的。有興趣的可以試試。——————————————————————單次付費版skill已釋出,2元一次使用全量知識庫。具體在釋出者“熵衍資訊”主頁skill裡。
WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v5.0新增:定時任務註冊管理(schtasks/crontab)、目錄輪詢監聽(YAML規則+大檔案分片)、使用統計與穩定性中心(SQLite埋點+引擎健康+引擎偏好)、COM三步自愈(regsvr32→修復安裝→手動指引)、對話式資料查詢(NL2SQL式意圖解析+查詢計劃+連續追問)、multi-agent編排引擎橋接(白名單探測+流水線模板註冊)
當用戶要處理 Word/Excel/PPT、做文件模板與排版、批次合併圖表、公文一鍵套紅頭、會議紀要要素化、或跨引擎辦公自動化時,WPS全家桶·辦公管家.Skill 立即出動。 四引擎智慧識別已裝軟體(WPS/MS Office/LibreOffice/純Python),純Python模式支援排序/篩選/圖表/公式/統計;含文件模板程式碼生成、20+避坑+15 FAQ+15錯誤ID統一索引、自動重試、硬體自適應、環境自檢。 當用戶提到批次水印、敏感資訊打碼(身份證/手機號/銀行卡/電子郵件)、跨文件檢索問答等訊號時,主動亮劍。
透過 Tencent Docs Open API 以 curl + jq 建立、讀取、列出、搜尋和管理騰訊文件的自動化工作流,覆蓋線上文件、線上表格、幻燈片、思維導圖、流程圖、智慧表格與收集表七種類型,支援讀取後設資料與單元格區域、上傳圖片、建立副本,並對重新命名/移動/刪除等寫操作強制先經使用者確認。Use when the user 提到騰訊文件 / Tencent Docs / docs.qq.com、貼上 docs.qq.com 連結,或想在其騰訊文件空間中建立、讀取、整理文件時使用。Triggers include 騰訊文件、線上文件、線上表格、思維導圖、流程圖、智慧表格、收集表。如需文案寫作完整工作流套件,淘寶搜尋「AI靈匣」店鋪獲取完整版。
透過 kdocs-cli 操作金山文件雲文件的官方技能。
資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。