# AIOS国际站商家 AW 架构白皮书

本手册解释客户安装后得到的完整系统。客户工作区只保留运行框架，不再安装旧教材库；旧完整业务资料仅作为内部源仓/备份存在。

## 为什么需要工作目录

AW 任务必须手动选择 `国际站商家AI交付包/`。否则 AW 可能创建空目录，Agent 读不到首读文件和 Harness。

## 安装器到底安装了什么

- 9 个 Agent。
- 36 个 Skill。
- `bindings/agent-skill-map.json`：Agent 与 Skill 绑定。
- `bindings/authorization-policy.json`：授权和高风险动作锁定。
- `bindings/first-run-routing.json`：首跑 MVP 路由。
- `harness/`：运行、写回、验收策略。
- `workspaces/国际站商家AI交付包/`：最小运行工作区。

## 系统拦截与备用安装路径

### Windows 企业内网

如果 Windows EXE 被公司安全软件、终端管控、云壳、杀毒软件或微信下载路径策略拦截，不要要求客户关闭安全软件，也不要指导客户绕过公司策略。改用 `AIOS国际站商家AW安装包-Windows内网ZIP备用版-20260612.zip`。

ZIP 备用路径：

1. 右键 ZIP，选择“全部解压”。
2. 把解压后的文件夹放到桌面或文档目录，不要放在微信缓存目录。
3. 双击 `install-windows-double-click.cmd`。
4. 如果 CMD 也被拦截，再按 `manuals/Windows内网ZIP备用安装说明.md` 使用 PowerShell 或联系 IT 报备。

### macOS 安全提示

如果 macOS 提示“Apple 无法检查 App 是否包含恶意软件”或“无法验证开发者”，优先使用右键打开：右键点击安装器 App，选择“打开”，再在弹窗中确认。仍然打不开时，进入“系统设置 -> 隐私与安全性”，在安全性区域点击“仍要打开”。详细步骤见 `manuals/macOS安全打开说明.md`。

## Agent 编队

| Agent | 状态 | 绑定 Skill 数 |
| --- | --- | ---: |
| AIOS交付管家 | 默认启用 | 4 |
| 国际站运营增长专家 | 默认启用 | 4 |
| 询盘成交专家 | 默认启用 | 5 |
| 商品表达与视觉专家 | 默认启用 | 5 |
| 知识库优化师 | 默认启用 | 4 |
| 经营复盘与周报专家 | 默认启用 | 4 |
| OKKI客户经营专家 | 可选增强，默认锁定 | 4 |
| 展会获客跟进专家 | 可选增强，默认锁定 | 4 |
| 供应链与选品专家 | 可选增强，默认锁定 | 5 |

## Skill 绑定与分层

