Generación automática de Tencent Docs - Tutorial para principiantes ©️SONGBING

📋 Instrucciones de uso

El contenido del cuadro gris = Copiar y pegar directamente en el cuadro de diálogo de WorkBuddyde instrucción
Sigue los pasos en orden, completa cada paso antes de continuar con el siguiente
Del primer al segundo paso solo se hace una vez (configurar el entorno); después, cada vez que generes un documento solo necesitas ejecutar el cuarto paso
Si tienes problemas, consulta las preguntas frecuentes al final

🗺️ Vista general del proceso

Registrar la plataforma abierta → Obtener Client ID / Secret → Configurar el entorno de Python → La IA escribe el artículo → Escritura en Tencent Docs con un solo clic

Se configura una vez y, a partir de ahí, cada documento se genera con una sola frase.

ℹ️ Acerca de Tencent Docs Open API:Tencent Docs ofrece autorización OAuth2.0 + API RESTful, con soporte para crear documentos en línea, escribir contenido con formato, gestionar archivos, etc. Dirección de la documentación:docs.qq.com/open/document/app。

Paso 1: Registrarse en la plataforma abierta y obtener Client ID y Client Secret

Igual que un WeChat Official Account necesita AppID y AppSecret, Tencent Docs también necesita un par de claves para llamar a la API.

1.1 Registrar desarrollador

Abre el navegador y visita la plataforma de cooperación abierta de Tencent Docs:

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

Tras iniciar sesión, haz clic en"Crear aplicación", rellena el nombre de la aplicación (por ejemplo, "Asistente de documentos inteligentes con IA") y envía para revisión.

Una vez aprobada, entra en la página de detalles de la aplicación y verás dos datos clave:

Nombre del parámetro	Descripción	Uso
`Client ID`	Identificador único de la aplicación	Se necesita tanto para la autorización como para las llamadas a la API
`Client Secret`	Clave de la aplicación (¡confidencial!)	Se usa al canjear el Access Token

ConfiguraciónURL de callback(Callback URL), rellena:http://localhost:8080/callback(para desarrollo local, usa esta).

⚠️ ¡El Client Secret debe mantenerse confidencial!Solo se usa en el servicio backend y nunca debe exponerse en el frontend ni en público. Si se filtra, restablécelo en la plataforma abierta.

✅ ¡Con el Client ID y el Client Secret en mano, pasa al siguiente paso!

Paso 2: Configurar el entorno de Python

Copia el siguiente texto y envíalo a WorkBuddy; te ayudará a configurar todo el entorno con un solo clic:

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

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. 测试配置是否正常

💡 Sustituye "rellena aquí xxx" por tu información real y envíalo a WorkBuddy

2.1 Completar la autorización OAuth

El primer uso requiere una autorización manual para obtener Access Token(válido por 30 días). Después, WorkBuddy renovará el Token automáticamente, sin necesidad de repetir la operación.

📦 Instrucciones del cuadro de diálogo Copiar y pegar

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

💡 WorkBuddy te dará un enlace; ábrelo en el navegador, inicia sesión en Tencent Docs y haz clic en "Aceptar autorización"; así obtendrás el Token

2.2 Verificar el entorno

📦 Instrucciones del cuadro de diálogo Copiar y pegar

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

💡 Si ves "Conexión exitosa, información del usuario obtenida correctamente", la configuración es correcta

✅ ¡Autorización completada! Ahora puedes empezar a escribir documentos.

Paso 3: Personalizar el contenido y el formato del documento

Dile a WorkBuddy qué quieres escribir; generará el contenido y lo escribirá en Tencent Docs mediante API.

Opción 1: Deja que la IA escriba el contenido completo

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

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

💡 Sustituye "escribe aquí xxx" por tu necesidad

Opción 2: Ya tienes el contenido, solo necesitas escribirlo en Tencent Docs

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

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

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

💡 Compatible con formato Markdown; WorkBuddy lo convertirá automáticamente al formato de Tencent Docs

Opción 3: Importar directamente un archivo Markdown

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

💡 WorkBuddy leerá el archivo, analizará el formato Markdown y lo escribirá en Tencent Docs

Paso 4: Generar un documento de Tencent Docs con un solo clic (¡el más usado!)

Una vez configurado el entorno, en adelante solo necesitas decir esta frase:

📦 Instrucciones del cuadro de diálogo Copiar y pegar

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

💡 Todo en una frase: escritura con IA → llamar a la API para crear el documento → escribir el contenido y el formato

Tras una ejecución exitosa, WorkBuddy devolverá el enlace del documento, así:

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

ℹ️ El documento generado se almacena entu cuenta de Tencent Docs; abre el enlace directamente para verlo y editarlo, o compártelo con colegas para colaborar.

¿Dónde verlo después de generarlo?

Abre docs.qq.com, inicia sesión con la misma cuenta y en "Mis documentos" podrás ver el documento recién generado.

Paso 5: Programar la generación automática de documentos

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

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

💡 WorkBuddy creará una tarea automatizada y la ejecutará automáticamente según lo programado

Acerca de la automatización:La función de automatización de WorkBuddy requiere que el equipo permanezca encendido y que WorkBuddy esté en ejecución. El Access Token es válido por 30 días; WorkBuddy lo renovará automáticamente, sin preocuparte por que caduque.

Tabla de referencia rápida de comandos habituales

