使用手册

0五分钟上手

不需要任何配置，先把四个动作走一遍，你就知道这个系统怎么用了。

1. 打开并登录本地：node server.js 后访问 http://127.0.0.1:4173；账号 admin，密码 admin123。线上则用你部署时设的 ERP_ADMIN_PASSWORD。
2. 看首页大屏（30 秒）确认「范围总营业额 / 预估利润 / 订单数」三个数是否合理，切一下「今天 / 7 天 / 28 天」看趋势。右上角 缺货 65 是可点的，直接跳到库存页处理。
3. 点开任意一页的表格行21 个模块里凡是列表，点一行都会从右侧滑出详情抽屉（费用拆解、物流节点、评价原文等）。这是最常用的动作。
4. 导出一次 CSV订单、利润、库存、关键词等页面右上角都有「导出」。文件带 BOM，Excel 直接双击不乱码，可拿去和财务/仓库对。
5. 去「店铺设置」加一家店填平台 + Client ID + API Key → 点「测试连接」→ 点「写入环境变量 / 添加店铺」。加完左栏「在售 SKU」和数据源数量会跟着变。

1界面地图

整个系统只有三个区域，先认清它们，剩下的就是点菜单。

各模块分别解决什么问题

2数据是怎么进来的（三条管道）

搞清这一点，你就知道为什么有时候数字是「演示值」，有时候是「真值」。

3接一家店铺（平台 API）

在「系统 → 店铺设置」里操作。授权的意义已经不止"记录一下"，而是直接决定哪些能力不用登录后台。

1. 拿到凭证Ozon：卖家后台 → 设置 → API 密钥（Client ID 是纯数字，API Key 是一长串）。Wildberries：后台 → 设置 → 供应商 → API 访问令牌（UUID 格式）。生成时把内容 / 统计 / 推广 / 费率这几类权限都勾上，缺哪类对应能力就会 403。
2. 填写并选模式平台、店铺名、Client ID、API Key；模式选跨境 / 跨境 FBS / 本土——这个选择会决定利润核算用哪套费率。
3. 点「验证并授权」会真的调一次平台接口（WB 走 /ping，Ozon 读一次仓库列表）。通了才保存，并通过不是"格式对"，是"平台认"。
4. 看「接口」列变绿显示「API 已授权」即完成；能力中心里对应的能力会自动从「需登录」变成「API 直连」，按钮也变成「接口运行」。

4接 BrowserSkill（抓平台没接口的数据）

典型场景：竞品今天降价没？我的词掉到第几页了？这些只能靠浏览器抓。

1. 在「自动化任务 → 任务列表」找到对应任务已有覆盖：关键词排名、竞品跟价、商品巡检、评价提问、订单、结算、选品情报。点「命令」把 bsk 命令序列复制出来。
2. 到装了 BrowserSkill 的电脑上执行粘贴到 PowerShell 跑；命令里已带好选择器和翻页逻辑。要每天自动跑，就挂到 Windows 计划任务，频率参考页面底部的建议。
3. 导出结果bsk extract --format json 输出到文件，或直接复制终端里的 JSON。
4. 回「结果导入」贴进去系统会按字段落到对应模块，并生成一条数据集记录。云端模式下同时写入 D1，别人打开也能看到。

★能力中心：在网页里直接跑 BrowserSkill

这是整个系统最省事的一页。63 项能力全部列在这里，点「运行」填几个参数，剩下的交给本机浏览器，结果直接回到表格里，还能一键写进对应模块。

它为什么能"点一下就动浏览器"

网页本身跑在云端，碰不到你的电脑；所以项目里带了一个 本地桥（bridge/，一个只监听 127.0.0.1:8765 的小服务）。你在网页上点「运行」→ 桥在你本机执行 bsk 命令 → 驱动你已登录的 Chrome → 把结果回传网页。数据不出本机，只有抓取结果会写进浏览器本地存储（或云端的 D1）。

装一次，以后永远自动

