Skill Deck v1.3.0

Changed

• Manage Agents 弹窗重设计 — 新增 Agent 的安装方式选项改为 card-style radio（整行点击、选中态高亮），字号体系统一 AgentSelector（13px/11px），通过顶部分隔线与 Agent 列表区分层级；始终渲染且无新增 Agent 时置灰，消除选中/取消 Agent 时弹窗的高度抖动
• AgentSelector 中文文案本地化优化 — 调整若干中文术语使其更贴合用户心智：通用目录区标题「基准目录」→「通用目录」、Badge「默认支持的 Agent」→「自动支持」、独立目录区标题「独立目录的 Agent」→「独立目录」；在独立目录标题旁以小字统一解释"已检测"含义，避免多处 Tooltip 堆积
• 「已检测」Badge 语义明确化 — 独立目录 Agent 的检测标识由「已安装」/"Installed" 改为「已检测」/"Detected"，避免与"skill 已安装到该 Agent"产生歧义（检测仅根据 Agent skills 目录是否存在反推）
• GeneralTab 空状态判定修正 — 默认 Agent 设置的空状态判定由 hasNonUniversalAgents 改为 hasAgents，只检测到 Universal Agent 时不再误显示空状态

Fixed

• AgentSelector 路径标签渲染 — scope 为 undefined 时不再显示默认路径字符串，避免非 global/project 场景下渲染错位路径

Removed

• 清理 5 个不再使用的 i18n key：addSkill.agents.detectedSection / otherSection / otherAgentsTitle / expand / collapse

Skill Deck v1.2.0

Added

• GitNexus 项目指引 — 新增 AGENTS.md，并在 CLAUDE.md 中加入 GitNexus 代码智能工具的使用规范、风险检查流程和索引刷新说明；.gitignore 忽略 .gitnexus 本地索引目录
• Manage Agents 安装模式选择 — 管理已安装 Skill 的 Agent 支持时，可为新增 Agent 选择 Symlink 或 Copy 模式，并在前端弹窗中明确展示两种投放方式

Fixed

• Copy 模式保留 canonical 目录 — copy 安装不再跳过 .agents/skills/<skill>，而是先写入 canonical，再复制到目标 Agent 目录，避免后续管理 Agent 时找不到源目录
• Manage Agents 不再静默降级 — 通过 Manage Agents 添加 Agent 时，用户选择 symlink 后若链接创建失败会返回明确错误，不再自动 fallback 成 copy
• 更新流程保留 per-agent 模式 — 单个更新和批量更新改为按 Agent 独立检测并应用原有模式，避免用第一个 Agent 的模式覆盖所有 Agent

Skill Deck v1.1.0

Added

• Agent 管理 — 为已安装的 Skill 添加或移除 Agent 支持，无需重新安装；SkillCard 和详情面板均提供入口
• 跨项目复制 Skill — 一键将项目级 Skill 复制到其他项目，自动标注目标项目中已存在的 Skill 并提示覆盖
• 单实例运行 — 集成 tauri-plugin-single-instance，防止同时打开多个应用进程；重复启动时自动聚焦已有窗口
• Discover 双栏详情面板 — Discover 页支持在可调节双栏布局中浏览榜单与搜索结果，右侧详情展示 overview、SKILL.md 正文、安全审计、Agent 安装量与 CLI 安装命令；侧栏展示本机安装位置（Global 及各项目），安装按钮始终可用，支持将 Skill 安装到不同位置

Changed

• Discover 对齐 skills.sh 语义 — 榜单切换调整为 All Time / Trending / Hot，搜索结果保留 live API 顺序，official creators 改为内部 metadata 判断，详情解析按页面分区提取真实内容
• 前端状态管理重构 — Skills 状态管理按职责拆分为数据层、详情面板、对话框三个独立模块，降低模块间耦合；Skill 更新完成后列表刷新不再阻塞 UI 交互
• 设置页重构 — General、Projects、About 三个标签页拆分为独立组件，提升页面加载效率和可维护性

Fixed

• Discover 搜索结果截断 — skills.sh search 请求上限从 50 提升到 100，减少热门关键词搜索时结果过早截断
• About 页技术栈版本标注 — React 版本从 18 修正为 19

