# 模型、托管运行与服务导航

「模型供应商」、「托管运行」与「服务导航」是 Raise 运营与运维管理的核心模块。运营人员可以在这里配置模型供应商并同步到模型网关、查看各租户的模型用量与账单对账，查看平台托管的应用进程状态、执行重启与读取运行日志，以及实时探测底层依赖服务的健康状态。

## 谁能用

本模块的功能权限根据平台角色进行划分，分为运营人员与支持人员两种：

| 角色 | 权限说明 |
|---|---|
| `platform.ops`（运营人员） | 具备完整的读写权限。可添加、编辑、删除模型供应商；触发网关重新同步；配置与登记模型价格；下载账单 CSV 文件；重启托管应用进程；查看进程最近日志。 |
| `platform.support`（支持人员） | 具备只读查看权限。可浏览模型供应商列表、网关一致性状态、用量统计、月度账单、对账明细、托管进程状态与服务导航健康信息。无法执行任何写操作，页面页脚提示「你的角色只能查看」。 |

> **注意**
>
> 托管应用进程日志中可能包含租户数据。为了保障数据安全，每次查看日志的操作都会记入[平台审计](/ops/audit)。添加、编辑、删除供应商以及重启进程等操作也会同步记入审计。

## 怎么打开

你可以通过以下路径进入对应的功能页面：

1. **模型供应商**：在运营后台左侧导航点击「运营」→「模型供应商」。页面提供「供应商」、「用量与租户」、「账单」与「对账」4 个标签页。
2. **托管运行**：在运营后台左侧导航点击「运维」→「托管运行」。
3. **服务导航**：在运营后台左侧导航点击「运维」→「服务导航」。
4. **工作台联动进入**：
   - 当[工作台](/ops/)主栏出现「平台未就绪」待办时，点击条目右侧「查看服务」直接进入服务导航。
   - 当工作台右侧「平台状态」需要排查明细时，点击底部的「全部服务 →」进入服务导航。

> **提示**
>
> 模型网关一致性维护集成在「模型供应商」页面中，系统没有单独的网关路由。此外，租户全貌中的「模型调用追踪」为租户绑定的独立 Langfuse 项目，不在本页配置（参见 [租户](/ops/tenants)）。

## 界面一览

### 模型供应商

模型供应商页面顶部显示标题「模型供应商」。拥有写权限时，右上角提供「重新同步」与「添加供应商」按钮。

页面包含 4 个标签页：

| 标签页 | 界面组成与说明 |
|---|---|
| 「供应商」 | **状态横幅**：<br>- 若部署环境未安装模型网关，提示「没有部署模型网关」（安装时添加 `--llm` 或 `--shell` 选项才有网关，此时仍可预先配置供应商）。<br>- 若网关运行异常，显示「模型网关不可用」与错误详情。<br>**指标三卡**：展示「网关」（正常/异常/未部署）、「供应商」（启用数/全部数）以及「可用模型」总数。<br>**「与网关的一致性」**：<br>- 配置一致时显示「网关与这里的记录一致」，说明供应商与租户密钥均匹配。<br>- 存在配置漂移时提示不一致处数量，说明「「重新同步」按这里的记录重推供应商和租户密钥。」。展示漂移类型（如「网关缺少供应商」「网关多出供应商」「供应商的模型对不上」「租户在网关没有密钥」「网关里有多余的租户密钥」等），并提供「重新同步」按钮。<br>**供应商列表**：表格包含「供应商」「接口地址」「区域」（不限/中国境内/欧盟/美国）、「模型」、「状态」（已停用/同步失败/已同步/未同步）及操作列「编辑」「删除」。<br>**空状态**：无供应商时显示「还没有模型供应商」与「添加供应商后租户才能用平台模型。」。 |
| 「用量与租户」 | **统计周期**：支持切换「7 天」「30 天」与「90 天」。<br>**核心指标卡片**：展示请求数（包含失败次数）、Tokens（包含输入与输出）以及估算费用（标注「按目录价格估算」）。<br>**财务与质量汇总**：展示「收入（向租户收取）」「成本（付给供应商）」「毛利」与「失败率」。<br>**「按租户」统计表**：展示租户、来源（显示「自带」或「平台」）、请求数、Tokens、失败率、平均响应时间、收入、成本、常用模型与调用趋势。<br>**「按模型」统计表**：展示模型、请求数、Tokens 与估算费用。<br>**空状态**：选定周期无调用数据时显示「这段时间没有调用」。 |
| 「账单」 | **月份选择与导出**：提供月份选择下拉框，提供「下载 CSV」按钮（下载文件名格式为 `llm-statements-{月份}.csv`）。<br>**财务指标汇总**：展示当月应收总额、「成本」与「毛利」。<br>**按租户分表明细**：按租户列出模型、来源、请求数、输入 Tokens、输出 Tokens、金额与成本。<br>**空状态**：当月无调用记录时显示「这个月没有调用」。 |
| 「对账」 | **网关状态与对账横幅**：<br>- 网关异常时展示网关不可用提示。<br>- 两端完全一致时显示「对得上」与「kwork 与网关的 token 计数一致。」。<br>- 两端存在出入时提示出入租户数，并说明「出入超过 5% 或 200 tokens。常见原因：密钥当天重建、有调用没经过网关。」。<br>**对账明细表**：列包括租户、kwork 计 tokens、网关计 tokens、差、请求（kwork / 网关）、状态（显示「一致」「有出入」「网关没有密钥」或「网关不可达」）。表格底部注明「按当前自然月对比；请求数仅供参考。」。<br>**操作按钮**：提供「重新对账」按钮。 |

