# 应用、套件与技能

组织管理员在「应用与市场」中浏览、安装和卸载应用、模板、知识包与素材，管理套件，升级应用版本，开启或关闭功能模块。你还可以在「安全」的「登录与认证」中配置应用运行与草稿隔离策略，并在「助手」的「Skill 与连接」中管理助手的图表生成与联网搜索能力。

## 谁能用

页面权限由组织角色决定：
- **查看页面**：侧栏导航中的「应用与市场」和「Skill 与连接」仅组织管理员可见。查看页面需要管理员查看权限。
- **管理与操作**：执行安装、启用、停用、卸载、升级应用、配置套件或保存 Skill 设置，需要管理员修改权限。
- **审计员限制**：审计员的侧栏导航中不显示这两页。若账号没有权限直接访问页面地址，界面显示空状态，并提示「没有权限」与「你的账号角色不允许查看这个页面。请联系租户管理员。」。
- **应用策略权限**：应用策略卡片位于「安全」→「登录与认证」页面底部，该页面同样仅限组织管理员访问。参见[安全设置](/admin/security)。
- **系统应用保护**：「我的组织」是平台自带的系统应用，不能卸载或停用，列表上方已明确注明。

## 怎么打开

1. 进入[工作台](/guide/workspace)。
2. 在工作台打开「行政」→「我的组织」。
3. 在左侧导航点击「应用」→「应用与市场」。
   - 点击条目名称进入该应用的详情。
   - 当组织拥有套件时，可切换到「套件」页签。
   - 可用类型筛选按「应用」「模板」「知识包」「素材」查看。
4. 从工作台空面板直达：工作台应用面板为空时，管理员可点击面板中的「去应用市场安装」按钮直达本页。
5. 从助手设置直达：在「我的组织」左侧导航点击「助手」→「Skill 与连接」。
6. 从安全设置直达：在「我的组织」左侧导航点击「安全」→「登录与认证」，向下滚动到「应用运行与草稿应用」卡片。
7. 从助手或已发出的链接进入时，可直达应用与市场、某个已安装应用的详情，或某个套件。
8. 首页待办入口：当有应用存在新版本时，首页待办显示数字加上「 个应用有新版本」，点击可直达本列表。

## 界面一览

### 1. 「应用与市场」列表页

![「应用与市场」列表](/shots/admin-apps.webp)

图：「应用与市场」列表

1. 页头「应用」（导航名是「应用与市场」）
2. 「我的组织」本身不能卸载或停用
3. 搜名称、简介、发布方
4. 已装应用底部：启用开关、「升级」、「卸载」

- **页头与系统说明**：页头标题显示为「应用」（侧栏导航名称为「应用与市场」）。顶部说明提示：「「我的组织」是平台自带的，不能卸载或停用。」。
- **页签切换**：当平台返回至少 1 个有成员的套件时，页面显示「应用」与「套件」两个页签。如果只有空套件、已退役或无成员套件，则不显示套件页签，页面仅显示市场内容。
- **筛选与搜索**（条目数量大于 3 或存在多种类型时显示）：
  - **类型筛选**：提供「全部」，以及「应用」「模板」「知识包」「素材」。
  - **搜索框**：占位提示为「搜名称、简介、发布方…」，无障碍标签为「搜索市场」。
  - **分类选单**：提供「全部分类」以及各个分类（格式如 分类名加括号数量）。
  - **排序选项**：支持「推荐」「最近更新」「安装最多」「评分最高」。
  - **统计与空状态**：显示匹配条目数加上「个」（如「3 个」）；市场无内容时提示「市场里还没有应用」，说明「审核上架后会出现在这里。」；搜索无匹配时提示「没有找到」，说明「换个关键词，或清除筛选。」，并提供「清除筛选」按钮。
- **内容卡片**：
  - **基本信息**：显示名称（点击进入详情页）；副行显示「平台自带」或发布方名称加上「 · 」与分类名称；无简介时显示「暂无简介」。
  - **契约徽章**：显示契约等级 L0–L3，或显示「未验证」「未通过」。鼠标悬停显示说明（例如「Agent 可以起草变更，由你确认后写入」等）。若发生契约降级，徽章会对照声明等级与实测等级，并说明按实测启用。
  - **特性标签**：可能带有「有新版本」后接版本号、「推荐」、「无界面」、「外部托管」、「需先装……」（接依赖应用名称）、「…… 个模块」。
  - **版本与统计**：显示已安装版本号，或已装版本与可升级版本对照；显示评分与有多少组织在用。
  - **已安装卡片操作**：包含「已启用」或「已停用」状态开关；提供「升级」按钮（有新版本时）与「卸载」按钮；点击展开「设置」与开启模块数（会显示已开启数与总数），可查看并开关各个功能模块；对于应用类型，展开项中提供「新版本上架后自动升级」开关。
  - **未安装卡片操作**：显示「未安装」，若曾安装过显示「曾安装于……」（接安装时间）；提供「安装」按钮。若条目当前不可安装，「安装」按钮置灰禁用，鼠标悬停时 Tooltip 提示不可安装原因。
