用应用与 AI 扩展能力

站点后台的侧栏是固定的：装了多少应用，它都不会变长。原因是应用不往侧栏里插菜单，而是统一收在应用中心这一个入口里；而增强能力（AI、云打印、开放 API）虽然常驻侧栏，但没开通时是灰的，点开会告诉你怎么开。先理解这两条规则，后面的页面就都好找了。

应用中心：打开已装的应用

侧栏顶级那一行「应用中心」（侧栏收起时显示为「应用」）是本站点全部应用与插件的唯一入口。页面分上下两区，两区的东西点开后行为不一样，这是本页最需要先分清的一件事。

1. 1

   进去

   点应用卡片的任意位置，或右下角的「进入」按钮，落到该应用的第一个功能页。

2. 2

   在里面

   侧栏此刻只剩这个应用的功能。应用内部的下钻页（订单详情、编辑页这类没有菜单项的页面）同样算在工作区里，不会点着点着掉回站点菜单。

3. 3

   出来

   点侧栏第一行「返回站点」，菜单换回站点自己的会员 / 营销 / 交易那一套。

唯一的例外是「跨树线索」：应用可以声明自己归属哪个分组，那个分组的末尾就会多出一行「XX 应用」的入口（例如商城把优惠券、限时秒杀、拼团这类页面归在「营销」下）。它只是一块指路牌，点进去同样是整树切入该应用的工作区。

想不起来某个功能在哪一层，按 Ctrl / ⌘ + K 搜。搜索索引里同时有站点核心页面和全部应用页面：在站点菜单下能直接搜到应用内的页（如「限时秒杀」）并回车直达，在应用工作区里也能搜回站点自己的页面。

页面是空的，两种原因别搞混

设置 → 应用授权：绑定与名额

应用中心页头右上角常驻一个「管理已绑定的应用」按钮，点它直达；也可以走设置 → 应用授权。这一页管的是「本站点绑了哪些应用、还剩多少名额」，与应用中心的「打开应用」是完全不同的两件事。绑定后，该应用的管理页与接口才对本站点开放。

名额的规则只有一条，但很关键：一枚名额同一时间只能绑一个站点。绑定即占用一枚，解绑才会还回来。所以多店客户的常见动作不是「买更多」，而是先看看名额被哪家店占着。

名额不足时

可用名额为 0 时，「绑定」按钮不会变成一个不说话的灰按钮，而是变成「名额不足 · 查看说明」。点开会把账算给你看：本租户这个应用共划拨多少枚、已被站点占用多少枚、多少枚正在冷却（以及最早哪天可用）、当前可用 0 枚。接着给三条出路：

• 请租户所有者到租户后台的「名额概览」核对占用情况——多半是某个店占着没在用。
• 向平台方申请增配名额。
• 在那个不再使用该应用的站点里先解绑，把名额腾出来（注意下面的冷却规则）。

解绑与冷却

点「解绑」会先弹确认，里面写清楚两件事：解绑后本站点无法再访问该应用的页面与接口；这枚名额会进入冷却（天数由部署方设置，确认框里会写出具体数字），冷却期间只能绑回本站点，其它站点用不了，平台方也无法提前回收。

同一页下方的「插件」

插件是单页的小功能（打印服务商、支付通道这类）。平台一个插件都没装时，这块区域整个不显示；装了才会出现一张表。

「本站状态」一列有三种：生效中、父应用未绑定、已关闭。关掉的插件，它的页面也会从应用中心的插件区消失。

灰掉的菜单：能力还没开通

侧栏里有两种「打不开」，长得不一样，找的人也不一样——这是本章最值得记住的一张表。

灰行刻意不删掉——删了你永远不会知道产品还有这个功能。它们收在分组末尾的「更多能力（N）」折叠条里；如果整个分组都没开通（比如基础套餐下的 AI 组），就直接摊开显示，不再多折一层。

点灰行不会跳转，而是弹出一个「XX · 尚未开通」的说明框：先一句话说明这项能力是干什么的，再说开通方式——联系平台开通或升级套餐；如果租户后台针对本站点单独设置过功能限制，还需要在那里把这一项放开。说明框里没有「去升级」按钮，是因为站点后台本身就没有升级入口，画一个跳不过去的按钮比不画更糟。

「点数套餐」故意不在这张表里：它管的是卖点数收钱，和开没开某种 AI 生成能力是两件事，所以任何时候都能配。

AI 生图与 AI 视频

这两页结构一模一样，站点这边只决定三件事：用哪个模型、每次扣多少点、允许顾客选哪些规格。模型本身由平台方接入（平台后台的「产品 → AI 模型接入」），站点只能从平台放行的清单里挑。

所以页面顶部的两条提示要分清：黄色的「AI 生图未对当前站点开放，请联系平台方或升级套餐后使用」是本站点没这项能力（此时侧栏那一行也是灰的，你多半是从收藏链接直接进来的）；而普通提示「平台尚未配置生图接入，暂无法启用生图」是能力开了、但平台还没接模型，等平台接完再来选即可。两种都不是报错。

