chore(release): 0.4.0

Author: LuSrackhall

CHANGELOG.md

@@ -1,3 +1,76 @@
+#  (2025-02-17)
+
+
+### Bug Fixes
+
+* 对导出专辑 按钮的具体功能逻辑, 进行了重构。直接依赖前端的下载功能。 不再使用上传某个文件来获取路径的方式(需要依赖electron的api)交由sdk来保存。 ([225aeef](https://github.com/LuSrackhall/KeyTone/commit/225aeef6f1a017e199cc23220a4ebf3581d8c01e))
+* 修复 导出专辑 时, 压缩的文件夹改变了原始文件夹根目录名称的bug ([968654c](https://github.com/LuSrackhall/KeyTone/commit/968654c03f835f47676ccbf99177945426cad1cd))
+* 修复导出专辑时, 用户还未选择保存的路径, 就弹窗导出成功通知的bug。(本次修复选择使用 File System Access API 替代当前的 download 属性方案) ([f751aa4](https://github.com/LuSrackhall/KeyTone/commit/f751aa4871a5c694c52ad669a7142871f7feb474)), closes [#61](https://github.com/LuSrackhall/KeyTone/issues/61)
+* 修复了带芯片的选择器组件, 受h-5.8影响, 无法显示完全, 以及显示纵向滚动条的bug。 ([d6906d5](https://github.com/LuSrackhall/KeyTone/commit/d6906d5b65bd43d18505faf50aeaa956a64eb926))
+* 修复了上传专辑覆盖现有专辑时, 若被覆盖是已选择专辑时, ui没有更新的bug, 且优化了更新时机。另外,  添加获取专辑文件元数据的功能，支持上传并验证专辑文件格式，返回相关元数据信息。 ([32b81f8](https://github.com/LuSrackhall/KeyTone/commit/32b81f8abaf0a391837e8dcae675aec84545c2ac))
+* 修复删除专辑时, 若删除的是最后一个专辑, 响应的专辑列表仍有不可用残留的bug。 ([be7ebdb](https://github.com/LuSrackhall/KeyTone/commit/be7ebdb135048db032de418cefefba7d612fbb61))
+* **frontend:** 修复了潜在的bug。即当用户所选的键音包受到外部破坏(比如被恶意删除)后, 在重新加载页面时仍会看到一个名称为空白的假性不可用键音包的bug。 ([372f8b7](https://github.com/LuSrackhall/KeyTone/commit/372f8b762541f4bea15c15bfc6387152b43ef05b))
+* **sdk:** 调整临界区, 以继续根除sdk可能产生的死锁或其它意外情况。 ([c5b48e9](https://github.com/LuSrackhall/KeyTone/commit/c5b48e9619f8f6d0eb0ab21f7c960abcc132e633))
+* **sdk:** 对于所加载键音包路径不存在的情况, 应该回收Viper这个全局变量, 以免发生未知的错误。 ([3b40784](https://github.com/LuSrackhall/KeyTone/commit/3b407840275532050cffa68bb34d34eac0f2ad76))
+* **sdk:** 修复了因上次修复引发的新bug。即当Viper==nil时造成panic引发sdk崩溃的问题。 ([21908e6](https://github.com/LuSrackhall/KeyTone/commit/21908e6f71e1cd8683a79517f334caf7a1b5856f))
+* **sdk:** 修复了sdk的panic问题。重新梳理了键音包模块的生命周期, 以及并发的临界区, 删除了不需要的判断, 以及对必要的临界区进行上锁操作, 以避免panic的风险。 ([226384b](https://github.com/LuSrackhall/KeyTone/commit/226384b6eb888eca0276e2488be41e3b33d5fcae))
+* **ui:** 1.修复了编译已有声音的选择框, 在没有任何选择时, 样式过窄的问题;2 修复了 选择后, 内部关于源文件的选择框 名字过长时的溢出问题。 ([8f48a5a](https://github.com/LuSrackhall/KeyTone/commit/8f48a5a44571e30d445fab695e19f1709d3079dc))
+* **ui:** 进一步修复了上个提交中的问题。本次修复位置迁移值sse回调是由于历史问题的积累造成的->函数initData()中初次主动获取并初始化这一操作的内部生命周期,因长期忽视维护, 使得目前变得难以管理。(若后续有相关bug报告, 则仍需迁回处理, 且需要处理的不止此一项) ([06961ce](https://github.com/LuSrackhall/KeyTone/commit/06961ce059ceaa4a732b28f7937d411345bd6f4e)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 进一步修复前两个提交中的问题。本次修复是因为当全键已选择声音存在源文件(soundFileList)时, 会由于源文件的生命周期更新延迟造成错误的问题(上上个提交的注释中介绍过)。(解决方案:直接在initData中完善此字段的初始化以补全其生命周期。) ([ce1d101](https://github.com/LuSrackhall/KeyTone/commit/ce1d101d6762f25806c6c2a5e3d6dfcec6bd1ca1)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 临时修复了 编辑键音专辑时, 按键联动声效的全键声效设置对话框中, 相关配置初始化缺失不符合真实配置的问题。 ([55be04c](https://github.com/LuSrackhall/KeyTone/commit/55be04cf7575aec449d17377814e6ba6f2f29924)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 明确键音专辑初始化的必要内容,明确其生命周期,保证连续创建键音包时,不会错误的中止正在初始化的键音专辑。同时对于初始化的键音专辑,在初始化完成之前不予展示(此时展示加载动画)。 ([18b59d5](https://github.com/LuSrackhall/KeyTone/commit/18b59d53d9e19fc1f1c37e517007de0d62c348fc))
+* **ui:** 通过deep,进一步修复了主页面中, 选择键音名称过长时引发界面异常的问题。(本次修复主要解决了label溢出过了选择框内关闭按钮后, 且滚动时会带着选择框整体一起滚动的问题) ([ab27938](https://github.com/LuSrackhall/KeyTone/commit/ab2793877d570cf871d48a7b21b1adf73165bd10))
+* **ui:** 修复键音专辑页面上唯一的选择组件, 因所选键音专辑名称过长而造成的横向页面溢出问题。(这是与刚刚修复的主页面的选择组件相同的问题) ([ab9a6a4](https://github.com/LuSrackhall/KeyTone/commit/ab9a6a4b61f23d2a2012b6f3a7ceae6ca96b3768))
+* **ui:** 修复键音专辑页面中,切换键音包后,发生的错误的初始化问题。(本次错误是因为: 漏掉了持久化中 按下测试音/抬起测试音 相关字段的初始读取, 并错误的按照默认数据给重新进行了初始化) ([3d705a9](https://github.com/LuSrackhall/KeyTone/commit/3d705a996128c1e9a8399d8cf2b5637630f9ff01)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 修复了 编辑对话框(如音频文件、声音、按键音)中, 因右上角名称过长造成的溢出问题。(对声音和按键音的问题通过移除组件处理, 对音频文件采取仅显示后缀名称来处理。) ([ba67f28](https://github.com/LuSrackhall/KeyTone/commit/ba67f28619d9ef52bb763fc948d2da0129b04f64))
+* **ui:** 修复了按键联动声效步骤条在关闭后, 对当前步骤是否被操作过会作出错误判断的问题。 ([385608d](https://github.com/LuSrackhall/KeyTone/commit/385608dada66c5a1d69adc18f563a0b988573ae9)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 修复了创建键音包时, 初始化过程被打断而造成创建的键音包不可用的bug。 ([3aeb848](https://github.com/LuSrackhall/KeyTone/commit/3aeb848564f2c80f4cf00bb6e3e8dd52db49ed6b))
+* **ui:** 修复了从选择框删除所选键音专辑后, 键音专辑组件未随之消失的bug。 本次提交中还包含了预防键音专辑组件在创建新专辑过程中的重复渲染bug。 ([53213af](https://github.com/LuSrackhall/KeyTone/commit/53213afc6d618e1a4ac63b5eb3415123e1c0d4ae))
+* **ui:** 修复了键音专辑页面, 在切换键音包后失去滚动监听的bug。这个bug造成了预期的向下滚动触发收起按钮 以及 在顶部向上滚动触发展开按钮的触发 的逻辑 变得失效。 ([f2749e7](https://github.com/LuSrackhall/KeyTone/commit/f2749e784f94fd5b149bfb8d4306d70e853762af)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 修复了键音专辑页面顶部选择器在某些情况下被下方键音专辑组件覆盖的问题。复现方式->对滚动到底后, 点击展开按钮。 ([53533a0](https://github.com/LuSrackhall/KeyTone/commit/53533a0dd8f744ee046e2547297c9acfdb121a90))
+* **ui:** 修复了可能存在的潜在的内存泄漏问题。(对键音专辑组件中, 所创建的侦听器, 在组件卸载前进行删除操作) ([b4ecfbd](https://github.com/LuSrackhall/KeyTone/commit/b4ecfbdcd47e4d7f017aa71c6565ef4291a41af0))
+* **ui:** 修复了连续创建键音包时的bug。这个bug会使得从创建第二个键音包开始, 将新内容错误的赋给上一个键音包。 ([665b14c](https://github.com/LuSrackhall/KeyTone/commit/665b14c3327795be3ea7acf7e70e8bab23290163))
+* **ui:** 修复了刷新页面后造成的之前 为 quasar选择器菜单中的选项, 添加的细微滚动条消失, 退回换行策略的bug。 ([6743096](https://github.com/LuSrackhall/KeyTone/commit/6743096f049807a3bef3015d1f598ee7b844cfb8))
+* **ui:** 修复了刷新页面后造成的之前 为 quasar选择器添加的滚动条 消失且样式重新溢出的bug。 ([1f612b6](https://github.com/LuSrackhall/KeyTone/commit/1f612b61dd066ae8b450dbcd27d6caab517adb0e))
+* **ui:** 修复了音频专辑组件中, 步骤框内部, 普通选择框的文字溢出问题。 对于带芯片的多选框, 将原有省略号策略改为溢出滚动策略。 ([35d84b8](https://github.com/LuSrackhall/KeyTone/commit/35d84b85f0bd65486fd478726274a5958a8284a8))
+* **ui:** 修复了音频专辑组件中, 步骤框上方的专辑名称显示会因名称过长而溢出的问题。(采用不换行+溢出滚动的策略)(注意, 对于quasar的输入器来说, 不换行+溢出滚动的策略是自带的) ([3e3fc50](https://github.com/LuSrackhall/KeyTone/commit/3e3fc502b18164b492629b91988c819aa7b81575))
+* **ui:** 修复了q-select选择器的弹出菜单, 普遍存在的当选项名称过长时的溢出问题。另外, 本次提交还统一了q-select选择其弹出菜单的滚动条样式, 弃用了默认的经典滚动条样式。 ([b63cdde](https://github.com/LuSrackhall/KeyTone/commit/b63cdde8d2befe8123ccee9aa7f81da8645dff7f))
+* **ui:** 修复了q-select选择器的弹出菜单, 普遍存在的英文内容过长时超出部分无法正常显示的bug。(中文会自动换行) 本次修复方案是, 使得所有字体的内容都遵循超出自动换行的策略。 ([36ecac8](https://github.com/LuSrackhall/KeyTone/commit/36ecac8c9c8535738eb05a3d8f542690e861b62a))
+* **ui:** 修复主页面q-select选择器的弹出菜单(目前使用的对话框模式)中, 最上方已选择部分因所选项的名称过长的超出部分溢出的问题。 ([d106b98](https://github.com/LuSrackhall/KeyTone/commit/d106b98204ed9c375b635bb0dfb39ab357c82fbb))
+* **ui:** 修复主页中, 选择的键音专辑名称过长时引发的页面样式异常的bug。(采取不换行+溢出滚动的策略) ([2c81c63](https://github.com/LuSrackhall/KeyTone/commit/2c81c6340b957624096c9640786409676e1369cd))
+* **ui:** 在创建键音包期间, 禁用选择器, 以避免引发类似连续创建时的问题。 ([88bb2b2](https://github.com/LuSrackhall/KeyTone/commit/88bb2b235ce49751503d3af3d583a63f40791da2))
+* **ui:** 在创建键音包期间, 应禁止可能造成创建中止问题的一些按钮。 (不过做的可能有些过度了, 不过先加上, 后续再考虑是否删除吧) ([6ac55cb](https://github.com/LuSrackhall/KeyTone/commit/6ac55cb5cddcf8fea311e299b1c1bce910f35381))
+* **ui:** 在键音专辑页面中, 删除按键联动音效设置中单键声效设置对话框的不符合设计的"确定"和"取消"按钮, 改为更合适单独的"Close"按钮。 ([8a31d4e](https://github.com/LuSrackhall/KeyTone/commit/8a31d4e05b5baae7a6a35504621ff4f6b0cffe09)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+
+
+### Features
+
+* 实现 .ktalbum 文件格式，包含加密和验证 ([575351a](https://github.com/LuSrackhall/KeyTone/commit/575351a64022a8f193d1c7d2f3b8d75eea0f0bd2))
+* 实现了 导出专辑 按钮的具体功能。 ([485b8df](https://github.com/LuSrackhall/KeyTone/commit/485b8df361b2224e376bd786fb14d91696a61df3))
+* 实现了 导入专辑 按钮的实际功能。 ([6fe8936](https://github.com/LuSrackhall/KeyTone/commit/6fe8936c290db5335171f6ba7b5c6a7b16183e8a))
+* 添加专辑覆盖导入功能，处理已存在专辑的情况。现在可以在专辑已存在时, 选择覆盖导入或是取消导入, 而不是直接报错。 ([ef50487](https://github.com/LuSrackhall/KeyTone/commit/ef504875ab655f8885497d81711492bb3a6277e1))
+* 添加专辑元数据支持，优化导入专辑验证逻辑 ([1d58f48](https://github.com/LuSrackhall/KeyTone/commit/1d58f48ff08d3e9d46257bc638e9291ad563208a))
+* 完善键音专辑页面, 删除当前专辑的按钮的功能。 ([caefec4](https://github.com/LuSrackhall/KeyTone/commit/caefec45442675767c2b02560a1b35fb6acad1cc))
+* 为导入专辑遇到已存在的情况, 添加导入专辑为新专辑的功能，允许用户在导入时选择覆盖、保存为新专辑或取消导入。 ([865eaa3](https://github.com/LuSrackhall/KeyTone/commit/865eaa3092c85bb304e7364d8b566d0236ded847))
+* 为键音专辑页面, 添加键音专辑选择器的空状态提示和相关样式，优化用户体验。 ([2db2e67](https://github.com/LuSrackhall/KeyTone/commit/2db2e671a351fe9674f6c55d3c6e4199c9c62490))
+* 为主页面, 添加键音专辑选择器的空状态提示和导航功能，优化用户体验 ([09620b3](https://github.com/LuSrackhall/KeyTone/commit/09620b31d8a8d48e9dbbd75fdc874055fc50bdb4))
+* 重新实现新设计的键音专辑页面中, 创建键音包按钮的功能。 ([c391399](https://github.com/LuSrackhall/KeyTone/commit/c3913999a29e54d769093be3b9300efbb3f6d865))
+* **tools:** 初始化 ktalbum-tools CLI 工具，实现文件解包功能 ([640a0de](https://github.com/LuSrackhall/KeyTone/commit/640a0dece640f5ecc63f279aa7214d838a4e375f))
+* **tools:** 添加 Web 服务和前端界面到 ktalbum-tools ([3cb5bb2](https://github.com/LuSrackhall/KeyTone/commit/3cb5bb229b6893db5aecbbed18c4dbe8f46c61cc))
+* **tools:** 增强文件信息检索并添加文件完整性检查 ([a22b2b8](https://github.com/LuSrackhall/KeyTone/commit/a22b2b83830c4ca61018f763e0e4849c30d13178))
+* **ui:** 对quasar选择器菜单中的选项, 不再采取换行方案, 而是改为滚动方案, 并新增了对应样式的细微滚动条, 以方便用户查看。 ([44dc336](https://github.com/LuSrackhall/KeyTone/commit/44dc336687f45e4c1f9cc4e2fd4012864deafdda))
+* **ui:** 放弃旧的键音专辑页面的设计, 改用新设计的键音专辑页面。 ([a6b4d14](https://github.com/LuSrackhall/KeyTone/commit/a6b4d14349aee00424e6fb3a7661829316372229)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+* **ui:** 为键音专辑组件中, 编辑对话框(如音频文件、声音、按键音)的管理选择器, 添加清除所选项的功能。 ([5e9f601](https://github.com/LuSrackhall/KeyTone/commit/5e9f601a42e4e718ebce89b17eb90c74fdcbb1da))
+* **ui:** 为所有页面中的 quasar 选择器 的 输入框 添加 符合 选择器样式的 滚动条。 ([5f14469](https://github.com/LuSrackhall/KeyTone/commit/5f144692092e12398b7b3807a0efa833cd0a838e))
+* **ui:** 新增 键音专辑的  创建、导入、导出、删除 等四个功能按钮。 ([dcc3a1a](https://github.com/LuSrackhall/KeyTone/commit/dcc3a1a6c07dd292847e474f18e27663e3b4b92a))
+
+
+### Reverts
+
+* Revert "chore(ui): 因上方组件收起会引发下方组件向上靠拢, 而这个靠拢是没有动画的, 本次提交就是为其添加动画。" ([9ea8478](https://github.com/LuSrackhall/KeyTone/commit/9ea8478a576fb20d399b1b5bdf4ad336026c3837)), closes [#55](https://github.com/LuSrackhall/KeyTone/issues/55)
+
+
+
 #  (2025-01-29)
 
 

docs/docs/.vitepress/config/en.mts

@@ -81,6 +81,7 @@ function sidebarChangelog() {
       text: "Changelog",
       items: [
         // { text: "v0.2.0", link: "/v0.2.0" }, // 最新的changelog, 往上写就好了
+        { text: "v0.4.0", link: "/v0.4.0" },
         { text: "v0.3.6", link: "/v0.3.6" },
         { text: "v0.3.5", link: "/v0.3.5" },
         { text: "v0.3.4", link: "/v0.3.4" },

docs/docs/.vitepress/config/zh.mts

@@ -81,6 +81,7 @@ function sidebarChangelog() {
       text: "更新日志",
       items: [
         // { text: "v0.2.0", link: "/v0.2.0" }, // 最新的changelog, 往上写就好了
+        { text: "v0.4.0", link: "/v0.4.0" },
         { text: "v0.3.6", link: "/v0.3.6" },
         { text: "v0.3.5", link: "/v0.3.5" },
         { text: "v0.3.4", link: "/v0.3.4" },