- **无法安装的原因提示**：
  - 「已被运营方停用」；
  - 「暂时不能安装」（非应用类条目）；
  - 「尚未通过契约测试」；
  - 「契约测试未通过 L0」；
  - 缺少依赖应用时，详情提示「需要先安装应用 」后接依赖应用标识。

### 2. 「全部升级」条

- **显示条件**：当组织内有 2 个及以上已安装的**应用**有新版本，且当前管理员拥有修改权限时，列表上方显示全部升级条。
- **内容与提示**：显示「有 …… 个应用有新版本」；若其中有版本新增了访问权限，追加提示「，其中 …… 个新版本要新增访问，升级前会让你确认」。
- **操作按钮**：「全部升级」。点击后弹出「升级这 …… 个应用？」确认框，按钮为「同意并全部升级」或「全部升级」。
- **结果反馈**：全部成功提示「全部升级完成」；未能全部完成提示「全部升级没有全部完成」，并附带「知道了」按钮。
- **覆盖范围**：仅处理应用类型，不包含模板、知识包与素材。

### 3. 应用详情页

![应用详情](/shots/admin-app-detail.webp)

图：应用详情

1. 页签「概览」「更新记录」「评价」；已装才有「设置」
2. 返回市场列表
3. 徽章「已启用」/「已停用」
4. 「设置」：启用、自动升级、工作台显示名与图标、卸载

- **页头与操作**：提供返回链接「← 应用与市场」；描述信息包含应用标识 · 类型 · 「平台自带」或发布方名称加上「 出品」 · 分类；徽章显示「平台推荐」、「已启用」或「已停用」；主按钮未安装时显示「安装」，有新版本时显示「升级到 v……」（接新版本号）。
- **升级提示（Alert）**：有新版本时，显示「有新版本 v……」与「当前 v……，升级前请看「更新记录」。」。若新版本申请了额外访问，提示「新版本比现在用的多要下面这些，升级时需要你确认：」并在下方列出清单：
  - 「页面能力：」后接能力中文名称（如「感知你正在看哪个页面」等）；
  - 「新的权限点「……」（标识）：只是声明，升级不会把它授予任何角色」；
  - 「想和工作台在同一个页面运行：升级后要重新同意，没同意前仍在框架里运行」。
- **详情页签**：包含「概览」「更新记录」「评价」；已安装的应用额外提供「设置」页签（未安装应用无法停留在设置页签）。
- **「概览」页签**：
  - 「介绍」：展示详细介绍，开发者未编写时显示「开发者还没有写详细介绍。」；展示应用「截图」。
  - 模板说明：若为模板类型，展示「安装后会创建的数据类型」，说明「示意。已有的同名类型不变，卸载后创建的类型也保留。」。
  - 权限说明：展示「它会向平台要什么」，说明「经平台审核；应用读不到你的数据和别的应用。」，页脚说明「界面在沙箱中运行。」；无额外申请时显示「没有申请额外能力。」。
  - 「模块」：展示已安装应用的模块列表，说明「关闭的模块不在工作台显示，Agent 也不会起草。」。
  - 侧栏信息：侧栏标注「你的安装」或「安装」，显示「最新版本」、「你用的版本」、「安装时间」、「契约等级」、「依赖应用」。版本说明会对照当前已装版本与最新版本，或提示已是最新；未安装时显示最新版本号。「发布方」显示「由平台提供。」或「由…… 提供，看不到你的数据。」（含发布方名称）。
- **「更新记录」页签**：
  - 展示版本时间线，当前使用版本标记「你正在用」，最新上架版本标记「最新」。
  - 版本未填写说明时显示「没有写更新说明」；无版本记录时显示「还没有版本信息」。
