亚马逊广告指挥官 Jegozhou/dsh-scale-commander

Scale Commander

亚马逊 PPC 自动化插件，为 DeepSeek Harness 而生 —— 原生双端插件，把你的广告策略变成可审计的自动化。

English · 中文

Scale Commander 是面向亚马逊广告的生产级 DeepSeek Harness 插件。它实现了卖家对专业 PPC 工具期待的全部操作面：十一种可叠加算法、可复用的条件配置档、带每小时出价修正的分时段投放、否定与白名单管理、关键词收割、批量广告活动构建器、预算与展示位置规则、销售归因，以及一条 预览 → 应用 → 回滚 流水线，记录它做的每一次变更。

它对接真实的 Amazon Advertising API，并附带一个沙箱服务商，在本地生成仿真账户 —— 因此无需凭据就能跑通并验证每一条工作流。

为什么要有它

PPC 自动化工具有一条普通软件没有的要求：人审阅的计划，必须就是执行的那份计划。 Scale Commander 用同一遍纯求值来算预览和应用计划，以此保证这一点。预览不会偏离执行，审计轨迹也绝不会出现审阅者没见过的动作。

十一种算法

每种算法都是纯函数，输入是已聚合的指标，每个建议动作都附带背后的逐步算术。

| 算法 | 做什么 |
| 出价 | 把关键词和商品定向的出价推向目标 ACOS，每次只走一个设了上限的步长，用的是有文档记载的最优出价公式。 |
| 分时段 | 按小时开关广告组，并施加每小时百分比出价修正；最优时段模式从实际表现反推计划。 |
| 导入 | 把有转化的搜索词收割成新关键词或商品定向，定价为其平均 CPC 的某个百分比。 |
| 否定 | 把满足条件的搜索词否定掉，形式为否定精确或否定词组。 |
| 否定词 | 把搜索词拆成单个词，聚合后把表现不佳的词按词组否定。 |
| 黑名单 / 白名单 | 把维护好的列表强制转为否定项，并保护白名单词不被否定类算法命中。 |
| 复活 | 给曾经表现好、如今已死的关键词加价，直到流量回来。 |
| 默认出价 | 为老式自动广告活动优化广告组默认出价。 |
| 状态 | 按条件暂停或启用广告活动和广告组。 |
| 每日预算 | 先套基线，再乘星期几系数，然后按顺序套用每条匹配的条件。 |
| 展示位置 | 把搜索结果顶部、商品页面和其余位置的修正推向目标，每次运行走一个增量。 |

可叠加规则按优先级顺序执行。互斥的类型（分时段、黑名单、默认出价、每日预算）每个广告只保留一条规则，而直接同类规则中，已分配的规则会覆盖继承来的规则。

安全模型

1. 预览不写入任何内容。 每个操作都会显示改动前 → 改动后的值，以及背后的计算过程。
2. 应用操作必须带上 confirm: true —— 界面和智能体工具执行同样的校验，因此助手无法应用你尚未批准的计划。
3. 每个已应用的操作都会记录，并附上完整的 Amazon 请求体。
4. 回滚会恢复改动前的值，最新的优先，回滚本身也会被审计。
5. 沙箱账户绝不接触 Amazon。

安装

从 DSH 插件市场安装（推荐）。 仓库带有 dsh-plugin 主题标签，因此会被自动索引，并出现在市场的 Discover 标签页中：

Settings → Plugins → Discover → search "Scale Commander" → Install

市场会克隆仓库，在 package/ 内运行 npm run build（构建不需要预先安装依赖 —— esbuild 以二进制方式调用），并注册 bundle 补丁。之后重启 DeepSeek Harness。

从本地检出安装，使用插件管理器工具：

plugin_manager action=install_bundle target=<absolute path>/package

配置位于 bundle 行中。包名现在是 dsh-scale-commander（不带 scope，因此不会在 npm 上冲突）：

- insert:
- id: scale-commander
name: 'dsh-scale-commander'
config:
dataDir: '' # defaults to <DSH_HOME>/scale-commander
schedulerEnabled: true
schedulerTickSeconds: 60
requestTimeoutMs: 45000

需要 Node 22.5+ 才能使用 node:sqlite。没有原生模块，也没有安装脚本。

安装后请重启 DeepSeek Harness。 浏览器端由 clientModules 服务加载，该服务会缓存每个包的扫描结果，直到进程结束；新安装的包只会在下次启动时被识别。Host 端 —— 引擎、调度器、HTTP API、智能体工具、数据库 —— 会立即生效。

