一站式 Markdown 文档云端管理工具 - 腾讯文档Markdown

腾讯文档 Markdown 技能，支持创建、写入、读取、下载、更新、删除、重命名等全生命周期管理，需微信/QQ 扫码认证。

基本信息

• 技能名称?腾讯文档Markdown
• 中文名称?一站式 Markdown 文档云端管理工具
• 作者?wscats
• 分类?专业技能
• 版本?1.1.7
• 标签?tencent-docs, markdown, document-management, cloud-sync, automation, playwright, wechat-login, cookie-auth

使用方法

使用说明
核心用法
腾讯文档 Markdown 技能是一套完整的自动化工具，用于通过程序化方式管理腾讯文档平台上的 Markdown 文档。主要功能包括：

1. 文档创建与初始化 ：支持新建空白文档或带内容的文档，自动处理 doc_type=14 的 Markdown 类型标识
2. 内容同步 ：支持双向同步——既可将本地 .md 文件上传至云端，也可将云端文档下载为本地文件
3. 实时读写 ：通过 read / update API 实现文档内容的读取与覆盖更新
4. 文档管理 ：提供重命名、删除（移至回收站）、获取元信息等管理操作
   技术实现亮点 ：
   URL 标识符自动解析：系统通过访问文档页面从 basicClientVars 中提取真实的 padId ，解决 URL 标识符与 API 所需 globalPadId 不匹配的问题
   双模式登录：优先尝试微信快捷登录（无感体验），失败时降级为二维码扫码
   Cookie 持久化：登录状态缓存于 .cookies.json ，自动复用避免重复认证
   显著优点
   | 优势 | 说明 | |------|------| | 完整 CRUD | 覆盖文档全生命周期，非仅单一功能 | | 无缝集成 | 同时提供 CLI 与 Python API，易于嵌入工作流 | | 智能认证 | 支持快捷登录+扫码双通道，Cookie 自动管理 | | 安全设计 | 破坏性操作强制确认、文件权限 0600、明确凭证风险提示 | | 依赖锁定 | requirements.txt 版本固定，降低供应链风险 | 潜在缺点与局限性
5. 平台绑定 ：仅支持腾讯文档 Markdown（ doc_type=14 ），不支持其他腾讯文档类型（表格、幻灯片等）或其他云文档平台
6. 认证门槛 ：必须使用微信或 QQ 账号，不支持企业微信/邮箱等独立认证体系；首次使用需人工扫码
7. 浏览器依赖 ：基于 Playwright + Chromium 实现，需下载约 100MB+ 浏览器二进制文件，对资源受限环境不友好
8. 隐私暴露风险 ： read / download 操作会将文档内容完全暴露给 agent 会话，不适合高敏感场景
9. 破坏性操作不可逆 ： update 为覆盖写入（非追加/合并）， delete 虽移至回收站但自动化场景下难以恢复
10. Python 版本限制 ：仅支持 >= 3.10，老旧系统兼容性受限
    适合人群
    开发者/技术写作者 ：需要将本地 Markdown 写作流与腾讯文档协作流桥接的用户
    自动化运维人员 ：构建文档同步流水线（如 CI/CD 生成文档自动上传）
    内容运营团队 ：批量管理文档、自动化内容分发场景
    个人知识管理用户 ：偏好本地编辑器（Obsidian/Vim/VS Code）但需腾讯文档分享能力的用户
    常规风险
    | 风险类别 | 具体风险 | 缓解措施 | |----------|----------|----------| | 凭证泄露 | .cookies.json 包含会话 Cookie，等同账户凭证 | 文件自动 0600 权限、明确提示勿提交 Git、提供 logout 清除命令 | | 误操作数据丢失 | update 覆盖写入、delete 删除文档 | 强制交互确认（y/N）或显式 confirm=True 参数、操作前展示文档标题与 URL | | 隐私泄露 | read/download 暴露文档内容至 agent/终端 | 文档中明确警示避免用于高敏感文档 | | 供应链攻击 | 依赖包被篡改 | 版本锁定、建议审查依赖更新 | | 会话劫持 | Cookie 被盗用可导致账户接管 | 推荐使用专用自动化账号（非个人主账号）、定期重新登录轮换 Cookie |