- **「评价」页签**：
  - 侧栏显示「评分」，说明「装过它的组织才能评价，每组织一条。」；未安装应用时提示「安装之后可以评价它。」。
  - 评价表单：「写评价」或「你的评价」。包含 1–5 星选择；输入框「想说的（可选）」，提示「不要写客户或员工的个人信息。」；操作按钮「提交评价」或「更新评价」，提交成功提示「已提交，谢谢」。
  - 校验提示：未选星级提示「先选几颗星」；超出字数提示「评价最多 1000 个字」。
  - 评价列表：展示「你的」、「用的是 v……」（接版本号）、「开发者回复」；若评价被平台隐藏，显示「平台隐藏了你的评价：」后接隐藏原因；无评价时提示「还没有可以看的评价。」或「还没有评价。」。
- **「设置」页签**（仅已安装应用可用）：
  - 「使用」分区：包含「启用」开关，说明「停用后成员无法使用，数据保留。」。
  - 「自动升级」开关（仅应用类型）：说明「新版本上架后自动升级。」。
  - 「在你们的工作台里怎么显示」分区：说明「只影响你们的组织，留空用原来的。」。提供「显示名称」输入框（最多 40 个字符）；提供「图标」设置，包含「上传图片」（支持 PNG、JPEG、WebP、SVG，最大 256 KB）与「用名字的第一个字」按钮。
  - 危险区：提供「卸载 ……」按钮（含应用名），说明「成员将无法使用。数据、名称和模块开关保留，重新安装时恢复。」。

### 4. 「运行方式」卡片（同页运行）

当已安装的应用版本申请与工作台在同一个页面运行时，应用详情中会显示该卡片：
- **状态显示**：「同页运行中」「已同意，暂以框架运行」或「未同意」。
- **核心开关**：「同意在同一个页面运行」。
  - 开启说明：「可随时撤回，撤回后立即改回框架页面。」，开启后提示「已同意 …… 在同一个页面运行」（含应用名）。
  - 关闭说明：「不同意时，应用在沙箱框架页面里运行。」，撤回后提示「已撤回同意」。
  - 原因与状态提示：如「现在以独立的框架页面（iframe）运行。」、「组织策略要求 ISV 应用一律放在框架里，所以不会同页运行。」、「同页运行要求先开启「只在隔离界面应用 Agent 草稿」（在“安全”页）…」。

### 5. 「套件」页签

- **概念说明**：页顶明确说明「套件不是应用：每个应用仍单独授权、计数，可各自停用、卸载或升级。」。
- **空状态**：无套件时提示「还没有套件」，说明「平台上架后会出现在这里。」。
- **套件卡片**：
  - 进度显示：显示已装数量与套件内应用总数。
  - 页脚状态：「成员已全部安装」、「缺少必装：……」（接应用名）或「必装的已就绪」。
  - 操作按钮：「安装套件」（无可安装成员时禁用）。
  - 成员应用：角色标注为「必装」或「可选」；状态标注为「已安装」「已停用」「暂不能安装」「未安装」。
- **「安装套件」对话框**：
  - 标题显示「安装套件：……」（接套件名）。
  - 说明提示：「必装的会一起装上，可选的按需勾选。已经装着的应用不会被改动。」。
  - 成员规则：必装成员自动勾选且不可取消；已装成员标记「已安装，保持不变」；不可装成员标记「现在不能安装：还没有上架，或没通过契约测试，或不在授权范围内。」；缺少依赖时显示警告「缺少依赖（不会阻止安装）」。
  - 阻塞提示：若有必装成员不可安装，显示阻塞提示「装不了这个套件」与「必装的 …… 暂不能安装。」（含应用名），此时无法安装。
  - 底部操作：按钮提供「取消」，以及「安装 …… 个应用」或「没有需要安装的」。若安装失败提示「套件没有装成」。
  - 完成状态：安装完成后提示「安装结果如下。装好以后每个应用仍然各自独立：可以单独停用、卸载、升级。」，按钮切换为「完成」。
- **系统限制**：平台内置分组「办公」和「Agent」不能作为套件安装，也不能售卖。「我的组织」显示在「行政」里，不用装「行政」套件。

### 6. 「应用运行与草稿应用」（安全设置）

