品牌命名与标识
统一品牌为「维刻 Vex」,slogan 为「写下想法,看见脉络」。
大小写约定
Dart 标识符区分大小写。Windows 文件系统通常不区分路径大小写,但 Linux、Android 及 CI 构建环境不能依赖这一行为。
| 用途 | 命名 |
|---|---|
| 品牌、标题、分发安装包 | Vex / 维刻 Vex |
| Dart 类型 | VexApp 等 UpperCamelCase |
| Dart 包、文件、目录、Linux 命令 | vex、vex_editor、vex_markdown_core、vex_mindmap |
| 原型页面、Windows 安装脚本 | Vex.html、Vex-Adaptive.html、Vex-Installer-*.html、Vex.iss |
| 环境变量与 JavaScript 全局常量 | VEX_* |
| Android namespace / applicationId | com.codewf.vex,preview 使用 .preview 后缀 |
| iOS / macOS Bundle ID、Linux 应用 ID | com.codewf.vex |
| Windows / Linux 可执行文件 | vex.exe / vex |
| macOS 应用与可执行文件 | Vex.app / Vex |
安装与数据边界
当前按全新开发维护,只使用表中的平台标识与命名,不维护旧应用身份、旧品牌入口或配置格式的迁移逻辑。稳定后再明确兼容与升级策略。Android 不同包名的应用可并存;不能假设旧设置目录会被新应用复用。
更新前先在旧应用中将未保存内容另存为 Markdown,再在新应用中打开原文件并按需重新配置偏好设置。确认文档无误后再卸载旧应用,不要先卸载再尝试找回恢复草稿。普通 Markdown 文件本身不改名、不转换、不删除。
Windows 当前安装标识为固定 AppId {51E79E85-AD4C-4D48-92EC-C1EA09FB4E56},安装目录为 Vex;程序文件名及 Markdown ProgID 分别为 vex.exe 和 Vex.Markdown。固定安装身份用于正常安装 / 修复 / 卸载,不代表承诺配置格式兼容。如需文件关联,安装时勾选相应选项,并按 Windows 系统要求选择默认应用。
内部包及公开 Dart 入口已一并更名,宿主项目需要同步修改依赖与 package: 导入,没有保留旧包名别名。原型入口也已更名,需要从 design/index.html 打开新链接;旧原型本地偏好不会迁移。
历史验证文档中的源码路径和品牌引用已统一为当前名称;旧版本的二进制产物、历史提交、测试证据和本机外部 SDK 不会被改写。当前版本以 apps/vex/pubspec.yaml 为准,发布记录见 GitHub Releases。
防止回流
scripts/tests/test_brand_contract.py 检查当前源码文件名、内容、内部包入口与平台身份;CI 会运行该检查。构建缓存、签名材料、Git 历史及忽略的本地证据不属于源码扫描范围。
有疑问或建议,欢迎到 GitHub 提交 Issue 参与讨论。