Skill Deck v1.0.0

Added

• Skill 内容详情面板 — Skills 页面支持在可调节宽度的双栏布局中查看已安装 skill 的 SKILL.md 正文；自动剥离 frontmatter 并以 Markdown/GFM 渲染，同时展示来源、安装时间、更新时间、适用 Agents 和安装路径，支持复制路径、重试加载、面板内直接更新/删除

Changed

• 整体视觉重设计 — 引入 Manrope / Inter 字体，更新为 emerald 主色与分层中性色面板体系，统一更利落的圆角、边框、滚动条和文档排版风格
• 导航与品牌焕新 — Header 改为胶囊式导航，刷新应用 Logo，并同步更新 Tauri 桌面端图标资源
• Skills 工作台重构 — 选中 skill 后切换为“紧凑列表 + 沉浸式详情面板”的工作台布局；SkillCard、Compact List、Empty States 和详情阅读区整体重做
• Context Sidebar 重做 — 左侧上下文切换区调整为 Workspace / Global / Projects 分区，强化选中态、项目路径信息和底部 Add Project 入口
• Discover / Wizard / Settings 统一改版 — 搜索安装流程、Discover 页面和 Settings 三个标签页统一为新的卡片化界面；About 区新增品牌展示、外链入口和更新操作聚合区

Fixed

• Sidebar 设计稿对齐问题 — 修复 Add Project 按钮、Workspace 标题、GLOBAL 分区标题和项目列表细节与设计稿不一致的问题
• 详情面板阅读干扰 — 移除详情区 sticky header，并将更新/删除等操作收纳到 Hero 区域，减少滚动阅读时的视觉干扰
• 紧凑列表细节打磨 — 调整列表计数、间距和选中态表现，改善双栏模式下的浏览与定位体验

Skill Deck v0.11.0

Changed

• 对齐 vercel-skills CLI v1.4.7 — 完成与上游 23 个 commit（7022ad3..HEAD）的兼容性适配
• Well-Known 路径迁移 — 优先探测 .well-known/agent-skills，fallback 到旧的 .well-known/skills；build_index_urls() 为每个 well-known 路径生成候选 URL
• Discovery 搜索路径清理 — 移除已废弃的 .agent/skills（单数）搜索路径，仅保留 .agents/skills

Added

• Branch ref #fragment 语法 — source 输入支持 owner/repo#branch、owner/repo#branch@skill-name 格式；source parser 新增 parse_fragment_ref() + looks_like_git_source() 判定逻辑；含 / 的分支名、tag、github:/gitlab: 前缀递归附加等场景全覆盖（10 个新测试）
• Lock 文件 ref 字段 — SkillLockEntry 和 LocalSkillLockEntry 新增 ref_name: Option<String>（serde rename ref），install/update 命令全链路传递；更新检测按 (source, ref) 分组，同仓库不同分支互不干扰
• 新增 Agent：Bob (IBM) 和 Firebender — agent 总数 43 → 45；Bob 使用 .bob/skills 目录，Firebender 使用 .agents/skills + ~/.firebender/skills
• 前端 ref badge — SourceStep 输入框下方展示 branch/skill-filter Badge；SkillCard 已安装 skill 卡片在 source 信息行展示分支标签；新增 en/zh-CN 双语 i18n key

Fixed

• macOS 外部链接无法打开 — 更新弹窗中「前往下载」按钮使用 window.open() 在 Tauri webview 中无效，改用 tauri-plugin-opener 的 openUrl() 通过系统浏览器打开；同时 opener 插件自动拦截页面中所有 <a target="_blank"> 链接，修复 SettingsPage、SkillCard、SkillDetailDialog 等处的外部链接
• Discover 模块 TypeScript 严格模式错误 — 修复 parseLeaderboardHtml 返回值含 null 的类型不匹配、DiscoverSkillSummary 上不存在的 repoUrl 引用、relevanceScore 可能 undefined 的排序比较
• SkillCard ref badge 尾部分隔符 — 当 gitRef 存在但 updatedAt 为空时不再渲染多余的 · 分隔符
• Discover 模块 regex 性能 — parseLeaderboardHtml 循环内的 3 个 regex literal 提升为模块级常量（js-hoist-regexp）

Skill Deck v0.10.0

