# DoTouchAI 商业化方案

> 版本：v1.0（2026-08-24）｜前提：**不改动任何既定功能**——本地模式永久免费可用、自带 API Key（BYOK）通道永久保留、DSH 官方升级机制不变。商业化层为纯增量（自有云端 + 壳层 UI 新增页面）。
> 进度基线：壳版 milestone-7（发布签名链完成、DoTouchAI 品牌定型、AGC 真机安装验证、API 20 模拟器端到端通过）。

---

## 1. 三条红线（商业化与既定功能的关系）

| 红线 | 含义 | 商业化层的做法 |
|---|---|---|
| 本地优先 | 不登录也能完整使用本地 Agent（对接自己的 Key/本地 Host） | 登录仅在启用「DoTouchAI 模型服务」「云同步」时要求 |
| BYOK 共存 | 用户自带 Key 的官方直连通道不变 | 设置页并列两选项：DoTouchAI 模型服务（默认）/ 使用自己的 API Key |
| 升级机制不变 | 不 fork 官方、npm 通道热替换运行时不受商业化影响 | 商业化全在自有云端 + 壳层 UI，dsh Host 配置仍由壳生成 |

## 2. 账号体系（手机号身份 + 华为/苹果一键授权）

### 2.1 身份模型

- 内部 user_id 永久不变；手机号是身份的「别名」，可换绑——订阅、配额、云数据全部挂在 user_id 上，换手机号零迁移成本
- 一个手机号 = 一个账号：无论通过哪个渠道登录（华为授权/苹果授权/短信直登），同手机号自动归并到同一账号

### 2.2 三个登录渠道

| 渠道 | 平台 | 流程 | 手机号来源 |
|---|---|---|---|
| 华为账号一键授权（主渠道） | HarmonyOS | Account Kit 一键授权 → 隐私协议 → 授权手机号预填确认 → 登录成功（2 步） | 华为账号绑定手机号（运营商级验证，免短信） |
| Apple 一键授权 | iOS/macOS 客户端 | Sign in with Apple → 创建账户 → 引导绑定手机号（一次性）→ 短信验证 → 完成 | 苹果不提供手机号，首登后标准补绑 |
| 手机号 + 短信验证码（兜底，全平台） | 所有端 | 输入手机号 → 图形/频控防护 → 短信验证码（60s 倒计时）→ 登录注册合一 | 用户输入 |

标准交互细节：登录页默认展示一键授权大按钮（华为端）+「其他方式登录」折叠短信登录；隐私协议与用户协议勾选前置（未勾选时授权按钮置灰）；验证码错误 5 次锁定 10 分钟；多设备登录态并列（设备管理列表可远程下线）。

### 2.3 换绑手机号流程（标准账号安全流程）

设置 → 账号与安全 → 更换手机号 → 验证当前手机号（短信或已登录态+生物识别）→ 输入新手机号 + 验证码 → 换绑生效（user_id 与所有权益不变）→ 旧手机号 30 天冷却期（防账号倒卖）。

### 2.4 技术实现要点

- HarmonyOS 端：Account Kit（华为账号一键登录，官方 Kit，符合「严格按官方要求开发」纪律）
- 短信：后端接华为云短信/阿里云短信通道（签名与模板提前报备，见 §9）
- 凭证体系：OAuth2 登录态（access/refresh token，Asset Store 加密存储）→ 按需换取模型网关短时效凭证（§4.3，15 分钟轮换，不落明文）

---

## 3. 商业模式总览：三条收入线

| 线 | 产品 | 定价锚点 | 角色 |
|---|---|---|---|
| 1. 模型订阅（主力） | 免费层 100 次/月 + 全模型会员 | 行业首个「零配置开箱即用」DSH 客户端 | 获客钩子 + 主收入 |
| 2. 云同步存储 | 1GB 免费 + 分级订阅 | 对标 iCloud/华为云 | 粘性 + 稳定 ARPU |
| 3. 团队/信创版（v2 预留） | 多席位、集中计费、私有部署 | 政企采购（竞调结论：鸿蒙 PC 信创卡位无对手） | 高客单未来线 |

