私有化交付

员工更新于 2026-10-21v3.0

本册的截图和说法以 2026-10-21 的界面为准;之后上线的变化见「新功能」。 新功能

前言这本手册讲什么

私有化交付要回答两件事:这套部署有没有被授权跑,以及现在能不能放行给客户装。前者是许可证,后者是交付前的只读检查。

出问题时按症状查故障排查表,要确认上限与配额查限制与配额速查表,遇到不认识的词查全套共用的术语表——三张表都在首页「随时可查」里。

第 1 章授权与续期 — 这套部署凭什么能跑

私有化交付的第一个问题不是「装好了没有」,是「这套部署被授权跑了没有」。答案只在一个地方:「设置 > 授权与续期」。这一页先告诉你当前处于什么模式,再告诉你凭什么。

页面标题旁就是结论:一枚状态徽章。没有许可证时徽章写未配置许可证,旁边说明图标里的话是「当前部署没有配置许可证,因此没有到期时间,也没有由许可证设定的功能或用量上限」——这不是提示,这是判决。它意味着这套部署没有装许可证,只能用来自己验一验,不能放行给客户。

授权与续期页,当前处于开发模式
图 1-1「当前状态」区把同一句判断再说一遍,并给出两个只读日期:有效期截止与宽限期截止。许可证没带的日期不再印成「未提供」,整行直接不显示;没有许可证时「当前状态」区本身也不出现(声明了部署环境时,它收在右上角「更多授权操作 › 交付/运维详情」里)。

两个日期该怎么读

有许可证的部署,这两个日期是交付负责人最该盯的字段。有效期截止是许可证正常生效的最后一天;宽限期截止是过期之后仍然容许运行的缓冲期终点。宽限期是给你留的续期时间,不是可以长期停在那里的状态。宽限期一旦走完,新的 AI、运行环境、自动任务和业务写入会停止(仍可登录、查看已有数据并按权限导出),全站会出现一条红色横幅——这条症状在故障排查表里也收录了。

本版手册的截图取自未授权状态

这一页的内容依赖许可证状态:装了证和没装证,看到的是两套内容。手册里这两张图拍摄于没有许可证的环境,所以你看到的是未配置许可证时的样子。正式授权后这一页会变成什么,本版手册没有截图,待补。可以确定的只有页面自己写明的结构:模式徽章、两个截止日期、三张额度卡、已授权功能清单、续期说明——正式授权后填进去的是值,框架不变。

这一页只读,不要在这里找上传入口

页面最下方的「续期与运维」区把边界写得很直白:许可证替换由部署负责人按交付流程完成,本页只读,不上传私钥、签名、机器指纹或原始许可证文件。换句话说,续期动作发生在服务端,不发生在控制台。管理员在这一页能做的只有两件事——看当前状态,以及把状态告诉该处理的人。

用平台交付账号登录时,同一区块末尾有一个按钮「查看部署检查」(组织管理员看不到它,「续期与运维」只是一段可展开的说明),直接跳到 第 3 章 讲的那一页。这个跳转是有意为之:授权状态本身也是部署检查里的一条检查项,两页看的是同一件事的两个面。

第 2 章用量与授权额度 — 席位、并发、Agent 各用了多少

正文第一块是「本组织用量与部署授权额度」,标题旁的说明图标里写着这一区的口径。

说明图标里的那句话先划清口径:已用量只统计当前组织;授权上限来自本部署许可证,不展示其它组织明细。这句话在一套跑多个组织的部署里很关键——你在这里看到的数字只代表你自己这一家,不要拿它去推断整套部署的负载。

点过刷新状态之后的授权与续期页
图 2-1右上角「更多授权操作」菜单里的「刷新状态」重新读一次。本图是点过之后的样子:内容与上一张一模一样——状态本来就没变,重新读也不会变。三张卡的写法都是「实测值 / 授权上限」。

三张卡分别在数什么

卡片数的是什么本图取值
已分配席位本组织已经分出去的账号席位数,是个累计量7 / 未设授权上限
当前并发用户此刻同时在线的用户数,是个瞬时量0 / 未设授权上限
运行中数字员工此刻正在跑的数字员工实例数,同样是瞬时量0 / 未设授权上限

