DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

gx18391303625-afk /

gx18391303625-afk/xander-zaozao-xiaban

Verified

Xander(自用)早早下班小助手

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@1c2aa72e

Xander(自用)早早下班小助手

给亚马逊个人卖家用的本地运营插件 · 支持 Claude、Codex(GPT)和 DeepSeek Harness(DSH)
让日常运营更轻松,把时间还给生活。


这是什么

装进 Claude Code、Codex 或 DSH 之后,你可以直接用中文交代亚马逊的日常活。DSH 从 v2.5.1 起支持原生接入;固定版本安装、只读验收与市场收录说明见 DSH 接入指南:

“分析我最近 7 天的销售、广告、库存和利润,最需要关注什么?” “这几个竞品和我比,差在哪?” “帮我把这个 SKU 的五点重写一下。” “按现在的销量和交期,每个颜色要补多少箱?” “这几个关键词的竞价降 15%,那个没出单的词加否定。”

它包含 1 个总协调 + 6 个运营模块。选品已冻结,之后会作为独立插件发布;没有选品数据时各模块照常工作,不会因为缺选品 ID 卡住。

模块 能做的事
竞品分析 锁定对标、拆解页面与买家反馈、对比同词表现,给出有证据的突破口
关键词词库 采集、去重、分类、前台验证,交接给 Listing
Listing 按产品事实写/改/审标题、Item Highlights 亮点、五点、描述、后台词,带合规审计
广告 盈亏线核算、新品/老品分开诊断、调竞价/预算/开停/否词
补货 续航、断货日、情景补货量、整箱与 MOQ
利润 日常预估、期间复盘、结算对账,缺项不硬凑

和别的工具不一样的地方

  • 凭证和档案本地保存。 店铺和广告凭证由本机凭证后端保存(macOS 钥匙串 / Windows DPAPI 等),配置和档案留在本地。授权与业务请求会访问你选择的接口,进入对话的数据也会按宿主所选模型传输;启用云备份后加密档案会传到你自己的 S3,不承诺“数据完全不出电脑”。
  • 写入像开灯。 每一类改动(改竞价、改预算、改标题、改价……)都有一个开关,默认全部关闭。你在本地开关面板里自己点开,支持一键全开/全关;紫鸟浏览器控制是单独的开关。AI 只能看开关,不能拨开关。
  • 每次改动都要你批准。 AI 先生成精确提案(改哪个对象、原值多少、新值多少、为什么),你说“批准”才执行,只执行一次,执行后自动回读核对。断网超时不会重复提交。
  • 有安全上限。 竞价、预算、售价单次改动超过你设的幅度(默认 ±50% / ±100% / ±20%),直接拒绝。
  • 会记事。 店铺档案库记住后台没有的东西:采购价、头程、箱规、交期、认证、过往决策。改价保留历史,利润按当期成本算。
  • 不硬凑数字。 缺的就是缺,不当 0;第三方估算和模拟结果都会标出来。
  • 诊断能接着复盘。 把六模块已有证据整理成单 SKU/ASIN 诊断,列出最多三项优先待办和暂不动原因;保存行动假设、支出/损失边界与追加复盘。门禁通过只代表可人工复核,不代表授权、已执行或已证明收益。

快速开始(约 20 分钟)

1. 准备 Node.js:需要 22.13 或更高。Claude / Codex 或用户终端命令可到 https://nodejs.org 下载 LTS 版;DSH Desktop 原生插件可使用其自带 Node 运行时,详见 DSH 接入指南。

2. 装插件

  • Claude Code:
    /plugin marketplace add gx18391303625-afk/xander-zaozao-xiaban
    /plugin install xander-zaozao-xiaban@xander-zaozao
    
  • Codex:
    codex plugin marketplace add gx18391303625-afk/xander-zaozao-xiaban
    
    然后在 ChatGPT 桌面版的“插件”目录里安装。找不到的话见 手动安装。
  • DSH Desktop(^0.2.1-rc.5):在插件管理器的“来源”输入框填固定版本来源,由插件管理器安装,不手工改 profile:
    github:gx18391303625-afk/xander-zaozao-xiaban#v2.5.1
    
    也可用 GitHub Release 安装包或本地仓库绝对目录。DSH 使用原生 xander_* 工具,不另启 Xander MCP 子进程。安装、只读验收、重复旧 MCP 的确认后停用和市场收录说明见 DSH 接入指南。GitHub 发布不等于已获市场审核通过。

3. 接入店铺:下载本仓库(或在插件目录里),由你本人在自己的终端运行;密钥和令牌只在 xander setup 输入,不贴进聊天:

npm link            # 让 xander 命令可用(只需一次)
xander setup        # 接入向导:店铺、广告、卖家精灵、云备份、紫鸟
xander doctor       # 体检:逐项测试是否接通