Changed

• 批量更新检测优化 — check_updates 使用 fetch_skill_folder_hashes_batch 批量查询同源 skills 的 hash，同源 N 个 skills 从 N 次 GitHub Trees API 降为 1 次
• Update All 并行分组 — updateAllInSection 按 source 分组后调用 updateSkillsBatch 批量 API，不同源组并行执行（Promise.all），同组共享单次 clone
• SkillCard 进度条性能优化 — 更新进度 phase 改用 useRef + DOM 操作替代 useState，避免 Tauri 事件驱动的高频 re-render；条件渲染统一为三元表达式
• 刷新按钮交互优化 — Refresh 按钮增加最小 300ms spin 保持时间 + ✓ 完成态闪现（800ms），解决操作过快时用户无法感知点击生效的问题；Check 按钮检测完成后短暂显示 ✓ 图标（有更新时跳过，已有 "X updates" 信号）

Added

• update_skills_batch 命令 — 新增批量更新后端命令，按 source 分组后每组只 clone 一次仓库，从同一 clone 中安装所有同源 skills
• fetch_skill_folder_hashes_batch API — 批量获取同源多个 skill 文件夹的 hash，单次 GitHub Trees API 请求即可比对所有 skills
• SkillCard 更新状态 Badge — 新增 done/failed 独立 Badge 标识（updateDone/updateFailed i18n key），替代底部色条的单一信号

Fixed

• 更新缓存标记残留 — 更新成功后清除 updateInfoCache 中对应 skill 的 hasUpdate 标记，防止 syncSkills 恢复旧标记导致更新按钮重新出现

Skill Deck v0.9.0

Changed

• 对齐 skills CLI v1.4.4 — 完成与 vercel-labs/skills CLI v1.4.2 → v1.4.4 的全量同步
• 移除 SourceType::DirectUrl — direct-url 类型统一为 well-known；自定义 serde Deserialize 实现确保旧 lock 文件中 "direct-url" 值可正确反序列化为 WellKnown
• 更新检测范围扩展 — check_updates 不再限制 sourceType == "github"，改为检查 skillFolderHash 和 skillPath 字段是否存在，支持更多来源类型的更新检测

Added

• Well-Known Skills 支持 — 实现 RFC 8615 /.well-known/skills/ 协议，支持从任意 HTTP 站点发现和安装 skills（如 https://mintlify.com/docs）；新增 core/wellknown.rs 模块处理 index.json 获取、文件下载和临时目录管理；fetch_available 和 install_skills 命令完整接入 WellKnown 来源；lock 文件使用 hostname 作为 source identifier（对齐 CLI WellKnownProvider）
• github:/gitlab: 前缀简写 — source 输入支持 github:owner/repo 和 gitlab:owner/repo 前缀格式，分别复用 GitHub shorthand 和 GitLab URL 解析逻辑（对齐 CLI v1.4.4）
• SSH URL owner/repo 提取 — get_owner_repo() 新增对 git@host:owner/repo.git 格式的解析，支持 GitHub、GitLab、自定义 host 和多级 subgroup 路径
• Subpath 路径遍历防护 — 双层防护：解析层 sanitize_subpath() 拒绝含 .. 段的 subpath，执行层 is_subpath_safe() 验证 resolved path 不逃逸 base 目录
• 27 个新增 Rust 测试 — 覆盖 serde 兼容层（3）、前缀简写（5）、SSH URL 解析（6）、路径遍历防护（11）、更新检测（1）、现有测试修改（1）

Skill Deck v0.8.0

Changed