分清累计量和瞬时量,读数才不会误判。已分配席位逼近上限,说明该清理不再使用的账号或者加购席位;当前并发用户顶格,表现是新登录被挡住,界面上的原话是「当前组织并发登录额度已满,请稍后重试」。这两种情况的处理方式完全不同,别混着看。

「未设授权上限」不是正常终态

本图三张卡的分母全部写着「未设授权上限」。这是拍摄环境没有许可证的直接后果——上限本来就该由许可证提供。请不要把它当成产品的正常状态来交付。一套正式授权的部署,这三个分母应该是许可证里写明的容量数字;如果装了证仍然三项全是「未设授权上限」,那就是许可证或读取环节出了问题,要找部署负责人核。容量本身属于套餐与许可证决定的数字,不在限制与配额速查表的固定取值里,一切以这一页显示的为准。

已授权功能

再往下是「已授权功能」区,列的是这份许可证放开了哪些能力。本图写的是「未配置许可证,无功能清单。」——同样是因为没有许可证,没有清单可列。正式授权后这一区里会出现什么条目,本版手册没有截图,待补。交付时如果客户问「我买的那个模块开了没有」,答案就该在这一区,而不是靠翻菜单猜。

第 3 章交付前的部署检查 — 一次只读体检,判断能不能放行

授权回答的是「能不能跑」,部署检查回答的是「现在能不能放行给客户装」。进入「交付 > 部署检查」,点右上角「运行部署检查」。

按钮下面有一行小字,是这一页最重要的免责说明:只读检查 · 不执行安装。它不改任何配置、不装任何东西、不会把环境跑坏。所以在拿不准的时候,跑一次永远是安全的。

部署检查的结果页
图 3-1跑完先给三个数和一个结论:检查 12 · 阻断 0 · 提醒 8,右边跟着放行结论徽章「放行·待补提醒」。12 = 8 条提醒 + 表格下方「已通过检查」折叠区里的 4 项。

先看三个数,再看那句建议

阻断是硬门槛:只要不是 0,就不该放行。提醒是软门槛:不挡放行,但每一条都得有人认领。本图阻断为 0、提醒为 8,所以结论是「放行·待补提醒」,紧跟着的一句建议把责任分得很清楚——可以小范围继续,但先处理提醒项;部署负责人补齐提醒项,试用负责人可安排受控试问和业务验收。

这句话的实际含义是:这个状态可以进小范围试用,不能进正式交付。「小范围继续」和「放行给客户装」是两回事,交付放行的门槛要更高——至少许可证那一条提醒得先消掉(见 第 1 章)。

报告头:这份报告对什么有效

计数行下面那一行灰字是报告头,写着这份报告的生成时间、它对应的提交、以及它是否声明了正式部署档案。本图写的是「未声明正式部署档案」——和表格第一行说的是同一件事。

报告只对这一次的提交有效

报告头末尾的原话是:报告仅对应此提交/部署档案,代码、配置、数据目录、模型通道或验收证据变更后须重新运行部署检查。这五个触发条件要当成清单用——改过模型通道、动过数据目录、补了一批验收证据,之前那份报告就作废了,不能拿去当交付证据。

表格下面的两个折叠区

表格只展开需要处理的项。通过的项收在「已通过检查」折叠区里,右端标着条目数(本图 4 项);这一次读到的原始依据收在「证据明细」折叠区里(本图同样 4 项)。日常看结论不用展开;要向客户或审计交代「你凭什么说通过了」的时候,展开证据明细。这和数据主权与合规里「产品支持这么做」与「已经有证据」的区分是同一个思路。

第 4 章逐条读检查结果 — 八条提醒各在查什么

表格四列:检查项 / 结论 / 结果 / 下一步。「结果」是这次读到了什么,「下一步」是产品直接给出的处理建议——大多数时候照做即可,不必自己发挥。下面按截图上真实列出的八条逐条讲。

再跑一次部署检查,结论未变
图 4-1同一页面隔两分钟再跑一次。除了报告头里的生成时间,八行提醒的文案、计数和折叠区条目数完全没变——环境没动,报告就不会动。重跑不是解决问题的办法,先做实际改动再重跑。

1. 部署档案