不会的地方直接问 AI:“带我接入店铺”。详细图文见 新手接入教程。xander setup 和 xander doctor 会实际测试所选连接,不属于 DSH 的最小只读验收;如果只验证安装,请按 DSH 接入指南 操作。

4. 打开开关面板:

xander panel

安装不会自动打开写入权限。只做 DSH 安装验收时不需要开任何开关;正式使用的首次演练由你自行决定,建议先打开“演练模式”,再开一个低风险开关(比如“新增否定关键词”)把完整流程走一遍。

2.5 经营诊断与行动复盘

可以直接说:“诊断这个 ASIN:现在最值得做哪三件事、哪件暂时别动?把依据和复盘计划记下来。”

AI先由相关模块取证,再检查范围、分页、样本归因、经济性和库存现金;不要求用户手填大表,不按上架月龄自动放量。2点击1单不能因转化率高而建议扩量,也不能借另一活动的样本通过门禁。诊断快照不可覆盖,实验绑定具体动作,复盘分清平台回读和描述式经营效果。

开关面板新增只读摘要;原有精确提案、逐份批准、执行一次与独立回读不变。不会自动监控、停投、恢复基准或开开关。范围、六个工具和升级限制见 2.5 功能说明。已运行的MCP需在宿主重新连接;GitHub仓库更新不会自动替换所有宿主缓存,使用缓存安装时仍需更新对应安装。

写入开关一览

分组 开关
SP 商品推广 新建活动/广告组/商品(默认暂停)、竞价策略/广告位加价、活动开/停、活动日预算、广告组开/停、广告组默认竞价、投放竞价(关键词/商品/自动)、投放开/停、广告商品开/停、新增关键词、新增否定关键词(广告组级/活动级)
SB 品牌推广 活动开/停、活动日预算、投放竞价、投放开/停
SD 展示型(Beta) 活动开/停、活动预算、投放竞价、投放开/停
Listing 标题/Item Highlights 亮点/五点/描述/后台词、售价、自发货库存、主图/附图贡献更新(实时 PTD + 预校验)
预算与投资组合 SP 预算规则创建/编辑/关联/解除;投资组合创建/编辑、SP 活动归属
A+ 内容创建/编辑、完整 ASIN 集关联、校验和提交审核,审核与发布分开核验
优惠券/促销 本地准备与校验、网页交接、官方只读状态查询;暂无官方写接口
紫鸟浏览器 代为点击/填写(单独开关,不跟随一键全开)
FBA 物流(Beta) 美国站先装箱入仓:计划、装箱、分仓、运输报价/确认、到仓窗口、跟踪号、箱唛/提单(单独开关,不跟随一键全开)

六项新增能力的范围、输入示例、资格和状态含义见 2.3 功能使用说明。所有新增开关默认关闭;升级不会改动店铺设置、密钥或档案库。

美国 SP 活动名称可通过独立的“修改广告活动名称”开关修改;只提交名称字段,保留暂停状态、预算及竞价。参数和审批流程见 活动改名。

Item Highlights 使用 Amazon 属性 title_differentiation,可独立读取,并按目标站点、商品类型和语言准备改动;真实 PTD 与 VALIDATION_PREVIEW 通过后仍须批准,演练不正式提交。字段映射与完整流程见 Listing 文案属性。

FBA 的接入权限、每一步审批、费用确认和所需资料见 FBA 入仓流程。创建入仓计划不等于货已发出;合作承运报价确认可能产生费用。

归档、删除这类不可恢复的操作故意不提供。

接口版本与已核实范围(2026-10-23)

用途 接口 说明
广告管理 SP/SB Amazon Ads API v1 统一接口(/adsApi/v1/...) 官方正式版,替代 SP v3 / SB v4
SP 预算规则 / 投资组合 专用 /sp/budgetRules / Portfolios v3 未强行套用统一活动接口;支持范围见使用说明
A+ / 优惠券促销 A+ v2020-11-01 / Promotions v2025-12-01 A+ 可提交审核;Promotions 仅公开 GET 查询,创建必须网页交接
广告管理 SD SD 原接口(/sd/...) 官方尚未发布 SD 统一接口迁移资料,发布后跟进
广告报表 Reporting API v1(/adsApi/v1/create|retrieve/reports) 官方仍为测试版;搜索词、投放、推广商品三类报表的 v1 字段未公开,暂自动用 v3(2027-06-30 关停),并在结果里注明
订单 Orders v2026-01-01 v0 已弃用(2027-03-27 下线),插件拒绝调用
财务 Finances v2024-06-19 v0 已弃用(2027-08-27 下线),插件拒绝调用
FBA 入库 Fulfillment Inbound v2024-03-20 主要流程用新版;箱唛/提单仍使用有效的 v0 专用端点,须审批
Listing / 目录 / 报表 / 库存 Listings 2021-08-01、Catalog 2022-04-01、Reports 2021-06-30、FBA Inventory v1 均为当前最新版

