# 商小助-拼多多工具合集

拼多多平台的统一插件维护入口。后续新增、修改或发布拼多多功能，均从本目录开始；旧的独立插件和 `商小助拼多多助手` 仅保留为历史版本，未经确认不要继续修改。

当前开发版本：`1.3.5`。

## 当前模块

| 模块 | 生效页面 | 说明 |
|---|---|---|
| 评价DSR提升 | `mms.pinduoduo.com/goods/evaluation/index` | 评价筛选、订单号导出、批量回复与差评举报；`debugger` 权限在插件安装时声明，用于弹窗内的原生点击。 |
| 30 日金额退款率 | `mms.pinduoduo.com/sycm/goods_effect` | 商品数据页显示退款金额和金额退款率。 |
| 首页经营卡片 | 拼多多后台首页，以及直通车历史数据采集页 | 显示实时费比、单笔成交花费、今日销量预测、店铺 30 日金额退款率。 |
| 售后率计算 | 插件内独立工作台 | 导入历史订单表，按货号（是拼多多字段里的商家编码-商品维度）计算发货前退款率、签收退货率和总退款率；不包含库存匹配、销售分析和“复制数据到飞书”。 |
| 表格导出 | `mms.pinduoduo.com/sycm/goods_effect`、`yingxiao.pinduoduo.com/goods/promotion/list` | 商品数据页和直通车列表页各提供一个“导出 CSV”按钮；不包含汇总导出、接口监听、量化导出或分时采集。 |
| 商品发布 | `mms.pinduoduo.com` 下路径包含 `goods_add` 的页面、`mms.pinduoduo.com/goods/goods_list` | 商品发布页提供图片整理、图片空间选图、SKU 生成和价格换算；商品列表页提供编码填充、编码母版、批量套用、间隔和自定义编码规则。商品属性功能不迁入。 |

五个网页注入型模块默认关闭。Popup 开关只注册或注销对应内容脚本，不再自动刷新当前页面；切换后会在开关附近显示 2 秒淡入淡出提示，用户手动刷新相关页面后生效。售后率计算是插件内独立工作台，默认可用且不设开关，不向拼多多网页注入脚本。

Popup 中每个模块名称右侧均提供独立的“说明教程”链接，分别打开该模块自己的说明页；不使用合并说明中心。说明内容为第一版详细草稿，后续按实际使用反馈继续审核完善。

## 本地加载

1. 打开 `chrome://extensions`。
2. 开启“开发者模式”。
3. 点击“加载已解压的扩展程序”。
4. 选择本目录 `商小助-拼多多工具合集`。
5. 打开插件 Popup，按需开启模块。

首次使用首页经营卡片时，需要到一次直通车页面选择“近 30 天 + 成交花费”，让模块保存真实历史花费请求参数；随后回到首页即可显示完整曲线。

售后率计算不需要开启，也不会随 Popup 打开而自动新建页面；需要使用时，直接在该模块右侧点击“打开工具”进入独立工作台。导出的 Excel / CSV 只包含货号（是拼多多字段里的商家编码-商品维度）、发货前退款率、签收退货率、总退款率四列，不生成空白字段列。

直通车 CSV 的“推广状态”优先读取页面 `AdStatus_*` 元素，因此支持推广中、手动暂停、到达日限额等状态。“今日预算日限额”取页面预算金额，例如 `100.00 元`；“今日预算剩余”输出百分比，例如 `96%`，预算不足时输出 `预算不足`；“净目标投产比”单独输出 `9.06 流量下滑` 等内容。

商品发布模块中，轮播图和详情图均提供“只保留首图”；打开图片空间后保留“主图选择”“详情图选择”和“使用说明”。商品规格只保留 SKU 编辑器与“生成sku”，不包含升级款生成。价格输入框表示最终希望用户实际支付的目标实售价，“价格设置逻辑”支持按折扣和优惠券反推上架价，或按商品成本与期望毛利率计算；未设置逻辑时可以直接使用输入价。商品编码填充支持延续原有种子识别规则，也可以用 `{种子前缀}`、`{尺码}`、`{种子后缀}` 自定义模板。

价格操作区中，蓝色“价格设置逻辑”用于配置规则，绿色“计算并批量填充价格”用于执行计算和写入，通过颜色和层级区分设置与执行操作。

同一货号多次保存商品编码母版时，新颜色/规格会追加到该货号的母版明细；已存在的同名颜色/规格只更新对应规则，不会删除其他已保存明细。旧版母版数据会在下次保存时自动合并为新结构。

商品发布价格批量填充时，页面 `data-tracking-viewid="count_discount"` 对应的满 2 件折扣固定填写 `9.9`，不使用价格设置逻辑中的活动折扣比例。商品发布脚本匹配 `mms.pinduoduo.com` 下所有路径包含 `goods_add` 的页面。为降低页面卡顿，DOM 监听不再监听文字变化，扫描最多约每 700 毫秒执行一次，且只有找到真实插入位置后才创建按钮。

## 版本号规则

本目录中的插件每次发生代码、样式、文案或配置变更，都必须同步修改 `manifest.json` 的版本号。小修复、文案和样式调整递增末位版本号；新增模块、明显功能扩展递增中间版本号；存在不兼容变化或整体重构时递增主版本号。具体升级级别由维护者根据影响范围判断，不允许更改插件后沿用旧版本号。

## 图标候选

`icon-candidates/` 保存此前的设计候选，仅作为历史参考。当前正式插件图标以根目录 `logo.png` 为母版，先裁掉透明外圈，再生成完全占满画布的 `icons/icon16.png`、`icon32.png`、`icon48.png` 和 `icon128.png`；Popup 品牌标识使用裁掉透明边距的 `icons/brand-logo-popup.png`。
