像用应用商店一样，管理你的 AI 技能。
SkillSync 是一个桌面应用。它把公司的 AI 技能库变成可浏览、可搜索、一键获取的商店界面， 让不熟悉命令行的同事也能用上团队沉淀的 AI 能力——全程不需要接触任何开发工具。
获取的技能会自动出现在你电脑上的 AI 工具里（Claude Code、Cursor、Codex、Trae 等）， 下次和 AI 对话时，它就知道该怎么帮你做那件事。
AI 技能（skill）是一份写给 AI 的说明书，告诉它遇到某类任务时该怎么做—— 比如"把这周的工作记录整理成周报"、"按公司模板写会议纪要"。 一个人写好，全组都能用。
难点从来不在写，而在分发：过去要用上别人写的技能，得会用命令行工具、 得知道技能库在哪、得手动把文件放进正确的目录——而每个 AI 工具的目录还都不一样。 技能更新了也没人通知你。
SkillSync 把这些全包了：
| 你想做的事 | 在 SkillSync 里 |
|---|---|
| 看看团队有哪些技能 | 打开技能商店，搜索、看介绍 |
| 用上某个技能 | 点「获取」，勾选要在哪些 AI 工具里生效 |
| 技能出了新版本 | 自动检查并通知，一键更新 |
| 把自己的技能给团队 | 打开分享，填个说明就提交 |
| 从零写一个新技能 | 分享页点「新建技能」，给你一份模板 |
- 从内部渠道取得
SkillSync_<版本号>_universal.dmg（当前0.3.11） - 双击打开，把 SkillSync 拖进「应用程序」文件夹
- 直接双击启动
分发时请发 dmg 文件本身或下载链接。用聊天软件直接发应用程序（
.app）会因为 压缩解压丢失文件权限而无法打开——那不是应用的问题，换 dmg 即可。
应用已通过 Apple 签名与公证，不需要右键打开、也不需要去系统设置放行。 Apple Silicon 与 Intel 两种 Mac 都支持。
- 从内部渠道取得
SkillSync_<版本号>_x64-setup.exe（当前0.3.11，64 位） - 双击安装。它按当前用户安装，不需要管理员权限、不会弹 UAC
- 从开始菜单启动
Windows 会提示「Windows 已保护你的电脑 / 未知发布者」。这是因为安装包还没有 代码签名证书，不代表有问题：点「更多信息」→「仍要运行」即可。
安装包为 64 位（x64）。
首次启动有一个三步引导：
① 认识你的 AI 工具 应用会扫描这台电脑，列出找到的 AI 工具。之后获取的技能会自动对它们生效。 没检测到也不要紧——技能仍会存好，等你装了工具就能用。
② 登录公司技能库 登录后才能把自己的技能分享给团队。 只是想用别人的技能，可以先跳过，之后随时能在「设置」里补登。
③ 装上第一批技能 如果团队准备了精选清单，这里可以勾选后一键装上；没有清单就直接去商店逛。
引导只出现一次。
左侧是导航栏，四个页面：技能商店 · 我的技能 · 分享 · 设置。
⌘1 ⌘2 ⌘3 ⌘4 快速切换。
找
- 顶部搜索框直接输关键词（用拼音输入法打字时不会误触发搜索）
⌘K打开命令面板，输几个字直接跳到某个技能/快速聚焦搜索框- 上方筛选可以只看「未安装」或「已安装」
- 技能库管理员给技能打了标签时，筛选下方会多一行标签，点一个只看这类技能 （再点取消）。库里没配标签就不显示这一行。
看 点技能卡片，右侧展开详情面板：完整说明文档、所属技能库、当前版本。 技能库管理员配置了作者信息时，卡片底部会显示作者，详情面板会显示作者与贡献者 （没配置就不显示这一栏，应用不会瞎猜）。
装 点卡片上的「获取」，勾选要在哪些 AI 工具里生效—— 只在 Claude Code 里用它，就只勾 Claude Code。装完按钮变成「已启用」。
装到某个项目文件夹（0.5.0 起）
「获取」按钮右边有个小箭头，点开可以选「装到项目…」，选一个文件夹，
技能就只装进那个文件夹、只在那里生效——适合"这个技能只跟这个项目有关"的情况。
装过之后，箭头菜单里会列出最近用过的文件夹，下次点一下就装。
装进项目的技能用的是与命令行工具 npx skills 完全相同的存放方式：
文件放在 <你的文件夹>/.agents/skills/ 下，记录写在文件夹根部的 skills-lock.json。
所以两边能互相认出对方装的技能——你用 SkillSync 装的，同事用命令行也能看到和更新。
这个菜单里的工具选择沿用设置里的默认（没被你关掉的那些），不再单独问一次。 要改某个技能关联了哪些工具，去「我的技能」里改。
按钮上的四种状态
| 显示 | 含义 |
|---|---|
| 获取 | 还没装 |
| 已启用 | 装好了，且是最新的 |
| 更新 | 装过了，技能库里出了新版本 |
| 替换 | 你装的同名技能来自另一个技能库，点了会换成当前这个 |
「替换」和「更新」是两回事。 同名技能来自不同技能库时，内容通常完全不同。 应用不会把它当成一次普通更新悄悄换掉，而是明确问你一次。
多个技能库 配置了不止一个技能库时，商店上方会出现切换器，各库的技能分开展示。
0.4.0起提供。如果你打开应用找不到下面说的「技能广场」这一档， 不是操作问题，是版本还不够新——去「设置 → 检查应用更新」升一下。
商店的库切换器里固定有一档「技能广场」，除了公司技能库之外，还能搜到全网公开分享的 AI 技能（数据来自 skills.sh）。
用：切到「技能广场」→ 首屏直接列出全网热门技能（不用先想搜什么，
卡片样式与公司技能库完全一致）→ 往下滚会自动接着加载后面的技能，不用翻页、
也不用点「加载更多」，热门榜能一直滚到几百条 → 想找特定技能就在搜索框输入关键词
（至少 2 个字符），输入完按回车才真的去搜（搜一次要走外网，边打字边搜会又慢
又抖，所以由你决定什么时候搜）；把搜索框清空就回到热门榜，不用再按一次回车。
搜索过程中右上角的刷新按钮会转圈；同一个词连按几次回车不会重复发请求，但换个词
按回车立刻就以新的那次为准，不用等上一次的结果回来（换了搜索词，列表从头开始，
不会停在你上次滚到的位置）→ 结果卡片显示技能名、来源技能库
（拥有者/技能库名 这样的格式）与全网安装量 → 点开卡片会当场联网获取详情
（说明文档、文件列表）→ 确认没问题就点「获取」，跟从公司技能库装技能一样，
勾选要在哪些 AI 工具里生效。
装完之后它就是一个普通技能：出现在「我的技能」里，会自动检查更新， 用法与公司技能库装的技能完全一样。卡片上还有「在浏览器中查看」， 跳到 skills.sh 上那个技能的页面。
热门榜偶尔拉不到（对方网站改版之类），这一档会安静地退回「输入关键词搜索」的 提示，搜索照常能用——不会弹报错打断你。
列出这台电脑上你拥有的所有技能，以及它们在哪些 AI 工具里生效。分四部分：
-
由技能库管理 — 应用在管的技能，更新/修复/分享改动/移除都在这里；
-
本地创建 — 你自己新建或手放进技能目录的，还没进过技能库；
-
其他工具装的 — 命令行工具（
npx skills）装的、应用还没接手的。 如果它来自你配置过的技能库，这里会给「纳入管理」——点一下就交给应用管， 文件一个字节都不会动，反悔了点「移出管理」即可，同样不动文件。 如果它的来源不在你的技能库列表里，这里给的是「分享到技能库」： 先把它推进公司库，之后就能像其他技能一样自动更新。 -
装在项目里的（
0.5.0起）— 装进某个具体文件夹、只在那个文件夹里生效的技能， 按文件夹分组列出。每个技能可以单独更新或移除；整个文件夹可以「从列表移除」， 那只是不再显示它，文件夹和里面的技能一个字节都不会动。 文件夹被删掉或移走时，这里会如实说明，并且只留「从列表移除」这一个动作。
侧边栏「我的技能」右侧的数字，是有新版本可用的技能数。
更新 技能库里出了新版本时，条目上会出现标记，点「更新」即可。
如果你本地改过这个技能，更新时会先问你：
- 保留我的改动 — 不覆盖，本地版本原样留着
- 用新版本覆盖 — 你的改动会丢失
- 保留并分享 — 保留改动，同时把它推给团队（推荐）
应用绝不会在不问你的情况下覆盖你改过的文件。
修复关联 某个 AI 工具里突然读不到技能了（比如你手动整理过文件夹），点「修复关联」重建。 条目上会标出具体问题：关联已丢失 / 位置被占用 / 指向了别处。
卸载 点「移除」，会先确认一次。如果你改过这个技能的内容，会再红色警示确认一次—— 删掉找不回来。
分享改动 改过的已装技能，点「分享改动」可以把改动推回它的来源技能库。
如果在你获取之后，其他人也更新过这个技能，应用会先停下来告诉你， 并给出对方改动的查看链接。此时你的改动不会顶掉对方——确认后会转为 提交审核，由技能库管理员定夺；不想处理也可以先不动，改动仍在你电脑上。
这一页列出可以分享的本地技能——你自己写的、或用其他工具装的。 从公司技能库获取的技能不在此列（它们的改动走「我的技能」里的「分享改动」）。
新建一个技能
点「新建技能」，填三样：
| 字段 | 说明 | 例子 |
|---|---|---|
| 技能名称 | 给人看的名字，可以用中文 | 周报生成 |
| 技能描述 | 一句话说清它能帮人做什么 | 把本周的工作记录汇总成周报 |
| 文件夹名称 | 英文小写 | weekly-report |
创建后会在你的技能目录里生成一份 SKILL.md 模板。
用任意编辑器打开，按模板的三段（做什么 / 何时使用 / 步骤）写完，就能分享给团队。
新建的技能，Cursor 和 Codex 立刻就能读到； Claude Code 和 Trae 要等它分享到技能库、再从商店获取回来才能用。
分享出去
点技能条目上的「分享…」，确认名称和描述后提交。 提交前，应用会先告诉你这次分享会走哪条路：
- 你的改动会直接生效
- 你的改动需要管理员审核，通过后才会生效
- 会先复制一份到你的账号下，再请管理员审核
走哪条取决于你在那个技能库的权限。应用会提前探明并如实告知； 探不到就什么都不说，不猜。
如果技能库里已有同名技能，会让你三选一：换个名字 / 看看对方的 / 覆盖。
账号 — 登录、退出、查看当前身份
技能库来源 — 添加、移除技能库。公司内建的技能库锁定，不可删除。 一个来源下可以挂多个技能库。
外观
- 主题：浅色 / 深色 / 跟随系统
- 强调色：陶土橙 / 深青绿 / 墨蓝
AI 工具 — 逐个开关。关掉的工具不会再收到新技能。 没装的工具标「未检测到，安装后自动启用」。
更新
- 自动更新技能：手动 / 每 5 分钟 / 每 4 小时 / 每天，新装默认「每 5 分钟」。 嫌太勤可以随时调低，调过之后升级不会把你的选择改回去
- 自动更新应用：每分钟检查一次，有新版本就在后台悄悄准备好，左下角随后出现
「新版本已就绪，重启后生效」——点「立即重启」即可，不重启也不影响使用，
应用不会自己关掉打断你。这一项与上面的技能更新频率互不影响
Windows 上点「立即重启」后会先跑一下安装程序（Windows 不允许替换正在运行的程序， 这一步躲不掉），装完应用会重新打开。macOS 上是直接重启。
- 「立即检查」：马上比对一次技能库
版本历史 — 每一版改了什么，默认收起，点开看正文。 装上新版第一次打开时，商店页顶部还会出现一张卡片直接告诉你这一版的改动， 关掉它才算看过（不关的话下次打开还在）。
关掉窗口就退出了吗？
不会。关窗口只是收进菜单栏，应用继续在后台检查技能更新。
要完全退出，点菜单栏图标 →「退出」，或按 ⌘Q。
技能装到哪里去了？
统一存放在你用户目录下的 .agents/skills/。
对需要关联的 AI 工具（如 Claude Code），应用会在它自己的目录里建一个指向该处的链接。
在「我的技能」里点技能可以看到具体路径，也能直接在访达中打开。
它会动我别的文件吗？ 只动它自己装的技能。任何可能让你的内容丢失的操作，都会先问过你。
作者是从哪来的？为什么有的技能没有作者？ 作者与贡献者记在技能库里，由应用在分享时自动维护：谁第一次分享某个技能，谁就是作者； 之后改过它的人成为贡献者。技能库里没有这条记录时，界面就不显示作者栏——应用不猜。 安装量仍然没有：那需要一套统计服务，目前没有。
连不上公司技能库怎么办？ 先确认是否连着公司内网或 VPN。应用会把具体错误显示出来，不会静默失败。
需要我懂 Git 之类的东西吗？ 不需要，界面里也不会出现任何相关术语。 背后确实用技能库做存储，但那对你是透明的。
每个版本改了什么、要不要升，都记在 RELEASE_NOTES.md 里。 内网发布页上每个版本的说明也是同一份内容。
最近几版：
| 版本 | 日期 | 说明 |
|---|---|---|
0.5.0 |
— | 技能可以只装进某个项目文件夹：「获取」旁的箭头选「装到项目」，选完文件夹先确认再装；技能详情显示「已装到」哪些位置；「我的技能」新增项目分区；与 npx skills 完全互通。升级后首屏显示本版改了什么，历史版本（带日期）收在设置里 |
0.4.0 |
2026-08-20 | 技能广场：搜遍全网技能一键装；首屏全网热门、滚到底自动加载；读详情与安装大幅提速；macOS 钥匙串询问从三次减到一次 |
0.3.13 |
2026-08-11 | 修复窗口拖不动（0.3.12 那次没修对，真正原因是少授了一项系统权限） |
0.3.12 |
2026-08-11 | Windows 更新不再自己关掉应用；修复程序坞图标点了没反应、托盘左键弹菜单 |
0.3.11 |
2026-08-07 | 修复 Windows 上登录不了（凭证超出 Windows 凭据管理器的大小限制） |
0.3.10 |
2026-08-07 | 首个 Windows 版本 |
0.3.9 |
2026-08-07 | 修复作者栏不显示 |
0.3.8 |
2026-08-07 | 作者与贡献者展示 |
0.3.6 |
2026-08-07 | 新增「每 5 分钟」检查档位（装过之后不能回装更早版本） |
0.3.3 |
2026-08-07 | 更新提示更及时；修复 macOS 重启后窗口沉底 |
0.3.0 |
2026-08-06 | 多来源、新建技能、静默自更新 |
0.2.1 |
2026-08-05 | 修复 0.1.0/0.2.0 收不到自动更新 |
完整列表见 RELEASE_NOTES.md。
当前是 0.5.0 内部版本，以下几点还没做完，如实列在这里：
- Windows 上的
0.3.10登录不了，请装0.3.11或更新的版本。0.3.10把登录凭证 一次性写进 Windows 凭据管理器，而它对单条凭证有大小限制，公司 Gitea 的登录令牌 正好超出——表现是在浏览器里点完授权、回到应用「没有反应」。0.3.11起改成分片 保存，已修复。macOS 不受影响。 - Windows 版还没在真机上完整验证过。 安装包与签名、更新公告牌已经验证； 但登录修复、托盘行为、Claude Code 能不能读到技能、自动更新能不能装上， 都还没有在真实的 Windows 机器上逐条走过。遇到问题请直接反馈。
- Windows 安装包没有代码签名，首次运行会被 SmartScreen 提示「未知发布者」， 点「更多信息」→「仍要运行」。正在推进内部证书签名。
- Windows 的自动更新一次都还没真正跑过：
0.3.10才是第一个 Windows 包， 在它之前没有旧版本可升。要等再发一个版本，才会第一次走完「检查到新版 → 准备好 → 提示重启 → 装上」的完整流程。 0.1.0与0.2.0收不到自动更新（那两版有个更新源缺陷，0.2.0已下架）。 装的是这两版的话，手动装一次新 dmg 即可，之后就会自动收到更新。0.2.1起自动更新正常。- 装过
0.3.6之后不能回装更早的版本：0.3.6把本地配置升到了新格式（为了支持 「每 5 分钟」这一档），老版本读到新格式会进只读模式并提示升级——这是有意的保护， 避免老版本用旧结构覆盖新结构。再装回新版即恢复。 0.3.2之前的版本更新提示不及时：0.3.0/0.3.1的检查跟着技能更新频率走， 技能设成「手动」时就只在启动时查一次；0.3.2之前点重启后窗口还会沉到后面， 要点一下程序坞图标才出来。0.3.3起两者都已修好。- 技能库里没有的技能，「纳入管理」不提供。这类技能（比如从 GitHub 装的） 应用给不出更新去处，所以只提供「分享到技能库」这条路。
- 技能广场的三条限制（
0.4.0起适用）：- 需要能访问外网 skills.sh 与 github.com。公司内网若不允许访问外网， 或没连 VPN，这一档会提示连不上——不影响公司技能库，商店的其他部分照常用；
- 搜索结果卡片没有描述，因为数据源本身就没有这个字段； 点开详情，或者装上之后，才看得到完整的说明文档；
- 搜出来的条目里，只有形如
拥有者/技能库名的才会显示。数据源里混着少量 以网站域名（而不是技能库坐标）登记的条目，它们点开也装不了，所以直接不摆出来。 偶尔会出现「搜某个词一条结果都没有」，就是这个原因。
- 装到项目的三条限制（
0.5.0起适用）：- 自动更新只管装在这台电脑上的技能，不管装在项目里的。项目里的技能要更新， 去「我的技能」的「装在项目里的」分区点「更新」。这是第一版有意收窄的范围；
- 项目里改过的技能不能分享回技能库。要分享，先在这台电脑上装一份再改；
- 来源找不回去的技能不给「更新」按钮。比如别人手放进项目、或用其他方式装的， 应用不知道该去哪儿取新版本，所以不摆这个按钮——而不是摆一个点了必然失败的。
技术栈：Tauri 2 + Rust / React 19 + TypeScript + Tailwind v4。 架构铁律、开发纪律、已知约束见 CLAUDE.md； 用户文案术语规范见 docs/terminology.md。
pnpm install
# 本地联调内建技能库时,先在 shell 导出编译期常量(不要写入任何仓库文件):
# export SKILLSYNC_BUILTIN_GITEA_URL=... # 内网 Gitea 地址
# export SKILLSYNC_OAUTH_CLIENT_ID=... # OAuth2 公共客户端 ID(PKCE,无 secret)
pnpm dev # 启动桌面应用(tauri dev)提交前跑完这四道闸（缺一不可，build:web 最容易漏——vitest 不做类型检查）：
pnpm test # 前端单测
pnpm lint # eslint
pnpm build:web # tsc + vite build
cd src-tauri && cargo test --workspace && cargo clippy --all-targets -- -D warnings动过 tauri::Builder 的插件/setup/窗口配置后，还要跑一次 pnpm dev 启动冒烟
——两套测试都不启动 Tauri runtime，插件初始化失败会让应用起不来而测试全绿。
发布构建走 ./scripts/build-release.sh，它会强校验编译期内网配置与更新通道配置，
缺任一变量即拒绝出包——那种包要到用户手里才会发现连不上、或收不到更新。