预定会议模版设置

技能文档

---
name: tmeet-meeting-templates
title: 预定会议模版设置
category: 办公效率
description: 腾讯会议预定设置模版管理，将常用会议设置保存为可复用模版，下次预定会议时直接套用。当用户要求"预定会议""创建会议""约个会""保存会议模版""把会议设置存为模版""创建会议模版"时触发。
---

# 预定会议模版设置

腾讯会议预定设置模版管理。将常用会议的设置（入会限制、等候室、水印、自动录制、自动转写等）保存为可复用模版，下次预定会议时可直接指定或从列表中选用模版，无需每次逐项重新配置。

## 使用场景

- 用户说"把 XX 会议的设置存为模版""保存成会议模版""下次预定会议时给我这个选项""帮我创建一个会议模版"等 → 触发**创建模版**流程：默认引导用户提供一场想参考的会议来创建模版；用户也可以选择不参考任何会议，直接逐项配置来创建模版。
- 用户说"帮我预定会议""创建会议""约个会"等，且尚未指定完整设置 → 触发**套用模版**流程：
  - 若用户已在同一句话里指定了模版（如"用分享会模版建个会"）→ 直接匹配并套用该模版，无需再问是否使用模版。
  - 若用户未指定模版 → 先询问"是否需要使用已保存的会议模版"，用户确认需要后再列出 `templates/` 下所有可用模版供其挑选；用户选定后再询问缺失的必填信息（主题、开始/结束时间等），最后调用 `tmeet meeting create` 创建。
- 用户不需要模版、已给出完整设置时，正常调用 tmeet 技能创建会议即可，无需触发本技能。

## 技能工作流

### 步骤 0：连接检查（每次进入本技能必做，强制前置，无绕过路径）

本技能无论是"创建模版"还是"套用模版"，都依赖 tmeet（腾讯会议）完成实际的 `meeting get` / `meeting create` 调用，**必须先确认 tmeet 已安装且已登录才能继续**，不提供跳过连接直接生成本地模版草稿等任何绕过方式。