位于「安全」→「登录与认证」页面底部：
- **「只在隔离界面应用 Agent 草稿」开关**：说明提示「Agent 的草稿只能在单独域名的页面上、用单独的登录应用来应用。工作台里的任何代码（包括应用的代码）都点不到「应用」。」。参见[草稿：审阅与应用](/agent/drafts)。
- **「ISV 应用一律放在框架里」开关**：说明提示「第三方应用即使申请了同页运行，也只在带沙箱的框架页面里运行，页面隔离始终保留。」。
- **生效状态反馈**：显示「ISV 应用以框架页面运行。」或「经你同意且通过专项审核的 ISV 应用可以同页运行。」。
- **平台环境限制**：若平台未部署独立界面，显示「平台未部署独立的应用界面，无法开启「只在隔离界面应用 Agent 草稿」，ISV 应用只能在框架里运行。」。
- **隔离地址与保存**：若配置了隔离界面，显示「隔离界面地址：」后接具体地址。开关调整后即时保存并提示「已保存」；若读取失败提示「读取失败」。

### 7. 「Skill 与连接」页面

![「Skill 与连接」](/shots/admin-skills.webp)

图：「Skill 与连接」

1. 页头「Skill 与连接」；有改动才可「保存」
2. 「图表与组件」：允许助手生成组件（默认开）
3. 开：必要时画图；关：只用文字和表格
4. 「联网搜索」：默认关；搜索词会发给外部并记审计
5. 平台未配搜索服务时，开了也不生效

- **页头与保存**：页头标题显示为「Skill 与连接」。顶栏「保存」按钮在拥有修改权限且有改动时可点击，保存成功后提示「已保存，新的对话马上用上」。
- **「图表与组件」分区**：说明提示「组件在隔离环境运行，无网络，读不到你们的数据。」。
  - 设置项：「允许助手生成组件」。
  - 状态说明：开启为「开：必要时画图。」；关闭为「关：只用文字和表格回答。」。默认开启。
- **「联网搜索」分区**：说明提示「搜索词会发送到外部搜索服务，每次搜索记入审计日志。默认关闭。」。
  - 设置项：「允许助手联网搜索」。
  - 状态说明：若平台未配置搜索服务，提示「平台未配置搜索服务，开启暂不生效。」；开启为「开：需要时联网搜索，并给出来源链接。」；关闭为「关：只用你们自己的数据和已有知识回答。」。默认关闭。
- **当前范围**：当前页面仅包含这两项设置，无其他连接器列表。

## 常用操作

### 搜索与筛选市场内容

1. 在左侧导航点击「应用」→「应用与市场」。
2. 在列表上方类型筛选栏中点击「全部」，或点击「应用」「模板」「知识包」「素材」按类型筛选。
3. 在搜索框（占位提示「搜名称、简介、发布方…」）中输入关键词，列表按名称、简介或发布方筛选。
4. 在分类选单中选择「全部分类」或目标分类。
5. 在排序选单中选择「推荐」「最近更新」「安装最多」或「评分最高」。
6. 列表实时更新匹配结果；若无匹配内容，点击「清除筛选」恢复完整列表。

### 安装单个应用或内容

1. 在左侧导航点击「应用」→「应用与市场」。
2. 在列表中找到目标条目卡片。
3. 若卡片底部的「安装」按钮可点击，直接点击「安装」；若按钮置灰禁用，将鼠标悬停在按钮上查看原因 Tooltip（如「已被运营方停用」「暂时不能安装」「尚未通过契约测试」「契约测试未通过 L0」）。
4. 也可以点击卡片名称进入详情页，在页头右上角点击「安装」；若缺少依赖应用，详情页提示「需要先安装应用 」后接依赖应用标识。
5. 安装成功后，系统弹出提示应用名接「已安装」。若安装的是模板，提示会接「：生成 …… 个数据类型」（若有同名类型则接「 …… 个已有的保持不变」）。安装模板会建立数据模型，开通清单中的「建立数据模型」可通过安装模板完成。

> **套餐限制**
>
> 若当前组织的套餐配额中「可装条目」已达到上限，服务端将拒绝安装，并提示套餐已达最大安装上限，需先卸载一个应用或请平台调整套餐。参见[套餐与用量](/admin/usage)。

### 启用或停用应用

1. 在左侧导航点击「应用」→「应用与市场」。
2. 在已安装应用卡片底部找到状态开关；或进入应用详情页的「设置」页签，找到「使用」分区的「启用」开关。
3. 点击切换开关状态。
4. 列表操作后弹出提示应用名加「 · 」与「已启用」或「已停用」；详情页操作后弹出提示应用名接「 已启用」或「 已停用」。
5. 停用后成员无法在工作台使用该应用，但应用的所有业务数据均完整保留。「我的组织」不能停用。