1. 双击 install-autostart.cmd只需一次。它把本地桥注册成开机自启、无窗口常驻，并当场启动一次做校验。
2. 打开网页，什么都不用做地址栏敲 http://127.0.0.1:4173 就是"已连接"。状态带会显示「本地桥已连接 · bsk 0.3.3 · Chrome 1 个」。
3. 点任意一项的「运行」抽屉里填参数 → 开始运行 → 看日志一步步走（打开页面、识别容器、抽取行数），结束后直接出表格。

以后再开机，桥会跟着系统自己起来。你不会看到任何窗口，也不用记任何命令 —— 跟你装完 BrowserSkill 扩展后的感觉是一样的。

正常情况下你不需要手填：页面从 127.0.0.1 或 localhost 打开时，桥会把令牌直接交给它，状态带自动变绿。只有页面是公网地址（例如部署到 Cloudflare 后的域名）时才要求填一次，因为浏览器不允许公网页面随便读本机服务。

真要手填时，两个办法任选：

• 点弹窗里的 「自动读取」，直接取到 32 位令牌，再点「保存并连接」
• 用记事本打开项目里的 bridge\.token，全选复制那一行粘进去

令牌只存在你这台电脑的浏览器里，换台电脑要重新连一次；桥重启令牌也不变。想取消开机自启，双击 uninstall-autostart.cmd。

63 项怎么区分

先看登录态，再跑后台能力

状态带里有一个 「WB 后台未登录 / 已登录」 的胶囊。它不是在猜 —— 桥会真打开一次后台首页，用三个证据判断：是否被踢到登录域名、页面上有没有密码框、有没有后台菜单（Заказы / Аналитика / 库存 / 结算这类词）。

为什么不能只看网址：未登录访问 seller.wildberries.ru 会跳到一个中文营销落地页，网址看着"对"，但其实什么也读不到。只看网址就会被骗。

未登录时，卡片上的按钮会直接从「运行」变成 「先登录」，点了会给你登录引导，而不是让你等 30 秒看一个空表格。这是刻意的：失败要失败得明白。

建议先跑这五项

跑完的数据去哪了

结果先出现在抽屉里的表格（可导出 CSV / 复制 JSON），点 「写入XX模块」 就落到对应页面：

让它在你看不到的时候自己跑

切到「定时任务」页签。这里的排程由本地桥执行 —— 因为抓取要驱动你本机已登录的 Chrome，云端做不到这件事。桥开着，任务才会按点跑；关掉桥，排程就停了。

第一次进去会看到三条推荐（3.1 排名 / 4.1 竞品价 / 6.4 差评预警），点「加上」就建好，参数之后还能改。

定时任务里两个刻意的设计

• 未登录就跳过，不报错。如果已经明确检测到「未登录」，到点后任务会标成 跳过 并记下原因（"未登录 Wildberries 卖家后台"），而不是给你刷一堆红色失败日志。等你登录后，下一次到点自动恢复。
• 同一能力不并发。上一次还没跑完，这一轮直接跳过，避免两个任务同时抢浏览器会话把页面搞乱。

★API 直连：授权一次，后台类能力就不需要登录

「需登录」的能力，本质是在读卖家后台的数据 —— 而这些数据平台其实都有开放接口。所以只要你在店铺设置里授权过 API，同一项能力就自动改走接口：不打开浏览器、不受登录态影响、可以半夜定时跑。

17 项能力可以完全不用登录

怎么用

1. 店铺设置 → 验证并授权填完点一下，接口通了就保存。可存多家：WB 和 Ozon 各一家、同平台多家都行。
2. 能力中心里那些能力自动变绿标签从「需登录」变成「API 直连」，卡片上还会写明走的是哪家店的接口，按钮变成「接口运行」。
3. 点「接口运行」抽屉里只有一个绿色提示，不会打开任何页面。结果表上方会标「官方接口 · 店铺名」，和浏览器抓的结果格式完全一致，可以照常生成报告、写入模块、导 CSV。
4. 定时任务自动跟着走排了程的能力，只要授权还在，到点就走接口；不会再因为「WB 后台没登录」被跳过。

还有哪些必须用浏览器

不是所有数据平台都开放。下面这些仍走浏览器抓（能力中心里它们的标签还是「需登录」或「公开页」）：