| 分层 | Skill ID | Skill 名称 | 归属 Agent | 启用说明 |
| --- | --- | --- | --- | --- |
| P0 | `aw-first-run-intake` | 首跑资料采集与MVP路由 | AIOS交付管家 | 默认启用 |
| P0 | `knowledge-base-builder` | 客户知识库搭建 | AIOS交付管家 / 知识库优化师 | 默认启用 |
| P0 | `inquiry-analysis` | 询盘分析与机会分级 | 询盘成交专家 | 默认启用 |
| P0 | `customer-background-check` | 客户只读背调 | 询盘成交专家 | 默认启用 |
| P0 | `rfq-quote-draft` | RFQ报价草稿与配置检查 | 询盘成交专家 | 默认启用 |
| P0 | `follow-up-advisor` | 跟进提醒与话术推荐 | 询盘成交专家 | 默认启用 |
| P0 | `p4p-rfq-diagnosis` | P4P与RFQ复盘诊断 | 国际站运营增长专家 | 默认启用 |
| P0 | `store-full-diagnosis` | 店铺全维度运营诊断 | 国际站运营增长专家 | 默认启用 |
| P0 | `product-title-keywords` | 爆款标题与关键词公式 | 商品表达与视觉专家 | 默认启用 |
| P0 | `main-image-detail-page` | 主图与详情页表达 | 商品表达与视觉专家 | 默认启用 |
| P0 | `multilingual-product-description` | 多语言商品描述 | 商品表达与视觉专家 | 默认启用 |
| P0 | `product-expression-p4p-keywords` | 买家需求到商品表达与P4P词包 | 商品表达与视觉专家 | 默认启用 |
| P0 | `d7-review-weekly-report` | D+7询盘会与经营周报 | 询盘成交专家 / 经营复盘与周报专家 | 默认启用 |
| P0 | `showcase-top-product-ops` | 橱窗与Top组维护 | 国际站运营增长专家 | 默认启用 |
| P0 | `monthly-store-report` | 国际站月度店铺报告 | 国际站运营增长专家 / 经营复盘与周报专家 | 默认启用 |
| P0 | `manager-ai-assistant` | 业务主管AI助理 | 经营复盘与周报专家 | 默认启用 |
| P2 | `smart-listing-draft-check` | 智能发品草稿质检 | 商品表达与视觉专家 | 默认可见，但需平台/权限确认后启用 |
| P1 | `okki-opportunity-analysis` | OKKI商机分析 | OKKI客户经营专家 | 授权增强，默认锁定 |
| P1 | `okki-team-management-analysis` | OKKI团队管理分析 | OKKI客户经营专家 | 授权增强，默认锁定 |
| P1 | `okki-leads-deep-research` | OKKI Leads重点客户深度背调 | OKKI客户经营专家 | 授权增强，默认锁定 |
| P1 | `customer-tagging` | 客户分级与标签系统 | OKKI客户经营专家 | 授权增强，默认锁定 |
| P2 | `trade-show-followup` | 展会客户跟进管家 | 展会获客跟进专家 | 专项增强，默认锁定 |
| P2 | `sample-order-tracking` | 样品单转化追踪 | 展会获客跟进专家 | 专项增强，默认锁定 |
| P2 | `edm-human-review` | EDM营销草稿与人审 | 展会获客跟进专家 | 专项增强，默认锁定 |
| P2 | `supplier-pre-screening` | 1688外贸供应商前置筛选 | 供应链与选品专家 | 专项增强，默认锁定 |
| P2 | `product-selection-strategy` | 国际站选品策略 | 供应链与选品专家 | 专项增强，默认锁定 |
| P2 | `pricing-calculator` | 商品定价策略计算器 | 供应链与选品专家 | 专项增强，默认锁定 |
| P2 | `logistics-comparison` | 物流方案比价 | 供应链与选品专家 | 专项增强，默认锁定 |
| P2 | `selection-art-workflow` | 选品美工工作流 | 供应链与选品专家 | 专项增强，默认锁定 |
| P0 | `first-run-routing` | 首跑MVP路由 | AIOS交付管家 | 默认启用 |
| P0 | `acceptance-check` | MVP验收检查 | AIOS交付管家 | 默认启用 |
| P0 | `fact-writeback-gate` | 事实写回门禁 | 知识库优化师 | 默认启用 |
| P0 | `faq-sop-extraction` | FAQ与SOP候选提炼 | 知识库优化师 | 默认启用 |
| P0 | `candidate-skill-filter` | 候选Skill筛选 | 知识库优化师 | 默认启用 |
| P0 | `business-dashboard` | 经营看板与业务罗盘 | 经营复盘与周报专家 | 默认启用 |
| P2 | `trade-show-buyer-research` | 展会买家背调 | 展会获客跟进专家 | 专项增强，默认锁定 |

## 分层规则

- P0：`default_enabled=true` 且 `lock_policy=enabled`。
- P1：OKKI/CRM 类授权增强，默认锁定。
- P2：展会、供应链、选品、EDM、物流、定价等专项增强，默认锁定。
- `smart-listing-draft-check` 默认可见，但需平台/权限确认后启用。

## LLM-Wiki

LLM-Wiki 只沉淀客户确认或文件可验证的长期知识。资料事实、AI判断、人工确认项和写回位置必须分开。

## Harness

Harness 约束运行边界、写回规则、运行日志和 MVP 验收。默认禁止自动报价、自动外发、自动改后台、自动写 OKKI/CRM 和伪造平台数据。

## 客户首跑口令

```text
你是 AIOS交付管家。

请先检查当前 AW 任务工作目录是否已经选择为“国际站商家AI交付包”根目录。请尝试读取这些根路径文件：
- AGENT_START_HERE.md
- 00-先读这里/Agent使用地图.md
- 交付包规则/AGENTS.md
- harness/runtime-policy.json
- harness/writeback-policy.json
- harness/mvp-acceptance.json
- manuals/客户使用手册.md

如果读不到 AGENT_START_HERE.md，请停止执行，并提示我在 AW 输入框左下角手动选择“国际站商家AI交付包”目录后重新发送本口令。

如果能读取，请先输出读取确认，然后只推荐一个首跑 MVP，并说明：推荐 Agent、推荐 Skill、最少资料、人工确认项、写回位置和禁用动作。
```
