摘要
AI-3.1-01 是 PRD V1.4「AI 功能模块作为平台核心能力层」的模块定位判定条目，PRD 判定为部分实现。本 TDD 为全组 17 份 TDD 的汇总/追踪锚点：不承载任何单一子能力的建设设计，而以「六大子能力逐项落地状态追踪表 + 17 份 TDD 交叉索引」为主体，并以代码证据对基线口径做精确化。
基线精确化结论：平台并非「AI 服务未接入」，而是仅智能翻译存在真实 AI 接入（backend/src/modules/translation/client.ts:1-28 OpenAI 兼容通路；dev 已接内网 LLM，生产默认关闭，异常不阻断主业务），其余五项无任何 AI 实现。该精确化不推翻 PRD 状态判定，PRD 修订建议仅作 deferred 记录、由 PRD 治理方决定。
本卡无外部 blocker，与其余 16 份 TDD 全并行交付；17 份 TDD 已全部交付（终审复核 17/17），追踪表与索引状态列随之刷新，PRD 附录 A 三态映射不变（TDD 交付 ≠ 条目已实现）。
六大子能力
6
智能注册 / 搜索 / 选品 / 翻译 / 新零售 / 个人 AI 服务，逐项对应 TDD 交付
TDD 交叉索引
17
分工 A 11 份 + 分工 B 6 份，全部 delivered（17/17 终审复核）
外部 blocker
0
汇总锚点零外部依赖可独立交付；DEC-1~5 等 22 项 blocker 挂靠具体能力条目
探索新发现缺口
5
ja 正文泄漏（RK-03）/ api_key 明文降级（RK-02）/ 搜索 100 条天花板（RK-04）/ 吞吐天花板（RK-09）/ 占位符未填
关键概念
汇总/追踪型 TDD
本卡形态定位：以状态追踪表 + 交叉索引为主体，不做单一子能力的建设设计；各子能力设计归其对应 TDD。
PRD V1.4 双层口径
①底座已建成 ／ ②AI 服务未接入——两态不得混同（承 FR-3.5-02）；本文档按代码证据将②精确化（见基线口径），不推翻「部分实现」判定。
基线精确化口径
非「AI 服务未接入」，而是「仅智能翻译存在真实 AI 接入（默认关闭），其余五项无任何 AI 实现」。
唯一 AI 通路
backend/src/modules/translation/client.ts:1-28：OpenAI 兼容 HTTP 客户端，586 行，DB 优先配置 + env 回退；全组涉 LLM 条目必须声明与该通路的关系（复用/并行/抽公共）。「AI 异常跳过」范式
『未配置/故障即跳过不阻断主业务』（NFR-3.8-01）＝全组 17 份 TDD 的强制范式；既有规范 4 处落点见代码现状底座。
双写标注
卡内锚点与复核实际行号漂移处，以「来源锚点（复核：实际行号）」双写标注，不回溯改写上游。
深度分级
TDD 的要素深度档位：full 字段级可直接开工；architectural 架构级；conceptual 概念级。
波次结构
p1（P1 批次全并行）→ P2·A 波（基础设施/机制先行）→ P2·B 波（依赖 A 波）→ P2·C 波（依赖前两波）。
三态映射
PRD 附录 A 的条目实现状态：已实现 / 部分实现 / 规划中。TDD 交付 ≠ 条目已实现，实现状态以各条验收要点达成为准。
方案设计
本卡形态与范围边界
汇总/追踪型：方案设计让位于状态追踪表与17 份 TDD 交叉索引。本卡无数据模型 / API / Workflow 设计（各归对应 TDD），自身零源码/迁移/配置改动，不涉及任何前端改动面与 i18n。全组共同红线（Workflow 承载业务逻辑 / 不修改上游源码 / 后端单一数据源 / 参数化 SQL）在各 TDD 要素内逐条验收，本卡组级收口。
基线口径与代码证据
PRD V1.4 附录 A 溯源行（原文）：AI-3.1-01 | 3.1 模块定位 | AI 功能模块作为平台核心能力层 | 部分实现 | 4.1。PRD §4.1 验收要点：本条为模块定位判定，其兑现以六大 AI 子能力逐项落地为标志；完整度随第 5、6 章各条需求的验收要点逐项复核。
基线表述采用精确化口径（非复述 PRD 原文）：
精确化口径
非「AI 服务未接入」，而是「仅智能翻译存在真实 AI 接入（backend/src/modules/translation/client.ts:1-28，按环境配置、dev 已接内网 LLM、生产默认关闭、异常不阻断主业务），其余五项无任何 AI 实现」。组级含义：涉 LLM 条目的通路决策以「与 client.ts 通路的关系（复用/并行/抽公共）」声明为必填项。
PRD 修订建议（deferred 记录，本卡不翻案）：建议 PRD V1.5 修订时采纳该精确化表述，是否修订由 PRD 治理方决定；本卡以代码事实为基线，不修改 PRD。
| # | 代码证据锚点 | 结论 |
|---|---|---|
| 1 | backend/src/modules/translation/client.ts:1-28 |
唯一真实 AI 通路：文件头注释自述 OpenAI-compatible AI translation client；586 行纯函数文件，非插件化 provider 体系 |
| 2 | backend/.env:43-47 |
dev 已接内网 LLM：TRANSLATION_AI_BASE_URL=http://192.168.66.225:3030/v1、TRANSLATION_AI_MODEL=deepseek-v4-flash、TRANSLATION_AI_ALLOW_PRIVATE_HOST=true（dev only） |
| 3 | backend/.env.template:90-94 |
生产默认关闭：占位值 https://your-translation-ai.example.com/v1 / sk-xxxx…（复核恰在 :90-94，无漂移）；:88-89 为 ALLOW_PRIVATE_HOST 生产留空注释 |
sequenceDiagram
autonumber
participant Job as 翻译任务（translation-job / retry-translations）
participant Cfg as translation-config（DB 优先，env 回退）
participant Cl as client.ts（OpenAI 兼容客户端）
participant LLM as LLM 服务（BASE_URL /chat/completions）
Job->>Cfg: 读取 AI 配置（isAIConfigured 预检）
alt 配置齐备（base_url + api_key + model）
Job->>Cl: 发起翻译请求（REQUEST_TIMEOUT_MS = 60_000）
Cl->>LLM: POST 配置端点 /chat/completions
LLM-->>Cl: 返回补全结果
Cl-->>Job: 取 choices[0].message.content（忽略 reasoning_content）
else 未配置 / 探测异常 / 调用失败
Job-->>Job: 跳过翻译，不阻断主业务（NFR-3.8-01 范式）
end
代码现状底座
全局层：插件/模块注册与 AI provider 负证据
backend/medusa-config.ts:60-110（复核：plugins 区实际:58-94，漂移 2 行，双写标注）——注册@mercurjs/b2c-core、@mercurjs/commission、@mercurjs/algolia（isAlgoliaConfigured条件注册 :67-77）、@mercurjs/reviews等；backend/medusa-config.ts:112-290（复核：modules 区实际:95-293）——约 25 个本地模块 + 上游模块；@medusajs/translation注册精确:239（无漂移）；- 负证据：
grep -inE "openai|llm|anthropic|ai[-_]provider|@medusajs/ai" backend/medusa-config.ts→ 0 命中——全文件无任何 AI/LLM provider 插件注册，AI 通路不经插件体系； - feature flag：
backend/medusa-config.ts:54-56featureFlags: { translation: true }（唯一与 AI 邻接的 flag）。
「AI 异常跳过」规范 4 处落点（3 处已复核 + 1 处标注）
| # | 落点 | 复核结论 |
|---|---|---|
| ① | backend/src/utils/translation-config.ts:49-66 | 成立 isAIConfigured（:49 起）探测 base_url && api_key && model 齐备，catch 分支返回 true（探测异常不阻断） |
| ② | backend/src/jobs/retry-translations.ts:244-248 | 成立 重试耗尽分支 if (exhausted) + logger.warn('[translation-retry] max retries reached … attempts=N/5') |
| ③ | storefront/src/app/[locale]/(main)/collections/[handle]/page.tsx:38-52 | 成立 托管搜索缺失降级：bot || !ALGOLIA_ID || !ALGOLIA_SEARCH_KEY 条件回退 ProductListing（关键词列表路径，:47-52） |
| ④ | algolia 同步失败告警 | 未直接复核 探索报告口径，插件源码在 node_modules，delegate 未直接复核；采纳需二次确认（归 AI-3.3-02 TDD 复核） |
六大子能力 + 支撑能力底座摘要（字段级 + file:line）
| 子能力 / 支撑 | 对应 TDD | 底座摘要（关键锚点） |
|---|---|---|
| 智能注册 | AI-3.2-02 | 资质提交/退回补正重提/维护全套在——register-vendor.ts:232（六步串行，复核精确命中）、seller-approval.ts:35-50（资质字段 JSON 可扩展）、resubmit-qualification/route.ts:54-65、执照 nonce 防伪 verify-license-ownership.ts:33-40；两阶段分层注册未成型、OCR/智能填单/材料预审 rg 0 命中 |
| 智能搜索 | AI-3.3-02/03/04 | 三语检索实际为零——api/store/products/route.ts:258-272（q ILIKE 仅搜原语言列）、Algolia 条件注册默认关（medusa-config.ts:67-77 + .env.template ALGOLIA_ENABLED=false）、B2C 实为 fetch limit=100 客户端过滤（AlgoliaProductsListing.tsx:192,206）、b2b/h2b 搜索输入框 disabled；词库（thesaurus|synonym|glossary 全库 0 命中）与主体识别零实现 |
| 智能选品 | AI-3.4-02/03 | 类目树 6 根 18 子类 seed 与 PRD 门类一致（seed-functions.ts:208-311，复核 createProductCategories 起始 :208）+ 三语四层闭环；建档规范层为零；选品模型/管线/推荐接口零实现（rg 全误报），唯一人工干预 = pinned 置顶（api/store/products/route.ts:4-10，复核命中） |
| 智能翻译 | AI-3.5-02/03/04 | 六大子能力中唯一真实 AI 接入、管道完整可用——client 通路（§2.2）+ translation-config 加密配置 + translation-job 重试队列（幂等/原子占位/指数退避/MAX 5）+ 双防线跳过 + admin 配置页与手动编辑矩阵 + 8 个单测；生产默认关闭；7 项管道缺口归 AI-3.5-02；场景翻译与双轨复核零实现 |
| 新零售 AI 赋能 | AI-3.6-03/04 | 数字员工对话引擎/分身配置/服务看板零实现（digital.?employee|数字员工 0 命中），仅 TalkJS 人类聊天骨架 + LLM 通路可参考 + employee 命名冲突（company/types/common.ts:21，RK-11）；广场/展位/活动实体零实现，仅 h2b-receiving-location 点位雏形 + 商品级 QR 归因闭环 |
| 个人 AI 服务 | AI-3.7-02 | C 端会员/注册归因/CPS 分佣基座在（storefront user/* 全套、affiliate CPS 完整）；数字形象/画像字段、对话式购物、个性化推荐全部零实现（conversational|personaliz 0 业务命中）；依赖链最长 + C6 双评估前置 |
| 商业化机制（支撑） | AI-3.2-04 | 四块原语在——finance 复式账本（ledger-entry.ts，amount_minor 整数 + 幂等 + append-only，复核命中）、customer.groups 定价解锁（validate-add-to-cart.ts:70-102）、Stripe payment_collection、17 个定时 job 先例；plan/订阅/试用期/用量计量零实现 |
| 合规把关（支撑） | AI-3.9-01/04 | 三语隐私政策存在但 AI 专项条款错放 ToS §8、隐私政策 ja 正文 seed 泄漏（RK-03）+ 占位符未填；四套人工审核状态机齐备（入驻 3 态/渠道 6 态 forward-only/购物车审批/协议 4 态；qualification-state-machine.ts:26-40，复核 REVIEW_TRANSITIONS 表驱动白名单实际 :29），无 AI 产出物把关框架 |
| 类别 | 项 |
|---|---|
| 已存在可复用 | 电商底座（订单/支付/渠道/审核/多语言框架）；翻译管道全套（唯一 AI 接入）；四套审核状态机；finance 账本 + 定价解锁原语；类目树 + 三语闭环；「AI 异常跳过」规范 4 落点范式 |
| 需扩展 | 翻译管道（7 项缺口，归 AI-3.5-02）；四套审核状态机向 AI 产出物把关框架参数化延伸（归 AI-3.9-04）；q 检索链路向三语扩展（归 AI-3.3-02） |
| 从零新建 | 两阶段分层注册的 AI 辅助；词库/主体识别/撮合算法；选品模型与管线；数字员工/线下广场实体；个人形象/画像/对话式购物；商业化机制层（plan/订阅/试用/计量）；AI 专项合规条款与把关框架 |
flowchart TB
ROOT["AI 功能模块（平台核心能力层）"]
T["智能翻译：唯一真实 AI 接入，管道完整可用"]
R["智能注册：资质链路在，两阶段分层未成型"]
S["智能搜索：三语检索实际为零"]
P["智能选品：类目树在，选品模型为零"]
N["新零售 AI 赋能：对话引擎等零实现"]
A["个人 AI 服务：全零，依赖链最长"]
B1["支撑：商业化机制（账本/定价解锁原语在）"]
B2["支撑：合规把关（审核状态机在，AI 把关框架缺）"]
ROOT --> T
ROOT --> R
ROOT --> S
ROOT --> P
ROOT --> N
ROOT --> A
ROOT --> B1
ROOT --> B2
T -. "唯一 AI 通路 client.ts" .- R
T -. "通路关系声明为必填项" .- N
缺口与目标状态
PRD 验收要点转译：①「兑现以六大 AI 子能力逐项落地为标志」→ 六大子能力逐项对应 TDD 交付，落地 = 各 TDD 自身验收达成（承载：追踪表 + 索引）；②「完整度随第 5、6 章各条需求的验收要点逐项复核」→ 状态刷新机制：终审随各 TDD 交付刷新状态列并复核计数（17/17），映射 PRD 附录 A 三态。
| # | 子能力 | 缺口（证据） | 目标状态（TDD 交付） |
|---|---|---|---|
| ① | 智能注册 | 两阶段分层注册未成型（现有为资格通道迁移非分层注册）；零 AI 辅助（OCR/智能填单/材料预审 0 命中） | AI-3.2-02-deep-commerce-registration.md（分层注册向导 + 权益门控；AI 辅助标注后续增强） |
| ② | 智能搜索 | 三语检索实际为零（索引无译文/查询无理解/b2b·h2b UI disabled/q 无调用方）；词库与主体识别全零；B2C 数据天花板 limit=100 | AI-3.3-02-trilingual-search.md（三端搜索链路 + 全量索引）+ AI-3.3-03-shared-thesaurus.md + AI-3.3-04-entity-recognition-param-parsing.md |
| ③ | 智能选品 | 建档规范层为零（无类目模板/准入规范）；选品模型/管线/特征数据全零；数据前提不足（seed 留空/demo 11 商品） | AI-3.4-02-standardized-product-system.md（建档规范层 + 挂载定稿）+ AI-3.4-03-ai-product-selection.md（架构级） |
| ④ | 智能翻译 | 管道完整但 7 项缺口（白名单写死/无状态 API/category 无预检/缺专属单测/明文降级/usage 丢弃/生产未配置）+ 场景翻译与双轨复核零实现 | AI-3.5-02-dynamic-content-translation.md（打样已交付）+ AI-3.5-03-vertical-scenario-translation.md + AI-3.5-04-dual-track-review.md |
| ⑤ | 新零售 AI 赋能 | 对话引擎/分身配置/看板零实现；广场/展位/活动实体零实现；产品边界与场地资源未定 | AI-3.6-03-digital-employee.md（架构级）+ AI-3.6-04-offline-retail-plaza.md |
| ⑥ | 个人 AI 服务 | 形象配置/对话式购物/个性化推荐/画像标签全零；依赖链最长 + C6 双评估前置 | AI-3.7-02-personal-digital-avatar.md（概念级） |
| ⑦ | 商业化机制（支撑） | 无 plan/订阅实体、无试用期计时、无用量计量；四类工具本体全部零实现 | AI-3.2-04-tool-trial-and-paywall.md（机制层先行） |
| ⑧ | 合规把关（支撑） | 隐私政策无 AI 专项条款（错放 ToS §8）；ja 正文泄漏 + 占位符；无 AI 产出物把关框架 | AI-3.9-01-appi-compliance-foundation.md（技术管道段可开工 + 条款内容段 DEC-2 门控）+ AI-3.9-04-human-review-framework.md（把关状态机参数化框架） |
六大子能力落地状态追踪表（主体）
状态列已随终审刷新为 delivered（17/17，2026-10-26 终审执行）；计数复核 17/17，与 PRD 附录 A 三态映射不变。
| 子能力 | PRD 状态 | 代码现状一行结论 | 对应 TDD 文件（docs/reports/ai-module-prd/tdd/） | 状态 |
|---|---|---|---|---|
| 智能注册 | 部分实现（3.2-01/03 已实现、3.2-02 部分实现） | 资质提交/重提/维护全套在（register-vendor.ts:232 六步工作流）；两阶段分层注册未成型、零 AI 辅助 | AI-3.2-02-deep-commerce-registration.md（P1） | delivered |
| 智能搜索 | 部分实现 + 规划中混合（3.3-01 已实现、3.3-02/05 部分、3.3-03/04 规划中） | 三语检索实际为零：q ILIKE 仅原语言列、Algolia 默认关、B2C=fetch limit=100 客户端过滤、b2b/h2b 搜索框 disabled；词库/主体识别零实现 | AI-3.3-02-trilingual-search.md（P1）；AI-3.3-03-shared-thesaurus.md（P2·A 波）；AI-3.3-04-entity-recognition-param-parsing.md（P2·B 波） | delivered |
| 智能选品 | 部分实现 + 规划中混合（3.4-01/04 已实现、3.4-02 部分、3.4-03 规划中） | 类目树 6 根 18 子类与 PRD 一致（seed-functions.ts:208-311）+ 三语闭环；建档规范层为零；选品模型/管线/推荐接口零实现（唯一人工干预 = pinned 置顶） | AI-3.4-02-standardized-product-system.md（P1）；AI-3.4-03-ai-product-selection.md（P2·A 波，架构级） | delivered |
| 智能翻译 | 部分实现（3.5-01 已实现、3.5-02 部分、3.5-03/04 规划中） | 唯一真实 AI 接入、管道完整可用（client.ts 586 行 + 加密配置 + 重试队列 + 双防线跳过 + 8 单测）；生产默认关闭；场景翻译与双轨复核零实现 | AI-3.5-02-dynamic-content-translation.md（P1·打样已交付）；AI-3.5-03-vertical-scenario-translation.md（P2·B 波）；AI-3.5-04-dual-track-review.md（P2·C 波） | delivered |
| 新零售 AI 赋能 | 规划中（AI 本体 3.6-03/04；商城/壳店/扫码 3.6-01/02/05 已实现） | 对话引擎/分身配置/看板零实现（仅 TalkJS 人类聊天骨架 + LLM 通路参考 + employee 命名冲突）；广场/展位/活动实体零实现（仅点位雏形 + 商品级 QR 归因） | AI-3.6-03-digital-employee.md（P2·B 波）；AI-3.6-04-offline-retail-plaza.md（P2·C 波） | delivered |
| 个人 AI 服务 | 规划中（3.7-02；会员体系 3.7-01 已实现） | 会员/归因/CPS 基座在；形象/画像/对话式购物/个性化推荐全零；依赖链最长 + C6 双评估前置 | AI-3.7-02-personal-digital-avatar.md（P2·C 波） | delivered |
| 商业化机制（支撑） | 规划中（3.2-04） | 四块原语在（账本/分组定价解锁/Stripe 收款/定时 job）；plan/订阅/试用/计量零实现；机制层先行判定 | AI-3.2-04-tool-trial-and-paywall.md（P2·A 波，机制层先行） | delivered |
| 合规把关（支撑） | 部分实现（3.9-01/04 部分；3.9-02/03 已实现） | 三语隐私政策在但无 AI 专项条款（错放 ToS §8）+ ja 泄漏；四套审核状态机在但无 AI 产出物把关框架（共享粒度：迁移表工具级共享，禁两套状态机） | AI-3.9-01-appi-compliance-foundation.md（P1）；AI-3.9-04-human-review-framework.md（P1） | delivered |
表注（行覆盖口径）：AI-3.3-05 供需撮合（智能搜索子能力域内的撮合形态，P1，AI-3.3-05-supply-demand-matching.md 状态 delivered）按任务卡 8 行定义不单列行，经交叉索引第 5 项追踪——17 文件全量在索引中，无一遗漏。
17 份 TDD 交叉索引全清单（锁定文件名）
路径前缀统一 docs/reports/ai-module-prd/tdd/。深度分级图例：full 字段级可开工 · architectural 架构级 · conceptual 概念级。
分工 A（11 份）
| # | 文件名 | 条目 | 优先级·波次 | 深度分级 | 状态 |
|---|---|---|---|---|---|
| 1 | AI-3.1-01-module-positioning.md | AI-3.1-01 模块定位 | P1·p1 | full（汇总/追踪型） | delivered |
| 2 | AI-3.2-02-deep-commerce-registration.md | AI-3.2-02 深度商业注册 | P1 | full | delivered |
| 3 | AI-3.3-02-trilingual-search.md | AI-3.3-02 三语检索 | P1 | full | delivered |
| 4 | AI-3.3-03-shared-thesaurus.md | AI-3.3-03 共享术语库 | P2·A 波 | full | delivered |
| 5 | AI-3.3-05-supply-demand-matching.md | AI-3.3-05 供需撮合 | P1 | full | delivered |
| 6 | AI-3.4-02-standardized-product-system.md | AI-3.4-02 标准化商品体系 | P1 | full | delivered |
| 7 | AI-3.5-02-dynamic-content-translation.md | AI-3.5-02 动态内容翻译 | P1·pilot | full（打样基准） | delivered |
| 8 | AI-3.5-04-dual-track-review.md | AI-3.5-04 双轨复核 | P2·C 波 | architectural | delivered |
| 9 | AI-3.6-03-digital-employee.md | AI-3.6-03 数字员工 | P2·B 波 | architectural | delivered |
| 10 | AI-3.9-01-appi-compliance-foundation.md | AI-3.9-01 APPI 合规基础 | P1 | full | delivered |
| 11 | AI-3.9-04-human-review-framework.md | AI-3.9-04 人工审核机制 | P1 | full | delivered |
分工 B（6 份）
| # | 文件名 | 条目 | 优先级·波次 | 深度分级 | 状态 |
|---|---|---|---|---|---|
| 12 | AI-3.2-04-tool-trial-and-paywall.md | AI-3.2-04 工具试用与付费 | P2·A 波 | architectural | delivered |
| 13 | AI-3.4-03-ai-product-selection.md | AI-3.4-03 智能选品 | P2·A 波 | conceptual | delivered |
| 14 | AI-3.3-04-entity-recognition-param-parsing.md | AI-3.3-04 主体识别与参数解析 | P2·B 波 | architectural | delivered |
| 15 | AI-3.5-03-vertical-scenario-translation.md | AI-3.5-03 垂直场景翻译 | P2·B 波 | architectural | delivered |
| 16 | AI-3.6-04-offline-retail-plaza.md | AI-3.6-04 线下新零售广场 | P2·C 波 | conceptual | delivered |
| 17 | AI-3.7-02-personal-digital-avatar.md | AI-3.7-02 个人数字形象 | P2·C 波 | conceptual | delivered |
一致性核对记录：17 个文件名已与终审批次任务卡 files[].path 全量核对——17/17 一致，无不一致项。TASK-019 产物为终审汇总索引 _index.md，不在 17 之列。
flowchart LR
subgraph P1["p1 批次（全并行）"]
direction TB
M["AI-3.1-01 模块定位（本卡）"]
T52["AI-3.5-02 动态内容翻译（打样）"]
R32["AI-3.2-02 深度商业注册"]
S33["AI-3.3-02 三语检索"]
S35["AI-3.3-05 供需撮合"]
P42["AI-3.4-02 标准化商品体系"]
C91["AI-3.9-01 APPI 合规基础"]
C94["AI-3.9-04 人工审核机制"]
end
subgraph WA["P2·A 波（基础设施/机制先行）"]
direction TB
W33["AI-3.3-03 共享术语库"]
W24["AI-3.2-04 工具试用与付费（机制层先行）"]
W43["AI-3.4-03 智能选品（架构级）"]
end
subgraph WB["P2·B 波（依赖 A 波词库等）"]
direction TB
B34["AI-3.3-04 主体识别与参数解析"]
B53["AI-3.5-03 垂直场景翻译"]
B63["AI-3.6-03 数字员工"]
end
subgraph WC["P2·C 波（依赖前两波）"]
direction TB
C54["AI-3.5-04 双轨复核"]
C64["AI-3.6-04 线下新零售广场"]
C72["AI-3.7-02 个人数字形象"]
end
WA --> WB
WB --> WC
状态刷新机制
- planned = 该 TDD 文件名已锁定、任务已派发，交付状态待确认；各 TDD 交付后由终审索引（
_index.md）刷新状态并复核计数（17/17），同步映射 PRD 附录 A 三态（已实现/部分实现/规划中——TDD 交付 ≠ 条目已实现，实现状态仍以各条验收要点达成为准）。 - 终审刷新记录（2026-10-26）：17/17 TDD 全部交付，追踪表与交叉索引状态列已由 planned 全量刷新为 delivered（17 行索引 + 8 行追踪表）；PRD 附录 A 三态映射不变。
- 刷新输入 = 16 份 TDD 交付物本身；本卡状态列不承载运行时开关语义。
flowchart LR
D["各 TDD 逐份交付"] --> F["终审索引复核（计数 17/17）"]
F --> U["追踪表 / 交叉索引状态列刷新"]
U --> M["映射 PRD 附录 A 三态（已实现 / 部分实现 / 规划中）"]
M -. "TDD 交付 ≠ 条目已实现，以各条验收要点达成为准" .- N["PRD 状态判定保持不变"]
AI 能力接入点（组级结论）
- 全平台唯一 AI 通路 =
backend/src/modules/translation/client.ts:1-28（OpenAI 兼容 HTTP 客户端，586 行，DB 优先配置 + env 回退）。全组涉 LLM 条目必须声明与该通路的关系（复用/并行/抽公共）；打样基准 AI-3.5-02 判定为「本体复用」。 - prompt 组装扩展位 =
fillPrompt（client.ts:295-306，复核精确 :295；{source}/{target}占位替换，空模板回退内置指令）。场景化 prompt 路由与术语注入归 AI-3.5-03（依赖 AI-3.3-03 词库），本卡仅记扩展位坐标。 - 强制范式（固定句，逐字）：『未配置/故障即跳过不阻断主业务』（NFR-3.8-01）——17 份 TDD 中一切 AI 能力的降级路径必含跳过路径测试点。组级跳过路径既有规范 4 落点见上文（3 处已复核 + 1 处标注未直接复核）。
- 环境配置现状：dev 已接内网 LLM（backend/.env:43-47）、生产默认关闭（backend/.env.template:90-94）、异常不阻断主业务——此三态为全组 TDD 的公共起点事实。
合规挂钩（组级映射）
| NFR / 评估项 | 组级挂钩点 | 承载 TDD |
|---|---|---|
| NFR-3.9-01（APPI 基础 + AI 专项条款） | AI 专项条款缺失（错放 ToS §8）、ja 泄漏、占位符、发布通道未决（R-legal-publish-channel） | AI-3.9-01（技术管道段可开工；条款内容段 DEC-2 门控） |
| NFR-3.9-02（免责与权责，已实现） | 通用级已实现；翻译误差等能力级细化归各能力 TDD 引用 | 各能力 TDD（AI-3.5-02 已引用） |
| NFR-3.9-03（审计与可追溯，已实现但 AI 调用审计缺） | usage/token 丢弃 = 审计缺口代码坐实；ai_call_log 设计已在 AI-3.5-02 P-④ | AI-3.5-02（管道增强段） |
| NFR-3.9-04（人工审核覆盖 AI 产出物） | 把关框架缺失；与 AI-3.5-04 共享把关状态机（迁移表工具级共享，禁两套状态机） | AI-3.9-04（P1 先行）+ AI-3.5-04（引用） |
| C6 三项 APPI 影响评估 | 对话记录/客服翻译、画像与推荐、真人形象肖像授权——评估清单未出，挂靠对应条目 | AI-3.6-03 / AI-3.7-02 / AI-3.5-03 |
| DEC-1~5 | 翻译接入时点 / 合规条款时点 / 大额阈值 / P2 范围与定价 / 验收基线——全组以编号引用 | 22 项 blocker 全量建模，本卡不重判 |
波次与排期
本卡所属波次 p1（汇总锚点——与打样 AI-3.5-02 同批先行；终审收口）。全组波次结构见图3。本卡无子任务依赖链（单一文档产出）；状态刷新 DAG = 各 TDD 交付 → 终审索引 → 状态列刷新与三态映射复核。跨波交叉引用强制项：AI-3.9-04 × AI-3.5-04 共享把关框架（禁两套状态机）；AI-3.2-04 工具适配器映射归属声明——细节归各自 TDD。
迁移与回滚（文档型）
- 数据 migration：无——零 schema/seed 变更，
pnpm db:reset/db:reset:demo流程不受影响。 - 「新 AI 能力独立关闭开关」：N/A——本卡无运行时行为；组级开关现状 = featureFlags translation（medusa-config.ts:54-56）+ 翻译 AI 三态环境配置，各新 AI 能力的独立开关由其对应 TDD 定义。
- 回滚方案（文档更正流程）：①文件名/索引与任务卡漂移 → 以任务卡为准修正并追加注记；②上游 PRD 修订 → 基线口径随终审刷新，修订历史在文档版本号递增；③状态列错误刷新 → 以终审索引复核结果为最终权威回滚覆盖。
验收与测试
本卡为汇总/追踪型，验收对象为文档本体。
| # | 验收标准 | 口径 |
|---|---|---|
| A1 | 十要素章节齐备（10 节标题逐字，grep 各命中 ≥1 次） | 模板规则 |
| A2 | 追踪表 8 行齐备（六大子能力 + 商业化支撑 + 合规支撑），5 列结构完整 | 任务约定 |
| A3 | 交叉索引 17/17（分工 A 11 + 分工 B 6），17 个锁定文件名逐一可 grep 命中 | 收敛条件 |
| A4 | 状态列统一（终审前 planned → 终审后 delivered 17/17）且含终审刷新注记 | 任务约定 |
| A5 | 基线口径含精确化表述「仅智能翻译存在真实 AI 接入」（非复述 PRD 原文） | 关键发现 |
| A6 | 关键锚点可 grep：backend/src/modules/translation/client.ts:1-28、medusa-config.ts:112-290、backend/.env.template:90-94、utils/translation-config.ts:49-66 | 验证命令 |
| A7 | PRD V1.4 双层口径不混同（口径声明 + 精确化不翻案声明） | 写作纪律 |
| A8 | 与波次判定一致：A/B/C 三波标注逐文件对应（A = AI-3.3-03 / AI-3.2-04 / AI-3.4-03；B = AI-3.3-04 / AI-3.5-03 / AI-3.6-03；C = AI-3.5-04 / AI-3.6-04 / AI-3.7-02） | 波次验收 |
| A9 | 与终审批次任务卡 files[].path 核对记录在案（本卡为 17/17 一致） | 输入约定 |
测试策略（文档型声明）
- L0 门禁（本卡唯一自动化层）：验证命令组全绿（文件非空 / 关键字符串 grep / 17 文件名逐一 grep / 双锚点 grep），缺失项必须清零。
- 无单测 / integration / e2e：本卡不产出代码；后续状态刷新验证 = 终审对索引计数复核（17/17）与 PRD 附录 A 三态映射核对。
- 降级路径测试（组级约束传递）：本卡自身无 AI 调用；全组各涉 LLM TDD 的降级路径测试设计在其各自验收要素内强制（打样 AI-3.5-02 已示范双防线四测试点）。
- 量化指标：各子能力验收数值一律「基线立项定（DEC-5）」占位，本卡不设任何数值指标。
风险与开放问题
已识别风险（含探索新发现缺口）
高
隐私政策 ja 正文 seed 泄漏（RK-03）
storefront/b2b 的
documents.json ja 正文泄漏 seed 脚本文本（len 6170 vs zh 1932，含 publishLegalDocumentRevisionWorkflow 字样），线上法务文档存在非正文残留。→ 归 AI-3.9-01（P1 顺手修复）。
高
翻译 api_key 明文降级 + 密钥轮换无路径（RK-02）
upsert-translation-config.ts:52-56 无 NODE_ENV 守卫；secret-crypto 密文无版本标记层。→ 归 AI-3.5-02（管道增强段 P-③，已交付设计）。
中
B2C 搜索 100 条数据天花板（R-search-100-cap，RK-04）
AlgoliaProductsListing.tsx:192,206 fetch limit=100 客户端过滤，商品量增长后 B2C 检索结果不完整。→ 归 AI-3.3-02（全量索引方案）。
中
翻译扩量吞吐天花板（R-throughput，RK-09）
并发 3 + 5min cron + MAX 5 重试（
translation-job/constants.ts、retry-translations.ts:60-68）。→ 归 AI-3.5-02（验收口径含吞吐指标位，数值 DEC-5）。
中
法务文档三语正文占位符未填（R-legal-placeholder）
documents.json:62 存在 [氏名]/[住所]/[メール/電話] 等未填占位——APPI 信息管理者联系方式线上不可用。→ 归 AI-3.9-01。
低
「AI 异常跳过」落点④未经直接复核
algolia 同步失败告警为探索报告口径，插件源码在 node_modules 未直接复核——如实标注，采纳需二次确认。→ 归 AI-3.3-02 TDD 复核。
低
锚点行号漂移
后续代码演进使本文锚点失准——双写标注（「复核：实际行号」）即漂移修正落点，由终审统一复核刷新，不回溯改写。
前提与假设
假设与仅引用不重判项
- 17 份 TDD 各自本体内容由各任务卡所有，本卡只做索引与状态追踪（仅引用不重判）；波次三波判定引用不重判。
- PRD V1.4「部分实现」判定维持不变；精确化表述不推翻上游结论。
- 数字化指标的基线与目标值一律 DEC-5 占位。
前置决策点
外部 blocker：无——本卡作为汇总/追踪锚点零外部依赖可交付；DEC-1~5、C3、C6、X-*（外部资源/数据前提）等 22 项 blocker 均挂靠在具体能力条目，由对应 TDD 承接，本卡仅组级索引不重复展开。
| 依赖 | 性质 | 说明 |
|---|---|---|
| TDD-TEMPLATE + 打样决策（AI-3.5-02） | 上游（已满足） | 十要素骨架与打样约定（本卡已消费：两段式 / 双写标注 / 文件名以卡为准） |
| 其余 16 份 TDD 交付 | 下游输入（已完成） | 状态刷新机制的输入：终审随各 TDD 交付刷新状态列并复核 17/17；本卡交付不等待任何一份 TDD 完成 |
「阻塞什么/可并行做什么」二分：本卡无阻塞点——追踪表与交叉索引按锁定文件名先行交付；16 份 TDD 与本卡全并行，交付后单向刷新，无循环依赖。
待决问题清单
- PRD V1.5 是否采纳「仅智能翻译存在真实 AI 接入（默认关闭）」的精确化表述——deferred 记录，由 PRD 治理方决定，本卡不翻案。
- DEC-1（翻译接入时点）/ DEC-2（合规条款时点）/ DEC-3（大额阈值）/ DEC-4（P2 范围与定价）/ DEC-5（验收基线）——全组以编号引用，由对应能力条目 TDD 承接，本卡不内联臆造数值。
- C6 三项 APPI 影响评估清单未出：C-c6-dialog（对话记录/客服翻译）、C-c6-profile（画像与推荐）、C-c6-likeness（真人形象肖像授权）——挂靠 AI-3.6-03 / AI-3.7-02 / AI-3.5-03。
- algolia 同步失败告警落点需二次确认（归 AI-3.3-02 TDD 复核）。
附录：溯源对照
本文档由 docs/reports/ai-module-prd/tdd/AI-3.1-01-module-positioning.md（文档版本 v1.0，2026-10-26）转换生成。输出章节与源章节映射如下（Preserved = 保留原文内容；Summarized = 摘要化重组；Inferred = 转换侧推断标注）：
| 本文档章节 | 源章节 | 处理方式 |
|---|---|---|
| 摘要 | 元数据表 + §1 溯源与现状 + §4.1 追踪表结论 | Summarized |
| 关键概念 | 头部口径声明 + §1.2 + §2.3 + §4.2 波次说明 | Summarized |
| 方案设计 · 基线口径与代码证据 | §1.1 / §1.2（含 PRD 修订 deferred 记录） | Preserved |
| 方案设计 · 代码现状底座 | §2.1 / §2.2 / §2.3 / §2.4 / §2.5 | Preserved（锚点与负证据逐条保留） |
| 方案设计 · 缺口与目标状态 | §3.1 / §3.2 | Preserved |
| 方案设计 · 状态追踪表 | §4.1（含表注行覆盖口径） | Preserved |
| 方案设计 · 17 份 TDD 交叉索引 | §4.2（分工 A 11 + 分工 B 6，一致性核对记录） | Preserved |
| 方案设计 · 状态刷新机制 | §4.3 | Preserved |
| 方案设计 · AI 能力接入点 | §5（唯一通路 / fillPrompt 扩展位 / 强制范式） | Preserved |
| 方案设计 · 合规挂钩 | §6 | Preserved |
| 方案设计 · 波次与排期 / 迁移与回滚 | §9 / §10（波次表转为图3） | Preserved / Summarized |
| 验收与测试 | §8.1 / §8.2 | Preserved |
| 风险与开放问题 | §3.3 探索新发现缺口 + §2.3④ + §10 锚点漂移维护 | Preserved + Inferred（风险分级为转换侧判定） |
| 前置决策点 | §7 前置依赖与决策点 + §1.2 deferred 记录 | Preserved |
| 图1 / 图2 / 图3 / 图4 | §2.2+§5 / §2.4+§2.5 / §9 / §4.3 | Inferred（依源表格与文字绘制的可视化视图） |
| 范围边界（无数据模型/API/前端改动） | §4 头部形态声明 + design_ownership | Preserved |
溯源说明
源文档事实基线溯源探索 findings + PRD V1.4 + 执行复核；内部流程标识（任务批次号、执行 run 标识、findings 条目引用）属过程元数据，在本可读版中按上下文保留或摘要，不影响任何契约性内容（追踪表、17 文件索引、锚点、缺口清单、验收标准均完整保留）。