Skip to content

Commit a7c2f3e

Browse files
sdmj76sdmj76
committed
Bump version and update documentation for v1.1.3 Release
1 parent 410f72b commit a7c2f3e

6 files changed

Lines changed: 621 additions & 550 deletions

File tree

‎Mousecape/Mousecape‎

‎Mousecape/Mousecape.xcodeproj/project.pbxproj‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -910,7 +910,7 @@
910910
"@executable_path/../../Frameworks",
911911
);
912912
MACOSX_DEPLOYMENT_TARGET = 15.0;
913-
MARKETING_VERSION = 1.1.2;
913+
MARKETING_VERSION = 1.1.3;
914914
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.Mousecape.QuickLook;
915915
PRODUCT_NAME = "$(TARGET_NAME)";
916916
SKIP_INSTALL = YES;
@@ -938,7 +938,7 @@
938938
"@executable_path/../../Frameworks",
939939
);
940940
MACOSX_DEPLOYMENT_TARGET = 15.0;
941-
MARKETING_VERSION = 1.1.2;
941+
MARKETING_VERSION = 1.1.3;
942942
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.Mousecape.QuickLook;
943943
PRODUCT_NAME = "$(TARGET_NAME)";
944944
SKIP_INSTALL = YES;
@@ -965,7 +965,7 @@
965965
"@executable_path/../../Frameworks",
966966
);
967967
MACOSX_DEPLOYMENT_TARGET = 15.0;
968-
MARKETING_VERSION = 1.1.2;
968+
MARKETING_VERSION = 1.1.3;
969969
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.Mousecape.QuickLookThumbnail;
970970
PRODUCT_NAME = "$(TARGET_NAME)";
971971
SKIP_INSTALL = YES;
@@ -993,7 +993,7 @@
993993
"@executable_path/../../Frameworks",
994994
);
995995
MACOSX_DEPLOYMENT_TARGET = 15.0;
996-
MARKETING_VERSION = 1.1.2;
996+
MARKETING_VERSION = 1.1.3;
997997
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.Mousecape.QuickLookThumbnail;
998998
PRODUCT_NAME = "$(TARGET_NAME)";
999999
SKIP_INSTALL = YES;
@@ -1037,7 +1037,7 @@
10371037
"@executable_path/../Frameworks",
10381038
);
10391039
MACOSX_DEPLOYMENT_TARGET = 15.0;
1040-
MARKETING_VERSION = 1.1.2;
1040+
MARKETING_VERSION = 1.1.3;
10411041
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
10421042
MTL_FAST_MATH = YES;
10431043
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.MousecapeHelper;
@@ -1087,7 +1087,7 @@
10871087
"@executable_path/../Frameworks",
10881088
);
10891089
MACOSX_DEPLOYMENT_TARGET = 15.0;
1090-
MARKETING_VERSION = 1.1.2;
1090+
MARKETING_VERSION = 1.1.3;
10911091
MTL_ENABLE_DEBUG_INFO = NO;
10921092
MTL_FAST_MATH = YES;
10931093
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.MousecapeHelper;
@@ -1241,7 +1241,7 @@
12411241
"$(LD_RUNPATH_SEARCH_PATHS_$(IS_MACCATALYST))",
12421242
"@executable_path/../Frameworks",
12431243
);
1244-
MARKETING_VERSION = 1.1.2;
1244+
MARKETING_VERSION = 1.1.3;
12451245
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.Mousecape;
12461246
PRODUCT_NAME = "$(TARGET_NAME)";
12471247
PROVISIONING_PROFILE_SPECIFIER = "";
@@ -1276,7 +1276,7 @@
12761276
"$(LD_RUNPATH_SEARCH_PATHS_$(IS_MACCATALYST))",
12771277
"@executable_path/../Frameworks",
12781278
);
1279-
MARKETING_VERSION = 1.1.2;
1279+
MARKETING_VERSION = 1.1.3;
12801280
PRODUCT_BUNDLE_IDENTIFIER = com.sdmj76.Mousecape;
12811281
PRODUCT_NAME = "$(TARGET_NAME)";
12821282
PROVISIONING_PROFILE_SPECIFIER = "";

‎README.md‎