### 添加 / 编辑模型供应商对话框

点击「添加供应商」或列表中的「编辑」打开对话框：
- **对话框标题**：添加时显示「添加模型供应商」，编辑时显示对应供应商名称。
- **「类型」**：单选「OpenAI 兼容」（说明「兼容 OpenAI 接口的服务，如 vLLM、Ollama。模型可从供应商读取。」）、「Anthropic」或「Google Gemini」（后两者说明「接口地址可留空；模型需手填。」）。创建后类型不能修改。
- **「ID」**：必填，标识符，下方提示「创建后不能修改」。规则为 2–31 位小写字母、数字或连字符，以字母开头。不能以 `byo-` 为前缀（系统预留给租户自带密钥），不能使用网关保留名称（如 openai、anthropic、gemini 等，系统提示换用如 `{id}-main` 形式）。
- **「名称」**：必填，供应商显示名称。
- **「接口地址」**：OpenAI 兼容类型必填，说明「不带 /v1，如 https://api.deepseek.com；以版本号结尾的（如 …/api/v3）原样用」。必须为 https 地址（控制台允许 http 时除外），不能携带用户名和密码。Anthropic 与 Google Gemini 类型可留空。
- **「数据所在区域」**：下拉选择区域（不限、中国境内、欧盟、美国）。
- **「API 密钥」**：供应商凭据。已保存时显示「已保存」，输入框占位显示「（保持不变）」，说明「保存后不再显示。」。
- **「模型」**：模型列表配置，说明「单位：每百万 tokens。成本价只用来算毛利。」。列包含启用开关、模型 ID、「租户 入」「租户 出」「成本 入」「成本 出」。提供「添加」按钮；对于 OpenAI 兼容类型，提供「从供应商读取」按钮。每家供应商必须「至少保留一个启用的模型，或者停用整个供应商」。
- **「测试连接」**：已有供应商在对话框中提供该按钮，说明「向第一个启用的模型发一条短消息。」。连通显示模型与延迟毫秒数，未连通显示「没通：」及错误信息。
- **「启用」开关**：位于底部，控制是否启用整个供应商。
- **「保存并同步」**：提交按钮。保存成功提示「已保存并同步到网关」；若网关同步失败，提示「已保存，但没有同步成功：」并附带错误详情。

### 托管运行

托管运行页面用于监控平台托管的应用进程状态：
- **页眉**：显示标题「托管运行」，右侧提供「刷新」按钮。
- **功能未启用提示**：若部署时未启用托管运行，显示空态「托管运行未开启（部署时使用 --apps）」。
- **统计三卡**：「托管的应用」总数、「运行中」数量与「异常」数量（异常时提示「见下表的“问题”一列」，正常时提示「没有异常」）。
- **「进程」表格**：
  - 「应用」：托管应用的名称。
  - 「状态」：状态徽章，包含「运行中」「启动中」「启动失败」「已停止」「未找到进程」。
  - 「版本」：当前运行的版本号（平台只运行最新上架版本）。
  - 「镜像」：展示缩短后的容器镜像摘要。
  - 「状态自」：当前状态的持续起始时间。
  - 「问题」：异常诊断信息。
  - 操作列：具备写权限时提供「查看日志」与「重启」按钮。
