Cherry Studio Skill Manager

✨ Возможности

• 📦 Установка Skill — установка нового Skill в один клик с автоматическим резервным копированием старой версии
• 🔄 Синхронизация реестра — автодополнение plugins.json и очистка недействительных записей
• 📊 Проверка статуса — визуальный обзор состояния регистрации всех Skills
• 🖥️ Кроссплатформенность — поддержка macOS и Windows с единообразным опытом использования

📸 Предпросмотр интерфейса

macOS

Windows

Графический интерфейс с диалогом выбора папки и всплывающими уведомлениями.

🚀 Быстрый старт

Системные требования

Установка на 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

Автоматическое резервное копирование: если Skill уже существует, старая версия автоматически сохраняется как skillname_backup_YYYYMMDD_HHMMSS

2. Синхронизация существующих Skills

Сканирует директорию .claude/skills/ и автоматически:

• ✅ Регистрирует вновь установленные Skills
• 🗑️ Очищает остаточные записи удалённых Skills

3. Проверка статуса

Отображает статус всех Skills:

• 🟢 Зарегистрирован — Skill корректно зарегистрирован
• 🔴 Не зарегистрирован — Skill существует, но не зарегистрирован
• 🟠 Недействительная запись — запись в реестре есть, но папка удалена

📁 Структура директорий

🏗️ Техническая архитектура

Общее ядро (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 (с резервным копированием)

Реализация по платформам

🔧 Разработка

Тестирование общего ядра

# Тест функции синхронизации
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: выполните python --version в cmd

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-диалогов