### 卸载应用

> **危险**
>
> 卸载应用后，组织成员将无法使用该应用。系统自带的「我的组织」不能卸载。

1. 在左侧导航点击「应用」→「应用与市场」。
2. 在已安装应用卡片底部点击「卸载」；或进入详情页的「设置」页签，在底部的危险区点击「卸载 ……」（含应用名）。
3. 系统弹出确认弹窗「卸载 ……？」（含应用名），说明提示「成员将无法使用。所有数据、名称和模块开关保留，重新安装时恢复。」。
4. 点击确认卸载，卸载成功后系统提示「已卸载」。
5. 卸载应用不会连带卸载套件中的其他成员应用。

### 升级单个应用

> **注意**
>
> 应用升级后不能降级回旧版本，组织内所有成员都将统一使用新版本。新版本声明的新权限点不会自动授予任何角色，需要前往「权限」→「业务角色」手动分配，参见[角色与权限](/admin/roles)。

1. 在左侧导航点击「应用」→「应用与市场」。
2. 找到带有「有新版本」标签的应用，在卡片底部点击「升级」，或在应用详情页点击主按钮「升级到 v……」（接新版本号）。
3. 若新版本未申请额外的系统访问或权限，系统直接完成升级，提示应用名加「 → v」与版本号。
4. 若新版本申请了额外访问（如新增页面能力、声明新权限点或申请同页运行），系统弹出确认弹窗（如「升级「客户管理」到 v1.1.0？」），详细列出新增访问清单并说明「组织里每个人用到的都是新版本，不能降级。」。核对后点击「同意并升级」。
5. 若确认期间版本信息发生变动导致确认过期，系统提示「这个新版本比你看到的多要访问，需要你确认后再升级。页面已刷新，请再点一次。」，页面刷新后请重新点击升级。
6. 已停用的应用在升级完成后仍保持停用状态；此前若已同意同页运行，升级后同意将清零重置，需要重新同意。

### 全部升级应用

1. 在左侧导航点击「应用」→「应用与市场」。
2. 当组织内有 2 个及以上已安装的**应用**有新版本时，列表上方自动出现全部升级条，显示待升级应用数量与新增访问提示。
3. 点击右侧「全部升级」按钮。
4. 在弹出的「升级这 …… 个应用？」确认弹窗中，仔细阅读各应用的新增访问清单。
5. 点击「同意并全部升级」（若均无新增访问则点击「全部升级」）。
6. 升级完成后系统提示「全部升级完成」；若有部分应用未能成功升级，系统提示「全部升级没有全部完成」，点击「知道了」关闭弹窗。
7. 全部升级不处理模板、知识包与素材，需分别进入各自详情页处理。

### 开启或关闭应用模块

1. 在左侧导航点击「应用」→「应用与市场」。
2. 在已安装应用卡片底部点击展开「设置」，或进入应用详情页的「概览」页签中的「模块」区域。
3. 找到需要调整的功能模块，切换对应的开关。
4. 列表操作后弹出提示，在「已启用」或「已停用」后接模块名；详情页操作后弹出「已开启」或「已关闭」并带上模块名。
5. 关闭某个模块后，该模块在工作台的导航入口将被隐藏，助手（Agent）也不会起草该模块的变更。切换或升级应用版本不会重置模块开关状态；升级时新增加的模块默认开启。

### 设置自动升级

1. 仅「应用」类型条目支持自动升级（模板等其他类型不支持）。
2. 在左侧导航点击「应用」→「应用与市场」。
3. 在应用列表卡片底部展开「设置」，或进入详情页的「设置」页签，找到「新版本上架后自动升级」（详情页为「自动升级」）开关。
4. 点击切换开关。开启时系统提示「新版本上架后自动升级」（详情页提示「已开启自动升级」）；关闭时提示「已停用」（详情页提示「已关闭自动升级」）。
5. 开启自动升级后，新版本上架时系统会自动升级，不会逐次弹出新增访问确认。

### 安装套件

1. 在左侧导航点击「应用」→「应用与市场」。
2. 在顶部切换到「套件」页签。
3. 找到目标套件卡片，点击「安装套件」按钮（若没有可安装成员则禁用）。
4. 系统弹出「安装套件：……」（含套件名）对话框，显示套件内所有成员应用：
   - 标注为「必装」的成员会自动勾选且不能取消；
   - 标注为「可选」的成员可根据需要手动勾选；
   - 已经安装的应用保持不变，标注为「已安装，保持不变」；
   - 若有必装成员当前不可安装，弹窗显示阻塞提示「装不了这个套件」与「必装的 …… 暂不能安装。」（含应用名），此时无法提交安装；
   - 若缺少依赖，显示警告「缺少依赖（不会阻止安装）」。
