腾讯文档Markdown

核心功能

腾讯文档Markdown技能是一套完整的云端文档管理工具，通过调用腾讯文档官方API实现Markdown文档的自动化操作。核心能力覆盖创建、写入、读取、更新、下载、删除、重命名七大场景，特别适合需要将本地Markdown工作流与腾讯文档云端协作结合的用户。

显著优点

官方API背书：基于腾讯文档未公开的内部API（docs.qq.com域），接口稳定性与数据安全性由腾讯基础设施保障，非第三方爬虫方案。

智能登录机制：首创双模式登录——首次扫码后Cookie持久化缓存，有效期内自动复用；同时支持"微信快捷登录"自动检测，减少人工干预。

URL透明解析：自动处理腾讯文档URL标识符与真实padId的映射关系，用户无需理解DSxxxxxx与globalPadId的技术差异。

双向同步能力：既支持"本地→云端"的上传覆盖，也支持"云端→本地"的下载导出，形成完整的DevOps文档工作流闭环。

潜在局限

• 非官方公开API：依赖内部端点（如/api/markdown/read/data），存在腾讯调整接口导致功能失效的风险
• Cookie安全风险：登录凭证以明文JSON形式存储于.cookies.json，多用户环境需注意文件权限
• 企业级功能缺失：不支持权限管理、版本历史、协作编辑等高级功能
• 平台绑定：仅支持微信/QQ扫码登录，无企业微信或独立账号体系

适合人群

• 技术博主/开发者：需要快速发布本地Markdown到腾讯文档
• 小团队协作：将腾讯文档作为轻量级知识库中枢
• 自动化工作流：结合CI/CD实现文档自动生成与发布

常规风险

| 风险类型 | 等级 | 说明 |

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

| API失效 | 中 | 内部接口变更可能导致功能中断 |

| 数据泄露 | 低 | Cookie文件需设置600权限，避免多用户读取 |

| 账号风控 | 低 | 高频API调用可能触发腾讯安全策略 |

核心用法

腾讯文档 Markdown 技能提供完整的 Markdown 文档生命周期管理能力，支持通过命令行或编程接口与腾讯文档平台交互。核心功能包括：

• 文档创建：新建空文档或带内容的文档
• 内容操作：读取、更新、覆盖文档内容，支持直接传入 Markdown 文本或本地文件路径
• 文档管理：下载为本地 .md 文件、重命名、删除（移入回收站）、查看文档元数据
• 认证管理：微信/QQ 扫码登录，Cookie 自动缓存与复用

关键技术特性：自动解析 URL 标识符为真实 padId（通过页面嵌入的 basicClientVars 提取），支持微信快捷登录自动检测，所有 API 调用限定于 docs.qq.com 官方域名。

显著优点

1. 功能完整：覆盖 Markdown 文档的 CRUD 全生命周期，满足自动化文档管理需求
2. 体验友好：支持微信快捷登录自动检测，减少用户操作步骤
3. 设计规范：代码结构清晰，Cookie 管理包含域名白名单验证，防止凭证误发
4. 开源透明：MIT 许可证，源码可审计

潜在局限

1. Cookie 明文存储：登录凭证以 JSON 明文保存于 .cookies.json，虽加入 .gitignore 但未加密，共享环境存在泄露风险
2. T3 来源可信度：个人开发者维护项目，无知名组织背书，生产环境建议额外审查
3. Puppeteer 依赖：需下载 Chromium（约 100MB+），增加安装体积和潜在攻击面
4. 路径验证不足：文件下载/更新操作的路径解析未完全防范遍历攻击
5. 平台绑定：仅支持腾讯文档，无法迁移至其他 Markdown 平台

适合人群

• 需要批量自动化管理腾讯文档的开发者
• 希望将本地 Markdown 工作流与云端同步的技术写作者
• 构建文档自动化工具链的 DevOps 工程师
• 对安全要求不极端敏感的个人或小型团队

常规风险

| 风险类型 | 说明 | 缓解建议 |

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

| 凭证泄露 | Cookie 明文存储可能被其他进程读取 | 单用户环境运行，避免多用户共享 |

| 会话劫持 | Cookie 有效期未明确说明 | 异常时执行 `login --force` 重置 |

| 供应链攻击 | Puppeteer 依赖体积大，更新频繁 | 锁定版本，定期审计依赖 |

| 误操作风险 | 更新操作直接覆盖，无版本历史 | 重要文档先执行 `download` 备份 |

| 隐私合规 | 文档内容上传至腾讯云服务 | 遵守企业数据出境与云存储政策 |