隐私

这个插件会向 Amazon 发送广告数据，因为它自动化的正是这件事。它不联系任何其他方。端点和凭据处理方式在 package.json 的 disclosure 字段中声明，因此市场卡片会在你安装前展示它们：

| 网络 | advertising-api.amazon.com 及其 EU/FE 镜像，外加 api.amazon.com/auth/o2/token 用于 token 交换 |
| 离线模式 | 支持 —— 沙箱账户在本地生成数据，不联系任何方 |
| 凭据 | Amazon LWA client id、client secret、refresh token；以 AES-256-GCM 加密后存放在 0600 文件中，挂载时同步到 Harness 凭据服务，绝不返回给浏览器，绝不写入日志 |
| 静态数据 | SQLite 加上加密的附属文件，都位于插件数据目录内 |
| 保留 | 仅本地；不向第三方服务器发送任何内容 |

快速开始

1. Accounts → Add account → Sandbox。 无需凭据；它会生成约 120 天
1. 从预设中创建战略目标（Bulk Auto、Sales Exact、Ranking Exact……），再把它指派给几个广告活动。
2. 同步，然后从预设中创建战略目标（Bulk Auto、Sales Exact、Ranking Exact……），并把它指派给几个广告活动。
3. 打开预览 —— 每个操作都附带计算过程 —— 然后应用。
4. 查看变更日志，回滚一次运行，看改动前的值是否恢复。

接入真实账户：创建 Login with Amazon 应用，为你的广告配置档授权，然后把 client id、client secret 和 refresh token 粘贴到凭证对话框。这些凭证在存储时用 AES-256-GCM 加密，绝不会返回给浏览器。

智能体工具

共注册 12 个工具，同一配置档下的助手可以用对话方式操作账户 —— scale_commander_accounts、_overview、_preview、_apply、_rollback、_runs、_rules、_create_rule、_assign、_insights、_audit、_sync。每个工具调用的服务方法，和浏览器调用的是同一个。

开发

node scripts/build.mjs # bundle both halves
node scripts/test.mjs # 62 assertions in 3 suites + 22 end-to-end checks

文档

- 用户指南 —— 走遍全部 14 个界面
- 架构 —— 设计决策及其理由
- 验收 —— 每条需求，以及验证它的命令

许可证

MIT

Scale Commander 是一个生产级的 DeepSeek Harness 插件，用于亚马逊广告投放。它实现了专业 PPC 工具应有的完整操作面：11 种可叠加算法、可复用的条件配置档、带小时竞价系数的分时策略、否词与白名单管理、关键词收割、批量广告创建、预算与广告位规则、销售归因，以及一套预览 → 应用 → 回滚流程，记录它做出的每一次改动。

它对接真实的 Amazon Advertising API，并附带一个沙箱服务商，在本地生成一个逼真的账户 —— 因此每条工作流都可以在没有凭证的情况下被完整演练和验证。

为什么做这个

PPC 自动化工具有一个普通软件没有的硬性要求：给人审阅的计划，必须和执行的计划完全一致。 Scale Commander 用同一次纯函数评估 pass 同时计算预览计划和执行计划来保证这一点。预览不会与执行产生偏差，审计流水里也永远不会出现审阅者没看过的操作。

11 种算法

每种算法都是作用于已聚合指标的纯函数，每个建议操作都附带一步步的计算过程。

| 算法 | 作用 |
| Bidding 竞价 | 按文档所述的最优出价公式，以受控步长把关键词和商品投放出价推向目标 ACOS。 |
| Dayparting 分时 | 按小时开关广告组，并按小时应用竞价系数；"最优时段"模式从实际小时表现推导计划。 |
| Import 收割 | 把有转化的搜索词导入为新关键词或商品投放，初始出价取其平均 CPC 的百分比。 |
| Negative 否词 | 把满足条件的搜索词加为否定精准或否定词组。 |
| Negative word 否词-词根 | 把搜索词拆成单词、聚合表现，把无效单词加为否定词组。 |
| Blacklist / whitelist 黑/白名单 | 把维护的无关词列表强制转为否定，并保护白名单词不被否定。 |
| Revive 复活 | 对曾经有效、现在没有流量的"死词"提价，直到流量恢复。 |
| Default bid 默认出价 | 为传统自动广告优化广告组默认出价。 |
| Status 状态 | 按表现暂停或启用广告活动和广告组。 |
| Daily budget 日预算 | 先乘基线，再乘星期系数，然后依次应用每个满足的条件。 |
| Placement 广告位 | 把搜索顶部、商品页、搜索其他的修饰符推向目标，每次运行只走一档增量。 |