核心差异化（来自竞调）：所有竞品（anywhere-labs 18.7k 星等）都要求用户自备 API Key 或订阅——DoTouchAI 是第一个「装上就能聊」的 DSH 客户端，免费层就是获客引擎。

---

## 4. 模型接入与套餐（不用自带 Key 即可用）

### 4.1 免费层（获客引擎）

- 不接任何 Key、不装任何环境，登录即可对话——默认使用成本最低档的基础模型（DeepSeek V4 Flash 级）
- **100 次对话/月**，防滥用三件套：单会话 token 上限、每日新会话上限（如 10 个/日）、设备+账号风控
- 「一次对话」的定义：**新会话发出首条用户消息时计 1 次**；当月内继续/恢复历史会话不计次——语义清晰、用户易理解、难以绕过

### 4.2 会员套餐（指定套餐）

| 档位 | 定价建议 | 权益 |
|---|---|---|
| 会员版 | 39 元/月 | 一键接入全部模型目录（DeepSeek/GLM/Qwen 等经网关路由），随时切换，公平使用量（families 高频场景有软限频） |
| Pro 版 | 99 元/月 | 更高用量上限、优先队列、抢先体验新模型 |

- 切换模型 = 客户端拉取 entitlement 模型目录 → 用户选择 → 壳层重写 profile 的 provider 配置 → 复用升级管家的无感重启机制（既定能力，零新增）
- 原「模型信息只读页」升级为「模型目录选择器」——这是壳层自己的 UI，不动 dsh 功能

### 4.3 LLM 网关架构（商业化的技术心脏）

```
客户端(壳) ── baseURL 指向网关 + 短时效凭证(Asset Store 加密, 15min 轮换)
   │  dsh Host 的 provider 配置由壳生成（既定机制不变）
   ▼
LLM Gateway（OpenAI 兼容端点）
   ├─ 鉴权：用户凭证 → user_id → 订阅状态/配额
   ├─ 计量：对话次数、token 用量、模型路由记账
   ├─ 路由：模型名 → 上游官方 API（我方持有的 Key）
   └─ 风控：频控、异常检测、熔断
```

- 免费层/会员的差异只在网关侧的配额与目录下发——客户端零判断逻辑，全部服务端权威
- BYOK 通道不受影响：用户选「使用自己的 API Key」时 baseURL 直写官方端点，流量不经过网关

## 5. 云同步（1GB 免费 + 分级付费）

### 5.1 同步内容分级

| 类别 | 内容 | 默认 |
|---|---|---|
| 默认同步 | 会话记录（JSONL 文本）、Agent 预设、设置偏好、插件清单、todo/goal 历史 | 开 |
| 可选同步 | 附件与图像（占用配额较大） | 关 |
| 永不同步 | API Key 凭据、SSH/证书类敏感材料 | 强制关 |

容量估算：一次重度会话的 JSONL 约 1–5MB，1GB 免费额度 ≈ 数百次深度会话——免费层够用，付费层为长期重度用户准备。

### 5.2 存储定价（对标 iCloud 6/21/68 元、华为云同级）

| 档位 | 容量 | 定价建议 |
|---|---|---|
| 免费 | 1GB | 0 元 |
| 基础 | 20GB | 3 元/月 |
| 标准 | 100GB | 8 元/月 |
| 扩展 | 500GB | 25 元/月 |
| 捆绑优惠 | 会员版含 10GB 同步空间 | 提升会员感知价值 |

配额满：新增同步暂停 + 系统通知 + 设置页 iCloud 式用量条 + 升级引导（不删数据、不影响本地使用）。

### 5.3 同步架构

- 同步代理跑在常驻服务（Guided Service daemon，具备文件系统访问权）或经 Host RPC 导出（dsh-session-log-export，官方已有能力）
- 云端：按 user_id 分桶的对象存储 + 增量同步协议（内容寻址去重、断点续传）
- 隐私：传输 TLS + 服务端加密起步；端到端加密（E2EE，密钥仅用户设备持有）列入 v2 路线对标 iCloud 高级数据保护

## 6. 支付（双通道策略）