5. 确认勾选后，点击底部的「安装 …… 个应用」按钮开始安装（若无可装项显示「没有需要安装的」）。
6. 安装完成后，弹窗显示「安装结果如下。装好以后每个应用仍然各自独立：可以单独停用、卸载、升级。」，点击「完成」退出。
7. 若安装过程中失败，系统提示「套件没有装成」，并仅撤销本次新安装的应用。

### 修改工作台显示名称与图标

1. 在左侧导航点击「应用」→「应用与市场」。
2. 点击已安装应用名称进入详情页，切换到「设置」页签。
3. 在「在你们的工作台里怎么显示」分区中，填写新的「显示名称」（最多 40 个字符，留空则恢复默认名称）。
4. 设置图标：可以点击「用名字的第一个字」，也可以点击「上传图片」上传自定义图标（支持 PNG、JPEG、WebP、SVG 格式，文件大小不超过 256 KB）。上传成功后提示「图标已更新」。
5. 点击「保存」，系统提示「已保存」。修改仅影响当前组织工作台的显示。

### 评价应用

1. 在左侧导航点击「应用」→「应用与市场」。
2. 点击已安装应用名称进入详情页，切换到「评价」页签。
3. 在「写评价」或「你的评价」表单中，先选择 1–5 颗星（未选星级点击提交提示「先选几颗星」）。
4. 在「想说的（可选）」输入框中填写评价内容（最多 1000 个字，提示「不要写客户或员工的个人信息。」；超出字数限制提示「评价最多 1000 个字」）。
5. 点击「提交评价」（已评价过显示为「更新评价」），成功后系统提示「已提交，谢谢」。每个组织只能提交一条评价。

### 配置应用安全策略与同页运行

1. 在左侧导航进入「安全」→「登录与认证」，向下滚动到「应用运行与草稿应用」卡片。参见[安全设置](/admin/security)。
2. 根据组织安全要求切换开关：
   - 若要求草稿必须在隔离界面应用，开启「只在隔离界面应用 Agent 草稿」；
   - 若要求第三方应用严格隔离，开启「ISV 应用一律放在框架里」。
   - 开关修改后系统立即保存并提示「已保存」。
3. 若组织策略允许同页运行，且某个第三方应用版本申请了同页运行：前往该应用的详情页，在「运行方式」卡片中打开「同意在同一个页面运行」开关，系统提示「已同意 …… 在同一个页面运行」（含应用名）。
4. 管理员可随时关闭开关撤回同意，撤回后提示「已撤回同意」，应用立即改回沙箱框架页面运行。

### 配置助手 Skill（图表与联网搜索）

1. 在左侧导航点击「助手」→「Skill 与连接」。
2. 在「图表与组件」分区，切换「允许助手生成组件」开关（开启允许必要时画图，关闭则仅用文字和表格回答）。
3. 在「联网搜索」分区，切换「允许助手联网搜索」开关（开启允许必要时联网搜索并给出来源链接，搜索词会发送到外部服务并记入审计日志；关闭则仅用组织自有数据和已有知识回答；若平台未配置搜索服务，开启提示「平台未配置搜索服务，开启暂不生效。」）。
4. 调整完成后，点击页面顶栏右上角的「保存」按钮（只有发生改动且拥有修改权限时才可点击）。
5. 保存成功后系统提示「已保存，新的对话马上用上」。该设置仅对新发起的助手对话生效，当前已有的对话不回溯。

## 状态说明

契约等级徽章状态：

| 状态 / 徽章 | 说明 |
|---|---|
| L0–L3 | 契约等级。悬停显示说明（例如「Agent 可以起草变更，由你确认后写入」等） |
| 「未验证」 | 应用尚未进行契约测试 |
| 「未通过」 | 应用契约测试未通过 |
| 契约降级 | 对照声明等级与实测等级，并说明按实测启用 |

应用安装与启用状态：

| 状态 | 说明 |
|---|---|
| 「未安装」 | 组织尚未安装该应用或内容条目；曾安装过显示曾安装时间（如「曾安装于……」） |
| 「已启用」 | 应用已安装且处于开启状态，组织成员可在工作台正常访问 |
| 「已停用」 | 应用已安装但被管理员停用，成员无法使用，所有数据完整保留 |