结果:「未声明正式部署档案,当前更像本地开发或试用环境。」它在问的是——这套部署到底是哪一套,有没有登记在案。下一步写得很具体:正式交付前补充部署档案,明确客户环境、网络、证书、存储、身份源和模型策略。这六项就是补档案时要填的清单。这一条不消掉,后面所有结论都只是「某台机器上的一次自测」。

2. 许可证模式

结果:「当前为未配置许可证的开发/试用模式。」和 第 1 章 看到的是同一件事,只是换了个地方说。下一步:生产部署前安装离线许可证,并保留授权验收证据。注意后半句——装上不算完,得留下能拿出来的凭据。

3–6. 四条脚本类检查

「标准启动与冒烟脚本」「私有化安装脚本」「备份准备状态」「恢复演练检查」这四条,结果的措辞几乎一样:当前进程不是源码检出,看不到对应的脚本。下一步也一样:在构建/交付流水线里核对,并把结论作为交付证据带上。

  • 标准启动与冒烟脚本——这套部署是不是按标准方式启动的,有没有开机自检。
  • 私有化安装脚本——交付安装用的是不是受控的那一套流程,而不是手工拼出来的。
  • 备份准备状态——有没有受控的备份手段,出事之后有东西可以还原。
  • 恢复演练检查——备份不只是存在,而且演练过、真能还原回来。

有些问题它诚实地不回答

运行中的部署镜像里本来就不带这些交付脚本,所以站在部署内部无法判断。产品的处理方式是显示为提醒、并说明该去构建与交付流水线里核对,而不是给一个运维在这台机器上根本处理不掉的阻断。不要在这一页等它们变绿——它们在这里永远变不绿。正确做法是在流水线侧核对完,把结论作为交付证据带上。

7. 验收证据目录

结果:「尚未发现验收证据目录。」它在找的是这次交付的验收产物存放处。下一步是先跑完标准的启动与管理端冒烟测试,或者等待流水线生成验收证据,之后再做交付验收。也就是说:证据没生成之前,验收这一步不成立。

8. 当前提交验收门禁

结果开头是「当前提交验收门禁未就绪」,后面逐个列出这次提交缺少哪几项测试的证据——从启动冒烟、开发态冒烟、管理端冒烟,到界面质量检查和几项端到端用例。下一步写明:还没有可用于当前提交验收的证据,请先把这几项跑完。

第 7 条和第 8 条是一组:第 7 条说「一份证据都没有」,第 8 条说「具体缺哪几份」。修的是同一件事,看第 8 条的清单去补最省事。

这一版的行数还会变

本图把八条提醒平铺成八行,其中有四条其实同因(都因为「不是源码检出」)。产品现在会把同因同解的提醒合并成一行,表格上方注明「N 项检查合并为 M 行」,展开可看每一项,所以行数会少于本图。请按每一条在查什么来理解,不要把「八行」当成固定的产品形态记住。合并后的界面本版手册没有截图,待补。

第 5 章一次完整的交付放行 — 从进页面到给出结论

把前面几章串起来,一次交付前的放行判断是这样走的。前七步在本版手册里全程有截图佐证;第八步开始需要一套已授权的环境,本版手册没有覆盖。

看授权状态看用量与额度跑部署检查逐条认领提醒补证据后重跑放行
  1. 打开「设置 > 授权与续期」。看标题旁那枚徽章。写着「未配置许可证」就到此为止——这套部署还没被授权,不用往下走了,先去要许可证。
  2. 有许可证的部署,看「当前状态」里的有效期截止与宽限期截止。两个日期都在未来,才算这一步过。已经进入宽限期的,交付前必须先续期。
  3. 点右上角「更多授权操作」里的「刷新状态」重读一次,确认刚才看到的不是旧数据。页面内容不变是正常的——状态没变,重读就不会变。
  4. 看「本组织用量与部署授权额度」三张卡:已分配席位、当前并发用户、运行中数字员工。逐张对照分母上的授权上限。三个分母都能读到具体数字,这一步才算过;全是「未设授权上限」说明许可证没提供容量,回上一步查。
  5. 顺手看一眼「已授权功能」,确认客户买的模块在清单里。
  6. 用平台交付账号点「续期与运维」区里的「查看部署检查」(或从「交付 > 部署检查」进入)跳到部署检查页,点右上角「运行部署检查」。这是只读检查,不装任何东西,跑坏不了。
  7. 跑完先看三个数:阻断必须是 0,否则不放行,没有商量余地。阻断为 0 时看放行结论徽章和紧跟的那句建议,它会告诉你这个状态能到哪一步——比如「放行·待补提醒」的含义是可以小范围试用、还不能正式交付。
  8. 逐条读提醒表的「结果」和「下一步」,给每一条指定处理人:许可证与部署档案归部署负责人;脚本类的四条去构建与交付流水线里核对,不要在这一页等;验收证据类的两条去把缺的测试跑完。
  9. 所有提醒都处理完之后,回到部署检查页重新运行一次。这一步不能省——报告只对当时那一次提交有效,代码、配置、数据目录、模型通道或验收证据动过,旧报告就作废。
  10. 展开「证据明细」折叠区,把本次检查的读取依据留档,连同许可证的授权验收证据一起作为交付材料。