• 词级广告搜索词明细 —— WB 只开放到「计划 × 天」，词级还得看后台；3.2 会给计划级数据并注明。
• 公告、政策原文、EAC 认证要求 —— 没有接口，只能读后台页面。
• 纠纷取证截图 —— 本质就是截图归档，接口给不了。
• seller.imlb2c.cn 内部系统 —— 第三方系统，走它自己的登录态。
• 买家复购识别 —— 平台接口不返回买家标识。

★报告看板：把抓回来的数据变成看得懂的结论

能力中心解决「抓得到」，报告看板解决「看得懂」。跑完一项能力，点一下就能得到一份带结论、图表和定价建议的报告，不用自己拉 Excel 算。

报告从哪来

两个入口，结果一样：

1. 跑完马上生成能力中心 → 任意能力 → 运行 → 结果区点「生成洞察报告」，自动跳到报告看板。
2. 回头再生成左栏「抓取 → 报告看板」，左栏第一块列的是「本地桥里每项能力最近一次成功运行」，点一项就生成。第二块是已存报告，可离线反复看。

一份报告里有什么

两个按钮

• 导出报告：生成一份自包含的 HTML（图表是内嵌 SVG，不依赖网络）。浏览器打开后 Ctrl/⌘ + P 就能存成 PDF，适合发给老板或存档。
• 导出数据：原始行导成 CSV（带 BOM，Excel 直接开），要自己二次加工时用。

★小蓝挂件：右下角那只盯着余额和待办的女仆

它常驻在页面右下角，气泡里实时显示账户余额、今日已用、待办和峰谷时段。参考 dsh-whale-widget 的用法做的，立绘用的是你提供的那张 Q 版蓝发猫耳女仆（原图是带“透明格”的 JPEG，已去背转成 560×608 的带 alpha WebP，48KB）。

气泡上默认有五行

余额怎么接

点小蓝 → ⋯ → 设置 → 钱包，两种模式：

1. 接接口（推荐）填一条 DeepSeek API Key（platform.deepseek.com → API keys），点「保存并验证」。验证是真调一次 api.deepseek.com/user/balance，Key 错了当场报错并告诉你去哪重新生成。之后每 60 秒自动刷新一次。
2. 手动填不想给 Key 就自己填余额。今日已用照样按差值算，只是要你自己更新余额。

今日已用是怎么算的

不读你的对话记录，只看余额：每次刷新拿到的余额和上一次比，掉了多少就记多少。涨上来（充值）不冲抵当天已用，只更新基准值。跨天自动归零并归档。所以它统计的是「今天这个账户实际被扣了多少钱」，比按 token 估算更准。

峰谷计时

按北京时间：工作日 09:00–12:00、14:00–18:00 是峰，其余时段和周末全天是谷。气泡上的红色「峰」/ 绿色「谷」后面跟的是倒计时（还有多久切换），用来判断现在跑批量任务划不划算。

待办从哪来

两路合并，不用手工维护：

• 系统待办：自动从 ERP 算出来 —— 待发货、退货待处理、评价没回、提问没答、SKU 快断货、卡片有问题、结算待核对。处理完自动消失，点一下直接跳到对应模块。
• 自己的清单：设置里加，勾掉即完成。气泡里勾选也能直接完成。

怎么玩

• 拖：按住小蓝拖到任意位置，松手自动贴边；贴左边时她会翻个面。
• 点：点一下刷新余额和待办，它会说句话；睡着时点一下叫醒。
• ⋯ 菜单（鼠标移上去出现）：刷新、待办清单、设置、大一点 / 小一点、静音、睡 30 分钟、回到右下角。
• 排版：设置 → 气泡排版，最多 6 行、每行合计最多 6 列。把「宽」调到 3 就能一行并排两个模块，字号也能单独改。
• 提醒：余额低于阈值、待办堆到阈值时，它会弹提示并响一声（30 分钟内不重复）。提示音可以单独关。

★待办事项：每天真正要干的那些事

它不是一张空白便签。三件事被合成一屏：系统从订单、售后、库存里算出来的「该干了」，你自己记的「别忘了」，以及日 / 周 / 月例行工作。谁在什么时候该做什么，一眼看完。

