---
title: 自定义脚本和店铺 Agent
description: 添加店铺 JavaScript 并选择一个店铺项目中可用的 Skill。
---

自定义脚本更改店铺行为，而店铺 Agent 更改 Runner 可以为当前项目使用的 Skill。两者都是店铺特定的设置，应该特别谨慎地审查。

## 本指南内容

您将能够添加和保存脚本、暂停它而不删除它，以及仅为当前项目添加或禁用 Skill。

## 可用性和前置条件

- 从预期项目内打开设置。
- 自定义 JavaScript 可以更改店铺行为。仅添加您理解和信任的代码。
- Skill 操作取决于可用的工作区 Skill 以及系统 Skill 是否可配置。
- 完整的 Agent 页面和计划门控仍然控制更广泛的 Skill 可用性。

## 入口路径

- 脚本：**头像 → 设置 → 店铺 → 自定义脚本**
- 项目 Skill：**头像 → 设置 → 店铺 → Agent**

## 自定义脚本控件

| 入口或按钮 | 为什么有用 | 接下来会发生什么 |
| --- | --- | --- |
| **添加脚本** | 创建店铺脚本条目。 | 打开一个新的启用脚本行，带有空的 JavaScript 代码。 |
| 脚本行 | 展开或折叠其编辑器。 | **脚本名称** 和 **JavaScript 代码** 变为可见。 |
| 眼睛/隐藏眼睛图标 | 启用或禁用一个脚本。 | 本地行更改状态；选择保存更改以应用它。 |
| 删除图标 | 从待处理列表中删除脚本。 | 行消失，没有第二个对话框；保存更改应用删除。 |
| **保存更改** | 应用每个待处理的脚本编辑。 | Runner 保存完整脚本列表并显示成功或错误消息。 |

Runner 允许最多十个脚本条目。当没有更改时，保存更改按钮保持禁用。

## 添加或更改脚本

1. 打开 **店铺 → 自定义脚本**。
2. 选择 **添加脚本**。
3. 输入清晰的 **脚本名称** 和受信任的 **JavaScript 代码**。
4. 仅当脚本应在店铺上运行时才保持启用。
5. 审查所有其他行，因为 **保存更改** 应用整个列表。
6. 选择 **保存更改** 并等待 **已保存**。
7. 在保存后安全地检查店铺。

Runner 尝试防止一个脚本错误导致页面崩溃，但这不会使未知代码安全。脚本仍然可以影响隐私、性能、跟踪和客户体验。

## 店铺 Agent 控件

| 入口或按钮 | 为什么有用 | 接下来会发生什么 |
| --- | --- | --- |
| 活跃 Skill 行 | 查看此项目中可用的 Skill。 | 该行显示名称、描述和系统或自定义类型。 |
| **禁用** | 从此项目中删除可配置的 Skill。 | Skill 离开此项目的活跃列表；它不会被全局删除。 |
| **添加技能** | 将可用的工作区 Skill 添加到此项目。 | 选择列出的 Skill 为当前项目启用它。 |
| **创建自定义技能…** | 创建新的自定义功能。 | Skill 编辑器打开，成功后项目列表刷新。 |

## 配置项目 Skill

1. 打开 **店铺 → Agent**。
2. 审查当前活跃的 Skill。
3. 选择 **添加技能**，然后选择可用的 Skill 或 **创建自定义技能…**。
4. 等待成功消息并确认 Skill 出现。
5. 当可配置的 Skill 应停止应用于此项目时使用 **禁用**。
6. 打开 **控制中心 → Agent** 以获取完整的 Skill 详情、暂停、编辑、导入或删除操作。

## 状态和限制

- 脚本更改保持本地，直到 **保存更改** 成功。
- 删除脚本行在保存更改前没有单独的确认。
- 达到十个脚本会禁用 **添加脚本**。
- 店铺 Agent 可以显示加载、错误、**暂无已启用的技能** 或活跃列表。
- 固定系统 Skill 不显示 **禁用**。
- 在店铺 Agent 中禁用会更改此项目的范围；它不会全局删除或暂停 Skill。

## 故障排除

- 如果脚本仍在运行，确认其禁用状态后跟 **保存更改**。
- 如果保存失败，之前保存的列表保持不变；更正代码或在错误后重试。
- 如果 **添加技能** 没有预期的条目，检查完整的 Agent 页面和当前计划。
- 如果 **禁用** 不存在，系统 Skill 对此项目不可配置。
- 如果新 Skill 全局出现但不在这里，从店铺 Agent 将其添加到项目。

## 相关指南

- [店铺常规](./store-general)
- [Agent 技能](../agent/skills)
- [创建、导入和管理技能](../agent/create-import-manage-skills)
- [API 密钥安全](./api-keys)