NBS AI App Store 用户指南
应用发现与启动操作手册
NBS AI App Store 是 NBS 的集中式 AI 应用发现与启动平台。你可以在应用大厅中浏览、搜索和启动可用的应用。
登录与认证
首次访问流程
- 在浏览器中打开 App Store 首页
- 系统自动检测登录状态：
- 如果已登录且登陆状态有效 → 直接显示应用大厅
- 如果未登录或登陆状态已过期 → 自动跳转到 登录页面
- 在登录页面，点击页面中央的 Sign In 按钮
- 浏览器跳转到企业 SSO 认证页面，输入企业账号密码完成认证（如果当天已经完成过 Midway 登录，则会自动完成认证）
- 认证成功后，浏览器自动跳转回应用大厅
登录状态管理机制
- 登录成功后，登陆状态 仅存储在浏览器内存中，关闭浏览器标签页后会话即失效
- 系统会在登录状态过期前自动刷新，用户无需手动操作
- 如果刷新登录状态也过期或刷新失败，系统会自动跳转到登录页面，需要重新登录
退出登录
- 在页面右上角找到用户头像区域
- 点击头像旁边的 Logout 按钮
- 系统清除内存中的登录状态，跳转回登录页面
应用大厅（App Hub）
应用大厅是 App Store 的主页面，用于浏览和发现所有可用应用。
页面布局
| 区域 | 位置 | 内容 |
|---|---|---|
| 顶部导航栏 | 页面顶部 | "NBS AI App Store" 标题、用户头像 + Logout 按钮 |
| 左侧分类栏 | 页面左侧 | 应用分类列表，点击可筛选 |
| 主内容区 | 页面中央 | 搜索栏 + 排序选择器 + 应用卡片网格 |
应用卡片详解
每张应用卡片展示以下信息：
| 元素 | 说明 |
|---|---|
| 应用图标 | 1:1 比例的方形图标，无图标时显示占位符 |
| 应用名称 | 粗体显示 |
| 分类标签 | 显示所属分类名称 |
| 描述文字 | 最多显示 120 个字符，超出部分截断 |
| 状态徽章 | Active 绿色 · Testing 黄色 · Inactive 灰色 |
| 用户数量 | 显示当前应用的注册用户数 |
搜索应用
- 在主内容区顶部找到搜索输入框
- 输入关键字（如应用名称或描述中的词语）
- 系统会实时过滤应用列表（不区分大小写），无需按回车
- 清空搜索框即可恢复显示所有应用
按分类筛选
- 在左侧分类栏中，点击任意分类名称：
- Data Insights — 数据洞察类
- Task Management — 任务管理类
- Workflow Automation — 工作流自动化类
- Seller Engagement Content Generation — 卖家互动内容生成类
- Seller Outreach — 卖家触达类
- 被选中的分类会高亮显示，主内容区仅显示该分类下的应用
- 再次点击同一分类或点击 "All" 可取消筛选
搜索和分类筛选可以同时使用，例如：选择 "Data Insights" 分类后再输入关键字，只会在该分类内搜索。
排序应用
- 在搜索栏右侧找到排序下拉框
- 选择排序方式：
- Sort by Popularity（默认）— 按用户数从多到少排列
- Sort by Name — 按应用名称字母顺序排列
- Sort by Newest — 按创建时间从新到旧排列
- 选择后立即生效，应用卡片重新排列
可见性规则
你在应用大厅中能看到的应用取决于你的身份：
- 所有 Access Mode 为 Public 且状态为 Active 的应用
- 你作为 App Admin / App Owner / App Manager / Member 的应用（无论状态如何）
Access Mode 为 Whitelist 的应用，只有被加入白名单的用户才能看到。
应用启动
启动 Active 应用
- 在应用大厅中找到目标应用卡片
- 确认应用状态徽章为绿色 Active
- 点击应用卡片
- 浏览器会在当前标签页跳转到该应用的入口 URL
无法启动的情况
| 情况 | 表现 | 原因 |
|---|---|---|
| 应用为 Inactive 状态 | 卡片半透明显示，点击无反应 | 应用已被停用 |
| 应用未配置入口 URL | 点击后显示错误提示（Toast） | 管理员未设置 Entry URL |
| 应用为 Testing 状态 | 普通用户看不到该卡片 | 仅管理员可见 |
角色说明
App Store 中有两类角色：平台级角色和应用级角色。
角色定义
| 角色 | 级别 | 说明 |
|---|---|---|
| Platform Admin | 平台级 | 平台管理员，可查看所有应用、注册新应用、访问审计仪表板、管理任意应用配置 |
| App Admin | 应用级 | 应用管理员，管理应用配置和用户权限，不能访问应用文件数据 |
| App Owner | 应用级 | 应用所有者，可访问应用内所有文件（包括 .private），不能管理应用配置 |
| App Manager | 应用级 | 应用管理者，可读写自己目录和下属目录，只读 .public，不能访问 .private，不能管理应用配置 |
| Member | 应用级 | 应用成员，仅可访问自己的目录和 .public 目录 |
App Admin、App Owner、App Manager 是三个完全不同的角色。App Admin 管理配置但不能访问文件；App Owner 访问所有文件但不能管理配置；App Manager 只能访问自己和下属的目录。
常见问题
登录相关
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 页面自动跳转到登录页 | 登录状态过期且刷新失败 | 重新点击 Sign In 登录 |
| 登录后页面空白 | 回调处理失败 | 清除浏览器缓存后重试 |
| 关闭浏览器后需重新登录 | 登录状态仅存储在内存中 | 这是正常行为，重新登录即可 |
权限相关
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 看不到某些应用 | 应用为 Whitelist 模式且你不在白名单中，或应用处于 Testing/Inactive 状态 | 联系应用管理员将你加入白名单或添加为应用角色 |
| 看不到 Platform Admin 菜单 | 你不是 Platform Admin | 联系平台管理员添加权限 |
| 看不到应用的 Manage 按钮 | 你不是该应用的 App Admin 或 Platform Admin | 联系应用管理员添加权限 |
操作相关
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 点击应用卡片无反应 | 应用为 Inactive 状态 | 联系应用管理员激活应用 |
| 用户搜索无结果 | 搜索关键字不匹配 | 尝试使用别名（alias）搜索 |
| 数据加载失败 | 网络连接问题或服务端异常 | 点击 Retry 按钮重试，如持续失败请联系管理员 |