Retail Reason Intelligence

Retail Reason 客户端分发

Retail Reason 是一项托管专家服务，面向在 Walmart 供应商和卖家平台上开展业务的人士：Walmart 供应商、Sam's Club 供应商、Marketplace 卖家，以及为他们提供服务的顾问和代理机构。它可以解答有关指标定义、页面路径、阈值和争议处理渠道的运营问题。它会检查待发布内容中的潜在问题，并在每个答案中返回 as_of 验证日期。 带日期的答案并不意味着能立即检测到每一项变更。

本仓库仅包含轻量客户端：Claude Code 和 Cowork 插件、Codex CLI 配置，以及公开的能力地图。所有专业知识都通过经过身份验证的 MCP 连接，由托管服务提供；Claude Code 和 Codex 需要绑定到用户的访问密钥（wadv_live_...）。所有受支持客户端的最新维护版设置说明均位于 https://retailreason.com/docs/connect/；本 README 与其保持一致。密钥绑定到一个指定用户和 Retail Reason 账户。请勿共享密钥。每位指定用户最多可同时启用两个密钥，以便在轮换时重叠使用；每个密钥的有效期最长为 180 天，用户或账户所有者/管理员也可以提前撤销。

Retail Reason 是一款独立产品，与 Walmart Inc. 无关联、未获其认可，也不是其产品；下文仅使用“Walmart”及平台名称来说明这项服务的适用对象和覆盖范围。

安装：Claude Code

1. 添加市场：

   /plugin marketplace add https://github.com/RetailReason/retail-reason-plugins
   

2. 安装插件：

   /plugin install retail-reason@retail-reason
   

   （retail-reason 同时是插件和市场标识符。2026 年 9 月 6 日之前安装的版本使用 walmart-advisor@walmart-advisory；请使用 /plugin marketplace remove walmart-advisory 移除此市场，然后按上述步骤添加并安装。）

3. 出现提示时，输入在你的 Retail Reason 账户中创建的 Retail Reason 访问密钥（wadv_live_...），账户地址为 https://app.retailreason.com/app/access。需要符合条件且已开通访问权限的账户；本仓库无法签发密钥。服务地址已包含在插件中，无需输入服务器地址。

4. 重启 Claude Code，并提出任意 Walmart 供应商/卖家问题，以确认其正常工作。

**如果密钥在重启后停止工作：**密钥存储在操作系统钥匙串中，偶尔可能会丢失。请在插件设置中重新输入（/plugin → Retail Reason → configure）。如果问题持续发生，请使用环境变量备用方案：在 shell 配置文件中设置 export WADV_LICENSE_KEY="wadv_live_..."，并编辑已安装插件的 .mcp.json，使其读取 "Authorization": "Bearer ${WADV_LICENSE_KEY}"。Claude Code 会在 MCP 请求头中展开环境变量。

安装：Claude Cowork

1. 在 Claude 中，打开 Customize → Plugins → Add → Add marketplace，然后选择 Add from a repository。 选择 RetailReason/retail-reason-plugins，或输入 https://github.com/RetailReason/retail-reason-plugins，然后同步市场。
2. 添加 Retail Reason，并打开其 Connectors 选项卡。为 retail-reason 选择 Connect。 服务器地址为 https://mcp.retailreason.com/mcp。
3. 选择 Sign in now 和 Use Claude's published identity。添加连接器，然后如果登录未自动打开，请选择 Connect。使用与你已开通访问权限的 Retail Reason 会员身份相同的身份登录。
4. 开始新的 Cowork 任务，并使用 Retail Reason 提出供应商或卖家问题。确认 Retail Reason 工具会返回答案及其 as_of 验证日期。

Cowork 使用账户登录。请勿将 Claude Code 访问密钥作为请求头或在聊天中输入。 如果授权失败，请将显示的支持参考编号发送给 [email protected]。 插件的 Skills 选项卡应列出 setup 和 walmart-advisor。

安装：Codex CLI

请参阅 codex/README.md：导出 WADV_LICENSE_KEY，将 codex/config-snippet.toml 粘贴到 ~/.codex/config.toml 中，并 可选安装 Codex 精简技能插件。

托管式和命令行客户端

发布时支持：Claude 托管式服务、Claude Code 和 Codex CLI。Claude 托管式服务通过 Retail Reason 基于 WorkOS 的 OAuth 流程连接，该流程从账户应用启动； 它不使用上面的 CLI 密钥。请按照账户内的连接说明操作，切勿将 wadv_live_... 密钥粘贴到 Claude 托管式服务中。

ChatGPT 即将推出，发布时暂不支持。它仍处于禁用状态，使用受支持的发布路径无需 ChatGPT 订阅或管理员设置。本仓库不会凭空编造 ChatGPT 连接器 URL，也不会暗示该路径已经上线。

密钥和工作区管理

• 为每位具名用户创建单独的密钥；切勿让其他人重复使用所有者、顾问或客户访客的密钥。
• 用户可以同时拥有两个有效密钥，以便在轮换期间重叠使用。创建替换密钥， 更新 Claude Code/Codex，并验证后，再撤销旧密钥。密钥最多在 180 天后过期，即使未手动轮换也不例外。
• 用户可以撤销自己的密钥。账户所有者/管理员可以撤销其账户中的任何密钥。 如果密钥被复制、泄露或丢失，应首先撤销密钥。
• 运营人员账户通常只有一个工作区。拥有多个可用客户工作区的顾问用户需为每次对话选择工作区；客户端会在每次涉及工作区的调用中传递 workspace_id，包括 get_capabilities、问题查询和陷阱检查。客户访客只能使用顾问实践或顾问网络账户分配给他们的一个工作区。

