单店工作室 v0.4 使用手册

v0.6 新增：全历史检索、自动召回和长期经验使用指南。

v0.5 新版：右侧运营 Agent、素材中心及新界面操作请先阅读 运营 Agent 使用指南。下方保留原业务配置说明。

Linux v0.4.1 服务器用户：本手册的业务操作适用；Windows 启动文件、8793 入口和本机备份路径请改按源码包内 studio/docs/Linux完整部署.md 执行。原生服务器数据目录为 /var/lib/doudian-studio，入口为 SSH 转发的 8790 或配置的 HTTPS 域名。

适用对象：店主、运营人员。整理日期：2026 年 10 月 19 日。

本机入口：打开单店工作室。启动文件：项目文件夹中的 启动工作室.cmd。

本版已实现经营流程与保护逻辑；是否能操作你的店铺，还要经过账号授权和小样本验收。你可以先看手册、准备资料，以后自己填写账号和 Key。不要把后台密码、短信验证码、Secret 或 Token 发到聊天中。账号登录在对应平台或专用浏览器完成，接口凭据填工作台表单。

目录

1. 启动、页面与功能状态
2. 准备凭据和业务资料
3. 配置 Sub2API 三个模型通道
4. 三平台应用申请、授权与连接测试
5. HTTPS 回调与商品图片托管
6. 建商品、记成本与动态保本
7. 17 网采集、授权货源与导入
8. 订单映射、补录与成熟参考批次
9. 商品发布、普通作品与浏览器挂车
10. 通用模板与自动衔接
11. 40 条素材实验与停投对账
12. 标准、全域及组合直播控制
13. 首次验收与日常运行顺序
14. 暂停、异常与恢复
15. 备份、更新与电脑睡眠
16. 附录：入口和维护资料

1. 启动、页面与功能状态

页面位置：启动后先进入“自动经营”，左侧可切换其他页面。

双击“启动工作室.cmd”，看到“本机工作室已启动”或“已在运行”后，在浏览器打开 http://127.0.0.1:8793/#operations。如果没有自动打开网页，手动复制这个地址。电脑需安装 Node.js 24 或更新版本；正常使用不需要自己安装 npm 依赖。

如果出现“解锁工作空间”，输入为这份工作室设置的访问密码，它不是抖店密码。关闭启动窗口不会停止后台服务；电脑重启后需再次双击启动文件。日常改配置或更新后，用同一文件夹中的“重启工作室.cmd”，不要另外启动一套后台。

成功标志：页面能刷新商品和任务，顶部不再显示连接本地服务失败。这个标志只证明软件已运行。

常见失败：提示 8793 被其他服务占用时，不要连续双击或随意杀掉全部 Node 进程。新版本会受控重启可识别的旧实例；首次遇到不支持重启的旧版服务，按第 15 节处理。不要同时在旧 8790 与新 8793 工作区录入业务。

分清三个状态：离线测试证明实现；连接测试证明本次读取或授权；真实对象核验才证明对应发布或操作完成。已配置、HTTP 成功、accepted 都不等于“已公开挂车”或“已盈利”。

2. 准备凭据和业务资料

页面位置：凭据主要填“连接与设置”“自动发布”“自动经营 → 账号授权”。

先分清两类资料。接口凭据回答“程序能代表谁做什么”，业务参数回答“卖什么、成本多少、最多花多少”。这两类不能互相替代。

准备一个确实已上架的商品 ID、一个确实已公开的抖音作品 ID，供接口只读校准。商品 ID、SKU ID、SKU 订单 ID、作品 ID、广告计划 ID、广告主 ID是不同字段，不要混填。

成功标志：每项资料能对应明确账号和商品，密钥保存后显示“已保存”而不是明文。

常见失败：Secret 填进 Token 栏、把店铺 ID 当广告主 ID、复制不完整 ID。密钥框留空通常保留原值；填新值可替换。只有实际带“清除”选项的表单才可勾选删除，OAuth 和发布连接卡没有该勾选项。

