# 应用与套件

组织管理员在「我的组织」→「应用与市场」中浏览、安装、停用、卸载应用和套件；成员在[工作台](/guide/workspace)中使用套件切换器筛选已安装的应用。平台自带的「Agent」「我的组织」「消息中心」属于内置系统应用，不能卸载或停用。

## 谁能用

「应用与市场」属于组织管理功能。侧栏入口只给组织管理员：

| 角色 | 权限范围 |
|---|---|
| 组织管理员 | 拥有全部操作权限：浏览市场与套件、安装应用、停用或启用应用、卸载应用、安装套件、升级应用、配置模块开关及自动升级 |
| 审计员 | 「我的组织」侧栏没有「应用与市场」。工作台没有已装应用时，看到的是「请联系组织管理员安装。」。若拿到链接打开，只能只读查看，不能安装、卸载、停用、启用、升级或改设置 |
| 普通成员 | 无权进入「应用与市场」。在「我的组织」中看不到该入口；若工作台暂无任何已安装应用，界面提示「请联系组织管理员安装。」 |

> **提示**
>
> 若账号没有相关权限，在「我的组织」中不会显示「应用与市场」入口。

## 怎么打开

1. 在[工作台](/guide/workspace)左侧打开「我的组织」（显示在「行政」分组里，没有安装「行政」套件也能看到）。
2. 在左侧导航的「应用」分组中，点击「应用与市场」。
3. 进入后，页面标题显示「应用」；当组织拥有套件数据时，顶部提供「应用」和「套件」两个页签。

其他打开方式与场景：
- **工作台无应用引导**：组织尚未安装任何业务应用时，管理员在工作台上会看到「去应用市场安装」按钮，点击可直接打开本页。
- **访问未安装应用链接**：如果你通过链接访问未安装或无权打开的应用，系统会提示「这个链接指向的应用没有安装，或你没有权限打开。请联系组织管理员。」。
- **返回列表**：在应用详情页中，点击顶部的「← 应用与市场」返回列表。

## 界面一览

### 「应用」页签（市场）

页顶常驻说明：「「我的组织」是平台自带的，不能卸载或停用。」。

![「我的组织」的「应用与市场」](/shots/apps-market.webp)

图：「我的组织」的「应用与市场」

1. 页头「应用」
2. 「套件」页签
3. 页顶说明：组织应用不能卸载或停用
4. 搜索市场应用（占位「搜名称、简介、发布方…」）
5. 已装应用的状态开关

| 区域 / 元素 | 说明 |
|---|---|
| 种类页签 | 提供「全部」以及「应用」「模板」「知识包」「素材」（仅当存在多种类型时显示） |
| 搜索框 | 搜索占位提示「搜名称、简介、发布方…」，支持快速搜索市场应用 |
| 分类筛选 | 提供「全部分类」下拉筛选，分类项显示为对应分类名称与应用数量 |
| 排序方式 | 支持按「推荐」「最近更新」「安装最多」「评分最高」进行排序 |
| 数量统计 | 显示当前筛选结果的应用总数（如 10 个） |
| 空状态提示 | 市场无应用时显示「市场里还没有应用」与「审核上架后会出现在这里。」；筛选无结果时显示「没有找到」与「换个关键词，或清除筛选。」，并提供「清除筛选」按钮 |
| 应用卡片信息 | 展示应用名称（若配置了组织自定义展示名则优先显示展示名）、发布方（缺省显示为「平台自带」）、所属分类、简介（缺省显示为「暂无简介」） |
| 卡片徽章 | 展示能力等级；种类（如「模板」等）；「推荐」；「无界面」；「外部托管」；依赖提示（「需先装」后接应用名）；模块数量（数字后接「个模块」）；新版本提示；使用规模（数字后接「个租户在用」） |
| 降级提示 | 当实测能力与声明不一致时，卡片写明声明等级、实测等级，并说明按实测启用 |
| 已装应用卡片操作 | 底部提供状态开关，显示「已启用」或「已停用」；提供「升级」（有新版本时）与「卸载」按钮；可展开「设置」调整模块开关与自动升级 |
| 未装应用卡片操作 | 状态显示「未安装」，若曾安装过则显示「曾安装于」后接日期；提供「安装」按钮（若因许可、契约或配额受限被拦截，按钮呈禁用置灰状态，悬停可查看原因） |
| 卸载确认弹窗 | 点击「卸载」后弹出确认框，标题为「卸载」后接应用名加问号，说明提示「成员将无法使用。所有数据、名称和模块开关保留，重新安装时恢复。」，包含「卸载」按钮；操作成功后提示「已卸载」 |

