name: tk-product-editor description: 店小秘 TikTok 商品编辑与上架辅助:在店小秘商品详情页结合 1688 采购插件核验货源、材质、采购价、重量尺寸后,为 TikTok Shop 日本站商品选择分类、填写必填属性、优化日语标题和描述、检查/生成主图、填写变种、物流和保修信息,并按用户授权保存草稿或提交上架。
TK Product Editor
当用户给出店小秘 TikTok 商品编辑页链接,或要求“帮我编辑店小秘商品 / 优化标题描述 / 填分类属性 / 填重量尺寸 / 上架到 TK / 发布商品”时使用这个 skill。
核心定位
- 这是采集后的商品编辑 skill,负责把店小秘待编辑商品整理成 TikTok Shop 日本站可上架的待发布产品。
- 保存动作按本次授权决定:未明确授权时只允许保存草稿;用户明确要求“保存并移入待发布/转入待发布”时才使用
op=3;用户明确要求“发布/上架/提交发布”并完成最终复核后才允许op=2。 - 编辑前必须完成 1688 货源核验,除非用户明确要求跳过并接受保守估算。
- 店小秘编辑优先走接口化脚本流程;Chrome/浏览器插件只作为备用通道或 1688 核验辅助。
- 店小秘、1688 采购助手、1688 图搜/搜索/详情页都必须串行低频操作;触发验证或风控确认时保留当前页面等待恢复,不通过刷新、换关键词或重开多页硬冲。
- 不绕过平台人工确认、付费确认、资质确认、验证码、人机验证或发布确认;遇到这些状态按对应 reference 状态机停止等待。
必读资料
开始前读取:
references/editing-rules.md:标题、描述、品牌、图片、变种、物流、发布和回写规则。references/selection-rules.md:日本站编辑前合规红线。命中红线停止编辑。references/1688-sourcing.md:1688 货源核验、登录探针、人机验证、材质/采购价/重量尺寸采集和货源风险判断。references/draft-queue-and-browser-stability.md:店小秘采集箱队列来源、浏览器稳定策略和超时恢复。references/api-editor-workflow.md:接口化编辑、保存 DTO、op含义、保存后验证和数据库回写路线。接口化编辑时必须读取。references/section-state-machine.md:页面分区编辑模式。使用页面填表时必须读取。
按需读取:
references/sku-pricing.md:用户要求改价或定价时读取。references/store-prefixes.md:店铺标题前缀。references/category-map.md:常见分类和属性映射。references/attribute-fill-rules.md:常见必填属性填写口径。
工作边界
- 待编辑入口以店小秘
TikTok > 采集箱当前列表,或用户明确给出的店小秘编辑页链接为准。 - 不把
collection_records里的店小秘编辑状态=未编辑当作待编辑队列;采集表只用于辅助匹配和保存成功后的回写。 - 1688 采购插件只用于找同款和读取商品信息;不点击会产生采购、铺货、下单或加入选品池影响的按钮,除非用户明确要求。
- 不修改价格、库存、SKU 编码、运费模板、仓库、税务或结算字段,除非用户本次明确要求;改价必须先出 SKU 定价报告并获确认。
- 用户要求设置库存时,默认每个店小秘 SKU 填
100;只改库存字段和必要的商品级库存汇总字段。 - 不虚构商品材质、认证、功效、适用范围、套装数量、品牌或赠品。
- 1688 货源数据只作为内部编辑依据,不写进买家可见标题或描述里的价格、销量、供应商名或优惠。
页面稳定与验证处理
- 每次只处理一个店小秘商品和一个 1688 候选链路;不要同时打开多个 1688 搜索、图搜、详情或 SKU 价格页。
- 1688 优先从采购助手或当前图搜结果正常进入候选详情页;必须打开候选链接时,只开一个,等待页面稳定后读取字段。
- 1688 或店小秘出现登录、验证码、人机验证、滑块、安全验证、风险确认、空白确认或权限遮挡时,立即停止当前页面动作,保留页面,按
references/1688-sourcing.md或references/draft-queue-and-browser-stability.md的状态机等待恢复。 - 等待期间只做 URL、标题、少量页面标记检查;不要读取整页文本、连续刷新、重复上传图片、重复提交保存或把旧缓存当结果。
- 页面恢复后继续同一个商品、同一张图、同一个候选详情或同一编辑区块;等待超时才停止当前商品,未保存成功不得回写
店小秘编辑状态=已编辑。
默认流程
- 从店小秘编辑页或 TK 采集箱列表取得目标商品,确认商品 ID、店铺名、商品名称和目标账号。
- 建立编辑包:读取当前商品信息、图片、变种、来源信息和已填字段;用 1688 采购插件或 1688 页面核验同款货源。需要改价时,先生成 SKU 定价包。
- 按
selection-rules.md复核上架红线;命中禁售、暂不支持、跨境禁运、运营红线或货源风险时停止。 - 在编辑包里提前生成分类判断、必填属性候选、标题、描述、图片处理决策、变种映射、重量尺寸估算和数据库回写键;不要进入页面后一边想一边填。
- 默认按
api-editor-workflow.md接口化编辑;接口路线不可用或用户要求页面填表时,按section-state-machine.md分区执行。 - 基本信息:选择新版产品分类,等待属性刷新,品牌选择无品牌或页面对应无品牌选项。
- 产品属性:填写所有必填属性,优先按可信 1688 货源和商品真实信息填写;不确定时用安全中性值或停止确认。
- 产品信息:写入优化后的日语标题和描述。标题开头必须带店铺前缀,不写包邮、送料無料、官方、大牌、疗效、最强等高风险词。描述保留原有图片和 HTML 结构。
- 图片:检查主图是否清晰真实;首图差时才生成不虚构实物的白底/简洁主图,并按授权上传替换或追加。
- 变种/SKU:按店小秘已有变种和可信 1688 货源 SKU 对齐;不新建无依据变种,不修改 SKU 编码。
- 物流保修:优先使用可信 1688 包装信息里的重量/尺寸;缺完整尺寸时按实物形态加包装冗余保守估算,不低报。
- 保存与回写:按本次授权保存。保存成功并验证目标状态/字段后,按“采集表回写”更新同一条数据库记录;保存未成功不得标记
店小秘编辑状态=已编辑。
采集表回写
- 编辑技能只处理编辑字段:
店小秘编辑状态、编辑时间、编辑标题、编辑判断。采集字段由采集技能维护,编辑技能不得修改采集状态或选品判断。 - 编辑完成并保存验证成功后,回写同一条采集表记录:
店小秘编辑状态=已编辑、编辑时间、最终日语标题和成功判断。 - 编辑阶段判定不合格、跳过或停止时,回写同一条采集表记录:
店小秘编辑状态=编辑失败、编辑时间和第一个决定性原因;不写编辑标题。 - 回写使用采集 skill 的
firestore-sync.mjs mark-dxm-edited/mark-dxm-rejected。命中多条或找不到既有采集记录时停止,不新增采集记录。
必须停止
- 商品命中选品/合规红线。
- 页面要求平台人工确认、付费确认、资质证明、验证码、人机验证或发布确认。
- 1688 采购助手未登录,或 1688 图搜/搜索/详情/SKU 价格读取出现人机验证且等待超时。
- 找不到可信 1688 货源,或货源和店小秘商品在外观、规格、材质、套装数量上明显不一致。
- 必填属性无法根据商品真实信息判断。
- 用户要求改价但无法把店小秘 SKU 与可信 1688 SKU 一一对齐,或缺少采购价、重量尺寸。
- 商品图片不足以确认实物,且生成图片会导致实物不一致。
- 店铺名、目标账号或发布站点不明确。
- 保存接口失败、保存后验证不一致,或数据库回写无法唯一匹配既有采集记录。
输出要求
完成后简短汇报:
- 商品编辑状态:已保存草稿 / 已移入待发布 / 已提交上架 / 已停止。
- 分类、关键属性、标题前缀和最终标题。
- 1688 货源核验:选中的 1688 链接、供应商、采购价、材质、重量尺寸、风险备注。
- SKU 定价:是否生成/写入价格,关键参数和异常 SKU。
- 描述、图片、变种、重量尺寸是否调整。
- 采集表回写:是否已回写编辑状态、编辑时间、编辑标题和编辑判断。
- 未处理或需要用户确认的项目。
如果停止,说明第一个决定性原因,不列泛泛风险。