3. 配置 Sub2API 三个模型通道

页面位置：连接与设置 → 推理通道、图像通道、视频通道。

三个通道都经过你配置的中转，不会在失败后偷偷换成默认官方模型地址。同一个中转地址和 Key 可以共用，但模型、协议、路径分别保存。

1.填“中转 API Base URL”。使用服务商给出的完整 API 前缀，例如形式为 https://你的中转域名/v1；它是填写格式，不是可用的测试域名。程序不会再补一层 /v1。

2.填该通道真正支持的“模型名称”和“请求协议”，不要照抄其他服务商的模型名。

3.填 API Key，点击“保存此通道”，再点“测试已保存配置”。测试读取模型列表，只说明基础连接可用。

4.需要共用地址和 Key 时，可用“将推理通道的地址与当前输入密钥应用到三通道”。它保留各通道模型、协议和路径，之后仍要逐一检查。

高级路径只有在中转文档明确要求时才改。视频创建、查询、下载必须属于同一套服务协议；只改创建地址通常不够。图片自定义创建路径可能覆盖默认生成/编辑选择，不确定时保留默认。推理的“JSON 回退模式”只在服务商不支持原生工具调用时启用。

成功标志：在“创意工坊”用一件测试商品分别提交脚本、一张图、一条短视频，任务成功且结果能显示、下载；视频不只是取得任务 ID，而是真正拿到可播放文件。

常见失败：模型列表能读但生成报错，多半是模型能力、协议或路径不匹配；视频等待较久不是失败；出现 unknown 时先去中转后台核对任务和计费，不重复点创建。模型生成费用与广告预算是两笔费用，实际费用还需对账。

4. 三平台应用申请、授权与连接测试

页面位置：自动发布 →“查看三平台 Key 与授权申请指南”；自动经营 → 账号授权。

应用 Key/Secret 标识应用，Token 代表某个店铺或账号已经授权。创建应用不等于具备所有业务权限；后台管理员密码也不能代替 Token。审核资料和菜单以平台当前控制台为准。

每个平台勾选“启用此授权配置”，先“保存授权配置”，再“发起授权”。返回授权链接后，还需点“打开平台授权页面 ↗”；核对店铺或账号，由你完成授权，返回后检查状态和只读校准。抖店自用方式可能直接返回结果。不要把授权码或 Token 发到聊天。

抖店自用应用先在官方后台开通本店授权，工作台可直接获取授权结果；服务商方式需要平台审核、有效服务订购和正确 Service ID，不能拿 App Key 代替 Service ID。抖音普通作品 API 需核对 video.create.bind 等已开通 Scope，默认申请文字不能代替平台真实权限。千川“平台控制台授权 URL”要从该应用控制台原样复制，不能把开放平台首页填进去。

已有有效 Token 时，也可以在“自动发布”的对应连接卡片中自行填写：抖店填 App Key、Secret、店铺 ID、Token；抖音填 Client Key、Open ID、Token；千川填广告主 ID、Token。分别点“保存连接”“测试已保存连接”。抖店和抖音还需填写前述真实参考商品/作品 ID。

成功标志：授权显示成功，账号 ID 与预期一致，连接卡片通过只读校准。千川素材读取成功不代表已经创建广告；抖音 API 成功也不代表已有购物车资格。

常见失败：回调域名未部署、Scope 未获批、参考商品尚未上架、参考作品未公开、广告主不在授权范围内。访问 Token 在有效刷新授权内自动刷新；刷新令牌到期或权限撤回后，重新“发起授权”，不能保证永久免登录。

5. HTTPS 回调与商品图片托管

页面位置：自动经营 → 账号授权的回调提示；自动发布 → 抖店商品 → 公开素材 Origin。

本机 127.0.0.1:8793 可供你操作工作台，但平台服务器不能用这个地址回调你，也不能凭它读取本机生成的商品图片。需要稳定、可被平台访问的 HTTPS 域名，并实际连接到这份工作台后台。