改完点「保存配置」。有未保存改动时按钮旁边会一直挂着「未保存」，保存成功变成「已保存」；此时切去别的页面会先问一句，可以选「留在此页」。没有 AI 管理权限的人能看不能改，表单底部会明说「你没有修改生图配置的权限」。

页面下方的「本周期用量」卡片写明计量单位与当前周期，站点与租户各一行：「已用 X / Y（剩 Z）」并配一条进度条，不限量时写成「已用 X · 不限」且不画进度条。上限来自套餐，快用完就该找平台方了。

点数套餐：把点数卖出去

模型配好只解决「能生成」，顾客手里还得有点数。「AI → 点数套餐」就是面向会员售卖的充值包，也是这一组里唯一不受能力开关限制的页面。

1. 1

   新建套餐

   点右上角「新建套餐」，先给一个顾客看得懂的名字，例如「100 点充值包」。

2. 2

   定到账点数

   到账点数 = 面值点数 + 赠送点数，两者之和必须大于 0。不做赠送就把赠送填 0。

3. 3

   定价

   售价按元填写（例如 9.90），范围 0.01 ~ 1,000,000 元。系统内部按分记账，你不用操心小数误差。

4. 4

   定有效期与顺序

   有效天数是顾客买到的点数的有效期，填 0 表示永久有效；排序数字控制前台的展示先后。

5. 5

   上架

   打开「上架状态」开关再保存，套餐即刻对外售卖；先不卖就关掉开关存为下架。

云打印：单据自动出小票

设置 → 云打印，两个页签：「打印机」管配置，「打印记录」管排查。逻辑是订阅制——你给每台打印机勾选它关心的场景，业务单据一产生，系统自动往订阅了该场景的打印机派发任务。

1. 1

   新增打印机

   在「打印机」页签点右上角「新增打印机」，进入独立的编辑页。

2. 2

   填基本信息

   名称（例如「前台打印机」）、份数（1~5 份，同一张单据要打几联就填几）、启用状态。

3. 3

   选打印服务商并填凭证

   选定服务商后，下面的凭证字段会跟着换成它要求的那几项。凭证以密文保存，编辑时敏感字段留空即表示保留已保存的值；中途换服务商会清空已填凭证，需要重填。

4. 4

   勾订阅场景

   勾中的业务场景产生单据时，才会往这台打印机派任务。一台打印机可以订阅多个场景。

5. 5

   保存后测试

   回到列表点这一行的「测试打印」，页面提示「已发送测试打印」后，去看机器是否真的出纸。

列表里的「凭证态」是快速体检：已配置 / 未配全（该服务商要求的密钥还有没填的）/ 无需凭证。看到「未配全」就别指望它能打出来，先去编辑页补齐。

「打印记录」页签按状态筛选（全部状态 / 待打印 / 成功 / 失败），每行可以「查看内容」看这张小票到底打了什么字。列表里还有「待打印」的任务时，页面会自己刷新，全部出结果后自动停下——不用手动刷。

删除打印机只是让它不再接收新任务，历史打印记录仍然保留，事后仍可追溯。

开放 API：让自己的系统读数据

设置 → 开放 API，用来给你自己的 ERP、收银、报表系统发一把钥匙，让它按你授权的范围读写本站点的数据。数据自动限定在本站点——拿这把钥匙读不到别人的店，也不需要（更不能）在请求里传站点参数。

1. 1

   新建凭证

   点右上角「新建凭证」，填一个能认出用途的应用名称（如「ERP 数据同步」），再勾选数据权限范围，至少勾一个。

2. 2

   立刻保存 token

   保存后会弹出 token 并且只显示这一次。当场复制交给对接方；关掉弹窗就再也看不到了，只能重置换一把新的。

3. 3

   对接方调用

   在请求头里带上 Authorization: Bearer {token} 即可。列表里的「调用次数」和「最近调用」会随之动起来，可以据此确认对方是否真的接通了。

4. 4

   按需开启签名

   安全要求高的场景，在这一行的「更多」菜单里「开启签名」，系统生成签名密钥（同样只显示一次），此后调用还须附带签名。

列表里每一行都能看到 App Key、已授权范围、token 尾码（tk_**** 加上末尾四位，用来认出这是哪一把）、签名是否开启、启用状态、累计调用次数与最近调用时间。长期显示「从未」调用的凭证，多半是当初测试留下的，该停用就停用。

开启签名后，调用方除了带 token，还要对请求做 HMAC-SHA256 签名，附带 X-Tf-Timestamp、X-Tf-Nonce、X-Tf-Signature 三个请求头，具体规则写在上面那份自描述规格里。密钥同样只显示一次，忘了就「重置密钥」；「关闭签名」会清空密钥，此后只凭 token 认证。