Square Connect

Square 是一个电商平台，可用于管理商品、规格、价格、库存和经营地点。通过 Square Connect， 可以将一个 DevDeck 项目连接到一个 Square 账号及其一个有效的 Location，让项目商城以 Square 中的商品目录和库存数据为准。

此连接不包含结账和订单能力

Square 仅管理商品目录和库存。不包含：支付/结算/订单功能。

在 DevDeck 中连接 Square

1. 在 DevDeck 中打开项目。
2. 在 Project Studio 中选择 配置 → 连接（Connections）。
3. 在电商（Commerce）分类下找到由 Square 提供的电商运营（Commerce operations），然后选择连接（Connect）。
4. 在确认窗口中选择前往 Square（Continue to Square）。
5. 登录 Square 或注册新的 Square 账号，选择要连接的商家，并同意所需权限。
6. Square 跳回 DevDeck 后，选择此项目要使用的 Square Location，然后选择 继续（Continue）。如果账号只有一个有效的 Location，DevDeck 可能会自动完成选择。
7. 确认连接卡片显示 Square 已连接，并显示所选 Location。

此项目的商品目录和库存将使用所选 Location。如果已经完成 Square 授权，但还未选择 Location，可再次选择连接（Connect），重新打开 Location 选择窗口。

连接不会自动导入已有商品

Square Connect 不会自动把项目原有的商品目录复制到 Square。如果项目中已有商品，可在 Square 连接卡片上选择检查商品迁移（Review catalog），先预览商品和规格数量，再明确 确认导入。

连接成功后在哪里管理商品和库存

Square 连接成功后，打开 Project Studio 左侧菜单中的 **Manage（管理）**分组，可以看到：

• 商品管理（Products） — 打开已连接 Square 账号的商品库。
• 库存管理（Inventory） — 打开 Square 库存管理页面。

这些菜单会在新的浏览器标签页中打开对应的 Square Dashboard 页面。在配置 → 连接中 选择已连接的 Square 卡片，也可以打开该账号的 Square Dashboard。

使用 AI Builder 聊天管理电商

除了进入 Square Dashboard，你也可以直接在 AI Builder 中通过聊天管理已连接的 Square 商品和库存。用日常语言描述希望完成的操作，AI Builder 可以查询当前项目所选 Location 下的商品、规格、分类和库存，并执行支持的修改。

例如，可以这样说：

• “查询经典 T 恤的所有规格和当前库存。”
• “新建一个陶瓷马克杯，添加标准规格，价格为 19.90 美元，并开启库存跟踪。”
• “把经典 T 恤黑色 M 码的价格改为 29 美元。”
• “把陶瓷马克杯标准规格的库存调整为 30 件。”
• “在当前 Location 下架夏日礼盒。”

如果商品或规格不明确，AI Builder 可能会继续询问。只读查询会直接执行；涉及价格、库存、 Location 可售状态、批量操作或删除的修改，会在聊天中显示待确认操作。请核对具体变更， 确认后 DevDeck 才会修改 Square 数据。

在 Square 中管理商品

1. 在 DevDeck 中选择 Manage → 商品管理（Products）。
2. 在 Square 的 Item Library（商品库）中创建商品，或打开已有商品。
3. 根据需要填写商品名称、描述、分类和图片。
4. 添加商品规格，并为商城中销售的每个规格设置固定价格。
5. 确保商品在 DevDeck 项目连接的 Location 中可用，然后保存。

DevDeck 会读取所选 Location 下的 Square 商品和规格数据。商品需要分配到该 Location， 并且具有大于零的固定价格，才能在商城中显示为可用。支付和订单需要另外连接 Stripe。

在 Square 中管理库存

1. 在 DevDeck 中选择 Manage → 库存管理（Inventory）。
2. 在 Square 中选择 DevDeck 项目连接的 Location。
3. 找到需要修改库存的商品规格。
4. 使用 Square 的库存调整或重新盘点功能，选择正确的调整原因并填写数量。
5. 保存库存调整。

启用库存跟踪后，商品规格必须有明确且大于零的库存数量，才能在商城中显示为可用。如果没有 启用库存跟踪，Square 可以在不显示库存数量的情况下保持该规格可用。

请始终核对 Location

Square 会分别记录各个 Location 的库存。修改其他 Location 的库存，不会改变当前 DevDeck 项目使用的库存。

Square Location 是什么？

**Location（经营地点）**是 Square 用来区分电商经营数据的业务地点或销售渠道。它可以 代表实体门店、仓库、移动经营点、线上商店，或商家开展业务的其他地点，并不只是一个 街道地址。

注册新的 Square 商家账号时，Square 会自动创建一个主 Location；商家之后也可以添加 更多 Location。不同 Location 可以分别设置商品是否可售、库存数量和价格，因此 DevDeck 会让每个项目选择一个有效的 Location，并使用该 Location 下的商品目录和库存数据。

如需在 Square 中查看 Location，请打开 Square Dashboard，进入 Settings（设置）→ Account & Settings（账号与设置）→ Business information（商家信息）→ Locations（经营 地点）。不同国家、地区或 Square Dashboard 版本的菜单名称可能略有不同。在这里可以 查看各个 Location 的名称、状态和地址。

DevDeck 要求选择 Location 时，请选择希望项目商城使用其商品目录和库存的经营地点。选择 窗口会显示 Location 名称，并在有地址信息时同时显示地址。

断开 Square

如需移除连接，请打开配置 → 连接并断开 Square。断开后，项目将无法继续访问 Square， 但不会删除 Square 中的商品或库存。