AI 助手的技能库、知识库与维护脚本
如何使用 AI 助手 讲的是「怎么问、怎么让它动手」。本页讲的是它下面那层底座：助手回答时依据的是哪份资料、这份资料谁维护、它起草出来的脚本怎么审怎么发，以及另外两件同样带「AI」字样、但和排障助手完全不是一条链路的东西。
这一层平时不用管，出厂就是能用的。会翻到本页，通常是遇到下面这几种情况：
1，助手答得不对路，想知道能不能自己补一篇手册进去。
2，助手报的参数总填错，运营让你「把本机的动作目录导一份上来」。
3，让助手改了客户机开机维护脚本，要在发布前逐行核一遍。
4，在菜单里看到「AI 分析服务配置」，不确定它跟助手的点数有没有关系（没有）。
一、先把三套东西分清
带「AI」字样的东西在这套软件里有三条互不相干的链路，混起来会白折腾很久：
| 这一套 | 干什么用 | 模型在哪 | 与助手点数的关系 |
|---|---|---|---|
| AI 助手（排障） | 自然语言排障、替你操作控制台、起草维护脚本 | 云端统一下发，现场不配 | 就是它在计费 |
| AI 分析服务 | 教室摄像头的视频巡检与督导分析 | 现场另装的分析节点（本页第五节） | 无关，不消耗点数 |
| AI 教学库（智能体） | 早期的知识库 / RAG 问答 / 模型训练 | 现场本机的 Qwen（本页第六节） | 无关，不消耗点数 |
一句话记住
助手的模型在云端、分析节点在机房、教学库在本机。 三者各有各的配置页，改一处不影响另外两处。
二、技能库：助手「怎么操作这套软件」的依据
没有它的时候麻烦在哪
大模型懂通用知识，但不懂这套软件的正规口径——哪个功能该点哪里、改完要不要重启、哪一步有坑。缺了这份资料，助手回答现场问题时只能凭先验知识编，编出来的页面名和步骤在实机上根本找不到。技能库就是喂给助手看的那份操作与排障资料。
分两层，各有各的维护人
| 这一层 | 放在哪 | 谁维护 | 生效方式 |
|---|---|---|---|
| 现场本地目录 | 随服务端出厂的一批 Markdown 文件，目录位置由服务端配置指向、随部署放置 | 现场可自行增补 | 在页面上点「重新加载」，重扫目录即生效 |
| 云端技能库 | 云端一处维护 | 由服务商维护 | 全网现场自动跟随，最迟约 10 分钟，不必动现场、不必重出产物 |
为什么手册在云端、记忆在现场
「这套软件怎么操作」对所有单位都一样，放云端一处维护、全网跟随最省事；「一号机房其实是机房 1」这类只有本单位懂的叫法，只对本现场成立，所以记忆存在本单位服务器上、不随云端下发。技能＝怎么做，记忆＝指的是谁。
在哪里看
管理台 →「智能排障」页 → 右侧「技能库」面板。
面板是一张清单，逐篇显示三项元信息：
| 列 | 说明 |
|---|---|
| 标题 | 这篇手册管什么，例如「客户机开机卡在下载或下载很慢」 |
| 分类 | 出厂手册目前用到 client（客户机）、network（网络）、image（镜像）、server（服务器）四类 |
| 严重度 | high / medium，供助手判断优先级 |
清单上方有「重新加载」按钮：点一次重新扫描技能库目录，新增或改过的手册立即生效，不需要重启管理服务。
「智能排障」与「维护脚本草稿」两页默认不在菜单里
这两页挂在「智能体」（旧称 AI 教学）分组下，该分组当前版本默认不在左侧菜单显示，菜单是否露出属产品开关，另外还要有对应的功能权限。需要用到时请联系您的服务提供方开启。日常问答请走顶层菜单 AI 助手 → 智能对话，那一页不受此限制。
出厂带了哪些
服务端出厂已带十余篇针对无盘 / 云桌面场景的排障手册，覆盖：开机卡在下载、客户机蓝屏、跨机型网卡驱动没绑定、客户机掉线或无法上线、服务器磁盘空间不足、回写与缓存盘异常、维护通道 run.bat 不执行、镜像更新后不生效、上传母盘失败、更新模式卡住，以及后续版本陆续补上的交换机专题（机房交换机总纲与三厂商命令对照、终端网络启动被挡、组播不生效、传输慢）和两篇流程专题（维护通道从想法到发包、开更新 → 装软件 → 确认更新）。
每篇的正文按固定几节组织：适用症状 → 可能原因（按概率排序）→ 排查步骤 → 处置办法 → 常见误判。自己增补时照这个结构写，助手用起来最顺。
云端那一层另有一批「怎么操作这套软件」的操作手册，按功能与场景分篇（开关机、访问模式、各种「清」的区别、桌面、开机菜单、更新合并、探测测速、机器与分组、消息与命令、服务器与磁盘、计划任务，以及开不了机、下载慢、改了东西没保存、考试机房准备等场景篇），由服务商统一维护。
边界与坑
1，技能库只管「这套软件怎么操作」。像「不能网络唤醒多半是什么问题」这类通识经验题，助手直接用自身知识回答，不依赖技能库，也不会因为技能库里没有就回一句「未找到相关内容」。
2，自己加的手册必须放进服务端配置指向的那个目录，放在别处扫不到。加完记得点「重新加载」。
3，云端那一层改不了，需要补充请通过服务商提交，改完全网现场跟随。
4，经助手发起时要点确认。「列技能库清单」「重新扫描目录」这两个动作本身只是读取和重载，但仍按高危分档——你在页面上手动点没问题，让助手代劳会先弹待确认卡片。
5，手机端没有技能库管理。这属于坐在电脑前干的活，小程序里不提供。
三、导出接口目录（动作目录导出）
解决什么问题
助手知道控制台有哪些动作，但不一定知道每个动作的参数该怎么填。这些参数说明的真身散在现场程序里，几十条，运营手上没有一份能补充、能修订的版本，遇到助手填错也没地方纠正。
于是云端后台有一张「接口目录」：每个动作叫什么、要哪些参数、参数什么含义、危险不危险，在那里维护一份，下发给现场后进入助手的检索库。助手回答前先检索，既拿到「该干什么」（技能库），也拿到「参数怎么填」（接口目录），才能把几个动作自己串起来完成一件事。
几十条手抄必然抄漏、抄完就开始漂，所以现场这边做了一键导出。
在哪里操作
管理台 → AI 助手 → 智能对话 → 右侧面板底部 →「导出接口目录」按钮。
（右侧面板可收起；收起后左边会留一条细边，点它展开。）
1，点「导出接口目录」，浏览器直接下载一个
console-actions.json文件，导出成功的提示里会写明这次导了多少个动作。2，把文件内容粘进云端后台「接口目录 → 批量导入」。
3，导入按动作名覆盖，不会删掉云端已有的其它条目——不同版本的现场可以先后往上导，互不干扰。
边界与坑
1，导出的是「本现场这个版本真实有的动作」。各现场版本不同、动作条数不同是常态，不用对齐。
2，接口目录里写什么都不会让现场多出一个能执行的动作。能执行哪些永远只由现场自己的清单说了算，云端那份只是给模型看的说明文字。这条边界是刻意的：否则云端一旦出事，等于全网现场任意操作可调。
3，计划任务的门禁类动作不从这里下发。它走的是另一套通道，从接口目录发过去会变成一条到点没人执行的死条目；遇到这种会明确拒绝并指路。
4，手机端不提供导出，请在管理台做。
四、维护脚本草稿：AI 起草，管理员发布
是什么
维护通道是客户机开机时自动执行一段脚本的机制（新建计算机时默认开启，见 快速安装 的「新建计算机 · 维护通道」）。想让机器开机自动干件事——清临时文件、调某个服务、补个补丁——就得改这段脚本。
过去这件事只有会写批处理的人干得了。 现在可以在智能对话里直接提需求（例如「开机自动清一下临时目录」），助手会先问清四件事：做什么、对哪些机器、哪个模式、要不要重启，然后生成 run.bat 草稿并自动做安全风险分级。
AI 只能起草，没有发布权限
生成与发布强制分离。助手产出的永远只是草稿，发布与回滚只能由管理员在控制台上完成，并记录操作人。
在哪里操作
管理台 →「维护脚本草稿」页（与「智能排障」同属默认隐藏的「智能体」分组，见第二节的提醒）。
页面从上到下三段：目标模板 / 模式 → 草稿列表 → 草稿详情。
1，先在顶部选好模板与模式。没选会提示「请先选择模板和模式」——发布、回滚、以及看详情时补取现行脚本，全都以这里选定的「模板 + 模式」为准。
2，点「刷新草稿」拉取草稿列表。列表列出时间、意图、风险级别、状态。
3，点某条草稿的「查看」，进详情：上方是风险报告，下方是脚本对比——现行脚本与草稿逐行对照，新增和删除分色标出。
4，逐行核完再点「发布」。命中高危规则的草稿会再弹一层确认，把扫描命中的条目逐条列出来，确认后才能「强制发布」。
5，发布后发现不对，点顶部「回滚脚本」，把所选「模板 + 模式」的维护脚本回到上一版本。
参数与取值
| 项 | 取值 | 说明 |
|---|---|---|
| 模板 | 已有的维护通道模板 | 必选，无默认值 |
| 模式 | 只读（ro）/ 更新（update）/ 学习（learn） | 必选，无默认值；发布与回滚都只作用于所选这一组 |
| 风险级别 | 高 / 中 / 低 | 由发布前的静态扫描判定，不用手填 |
静态安全检查的口径：
| 这类命令 | 处理 |
|---|---|
| 格式化磁盘、删除系统目录、改引导等 | 默认拦截，必须显式「强制发布」才放行 |
| 关机、结束进程等 | 放行，但在风险报告里标出来 |
发布时到底动了什么
1，只替换开机脚本。原脚本包里除脚本以外的文件全部原样保留。
2，旧包整包归档，归档位置会一并告知，这也是回滚的依据。
3，沿用维护通道既有的版本递增与客户机通知机制，客户端行为完全不变——不需要动终端、不需要重出客户端。
边界与坑
1，静态检查是规则黑名单，穷不尽所有危险写法。 它挡得住常见的几类，挡不住所有的。发布前人工审读仍然是必要环节，这也是页面上摆着逐行对比的原因。
2，只写批处理脚本。约定不涉及需要编译的程序。脚本本身按幂等标记、中文编码、带时间戳日志、重启留出时间这几条规矩写。
3，回滚只回上一版。这是「回到上一次归档」，不是任意版本任选。
4，从启动界面进学习模式的那一次开机会跳过一次维护通道，脚本当次不执行——这是有意为之，避免维护脚本污染学习采集。排查「脚本怎么没跑」时先想到这条。
5，发布与回滚都要求有效的管理员登录态，并记录操作人；经助手发起回滚属高危档，一律先弹待确认卡片。
6，本页与「智能排障」「技能库」、小程序问答共用同一个 AI 功能开关。开关关掉时，这几处会统一提示功能已关闭。
五、AI 分析服务配置：视频巡检节点
是什么
教室摄像头的画面分析（当前人数、开机数、有没有烟、当前课程这类巡检结论，以及在线督导的 AI 分析）不是管理服务自己算的，而是交给另外装的 AI 分析节点去算。这一页就是把这些节点登记进来。节点没登记，巡检看板和大屏上的 AI 区域就没有结果。
结果在哪看：控制台侧见 自动运维大屏（下方 AI 巡检区域），手机侧见 如何用小程序管云桌面 的巡检看板。
在哪里操作
管理台 → 其他 → 系统配置 →「AI 分析服务配置」卡片（在该页最上面一张卡）。
一台节点一张小卡，卡片右上角是「启用」开关与「删除」。
| 字段 | 必填 | 说明 |
|---|---|---|
| AI 服务 IP | 是 | 分析节点的地址 |
| 端口 | 是 | 整数，范围 1～65535 |
| 备注 | 否 | 给人看的标识，例如「GPU-01 / 教学楼 A 节点」 |
| 启用 | — | 开 / 关。只有启用的节点参与分配 |
1，点「新增一台」加一张卡，填 IP 与端口，需要时写备注。
2，把「启用」打开。
3，点「保存 AI 配置」。填错端口会提示「AI 服务端口必须在 1 到 65535 之间」；一台都不留会提示「请至少配置一台 AI 服务」。
4，改错了不想存，点「重置」重新读回服务器上的那一份。
支持多台，按可用节点轮询
后台 AI 巡检任务会按可用节点轮询分配，单路预览也按启用节点轮询。教室多、算力吃紧时加机器就行，不需要改别的配置。
边界与坑
1，这里配的不是对话模型。 它只服务于视频巡检与督导分析，与 AI 助手的问答用量、点数余额毫无关系——助手的模型由云端下发，现场配不了，也不在这一页。
2，巡检结果依赖教室里已纳管的摄像头。 纳管方式见 增加监控设备，纳管时「所属分组」要选到与云桌面相同的子节点，选在主节点上按分组过滤就找不到这台摄像机。
3，分析节点与管理服务之间走的是内网回传通道。 部署时不要把管理服务直接暴露到不受信网络。
4，节点填了地址不代表它真的在跑。看板上长期没结果时，先确认那台节点的服务本身是否正常。
六、AI 教学库（智能体分组）：另一条链路
先说清楚：它跟排障助手没有关系
「AI 教学库」是更早期的一组页面，用的是现场本机的 Qwen 那套参数；排障助手的模型由云端下发，检索的是第二节的技能库与知识目录，不查这里的知识库、不走 RAG 问答。两者是彼此独立的两条链路，排查助手的问题时不要往这边找。
这一组页面挂在「智能体」（旧称 AI 教学）分组下，当前版本默认不在左侧菜单显示，菜单是否露出属产品开关，并需要对应功能权限。
| 页面 | 做什么 |
|---|---|
| 知识库管理 | 上传文档、看解析进度、部署上线 / 下线、删除文档；顶部有总文档数、已完成、处理中、知识块总数四个统计 |
| 手动添加知识 | 不传文件，直接填标题、分类、标签、正文入库；保存前可预览，预览里会给出字符数与预计分块数 |
| 模型训练 | 建训练任务并启停，看任务的进度、Epoch、Loss |
| Qwen 配置 | 填本机大模型服务的连接参数 |
| RAG 问答测试 | 拿知识库试问答，可调检索数量（检索最相似的前 N 个文档块） |
| AI 标记配置 | 给 AI 生成的回答加隐藏标记 |
| AI 标记检测 | 粘一段文本，检测里面有没有这个隐藏标记 |
知识库文档的状态
文档不是传上去就能用，要走完一条处理链才算好：
| 状态 | 含义 |
|---|---|
| 上传中 | 文件还在传 |
| 解析中 | 正在读文档内容 |
| 分块中 | 正在切成知识块 |
| 向量化中 | 正在做向量 |
| 已完成 | 可用 |
| 失败 | 需要重来 |
「已完成」还不等于能问
文档处理完之后，还要在知识库管理页点一次「部署上线」，RAG 问答才检索得到。页面上用「已部署 / 未部署」标出当前状态，也可以「下线」。
训练类型
| 类型 | 页面上的标注 | 适用场景 |
|---|---|---|
| Prompt 教学 | 已实现 | 临时问答、知识问答；不改模型，只让它「记住」上下文或知识库。这一档已经由知识库那套 RAG 实现，页面会直接指路到知识库管理 |
| LoRA 微调 | 推荐使用 | 让模型学会风格、术语、语气、知识；加一层轻量参数适配层，模型文件只有几百 MB |
| 全参数微调 | 需要 GPU | 训练专属模型、重知识内容；真正改动所有参数 |
| 继续预训练 | 需要多 GPU | 只喂原始书本文本、不带问答格式，让模型「吸收」整套知识体系 |
可填的配置项有任务名称、基础模型、输出模型、训练轮次、批次大小、学习率、GPU 设备。
全参数微调对硬件要求很高
页面上明确写着：需要强大的 GPU 资源（建议 24GB 以上显存），训练时间从数小时到数天。没有这个条件请用 LoRA 微调。
Qwen 配置的四项
| 字段 | 说明 |
|---|---|
| API 地址 | 本机大模型服务（Ollama）的地址，默认端口 11434 |
| 模型名称 | 例如 qwen2.5:7b 或 qwen2.5:14b |
| Embedding 模型 | 用于文本向量化，页面推荐 nomic-embed-text |
| 超时时间 | API 请求超时，单位毫秒，默认 60 秒 |
页面上附了一份快速部署指南（装 Ollama → 拉模型 → 启服务 → 填表保存）。配置前请先确认本机的 Ollama 服务已正常运行，否则保存了也用不了。
AI 生成标记
给 RAG 问答的回答自动打一个肉眼看不见的标记，之后可以用「AI 标记检测」页验回来，用于内容审核、版权标注、区分人工与 AI 回答。
| 标记方式 | 特点 |
|---|---|
| HTML 注释标记 | 加在回答开头。在源码里看得见，显示时看不见——可溯源 |
| 零宽字符标记 | 加在回答结尾。完全不可见，即使在源码里也难发现——纯隐藏 |
标记文本默认是「澄成AI生成」，可自定义。两种方式可以单开也可以同时开（页面推荐同时开，双重保障）；总开关关掉后 AI 回答不加任何标记。保存后立即生效。
检测页粘进一段文本点「检测标记」，会给出：是否 AI 生成、HTML 注释标记找不找到、零宽字符标记找不找到、标记在第几个字符处、原始长度与去掉标记后的长度，以及清除标记后的正文。
经助手发起时的分档
知识库上传文档、新建训练任务这类属写入档，会先弹待确认卡片；删除知识库文档属高危档，同样要点确认。你在页面上手动操作不受影响。
七、AI 网关令牌与定价（服务商侧）
云端还有一处维护网关令牌与各模型单价的地方，由现场管理服务同域代理到云中转服务。这是服务商侧的活，现场管理员一般用不到，管理台左侧也没有对应入口。
放在这里只为说明一件事：助手各模型的点数单价按上游实际报价标定，不在现场配置。 现场能看到的只有余额、账单流水与套餐，见 如何使用 AI 助手 的「点数、充值与发票」。
别和「AI网关」菜单搞混
控制台左侧那个 AI网关 顶级菜单是另一回事——它是装在本机、供云桌面里的 AI 教学与开发环境调用的网关，用户与分组直接取自个人网盘的账号。它跟本节说的服务商侧令牌定价、跟 AI 助手的点数，都不是同一套东西。
八、配套阅读
- 如何使用 AI 助手（技能 · 我的功能） —— 怎么问、待确认卡片、记忆、点数与充值
- 快速安装 —— 「新建计算机 · 维护通道」一节，维护通道的开关与模板
- 自动运维大屏 —— AI 巡检结果在控制台侧的呈现
- 增加监控设备 —— 摄像头纳管与所属分组的选法
- 如何用小程序管云桌面 —— 手机侧的巡检看板与抓拍图
- 桌面云平台检测工具 —— 与助手排障的分工