镜帆上架全能Skill
常见问题
从安装到生成草稿，找到你需要的说明。
产品与适用范围
镜帆上架全能Skill 是什么？
它是一套配合 Codex 使用的商品上架与定价工作流。从一个1688商品链接开始，自动采集商品数据、逐 SKU 定价、准备本土化场景图文，并在妙手 ERP 保存可检查的未发布商品草稿。
适合谁使用？
适合使用1688货源铺货至 Shopee、TikTok Shop 的跨境卖家、中小卖家及副业经营者。你负责确认经营目标、核对商品事实和最终草稿，再手动发布。
支持哪些平台和市场？
面向 Shopee 与 TikTok Shop 多市场。具体可用范围取决于当前版本、店铺资质、物流方式及妙手 ERP 的支持情况；不同市场需分别确认费率、税费、语言和上架要求，不能直接沿用另一个市场的结果。
只给一个1688链接就能开始吗？
可以从一个链接开始。首次使用时，Codex 会按任务需要确认平台、市场、店铺、利润目标、折扣与费用。你已保存的偏好可在适用范围内复用；未知商品信息、登录和必要授权仍需你补充。
需要准备哪些工具？套餐包含它们的费用吗？
先安装并登录 Codex，准备谷歌浏览器。完整上品流程还需要可用的 ImageGen、Computer use 或相应浏览器操作能力，以及已登录并连接目标店铺的妙手 ERP。
镜帆套餐不包含 Codex 订阅、Token 等用量费用，也不包含妙手 ERP 或其他第三方服务费用。具体能力取决于账户、设备及客户端；只做定价不强制使用生图和 ERP。
只做定价，也需要登录妙手或准备模特吗？
不需要。只做定价时，确认目标平台、市场、利润或售价目标，以及必要成本即可。生成图片时再按需配置 Logo、模特等素材；编辑草稿时才需要目标店铺和 ERP 操作条件。
安装与首次使用
有哪些安装方式？
方式一：在下载区选择适配电脑的 ZIP，下载后拖入 Codex，或提供文件在本机的路径，再发送“手动安装 Prompt”。Codex 会依据官方说明核对安装包，并按包内说明安装。
方式二：在“直接在 Codex 安装”页签复制 Prompt，发给已登录的 Codex。它会读取官方安装说明，按当时的 stable 推荐版本选择适配安装包，完成下载、核验与安装检查。两种方式都不需要你自己编写安装命令。
下载安装包后，需要先解压吗？
可以直接把下载好的 ZIP 交给 Codex，并发送手动安装 Prompt。让 Codex 先核验，再解压到新的目录并按包内 INSTALL.md 安装。不要把文件直接覆盖到已有 Skill 或程序目录；无法拖入 ZIP 时，提供文件的本机路径即可。
显示安装成功，就可以开始完整上品了吗？
安装成功只表示程序注册和离线诊断完成。请新建一个 Codex 聊天，确认能发现“镜帆上架全能Skill”；内部标识为 genfan-listing-commercial。
首次正式采集商品数据前，还需领取试用或开通套餐，并在本机录入自己的客户密钥。生图和妙手操作分别依赖相应能力与登录状态，不能用安装成功代替完整流程的可用性确认。
下载的是完整包，使用时还要联网吗？
需要。完整包自带必要运行环境，减少额外安装依赖的步骤；商品数据采集、AI 生图、Codex 使用和妙手网页操作仍需联网。已有完整资料的本地测算能否离线完成，取决于具体任务。
安装时需要客户密钥吗？密钥在哪里输入？
安装和离线诊断不需要客户密钥。首次正式采集商品数据时，再按 Codex 引导，在本机交互终端隐藏输入自己的 Genfan 密钥，保存到系统凭据能力后复用。
不要把密钥放进聊天、命令参数、网页表单或日志。换电脑时在新设备重新录入，不复制旧设备的加密凭据。
为什么首次使用还会询问费用、店铺或素材？
不同市场、店铺和物流方案的费用与要求不同。Codex 会按当前任务收集必要信息，明确保存的配置可继续复用。你可随时要求修改或停用；Logo、御用模特和图文偏好需先手动配置。
系统、芯片和版本有什么要求？
需要另装 Python、Node，或申请管理员权限吗？
安装包已包含 Python、Node 和 Pillow，无需单独安装这些运行环境。请先自行安装并登录 Codex，准备 Chrome。安装会按需请求当前用户的文件访问授权，不要求管理员权限或永久完全访问。
Windows 按官方指引在普通 PowerShell 终端取得当前用户 SID，由 Codex 核对安装身份；SID 不是客户密钥。若系统策略或签名阻止执行，不要自行关闭防护或修改执行策略，请保留错误并联系支持。
下载、安装失败，或新聊天找不到 Skill 怎么办？
先记录错误提示和安装输出的 evidence 目录。下载中断或完整性校验失败时，不执行安装包代码；按官方说明重新开始，让安装流程建立新的临时目录并重新核验。
若存在旧版本、注册冲突或未完成事务，按包内 INSTALL.md 的恢复流程处理，不强行覆盖。安装完成后新建 Codex 聊天确认能发现 Skill；仍未发现时，将不含密钥的错误信息交给企业微信支持，不能只凭安装输出认定全部就绪。
价格、费用与商品数据
定价会核算哪些成本？
逐 SKU 核算采购成本、国内运费、货代成本、跨境运费、适用的平台费率、进口税费及已确认的其他经营成本。可采用 Skill 初始成本或自定义实际成本，并确认费用覆盖范围，避免重复计算。未知项会提示补充，不默认记为零。
如何根据利润和折扣倒算价格？
提供目标利润与计划折扣，或明确给定售价，Codex 会按目标市场规则测算折后售价与上架原价，并核对舍入及平台展示口径。具体可选的利润目标，以相应市场模板支持的输入为准。
“利润率20%”和“加价20%”一样吗？
不一样，两者计算的分母不同；“减价20%”与“打两折”也不同。描述不明确时，Codex 会先与你确认计算口径，再测算售价。
平台费率、税率和汇率都是实时的吗？
不承诺每次都取得实时官方数据。优先使用最近已核验、适用于该任务的数据，并列明来源与日期；缺项、需要复核或你要求更新时再核验。参考汇率也不等于店铺最终结算汇率。
缺少重量、税基或某项费用怎么办？
Codex 会说明缺少什么、对结果有什么影响。经确认且有依据的暂估值会标明，未计入的可选费用也会说明。必要条件缺失时，不编造数值，也不把对应 SKU 标为已完成。
定价结果能保证实际利润吗？
不能保证。测算依据当时的商品资料、费用、汇率和经营假设；实际运费、结算、退货、投放等成本变化都可能影响利润。请检查计算依据，条件变化后再重新测算。
不同 SKU、组合销售和库存怎样处理？
各 SKU 分别计算。组合销售时，采购成本、重量、标题、图片与库存使用同一组合数量；可售组数按来源库存除以每组数量向下取整。组合采购成本只是成本，不是最终平台售价。
图文、品牌与草稿
保真生图会改变商品本身吗？
工作流以真实商品源图为依据，要求保留外观、规格、包含物与商品属性，并核对图片和 SKU 的对应关系。场景可以本土化，商品事实不能虚构。AI 生成结果仍需逐图检查，不保证每次生成都天然准确。
可以使用店铺 Logo、品牌标识和御用模特吗？
可以，需先手动配置。按店铺保存 Logo、模特参考与图文偏好后，可在后续任务中复用，也可更换或停用。固定模特需要清晰且身份一致的参考图；店铺标识不能用来冒充商品原有制造品牌。
会直接发布到店铺吗？
不会。流程自动准备并保存未发布的商品草稿，重新打开核对后交给你检查；确认商品、图文和价格后，由你手动发布。也不会自动创建采购订单或付款。
“学习爆品表达”会照抄其他商品吗？
参考优秀商品的标题结构、卖点组织与表达方式，再依据当前商品的真实资料生成内容。不复制不适用的材质、认证、销量或功效，也不把参考商品图片作为当前商品的事实依据。参考资料获取范围以实际版本为准。
按平台标准整理，一定能通过审核吗？
不能保证。工作流按已知的平台字段、图片、规格和语言要求整理并校验。最终能否发布和售卖，还取决于平台当前规则、商品类目、店铺资质、物流以及商品本身。
草稿保存在哪里？多个市场会怎样处理？
保存到你确认的妙手目标平台、店铺和对应商品中。TikTok 多国家售卖信息加载后需逐项核对；各市场的价格和利润应分别验证，一个市场算对不代表所有市场都适用。
如何继续旧草稿？遇到登录或页面阻塞怎么办？
可以在身份和目标一致的未发布草稿上继续，并重新核算变化的条件。遇到登录、验证码、权限或必填信息阻塞时，需要你完成对应操作。已完成资料会保留，并明确哪些步骤尚未完成。
试用、套餐与用量
免费下载安装后，怎样开始试用？
下载与安装免费。添加官网企业微信领取免费额度，人工开通后获得自己的客户密钥，再按 Codex 引导在本机隐藏录入。试用开通后 7 天有效，适合先体验少量商品，建议从一款商品开始；实际可准备量受商品复杂度和使用方式影响。
套餐价格和有效期是什么？
内测促销期间，轻量套餐 49 元，预计可自动准备约 50-150 件商品草稿；常用套餐 99 元，预计约 166-500 件。两档业务功能一致，均从实际开通起算 30 天。
当期加量 29 元，预计增加约 33-100 件商品的同类准备量，沿用当前付费到期时间。以上为估算，不是保证交付的成稿数量。
套餐预计能处理多少件商品？
按每件商品查询 1-5 个 SKU、常规资料准备量估算：轻量套餐约 50-150 件商品草稿，常用套餐约 166-500 件，当期加量约增加 33-100 件的同类准备量。
规格少、资料完整、已有设置可复用时，通常能准备更多商品；规格多、需补充资料或反复处理时，数量会减少。
区间仅用于选择铺货规模，不是固定成稿名额，实际可能低于估算下限。Codex 与妙手 ERP 的可用性，以及图文和草稿修改量，也会影响最终完成数量。
为什么同一套餐能准备的商品数量不固定？
每款商品的规格数量、资料完整度、物流方案和重复处理需求不同，准备工作量也不同。套餐并非每生成一份草稿就固定扣一个名额，页面展示的是预估准备规模，实际数量以使用情况为准。
修改价格或重新生图，会影响可准备的商品数量吗？
使用已有完整资料进行本地重算或编辑，本身不额外消耗镜帆额度。补充或重新采集商品资料会使用额度，可能减少后续可准备量。重新生图与 Codex 操作仍可能产生第三方服务费用。
商品资料获取失败或任务中断怎么办？
服务端确认失败的资料处理不消耗镜帆额度。如果服务端已处理成功，但本机超时或未收到结果，仍可能使用额度。请保留任务标识，通过企业微信核对后再继续，避免反复重复处理。
到期没用完怎么办？额度用完会自动续费吗？
到期剩余额度不结转，不自动扣款或续费。额度提前用完时，可联系办理当期加量、同一期升级，或明确选择立即开启新一期；首版不办理预付下一期。
加量和升级有什么区别？
加量适合临时增加铺货量，预计多准备约 33-100 件商品草稿，不延长有效期。升级将本期调整为常用套餐规模，保留原到期时间与已有使用进度。
按当前价格，轻量升常用补 50 元；同一期已购买一个 29 元加量包时补 21 元。升级后可准备量需扣除本期已使用部分，不会额外赠送一整份常用套餐。
怎样购买、开通和查询余量？
通过官网企业微信联系人工核实付款、开通或查询。受理时间为每天北京时间 10:00-22:00，必要资料和到账信息齐备后，累计 4 个服务小时内办结。
上述时效适用于试用、开通、加量和升级，不是所有技术故障的修复承诺。当前没有客户自助余额看板；收到额度不足提示后，可打开提示中的官网套餐链接，再联系企业微信办理。
Skill 提示额度不足时，去哪里购买或加量？
打开提示中的官网套餐链接，比较轻量、常用和当期加量方案，再点击“联系购买”前往企业微信二维码。由人工确认开通、加量或升级，不会自动扣款。
套餐区地址固定保留，已写入 Skill 的入口继续可用。开通后按引导继续原任务，避免反复重复采集商品资料。
维护、数据与售后
如何更新、回退或卸载？
更新需你明确提出，stable 推荐版本变化不会让已安装版本在后台自动升级。请让 Codex 读取官方安装说明并执行更新；普通安装遇到已有其他版本时会停止，不直接覆盖。
回退需先核对本机保留的旧版本，再按包内说明操作。卸载与资料清理也以包内说明为准。操作前备份需要保留的配置、素材与任务文件；不要手动覆盖程序目录或重新录入密钥来替代恢复检查。
商品、图片和店铺信息会发送到哪里？
客户配置与任务文件按产品目录保存在本机。商品采集需要访问数据服务；生图、Codex 执行和草稿编辑可能向相关服务传递完成任务所需的资料。整个流程并非完全离线，请勿在公开示例或录屏中展示密钥、店铺登录凭证。
可以退款吗？
如需退款或遇到无法使用的情况，请通过企业微信联系核对。购买前确认当时公示的退款适用条件、申请方式、处理时效与结算规则。
支持哪些付款方式？可以开票吗？
收款方式、发票类型、开票范围与时效，以购买前镜帆提供的企业渠道说明为准。官网企业微信二维码用于联系咨询，不是付款码。
可以在多台设备或团队中使用吗？
换电脑后需在新设备本地重新输入自己的密钥。可同时使用的设备数、并发限制与团队授权，请在购买前确认；能重新录入不等于可以无限设备或多人共享。当前安装路径面向 Codex，其他 Agent 以实际发布范围为准。
任务规模与完成时间
可以一次批量处理很多商品或发布到所有店铺吗？
当前流程以一个1688商品链接和明确的目标平台、店铺为任务单位。不要把铺货自动化理解为任意并发、全店批量发布或无需复核；批量能力以实际版本说明为准，最终发布仍由你操作。
完成一件商品需要多久？
取决于 SKU 数量、图片制作与修改量、网络、Codex 用量限制、资料完整度及 ERP 页面状态。当前不承诺固定分钟数；人工开通套餐的服务时效也不代表商品处理时长。