让维护人员配置公开域名和至少 12 字符的工作台访问密码，再把“账号授权”显示的完整回调地址登记到对应应用。抖店服务商应用须按平台要求登记应用使用地址。不要把一个无关网站的域名填进表单，或只填 HTTPS 字样就认为部署完成。

本机没有域名、密码网页表单，按下面步骤保存启动配置：

1.在项目文件夹打开 deploy，复制 .env.local.example，把副本改名为 .env.local。在文件资源管理器中显示文件扩展名，避免保存成 .env.local.txt。

2.用记事本打开副本，在 STUDIO_PUBLIC_ORIGIN= 后填写已实际接通本机后台的 https://实际域名；在 STUDIO_PASSWORD= 后填独立的长密码，至少 12 字符。密码含空格或 # 时用英文双引号包住。

3.一般保持 STUDIO_CHROME_PATH= 为空，程序会寻找已安装的 Chrome 或 Edge；确实找不到浏览器时再填本机可执行文件的完整路径。

4.保存文件，双击“重启工作室.cmd”。等待原服务保存回执、退出并重新启动，再刷新网页，用新工作台密码登录。

这个文件只保存本机启动条件，不替代三平台与 Sub2API 的表单。它包含访问密码，应私下保管。若还没有 HTTPS 域名和实际代理连接，可以先用本机核算、模型和已配置 Token 的功能；相关回调及本机图片公开托管仍会提示缺项。

“公开素材 Origin”只填 https://实际域名，不带路径或尾部斜杠，且必须与后台公开域名完全一致。工作台只对正式发布中明确选定的图片提供公开素材链接；其他本地素材不会因此全部公开。已发布商品使用的图片和链接应长期保留。

成功标志：从另一网络能访问实际 HTTPS 工作台，官方授权回调能返回正确工作区，抖店真实样本可读取商品图片。

常见失败：只有本机地址、证书错误、域名指向另一份数据库、图片链接过期、配置文件未重启生效、代理没有转到当前后台。域名和访问密码不能填入模型 Base URL；写了环境文件也不等于网络部署完成。

6. 建商品、记成本与动态保本

页面位置：商品与利润 →“+ 新建商品”或“查看 / 编辑”；情景实验室。

填写名称、唯一 SKU 编码、售价、单件货品成本、每单运费、每单运费险、实际库存、签收佣金率、目标净利润率和广告费比上限，再保存。界面标“元”的地方填人民币元，标“%”的地方填百分数；高级平台 JSON 的价格可能是分，不能混用。

未知库存、采购成本或费用不能为了通过表单而填 0。货源资料未核实就先保留为待补全候选，不启动实盘。预计支付 GMV 是经营预估，不能取代今日真实订单；正常放量还会受真实成交额约束。

核算规则是：每个已发货订单都收运费和运费险；佣金按签收 GMV 计，签收后退货不退佣金；完好可再售退回品不算留存货品成本；损坏、补寄等实际损失另记。退款金额和退货件数分开，部分退款不能按整件退货处理。

100 元商品例子：100 单全部支付、发货和签收，每单售价 100 元，货品成本 40 元，运费 4 元，保险 3.5 元，佣金 5%；之后 50 件完好退回且全额退款。

若另外 50 单在签收前退款，实际只有 50 单签收，佣金变成 250 元，保本广告额变为 2,000 元。可见没有固定的万能 ROI。

有效广告上限取“目标利润允许的广告额”和“支付 GMV × 广告费比上限”中更小者，最低为 0。修改价格、退货率或成本后，在情景实验室点“重新计算”核对变化。

成功标志：每项成本能解释，实账和试算能对上；不是只看到绿色利润。

常见失败：漏保险、退货后扣回佣金、用订单退货比例代替退款金额比例。手工结算账本用于记录你核对过的批次，不会自动变成真实平台放量依据。

7. 17 网采集、授权货源与导入

页面位置：自动经营 → 17 网采集、货源选品。

