# TopOn / AnyThink React Native SDK

| 项 | 内容 |
|----|------|
| 仓库 | `up_sdk_react_native` |
| 状态 | 设计阶段（尚未初始化工程代码） |
| 原生 SDK（Android） | **6.5.73.3** |
| RN 插件版本 | **1.0.0** 起（独立 semver） |

## SPACE 主文档（技术设计 + 登记主表）

**[docs/SPACE-TopOn-ReactNative-SDK技术设计.md](docs/SPACE-TopOn-ReactNative-SDK技术设计.md)**

整合内容：背景与架构 · **§2.5 RN 插件工程惯例** · 双向通信 · **§3 类级/AI 约束** · 项目结构 · 跨端 API · 登记主表（§17）

> 文档版本 **v4.6**；变更见 SPACE 文末 **§二十一**。iOS 附录见 **[ios_rn_bridging_design.md](docs/ios_rn_bridging_design.md)**。

## 钉钉交付（两份主文档）

| 文档 | 说明 |
|------|------|
| **[docs/TopOn-RN-SDK-实施规范.md](docs/TopOn-RN-SDK-实施规范.md)** | **实施规范**：Phase 0～4、广告五步法、AI 约束、代码质量门禁 |
| **[docs/TopOn-RN-SDK-验收标准.md](docs/TopOn-RN-SDK-验收标准.md)** | **验收标准**：功能/质量/Demo/单测/对拍/签核（可喂 AI 生成测试） |

更多交付说明见 [docs/DELIVERY.md](docs/DELIVERY.md)。

## 仓库内拆分稿（与上表同源）

| 文档 | 说明 |
|------|------|
| [docs/spec.md](docs/spec.md) | 执行步骤简版 |
| [docs/ACCEPTANCE.md](docs/ACCEPTANCE.md) | 验收简版 |
| [docs/CODE-QUALITY.md](docs/CODE-QUALITY.md) | 质量扫描（已并入实施规范 §九） |
| [docs/RN SDK插件prd V1.0.0.md](docs/RN%20SDK插件prd%20V1.0.0.md) | 产品 PRD |

喂 AI：`@TopOn-RN-SDK-实施规范.md @TopOn-RN-SDK-验收标准.md @RN SDK插件prd V1.0.0.md`（注明验收标准为后者）。

## 其他文档

| 文档 | 说明 |
|------|------|
| [docs/ios_rn_bridging_design.md](docs/ios_rn_bridging_design.md) | **iOS 实施附录**（Flutter 拷贝、AT* 命名、§9.1 目录） |
| [docs/IMPLEMENTATION-PLAN.md](docs/IMPLEMENTATION-PLAN.md) | 落地任务与里程碑 |
| [docs/MULTI-BRAND-DELIVERY.md](docs/MULTI-BRAND-DELIVERY.md) | 三品牌品牌化替换细则 |
| [docs/android-rn-parity.md](docs/android-rn-parity.md) | Android Demo 对拍表 |
| [docs/RN-SDK-探索发现与待决项-已落地.md](docs/RN-SDK-探索发现与待决项-已落地.md) | 历史探索归档（只读） |
| [docs/SDD（Spec驱动开发）.md](docs/SDD（Spec驱动开发）.md) | OpenSpec / Superpowers 工作流（可选） |
| [docs/DESIGN.md](docs/DESIGN.md) | ↪ 已合并至 SPACE 主文档 |
| [docs/api-dictionary.md](docs/api-dictionary.md) | ↪ 已合并至 SPACE 第十七节 |

实现前建议阅读：**TopOn-RN-SDK-实施规范.md Phase 0～1** → SPACE **§2.5**、**§3**、**§13.6**。

## 维护 SPACE 文档

```bash
# 若分别维护 DESIGN + api-dictionary 后需重新合并（需恢复两文件完整版）
python3 scripts/merge_space_doc.py
```

## 跨端参考代码（实现时）

| 端 | 路径 |
|----|------|
| Flutter Android 桥 | `topon_flutter_project/anythink_flutter_sdk/android` |
| Flutter iOS 桥 | `topon_flutter_project/anythink_flutter_sdk/ios` |
| Android 原生 API | `up_sdk_android/anythink_sdk` |