同页运行状态（「运行方式」）：

| 状态 | 说明 |
|---|---|
| 「同页运行中」 | 管理员已同意，且组织策略允许同页运行 |
| 「已同意，暂以框架运行」 | 管理员已同意，但受组织策略或环境限制，当前仍以框架（iframe）页面运行 |
| 「未同意」 | 管理员尚未同意同页运行，应用在沙箱框架页面里运行 |

套件成员角色与状态：

| 属性 | 取值 | 说明 |
|---|---|---|
| 成员角色 | 「必装」 | 套件的核心依赖，安装套件时必须一同安装，不可取消勾选 |
| | 「可选」 | 套件的可选组件，安装套件时可按需勾选 |
| 成员状态 | 「已安装」 | 该成员应用已在组织中安装，安装套件时保持原样 |
| | 「已停用」 | 该成员应用已安装但处于停用状态 |
| | 「未安装」 | 尚未安装的成员应用 |
| | 「暂不能安装」 | 因未上架、未通过契约测试或不在授权范围内而暂时无法安装 |

## 让助手帮你做

你可以让助手（Agent）协助你安装、升级、停用应用，调整模块开关，安装套件，或配置助手的图表与联网能力。

你可以这样对助手说：
> “把工单应用装上”
> “升级所有有新版本的应用”
> “关掉合同应用的某个模块”
> “安装增长套件，可选的先不装”
> “允许助手画图，但不要联网搜索”
> “第三方应用一律放框架里，不要同页运行”

> **注意**
>
> 助手的以下操作涉及组织安全与系统变更，属于高风险操作。执行前助手会生成确认卡片，必须由你手动点击确认：
> - 安装应用、卸载应用、启用或停用应用；
> - 升级应用（当新版本申请了新增访问时需确认同意）；
> - 升级全部应用（助手单次批量处理最多 50 个应用）；
> - 开关应用的模块；
> - 同意应用在工作台页面内运行；
> - 安装套件；
> - 评价应用；
> - 开关助手能力（确认卡片提示：「改变后，组织里每个人的助手立刻按新的能力工作；打开联网搜索会把对话里的词发给第三方搜索服务。」）。

助手不能做的事项：
- 不能卸载系统自带的「我的组织」；
- 不能将应用降级到旧版本；
- 不能将新版本声明的新权限点自动授予任何业务角色；
- 不能安装平台内置分组「办公」「Agent」中的内容；
- 不能在「Skill 与连接」中配置尚未提供的其它连接器。

## 设置

| 设置项 | 位置 | 作用 | 默认值 | 谁能改 |
|---|---|---|---|---|
| 「启用」 | 应用卡片底部 / 应用详情「设置」 | 控制成员能否在工作台使用该应用，停用后数据保留 | 安装时启用 | 管理员 |
| 「新版本上架后自动升级」/「自动升级」 | 应用卡片「设置」 / 应用详情「设置」（仅应用类型） | 控制新版本上架后是否自动升级，开启后不逐次确认新增访问 | 关 | 管理员 |
| 各模块开关 | 应用卡片「设置」 / 应用详情「概览」→「模块」 | 控制特定功能模块在工作台的显示以及助手起草 | 新模块默认开 | 管理员 |
| 「只在隔离界面应用 Agent 草稿」 | 「安全」→「登录与认证」 | Agent 草稿只能在单独域名的隔离界面上应用，防止工作台内代码触碰应用操作 | 视平台部署配置 | 管理员（无联邦能力时不能开启） |
| 「ISV 应用一律放在框架里」 | 「安全」→「登录与认证」 | 第三方应用即使申请了同页运行，也强制只在沙箱框架页面里运行 | 视平台部署配置 | 管理员 |
| 「同意在同一个页面运行」 | 申请同页运行的应用详情「运行方式」 | 是否同意该第三方应用版本在工作台同页运行 | 关 | 管理员 |
| 「允许助手生成组件」 | 「助手」→「Skill 与连接」 | 是否允许助手在对话中必要时生成图表与前端组件 | 开 | 管理员（修改后须点击「保存」） |
| 「允许助手联网搜索」 | 「助手」→「Skill 与连接」 | 是否允许助手在需要时向外部搜索服务发送搜索词并给出来源链接 | 关 | 管理员（修改后须点击「保存」；若平台未配置搜索服务则开启也不生效） |
| 「显示名称」与「图标」 | 应用详情「设置」→「在你们的工作台里怎么显示」 | 自定义应用在当前组织工作台内的名称与图标展示，不影响其他组织 | 默认名称与图标 | 管理员 |

