七 AI 助手
智能体按你的要求整理资料、调用技能，再通过店智效执行已开放的店铺任务。这里统一说明店铺接入、任务使用，以及技能广场的下载、安装、上传和更新。
1.1 连接店铺
- 启动店智效客户端，登录软件账号，核对目标店铺和会员状态。
- 在客户端的 MCP 设置中获取接入配置，添加到自己的 AI 工具；密钥只保存在自己的连接配置中。
- 软件页面操作使用 dianzhixiao-desktop；淘宝、天猫业务使用 dianzhixiao-taobao；1688 使用 dianzhixiao-1688。
- 先读取能力目录，再做一次本店只读查询，核对平台、账号和店铺；每店 Key 只能操作所属店铺。
使用当前客户端提供的配置，不复用旧插件的连接地址。不要把密钥、密码或验证码发进公开聊天、截图或反馈。
1.2 交代任务、确认结果
说明哪家店、哪些对象、做什么、目标是什么。智能体先读取本店开放能力，检查与预览后，再按明确授权执行；任务由对应店铺工作区中的店智效完成，智能体继续查询原任务并汇总结果。
| 任务 | 需要说明 |
|---|---|
| 查询推广 | 频道、统计日期、计划／单元等对象范围 |
| 调整已有投放 | 精确对象 ID、原值和目标值、金额单位、执行范围 |
| 按货号上新 | 店铺、货号、素材来源、发布方式及上架位置；复用店智效保存的上新配置 |
| 数据下载 | 数据日期、类别与本店已授权目录 |
可以这样交代一批上新：
处理这个素材文件夹里的货号，按本店规则整理资料、写标题和规格名、填入上新表。检查通过后列出本批货号和上架位置，经我确认再调用店智效放入仓库，并核对每个货号的结果。
首次配好技能、资料来源和权限后，每批图片按货号分好文件夹，就可以交给智能体连续处理。价格、库存、材质、尺寸等使用已有资料或明确规则；资料缺失时先补齐。目录授权、平台登录和安全验证由本人完成。
具体业务以当前平台和店铺的能力目录为准；页面上新仍按原有配置、飞书资料和素材规则使用。
| 任务状态 | 怎么处理 |
|---|---|
| 排队、已领取、运行中 | 保持店铺工作区和登录可用，继续查询原任务 |
| 成功 | 核对实际对象 ID、数量、状态及写后结果；预检成功不等于已执行 |
| 明确失败、部分成功 | 分清完成项与失败项，按具体字段和原因处理 |
| 待确认、结果未知 | 先读取原对象状态，不另建任务重复提交 |
| 取消、到期 | 先核对原记录；取消只支持仍未领取的排队任务，不撤销已完成的平台修改 |
1.3 下载与安装技能
打开技能广场，搜索技能名称或用途，也可以多选场景分类。点击技能卡片查看具体功能、使用方法、运行条件、配置要求和版本记录。浏览、下载及复制安装指令不需要登录。
| 方式 | 操作 |
|---|---|
| 让AI安装 | 在技能详情复制安装指令，发给自己的AI工具；AI读取安装说明、下载并核对包，安装后带你配置和试运行 |
| 手动下载 | 点击详情页“下载”，将 ZIP 交给自己的AI工具按说明安装；历史包可从版本记录下载 |
下载完成还不等于可以使用。按技能说明配置所需账号、软件、目录、表格和权限，再做一次小范围验证。技能在自己的AI工具中运行，店智效不安装或运行技能。
例如店智效标题与规格名负责看图写标题、规格名，写回已有飞书记录并读回核对；它不负责建表、补价格库存或直接发布。建表和其他资料处理配置对应能力，上新通过店智效接入执行。使用标题词库时，把技能的词表位置与店智效关键词抓取的目录对应好。
更新已安装技能时，让AI按该技能当前安装说明更新，再检查配置变化并试运行。保留自己的配置、词库与数据；官网发布新版不会自动替你更新电脑里的副本。
1.4 上传自己的技能
- 登录会员，在“我的技能”设置作者名称；使用 2～20 字、未被占用且不冒充官方的名称。
- 从技能广场“我要上传技能”，或会员中心“我的技能”进入上传表单。
- 按“基本信息 → 使用与配置 → 上传发布”填写，最后选择 ZIP 并提交。
- 查看自动审核结果。通过即发布；不通过按列出的原因修改后再提交。
| 字段 | 是否必填 | 要写清楚什么 |
|---|---|---|
| 技能名称 | 必填，2～40 字 | 面向使用者的名称 |
| 一句话介绍 | 必填，5～120 字 | 解决什么问题 |
| 场景分类 | 必选，至少一类，可多选 | 按实际用途选择店铺全运营、作图／视觉、广告分析或适用平台等分类 |
| 具体功能 | 必填，10～3000 字 | 能做哪些事、处理什么输入、产出什么结果 |
| 使用方法 | 必填，10～3000 字 | 操作顺序，并给一句可发给AI的任务示例 |
| 运行条件 | 必填，2～1000 字 | 系统、软件、账号、权限；涉及付费服务时说明 |
| 是否需要配置 | 必选 | 选择无需配置或需要配置 |
| 配置说明 | 选择需要配置后必填，10～3000 字 | 各配置项、获取位置和填写方式，不填真实密码或密钥 |
| 注意事项 | 选填，最多 2000 字 | 限制、会修改哪些数据及其他需提前了解的事项 |
| 技能包 | 首次上传和更新包时必填 | ZIP，最大 20 MB |
| 更新说明 | 首次上传选填；发布新版本必填，最多 200 字 | 新增、修复、变化，以及用户需要调整的配置 |
ZIP 根目录或唯一文件夹中应有 SKILL.md，包含 name、description。name 决定技能地址，同一个技能更新时保持不变。只放分发需要的说明与脚本，不放账号凭据、私有配置、个人数据和运行记录；详细限制见审核规则。每账号最多 30 个技能，24 小时内最多上传 20 次，页面显示剩余额度。
1.5 编辑、更新与上下架
在“我的技能”找到技能，点击“编辑技能”，选择这次是只改说明还是同时更新包。
| 操作 | 结果 |
|---|---|
| 只修改说明 | 保存功能、用法和配置等介绍，保留技能包与原版本号 |
| 同时发布新版本 | 上传相同 name 的 ZIP，必填更新说明；通过审核后生成新的 v1、v2、v3…版本，历史版本保留 |
| 作者自行下架 | 从公开展示中移除，需要恢复时再重新上架 |
| 编辑已下架或暂停的技能 | 不会因保存说明或上传新包而自动恢复上架 |
| 管理员下架 | 查看原因，按管理状态处理；不能靠再传新包绕过下架 |
上传记录可以查看审核结果与失败原因。使用者登录后可以点赞或取消点赞，同一会员对每个技能只计一次，作者不能给自己点赞。发现问题可举报；会员技能收到三位不同会员的未处理举报后暂停展示，等待管理员处理。
1.6 连接与使用问题
| 问题 | 先检查 |
|---|---|
| MCP 无法连接 | 地址和 Key、绑定店铺、会员状态及客户端支持的连接方式 |
| 任务一直排队 | 客户端是否运行、所选店铺是否在线、平台登录和所需能力是否就绪；连接恢复后继续查询原任务 |
| 换了另一家店 | 使用该店自己的绑定与接入配置，不能只改任务里的店铺名称 |
| 技能已下载但不能运行 | 安装位置、运行软件、账号权限及配置清单；按安装说明逐项验证 |
| 上传审核失败 | 查看具体字段、文件与原因，修正后提交；不要只换文件名重传 |
| 执行回执中断 | 保留原任务 ID，连接恢复后查原任务与实际结果，不重复写入 |
反馈时提供发生时间、平台、任务 ID、阶段和错误码，遮挡密钥、密码及验证码。文件下载结果按数据下载核对，客服入口见客服反馈。