Qué quieres hacer	Copia este texto
Escribir un artículo y generar un documento de Tencent Docs	`帮我写一篇关于"xxx"的文章，创建为腾讯文档。`
Importar Markdown a Tencent Docs	`把"xxx.md"导入为腾讯文档。`
Generar varios documentos en lote	`帮我写3篇关于"xxx"不同角度的文章，分别创建为腾讯文档。`
Actualizar el contenido de un documento existente	`更新腾讯文档 xxx 的内容，把第二章改成"xxx"。`
Listar mis documentos	`列出我腾讯文档账号里的最近10个文档。`
Copiar documento	`把腾讯文档 xxx 复制一份。`
Probar la conexión con la API	`测试腾讯文档 API 连接是否正常。`
Actualizar Token	`检查并刷新腾讯文档 Access Token。`
Modificar el formato predeterminado	`修改腾讯文档生成脚本，默认字体改为"微软雅黑"，字号14px。`
Ver tareas programadas	`查看当前有哪些自动化任务在运行。`

Preguntas frecuentes

❓ ¿Qué hago si aparece el error "invalid_client"?

El Client ID o el Client Secret no son correctos. Verifica que los hayas copiado completos y asegúrate de no incluir espacios adicionales. Si confirmas que son correctos, restablece el Client Secret en la plataforma abierta y vuelve a intentarlo:

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

❓ ¿Qué hago si el Access Token ha caducado?

El Access Token tiene una validez de 30 días. WorkBuddy lo renueva automáticamente con el Refresh Token, por lo que normalmente no necesitas hacerlo manualmente. Si efectivamente ha caducado:

📦 Instrucciones del cuadro de diálogo Copiar y pegar

刷新腾讯文档 Access Token。

❓ ¿Qué hago si el usuario ha revocado la autorización?

Si el usuario ha revocado la autorización de terceros en la configuración de Tencent Docs, es necesario volver a autorizar:

📦 Instrucciones del cuadro de diálogo Copiar y pegar

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

❓ ¿El documento se genera correctamente pero el formato del contenido no es el esperado?

La API v3 de Tencent Docs utiliza el formato JSON para describir la estructura del documento (párrafos, texto, estilos). Si detectas que el formato no es el correcto, puedes pedirle a WorkBuddy que lo ajuste:

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

❓ ¿Hay un límite en la cantidad de documentos?

La Open API de Tencent Docs ofrece a cada aplicación 20000 llamadas gratuitas(a partir de julio de 2025), suficiente para el uso diario. Si necesitas ampliar la cuota, puedes contactar al equipo oficial.

❓ ¿Qué hago si quiero generar el documento en una carpeta específica?

📦 Instrucciones del cuadro de diálogo Copiar, pegar y modificar

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

❓ ¿La tarea programada no se ejecutó?

Verifica que WorkBuddy esté en estado activo
Verifica si el Access Token ha caducado (renuévalo con el comando anterior)
Copia el siguiente comando para ver el estado de la tarea:

📦 Instrucciones del cuadro de diálogo Copiar y pegar

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

En esencia, todo se resume en una frase:Una vez configurado el entorno de la API, dile a WorkBuddy en lenguaje sencillo qué quieres escribir; él redactará el artículo, llamará a la API de Tencent Docs para crear el documento y escribirá el contenido con formato, todo sin ninguna operación manual.

Consulta rápida de parámetros de configuración

Elemento de configuración	Descripción	Dónde encontrarlo
Client ID	Identificador único de la aplicación	Plataforma abierta → Detalles de la aplicación
Client Secret	Clave de la aplicación (¡confidencial!)	Igual que el anterior, se genera al crear la aplicación
URL de callback	URL de callback de OAuth	http://localhost:8080/callback
Access Token	Credencial de llamada a la API (30 días)	Se obtiene automáticamente tras la autorización OAuth
Refresh Token	Credencial de renovación (1 año)	Se obtiene junto con el Access Token
Documentación de la API	Referencia de la interfaz	docs.qq.com/open/document/app

Elige tu idioma preferido

Al terminar un artículo, genera automáticamente un Tencent Doc

Paso 1: Registrarse en la plataforma abierta y obtener Client ID y Client Secret

1.1 Registrar desarrollador

Paso 2: Configurar el entorno de Python

2.1 Completar la autorización OAuth

2.2 Verificar el entorno

Paso 3: Personalizar el contenido y el formato del documento

Opción 1: Deja que la IA escriba el contenido completo

Opción 2: Ya tienes el contenido, solo necesitas escribirlo en Tencent Docs

Opción 3: Importar directamente un archivo Markdown

Paso 4: Generar un documento de Tencent Docs con un solo clic (¡el más usado!)

¿Dónde verlo después de generarlo?

Paso 5: Programar la generación automática de documentos

Tabla de referencia rápida de comandos habituales

Preguntas frecuentes

❓ ¿Qué hago si aparece el error "invalid_client"?

❓ ¿Qué hago si el Access Token ha caducado?

❓ ¿Qué hago si el usuario ha revocado la autorización?

❓ ¿El documento se genera correctamente pero el formato del contenido no es el esperado?

❓ ¿Hay un límite en la cantidad de documentos?

❓ ¿Qué hago si quiero generar el documento en una carpeta específica?

❓ ¿La tarea programada no se ejecutó?