### 「套件」页签

页顶常驻说明：「套件不是应用：每个应用仍单独授权、计数，可各自停用、卸载或升级。」。

![「我的组织」的「套件」](/shots/apps-suites.webp)

图：「我的组织」的「套件」

1. 当前在「套件」页签
2. 页顶说明：套件不是应用
3. 「安装套件」：必装的一起装，可选的按需勾选

| 区域 / 元素 | 说明 |
|---|---|
| 空状态提示 | 平台暂无套件时显示「还没有套件」与「平台上架后会出现在这里。」 |
| 套件卡片信息 | 展示套件名称、摘要、已安装进度（显示已装数量与总数，后接「已安装」） |
| 成员应用列表 | 每行展示应用中文名、套件角色（「必装」或「可选」）、收录原因、当前状态（「已安装」「已停用」「暂不能安装」「未安装」） |
| 就绪状态提示 | 套件卡片底部显示「成员已全部安装」、缺少必装时写「缺少必装：」后接应用名，或显示「必装的已就绪」 |
| 操作按钮 | 提供「安装套件」按钮 |

### 安装套件对话框

点击「安装套件」后弹出对话框：
- **标题**：显示「安装套件：」后直接接套件名称。
- **说明**：未完成安装前说明提示「必装的会一起装上，可选的按需勾选。已经装着的应用不会被改动。」。
- **成员勾选**：标记为「必装」的应用默认勾选且不可取消；标记为「可选」的应用可自主勾选；已安装的成员应用旁标注「已安装，保持不变」。
- **限制与依赖提示**：若无法安装提示「现在不能安装：还没有上架，或没通过契约测试，或不在授权范围内。」；若必装成员无法安装提示「装不了这个套件」，并写「必装的 」后接应用名再接「 暂不能安装。」；若缺少可选依赖提示「缺少依赖（不会阻止安装）」。
- **安装结果**：
  - 成功时说明提示「安装结果如下。装好以后每个应用仍然各自独立：可以单独停用、卸载、升级。」。结果文本以「已安装」起头并列新装应用名；若包含原已安装应用则接「原来就装着，没有改动」；若无新安装应用则提示「没有需要新装的应用」。
  - 失败时提示「套件没有装成」。
- **底部按钮**：提供「取消」按钮；提交按钮显示「安装」后接个数再接「个应用」，或「没有需要安装的」；安装完成后按钮显示为「完成」。已无可装成员时，「安装套件」仍在但禁用。

### 工作台套件切换器

在[工作台](/guide/workspace)中使用套件切换器：
- **入口位置**：位于工作台标签栏左侧，显示当前所选的套件名称。
- **宫格菜单**：点击展开宫格面板，一行显示 3 个套件，并提供「显示全部」选项。
- **筛选逻辑**：仅用于筛选当前组织已安装且已启用的应用，不能在此安装新应用。
- **恢复平铺**：点击「显示全部」后，工作台标签恢复平铺展示。
- **平台分组**：内置平台分组会出现在切换器中，但不会出现在「套件」页签中，也不能进行套件安装。

![工作台标签栏的套件切换](/shots/apps-suite-switch.webp)

图：工作台标签栏的套件切换

1. 套件切换：显示当前套件名
2. 宫格：一行 3 个套件，只筛选已安装且已启用的应用
3. 「显示全部」：恢复平铺所有已装应用
4. 「知识与文件」套件
5. 「数据分析」套件

