语匠 VoiceCraft · 帮助中心
这一页把整套系统的用法从"我要做一件事"讲到"该点哪个按钮"：新用户按三分钟上手走一遍就能出片； 老用户用左侧目录或顶栏搜索直接跳到那一页、那一个区域；管理员与运维看配置要点、部署形态和故障排查。 右上角的开关灯与平台共用同一个偏好——你在平台里切到"黑暗"，这里就是黑暗；在这里切了，回平台也带着走。
系统入口
一个地址
平台首页即整套系统，登录后所有功能都在左侧菜单里
说明覆盖
26 页逐页
步骤 · 区域 · 约束 · 可见范围，与界面按钮一一对应
角色
4 档
未登录 · 普通用户 · 管理员 · 超级管理员
数字口径
不抄字面量
量程与上限由平台随界面下发，本页只写"由谁下发"
快照
2026-10-09
对应生产 release 20261008-131335-393451
01
三分钟上手
先出一声，再谈参数2
挑一条音色
左侧 TTS任务管理 › 新建合成任务 里，先在音色选择器用"分类"或"关键字"收窄，点生成试听听一条。不知道哪条好，就去 音色模型管理 › 评价参考 看大家的口碑。详见音色列表。
3
贴文本，出第一条
把要合成的文字贴进"待合成文本"，其余参数先别动——预设里已经配好了这套音色的最优区间。点试听听，满意了点提交任务。详见新建合成任务。
4
取成品
左侧 任务列表 里等状态灯从"排队/合成中"变成"成功"，行末点下载或试听。列表会写明这条任务由哪台节点产出、纯推理耗时多少。详见任务列表。
三条常见误解，先在这里拆掉：
① "简易模式"是把进阶参数收起来，不是把它们禁掉——切到专业就都在（专业模式需管理员开通）；
② 参数拖出这条音色的最优区间时只提示不拦你，改不改由你判断；
③ 评分不参与排程、审核和可见性，它只是一份参考读数。
02
一条声音是怎么造出来的
看懂这条链，界面就不神秘03
开关灯与界面偏好
三件事各自独立，别混成一个概念显示开关灯：明 / 暗 / 跟随系统
顶栏「显示」三个按钮：明亮、黑暗、跟随系统。这是外观，任何人随时可切，只影响你自己，不影响别人看到的东西。
选跟随系统时，界面跟着操作系统的深浅色偏好走——系统换模式，页面立刻跟着换，不用刷新。
本帮助中心与平台共用同一份偏好：同一个浏览器里，平台切到黑暗，这里打开就是黑暗；反过来也一样。偏好存在这台浏览器的 tts.ui.theme 里，同时跟着你的账号保存，换机器登录还是你原来那套。
一个诚实的边界：帮助中心是静态页，它改的是这台浏览器上的偏好；如果你随后在平台里也切了一次，以最后一次在平台里的操作为准（那一次才会写进账号）。
模式简易 / 专业：界面密度，不是权限
简易把进阶参数收起来，页面只留你天天用的那几个；专业把它们摊开。收起来不等于禁用——值还在，仍然生效。
能不能进专业模式由账号上的一个许可位决定（管理员在用户管理里开）。没有权限时点了不切，并且会告诉你找谁开通——按了没反应又不说原因，就是静默失效。
简易模式顶部有一条横幅，写明本次藏了几项、哪些值仍偏离默认，避免"看不见 = 以为没设"。
说明右侧说明栏：边操作边看
每个功能页右侧有一条竖标签「使用说明」，点开是这一页的一句话摘要、可见范围，以及「打开完整说明」——它在新标签里打开本帮助中心，并自动停在这一页的位置。
长说明、逐区域解释、约束清单都在这里（帮助中心），右侧栏只留"够不够我用"的那一句。两边内容不再各写一份，所以不会出现界面改了说明没改的情况。
04
谁能看到什么
角色决定页面，许可位决定个别入口四个角色是逐级包含的：管理员拥有普通用户的一切，超级管理员拥有管理员的一切。只有两处例外用许可位而不是角色：接入指南（超管逐人发放）与专业模式（管理员开通）。
| 功能页 | 普通用户 | 管理员 | 超级管理员 | 说明 |
|---|---|---|---|---|
| 新建合成任务 | ✓ | ✓ | ✓ | 主链路永不下架 |
| 任务列表 | ✓ | ✓ | ✓ | 自己的任务全可见；全量视图按角色放开 |
| 配音工作台 | ✓ | ✓ | ✓ | 字幕多角色配音 |
| 剪辑工作台 | ✓ | ✓ | ✓ | 非破坏剪辑，版本可回退 |
| 素材切片与审阅 | ✓ | ✓ | ✓ | 切片与审阅队列 |
| 音色列表 | ✓ | ✓ | ✓ | 上传人人可；过审才能用于生成 |
| 音色审核 | — | ✓ | ✓ | 过审 / 驳回并写原因 |
| 评价参考 | ✓ | ✓ | ✓ | 只读榜，全角色可评可看 |
| 读法替换 | ✓ | ✓ | ✓ | 个人作用域读法；公共规则需管理员 |
| 预设库 | ✓ | ✓ | ✓ | 私有预设人人有；公开要申请审核 |
| 素材库 | ✓ | ✓ | ✓ | 共享范围由上传者与管理员定 |
| 接入指南 | 许可位 | 许可位 | ✓ | 默认仅超管；其余由超管逐人发放 |
| 监控大屏 | — | ✓ | ✓ | 集群与任务吞吐读数 |
| 用户管理 | — | ✓ | ✓ | 角色、专业模式许可位、把人绑进分组 |
| 用户分组 | — | ✓ | ✓ | 按维度收紧：可用功能 / 节点 / 音色 / 每周额度 |
| 反馈接收 | — | ✓ | ✓ | 严重问题处置台 |
| 审计日志 | — | ✓ | ✓ | 操作留痕，来源取真实 IP |
| 模型库 | — | ✓ | ✓ | 节点自动发现的模型登记 |
| 系统配置 | — | — | ✓ | NAS / 数据库 / 推理服务 / 告警 / 品牌 |
| 功能开关 | — | — | ✓ | 关掉的功能服务端按名字拒绝 |
| 更新中心 | — | — | ✓ | 升级包与发布台账 |
| 个人中心 | ✓ | ✓ | ✓ | 改密、界面偏好 |
"整页下架"与"页内少一块"是两回事：超管关掉一个功能时，作为它入口的那一页会落到功能未开放页并点名是哪个开关；
但新建任务 / 任务列表 / 音色列表 / 模型库这四页永不下架——它们身上挂的是批量清单、导出、试听样本这类子能力开关，关掉只是页面里少一块，把工作台整个收掉不叫门禁。
05
逐页说明
26 页 · 与左侧菜单同序 · 每页给"步骤 / 区域 / 约束 / 可见范围"下面每一块对应界面上的一个页面，标题右侧是它在系统里的地址与「打开这一页 ↗」。 从平台的右侧说明栏点「打开完整说明」进来时，会直接停在你刚才那一页的位置。
TTS 任务管理
新建合成任务/task/new打开这一页 ↗
写文本、挑音色、调参数，出一条能直接试听的多角色合成任务。
使用步骤（照着走一遍）
- 在「01 待合成文本」里贴入文本；需要多角色时用【角色名】内容 的写法标出说话人，需要停顿/语气/强调就插入示例标记。
- 在「02 音色与参数」选预设或直接选模型与音色；音色多时先用选择器上方的关键字、分类、我的收藏三个筛子收窄。
- 拖语速、音调、音量、停顿与音效旋钮；拖出这条音色的最优区间时，旋钮下方会出现一条"建议"提示，只提示不锁参数。
- 需要情绪就在「03 情感模式」选全局语气，或切到情感参考音频 / 风格指令两种方式之一。
- 要垫乐就在「04 背景音乐」挑素材库里的音频素材并选播放方式。
- 点「试听」听一条；勾选「调参实时预览」后每改一个参数会自动重出一版；改完点「提交任务」或「保存为预设」。
逐区域功能说明
- 顶栏三个开关
- 「明亮 / 黑暗」换配色；「简易 / 专业」决定这一页摆出多少参数——简易模式下进阶参数是不显示（不是灰着一排），顶部横幅会写明本次藏了几项、哪些值仍偏离默认；超级管理员的顶栏还会多出「实时日志面板 开 / 关」，关掉后底部日志控制台连同它的轮询一起撤掉，监控大屏不受影响。
- 逐句表格
- 文本按句拆开后列出序号、文本、引擎文本、角色、段前停顿、字符数、预估时长与告警，切分是否合意在这里直接看。
- 音色选择器
- 只列"可用"的音色（已启用且已过审）；下方计数写明当前可选多少条、被筛掉多少条；已经选中的那条即使不匹配筛选也会留在列表里，不会被筛没。
- 引擎 / 能力位
- 显示这条音色落在哪个引擎上、该引擎开了哪些能力位；不支持的参数不会出现在表单里。
- 最优区间提示
- 语速、音调、音量、强调、情感强度、音效混响等都有"这条音色不变形的区间"，超出就提示文字与推荐区间；提示来自音色的最优区间设置，未单独设置时用全局默认区间。
- 情感模式
- 全局语气下拉 + emotion_mode + 情感参考音频（NAS 相对路径）+ 风格指令，四者按引擎能力显示。
- 背景音乐
- 从素材库里选音频素材（material_id）并选播放方式，只影响混音不影响合成。面板里的「标签需求」（分类/标签全含或任一/时长档/许可）在服务端筛候选并写明命中数；这几项只筛清单，不会进提交参数，产物仍然只由你选中的那条素材与增益决定。
- 05 试听回放 / 06 调参参照曲线
- 回放区给这一版的音频与读数；参照曲线把基线时长和当前参数时长画在同一条时间轴上，读数写明"重渲染耗时 / 包络点数 / 未重新推理"。
- 08 本次已提交
- 本页面内提交成功的任务回执，含任务号与排队读数，点任务号可跳到任务列表。
约束与注意（不做就会踩）
- 所有量程、上限、分段字数都来自 /tts/param_spec，不在前端写死；填了非法值时提交按钮下方会点名是哪一项、为什么、该怎么改。
- 文本超过引擎单次分段上限时不会报错，但会提示"引擎会做二次切分"，逐句表格里能看出切在哪。
- 多角色脚本里任何一个角色没配到音色，后端会拒绝整次提交，页面会先把这些角色名标红列出。
- 「保存为预设」只保存参数与音色编码，不保存你的私有路径与他人素材；预设要给别人用得走预设库的公开申请。
- 调参实时预览会连续发重渲染请求，参数还没想好时先关掉。
可见范围：全部登录用户
任务列表/task/list打开这一页 ↗
查所有合成任务的状态、试听产物、下载与导出，并在原产物上直接改参数重渲染。
使用步骤（照着走一遍）
- 用状态筛选（全部状态/等待/处理中/成功/失败）与关键字（任务 UUID / 文本 / 预设名 / 提交人）定位任务，点「搜索」；筛选生效时可「清除筛选」。
- 管理员可勾「查看全部用户任务」并按提交人筛，此时表里多出一列提交人。
- 点行上「详情」看参数、分轨与派生剪辑；成功行可直接试听与「下载」，需要别的容器或音质用「导出」下拉。
- 要改参数不出新音色：点「调参」在抽屉里拖语速/音调/音量/停顿与音效，或改分角色音色，点「重渲染并试听」。
- 要按字幕继续加工：用详情里的「按字幕配音」或「去剪辑」跳到对应工作台，任务号会自动带过去。
- 觉得这次生成效果好或差：点成功行末的「评价」，拖滑块或点星给这一条打分；分数低时同一弹窗会展开写问题反馈的地方。
逐区域功能说明
- 列表列
- 任务 UUID、文本摘要、音色（多角色会标出分轨数）、模型（带预设名标签）、状态（排队时标"节点满载排队中"）、创建时间、耗时、服务节点、试听、操作。
- 导出下拉
- 按"格式 · 音质档"列出当前可用的组合；不适用的档位是灰的，鼠标停留给后端原话原因。
- 字幕下拉
- SRT / ASS 两种字幕；该任务没有时间轴时按钮禁用并写明原因。
- 详情抽屉
- 混合总轨试听、分角色音轨逐条单独下载、字幕下载、派生剪辑列表（每版可单独导出）、原始文本、完整参数、错误信息，以及重渲染 / 下载 / 导出 / 重试 / 去剪辑 / 按字幕配音的入口。
- 调参重渲染
- 只跑 DSP 与混音、不重新推理，所以秒级出结果；分角色音色可以在这里逐条换。
- 评价
- 成功行的操作列有「评价」：一个弹窗里给"本次生成 / 这个音色 / 这个模型 / 音色×模型"四个口径分别打分（10 分制与 5 星是同一个数），只提交你动过的那几项。按钮上写的数字就是你自己那一票。
- 问题反馈
- 评分弹窗里分数落到不满意那一档会自动展开"写一条给管理员"：严重度、类别、现象描述。归属（音色/模型/节点）由服务端从这条任务上取，不用你填。
- 重试
- 仅失败任务可用，按原参数重新入队。
- 队列读数
- 工具条下方一行写明各状态在途数量，来自队列状态接口。
约束与注意（不做就会踩）
- 「调参」「下载」「导出」「字幕」「评价」都只对成功任务开放，其余行是灰的；「评价」灰按钮的悬浮原因写的是"只有已完成的生成可以打分"。
- 打分不会改变任何东西的去留：评分不参与排程、不影响审核，也不会让音色下架；要东西被改就写问题反馈。
- 一人对一个目标只有一票：再点「评价」提交是改分，不会攒成两条，均分里的条数也不会因此变多。
- 重渲染要求每个角色都有音色，缺任何一条会被挡下并说明缺哪条。
- 列表默认只看自己的任务；管理员勾"查看全部用户任务"后才能看到别人的，导出与下载仍按数据可见范围给。
- 页面每 2.5 秒静默刷新一次状态；刷新失败时保留上一次数据，不会闪成空表。
- 关键字只取前 120 字，分页档位与上限由后端裁剪。
可见范围：全部登录用户；「查看全部用户任务」与提交人筛选仅管理员
配音工作台/task/dub打开这一页 ↗
两条配音路径：多角色按标记分声，或者拿一份 SRT 让每条字幕贴着原时间轴走。
使用步骤（照着走一遍）
- 顶部切模式：「按标记多角色」或「按字幕时间轴」。
- 标记模式：在「角色表」逐行填角色名并配音色（可展开该行单独设语速与情感），点「添加角色」；在「脚本」卡贴【角色名】内容，选默认音色，先「解析预览」确认切分，再「提交多角色任务」。
- 字幕模式：在「字幕来源」上传 .srt/.txt 或直接粘贴内容，核对 cue 表的入点/出点/目标时长；在「贴合参数」勾选是否先裁首尾静音并拖两端保留、最大变速、时长系数，选默认音色后「提交配音任务」。
- 提交后看「提交回执」与「产物」：成功后试听，并「下载新 SRT」或「下载 ASS」拿回填好时间轴的字幕。
逐区域功能说明
- 角色表
- 一行一个说话人：角色名、该角色音色、试听、语速/情感折叠、移除；顶部计数写"角色 N/上限"。
- 解析预览
- 提交前先看后端怎么切：序号、角色、朗读文本、字符数、预估时长一张表。
- 字幕来源
- 文件或文本两条入口，解析成 cue 表列出 # / 入点 / 出点 / 目标时长 / 内容。
- 贴合参数
- 先裁首尾静音、两端保留、最大变速、时长系数——这一组决定每条字幕是变速贴轴还是留白，量程来自参数读数。
- 逐条报告
- 产物卡里列出每条字幕的 target / raw / trimmed / speed / pad / 是否截断，配音对不上轴时看这里。
- 时间轴
- start_ms 由已落盘 clip 的真实时长累加，不是按字数估算。
约束与注意（不做就会踩）
- 角色名填了但没配音色会被红条点名，后端拒绝整次提交。
- 标记模式必须有脚本与默认音色；字幕模式必须至少解析出 1 条 cue 且选好默认音色。
- 贴合参数超范围会返回 400 并写明原因；参数读数取不到时滑块显示的是契约参考值，页面会提示当前处于兜底状态。
- 下载字幕要先有任务号；没有时间轴或缺 ffmpeg 时后端给中文原因，页面原样显示。
- 切换模式会停止上一模式的轮询，避免两个任务同时抢进度显示。
可见范围：全部登录用户
读法替换/pron打开这一页 ↗
把容易读错的字词预先改写成正确读法，提交合成时自动生效，还能在这里先试跑看命中。
使用步骤（照着走一遍）
- 顶部切作用域：「个人词典」只影响你自己的任务，「全局词典」影响所有人（仅管理员可切）。
- 在「就地新增」填"要替换的字"，选模式（同音字替换 / 注音），填"朗读为"，可选地限定引擎与写备注，点「添加」。
- 在规则表里逐条启用或停用，不需要就删除（会确认）。
- 到「只读试跑」贴一句含多音字或专有名词的文本，选音色（或先选模型），点「试跑」，看命中数与逐段的"原文 → 朗读文本"。
逐区域功能说明
- 作用域与条数
- 工具条上的计数写明当前词典已用多少条、上限多少，接近上限会变警示色。
- 两种模式
- 同音字替换是换字；注音是写成"字|拼音"的形式给引擎读。注音模式要求所选引擎支持，不支持时选项是灰的。
- 限定引擎
- 不选＝对所有引擎生效；选了就只在指定引擎上改写，避免同一条规则在别的引擎上读坏。
- 试跑
- 只改写不落库。给出命中条数、词典是否生效、改写了几段，以及逐段对照表。
约束与注意（不做就会踩）
- 全局词典仅管理员可改；普通用户切不到那个页签。
- "要替换的字"必填且长度有限；注音模式必须有"朗读为"内容；替换留空表示删掉该串。
- 试跑必须有文本；选了音色时模型下拉会被锁定，因为引擎由音色决定。
- 规则上限按账号计，个人与全局各自受限；删掉规则后该处恢复原文读法。
可见范围：全部登录用户；「全局词典」仅管理员
接入指南/api-guide打开这一页 ↗
把平台当 API 用的人看这一页：接入地址、端点清单、可直接复制的 curl 配方与参数取值范围。端点清单由服务端给出，默认只有超级管理员看得到——普通账号看到的是「未开放」说明，不是空白页。
使用步骤（照着走一遍）
- 若这一页显示「未对你的账号开放」，按横幅里的口径找超级管理员，在「用户与权限 › 接入许可」中开通；没开通不影响你正常提交任务。
- 先看「接入地址」：内网基址加版本前缀，点「复制」拿走。
- 照「可直接复制的 curl 模板」从①口令换令牌开始，按编号往下做：提交、查状态、取产物、批量与拼接各有配方。
- 令牌一律用 <你的令牌> 占位自己替换，不要把真实凭据写进脚本仓库。
- 要看参数能填多少，查「合成参数取值范围」；要控制读法，看「文本标记语法」；跨引擎前先对「引擎能力差异」。
逐区域功能说明
- 端点一览
- 逐条列出登录、提交、查任务、队列状态、音色列表、签名下载地址、导出、批量预览/提交/拼接的用途；这份清单全平台只有一份，由服务端按你这个账号的许可当场下发，页面不抄第二份，所以这一页上也不留它的地址。
- curl 配方
- 编号配方覆盖单条合成、按角色合成、字幕回填、批量与拼接，另附一段最小 Python 循环。
- 合成参数取值范围
- 直接读参数规格接口，不写死数字；改了服务端配置这里刷新即一致。
- 文本标记语法
- 语气、停顿、连读、强调、角色的写法，以及哪些标记可以段级覆盖。
- 引擎能力差异 / 导出格式
- 哪个引擎支持哪些参数、能导出什么容器与音质档。
约束与注意（不做就会踩）
- 这一页只讲怎么接，不替你保管令牌：页面不读取也不显示当前会话的令牌。
- 许可分两层：入口按账号的「接入许可」显隐，端点清单在服务端另有一道闸——只藏导航不等于拿到了数据。
- 「重新拉取」按需取参数读数；取不到时页面会显示错误态而不是留空白。
- 复制到剪贴板依赖安全上下文，非 https 下可能失败，页面会提示手动复制。
- 页面上所有数字都来自接口，和提交页同源；改量程请改服务端配置。
可见范围：仅超级管理员，或被超级管理员逐人开通「接入许可」的账号（含令牌签发口径）
音频加工
剪辑工作台/edit打开这一页 ↗
对一条已完成的产物做非破坏性剪辑：选区、加操作、预览、应用，每一版都另存为派生剪辑。
使用步骤（照着走一遍）
- 在「选一条已完成的产物」里搜 UUID / 文本 / 音色并选中一条成功任务（从任务列表「去剪辑」跳过来会自动选中）。
- 在波形或谱密度图上按住鼠标拖出选区（小于 10ms 视为误触自动取消），需要重来点「清除选区」。
- 在「操作栈」选操作类型（区间裁切、删除片段、淡入淡出、裁首尾静音、区间变速、峰值/响度归一、段间静音、逐条重排、单条重新合成），点「添加操作」，再在该行填参数。
- 点「预览」听这一版并看相对原产物的倍率；确认无误点「应用」，产出的版本进「派生剪辑」表，可逐条试听与导出。
逐区域功能说明
- 两块画布
- 同一时间轴的波形与谱密度，用于看清静音、削顶与高频分布；削顶会在下方给提示。
- 操作栈
- 按添加顺序串行执行；「单条重新合成」带"会回推理"徽标，其余只跑 DSP；每行的控件按操作类型渲染，逐条重排用 ◀▶ 调整分句顺序。
- 预览回执
- 写明"相对原产物 N.NN×（只跑 DSP，没回推理）"，用它判断变速是否过头。
- 应用回执
- 给出这一版的编号与出处（缓存命中还是引擎重推）。
- 派生剪辑
- 列出每版的操作序列、时长、文件、生成时间与试听；导出只走后端签名地址。
- 分句时间轴
- 有字幕时间轴时显示，逐条重排与单条重推都要靠这里的分句序号。
约束与注意（不做就会踩）
- 必须先选一条成功状态的任务，否则后面全部禁用。
- 区间类操作（裁切、删除片段、区间变速）没有选区时点「添加操作」只会弹提示，不会发请求；裁切/删除的终点必须晚于起点。
- 一次操作序列有条数上限，超出会被挡下；未知操作名在前端就会被拦，不会发给后端。
- 「单条重新合成」需要填分句序号（如 1,3）并选新音色，这一条会真的回推理，耗时比 DSP 长。
- 逐条重排在任务没有时间轴时没有可排的分句，页面会直接说明。
可见范围：全部登录用户
素材切片与审阅/clips打开这一页 ↗
把长素材切成一句一条，边听边写文本并标通过/退回，合格的切片直接登记成参考音色送审。
使用步骤（照着走一遍）
- 「素材来源」选一个音频文件，点「执行切片」。
- 在「切片参数」拖最短静音、静音阈值、最短保留、最长保留、段首尾留静音、段尾淡出，回显区会列出后端实际采用的参数与提醒。
- 在「切片结果」逐条试听，勾朝那些要留的，点「加入审阅清单（N）」。
- 在「审阅清单」里补/改每条的文本并「保存」，然后标「通过」或「退回」（退回必须写原因），用「上一条/下一条」连续处理。
- 要做成音色：在「录制参考音频」录一段（或直接用某条切片），填音色编码、显示名、引擎、模型 id、参考文本与授权路径，点「登记并送准入」。
逐区域功能说明
- 切片参数滑块组
- 六个滑块决定切点的松紧；量程优先取参数读数接口，取不到时显示契约参考值并注明。
- 切片结果表
- 多选框、序号、相对路径、时长、峰值 dBFS（过响接近 0 的会标红）、试听、单条加入。
- 审阅清单
- 支持按切片顺序/倒序、时长、峰值、未审阅优先、最近更新排序，按状态与关键字筛，分页浏览；文本列就地编辑。
- 状态与备注
- 通过 / 退回 / 重置三个动作加一个退回原因输入框；删除按钮文案是「只删记录」，确认框里明说不删音频文件。
- 录制参考音频
- 开始/停止录音，录完可「用这段做切片素材」；下方是登记音色的完整表单。
- 准入读数
- 送审后显示 ok / warn / reject 面板，逐项列出 reasons、issues 与说明，让上传者先自己改再找管理员。
约束与注意（不做就会踩）
- 素材大小与格式受后端限制：坏输入会按"空文件 / 超限 / 不是音频"三类给原话，不会只报"失败"。
- 最短保留大于最长保留会被前端直接挡下。
- 一次加入审阅清单有条数上限；文本保存不能为空。
- 音色编码有格式要求（小写开头，允许数字与 - _），引擎必须在启用清单里，参考文本有长度范围，授权路径不许写绝对路径或 ..。
- 「登记并送准入」需要管理员；普通用户到这里能切片与审阅，但不能自行把切片变成可用音色，需走「上传我的音色」+ 管理员审核。
- 录音依赖浏览器麦克风权限，只在 https 或 http://localhost 下可用，失败原因原话回显。
可见范围：全部登录用户；「登记并送准入」仅管理员
音色与模型
音色列表/voice打开这一页 ↗
找音色、听音色、标音色：一条音色能不能用由管理员定，怎么排序和标星由你自己的账号定。
使用步骤（照着走一遍）
- 用筛选条收窄：关键字、分类、标签（多选后可选"全含/任一"）、引擎、审核状态、我的（收藏/仅我上传）、排序键与升降序；改动即向服务端要第一页，条数读数写明"已按 N 个条件筛出 M 条"。
- 点行首「+」展开看编码、参考音频路径、参考文本、授权、上传者、最优区间是否被单独覆盖、审核意见与你的个人标记。
- 点星形按钮收藏；点「我的标记」写个人备注、加个人标签——这些只存在你自己账号下。
- 要听效果就点「生成试听」，成功后行内出现播放器；音色可用时才能试听。
- 用过这个音色就点行末「评价」给它打一分（10 分制拖滑块或点星）；名称下面那行「口碑」是大家的均分与条数。
- 普通用户点「上传我的音色」交参考音频；管理员另有「新增音色」「分类字典」「导入音色包」与「去审核」入口。
逐区域功能说明
- 筛选条
- 分类、标签、引擎三个下拉的候选与计数都来自音色读数接口；审核状态仅管理员可见，排序键与默认值也从读数下发。
- 列表列
- 收藏星、名称（带 voice_id、"标"角标，和一行口碑：星级 + 平均分 + 条数）、分类、标签（超过三个折叠成 +N）、状态、所属模型、试听、操作。
- 状态
- 把审核状态与启用状态合成一个可读结论：待审核、已驳回、可用、已停用；驳回原因在展开行里。
- 我的标记
- 收藏、备注、个人标签三项；同一音色别人的标记你看不见，你的标记也不影响别人。
- 评价
- 音色自己的一票：一人一条，再提交是改分。它只是给后来的人做参考，不改变这条音色能不能用、谁能看到它。
- 编辑分类（管理员）
- 改公共分类、公共标签，并按参数逐项设置这条音色的最优区间与说明；留空即用全局默认，可一键恢复。
- 分类字典（管理员）
- 维护分类名称、描述、排序与是否启用；分类下还挂着音色时不能删，只能停用。
- 导入音色包（管理员）
- 按包批量登记，可统一指定分类与标签，回执写明包名、引擎、前缀与逐条结果。
- 试听
- 试听是异步生成的：点了先进入生成中，页面自己轮询到就绪；失败只说明这条试听没出，音色本身仍可用。
约束与注意（不做就会踩）
- 普通用户上传的音色一律停在"待审核"，过审前不出现在可生成列表里；驳回不会删你的音频，也不会删记录，原因写在展开行。
- 你对分类/标签的编辑改的是全站共享元数据；只有「我的标记」是个人作用域。
- 删除音色的文件与行是两件事：这里删的是登记，文件处置归产物保留期策略。
- 分类、标签、备注、收藏的长度与条数上限都由接口下发，超限会当场提示并指出是哪一项。
- 「口碑」显示"暂无"是没人评过，不是 0 分：新登记的音色不会因为还没人打分被读成差评。
可见范围：全部登录用户；审核状态筛选、分类字典、新增音色、导入音色包、编辑分类与删除仅管理员
评价参考/rating打开这一页 ↗
看别人给音色、模型、音色×模型组合、推理节点打的分，并在这里补上自己的一票。
使用步骤（照着走一遍）
- 切标签页：音色榜 / 模型榜 / 组合榜 / 节点榜（每个标签旁边写了它回答的是什么问题），最后一个「我的反馈」是你自己报过的问题。
- 看「口碑」列：星级与平均分是同一个读数的两种写法，后面的小数字是评价条数。
- 要看自己打了几分就看「我的评分」列；没打过显示"未评"。
- 点行末「评一下」（打过分的行是「改分」）：弹窗里拖滑块或点星，写完一句话提交，这一行的读数当场更新。
- 节点榜上面还有一排「本机已知的推理节点」：哪台还没被你评过就点「评这台」，第一票不必等生成记录。
- 想让新数字上榜就点右上「刷新」。
逐区域功能说明
- 名次
- 按平均分排；均分并列时条数多的在前，所以"一个人打的满分"不会压住"几十个人打的高分"。
- 口碑列
- 星级 + 平均分 + 条数 + 你打的那一票，四个数来自同一份服务端读数。
- 评一下 / 改分
- 一人对一个目标只有一票：再提交一次是改分，不会变成两条。
- 空榜
- 某一类还没有人评过时是空的：音色/模型/组合去「任务列表」给一条已完成的生成打分就会有第一行；节点榜上面那一排「评这台」可以直接起第一票。
- 我的反馈
- 你报过的严重问题在这里回看：展开行看全文与提交当时的归属，处置状态和管理员写的那句回复就在行上。
约束与注意（不做就会踩）
- 评分只是参考读数：它不参与排程、不影响审核、不会改变谁能看到哪个音色，打低分也不会让任何东西下架。
- 单次生成（任务）不出榜：它不是一类可选项，评它是为了给反馈。
- 分数量程（上下限、星级、留言字数）由 /rating/spec 下发，这一页不写死数字；量程一改这里的滑块与提示同步变。
- 推理节点榜的候选来自节点配置与历史任务真跑过的地址，摘掉的节点仍然在榜上，这样它出过的问题不会被抹掉。
可见范围：所有登录用户（打分与看榜都是同一套口子）
音色审核/voice/audit打开这一页 ↗
把普通用户上传的音色过审成可用，或者驳回并写清原因。
使用步骤（照着走一遍）
- 用「审核队列」下拉切换 pending / approved / rejected / 全部（每个候选带条数读数），必要时用关键字继续收窄，点「刷新」。
- 展开行看参考音频路径、参考文本、编码、模型 id、授权文件、质检读数与上次审核意见；行内直接听这条参考音频。
- 看「准入质检」列的结论（通过/提醒/不合格）与逐条原因。
- 点「通过」：选这条公开到全站可选还是仅上传者与管理员可见，确认后即置为可用，并自动排队生成试听样本。
- 点「驳回」：写驳回原因（必填，会从质检原因预填），确认后该音色保持不可用，上传者账号里能看见原因。
逐区域功能说明
- 审核队列
- 默认只列待审；条数来自接口的审核计数，全部三种状态各自独立可查。
- 准入质检
- 服务端对参考音频做的静音、削顶、时长类读数，是判断依据，不替你做决定。
- 上传者
- 用户名直接列在行上，方便驳回后知道该找谁。
- 通过时的公开范围
- 决定这条音色是否出现在所有人的可选列表里。
- 返回列表
- 审核完可回音色库，该音色的状态会同步变化。
约束与注意（不做就会踩）
- 驳回不删音频也不删记录：删掉记录就变成"我的上传凭空消失"，最难解释；文件清理另有保留期策略。
- 通过等于置为可用并投递试听样本生成，样本生成失败不影响音色可用。
- 审核动作会写审计日志，谁审的、什么时候、公开范围都会留痕。
- 质检结论只是参考：不合格也可以过，但审计里留的是你的判断。
可见范围：管理员与超级管理员
模型库/admin/models打开这一页 ↗
登记模型、上下架、把权重拉取到推理节点，看每个节点探测到什么。
使用步骤（照着走一遍）
- 点「重新探测节点」刷新节点实况，「刷新」重取模型列表。
- 点「新增模型」填模型键、显示名、引擎与能力，保存；改配置用行上「编辑」。
- 临时下架点「停用」，确认不再用就「删除」；内置模型没有删除按钮。
- 要把权重放到节点：在「拉取模型权重到推理节点」选节点，先「读取该节点」看能力，再「开始拉取」；中途可「取消作业」，结束后「清除进度」。
逐区域功能说明
- 模型表
- 模型键、显示名、引擎、能力位、启用状态与操作。
- 推理节点探测明细
- 逐节点列出可达性与看到的模型，回答"为什么这个节点不接活"。
- 拉取作业
- 进度每两秒轮询一次；作业在跑时节点/目录/文件输入会禁用，避免改一半。
- 新增/编辑模型
- 模型键有格式要求（小写字母数字开头，允许 - 与 _）；模型键与引擎登记后不可改，只能删了重建。
约束与注意（不做就会踩）
- 权重文件走节点之间直连，本平台只做登记与作业指挥，不让模型字节穿过应用。
- 单次拉取有条数上限，文件行必须是可直达的 http(s) 链接；节点目录白名单不符会被拒绝。
- 取消作业会删掉已下载的半截文件，请重跑而不是续跑。
- 仍有音色在用的模型会被挡停用，并指出是哪几口音色。
可见范围：管理员与超级管理员
预设与素材
预设库（我的 / 公共）/preset打开这一页 ↗
把调好的一组参数存下来复用：自己的随时加载，想让别人用得申请公开并过审。
使用步骤（照着走一遍）
- 在「我的预设」找到要用的行，点「加载到新建任务」，参数与音色会带着跳到新建合成任务页。
- 想把一套参数交给大家：点「申请公开」提交审核；管理员在「预设审核」页签里「通过」或「驳回」。
- 要备份或交换：点「导出 JSON」下载文件，换到别的账号或环境时用顶部「导入 JSON」。
逐区域功能说明
- 三个页签
- 我的预设 / 公共预设 / 预设审核（仅管理员）；当前页签同步在地址栏里，能直接分享给同事到同一页。
- 列表列
- ID、预设名称、音色、作者（公共页签）、描述、创建时间，以及各行动作。
- 加载到新建任务
- 把预设的参数与音色编码灌进提交页，不会覆盖你的文本。
- 导出 JSON
- 只导参数与音色编码，不带作者与私有路径。
- 申请公开 / 通过 / 驳回
- 公开要走审核；通过后出现在所有人的公共预设里。驳回可附理由，取消即撤销操作。
约束与注意（不做就会踩）
- 删除预设会连产物存储里的参数文件一起删，不可恢复，确认框里写明了这点。
- 导入只接受 .json；导入成功后新行会高亮几秒提示位置。
- 公共预设加载后仍是"参数快照"，音色下架时提交会被挡下并说明是哪一项。
- 空表时每个页签给各自的空状态提示，不是加载失败。
可见范围：全部登录用户；「预设审核」页签仅管理员
素材库/material打开这一页 ↗
按分类、标签、时长档、许可找素材并上传、改元数据、批量打标：一条素材归在哪个分类、能不能商用，由这一页写进库。
使用步骤（照着走一遍）
- 点「上传素材」：选文件后顺手把分类、标签、许可、来源地址、署名文本一起填了再提交——这几列和文件在同一个请求里入库，事后补总有一部分永远停在「未标注」。
- 用筛选条收窄：关键字、分类（可多选）、标签（可多选＋全含/任一）、时长档、许可、共享范围、「只要音频」「只看我上传」，任何一条改完立刻生效并回到第 1 页。
- 点行的「试听」就地放音（文档类素材是「打开」链接）；点「编辑元数据」改这一条的分类/标签/许可/署名/名称。
- 一批素材要统一打同一组标签：勾中行 → 右上「批量打标」→ 选追加/摘除/整表替换 → 应用，回执写明实际改动多少条。
- 管理员点「分类字典」建分类、写说明、设「只收音频」与排序，或停用旧分类。
逐区域功能说明
- 列表列
- ID、名称、分类、标签、时长（＋所属档）、许可、大小、共享范围、归属、路径、上传时间、操作。
- 筛选条的计数
- 每个下拉选项后面的数字来自服务端，口径是你看得见的那些素材，不是全库；点进去的数量和它一致。
- 时长档
- 时长由系统在入库时探测，档位是「极短/短/中/较长/长/超长」这一套区间；探不出时长的显示「未探测」，不会被说成 0 秒。档位计数只数音频素材。
- 许可
- 未标注、可商用·免署名、可商用·需署名、仅内部使用。这一列决定对外成片能不能带这条素材，改错了是合规问题不是显示问题。
- 归属与只读
- 「归属」是上传者；别人上传的素材在你这里显示「只读」，编辑与批量打标都会被服务端整批拒收。
- 分类字典
- 素材的分类必须命中字典里的启用项，所以表单的下拉没有自由输入——新分类在字典里建好，才会出现在下拉里。
约束与注意（不做就会踩）
- 格式白名单、单文件体积上限、名称长度、标签个数与长度都是服务端下发的读数，界面上写的数字就是当次生效值；超了会被整条拒收并点名原因，不做静默修剪。
- 体积上限按你进来的入口再压一档（外网比内网小），提示语里写的 MB 就是当前入口这一档。
- 「只收音频」的分类选不到文稿素材（.txt/.md/.docx/.pdf），服务端同样会拒。
- 批量打标是整批一起判：勾中的行里只要有一条不属于你，这一批一条都不会写。对话框会先把不可改的行列出来。
- 编辑元数据只写治理列，不碰文件本体与共享范围；要换格式或换可见范围，只能删了重传（id 会变）。
- 还挂着素材的分类删不掉，服务端会点名还有几条；要收起一个分类请改用「停用」。
- 删除不可恢复；正在被任务引用的素材删掉后，那些引用会失效。
- 试听与打开用的是短时效签名地址，过期后重新点一次即可；加载失败时表格会清空并提示，不保留上一次结果以免误用。
可见范围：全部登录用户；分类字典仅管理员，别人上传的素材只有本人或管理员能改
监控
监控大屏/monitor打开这一页 ↗
集群在跑什么、忙不忙、还剩多少空间，一屏看完；这一页只读，不做任何操作。
使用步骤（照着走一遍）
- 扫顶部 KPI 带：CPU 使用率、内存使用率、NAS 使用率、今日任务、进行中任务、任务成功率。
- 按 01→06 看：今日任务趋势、CPU 与内存、分核负载、推理节点分布、业务指标、硬件与 NAS。
- 想看最新数就点「立即刷新」，否则每 10 秒自动取一次。
逐区域功能说明
- CPU 与内存曲线
- 由本页自己的轮询采样画出来，约保留十几分钟；至少要两轮才成曲线。
- 推理节点分布
- 逐节点列在途与排队；一台机器上多组合并的行列成"—"，不当作一台机器计数。
- 业务指标
- 今日任务量、状态分布与耗时读数，来自业务指标接口。
- 硬件与 NAS
- 节点负载与 NAS 容量/挂载状态；状态灯"off"表示还没探到，不等于故障。
约束与注意（不做就会踩）
- 全接口都失败时页顶给一条横幅并继续重试，不会静默显示空图。
- 这一页没有写操作：改配置去「系统配置」，下架模型去「模型库」。
- 数据是采样值，不是告警系统；超阈值处理看告警配置段。
可见范围：管理员与超级管理员
用户与权限
用户管理/admin/users打开这一页 ↗
开账号、停用账号、改角色、重置密码，并逐人决定两件事：能不能切专业模式、有没有接入许可。
使用步骤（照着走一遍）
- 用关键字（用户名/昵称）与状态下拉定位，点「查询」。
- 点「新增用户」，填用户名、初始密码、昵称、部门、角色，点「创建」。
- 需要停用时点行上「禁用」（或恢复「启用」），确认即生效；密码忘了点「重置密码」输入新密码。
- 要放开专业模式：拨该行「专业模式权限」开关；要收回，确认后该账号下次切换时回到简易界面。
逐区域功能说明
- 列表列
- ID、用户名、昵称、部门、角色、状态、专业模式权限、接入许可、创建时间、操作。
- 角色
- 普通用户 / 管理员 / 超级管理员三档，权限逐级包含；新建默认普通用户。
- 专业模式权限
- 决定这个账号能不能切到专业界面；权限位与「他现在看的是哪套界面」分成两格显示，只看一格会误判另一格。
- 接入许可
- 决定这个账号能不能拿到「接入说明」的端点清单。新建账号默认没有；超级管理员本身就有，那一格显示「默认持有」而不是再给你一个开关。
- 新增用户
- 用户名与初始密码必填，密码有强度口径提示。
- 重置密码
- 直接置新密码，不要求对方原密码——这一步会留审计日志。
约束与注意（不做就会踩）
- 禁用只是登录与提交被挡，历史记录仍在；删除账号不在这一页。
- 禁用、启用、重置密码、收回专业模式、开放接入许可都要显式确认，取消即不发请求。
- 两个开关的默认方向是刻意的：权限位一律从最小开始（默认关），界面偏好按现状走（默认开）。
- 管理员账号看不到「接入许可」的可操作开关：这项许可只有超级管理员能发，按不动是设计而不是坏了。
- 收回许可或权限不影响对方已经打开的页面，下一次取数时才会拿到「未开放」的回执。
- 超级管理员账号请保持至少两个，避免只剩一个时无法自证。
- 列表按查询条件向服务端要分页，不在前端过滤全量。
可见范围：管理员与超级管理员（接入许可仅超级管理员可改）
用户分组/admin/groups打开这一页 ↗
给用户建组并按维度收紧权限：可用功能、可用推理节点、可用音色、每周字符额度、积分发放周期——白名单，只有收紧没有放宽（发放周期例外，它按积分管理页选的口径合并）。
使用步骤（照着走一遍）
- 先看列表上方三个计数：分组总数、「真收紧」几个、组内账号共几人。后两个对不上，就说明有组只是建了名字还没定规矩。
- 点「新建分组」，填名称（重名会被服务端顶回来并点名已存在的那一个），可写备注、拨启用/停用、给排序，点「创建」。此时提示会说清楚：还没有授权行，当前不收紧任何账号。
- 点行上「授权」打开抽屉，逐维度勾出这一组允许的那一圈；保存前抽屉会报「本次交回几个维度、共几行」，看清再点。
- 把人挪进组不在这一页做：去「用户管理」的行操作里绑组。这里点「成员」只是看这个组里有谁。
- 删组时如果组里还有人，必须在「转入接盘分组」与「转为不属于任何组」之间点选一个；选了接盘还要点名是哪个组。
逐区域功能说明
- 列表列
- ID、分组、备注、成员数，接着是按维度逐列展开的授权条数，再是「是否真收紧」、状态、排序、最近更新、操作（授权 / 成员 / 编辑 / 删除）。维度清单由服务端注册表随页面下发，这一页不自己发明维度。
- 授权列怎么读
- 某维显示「不收口」＝这个组在这一维一行授权都没有，组员在这一维继承全局；显示「N 条」＝这一维收了口，填进去的那 N 个就是全集。
- 是否真收紧
- 所有维度都没有授权行的组会显示「否」——建了组不等于收了口，这一格就是防止把「有名字」当成「有规矩」。
- 状态
- 停用只是不能再把人移进这个组，已有成员与已填的授权都还在。
- 授权抽屉
- 一次展示全貌、一次交回全份。额度那一维填 0 表示本组不覆盖全局额度（不是不限额），全站当前额度由页面现读显示；功能那一维里已被全局开关关掉的项会当场标出来，勾上也不可用。「积分发放周期」那一维勾的是链（每周／每月），一行都不填＝这一组跟随全局、两条链照常发；它的合并口径不在这一页定，在「积分管理」页那枚选择器上。
- 成员弹窗
- 列出这个组的账号（用户名、昵称、部门、角色、状态），可翻页。每个人实际生效的权限＝本组授权与他的个人例外取交集，额度取最小的那一个；发放周期那一维不吃交集，按全站口径合并。
约束与注意（不做就会踩）
- 白名单语义只有收紧：留空那一维是「继承全局、不收口」，不是「全禁」；一旦填了，填的就是全集。
- 保存是整份替换：这一次没交回的维度会被清空。所以抽屉拿不到维度注册表时会直接拒绝打开，而不是让你保存半份。
- 分组不能把全局关掉的能力再放开：全局功能开关说了算，组里勾了也不可用。
- 「转为不属于任何组」等于把人放宽到只受角色与全局开关约束，弹窗里就写着请确认是有意为之；想保留收口请选接盘分组，成员的收口随接盘组继续生效。
- 服务端不接受「删组即散伙、什么都不说」：有成员又没选安置方式时请求会被顶回来，弹窗显示服务端原文（点名还剩几个账号、怎么办）。
- 超级管理员不受分组收口，这是设计如此：把他挪进任何组都不会改变他的权限，成员弹窗里也会说明这一点。唯一例外是发放周期——挡的是某一条链的进账，不是门，所以那一维照样对他生效。
- 授权改动不影响对方已经打开的页面，下一次取数时才拿到新的收口结果。
可见范围：管理员与超级管理员
积分管理/admin/credit打开这一页 ↗
在这页上决定「要不要收积分、每周每月各发多少、哪几条链发、积分换算成多少钱」，再查每个账号的余额与流水、给模型定单价，并对着月产能红线判断「发出去的积分这台机跑不跑得出来」。
使用步骤（照着走一遍）
- 先落在「发放与结算」那张卡上：总开关、每周发放（开关＋人数额）、每月发放（开关＋人数额）、发放周期口径、积分换算率五格都在这一处改，改完点右上角「保存」。不用登服务器改配置文件。
- 看它下面那句「当前生效」：写的是 1 元换多少积分、换成对外口径是几元/万字。它只是把积分翻译成人能懂的钱，扣分不吃这个数。
- 先看「总览」的读数卡（余额合计、本周期已发放、本周期已消耗、全站累计消耗、本周发放总盘、本月发放总盘、模型单价条数），下面就是产能红线那一格。
- 看红线：它算的是「（周总盘 × 4.33 ＋ 月总盘）÷ 月产能」。显示「未填产能」是运维还没填月产能，这一格刻意不假装有数；填法写在格子下面那句提示里。关掉的链不占产能。
- 切「账号与发放」：按账号/姓名模糊搜、按分组筛。给多人加钱就勾上他们再点「发放积分（N 人）」，填一个正整数与可选备注。
- 要改一个人的账就用行上的「调整」：正数加、负数减，原因必填；它允许把余额调成负数，因为这是改账不是消费闸门。
- 点行上的「流水」会带着这个账号跳到流水页签；流水可按种类、周期收窄，「导出当前筛选 CSV」把筛选后的全量（不是当前页）拉下来。
- 切「模型单价」：点「登记模型单价」写 model_key 与每千字积分数，备注里写上系数是在哪儿测的。删一行等于这个模型回到全局默认价，不是改成免费。
逐区域功能说明
- 发放与结算那张卡
- 一次决定这几件事：总开关、周发放开关与量、月发放开关与量、发放周期口径、积分换算率。保存是整批的——先全部校验再全部写入，任一键越界就一个都不落库，后端会点名是哪一键。没改的键不提交，所以不会把别人刚调的值盖回去。改动作写审计日志，记的是「旧值→新值」清单而不是请求体。
- 每周发放与每月发放是两条链
- 各有一个开关、各发各的量（出厂每人每周 5,000、每月 50,000），各记各的水位，互不折算。周链会被分组与个人的收紧值再砍一刀；月链不接收紧，人人都领满额，要给某个人更多请走「按人发放」。
- 发放周期口径
- 决定「谁的两条链都发、谁只发其中一条」听谁的。账号优先：个人设过就只看个人的，分组那一行整级不再参与，个人一行都没设时分组的照常生效；分组优先方向反过来；叠加两级取并集，谁勾的都发——这是唯一一条能让个人比所属分组多一条链的路。逐人的勾法在「用户分组」与账号的「积分发放周期」维度里；两级一行都没勾＝跟随全局，两条链照常发。出厂是账号优先，而这一维新加时没有任何授权行，所以对现有部署零影响。
- 被周期挡掉的那条链
- 不发，但水位照样往前推，之后放开也不把这一期补回来——和「把那条链的开关关掉」是同一个形状。所以「先只发周、这个月过一半再改成周＋月」不会凭空印出本月的月发放。全站总盘那两格按全局口径算，是被挡掉的量的上限；真实数字看账号表逐行的「本周额度／本月额度／发放周期」。
- 关掉的那一周不补发
- 开关关掉时该周期的发放量为 0，而水位照样往前推：关掉三周再打开，只发打开那一周的一份，不会凭空印出三周的积分。
- 积分换算率
- 本轮口径是 1 元＝1,000 积分＝1,000 标称字符，配合全局单价 1,000 分/千字得到「10 元/万字」。它只影响面板上那几个「元」字读数，不参与任何扣分算式；改成别的值不动任何一单的分。
- 页头那几颗药丸
- 「我的余额」是当前登录账号自己的读数，后面跟着「/ 周」「/ 月」两截（关掉的链不显示），周期与产能占用随全站摘要刷新。全部数字都来自
/admin/credit/*，界面不自己算。 - 本周期已消耗
- 取的是消耗与退还相抵后的净额：失败退还把已用降回去，所以重试一次不会变成双倍付费。
- 本周发放总盘
- 全员都领满时的量（周发放量 × 在用账号数），实际每人还会被分组与个人的收紧值再砍一刀，所以它是上限而不是预算。本月发放总盘是月链那一格，两格分列是因为「这周发了多少」和「这个月发了多少」回答的不是一个问题。
- 账号表里的「未发放」
- 没有账户行的新账号照样出现在列表里，余额显示 0 并标「未发放」——管理员来这一页最常见的动作恰恰是给刚开的那个号发一点。
- 账号表的三列额度
- 「本周额度」「本月额度」是这个人实际能领到的量（全站总盘是上限，不是实发），低于全站默认值时标「已收紧」——被分组/个人的 scalar 维度收过口，或被发放周期挡掉了那条链，原因看下一列。「发放周期」那一格写「跟随全局」＝两级都没勾、两条链照常发，写「每周」「每月」＝只发这几条链，另一条这个周期不发也不补发。
- 要放宽怎么办
- 发放额度这一维只有收紧，界面上没有「把某个人的每周额度提到全站以上」的入口——那是设计，不是缺功能。要给某个人更多，用本页的「发放积分（按人）」或「人工调整」，那两个动作会进流水也进审计。
- 流水的种类配色
- 消耗走警示色、退还走通过色、周期发放与管理员发放、人工调整、过期清零各一档。加钱的动作分「周期发放」与「管理员发放」两种，是为了查得出这钱是谁点下去的。
- 其余口径那一格
- 全局单价、预警线、是否允许负余额、月产能、下次发放时间——这一张只读。前四项在「系统配置」里改（仅超管可进那一页），下次发放时间是两条链各自的重置时刻，只能读。
约束与注意（不做就会踩）
- 总开关关着时这一页满屏是 0，并顶着一句「积分系统未启用」。那不是坏了：此时提交任务不受任何额度约束，开关就在本页最上面那张卡上。
- 两条发放链都关掉时没有周期额度可撞，系统按「不限」放行，但账户行照样会建——积分仍然要有人发才花得出去，那时唯一的进账是「按人发放」与「人工调整」。
- 发放与调整的量程（正整数、0 不写、原因必填）由后端
NUMERIC_SPECS一处声明，界面不抄第二份；越界就在保存那一刻被点名，不会先落半份账。 - 发放只能给正整数，人数一次有上限；超了服务端会顶回来并点名，界面不替你分批。
- 人工调整必须写原因，且调整值不能为 0——这句原因会进流水，也会进审计日志。
- 同一条任务在流水里出现一负一正是正常记账（提交预扣、失败退还），不是重复扣费。
- 模型单价表出厂是空的，这是正常状态：所有模型走全局默认。没在自己节点上复测过的系数不要抄，那是假精确。
- 产能红线只在填了月产能时才计算。发出去却跑不出来的积分，最后都会变成「我的任务为什么在排队」的工单，所以这一格是这一页唯一一条物理约束。
- 导出 CSV 与每一次发放、调整、改价、改这组开关都写审计日志；导出拿到的是当前筛选的全量，受服务端行数上限约束，超限会点名而不是给你半份。
- 每人能提交多长的文本、每周能跑多少字符，是在「系统配置」与「用户分组」里定的；这一页只管钱（积分），不管那些额度。
可见范围：管理员与超级管理员（发放与结算那组数在本页可改，含发放周期的全站口径；全局单价、预警线、月产能仍只在系统配置里，仅超管可进）
积分定价/admin/credit/pricing打开这一页 ↗
把「按什么定义扣分」和「每个模型、每一档音色各值多少分」都摆在同一页上可调：公式六个旋钮、五层规则、模型×音色格值、单条与批量两种改法，以及谁改了这个价的历史。
使用步骤（照着走一遍）
- 先看「计价公式」：六个旋钮（取整方式、单条保底、单条封顶、计费字符口径、失败退还、整单取整）各带出厂值与量程。只改你动过的那几个——保存时没改的键不提交，不会把别人刚调的值盖回去。
- 切「实时试算」：填字符数、选模型、选音色，看这一单到底扣几分。四项读数（最终扣分、综合系数、计费字符、取整口径）下面是命中链，「生效」那几条才是算钱的，被压住与停用的行留着是为了回答「为什么不是这个价」。
- 切「定价规则」：五层各自的单条设置。点「单独设置一条」，先选层再选对象，写法三种（系数 / 每千字分数 / 免费）。表里「影响音色」是这一条落库后会碰到多少个音色，「单看这一格」是按 1000 字算出来的示例分。
- 切「模型 × 音色」：行是音色分组（可切按分类 / 按标签 / 按单个音色），列是模型，格值是「每 N 字扣多少分」。点任意一格，下面给出两个挂点：改这个模型行的系数，或改这一档音色组的系数。
- 切「批量与导入」：选层、勾一组目标、写一种写法，先点「预览影响面」——它给「影响多少个音色」和最多三个示例格的改前 / 改后分数，确认过才允许写入。CSV 一屏同理：可以先「校验并预览」，也可以直接下载当前整表当模板，改完回灌。
- 切「变更历史」：谁在什么时候把哪个对象从多少改成多少。可按操作人 / 对象 / 内容筛。
逐区域功能说明
- 扣分公式这一句
- 扣分 = 取整( 计费字符 × 全局基准/1000 × 模型系数 × 音色系数 )。保底与封顶夹在取整之前的金额上；全局基准本身在「系统配置」的
credit.points_per_1k_chars。 - 五层与命中顺序
- 模型链：模型 → 老表单价 → 引擎；音色链：音色自己 → 所属分类 → 标签。两条链各走一遍，命中即停，同一层里多条并列时按优先级与 ID 决定谁先看。音色链不接受「每千字分数」这种写法——两条链都能定绝对价时同一个音色就会同时有两个价。
- 「免费」与「删掉这一行」
- 不是一件事。写成「免费」是这一格收 0 分；删掉这一行是回落到下一层说话，可能更贵也可能更便宜，删除的回执里会写明回落后的那个数。
- 关掉但没删的规则
- 「参与计价」关掉等于这一行留着但不参与，价格同样落回下一层。表里的停用行不会消失，是为了让下一轮接手的人看得见这段历史。
- 系数写坏的那一格
- 规则表里的值读不出十进制时标成坏值并点名：它不参与计价，但也不会被静默忽略掉——你在这个界面上看得见它。
- 模型×音色那两张表的底色
- 只是热度提示：高于全局基准 15% 以上偏主色，低于 15% 以上偏通过色。格子里那个数才是结论，它由服务端算，界面不重算。
- 老表 tts_credit_rate
- 「模型链的第二级」那一块只读。要改每模型的每千字积分数，去积分管理的「模型单价」。两张表的「停用」语义相反，所以不并表、不在这页代改。
约束与注意（不做就会踩）
- 批量与 CSV 默认都是 dry-run：必须先看到「改前 / 改后」两个数才允许写入。改完表单任何一个字段，旧预览会当场作废——那一屏的影响面已经不是你现在这一批的了。
- CSV 任一行非法则整批一行都不写，坏行按行号点名。「跳过坏行继续」这一档故意没有：导入的是钱，40 条只改 37 条而提示「导入成功」是最难归因的那种错。
- 一次批量与一次导入的目标数有上限（超出会顶回来并点名），单文件行数同理。
- 优先级不是「谁更贵」，是同层多条并列时「谁先看」。绝大多数对象只有一条规则，留默认值即可。
- 这一页改完只影响之后的任务。已经在跑或已经结算的任务不回填——它们的扣分快照写进了流水里。
- 积分总开关在「积分管理」页最上面那张卡上：
credit.enabled=false时这一页照旧可以配好口径，但提交任务不受额度约束，格值只是读数不是真扣。换算率（credit.points_per_yuan）也在那张卡上，它只把积分读成钱，不进这一页的任何公式。 - 每一次保存、删除、批量、导入、导出都写审计日志，包括失败的那一次。
可见范围：管理员与超级管理员（写进库的每个动作都留审计；总开关与全局基准本身仍在系统配置里）
反馈接收/admin/issues打开这一页 ↗
接收完成列表里报上来的严重问题，逐条给出处置结论，并把结论回给提问的人。
使用步骤（照着走一遍）
- 默认只看「待处理」；用状态 / 严重度 / 类别 / 关键字收窄，每个候选后面带条数读数。
- 点行首的展开箭头看全文、任务 UUID、提交当时的归属快照（音色 / 模型 / 节点）与已有处置记录。
- 点「处置」：选状态（待处理 → 已确认 → 已修复 / 已关闭 / 暂不处理），写一句为什么，保存。
- 保存后行上的状态与计数同步变化；提交人在「评价参考 → 我的反馈」那一栏里能看见你写的这句话。
逐区域功能说明
- 顶部两个计数
- 待处理条数与"特别严重且还没人处置"的条数，后者非零时标成警示色。
- 排序
- 特别严重的排在最前，其次未处置，再按提交时间倒序——最急的那条不会沉到第二页。
- 归属三列
- 音色 / 模型 / 节点是提交那一刻从任务上快照下来的，不回查任务，也不由提交人填写。
- 处置说明
- 改成任何非「待处理」的状态都必须附一句说明，否则保存不了。
约束与注意（不做就会踩）
- 这一页只收严重问题反馈，不是工单系统：满意度请走评分，这里只留"需要有人改东西"的条目。
- 归属三列可能是空的（老任务没记模型或节点），空就显示"—"，不要当成异常数据去补。
- 处置动作写审计日志：谁改的状态、什么时候、回复了多少字都留痕。
- 反馈与评分分属两张表，处理完一条反馈不会改变任何评分读数，反之也一样。
可见范围：管理员与超级管理员
审计日志/admin/audit打开这一页 ↗
谁在什么时候做了什么，以及谁在登录。只查不改。
使用步骤（照着走一遍）
- 切页签：「审计日志」看操作留痕，「登录日志」看登录成功与失败。
- 按关键字、动作、时间范围筛，点「查询」；翻页直接点分页。
- 要分享给同事定位问题时，页签选择会同步到地址栏。
逐区域功能说明
- 审计日志列
- 用户、动作、对象、详情、IP、时间。动作名是 <模块>.<动作> 形式，例如音色审核、参数重渲染。
- 登录日志列
- 用户名、结果（成功/失败）、IP、信息、时间。
- 关键字口径
- 审计页签按用户 ID 搜，登录页签按用户名搜，输入框标签会跟着换。
约束与注意（不做就会踩）
- 没有导出、清空与删除入口：审计留痕本身不可被这一页改动。
- 切换页签会重置到第一页。
- 请求失败时表格清空并提示，不会把上一次结果留着让人误读。
可见范围：管理员与超级管理员
系统配置
系统配置（NAS / 数据库 / 推理服务 / 告警 / 品牌）/admin/sysconfig打开这一页 ↗
NAS、保留期、数据库、推理服务、更新中心、告警、品牌这七段的配置都改这一处，改完统一保存。
使用步骤（照着走一遍）
- 找到对应卡片改字段；密钥类字段显示为掩码，不动它就表示不修改。
- 涉及连通性的先点该卡片的「测试连接」，看逐项结果再保存。
- 点「保存全部修改」，页头"N 项待保存"的计数实时显示到底改了几项。
- 需要留底点「立即备份数据库」；要立刻回收空间在保留期卡里点「立即执行一次清理」并确认。
逐区域功能说明
- NAS 存储配置
- 地址、共享、挂载点与凭据；测试用的是尚未保存的草稿值，并回一条可直接执行的挂载命令。
- 产物保留期
- 多少天/多少条之内的产物与临时文件会被清理；显示当前清理任务的状态读数。
- 数据库配置
- 连接与备份相关项，测试连接验证是否能连通。
- 推理服务配置
- 节点清单可「添加节点」、逐个「测试」、「删除」、「打开面板」；合成实际会按这里的可用节点排队。
- 更新中心 / 告警 / 品牌
- 更新源与部署脚本位置；告警阈值与通知去向；品牌名与 logo。
约束与注意（不做就会踩）
- 改协议（如 NAS 类型）会连带清掉不再适用的键，保存时会明说清了哪些。
- 这里写的 NAS 路径和运行时实际生效的存储根不一定相同，不一致时页面会警告：保存不会自己把已有产物搬过去。
- 链接类字段必须以 http(s):// 或 / 开头，否则保存被挡下。
- 清理是不可逆的：确认框里会说明会清掉什么，先备份再执行。
- 保存被拒绝时错误条直接显示在后端原话上，不静默回滚。
可见范围：仅超级管理员
功能开关/admin/features打开这一页 ↗
逐条开关平台功能。关掉的不是按钮，是服务端那条路径上的每个请求。
使用步骤（照着走一遍）
- 点「刷新」重取全量清单——清单来自代码里的功能注册表，这一页不能凭空造开关：页面上有几项，注册表就有几项。
- 要关一项：点它「状态」列的开关，弹窗里写关闭原因（可留空），点「关闭」确认。
- 要开回来：把开关再点一次即可，不需要填原因。
- 切换后看页顶那条回执：它点名这次被拦的路径；表格下方那行带绿灯的文字是本轮读数的说明。
逐区域功能说明
- 功能 / 说明
- 注册表里的中文名与这一项管什么。
- 入口
- 这一项在前端对应的页面路径，用来对账"关的是哪个入口"。
- 服务端拦截路径
- 关掉之后真正返回 403 的路径清单——门禁落在服务端，不是把按钮藏起来。
- 状态
- 开 / 关。非超级管理员这一列是禁用的。灰字「出厂即开 · 无记录行」表示库里还没有这一行，缺行按"开"处理。
- 状态读数 / 备注 / 最近更新
- 启用标签、上次留下的关闭原因、最近一次改动时间。每次切换都写审计日志。
约束与注意（不做就会踩）
- 关掉之后那条路径上的请求一律 403 并点名功能中文名；界面侧不会把东西删掉，而是把入口标成"未开放"，点进整页时落到「功能未开放」页。
- 本页自身与「功能未开放」页在服务端的豁免清单里——否则关掉开关的人就再也打不开回来了。
- 本机即时生效；多 worker 部署时另一个 worker 最迟按读数里给的 TTL 秒数收敛，这中间存在一个短窗口。
- 这一页管"这项能力开不开"；某个账号能不能进专业模式是另一个旋钮，在用户管理页逐人设置。
可见范围：仅超级管理员
更新中心/admin/version打开这一页 ↗
看当前版本与最新版本，登记升级或回滚意向，拿到要在部署机上执行的命令。
使用步骤（照着走一遍）
- 点「检查更新」比对当前版本与最新版本（没配更新源时按钮禁用并写明原因）。
- 决定要升就点「登记升级意向」，要退就点「登记回滚意向」——两者都只登记，不动文件。
- 在「执行计划」卡里点「复制」拿走命令，到业务机（部署机）上执行，结果看「操作结果」日志。
逐区域功能说明
- 版本 KPI
- 当前版本与最新版本两个读数。
- 说明条
- 写明自动检查是否开启、部署脚本路径、最近一次登记的状态。
- 执行计划
- 升级/回滚登记后出现，给出可复制的命令序列。
- 操作结果
- 事件式日志，新行追加并自动滚到底。
约束与注意（不做就会踩）
- 平台自身不会执行部署命令：真正的变更必须在部署机上手动跑，这是为了避免平台自己把自己改坏。
- 部署脚本在主机上缺失时计划会被标成"脚本缺失"并且不提供命令。
- 回滚需要历史版本存在，否则后端给原因。
- 更新源没配好时页面显示禁用与原因，不会假装"已是最新"。
可见范围：仅超级管理员
推理中枢/admin/infer-hub打开这一页 ↗
把所有推理节点各自端口里的管理面板并到一页：架构与链路两张图先看全局，再看到谁在排队、权重此刻住在显存还是内存、哪台要解锁改参数；各台日志与平台自己的日志也在这一页过滤和打包下载。
使用步骤（照着走一遍）
- 先看「车队总览」的卡片：亮灯是在跑、黄灯是并发已打满或引擎非 ok、虚线卡片是这台连不上（卡片上写着中文原因）。
- 接手或排障前开一眼「架构与链路」：分层图说清请求从哪儿进、经过谁、落到哪台，链路图把一次合成请求要过的签名与闸门按顺序画出来——两图上每一格都是读数，取不到的写「这台没报」。
- 点任一卡片进「单台全档」，逐段读这一台的运行态、并发与排队、吞吐、时延、最近请求与接入读数。
- 要动参数就进「现场管理」：先在 A 卡里选台、亲手填该节点的签名密钥点「解锁」，成功后 B 卡的参数表才可改。
- 只填要改的那几栏，点「应用这 N 项」；回执写明生效了哪些键与"什么时候生效"，没填的栏不会被发出去。
- 收尾点「立即上锁」或「全部上锁」；解锁时长与剩余时间由节点回，到点自己失效。
逐区域功能说明
- 读数带
- 台数、在线、连不上、在途并发合计、排队合计、归属任务合计六枚；跨台对照看「容量与队列」页签。
- 车队卡片
- 一卡一台：引擎/显卡/在装音色、并发与排队两条计量条、近一小时分桶柱、p50/p95 与累计成败（失败按"总数减成功"算，节点没有单独的失败桶），末尾给这台自己的面板、
/health、/metrics三个直链。 - 架构与链路
- 两张内联 SVG：上面一张是系统分层（入口 → 业务平台 → 中枢 → 各台节点 → 权重与产物），下面一张是一次请求的链路（签名头、时间窗、超时、准入闸、队列）。窄屏走横向滚动而不是把字缩成一团糊。
- 吞吐与时延
- 每台一张分桶柱（成功与失败两段堆叠），桶宽与桶数取节点读数；下方「全场最近请求」把各台 20 条按时刻并排。
- 模型装载
- 这台现在装的是什么、装载状态机走到哪一步（当前态在呼吸高亮）、权重合计多少 GiB、驻留模式与空闲倒计时；「现场清单」才去扫盘，其余读数是 5 秒一轮的缓存。
- 音色落位
- 这台机上真正存在的音色目录与参考音频——跨机排程最容易坏的就是"业务库里有、这台没有"。
- 现场管理
- 解锁、热更参数（量程与生效口径由节点下发）、引擎自检、显存让位/回位、清理权重残骸，以及"不接受面板热改的项"逐条理由。
- 日志中心
- 一份工具条读两类出处：平台自己的日志文件、以及每台节点自己写的日志。级别多选与关键词只决定给不给你看，上方的「级别占比」条始终按窗口里真实有什么来画；可勾「自动刷新 10s」盯着涨，「打包下载全部」把平台 + 每台的日志拼成一个 zip（含
manifest.json说明本次筛选条件与各台状态）。 - 接入与别名
- 节点池只读快照、每台的注册地址与接入提示，以及别名与备注的编辑（与系统配置同一份读数）。
- 配置读数
- 各台配置键的并排矩阵，用来发现"这台和那台的队列上限不一样"这类差异。
- 明暗两态
- 页面右上角的「明亮 / 黑暗 / 跟随系统」就地切，与全站顶栏、个人中心是同一份偏好；两张图与所有计量条在两态下都重新取色，不靠滤镜。
约束与注意（不做就会踩）
- 加机器、减机器只在 系统配置 →
infer.nodes一处做；这一页读的就是那一份清单，池外地址中枢一律不代打。 - 中枢不做"平台自动解锁"：密钥要人亲手输，连续输错会被该节点冷处理一段时间。密钥与会话都不进日志、不进应答、不落库。
- 解锁是"人和这台"之间的事：你解锁的台子，别人那侧仍是锁着的；页面顶部的"解锁中 N 台"只数你自己的。
- 读各台日志走的是签名直读那条路，不需要先解锁；密钥不一致的台会明说读不到，并给出走的哪条兜底。
- 「打包下载全部」是一次管理员动作，会记进审计日志（含操作者与本次筛选条件）；逐行刷新日志不写审计，否则日志会被自己刷满。
- 参数越界或类型错时节点整批拒绝，不会部分生效；拒绝理由是节点给的中文原话，这里不改写。
- 自检会在该节点真跑一次推理，走准入闸不插生产请求的队；结果同时出现在那台的「最近请求」里。
- 驻留搬运只在没有任何在途与排队请求时才发生，忙时节点回 409，页面不会替你重试。
- 清理权重残骸只删
models/base_models下的目录本身，要键入同名确认；正在拉取的目录与符号链接一律拒绝。成功拉取过的模型请走「模型库」的下线流程。 - 一台连不上只影响那一张卡片，其余读数照常刷新。
可见范围：仅超级管理员（路由 roles 与后端门禁同一口径）
账号
个人中心/profile打开这一页 ↗
改自己的昵称与联系方式，换密码。用户名和角色由管理员定，这里改不了。
使用步骤（照着走一遍）
- 在「01 基本资料」改昵称、头像 URL、手机、邮箱，点「保存资料」。
- 在「02 修改密码」依次填原密码、新密码、确认新密码，点「修改密码」。
逐区域功能说明
- 角色 / 账户读数
- 表头两枚标签显示当前角色与登录名，只读。
- 基本资料
- 用户名与角色是只读行；头像填可直接访问的图片地址，登录后顶栏就用它。
- 修改密码
- 三个密码框都带明文切换，保存成功后自动清空输入。
约束与注意（不做就会踩）
- 新密码有强度要求（长度与大小写数字组合），页面占位符写着口径，服务端会再校验一次。
- 原密码留空、新密码留空、两次输入不一致都会被就地拦下并提示，不会白白发请求。
- 改密码成功后当前会话仍可用，下次登录用新密码。
- 失败原因来自后端原话，不弹空提示。
可见范围：全部登录用户（只影响自己）
登录页/login打开这一页 ↗
用管理员分配的账号进入平台；登录成功后拿到的令牌只留在本次会话里。
使用步骤（照着走一遍）
- 输入用户名与密码（两项都必填，失焦时会就地提示缺哪一项）。
- 点「登 录」或直接在密码框按回车提交。
- 成功后先显示欢迎条，再跳回原先要访问的页面（带 ?redirect= 时会回到那一页）。
逐区域功能说明
- 品牌块
- 左上角的名称与 logo 来自系统配置的品牌段；没有配到 logo 时显示"语匠"字标。
- 错误条 / 成功条
- 红条是后端原话（例如账号或密码不对、会话已过期）；绿条是登录成功回执，随后自动跳转。
- 密码输入
- 带小眼睛可切换明文；提交期间按钮进入 loading 并禁用，避免重复登录。
约束与注意（不做就会踩）
- 没有注册、忘记密码或第三方登录入口：账号统一由管理员在「用户管理」里创建，密码忘了请让管理员重置。
- 连续输错不会锁号，但会留下登录日志，可在「审计日志」的登录页签里查到。
- 平台只在内网可用，页面不会把令牌写进可复制的文本里。
可见范围：公开页（未登录访问任何功能页都会先被送回这里）
06
文本标注语法
写给要控制到每一个字的人标注不是"富文本格式"，而是一行行写在待合成文本里的指令。平台把它们分成两层： 引擎级的（说话人、语气、风格指令）交给音色模型去理解；后期级的（停顿、连读、逐段语速/音调/音量）在合成之后用信号处理落上去。 这个区分决定了"改它要不要重新合成"，也决定了它为什么有时看起来"没那么明显"。
先记住一句：标注只有在服务端解析器认得它的时候才叫标注。认不出的写法不会被吃掉——
它会原样留在文本里（于是被读出来），同时在解析回执里单独列一行告诉你哪一处没认出来。
所以"我写了它却没生效"从来不是静默失败：要么它读出来了，要么它被点名了。想知道自己写得对不对，提交前先点一次「解析检查」。
◆标记总表
| 写成这样 | 管什么 | 哪一层 | 写在哪儿才有效 | 生效范围 |
|---|---|---|---|---|
| 【角色名】台词 | 这句交给哪个说话人 | 引擎 | 段首：行首、句末标点之后、或 ‖ 之后 | 一直延到下一个角色标记 |
| [中性] [开心] [悲伤] [愤怒] [严肃] | 语气 | 引擎 | 句子里任意位置 | 一直延到下一个语气标记或文末 |
| [开心@强度] | 语气的强弱 | 引擎 | 紧贴在一个语气标记上 | 同上；范围与默认值由服务端下发 |
| [说明：…］ / [instruction: …] | 用一句话描述想要的说法 | 引擎 | 需要模型侧支持；哪些模型吃这一项看能力表 | 一直延到下一个同类标记 |
| [停] / [停0.8s] | 在这里插一段静音 | 后期 | 句与句之间、段与段之间 | 只影响这一处；时长与上限由服务端下发 |
| [连读] | 把和上一句之间的空隙压掉 | 后期 | 紧跟在要连读的句子前 | 与 [停] 共用同一份"空隙预算"，后写的算 |
| ‖ | 强制断句（等同于一个句末标点） | 解析 | 想让下一段重新起头的时候 | 只切一刀，标记本身不发音 |
| **词** | 给这个词加着重 | 引擎 | 必须在同一句内成对闭合 | 只作用于被包住的那个词 |
| [速1.2] / [speed1.2] | 这一段语速 | 后期 | 段首区域生效 | 覆盖全局语速，直到下一处同类标记 |
| [调+2] / [pitch+2] | 这一段音调（半音） | 后期 | 段首区域生效 | 同上 |
| [量-3dB] / [gain-3db] | 这一段音量（分贝） | 后期 | 段首区域生效 | 同上；单位支持 db / dB / DB / 分贝 |
数字都不在这页上，是故意的。上面凡是写"由服务端下发"的地方（停顿默认与上限、可标注的句数上限、语气强度的范围、逐段语速/音调/音量的边界、角色名长度上限、长句二次切分的门槛），
真源是平台随界面下发的那份量程读数（标注语法那一段），界面里的示例提示也读同一份。
量程调了不用改文档，也不用发版——这一页也不会过期成错的。
◆三件事必须知道
角色标记只认"段首"
【张三】 写在句子中间是不生效的：它只在行首、句末标点之后、或 ‖ 之后被当作说话人切换。
想让某半句换人说话，就先 ‖ 切一刀再标角色。角色名本身不会被读出来。
着重号必须成对且在一句之内
**重要** 跨句没有闭合时，解析器不会"帮你补上"，而是把这一处按原样保留并列进错误回执。
另外它加的是固定强度的着重：已经在 @ 上手动写过强度的地方，它不覆盖。
停顿与连读抢同一份预算
一个空隙上要么"停"要么"连"，两处都写时后写的赢，并且回执里会给你一条警告。 标注的句数超过上限时不会整条失败：多出来那些原样交给模型读。
◆读法替换不在上面这张表里
多音字、缩写、品牌名的读法没有行内标记，它是一张词典：在「读法替换」页（/pron）里配规则，
解析完成后、真正送去推理的那份文本上生效——也就是说界面里看到的原文不会被改写，只有读出来的音变了。
这一页还给你「试读」，不用提交任务就能验规则命中了没有。
◆一条文本在里面变成了什么
07
评分与口碑怎么读
10 分是输入，5 星是读数，榜是汇总平台上的评价刻意做得很轻：一条完成的任务上点一次，滑一下就是分。它不改变任何业务行为—— 不影响排队优先级、不影响谁能用哪个音色、不折成任何"信用分"。它只是把"这版音色/这个模型/这台节点好不好用"这件事， 从各人的耳朵里搬到台面上。
一个分，两种写法
存下来的只有 1–10 的整数；星星是算出来的（分数 ÷ 2，可以落在半星上）。
所以界面上拖滑条和点星星是同一件事的两个入口，不会出现"我点了四星存成了几分"的疑问。
一个位置只有一票
同一个人对同一个对象（同一条任务、同一个音色、同一个模型……）永远只有一条记录：再提交就是改，不是叠加。 目前没有"撤销评分"的入口——改个分就是撤回的方式。
◆可以打分的五个对象
| 打给谁 | 入口在哪 | 进不进「评价参考」榜 | 为什么要打它 |
|---|---|---|---|
| 这条任务 | 任务列表 · 已完成行的「评价」 | —（不进榜） | 记住这一次的结果；榜上排它是因为它是流水不是口碑 |
| 这个音色 | 评价弹窗里的音色页签 · 音色列表 | ✓ | 下次别人挑音色时看得见的口碑 |
| 这版模型 | 评价弹窗里的模型页签 | ✓ | 同一音色在不同模型下的差别，归到模型头上 |
| 音色 × 模型 | 评价弹窗里的组合页签 | ✓ | "这个音色配这版模型才好听"——组合才是一线真正在用的单位 |
| 推理节点 | 评价弹窗里的节点页签 · 监控大屏 | ✓ | 把"这台机器最近出的活儿不对劲"说出口，管理员看得到 |
榜是怎么排的：每个对象给出平均分、票数、最近一次改动时间，先按平均分从高到低，同分再按票数多者在前；
榜单长度有上限（默认取前面若干条，界面上一次多要几十条）。没被评过的对象根本不出现在榜上，而不是显示成 0 分——
看不见和没人夸是两件事。想查具体某几个对象的分数，用「评价参考」页上的查询，把标识粘进去就行。
◆门槛与规矩（服务端真的会拦）
- 只有跑成功的任务能评；没完成、已失败的条目上按钮是灰的。
- 任务只能评自己的；管理员可以评任何人的已完成任务（用于代录反馈与自检）。
- 分数只收 1–10 的整数，越界直接被拒；附言最长 200 字。
- 推理节点这一项只认平台认识的节点（配置里的、探测到的、或历史任务用过的），不能随手编一个地址。
- 每一次提交、每一次上报、每一次处置都会写进审计日志。
◆严重问题反馈：从"我很生气"到"有人处置"
评价弹窗里分数低到一定档（界面上会自己展开那块）就是上报入口；任务列表上每一行也单独放着这个入口。 上报时会自动带上这条任务用过的音色、模型、节点作为快照——快照就是快照：那个音色后来被删了，报告里的名字仍然留着。
| 档位 | 含义 | 谁该选它 |
|---|---|---|
| 轻微 minor | 能忍，但下次别这样 | 个人口味、可绕过的毛病 |
| 主要 major | 默认档：这条结果不该这么交出来 | 多数情况 |
| 严重 critical | 挡住用了 / 成片会出错 / 疑似节点或模型问题 | 需要有人立刻看 |
处置状态是一条单向可回头的流水线：open 待处理 → triaged 已定性 → fixed 已修 / closed 已结 / wontfix 不修。
分类固定五个：音频、音色、模型、节点、其他。
改状态必须附一句说明。把一条报告从"待处理"挪走而不写字，服务端会拒绝——
这是"没人处置"和"处置了没人知道原因"之间唯一的区分手段。上报人会看到「我的上报」列表，但报告里不会反向暴露别人的身份。
管理员不会被打扰。目前没有任何推送、邮件或角标提醒：反馈接收页顶上的两个读数（待处理总数、严重未处置数）就是全部的提醒。
这一页需要有人真的去看，且"严重 + 待处理"会被排在第一页最前。
08
接入与联调
这一章故意不讲细节为什么这一节是空的。帮助中心是一份不登录也能整份看完的静态文件，
而"怎么接入"这件事在平台里属于受许可的内容：默认只有超级管理员进得来，其他人要由超管在「用户管理」里逐人打开"接入许可位"。
把端点清单、参数形状、被关掉的功能对应哪些地址抄进这一页，等于把那份许可作废——所以这一章一条都不抄。
◆要拿到细节，只有一条路
1
先让超管给你开许可
在「用户管理」里把这一位的接入许可打开。界面上的入口只是提示，真正的拦在服务端：没有许可的账号，那份清单会独立拒绝。
2
进系统里的「接入指南」页
左侧导航里那一页（仅在有许可时出现）。清单的唯一出处就是它：内容由服务端按你的账号现给，不在任何静态文档里留第二份。
3
量程与开关现读现用
参数的上下限、默认值、单位，以及哪些功能当前是开的是关的，都由平台在打开界面时下发。照着它接，别照文档里的数字接——文档会旧，它不会。
◆不靠许可、人人都有的三条
- 这一页（帮助中心）：怎么用界面、每个页面干什么、标注怎么写、出了问题先查什么——这些不设门槛。
- 门户页：能力概览与逐页直达，同样不登录就能看。
- 「个人中心」：自己的账号、自己的偏好、自己的那份东西，本人随时可看。
给管理员的一句话。想让人"照文档接"是可以的，但要清楚：一旦把受控清单的正文复制进静态文件、聊天记录或工单附件，
后面那个逐人许可位就只是界面装饰了。要给别人看，就给他开这一位的许可。
09
引擎与推理节点
为什么同一句话换个模型就不一样平台上"音色"这件事是两层的：底层是引擎（一套会说话的模型族），上面是音色（用某个引擎练出来的具体嗓门）。 界面上让你选的是后者，但决定"能不能标注、能不能吃风格指令、参数拉到哪就开始失真"的是前者。
| 引擎 | 它是什么 | 跑在哪个进程里 | 挑它的理由 |
|---|---|---|---|
| cosyvoice | 主力中文合成引擎，参数保守、结果稳 | 主推理节点进程内 | 默认优先；不折腾的时候用它 |
| sovits | 音色替换类引擎，对"像不像"更敏感 | 主推理节点进程内 | 需要贴脸相似度的素材 |
| indextts25 | 2.5 代桥接引擎，唯一吃音素标注的 | 独立桥接进程（20004） | 要抠字音、要风格指令的场合 |
| indextts | 第二代桥接引擎 | 独立桥接进程（20002） | 已有素材库在这代上练的 |
| mock | 不加载权重的模拟引擎，只把链路走通 | 主推理节点进程内 | 装机自检、演示、压排队；产出不是真人声 |
优先顺序是配出来的，不是猜的。模型库里的内置登记带优先级数字，选路时按它排：
cosyvoice 最低、sovits 次之、
indextts25、indextts 往上，mock 垫底（有真引擎可用时永远轮不到它）。
这些数字来自 model_registry 的内置种子，改它属于改主链路，得走报备。◆能力差异不是 bug
- 音素标注：只有 2.5 代桥接引擎吃。用别的音色时这一项就是不参与。
- 着重（
**词**）多有效：按引擎的一张"哪些语气下着重真的起作用"表来定；不在表上的组合不报错，只是听感差别小。 - 风格指令（
[说明：…]）：同上，看引擎是否声明支持。 - 参数安全区间：每个音色有一条"建议区间"，拖出区间时界面只给一条提示、不锁参数——你照样能提交，只是听起来不像它自己。
◆节点是怎么被发现的
业务侧不手工登记 GPU 机器：配置里给一份节点地址清单（INFER_NODES，逗号分隔），
平台启动时与周期任务里逐个去问 /health，把对方报上来的引擎、GPU、权重读数自动并进模型库；
遇到没登记过的引擎就补录一条。所以「模型库」页上看到的东西是探出来的，不是人手抄的——一台机器没出现，先问它自己 /health 通不通，再点一次「重新发现」。
10
管理员配置要点
哪些事只有超管能做 · 哪些做了会立刻影响所有人角色只有三档 adminsuper_admin
普通用户、管理员、超级管理员。管理员管人、管音色、看监控与审计、处置反馈； 超级管理员额外独占：系统配置、功能开关、更新中心、数据库备份，以及给别人开许可位。
三个许可位，各管一件事
专业模式（管理员可开）决定这个人能不能看到全套参数；接入许可位（只有超管能写）决定他能不能看接入指南； 角色本身决定门禁。三者互不蕴含——开了专业模式不等于能看接口，反之也一样。
◆动之前先想清楚的那几件事
| 动作 | 立刻发生什么 | 怎么收回来 | 注意 |
|---|---|---|---|
| 关掉一个功能开关 | 所有人的入口同时收：整页入口落到"功能未开放"页并点名开关；页内按钮变"未开放" | 再打开一次，同一个页面里 | 开关页本身永不受门禁约束 |
| 停用 / 恢复一个账号 | 停用后对方下一次请求就被拒；已开的界面读数跟着失效 | 同一页切回来 | 不会删他的任务与评分历史 |
| 收回专业模式 | 对方即使本地记着"我在专业模式"，也会落回简易模式，而不是切过去再被接口拒 | 再开 | 偏好仍跟着账号，换机器不丢 |
| 给某人开接入许可 | 他的左侧菜单多出"接入指南"；服务端同一次放行 | 逐人收回 | 这一位只有超管写得动 |
| 处置一条反馈 | 状态推进 + 附言留痕，上报人在"我的上报"里看到 | 可回退到待处理 | 不写字就改不了状态 |
| 审核一个上传音色 | 过审后它才出现在别人的可选列表里 | 驳回 / 下架 | 不过审只是"不可用"，文件不删 |
| 改系统配置（NAS / 数据库 / 推理服务 / 告警 / 品牌） | 写的是运行时读数，界面上的品牌名、logo、连接参数按新值走 | 改回旧值 | 每一项都先「测试连接」再保存 |
| 跑数据保留清理 / 备份 | 按保留策略清历史成品、把库备份到配置好的位置 | 备份留着可回 | 清理是不可逆的，先看状态读数再按 |
更新中心这一页不会替你升级。它做的是"看当前版本、看有没有新包、给出该执行的部署命令、记台账"，
真正的升级动作是在服务器上跑部署脚本（换
current 符号链接、迁移数据库、重启单元）。
生产环境的推送只有一个口子，而且需要人类当轮明示授权——界面上点一下不构成推送，这是刻意留的。改环境变量前的两条红线：① 若用 MySQL，数据目录必须落在本机盘，不能放网络盘；
② 素材/成品卷靠挂载监视单元撑着，网络盘断了时报错的是任务而不是界面，排查时先看那一个单元的状态。
11
部署形态与端口
给接手运维的人 · 端口一律来自配置项| 端口 | 谁在听 | 来自哪个配置项 | 要不要暴露给用户 |
|---|---|---|---|
| 20000 | 业务 API（FastAPI，顺带端出前端静态件与帮助中心） | APP_PORT | 是（通常经 nginx 反代） |
| 20001 | 主推理节点（cosyvoice / sovits / mock） | INFER_PORT | 否，只给业务侧调 |
| 20002 | IndexTTS 二代桥接进程 | BRIDGE_PORT | 否 |
| 20004 | IndexTTS 2.5 桥接进程 | BRIDGE25_PORT | 否 |
| 20003 | 前端开发服务器（Vite，只在开发机上） | FRONTEND_DEV_PORT | 生产上没有 |
| 3306 / 6379 | MySQL / Redis（交付形态选择，不是必需） | DATABASE_URL 等 | 只绑 127.0.0.1 |
| 80 | nginx 入口 | — | 是 |
| 9090 / 3000 / 9093 | Prometheus / Grafana / Alertmanager（可选监控形态） | — | 内网 |
| 9100 / 9400 | 节点指标 / GPU 指标导出器 | — | 只给采集器 |
◆裸机形态的服务单元（都按 tts 用户跑）
| 单元名 | 里面是什么 | 挂了会怎样 |
|---|---|---|
| tts-platform-api | 业务 API，2 个工作进程 | 整站打不开，登录也不行 |
| tts-platform-celery | 任务工人，4 并发，吃 synth 与 default 两条队列 | 界面能用，任务永远排队不出成品 |
| tts-platform-celery-beat | 周期任务：节点再发现、清理、读数 | 新节点不会被发现，保留策略不跑 |
| tts-infer | 主推理节点 | 主力引擎失声，其它引擎还能出活 |
| tts-indextts-bridge | 二代桥接 | 只有这代音色受影响 |
| tts-indextts25-bridge | 2.5 代桥接 | 音素标注与风格指令那条路断 |
| tts-platform-mount-monitor | 素材/成品卷挂载监视 | 卷掉了没人报警，任务在写文件时才炸 |
| tts-nas-mount | 挂载目标（把上面几个捆在一起等网络盘） | 依赖它的单元起早了会连不上卷 |
◆发布是怎么滚的
目录形状
发布根下 releases/<打包时间戳> 一份一份存，
current 指向在用那份，previous 留着回滚。
升级动作
换链接 → 跑数据库迁移 → 按顺序重启（beat、worker、api）→ 打健康检查。
任一步没成，current 还指在旧那份上。
版本记在哪
没有专门的版本表：记在系统配置项里，外加一份状态文件与符号档，更新中心读的就是这几处。
关于 https：配置里能查到的入口只监听
80，仓库内没有 TLS 落地件。
如果你访问的地址是 https，那加密是在你这一侧的外层设备上做的，端口与证书不归这个项目管——排查"证书告警"这类问题时别在平台里找。这份帮助中心是怎么被端出来的：它是前端构建产物之一（源件在前端
public/ 下，构建后落在 dist 根），
由业务 API 的静态分支直接送出，不经前端路由，因此不需要登录就能打开，也才能做到"从任何一页新标签打开都在同一个地址"。
同理：/api、/files、/health、/metrics 这几个前缀是留好的，静态件不能占。12
故障排查
先自己看得见的三眼：状态条 · 回执 · 读数| 现象 | 大概率原因 | 怎么办 |
|---|---|---|
| 提交了，一直显示排队 | 工人或推理节点没在跑；或前面确实有长任务 | 看任务详情里的排位读数；管理员查「监控大屏」的队列与节点，先确认是排队还是没人干 |
| 界面弹"该功能未开放" | 超管关了对应的功能开关 | 提示里点名的就是开关名与找谁；不用重试，重试也是 403 |
| 整页变成"功能未开放" | 这一页本身是某个功能的入口 | 同上；四个主链路页（新建任务 / 任务列表 / 音色 / 模型库）不会整页消失 |
| 写了标注，读出来是字面意思 | 写法没被解析（尤其 【角色】 不在段首、** 跨句没闭合） | 提交前先跑一次「解析检查」，回执会逐行点名没认出来的那一处 |
| 停顿标了没反应 | 和上一处的「连读」抢同一份空隙预算，后写的赢了 | 同一个空隙只留一个指令；回执里有警告说明 |
| 同一行标注换个音色效果差很多 | 语气指令 / 音素标注 / 着重强度是按引擎能力生效的 | 看「模型库」里这一版的能力读数；需要音素标注只有 2.5 代吃 |
| 多音字读错 | 读法替换是词典，不是行内标记 | 去「读法替换」加规则并用「试读」验证命中；规则只影响送去推理的文本，界面原文不变 |
| 自己上传的音色别人（或自己）选不到 | 还没过审 | 等管理员在「音色审核」处置；驳回只是不可用，文件不会被删 |
| 「评价」按钮是灰的 | 这条任务不是"成功"状态 | 失败的任务请先重试或调参重出；成功后按钮即亮 |
| 评完分在榜上找不到 | 榜是按音色/模型/组合/节点汇总的，任务级评分不进榜；且没人评过的对象根本不出现在榜上 | 用「评价参考」页的查询，把具体标识粘进去看均分与票数 |
| 反馈提交了，没人动 | 平台没有任何推送提醒，靠管理员看反馈接收页的读数 | 严重问题在选择时按"严重"报，它会被排到第一页最前；急事还是得当面说 |
| 改反馈状态被拒 | 从"待处理"挪走必须附一句说明 | 在处置框里写一句话再保存，这是留痕不是刁难 |
| 登录一直失败 | 账号或密码不对；或连续尝试把这一分钟的门限用完了 | 429 就是被限流，等一分钟再来；忘记密码只能由管理员重置（没有自助找回） |
| 用着用着跳回登录页 | 令牌过期（默认 12 小时） | 重新登录即可；界面上不会把令牌写成可复制的文本 |
| 音频链接打不开 / 播放 403 | 那是短时签名地址，过期作废 | 重新查一次任务或重新导出，拿一条新地址；别把地址存进长期文档 |
| 换了台电脑，明暗和模式又回来了 | 偏好跟着账号存在服务端，正常应该跟过来；没跟过来说明那次保存失败了 | 失败时界面会明说"未保存到服务器"；再切一次，或确认自己不是在被收回专业模式之后 |
| 模型库里少了一台机器 / 一个引擎 | 节点没被探到（服务没起、/health 不通、不在配置清单里） | 管理员点「重新发现」；仍不出现就查那台机器的进程，界面上没有手工添加机器的入口 |
| 任务报"写文件失败 / 找不到素材" | 素材或成品所在的网络卷掉了 | 管理员查挂载监视单元与「系统配置」的挂载状态；这类错的根因在盘不在文本 |
说给管理员的排查次序：界面还能不能登录 → 能不能看到历史任务（能，说明 API 与库活着，问题在工人/节点）→ 任务详情里是排队还是在跑（排队＝没人干，在跑不出结果＝节点侧）→
监控大屏的节点读数 → 对应引擎的进程与端口。反过来做（先重启节点）会让一条本来只是排队的问题变成一次中断。
13
术语表
界面上的词在这里对齐一次| 词 | 一句话 | 你在哪儿遇到它 |
|---|---|---|
| 引擎 engine | 会说话的模型族，决定能力边界 | 模型库 · 参数回执 · 本报告 §09 |
| 模型 model_key | 一版可被选择的合成模型，带优先级与状态 | 音色与参数区 · 模型库 |
| 音色 voice_id | 一个具体嗓门，挂在某个引擎/模型下 | 音色列表 · 评分对象 |
| 组合 音色×模型 | "这个音色配这版模型"这一对，是口碑的真正单位 | 评价弹窗 · 评价参考榜 |
| 节点 node | 一台跑推理的机器（地址 + 端口），可被打扰也可被打分 | 监控大屏 · 评分弹窗 |
| 发现 / 探测 | 平台去问节点的 /health 并把读数并进模型库 | 模型库「重新发现」 |
| 驻留 residency | 权重留在内存里随时出活；切走是换出而不是删除 | 监控大屏 · 切换读数 |
| 桥接进程 bridge | 把某一代引擎单独包成一个进程的形态 | 运维 · 端口表 |
| 任务 task_uuid | 一次提交的凭证，状态从这里推进；成品挂在它身上 | 任务列表 · URL |
| 试听 preview | 走同一条链路但不占正式任务号的快速产出 | 新建任务页 |
| 实时预览 | 改后期参数就重拼、改文字才重推的那套自动重出 | 新建任务页的勾选 |
| 预设 preset | 一套参数与文本形状的名字：私有 / 公共（公共要过审） | 预设库 |
| 素材 material | 上传进来的音频，供垫乐与切片使用 | 素材库 · 背景音乐区 |
| 切片 / 审阅 clip | 把长素材切成可用小段并逐条定文本、定去留 | 素材切片与审阅 |
| 配音 dub | 合成之后按时间轴重新对台词/换声的工序 | 配音工作台 |
| 剪辑 edit | 对已完成任务出改版，版本之间有血缘 | 剪辑工作台 |
| 标注 markup | 写在文本里的行内指令；解析在服务端 | 本报告 §06 |
| 分句 / 段 segment | 一句一条的最小合成与重推单位 | 解析回执 · 剪辑时间轴 |
| 后期 DSP | 合成之后的信号处理：空隙、语速、音量、混响、垫乐 | 参数旋钮区 |
| 空隙预算 | 停顿与连读共享的那份额度，后写的算 | 解析回执警告 |
| 读法替换 pron | 词典式的读法改写，只作用于送推理文本 | 读法替换页 |
| 参数守卫 param_guard | 某个音色的建议区间；出区间只提示不锁 | 音色选择与旋钮 |
| 量程下发 param_spec | "数字由服务端说了算"的那份接口，含标注全部上限 | 界面所有范围与提示 |
| 功能开关 / 门禁 | 超管按功能关，服务端按路径前缀 403 并点名 | 各处"未开放"提示 |
| 整页下架 vs 少一块 | 入口页消失与页内能力收口，是两种不同的关法 | 本报告 §04 |
| 许可位 | 账号上的一个开关（专业模式、接入指南），不等同于角色 | 用户管理 |
| 分组收口 | 按组给一批人收紧权限，白名单、只收紧不放宽；留空那一维＝继承全局 | 用户分组 |
| 审计日志 | 谁在什么时候做了什么，来源取真实 IP | 审计日志页 |
| 令牌 token / JWT | 登录后带在请求头里的身份，默认 12 小时过期 | 接入 · 掉线重登 |
| 签名地址 signed URL | 带过期与签名的音频地址，过期即废 | 播放器 · 导出 |
| 配额 quota | 给账号设的量，管理员可重置 | 用户管理 |
| 保留策略 retention | 历史成品与记录留多久，到期清理（不可逆） | 系统配置 |
| 评分 target_type | 这一票投给谁：任务 / 音色 / 模型 / 组合 / 节点 | 评价弹窗 · 榜 |
| 反馈状态机 | 待处理 → 已定性 → 已修 / 已结 / 不修 | 反馈接收 |
| current / previous | 在用的那份发布与上一份；回滚就是换链接 | 服务器目录 · 更新中心 |
| 开关灯 / 模式 | 外观（明亮·黑暗·跟随系统）与密度（简易·专业），两件事 | 顶栏 |
14
这份说明的口径
它凭什么可信 · 它什么时候会失真逐页那 22 块从哪来
它们机械迁移自平台内一直在用的那批说明数据（右侧说明栏读的就是同一份），文字没有被改写、没有重新组织顺序， 只是换了呈现位置。也就是说：以前你在界面右侧读到的东西，这里一字不差都在，只是现在它还长了锚点、目录和搜索。
数字一律不写死
凡涉及量程、上限、时长、字数、阈值——本页只写"由平台下发"，真源是你打开界面时平台现给的那份量程读数。 这条规矩不是文风偏好：标注教程正文里刻意一个数字都没有，并有自动化测试逐条拿真解析器验它，为的就是量程调整不需要改文档。
受许可的内容不在这页上
接入清单由服务端按账号许可现给，只有被开通的那位账号读得到；这一页因此不抄录它，也不给它做"简化版"。 标注语法的真源是平台后头的解析规则，本页给的是形状与读法，不是替代它们。
它不包含什么
没有任何账号、口令、密钥；没有受门禁的功能清单正文；也没有"当前生产版本号""在跑哪台机器"这类会变的事实。 需要这些的人请登录平台后从对应页面看——那里读到的一定比这份静态件新。
◆开关灯为什么能跟着平台走
这一页与平台同源（同一个地址、同一份本地存储），所以它读的是同一把偏好键： 你在平台上开着黑暗进来，这里就是黑暗；开着跟随系统进来，这里就跟着操作系统走。页顶那三个按钮拨的就是同一位偏好。 一个必须讲清楚的边界：平台上那次拨动会同时写进你的账号（换台机器还在），而在这一页拨动只改这台浏览器—— 因为它是静态页，没有账号上下文可写；下次你登录平台时，账号上记着的那份会覆盖本地。想永久改，请去平台里改。
◆它什么时候会失真
- 界面改版之后：这一页是构建产物，不会自动跟随代码。改版后需要重出它（尤其 §04 的角色矩阵与 §12 的现象描述）。
- 许可口径被改过之后：§08 记的是"接入内容默认仅超管、其余逐人发放"这一条规矩；哪天这条改了，那一节要跟着改。
- 端口/单元被改过之后：§11 记的是默认值与仓库内的单元名，现网以部署机上的环境变量为准。
发现说明与界面不一致时：以界面与服务端回执为准，并把那一处告诉管理员——
说明写错和量程写错是同一级别的缺陷，该改的是这份说明，不是让你去适应它。
编制日期
2026-10-09
逐页说明迁移自平台在用说明数据
覆盖
26 页 · 14 节
上手 / 逐页 / 语法 / 口碑 / 接入边界 / 引擎 / 管理 / 部署 / 排查 / 术语
形态
单文件自包含
无外部依赖 · 可离线打开 · 可直接打印
配套
量程随界面下发
本页所有"由平台下发"的出处