From 29f039055448dc66b5d76657348f481b28d4e321 Mon Sep 17 00:00:00 2001
From: Ariver <ar@MacBook-Air.local>
Date: Wed, 06 May 2026 16:58:52 +0800
Subject: [PATCH] checkpoint: v3.0.6 — 创建 CHANGELOG.md，记录 v1.1.3~v3.0.6 全部版本变更

---
 CHANGELOG.md |   62 +++++++++++++++++++++++++++++++
 1 files changed, 62 insertions(+), 0 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..44ba431
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,62 @@
+# Apptag Changelog
+
+## [3.0.6] — 2026-05-06
+- 新增标签输入行显示在标签列表最上面第一行
+- Settings Tags 标签页排序改用 tagOrder（新建标签确认后留在顶部）
+
+## [3.0.5] — 2026-05-06
+- `createTag` 和 `assignTag` 中 `tagOrder.append` → `tagOrder.insert(at: 0)`，新建标签始终在列表最上面
+
+## [3.0.4] — 2026-05-06
+- 新增 **Hide app names** Toggle（Preferences → General → 最后一行），Flat/Container 双模式均支持隐藏 APP 名称
+- 去掉 General 标签页中 "Appearance"、"Layout" 两个 section header
+- 修复新建 tag 消失的 bug：`addNewTag` 调用 `TagEditor.createTag` 持久化到数据库
+- 每次进入编辑模式强制从数据库刷新 tagColors 和 draggedTagNames
+- 编辑模式标签名强制单行 + 中间截断（`.truncationMode(.middle)`）
+
+## [3.0.3] — (已回滚)
+- 尝试等行高 LazyVGrid 布局 → 用户不满意，回滚至 3.0.2
+
+## [3.0.2] — 2026-05-06
+- 容器样式改为瀑布流布局（Pinterest-style）：GeometryReader + HStack + LazyVStack，按最短列分配，16pt 等距间隙
+- 容器名强制单行 `.lineLimit(1)` + `.truncationMode(.middle)`
+- 标签拖拽排序最终方案：`onDrag`/`onDrop`（放弃 List+.onMove，因 macOS 不原生支持且导致无法退出编辑）
+
+## [3.0.1] — 2026-05-06
+- 新增容器显示样式：Preferences → General → "App list style" → Flat / Container
+- Container 模式：每个 tag group 包在圆角矩形框内，`ultraThinMaterial` 背景，app 图标网格自动适配
+
+## [2.0.2] — 2026-05-06
+- 标签拖拽排序：编辑模式左侧标签列表支持 `onDrag`/`onDrop` 拖拽重排
+- 新增 `tagOrder` 字段持久化到数据库，`AppIndexer.group()` 按自定义顺序排列分组
+
+## [2.0.1] — 2026-05-06
+- 确认导出已包含完整 app-tag 映射信息（`tags` + `appTags`）
+
+## [2.0] — 2026-05-06
+- **架构级变更**：标签完全脱离 Finder，独立存储在本地 JSON 数据库 `~/Library/Application Support/Apptag/tags.json`
+- 首次启动一次性导入 Finder 存量标签（含"Mac自带"），之后不再触碰 Finder xattr
+- 所有 CRUD（assign/rename/delete/setColor）写入本地 DB
+- Preferences → Data 标签页：Export / Import JSON 备份恢复
+- `DismissibleHostingView.mouseDown` 递归搜索 `TextFieldContainer`/`NSTextField`
+- 编辑模式直接进入 Edit App Categories（去掉 tag 编辑选择页）
+
+## [1.1.6] — 2026-05-06
+- xattr 写入失败时通过 `osascript` + `administrator privileges` 弹出系统认证窗口重试
+- SIP 保护路径检测并提示
+
+## [1.1.5] — 2026-05-06
+- 去除编辑模式中 tag 编辑选择页，直接进 Edit App Categories
+- 修复 Settings 中 tag 重命名产生重复标签的 bug
+
+## [1.1.4] — 2026-05-05
+- `TagEditorView` 可复用 tag CRUD 组件
+- `TextFieldContainer` 模式解决 NSTextField 焦点问题
+- `DismissibleHostingView` 点击转发优化
+- 编辑模式 Ctrl+E、标签位置 left/right/top
+
+## [1.1.3] — 初始
+- macOS menubar 应用，SwiftUI+AppKit，swiftc 编译
+- Carbon 全局热键 Shift+Option+Space
+- Finder 标签读取、分组显示、全屏 overlay
+- 标签编辑（与 Finder xattr 同步）

--
Gitblit v1.9.3