## 套件与应用目录

平台提供 7 个业务目录套件（包含 20 个官方应用）以及内置平台分组。每个应用仅属于一个套件，套件本身不包含独立代码、权限或数据。

### 1. 「增长」套件
摘要：「获客、转化、裂变」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [站点](/apps/site) | 必装 | 没有它，活动页面没有地方放 | 站点：活动页、报名页、H5 托管在企业自己的域名上，版本可发布可回滚 |
| [活动](/apps/campaign) | 必装 | 券、抽奖与拼团都在这里做 | 活动：按数量发券、服务端抽奖、线上线下核销、兑奖与统计 |
| [分销](/apps/distribution) | 可选 | 要做分销裂变时再装 | 最多两级的分销：分销员、归因、佣金账、结算单 |
| [触达](/apps/outreach) | 可选 | 要给客户发短信、公众号通知时再装 | 向客户发短信与公众号模板消息：同意、退订、免打扰与频控在发送前检查 |

### 2. 「康复」套件
摘要：「会员、评估与治疗记录、预约核销、课程包与储值、家庭作业与随访」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [会员](/apps/membership) | 必装 | 会员、权益与核销都在这里 | 会员、课程包、预约、核销、今日提醒和训练记录 |
| [客户](/apps/customer) | 可选 | 要统一查看客户、标签与合并建议时再装 | 客户档案、标签、归属、合并建议、同意与退订、导入导出 |
| [订单](/apps/order) | 可选 | 要卖服务商品、收银开单和退款时再装 | 服务类商品、轻订单、收银开单、退款与待处理 |

### 3. 「财务」套件
摘要：「账本、对账、收款、合同与费用」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [经营](/apps/biz) | 必装 | 账本是经营的底座，其他应用的收入也记在这里 | 收付款台账、应收应付、核销、报表；会员售卖与审批通过自动入账 |
| [合同](/apps/contract) | 可选 | 要管理合同台账、审批与收付款计划时再装 | 合同台账、审批、签订与收付款计划 |
| [费用](/apps/expense) | 可选 | 要做费用报销、借款与采购时再装 | 费用报销、借款与采购：明细、发票查重、借款冲抵、收货入账 |

### 4. 「人事」套件
摘要：「人员档案与绩效，权限和数据彼此独立」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [人力资源](/apps/hr) | 必装 | 人员档案、入转调离与假勤 | 人事系统：员工档案、入转调离、合同与证件到期提醒、招聘、请假与假期余额、人员统计 |
| [绩效](/apps/perf) | 可选 | 要做绩效考核与 360 评价时再装 | 绩效管理：考核周期、目标与 OKR、自评/上级评/360、校准、结果公示与申诉 |

### 5. 「行政」套件
摘要：「审批、资产与场地、服务台工单」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [审批](/apps/flow) | 必装 | 发起审批、搭建审批流 | 发起审批、搭建审批流：表单、条件分支、会签或签、转交加签、超时、统计 |
| [资源管理](/apps/resource) | 可选 | 要管理资产、会议室、车辆、证照与预订时再装 | 资源台账：资产、设备、车辆、会议室、证照；领用归还调拨、预约、盘点，可被引用 |
| [工单](/apps/ticket) | 可选 | 要受理客户问题或内部服务请求时再装 | 受理客户问题与内部服务请求：队列、SLA、对外回复与内部备注 |

### 6. 「知识与文件」套件
摘要：「知识库、文档与云盘」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [知识库](/apps/wiki) | 必装 | 团队共享的知识库 | 组织共有的知识库：页面树、多人实时协同编辑、按部门与角色授权 |
| [文档](/apps/doc) | 可选 | 个人与协作文档 | 自己的文档：页面树、多人实时协同编辑、分享给同事 |
| [云盘](/apps/storage) | 可选 | 文件的存放与分享 | 在组织的云盘里管理文件：助手生成的内容、上传的资料，按角色控制访问并分享 |
| [资料库](/apps/library) | 可选 | 要让云盘里的制度、手册、合同等文件的内容也能被搜索和被助手引用时再装（需要云盘） | 云盘里指定目录的文件内容：抽取文本、分块、检索，助手可以引用段落和页码 |

