# 发布说明 — YuMatrix Studio 0.1.0-beta.2

**发布日期：** 2026-08-27
**频道：** beta
**版本：** 0.1.0-beta.2

---

## 新功能 — 桌面端国际化/本地化

此版本让 YuMatrix Studio 成为完整的**双语桌面应用**（zh-CN / en-US），支持运行时切换语言 — 无需重启。

### 语言支持
- **zh-CN（简体中文）** — 中文兼容系统的默认语言
- **en-US（English）** — 未知/英文系统的回退语言
- **运行时切换** 通过设置 → 语言选择器。更改立即应用到整个应用
- **持久化** — 偏好保存到应用本地存储（localStorage），下次启动时恢复
- **系统检测** — 首次运行时，应用遵循 `navigator.language`（任何 `zh*` 变体 → zh-CN，否则 en-US）

### 本地化界面
每个用户可见字符串都通过集中式翻译目录流转 — UI 代码中没有分散的条件字符串。

**页面（8）：** 账号、AI Studio、内容编辑器、内容列表、首页、媒体库、发布中心、设置
**组件（3）：** 侧边栏导航、Badge、EmptyState

### 翻译目录
- **267 个扁平键**，跨 16 个命名空间
- **`{param}` 插值**（例如 `t('home.welcome', { name: 'World' })`）
- **键回退** — 缺失翻译回退到键本身（不会抛出异常）
- **受保护术语永不翻译：** YuMatrix、YuMatrix Studio、AI Studio、YouTube、TikTok、OAuth、API、SHA-256

---

## 安全

i18n 层是纯渲染器事务，不接触机密：
- 没有令牌、机密、cookie 或凭证通过翻译传递
- 没有日志或事件携带用户文本
- 语言偏好仅本地保存 — 从不发送到主进程，从不持久化到数据库
- 没有数据库迁移；偏好存储在应用本地偏好中
- OAuth 继续使用系统默认浏览器；无代理注入

---

## 支持的平台（工作流）

| 平台 | 状态 | 说明 |
|------|------|------|
| YouTube | 已实现适配器 | OAuth + 可恢复上传。真实凭证/发布 = 需要所有者操作 |
| TikTok | 目录条目 | 审批待定 — 未实现 |
| 中国平台 | 仅人工交接 | `HumanHandoffAdapter` — 辅助执行 |

---

## 系统要求

| 要求 | 最低配置 |
|------|----------|
| 操作系统 | Windows 10 (x64) |
| 内存 | 推荐 4 GB |
| 磁盘 | 500 MB 可用空间 |
| 网络 | OAuth 和 AI 功能需要 |

---

## 安装

### Windows

1. 下载 `YuMatrix Studio-Setup-0.1.0-beta.2-x64.exe`
2. 验证 SHA-256：`EC2A5529E01041480170B5335A9E9949C72D216310FC97679F9604B14DEE101A`
3. 运行安装程序（每用户安装不需要管理员权限）
4. 启动 YuMatrix Studio — 在设置中选择语言，或让应用从系统检测

---

## 已知限制

这是**私有测试版**。诚实的限制：

- **真实 YouTube 生产验证待定** — 适配器已实现，需要真实 OAuth 凭证
- **TikTok 生产适配器待定** — 未实现
- **中国平台使用人工交接** — 辅助的，非自动
- **macOS 签名待定** — 需要所有者操作（Developer ID）
- **macOS 公证待定** — 需要所有者操作
- **自动更新可能不可用** — 测试版手动更新
- **某些 AI 提供商需要用户配置** — 在设置中设置 API 密钥
- **网络连接取决于用户环境** — 支持代理
- **Windows 代码签名待定** — 未签名的本地构建（预期会有 SmartScreen 警告）

详见 `PRIVATE_BETA_KNOWN_LIMITATIONS.zh.md`。

---

## 测试基线

| 检查 | 结果 |
|------|------|
| 类型检查 | 0 错误 |
| 测试 | 568 通过，5 跳过（36 文件） |
| 构建 | 通过 |
| Windows 构建 | 已验证（上方 SHA-256） |

---

## 构建完整性

| 字段 | 值 |
|------|------|
| 文件名 | `YuMatrix Studio-Setup-0.1.0-beta.2-x64.exe` |
| 大小 | 106,276,013 字节 |
| SHA-256 | `EC2A5529E01041480170B5335A9E9949C72D216310FC97679F9604B14DEE101A` |
| 版本 | 0.1.0-beta.2（package.json / 构建 / 清单一致） |
| 签名 | 否（未签名的本地构建 — 签名需要所有者操作） |

---

**这是受控的私有测试版。不要公开重新分发。**
