@workskills/getskill 1.0.0 → 1.1.1

package/EXAMPLES.md

@@ -147,6 +147,12 @@ const getskill = require('@workskills/getskill');
 
 (async () => {
     try {
+        // 设置自定义 API 地址（可选）
+        getskill.setBaseUrl('https://getskill.work');
+
+        // 查看当前 API 地址
+        console.log('当前 API:', getskill.getBaseUrl());
+
         // 检查 Git 是否已安装
         const isGitInstalled = await getskill.checkGitInstalled();
         console.log('Git 已安装:', isGitInstalled);
@@ -161,7 +167,7 @@ const getskill = require('@workskills/getskill');
         console.log('搜索结果:', results);
 
         // 安装技能
-        const result = await getskill.downloadSkill('commit-helper');
+        const result = await getskill.downloadSkill('skills/commit-helper');
         console.log('安装成功:', result.files);
 
         // 更新技能
@@ -224,7 +230,28 @@ $ getskill search commit
 执行命令时出错: connect ETIMEDOUT
 ```
 
-## 场景 6: 目录结构查看
+## 场景 6: 配置自定义 API 地址
+
+```bash
+# 查看当前 API 地址
+$ getskill config get
+当前 BASE_URL: https://getskill.work
+
+# 设置自定义 API 地址
+$ getskill config set https://custom-api.example.com
+BASE_URL 已设置为: https://custom-api.example.com
+
+# 通过环境变量设置
+$ GETSKILL_BASE_URL=https://another-api.com getskill search commit
+找到 2 个技能:
+...
+
+# 验证配置
+$ getskill config get
+当前 BASE_URL: https://custom-api.example.com
+```
+
+## 场景 7: 目录结构查看
 
 ```bash
 # 安装几个技能后查看目录结构

package/README.md

@@ -10,6 +10,7 @@ OpenClaw 技能管理工具 - 从 getskill.work 搜索、下载和更新技能
 - 🛠️ 自动检测并引导安装 Git（如未安装）
 - 📂 跨平台支持（Windows/macOS/Linux）
 - 💾 自动管理技能文件到 OpenClaw skills 目录
+- ⚙️ 支持自定义 API 地址
 
 ## 工作原理
 
@@ -142,25 +143,44 @@ getskill clean
 
 清理所有 Git 仓库缓存（不影响 skills 目录中的文件）
 
+### 配置 API 地址
+
+查看当前 API 地址：
+```bash
+getskill config get
+```
+
+设置自定义 API 地址：
+```bash
+getskill config set https://your-custom-api.com
+```
+
+通过环境变量设置：
+```bash
+GETSKILL_BASE_URL=https://your-custom-api.com getskill search keyword
+```
+
 ## API 接口规范
 
 ### 搜索 API
 
 ```
-GET https://getskill.work/api/skills/search?q=<关键词>
+GET https://getskill.work/repo/search?sort=updated&order=desc&q=<关键词>&page=1&limit=20
 ```
 
 响应格式：
 ```json
 {
-  "skills": [
+  "ok": true,
+  "data": [
     {
-      "id": "commit-helper",
-      "name": "commit-helper",
-      "description": "帮助生成规范的 git commit 信息",
-      "git_url": "https://github.com/workskills/commit-helper.git",
-      "author": "workskills",
-      "version": "1.0.0"
+      "repository": {
+        "id": 1,
+        "full_name": "skills/commit-helper",
+        "description": "帮助生成规范的 git commit 信息",
+        "html_url": "https://getskill.work/skills/commit-helper",
+        "clone_url": "https://getskill.work/skills/commit-helper.git"
+      }
     }
   ]
 }
@@ -169,20 +189,19 @@ GET https://getskill.work/api/skills/search?q=<关键词>
 ### 详情 API
 
 ```
-GET https://getskill.work/api/skills/<技能ID>
+GET https://getskill.work/repo/<技能名称>
 ```
 
 响应格式：
 ```json
 {
-  "id": "commit-helper",
-  "name": "commit-helper",
-  "description": "帮助生成规范的 git commit 信息",
-  "git_url": "https://github.com/workskills/commit-helper.git",
-  "author": "workskills",
-  "version": "1.0.0",
-  "files": ["commit-helper.md"],
-  "readme": "..."
+  "repository": {
+    "id": 1,
+    "full_name": "skills/commit-helper",
+    "description": "帮助生成规范的 git commit 信息",
+    "html_url": "https://getskill.work/skills/commit-helper",
+    "clone_url": "https://getskill.work/skills/commit-helper.git"
+  }
 }
 ```
 
@@ -191,11 +210,14 @@ GET https://getskill.work/api/skills/<技能ID>
 ```javascript
 const getskill = require('@workskills/getskill');
 
+// 设置自定义 API 地址（可选）
+getskill.setBaseUrl('https://your-custom-api.com');
+
 // 搜索技能
 const results = await getskill.searchSkills('commit');
 
 // 安装技能
-const result = await getskill.downloadSkill('commit-helper');
+const result = await getskill.downloadSkill('skills/commit-helper');
 console.log(result.files); // 已复制的文件列表
 
 // 更新技能
@@ -207,6 +229,9 @@ const skills = getskill.listLocalSkills();
 // 获取目录
 const skillsDir = getskill.getSkillsDirectory();
 const cacheDir = getskill.getSkillsCacheDirectory();
+
+// 获取当前 API 地址
+const baseUrl = getskill.getBaseUrl();
 ```
 
 ## 技能仓库规范

package/index.js

@@ -7,6 +7,29 @@ const path = require('path');
 const os = require('os');
 const { exec } = require('child_process');
 
+/**
+ * 基础 URL 配置
+ * 可以通过环境变量 GETSKILL_BASE_URL 自定义
+ */
+let BASE_URL = process.env.GETSKILL_BASE_URL || 'https://getskill.work';
+
+/**
+ * 设置自定义 BASE_URL
+ * @param {string} url - 自定义的基础 URL
+ */
+function setBaseUrl(url) {
+    BASE_URL = url.replace(/\/$/, ''); // 移除末尾的斜杠
+    console.log(`BASE_URL 已设置为: ${BASE_URL}`);
+}
+
+/**
+ * 获取当前 BASE_URL
+ * @returns {string} 当前的基础 URL
+ */
+function getBaseUrl() {
+    return BASE_URL;
+}
+
 /**
  * 检查 Git 是否已安装
  */
@@ -259,18 +282,46 @@ function executeCommand(command, cwd) {
 }
 
 /**
- * 搜索技能（从 getskill.work API）
+ * 搜索技能（从配置的 BASE_URL API）
  * @param {string} keyword - 搜索关键词
+ * @param {Object} options - 搜索选项
+ * @param {string} options.sort - 排序字段，默认 'updated'
+ * @param {string} options.order - 排序顺序，默认 'desc'
+ * @param {number} options.page - 页码，默认 1
+ * @param {number} options.limit - 每页数量，默认 20
  * @returns {Promise<Array>} 技能列表（包含 git 地址）
  */
-async function searchSkills(keyword) {
-    const url = `https://getskill.work/api/skills/search?q=${encodeURIComponent(keyword)}`;
+async function searchSkills(keyword, options = {}) {
+    const {
+        sort = 'updated',
+        order = 'desc',
+        page = 1,
+        limit = 20
+    } = options;
+
+    const url = `${BASE_URL}/repo/search?sort=${sort}&order=${order}&q=${encodeURIComponent(keyword)}&page=${page}&limit=${limit}`;
 
     try {
         const response = await request(url);
-        const data = JSON.parse(response.body);
-        // 返回格式: [{ name, description, git_url, author, ... }]
-        return data.skills || [];
+        const result = JSON.parse(response.body);
+
+        // 解析返回格式: { ok: true, data: [{ repository: {...} }] }
+        if (!result.ok || !result.data) {
+            return [];
+        }
+
+        // 提取需要的字段
+        return result.data.map(item => {
+            const repo = item.repository || {};
+            return {
+                name: repo.full_name || '',
+                full_name: repo.full_name || '',
+                description: repo.description || '',
+                html_url: repo.html_url || '',
+                git_url: repo.html_url ? `${repo.html_url}.git` : '',
+                clone_url: repo.clone_url || ''
+            };
+        });
     } catch (error) {
         console.error('搜索技能失败:', error.message);
         throw error;
@@ -279,17 +330,38 @@ async function searchSkills(keyword) {
 
 /**
  * 获取技能详情（包含 git 地址）
- * @param {string} skillId - 技能ID
+ * @param {string} skillId - 技能ID或名称
  * @returns {Promise<Object>} 技能详情
  */
 async function getSkillDetail(skillId) {
-    const url = `https://getskill.work/api/skills/${skillId}`;
+    const url = `${BASE_URL}/repo/${encodeURIComponent(skillId)}`;
 
     try {
         const response = await request(url);
-        const data = JSON.parse(response.body);
-        // 返回格式: { name, description, git_url, files, ... }
-        return data;
+        const result = JSON.parse(response.body);
+
+        // 如果返回的数据格式类似搜索接口，需要解析 repository
+        if (result.repository) {
+            const repo = result.repository;
+            return {
+                name: repo.full_name || repo.name || skillId,
+                full_name: repo.full_name || '',
+                description: repo.description || '',
+                html_url: repo.html_url || '',
+                git_url: repo.html_url ? `${repo.html_url}.git` : '',
+                clone_url: repo.clone_url || ''
+            };
+        }
+
+        // 如果是直接返回数据（向后兼容）
+        return {
+            name: result.full_name || result.name || skillId,
+            full_name: result.full_name || '',
+            description: result.description || '',
+            html_url: result.html_url || '',
+            git_url: result.html_url ? `${result.html_url}.git` : (result.git_url || ''),
+            clone_url: result.clone_url || ''
+        };
     } catch (error) {
         console.error('获取技能详情失败:', error.message);
         throw error;
@@ -386,12 +458,14 @@ async function downloadSkill(skillIdOrName) {
         console.log(`获取技能信息: ${skillIdOrName}...`);
         const skillDetail = await getSkillDetail(skillIdOrName);
 
-        if (!skillDetail.git_url) {
-            throw new Error('技能信息中未包含 git_url');
+        // 支持 clone_url 或 git_url
+        const gitUrl = skillDetail.clone_url || skillDetail.git_url;
+        if (!gitUrl) {
+            throw new Error('技能信息中未包含 git_url 或 clone_url');
         }
 
         const skillName = skillDetail.name || skillIdOrName;
-        const repoPath = await cloneOrUpdateRepo(skillDetail.git_url, skillName);
+        const repoPath = await cloneOrUpdateRepo(gitUrl, skillName);
         const copiedFiles = copySkillFiles(repoPath);
 
         return {
@@ -475,16 +549,13 @@ async function cli() {
                 const results = await searchSkills(args[1]);
                 console.log(`找到 ${results.length} 个技能:\n`);
                 results.forEach((skill, index) => {
-                    console.log(`${index + 1}. ${skill.name}`);
+                    console.log(`${index + 1}. ${skill.full_name}`);
                     if (skill.description) {
                         console.log(`   描述: ${skill.description}`);
                     }
                     if (skill.git_url) {
                         console.log(`   Git: ${skill.git_url}`);
                     }
-                    if (skill.author) {
-                        console.log(`   作者: ${skill.author}`);
-                    }
                     console.log('');
                 });
                 break;
@@ -527,6 +598,18 @@ async function cli() {
                 console.log(`缓存目录: ${getSkillsCacheDirectory()}`);
                 break;
 
+            case 'config':
+                if (args[1] === 'set' && args[2]) {
+                    setBaseUrl(args[2]);
+                } else if (args[1] === 'get') {
+                    console.log(`当前 BASE_URL: ${getBaseUrl()}`);
+                } else {
+                    console.log('用法:');
+                    console.log('  getskill config set <URL>  - 设置自定义 API 地址');
+                    console.log('  getskill config get        - 查看当前 API 地址');
+                }
+                break;
+
             case 'clean':
                 const cacheDir = getSkillsCacheDirectory();
                 if (fs.existsSync(cacheDir)) {
@@ -541,13 +624,16 @@ async function cli() {
                 console.log('GetSkill - OpenClaw 技能管理工具');
                 console.log('');
                 console.log('用法:');
-                console.log('  getskill search <关键词>    - 从 getskill.work 搜索技能');
+                console.log('  getskill search <关键词>    - 从 API 搜索技能');
                 console.log('  getskill install <技能名称> - 通过 git clone 安装技能');
                 console.log('  getskill update <技能名称>  - 通过 git pull 更新技能');
                 console.log('  getskill list               - 列出本地技能');
                 console.log('  getskill path               - 显示目录路径');
+                console.log('  getskill config set <URL>   - 设置自定义 API 地址');
+                console.log('  getskill config get         - 查看当前 API 地址');
                 console.log('  getskill clean              - 清理 git 缓存');
                 console.log('');
+                console.log(`当前 API: ${getBaseUrl()}`);
                 console.log(`技能目录: ${getSkillsDirectory()}`);
                 console.log(`缓存目录: ${getSkillsCacheDirectory()}`);
         }
@@ -569,7 +655,9 @@ module.exports = {
     cloneOrUpdateRepo,
     copySkillFiles,
     checkGitInstalled,
-    ensureGitInstalled
+    ensureGitInstalled,
+    setBaseUrl,
+    getBaseUrl
 };
 
 // 如果直接运行此文件，执行 CLI

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@workskills/getskill",
-    "version": "1.0.0",
-    "description": "Search, install, and update OpenClaw skills from getskill.work with automatic Git integration",
+    "version": "1.1.1",
+    "description": "Search, install, and update OpenClaw skills with automatic Git integration and configurable API endpoint",
     "main": "index.js",
     "bin": {
         "getskill": "./index.js"