Cherry Studio Skill Manager

---

✨ 功能特性 / Features

• 📦 安装 Skill / Install - 一键安装新 Skill，自动备份旧版本 / One-click install with auto backup
• 🔄 同步注册表 / Sync - 自动补全 plugins.json，清理无效注册 / Auto-complete registry and clean orphaned entries
• 📊 状态检查 / Status Check - 可视化查看所有 Skill 的注册状态 / Visual overview of all Skill registrations
• 🖥️ 跨平台 / Cross-Platform - 支持 macOS 和 Windows，双平台体验一致 / Native experience on macOS and Windows

📸 界面预览

macOS

========================================
  Cherry Studio Skill 管理器
  ===========================

  请选择操作：

  1. 安装新 Skill（自动同步所有）
  2. 仅同步现有 Skills
  3. 检查 Skills 注册状态
  q. 退出

Windows

图形化界面，支持文件夹选择对话框和消息提示。

🚀 快速开始

系统要求

| 平台 | 要求 | |------|------| | macOS | macOS 10.14+ | | Windows | Windows 7/8/10/11 + Python 3.6+ |

macOS 安装

1. 下载本项目
2. 双击运行 MacOS/Start.command
3. 在终端菜单中选择操作

首次运行可能需要授予终端权限

Windows 安装

1. 安装 Python 3

   • 访问 https://python.org 下载 Python 3.6+
   • 安装时勾选 "Add Python to PATH"
   • 勾选 "tcl/tk and IDLE"（tkinter 支持）

2. 运行管理器

   • 双击 Windows/start.bat
   • 在图形界面中选择操作

📖 使用指南

1. 安装新 Skill

步骤 1: 选择 Cherry Studio 项目目录（包含 .claude 文件夹）
步骤 2: 选择要安装的 Skill 文件夹（必须包含 SKILL.md）
步骤 3: 自动复制文件并同步注册表

自动备份: 如果 Skill 已存在，旧版本会自动备份为 skillname_backup_YYYYMMDD_HHMMSS

2. 同步现有 Skills

扫描 .claude/skills/ 目录，自动：

• ✅ 注册新安装的 Skills
• 🗑️ 清理已删除 Skills 的残留注册

3. 检查状态

显示所有 Skills 的状态：

• 🟢 已注册 - Skill 已正确注册
• 🔴 未注册 - Skill 存在但未注册
• 🟠 无效注册 - 注册表中有但文件夹已删除

📁 目录结构

Cherry-Studio-Skill-Manager/
├── shared/
│   └── skill_core.py          # 共用核心逻辑
├── MacOS/
│   └── Start.command
├── Windows/
│   ├── start.bat
│   ├── skill_manager.py
│   └── README.txt
├── .gitignore
├── LICENSE
└── README.md

🏗️ 技术架构

共用核心（shared/skill_core.py）

双平台共用以下 Python 类与函数：

class SkillRegistry      # plugins.json 注册表管理
class SkillInfo          # Skill 信息容器
def parse_skill_md()     # 解析 SKILL.md 文件
def calculate_size()     # 计算文件夹大小
def install_skill()      # 安装 Skill（含备份）

平台实现

| 特性 | macOS | Windows | |------|-------|---------| | 界面 | 终端菜单 + AppleScript 对话框 | tkinter GUI | | 调用方式 | CLI: python skill_core.py sync ... | 模块导入 | | 编码 | UTF-8 终端 | Python 原生 UTF-8 |

🔧 开发说明

测试共用核心

# 测试同步功能
python shared/skill_core.py sync /path/to/project [skill_name]

# 测试检查功能
python shared/skill_core.py check /path/to/project

修改核心逻辑

编辑 shared/skill_core.py，双平台同步生效。

🐛 故障排除

macOS

Q: 运行.command文件提示"无法打开"

• A: 右键点击文件 → 打开，授予终端权限

Q: 找不到 Python

• A: macOS 自带 Python 3，或从 python.org 安装

Windows

Q: 双击 start.bat 无反应

• A: 检查 Python 是否安装并添加到 PATH：cmd 中运行 python --version

Q: 提示 tkinter 错误

• A: 重新安装 Python，确保勾选 "tcl/tk and IDLE"

Q: 出现乱码

• A: 确保通过 start.bat 启动，不要直接运行 skill_manager.py

Q: 提示找不到 skill_core.py

• A: 确保 shared/ 文件夹与 Windows/ 文件夹在同一目录下

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License © 2026 Mars YANG

🙏 致谢

• Cherry Studio - 优秀的 AI 对话客户端

---