安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install pdd-update-price
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 pdd-update-price。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

拼多多 SKU 价格管理器是一款 Openclaw Skills 工具，可通过已登录的 Chrome 会话更改拼多多店铺中 SKU 级别的价格。它支持价格调整、目标价格和单个 SKU 变更，并通过平台的提交流程应用更新。
其安全优先的工作流程默认采用 dry-run，因此你可以在进行变更前检查每项从当前价格到目标价格的方案。执行需要明确确认，超过 30% 防护阈值的变更默认会被阻止，并且每次价格更新都会记录下来，以供审计和回滚。

应用场景

在应用前预览所有 SKU 的拟议涨价或降价。
为商品设置多件和单件目标价格。
仅在需要更新选定款式时更改单个 SKU 的价格。
在平台传播延迟后，验证已提交的价格变更是否生效。
如果最近的价格更新有误，则还原该更新。
如果用户提供了商品但未指定目标价格或调整金额，则检查拟议的变更范围。

工作原理

确认用户明确要求更改价格，并提供了商品以及目标价格或调整幅度。缺少信息时应询问，而不是猜测。
通过 Chrome DevTools Protocol (CDP) 端口连接 Chrome 中现有的、已登录的拼多多商家页面；默认端口为 9222。
运行脚本时不加 --execute，以生成显示当前价格和拟议目标价格的 dry-run 方案。此操作不会更改价格。
将方案提供给用户审核。只有在获得明确确认后，才使用 --execute 重新运行命令。
脚本通过平台的价格调整提交流程提交更新，并将变更记录到审计日志中。超过配置限制的变更会被阻止，除非获得明确授权。
轮询平台以验证最终价格。更新可能需要 3–15 秒才会生效；如果验证仍在等待中，应报告该状态，并稍后重新读取，不要再次执行变更。
如需回滚，先预览还原操作，并且只有在确认后才使用 --revert --execute。

配置指南

前置条件
Python 3，可通过 python3、python 或 py 使用。
Python 套件 requests 和 websocket-client。
Chrome 已登录 mms.pinduoduo.com，并启用 CDP。默认 CDP 端口为 9222。
技能中的 scripts/update_price.py 文件。请将下方的 {baseDir} 替换为已安装的技能目录。
配置审计日志（可选）
默认情况下，审计日志写入 ~/.pdd-data/price_audit.jsonl。设置 PDD_AUDIT_PATH 可使用其他路径。
export PDD_AUDIT_PATH="$HOME/.pdd-data/price_audit.jsonl"
先预览，再执行
务必先运行预览。只有在用户审核并确认方案后才执行。
python3 {baseDir}/scripts/update_price.py --goods --delta +0.5
python3 {baseDir}/scripts/update_price.py --goods --delta +0.5 --execute
其他支持的命令

为所有 SKU 设置多件和单件价格

python3 {baseDir}/scripts/update_price.py --goods --set 499:500 --execute

为指定 SKU 设置价格

python3 {baseDir}/scripts/update_price.py --goods --sku :499.5:500.5 --execute

还原最近一次价格变更；执行前请确认

python3 {baseDir}/scripts/update_price.py --goods --revert
python3 {baseDir}/scripts/update_price.py --goods --revert --execute
可选标志包括用于选择 CDP 端口的 --port 9222，以及用于设置变更阈值的 --max-change-pct 30。--force 会绕过防护机制，未经用户明确授权不得使用。

数据架构

价格输入项
输入项 用途 --goods 标识拼多多商品。 --delta 对该商品的 SKU 批量应用价格调整。 --set : 为所有 SKU 设置多件和单件价格，单位为元。 --sku :: 指定单个 SKU 的目标价格。 平台请求使用 goods_id、market_price 和 sku_prices 集合。每个 SKU 价格条目包含 sku_id、multi_price（多件价格）和 single_price（单件价格）；平台值以分和元表示。请求还使用 need_delete_goods_commit: true，并返回 goods_commit_id。
文件和结果
审计日志： JSON Lines 文件，默认路径为 ~/.pdd-data/price_audit.jsonl；使用 PDD_AUDIT_PATH 可更改其位置。每次价格更新都会被记录。技能文档未指定固定的单条记录字段架构。
命令响应： 单行 JSON 结果。成功响应可能包含 ok、commit_id、verified 和 after 值。verified: false 的结果附带说明，表示提交已发出，但新价格可能尚未生效。
失败处理： 错误响应包含 action 字段，例如 notify_user 或 retry，用于指导下一步操作。

高级特性

默认 dry-run： --execute 时只生成方案，不会更改价格。
明确的执行门槛：
实际更新和回滚都必须在用户确认后使用 --execute 标志。
百分比防护机制：
默认拒绝超过 30% 的变更；只有获得明确授权后， --force 才能绕过此保护。
SKU 级控制：
可调整所有 SKU 或指定 SKU，并分别设置多件和单件价格。
提交验证：
提交后自动轮询价格变更，以应对平台通常为 3–15 秒的延迟。
审计与回滚：
将价格更新记录到本地 JSONL 审计日志，并支持还原最近一次变更。
平台感知的响应处理：
将等待验证的状态与已确认结果分开报告，并根据失败时的
action
值决定通知用户或重试。
CDP 配置：
支持使用 --port 选择 Chrome DevTools Protocol 端口。

name: pdd-update-price description: Changes Pinduoduo SKU prices with a dry-run-by-default workflow, change-ratio guardrails, audit log and one-command revert. Use only when the user explicitly asks to change prices on their PDD shop. 拼多多改价：默认只出计划不执行，显式确认才改价，带涨跌幅护栏、本机审计日志与一键回滚；仅在用户明确要求调价时使用。 homepage: https://claw-school.com