已弃用的旧接口和报表类型(如旧版结算报表 GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE)插件会直接拒绝,并告诉 AI 应该改用哪个新接口。

常用命令

xander setup                  接入向导
xander doctor                 体检
xander panel                  开关面板
xander switch list            终端查看开关
xander archive list | show <店铺> [SKU] | import <店铺> <成本表.csv> | export <店铺>
xander sync push | pull       加密备份到你自己的 S3 / 恢复
xander log                    写入日志
xander install                只显示 Claude / Codex / DSH 安装方法,不执行安装

成本表模板:examples/成本表模板.csv

数据放在哪

默认在 ~/.xander-zaozao/(可用环境变量 XANDER_HOME 改):

config.json       店铺别名、区域、站点、广告 profile、设置(不含密钥)
switches.json     开关状态和安全上限
archive.db        店铺档案、诊断快照、行动/实验与追加复盘(SQLite,独立表)
proposals/        每一份改动提案
ledger.jsonl      写入日志
reports/          下载的报表

能在哪些地方用

宿主 技能 工具(读数据/写入)
Claude Code ✅ 插件自动加载 ✅
Codex CLI / ChatGPT 桌面版 ✅ ✅
DSH(^0.2.1-rc.5) 官方 filesystem provider 注册 7 个包内技能,不写用户技能目录 原生 xander_*,无额外 MCP 子进程;固定版本安装与验收,市场收录另行审核
Claude 桌面版 手动上传技能 ✅ 手动配置
网页版 ChatGPT / claude.ai ❌ ❌ 连不到你电脑上的本地服务;本地插件不代表业务数据不会按接口或模型传输

安全说明(请读一下)

  • 开关挡的是“误操作”和“没想清楚就执行”,不能挡一个被恶意指令劫持的 AI 去改你电脑上的文件。所以:别让 AI 读来路不明的文件或网页后直接执行改动;改动前认真看提案;不用的开关及时关掉。
  • 如果你在聊天里贴过密钥,请到对应后台重新生成。接入凭证只由你本人在自己的终端运行 xander setup 输入,不放进聊天、工具参数或插件公开配置。
  • DSH 停止或工具超时不能撤回已经提交的 Amazon 请求,不自动重试;结果未知时保留 proposalId,先核验原提案状态和平台回读,不把取消当成“未执行”。
  • 紫鸟控制是模拟人工点击,页面改版就可能失败,属于高风险能力,默认关闭。
  • 本工具不构成财务、法律或合规建议;所有改动的最终决定权在你。

已知限制与待验证

  • DSH 适配已覆盖本地加载、只读配置查询和合成计算验收,仍未完成真店读写验证。GitHub 发行、市场目录收录和官方 Discover 索引是不同步骤,不能把安装成功或收录 PR 当成已经上架;见 DSH 接入指南。
  • 新增业务写入用官方合约和合成接口测试,没有对真实账户创建广告、修改图片、提交 A+ 或创建优惠券。成功读取账户不证明具备全部写权限或商品资格。SD 写入标为 Beta,第一次用建议先开演练模式。
  • Reporting API v1 官方仍是测试版,返回格式可能变化;遇到“已完成但没有下载地址”这类提示,请提 Issue。
  • 搜索词 / 投放 / 推广商品报表暂用 v3,2027-06-30 前需要换成 v1(等官方公开字段名)。
  • 紫鸟 WebDriver 的接口参数以紫鸟官方文档为准,不同版本可能不同。
  • 卖家精灵 MCP 由你自己在宿主里连接,本插件不经手。

开发

零依赖,只用 Node 自带功能(内置 SQLite、fetch、WebSocket)。

npm test          # 契约、故障恢复、审批和端到端模拟测试:v1 统一接口写入全流程、v1/v3 报表、旧接口拦截、故障保护、计算器、档案库、面板安全、MCP 协议、S3 签名

技能里的 Python 脚本(竞品评分、广告经济、Listing 校验等)各自带回归测试:python3 skills/<技能>/scripts/run_regression_tests.py。

竞品研究可按需运行证据检查,核对评论去重/变体、报价资格/单位和事件时间线。检查器只验证已提供记录,不替代来源核实或业务决策。

创作初衷

第一 ☝️ 我期望能解放所有基本运营岗位,或服务给小卖家; 第二 ✌️ 这个运营助手因本人不懂代码,全靠和 AI 打嘴炮、真金白银磨出来的,好不好用还请见谅; 第三 🥉 希望能帮助大家减轻日常运营负担,每天早点下班,找回真正属于自己的生活; 第四 勒克莱尔 🏎️

许可

MIT。本项目与亚马逊、卖家精灵、紫鸟无任何关联。

—/ 5

No ratings yet

Verified DSH bundle

Commit 1c2aa72e8841

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout