自定义脚本和店铺 Agent
添加店铺 JavaScript 并选择一个店铺项目中可用的 Skill。
自定义脚本更改店铺行为，而店铺 Agent 更改 Runner 可以为当前项目使用的 Skill。两者都是店铺特定的设置，应该特别谨慎地审查。
本指南内容
您将能够添加和保存脚本、暂停它而不删除它，以及仅为当前项目添加或禁用 Skill。
可用性和前置条件
- 从预期项目内打开设置。
- 自定义 JavaScript 可以更改店铺行为。仅添加您理解和信任的代码。
- Skill 操作取决于可用的工作区 Skill 以及系统 Skill 是否可配置。
- 完整的 Agent 页面和计划门控仍然控制更广泛的 Skill 可用性。
入口路径
- 脚本：设置 → 商店：商店名称 → 自定义脚本
- 项目技能：设置 → 商店：商店名称 → Agent
自定义脚本控件
| 入口或按钮 | 为什么有用 | 接下来会发生什么 |
|---|---|---|
| 添加脚本 | 创建店铺脚本条目。 | 打开一个新的启用脚本行，带有空的 JavaScript 代码。 |
| 脚本行 | 展开或折叠其编辑器。 | 脚本名称 和 JavaScript 代码 变为可见。 |
| 眼睛/隐藏眼睛图标 | 启用或禁用一个脚本。 | 本地行更改状态；选择保存更改以应用它。 |
| 删除图标 | 从待处理列表中删除脚本。 | 行消失，没有第二个对话框；保存更改应用删除。 |
| 保存更改 | 应用每个待处理的脚本编辑。 | Runner 保存完整脚本列表并显示成功或错误消息。 |
Runner 允许最多十个脚本条目。当没有更改时，保存更改按钮保持禁用。
空白编辑器可供您在安装脚本前了解各个字段。本例未保存任何跟踪脚本。（英文界面）
添加或更改脚本
- 打开 店铺 → 自定义脚本。
- 选择 添加脚本。
- 输入清晰的 脚本名称 和受信任的 JavaScript 代码。
- 仅当脚本应在店铺上运行时才保持启用。
- 审查所有其他行，因为 保存更改 应用整个列表。
- 选择 保存更改 并等待 已保存。
- 在保存后安全地检查店铺。
Runner 尝试防止一个脚本错误导致页面崩溃，但这不会使未知代码安全。脚本仍然可以影响隐私、性能、跟踪和客户体验。
先查看脚本草稿
首次查看时，选择添加脚本，将其命名为 Store analytics，然后关闭眼睛图标对应的启用开关。代码保持为空，且不要选择保存更改。这样，您可以先了解编辑器和禁用状态，再添加可信提供方的代码。实际保存脚本后，请重新打开列表，检查代码和启用状态。
英文标注指出了操作位置。点击图片可放大查看。
管理项目技能时，请选择商店标题下的 Agent。此图仅展示入口，不代表已添加或停用技能。（英文界面）
店铺 Agent 控件
| 入口或按钮 | 为什么有用 | 接下来会发生什么 |
|---|---|---|
| 活跃 Skill 行 | 查看此项目中可用的 Skill。 | 该行显示名称、描述和系统或自定义类型。 |
| 禁用 | 从此项目中删除可配置的 Skill。 | Skill 离开此项目的活跃列表；它不会被全局删除。 |
| 添加技能 | 将可用的工作区 Skill 添加到此项目。 | 选择列出的 Skill 为当前项目启用它。 |
| 创建自定义技能… | 创建新的自定义功能。 | Skill 编辑器打开，成功后项目列表刷新。 |
配置项目 Skill
- 打开 店铺 → Agent。
- 审查当前活跃的 Skill。
- 选择 添加技能，然后选择可用的 Skill 或 创建自定义技能…。
- 等待成功消息并确认 Skill 出现。
- 当可配置的 Skill 应停止应用于此项目时使用 禁用。
- 打开项目导航中的 Agent，查看完整技能详情，或执行暂停、编辑、导入和删除操作。
状态和限制
- 脚本更改保持本地，直到 保存更改 成功。
- 删除脚本行在保存更改前没有单独的确认。
- 达到十个脚本会禁用 添加脚本。
- 店铺 Agent 可以显示加载、错误、暂无已启用的技能 或活跃列表。
- 固定系统 Skill 不显示 禁用。
- 在店铺 Agent 中禁用会更改此项目的范围；它不会全局删除或暂停 Skill。
故障排除
- 如果脚本仍在运行，确认其禁用状态后跟 保存更改。
- 如果保存失败，之前保存的列表保持不变；更正代码或在错误后重试。
- 如果 添加技能 没有预期的条目，检查完整的 Agent 页面和当前计划。
- 如果 禁用 不存在，系统 Skill 对此项目不可配置。
- 如果新 Skill 全局出现但不在这里，从店铺 Agent 将其添加到项目。