基于 Git 原生能力驱动的 AI Agent 技能管理器
支持多 Git 仓库与独立分支、像文件树一样逐层进入浏览、目录级与单 Skill 专属挂载路径、符号链接零拷贝秒级挂载、统一 CLI 控制中枢与后台自动更新。
在开发或使用 AI Coding Agent（如 OpenCode、Claude Code、Cursor、Windsurf、Cline 等）时，现存的技能管理工具往往存在诸多痛点：
- 无法指定 Git 分支：对企业内网私有 GitLab、分支开发模式极不友好，默认只能克隆 main/master；
- 多层级 Monorepo 无法有效浏览：大型仓库内部按业务线分了多层目录，扁平展开直接刷屏甚至无法识别；
- 安装目录僵化：无法区分“全局默认技能”、“业务线目录级技能”与“特定工程专有技能”；
- 运维脚本散乱：启停、自启、状态查看散落多个批处理，缺乏统一的管理中枢；
- 挂载体验不佳：反复复制大文件，或建立软链接时频繁弹出黑色命令行黑框。
SkillBox 专为解决上述痛点而生！
- 🌿 支持配置多个 Git 仓库与独立分支：
- 自由纳管多个私有/公开仓库（内网 GitLab、GitHub、Gitea、SSH、HTTPS 协议）；
- 每个仓库独立指定**分支（Branch）**与 Skill 相对子目录（Subdirectory）；
- 自动记录每个仓库的最后拉取时间，并持久化存储。
- 📁 像文件树一样一层一层进入浏览 (Folder Drill-down)：
- 资源管理器级下钻体验，从顶级目录点击文件夹逐级进入子目录，页面始终清晰聚焦；
- 配备精致的**面包屑路径导航（Breadcrumbs）**与
⬅ 返回上一级按钮，随时瞬时跳转； - 文件夹卡片支持一键「全选本目录（含全部子孙技能）」。
- 🎯 三层灵活挂载路径架构（目录级统一挂载）：
- 单 Skill 专属路径（最高优先级）：精确覆盖特定单个技能；
- 目录级统一挂载路径（第二优先级，自底向上多级继承）：为任意目录（如
business/bind-center或business）指定专属目录，该目录下所有技能自动继承统一挂载； - 全局默认安装路径（保底优先级）：统一未指定目录的默认安装位置（如
~/.agents/skills）； - 修改路径全自动平滑迁移：无论修改全局默认还是某个目录的挂载路径，系统自动在旧位置解绑并在新位置重建软链接，无需人工重新勾选。
- 🖥️ 桌面托盘客户端 (Desktop Tray App)：
- 基于系统原生 WebView 承载控制台，观感接近原生桌面应用（不再外挂浏览器窗口）；
- 关闭窗口即缩到右下角系统托盘，服务继续后台运行，托盘右键菜单可一键打开控制台、同步更新、查看日志与退出；
- 托盘应用内嵌托管服务，无需独立的隐藏守护进程；重复启动自动复用已运行实例（单实例保证）。
- 📦 单文件 exe 与快捷方式：
- 提供
tools/build_exe.py一键打包内嵌图标的dist/SkillBox.exe（无黑窗、免装 Python）； skillbox shortcut生成的桌面快捷方式优先指向打包好的 exe，双击即启动。
- 提供
- 🛠️ 统一 CLI 命令行中枢与双击一体化：
- 根目录提供统一命令
skillbox.bat，双击默认直接拉起桌面托盘应用，命令行传参可一键启停、重启、查状态、开机自启、全量更新与查日志。
- 根目录提供统一命令
- 🏷️ 智能直接父目录名 Tag：
- 严格按技能所属的直接父目录名提取 Tag（如
A/B/C/skill对应Tag = C）； - 顶部配备 Tag 下拉筛选与快捷 Tag 胶囊栏（Tag Pills），点击卡片标签联动过滤。
- 严格按技能所属的直接父目录名提取 Tag（如
- 🔍 按挂载状态快速收窄：
- 工具栏提供状态过滤器，支持一键切换
全部/🟢 仅已挂载 (Installed)/⚪ 仅未挂载 (Unmounted)，环境现状一目了然。
- 工具栏提供状态过滤器，支持一键切换
- 👁️ Skill 详情与 SKILL.md 文档正文预览：
- 点击卡片标题或详情按钮，大弹窗结构化展示完整功能描述、生效挂载路径与
SKILL.md完整文档指令正文，支持一键复制。
- 点击卡片标题或详情按钮，大弹窗结构化展示完整功能描述、生效挂载路径与
- 🔄 后台静默定时自动更新：
- 每个仓库可独立配置自动拉取频率（每 30 分钟、每 1 小时、每 6 小时、每天）；
- 后台常驻守护线程到期自动
git pull；由于采用符号链接机制，Agent 本地读取的代码全自动秒级变为最新版本。
- ⚡ 零拷贝、零闪屏与安全解绑：
- Windows 原生采用底层 Win32 C 级系统调用（
_winapi.CreateJunction）创建 NTFS 目录联结，100% 杜绝终端黑框闪烁，纳秒级生效； - 解绑采用 Python 原生
os.rmdir安全移除挂载指针，绝不误伤 Git 缓存里的物理源码。
- Windows 原生采用底层 Win32 C 级系统调用（
- 🚀 Windows 开机静默自启：
- 基于当前用户注册表机制，无需 Administrator 管理员权限；
- 支持在 WebUI 设置页面一键开关，或通过命令行一键配置；开机静默常驻，不弹黑框与浏览器。
- 📝 内置标准审计日志系统：
- 所有后台服务事件、Git 拉取、符号链接挂载（
[Mount]）、旧链接清理（[Clean]）、解绑（[Unmount]）实时写入skillbox.log； - 可在命令行直接输入
skillbox log秒级查看最新运行日志。
- 所有后台服务事件、Git 拉取、符号链接挂载（
- 🛡️ 安全与凭据完全隔离：
- 不保存任何私钥密码，直接复用操作系统的 Git 原生凭据（SSH 密钥系统 / Windows 凭据管理器）；
- 本地配置文件与 Git 源码缓存已被
.gitignore严格物理屏蔽，绝不上库。
前往 Releases 下载最新成果物：
| 成果物 | 适用场景 | 说明 |
|---|---|---|
SkillBox-Setup-<version>.exe |
推荐，常规安装 | Windows 安装包：双击安装，自动创建开始菜单/桌面快捷方式，可一键卸载 |
SkillBox-<version>-win64.zip |
绿色免安装 | 解压即用，双击 SkillBox.exe 启动，配置与缓存保存在解压目录内 |
Windows 安装包/绿色版均内置 Python 运行时与全部依赖，无需另装 Python。 Agent CLI（
skillbox search/commit）面向开发机，请在源码仓库中运行（需本机 Python）。
安装版 / 绿色版：双击 SkillBox.exe 即可启动，界面顶部「💾 保存并生效挂载」一键应用挂载；
开机自启在 「⚙️ 仓库与配置」 页面一键开关。
源码运行：
pip install -r requirements.txt # 桌面应用依赖
python desktop_app.py # 启动桌面托盘应用SkillBox 为 AI Agent 提供了一个极简命令行工具，仅三条命令，
聚焦「检索技能」与「提交技能」两件事（Windows 入口为 skillbox.bat，类 Unix 为 skillbox）：
| 命令 | 效果说明 |
|---|---|
skillbox search <关键词> |
按关键词搜索技能（匹配名称/描述/目录），输出名称 + 真身路径 + 描述 |
skillbox commit <名称> [-m "说明"] |
白名单提交并推送该技能目录（提交前自动先拉取该技能所在仓库） |
skillbox help |
显示帮助 |
服务的启停、安装、开机自启、桌面图标等运维能力已全部迁移到桌面应用与 WebUI， CLI 不再承担这些职责，保持 Agent 使用场景的极简与稳定。
commit支持--no-push（仅本地提交不推送）。
- 设置全局默认安装路径：
- 进入顶部导航栏的 「⚙️ 仓库与配置」 页面配置通用路径（如
C:\Users\Name\.agents\skills）。
- 进入顶部导航栏的 「⚙️ 仓库与配置」 页面配置通用路径（如
- 添加你的 Git 仓库源：
- 点击 「+ 添加仓库源」，填写仓库名称、Git URL、指定分支与子目录，并选定自动更新频率。
- 设置目录级统一挂载（可选，高级特性）：
- 在文件夹卡片上点击 「⚙️ 设置本目录安装路径」（或进入该目录后点击面包屑右侧按钮）；
- 为该目录（如
business/bind-center）指定专有目录，其内部所有技能自动继承该路径！
- 浏览、勾选与应用挂载：
- 逐层下钻浏览文件夹，勾选需要启用的技能；
- 点击右上角 「💾 保存并生效挂载」，系统秒级在对应目标目录建立符号链接！
skillbox/
├── skillbox.bat # Windows 统一 CLI 命令与启动入口
├── skillbox # macOS / Linux 统一 CLI 启动入口
├── start.bat # 兼容启动入口（拉起桌面托盘应用）
├── cli.py # Agent CLI（search / commit / help）
├── app.py # SkillBox 服务端核心（多仓库引擎 + 递归扫描 + 前端 SPA）
├── desktop_app.py # 桌面托盘应用（原生 WebView 窗口 + 系统托盘 + 内嵌服务）
├── platform_utils.py # 跨平台工具库（快捷方式/应用模式/启动器，供扩展调用）
├── requirements.txt # 桌面托盘应用运行依赖（pywebview / pystray / Pillow）
├── builtin_skills/ # 工具自带技能（随版本分发，默认自动挂载）
│ └── skillbox/ # skillbox 命令使用说明技能
├── assets/ # 图标资源（icon.ico / icon.png，多尺寸）
├── tools/
│ ├── gen_icon.py # 图标生成脚本（Pillow 绘制，可复现）
│ ├── build_exe.py # 单文件 exe 打包脚本（PyInstaller）
│ ├── build_release.py # Release 成果物打包（zip 绿色包 + Inno Setup 安装包）
│ └── installer.iss # Inno Setup 安装包脚本
├── run_tests.py # 自动化单元测试运行器
├── tests/ # 自动化测试套件
│ ├── test_config.py # 配置管理与持久化测试
│ ├── test_folder_mount.py # 目录级挂载与继承优先级测试
│ ├── test_scanner.py # 元数据解析与 Tag 父目录名规则测试
│ ├── test_symlink.py # Junction 挂载与安全解绑测试
│ ├── test_autostart.py # 开机自启注册测试
│ └── test_api.py # HTTP REST API 全链路测试
├── docs/
│ └── architecture.md # 系统架构设计文档
├── .github/workflows/ # CI：单元测试 + 打标签自动发布
├── CHANGELOG.md # 变更日志 (Keep a Changelog)
├── CONTRIBUTING.md # 贡献指南
├── LICENSE # MIT 许可协议
├── ROADMAP.md # 产品演进路线图
├── .gitattributes # 跨平台行尾规范化
├── .gitignore # Git 忽略配置
└── README.md # 本说明文档
运行全量自动化单元测试套件：
skillbox test或：
python run_tests.py- 详细系统架构与数据流图：请参阅 架构设计文档 (docs/architecture.md)
- 迭代历史与版本记录：请参阅 变更日志 (CHANGELOG.md)
- 参与贡献与打包说明：请参阅 贡献指南 (CONTRIBUTING.md)
- 未来规划与生态演进：请参阅 产品路线图 (ROADMAP.md)
- 开源许可协议：请参阅 MIT License (LICENSE)
- 项目仓库地址：https://github.com/SenZh/SkillBox