> **提示**
>
> 「资料库」应用在套件收录原因中注明需要「云盘」，但这并非系统强行拦截的硬依赖。组织未安装云盘时仍可点击安装资料库，但实际使用时功能不完整。

### 7. 「数据分析」套件
摘要：「图表与看板，按查看者的数据权限计算」

| 应用 | 角色 | 收录原因 | 用途说明 |
|---|---|---|---|
| [分析](/apps/analysis) | 必装 | 图表与看板 | 对你有权限的数据做分析：图表与看板，按你自己的数据权限计算 |

### 平台内置应用（不可卸载）

平台自带以下系统应用，不出现在应用市场列表，没有卸载卡片，组织无法卸载或停用：

| 界面中文名 | 所属分组 | 用途说明 | 可否卸载 |
|---|---|---|---|
| [Agent](/agent/overview) | 「Agent」 | 管理[定时任务](/agent/tasks)；审阅、修改并应用助手起草的变更；管理自动应用；查看和整理会话 | 否 |
| [我的组织](/admin/) | 「行政」 | 通讯录与权限、应用、助手、数据、品牌、安全与审计 | 否 |
| [消息中心](/guide/messages) | 「办公」 | 站内信、平台通知和系统提醒（导航页名另有「消息」） | 否 |

### 工作台多入口应用

部分应用在工作台中提供多个标签入口（共用同一套安装状态与权限）：
- **「Agent」**：在工作台中展开为 3 个入口标签：
  - 「定时任务」
  - 「草稿」（应用内的「自动应用」功能同样归入此入口）
  - 「Session」
- **「会员」**：在工作台中展开为 2 个入口标签：
  - 「康复」（今日、会员、预约、量表库、统计、提成、设置）
  - 「前台」（核销、会员、课程包、待付款、退款申请、设置）
- **「分析」**：在工作台中展开为 3 个入口标签：
  - 「看板」
  - 「探索」
  - 「数据」
- **其他应用**：其余一方应用在工作台中均为单一标签入口。

## 常用操作

### 安装单个应用

1. 在[工作台](/guide/workspace)进入「我的组织」→「应用与市场」。
2. 点击「应用」页签。
3. 在搜索框中输入关键字，或在「全部分类」中筛选，找到目标应用卡片。
4. 在卡片右下角点击「安装」。
5. 安装完成后，卡片底部显示开关及「已启用」，工作台标签栏按所属套件分组显示该应用。

### 停用或启用应用

1. 在「应用与市场」页面点击「应用」页签。
2. 找到已安装的应用卡片。
3. 点击卡片底部的状态开关，切换为「已停用」或「已启用」。
4. 切换为「已停用」后，成员无法在工作台打开该应用，但应用数据完整保留；切换回「已启用」后恢复正常使用。

### 卸载应用

> **注意**
>
> 卸载应用会导致成员无法继续使用该应用。应用内的数据、自定义展示名和模块开关均会保留，重新安装时会自动恢复。

1. 在「应用与市场」的「应用」页签找到已安装的应用卡片（或进入该应用详情页）。
2. 点击卡片底部的「卸载」按钮。
3. 在弹出的卸载确认框中（标题为「卸载」后接应用名加问号），阅读说明「成员将无法使用。所有数据、名称和模块开关保留，重新安装时恢复。」。
4. 点击弹窗中的「卸载」按钮。
5. 卸载完成后，界面提示「已卸载」。应用从工作台中移除，且不会级联卸载所属套件中的其他应用。

### 安装套件

1. 在「应用与市场」页面点击「套件」页签。
2. 找到目标套件卡片，点击「安装套件」。
3. 在弹出的「安装套件：」后接套件名的对话框中查看成员清单：标记为「必装」的应用已默认勾选且不可取消；标记为「可选」的应用可按需自主勾选。已经安装的应用会标注「已安装，保持不变」。
4. 点击底部提交按钮（显示为「安装」后接个数再接「个应用」；若无需安装新应用则显示「没有需要安装的」）。
5. 安装完成后，弹窗显示安装结果说明「安装结果如下。装好以后每个应用仍然各自独立：可以单独停用、卸载、升级。」，并列出安装结果。点击「完成」关闭弹窗。

