主题
晞晗IM（XHIM）产品标识规范
状态：Core 与平台技术标识已冻结；正式签名主体由发布证据确认。
本文是仓库内名称、代码标识和发行制品的唯一命名依据。新增模块、示例、文档 和自动化脚本不得自行创造另一套产品前缀。
已冻结标识
| 使用场景 | 标识 |
|---|---|
| 中文展示名 | 晞晗IM |
| 英文产品名 | XHIM |
| C/C++ 小写前缀 | xhim |
| C++ namespace 根 | xhim |
| 公共 include 根 | xhim/ |
| 稳定 C ABI 头文件 | xhim/xhim_v1.h |
| 稳定 C ABI 符号前缀 | xhim_v1_ |
| CMake package | XHIM |
| 普通消费 Target | XHIM::XHIM |
| 核心动态库 basename | xhim_core_v1 |
| Protobuf package | xhim.protocol.v1 |
| Protobuf 文件 | xhim_sync_v1.proto |
| 默认示例数据库 | xhim-demo.db |
产品文案首次出现时使用“晞晗IM（XHIM）”；已经建立上下文后可以简称 “XHIM”。代码、包管理和制品名称只使用 ASCII 标识，避免不同文件系统、编译器 和包管理器对 Unicode 名称处理不一致。
平台标识
平台 SDK 使用组织控制的 xihansoftware.com 反向域名和 XHIM 产品名：
| 平台 | 已冻结的 SDK 技术标识 |
|---|---|
| iOS | Swift Package：XHIMSwift；Module/Pod：XHIM、XHIMSwiftUI |
| macOS | Swift Package：XHIMSwift；Module/Pod：XHIM、XHIMSwiftUI |
| Android | Maven Group/namespace：com.xihansoftware.xhim；Artifact：xhim-sdk、xhim-ui-compose |
| Windows | NuGet：XHIM.SDK、XHIM.UI.Wpf；namespace：XHIM |
| HarmonyOS | OHPM：@xihansoftware/xhim；module：xhim |
| Flutter | pub package：xhim_flutter |
| Electron | npm package：@xihansoftware/xhim-electron |
客户 App 的 Bundle/Application ID 由客户自行决定，SDK 不强制占用。XHIM Demo、测试宿主和构建宿主使用 com.xihansoftware.xhim.*。正式签名证书主体、 Apple Team、商店/包管理账号、仓库权限和下载域名所有权仍必须由每次发布证据 证明；源码中的字符串不能代替账号或证书所有权。
协议生成 namespace 属于 Wire/源码兼容合同。若未来调整，必须先完成描述符和 生成代码兼容性评估，不得在已发布版本上直接替换。
兼容规则
- 已发布的 C ABI 符号、动态库名和 include 路径不能仅因市场文案变化而改名。
- 已持久化的内部 ID 前缀属于数据兼容合同。新版本可以采用 XHIM 前缀，但必须 继续读取并保护历史前缀，不能让业务方复用。
- Protobuf 字段号、enum 数值、SQLite Schema 版本和已有数据字段不随品牌变化。
- CI 的品牌一致性门禁只允许明确登记的历史存储前缀，不允许旧品牌重新进入 公共 API、包名、文档或制品。
- 若未来发生公司级品牌变更，必须先设计兼容层和迁移周期，不能直接做全仓文本 替换。