ai-skillhub

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# AI SkillHub

**简体中文** | [English](https://github.com/Francis-Zxp/AI-SkillHub/blob/HEAD/README_EN.md)

把分散在 GitHub、本地目录和不同 AI 工具里的 Skills，整理成一张可识别、可搜索、可评分、可路由、可同步的能力图谱。

AI SkillHub 是一款面向 Windows 的本地优先 Skill 管理器：导入真实 `SKILL.md`，区分 Prompt 资料与可调用 Skill，自动概括用途与使用方法，组织父子关系与同名路由，并把经过筛选的能力安全同步给 Claude Code、Codex、Antigravity 等工具。

<img width="2560" height="1526" alt="AI SkillHub 3.x" src="https://github.com/user-attachments/assets/408eab67-1912-47ca-af5d-3dad1c383e01" />

## 现在能做什么

- 从 GitHub、本地文件夹、zip / `.skill` 包导入来源。
- 只把包含 `SKILL.md` 的目录识别为可调用 Skill；Prompt 仓库保留为资料，不伪装成 Skill。
- 根据 `README`、`SKILL.md` 与来源信息离线生成简介、用途、用法、分类和自定义标签；用户修改永远优先。
- 导入进入正式资料库前执行逐文件安全扫描；高风险始终阻止写入，中风险展示脱敏证据并留在隔离区，只有用户明确确认后才会加入资料库。
- 父 Skill 只路由到同一来源内的明确子 Skill 文件；同名子 Skill 保留
  来源限定别名，仅高级用户的明确选择才会建立全局短名入口。
- 给来源与子 Skill 进行本地 1–5 星评分，并按评分优先排序。
- 锁定 Git 来源版本、预览上游更新差异，并在存在已验证备份时一键回滚。
- 用个人/子评分、健康、真实本地使用和安全扫描生成可解释质量分；缺失证据不计零分，GitHub stars 仍只表示热度。
- 用真实来源、分类、父子关系、个人评分和 GitHub 热度生成可交互能力星图。
- 检测 Claude Code、Codex、Antigravity 等本机工具；适配器医生会解释桌面应用、Code 能力、PATH 与 Skills 目录分别处于什么状态。
- 保存诊断、审计、快照和回滚信息，不向新用户展示开发发布工具。
- v4 恢复完成且数据库健康后，用白名单清理助手把旧便携数据移动到可恢复备份；开发者 `release` 目录不自动处理。

## 安装与自动更新

前往 [GitHub Releases](https://github.com/Francis-Zxp/AI-SkillHub/releases/latest) 下载：

- 推荐：`AI-SkillHub-<版本>-setup.exe`
- 备用：`AI-SkillHub-<版本>.zip`

v3.0.3 是自动更新起点。安装 v3.0.3 或更高版本后，软件会自动检查官方正式版；只有通过 AI SkillHub 更新公钥验证的签名安装包才会被接受。后续更新替换受管理的程序文件并重启，来源、评分、设置与 SQLite 索引继续保存在：

```text
%LOCALAPPDATA%\AI SkillHub\UserData\
```

v3.0.2 及更早版本没有更新器，因此需要手动安装一次当前正式版。v3.0.4
起的可恢复迁移会逐来源复制和校验旧资料，并在合并本地备注、标签、评分
等 SQLite 元数据前创建备份；它不会覆盖更新的来源。v3.0.5 又把来源
下载、安全扫描和写入移到后台线程并显示五阶段进度。恢复完成后，用户
可用安全清理助手逐项确认并移动白名单中的旧数据，`release` 始终保留
手动处理。

v3.0.6 会对刚发布版本尚未同步到全部 GitHub 更新端点的情况自动重试，
无需退出软件。主页会先恢复上一份真实星图缓存，再过渡到当前 SQLite
索引；缓存不保存来源绝对路径、备注或完整 Skill 内容，手动“同步并刷新”
仍代表真实的 Git/工具同步，不会用快速动画伪装完成。

v3.0.7 把启动时的快速本地读取明确标成“加载本地索引”，不再称作同步；
只有手动同步才会访问 Git/工具链。编辑侧栏现已逐主题校验可读性，星图
体积光与几何球心严格重合，空间背景提供受性能约束的 5–20 条会话级随机
流星。首页右上角可进入沉浸模式，也可直接打开官方 GitHub 项目；`Esc`
可随时退出沉浸模式。

## 最短使用流程

1. 打开 AI SkillHub，进入「技能库」。
2. 粘贴 GitHub 仓库地址，或选择本地 Skill 文件夹。
3. 点击「一键添加并刷新」。
4. 检查自动识别的简介、用途、用法与标签；需要时直接编辑或对现有资料库一键重新识别。
5. 在「AI 工具」中只启用实际检测到的工具，再执行同步。

## 重要边界

- 不创建不存在的 Codex、Claude 或其他 AI 工具目录。
- 不把 Prompt 仓库安装成 Skill。
- 不执行导入来源中的脚本；自动元数据识别只读取有边界的文本证据。
- 不覆盖用户目录；涉及真实写入前必须有快照、确认与诊断记录。
- 公开发布包不包含个人 Skills、私有来源、评分、配置、报告或构建缓存。

## 开发

本地开发入口：

```text
AI SkillHub.exe
```

正式发布会同时生成签名 NSIS 安装器、更新清单、SHA-256、便携包，并把仓库根目录的开发者 EXE 刷新为同一个版本。详细架构、路由规则与开发命令见 [English documentation](https://github.com/Francis-Zxp/AI-SkillHub/blob/HEAD/README_EN.md)、[使用说明](https://github.com/Francis-Zxp/AI-SkillHub/blob/HEAD/使用说明.md) 和 [Skill Router Standard](https://github.com/Francis-Zxp/AI-SkillHub/blob/HEAD/docs/skill-router-standard.md)。

## 作者

FrancisZhu

AI SkillHub

简体中文 | English

把分散在 GitHub、本地目录和不同 AI 工具里的 Skills，整理成一张可识别、可搜索、可评分、可路由、可同步的能力图谱。

AI SkillHub 是一款面向 Windows 的本地优先 Skill 管理器：导入真实 SKILL.md，区分 Prompt 资料与可调用 Skill，自动概括用途与使用方法，组织父子关系与同名路由，并把经过筛选的能力安全同步给 Claude Code、Codex、Antigravity 等工具。

现在能做什么

从 GitHub、本地文件夹、zip / .skill 包导入来源。
只把包含 SKILL.md 的目录识别为可调用 Skill；Prompt 仓库保留为资料，不伪装成 Skill。
根据 README、SKILL.md 与来源信息离线生成简介、用途、用法、分类和自定义标签；用户修改永远优先。
导入进入正式资料库前执行逐文件安全扫描；高风险始终阻止写入，中风险展示脱敏证据并留在隔离区，只有用户明确确认后才会加入资料库。
父 Skill 只路由到同一来源内的明确子 Skill 文件；同名子 Skill 保留来源限定别名，仅高级用户的明确选择才会建立全局短名入口。
给来源与子 Skill 进行本地 1–5 星评分，并按评分优先排序。
锁定 Git 来源版本、预览上游更新差异，并在存在已验证备份时一键回滚。
用个人/子评分、健康、真实本地使用和安全扫描生成可解释质量分；缺失证据不计零分，GitHub stars 仍只表示热度。
用真实来源、分类、父子关系、个人评分和 GitHub 热度生成可交互能力星图。
检测 Claude Code、Codex、Antigravity 等本机工具；适配器医生会解释桌面应用、Code 能力、PATH 与 Skills 目录分别处于什么状态。
保存诊断、审计、快照和回滚信息，不向新用户展示开发发布工具。
v4 恢复完成且数据库健康后，用白名单清理助手把旧便携数据移动到可恢复备份；开发者 release 目录不自动处理。

安装与自动更新

前往 GitHub Releases 下载：

推荐：AI-SkillHub-<版本>-setup.exe
备用：AI-SkillHub-<版本>.zip

v3.0.3 是自动更新起点。安装 v3.0.3 或更高版本后，软件会自动检查官方正式版；只有通过 AI SkillHub 更新公钥验证的签名安装包才会被接受。后续更新替换受管理的程序文件并重启，来源、评分、设置与 SQLite 索引继续保存在：

%LOCALAPPDATA%\AI SkillHub\UserData\

v3.0.2 及更早版本没有更新器，因此需要手动安装一次当前正式版。v3.0.4 起的可恢复迁移会逐来源复制和校验旧资料，并在合并本地备注、标签、评分等 SQLite 元数据前创建备份；它不会覆盖更新的来源。v3.0.5 又把来源下载、安全扫描和写入移到后台线程并显示五阶段进度。恢复完成后，用户可用安全清理助手逐项确认并移动白名单中的旧数据，release 始终保留手动处理。

v3.0.6 会对刚发布版本尚未同步到全部 GitHub 更新端点的情况自动重试，无需退出软件。主页会先恢复上一份真实星图缓存，再过渡到当前 SQLite 索引；缓存不保存来源绝对路径、备注或完整 Skill 内容，手动“同步并刷新” 仍代表真实的 Git/工具同步，不会用快速动画伪装完成。

v3.0.7 把启动时的快速本地读取明确标成“加载本地索引”，不再称作同步；只有手动同步才会访问 Git/工具链。编辑侧栏现已逐主题校验可读性，星图体积光与几何球心严格重合，空间背景提供受性能约束的 5–20 条会话级随机流星。首页右上角可进入沉浸模式，也可直接打开官方 GitHub 项目；Esc 可随时退出沉浸模式。

最短使用流程

打开 AI SkillHub，进入「技能库」。
粘贴 GitHub 仓库地址，或选择本地 Skill 文件夹。
点击「一键添加并刷新」。
检查自动识别的简介、用途、用法与标签；需要时直接编辑或对现有资料库一键重新识别。
在「AI 工具」中只启用实际检测到的工具，再执行同步。

重要边界

不创建不存在的 Codex、Claude 或其他 AI 工具目录。
不把 Prompt 仓库安装成 Skill。
不执行导入来源中的脚本；自动元数据识别只读取有边界的文本证据。
不覆盖用户目录；涉及真实写入前必须有快照、确认与诊断记录。
公开发布包不包含个人 Skills、私有来源、评分、配置、报告或构建缓存。

开发

本地开发入口：

AI SkillHub.exe

正式发布会同时生成签名 NSIS 安装器、更新清单、SHA-256、便携包，并把仓库根目录的开发者 EXE 刷新为同一个版本。详细架构、路由规则与开发命令见 English documentation、使用说明和 Skill Router Standard。

作者

FrancisZhu