在“17 网采集”点“打开专用 Chrome”。它使用本机 9334 端口和独立浏览器资料目录；在这个窗口中自行登录搜款网，打开七日热款或商品列表，让要采集的商品可见，再点“采集当前可见页面”。普通路径保留默认设置，不填 CSS。

“观察记录与证据”会列出实际可见标题、链接、展示价、图片及榜单信息。七日热款、TOP 2 不是销量；材质不能从商品名字猜，未显示的库存和成本保持空白。图片使用页面实际地址，不凭空拼接高清原图。

接着在“货源选品”选择“17 网专用浏览器可见页面”，保存货源策略，点“同步当前货源方式”。如果使用供应商授权 Feed，改选该方式，填写供应商实际提供的 HTTPS 地址和独立 API Key。Feed 不是搜款网登录密码。

导入前核对素材授权、真实采购成本、拟售价格、库存和参考图片。“售价 / 采购成本倍率”填 1.8，表示按已核实采购成本的 1.8 倍定价；0 表示不自动计算。展示价不会直接当采购成本。候选区没有成本或库存编辑表单：缺项须通过授权 Feed，或由维护人员核实可见字段映射后重新同步，齐全后才用“导入此授权商品”。

首次可把“每天最多导入”设为 1，关闭自动导入，查看一件候选是否正确。分数来自可核对的销量、增长或点击成交样本；没有样本可能达不到阈值，不表示系统已经证明它是爆款。竞品资料仅供观察，不会自动变成你的货源商品；不可见的同行报价、竞价和销量不会编造。

成功标志：候选有来源、时间和字段证据，导入后出现在“商品与利润”，原始参考图能在素材库找到。

常见失败：专用浏览器未开、用户尚未登录、验证码、页面无商品、多个同等标签、成本或库存不全。回到专用窗口处理，显示更多商品后再采集；不要把未知改成 0，也不要把验证码交给程序绕过。

8. 订单映射、补录与成熟参考批次

页面位置：自动经营 → 订单与成本。

先在“SKU 对应本地商品”选择本地商品，填平台商品 ID 与平台 SKU ID，或明确的商家 SKU 编码，点“保存 SKU 映射”。不同平台 SKU 对应不同本地商品时逐一保存；不要靠标题相似来匹配。

在“商品与订单同步”保留初始默认值即可开始：300 秒同步间隔、首次回看 30 天、600 秒重叠回读、15 天成熟观察。点“保存订单同步策略”，先手动“立即同步订单与售后”。确认内容后再开启定时同步。

订单按固定窗口分页，重复记录会去重；中断后保留页码，重试恢复原窗口，成功后才推进截止位置。售后可以回补历史订单。父订单与子 SKU 金额不会重复相加，一单多件的件数和订单数分别处理；整单物流费按规则分摊，不按每个 SKU 再收整笔。

查看“同步账本与缺项”。实际签收或退货损耗缺失时，用“订单财务补录”填 SKU 订单 ID、真实签收时间、实际退回件数、损失和额外成本，点“保存财务补录”。仅填写你已核实的项，空白表示未知；只有确认确实为零才填 0。

“只读参考窗口与今日销售”区分三种数据：全量实账包含新订单；成熟参考只取走完观察期的完整支付日期，持续纳入这些老订单最新售后；今日销售来自当天店铺去重支付额，不是标准与全域归因 GMV 相加。默认参考要求至少 3 个支付父订单，样本或费用不全就不支持正常放量。

成功标志：映射明确、未映射项已处理、参考财务完整、实际数据覆盖时间新鲜，今日销售也已完整同步。

常见失败：账号换店、同 SKU 冲突、退款多 SKU 金额无法对应、签收和损失缺项、广告账本不完整。手动补录会重新计算，但不会把旧覆盖时间伪装成今天；不要只看“最近保存时间”。

9. 商品发布、普通作品与浏览器挂车

页面位置：自动发布；自动经营 → 抖音带货。

