itismyskillmarket 1.2.6 → 1.2.7

package/CHANGELOG.md

@@ -1,3 +1,115 @@
+# SkillMarket v1.2.6 更新日志
+
+**日期**: 2026-04-22
+**版本**: 1.2.6
+
+---
+
+## 🔍 新功能：skm ls 搜索支持
+
+### 功能说明
+
+新增搜索功能，可以通过关键字搜索 skills。
+
+### 新增选项
+
+```bash
+# 搜索 npm 上的 skills
+skm ls --search brain
+skm ls -s brain
+
+# 搜索已安装的 skills
+skm ls --installed --search test
+
+# 组合分页和搜索
+skm ls --search brain --page 1 --limit 10
+```
+
+### 搜索字段
+
+- skill ID
+- displayName（显示名称）
+- description（描述）
+
+---
+
+## 🎉 新功能：skm ls 分页支持
+
+### 功能说明
+
+当 skill 数量较多时，现在支持分页浏览。
+
+### 新增选项
+
+```bash
+# 默认每页 20 个
+skm ls
+
+# 指定页码
+skm ls --page 2
+
+# 指定每页数量
+skm ls --limit 10
+
+# 组合使用
+skm ls --page 2 --limit 10
+
+# 已安装的 skills 也支持分页
+skm ls --installed --page 2
+```
+
+### 输出示例
+
+```
+Found 85 skill(s):
+
+📦 @skillmarket/brainstorming@1.2.0
+   名称: Brainstorming
+   描述: Feature brainstorming skill
+   平台: opencode, cursor, vscode, claude
+   链接: https://www.npmjs.com/package/@skillmarket/brainstorming
+
+Page 1/5 (20 per page) | Use --page N to navigate
+```
+
+### 实现细节
+
+- npm search API 使用 `from` 和 `size` 参数实现服务端分页
+- 本地已安装 skills 使用数组 slice 实现客户端分页
+- 默认每页 20 个，可自定义
+
+---
+
+## 🔧 改进
+
+1. **文档更新**
+   - 更新 README.md 添加分页使用示例
+   - 更新 SKILLMARKET-GUIDE.md 修复安装命令
+   - 更新 skills/README.md 添加 test-skill-1/2
+
+2. **版本管理优化**
+   - 版本号现在从 `package.json` 动态读取
+   - 不再需要手动同步版本号
+
+---
+
+## 📦 完整版本历史
+
+| 版本 | 日期 | 描述 |
+|------|------|------|
+| 1.2.6 | 2026-04-16 | 修复版本号动态读取 |
+| 1.2.5 | 2026-04-16 | 文档更新 |
+| 1.2.4 | 2026-04-16 | 修复版本号硬编码问题 |
+| 1.2.3 | 2026-04-15 | 跨平台 Skill 安装支持 |
+
+---
+
+## 贡献者
+
+- wxc2004 (wanxuchen)
+
+---
+
 # SkillMarket v1.2.3 发布总结
 
 **日期**: 2026-04-15

package/dist/index.js

