腾讯文档Markdown

核心用法

腾讯文档Markdown技能是一套基于Node.js的自动化工具，通过封装腾讯文档官方API实现Markdown文档的全生命周期管理。核心功能包括：新建并写入内容、创建空文档、下载为本地.md文件、读取文档内容、更新覆盖内容、删除（移至回收站）、重命名及获取文档详情。

使用时需先扫码登录（微信/QQ），系统会自动缓存Cookies至.cookies.json后续复用。所有操作支持命令行和编程接口两种调用方式。

显著优点

• 完整CRUD能力：覆盖文档创建、读取、更新、删除全流程
• 智能ID解析：自动从URL提取真实padId，用户无需关注底层标识符转换
• 双模式登录：支持扫码登录和微信快捷登录自动检测
• 本地文件同步：支持直接上传本地.md文件或下载到本地
• MIT开源：可自由修改和二次开发

潜在缺点与局限性

• 依赖Cookie持久化：登录状态依赖本地文件存储，跨设备需重新登录
• 腾讯生态绑定：仅限腾讯文档Markdown类型（doc_type=14），不支持其他文档格式
• 无实时协作API：仅支持内容读写，不涉及协作权限管理
• 回收站机制：删除非永久删除，需手动清空回收站

适合人群

• 需要将本地Markdown笔记批量同步到云端的开发者/写作者
• 构建文档自动化工作流的技术团队
• 使用腾讯文档作为知识库底座的企业用户

常规风险

• Cookie泄露风险：.cookies.json包含登录凭据，需确保文件权限和.gitignore配置
• 会话过期：长期未使用需重新扫码登录
• API稳定性：依赖腾讯文档非公开API，存在接口变更风险

核心用法

该技能提供腾讯文档 Markdown 的完整操作能力，涵盖新建、读取、更新、删除、下载、重命名六大核心功能。支持两种交互模式：

1. 命令行工具：通过 node src/index.js 直接操作，适合脚本集成与自动化工作流
2. 编程接口：导出 handleCreateAndWrite、handleRead、handleUpdate 等函数，便于嵌入 Node.js 应用

典型工作流：

• 首次使用执行 login 命令，微信/QQ 扫码后 Cookie 自动缓存至 .cookies.json
• 后续操作自动复用会话，无需重复登录
• URL 标识符自动解析：用户传入 https://docs.qq.com/markdown/DSxxx 后，系统自动提取真实 padId 完成 API 调用

显著优点

| 维度 | 优势 |

|------|------|

| **功能完整** | 覆盖 Markdown 文档全生命周期，支持批量下载、内容同步等自动化场景 |

| **认证友好** | 扫码登录 + Cookie 持久化，避免频繁授权；支持微信快捷登录自动检测 |

| **开发体验** | CLI 与 SDK 双模式，TypeScript 友好，返回结构化数据（docUrl、padId 等） |

| **安全设计** | Cookie 域白名单（仅 `.qq.com`、`docs.qq.com`）、HTTPS 全链路加密 |

潜在局限

• 浏览器依赖：登录环节依赖 Puppeteer + Chromium，增加 ~150MB 磁盘占用与启动开销
• 平台绑定：仅支持腾讯文档生态，无法迁移至 Notion、语雀等其他平台
• 会话有效期：Cookie 可能过期，需手动重新登录（工具已内置自动重登流程）
• 沙箱降级：容器环境强制 --no-sandbox，浏览器隔离安全性有所降低

适合人群

• 内容运营团队：需批量将本地 Markdown 同步至腾讯文档进行协作
• 开发者/DevOps：构建文档自动化流水线（如 CI 生成 Changelog 自动上传）
• 个人知识管理用户：偏好本地 Markdown 编辑，但需云端备份与分享

常规风险

| 风险项 | 说明 | 缓解措施 |

|--------|------|----------|

| Cookie 本地存储 | `.cookies.json` 明文存储会话凭证 | 已加入 `.gitignore`；建议配合文件系统权限控制（chmod 600） |

| Puppeteer 供应链 | Chromium 下载源可能被污染 | 锁定 Puppeteer 版本，企业内网可配置镜像源 |

| 权限范围 | 获得完整腾讯文档读写权限 | 遵循最小权限原则，不共享登录后的运行环境 |

安全认证评级 A 级（78 分），无高危漏洞，符合生产环境使用标准。