From 0badb998147135c75187a0c48f926b665af734c5 Mon Sep 17 00:00:00 2001 From: Ariver <shanghai3168@gmail.com> Date: Sun, 28 Jun 2026 02:53:51 +0800 Subject: [PATCH] Release 8.1.6 build 20260628.0230 --- CODEGRAPH.md | 17 ++++++++++++----- 1 files changed, 12 insertions(+), 5 deletions(-) diff --git a/CODEGRAPH.md b/CODEGRAPH.md index b03aae7..60ce67c 100644 --- a/CODEGRAPH.md +++ b/CODEGRAPH.md @@ -19,6 +19,7 @@ - `src/Apptag/ApptagApp.swift` - `TagLauncherApp`：SwiftUI App 入口。 - `AppDelegate`：菜单栏状态项、Dock 显示策略、热键注册、窗口打开、Quick Search 触发、App 生命周期。 + - 支持外部 URL 唤起 `taglauncher://show`：只做 AppGrid show/focus，不做 toggle；冷启动时请求会排队到初始化完成后执行；不接管原生触控板手势。 - 支持从标签导航双击进入设置页的 Tags tab。 - 启动时初始化 `ProEntitlementCenter`，保证免费 / Pro / 老用户自动 Pro 状态进入全局同步快照。 - 菜单栏下拉菜单包含免费 / Pro 当前身份状态项；免费状态点击进入 About 页的 Pro 卡片，Pro 状态使用金色皇冠图标。 @@ -34,6 +35,7 @@ - `src/Apptag/PreferencesView.swift` - `PreferencesView`：设置窗口、语言、通用、主题、快捷键、标签、数据、关于等设置页。 - Theme tab 只写视觉偏好 `appGridThemeID`，不得改变标签、排序、备注或分类数据。 + - 免费用户预览 Pro 主题时，Theme tab 状态行和当前预览主题卡片显示基于 `ProThemePreviewState.endsAt` 推导的 `MM:SS` 倒计时；倒计时到期只退出预览，不弹阻塞提示。 - Pro 升级 / 权益卡位于 About tab；Data tab 只承载分类方案、导入导出和气泡显示位置等数据管理入口。 ## AppGrid 显示与交互 @@ -95,8 +97,8 @@ - `src/Apptag/SmartCategorization/SmartCategory.swift` - 内置智能分类定义。 - - `SmartCategoryDefaults.orderedIDs` 是 SmartStart 默认初始化标签事实源；当前默认方案为 13 个标签。 - - `SmartCategoryID.smartStartDefaultCategoryID` 负责把旧细分 catalog 分类归并到 13 个默认标签；`finance` 和 `other` 返回 nil，回到未分类；这是新 SmartStart 写入前的归并，不做老用户旧标签自动迁移。 + - `SmartCategoryDefaults.orderedIDs` 是 SmartStart 默认初始化标签事实源；当前默认方案为 12 个标签。 + - `SmartCategoryID.smartStartDefaultCategoryID` 负责把旧细分 catalog 分类归并到 12 个默认标签；`Meeting` 归入 `communication`，`finance` 和 `other` 返回 nil，回到未分类；这是新 SmartStart 写入前的归并，不做老用户旧标签自动迁移。 - `src/Apptag/SmartCategorization/SmartCategorizationDraft.swift` - 智能分类草稿、默认备注 provenance、未分配应用和 warning 模型。 - `src/Apptag/SmartCategorization/SmartStartService.swift` @@ -121,7 +123,7 @@ ## 构建与发布 - `src/Apptag/Info.plist` - - App 版本、build、bundle metadata。 + - App 版本、build、bundle metadata；注册公开 URL Scheme `taglauncher`，首期路由只支持 `taglauncher://show`。 - `src/Apptag/TagLauncher.entitlements` - App sandbox / entitlement 配置。 - `src/build.sh` @@ -148,7 +150,7 @@ - `src/Scripts/smart_category_localization_qa.sh` - SmartCategory/default system tag 初始化标签 29 语种本地化检查；禁止非英文语言包直接复制英文标签，保留 `PDF`、`DevOps` 等技术通用词例外。 - `src/Scripts/smartstart_default_categories_qa.sh` - - SmartStart 默认初始化标签检查；验证 13 个默认分类、catalog 分类归并入口、`finance` / `other` 回未分类、首次 starter tags 和关键多语言目标文案。 + - SmartStart 默认初始化标签检查；验证 12 个默认分类、catalog 分类归并入口、`Meeting` 归入 `communication`、`finance` / `other` 回未分类、首次 starter tags 和关键多语言目标文案。 - `src/Scripts/quick_search_app_name_qa.sh` - Quick Search 应用显示名回归。 - `src/Scripts/quick_search_system_app_qa.sh` @@ -163,14 +165,18 @@ - Pro 文案 29 语种静态门禁；检查 `pro.*` 键完整、占位符完整、无生成污染和非英文语言无英文兜底复制。 - `src/Scripts/pro_feature_gate_qa.sh` - Pro 功能源码门禁；检查 StoreKit 权益、老用户自动 Pro、主题门禁、导入导出硬拦截、备注额度、排序预览和 Pro UI 提示。 +- `src/Scripts/pro_theme_preview_countdown_qa.sh` + - Pro 主题预览倒计时门禁；检查状态行倒计时、当前预览卡片 `MM:SS`、到期清理、29 语种 `%time%` 占位符和禁止写死体验时长。 - `src/Scripts/appgrid_startup_loading_qa.sh` - AppGrid 快照复用和延迟转圈回归。 +- `src/Scripts/url_scheme_activation_qa.sh` + - 外部 URL 唤起门禁；检查 `taglauncher://show` 注册、AppDelegate show/focus 语义、冷启动 pending、29 语种设置文案和禁止私有触控板捕获。 - `src/Scripts/usage_tips_qa.sh` - AppGrid 使用技巧 AppKit 横幅、主题可读性、防穿透、关闭按钮、29 语种文案回归。 - `src/Scripts/usage_tips_close_reminder_qa.sh` - 使用技巧关闭提醒、modal 防穿透、设置页预览、29 语种文案回归。 - `src/Scripts/window_logic_qa.sh` - - 窗口层级、显示隐藏、Dock/菜单栏相关逻辑回归。 + - 窗口层级、显示隐藏、Dock/菜单栏相关逻辑回归；Dock 项断言按当前 QA 构建路径过滤，避免本机固定正式版 App 时误判重复图标。 - `src/Scripts/app_ordering_data_qa.sh` - App 排序数据持久化回归。 @@ -212,3 +218,4 @@ - 改 `DataLayer.swift` 通常会影响应用扫描、显示名、标签数据、导入导出和迁移，必须补数据 QA。 - 改 `PreferencesView.swift` 通常需要检查 29 个本地化 JSON、设置持久化和 macOS 14 UI 表现。 - 改 `ApptagApp.swift` 或 `OverlayWindowController.swift` 必须回归菜单栏、Dock 图标策略、热键、窗口层级、全屏/Split View 行为。 +- 改外部 URL 唤起、`Info.plist` URL Scheme 或第三方手势说明时，必须运行 `url_scheme_activation_qa.sh`，并确认不新增 Accessibility/Input Monitoring/private multitouch 依赖。 -- Gitblit v1.9.3