- **刷新与审计**：表格页脚注明「每 15 秒刷新」；查看日志对话框提示「最近 200 行。可能含租户数据，每次查看都记入平台审计。」。
- **空状态**：无托管应用时提示「还没有托管的应用」与「应用声明 runtime 并上架后会出现在这里。」。

### 服务导航

服务导航页面用于监控底层依赖组件与基础服务健康：
- **页眉**：显示标题「服务导航」，右侧提供「刷新」按钮。
- **状态四卡**：展示「运行中」「异常」「未部署」「未探测」4 种状态的服务数量。
- **「全部服务」区域**：
  - 刷新说明：注明「每 30 秒刷新」。
  - 筛选与搜索：提供「只看异常」开关与「搜索服务」输入框。
  - 服务卡片：按组件分组展示。卡片包含状态圆点、服务名称、状态徽章（运行中显示响应延迟毫秒数）。
    - 运行中服务：显示正常状态与延迟。
    - 异常服务：卡片标红，显示「没有正常响应」，并说明「会影响：」受影响的具体业务。
    - 未部署服务：展示对应安装命令参数提示（如 `install.sh --{profile}`）。
  - 卡片操作与信息：提供「打开」链接（配置了 URL 时展示，地址形如 `{服务}.ops.{基础域名}:8443`，属于管理网主机）；提供「怎么登录」操作（展开登录指引，实例域名显示为 `{域名}`）；展示底层依赖与文档路径。
- **空状态**：无异常服务时提示「没有异常的服务」；搜索无结果时提示「没有匹配的服务」。
- **典型组件**：包含 Grafana、Temporal、Langfuse、LLM 网关、OpenBao 等基础服务。

## 常用操作

### 添加模型供应商

1. 在左侧导航点击「运营」→「模型供应商」。
2. 点击右上角「添加供应商」，打开「添加模型供应商」对话框。
3. 填写基本信息与参数：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「类型」 | 是 | 选择供应商接口类型，支持「OpenAI 兼容」（说明「兼容 OpenAI 接口的服务，如 vLLM、Ollama。模型可从供应商读取。」）、「Anthropic」或「Google Gemini」（说明「接口地址可留空；模型需手填。」）。创建后类型不能修改。 |
   | 「ID」 | 是 | 供应商唯一标识，说明「创建后不能修改」。格式为 2–31 位小写字母、数字或连字符，且必须以字母开头。不能使用 `byo-` 前缀（留给租户自带密钥），不能使用网关保留名称（如 openai、anthropic、gemini 等，若使用系统提示换用如 `{id}-main` 形式）。 |
   | 「名称」 | 是 | 填写供应商展示名称。 |
   | 「接口地址」 | 条件必填 | OpenAI 兼容类型必填，说明「不带 /v1，如 https://api.deepseek.com；以版本号结尾的（如 …/api/v3）原样用」。必须为 https 地址（控制台允许 http 时除外），不能包含用户名和密码。Anthropic 与 Google Gemini 类型可留空。 |
   | 「数据所在区域」 | 否 | 下拉选择数据合规区域，可选不限、中国境内、欧盟或美国。 |
   | 「API 密钥」 | 是 | 输入访问该供应商的凭据密钥。保存后不再显示。 |
   | 「模型」 | 是 | 配置该供应商提供的模型列表，说明「单位：每百万 tokens。成本价只用来算毛利。」。可点击「添加」逐行填入，或若为 OpenAI 兼容类型可点击「从供应商读取」勾选添加。设置每行启用开关、模型 ID、「租户 入」「租户 出」「成本 入」「成本 出」价格。至少保留一个启用的模型，否则提示「至少保留一个启用的模型，或者停用整个供应商」。 |
   | 「启用」 | 否 | 底部开关，控制是否启用整个供应商。 |
4. 点击「保存并同步」按钮。
5. 保存成功后提示「已保存并同步到网关」。若网关同步失败，提示「已保存，但没有同步成功：」并附带错误详情。状态列显示为「已同步」或「同步失败」。

### 测试连接与编辑模型供应商