能力映射（capabilities/capabilities.json）

此文件是对服务覆盖范围进行整理后的公开说明。没有客户端会读取它。 托管服务会摄取此文件，而 get_capabilities 工具会为拥有有效访问权限的账户呈现相同的四个主题领域。工作区经验证的 Scintilla 层级会影响哪些指导适用于该工作区；但不会移除任何商业主题领域。响应内容如下：

• 合并并重新命名。 文件内部使用以下键名（supplier_academy、 scintilla_basic、scintilla_charter、marketplace、supplier_one）；答案则归入四个展示区域：Walmart 供应商基础知识、Scintilla / Walmart 数据、 Walmart Marketplace、Supplier One。两个 Scintilla 源集合会合并到一个 Scintilla 区域，主题和示例问题会合并并去重。

只有在服务重新摄取语料库后，编辑此文件才会改变用户看到的内容； 重新安装插件不会产生任何影响。请确保条目以结果为导向：下方的防泄露检查无法拦截反映内部结构的主题列表。

支持

请发送邮件至 [email protected] 联系支持。该邮箱由运营人员直接监控并回复。（Startup Success Lab LLC 是 Retail Reason 背后的实体。）请注明组织名称以及问题大致发生时间；切勿包含访问密钥。

贡献 / 维护者

提交前，请运行以下检查。这些检查必须全部通过：

./scripts/leak-check.sh
./scripts/brand-check.sh
node scripts/claude-plugin-check.mjs

干净克隆的 CI 会验证所有已发布的 JSON 文件，并在每个拉取请求中运行一次品牌和静态泄露检查。与 main 的逐字节相同合并不会重新运行这些检查。由于公共 CI 检出环境无法读取 私有语料库仓库，因此发布仍要求针对准确的语料库源代码检出，单独记录一次成功的 leak-check.sh --strict 运行。

leak-check.sh：绝不能发布的内容

它会扫描此仓库中的每个文件，查找绝不能公开发布的字符串。请将它配置为 提交前钩子。脚本会通过符号链接解析其实际位置。无论是发现泄漏，还是检查未能运行， 只要退出码非零，就会阻止提交：

ln -s ../../scripts/leak-check.sh .git/hooks/pre-commit

两种模式：

• 默认模式：如果机器上没有私有语料库仓库，则跳过内部名称 禁用列表，并显示提示，但仍会运行静态检查。这是贡献者 模式：大多数机器确实没有语料库仓库。
• --strict：除非禁用列表确实是根据语料库仓库生成的，否则 检查失败（退出码为 2）。在有语料库检出目录的环境中使用（Matt 的机器、发布检查）： WADV_CORPUS_REPO=path/to/corpus-repo ./scripts/leak-check.sh --strict。如果未设置环境变量， 脚本会自动检测布局符合预期的同级目录。

此检查只匹配字面字符串。它无法捕获结构性泄漏：措辞结构与私有技能分类体系一一对应的 文案。SKILL.md 中的触发语句和工具描述必须保持宽泛并以结果为导向；这一部分需要人工审查。

brand-check.sh：告知买家的产品名称

这里的每个文件都是买家会阅读的内容。产品更名为 Retail Reason 后，服务端 （serverInfo.name、/healthz）已完成更名，却一直未同步到此仓库，因此有一段时间，安装 路径展示的产品名称并非客户实际付费购买的产品。brand-check.sh 会在已停用的名称重新出现、 面向买家的内容不再提及 Retail Reason、安装说明将已发布的生产端点描述为本地开发 占位符，或尚未替换的客户可见占位符仍然存在时失败。

它有意不检查机器标识符。市场和插件 ID （retail-reason）、技能目录（walmart-advisor）、MCP 服务 键、wadv_live_ 键前缀和 WADV_LICENSE_KEY 都是由后端的 test/distribution.test.ts 固定的线上值；MCP 工具名称（ask_walmart、 check_walmart_pitfalls，……）则是协议约定。更改其中任何一项都需要协调修改两个仓库，并会导致现有安装失效。这绝不能作为文案编辑的附带结果发生。

此检查所规定的命名规则：产品名称是 Retail Reason；只有在说明服务面向谁（“面向 Walmart 供应商”）时才提及 Walmart。标题或清单展示字段中的产品名称不得包含 Walmart。

端点

插件预先配置了此 MCP 端点：

https://mcp.retailreason.com/mcp

此端点使用独立于账户／账单 API 的主机。访问仍需拥有符合条件且权限有效的账户，并使用与用户绑定的密钥连接 Claude Code 和 Codex。 请按照上方当前的连接指南为你的客户端和账户进行配置。

使用独立本地后端的开发者，可以在本地 Claude Code 或 Codex MCP 配置中将 URL 编辑为 http://localhost:8787/mcp。请使用为该环境签发的凭据。

许可证

此仓库中的文件根据 MIT 许可证发布。托管的 Retail Reason 服务、其知识语料和回答不属于此仓库的内容，并受 Retail Reason 条款 https://retailreason.com/terms/约束。