MoonClaw 批量上新协作工作台产品说明与操作手册
理解它为谁服务,怎样与现有产品协作,以及如何完成一次可核对的上新任务。
阅读说明与个人研究声明
这份手册说明一套围绕跨境商品上新的协作工作台:它服务哪些人,如何与官网、选品商城及 MoonClaw 智能体配合,以及如何操作当前的交互展示。其核心构想,是让对话式任务与可视化核对进入同一条业务流程。
个人研究声明
本手册及配套工作台,是本人基于公开资料、有限的个人试用体验和对跨境电商业务的理解制作的独立概念作品,意在交流产品思路与业务流程设计,不代表西之月或 MoonClaw 的官方立场、产品规划或交付承诺。
本人未参与公司内部研发与经营,无法完整了解既有系统、用户需求和实际业务约束,相关认识与推断可能存在偏差,方案也仍有较多不完善之处。本文不以个人体验推定原有产品缺少某项能力,也无意质疑或否定原有项目与团队工作。如有理解不周或表述未尽妥帖之处,敬请谅解并指正。
文中“不足”“尚未实现”等表述,除明确注明出处外,均指本次独立工作台展示。所有示例商品、商家、店铺、回执和积分均为演示数据;界面标志为独立概念绘制,不应被视为官方发布标识。
阅读时区分三种信息
公开信息 指公开页面披露的业务范围,不等于已逐项验证登录后功能。当前演示 指配套 v0.2.1 工作台可以实际操作的前端行为。协作设想 指需要与产品方、真实用户和研发团队确认的未来接入方式。本文不会把三者混写成已经上线的能力。
产品负责人可先阅读第 1 至 4 章及第 11 至 13 章;首次体验者可先读第 5 至 9 章;研发与交付人员可重点查看第 3、10、11、12 章。页面目录支持跳转,上方搜索可定位正文,字号按钮可调整阅读大小。整套发布文件下载后可在本地浏览器打开;外部参考链接需要网络。单独另存本页时,请同时保留样式与脚本文件。
手册版本 v1.0 · 对应工作台独立概念版 v0.2.1 · 整理日期 2026 年 10 月 24 日。通过顶部“体验产品”进入配套工作台;本手册不内置或自动修改该工作台的数据。
1 产品背景与定位
公开信息 西之月业务官网介绍了选品、生产供应、定制及代发等服务,服务对象涉及跨境卖家与供应商。MoonClaw 官网则介绍了选品、商品素材、批量刊登、多店铺经营及履约,并提及用户确认后的执行与结果跟踪。[1][2] 这些信息支持研究商品上新场景,但不足以判断其内部系统架构、具体接口或各能力完成度。
协作设想 本工作台更适合被理解为 MoonClaw 业务方向上的“批量上新与审核协作模块”。它把商品事实、内容草稿、人工判断、渠道执行和失败恢复集中展示,探索运营如何从一条任务持续做到结果可核对。它并不以另建一套商品库、智能体平台或计费系统为目标。
它试图回答的业务问题
一个运营人员准备把一批商品发布到多个店铺时,需要知道:内容依据哪份商品资料,哪些字段还没有确认,负责人批准的是哪一版,哪些店铺已经成功,哪些仍需处理。这些问题贯穿资料准备到执行回执,而不仅是“能否生成一段文案”。本方案以一个具体任务把它们组织起来,方便讨论交接责任和异常处理。
与智能体相同的地方和不同的观察角度
商品生成、刊登和任务跟踪与 MoonClaw 的公开方向有明显重合。因此,这份展示的价值应放在流程是否清楚、状态是否一致、操作是否便于核对上,而不能简单宣称增加了一种原产品没有的业务。智能体也可以拥有表格、审批与任务管理;工作台也可以调用智能体,两者不是互斥的产品类型。
对话适合表达目标,例如“帮我准备这批商品的上新内容”;表单和列表适合精确选择范围、核对大量字段和处理一批结果。建议两种入口共用一个任务,而不是分别复制一份任务。若现有产品已经覆盖这些交互,优先复用或微调即可,是否新增模块仍应通过实际使用验证。
目前可确认的是一份能够操作的前端概念展示,而不是已接入 MoonClaw 的官方插件,也不是可直接承担真实经营工作的生产系统。
2 目标客户与典型使用场景
协作设想 首批适合验证的对象,是持续上新、拥有可核实商品资料和明确店铺授权的跨境卖家及运营团队。“入驻商家”可能包含卖家、工厂、品牌和服务商,不能仅凭入驻身份假设他们需要同一套页面。客户分组与优先级仍需访谈确认。
| 客户或参与者 | 典型用法 | 预期价值与边界 |
|---|---|---|
| 单人或小型跨境卖家 | 集中准备几款商品,查看待处理内容,确认后发布并跟进失败项。 | 减少来回找资料和遗漏任务。单人业务是否需要独立审核人,应按风险与现行规则决定。 |
| 多店铺运营团队 | 运营准备资料,负责人审核,管理员处理连接,团队按任务交接。 | 减少版本混用和交接遗漏。应先验证现有流程是否已经满足需求。 |
| 代运营服务团队 | 在得到客户授权后,按客户空间分别处理商品、店铺和任务。 | 便于分清客户范围。当前空间切换仅为演示,尚不具备真实代理授权和跨客户管理能力。 |
| 工厂或品牌供应商 | 提供规格、素材和资料更新,协助解释商品事实。 | 更可能是资料协作方;不应默认给予卖家的店铺发布权限。 |
| 平台内部运营与客户支持 | 在获得明确授权后,协助定位失败原因、维护规则、支持试点。 | 需要独立的内部支持权限与审计。本展示没有内部员工管理后台。 |
一个小团队如何使用
假设一家生活用品卖家的运营人员准备把两款商品送到两个店铺。运营先检查资料,再创建任务并修订草稿;负责人集中核对事实和目标范围,批准当前版本;运营执行后,只继续处理失败项。管理员不必逐条编辑内容,而是在授权过期或预算不足时处理相关设置。这种分工是为了说明协作关系,不代表西之月或某家商家的实际组织设置。
哪些情形暂不适合直接照搬
没有可靠商品资料、尚未获得店铺授权、需要复杂多国家合规判定,或希望无人确认便完成全自动经营的场景,不宜直接套用本演示。大型商家若已有成熟刊登系统,也应先比较现有流程与用户痛点,避免额外增加一套操作负担。
3 官网 商城 智能体与工作台如何协作
协作设想 官网负责介绍产品和引导进入,选品商城负责发现与选择商品,智能体帮助用户表达目标并调用能力,工作台帮助用户核对范围、审核内容和查看结果。真正需要统一的是后台任务、资料来源、账号权限与计量,而不只是页面颜色或导航入口。
从官网进入
可以在现有产品官网设置“进入工作台”入口,进入已有登录体系后打开相应模块。官网增加一个按钮,只解决“从哪里进入”;账号识别、数据读取、任务执行仍需要后台接口。官网当前也提供客户端下载入口,工作台是否放在网页端、客户端或已有控制台,应根据产品方的技术结构和用户习惯决定。[1]
从商城进入
商家在商城选择商品后,可以通过“AI 上新”等入口发起业务。建议传递商品编号和任务意图,由后台校验商家身份、可用商品及店铺范围,再建立任务;不要把跳转链接里的价格、权限或商品内容直接当作可信事实。具体按钮名称在这里是设计示意,当前展示并未连接真实商城。
从智能体进入
用户可以提出“把这两款商品准备到两个店铺”的请求,智能体据此提出任务范围,由用户确认后建立同一条任务,并提供“打开工作台核对”的入口。用户在工作台修改后,对话应读取更新后的状态;执行也应走同一套授权和审批检查。本展示尚未实现真实对话入口、智能体编排或跨入口同步。
优先复用什么
应先盘点现有商品、账户、店铺授权、任务、审核、能力市场、积分和日志服务。独立展示为便于体验而提供的多个管理页面,并不意味着正式产品需要再造一套后台。页面可以作为现有前端模块,也可以独立部署并共用后台;是否拆分应用、数据库或服务,应由实际隔离与运维要求决定。
4 用户收益与验证方法
预期价值 用户收益应来自更少的反复核对、更清楚的责任交接和更容易恢复的异常,而不是页面数量或一次生成的速度。以下均是待验证的收益假设,本作品没有真实客户使用数据,也没有证明收入、转化率或效率提升的具体幅度。
| 希望改善的工作 | 产品怎样支持 | 试点如何观察 |
|---|---|---|
| 重复搬运商品资料 | 任务引用统一资料源,核对具体版本。 | 记录从资料准备到可送审的人工操作时间,区分首次录入和重复使用。 |
| 审核与交接遗漏 | 把负责人、草稿版本和待办状态放在同一任务中。 | 观察待审核积压、退回原因、误用旧版本次数,不能只看点击次数。 |
| 发布失败后重新做整批 | 分开显示各商品和店铺的结果,保留已成功项。 | 记录失败恢复耗时、重复提交和结果不明数量;按异常类型区分。 |
| 成本与产出难以对应 | 把执行记录和用量关联到任务。 | 观察每个验收合格结果对应的模型、媒体、接口及人工成本。 |
| 负责人不了解整体进展 | 工作台汇总待办、结果与当前用量。 | 访谈负责人能否找到下一步责任人,以及是否减少额外追问。 |
比较试点前后时,应选择商品数量、资料完整度、渠道与任务复杂度相近的样本,同时记录质量。自动生成更快但人工改写更多,或者发布成功却存在关键事实错误,都不能简单算作收益。对西之月而言,减少支持成本、提高卖家持续使用意愿等也只能作为业务假设,需结合实际经营数据验证。
6 业务流程与关键规则
一条任务从商品资料开始,经过内容准备、人工审核和执行检查,最终形成可以核对的结果。资料、内容和审批分别有自己的意义:“资料齐全”只表示通过当前有限字段检查;“审核通过”表示某个演示角色批准了一个明确版本;“全部完成”表示所有子任务返回模拟成功。
当前每个“商品 × 店铺”构成一个执行项。两件商品、两个店铺就是四项,并不是按照商品的每个规格分别创建执行项。本版每件商品只有一份草稿,多个目标店铺共用;面向不同国家的平台类目、属性、语言、售价与素材映射仍未实现。
审批绑定当前内容与商品资料版本。执行前发生变化时,需要重新生成或重新送审;部分发布后再改变商品资料,则应保留历史结果,取消剩余工作并重新安排。该规则用于避免把已审核内容和实际执行内容混在一起。
7 完整体验一次双商品双店铺任务
操作说明 用浏览器打开配套工作台 HTML 文件,不需要账号密码、API 密钥或真实店铺授权。首次默认进入“南风出海工作室”,角色为“商家运营”。该空间初始有 6 件商品、4 项任务、3 家示例店铺;其中两家连接可用,一家马来西亚店授权过期。初始预算为 200 模拟积分,已使用 4,剩余 196。若之前已操作过,数量和余额会不同。
步骤 1 选中两件商品
进入左侧“商品中心”,勾选“折叠式头戴耳机”和“桌面分类收纳袋”。两者在初始样本中没有既有任务,便于观察新流程。看到“已选择 2 件商品”后,点击“创建刊登任务”。也可以从侧栏“新建 AI 任务”进入,再在弹窗中选择商品。
步骤 2 选择目标店铺
弹窗依次为“选择商品”“选择店铺”“确认任务”。核对第一步并点击“下一步”,勾选“Nanfeng Living · 越南”和“Nanfeng Select · 泰国”,再点“下一步”。初次体验不选授权过期的马来西亚店。此时范围应为 2 件商品、2 家店铺,共 4 个子任务。
步骤 3 确认任务范围
填写易于识别的名称,例如“手册体验 两商品双店铺上新”,核对使用能力为“商品刊登助手”,查看全部成功预计 8 模拟积分。点击“创建任务”进入详情。此时只建立任务,并未生成内容或提交渠道。
步骤 4 生成并核对草稿
点击“生成内容草稿”,查看每件商品的“商品标题”“商品描述”、事实来源和引用版本。当前内容由本地模板拼接,含中文事实和英文模板标签,并不是真正的越南语或泰语翻译。若修改文案,点击“保存草稿”,或在未保存提示中点击“保存修改”;不修改则无需额外保存。
步骤 5 提交人工审核
确认资料和内容后,点击“提交人工审核”。任务变为“待审核”,此时尚未批准,也不会自动发布。若存在资料缺失或未保存修改,先按提示处理,不能用草稿中写入一个材质词来替代补齐商品资料源。
步骤 6 切换审核视角并批准
将右上角“角色体验”切换为“审核负责人”。可留在当前任务,也可进入“审核中心”,找到任务并点击“查看内容并审核”。检查商品事实、文案、来源版本和目标店铺,点击“批准版本 v1”,然后在确认框点击“确认”。版本号以页面当前值为准。如果需要修改,可点“退回修改”,填写“处理原因”并确认。处理原因最多 1000 字符;超长时会提示,原文保留以便删短。
步骤 7 执行模拟发布
切回“商家运营”,点击“提交渠道发布”,核对确认框中的范围和积分说明,再点击“确认”。按预设演示规则,两个 Shopee 子任务成功,两个 TikTok 子任务出现“429 · 模拟限流,明确未受理,可重试”。任务进入“部分成功”,本次新任务已记 4 模拟积分。此异常是为了体验恢复流程而设置,不能用来说明真实平台或原产品存在故障。
步骤 8 只重试失败项
点击“重试失败项”,核对范围后确认。本版会让两条失败项恢复成功,任务成为“全部完成”。在“渠道执行与回执”中查看请求次数、回执和状态,确认先前成功项没有再次执行。
| 商品与店铺 | 最终状态 | 请求次数 | 本项积分 |
|---|---|---|---|
| 耳机 · 越南店 | 成功 | 1 | 2 |
| 耳机 · 泰国店 | 成功 | 2 | 2 |
| 收纳袋 · 越南店 | 成功 | 1 | 2 |
| 收纳袋 · 泰国店 | 成功 | 2 | 2 |
本任务合计 8 模拟积分。如果从未改动的初始样本开始,空间总用量会从 4 增至 12;空间总用量不等于本次任务费用。模拟积分仅用来解释计量行为,不对应官方价格或真实扣款。
步骤 9 核对并导出记录
在任务详情查看“审批快照”“操作记录”和成功回执,在“用量与积分”核对流水。完成后的任务可点击“导出任务记录”,得到 JSON 格式记录。该文件用于留存与核对,本版没有导入 JSON 恢复进度的入口。
8 商品录入 CSV 导入与日常查看
手动新增一件商品
进入“商品中心”,点击“添加商品”,填写商品名称、主 SKU、分类、材质、资料来源、参考价格、库存和事实说明,选择一张内置示例配图,再点击“保存商品”。名称与主 SKU 必填;同一空间内在用商品的主 SKU 不可重复。价格须为非负数字,库存须为非负整数。未知材质可以先留空,之后在送审前补齐,不应为了通过校验而编写真实商品事实。
SKU 是区分商品或规格的编号。本版可展示多规格样例,但规格清单只读,多规格总库存由规格汇总;并不支持完整的规格增删改。配图只用于概念展示,不支持上传真实商品图片,也没有素材版权与使用授权管理。
使用模板批量导入
点击“下载导入模板”,在 Excel 或其他表格工具中按模板填写,再保存为 UTF-8 编码的 CSV 文件。回到工作台点“导入 CSV”,在弹窗中“选择 CSV 文件”,查看各行校验结果,全部通过后点击“确认导入 N 件商品”。当前不接受直接上传 .xlsx 文件;单次最多 50 条商品记录,文件不超过 1 MB。
| 字段 | 中文含义 | 填写要求 |
|---|---|---|
name | 商品名称 | 必需列,名称非空。 |
sku | 商品主 SKU | 必需列,同空间不重复。 |
price | 参考价格 | 必需列,非负数字;本版为 CNY 示例参考价。 |
stock | 库存 | 必需列,非负整数。 |
category | 分类 | 可选列,可保留自定义分类;编辑商品时不会自动改回默认分类。 |
material | 材质 | 可选列;未知可导入,送审前仍需补齐。 |
description | 事实说明 | 可选列,只写有依据的规格、特点与用途。 |
source | 资料来源 | 可选列,建议保留可核对的来源名称。 |
任何一行校验失败,整批不会写入。修正后重新选择文件,再核对预览。模板示例 SKU 已导入过时,再次原样导入会被视为重复,可修改为新的编号或使用空白的“探索工作空间”。导入用于创建商品,不是通过 ID 更新已有商品;不要额外加入 id、version 等控制列。
搜索 待办与空白空间
顶部“全局搜索商品和任务”可按当前空间的商品名称、主 SKU、商品编号及任务名称或编号定位,Mac 可用 Command K,Windows 可用 Ctrl K。铃铛入口汇总待审核、待补资料、部分成功与待发布任务。左上切到“探索工作空间”后,初始没有商品和任务,但有一家可用的越南示例店铺,适合从零练习。
9 常见异常与处理方法
资料缺失导致无法送审
可打开初始任务“旅行分装瓶 · 商品资料准备”,点击“补充资料”,依据可靠来源填写材质并“保存商品”;回到任务后,使用“重新生成并校验”或“使用最新资料重新生成”,以当前页面提示为准,再检查和送审。练习时可使用明确标注“虚构练习”的资料,但不能把练习材质当成该商品的真实规格。重新生成会覆盖当前草稿并清除旧审批,应先留存需要的内容。
审批通过后修改了内容或资料
任务尚未执行时,保存草稿修改会增加内容版本,并让原审批失效,需要重新“提交人工审核”。修改商品资料后,旧草稿引用的版本不再有效,需要重新生成并审核。此规则保护的是“批准内容与执行内容一致”,不是增加无意义的审核步骤。
部分成功后商品资料又变化了
已有回执时不覆盖历史草稿。点击“取消剩余工作”保留已成功结果,再基于新资料创建任务。新任务应仅包含仍需处理的范围;若失败组合不规则,可分成多个任务,以免重新组合后包含已成功项。当前没有跨任务的全局重复刊登识别,不能假设重新创建任务也会自动去重。
店铺授权过期
切换“空间管理员”,打开“渠道连接”,在对应店铺点击“恢复模拟连接”并确认,再切回运营继续。该操作只改变演示状态,不会打开真实平台授权。本版首次执行前检查全部目标连接,若其中一家不可用,不会先执行其他可用店铺;是否允许真实业务分批执行,需要另行设计。
模拟预算不足
切换管理员,在“空间设置”调整“模拟积分预算”,点击“保存空间设置”,再回到任务。预算不能低于已使用积分。执行前按本次待执行项全部成功的最大需求检查,重试只检查失败项所需额度。调整预算不是实际充值;模型调用失败是否产生实际成本,也不能用本演示的“失败不计积分”规则推断。
草稿有未保存修改或按钮不可用
任务详情中的草稿修改会暂存在当前浏览器;刷新后可恢复。在有未保存修改时,关键任务动作以及当前任务页内的角色、空间切换会被拦截。先点击“保存修改”或“还原已保存版本”,再继续。如果按钮仍不可用,检查角色、任务状态、资料版本和店铺连接。商品编辑或创建任务的弹窗只有关闭确认,不应认为所有表单都支持刷新恢复。
取消后仍然看得到成功结果
“取消剩余工作”只停止未完成部分,不撤销已成功刊登,不下架商品,也不退还已记模拟积分。真实下架、退款或补偿应另有授权流程,本展示尚未实现。
模拟失败可以重试 真实结果不明应先核对
本演示的 TikTok 限流被明确设定为未受理,重试会成功。真实环境可能出现请求超时但平台已经受理的情况,此时需先查询回执、识别同一业务请求并核对结果,再决定是否重试。本展示没有验证这种跨系统不确定性,也没有覆盖所有平台错误码。
导出 重置与本地保存
“空间设置”中的“导出当前空间记录”可留存 JSON;管理员点击“重置当前空间样本”并确认后,会恢复该空间初始数据,其他空间不受影响。导出的记录不能一键导回。本版仅在当前浏览器保存,不跨电脑同步;清除浏览器数据、无痕模式或本地存储限制都可能影响保存。请使用示例资料,不录入真实密钥和敏感客户数据。关闭页面后没有后台任务继续运行。
10 从展示走向真实接入
实施设想 上线需要先确认是否值得新增交互,再决定怎样接入。前端入口可以统一,后端仍需明确数据归属与操作权限;外部商家页面和内部员工支持后台也不应因为共用组件就共用全部权限。下面是讨论顺序,不代表已获授权的开发计划。
第一步 盘点现有能力与责任人
与产品、运营和研发确认现有的商品主数据、任务、审批、渠道授权、计量和日志能力,说明各模块的负责团队与可复用接口。若现有 MoonClaw 已经满足目标场景,优先改善入口或操作细节,不另建业务系统。选择首个试点渠道时,以真实客户任务和已有授权接口为依据,而不是照搬演示中的平台名称。
第二步 接上账户与商家空间
优先复用现有登录,明确用户所属企业、可访问店铺、可执行动作及代理授权。单点登录是让多个入口识别同一身份,并不自动赋予其全部业务权限。后台应逐次校验任务所属商家和动作范围,不能信任网页下拉框传来的角色;跨商家的内部支持访问也应单独授权并留下记录。
第三步 接上可靠商品资料
先确定哪一个现有系统对商品、规格、价格、库存和素材负责。工作台按授权读取资料,任务记录来源编号、版本和必要快照;不将浏览器里的参考价直接变成渠道售价。不同平台的类目、属性、规格、语言、货币、运费与素材要求需要明确映射,发布前还应检查实时变化和必要的业务限制。
第四步 复用智能体与执行服务
前端负责提交意图与展示状态,服务端负责模型调用、队列、审批校验和渠道请求。智能体只能使用本次获授权的数据与工具范围,不应直接绕过后台写数据库或持有不受限的平台权限。真实生成需要结构化结果校验、事实核对和评测;长任务需要持久化状态与恢复机制,浏览器关闭不应决定后台任务是否丢失。
第五步 统一回执 审计与计量
建议让对话与工作台引用同一任务编号,保存商品范围、资料版本、草稿版本、审批人、执行子项、平台请求和回执关系。重复点击、重复回调或服务重启不能造成重复业务动作;结果不明时先对账再重试。模型用量、媒体成本、渠道执行与用户账单应分别定义,并与现有计费体系统一,不能直接把演示积分当作真实成本模型。
第六步 分阶段验证并决定是否扩大
先在测试环境接一个可靠资料源和一个获授权渠道,再进行人工对照验证;确认事实质量与权限行为后,才在明确授权下小范围使用。记录失败原因、用户操作负担和实际成本,明确暂停执行、回退旧入口及人工接管方式。前端界面能运行,不等于真实渠道、并发或数据安全已经验收。
11 本工作台当前的不足
以下是对本独立展示的自我审视,不是对西之月或 MoonClaw 原产品的能力评价。它们会影响作品能证明什么,也决定了真正落地前应补齐什么。
需求证据仍然有限
目前没有完成真实商家访谈、跟岗观察和现有操作耗时统计。目标人群、使用频率、审核分工以及商家愿意为哪些结果付费,仍是待验证问题。展示的完整性不能替代需求真实性。
与原产品的重复程度尚未核清
公开介绍与本方案已有明显重合,但尚未完整核对现有账号下的全部流程和内部服务。商品中心、审核、任务、计量等可能已有成熟实现。正式讨论应先找复用点,再判断是否需要增加页面;不应因为做了独立演示,就预设必须另建 SaaS。
生成与渠道适配尚不完整
目前是本地模板,没有真实模型、翻译、商品图或视频生成。每个商品只有一份草稿供多个店铺共用,没有独立的目标市场内容、平台类目和属性映射。商品价格只是 CNY 示例参考价,没有汇率、佣金、运费计算;库存没有实时同步、锁定或扣减。多规格清单只读,配图来自内置素材。
质检与审核规则较为基础
“资料齐全”主要反映名称、材质等有限字段检查,不能覆盖认证、禁限售、知识产权或不同平台的要求。人工审批流程可以演示版本关系,但尚无真实人员身份、多人并发编辑、权限委派及完整职责分离机制。审核通过也不能保证商品事实天然正确。
执行可靠性只覆盖确定的模拟分支
当前失败与恢复由预设规则决定,没有真实异步队列、超时对账、重复回调、网络中断或大批量压力验证。同一任务内可保留成功项并避免重复计量,但跨任务重复刊登识别尚未实现;取消也不等于撤销成功的外部操作。
数据安全与运维未进入生产状态
浏览器存储不具备真实身份认证、服务端租户隔离、云端备份、不可篡改审计或跨设备协作。JSON 导出只能留存,没有自动恢复。通知设置不发送真实通知;预算没有支付和发票流程;没有生产监控、告警和服务可用性承诺。页面也未提供完整内部客服或管理后台。
已完成的 26 项自动检查及浏览器流程验收,主要支持前端状态和交互行为正确,不能代替真实接口、并发、安全、性能与平台联调验收。
12 需要与产品方确认的问题
这些问题用于缩小不确定性,并不预设现有系统存在问题。回答后,应相应删减或调整方案,而不是为了保留展示中的页面而扩大项目范围。
- 首批用户是谁? 是使用货盘的卖家、独立 MoonClaw 用户、代运营机构,还是内部运营?他们最频繁、最耗时的任务是什么?
- 现有产品已经怎样完成这件事? 从选品、生成、审核到刊登和回执,哪些入口与规则可以直接复用?增加工作台是否真的减少操作?
- 商品事实由谁负责? 商品、规格、库存、图片和价格分别来自哪个系统?资料更新后由谁确认,旧任务怎样处理?
- 哪些动作需要人确认? 单人卖家、多人成员和代理机构的规则是否不同?谁对商品事实、文案和实际发布分别负责?
- 账户与代理关系是什么? 同一用户能否属于多家企业,代理商怎样获得并失去客户授权,内部支持能看到哪些数据?
- 首个渠道能提供什么接口? 授权范围、字段限制、发布结果与查询方式是什么?测试环境能否验证部分失败及结果不明?
- 同一个任务怎样跨入口保持一致? 对话和页面是否共用任务服务?正在修改、等待审核或已经提交时,另一入口可以做什么?
- 成本和收费怎样区分? 模型调用失败可能已经发生的成本如何核算?额度、积分和商家账单怎样使用既有体系?
- 数据保留与支持责任怎样安排? 谁能删除或导出记录,保留多久,发生异常由谁接手,何时需要客户确认?
- 什么结果才值得继续投入? 首期验收标准、停止条件、用户反馈方式和版本发布责任人分别是什么?
13 建议的试点与验收
试点建议 先选择资料完整、风险可控的一小批商品和单一获授权渠道,在测试环境完成事实读取、生成校验、审核、执行和回执核对,再决定是否扩展多店铺。这里不预先承诺上线日期、节省比例或增长目标。
| 阶段 | 主要工作 | 进入下一阶段的依据 |
|---|---|---|
| 场景确认 | 观察用户完成一次真实任务,盘点已有能力。 | 明确一个可衡量问题,确认新增交互有必要。 |
| 测试联调 | 接资料源、身份、模型和渠道测试接口。 | 数据、权限、版本与回执能够逐项核对。 |
| 人工对照 | 比较生成结果与人工处理结果,检查异常。 | 关键事实与执行范围正确,质量评测和异常处理达到约定标准。 |
| 授权小范围使用 | 由明确责任人监督少量真实任务。 | 用户收益、成本与运行稳定性有证据支持。 |
| 逐步扩大 | 按渠道与客户群逐步增加范围。 | 有监控、支持和暂停机制,扩展不破坏已有任务。 |
当前已经验证什么
交付前已对研究方案、工作台与本手册交叉核对。工作台的 26 项状态与控制器检查通过,并从交付 HTML 中抽取实际脚本,复核自定义分类保留、超长退回原因保留,以及第 7 章的完整示例:两件商品与两家店铺形成 4 个子任务,首次 2 成功、2 失败,重试后本任务共计 8 模拟积分,初始空间总用量由 4 增至 12。修改后审批失效、部分成功后资料变化阻止重试、取消保留成功回执也已验证。这些结果证明当前展示内部逻辑一致,不代表真实模型、渠道或多租户环境已经通过验收。
首期可落地的最小范围
建议把首期限制为一个已确认的商家群体、一个只读商品资料源、一套现有身份权限、一个已获授权的渠道,以及人工审批后发布的链路。先实现商品与资料版本读取、内容生成与事实校验、版本审批、持久化子任务、渠道回执查询和操作审计。将跨渠道映射、自动无人审核发布和复杂套餐收费留到后续验证;本展示中的两渠道示例并不意味着首期必须同时接入它们。
推进条件应由对应责任人确认:业务负责人确认场景与商品事实,现有账号团队确认商家和店铺授权,智能体团队确认可复用的生成接口,渠道团队确认发布及查询能力,测试与运维确认重复请求、未知结果、恢复与暂停流程。任何一项缺少可用接口或责任归属,都应保持测试或人工处理,不能仅靠页面跳转宣称完成接入。
至少应验证的关键情况
用真实边界条件验证:未授权用户不能读取或执行他人任务;资料变化后不能沿用旧审批;未知材质不能凭空补齐;重复点击和重复回调不会重复发布;失败项恢复不覆盖成功项;结果不明能够查询与核对;预算和实际成本能够解释;断开连接后新操作受控;服务重启后任务状态可恢复。
出现越权、关键商品事实错误、错误店铺发布或重复刊登时,应暂停真实执行并定位原因。恢复入口或暂停队列可以阻止后续动作,但不能自动撤回已完成的外部发布;需要按平台能力和客户授权另行处理。是否扩大范围,以验收和反馈决定。
14 常用术语与阅读提示
| 术语 | 在这里的含义 |
|---|---|
| SaaS | 通过软件服务让用户持续使用业务能力。当前文件是这种产品形态的前端展示,并非已运行的云服务。 |
| Agent 智能体 | 理解任务并在授权范围内调用工具的执行能力,可以与表单、表格等界面协同。 |
| SKU | 商品或规格的识别编号。资料层级与渠道映射需要按真实业务定义。 |
| 任务与子任务 | 任务表达一次业务目标;本版以“商品 × 店铺”拆分执行子项,分别记录结果。 |
| 租户与工作空间 | 通常用于区分企业或客户的数据边界;本演示的空间只是在浏览器中分组,不能代替服务端隔离。 |
| API 接口 | 系统间约定的调用方式,例如读取商品、提交任务和查询回执,需要身份与权限校验。 |
| SSO 单点登录 | 让多个产品入口识别统一身份;具体能做什么仍需业务授权。 |
| OAuth 平台授权 | 通过平台支持的流程授予约定范围的访问能力,不等于把店铺密码填进工作台。 |
| 幂等 | 同一个业务请求被重复处理时,不重复产生应只发生一次的业务结果,生产中需要服务端与渠道配合。 |
| 回执与审计 | 回执帮助确认外部执行结果;审计记录谁在何时对什么对象做了什么,二者不能只依赖可改写的本地页面。 |
| PRD 产品需求文档 | 说明目标、范围、规则、接口需求和验收方式。本手册侧重使用理解与操作,不替代正式 PRD。 |
15 参考依据与版本说明
公开资料于 2026 年 10 月 24 日核对。以下页面用于确认企业和产品公开介绍的方向,不用于证明内部架构、全部功能可用性、收入、经营成效或本方案的必要性。
- MoonClaw 产品官网:https://moonclaw.com/。用于确认公开能力范围和体验入口,未在本手册制作中逐项验证其真实账号下的执行结果。
- 西之月业务官网 公司简介:https://www.westmonth.cn/business。用于确认供应、选品、定制和代发等业务介绍,不独立核定规模与效果。
- 个人提供的体验与招聘资料:招聘截图、产品截图及《西之月.pptx》。用于理解研究背景;有限试用记录不能替代系统日志、用户访谈和产品方说明,本手册未公开原始截图中的个人账号信息。
- 独立工作台 v0.2.1:当前前端页面、业务状态逻辑及既有验收记录。第 5 至 9 章按钮名称、流程和限制以此版本为准,未来版本变更后应同步更新手册。
本次修订记录
工作台 v0.2.1 在 v0.2 基础上修复两处输入问题:CSV 导入自定义分类后,编辑商品仍保留原分类;退回原因超过长度限制时,校验提示保留原文供修改。完整业务流程与数据结构保持原有设计。研究方案另提供说明修订版 v0.1.1:保留原 v0.1 的状态逻辑与计量示例,在各页面补充版本阅读提示,避免与批量工作台混淆。原始文件保留供追溯,建议配套阅读本次修订版。
本手册与早期研究文档的关系
配套工作台保留的 v0.1 PRD 主要围绕单任务验证案例;v0.2.1 已扩展到多商品、多店铺和多任务。此次手册以“现有产品体系中的协作模块构想”解释定位,并明确每个成功的商品与店铺子任务记 2 模拟积分。该口径只服务演示,不覆盖模型成本或官方收费。
本作品希望提供一个可以被讨论、修订或否定的具体样本。若产品方已有更合适的流程或约束,应以实际业务与经验证据为准,并相应调整本方案。