{"id":28799300,"url":"https://github.com/unc611/mouse-cursor-installer","last_synced_at":"2026-04-24T11:38:35.722Z","repository":{"id":299706486,"uuid":"1003811528","full_name":"unc611/Mouse-Cursor-Installer","owner":"unc611","description":"A simple but powerful batch installer for Windows mouse cursor schemes, with intelligent detection, automatic matching, and one-click installation.","archived":false,"fork":false,"pushed_at":"2025-06-17T21:59:31.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-17T22:38:00.460Z","etag":null,"topics":["automation","batch","cursor-installer","cursor-theme","cursors","installer-tools","mouse","mouse-cursors","mouse-pointer","pointer","powershell","tool","tools","windows"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unc611.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-17T17:47:53.000Z","updated_at":"2025-06-17T22:09:26.000Z","dependencies_parsed_at":"2025-06-17T22:48:06.869Z","dependency_job_id":null,"html_url":"https://github.com/unc611/Mouse-Cursor-Installer","commit_stats":null,"previous_names":["unc611/mouse-cursor-installer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/unc611/Mouse-Cursor-Installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unc611%2FMouse-Cursor-Installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unc611%2FMouse-Cursor-Installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unc611%2FMouse-Cursor-Installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unc611%2FMouse-Cursor-Installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unc611","download_url":"https://codeload.github.com/unc611/Mouse-Cursor-Installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unc611%2FMouse-Cursor-Installer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260499357,"owners_count":23018291,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","batch","cursor-installer","cursor-theme","cursors","installer-tools","mouse","mouse-cursors","mouse-pointer","pointer","powershell","tool","tools","windows"],"created_at":"2025-06-18T06:05:50.253Z","updated_at":"2026-04-24T11:38:35.717Z","avatar_url":"https://github.com/unc611.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 鼠标光标批量安装工具（Mouse-Cursor-Installer）\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PowerShell](https://img.shields.io/badge/PowerShell-5.1%2B-blue.svg)](https://docs.microsoft.com/en-us/powershell/)\n\n**简体中文** | [**English**](./README_en.md)\n\n一个简单但功能强大的 Windows 鼠标光标方案批量安装工具，支持智能识别、自动匹配和一键安装。\n\n## ✨ 特色功能\n\n### 🎯 智能光标类型识别\n\n- **多语言关键词识别：** 支持中文、英文、日文光标文件名识别\n- **智能前后缀处理：** 自动识别并去除文件名中的公共前缀和后缀\n- **数字序号匹配：** 支持基于数字序号的光标类型推断\n\n### 📦 批量安装\n\n- **通用方法：** 不再需要`.inf`文件，适用于各种光标方案\n- **自动设置方案名：** 自动以文件夹名作为方案名，快速安装多个光标主题\n- **灵活的目录结构：** 支持递归扫描子文件夹\n\n### 🔄 自动替代机制\n\n- **Wait ↔ AppStarting 互相替代：** 当其中一个缺失时自动使用另一个\n- **Hand/Pin/Person 优先级替代：** 按优先级顺序自动填补缺失的光标类型\n\n### 📊 完整的安装报告\n\n- **数量异常检测：** 识别非常见数量（10/13/15/17）的光标方案\n- **未匹配文件检测：** 发现可能存在命名问题的光标文件\n- **备选光标检测：** 识别可能存在备选的光标文件\n- **详细统计报告：** 提供安装成功数量、处理文件数量等详细信息\n\n\u003e ⭐ 如果这个项目对您有帮助，请给它一个星标！\n\n## 🚀 使用方法\n\n1. **下载：** 前往 [Releases](https://github.com/unc611/Mouse-Cursor-Installer/releases) 页面，下载最新的 `Mouse-Cursor-Installer.exe` 文件。\n\n2. **文件夹结构：**\n   \n   - 在任意位置，创建你的光标文件夹。**每个主题一个文件夹，文件夹名称将成为鼠标方案的名称。** 例如：\n   \n   ```\n   MyCursors/\n   ├── 方案名1/\n   │   ├── cursor1.ani\n   │   ├── cursor2.ani\n   │   └── ...\n   ├── 方案名2/\n   │   ├── Arrow.cur\n   │   ├── help.cur\n   │   └── ...\n   ├── 正常选择.cur  # 也支持根目录下的光标文件\n   ├── 帮助选择.cur\n   └── ...\n   ```\n\n3. **运行工具：**\n   \n   - 双击运行 `Mouse-Cursor-Installer.exe`，程序会自动请求管理员权限。\n   \n   - 根据菜单提示进行操作，只需几秒就能完成！\n\n4. **应用方案：** 安装完成后，工具会询问是否立即打开鼠标属性面板。你可以在「指针」选项卡下的「方案」下拉菜单中找到并应用你刚刚安装的所有主题。\n\n## 🔧 构建指南\n   \n   如果你想从源码运行或自行修改，请遵循以下步骤：\n\n1. **环境要求：** Windows 10/11，PowerShell 5.1 或更高版本。\n\n2. **直接运行脚本：**\n      \n      - 克隆仓库到本地。\n      \n      - 在 PowerShell 中，执行以下命令（需要管理员权限）：\n  \n    ```powershell\n      Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force\n      ./mouse-cursor-installer.ps1\n    ```\n\n3. **打包成 `.exe`**：\n      \n      - 本项目使用 [PS2EXE](https://github.com/MScholtes/PS2EXE) 工具进行打包。\n      \n      - 安装 PS2EXE 模块：\n  \n    ```powershell\n      Install-Module ps2exe\n    ```\n\n      - 执行以下命令进行打包：\n\n    ```powershell\n      ps2exe .\\mouse-cursor-installer.ps1 .\\mouse-cursor-installer.exe\n    ```\n\n## 🐛 故障排除\n\n### 常见问题\n\n**Q: 双击运行后自动提权失败**\n\n```\nA: 尝试手动右键以管理员身份运行\n```\n\n**Q: 光标文件无法识别或识别错误**\n\n```\nA: 检查文件名是否过于不规范\n```\n\n**Q: 安装后在控制面板中找不到新方案**\n\n```\nA: 尝试重新打开\"鼠标属性\"窗口\n```\n\n**Q: 方案名称不符合预期**\n\n```\nA: 工具会自动以文件夹名作为方案名称，请修改文件夹名\n```\n\n### 调试模式\n\n在主菜单输入-log来启用调试模式，可以获得详细的处理日志。日志将保存到程序目录下的mouse-cursor.log\n\n或者使用启动参数：\n\n```powershell\n    ./Mouse-Cursor-Installer.exe -log\n```\n\n## 📄 编写\n\n- 34%的代码由Deepseek R1，30%由Claude sonnet 4，35%由Gemini 2.5 pro，剩下1%由本人编写。\n- 本人只负责调试和处理一些逻辑问题。\n\n\u003e [查看更新日志](./changelog.md)\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Func611%2Fmouse-cursor-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Func611%2Fmouse-cursor-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Func611%2Fmouse-cursor-installer/lists"}