需求说明 · 全局 Skill 按钮状态机统一

关联体验问题 #2 / #5 / #7 / #10 · 2026-06-16 · 上方为可交互原型

一、根因

对话推荐卡片、Skill 商店列表卡片、Skill 详情页三处的按钮各自为政，图标与点击语义到处漂移。根因是没区分两个独立维度，并把它们混进了同一个动作、同一个 ✓。

二、两个维度

• 安装维度：Skill 在不在「我的 Skill」库里（未安装 / 已安装）
• 应用维度：是否应用到对话（对话级概念）

三、统一三态 + 语境

统一状态：S1 未安装 / S2 已安装·未应用 / S3 已应用。

• 管理场景（商店列表、详情页）：稳定呈现 S1 / S2，S3 在对话里体现
• 使用场景（对话推荐卡片）：完整三态，且可一步从 S1 直达 S3

四、路径差异（快捷 vs 正常）

• 商店（正常）：S1 ──安装──▶ S2 ──应用──▶ S3（两步，应用=跳转到对话）
• 对话卡片（快捷）：S1 ──添加（安装+应用）──▶ S3（一步）

五、"应用"语义

应用 = 应用到对话（对话级）。对话卡片应用到当前对话；商店列表 / 详情页点「应用」→ 跳转到对话并应用：有当前对话则回当前对话，无则新建对话（复用 #5 的跳转）。

六、三处对照

	对话推荐卡片	商店列表卡片	详情页
流程	快捷（可一步）	正常两步	正常两步
S1 未安装	「+ 添加」	「安装」	「安装」
S2 已装·未用	「应用」	「应用」	「应用」
S3 已应用	「✓ 已应用」	跳对话后体现	跳对话后体现
应用落点	当前对话	跳转到对话	跳转到对话
卸载入口	··· 菜单	无	··· 菜单
成功反馈	toast	toast	toast

七、全局铁律

1. 颜色固定：紫 = 安装 / 添加 / 应用（正向主动作）；✓ = 已生效（已安装 / 已应用）；红 = 卸载
2. ✓ 永远代表"已生效"，绝不出现在未选中 / 未安装项上
3. 卸载永远"藏一层（··· 菜单）+ 二次确认"，绝不做成一眼能误点的主按钮；商店列表不放卸载
4. 所有正向操作（安装 / 应用 / 添加 / 卸载完成）都弹 toast 反馈

八、各处细则

• 对话推荐卡片：术语「添加 / 应用」。S1「+ 添加」一步安装并应用；S3 点击取消应用（→ S2），删输入框标签等价取消应用；卸载在 ··· + 二次确认
• 商店列表卡片：术语「安装 / 应用」。S1「安装」仅入库；S2「应用」跳转到对话使用；列表不提供卸载
• 详情页：同列表流程；卸载收进 ··· 菜单 + 二次确认；安装成功弹 toast，按钮由「安装」变为「应用」，不再直接变「卸载」

九、边界情况

• 商店点「应用」但无当前对话 → 新建对话并带入
• 卸载一个正应用于对话的 Skill → 二次确认通过后，同时取消应用 + 卸载
• 同一对话可应用多个 Skill（呼应 #1 多选需求），各卡片状态独立

十、验收标准

• ✓ 只出现在「已生效」状态（已安装 / 已应用）
• 已安装项点击主控件不再触发卸载（卸载在 ··· + 二次确认；商店列表无卸载）
• 安装 / 应用 / 添加 / 卸载完成都有 toast
• 商店点「应用」跳转到对话并应用（有当前对话回当前，无则新建）
• 详情页安装后弹 toast 且按钮变为「应用」，而非直接变「卸载」
• 术语：对话「添加」、商店与详情页「安装」，全程一致