先在“创意工坊”给本商品“上传参考图”，再到“自动发布 → 单品发布资料”选择商品和原图，决定生成图片/视频还是使用已有素材，填真实末级类目和平台要求的规格、SKU、运费模板、资质，点“保存单品发布资料”。高级模板需要由熟悉该店铺平台配置的人按真实资料准备，模型不会代填未知规格。

在“创建发布运行”先选“预览”，勾选需要的目的地，点“创建发布运行”。预览列出计划与缺项，不调用模型或提交平台。缺项处理完后，才能把发布策略及本次运行切为“正式”；首次仍关闭自动排队，只做一件样本。

浏览器挂车先到“抖音带货”点“打开抖音专用 Chrome”，它使用独立 9335 端口。自行登录创作者账号，在“单品带货档案”填已上架商品链接、最多 10 字的商品短标题、可见的公开抖音号或昵称；链接不能解析商品 ID 时另填真实 ID。AI 生成素材保留相应声明，点“保存单品带货档案”。

“启用带货浏览器流程”允许准备步骤；“允许自动点击发布”才允许最终发布点击。也可用“用现有 MP4 手动建任务”，选择本商品已保存的 MP4、作品标题和描述，生成请求 ID后创建任务。普通使用不用填选择器。

成功标志：发布记录为“平台核验成功”；浏览器任务必须到 verified。仅进入管理页、看到标题或 accepted 都不足以证明公开挂车。

常见失败：账号昵称不符、购物车权限缺失、商品不符合挂载条件、控件变化或平台审核中。用记录里的缺项处理；结果未知只做回读。更新既有商品在“订单与成本 → 更新已上架商品”操作，随后可点“只读回查平台更新”，不要为改图重复新增商品。

10. 通用模板与自动衔接

页面位置：自动经营 → 自动衔接 → 商品到实验的自动衔接。

这里把货源商品、发布、订单映射和素材实验串起来。先选通用投放模式、目的地、受众场景，并保存已核实的通用千川计划模板。模板中的 {{video_id}}、{{material_id}}、{{name}} 会替换为真实回执；它不能代替平台商品类目或业务资质。

先勾选“启用跨流程衔接调度”和“预览衔接计划，不执行新平台写入”，点“保存自动衔接策略”“运行一次衔接检查”。检查“衔接进度”中的商品、计划和缺项，保留每日新商品上限。

正式启用时取消衔接预览，并按需要打开自动创建发布运行、单 SKU 自动映射和启动素材实验。发布、素材实验、实盘写入各模块自己的开关仍须满足；一个衔接开关不会替你打开全部权限。

成功标志：商品先完成平台核验，再建立已证实的单 SKU 映射，之后进入实验；进度能指向对应发布和实验记录。

常见失败：原始参考图缺失、多 SKU 尚未明确映射、发布有暂停或未知记录、通用模板为空。已有单品发布资料和实验档案会保留，不被通用设置覆盖；单品未勾选自动启动时也会尊重它。改了通用模板，不代表旧商品档案自动被改好，应查看对应单品。

11. 40 条素材实验与停投对账

页面位置：自动经营 → 素材实验，以及实盘投放中的试投资金。

先明确“所有计划共享日预算”和“每日素材试投资金”；试投资金从共享总额中占用，不是额外叠加。新款没有成熟订单时，可以在明确授权的试投资金里做实验，但必须有真实正库存、成本、商品映射和可用模板，不能把“获准测试”当成“利润已达标”。

这些是广告资金参数，不包含 Sub2API 图像、视频和推理计费。计划达到单条资金边界也会处理，不必等到零订单判断；平台报表有延迟，10 元不是毫秒级绝对截停金额。

在“单品素材实验档案”选商品、原图、真实商品 ID、标准或全域模式、受众、视频时长和尺寸，保存真实计划模板，点“保存单品实验档案”“启动此商品素材实验”。首次建议只测试 1～2 条，确认后再改为 40 条。需要查看推进情况时可点“推动一次实验步骤”。