Lines changed: 6 additions & 261 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,10 @@ A free macOS cursor manager that allows you to easily replace Mac system pointer
3636
<br/>适配 macOS 26，全面采用液态玻璃设计。支持一键转换Windows光标**
3737
<br/>
3838
<br/>
39-
**[English](#english-section) | [中文](#chinese-section)**
39+
English | [中文](README_zh.md)
4040
</div>
4141

42-
<a id="english-section"></a>
43-
44-
# English
42+
---
4543

4644
## Interface Display
4745

@@ -66,11 +64,13 @@ A free macOS cursor manager that allows you to easily replace Mac system pointer
6664
### System Requirements
6765

6866
- macOS Sequoia (15) or later
69-
- Support Architectures: runs on both Intel and Apple Silicon Macs
67+
- Support Architectures: runs on both Intel and Apple Silicon Macs (Universal Binary)
68+
69+
> **Note:** The Debug version only includes the architecture of the build machine and may not run on all Macs. For normal use, please download the regular (Release) version.
7070
7171
Download the latest version from the [Releases](https://github.com/sdmj76/Mousecape-swiftUI/releases) section of this GitHub page.
7272

73-
If you encounter any problems, we recommend that you first check the [Troubleshooting](#Troubleshooting_en) section.
73+
If you encounter any problems, we recommend that you first check the [Troubleshooting](#troubleshooting) section.
7474

7575
## Example Cursors
7676

@@ -169,8 +169,6 @@ If you want to extract the cursors currently in use, you can:
169169
- **Standard image formats**: PNG, JPEG, TIFF, GIF
170170
- **Windows cursor formats**: .cur (static), .ani (animated)
171171

172-
<a id="Troubleshooting_en"></a>
173-
174172
## Troubleshooting
175173

176174
If you encounter issues, please check the common solutions below first. For more help, please [submit an Issue](https://github.com/sdmj76/Mousecape-swiftUI/issues).
@@ -291,256 +289,3 @@ This is just a tool, and I've polished its UI. But what matters most is your cur
291289
---
292290

293291
> **License Notice:** This project uses a dual-section license. Alex Zielenski's original code (ObjC model layer, private API layer) remains under its original BSD-like terms. All SwiftUI interface, CLI rewrite, Windows cursor conversion, and documentation by sdmj76 are covered by the Mousecape Non-Commercial License, which prohibits redistribution and requires attribution. Because the compiled application includes both, redistributing the Software as a whole requires compliance with the stricter terms. See [LICENSE](LICENSE) for full details.
294-
295-
---
296-
297-
<a id="chinese-section"></a>
298-
299-
# 中文
300-
301-
## 界面展示
302-
303-
<div align="center" style="display: flex; gap: 20px; justify-content: center; align-items: flex-start;">
304-
<img src="Screenshot/Home_zh_lg.gif#gh-light-mode-only" width="48%" style="height: auto;" />
305-
<img src="Screenshot/Edit_zh_lg.gif#gh-light-mode-only" width="48%" style="height: auto;" />
306-
<img src="Screenshot/Home_zh_dk.gif#gh-dark-mode-only" width="48%" style="height: auto;" />
307-
<img src="Screenshot/Edit_zh_dk.gif#gh-dark-mode-only" width="48%" style="height: auto;" />
308-
</div>
309-
310-
> 截图中展示的光标主题 "Kiriko" 由 [ArakiCC](https://space.bilibili.com/14913641) 制作，在示例文件中提供。
311-
312-
## 功能特性
313-
314-
- 自定义 Mac 系统光标，支持静态和动画光标
315-
- 一键转换 Windows 格式指针（.cur / .ani），覆盖 85% 的 macOS 光标类型
316-
- 提取系统默认光标，适合喜欢旧系统光标的用户
317-
- 左手模式：水平翻转光标，适合左手用户
318-
- 多语言支持：简体中文、繁体中文、英语、日语、韩语、德语、法语
319-
320-
## 下载安装
321-
### 系统要求
322-
323-
- macOS Sequoia (15) 或更高版本
324-
- 支持架构：同时支持 Intel 和 Apple Silicon Mac
325-
326-
在本 GitHub 页面的 [Releases](https://github.com/sdmj76/Mousecape-swiftUI/releases) 部分下载最新版本。
327-
328-
如果遇到问题，建议优先查看[故障排除](#Troubleshooting_cn)章节。
329-
330-
## 示例光标
331-
332-
本仓库的示例光标位于 `Example/` 目录下，包含以下光标
333-
334-
**Kiriko.cape**：由 [ArakiCC](https://space.bilibili.com/14913641) 制作，使用 CC BY-NC-ND 4.0（署名-非商业性-禁止演绎 4.0）许可证
335-
336-
**Default_macOS 15.cape**：由 macOS 15系统提取的默认光标
337-
338-
**Default_macOS 26.cape**：由 macOS 26系统提取的默认光标
339-
340-
## 快速开始
341-
342-
<details>
343-
<summary>设置开机启动</summary>
344-
345-
1. 下载并打开 Mousecape 应用
346-
2. 进入 **设置 → 通用**，开启 **开机自动应用**
347-
348-
开启后，Mousecape 会在登录时后台启动，并提供菜单栏图标，你可以通过它：
349-
- 打开 Mousecape 应用
350-
- 重置为系统默认光标
351-
352-
> **注意：** Helper 始终在后台运行以进行会话监控。"显示菜单栏工具"开关仅控制菜单栏图标的可见性。
353-
354-
</details>
355-
<br>
356-
<details>
357-
<summary>导入 Windows 格式光标</summary>
358-
359-
Mousecape 支持一键转换 Windows 光标类型：
360-
361-
1. 下载的 Windows 光标包解压
362-
2. 点击 "+" 按钮，选择"导入 Windows 光标"
363-
3. 选择包含光标文件的文件夹导入即可
364-
365-
如果文件夹中包含 `*.inf` 文件，Mousecape 会自动解析该文件以正确映射光标类型。否则，将使用基于文件名的匹配。
366-
367-
</details>
368-
<br>
369-
<details>
370-
<summary>创建自定义光标套装</summary>
371-
372-
1. 点击 "+" 按钮添加新光标套装
373-
2. 点击 "+" 按钮添加要自定义的指针
374-
3. 将图片或光标文件拖放到编辑窗口中
375-
4. 调整热点位置和其他参数
376-
5. 保存并应用你的主题
377-
378-
**简易/高级模式**
379-
380-
Mousecape 提供两种编辑模式，可通过工具栏切换：
381-
382-
- **简易模式**：以 15 个 Windows 光标分组展示。编辑一个光标后自动同步到同组内所有相关的 macOS 光标类型。
383-
- **高级模式**：逐个编辑 52 个 macOS 光标类型，保留完整控制。
384-
385-
首页预览也支持简易/高级显示模式，可在 **设置 → 外观 → 预览面板** 中配置。
386-
387-
</details>
388-
<br>
389-
<details>
390-
<summary>导入/导出 .cape 格式光标</summary>
391-
392-
- 点击 "导入" 按键，在弹出的finder窗口，选择要导入的 **.cape** 格式光标
393-
- 或直接将 **.cape** 文件拖放到应用窗口即可导入
394-
- 或在访达中双击 **.cape** 文件即可直接在 Mousecape 中打开
395-
- 点击 "导出" 按键，在弹出的finder窗口，选择要保存 **.cape** 光标的位置
396-
397-
> **.cape** 为 Mousecape 专用光标格式，文件内包含了一整套光标的内容
398-
>
399-
> **注意：** 使用 v1.1.0+ 保存的 Cape 文件采用 HEIF 图像格式，可能无法被旧版本 Mousecape 打开。现有的 Cape 文件可以继续使用，保存时会自动升级到新格式。
400-
401-
</details>
402-
<br>
403-
<details>
404-
<summary>重置系统光标</summary>
405-
406-
如果你想恢复为 macOS 默认光标，可以：
407-
408-
- 点击 **macOS 菜单栏 → 文件 → 重置为系统光标**
409-
- 或使用快捷键 **Cmd+R**
410-
411-
</details>
412-
<br>
413-
<details>
414-
<summary>提取当前光标</summary>
415-
416-
如果你想提取当前正在使用的光标，可以：
417-
418-
- 点击 **macOS 菜单栏 → 文件 → 提取当前光标**
419-
420-
</details>
421-
422-
### 支持的图片格式
423-
424-
- **常规图片格式**：PNG、JPEG、TIFF、GIF
425-
- **Windows 光标格式**：.cur（静态）、.ani（动画）
426-
427-
<a id="Troubleshooting_cn"></a>
428-
429-
## 故障排除
430-
431-
如果遇到问题，请先查看以下常见解决方案。更多帮助请[提交 Issue](https://github.com/sdmj76/Mousecape-swiftUI/issues)。
432-
433-
> **由于 macOS 系统限制，Mousecape 有以下限制：**
434-
>
435-
> *图像尺寸限制*
436-
>
437-
> - 最大导入尺寸：**512×512 像素**（超过此尺寸的图像将被拒绝）
438-
> - 所有光标图像会自动缩放至 **64×64 像素**（1x 分辨率）
439-
> - 如果导入的图像大于 64×64（最大 512×512），会自动缩小
440-
> - 如果导入的图像小于 64×64，会自动放大（可能导致质量下降）
441-
>
442-
> *动画帧数限制*
443-
>
444-
> - 每个动画光标最多支持 **24 帧**
445-
> - 超过 24 帧的动画光标会自动降采样
446-
> - 降采样会通过调整帧时长来保持动画速度一致
447-
>
448-
> *示例：* 32 帧的 GIF 动画会被降采样到 24 帧，帧时长会增加以保持原始动画速度。
449-
450-
<br>
451-
<details>
452-
<summary>光标在部分软件不生效</summary>
453-
454-
**症状**：光标在软件窗口内不生效，如终端、Excel
455-
456-
**原因**：部分软件会配置自定义光标，覆盖系统光标配置
457-
458-
**解决方案**：暂无安全解决方案，此问题只会在部分软件出现，影响范围不大。
459-
460-
</details>
461-
<br>
462-
<details>
463-
<summary>光标动画仅在 Dock 区域生效</summary>
464-
465-
**症状**：自定义光标动画仅在悬停在 Dock 上时显示，移动到其他地方会恢复为系统默认光标。
466-
467-
**原因**：macOS 系统设置中的自定义指针颜色会阻止 Mousecape 成功应用全局光标。
468-
469-
**解决方案**：将系统指针颜色重置为默认设置：
470-
471-
1. 打开 **系统设置** → **辅助功能** → **显示**
472-
2. 找到 **指针** 部分
473-
3. 点击 **重设颜色** 按钮
474-
4. 重新在 Mousecape 中应用光标主题
475-
476-
光标必须使用默认颜色方案（白色轮廓、黑色填充），Mousecape 才能正常工作。
477-
478-
</details>
479-
<br>
480-
<details>
481-
<summary>动画光标导入失败</summary>
482-
483-
**症状**：动画光标文件（.ani 或 .gif）无法导入或被拒绝。
484-
485-
**原因**：超过 24 帧的动画光标超出了 macOS 系统限制，需要自动降采样。
486-
487-
**解决方案**：
488-
- Mousecape 会自动对超过 24 帧的动画进行降采样
489-
- 动画速度会通过调整帧时长来保持一致
490-
- 如果仍然无法导入，请确保文件未损坏，尝试重新下载
491-
492-
</details>
493-
<br>
494-
<details>
495-
<summary>中文光标主题显示乱码</summary>
496-
497-
**症状**：中文或其他非英文光标主题显示乱码或名称不正确。
498-
499-
**原因**：INF 文件编码检测不正确。
500-
501-
**解决方案**：
502-
- Mousecape 支持多种编码：UTF-8、UTF-16 LE/BE、GBK、GB18030、Big5、Shift_JIS、EUC-KR、ISO-8859-1
503-
- 确保 INF 文件使用支持的编码保存
504-
- 如果问题持续，尝试将 INF 文件另存为 UTF-8 编码
505-
506-
</details>
507-
<br>
508-
<details>
509-
<summary>光标图像过大</summary>
510-
511-
**症状**：大型光标图像在导入时被拒绝。
512-
513-
**原因**：图像超过了最大支持的 512×512 像素尺寸。
514-
515-
**解决方案**：
516-
- 在导入前将图像调整为 512×512 像素或更小
517-
- 所有导入的图像会自动缩放到 64×64 像素
518-
- 超过 512×512 的图像将被拒绝并显示错误消息
519-
520-
</details>
521-
522-
## 捐赠
523-
524-
如果你觉得我的UI重制做的不错，可以请我喝杯下午茶 :)
525-
526-
![捐赠](Screenshot/Donate.png)
527-
528-
## 致谢
529-
530-
- 原始项目由 [Alex Zielenski](https://github.com/alexzielenski) 创建
531-
- 演示以及示例光标 "Kiriko" 由 [ArakiCC](https://space.bilibili.com/14913641) 制作
532-
- UI指导由 [Winter喵](https://space.bilibili.com/15016945) 帮助
533-
- SwiftUI 界面重构及液态玻璃适配由 [sdmj76](https://space.bilibili.com/224661756) 完成
534-
- SwiftUI 代码编程及本地化由 [Claude Code](https://claude.ai/code) 辅助编写
535-
536-
## 反馈与问题
537-
538-
如有问题或建议，欢迎在 [GitHub Issues](https://github.com/sdmj76/Mousecape-swiftUI/issues) 提出。
539-
540-
## 作者的话
541-
542-
这只是一个工具，我美化了它的UI。但最重要的还是你的光标内容 :)
543-
544-
---
545-
546-
> **许可证声明：** 本项目采用双段式许可证。Alex Zielenski 的原始代码（ObjC 模型层、私有 API 层）保留其原始 BSD 类条款。sdmj76 的所有 SwiftUI 界面、CLI 重写、Windows 光标转换及文档受 Mousecape 非商业许可证约束，禁止再分发且必须保留署名。由于编译后的应用同时包含两部分代码，再分发整体软件需遵守更严格的条款。详见 [LICENSE](LICENSE)。

0 commit comments

Comments
 (0)