店智效标题和SKU命名
官方搭配店智效插件上新必备
使用说明
具体功能
按货号读取飞书上新表中的商品资料，实际查看商品图片。 结合店铺规则和清洗后的词库生成商品标题，按图片与原始命名规则整理规格名。 先生成方案，确认后写回飞书并读回核对；上架由店智效插件完成。
使用方法
- 安装后，让 AI 运行配置向导，完成店铺、飞书表格与素材目录配置。
- 指定店铺、货号范围，以及本次要写标题还是规格名。
- 查看生成方案，确认后让 AI 写入飞书并核对结果。 示例：处理这家店指定货号的标题和规格名，先给我看方案。
运行条件
能读取技能、查看图片并运行 Python 的 AI 工具，例如 Codex、WorkBuddy、Claude Code。 Python 3.9 及以上；可编辑的飞书多维表格、自己的飞书应用及相应权限；本机商品图片。 生成标题还需要已清洗的关键词库；只生成规格名时不需要标题词库。
配置说明
飞书连接：配置自己的应用 App ID、App Secret，并授予目标表格权限；密钥只保存在本机配置或环境变量中，不发到聊天或公开页面。 店铺规则：选择准确的飞书表格及字段，填写货号、SKU、素材目录、品牌、禁词、标题与规格名规则。 词库：准备清洗后的关键词库；需要用插件抓词时，AI 会给出对应本机目录，由你填入插件下载地址。 安装 AI 通过 onboard.py 逐项引导；飞书授权等必须由本人完成的步骤会明确提示。
注意事项
写回飞书前先确认方案；结果未核实时先检查，不重复写入。此技能不修改价格、库存，也不直接发布商品。
查看技能原始说明
店智效标题与规格名
这份技能让 AI 做三件事：看图写标题、看图写规格名（SKU命名）、写进飞书上新表并读回核对。传图和上架由店智效插件完成；价格、库存等经营数据不在本技能范围内，不写、不猜。
技能本身不带任何店铺数据。飞书表格、列名、素材文件夹、品牌、禁用词和词库，全部来自会员自己的配置。
文件位置
| 内容 | 位置 |
|---|---|
| 规则说明 | references/ |
| 脚本（只用 Python 标准库） | scripts/ |
| 店铺配置 | <数据目录>/config/stores/<店铺标识>.json，模板 config/store.example.json |
| 飞书凭证 | <数据目录>/config/feishu.local.json，或环境变量 FEISHU_APP_ID、FEISHU_APP_SECRET |
| 词库 | <数据目录>/libraries/：店智效插件“关键词抓取”的下载文件夹，按 平台/类目/周期/input/日期/ 存原始词表，清洗后的 keyword_library.json 放在对应的类目周期文件夹 |
| 清洗规则 | <数据目录>/config/keyword-rules/<名字>.json，示例 config/keyword-rules/*.example.json |
| 每批运行记录 | <数据目录>/state/<批次名>/，核对完成后删除 |
| 权限配置确认 | <数据目录>/state/setup-confirmations.json，只记录应用与表格的确认范围，不含凭证 |
数据目录默认就是本技能目录。AI 工具不允许写技能目录时，设置环境变量 DZX_TITLE_HOME 指向一个可写的文件夹，脚本自动改用那里。
命令都在技能目录下运行，例如 python scripts/feishu_table.py ...；Windows 上 python 不可用时改用 py。
装好后先做
刚安装或更新完技能、config/stores/ 里还没有店铺配置、会员要求配置，或者处理货号前发现配置不全时，先运行：
python scripts/onboard.py
python 和 py 都运行不了，或版本低于 3.9 时，先告诉会员需要安装 Python，征得同意后带会员装好（见[首次配置](references/setup.md)第 1 步），重新打开 AI 工具后再运行。
按它的输出和会员沟通：
- 先用两三句话告诉会员这个技能做什么、平时怎么用（输出的前两段）。
- 再把“需要客户配合的配置”清单完整告诉会员，说明哪些已完成、哪些要做。
- 从第一项未完成的开始，一次只做一项。需要会员亲自操作的（复制凭证、开通飞书权限、在插件里选文件夹）讲清在哪里点、填什么；需要会员提供的信息逐项问。每做完一项再运行一次
onboard.py，确认变成 ✓ 再做下一项。?也属于未完成，不能略过。会员明确确认当前应用权限和表格编辑授权已完成后，才可运行python scripts/onboard.py --store <店铺标识> --confirm-permissions记录；AI 不得自行确认，也不能以读表成功代替写权限确认。 - 写标题时，把“插件里要填的路径”原样发给会员：这是店智效插件“关键词抓取”的下载文件夹，词表下载到这里，本技能才能读到。引导脚本会创建空的
libraries目录并保留已有内容。只写规格名时不要求配置标题词库。 - 全部配置完成后，挑一个货号走到
plan（不写入），把写入计划给会员确认。配置完成仅表示准备就绪；首次实际写入后读回核对通过，才可宣称写入已验证。
每一步的细节见[首次配置](references/setup.md)。不要让会员把 App Secret 发在聊天里。
还没有有效店铺配置时，先按引导填写店铺，再确认该应用和表格的权限；不要在缺少店铺标识时反复要求确认权限。
会员说“更新这个技能”时，打开 https://dianzhixiao.yinceqiyeguanli.com/skills/dianzhixiao-title/install.md，按里面的步骤下载最新版本覆盖安装。会员的配置和词库在数据目录里（默认就是技能文件夹），覆盖安装时不要删除任何文件。
处理货号
会员要说清：哪家店、哪些货号、只写标题还是只写规格名或两个都写、写完是否直接写进表格。
- 没说写什么，按本店
default_mode。 - 没说写入，就先给结果和写入计划，等会员确认再写。
- 只配置了一家店时直接用；有多家店又没说是哪家，问一句。
-
读表：只按货号筛选读取，不读整张表。缺货号、同一货号 SKU 编码重复时，该货号单独报错，其余继续。
python scripts/feishu_table.py read --store <店铺> --items <货号...> --batch <批次名> -
看图：先列出素材，再用工具真正打开图片看，只看文件名不算。先看主图，判断卖的是什么、整体是什么风格；再按 SKU 顺序逐张看 SKU 图。每款至少看
assets.min_images_viewed张，图片不够就全部看完。python scripts/assets.py --store <店铺> --items <货号...> -
准备词库（写标题时）：自动取插件下载的最新一期词表；已是最新就直接用，否则按本店清洗规则重新清洗。提示没有词表或已过期时，请会员用插件重新下载，详见[词库](references/keyword_library.md)。只有会员明确同意，才能不用词库或用过期词库，并在结果里注明。
python scripts/keywords.py prepare --store <店铺> -
写标题：按[标题规则](references/title_rules.md)。
-
写规格名：按[规格名规则](references/sku_naming_rules.md)。
-
写前检查：把结果写进
state/<批次名>/results.json，格式见[写回与核对](references/feishu_write.md#结果文件)，再运行下面的命令。检查不通过就改内容重来，不能跳过。把计划摘要给会员看：哪张表、哪些货号、哪几列、改前和改后。python scripts/feishu_table.py plan --store <店铺> --batch <批次名> -
写入并读回核对：会员要求写入或确认了计划后执行。写完自动重新读表，逐条核对。只有核对通过，才能说“已写入”。
python scripts/feishu_table.py write --store <店铺> --batch <批次名> --yes -
汇报并清理：按下面的格式汇报，再清掉这批的运行记录。
python scripts/feishu_table.py clean --batch <批次名>
红线
- 只按货号筛选读表。不新建记录、不删记录，只改配置里的标题列和规格名列，其他列一律不动。
- 写入前必须通过
plan，写入后必须读回核对。以表里实际存下来的内容为准，聊天里一句“已完成”不算数。 - 写入结果不明确（网络中断、报错）时不能直接重发，先运行
verify，再按[出错怎么办](references/feishu_write.md#出错怎么办)处理。 - 颜色、图案可以看图判断；材质、尺寸、容量只用表格资料或本店
title.default_facts写明的，没写的不猜。 - 不加配置以外的品牌，不写竞品名、店铺名和“旗舰店、官方、正品”之类，不用“顶级、最佳、全网第一”这类绝对化用词。
- App Secret 不打印、不复述，不写进运行记录、结果文件或聊天。
汇报格式
逐个货号列出：标题和它的计数字符数、每个 SKU 编码对应的规格名、写入和核对结果。失败的写清原因和下一步。只复述 verify 已经核对过的结果。