itismyskillmarket 1.3.1 → 1.3.3

package/CHANGELOG.md

@@ -1,3 +1,297 @@
+# SkillMarket v1.3.3 更新日志
+
+**日期**: 2026-04-30
+**版本**: 1.3.3
+
+---
+
+## 🚀 新功能：GitHub 第三方库支持 (Beta)
+
+### 1. 支持 GitHub URL 和简写格式
+
+现在可以直接从 GitHub 仓库安装 skills：
+
+```bash
+# GitHub URL 格式
+skm install https://github.com/owner/repo
+skm install https://github.com/owner/repo/tree/main/skills/my-skill
+
+# 简写格式
+skm install owner/repo
+skm install owner/repo#branch
+skm install owner/repo@commit-hash
+```
+
+### 2. 自动检测 Skill 本体
+
+安装时会自动检测仓库中的 skill 文件：
+
+- ✅ `SKILL.md` - skill 定义文件（必须）
+- ✅ `package.json` - 包配置文件（可选）
+- ✅ `metadata.json` - 元数据文件（可选）
+- ✅ 平台目录（`opencode/`, `cursor/`, `vscode/`, `claude/` 等）
+
+**检测输出示例**：
+```
+Detecting skill...
+  SKILL.md: ✅
+  package.json: ✅
+  Detected platforms: opencode, vscode
+```
+
+### 3. 平台判断和格式转换
+
+- 自动判断 skill 支持的平台
+- 如果某些平台文件缺失，会自动生成适配文件
+- 支持的平台：OpenCode, Cursor, VSCode, Claude Code, Codex, Antigravity
+
+```bash
+# 安装到指定平台（自动生成缺失的平台文件）
+skm install owner/repo --platform opencode,claude
+
+# 指定分支
+skm install owner/repo#dev --platform vscode
+```
+
+### 4. 版本控制
+
+支持指定分支、tag 或 commit：
+
+```bash
+# 指定分支
+skm install owner/repo#main
+skm install owner/repo -b develop
+
+# 指定 commit
+skm install owner/repo@abc1234
+
+# 指定 tag（通过分支名）
+skm install owner/repo#v1.0.0
+```
+
+### 5. 技术实现
+
+**新增模块**：`src/commands/github-install.ts`
+
+| 函数名 | 功能 |
+|--------|------|
+| `parseGitHubUrl()` | 解析 GitHub URL 和简写格式 |
+| `detectSkillFromGitHub()` | 从 GitHub API 检测 skill |
+| `installFromGitHub()` | 从 GitHub 安装 skill |
+| `generatePlatformAdapters()` | 为缺失平台生成适配文件 |
+
+**支持的 URL 格式**：
+| 格式 | 示例 |
+|------|------|
+| 完整 URL | `https://github.com/owner/repo` |
+| 完整 URL + 路径 | `https://github.com/owner/repo/tree/main/path` |
+| 简写 | `owner/repo` |
+| 简写 + 分支 | `owner/repo#branch` |
+| 简写 + commit | `owner/repo@commit` |
+
+---
+
+## 🔧 技术实现
+
+### GitHub 安装新增函数
+
+| 函数名 | 功能 |
+|--------|------|
+| `parseGitHubUrl()` | 解析 GitHub URL |
+| `detectSkillFromGitHub()` | 检测 skill 本体 |
+| `installFromGitHub()` | 主安装函数 |
+| `generatePlatformAdapters()` | 格式转换 |
+
+### 更新接口
+
+**GitHubInstallOptions** 接口：
+```typescript
+export interface GitHubInstallOptions {
+  platforms?: string[];  // 目标平台
+  force?: boolean;       // 强制覆盖
+  branch?: string;       // 指定分支
+  commit?: string;       // 指定 commit
+}
+```
+
+### CLI 参数更新
+
+| 命令 | 参数 | 说明 |
+|------|------|------|
+| `skm install` | `-b, --branch` | GitHub 分支 |
+| `skm install` | `-c, --commit` | GitHub commit hash |
+
+---
+
+## 📦 完整版本历史
+
+| 版本 | 日期 | 描述 |
+|------|------|------|
+| 1.3.3 | 2026-04-30 | GitHub 第三方库支持 |
+| 1.3.2 | 2026-04-30 | 增强卸载命令：--all, --dry-run, --yes |
+| 1.3.1 | 2026-04-29 | Bug 修复，workflow 改进 |
+| 1.3.0 | 2026-04-23 | 独立搜索命令，改进分页逻辑 |
+| 1.2.6 | 2026-04-22 | 添加搜索功能（--search） |
+| 1.2.5 | 2026-04-16 | 文档更新 |
+| 1.2.4 | 2026-04-16 | 修复版本号硬编码问题 |
+| 1.2.3 | 2026-04-15 | 跨平台 Skill 安装支持 |
+
+---
+
+## 贡献者
+
+- wxc2004 (wanxuchen)
+- Sisyphus Agent
+
+---
+
+# SkillMarket v1.3.2 更新日志
+
+**日期**: 2026-04-30
+**版本**: 1.3.2
+
+---
+
+## 🎉 新功能：增强卸载命令
+
+### 1. 卸载所有 Skills (`--all`)
+
+现在可以一键卸载所有已安装的 skills：
+
+```bash
+# 卸载所有 skills（需要确认）
+skm uninstall --all
+
+# 强制卸载所有，跳过确认
+skm uninstall --all --yes
+```
+
+**确认提示示例**：
+```
+Found 5 installed skill(s):
+  - brainstorming@1.2.0
+  - test-skill-1@1.1.0
+  - test-skill-2@1.0.0
+  - weather-time@1.0.0
+  - chinese-almanac@1.0.0
+
+⚠️  Are you sure you want to uninstall ALL 5 skill(s)? This action cannot be undone. (y/N): _
+```
+
+### 2. 预览模式 (`--dry-run`)
+
+新增 `--dry-run` 标志，可以预览将要删除的内容，而不实际执行删除：
+
+```bash
+# 预览卸载单个 skill
+skm uninstall brainstorming --dry-run
+
+# 预览卸载所有 skills
+skm uninstall --all --dry-run
+```
+
+**预览输出示例**：
+```
+📋 Uninstall Preview for "brainstorming":
+
+   Version: 1.2.0
+   Installed: 2026-04-15T10:30:00Z
+   Platforms (from registry): OpenCode, Claude Code, VSCode
+
+   Local files to remove:
+   - ~/.skillmarket/skills/brainstorming
+
+   Platform links to remove:
+   - ~/.skillmarket/platform-links/opencode/skills/brainstorming
+   - ~/.skillmarket/platform-links/claude/skills/brainstorming
+   - ~/.skillmarket/platform-links/vscode/skills/brainstorming
+
+⚠️  This was a dry-run. No files were actually deleted.
+```
+
+### 3. 跳过确认 (`-y, --yes`)
+
+新增 `-y` 或 `--yes` 选项，跳过所有确认提示：
+
+```bash
+# 强制卸载，不提示确认
+skm uninstall brainstorming --yes
+
+# 强制卸载所有，不提示确认
+skm uninstall --all --yes
+```
+
+### 4. 改进错误处理
+
+- 当平台卸载失败时，会询问用户是否继续清理本地文件
+- 避免误删本地文件导致无法恢复
+
+**错误处理示例**：
+```
+Uninstalling from 3 platform(s)...
+
+OpenCode     ✅  Uninstalled
+Claude Code  ❌  Failed: EPERM: operation not permitted
+VSCode       ✅  Uninstalled
+
+⚠️  1 platform(s) failed to uninstall. Continue with local cleanup? (y/N): _
+```
+
+---
+
+## 🔧 技术实现
+
+### 新增函数
+
+| 函数名 | 功能 |
+|--------|------|
+| `uninstallAll()` | 卸载所有已安装的 skills |
+| `askConfirmation()` | 请求用户确认（内部工具函数） |
+| `getUninstallPreview()` | 收集卸载预览信息（内部工具函数） |
+
+### 更新接口
+
+**UninstallOptions** 新增字段：
+```typescript
+export interface UninstallOptions {
+  platforms?: string[];  // 目标平台列表
+  all?: boolean;          // 卸载所有 skills
+  dryRun?: boolean;       // 预览模式
+  yes?: boolean;          // 跳过确认
+}
+```
+
+### CLI 参数更新
+
+| 参数 | 说明 |
+|------|------|
+| `-a, --all` | 卸载所有已安装的 skills |
+| `-d, --dry-run` | 预览模式，不实际删除 |
+| `-y, --yes` | 跳过确认提示 |
+
+---
+
+## 📦 完整版本历史
+
+| 版本 | 日期 | 描述 |
+|------|------|------|
+| 1.3.2 | 2026-04-30 | 增强卸载命令：--all, --dry-run, --yes |
+| 1.3.1 | 2026-04-29 | Bug 修复，workflow 改进 |
+| 1.3.0 | 2026-04-23 | 独立搜索命令，改进分页逻辑 |
+| 1.2.6 | 2026-04-22 | 添加搜索功能（--search） |
+| 1.2.5 | 2026-04-16 | 文档更新 |
+| 1.2.4 | 2026-04-16 | 修复版本号硬编码问题 |
+| 1.2.3 | 2026-04-15 | 跨平台 Skill 安装支持 |
+
+---
+
+## 贡献者
+
+- wxc2004 (wanxuchen)
+- Sisyphus Agent
+
+---
+
 # SkillMarket v1.2.6 更新日志
 
 **日期**: 2026-04-22