所有页面的共同起点
先选维护对象，再登录 API
顶部的 API、地址、客户和登录身份决定本次所有查看与保存作用于哪个账套。没有选中维护目标时，不做配置。
- 1Factory API 登录
- 2选择 API
- 3地址与当前维护对象
- 4切换账套或 API
- 1
输入运维账号并登录
账号由当前 API 管理。Factory API 没有名为“实施员账号”的角色：实施员使用可验证的 Admin 技术身份，运维管理员使用 Ops；不要把 ERP 业务账号、客户追溯访问码或 ADMIN 恢复密码当作普通运维登录密码。
- 2
从候选中选择 API
点“扫描已部署”刷新本机实例，再从下拉框选真实实例。候选可输入筛选，最终必须明确选中一项。
- 3
核对地址与维护对象
确认客户、账套、端口和地址一致。地址框用于明确连接目标，不应用一个旧地址猜测另一个账套。
- 4
切换账套前保存或取消
“切换账套/API”会改变后续所有页面的数据源。未保存的输入要先处理，切换后重新确认登录身份。
完成结果：顶部显示已登录，当前维护对象与准备操作的客户账套完全一致。
页面 · 运维总览
看清运行状态，再决定是否控制服务
总览用于查看实例、授权、用户和健康状态；检查是只读。重启只在 API 在线且当前 Admin/Ops 会话通过实时复核时可用；停止会持续中断现场。
- 1总览入口
- 2实例与服务状态
- 3授权与健康状态
- 4检查、重启、停止
- 1
刷新当前总览
进入页面或切换 API 后先刷新。页面只展示当前实例事实，不把另一个账套的上次结果沿用过来。
- 2
检查实例和服务
核对任务、端口、运行目录、服务可达性及数据库连接。单项失败时先看具体原因，不因“页面能打开”就判断服务正常。
- 3
检查授权与业务健康
授权有效期、并发限制、用户数量和移动功能状态应互相一致。已过期、未绑定或 Blocked 都会影响 APP。
- 4
按权限和恢复路径控制服务
“检查”不改变服务；“重启”会短暂断开连接；“停止”会持续中断 APP。重启/停止必须先选中本机正式实例，并以当前 Factory API 的 Admin/Ops 登录完成实时复核，再通过 Windows UAC。停止后本 API 已离线，运维工具不能再用本地会话启动，必须回实施工具登录平台后恢复。
完成结果：操作对象、影响和恢复责任都已确认；API 离线时按钮锁定并明确指向实施工具。
页面 · 用户与密码
维护账号、执行身份、密码和会话
该页同时管理移动用户资料、启停归档、ERP 执行身份、普通密码重置和登录会话；这些动作的影响不同。
- 1用户列表与新增
- 2资料与账号状态
- 3ERP 执行身份与密码
- 4登录会话维护
- 1
刷新、选择或新增用户
“刷新用户”读取当前 API 的正式用户；“新增”开始空白资料；“登录会话”查看该用户设备会话。先选中用户再做状态动作。
- 2
保存资料并控制账号状态
“创建用户/保存资料”写姓名、账号和角色；“启用、停用、归档、删除”分别代表恢复使用、禁止登录、保留历史退出使用、在满足条件时移除。删除前必须确认历史与依赖。
- 3
维护 ERP 执行身份与普通密码
执行身份决定移动提交在旧 ERP 中以谁的权限执行，可选、保存或清除；普通密码重置只改变该移动用户登录密码，不改变 ERP 身份。
- 4
处理异常会话
“强制下线”立即使所选用户现有会话失效；“清理过期/清空会话”用于设备更换、异常占用或安全处置。正常换页不需要清会话。
完成结果：用户状态、角色、ERP 身份和有效会话符合实际岗位，停用账号无法继续调用 API。
页面 · 客户追溯授权
给外部客户发放可停用、可审计的查询码
客户追溯码只用于被授权客户查询，不是员工 APP 登录账号，也不是永久不受控的共享密码。
- 1已发放查询码
- 2授权策略与客户
- 3访问码、密码和备注
- 4查询日志
- 1
刷新或选择已发放查询码
左侧每一条对应一个客户访问入口。选择后可以启用或停用；不要把同一码发给多个互不相关客户。
- 2
选择授权策略、有效期和客户
先选客户查询策略，再选永久或到期日，最后加载并选中正式客户。临时授权应设置明确到期时间。
- 3
填写访问码与一次记牢密码
访问码用于识别客户，可填写便于辨认的名称；密码至少 8 位，可随机生成。密码只在发放时交给客户，系统不会反复明文显示。
- 4
发放、停用并审计查询
“发放/保存”写入授权；“启用选中/停用选中”控制查询资格；“查看询日志”用于判断谁、何时、查询了什么。
完成结果：客户只能查询授权范围，授权可到期或停用，并有查询日志可追溯。
页面 · 授权·状态
查看当前授权，按现状申请续期并重新应用
这一页只处理当前实例的普通续期：本地 Admin/Ops 可按现有身份和并发提交，不能改变客户、账套、服务器身份或绑定 API Key。
- 1授权主体与身份
- 2有效期与并发
- 3刷新和同步授权
- 4结果与问题说明
- 1
选中实例并登录当前 API
先在顶部选中实际运行实例，再用该 Factory API 的本地 Admin 或 Ops 登录。客户、账套和服务器指纹必须对应当前 API；Designer/User 无权续期。
- 2
核对只读身份与并发
客户、账套、服务器身份和并发数来自当前运行授权，只读不可改。若任一身份或并发需求要变化，这不是普通续期，应交实施员回实施工具办理。
- 3
按现状申请续期
点击“按现状申请续期”。Factory API 会再次校验当前 Admin/Ops 会话，并以现有身份、并发和服务器证明生成 Renewal；客户端填写值不能覆盖这些事实。平台尚未批准时，申请只处于待审状态。
- 4
平台批准后重新应用
管理员在平台批准后，回到当前实例点击“重新应用已审结果”，再刷新状态。身份不符、签名无效、授权过期和平台不可达应按原始错误分别处理，不能手改本地状态文件。
完成结果：当前授权显示有效，身份未变化，有效期符合平台批准资料；若未批准则明确停在待审状态。
页面 · 通用标签模板
设计可复用模板，并用真实字段预览
模板负责版式；具体移动功能负责选择哪张模板、提供哪些字段。改模板会影响所有引用它的功能。
- 1模板列表与新建复制
- 2纸张、方向和打印机
- 3文本、条码和图片元素
- 4预览、保存和试打
- 1
选择、新建或复制模板
修改前先看引用范围。相似版式可复制后改名，避免直接改一张正被多个功能使用的正式模板。删除前必须确认无引用。
- 2
设置介质和输出设备
按实际标签宽高、边距、方向、DPI 和打印机能力配置。旋转预览、屏幕缩放和真实纸张尺寸不是同一回事。
- 3
放置元素并绑定字段
文本、条码/二维码、图片和线框各自设置位置、尺寸、字体与数据字段。固定文字与业务字段要区分；字段名必须来自功能的正式读回结果。
- 4
预览、保存并试打
先用样例数据检查遮挡、截断和扫码质量，再保存；现场有标签机时用真实数据试打。补打仍使用原记录的模板和快照。
完成结果：屏幕预览与实体标签内容一致，条码可识别，且没有误改其他功能的正式模板。
页面 · 货品识别
配置照片、特征与货品候选范围
识别只帮助操作员缩小真实货品候选，最终选择仍是正式货品；不能把模糊命中自动保存成业务事实。
- 1识别策略与状态
- 2照片和特征配置
- 3候选范围和阈值
- 4保存与重建
- 1
选择识别配置与启停状态
每个账套按实际货品和业务范围配置。停用时 APP 仍应允许通过正式候选选择货品，不得因识别不可用阻断基本业务。
- 2
设置照片与特征来源
确认照片目录、拍摄角度、样本数量和特征生成方式。照片属于业务证据，路径不可指向临时目录或另一个账套。
- 3
限制货品候选范围
来货识别只能在当前客户有业务关系的货品中筛选；生产和出货按各自正式范围。阈值越高越严格，但不能用阈值掩盖错误样本。
- 4
保存并在测试页复验
配置或样本变化后按页面提示重建特征，再到“货品识别测试”用已知货品检查排序。
完成结果：识别返回可解释的真实货品候选，未命中时允许人工选择，不产生假货品。
页面 · 货品识别测试
先离线验证样本，再交给 APP 使用
测试页用于判断照片是否可用、候选排序是否合理，不写入正式来货或生产记录。
- 1选择或拍摄测试图
- 2执行识别
- 3候选排序与相似度
- 4诊断说明
- 1
选择有代表性的照片
包含正面、背面、不同光线和易混淆货品。只用最清晰的一张命中，不能证明现场稳定。
- 2
执行识别测试
测试不会创建业务单据。若服务、模型或照片路径不可用，先处理明确错误，不把空候选当作“没有这个货”。
- 3
查看候选与相似度
正确货品应稳定出现在合理位置；相近货品并列时，APP 应要求操作员确认。相似度只是辅助信号，不是业务主键。
- 4
按诊断回到配置修正
错候选通常来自样本、范围、货品资料或阈值。修正对应配置后重建并复测，不在测试结果中写死例外。
完成结果：多组已知照片的候选符合预期，未命中和歧义都有可操作的人工路径。
专业页面 · 仅实施员
配置专家：把功能配置到 Ready
该页解释工作流程、数据环境、字段、扫码和标签的产品配置。运维管理员不应在不理解契约时修改。
- 1专业页分隔线
- 2选择移动功能
- 3六类配置页面
- 4状态与保存结果
- 1
确认只有实施员进入
配置专家、现场质量目录和实施员排障位于分隔线下方。权限应由服务端校验，不只靠左侧菜单隐藏。
- 2
一次选择一个功能
功能、工作流程、数据环境和字段全部属于当前账套。任何客户样本都只能作为参考，不能作为全账套标准。
- 3
按六个页面完成配置
依次处理基础绑定、使用范围、字段设置、扫码规则、标签输出、体检与启用；缺少任何有效维度都应明确阻断。
- 4
专业页面 · 仅实施员
现场质量目录：维护质量能力入口
现场质量产品线当前保留但暂停。页面用于查看与维护已有目录，不应为本次移动主线擅自重做或清空。
- 1目录树与分类
- 2规则与字段
- 3启停与保存
- 4校验与结果
- 1
选择已有质量目录项
先读当前目录、规则和引用关系。没有明确新需求时，不新增分类，也不删除看不懂的历史配置。
- 2
核对质量规则与字段
规则必须对应正式数据环境和 ERP 字段，不能用移动端临时字段制造第二真源。
- 3
按授权修改启停状态
暂停线保持现有源码、迁移和配置。只有明确恢复该产品线时才进行新增或结构调整。
- 4
保存前查看影响
确认哪些功能、用户和历史记录会受影响；验证失败时保留输入并给出可修正原因。
完成结果：既有质量能力未被移动主线误删、误启用或改变历史口径。
专业页面 · 仅实施员
实施员排障：收集证据，不靠猜测改库
排障页集中读取运行环境、配置和错误链。它用于定位根因，不是绕过权限、检查器或配置门禁的后门。
- 1诊断类别
- 2执行只读诊断
- 3完整错误与上下文
- 4复制诊断资料
- 1
按故障选择诊断类别
登录、授权、数据库、功能 Ready、字段映射、扫码、打印和提交失败的证据不同。先选接近实际现象的类别。
- 2
执行只读检查
优先读取当前 API 的状态、配置和依赖。只有明确修复动作才写入；不因为一条报错就批量改表或清空配置。
- 3
保留完整错误链和对象
记录客户、账套、API、功能、请求、时间和原始错误。密码、API Key、Token 与完整连接字符串不得进入日志或对外资料。
- 4
复制诊断资料交实施或开发
配置个性问题由实施脚本或选项处理；通用缺口必须回到产品代码修复。修复后重新跑同一诊断与业务闭环。
完成结果：故障有可复现证据、明确归属和复验结果，不留下只修本机的隐性改动。