## 注意事项

- **不可降级**：应用升级操作单向不可逆，系统不支持降级回旧版本。
- **系统应用保护**：平台自带的「我的组织」不能被卸载或停用。
- **套餐计数规则**：组织套餐的「可装条目」限制按每个安装的应用、模板、知识包或素材条目分别计数，不按套件计数。参见[套餐与用量](/admin/usage)。
- **卸载保留与恢复**：卸载应用不会删除任何业务数据，自定义显示名称和各模块开关状态也一并保留，重新安装时自动恢复。
- **卸载不级联**：卸载套件中的某个成员应用，不会级联卸载该套件内的其他应用。
- **全部升级限制**：全部升级仅包含「应用」类型条目（模板、知识包与素材不包含在内）；只有当待升级应用数达到 2 个及以上时页面才会显示升级条；助手单次最多批量升级 50 个应用。
- **新权限点不自动授权**：应用升级所声明的新权限点只是声明，系统不会自动将其授予任何业务角色，需要管理员前往「权限」→「业务角色」手动勾选，参见[角色与权限](/admin/roles)。
- **同页运行同意重置**：若某应用此前已获得同页运行同意，在升级到新版本后，同页运行同意将被清零，需要管理员重新确认同意。
- **自动升级不弹窗确认**：开启自动升级后，新版本上架将自动完成升级，不会逐次弹出新增访问确认。
- **评价字数与组织限制**：每个组织对每个应用只能提交一条评价；评价内容最多 1000 个字；请勿在评价中填写客户或员工的个人信息。
- **图标上传规格**：自定义图标支持 PNG、JPEG、WebP、SVG 格式，文件大小最大不超过 256 KB；显示名称最多 40 个字符。
- **助手 Skill 生效时机**：「Skill 与连接」中保存的设置仅对新发起的助手对话生效，当前进行中的会话不回溯。
- **移动端表现**：手机端访问时卡片网格会自动折行，详情页签支持横向滑动；系统未提供单独的移动端安装向导。
- **依赖重检限制**：升级应用时目前不会重新检查套件的依赖关系。

## 目前不支持

- 目前不支持套件在市场中单独售卖、套件级权限或许可控制，也不支持独立软件开发商（ISV）发布自定义套件。
- 卸载套件中的成员应用时，目前不支持针对其他成员应用的依赖提醒。
- 升级应用时目前不会重新检查套件依赖关系。
- 「Skill 与连接」页面目前不支持自定义扩展技能或其他外部连接器列表。
- 部分市场中知识包与素材目前还不能上架。

## 常见问题

### 为什么在应用列表或详情页找不到「降级」按钮？

Raise 的应用升级是单向不可逆的，系统不支持将已安装的应用降级回旧版本。如果新版本申请了新的权限点或页面能力，系统会在升级前提示你确认，确认后组织内所有成员都将统一使用新版本。

### 卸载应用后，应用里的业务数据和配置会丢失吗？

不会丢失。卸载应用只会让组织成员无法继续在工作台使用该应用。应用的所有业务数据、你在组织中自定义的显示名称以及各功能模块的开启状态都会被完整保留。重新安装该应用后，这些数据和配置将全部自动恢复。

### 为什么升级应用后，成员依然没有新功能的操作权限？

应用升级声明的新权限点只是在系统中完成声明注册，系统出于安全考虑，不会自动将新权限点授予任何已有角色。请前往「权限」→「业务角色」（参见[角色与权限](/admin/roles)），找到对应的业务角色并勾选新权限点。

### 为什么安装套件时提示「装不了这个套件」？

套件中的成员应用分为「必装」和「可选」。如果某个必装成员应用当前不可安装（例如应用尚未上架、未通过契约测试 L0，或者不在组织的套餐授权范围内），整个套件将无法提交安装。你可以在套件对话框中查看具体的阻塞原因。

### 为什么修改了「Skill 与连接」设置并保存后，正在进行的助手对话没有生效？

「Skill 与连接」中的图表生成与联网搜索设置在点击「保存」后即时生效，但仅对新发起的助手对话有效，不会回溯改变当前正在进行中的会话。若要使用最新配置，请开启一个新的对话。