1. 在「模型供应商」列表中，找到目标供应商行，点击操作列的「编辑」。
2. 打开编辑对话框（标题显示编辑对应供应商名称）。类型与 ID 不可修改；密钥输入框占位显示「（保持不变）」，已保存显示「已保存」。
3. 点击「测试连接」按钮。系统「向第一个启用的模型发一条短消息。」进行连通性验证。
4. 若连接成功，显示第一个启用的模型 ID 与响应延迟毫秒数；若失败，提示「没通：」并展示错误详情。
5. 调整名称、接口地址、区域、密钥或模型定价，确认至少保留一个启用模型。
6. 点击「保存并同步」，更新配置并推送到模型网关。

### 从 OpenAI 兼容供应商读取模型

1. 在添加或编辑 OpenAI 兼容类型的供应商对话框中，确保已填入有效的「接口地址」与「API 密钥」。
2. 在「模型」配置区域，点击「从供应商读取」按钮。
3. 系统自动读取该端点返回的模型列表并呈现。
4. 在读取出的模型列表中，勾选需要启用的模型并添加到列表中。
5. 为新添加的模型配置「租户 入」「租户 出」「成本 入」「成本 出」价格（单位为每百万 tokens）。
6. 点击「保存并同步」完成配置。

### 删除模型供应商

1. 在「模型供应商」列表中，找到目标供应商行。
2. 点击操作列的「删除」按钮，弹出删除确认对话框。
3. 对话框提示删除该供应商后，「它的模型会从所有租户的可用列表消失，正在使用的租户需改用其他模型。」。
4. 确认删除操作。删除后该供应商及其模型从系统和网关中移除，操作自动记入[平台审计](/ops/audit)。

> **注意**
>
> 删除模型供应商会使该供应商的所有模型从所有租户的可用列表中消失。正在使用这些模型的租户将无法继续调用，须改用其他模型。

### 重新同步网关与修复配置漂移

1. 在「模型供应商」页面顶部，查看「与网关的一致性」状态面板。
2. 若面板提示网关与这里的记录存在不一致，查看漂移类型列表（包括「网关缺少供应商」「网关多出供应商」「供应商的模型对不上」「租户在网关没有密钥」「网关里有多余的租户密钥」等）。
3. 点击面板中的「重新同步」按钮（或点击页眉右上角的「重新同步」按钮）。
4. 系统按本页面的记录将所有供应商和租户密钥策略重推至模型网关。
5. 重新同步成功后，弹出提示「已把网关恢复成这里的记录」或「已把所有租户的策略重新同步到网关」，一致性状态恢复为「网关与这里的记录一致」。

### 查看模型用量与租户明细

1. 在「模型供应商」页面，切换到「用量与租户」标签页。
2. 在周期选择器中切换统计时间跨度，可选「7 天」「30 天」或「90 天」。
3. 查看顶部概览卡片中的总请求数（包含失败次数）、Tokens 消耗（输入与输出）以及「按目录价格估算」的估算费用。
4. 查看经营指标卡片：「收入（向租户收取）」「成本（付给供应商）」「毛利」与「失败率」。
5. 在「按租户」表格中查看各租户的请求数、Tokens、失败率、平均响应延迟、收入、成本、常用模型与调用趋势，并核查来源为「自带」还是「平台」。
6. 在「按模型」表格中查看各模型的调用请求数、Tokens 消耗与估算费用。
7. 若所选周期内没有调用数据，表格区域显示「这段时间没有调用」。

### 查看月度账单并导出 CSV

1. 在「模型供应商」页面，切换到「账单」标签页。
2. 在月份选择下拉菜单中选择需要查看的自然月。
3. 查看当月的财务汇总信息，包括应收总金额、「成本」与「毛利」。
4. 在租户分表明细中，核对每个租户调用的模型、密钥来源、请求数、输入 Tokens、输出 Tokens、消费金额与成本。若当月无调用，显示「这个月没有调用」。
5. 点击右上角「下载 CSV」按钮。
6. 浏览器自动下载当月账单对账明细文件，文件名格式为 `llm-statements-{月份}.csv`（例如 `llm-statements-2026-10.csv`），可作为发票与财务核算的内部底稿。

> **提示**
>
> 此处的账单是根据目录价格估算的平台内部核算账单，平台不会自动向客户发起收款或扣费。如需处理租户在线充值或支付，请参见[申请与支付](/ops/apply-pay)。

### 检查网关 Token 对账与重新对账

