From 2e457b9707295d368ceccf85db3204a55bc6bd12 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9D=92=E5=B1=B1=E5=85=AC=E4=BB=94?= Date: Sun, 10 May 2026 14:18:35 +0800 Subject: [PATCH 1/2] =?UTF-8?q?[=E6=96=87=E6=A1=A3]=20-=20=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=E5=BC=80=E5=8F=91=E8=A7=84=E8=8C=83=E6=96=87=E6=A1=A3?= =?UTF-8?q?=EF=BC=8C=E6=95=B4=E5=90=88=E5=85=AC=E5=BC=80=E6=97=A5=E5=BF=97?= =?UTF-8?q?=E4=B8=8E=E5=BA=94=E7=94=A8=E5=86=85=E6=97=A5=E5=BF=97=E8=AF=B4?= =?UTF-8?q?=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...00\345\217\221\350\247\204\350\214\203.md" | 54 ++++++++++++++----- 1 file changed, 41 insertions(+), 13 deletions(-) diff --git "a/\346\226\207\346\241\243/\345\274\200\345\217\221\350\247\204\350\214\203.md" "b/\346\226\207\346\241\243/\345\274\200\345\217\221\350\247\204\350\214\203.md" index 92a5cfc..db3e97b 100644 --- "a/\346\226\207\346\241\243/\345\274\200\345\217\221\350\247\204\350\214\203.md" +++ "b/\346\226\207\346\241\243/\345\274\200\345\217\221\350\247\204\350\214\203.md" @@ -99,6 +99,8 @@ color_card/ │ ├── platform.py # 平台相关工具模块 │ └── theme_colors.py # 主题颜色管理模块（统一颜色管理、主题感知颜色获取） ├── locales/ # 语言包目录 +├── app_log/ # 应用日志目录 +│ └── changelog.json # 应用内更新日志 ├── color_data/ # 颜色数据目录（JSON格式） ├── tests/ # 测试目录 │ ├── __init__.py # 测试模块初始化 @@ -1535,7 +1537,10 @@ website/ # 官网开发目录 ### 14.2 更新日志维护 -**配置文件：** `docs/changelog.json` 和 `website/public/changelog.json` +**配置文件：** + +- **公开日志**：`docs/changelog.json` 和 `website/public/changelog.json`（网站展示） +- **应用内日志**：`app_log/changelog.json`（应用内更新对话框） **数据格式：** @@ -1543,11 +1548,15 @@ website/ # 官网开发目录 { "versions": [ { - "version": "v1.4.1", - "date": "2026-03-02", + "version": "v1.9.0", + "date": "2026-04-26", + "notes": [ + "Windows版本对配置文件区分了安装版与便携版...", + "Mac 版本在这个版本出现了一些兼容性而导致闪退的问题..." + ], "changes": [ - {"category": "问题修复", "items": ["修复问题描述"]}, - {"category": "新增功能", "items": [{"title": "功能名称", "desc": "功能描述"}]} + {"category": "新增功能", "items": [{"title": "功能名称", "desc": "功能描述"}]}, + {"category": "问题修复", "items": ["修复问题描述"]} ] } ] @@ -1556,15 +1565,33 @@ website/ # 官网开发目录 **字段说明：** -| 字段 | 类型 | 说明 | -| :--------- | :----: | :-------------------- | -| `version` | string | 版本号 | -| `date` | string | 发布日期（YYYY-MM-DD） | -| `changes` | array | 更新内容列表 | -| `category` | string | 分类名称（问题修复/界面优化/新增功能等） | -| `items` | array | 条目列表，简单条目用字符串，复杂条目用对象 | +| 字段 | 类型 | 说明 | +| :----------- | :------: | :---------------------------------------- | +| `version` | string | 版本号 | +| `date` | string | 发布日期（YYYY-MM-DD） | +| `notes` | array | 通知列表（可选），仅应用内日志支持 | +| `changes` | array | 更新内容列表 | +| `category` | string | 分类名称（问题修复/界面优化/新增功能等） | +| `items` | array | 条目列表，简单条目用字符串，复杂条目用对象 | + +**公开日志与应用内日志的区别：** + +| 特性 | 公开日志 (`docs/changelog.json`) | 应用内日志 (`app_log/changelog.json`) | +| :----------- | :------------------------------- | :------------------------------------ | +| 用途 | 网站展示 | 应用内更新对话框 | +| 受众 | 所有访客 | 已安装用户 | +| 内容 | 功能介绍、优化项 | 技术细节、临时通知、已知问题 | +| 通知字段 | ❌ 无 | ✅ 有 `notes` 字段 | +| 敏感信息 | ❌ 不应包含 | ✅ 可以包含 | + +**维护要求：** + +1. 发布新版本时，先更新 `app_log/changelog.json`（添加应用内通知） +2. 再更新 `docs/changelog.json` 和 `website/public/changelog.json`（公开日志，去掉敏感信息） +3. 保持公开日志两个文件同步（docs 和 website/public） +4. 分类名称与第13章更新日志分类保持一致 -**维护要求：** 发布新版本时同步更新 `changelog.json`；保持两个文件同步（docs 和 website/public）；分类名称与第13章更新日志分类保持一致。 +**获取逻辑：** 应用优先获取 `app_log/changelog.json`，失败时降级到 `docs/changelog.json`。 ### 14.3 截图更新 @@ -2149,6 +2176,7 @@ def _get_about_text(self): | 版本 | 日期 | 变更内容 | | :--: | :--------: | :------------------------------------------------------------------------: | +| 3.57 | 2026-05-09 | 更新项目结构（1.3节）：新增 app_log/ 目录；更新更新日志维护规范（14.2节）：整合公开日志与应用内日志说明，新增 notes 字段说明 | | 3.56 | 2026-05-08 | 更新项目结构（1.3节）：新增 installer/ 目录，包含 Windows 安装程序相关模块（安装向导、卸载功能、业务逻辑） | | 3.55 | 2026-05-04 | 更新项目结构（1.3节）：新增 core/harmony.py 和 dialogs/harmony_dialog.py | | 3.54 | 2026-04-28 | 更新类型注解规范（3.7节）：因项目要求 Python 3.11+，改用 PEP 585 内置泛型语法（list/dict/tuple），废弃 typing.List/Dict/Tuple/Optional；修正章节编号（3.7.3→3.8.3，3.7.4→3.8.4）；更新5.3.1节：废弃 ImageMediator 中介者模式，改用面板间直接信号连接；从项目结构（1.3节）中删除 image_mediator.py | -- Gitee From 6280e31abbcc8b3f86f6cf319db42fc781146e3f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9D=92=E5=B1=B1=E5=85=AC=E4=BB=94?= Date: Sun, 10 May 2026 14:40:46 +0800 Subject: [PATCH 2/2] =?UTF-8?q?[=E5=86=85=E5=AE=B9=E8=B0=83=E6=95=B4]=20?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=20v1.10.0=20=E6=9B=B4=E6=96=B0=E6=97=A5?= =?UTF-8?q?=E5=BF=97=E5=B9=B6=E6=9B=B4=E6=96=B0=20README=20=E5=BC=80?= =?UTF-8?q?=E5=8F=91=E5=8E=86=E7=A8=8B=E7=BB=9F=E8=AE=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 v1.10.0 更新日志至 docs/、app_log/、website/public/ 三个 changelog.json - 更新 README 中文版和英文版开发历程统计数据（版本 14 个 → 总更新项 177 项） --- README.md | 40 +++++++++---------- app_log/changelog.json | 74 +++++++++++++++++++++++++++++++++++ docs/changelog.json | 69 ++++++++++++++++++++++++++++++++ website/public/changelog.json | 69 ++++++++++++++++++++++++++++++++ 4 files changed, 232 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index ec43bfa..2b56ec9 100644 --- a/README.md +++ b/README.md @@ -45,22 +45,22 @@ |指标 |数据 | |:---|:---| -|发布版本 |13 个版本（v1.0.0 → v1.9.0） | -|开发周期 |80 天 | -|总更新项 |**159 项** | -|平均每版本 |12.2 项 | +|发布版本 |14 个版本（v1.0.0 → v1.10.0） | +|开发周期 |94 天 | +|总更新项 |**177 项** | +|平均每版本 |12.6 项 | **详细分类统计**： |分类 |数量 |说明 | |:---|:---:|:---| -|✨ 新增功能 |**42** |包含首次发布的 9 项核心功能 | -|🔧 问题修复 |**37** |持续修复 Bug，提升稳定性 | -|🎨 界面优化 |**41** |用户体验打磨 | +|✨ 新增功能 |**47** |包含首次发布的 9 项核心功能 | +|🔧 问题修复 |**43** |持续修复 Bug，提升稳定性 | +|🎨 界面优化 |**44** |用户体验打磨 | |⚡ 性能提升 |**12** |缓存机制、启动优化等 | -|📝 内容调整 |**8** |文本、名称等调整 | -|⚙️ 体验优化 |**6** |交互体验改进 | -|🏗️ 代码优化 |**4** |代码结构优化 | +|📝 内容调整 |**10** |文本、名称等调整 | +|⚙️ 体验优化 |**7** |交互体验改进 | +|🏗️ 代码优化 |**5** |代码结构优化 | |🔮 逻辑优化 |**2** |算法逻辑改进 | |🖥️ 平台支持 |**1** |Mac 版本适配 | |📜 许可证完善 |**1** |开源合规性 | @@ -347,22 +347,22 @@ Since the release of v1.0.0 on 2026-02-05, the project has maintained a fast and |Metric |Data | |:---|:---| -|Released Versions |13 versions (v1.0.0 → v1.9.0) | -|Development Period |80 days | -|Total Updates |**159 items** | -|Average per Version |12.2 items | +|Released Versions |14 versions (v1.0.0 → v1.10.0) | +|Development Period |94 days | +|Total Updates |**177 items** | +|Average per Version |12.6 items | **Detailed Category Statistics**: |Category |Count |Description | |:---|:---:|:---| -|✨ New Features |**42** |Including 9 core features from v1.0.0 launch | -|🔧 Bug Fixes |**37** |Continuous bug fixes for stability | -|🎨 UI Improvements |**41** |User experience refinements | +|✨ New Features |**47** |Including 9 core features from v1.0.0 launch | +|🔧 Bug Fixes |**43** |Continuous bug fixes for stability | +|🎨 UI Improvements |**44** |User experience refinements | |⚡ Performance |**12** |Cache mechanism, startup optimization | -|📝 Content Adjustments |**8** |Text, naming adjustments | -|⚙️ Experience |**6** |Interaction improvements | -|🏗️ Code Optimization |**4** |Code structure optimization | +|📝 Content Adjustments |**10** |Text, naming adjustments | +|⚙️ Experience |**7** |Interaction improvements | +|🏗️ Code Optimization |**5** |Code structure optimization | |🔮 Logic Optimization |**2** |Algorithm improvements | |🖥️ Platform Support |**1** |Mac version adaptation | |📜 License Compliance |**1** |Open source compliance | diff --git a/app_log/changelog.json b/app_log/changelog.json index ca7c085..c89dcd2 100644 --- a/app_log/changelog.json +++ b/app_log/changelog.json @@ -1,5 +1,79 @@ { "versions": [ + { + "version": "v1.10.0", + "date": "2026-05-10", + "notes": [ + "Mac版本存在闪退问题已修复", + "有需要什么改进的地方，欢迎大家反馈问题", + "版本存在一些bug，不太适合用于生产环境，后续会慢慢更新。" + ], + "changes": [ + { + "category": "新增功能", + "items": [ + { + "title": "图片处理", + "desc": "双数据架构分离显示与取色，支持 ICC 色彩空间转换，支持对广色域图片进行显示和取色" + }, + { + "title": "色彩分析面板", + "desc": "新增 K-Means 主色调提取算法，支持在设置中切换
支持双模式取色，可选择提取图片原始值或显示值" + }, + { + "title": "配色管理面板", + "desc": "新增导出色卡图片功能
新增色彩和谐度分析功能" + }, + { + "title": "图片导入", + "desc": "支持 Ctrl+V 从剪贴板粘贴图片导入色彩分析、明度分析面板" + }, + { + "title": "系统功能", + "desc": "实现 Windows 自定义安装程序，UI 风格与界面更加统一美观
新增自动检查更新功能，支持每周一次自动检查更新" + } + ] + }, + { + "category": "问题修复", + "items": [ + "修复 Mac 上因无条件导入 win32con 导致程序无法启动的问题", + "修复 Mac 语言跟随系统功能失效问题", + "修复英语语言包语法错误导致无法正确显示的问题", + "修复 HSB 色环采样点初始化缺失导致不显示的问题", + "修复明度分析对话框内直方图 Y 轴刻度与真实值不对应的问题", + "修复对话框标题栏 Logo 模糊问题" + ] + }, + { + "category": "界面优化", + "items": [ + "缩小 HSB 色环采样点尺寸", + "移除对话框中存在的分隔线", + "缩小启动画面尺寸，并优化其显示清晰度" + ] + }, + { + "category": "体验优化", + "items": [ + "更新对话框版本号日期显示优化" + ] + }, + { + "category": "代码重构", + "items": [ + "类型注解升级为 PEP 585/604 内置泛型语法" + ] + }, + { + "category": "内容调整", + "items": [ + "更新日志获取逻辑调整，支持获取更新日志内通知", + "Mac 版本应用显示名称改为中文" + ] + } + ] + }, { "version": "v1.9.0", "date": "2026-04-26", diff --git a/docs/changelog.json b/docs/changelog.json index ca7c085..d39d181 100644 --- a/docs/changelog.json +++ b/docs/changelog.json @@ -1,5 +1,74 @@ { "versions": [ + { + "version": "v1.10.0", + "date": "2026-05-10", + "changes": [ + { + "category": "新增功能", + "items": [ + { + "title": "图片处理", + "desc": "双数据架构分离显示与取色，支持 ICC 色彩空间转换，支持对广色域图片进行显示和取色" + }, + { + "title": "色彩分析面板", + "desc": "新增 K-Means 主色调提取算法，支持在设置中切换
支持双模式取色，可选择提取图片原始值或显示值" + }, + { + "title": "配色管理面板", + "desc": "新增导出色卡图片功能
新增色彩和谐度分析功能" + }, + { + "title": "图片导入", + "desc": "支持 Ctrl+V 从剪贴板粘贴图片导入色彩分析、明度分析面板" + }, + { + "title": "系统功能", + "desc": "实现 Windows 自定义安装程序，UI 风格与界面更加统一美观
新增自动检查更新功能，支持每周一次自动检查更新" + } + ] + }, + { + "category": "问题修复", + "items": [ + "修复 Mac 上因无条件导入 win32con 导致程序无法启动的问题", + "修复 Mac 语言跟随系统功能失效问题", + "修复英语语言包语法错误导致无法正确显示的问题", + "修复 HSB 色环采样点初始化缺失导致不显示的问题", + "修复明度分析对话框内直方图 Y 轴刻度与真实值不对应的问题", + "修复对话框标题栏 Logo 模糊问题" + ] + }, + { + "category": "界面优化", + "items": [ + "缩小 HSB 色环采样点尺寸", + "移除对话框中存在的分隔线", + "缩小启动画面尺寸，并优化其显示清晰度" + ] + }, + { + "category": "体验优化", + "items": [ + "更新对话框版本号日期显示优化" + ] + }, + { + "category": "代码重构", + "items": [ + "类型注解升级为 PEP 585/604 内置泛型语法" + ] + }, + { + "category": "内容调整", + "items": [ + "更新日志获取逻辑调整，支持获取更新日志内通知", + "Mac 版本应用显示名称改为中文" + ] + } + ] + }, { "version": "v1.9.0", "date": "2026-04-26", diff --git a/website/public/changelog.json b/website/public/changelog.json index ca7c085..d39d181 100644 --- a/website/public/changelog.json +++ b/website/public/changelog.json @@ -1,5 +1,74 @@ { "versions": [ + { + "version": "v1.10.0", + "date": "2026-05-10", + "changes": [ + { + "category": "新增功能", + "items": [ + { + "title": "图片处理", + "desc": "双数据架构分离显示与取色，支持 ICC 色彩空间转换，支持对广色域图片进行显示和取色" + }, + { + "title": "色彩分析面板", + "desc": "新增 K-Means 主色调提取算法，支持在设置中切换
支持双模式取色，可选择提取图片原始值或显示值" + }, + { + "title": "配色管理面板", + "desc": "新增导出色卡图片功能
新增色彩和谐度分析功能" + }, + { + "title": "图片导入", + "desc": "支持 Ctrl+V 从剪贴板粘贴图片导入色彩分析、明度分析面板" + }, + { + "title": "系统功能", + "desc": "实现 Windows 自定义安装程序，UI 风格与界面更加统一美观
新增自动检查更新功能，支持每周一次自动检查更新" + } + ] + }, + { + "category": "问题修复", + "items": [ + "修复 Mac 上因无条件导入 win32con 导致程序无法启动的问题", + "修复 Mac 语言跟随系统功能失效问题", + "修复英语语言包语法错误导致无法正确显示的问题", + "修复 HSB 色环采样点初始化缺失导致不显示的问题", + "修复明度分析对话框内直方图 Y 轴刻度与真实值不对应的问题", + "修复对话框标题栏 Logo 模糊问题" + ] + }, + { + "category": "界面优化", + "items": [ + "缩小 HSB 色环采样点尺寸", + "移除对话框中存在的分隔线", + "缩小启动画面尺寸，并优化其显示清晰度" + ] + }, + { + "category": "体验优化", + "items": [ + "更新对话框版本号日期显示优化" + ] + }, + { + "category": "代码重构", + "items": [ + "类型注解升级为 PEP 585/604 内置泛型语法" + ] + }, + { + "category": "内容调整", + "items": [ + "更新日志获取逻辑调整，支持获取更新日志内通知", + "Mac 版本应用显示名称改为中文" + ] + } + ] + }, { "version": "v1.9.0", "date": "2026-04-26", -- Gitee