待办从三个方向来

系统待办是按什么算出来的

每条规则都从你库里真实的数据算，不写死数字。处理掉了（比如退货处理完、差评回完了），下次进页面它就自己消失。

四个视图，各有各的用法

优先级怎么用

几个容易踩的点

• 快速添加默认今天 18:00。不然所有事都会掉进「没有截止」，永远排不上。
• 例程的截止时间会自动顺延。比如晚上 20:00 才点「今日 8 项」，那些原本 9:00、11:00 的事项会顺延到 23:59，不会一生成就满屏「已过点」。
• 勾掉就消失是对的，不是丢了。右上勾「含已完成」能翻回来，再点一次方块可以恢复成待办。
• 子任务：拆成 2–3 步的事更容易真做完。勾完子任务，主行会显示「1/2」这样的进度，但主行仍要你自己勾完成。
• 和右下角小蓝是同一份数据：在这页勾掉的，小蓝气泡里的数字立刻变；反过来在小蓝里勾也一样。
• 导出：当前筛选结果导成 CSV（带 BOM，Excel 直接打开），周会前丢给同事用。

★多人协同：两个人同时用，数据怎么保持一致

部署到 Cloudflare 后，同事用你分配的账号登录同一个网址即可。不需要装客户端，也不用手动「刷新一下」。

顶栏会多出两个东西

谁会看到什么

• 同事改了待办：你的页面 3–5 秒内自己变，右下角弹一句「已同步同事的修改：待办」。如果你正在输入框里打字，它不会强行重绘打断你。
• 你正在编辑表单时有人改了别的模块：只弹提示，等你处理完手头这一步再刷新，不会把输了一半的内容冲掉。
• 两个人改同一条待办：按最后修改时间保留一份；不同条目各自保留，不会互相覆盖。
• 删掉的不会被复活：你删了一条，同事那边的旧副本不会把它推回来。

加人、踢人、改密码

都在「系统 → 账号管理」：

• 新增成员（只有主账号能点）：填登录名、显示名、初始密码，把这三样发给同事即可。
• 移除成员：该账号所有登录会话立刻失效，人还在页面上的话下一次请求就被踢回登录页。他改过的数据不会丢。
• 改自己的名字/密码：会同步到云端；改密码会作废其它设备上的旧登录，当前设备保持登录。

5利润是怎么算的

三套费率并存，页面右上角可以切换口径。默认值如下，可在「成本中心」改。

公式：利润 = 售价 − 采购成本×成本汇率 − 佣金 − 各项费率 − 物流 − 包装。页面同时给卢布和人民币两个口径。

6常见问题

顶栏的「已同步」是灰的

说明没连上后端，正在跑本地演示模式。检查两件事：是否用 node server.js 或部署后的域名打开（而不是直接双击 html 文件）；云端是否绑定了 D1、配了 ERP_SECRET。访问 /api/health 返回 d1:true 就是正常的。

改了费率，为什么首页数字没变？

回到「成本中心」点保存，再刷新。全站是即时重算的，但页面不会自动轮询——这是刻意设计的，避免你正在看数的时候数字跳动。

导出的 CSV 用 Excel 打开乱码

不会。导出文件带 UTF-8 BOM，Excel 双击正常。如果你用 Numbers 或 Google Sheets 打开后列错位，是分号/逗号分隔的差异，用「数据 → 分列」指定逗号即可。

能多人一起用吗？

能，但要先部署到 Cloudflare 并绑定 D1。本地演示模式的数据在各自浏览器里，互相看不见。「账号管理」里可以开协作账号并限定可见店铺。

我不小心把演示数据改乱了

控制台 localStorage.clear() + 刷新，回到出厂状态。云端数据不受影响，也不会被这条命令删掉。

手机上能用吗？

能打开，表格会横向滚动，但发货倒计时、库存预警这类需要快速操作的场景建议还是用电脑。

下一步该先做什么

如果只有你一个人用：先在「成本中心」把真实费率填对（这一步能让所有利润数字可信），再在「店铺设置」接入主力店，然后每天只看首页 + 订单发货两页。等这两页的数据你信了，再往关键词、竞品、选品扩。