1. 在「模型供应商」页面，切换到「对账」标签页。
2. 查看页面顶部的对账结果横幅：
   - 若全部一致，显示「对得上」与「kwork 与网关的 token 计数一致。」；
   - 若存在差异，显示不一致的租户数量，并提示「出入超过 5% 或 200 tokens。常见原因：密钥当天重建、有调用没经过网关。」；
   - 若网关不可用，显示网关不可达相关警告。
3. 查看对账明细表格，核对租户名称、kwork 计 tokens、网关计 tokens、差异数量、双方统计的请求数，以及状态徽章（「一致」「有出入」「网关没有密钥」或「网关不可达」）。表格底部注明「按当前自然月对比；请求数仅供参考。」。
4. 如需更新或重新核对两端计数，点击表格上方的「重新对账」按钮，系统重新比对两端数据并刷新列表。

### 重启托管应用进程

1. 在左侧导航点击「运维」→「托管运行」。
2. 查看顶部「托管的应用」「运行中」与「异常」统计卡片。若存在异常，卡片提示「见下表的“问题”一列」。
3. 在「进程」表格中找到需要维护的目标应用，核对当前「状态」（如「运行中」或「启动失败」）、「版本」与「镜像」摘要。
4. 点击该行右侧的「重启」按钮。
5. 弹出确认对话框，提示「重启期间所有租户对该应用的请求会短暂失败。」。
6. 确认重启操作。系统向进程管理器发送重启指令，完成后弹出提示「已重启」，表格状态刷新。
7. 若应用当前处于未运行状态，点击重启会提示「进程没有在运行，无法重启」。

> **注意**
>
> 重启托管应用会导致该应用在重启期间短暂中断，期间所有租户对该应用的请求都会短暂失败。建议在业务低峰期执行，重启操作自动记入[平台审计](/ops/audit)。

### 查看托管应用进程日志

1. 在「托管运行」页面的「进程」表格中，找到目标应用行。
2. 点击该行右侧的「查看日志」按钮。
3. 弹出日志查看对话框，显示该应用进程的最近 200 行日志输出。对话框顶部明确提示「最近 200 行。可能含租户数据，每次查看都记入平台审计。」。
4. 若该应用进程当前未在运行，界面提示「进程没有在运行，没有日志可看。」；若进程尚无标准输出输出，内容区域显示「（没有输出）」。
5. 查看完毕后点击右上角关闭对话框。每次查看日志操作均自动记录至[平台审计](/ops/audit)。

> **注意**
>
> 托管应用进程日志中可能包含租户的业务输入或参数数据。为确保数据安全合规，平台对每次查看日志的操作都会记入[平台审计](/ops/audit)。

### 排查服务异常与查看登录指引

1. 在左侧导航点击「运维」→「服务导航」（或在[工作台](/ops/)待办中点击「平台未就绪」进入）。
2. 在顶部卡片查看服务的健康分布（「运行中」「异常」「未部署」「未探测」）。
3. 若服务较多，可开启「只看异常」开关只展示异常卡片，或在「搜索服务」输入框中输入服务名称进行筛选。
4. 在服务卡片中定位标红的异常服务，卡片显示「没有正常响应」，并列出「会影响：」说明受影响的具体系统能力。
5. 若服务卡片提供了「打开」按钮，点击该按钮可打开该运维组件的 Web 管理页面（如 Grafana、Temporal、Langfuse、LLM 网关、OpenBao 等，地址形如 `{服务}.ops.{基础域名}:8443`）。
6. 点击卡片中的「怎么登录」按钮，展开登录方式与凭据指引（其中 `{域名}` 对应当前实例域名）。
7. 排查并修复底层故障后，可在页眉点击「刷新」按钮（页面每 30 秒也会自动刷新探测一次），确认服务状态恢复为「运行中」。

## 状态说明

### 模型供应商状态

| 状态徽章 | 业务含义 |
|---|---|
| 「已同步」 | 供应商配置已成功推送到模型网关，网关配置与平台记录保持一致。 |
| 「未同步」 | 供应商已创建或配置已修改，但尚未完成向模型网关的下发推送。 |
| 「同步失败」 | 向模型网关下发推送配置时发生错误，需排查网关连通性后重新同步。 |
| 「已停用」 | 供应商已被停用，所有租户均无法调用该供应商旗下的模型。 |

### 网关一致性状态

```
平台记录 ───[ 重新同步 ]───> 推送配置 ───> 网关与这里的记录一致
   │
   └───[ 网关侧变动 / 未同步 ]───> 配置漂移（发现不一致处）
```

