腾讯文档 Markdown

问题背景

很多团队把笔记和协作文档放在腾讯文档里，但 Markdown 类型文档（doc_type=14）往往只能通过网页编辑。若你希望 Agent 把本地 .md 同步上去、按 URL 拉取内容做 diff，或在自动化脚本里批量更新，就需要一套能走官方接口、又处理好登录与文档 ID 的集成层。

技能如何工作

本技能封装腾讯文档 Markdown 的常见操作：新建并写入、新建空文档、下载、读取、更新、重命名、删除以及获取文档详情。用户可用自然语言触发（例如「上传 xxx.md 到腾讯文档」「读取某 docs.qq.com/markdown 链接」），Agent 再调用对应的 CLI 或编程接口。

一个容易踩坑的细节是 URL 里的标识符（如 https://docs.qq.com/markdown/DSxxxxxxxx）不是 API 用的真实 padId。技能通过访问文档页、从嵌入的 basicClientVars 解析真实 padId，再拼成 globalPadId（{domainId}${padId}），在下载、读取、更新时自动完成，调用方只需传分享链接。

认证方面，首次需微信/QQ 扫码登录（也支持检测浏览器侧的微信快捷登录）；会话写入项目根目录的 .cookies.json，并自动设为 0600 权限。XSRF 从 TOK Cookie 提取，过期时可重新登录。

边界与注意点

• 破坏性操作：update、delete、rename 在交互模式会展示标题与 URL 并要求 y/N；程序化调用必须显式 confirm=True，CLI 可用 -y/--yes。
• 凭证与隐私：.cookies.json 等同账户凭证，勿提交版本库或共享；read/download 会把正文进入 Agent 会话或本地文件。
• 删除为移入回收站（可恢复），非永久抹除。
• 运行环境涉及 Playwright 与 Chromium 自动化，建议在受信环境使用；Python >= 3.10。