腾讯文档 Markdown 技能，支持创建、写入、读取、下载、更新、删除、重命名等全生命周期管理，需微信/QQ 扫码认证。
说明：
## 核心用法
腾讯文档 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` 版本固定，降低供应链风险 |
## 潜在缺点与局限性
1. **平台绑定**：仅支持腾讯文档 Markdown（`doc_type=14`），不支持其他腾讯文档类型（表格、幻灯片等）或其他云文档平台
2. **认证门槛**：必须使用微信或 QQ 账号，不支持企业微信/邮箱等独立认证体系；首次使用需人工扫码
3. **浏览器依赖**：基于 Playwright + Chromium 实现，需下载约 100MB+ 浏览器二进制文件，对资源受限环境不友好
4. **隐私暴露风险**：`read`/`download` 操作会将文档内容完全暴露给 agent 会话，不适合高敏感场景
5. **破坏性操作不可逆**：`update` 为覆盖写入（非追加/合并），`delete` 虽移至回收站但自动化场景下难以恢复
6. **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 |
会员专属
