（10382期）腾讯文档Markdown – 一站式 Markdown 文档云端管理工具

一站式 Markdown 文档云端管理工具 腾讯文档 Markdown 技能，支持创建、写入、读取、下载、更新、删除、重命名等全生命周期管理，需微信/QQ 扫码认证。 使用说明 核心用法 腾讯文档 Markdown 技能是一套完整的自动化工具，用于通过程序化方式管理腾讯文档平台上的 Markdown 文档。主要功能包括： 文档创建与初始化：支持新建空白文档或带内容的文档，自动处理 doc_type=14 的 Markdown 类型标识 内容同步：支持双向同步——既可将本地 .md 文件上传至云端，也可将云端文档下载为本地文件 实时读写：通过 read/update API 实现文档内容的读取与覆盖更新 文档管理：提供重命名、删除（移至回收站）、获取元信息等管理操作 技术实现亮点： URL 标识符自动解析：系统通过访问文档页面从 basicClientVars 中提取真实的 padId，解决 URL 标识符与 API 所需 globalPadId 不匹配的问题 双模式登录：优先尝试微信快捷登录（无感体验），失败时降级为二维码扫码 Cookie 持久化：登录状态缓存于 .cookies.json，自动复用避免重复认证 显著优点 | 优势 | 说明 ||------|------|| 完整 CRUD | 覆盖文档全生命周期，非仅单一功能 || 无缝集成 | 同时提供 CLI 与 Python API，易于嵌入工作流 || 智能认证 | 支持快捷登录+扫码双通道，Cookie 自动管理 || 安全设计 | 破坏性操作强制确认、文件权限 0600、明确凭证风险提示 || 依赖锁定 | requirements.txt 版本固定，降低供应链风险 | 潜在缺点与局限性 平台绑定：仅支持腾讯文档 Markdown（doc_type=14），不支持其他腾讯文档类型（表格、幻灯片等）或其他云文档平台 认证门槛：必须使用微信或 QQ 账号，不支持企业微信/邮箱等独立认证体系；首次使用需人工扫码 浏览器依赖：基于 Playwright + Chromium 实现，需下载约 100MB+ 浏览器二进制文件，对资源受限环境不友好 隐私暴露风险：read/download 操作会将文档内容完全暴露给 agent 会话，不适合高敏感场景 破坏性操作不可逆：update 为覆盖写入（非追加/合并），delete 虽移至回收站但自动化场景下难以恢复 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 | 原始说明 腾讯文档 Markdown 技能，支持新建 Markdown 并写入内容、下载、删除、读取、更新、重命名等操作。