成功标志：每条依次有模型结果、千川素材回执、真实广告 ID 和报表；停用后先进入 settling，对账完成才释放可用资金。实验计划设置平台原生当日结束排期，避免日预算次日重置后继续消耗。

常见失败：素材生成或广告创建未知、模板不匹配、试投资金不足、没有实际商品映射、报表未完整。暂停、当日结束和跨日对账仍须看回执。点击“暂停实验与在投计划”后，不要因为本地显示正在暂停就立即复用其预算。

12. 标准、全域及组合直播控制

页面位置：自动经营 → 实盘投放。

先保存“绑定现有真实计划”：选择本地商品、真实平台商品 ID、计划 ID、标准/全域模式与营销目标。点“同步标准 / 全域计划”，核对实际回包；确认后再允许策略控制此计划。

实盘策略分别控制“启用实盘经营检查”“允许真实平台写入”“允许创建真实短视频计划”“允许按财务证据微调 ROI 目标”。初次不要同时打开所有扩张能力。正常放量需成熟参考、新鲜订单售后、今日真实 GMV和最新账户预算；当前成本上涨或售价下降会进行更保守重算。提高 ROI 目标通常更保守，降低目标属于放量，不是改商品售价。

直播另填公开抖音号 ID和每分钟观看上下限。流速来自同一直播间相邻两次真实累计观看数之差，包含自然和广告流量；第一次观测、换房间或统计回退时不会据此放量，不能把它称为实时付费入房速度。

多商品直播在“商品绑定类型”选“多商品直播组合”，点“添加组合商品”，逐款填本地 SKU 与真实平台商品 ID。至少两款；平台回读的商品集合、主播和目标必须完全一致。某平台商品 ID 对应多个本地 SKU 却无法分辨时会阻塞，不能随便选一款。

每个成员仍需完整、同店且日期兼容的财务。某款断货、成本恶化或没有费用空间，不能用另一款利润掩盖。只有整场消耗、没有真实逐款分摊时，相关 SKU 广告成本仍可能缺项；不要把“预算预留”手填成真实成本。

成功标志：绑定核验、各款财务及账户报表完整，操作回执确认目标预算/ROI/暂停状态；看组合消耗时按唯一计划去重。

常见失败：错账号、商品集合多一款少一款、过期报表、其他客户端改过预算、未绑定计划占用同款额度。平台报表延迟和外部修改无法由本地程序原子锁住，应同时使用平台原生账户限额。看不到的同行出价不会被当成自动调价依据。

13. 首次验收与日常运行顺序

页面位置：依次使用连接与设置、自动发布、自动经营；结果在任务和各区记录中查看。

按下面顺序推进，某一步失败就处理原记录，不靠连续新建任务绕过：

1.启动工作台，先保持正式发布、自动排队、实盘写入和自动实验关闭。

2.保存三个中转通道，实测一个脚本、一张图、一条视频。

3.在专用浏览器自行登录，试读一页 17 网；核对一件真实商品和原图。

4.完成所需平台授权与只读校准，映射商品，同步一小段真实订单核账。

5.创建一件发布预览，逐项消除缺项；再只对一个样本开正式运行。

6.到目标平台核对商品、作品、购物车及千川素材，记录实际 ID。

7.先做 1～2 条限额实验，观察归因、暂停、对账及未知状态保护；核对广告平台账单。

8.小样本通过后，再按资金承受范围启用自动队列、通用衔接和常规条数。

成功标志：每一步能拿本地记录与平台对象相互对应，不仅是按钮显示成功。正常运行后不需要逐件审批，但你设置的账户、模板、预算和授权必须持续有效。

每天开始时检查最近同步时间、剩余资金、库存、授权期限及异常记录；结束前核对实际广告消耗和待结算资金。模型建议、选品分数和试算都不能代替订单与账单。

14. 暂停、异常与恢复

页面位置：发布运行与核验、实盘计划与操作回执、实验与素材回执、浏览器步骤与公开核验。