• 更新交互重构 — 用独立 Dialog 替代 Toast 通知：发现新版本时弹出 Dialog 展示 Release Notes（Markdown 渲染），用户确认后再下载；下载中展示进度条且不可关闭；下载完成后提供「立即重启/稍后」选项；macOS 跳转 GitHub 下载
• Updater Store 重写 — 新增并发保护（仅 idle/error 可触发检查）、下载中止（dismiss 设置 abortFlag）、错误退避（失败后 4h 重试 vs 正常 24h 间隔）、Release Notes 和 lastCheckTime 字段
• Settings 更新状态完善 — 覆盖全部 7 种状态（idle/checking/available/downloading/ready/error/idle+lastCheckTime），idle 状态展示相对时间「上次检查：5 分钟前」
• 移除自动下载行为，改为用户在 Dialog 中确认后再开始下载
• update_skill 结构化响应 — update_skill 命令返回 UpdateSkillResponse（含 per-skill 状态 success/partial/failed/skipped、per-agent 结果、warnings、耗时），前端根据状态展示差异化 toast（成功/部分成功/跳过/失败 + 告警）
• Lock 文件原子写入 — skill_lock 和 local_lock 的写入改用 tempfile::persist 原子操作，避免写入中断导致文件损坏；统一追加尾部换行符
• Uninstaller 简化 — 提取 resolve_agents_to_remove 辅助函数，移除冗余的 detect_installed 中间回退逻辑
• CompleteStep 重构 — 统一为 skill 分组卡片展示，显示 agent 覆盖率统计（如 2/3 agents），失败明细可折叠展开
• 安装重试行为分离 — 提取 InstallBehavior 结构体，重试模式下跳过 Universal Agent 自动填充和 agent 持久化
• Install/Update 共享核心 — 提取 install_skill_to_agents() 共享函数，install 和 update 命令复用同一安装逻辑；PerAgentInstallResult 携带完整 path/canonical_path/mode 数据
• Update 文件系统检测 — 更新命令通过 detect_installed_agents_for_skill() 扫描文件系统确定目标 agents（非 lock 元数据），通过 detect_install_mode() 检测 symlink/junction vs copy 模式
• Skills Store 状态重设计 — updatingSkill: string | null 升级为 updatingSkills: Map<string, status> 支持批量并行状态追踪；新增 checkingUpdateScopes: Set<string> 实现 per-scope 独立检测状态
• 更新检测缓存 — 新增 scope 级 TTL 缓存（5 分钟），切换 scope 时避免重复网络请求；stale context guard 防止异步写入过期数据
• SkillsPanel selector 优化 — checkingUpdateScopes 从整个 Set 订阅改为派生 boolean selector（rerender-derived-state 规则），减少无关重渲染

Added

• UpdateDialog 组件 — 三态更新弹窗（available/downloading/ready），react-markdown 懒加载渲染 Release Notes，下载中禁止关闭
• formatRelativeTime 工具函数 — 将时间戳转换为 i18n 相对时间 key（刚刚/N 分钟前/N 小时前/昨天/N 天前），含 5 个单元测试
• Updater Store 测试 — 16 个单元测试覆盖并发保护、状态转换、错误退避、dismiss 重置
• 逐 Skill 重试 — CompleteStep 新增「重试该 Skill」按钮，仅对失败的 skill + 失败的 agents 重新安装（通过 retrySkillName/retryAgents 状态传递）；后端 InstallParams 新增 retry 标志
• UpdateSkillResponse 类型体系 — 新增 models/update.rs：UpdateSkillResponse、UpdateSkillItemResult、UpdateSkillAgentResult、UpdateSkillSummary、UpdateSkillStatus、UpdateSkillAgentStatus
• 11 个新增测试 — 6 个 Rust 测试（derive_skill_status 边界、summarize_results、InstallBehavior、serde 序列化）+ 2 个 CompleteStep 组件测试 + 2 个 useTauriApi 测试 + 1 个 skills store 测试
• Section 级 Update All — SkillsSection 标题栏新增「全部更新」按钮，支持批量串行更新（queued → updating → done/failed），进度计数器和取消按钮
• SkillCard 内联进度条 — 更新时展示 phase-based 进度条（cloning 35% → installing 70% → writing_lock 90%），监听 update-progress Tauri 事件
• 手动检查更新 — 每个 Section 新增 Check 按钮，调用 forceCheckUpdates() 强制刷新指定 scope 的更新检测（绕过 TTL 缓存）
• Update 进度事件 — 后端 update_skill 在 clone/install/lock-write 阶段发送 update-progress 事件，前端 SkillCard 响应并展示阶段标签

Removed

• 移除 update-toast.tsx（Toast 更新通知），由 UpdateDialog 替代

Skill Deck v0.7.0

Added

