글을 작성하면 Tencent Docs가 자동 생성됩니다

1단계: 오픈 플랫폼에 등록하고 Client ID와 Client Secret 발급받기

WeChat Official Account에 AppID와 AppSecret이 필요한 것처럼, Tencent Docs도 API 호출을 위해 한 쌍의 키가 필요합니다.

1.1 개발자 등록

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

2단계: 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 是否有效。

3단계: 문서 내용과 형식 사용자 지정

WorkBuddy에 무엇을 작성할지 알려주면 내용을 생성하고 API를 통해 Tencent Docs에 기록합니다.

방법 1: AI에게 전체 내용 작성 요청

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

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

방법 2: 이미 내용이 있고 Tencent Docs에 기록만 필요

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

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

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

방법 3: Markdown 파일 직접 가져오기

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

4단계: 한 번에 Tencent Docs 생성 (가장 많이 사용!)

환경 설정 후에는 매번 이 문장만 말하면 됩니다:

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

실행에 성공하면 WorkBuddy가 다음과 같이 문서 링크를 반환합니다:

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

생성 후 어디서 보나요?

열기 docs.qq.com, 동일한 계정으로 로그인하면 "내 문서"에서 방금 생성한 문서를 볼 수 있습니다.

5단계: 정기 자동 문서 생성 설정

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

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

자주 쓰는 명령어 빠른 참조

자주 묻는 질문

❓ "invalid_client" 오류가 발생하면 어떻게 하나요?

Client ID 또는 Client Secret이 올바르지 않습니다. 전체가 복사되었는지 확인하고, 불필요한 공백이 없는지 주의하세요. 올바른 것이 확인되면 오픈 플랫폼에서 Client Secret을 재설정한 후 다시 시도하세요:

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

❓ Access Token이 만료되면 어떻게 하나요?

Access Token의 유효 기간은 30일입니다. WorkBuddy가 Refresh Token으로 자동 갱신하므로 일반적으로 수동 조작이 필요하지 않습니다. 실제로 만료된 경우:

刷新腾讯文档 Access Token。

❓ 사용자가 권한 부여를 취소하면 어떻게 하나요?

사용자가 Tencent Docs 설정에서 제3자 권한 부여를 취소한 경우 다시 권한을 부여해야 합니다:

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

❓ 문서 생성은 성공했지만 내용 형식이 잘못되었나요?

Tencent Docs v3 API는 JSON 형식으로 문서 구조(단락, 텍스트, 스타일)를 설명합니다. 형식이 잘못된 것을 발견하면 WorkBuddy에 조정을 요청할 수 있습니다:

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

❓ 문서 수에 상한이 있나요?

Tencent Docs Open API는 각 애플리케이션당 20000회 무료 호출 할당량(2025년 7월부터)이 있어 일상적인 사용에 충분합니다. 확장이 필요하면 공식에 문의하세요.

❓ 지정된 폴더에 생성하려면 어떻게 하나요?

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

❓ 예약 작업이 실행되지 않았나요?

• WorkBuddy가 켜진 상태로 유지되는지 확인
• Access Token이 만료되었는지 확인(위 명령어로 갱신)
• 아래 명령어를 복사하여 작업 상태를 확인하세요:

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