Viết xong bài, tự động tạo Tencent Docs

Bước 1: Đăng ký nền tảng mở, lấy Client ID và Client Secret

Giống như WeChat Official Account cần AppID và AppSecret, Tencent Docs cũng cần một cặp khóa để gọi API.

1.1 Đăng ký nhà phát triển

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

Bước 2: Cấu hình môi trường Python

Sao chép đoạn văn bản dưới đây và gửi cho WorkBuddy, nó sẽ giúp bạn thiết lập toàn bộ môi trường chỉ với một cú nhấp:

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

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 Hoàn tất ủy quyền OAuth

Lần đầu sử dụng cần ủy quyền thủ công một lần để lấy Access Token(hiệu lực 30 ngày). Sau đó WorkBuddy sẽ tự động làm mới Token, không cần thao tác lại.

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

2.2 Xác minh môi trường

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

Bước ba: Tùy chỉnh nội dung và định dạng tài liệu

Cho WorkBuddy biết bạn muốn viết gì, nó sẽ giúp bạn tạo nội dung và ghi vào Tencent Docs qua API.

Cách một: Để AI viết toàn bộ nội dung

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

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

Cách hai: Bạn đã có nội dung, chỉ cần ghi vào Tencent Docs

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

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

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

Cách ba: Nhập trực tiếp tệp Markdown

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

Bước bốn: Tạo Tencent Docs chỉ với một cú nhấp (dùng nhiều nhất!)

Sau khi cấu hình môi trường, mỗi lần chỉ cần nói câu này:

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

Sau khi thực thi thành công, WorkBuddy sẽ trả về liên kết tài liệu, như thế này:

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

Xem ở đâu sau khi tạo?

Mở docs.qq.com, đăng nhập cùng tài khoản, trong "Tài liệu của tôi" là có thể thấy tài liệu vừa tạo.

Bước năm: Thiết lập tạo tài liệu tự động theo lịch

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

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

Bảng tra cứu nhanh các lệnh thường dùng

Câu hỏi thường gặp

❓ Gặp lỗi "invalid_client" thì phải làm sao?

Client ID hoặc Client Secret không đúng. Kiểm tra xem đã sao chép đầy đủ chưa, lưu ý không để thừa dấu cách. Nếu xác nhận đúng rồi, hãy vào nền tảng mở để đặt lại Client Secret rồi thử lại:

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

❓ Access Token hết hạn thì phải làm sao?

Access Token có hiệu lực 30 ngày. WorkBuddy sẽ tự động dùng Refresh Token để làm mới, thường không cần thao tác thủ công. Nếu thực sự đã hết hạn:

刷新腾讯文档 Access Token。

❓ Người dùng đã hủy ủy quyền thì phải làm sao?

Nếu người dùng đã hủy ủy quyền bên thứ ba trong phần cài đặt Tencent Docs, cần ủy quyền lại:

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

❓ Tạo tài liệu thành công nhưng định dạng nội dung không đúng?

API v3 của Tencent Docs dùng định dạng JSON để mô tả cấu trúc tài liệu (đoạn văn, văn bản, kiểu dáng). Nếu bạn thấy định dạng không đúng, có thể yêu cầu WorkBuddy điều chỉnh:

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

❓ Số lượng tài liệu có giới hạn không?

Open API của Tencent Docs mỗi ứng dụng có hạn mức 20000 lần gọi miễn phí(từ tháng 7/2025), đủ dùng cho nhu cầu hằng ngày. Nếu cần mở rộng có thể liên hệ chính thức.

❓ Muốn tạo vào thư mục chỉ định thì phải làm sao?

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

❓ Tác vụ định kỳ không được thực thi?

• Kiểm tra xem WorkBuddy có đang ở trạng thái mở không
• Kiểm tra Access Token có hết hạn không (dùng lệnh ở trên để làm mới)
• Sao chép lệnh dưới đây để xem trạng thái tác vụ:

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