--- slug: "ai-skillhub" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/Francis-Zxp/AI-SkillHub@main/README.md" repo: "https://github.com/Francis-Zxp/AI-SkillHub" source_file: "README.md" branch: "main" --- # 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 等工具。 AI SkillHub 3.x ## 现在能做什么 - 从 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