可叠加算法按优先级依次执行；互斥类型（分时、黑白名单、默认出价、日预算）每个广告只保留一条规则，直接指派的规则会覆盖继承来的同类型规则。

安全模型

1. 预览不写任何数据。 每个操作都展示改动前后的值和背后的计算。
2. 应用必须传 confirm: true —— UI 和智能体工具执行同一条规则，所以助手无法应用你没批准的计划。
3. 每个已应用的操作都被记录，连同发给 Amazon 的确切请求体。
4. 回滚从最新开始恢复改动前的值，并且回滚本身也进审计。
5. 沙箱账户绝不触碰 Amazon。

安装

从 DSH 插件市场安装（推荐）。 仓库已打上 dsh-plugin topic，会被市场自动收录，出现在 Discover 标签页里：

Settings → Plugins → Discover → 搜索 "Scale Commander" → Install 市场会克隆仓库、在 package/ 内执行 npm run build（构建不依赖任何已安装包 —— esbuild 以二进制方式调用），然后注册 bundle patch。之后重启 DeepSeek Harness。

从本地检出安装，用插件管理器工具：

plugin_manager action=install_bundle target=<绝对路径>/package

配置写在 bundle 行里。包名已改为 dsh-scale-commander（不带 scope，避免 npm 撞名）：

- insert:
- id: scale-commander
name: 'dsh-scale-commander'
config:
dataDir: '' # 默认 <DSH_HOME>/scale-commander schedulerEnabled: true schedulerTickSeconds: 60 requestTimeoutMs: 45000

需要 Node 22.5+（使用内置 node:sqlite）。无原生模块，无安装脚本。

安装后请重启 DeepSeek Harness。 浏览器端由 clientModules 服务加载，它把每个包的扫描结果缓存到进程生命周期；新装的包要到下次启动才会被发现。而 Host 端 —— 引擎、调度器、HTTP API、智能体工具、数据库 —— 立即生效。

隐私

这个插件会把广告数据发到 Amazon，因为它自动化的就是这件事。除此之外它不联系任何端点。网络端点和凭据处理方式都声明在 package.json 的 disclosure 字段里，安装前就能在市场卡片上看到：

| 网络 | advertising-api.amazon.com 及其 EU/FE 镜像，加 api.amazon.com/auth/o2/token 用于令牌交换 |
| 离线模式 | 支持 —— 沙箱账户本地生成数据，不联系任何端点 |
| 凭据 | Amazon LWA 的 client id、client secret、refresh token；以 AES-256-GCM 加密存放在 0600 文件里，同时镜像到 Harness 凭据服务（若已挂载），永不返回浏览器，永不写日志 |
| 落地数据 | SQLite 加加密边车文件，都在插件数据目录内 |
| 保留策略 | 仅本地；不上传任何第三方服务器 |

快速上手

1. Accounts → Add account → Sandbox。 不需要凭证，它会生成约 120 天的真实广告活动、关键词、投放、搜索词和小时数据。
2. Sync，然后从一个预设创建战略目标（Bulk Auto、Sales Exact、Ranking Exact……），指派给几个广告活动。
3. 打开 Preview —— 每个操作连计算过程一起看 —— 然后 Apply。
4. 看 Change log，回滚一次运行，看改动前的值回来。

接入真实账户：创建一个 Login with Amazon 应用，为你的广告 profile 授权，然后把 client id、client secret、refresh token 粘进 Credentials 对话框。它们以 AES-256-GCM 加密存储，永不返回浏览器。

智能体工具

注册了 12 个工具，同一 profile 里的助手可以对话式地操作账户 —— scale_commander_accounts、_overview、_preview、_apply、_rollback、_runs、_rules、_create_rule、_assign、_insights、_audit、_sync。每个工具调用的都是浏览器调用的同一个服务方法。

开发

node scripts/build.mjs # 打包双端
node scripts/test.mjs # 3 个套件 62 条断言 + 22 项端到端检查

文档

- 用户指南 —— 14 个界面逐一走查
- 架构 —— 设计决策及理由
- 验收 —— 每项需求配一条可复现的验证命令

许可

MIT