写完文章，自动生成腾讯文档

第一步：注册开放平台，获取 Client ID 和 Client Secret

就像微信公众号需要 AppID 和 AppSecret 一样，腾讯文档也需要一对密钥来调用 API。

1.1 注册开发者

https://docs.qq.com/open/developers/

第二步：配置 Python 环境

复制下面这段话发给 WorkBuddy，它会帮你一键搭好所有环境：

帮我配置腾讯文档自动生成环境：

Client ID：在这里填你的Client ID
Client Secret：在这里填你的Client Secret
回调地址：http://localhost:8080/callback

请帮我：
1. 创建 Python 虚拟环境并安装依赖（requests、flask、python-dotenv）
2. 创建配置文件 .env 保存 Client ID 和 Client Secret
3. 创建授权脚本 auth_server.py（启动本地 Flask 服务完成 OAuth 授权）
4. 创建文档生成脚本 tencent_docs.py（支持创建文档 + 写入内容）
5. 测试配置是否正常

2.1 完成 OAuth 授权

首次使用需要手动授权一次，获取 Access Token（有效期 30 天）。之后 WorkBuddy 会自动刷新 Token，无需重复操作。

启动腾讯文档 OAuth 授权流程，获取 Access Token。

2.2 验证环境

测试腾讯文档 API 连接是否正常，验证 Access Token 是否有效。

第三步：自定义文档内容与格式

告诉 WorkBuddy 你想写什么，它会帮你生成内容并通过 API 写入腾讯文档。

方式一：让 AI 写完整内容

帮我写一篇文章，并自动创建为腾讯文档：

主题：在这里写主题（比如：2024年AI行业年度总结）
风格：专业、简洁，适合内部汇报
字数：不少于2000字
结构要求：
- 开篇摘要
- 3-5个章节，每章有明确标题
- 关键数据用加粗标注
- 结尾附总结与展望
文档标题：在这里写文档标题

方式二：你已有内容，只需写入腾讯文档

帮我把下面这段内容写入腾讯文档：

文档标题：在这里填标题
正文：
（在这里粘贴你的文章内容）

格式要求：
- 标题用二号、加粗
- 正文用四号
- 重要内容用蓝色背景高亮
- 段落间保留间距

方式三：Markdown 文件直接导入

帮我把下面这个 Markdown 文件导入到腾讯文档：
C:\Users\你的用户名\Desktop\我的文章.md
文档标题：在这里填标题

第四步：一键生成腾讯文档（最常用！）

环境配好后，以后每次只需说这句话：

帮我写一篇文章，自动创建为腾讯文档。

执行成功后，WorkBuddy 会返回文档链接，像这样：

# 生成成功示例输出
✓ 文档创建成功！
  文档ID: DQWxxxxxxx
  链接: https://docs.qq.com/doc/DQWxxxxxxx
✓ 已写入 2150 字，共 5 个章节
✓ 格式设置完成（标题加粗、段落缩进、关键内容高亮）

生成后在哪儿看？

打开 docs.qq.com，登录同一账号，在"我的文档"里就能看到刚刚生成的文档。

第五步：设置定时自动生成文档

帮我创建一个每天自动写文章并生成腾讯文档的定时任务：

执行时间：每天上午9点
内容主题：每日科技资讯汇总，每次不重复
文章风格：简洁专业，适合团队周报
输出位置：腾讯文档（默认目录）

常用指令速查表

常见问题

❓ 报错"invalid_client"怎么办？

Client ID 或 Client Secret 不正确。检查是否复制完整，注意不要多空格。如果确认正确，去开放平台重置 Client Secret 后重试：

更新腾讯文档 Client Secret：在这里填新的Secret

❓ Access Token 过期了怎么办？

Access Token 有效期 30 天。WorkBuddy 会自动用 Refresh Token 刷新，一般不需要手动操作。如果确实过期了：

刷新腾讯文档 Access Token。

❓ 用户取消授权了怎么办？

如果用户在腾讯文档设置中取消了第三方授权，需要重新授权：

重新执行腾讯文档 OAuth 授权流程。

❓ 文档生成成功但内容格式不对？

腾讯文档 v3 API 使用 JSON 格式描述文档结构（段落、文本、样式）。如果你发现格式不对，可以要求 WorkBuddy 调整：

调整腾讯文档生成格式：
- 标题改为"一号、加粗、蓝色"
- 正文改为"四号、宋体"
- 段落首行缩进2字符
- 代码块用灰色背景

❓ 文档数量有上限吗？

腾讯文档 Open API 每个应用有 20000 次免费调用额度（2025年7月起），足够日常使用。如需扩容可联系官方。

❓ 想生成到指定文件夹怎么办？

帮我写一篇关于"xxx"的文章，创建到腾讯文档的"周报"文件夹里。

❓ 定时任务没有执行？

• 检查 WorkBuddy 是否保持开启状态
• 检查 Access Token 是否过期（用上面指令刷新）
• 复制下面指令查看任务状态：

检查每日腾讯文档生成定时任务状态，查看上次执行时间和下次执行时间。