@@ -174,12 +174,16 @@ async function fetchSkillPackage(skillId) {
   return null;
 }
 async function searchSkillmarketPackages(options = {}) {
-  const { from = 0, size = 100 } = options;
+  const { from = 0, size = 100, keyword } = options;
   const packages = [];
   let total = 0;
   return new Promise((resolve2, reject) => {
     const url = new URL("https://registry.npmjs.org/-/v1/search");
-    url.searchParams.set("text", "keywords:skillmarket");
+    if (keyword) {
+      url.searchParams.set("text", `${keyword} keywords:skillmarket`);
+    } else {
+      url.searchParams.set("text", "keywords:skillmarket");
+    }
     url.searchParams.set("size", String(size));
     url.searchParams.set("from", String(from));
     const req = https.get(url.toString(), { timeout: 1e4 }, (res) => {
@@ -213,22 +217,40 @@ async function searchSkillmarketPackages(options = {}) {
 }
 
 // src/commands/ls.ts
+function filterInstalledSkills(skills, keyword) {
+  const lower = keyword.toLowerCase();
+  return skills.filter(
+    (s) => s.id.toLowerCase().includes(lower) || s.displayName && s.displayName.toLowerCase().includes(lower) || s.description && s.description.toLowerCase().includes(lower)
+  );
+}
 async function listSkills(options) {
-  const { installed, updates, page = 1, limit = 20 } = options;
+  const { installed, updates, page = 1, limit = 20, search } = options;
   if (installed) {
-    const skills = await getInstalledSkills();
+    let skills = await getInstalledSkills();
+    if (search) {
+      skills = filterInstalledSkills(skills, search);
+    }
     const total = skills.length;
     const totalPages = Math.ceil(total / limit) || 1;
     const currentPage = Math.min(Math.max(1, page), totalPages);
     if (skills.length === 0) {
-      console.log('No skills installed yet. Run "skm ls" to see available skills.');
+      if (search) {
+        console.log(`No skills found matching "${search}".`);
+      } else {
+        console.log('No skills installed yet. Run "skm ls" to see available skills.');
+      }
       return;
     }
+    if (search) {
+      console.log(`Found ${total} match(es) for "${search}":
+`);
+    } else {
+      console.log(`Installed Skills (${total}):
+`);
+    }
     const start = (currentPage - 1) * limit;
     const end = Math.min(start + limit, total);
     const pageSkills = skills.slice(start, end);
-    console.log(`Installed Skills (${total}):
-`);
     for (const skill of pageSkills) {
       console.log(`  ${skill.id}@${skill.version}`);
       console.log(`    Platforms: ${skill.platforms.join(", ")}`);
@@ -238,21 +260,36 @@ async function listSkills(options) {
     console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
     return;
   }
-  console.log("Searching npm registry...\n");
+  if (search) {
+    console.log(`Searching npm for "${search}"...
+`);
+  } else {
+    console.log("Searching npm registry...\n");
+  }
   try {
     const offset = (page - 1) * limit;
     const { packages, total } = await searchSkillmarketPackages({
       from: offset,
-      size: limit
+      size: limit,
+      keyword: search
     });
     const totalPages = Math.ceil(total / limit) || 1;
     const currentPage = Math.min(Math.max(1, page), totalPages);
     if (packages.length === 0) {
-      console.log("No skills found. Check back later!");
+      if (search) {
+        console.log(`No skills found matching "${search}".`);
+      } else {
+        console.log("No skills found. Check back later!");
+      }
       return;
     }
-    console.log(`Found ${total} skill(s):
+    if (search) {
+      console.log(`Found ${total} match(es) for "${search}":
+`);
+    } else {
+      console.log(`Found ${total} skill(s):
 `);
+    }
     for (const pkgName of packages) {
       try {
         const info = await fetchNpmPackage(pkgName);
@@ -774,6 +811,7 @@ Commands:
                           --updates      Check for updates
                           --page <n>     Page number (default: 1)
                           --limit <n>    Items per page (default: 20)
+                          -s, --search   Search by keyword
   info <skill-id>      Display skill information
   install <skill>      Install a skill
                           @version      Install specific version
@@ -803,11 +841,12 @@ Examples:
   }
 });
 var lsCmd = program.command("ls").description("List available skills");
-lsCmd.option("--installed", "Show only installed skills").option("--updates", "Check for updates").option("-p, --page <number>", "Page number (default: 1)", parseInt).option("-l, --limit <number>", "Items per page (default: 20)", parseInt).action((opts) => {
+lsCmd.option("--installed", "Show only installed skills").option("--updates", "Check for updates").option("-p, --page <number>", "Page number (default: 1)", parseInt).option("-l, --limit <number>", "Items per page (default: 20)", parseInt).option("-s, --search <keyword>", "Search by keyword (id, displayName, description)").action((opts) => {
   const options = {
     ...opts,
     page: opts.page ?? 1,
-    limit: opts.limit ?? 20
+    limit: opts.limit ?? 20,
+    search: opts.search
   };
   listSkills(options);
 });

package/docs/plans/2026-04-16-keyword-search-design.md

@@ -0,0 +1,143 @@
+# SkillMarket 关键字搜索功能设计方案
+
+**版本**: 1.0  
+**日期**: 2026-04-16  
+**状态**: 待开发
+
+## 1. 功能概述
+
+为 SkillMarket CLI 添加关键字搜索功能，支持在 npm registry 和本地已安装 skills 中按关键字检索。
+
+## 2. 推荐方案
+
+### 2.1 新增命令
+
+```bash
+# 搜索 npm registry（默认行为，与现有 skm ls 等效但带过滤）
+skm search <keyword>
+
+# 搜索本地已安装的 skills
+skm search <keyword> --installed
+
+# 组合：分页 + 搜索关键字
+skm search <keyword> --page 1 --limit 20
+```
+
+### 2.2 搜索字段
+
+支持匹配以下字段：
+- `id`: skill 包名（精确匹配 + 模糊匹配）
+- `displayName`: 显示名称
+- `description`: 描述
+
+### 2.3 实现方式
+
+复用现有 `skm ls` 命令，添加 `--search` / `-s` 选项：
+
+| 命令 | 说明 |
+|------|------|
+| `skm ls --search <keyword>` | 在 npm registry 中搜索 |
+| `skm ls --search <keyword> --installed` | 在本地已安装 skills 中搜索 |
+| `skm ls -s <keyword>` | 简写形式 |
+
+**推荐**：将搜索功能作为 `skm ls` 的选项，而不是新增独立命令。原因：
+- 代码复用度高
+- 用户学习成本低
+- 与分页功能自然组合
+
+## 3. 技术方案
+
+### 3.1 代码修改
+
+**文件**: `src/commands/ls.ts`
+
+```typescript
+interface LsOptions {
+  // ... 现有字段
+  search?: string;  // 新增：搜索关键字
+}
+```
+
+### 3.2 npm search 实现
+
+修改 `searchSkillmarketPackages` 函数，添加关键字过滤参数：
+
+```typescript
+interface SearchOptions {
+  from: number;
+  size: number;
+  keyword?: string;  // 新增
+}
+```
+
+**注意**：npm search API 本身支持通过 `q` 参数进行关键字搜索，可以直接传入。
+
+### 3.3 本地搜索实现
+
+在已有本地 skills 列表上进行内存过滤：
+
+```typescript
+function filterInstalledSkills(skills: InstalledSkill[], keyword: string): InstalledSkill[] {
+  const lower = keyword.toLowerCase();
+  return skills.filter(s => 
+    s.id.toLowerCase().includes(lower) ||
+    s.displayName?.toLowerCase().includes(lower) ||
+    s.description?.toLowerCase().includes(lower)
+  );
+}
+```
+
+### 3.4 UI 输出
+
+```
+# npm 搜索结果
+$ skm ls -s "brainstorm"
+
+📦 brainstorming@1.0.0 (Found 1 match for "brainstorm")
+   名称: Brainstorming
+   描述: 多智能体头脑风暴能力
+   平台: opencode
+   链接: https://npmjs.com/package/brainstorming
+
+# 本地搜索结果
+$ skm ls --installed -s "test"
+
+🟢 test-skill-1@1.0.0
+   Platforms: opencode
+   Installed: 2026-04-16
+
+🟢 test-skill-2@1.0.0
+   Platforms: opencode
+   Installed: 2026-04-15
+```
+
+## 4. 实施步骤
+
+1. **修改 `ls.ts` 命令模块**
+   - 添加 `search` 选项到 `LsOptions` 接口
+   - 实现关键字过滤逻辑
+   - 支持 npm search API 和本地过滤
+
+2. **修改 `cli.ts`**
+   - 在 `ls` 命令中添加 `--search` / `-s` 选项
+
+3. **测试**
+   - `skm ls -s <keyword>`
+   - `skm ls --installed -s <keyword>`
+   - 边界情况：无结果、分页
+
+## 5. 优先级
+
+**P1 - 高**
+- 核心搜索功能
+- npm registry 搜索
+
+**P2 - 中**
+- 本地已安装 skills 搜索
+- 搜索结果高亮（可选）
+
+## 6. 风险与注意事项
+
+- npm search API 有速率限制，生产环境考虑缓存
+- 中文关键字搜索需要确认 npm API 支持
+- 大结果集需要分页处理

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itismyskillmarket",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
   "bin": {

package/src/cli.ts

@@ -99,6 +99,7 @@ Commands:
                           --updates      Check for updates
                           --page <n>     Page number (default: 1)
                           --limit <n>    Items per page (default: 20)
+                          -s, --search   Search by keyword
   info <skill-id>      Display skill information
   install <skill>      Install a skill
                           @version      Install specific version
@@ -148,12 +149,14 @@ lsCmd
   .option('--updates', 'Check for updates')
   .option('-p, --page <number>', 'Page number (default: 1)', parseInt)
   .option('-l, --limit <number>', 'Items per page (default: 20)', parseInt)
+  .option('-s, --search <keyword>', 'Search by keyword (id, displayName, description)')
   .action((opts) => {
     // Ensure numeric options have default values if not provided
     const options = {
       ...opts,
       page: opts.page ?? 1,
-      limit: opts.limit ?? 20
+      limit: opts.limit ?? 20,
+      search: opts.search
     };
     listSkills(options);
   });

package/src/commands/ls.ts

@@ -43,6 +43,9 @@ interface LsOptions {
   
   /** 每页数量 */
   limit?: number;
+  
+  /** 搜索关键字（支持 id, displayName, description） */
+  search?: string;
 }
 
 // -----------------------------------------------------------------------------
@@ -65,32 +68,72 @@ interface LsOptions {
  * // 列出已安装的 skills
  * await listSkills({ installed: true });
  */
+// -----------------------------------------------------------------------------
+// 搜索过滤函数
+// -----------------------------------------------------------------------------
+
+/**
+ * 过滤已安装的 skills（按关键字）
+ * 
+ * 匹配 id, displayName, description 字段
+ * 
+ * @param skills - 已安装的 skills 列表
+ * @param keyword - 搜索关键字
+ * @returns 过滤后的 skills 列表
+ */
+function filterInstalledSkills(skills: any[], keyword: string): any[] {
+  const lower = keyword.toLowerCase();
+  return skills.filter(s => 
+    s.id.toLowerCase().includes(lower) ||
+    (s.displayName && s.displayName.toLowerCase().includes(lower)) ||
+    (s.description && s.description.toLowerCase().includes(lower))
+  );
+}
+
+// -----------------------------------------------------------------------------
+// 命令实现
+// -----------------------------------------------------------------------------
+
 export async function listSkills(options: LsOptions): Promise<void> {
-  const { installed, updates, page = 1, limit = 20 } = options;
+  const { installed, updates, page = 1, limit = 20, search } = options;
   
   // -------------------------------------------------------------------------
   // 模式1: 显示已安装的 skills
   // -------------------------------------------------------------------------
   if (installed) {
-    const skills = await getInstalledSkills();
+    let skills = await getInstalledSkills();
+    
+    // 搜索关键字过滤（仅本地）
+    if (search) {
+      skills = filterInstalledSkills(skills, search);
+    }
+    
     const total = skills.length;
     const totalPages = Math.ceil(total / limit) || 1;
     const currentPage = Math.min(Math.max(1, page), totalPages);
     
     // 无已安装 skills 时给出提示
     if (skills.length === 0) {
-      console.log('No skills installed yet. Run "skm ls" to see available skills.');
+      if (search) {
+        console.log(`No skills found matching "${search}".`);
+      } else {
+        console.log('No skills installed yet. Run "skm ls" to see available skills.');
+      }
       return;
     }
     
+    // 搜索结果提示
+    if (search) {
+      console.log(`Found ${total} match(es) for "${search}":\n`);
+    } else {
+      console.log(`Installed Skills (${total}):\n`);
+    }
+    
     // 计算分页范围
     const start = (currentPage - 1) * limit;
     const end = Math.min(start + limit, total);
     const pageSkills = skills.slice(start, end);
     
-    // 打印表头
-    console.log(`Installed Skills (${total}):\n`);
-    
     // 遍历并打印每个 skill 的详细信息
     for (const skill of pageSkills) {
       // skill 名称和版本
@@ -117,7 +160,11 @@ export async function listSkills(options: LsOptions): Promise<void> {
   // -------------------------------------------------------------------------
   
   // 提示用户正在搜索
-  console.log('Searching npm registry...\n');
+  if (search) {
+    console.log(`Searching npm for "${search}"...\n`);
+  } else {
+    console.log('Searching npm registry...\n');
+  }
   
   try {
     // 计算分页偏移量
@@ -126,7 +173,8 @@ export async function listSkills(options: LsOptions): Promise<void> {
     // 调用 npm search API 搜索 skillmarket 相关包
     const { packages, total } = await searchSkillmarketPackages({
       from: offset,
-      size: limit
+      size: limit,
+      keyword: search
     });
     
     const totalPages = Math.ceil(total / limit) || 1;
@@ -134,12 +182,20 @@ export async function listSkills(options: LsOptions): Promise<void> {
     
     // 无搜索结果时
     if (packages.length === 0) {
-      console.log('No skills found. Check back later!');
+      if (search) {
+        console.log(`No skills found matching "${search}".`);
+      } else {
+        console.log('No skills found. Check back later!');
+      }
       return;
     }
     
     // 打印找到的包数量
-    console.log(`Found ${total} skill(s):\n`);
+    if (search) {
+      console.log(`Found ${total} match(es) for "${search}":\n`);
+    } else {
+      console.log(`Found ${total} skill(s):\n`);
+    }
     
     // 遍历每个包，获取详细信息并显示
     for (const pkgName of packages) {

package/src/commands/npm.ts

@@ -265,8 +265,9 @@ export async function fetchSkillPackage(skillId: string): Promise<NpmRegistryRes
 export async function searchSkillmarketPackages(options: {
   from?: number;
   size?: number;
+  keyword?: string;
 } = {}): Promise<{ packages: string[]; total: number }> {
-  const { from = 0, size = 100 } = options;
+  const { from = 0, size = 100, keyword } = options;
   const packages: string[] = [];
   let total = 0;
   
@@ -278,7 +279,15 @@ export async function searchSkillmarketPackages(options: {
     // text: 搜索关键字
     // size: 返回结果数量上限
     // from: 起始位置（分页用）
-    url.searchParams.set('text', 'keywords:skillmarket');
+    // 如果有关键字，组合搜索条件
+    if (keyword) {
+      // 组合搜索：keywords:skillmarket AND 关键字
+      // 注意：npm search 不直接支持 AND，这里用多个 text 参数
+      // 或者直接在 text 中组合
+      url.searchParams.set('text', `${keyword} keywords:skillmarket`);
+    } else {
+      url.searchParams.set('text', 'keywords:skillmarket');
+    }
     url.searchParams.set('size', String(size));
     url.searchParams.set('from', String(from));