> **提示**
>
> 若安装套件中途失败，系统提示「套件没有装成」，并仅回滚本次新装的应用，原有已安装的应用保持不变。

### 升级应用

1. 在「应用与市场」的「应用」页签中，找到带有新版本徽章的已安装应用卡片。
2. 点击卡片底部的「升级」按钮。
3. 若新版本需要额外访问，弹出「升级」后接应用名、再接「到」版本号加问号的确认框，按钮为「同意并升级」。确认文案写明不能降级。
4. 两个及以上应用待升级时，页上另有「全部升级」。升级完成后，应用更新至最新版本。

### 配置模块开关与自动升级

1. 在「应用与市场」的「应用」页签中，找到已安装的应用卡片。
2. 点击展开卡片中的「设置」。
3. 根据需要开启或关闭各个功能模块开关。操作后列表提示「已启用」或「已停用」及模块名（在详情页提示开启或关闭具体模块）。
4. 根据需要开启或关闭「新版本上架后自动升级」开关。开启后，该应用有新版本上架时将自动升级。

### 在工作台按套件筛选应用

1. 在[工作台](/guide/workspace)标签栏左侧，点击当前显示的套件名称。
2. 在展开的宫格面板中，点击某个套件名称，或点击「显示全部」。
3. 选择特定套件后，工作台仅展示该套件下已安装且启用的应用；点击「显示全部」后，所有已装且启用的应用恢复平铺展示。此操作仅影响视图展示，不改变应用的安装与启用状态。

## 状态说明

应用不涉及复杂的单据流转，状态主要体现为安装状态与套件成员就绪状态：

### 应用状态

| 状态 | 界面表现 | 说明 |
|---|---|---|
| 未安装 | 卡片显示「未安装」及「安装」按钮 | 组织尚未安装此应用 |
| 曾安装 | 卡片显示「曾安装于……」及「安装」按钮 | 曾经安装过但已被卸载，重新安装可恢复原有数据与配置 |
| 已启用 | 卡片底部开关显示「已启用」 | 应用已安装且处于启用状态，成员可在工作台正常访问 |
| 已停用 | 卡片底部开关显示「已停用」 | 应用已安装但被管理员暂停使用，成员无法打开，数据保留 |

### 套件成员应用状态

在「套件」页签中，成员应用行会显示以下状态：
- 「已安装」：该应用已在当前组织安装。
- 「已停用」：该应用已安装但处于停用状态。
- 「暂不能安装」：该应用尚未上架、未通过契约测试或不在授权范围内。
- 「未安装」：该应用尚未安装。

### 套件就绪状态

套件卡片底部根据成员安装情况显示不同状态：
- 「成员已全部安装」：套件内所有应用（必装与可选）均已在当前组织安装。
- 「必装的已就绪」：套件内的所有必装应用已全部安装，可选应用尚未全部安装。
- 提示「缺少必装：……」：套件内存在尚未安装的必装应用，需要补充安装。

## 让助手帮你做

「应用与市场」属于组织管理界面。助手不能自己改安装状态，也不能卸载系统内置应用或在工作台套件切换器中安装应用。

管理员可以让助手提出「安装应用」「卸载应用」「安装套件」「启用或停用应用」「升级应用」或「升级全部应用」，你在[动作确认](/agent/confirm)中同意后才会执行。

成员可以让助手快速打开已经安装的应用：

> 打开人力资源。
> 打开分析看板。
> 帮我打开经营。
> 打开活动应用。

> **提示**
>
> 助手提出的安装、卸载或升级必须由组织管理员在动作确认中同意。普通成员不能代替管理员完成这些操作。

## 设置

在「应用」页签中，展开已安装应用卡片底部的「设置」可进行以下配置：