- **「网关与这里的记录一致」**：模型网关中的供应商与所有租户密钥，与平台数据库中的记录完全一致。
- **配置漂移（发现不一致处）**：网关记录与平台记录发生偏差。常见漂移类型包括：
  - 「网关缺少供应商」：平台已配置但网关尚未录入。
  - 「网关多出供应商」：网关存在平台未登记的供应商。
  - 「供应商的模型对不上」：模型列表或规格存在差异。
  - 「租户在网关没有密钥」：租户在平台已分配但网关缺少对应访问凭据。
  - 「网关里有多余的租户密钥」：网关存在已失效或多余的租户密钥记录。

### 托管应用进程状态

| 状态徽章 | 业务含义 |
|---|---|
| 「运行中」 | 应用进程正常运行中，可对外处理业务请求。 |
| 「启动中」 | 应用进程正在拉起初始化。 |
| 「启动失败」 | 应用进程拉起失败或异常退出，可查看「问题」列说明或日志排查。 |
| 「已停止」 | 应用进程已主动停止运行。 |
| 「未找到进程」 | 系统底层未检测到该应用的托管容器或进程实例。 |

### 网关 Token 对账状态

| 状态徽章 | 业务含义 |
|---|---|
| 「一致」 | 平台记录与网关记录的 Tokens 计数在容差范围内对得上。 |
| 「有出入」 | 两端计数差异超过 5% 或 200 tokens。常见原因包括租户密钥当天重建，或有部分调用绕过网关直接发起。 |
| 「网关没有密钥」 | 租户在模型网关中缺少对应的凭据记录，导致无法完成双向对账。 |
| 「网关不可达」 | 模型网关服务异常或探测超时，无法拉取网关计量数据。 |

### 服务导航健康状态

| 状态徽章 | 业务含义 |
|---|---|
| 「运行中」 | 服务探针正常响应，卡片显示响应延迟毫秒数。 |
| 「异常」 | 服务未正常响应，卡片展示「没有正常响应」与受影响能力说明。 |
| 「未部署」 | 部署时未开启该服务组件，卡片展示对应的部署脚本命令参数提示。 |
| 「未探测」 | 系统尚未对该组件完成探针健康检查。 |

## 让助手帮你做

平台助手（Agent）未接入模型供应商、托管运行或服务导航的管理操作。出于平台系统级安全与运维控制要求，你不能通过助手添加供应商、修改模型定价、重新同步网关、重启托管应用或查看进程日志。

涉及模型配置与运维控制的操作，均须由具备 `platform.ops` 权限的人员在控制台界面中手动核对并执行。

你可以向助手咨询相关配置规则与运维机制，例如：
> 怎么配置 OpenAI 兼容的模型供应商？
> 重启托管应用会对租户产生什么影响？
> 模型网关与控制台记录不一致时该怎么修复？
> 为什么查看托管运行的进程日志会被记入平台审计？

## 设置

模型与托管运行涉及的控制项与配置规则如下：

| 设置项 | 作用 | 取值与配置方式 | 权限要求 |
|---|---|---|---|
| 供应商基础配置 | 配置供应商接口类型、唯一 ID、名称、接口地址与数据所在区域 | 在添加或编辑供应商对话框中配置；ID 与类型创建后不可修改 | 仅 `platform.ops` 角色可配置 |
| 模型与定价 | 配置供应商下各模型的启用状态、租户定价与成本价格（单位：每百万 tokens） | 在模型列表中逐行添加，或针对 OpenAI 兼容供应商从接口读取后勾选 | 仅 `platform.ops` 角色可配置 |
| 用量统计周期 | 控制用量分析卡片与表格的统计时间范围 | 页面提供「7 天」「30 天」「90 天」切换选项 | `platform.ops` 与 `platform.support` 均可切换 |
| 账单结算周期 | 控制 LLM 用量明细账单核算的自然月份 | 在账单页面下拉选择目标月份 | `platform.ops` 与 `platform.support` 均可选择 |
| 进程自动刷新 | 保持托管运行与服务导航状态的最新探测结果 | 系统自动定时刷新：托管进程每 15 秒刷新；服务健康每 30 秒探测刷新 | 系统底层自动执行 |
| 部署环境组件开关 | 决定模型网关与托管运行功能是否可用 | 安装部署时通过命令行参数开启（网关使用 `--llm` 或 `--shell`；托管运行使用 `--apps`），界面不支持修改部署开关 | 部署运维人员在部署时配置 |