| 渠道 | 适用 | 说明 |
|---|---|---|
| 华为 IAP Kit | 应用市场上架版 | 数字商品（订阅+消耗型加油包）必须走 IAP，合规红线；服务端回执校验 |
| 支付宝/微信鸿蒙 SDK | 官网分发版/侧载版 | 直连低费率，账号体系一致（手机号） |
| Apple IAP | 未来 iOS/macOS 上架版 | 苹果抽成 30%（小企业计划 15%），苹果端定价需覆盖；macOS 官网分发可直连支付 |

订阅管理：续订前提醒、随时取消（周期末生效）、家庭共享列 v2。

## 7. 后端服务清单

| 服务 | 职责 |
|---|---|
| account-svc | 手机号身份、华为/苹果 OAuth 绑定、短信验证、换绑、设备管理 |
| auth-svc | 登录态签发/刷新、网关短时效凭证交换 |
| billing-svc | 订阅状态、配额（对话次数/存储/模型目录）、IAP 回执校验、对账 |
| llm-gateway | OpenAI 兼容端点、鉴权、计量、模型路由、风控（§4.3） |
| sync-svc | 对象存储、配额计量、增量同步协议 |

客户端集成面（全部增量）：账号页、订阅商店、同步设置与用量条、模型服务切换开关——走 account.*/billing.* 命名空间打到自有云端，不经 dsh Host（开发方案 §7.1 已预留）。

## 8. 单位经济（粗算，需上线后校准）

- 免费用户成本控制：基础档模型 + 单会话 token 上限 + 日频控 → 目标 1–5 元/免费用户/月
- 转化假设：2–5%（行业基准）；手机号门槛显著抑制多开薅羊毛
- 存储毛利：对象存储成本约 0.1 元/GB/月量级，毛利率 90% 以上
- 会员毛利：39 元订阅 vs 重度用户推理成本——公平使用量上限是毛利保护线，条款需明示

## 9. 合规清单（中国区上线前置，提前启动）

1. PIPL：隐私协议、手机号收集最小必要授权、账号注销流程
2. 短信签名与模板报备（运营商通道，周期 1–2 周）
3. 云端域名 ICP 备案（经营性互联网信息服务评估 EDI/ICP 证）
4. 生成式 AI：《生成式人工智能服务管理暂行办法》与算法/深度合成备案评估（对公众提供模型对话服务是触发条件，周期长，最先启动）
5. 华为应用市场：数字商品走 IAP、账号登录合规审查
6. 苹果端（未来）：若提供第三方登录必须并列 Sign in with Apple、IAP 抽成、隐私标签

## 10. 里程碑（M5 商业化阶段，AI 开发排期）

| 阶段 | 内容 | 工期 |
|---|---|---|
| M5.1 账号与登录 | account-svc + 华为一键授权 + 短信登录 + 换绑 + 账号页 UI | 4–5 天 |
| M5.2 模型网关与免费层 | llm-gateway + 免费层配额 + 壳层默认接入 | 5–8 天 |
| M5.3 订阅与模型目录 | billing-svc + IAP 接入 + 模型目录选择器 | 4–5 天 |
| M5.4 云同步 v1 | sync-svc + 同步代理 + 用量 UI | 5–7 天 |
| M5.5 合规与上架 | 备案材料、隐私协议、应用市场提审 | 并行推进 |

## 11. 风险与对策

| 风险 | 对策 |
|---|---|
| 免费层被多账号薅 | 手机号门槛 + 设备指纹 + 日频控 + 风控名单 |
| 模型成本波动吃掉毛利 | 网关层动态限流、套餐公平使用条款、基础模型选最便宜档 |
| 上架审核强制 IAP | 双通道策略（市场版 IAP / 官网版直连） |
| AIGC 备案周期不可控 | M5.0 即启动，网关先内测（邀请码模式）过渡 |
| 与主线开发抢资源 | 商业化层独立于协议原生线，可并行（后端 + 壳层 UI） |

## 12. 与现有文档的关系

- 取代开发方案 §7「支付界面（预留）」的占位设计，§6「模型指定方案」的计费网关构想在此落地为完整方案
- 开发方案 §1.2 Non-goals 中「不做云同步、多用户」按本方案在 M5 阶段解除（商业化层）
- 竞调差异化结论（§5 优势 4：商业化独有）是本方案的战略依据