这条流程在哪里卡住了

第 2、4、5 步和最后的「放行」态,都需要一套装了许可证的部署才看得到。本版手册的截图全部取自未授权环境,因此这几步只能按页面自己写明的字段结构来描述,没有正式授权后的界面截图可供对照——待补。同样,本图的部署检查始终停在「放行·待补提醒」,产品在全部检查通过时给出的结论徽章长什么样,手册里也没有截图。

第 6 章排查表 — 屏幕上那句话是什么意思

按你在这两页上看到的原话查。这一模块的绝大多数「异常」其实不是故障,而是环境确实还没到那一步——分清这两者,能省掉大量无效排查。

症状可能原因去哪看怎么处理
未配置许可证这套部署没装许可证。不是读取失败,也不是权限问题。第 1 章联系部署负责人按交付流程安装离线许可证。未授权前不要放行给客户。
看不到「有效期截止」「宽限期截止」没有许可证就没有有效期可读。第 1 章先装许可证;装好后回本页确认两个日期都在未来。
三张额度卡的分母都写「未设授权上限」当前部署没有从许可证读到席位、并发与数字员工的容量。第 2 章这不是正常终态。找部署负责人确认许可证里是否写明容量,装证后复查。
未配置许可证,无功能清单。没有许可证,就没有功能授权清单可列。第 2 章装证后复查;客户问「买的模块开了没有」以这一区为准。
当前组织并发登录额度已满,请稍后重试同时在线人数达到许可证的并发上限。第 2 章等他人退出,或联系部署负责人调整授权额度。注意这是瞬时量,与席位数是两回事。
许可证宽限期已结束(全站红色横幅)许可证已过期,新的 AI、运行环境、自动任务和业务写入已停止;仍可登录、查看已有数据并按权限导出。故障排查表联系部署负责人续期。宽限期是缓冲,不是可以长期停留的状态。
未声明正式部署档案,当前更像本地开发或试用环境没有登记这是哪一套正式部署。第 4 章补部署档案,明确客户环境、网络、证书、存储、身份源和模型策略。
当前进程不是源码检出,看不到启动与冒烟脚本运行镜像里不带交付脚本,站在部署内部无法判断(另外三条脚本类检查同理)。第 4 章去构建与交付流水线里核对,把结论作为交付证据带上。不要在这一页等它变绿。
尚未发现验收证据目录这次提交还没有跑出任何验收产物。第 4 章先跑完标准的启动与管理端冒烟测试,或等流水线生成证据,再回来重跑部署检查。
当前提交验收门禁未就绪缺少若干项测试的证据,结果一栏逐个列出了缺哪几项。第 4 章照结果里列的清单把缺的测试补齐,然后重跑部署检查。
重跑之后结论一模一样,只有生成时间变了环境没有发生变化,报告就不会变。重跑不解决问题。第 3 章先按「下一步」做实际改动,改完再重跑。
改完配置,报告却还是旧结论看的是上一次的报告。报告只对生成它的那一次提交有效。第 3 章代码、配置、数据目录、模型通道或验收证据变更后,必须重新运行部署检查。

这一页找不到许可证上传入口,是设计如此

「授权与续期」明确写着本页只读,不上传私钥、签名、机器指纹或原始许可证文件。翻遍页面也找不到上传按钮不是缺陷——续期动作发生在服务端,由部署负责人完成。管理员在这里的职责是发现问题并转交,不是自己动手。