| 设置项 | 作用 | 默认值 | 谁能改 |
|---|---|---|---|
| 模块开关 | 按需开启或关闭该应用下的具体功能模块 | 默认随版本设置 | 组织管理员 |
| 「新版本上架后自动升级」 | 开启后，当该应用上架新版本时由系统自动完成升级 | 关闭 | 组织管理员 |

应用详情「设置」里另有「在你们的工作台里怎么显示」：字段是「显示名称」（还可改「图标」）。留空用原来的名称。卡片展开的「设置」里没有展示名。

> **提示**
>
> 系统没有套件级别的配置项，所有设置均在单个应用维度进行配置。

## 注意事项

- **系统内置应用限制**：平台自带的「Agent」「我的组织」「消息中心」是系统应用，不能卸载或停用，也不出现在应用市场卡片中。
- **卸载保留全部数据**：卸载应用不会删除业务数据。卸载后仅停用成员使用入口，所有数据、自定义展示名和模块开关配置均完整保留，重新安装后自动恢复。
- **套件必装依赖约束**：安装套件时，如果必装应用无法安装（未上架、未通过契约测试或不在授权范围），整个套件将无法安装，界面提示「装不了这个套件」，并写明必装应用暂不能安装。可选应用缺少依赖时仅提示「缺少依赖（不会阻止安装）」，不阻止套件安装。
- **套件安装失败回滚**：安装套件如果失败，系统仅回滚本次新安装的应用，原本已经安装的应用不受任何影响。
- **套件独立性**：套件不是应用，本身没有独立代码、权限或数据。套件安装后，每个应用依然单独授权、单独计数，可各自独立停用、卸载或升级。一个应用仅属于一个套件。
- **套餐与配额限制**：组织的[套餐与用量](/admin/usage)会限制允许安装的应用数量。达到配额上限或缺少许可时，「安装」按钮会变为禁用置灰状态，鼠标悬停可查看受限原因。
- **权限独立分配**：安装应用或套件不会自动为成员分配业务操作权限。应用的具体业务权限须在[业务角色](/admin/roles)中单独配置。

## 目前不支持

- **批量卸载套件**：目前没有提供一键卸载整个套件的功能，若需卸载只能逐个卸载其中的应用。
- **工作台直接安装**：目前不支持在工作台套件切换器中直接安装应用，安装必须由管理员在「应用与市场」中进行。
- **Session 标签自定义中文**：工作台「Agent」应用的第三个入口标签当前固定显示为英文「Session」，暂不支持配置为中文界面名称。

## 常见问题

#### 普通成员为什么在「我的组织」里找不到「应用与市场」？
「应用与市场」的侧栏入口只给组织管理员。普通成员和审计员在「我的组织」中都看不到该入口。如果工作台尚未安装任何业务应用，普通成员和审计员在工作台会看到提示「请联系组织管理员安装。」。

#### 卸载应用会清除原有的业务数据吗？
不会。卸载应用只会移除组织成员的使用入口。应用内的全部业务数据、自定义展示名以及模块开关配置都会完整保留。重新安装该应用后，原有数据与设置会自动恢复。

#### 为什么点击「安装套件」时提示「装不了这个套件」？
套件安装要求其中的所有「必装」应用均具备安装条件。如果某个必装应用尚未上架、未通过契约测试或不在当前组织的授权范围内，系统会阻止套件安装，并写明该必装应用暂不能安装。可选应用无法安装不会阻止套件安装。

#### 可以在工作台的套件切换器里直接安装新应用吗？
不能。工作台左侧的套件切换器仅用于在已安装且启用的应用之间进行分类筛选或恢复平铺展示。安装应用或套件必须由管理员进入「我的组织」→「应用与市场」进行操作。

#### 助手可以直接帮我安装或卸载应用吗？
助手不能自己改安装状态。管理员可以让助手提出安装、卸载、停用、启用、升级或安装套件，你在[动作确认](/agent/confirm)中同意后才会执行。普通成员只能让助手打开已经安装好的应用。