• 智能删除对话框 — 删除 skill 时展示 agent 安装详情，支持选择仅从部分 Agent 中移除 skill（保留源文件），或完全删除
• get_skill_agent_details 命令 — 新增后端命令，查询 skill 的 universal / independent agent 分组安装详情，为智能删除对话框提供数据
• SkillAgentDetails / IndependentAgentInfo 类型 — 新增数据模型，描述 skill 在各 agent 中的安装状态（路径、是否 symlink）
• Plugin 分组支持 — 解析 .claude-plugin/marketplace.json 和 .claude-plugin/plugin.json，自动识别 skill 所属 plugin 并在 UI 中分组展示（对齐 skills CLI v1.4.2）
• plugin_manifest 模块 — 新增 src-tauri/src/core/plugin_manifest.rs，支持多 plugin manifest 解析、路径安全校验（防目录穿越）和路径归一化
• pluginName 字段贯穿数据链路 — DiscoveredSkill → AvailableSkill → InstalledSkill → SkillLockEntry / LocalSkillLockEntry 全链路传递 pluginName
• 分层 CLAUDE.md — 新增 src/CLAUDE.md（前端 Store 交互模式、组件约定）和 src-tauri/CLAUDE.md（Rust 命令添加流程、模块职责表），根 CLAUDE.md 新增 Business Rules、Change Dependencies、Verification 段落
• Vitest 测试基础设施 — 配置 Vitest + jsdom + @testing-library/react，包含 Tauri invoke mock 和 i18n mock 的全局 test-utils
• 29 个单元测试 — 覆盖 useTauriApi unwrap 逻辑（5）、context store（10）、skills store（6）、settings store（8）
• Pre-commit hooks — husky + lint-staged，提交前自动 eslint --fix
• CI pipeline — GitHub Actions 工作流：lint → test → build → cargo check

Changed

• Header 导航栏优化 — 导航标签改为 pill 圆角胶囊样式，放大 logo 和品牌名，导航图标始终可见（移除 sm:hidden），主题/语言按钮增大触控区域
• ContextSidebar 侧边栏精简 — 移除标题栏、分区标题和底部「在设置中管理」按钮；去掉图标外层包裹容器；选中/悬停状态改为更柔和的 foreground 透明度样式；全局上下文新增副标题说明
• remove_skill 命令增强 — 新增 agents 和 full_removal 参数，支持完全删除和部分移除两种模式；部分移除时仅删除指定 agent 的 symlink，不清理 canonical 目录和 lock file
• DeleteSkillDialog 重构 — 从简单的 AlertDialog 升级为完整的 Dialog，包含 Skill 信息横幅、共享目录区（含级联全选和警告提示）、独立安装区（Checkbox 逐项选择）、加载骨架屏
• Cline Agent 路径迁移 — skill 目录从 .cline/skills 迁移到 .agents/skills（对齐 skills CLI v1.4.2）
• SkillsStep 安装向导 — 当 skill 来源包含 plugin 时，按 plugin 分组展示可选 skill 列表
• ConfirmStep 确认页面 — 选中的 skills 按 plugin 分组展示，未归属 plugin 的归入「通用」分组
• SkillCard 卡片 — 当 skill 属于某个 plugin 时，显示 plugin 名称 Badge

Skill Deck v0.6.0

Changed

• 重构 ConfirmStep 确认页面 — 移除冗余的 Scope 信息卡片和重复的路径前缀、agent badges、mode label，新增集中覆盖警告条与行内 Tooltip 标记，新增安装信息区展示安装方式和安装目录列表
• 优化安装进度展示 — 安装过程新增细粒度进度状态反馈，提升安装体验
• 搜索安装 skill 时窗口自适应高度
• 移除安装步骤中内容区域多余的 padding top
• 优化 ConfirmStep 布局层级和交互体验
• ESLint 校验范围限定为 src 目录

Fixed

• 修复 CompleteStep 中 useMemo 在 early return 之后调用导致违反 Rules of Hooks 的问题
• 修复 OptionsStep 中渲染期间直接写入 ref.current 的问题，改为通过 useEffect 同步
• 修复 InstallingStep 中 useEffect 缺失 t 和 state.availableSkills 依赖的问题，通过 ref 捕获
• ESLint 配置新增 argsIgnorePattern: '^_'，支持下划线前缀的未使用参数惯例