核心用法
腾讯文档 Markdown 技能提供完整的腾讯文档 Markdown 管理能力,支持 Agent 通过自然语言指令触发文档操作。主要功能包括:
1. 文档创建与写入:支持新建空白文档或直接写入 Markdown 内容
2. 本地同步:将在线文档下载为本地 .md 文件,或将本地文件上传同步
3. 内容管理:读取、更新、删除(移至回收站)、重命名文档
4. 智能登录:首次扫码登录后自动缓存 Cookie,支持微信快捷登录检测
技术实现上,该技能通过 Playwright 模拟浏览器行为,解析文档页面 HTML 提取真实 padId,再调用腾讯文档内部 API 完成操作。关键机制是将 URL 中的表面标识符解析为 globalPadId({domainId}${padId})格式用于 API 认证。
显著优点
- 完整生命周期管理:覆盖创建、编辑、同步、归档全流程
- 无缝本地集成:支持直接传入文件路径或 Markdown 文本
- 智能会话保持:Cookie 自动复用减少重复登录
- 微信生态原生:深度适配腾讯文档的认证体系
潜在缺点与局限性
- 依赖浏览器自动化:需安装 Chromium,启动开销较大
- API 非官方公开:基于内部接口逆向,存在失效风险
- 单账号限制:Cookie 绑定单个微信/QQ 账号,不支持多账号切换
- 权限边界模糊:删除操作仅移至回收站,彻底删除需手动到腾讯文档网页操作
适合人群
- 需要批量管理腾讯文档的开发者或内容运营人员
- 希望将本地 Markdown 工作流与腾讯文档同步的个人用户
- 构建自动化文档发布管道的 Agent 开发者
常规风险
- Cookie 泄露风险:
.cookies.json包含完整会话凭证,文件权限需严格限制 - 账号关联风险:扫码登录绑定个人微信/QQ,企业场景下需注意合规
- API 变更风险:非官方 API 可能随腾讯文档更新而失效
- 内容安全风险:更新操作直接覆盖原文,无版本回滚机制