前言¶

在 Agent 里处理「新建一篇会议纪要」「把本地 Excel 导入云盘」「按关键词搜公司知识库里的文档」时，如果只靠通用浏览器或手写 HTTP，往往要反复查 docs.qq.com 的接口与鉴权方式。下面介绍 SkillHub 上的 @user_70e389e9/wayne-is-bad：安装后是一套基于 SKILL.md 的腾讯文档（tencent-docs）操作指南，把文档类型选择、MCP 调用和授权流程写进技能包，便于 Cursor、Claude Code 等客户端按步骤执行。

这是什么¶

SkillHub 坐标为 @user_70e389e9/wayne-is-bad，分类 office-efficiency，来源为社区（community），发布者 user_70e389e9。页面当前展示名称为「这是一个更新后的名字」、简介为「这是一个更新后的描述」；下载安装得到的包内 SKILL.md 将技能标识为 tencent-docs，由 tencent-docs 维护，面向 docs.qq.com 在线云文档。标签 requires_api_key=true，实际使用需配置腾讯文档 Token（经 mcporter 写入 Authorization 头）。

它解决的是：在 Agent 会话中统一走「鉴权 → 选文档类型 → 调用 MCP 工具」的路径，而不是每次临时拼凑 API。

核心功能¶

以下能力来自安装包内 SKILL.md frontmatter 与正文，已与本地文件核对。

1. 创建多类在线文档：文档（smartcanvas）、Word、Excel、幻灯片、思维导图、流程图、智能表格（smartsheet）、收集表等；默认新建优先 smartcanvas（MDX/Markdown 兼容）。
2. 知识库空间：创建空间、查询空间列表；管理空间节点与文件夹结构（node_id 与 file_id 等价）。
3. 读取与搜索：get_content 读取内容；manage.search_file 等搜索后读取。
4. 编辑：智能表格 smartsheet.*；在线文档 smartcanvas.*；Sheet 用 sheet.*；Word 用 doc.*；PPT 精细编辑经独立 slide-mcp 服务。
5. 文件管理：重命名、移动、删除、复制、导入导出、权限等（manage.*）。
6. 剪藏与上云：scrape_url / scrape_progress 网页剪藏；本地文件经 import_file.sh 与 manage.async_import；本地 HTML 可经 aipage_pack.js 打包为 .aipage 后导入。
7. OCR：ocr.extract、ocr.toword、ocr.toexcel；本地图片配合 node ocr.js。

SkillHub 登记版本为 1.0.1；包内 SKILL.md frontmatter 版本为 1.0.35（以安装包为准做能力说明）。SkillHub 评分 100000，下载 728 次（抓取资料，2026-10-22）。

安装与启用¶

1. 安装 SkillHub CLI¶

若尚未安装，按官方安装说明执行：

command -v skillhub && skillhub --version

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须使用 --dir 指向客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。

Cursor 示例路径：

skillhub install wayne-is-bad --dir ~/.cursor/skills/

SkillHub 技能页关键词提示安装 wayne-is-bad。使用完整坐标 user_70e389e9/wayne-is-bad 直接下载时，接口可能返回 404；若遇此情况，可改用上述 slug 安装，或从技能页下载 1.0.1 版本 Zip 包解压到 skills 目录。

官方登记地址：

• API：https://api.skillhub.cn/user_70e389e9/wayne-is-bad
• 页面：https://www.skillhub.cn/skills/user_70e389e9/wayne-is-bad

3. 本地 MCP 与鉴权¶

技能依赖 Node.js 与 mcporter，并通过 setup.sh 完成腾讯文档授权。进入技能目录后，先做状态检查：

bash ./setup.sh tdoc_check_and_start_auth

若输出 READY，可直接调用工具；若输出 AUTH_REQUIRED:<url>，需在浏览器完成 QQ/微信授权，用户确认后再执行：

bash ./setup.sh tdoc_fetch_token

已有 Token 时，可参考 references/auth.md 写入配置：

mcporter config add tencent-docs "https://docs.qq.com/openapi/mcp" \
    --header "Authorization=$Token" \
    --transport http \
    --scope home

环境变量方面，OpenClaw 元数据标明主环境变量为 TENCENT_DOCS_TOKEN，Token 获取页：https://docs.qq.com/scenario/open-claw.html?nlc=1。

典型用法¶

安装并授权后，先确认 MCP 工具列表：

mcporter list tencent-docs
mcporter list slide-mcp

通用调用形式如下：

mcporter call "tencent-docs" "<工具名>" --args '<JSON参数>'
mcporter call "slide-mcp" "<工具名>" --args '<JSON参数>'

常见工作流（见 references/workflows.md）包括：

1. 搜索并阅读：manage.search_file → 取 file_id → get_content。
2. 网页剪藏：用户提供 URL 时优先 scrape_url，再 scrape_progress 轮询。
3. 本地文件上云：import_file.sh → manage.async_import → manage.import_progress。
4. 智能表格：先 smartsheet.list_tables 获取 sheet_id，再使用 smartsheet.*。

参数与 Schema 冲突时，以 mcporter list 返回为准。

适用场景与注意¶

适合：需要在 Agent 中自动化腾讯文档创建、协作空间整理、表格与文档读写、剪藏与导入的团队或个人；已接受腾讯文档账号授权与可能的 VIP/积分限制（错误码 400007、400008 等见 SKILL.md 问题定位表）。

注意：

• SkillHub 展示名称/简介可能与包内 tencent-docs 文档不一致，以 SKILL.md 与 references/ 为操作依据。
• 授权链接约 5 分钟有效；AUTH_REQUIRED 后须等待用户确认，勿自动轮询 Token。
• 异步任务（如 PPT 生成、网页剪藏）建议用子会话轮询，避免阻塞主会话。
• 每日可选用 check_skill_update 核对 SKILL 版本（见 SKILL.md「SKILL 更新」一节）。

结尾¶

@user_70e389e9/wayne-is-bad 在 SkillHub 上归类为办公效率技能；落地后实质是腾讯文档 MCP 的 Agent 操作手册，把 docs.qq.com 上的文档、空间与文件管理收敛到统一鉴权与工具调用流程。需要安装或查看登记信息时，可打开官方页面：https://www.skillhub.cn/skills/user_70e389e9/wayne-is-bad。