## 注意事项

- **API 密钥只显示一次**：供应商 API 密钥在保存后不再明文展示。后续编辑时仅显示「已保存」，输入框占位显示「（保持不变）」。
- **供应商删除影响全平台**：删除供应商会使该供应商的所有模型从所有租户的可用列表中消失。正在使用这些模型的租户将无法继续调用，须改用其他模型。
- **网关配置权威源**：若模型网关控制台被直接修改，会导致网关与本页记录发生漂移。系统始终以本页面的配置记录为唯一权威源，须点击「重新同步」将配置推回网关。
- **托管日志隐私与审计**：托管应用的运行日志中可能包含租户的业务输入数据。每次点击「查看日志」都会作为安全事件记录在[平台审计](/ops/audit)中。
- **进程重启短暂中断**：重启应用进程期间，所有租户对该应用的请求会发生短暂失败。
- **账单核算性质**：账单是按目录价格估算的内部核算账单，用于平台成本分析与毛利核算，平台不会自动向客户发起收款。客户实际付款与支付配置参见[申请与支付](/ops/apply-pay)。
- **管理网网络限制**：服务导航中的「打开」链接直连隔离管理网主机（端口 `:8443`），在公网环境下无法直接访问。
- **只读角色限制**：`platform.support` 角色为纯只读权限，无法添加、编辑、删除供应商，无法重新同步网关，无法重启应用，也无法查看日志。页面页脚会显示「你的角色只能查看」。

## 目前不支持

- **无独立网关与计费页**：没有单独的网关页或计费页，相关功能集成在「模型供应商」页面中。
- **套餐级模型额度**：暂未提供基于套餐级别的模型调用额度限制配置（套餐基础规格参见[套餐](/ops/plans)）。
- **托管进程出网与历史版本**：托管应用进程暂不支持主动访问公网（无出网能力），且平台仅支持运行最新上架的版本。
- **自动对接外部支付扣费**：本页的 LLM 账单不支持自动触发微信支付等外部支付渠道的自动扣款或开票。

## 常见问题

#### 添加 OpenAI 兼容供应商时，接口地址要不要带 `/v1`？
地址不以版本号结尾时（例如 `https://api.deepseek.com`），系统与模型网关自动补上 `/v1`，调用 `<地址>/v1/chat/completions`。地址以版本号结尾时（例如火山方舟的 `https://ark.cn-beijing.volces.com/api/v3`、智谱的 `https://open.bigmodel.cn/api/paas/v4`），接口路径直接接在后面，调用 `<地址>/chat/completions`，不再补 `/v1`。照供应商文档里的接口根地址填写即可；「添加供应商」里预置的供应商已带好地址。

#### 模型网关显示与这里的记录不一致时该怎么处理？
当出现「网关缺少供应商」「供应商的模型对不上」或「租户在网关没有密钥」等配置漂移提示时，说明网关底层的规则与平台控制台不一致。你可以点击一致性面板中的「重新同步」按钮（或页眉右上角的「重新同步」），系统会以本页面的记录为权威源，将所有供应商和租户策略重推至模型网关并恢复一致。

#### 为什么支持人员角色无法重启应用或查看进程日志？
这是由于权限隔离策略决定的。重启应用会导致租户请求短暂失败，而进程日志中可能包含租户的业务数据，属于高风险操作。因此平台将写操作权限（添加、编辑、删除供应商、重新同步、重启应用、查看日志）限制为仅 `platform.ops`（运营人员）可用。`platform.support`（支持人员）仅拥有只读权限，页面页脚会提示「你的角色只能查看」。

#### 为什么在浏览器中点击服务导航的「打开」链接无法打开页面？
服务导航中展示的管理组件（如 Grafana、Temporal、Langfuse、LLM 网关、OpenBao 等）均部署在受信任的内部隔离管理网段（主机形如 `{服务}.ops.{基础域名}:8443`），未向公网暴露。你必须确保操作终端已接入管理网或专用网络环境后方可访问。

#### 打开托管运行页面时，为什么显示「托管运行未开启」？
托管运行功能依赖底层部署时的开关配置。如果在安装平台时未包含 `--apps` 部署参数，系统就不会初始化托管应用运行环境，页面会显示空态「托管运行未开启（部署时使用 --apps）」。该开关属于安装部署层配置，无法在运营台界面中直接开启。