1. 项目概述一个桌面端的AI技能管理中枢如果你和我一样同时在使用Claude Code、Cursor、Windsurf等多个AI编程工具那你一定遇到过这个痛点每个工具都有自己的“技能”Skills系统用来扩展AI的能力。但问题是这些技能文件散落在用户目录下不同的文件夹里比如~/.claude/skills/、~/.cursor/skills/。管理起来极其麻烦——想安装一个新技能得手动复制到每个目录想更新或删除又得一个个去找。更别提在不同工具间同步和共享技能了简直是一场文件管理的噩梦。skills-manage就是为了终结这场噩梦而生的。它是一个基于Tauri框架构建的跨平台桌面应用核心使命就一个成为你所有AI编程工具技能的统一管理中心。它遵循了Anthropic提出的 Agent Skills 开放模式将~/.agents/skills/目录确立为技能的“唯一真相源”。所有技能都集中存放在这里然后通过创建符号链接symlink的方式“安装”到各个AI工具对应的目录中。这样一来你只需要在skills-manage里管理一次所有关联的工具就都能用上最新的技能。这个工具特别适合两类人一是重度依赖多个AI编程助手的开发者二是喜欢探索和收集各种AI技能并希望高效组织它们的极客。它把原本零散、手动的操作变成了一个可视化、可批量操作的管理流程。2. 核心功能与设计思路拆解2.1 中心化库与平台化安装设计哲学的胜利skills-manage最核心的设计思想是“中心化存储分布式链接”。这听起来有点抽象我打个比方你可以把~/.agents/skills/目录想象成你的“个人技能应用商店”里面整整齐齐地存放着所有技能的原始文件。而Claude Code、Cursor这些工具就像是不同的“手机品牌”平台它们各自有一个“应用安装目录”如~/.claude/skills/。传统方式是你手动把同一个“应用”技能的安装包复制粘贴到每个品牌的目录里。而skills-manage的做法是只在中心商店存一份正版然后在每个品牌的目录里创建一个“快捷方式”符号链接指向中心商店里的那份文件。这样做有三大好处空间节省一个技能只占一份磁盘空间无论它被多少个平台使用。管理统一更新、删除技能只需要在中心商店操作一次所有平台的“快捷方式”会自动生效或失效。状态清晰在skills-manage的界面上你可以一目了然地看到某个技能在哪些平台已安装哪些未安装彻底告别了手动检查各个隐藏文件夹的混乱。这个设计巧妙借鉴了现代操作系统或包管理器如Homebrew、apt的思想将资源的存储与使用解耦。对于用户而言感知到的就是一个干净利落的“安装”与“卸载”按钮背后的符号链接创建与删除由应用自动完成。2.2 技能的全生命周期管理从发现到洞察仅仅能安装卸载还不够skills-manage围绕技能的全生命周期提供了一套完整的管理工具本地技能库管理这是基础。应用启动后会自动扫描~/.agents/skills/目录以卡片或列表形式展示所有技能。每个技能卡片会显示其名称、简介、所属平台等元信息。技能详情深度预览点击任意技能会进入一个功能强大的详情页。这里不仅渲染技能描述文件通常是skill.json和README.md的Markdown格式让你获得美观的阅读体验还提供“源代码”视图方便开发者直接查看原始的JSON配置。最让我觉得贴心的是“AI解释生成”功能。对于某些编写简略或技术性较强的技能你可以点击一个按钮调用配置好的AI API如OpenAI、Anthropic让AI为你总结这个技能的功能、用法和注意事项这对于快速理解陌生技能非常有帮助。项目级技能库发现很多开发项目会在根目录下放置一个.agents/skills/文件夹将项目专用的技能放在里面。skills-manage的“发现”功能可以扫描整个本地磁盘找出所有这些分散的项目技能库。你可以方便地浏览并将感兴趣的技能一键导入到你的中心库中实现了从项目到个人知识库的流动。技能集合当技能数量多起来后分类整理就变得必要。你可以创建不同的“集合”Collections例如“前端开发”、“Python工具”、“代码审查”然后将相关技能拖拽进去。更棒的是你可以针对某个平台比如Cursor一键安装整个集合里的所有技能实现批量部署效率提升巨大。2.3 外部技能生态集成市场与GitHub除了管理本地已有的获取新技能也是刚需。skills-manage提供了两条主要途径市场浏览应用内置了一个“市场”标签页这里聚合了来自官方或社区维护的技能列表。你可以像浏览应用商店一样按分类、热度查看技能并直接将其下载到你的中心库。市场数据通常通过一个远程的索引文件获取保证了技能的时效性。GitHub仓库导入这是对高级用户和开发者最友好的功能。很多技能以开源项目的形式托管在GitHub上。你只需要输入仓库的URL例如https://github.com/someuser/awesome-skillskills-manage会通过GitHub API获取仓库信息。你可以选择导入整个仓库或者只导入仓库中符合技能规范的特定文件夹。如果仓库是私有的你还可以预先在设置中配置GitHub个人访问令牌PAT来进行认证。这个功能直接将庞大的GitHub生态变成了你的技能后备库。2.4 性能与体验优化应对海量技能随着技能库的增长性能可能成为瓶颈。skills-manage在架构上做了不少优化延迟查询与虚拟列表在技能列表页面搜索和过滤操作是“延迟”执行的即不会在你每输入一个字符时就全量扫描而是有一个合理的防抖延迟避免界面卡顿。对于可能包含成千上万个技能的列表它采用了列表虚拟化技术只渲染当前可视区域及附近的行项极大减少了DOM节点数量保证了滚动的流畅性。懒加载索引技能的元数据如名称、描述、标签会被建立索引以加速搜索。这个索引的构建是“懒加载”的在应用启动或技能库变更时在后台进行不会阻塞主线程和用户操作。响应式导航与双语UI整个应用界面采用响应式设计在不同尺寸的窗口上都能有良好的布局。同时它完整支持中文和英文界面会根据你的系统语言自动切换对于中文用户非常友好。视觉上它内置了深受开发者喜爱的 Catppuccin 主题配色方案支持多种强调色颜值在线。3. 技术栈深度解析与选型理由3.1 为什么选择 Tauri 2这是整个项目的技术基石。Tauri 是一个用于构建跨平台桌面应用的工具链它用Rust编写核心并允许你使用任何前端框架来构建界面。相比传统的ElectronTauri 2 有几个决定性的优势这也是作者选它的关键原因极小的体积与内存占用Electron应用需要打包整个Chromium浏览器内核动辄上百MB。而Tauri应用使用操作系统自带的WebView在macOS上是WKWebViewWindows上是WebView2Linux上是WebKitGTK最终生成的安装包体积可以小到几MB内存占用也远低于同类Electron应用。对于skills-manage这样一个工具类应用轻量化是核心诉求。卓越的性能与安全性Rust语言保证了后端的性能与内存安全。所有涉及文件系统操作扫描目录、创建符号链接、数据库访问、网络请求等敏感或重型任务都在Rust后端执行前端只负责展示和交互。这种架构比纯JavaScript执行相同任务更高效、更安全。良好的原生集成Tauri 提供了强大的API来与操作系统交互比如访问文件系统、创建系统托盘图标、发送原生通知等这对于一个文件管理工具来说至关重要。现代的开发体验Tauri 2 与Vite构建工具深度集成支持前端热重载和Rust代码的增量编译开发体验流畅。注意由于Tauri依赖系统WebView在较旧的Linux发行版上可能需要手动安装WebKitGTK运行时。不过对于主流的Windows 10/11、macOS和现代Linux发行版开箱即用。3.2 前端架构React 19 TypeScript Tailwind CSS前端采用了非常现代且高效的技术组合React 19使用了最新的React版本受益于其并发特性如useTransition带来的更流畅交互体验尤其是在执行搜索、过滤等可能触发重渲染的操作时。TypeScript为整个前端代码提供了严格的类型检查。这对于一个管理结构化数据技能元数据、平台配置的应用来说能极大减少运行时错误提升代码维护性。项目中的src/types/目录定义了所有共享的数据类型。Tailwind CSS 4实用优先的CSS框架让开发者能够通过组合类名快速构建出美观、一致的UI。它也与React组件化开发模式完美契合。skills-manage的整个视觉风格包括对Catppuccin主题的支持都是通过Tailwind配置实现的。shadcn/ui这是一个基于Radix UI原语和Tailwind CSS构建的组件库。它不是一个传统的NPM包而是一套你可以直接复制到项目中的组件代码。这意味着你可以完全控制组件的样式和行为实现高度定制化同时又能获得一套设计精良、无障碍支持良好的基础组件如按钮、对话框、下拉菜单等。这比引入一个庞大的UI库更加轻量和灵活。状态管理Zustand对于这个规模的应用Redux可能过于繁重。Zustand是一个轻量级、易于使用的状态管理库。它用更少的样板代码实现了类似Redux的状态切片和更新逻辑非常适合管理应用的全局状态比如用户设置、技能列表数据、UI主题等。3.3 后端与数据持久化Rust SQLite后端逻辑全部由Rust编写通过Tauri的“命令”Commands机制暴露给前端调用。Rust生态使用了serde进行序列化前端传过来的JSON数据到Rust结构体的转换、sqlx进行类型安全的数据库查询、chrono处理时间、uuid生成唯一标识。Rust强大的类型系统和零成本抽象确保了后端逻辑既快又稳。SQLite数据库所有需要持久化的数据包括技能元数据缓存、集合信息、扫描历史、用户设置如API密钥、GitHub PAT、甚至AI生成的技能解释都存储在一个单一的SQLite数据库文件~/.skillsmanage/db.sqlite中。SQLite是一个服务器端的数据库引擎它只是一个文件非常适合桌面应用。sqlx库支持在编译时检查SQL语句的正确性进一步避免了运行时数据库错误。WAL模式数据库连接配置为WALWrite-Ahead Logging模式。这种模式允许多个线程同时读取数据库而写入操作也不会完全阻塞读取提升了应用的并发性能尤其是在后台同步市场数据或进行磁盘扫描时。3.4 国际化与路由i18n使用react-i18next和i18next-browser-languagedetector实现国际化。翻译文件存放在src/i18n/目录下结构清晰。系统会自动检测用户的语言偏好并加载对应的翻译。路由使用react-router-dom第7版来处理单页面应用内的视图切换。不同的功能模块如“所有技能”、“市场”、“集合”、“设置”都对应不同的路由路径使得应用结构清晰且支持浏览器前进后退导航。4. 安装、配置与核心使用流程4.1 获取与安装应用目前官方提供了macOSApple Silicon芯片的预编译安装包.dmg和.app.zip可以在项目的 GitHub Releases 页面下载。对于Windows和Linux用户暂时需要从源代码编译运行。macOS安装特别注意由于当前版本未经过苹果官方公证Notarized从网上下载后首次打开时macOS的Gatekeeper安全机制可能会阻止运行并提示“已损坏无法打开”。这通常不是应用真的损坏了而是系统对未签名应用的拦截。解决方法如下将skills-manage.app拖入“应用程序”文件夹。打开“终端”Terminal。输入以下命令并回车解除该应用的安全隔离属性xattr -dr com.apple.quarantine /Applications/skills-manage.app再次从“应用程序”文件夹或启动台打开应用即可。如果应用安装在其他路径请将上述命令中的路径替换为实际的.app文件路径。4.2 首次运行与初始配置首次启动skills-manage它会自动完成几件事在~/.agents/目录下创建skills/子目录如果不存在的话作为中心技能库。在~/.skillsmanage/目录下创建db.sqlite数据库文件用于存储所有管理数据。扫描~/.agents/skills/目录加载其中已有的技能。扫描系统尝试自动检测并注册已安装的AI编程工具如Claude Code, Cursor对应的技能目录。初始化后建议你首先进入“设置”页面进行以下配置平台管理检查“支持的平台”列表。这里应该已经自动识别出了你系统上安装的部分工具。你可以在这里启用或禁用某个平台也可以手动“添加自定义平台”只需要提供平台名称和其对应的技能目录绝对路径即可。这体现了应用的扩展性即使未来有新的、未被内置支持的AI工具出现你也可以手动添加。网络与APIGitHub访问令牌如果你需要从私有GitHub仓库导入技能或者避免公开仓库的API速率限制强烈建议在这里配置一个GitHub Personal Access Token (PAT)。只需要“repo”权限即可。AI解释API如果你想使用“AI解释生成”功能需要在这里配置AI服务的API密钥和端点。它支持OpenAI兼容的API包括OpenAI自身、以及许多部署了开源模型的服务也支持Anthropic Claude的API。配置好后在技能详情页点击“生成AI解释”按钮就能快速获得对技能的解读。外观在这里切换浅色/深色主题或者选择Catppuccin的拿铁、摩卡、玛奇朵、焦糖四种风味主题并挑选喜欢的强调色。4.3 核心工作流演示假设你现在想为你的Claude Code和Cursor安装一个“代码审查”技能。步骤一获取技能方式A从市场点击侧边栏的“市场”标签。在列表或通过搜索找到名为“Code Reviewer”的技能点击卡片上的“下载”图标。应用会从配置的市场源获取该技能的元数据和文件并保存到你的~/.agents/skills/code-reviewer/目录下。方式B从GitHub导入点击市场页面的“从GitHub导入”按钮。输入技能仓库的URL例如https://github.com/example/code-reviewer-skill。应用会获取仓库信息你确认要导入的文件夹后点击导入技能就会被克隆到你的中心库。步骤二安装到平台回到“所有技能”页面找到刚刚添加的“Code Reviewer”技能。在技能卡片上你会看到一列平台图标Claude Code, Cursor等。图标是灰色的表示未安装蓝色表示已安装。点击Claude Code的灰色图标它会变成蓝色。此时应用的后台Rust代码会执行一个操作在~/.claude/skills/目录下创建一个指向~/.agents/skills/code-reviewer/的符号链接在Windows上可能是目录连接点。同理点击Cursor的图标进行安装。现在打开Claude Code和Cursor你应该就能在它们的技能列表里看到并使用“Code Reviewer”了。步骤三管理与组织查看详情点击技能卡片进入详情页。在这里阅读精美的Markdown文档查看原始的skill.json配置或者点击“用AI解释”来快速理解其功能。创建集合点击侧边栏的“集合”新建一个名为“代码质量”的集合。然后将“Code Reviewer”和其他相关的代码检查、格式化技能拖拽进这个集合。批量安装当你换了一台新电脑或者想在另一个AI工具比如Windsurf上也配置这套“代码质量”技能时你不需要一个个操作。只需要在“集合”页面找到“代码质量”集合点击旁边的“安装到平台”按钮选择“Windsurf”这个集合里的所有技能就会一次性被链接到Windsurf的目录中。发现本地项目技能点击“发现”标签页应用会扫描你的硬盘你可以指定扫描路径。它可能会发现你某个项目里的.agents/skills/目录。你可以浏览这些项目特有的技能并选择性地导入到你的个人中心库丰富你的武器库。5. 开发指南从零开始参与贡献如果你想自己编译运行或者想为这个开源项目贡献代码以下是详细的步骤。5.1 环境准备你需要配置以下开发环境Node.js与包管理器安装最新的LTS版本Node.js。然后安装pnpm一个更快的Node.js包管理器因为项目用它来管理前端依赖。# 以macOS为例使用Homebrew brew install node brew install pnpmRust工具链Tauri的后端是Rust写的所以需要Rust。推荐通过rustup安装。curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh安装完成后重启终端运行rustc --version检查是否成功。系统依赖Tauri需要一些系统库。请务必查阅 Tauri v2 先决条件页面 根据你的操作系统macOS, Windows, Linux安装所需的开发工具链如C编译器、WebView2运行时等。5.2 获取代码与安装依赖克隆项目仓库并安装所有依赖git clone https://github.com/iamzhihuix/skills-manage.git cd skills-manage pnpm install # 安装前端依赖pnpm install会自动安装package.json中定义的所有JavaScript/TypeScript依赖。同时它也会运行一个后置脚本确保Tauri所需的Rust依赖也被正确准备。5.3 启动开发服务器运行以下命令启动开发环境pnpm tauri dev这个命令会同时启动两个进程Vite开发服务器为前端React代码提供热重载服务运行在http://localhost:24200。Tauri开发窗口一个原生的桌面窗口加载上述前端页面并准备好Rust后端。现在你对前端代码src/下的文件的任何修改都会实时反映在窗口中。对Rust后端代码src-tauri/src/下的文件的修改则需要短暂的重新编译后生效。5.4 项目结构导航了解项目结构有助于快速定位代码skills-manage/ ├── src/ # 前端源码 │ ├── components/ # 可复用的React组件按钮、卡片、模态框等 │ ├── i18n/ # 国际化文件 (en.json, zh.json) │ ├── lib/ # 前端工具函数、API客户端 │ ├── pages/ # 页面级组件对应路由 │ ├── stores/ # Zustand状态管理store │ ├── test/ # Vitest单元测试和React Testing Library测试 │ └── types/ # TypeScript类型定义 ├── src-tauri/ # Rust后端 │ ├── src/ │ │ ├── commands/ # Tauri命令处理函数前端调用的后端接口 │ │ ├── db.rs # 数据库连接、迁移、查询函数 │ │ ├── lib.rs # Tauri应用构建和配置 │ │ └── main.rs # 程序入口点 │ └── Cargo.toml # Rust依赖和配置 ├── public/ # 静态资源图片、图标 └── ... (配置文件)5.5 代码质量验证在提交代码或Pull Request前建议运行以下检查以确保代码质量# 运行前端测试 pnpm test # 运行TypeScript类型检查 pnpm typecheck # 运行ESLint代码风格检查 pnpm lint # 进入后端目录运行Rust测试 cd src-tauri cargo test # 运行ClippyRust的代码检查工具 cd src-tauri cargo clippy -- -D warnings项目配置了Git钩子在提交时可能会自动运行部分检查。6. 隐私、安全与故障排查6.1 隐私与数据安全设计作为一个管理本地文件的工具skills-manage在隐私和安全方面考虑得比较周到数据本地优先所有数据包括技能元数据、你的集合、扫描历史、设置含API密钥都存储在本地SQLite数据库~/.skillsmanage/db.sqlite或你的技能文件目录中。没有数据会被自动上传到任何远程服务器。无遥测应用不包含任何分析、崩溃报告或使用情况跟踪代码。你的操作行为不会被收集。按需网络访问应用只在执行明确需要网络的功能时才发起请求同步市场列表、从GitHub下载技能、调用AI API生成解释。除此之外它处于离线状态。密钥本地存储你输入的GitHub PAT和AI API密钥会以明文形式存储在本地数据库的settings表中。这意味着你需要像保护密码一样保护你的电脑和这个数据库文件。应用本身没有提供加密这些密钥的功能这是当前的一个设计取舍将安全责任部分交给了操作系统和用户。重要安全提醒绝对不要在GitHub Issue、Pull Request、截图或日志中泄露真实的API密钥、访问令牌或任何其他敏感信息。如果意外泄露请立即到相应的服务商处撤销该凭证。6.2 常见问题与解决方案在实际使用和开发中你可能会遇到以下问题1. 技能在应用中显示但在AI工具中不显示或无效。可能原因符号链接创建失败或不被AI工具支持。排查步骤在skills-manage中确认技能已“安装”到目标平台图标为蓝色。打开终端导航到AI工具的技能目录例如cd ~/.claude/skills/。运行ls -la查看文件列表。你应该能看到以结尾的符号链接macOS/Linux或者一个特殊的链接文件Windows。如果链接不存在可能是权限问题。尝试在skills-manage中先卸载再重新安装。如果链接存在但AI工具不识别可能是技能文件本身格式不符合该工具的要求。检查AI工具的官方文档确认其技能规范。2. 市场页面空白或加载失败。可能原因网络问题或市场源URL配置错误/不可用。排查步骤检查网络连接。查看开发者工具在应用内按F12或CmdOptionI的控制台(Console)和网络(Network)标签页看是否有请求错误。市场源URL定义在前端代码或配置文件中。如果是开源贡献者可以检查相关代码如果是普通用户可以等待开发者修复或尝试后续版本。3. GitHub导入失败提示“API速率限制”或“认证失败”。可能原因未认证的GitHub API请求有严格的速率限制对于私有仓库必须提供PAT。解决方案前往skills-manage的设置页面在“GitHub”部分添加一个有效的Personal Access Token需要repo权限。添加后重试导入操作。4. AI解释生成失败。可能原因未配置API密钥或密钥无效或网络不通。排查步骤检查设置中是否已正确配置AI API如OpenAI或Anthropic的密钥和基础URL如果是第三方托管服务。确认你的API密钥有余额且未过期。查看开发者工具的网络请求确认请求是否成功发出以及API返回的错误信息是什么。5. 应用启动崩溃或界面异常。可能原因本地数据库文件损坏或与旧版本不兼容。解决方案尝试重启应用。如果问题依旧可以尝试重命名或移走~/.skillsmanage/db.sqlite文件注意这会丢失所有设置、集合和缓存数据然后重启应用让它创建一个新的干净数据库。你的核心技能文件在~/.agents/skills/不会受影响。如果是开发版本检查Rust后端编译是否有错误。6. 在Linux上应用无法启动或界面不显示。可能原因缺少WebView运行时依赖。解决方案根据你的Linux发行版安装WebKitGTK。例如在Ubuntu/Debian上sudo apt install libwebkit2gtk-4.1-dev。请参考Tauri官方文档中针对你的发行版的详细说明。6.3 高级技巧与心得技能目录的灵活管理虽然默认中心库是~/.agents/skills/但你可以通过创建符号链接的方式将其指向另一个位置例如Dropbox、iCloud Drive同步的文件夹从而实现技能库在多台电脑间的同步。只需在终端执行ln -s /path/to/your/sync/folder ~/.agents/skills即可。skills-manage会跟随这个链接。批量操作提升效率善用“集合”功能。将常用的技能分组在配置新环境时批量安装整个集合比一个个点击安装快得多。利用“发现”功能积累资产定期用“发现”功能扫描你的代码项目目录。很多优秀的开源项目都内置了实用的技能这是发现宝藏技能的好方法可以直接“拿来主义”。为自定义平台创建技能如果你使用的AI工具不在内置列表除了在设置中添加自定义平台你还可以为其编写技能。技能的本质是一个包含skill.json元数据和README.md文档的文件夹。参考 Agent Skills规范 你可以为自己常用的操作如“生成特定框架的组件”、“运行项目测试套件”创建技能然后在skills-manage中管理它们。开发调试在开发模式下前端错误会显示在浏览器开发者工具中。后端Rust的日志输出则可以在运行pnpm tauri dev的终端里看到这对于调试文件操作、数据库查询等后端逻辑至关重要。skills-manage解决了一个非常具体但普遍存在的痛点它的设计体现了“一次管理处处使用”的优雅思想。通过将现代前端、高性能Rust后端和本地文件系统操作相结合它提供了一个既美观又实用的解决方案。无论是作为最终用户来提升AI编程工具的使用体验还是作为开发者学习Tauri全栈桌面开发、状态管理、国际化等技术的优秀范例这个项目都值得深入探索和使用。