妙手ERP-AI产品润色

概述

妙手 ERP AI 产品润色

通过妙手 ERP AI 公共服务 API 生成润色后的商品文案和 SKU 销售规格。默认预览请求；仅当用户要求且本地会话凭证可用时才发起实际调用。

职责

• 发现当前支持的 AI 名称和目标语言代码。
• 根据商品上下文生成标题、描述或两者同时生成。
• 保留用户提供的商品信息、关键词、排除词、平台、站点、类目和图片上下文。
• 润色 TikTok SKU 属性名称和值，不丢失 ID 或图片关联。
• 返回每个生成的候选结果，并按结果类型标识部分失败。

非职责

• 不将生成的文本回写到采集箱或在线商品。
• 不发布商品。
• 不编造商品信息、品牌、认证、材质、尺寸、兼容性、安全声明或类目 ID。
• 不将此技能替代平台特定合规审核或商品上架校验。

标准工作流

1. 确定请求的输出类型：title、notes（描述）、sku-spec 或其组合。
2. 在选择具体字段、枚举或响应路径之前，先阅读 references/api.md。
3. 保留原始内容，仅收集缺失的必填上下文：平台、功能模块、AI 名称和语言代码。对于 SKU 规格润色，需要完整的 skuPropertyList。
4. 当请求的值缺失或不确定时，查询 ai-names 或 languages。不要猜测语言代码或不支持的模型。
5. 使用 scripts/miaoshou_ai_polish.py 构建预览。展示方法、路径和 payload；预览不暴露任何凭证。
6. 检查预览中是否存在不支持的字段和语义风险。如果生成内容依赖于用户未提供的商品信息，应标记而非视为已验证。
7. 仅当用户要求实际生成且凭证已在本地配置时，才添加 --execute。
8. 返回原始内容与生成候选的对比、请求的语言、AI 名称以及任何 API code、reason 或按类型的失败信息。

安全与数据规则

• 仅从 resources/config.json、显式选择的配置文件或环境变量加载会话数据。永远不要要求用户在聊天中粘贴 Cookie 或令牌。
• 永远不要打印 Cookie、timerToken、授权值或完整的请求头。
• 除非用户在授权测试环境中明确要求调试，否则不要发送 X-Apifox-Debug。
• 将生成的内容视为提案。此 API 不保存或发布，但后续写入仍需遵循相关编辑工作流和确认规则。
• 对于编辑模块，需要正确的商品标识符：标题/描述使用 functionModuleProductId，SKU 规格使用 productId。
• 对于 SKU 规格，保留 attrId、attrValueId、imgUrl 和 supplementarySkuImageUrls；除非用户明确要求，仅修改返回的名称/值。
• 根据所提供的 API 文档，SKU 规格端点目前仅支持 platform=tiktok 和 aiName=douBao1.6。

脚本用法

唯一 CLI 入口是 scripts/miaoshou_ai_polish.py。命令默认预览，仅在添加 --execute 时发送请求。

python scripts/miaoshou_ai_polish.py ai-names
python scripts/miaoshou_ai_polish.py languages
python scripts/miaoshou_ai_polish.py product-info --input request.json
python scripts/miaoshou_ai_polish.py sku-spec --input sku_request.json

使用 --payload '{...}' 传入紧凑内联 JSON，或使用 --input path.json 传入文件。共享选项放在命令之后：

python scripts/miaoshou_ai_polish.py product-info --input request.json --execute

运行 python scripts/miaoshou_ai_polish.py --help 及子命令帮助以查看完整选项。仅在本地机器上将 resources/config.json.example 复制为 resources/config.json；不要分发已填入凭证的文件。

参考

• 阅读 references/api.md 获取精确的端点、必填字段、枚举、响应结构和请求示例。