寫完文章，自動生成騰訊文件

第一步：註冊開放平台，取得 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 是否過期（用上面指令重新整理）
• 複製下面指令查看任務狀態：

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