我的 SQL 文档模板管理
功能概述
这篇文档介绍的是 我的 SQL 文档模板管理。
当前入口在 Studio 里，您可以从工作区顶栏的文档生成区点击：
- 我的模板管理
进入后，您会在同一个管理窗口里看到：
- 模板列表
- 模板详情
- 新建模板入口
- 上架 / 下架状态
- 编译状态
如果您是高校大学生，正在做课设、毕设或数据库文档整理，这个功能很实用，因为它能让您把一份固定的 SQL 文档模板反复管理、反复修订，而不用每次都重新从零开始。
列表页 / 详情页结构
当前 Studio 里的“我的 SQL 文档模板管理”由 列表页 + 详情页 两部分组成。
1. 列表页结构
列表页默认展示模板清单。 当前可见内容主要包括：
| 列表页区域 | 当前能看到什么 |
|---|---|
| 顶部标题 | 我的 SQL 文档模板 |
| 顶部描述 | 说明当前模板管理的用途 |
| 操作按钮 | 刷新、新建模板 |
| 统计卡片 | 全部模板、已上架、已编译、编译失败 |
| 搜索框 | 按 code / 名称 / 描述搜索 |
| 筛选项 | 引擎、上架状态、编译状态 |
| 表格列 | 模板、引擎、访问级别、上架状态、编译状态、更新时间、操作 |
2. 列表页里的状态怎么理解
当前列表页里，最容易需要确认的是这两个状态：
| 状态 | 您可以怎么理解 |
|---|---|
| 上架状态 | 这个模板是否已经对 Studio 可见 |
| 编译状态 | 这个模板的导出版 DOCX 是否已经处理完成 |
当前用户最常见的状态显示是：
- 已上架 / 已下架
- 已编译 / 待编译 / 编译失败
如果模板已经下架，它就不会出现在 Studio 选择器里。 如果编译失败，模板虽然还在列表里，但暂时不可按正常可用状态继续使用。
3. 详情页结构
从列表页点击某个模板后，就会进入详情页。 当前详情页主要由下面几部分组成：
| 详情页区域 | 当前能看到什么 |
|---|---|
| 顶部标题栏 | SQL 文档模板 |
| 顶部描述 | 模板名称、引擎、编码等信息 |
| 返回按钮 | 返回列表 |
| 操作按钮 | 校验、保存 |
| 页签 | 向导、目录结构、批量提示词 |
| 辅助面板 | 章节、参考 |
4. 详情页三个页签的区别
当前详情页默认会围绕这三个页签展开：
| 页签 | 更适合做什么 |
|---|---|
| 向导 | 按步骤上传、识别和整理模板 |
| 目录结构 | 查看和调整章节结构 |
| 批量提示词 | 批量处理提示词内容 |
如果您是第一次接触模板管理，通常先看 向导 就够了。 如果您已经有一份成型文档，就更适合直接到 目录结构 或 批量提示词 继续整理。
上传与创建步骤
当前创建 SQL 文档模板的流程非常明确： 以 Word(.docx) 上传作为起点。
第一步：打开“我的模板管理”
在 Studio 顶栏的文档生成区，点击：
- 我的模板管理
进入后，默认会先看到模板列表。
第二步：点击“新建模板”
在列表页右上角，您可以直接点：
- 新建模板
系统会打开创建对话框，标题是：
- 上传并创建我的模板
第三步：上传 Word(.docx)
在创建对话框里，最关键的一步是上传 Word 文件。 当前界面明确支持的是：
- Word(.docx)
上传后，系统会按当前流程自动处理：
- 识别目录
- 补齐默认内容
- 编译导出版 DOCX
第四步：填写可选信息
上传之后，您还可以补这两项可选信息：
- 模板名称
- 描述
如果您不填，系统也可以根据文件名帮您自动带出一个默认名称。
第五步：决定是否创建后立即上架
当前创建对话框里有一个开关：
- 创建后上架（立即可用）
如果您打开这个开关，成功创建后会自动变成可用状态。 如果您先想草稿保存、后面再慢慢调，也可以先保持关闭。
第六步：点击“上传并创建”
点击提交后，当前流程会依次显示：
- 上传中
- 识别中
- 编译中
- 创建完成
- 创建失败
如果成功，系统会自动帮您打开详情页。 如果某一步失败，页面会把失败信息明确告诉您，方便您回头修。
第七步：进入详情页后继续确认
创建成功后，您通常会进入详情页继续检查：
- 章节结构
- 目录内容
- 批量提示词
- 保存状态
- 校验结果
如果导出版编译失败，通常也可以进入详情页继续修复后再启用。
配置要点
1. 先看列表，再决定要不要新建
如果您已经有现成模板，先从列表页看：
- 是否已经存在类似模板
- 模板是否已上架
- 编译状态是否正常
很多时候，您不一定要立刻新建，只要先找到可复用的模板再进入详情页，会更省时间。
2. 上架状态和编译状态不是一回事
这点很重要。 当前列表页会同时展示：
- 上架状态
- 编译状态
它们的含义不同：
| 状态 | 作用 |
|---|---|
| 上架状态 | 控制模板是否对 Studio 可见 |
| 编译状态 | 控制导出版 DOCX 是否已经就绪 |
也就是说：
- 模板上架了，不代表编译一定成功
- 编译成功了，也不代表一定已经上架
3. 创建后是否上架，建议先想清楚
如果您做的是课设 / 毕设模板，通常建议先想清楚：
- 这是草稿
- 还是准备直接给 Studio 使用
如果是后者，创建时就可以直接打开“创建后上架”。 如果还在反复修改，就先当草稿更稳。
4. 详情页里要重点看“向导”和“目录结构”
当前详情页不只是一个静态预览。 您真正会反复用到的是：
- 向导：按步骤处理模板
- 目录结构：看章节怎么排
这两部分是创建后最需要回看的区域。
5. 先上传一份完整 Word，再考虑细节调整
如果您已经有现成的 SQL 文档，建议优先上传完整的 .docx。
先让系统识别出目录结构，再看哪些地方需要手工修，比一开始就想把所有细节都手输进去更顺。
6. 如果编译失败，先回到详情页修复
当前界面已经明确提示：
- 编译失败时，模板会暂时退出可用态
- 您可以进入详情页继续修复后再启用
所以如果创建后发现不可用，优先回详情页看编译状态，不要先怀疑整个流程坏了。
常见问题
Q1：当前入口在哪里？
当前入口在 Studio 的文档生成区。 点击：
- 我的模板管理
就能进入当前的模板管理窗口。
Q2：创建模板时必须上传什么？
当前创建流程基于：
- Word(.docx)
上传后，系统会继续帮您识别目录、补齐默认内容并编译导出版。
Q3：列表页里我最该看哪几个状态？
最值得关注的是：
- 上架状态
- 编译状态
- 访问级别
- 引擎
尤其是上架状态和编译状态，直接影响模板是不是当前可用。
Q4：创建后为什么没有立刻可用？
通常有两种情况：
- 还在上传 / 识别 / 编译过程中
- 编译失败，需要回详情页继续修复
当前创建流程会把这些状态直接显示出来，您按页面提示看即可。
Q5：创建后上架和不勾上架有什么区别？
如果您创建后就上架，模板会更快出现在 Studio 可见位置。 如果先不勾上架，它会更像一个草稿，方便您继续调完再启用。
Q6：详情页里我还能做什么？
除了看模板结果，您还可以：
- 返回列表
- 保存
- 校验
- 切换到向导 / 目录结构 / 批量提示词
- 继续编辑章节相关内容
Q7：这篇最需要掌握什么？
对大多数课设 / 毕设用户来说，最需要掌握的是：
- 怎么上传
- 怎么查看列表
- 怎么进入详情
- 怎么处理上架和编译状态
这比记模板语法更直接。
Q8：如果上传后自动没打开详情页怎么办？
当前也考虑到了这个情况。 如果自动打开没有成功，您仍然可以从列表页继续进入详情页编辑。
下一步
如果您已经把模板管理和字段结构都整理好了，下一步建议按下面顺序继续：
如果您的目标是让 SQL 文档模板真正稳定可用，通常就是：
- 先把模板上传并识别好
- 再检查列表里的上架和编译状态
- 然后进入详情页继续修
- 最后再回到工作区整体流程里继续往下走