1688 Item Title Optimizer — 1688 商品标题优化器

1688 商品标题智能优化助手 —— 商品标题智能优化技能概述 自动并发执行两种优化算法生成结果：1) 添加热词优化（快速、基于规则）2) LLM 深度重写（高质量、自然流畅）。只需提供商品 ID，即可同时获得两种优化方案供对比选择。支持用户偏好参数（如"加入'防潮'单词"）。

使用场景

• 商品标题修改、改写、优化
• 新品发布，需要高质量标题
• 批量优化商品标题
• 用户有特定优化偏好（如指定关键词、风格）

CLI 命令

• configure — 配置 AK

- 查看 AK 状态：python3 {baseDir}/cli.py configure - 设置 AK：python3 {baseDir}/cli.py configure YOUR_AK 配置网关鉴权所需的 AK。所有操作命令都依赖 AK，首次使用前需先配置。

• optimize_title — 添加热词优化（方式A）

- python3 {baseDir}/cli.py optimize_title --item_id <商品ID> 基于规则和统计的标题优化，保留原标题结构，快速添加高价值热搜词。

• optimize_title_llm — LLM 深度重写（方式B）

- 基础调用：python3 {baseDir}/cli.py optimize_title_llm --item_id <商品ID> - 带用户偏好：python3 {baseDir}/cli.py optimize_title_llm --item_id <商品ID> --preference "加入防潮单词" 基于大语言模型的智能标题重写，全面改写标题，支持用户偏好定制。

• get_keyword_info — 获取关键词信息

- 基础调用：python3 {baseDir}/cli.py get_keyword_info --item_id <商品ID> - 添加自定义关键词：python3 {baseDir}/cli.py get_keyword_info --item_id <商品ID> --custom_keywords "保温杯;不锈钢;便携" 获取标题优化所需的全部关键词数据（热搜词、曝光词、类目信息）。

• get_tokenizers — 获取分词器列表

- python3 {baseDir}/cli.py get_tokenizers 获取所有可用的分词器列表及说明。

重要：技能使用规范 规则2：获取到商品ID后，自动并发执行两种优化 当用户请求标题优化时，必须按以下步骤执行，关键节点需等待用户确认后再继续：

• 参数要求（硬性阻断点）：如果用户未提供商品 ID，严禁弹 card 询问，必须按规则1输出JSON
• 多商品澄清（≥3 个商品时必须触发）：如果用户一次传入 3 个及以上商品 ID，必须先触发 select_items_to_optimize 交互，让用户筛选需要优化的商品

展示所有商品 ID 及其当前标题（如能获取），让用户选择要优化的商品 必须等待用户选择后再继续，禁止自动对所有商品执行优化 如果用户传入 1-2 个商品，可直接跳过此步骤进入下一步

• 自动执行：收到用户的优化请求后（或用户在澄清点选定商品后），必须自动并发调用两种优化命令

并发调用：在同一个消息中同时发起两个工具调用：optimize_title（方式A：添加热词优化）和 optimize_title_llm（方式B：AI 深度重写） 提取偏好：如果用户在请求中提到特殊要求（如"加入'防潮'单词"），提取偏好并传入 optimize_title_llm 的 --preference 参数 展示结果：触发 title_comparison_card（type: table，在左侧弹出表格）3 列（方案 + 属性 + 内容），每个方案 4 行（方案名称、新标题、生成逻辑及优化说明、预估曝光变化） 利用 mergedColumns: ["plan"] + selectionGranularity: "group" + groupBy: "plan" + selectionMode: "single" 实现方案列合并单元格 + 组级单选勾选 通过 actions 配置一个 key: "adopt" / label: "采用此方案" / variant: "primary" 的按钮替代默认"确认选择" rows 的 plan 字段：同组所有 4 行都填相同方案名（如全部填"方案A"或全部填"方案B"），端侧依靠相同值进行合并和分组

• 应用确认

向用户展示选定的新标题，与原标题对比 触发 confirm_apply_title 交互，让用户选择：确认，应用到商品标题；我想手动微调后再应用（用户可输入修改后的标题）；仅记录，暂不应用 必须等待用户确认后再继续，禁止自动跳过 应用到商品：如果用户确认应用，且存在技能 1688-item-one-click，则调用技能更新商品标题 如果用户手动微调了标题，使用微调后的版本应用

规则3：结果展示规范（左侧 Table 表格） 展示时必须使用 title_comparison_card（type: table）交互组件，在左侧弹出表格，3 列（方案 + 属性 + 内容），每个方案 4 行，方案列合并为大单元格，组级互斥单选勾选。

端侧版本依赖（v2 协议）：本交互依赖 mergedColumns / selectionGranularity / selectionMode / groupBy 4 个 v2 字段，仅在已升级到 v2 的客户端才会生效。当前 1688 工作台 / 找工厂客户端尚未升级，会忽略这 4 个字段，退化为默认的 row + multiple（每行一个 checkbox、可任意多勾、无方案列合并）。

Agent 必须知道：payload 不要为兼容降级而修改——协议字段写法是正确的，等客户端升级即可自动生效 看到「每行一个 checkbox」不是 payload 错了，是端侧降级渲染 处理 selectedRows 时必须用下方"用户回传后处理"统一兼容算法，不能假设回传一定是同一方案的 4 行 完整端侧能力对比与降级表见 references/interaction-specs.md 中"端侧版本依赖"小节

展示规范（title_comparison_card）：

• title：格式为"请选择新标题 — 商品名称（商品ID）"
• columns 固定 3 列：plan（方案标识列，宽 80px，不传 editable）field（属性标签列，宽 140px，必须显式声明 editable: false）value（内容列，宽 620px，列级不传 editable，由行级 rows[i].editable: true 仅在"新标题"行开启）
• 行级 editable 协议（2026-05 用户实测有效）：1688 端侧官方曾答复"列级 editable 不支持行级控制"，但用户实测确认端侧已支持 rows[i].editable: true 行级控制。本场景配合"field 列显式 editable: false + value 列不传 + 仅新标题行 rows[i].editable: true"的组合写法，达到"仅新标题行可编辑、其他所有 cell 都只读"的预期效果。
• 双层保护（防御性设计）：即使端侧某天回退、行级 editable 失效，Agent 在读取回传时仍必须软兜底：只采用「新标题」行的编辑值，其他 3 行编辑显式忽略（详见下方"用户回传后处理"第 6 步），保证业务正确性不依赖于端侧能力

v2 协议合并/勾选字段（4 个，缺一不可）：

• mergedColumns: ["plan"]：方案列按相邻同值合并为大 rowSpan 单元格
• groupBy: "plan"：按方案字段切分相邻分组（selectionGranularity:"group" 时必填）
• selectionGranularity: "group"：勾选单位为组（每组组首行渲染一个 checkbox，整组共用）
• selectionMode: "single"：勾选数量为单选（方案 A / B 互斥；选新组自动取消旧组；点已选项 = 清空；空选 = 跳过）

协议硬约束（违反会被主进程 validator 拒绝 / 端侧渲染异常）：

• mergedColumns 中的列不能是列级 editable: true —— 本场景 value 列已改为不开启列级 editable（用行级 rows[i].editable 替代），所以约束自动满足；仍只合并 plan，因为 value 每行内容不同没有相邻同值