停发布用“暂停后续步骤”；停某个广告用“暂停此真实计划”；停实验用“暂停实验与在投计划”。关闭自动策略只停止后续调度，不等于所有平台计划已经暂停。正在发送的请求仍可能返回，须看最终回执。

商品更新未知时用“只读回查平台更新”；浏览器挂车用“只读核验回执”。“取消未提交本地任务”只结束尚未发布的本地任务，不删除浏览器草稿、不撤回已公开作品。已点击发布的未知任务不能用取消伪装成未提交。

修正条件后，发布记录可用“条件修正后继续”；实验在允许的状态下可用“修正条件后恢复实验”。没有恢复按钮的未知实盘操作，不要手改数据库清除标记，应让维护人员结合平台真实记录处理。

成功标志：真实暂停读回已确认、未知项有明确结果，才恢复后续资金或任务。

常见失败：看到旧的已暂停就认为现在仍停投、离线时假定停投成功、账号切换后继续旧任务。本程序会尽量阻断这些情形；店主仍应在平台核对真正运行的计划。

15. 备份、更新与电脑睡眠

位置：项目的 studio/local-data/；本机启动仍使用“启动工作室.cmd”。

本机资料包括数据库、vault.key、媒体、运行记录、local-control.key 和专用浏览器资料。数据库中的密钥已加密，但 vault.key 丢失就可能无法解密。备份至少保存同一次的数据库、密钥和媒体；建议停机后复制整个私有数据目录，另行保管 deploy/.env.local，备份放到其他安全位置。

备份前先停止新任务，并按第 14 节暂停需要停投的真实计划，等待在途请求和回执。再关闭专用浏览器，由维护人员停止对应工作台后台，复制整个目录。当前关闭启动窗口不会停后台；不知道哪个后台进程属于本工作室时不要结束所有 node.exe。运行中只复制 studio.sqlite 可能漏掉 WAL 中的数据；必须使用一致性在线备份方式。

更新软件前保留旧程序和数据备份。暂停新任务，按新包说明替换程序文件，不要覆盖或删除 studio/local-data/ 与自己的 .env.local，随后双击“重启工作室.cmd”。它只用本机控制凭据请求旧后台停止，等待回执保存和实例锁释放后再启动，不会为加快重启而开第二个同库进程。

重启等待可能需要几分钟。提示“原服务仍在保存回执”时继续检查原任务，别强开第二份。首次从没有 local-control.key 的旧版升级，程序会提示先关闭旧工作室进程，此时由维护人员核对旧服务后处理，数据目录保持原状。重启文件会重新启动服务，不能当成停机备份按钮。

重启后检查版本、商品数量、原图、密钥“已保存”状态和未完成任务；可能需要重新登录工作台。先做只读同步再恢复自动运行，未知任务不会因升级变成可重试。

电脑睡眠、关机、断网会中断采集、生成轮询、订单同步和预算控制，但平台已有广告可能继续投放。实验的原生当日结束排期不能替代所有普通计划的停投安排。需要持续运营时保持电脑、后台和必要的专用浏览器在线，并在平台自身设置限额；本机重启后重新启动工作台。

成功标志：备份能恢复商品、媒体和凭据，更新后能读到原工作区且没有第二个进程共用数据库。

常见失败：只备份主数据库、漏密钥、把新包空数据盖到旧目录、同时启动旧 8790 与新 8793。不要把含凭据和浏览器资料的私有目录放到公开网盘或源代码仓库。

16. 附录：入口和维护资料

此附录供交接或故障定位使用，日常操作无需编写代码。

说明中提到的 API 路径用于解释对应能力，不需要粘贴到浏览器地址栏。遇到问题时，先记下本地任务 ID、发生时间、状态和已显示的平台 ID，截图保留错误提示；提供给维护人员前遮住密码、Token、Secret 和个人信息。账号准入、生成质量、平台 DOM 与业务规则，以以后在你的实际账号中完成的小样本验收为准。