1. 执行 `tmeet auth status` 检查登录状态。
2. **已登录**：直接进入下方"创建模版"或"套用模版"对应流程。
3. **未登录 / 返回 `user config is empty` / `tmeet` 命令不存在**：
   - 告知用户当前尚未连接腾讯会议，本技能依赖 tmeet 拉取/创建真实会议数据，**无法在未连接状态下继续**。
   - 询问用户是否同意现在安装并连接。
   - **用户同意后**：帮用户安装腾讯会议 CLI（[https://github.com/TencentCloud/tencentmeeting-cli](https://github.com/TencentCloud/tencentmeeting-cli)），执行：
     ```bash
     npm install -g @tencentcloud/tmeet
     ```
     安装完成后执行 `tmeet auth login`（后台运行以捕获授权链接，将链接完整展示给用户，引导其在浏览器打开完成 OAuth 授权），授权完成后用 `tmeet auth status` 确认登录成功，再继续后续流程。
   - **用户不同意连接**：明确告知本技能无法继续（无法保存/套用会议模版），流程到此结束，不做任何降级处理。

### 步骤 1：创建模版

0. **询问用户创建方式**：默认引导用户提供一场希望参考的会议（"有没有一场现有会议，设置比较符合你想要的模版？可以给我会议号或告诉我是哪场会议"）；同时告知用户也可以选择不参考任何会议，直接从设置项列表里逐项勾选来创建模版。按用户选择进入下方 A 或 B 分支。

**A. 参考一场现有会议**

1. 通过 `tmeet meeting get --meeting-id <id>` 或 `--meeting-code <code>` 获取该会议的完整设置（`settings` 字段）。若用户在近期会议里找不准，可用 `tmeet meeting list-ended` / `tmeet meeting list` 列出候选清单交用户选择，不自行判断哪场符合。
2. 从 `settings` 中提取以下关键字段，映射为 `tmeet meeting create` 支持的命令行参数：

   | 会议详情字段 | create 命令参数 | 取值示例 |
   |---|---|---|
   | `only_user_join_type` | `--join-type` | 1=所有成员，2=仅受邀，3=仅企业内部 |
   | `auto_in_waiting_room` | `--waiting-room` | true/false |
   | `water_mark_type` | `--water-mark-type` | 0=单排，1=双排，2=关闭（注意：详情接口的取值含义需与 create 参数核对，如有出入以 create 参数说明为准） |
   | `audio_watermark` | `--audio-watermark` | true/false |
   | `auto_record_type` | `--auto-record-type` | none/local/cloud |
   | `auto_asr` | `--auto-asr` | true/false |

3. 把提取到的设置展示给用户确认，允许用户在此基础上调整个别项（如"其他都保留，等候室我想改成开启"）。

**B. 不参考会议，直接创建**

1. 向用户完整列出所有可配置的设置项及可选取值，让用户逐项选择（未提及的项使用 `tmeet meeting create` 的默认值，见下表"默认值"列）：

   | 设置项 | create 命令参数 | 可选取值 | 默认值 |
   |---|---|---|---|
   | 入会限制 | `--join-type` | 1=所有成员，2=仅受邀，3=仅企业内部 | 1 |
   | 等候室 | `--waiting-room` | 开启/关闭 | 关闭 |
   | 主持人自动录制 | `--auto-record-type` | none=关，local=本地，cloud=云录制 | none |
   | 文字水印 | `--water-mark-type` | 0=单排，1=双排，2=关闭 | 视个人/企业账号默认设置而定 |
   | 音频水印 | `--audio-watermark` | 开启/关闭 | 视企业设置而定 |
   | 自动文字转写（ASR） | `--auto-asr` | 开启/关闭 | 关闭 |
   | 会议密码 | `--password` | 4~6 位数字，可留空 | 无密码 |
   | 会议类型 | `--meeting-type` | 0=普通会议，1=周期性会议 | 0（模版一般只针对普通会议的通用设置，周期规则通常按每次实际预定单独设置，非必须存入模版） |

2. 用户逐项选定后，汇总成一份设置清单向用户确认无误。

**创建模版收尾（A/B 共用）**

3. 向用户确认模版名称（如未指定，用会议主题或场景类型命名，如"分享会模版""站会模版"）。
4. 在本技能的 `templates/` 目录下创建 `<template_id>.json`，字段结构如下：
   ```json
   {
     "template_id": "唯一标识，英文短横线命名",
     "template_name": "展示给用户的模版名称",
     "source_meeting": {
       "subject": "来源会议主题（走B分支时此字段省略或写\"手动创建\"）",
       "meeting_code": "来源会议号，走B分支时省略（不记录 meeting_id）",
       "captured_at": "创建日期"
     },
     "description": "一句话描述该模版适用场景和核心设置",
     "cli_flags": {
       "join-type": 1,
       "waiting-room": false,
       "water-mark-type": 1,
       "audio-watermark": false,
       "auto-record-type": "none",
       "auto-asr": false
     },
     "notes": ["对关键取值含义的补充说明"]
   }
   ```
5. 告知用户模版已保存，之后预定会议时会主动提供该模版选项。

### 步骤 2：套用模版（预定会议时）

0. **先判断用户是否已在请求中直接指定模版**（如"用分享会模版帮我建个会""按站会模版预定"）：
   - 若已指定：在 `templates/` 目录下按 `template_name`/`template_id` 匹配对应模版文件，匹配到后**跳过第 1 步，直接进入第 2 步**套用该模版；若指定的模版名找不到匹配项，告知用户未找到该模版，并展示当前可用模版列表供其重新选择。
   - 若未指定：进入第 1 步。
1. 用户未指定模版时，**先询问是否需要使用已保存的会议模版**（是/否），不要一开始就把模版列表甩给用户：
   - 若用户选择"否" → 跳过模版，直接询问会议主题/时间等设置，按用户口述或默认设置创建。
   - 若用户选择"是" → 列出 `templates/` 目录下所有 `*.json` 模版文件，展示 `template_name` 和 `description`，让用户从列表中选择一个具体模版。
2. 用户选定模版后（无论是步骤0直接指定还是步骤1选择得到），读取该模版的 `cli_flags`，作为 `tmeet meeting create` 的默认参数。
3. 询问用户缺失的必填信息：会议主题 `--subject`、开始时间 `--start`、结束时间 `--end`（模版不包含这些信息，因为每次会议不同）。若为周期性会议还需询问周期规则。
4. 拼装完整命令，向用户展示即将创建的会议信息（主题/时间/套用的模版设置），确认后执行 `tmeet meeting create`。
5. 创建成功后按 tmeet 技能的标准回复格式展示会议主题/时间/会议号/入会链接。

## 注意事项

- 会议详情接口（`meeting get`）返回的字段名和取值含义，与 `meeting create` 命令的参数取值可能不完全一致（例如水印字段的枚举值顺序），套用模版生成命令前，先用小范围测试或让用户确认最终生效的设置是否符合预期，不要盲目假设映射关系永远正确。
- 创建模版时**严禁**记录 `meeting_id`、参会人 `open_id`、密码等敏感或会议专属信息，模版只保留可复用的"设置类"字段。
- 套用模版不代表跳过用户确认：创建会议前仍需按 tmeet 技能的规则向用户展示关键信息，不能因为"用了模版"而省略确认步骤。
- 若 `templates/` 目录为空，直接跳过"列出模版"步骤，正常询问设置即可，不要提示报错。
- tmeet 未连接/未登录时，步骤 0 是强制前置检查，任何时候都不能绕过直接尝试"创建模版"或"套用模版"，即便用户表述得很急切。

## 验证方法

- 创建模版后，重新读取生成的 json 文件，确认字段完整且不含敏感信息。
- 套用模版创建会议后，用 `tmeet meeting get --meeting-id <新会议id>` 核对实际生效的设置是否与模版一致。

使用说明

# 预定会议模版设置

将腾讯会议常用设置保存为可复用模版，预定会议时一键套用，无需每次逐项配置。

## 使用

创建模版（参考现有会议）：

```text
把这场会议的设置存为模版
```

创建模版（手动配置）：

```text
帮我创建一个会议模版
```

套用模版预定会议：

```text
用分享会模版帮我预定一个会议
```

或直接预定会议时选择模版：

```text
帮我预定会议
```

## 工作原理

1. **连接检查**：确认 tmeet（腾讯会议 CLI）已安装并登录
2. **创建模版**：从现有会议提取设置，或手动逐项配置，保存为 `templates/` 下的 JSON 文件
3. **套用模版**：预定会议时读取模版的 `cli_flags` 作为默认参数，补充主题和时间后创建会议

支持的可配置项包括：入会限制、等候室、水印、自动录制、自动转写、会议密码等。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。