- グレーの背景ボックスの内容 = WorkBuddyのダイアログボックスに直接コピー&ペースト指示
- 順番にステップ1から始め、各ステップを完了してから次へ進んでください
- ステップ1からステップ2までは一度だけ行えばOK(環境設定)。以降、ドキュメント生成時はステップ4を実行するだけ
- 問題が発生した場合は、下部のよくある質問をご覧ください
一度設定すれば、以降のドキュメント生成は一言で完了。
ステップ1:オープンプラットフォームに登録し、Client ID と Client Secret を取得
WeChat Official Account に AppID と AppSecret が必要なように、Tencent Docs も API を呼び出すためのキーペアが必要です。
1.1 開発者登録
https://docs.qq.com/open/developers/
| パラメータ名 | 説明 | 用途 |
|---|---|---|
Client ID | アプリ一意識別子 | 認可と API 呼び出しの両方に必要 |
Client Secret | アプリシークレット(機密!) | Access Token の取得時に使用 |
http://localhost:8080/callback(ローカル開発ではこれでOK)。ステップ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点 内容主题:每日科技资讯汇总,每次不重复 文章风格:简洁专业,适合团队周报 输出位置:腾讯文档(默认目录)
よく使うコマンド早見表
| やりたいこと | この文をコピー |
|---|---|
| 記事を書いて Tencent Docs を生成 | 帮我写一篇关于"xxx"的文章,创建为腾讯文档。 |
| Markdown を Tencent Docs にインポート | 把"xxx.md"导入为腾讯文档。 |
| 複数のドキュメントを一括生成 | 帮我写3篇关于"xxx"不同角度的文章,分别创建为腾讯文档。 |
| 既存ドキュメントの内容を更新 | 更新腾讯文档 xxx 的内容,把第二章改成"xxx"。 |
| 自分のドキュメントを一覧表示 | 列出我腾讯文档账号里的最近10个文档。 |
| ドキュメントをコピー | 把腾讯文档 xxx 复制一份。 |
| API 接続をテスト | 测试腾讯文档 API 连接是否正常。 |
| Token を更新 | 检查并刷新腾讯文档 Access Token。 |
| デフォルト形式を変更 | 修改腾讯文档生成脚本,默认字体改为"微软雅黑",字号14px。 |
| スケジュールタスクを確認する | 查看当前有哪些自动化任务在运行。 |
よくある質問
❓ エラー「invalid_client」が出た場合は?
Client ID または Client Secret が正しくありません。コピーが完全か確認し、余分なスペースが入らないよう注意してください。正しいと確認できた場合は、開放プラットフォームで Client Secret をリセットしてから再試行してください:
更新腾讯文档 Client Secret:在这里填新的Secret
❓ Access Token の有効期限が切れた場合は?
Access Token の有効期間は 30 日です。WorkBuddy は Refresh Token で自動的に更新するため、通常は手動操作は不要です。実際に期限切れになった場合:
刷新腾讯文档 Access Token。
❓ ユーザーが認可を取り消した場合は?
ユーザーが Tencent Docs の設定で第三者認可を取り消した場合、再認可が必要です:
重新执行腾讯文档 OAuth 授权流程。
❓ ドキュメント生成は成功したが内容の形式が正しくない場合は?
Tencent Docs v3 API は JSON 形式でドキュメント構造(段落、テキスト、スタイル)を記述します。形式が正しくないと気づいた場合は、WorkBuddy に調整を依頼できます:
调整腾讯文档生成格式: - 标题改为"一号、加粗、蓝色" - 正文改为"四号、宋体" - 段落首行缩进2字符 - 代码块用灰色背景
❓ ドキュメント数に上限はありますか?
Tencent Docs Open API では、各アプリに 20000 回の無料呼び出し枠(2025年7月より)があり、日常利用には十分です。枠の拡張が必要な場合は公式にお問い合わせください。
❓ 指定したフォルダに生成したい場合は?
帮我写一篇关于"xxx"的文章,创建到腾讯文档的"周报"文件夹里。
❓ 定期タスクが実行されない場合は?
- WorkBuddy が起動状態を保っているか確認
- Access Token が期限切れでないか確認(上記のコマンドで更新)
- 以下のコマンドをコピーしてタスク状態を確認:
检查每日腾讯文档生成定时任务状态,查看上次执行时间和下次执行时间。
| 設定項目 | 説明 | 確認場所 |
|---|---|---|
| Client ID | アプリ一意識別子 | 開放プラットフォーム → アプリ詳細 |
| Client Secret | アプリシークレット(機密!) | 同上、アプリ作成時に生成 |
| コールバックアドレス | OAuth コールバック URL | http://localhost:8080/callback |
| Access Token | API 呼び出し認証情報(30日) | OAuth 認可後に自動取得 |
| Refresh Token | 認証情報の更新(1年) | Access Token と同時に取得 |
| API ドキュメント | インターフェースリファレンス | docs.qq.com/open/document/app |