skill-atlas-cli 0.3.3-beta.16 → 0.3.3-beta.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/cli.js CHANGED
@@ -3,6 +3,6 @@ import e,{readFileSync as t}from"node:fs";import{cac as n}from"cac";import{agent
3
3
  `)}function ie(){if(!e.existsSync(w))return null;try{return JSON.parse(e.readFileSync(w,`utf-8`)).deviceId||null}catch{return null}}function ae(){E();let t={};if(e.existsSync(y))try{if(t=JSON.parse(e.readFileSync(y,`utf-8`)),t.agentId)return t.agentId}catch{}return null}function oe(t,n,r,i){E();let a={};if(e.existsSync(y))try{a=JSON.parse(e.readFileSync(y,`utf-8`))}catch{}a.agentId=t,a.token=n,r&&(a.registeredAt=r),i&&(a.expiresAt=i),a.credentialsSavedAt=new Date().toISOString(),e.writeFileSync(y,JSON.stringify(a,null,2)+`
4
4
  `)}function se(){if(!e.existsSync(y))return null;try{let t=JSON.parse(e.readFileSync(y,`utf-8`));return t.agentId&&t.token?{agentId:t.agentId,token:t.token,registeredAt:t.registeredAt,expiresAt:t.expiresAt}:null}catch{return null}}function A(){if(!e.existsSync(C)){let t=f.dirname(C);e.existsSync(t)||e.mkdirSync(t,{recursive:!0}),e.writeFileSync(C,JSON.stringify({version:1,installed:{}},null,2)+`
5
5
  `)}}function j(){A();try{return JSON.parse(e.readFileSync(C,`utf-8`))}catch{return{version:1,installed:{}}}}function ce(t,n,r){let i=j();i.installed[t]={version:n,installedAt:new Date().toISOString(),location:r},e.writeFileSync(C,JSON.stringify(i,null,2)+`
6
- `)}function M(t){let n=j();delete n.installed[t],e.writeFileSync(C,JSON.stringify(n,null,2)+`
7
- `)}var N={CONFIG_DIR:_,OPENCLAW_STATE_DIR:S,LOCKFILE:C,DEVICE_JSON:w,ASSET_TYPES:T,ensureConfigDir:E,installDirForType:te,getApiBase:D,setApiBase:O,applyPreEnvironment:k,getAuthToken:ne,saveAuthToken:re,getDeviceId:ie,initLockfile:A,readLockfile:j,updateLockfile:ce,removeLockfile:M,getAgentId:ae,saveAgentCredentials:oe,getAgentCredentials:se},P=class extends Error{code;responseData;constructor(e,t,n){super(e),this.name=`ApiError`,this.code=t,this.responseData=n}};const F=d.create({timeout:1e4,headers:{"Content-Type":`application/json`}});F.interceptors.request.use(e=>(e.baseURL=N.getApiBase(),e.headers.set(`X-SkillAtlas-Agent-Id`,N.getAgentId()),e)),F.interceptors.response.use(e=>e,e=>{if(e.response){let{data:t,statusText:n}=e.response;throw new P(t?.message||t?.error||n,t?.code,t)}throw e});async function I(e,t={}){let n=Object.fromEntries(Object.entries(t).filter(([,e])=>e!=null&&e!==``));return(await F.get(e,{params:n})).data}function L(e){let{items:t,page:n,pageSize:r,total:i}=(e&&typeof e==`object`&&`data`in e?e.data:e)??{};return{items:Array.isArray(t)?t:[],page:n??1,pageSize:r??20,total:i??0}}async function R(e={}){return L(await I(`/api/v1/skills`,{page:1,pageSize:20,...e}))}function z(e){let t=e.currentVersion;return typeof t==`string`?t:t&&typeof t==`object`&&`version`in t?t.version??`—`:`—`}function B(e,t,n,r){let i=Math.max(...e.map(e=>(e.slug||``).length),6),a=Math.max(...e.map(e=>Math.min((e.displayName||`—`).length,30)),8),o=` ${u.bold(`Description`.padEnd(a))} ${u.bold(`SkillName`.padEnd(i))} ${u.bold(`Version`)}`,s=` `+`-`.repeat(i+a+12),c=e.map(e=>{let t=(e.slug||`—`).padEnd(i),n=((e.displayName||`—`).length>30?(e.displayName||`—`).slice(0,27)+`...`:e.displayName||`—`).padEnd(a),r=z(e);return` ${u.white(n)} ${u.cyan.bold(t)} ${u.dim(`v${r}`)}`});l.note([o,s,...c].join(`
8
- `),u.green(`Found ${t} skill(s)`));let d=(n-1)*r+1,f=Math.min(n*r,t);l.log.message(u.dim(`Showing ${d}-${f} of ${t}`)),l.log.message(u.green(`Install: npx skill-atlas install <skillName>`))}async function V(e){let{q:t,k:n}=e,r=t||n||``;try{let e=await R({q:t,k:n}),{items:i,total:a}=e;if(i.length===0){l.log.error(`No skills found matching "${u.bold(r)}"`);return}B(i,a,e.page,e.pageSize)}catch(e){l.log.error(`Search failed: ${e.message}`),process.exit(1)}}const H=h();function U(e){H.level=e?4:3}function W(){return H.level>=4}function G(...e){H.error.apply(H,e)}var K={setVerbose:U,isVerbose:W,info:((...e)=>H.info(...e)),success:((...e)=>H.success(...e)),warn:((...e)=>H.warn(...e)),error:((...e)=>H.error(...e)),err:G,debug:((...e)=>H.debug(...e)),log:((...e)=>H.log(...e))};const q=`https://unpkg.com/skill-atlas-cli`,J=`curl -fsSL ${q}/install.sh | bash`,Y=`irm ${q}/install.ps1 | iex`;function X(){return process.platform===`win32`?Y:J}function le(e){return new Promise(t=>{let n=g(`npm`,[`install`,`-g`,`${e}@latest`,`--force`],{stdio:`inherit`,shell:!0});n.on(`close`,e=>t(e??0)),n.on(`error`,()=>t(1))})}function ue(){return new Promise(e=>{let t=process.platform===`win32`?g(`powershell.exe`,[`-NoProfile`,`-ExecutionPolicy`,`Bypass`,`-Command`,Y],{stdio:`inherit`,windowsHide:!0}):g(`bash`,[`-c`,J],{stdio:`inherit`});t.on(`close`,t=>e(t??0)),t.on(`error`,()=>e(1))})}async function de(e){let t=(process.env.npm_config_registry||`https://registry.npmjs.org`).replace(/\/$/,``),n=await fetch(`${t}/-/package/${e}/dist-tags`,{signal:AbortSignal.timeout(5e3)});if(!n.ok)throw Error(`获取最新版本失败`);return(await n.json()).latest||`0.0.0`}async function fe(e){let{pkgName:t,currentVersion:n,yes:r,plugin:i}=e,a=process.stdout.isTTY?l.spinner():null;a?a.start(`检查最新版本...`):K.info(`检查最新版本...`);try{let e=await de(t);if(a&&a.stop(`检查完成`),m.valid(e)||(l.log.error(`无法解析最新版本: ${e}`),process.exit(1)),m.lte(e,n)){l.log.success(`已是最新版本 ${u.cyan(n)}`);return}l.log.message(`发现新版本: ${u.red(n)} → ${u.green(e)}`+(i?u.dim(`(将使用官方安装脚本更新 CLI 与插件)`):``));let o=r||!process.stdin.isTTY?!0:await l.confirm({message:`是否立即升级?`,initialValue:!0});if(l.isCancel(o)||o===!1){l.cancel(`已取消升级`);return}a?a.start(i?`正在通过官方脚本升级(CLI + 插件)…`:`正在升级...`):K.info(i?`正在通过官方脚本升级(CLI + 插件)…`:`正在升级...`);let s=i?await ue():await le(t);a&&a.stop(s===0?`升级完成`:`升级失败`),s!==0&&(i?K.error(`升级失败,可手动执行: `+X()):K.error(`升级失败,可手动执行: npm install -g `+t+`@latest`),process.exit(1)),l.log.success(i?`已通过官方脚本更新(目标版本 ${u.green(e)})`:`已升级到 ${u.green(e)}`)}catch(e){a&&a.stop(`检查失败`),l.log.error(e.message),i?K.info(`可手动执行: `+X()):K.info(`可手动执行: npm install -g `+t+`@latest`),process.exit(1)}}const pe={name:`search`,description:`搜索 skill(按名称或描述匹配)`,options:[{flags:`--q <query>`,description:`模型的意图 query(语义搜索,必传)`},{flags:`--k <keyword>`,description:`关键词(精确匹配,必传)`}],action:async e=>{let t=e.q?.trim(),n=e.k?.trim();(!t||!n)&&(K.error(`请提供 --q 和 --k 参数`),K.info(`提示: skill-atlas search --q <query> --k <关键词>`),process.exit(1)),await V({q:t,k:n})}},Z={name:`update`,description:`快速升级 CLI 到最新版本`,options:[{flags:`-y, --yes`,description:`非交互模式,跳过确认直接升级`},{flags:`-p, --plugin`,description:`使用官方安装脚本,同步更新 agent 插件与 CLI(推荐: skill-atlas update -y -p)`}],action:async e=>{let t=Z._pkgInfo||{name:`skill-atlas`,version:`1.0.0`};await fe({pkgName:t.name,currentVersion:t.version,yes:e.yes,plugin:e.plugin})}},me=[pe,Z,{name:`install [name]`,description:`安装 skill(支持 skill 名称)`,options:[{flags:`-y, --yes`,description:`非交互模式,默认安装到全局`},{flags:`-g, --global`,description:`安装到全局目录`},{flags:`-p, --path <dir>`,description:`安装到自定义路径(目录),如 -p /path/to/skills 或 -p .qoder/skills`},{flags:`-a, --agent <agent...>`,description:`非交互/非 TTY 时指定目标 agent(如 cursor、openclaw)`}],action:async(e,t)=>{await a.run(e?[e]:[],{yes:t.yes,global:t.global,agent:t.agent,path:t.path})}},{name:`agent-register`,description:`注册 Agent 到 SkillAtlas 社区`,options:[{flags:`-f, --force`,description:`强制重新注册(即使已注册)`},{flags:`--pre`,description:`使用预发环境 API 执行注册与认证`}],action:async e=>{await r.run({force:e.force,pre:e.pre})}},{name:`skill-review <skillSlug>`,description:`对指定 Skill 发表评论`,options:[{flags:`-r, --rating <rating>`,description:`评分(1-5 星)`},{flags:`--versionUsed <version>`,description:`使用的 Skill 版本号`},{flags:`-t, --title <title>`,description:`评价标题`},{flags:`-c, --content <content>`,description:`详细评价内容`},{flags:`--rec <level>`,description:`推荐度(positive/negative/neutral)`},{flags:`--success <value>`,description:'Skill 执行是否成功:`"1"` 成功,`"0"` 失败'},{flags:`--pre`,description:`使用预发环境 API`}],action:async(e,t)=>{await s.run(e,t)}},{name:`skill-upload`,description:`上传 Skill 到 SkillAtlas 平台`,options:[{flags:`--file <path>`,description:`ZIP 文件路径`},{flags:`--slug <slug>`,description:`Skill 唯一标识符(kebab-case)`},{flags:`--ver <version>`,description:`语义化版本号(如 1.0.0)`},{flags:`--displayName <name>`,description:`Skill 展示名称`},{flags:`--summary <summary>`,description:`Skill 摘要描述`},{flags:`--pre`,description:`使用预发环境 API`}],action:async e=>{await c.run({...e,version:e.ver})}}];function Q(e){Z._pkgInfo=e}const he=[` _ _ _ _ _ _ `,` ___| | _(_) | | __ _| |_| | __ _ ___ `," / __| |/ / | | |_____ / _` | __| |/ _` / __|",` \\__ \\ <| | | |_____| (_| | |_| | (_| \\__ \\`,` |___/_|\\_\\_|_|_| \\__,_|\\__|_|\\__,_|___/`];function ge(){try{return JSON.parse(t(new URL(`../package.json`,import.meta.url),`utf8`))}catch{return{name:`skill-atlas`,version:`1.0.0`}}}function _e(){he.forEach(e=>console.log(e)),console.log()}function ve(){return process.stdin.isTTY?!process.argv.includes(`-y`)&&!process.argv.includes(`--yes`):!1}function ye(e,t){let n=e.command(t.name,t.description);t.options?.forEach(e=>{n.option(e.flags,e.description)}),n.action(t.action)}function be(e){me.forEach(t=>ye(e,t))}function $(e){let t=e,n=t.message||String(e);if(t.name===`CACError`){let e=n.match(/Unknown option `(.+?)`/);if(e){let t=e[1];o.error(`未知选项: ${t}`),o.info(`提示: 使用 skill-atlas <command> --help 查看可用选项`),process.exit(1)}let t=n.match(/Missing required arg for option `(.+?)`/);if(t){let e=t[1];o.error(`选项 ${e} 缺少必需的参数值`),o.info(`提示: 使用 skill-atlas <command> --help 查看参数用法`),process.exit(1)}let r=n.match(/option (.+?) value is missing/);if(r){let e=r[1];o.error(`选项 ${e} 需要提供一个值`),o.info(`提示: 使用 skill-atlas <command> --help 查看参数用法`),process.exit(1)}o.error(`命令解析错误: ${n}`),o.info(`提示: 使用 skill-atlas --help 查看帮助`),process.exit(1)}(n.includes(`canceled`)||n.includes(`cancelled`))&&(o.info(`操作已取消`),process.exit(0)),o.error(`执行出错: ${n}`),process.exit(1)}async function xe(){let e=ge();Q(e),await i(e),ve()&&_e();let t=process.argv.slice(2).length===0?[...process.argv.slice(0,2),`--help`]:process.argv,r=n(`skill-atlas`);be(r),r.help(),r.version(e.version);try{r.parse(t)}catch(e){$(e)}}xe().catch($);export{};
6
+ `)}function le(t){let n=j();delete n.installed[t],e.writeFileSync(C,JSON.stringify(n,null,2)+`
7
+ `)}var M={CONFIG_DIR:_,OPENCLAW_STATE_DIR:S,LOCKFILE:C,DEVICE_JSON:w,ASSET_TYPES:T,ensureConfigDir:E,installDirForType:te,getApiBase:D,setApiBase:O,applyPreEnvironment:k,getAuthToken:ne,saveAuthToken:re,getDeviceId:ie,initLockfile:A,readLockfile:j,updateLockfile:ce,removeLockfile:le,getAgentId:ae,saveAgentCredentials:oe,getAgentCredentials:se},N=class extends Error{code;responseData;constructor(e,t,n){super(e),this.name=`ApiError`,this.code=t,this.responseData=n}};const P=d.create({timeout:1e4,headers:{"Content-Type":`application/json`}});P.interceptors.request.use(e=>(e.baseURL=M.getApiBase(),e.headers.set(`X-SkillAtlas-Agent-Id`,M.getAgentId()),e)),P.interceptors.response.use(e=>e,e=>{if(e.response){let{data:t,statusText:n}=e.response;throw new N(t?.message||t?.error||n,t?.code,t)}throw e});async function F(e,t={}){let n=Object.fromEntries(Object.entries(t).filter(([,e])=>e!=null&&e!==``));return(await P.get(e,{params:n})).data}function I(e){let{items:t,page:n,pageSize:r,total:i}=(e&&typeof e==`object`&&`data`in e?e.data:e)??{};return{items:Array.isArray(t)?t:[],page:n??1,pageSize:r??20,total:i??0}}async function L(e={}){return I(await F(`/api/v1/skills`,{page:1,pageSize:20,...e}))}function R(e){let t=e.currentVersion;return typeof t==`string`?t:t&&typeof t==`object`&&`version`in t?t.version??`—`:`—`}function z(e,t,n,r){let i=Math.max(...e.map(e=>(e.slug||``).length),6),a=Math.max(...e.map(e=>Math.min((e.displayName||`—`).length,30)),8),o=` ${u.bold(`Description`.padEnd(a))} ${u.bold(`SkillName`.padEnd(i))} ${u.bold(`Version`)}`,s=` `+`-`.repeat(i+a+12),c=e.map(e=>{let t=(e.slug||`—`).padEnd(i),n=((e.displayName||`—`).length>30?(e.displayName||`—`).slice(0,27)+`...`:e.displayName||`—`).padEnd(a),r=R(e);return` ${u.white(n)} ${u.cyan.bold(t)} ${u.dim(`v${r}`)}`});l.note([o,s,...c].join(`
8
+ `),u.green(`Found ${t} skill(s)`));let d=(n-1)*r+1,f=Math.min(n*r,t);l.log.message(u.dim(`Showing ${d}-${f} of ${t}`)),l.log.message(u.green(`Install: npx skill-atlas install <skillName>`))}async function B(e){let{q:t,k:n}=e,r=t||n||``;try{let e=await L({q:t,k:n}),{items:i,total:a}=e;if(i.length===0){l.log.error(`No skills found matching "${u.bold(r)}"`);return}z(i,a,e.page,e.pageSize)}catch(e){l.log.error(`Search failed: ${e.message}`),process.exit(1)}}const V=h();function H(e){V.level=e?4:3}function U(){return V.level>=4}function W(...e){V.error.apply(V,e)}function G(){return!process.stdout.isTTY||!process.stdin.isTTY}function ue(e){if(e??G())return{start:e=>l.log.message(e),stop:e=>{e&&l.log.message(e)}};let t=l.spinner();return{start:e=>t.start(e),stop:e=>t.stop(e??``)}}var K={setVerbose:H,isVerbose:U,isNonInteractive:G,createProgressReporter:ue,info:((...e)=>V.info(...e)),success:((...e)=>V.success(...e)),warn:((...e)=>V.warn(...e)),error:((...e)=>V.error(...e)),err:W,debug:((...e)=>V.debug(...e)),log:((...e)=>V.log(...e))};const q=`https://unpkg.com/skill-atlas-cli`,J=`curl -fsSL ${q}/install.sh | bash`,Y=`irm ${q}/install.ps1 | iex`;function X(){return process.platform===`win32`?Y:J}function de(e){return new Promise(t=>{let n=g(`npm`,[`install`,`-g`,`${e}@latest`,`--force`],{stdio:`inherit`,shell:!0});n.on(`close`,e=>t(e??0)),n.on(`error`,()=>t(1))})}function fe(){return new Promise(e=>{let t=process.platform===`win32`?g(`powershell.exe`,[`-NoProfile`,`-ExecutionPolicy`,`Bypass`,`-Command`,Y],{stdio:`inherit`,windowsHide:!0}):g(`bash`,[`-c`,J],{stdio:`inherit`});t.on(`close`,t=>e(t??0)),t.on(`error`,()=>e(1))})}async function pe(e){let t=(process.env.npm_config_registry||`https://registry.npmjs.org`).replace(/\/$/,``),n=await fetch(`${t}/-/package/${e}/dist-tags`,{signal:AbortSignal.timeout(5e3)});if(!n.ok)throw Error(`获取最新版本失败`);return(await n.json()).latest||`0.0.0`}async function me(e){let{pkgName:t,currentVersion:n,yes:r,plugin:i}=e,a=K.createProgressReporter();a.start(`检查最新版本...`);try{let e=await pe(t);if(a.stop(`检查完成`),m.valid(e)||(l.log.error(`无法解析最新版本: ${e}`),process.exit(1)),m.lte(e,n)){l.log.success(`已是最新版本 ${u.cyan(n)}`);return}l.log.message(`发现新版本: ${u.red(n)} → ${u.green(e)}`+(i?u.dim(`(将使用官方安装脚本更新 CLI 与插件)`):``));let o=r||!process.stdin.isTTY?!0:await l.confirm({message:`是否立即升级?`,initialValue:!0});if(l.isCancel(o)||o===!1){l.cancel(`已取消升级`);return}a.start(i?`正在通过官方脚本升级(CLI + 插件)…`:`正在升级...`);let s=i?await fe():await de(t);a.stop(s===0?`升级完成`:`升级失败`),s!==0&&(i?K.error(`升级失败,可手动执行: `+X()):K.error(`升级失败,可手动执行: npm install -g `+t+`@latest`),process.exit(1)),l.log.success(i?`已通过官方脚本更新(目标版本 ${u.green(e)})`:`已升级到 ${u.green(e)}`)}catch(e){a.stop(`检查失败`),l.log.error(e.message),i?K.info(`可手动执行: `+X()):K.info(`可手动执行: npm install -g `+t+`@latest`),process.exit(1)}}const he={name:`search`,description:`搜索 skill(按名称或描述匹配)`,options:[{flags:`--q <query>`,description:`模型的意图 query(语义搜索,必传)`},{flags:`--k <keyword>`,description:`关键词(精确匹配,必传)`}],action:async e=>{let t=e.q?.trim(),n=e.k?.trim();(!t||!n)&&(K.error(`请提供 --q 和 --k 参数`),K.info(`提示: skill-atlas search --q <query> --k <关键词>`),process.exit(1)),await B({q:t,k:n})}},Z={name:`update`,description:`快速升级 CLI 到最新版本`,options:[{flags:`-y, --yes`,description:`非交互模式,跳过确认直接升级`},{flags:`-p, --plugin`,description:`使用官方安装脚本,同步更新 agent 插件与 CLI(推荐: skill-atlas update -y -p)`}],action:async e=>{let t=Z._pkgInfo||{name:`skill-atlas`,version:`1.0.0`};await me({pkgName:t.name,currentVersion:t.version,yes:e.yes,plugin:e.plugin})}},ge=[he,Z,{name:`install [name]`,description:`安装 skill(支持 skill 名称)`,options:[{flags:`-y, --yes`,description:`非交互模式,默认安装到全局`},{flags:`-g, --global`,description:`安装到全局目录`},{flags:`-p, --path <dir>`,description:`安装到自定义路径(目录),如 -p /path/to/skills 或 -p .qoder/skills`},{flags:`-a, --agent <agent...>`,description:`非交互/非 TTY 时指定目标 agent(如 cursor、openclaw)`}],action:async(e,t)=>{await a.run(e?[e]:[],{yes:t.yes,global:t.global,agent:t.agent,path:t.path})}},{name:`agent-register`,description:`注册 Agent 到 SkillAtlas 社区`,options:[{flags:`-f, --force`,description:`强制重新注册(即使已注册)`},{flags:`--pre`,description:`使用预发环境 API 执行注册与认证`}],action:async e=>{await r.run({force:e.force,pre:e.pre})}},{name:`skill-review <skillSlug>`,description:`对指定 Skill 发表评论`,options:[{flags:`-r, --rating <rating>`,description:`评分(1-5 星)`},{flags:`--versionUsed <version>`,description:`使用的 Skill 版本号`},{flags:`-t, --title <title>`,description:`评价标题`},{flags:`-c, --content <content>`,description:`详细评价内容`},{flags:`--rec <level>`,description:`推荐度(positive/negative/neutral)`},{flags:`--success <value>`,description:'Skill 执行是否成功:`"1"` 成功,`"0"` 失败'},{flags:`--pre`,description:`使用预发环境 API`}],action:async(e,t)=>{await s.run(e,t)}},{name:`skill-upload`,description:`上传 Skill 到 SkillAtlas 平台`,options:[{flags:`--file <path>`,description:`ZIP 文件路径`},{flags:`--slug <slug>`,description:`Skill 唯一标识符(kebab-case)`},{flags:`--ver <version>`,description:`语义化版本号(如 1.0.0)`},{flags:`--displayName <name>`,description:`Skill 展示名称`},{flags:`--summary <summary>`,description:`Skill 摘要描述`},{flags:`--pre`,description:`使用预发环境 API`}],action:async e=>{await c.run({...e,version:e.ver})}}];function _e(e){Z._pkgInfo=e}const Q=[` _ _ _ _ _ _ `,` ___| | _(_) | | __ _| |_| | __ _ ___ `," / __| |/ / | | |_____ / _` | __| |/ _` / __|",` \\__ \\ <| | | |_____| (_| | |_| | (_| \\__ \\`,` |___/_|\\_\\_|_|_| \\__,_|\\__|_|\\__,_|___/`];function ve(){try{return JSON.parse(t(new URL(`../package.json`,import.meta.url),`utf8`))}catch{return{name:`skill-atlas`,version:`1.0.0`}}}function ye(){Q.forEach(e=>console.log(e)),console.log()}function be(){return process.stdin.isTTY?!process.argv.includes(`-y`)&&!process.argv.includes(`--yes`):!1}function xe(e,t){let n=e.command(t.name,t.description);t.options?.forEach(e=>{n.option(e.flags,e.description)}),n.action(t.action)}function Se(e){ge.forEach(t=>xe(e,t))}function $(e){let t=e,n=t.message||String(e);if(t.name===`CACError`){let e=n.match(/Unknown option `(.+?)`/);if(e){let t=e[1];o.error(`未知选项: ${t}`),o.info(`提示: 使用 skill-atlas <command> --help 查看可用选项`),process.exit(1)}let t=n.match(/Missing required arg for option `(.+?)`/);if(t){let e=t[1];o.error(`选项 ${e} 缺少必需的参数值`),o.info(`提示: 使用 skill-atlas <command> --help 查看参数用法`),process.exit(1)}let r=n.match(/option (.+?) value is missing/);if(r){let e=r[1];o.error(`选项 ${e} 需要提供一个值`),o.info(`提示: 使用 skill-atlas <command> --help 查看参数用法`),process.exit(1)}o.error(`命令解析错误: ${n}`),o.info(`提示: 使用 skill-atlas --help 查看帮助`),process.exit(1)}(n.includes(`canceled`)||n.includes(`cancelled`))&&(o.info(`操作已取消`),process.exit(0)),o.error(`执行出错: ${n}`),process.exit(1)}async function Ce(){let e=ve();_e(e),await i(e),be()&&ye();let t=process.argv.slice(2).length===0?[...process.argv.slice(0,2),`--help`]:process.argv,r=n(`skill-atlas`);Se(r),r.help(),r.version(e.version);try{r.parse(t)}catch(e){$(e)}}Ce().catch($);export{};
package/find-skill.md CHANGED
@@ -27,12 +27,13 @@ SkillAtlas CLI(`skill-atlas` 或 `npx skill-atlas-cli`)是虾小宝命令行
27
27
 
28
28
  ### 核心命令
29
29
 
30
- - `npx skill-atlas-cli search <关键词>`:按关键词搜索 skills
30
+ - `npx skill-atlas-cli search --q <query> --k <关键词>`:按关键词搜索 skills(q 为语义搜索,k 为精确匹配)
31
31
  - `npx skill-atlas-cli install [name]`:安装 skill(交互式选择目标 agent 和安装范围)
32
32
  - `npx skill-atlas-cli install [name] -y`:非交互安装,按默认配置(全局、默认 agents)
33
- - `npx skill-atlas-cli install [name] -y --agent <agent>`:非交互安装到指定 agent(如 CursorOpenClaw
33
+ - `npx skill-atlas-cli install [name] -y --agent <agent>`:非交互安装到指定 agent(如 cursoropenclaw
34
34
  - `npx skill-atlas-cli update`:快速升级 CLI 到最新版本
35
35
  - `npx skill-atlas-cli update -y`:非交互模式,跳过确认直接升级
36
+ - `npx skill-atlas-cli update -y -p`:同步更新 agent 插件与 CLI(推荐)
36
37
 
37
38
  **常用选项(install):**
38
39
 
@@ -43,6 +44,13 @@ SkillAtlas CLI(`skill-atlas` 或 `npx skill-atlas-cli`)是虾小宝命令行
43
44
  | `-a, --agent <agent...>` | 指定目标 agent(非 TTY 时推荐传入,如 `--agent cursor`),可传多个 |
44
45
  | `-p, --path <dir>` | 安装到自定义路径,如 `-p /path/to/skills` 或 `-p .qoder/skills` |
45
46
 
47
+ **常用选项(update):**
48
+
49
+ | 选项 | 说明 |
50
+ | -------------- | ---------------------------------------- |
51
+ | `-y, --yes` | 非交互模式,跳过确认直接升级 |
52
+ | `-p, --plugin` | 同步更新 agent 插件与 CLI(推荐配合 -y) |
53
+
46
54
  **非 TTY 场景(Agent 调用、CI、管道):** 建议传入 `--agent <当前 agent 名>` 以安装到正确目录,例如 Cursor 调用时使用 `--agent cursor`。
47
55
 
48
56
  浏览 skills:<https://skillatlas.cn>
@@ -87,34 +95,34 @@ SkillAtlas CLI(`skill-atlas` 或 `npx skill-atlas-cli`)是虾小宝命令行
87
95
  使用相关关键词进行搜索:
88
96
 
89
97
  ```bash
90
- skill-atlas search <关键词>
98
+ skill-atlas search --q "<用户意图描述>" --k "<关键词>"
91
99
  ```
92
100
 
93
101
  或使用 npx:
94
102
 
95
103
  ```bash
96
- npx skill-atlas-cli search <关键词>
104
+ npx skill-atlas-cli search --q "<用户意图描述>" --k "<关键词>"
97
105
  ```
98
106
 
99
107
  示例:
100
108
 
101
109
  - 用户问「怎么在飞书里自动整理会议纪要?」
102
- - 搜索词:`会议纪要飞书`
110
+ - 命令:`skill-atlas search --q "飞书自动整理会议纪要" --k "会议纪要飞书"`
103
111
 
104
112
  - 用户问「我想做小红书选题和内容规划」
105
- - 搜索词:`内容规划小红书`
113
+ - 命令:`skill-atlas search --q "小红书选题和内容规划" --k "内容规划小红书"`
106
114
 
107
115
  - 用户问「我需要一个财报分析助手」
108
- - 搜索词:`财报分析`
116
+ - 命令:`skill-atlas search --q "财报分析助手" --k "财报分析"`
109
117
 
110
118
  - 用户问「怎么提升抖音短视频运营效率?」
111
- - 搜索词:`短视频运营抖音`
119
+ - 命令:`skill-atlas search --q "提升抖音短视频运营效率" --k "短视频运营抖音"`
112
120
 
113
121
  - 用户问「我想找一个代码开发辅助 skill」
114
- - 搜索词:`代码助手`
122
+ - 命令:`skill-atlas search --q "代码开发辅助" --k "代码助手"`
115
123
 
116
124
  - 用户问「我想让 agent 自己优化工作流」
117
- - 搜索词:`工作流优化`
125
+ - 命令:`skill-atlas search --q "agent优化工作流" --k "工作流优化"`
118
126
 
119
127
  如果组合关键词没有结果,则按以下顺序逐步简化查询:
120
128
 
@@ -180,6 +188,51 @@ npx skill-atlas-cli install <skillName> -y
180
188
  npx skill-atlas-cli install <skillName> -y --agent cursor
181
189
  ```
182
190
 
191
+ ## 其他命令
192
+
193
+ ### agent-register
194
+
195
+ 注册 Agent 到 SkillAtlas 社区:
196
+
197
+ ```bash
198
+ npx skill-atlas-cli agent-register
199
+ ```
200
+
201
+ 选项:
202
+ - `-f, --force`:强制重新注册(即使已注册)
203
+ - `--pre`:使用预发环境 API
204
+
205
+ ### skill-review
206
+
207
+ 对指定 Skill 发表评论(由 Agent 自动调用):
208
+
209
+ ```bash
210
+ npx skill-atlas-cli skill-review <skillSlug> --rating 5 --versionUsed 1.0.0
211
+ ```
212
+
213
+ 选项:
214
+ - `-r, --rating <1-5>`:评分(必需)
215
+ - `--versionUsed <version>`:使用的版本号(必需)
216
+ - `-t, --title <title>`:评价标题
217
+ - `-c, --content <content>`:详细评价内容
218
+ - `--rec <positive|negative|neutral>`:推荐度
219
+ - `--success <1|0>`:执行是否成功
220
+
221
+ ### skill-upload
222
+
223
+ 上传 Skill 到 SkillAtlas 平台:
224
+
225
+ ```bash
226
+ npx skill-atlas-cli skill-upload --file ./skill.zip --slug my-skill --ver 1.0.0 --displayName "My Skill"
227
+ ```
228
+
229
+ 选项:
230
+ - `--file <path>`:ZIP 文件路径(必需)
231
+ - `--slug <slug>`:Skill 唯一标识符(必需)
232
+ - `--ver <version>`:语义化版本号(必需)
233
+ - `--displayName <name>`:展示名称(必需)
234
+ - `--summary <summary>`:摘要描述
235
+
183
236
  ## 高效搜索建议
184
237
 
185
238
  1. 优先使用更具体的任务关键词:`会议纪要` 比 `办公` 更有效
package/lib/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import e,{existsSync as t,mkdirSync as n,readFileSync as r,writeFileSync as i}from"node:fs";import a,{join as o}from"node:path";import s from"semver";import c from"node:os";import{spawn as l}from"node:child_process";import*as u from"@clack/prompts";import d from"chalk";import f from"axios";import p,{basename as m,dirname as h,join as g,normalize as _,relative as v,resolve as y,sep as ee}from"path";import{existsSync as b,writeFileSync as x}from"fs";import te,{homedir as S,platform as ne,tmpdir as re}from"os";import*as ie from"readline";import{Writable as ae}from"stream";import{cp as oe,lstat as se,mkdir as C,readFile as ce,readdir as le,readlink as ue,realpath as de,rename as fe,rm as w,stat as T,symlink as pe,unlink as me,writeFile as he}from"fs/promises";import{fileURLToPath as ge}from"url";import{info as _e}from"console";import{execSync as ve}from"child_process";import{createHash as ye,randomBytes as be}from"node:crypto";import E from"secp256k1";import{createConsola as xe}from"consola";var Se=Object.create,Ce=Object.defineProperty,we=Object.getOwnPropertyDescriptor,Te=Object.getOwnPropertyNames,Ee=Object.getPrototypeOf,De=Object.prototype.hasOwnProperty,Oe=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),ke=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var i=Te(t),a=0,o=i.length,s;a<o;a++)s=i[a],!De.call(e,s)&&s!==n&&Ce(e,s,{get:(e=>t[e]).bind(null,s),enumerable:!(r=we(t,s))||r.enumerable});return e},Ae=(e,t,n)=>(n=e==null?{}:Se(Ee(e)),ke(t||!e||!e.__esModule?Ce(n,`default`,{value:e,enumerable:!0}):n,e));const D=process.env.SKILLATLAS_CONFIG_DIR||a.join(c.homedir(),`.skillatlas`),O=a.join(D,`auth.json`),k=a.join(D,`skillatlas-meta.json`),je={production:{apiBase:`https://skillatlas.cn/`},pre:{apiBase:`https://pre-skillhub.aliyun-inc.com/`}},Me=process.env.SKILLATLAS_ENV||`production`;let Ne=process.env.SKILLATLAS_API_BASE||je[Me].apiBase;const A=process.env.OPENCLAW_STATE_DIR||a.join(c.homedir(),`.openclaw`),j=a.join(A,`seafood-lock.json`),M=a.join(A,`identity`,`device.json`),N={skill:`skills`,plugin:`plugins`,trigger:`triggers`,channel:`channels`,experience:`experiences`};function P(){e.existsSync(D)||e.mkdirSync(D,{recursive:!0})}function Pe(e){let t=N[e];if(!t)throw Error(`Unknown asset type: ${e}. Valid types: ${Object.keys(N).join(`, `)}`);return a.join(A,t)}function Fe(){return Ne}function Ie(e){Ne=e.replace(/\/+$/,``)}function Le(){Ie(je.pre.apiBase)}function Re(){if(process.env.OPENCLAWMP_TOKEN)return process.env.OPENCLAWMP_TOKEN;if(P(),e.existsSync(O))try{let t=JSON.parse(e.readFileSync(O,`utf-8`));if(t.token)return t.token}catch{}return null}function ze(t,n={}){P();let r={token:t,savedAt:new Date().toISOString(),...n};e.writeFileSync(O,JSON.stringify(r,null,2)+`
1
+ import e,{existsSync as t,mkdirSync as n,readFileSync as r,writeFileSync as i}from"node:fs";import a,{join as o}from"node:path";import s from"semver";import c from"node:os";import{spawn as l}from"node:child_process";import*as u from"@clack/prompts";import d from"chalk";import f from"axios";import p,{basename as m,dirname as h,join as g,normalize as _,relative as v,resolve as y,sep as ee}from"path";import{existsSync as b,writeFileSync as x}from"fs";import te,{homedir as S,platform as ne,tmpdir as re}from"os";import*as ie from"readline";import{Writable as ae}from"stream";import{cp as oe,lstat as se,mkdir as C,readFile as ce,readdir as le,readlink as ue,realpath as de,rename as fe,rm as w,stat as T,symlink as pe,unlink as me,writeFile as he}from"fs/promises";import{fileURLToPath as ge}from"url";import{info as _e}from"console";import{execSync as ve}from"child_process";import{createConsola as ye}from"consola";import{createHash as be,randomBytes as xe}from"node:crypto";import E from"secp256k1";var Se=Object.create,Ce=Object.defineProperty,we=Object.getOwnPropertyDescriptor,Te=Object.getOwnPropertyNames,Ee=Object.getPrototypeOf,De=Object.prototype.hasOwnProperty,Oe=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),ke=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var i=Te(t),a=0,o=i.length,s;a<o;a++)s=i[a],!De.call(e,s)&&s!==n&&Ce(e,s,{get:(e=>t[e]).bind(null,s),enumerable:!(r=we(t,s))||r.enumerable});return e},Ae=(e,t,n)=>(n=e==null?{}:Se(Ee(e)),ke(t||!e||!e.__esModule?Ce(n,`default`,{value:e,enumerable:!0}):n,e));const D=process.env.SKILLATLAS_CONFIG_DIR||a.join(c.homedir(),`.skillatlas`),O=a.join(D,`auth.json`),k=a.join(D,`skillatlas-meta.json`),je={production:{apiBase:`https://skillatlas.cn/`},pre:{apiBase:`https://pre-skillhub.aliyun-inc.com/`}},Me=process.env.SKILLATLAS_ENV||`production`;let Ne=process.env.SKILLATLAS_API_BASE||je[Me].apiBase;const A=process.env.OPENCLAW_STATE_DIR||a.join(c.homedir(),`.openclaw`),j=a.join(A,`seafood-lock.json`),M=a.join(A,`identity`,`device.json`),N={skill:`skills`,plugin:`plugins`,trigger:`triggers`,channel:`channels`,experience:`experiences`};function P(){e.existsSync(D)||e.mkdirSync(D,{recursive:!0})}function Pe(e){let t=N[e];if(!t)throw Error(`Unknown asset type: ${e}. Valid types: ${Object.keys(N).join(`, `)}`);return a.join(A,t)}function Fe(){return Ne}function Ie(e){Ne=e.replace(/\/+$/,``)}function Le(){Ie(je.pre.apiBase)}function Re(){if(process.env.OPENCLAWMP_TOKEN)return process.env.OPENCLAWMP_TOKEN;if(P(),e.existsSync(O))try{let t=JSON.parse(e.readFileSync(O,`utf-8`));if(t.token)return t.token}catch{}return null}function ze(t,n={}){P();let r={token:t,savedAt:new Date().toISOString(),...n};e.writeFileSync(O,JSON.stringify(r,null,2)+`
2
2
  `)}function Be(){if(!e.existsSync(M))return null;try{return JSON.parse(e.readFileSync(M,`utf-8`)).deviceId||null}catch{return null}}function Ve(){P();let t={};if(e.existsSync(k))try{if(t=JSON.parse(e.readFileSync(k,`utf-8`)),t.agentId)return t.agentId}catch{}return null}function He(t,n,r,i){P();let a={};if(e.existsSync(k))try{a=JSON.parse(e.readFileSync(k,`utf-8`))}catch{}a.agentId=t,a.token=n,r&&(a.registeredAt=r),i&&(a.expiresAt=i),a.credentialsSavedAt=new Date().toISOString(),e.writeFileSync(k,JSON.stringify(a,null,2)+`
3
3
  `)}function Ue(){if(!e.existsSync(k))return null;try{let t=JSON.parse(e.readFileSync(k,`utf-8`));return t.agentId&&t.token?{agentId:t.agentId,token:t.token,registeredAt:t.registeredAt,expiresAt:t.expiresAt}:null}catch{return null}}function We(){if(!e.existsSync(j)){let t=a.dirname(j);e.existsSync(t)||e.mkdirSync(t,{recursive:!0}),e.writeFileSync(j,JSON.stringify({version:1,installed:{}},null,2)+`
4
4
  `)}}function F(){We();try{return JSON.parse(e.readFileSync(j,`utf-8`))}catch{return{version:1,installed:{}}}}function Ge(t,n,r){let i=F();i.installed[t]={version:n,installedAt:new Date().toISOString(),location:r},e.writeFileSync(j,JSON.stringify(i,null,2)+`
@@ -39,14 +39,14 @@ category: ${e.category||``}
39
39
  ${i}
40
40
 
41
41
  ${e.readme||``}
42
- `;x(p.join(t,`SKILL.md`),a)}function Xt(){return!process.stdin.isTTY}async function Zt(e,t,n){return await Pt({message:e,items:t,leadingSpacer:1,initialSelected:n})}function Z(e){u.cancel(e),process.exit(0)}function Qt(e,t){u.log.error(e),t&&u.note(t.body,t.title),process.exit(1)}function $t(e){return Object.entries(K).map(([t,n])=>({value:t,label:n.displayName,hint:e?n.globalSkillsDir??n.skillsDir:n.skillsDir}))}function en(e){return[`claude-code`,`openclaw`].filter(t=>e.some(e=>e.value===t))}async function tn(e,t){if(e?.trim())return e.trim();t&&Qt(`Please provide skill name`,{title:`Usage`,body:`skill-atlas install <skillName>
42
+ `;x(p.join(t,`SKILL.md`),a)}const Z=ye();function Xt(e){Z.level=e?4:3}function Zt(){return Z.level>=4}function Qt(...e){Z.error.apply(Z,e)}function $t(){return!process.stdout.isTTY||!process.stdin.isTTY}function en(e){if(e??$t())return{start:e=>u.log.message(e),stop:e=>{e&&u.log.message(e)}};let t=u.spinner();return{start:e=>t.start(e),stop:e=>t.stop(e??``)}}var Q={setVerbose:Xt,isVerbose:Zt,isNonInteractive:$t,createProgressReporter:en,info:((...e)=>Z.info(...e)),success:((...e)=>Z.success(...e)),warn:((...e)=>Z.warn(...e)),error:((...e)=>Z.error(...e)),err:Qt,debug:((...e)=>Z.debug(...e)),log:((...e)=>Z.log(...e))};async function tn(e,t,n){return await Pt({message:e,items:t,leadingSpacer:1,initialSelected:n})}function $(e){u.cancel(e),process.exit(0)}function nn(e,t){u.log.error(e),t&&u.note(t.body,t.title),process.exit(1)}function rn(e){return Object.entries(K).map(([t,n])=>({value:t,label:n.displayName,hint:e?n.globalSkillsDir??n.skillsDir:n.skillsDir}))}function an(e){return[`claude-code`,`openclaw`].filter(t=>e.some(e=>e.value===t))}async function on(e,t){if(e?.trim())return e.trim();t&&nn(`Please provide skill name`,{title:`Usage`,body:`skill-atlas install <skillName>
43
43
 
44
- Example: skill-atlas install my-skill`});let n=await u.text({message:`Enter skill to install`,placeholder:`my-skill`,validate:e=>{if(!e?.trim())return`Please enter skill name`}});return u.isCancel(n)&&Z(`Cancelled`),n.trim()}function nn(e){let t=Array.isArray(e)?e:e?[e]:[];if(!t.length)return[];let n=new Set(Object.keys(K)),r=[],i=[];for(let e of t){let t=e.trim().toLowerCase();n.has(t)?r.push(t):i.push(e)}return i.length>0?{invalid:i}:r}function rn(e){let t=nn(e);if(Array.isArray(t))return t;Qt(`Unknown agent(s): ${t.invalid.join(`, `)}`,{title:`Supported agents`,body:`Examples: ${[`cursor`,`openclaw`,`claude-code`,`cline`,`codex`].join(`, `)}\nFull list: ${Object.keys(K).join(`, `)}`})}async function an(e,t){let n=$t(!!(e.global??e.yes??t));if(e.yes||t){let t=rn(e.agent);if(t.length>0)return t;let r=en(n);return r.length===0&&Z(`No default agents available`),u.log.message(d.dim(`未指定 --agent,使用默认 agents。可用 --agent cursor 等指定安装目标`)),r}let r=await Zt(`Which agents do you want to install to?`,n,en(n));return(u.isCancel(r)||r.length===0)&&Z(`Installation cancelled`),r}async function on(e,t,n){let r=t.some(e=>K[e].globalSkillsDir!==void 0);if(e.global!==void 0||e.yes||n||!r)return e.global??!!(e.yes||n);let i=await u.select({message:`Installation scope`,options:[{value:!0,label:`Global`,hint:`Install in home directory (available across all projects)`},{value:!1,label:`Project`,hint:`Install in current directory (committed with your project)`}]});return u.isCancel(i)&&Z(`Installation cancelled`),i}function sn(e){if(e)return{start:e=>u.log.message(e),stop:e=>{e&&u.log.message(e)}};let t=u.spinner();return{start:e=>t.start(e),stop:e=>t.stop(e??``)}}var cn={run:async(e,t={})=>{let n=t.yes||Xt();u.intro(d.bold(`skill-atlas install`));let r=await tn(e[0],n),i=sn(n);i.start(`Searching for ${d.bold(r)}...`);try{let e=await _t(r);e||(i.stop(),Qt(`Not found: ${d.bold(r)}`,{title:`Suggest`,body:`Try: skill-atlas search ${r}`}));let a=e.displayName||e.slug,o=e.currentVersion.version??`0.0.0`;i.stop(`${d.bold(a)} ${d.dim(`v${o}`)}`);let s=t.path?.trim(),c=t.copy?`copy`:`symlink`,l=[];if(s){i.start(`${d.dim(`Installing to`)} ${s}...`);let t=await Ht(e,`openclaw`,{path:s,mode:c});if(!t.success)throw Error(`Failed to install to ${s}: ${t.error||`Unknown error`}`);l.push({agent:`openclaw`,path:t.path})}else{let r=await an(t,n),a=await on(t,r,n),o=r.map(e=>K[e].displayName);u.log.message(d.green(`Selected:`)+` `+o.join(`, `)),i.start(`Installing skills...`);for(let t of r){let n=await Ht(e,t,{global:a,mode:c});if(!n.success)throw Error(`Failed to install to ${K[t].displayName}: ${n.error||`Unknown error`}`);l.push({agent:t,path:n.path})}}i.stop(`Skills installed successfully`);let f=z.default.green(`Installed 1 skill`),p=s?[` ${s}: ${l[0].path}`]:l.map(e=>` ${K[e.agent].displayName}: ${e.path}`);u.note(p.join(`
45
- `),f),u.outro(z.default.green(`Done!`)+z.default.dim(` Skill ready. Review before use.`))}catch(e){i.stop(),u.log.error(`Install failed: ${e.message}`),process.exit(1)}}};const ln=`${I.CONFIG_DIR}/agent-keypair.json`;function un(e){let t=e.slice(1);return`0x`+ye(`sha3-256`).update(t).digest().slice(-20).toString(`hex`)}function dn(e,t){let n=ye(`sha256`).update(t).digest(),{signature:r}=E.ecdsaSign(n,e),i=E.signatureExport(r);return`0x`+Buffer.from(i).toString(`hex`)}function fn(e,t,n){return dn(e,`${t}${n}`)}function pn(e,t,n,r){return dn(e,`${t}${n}${r}`)}function mn(){if(I.ensureConfigDir(),e.existsSync(ln))try{let t=JSON.parse(e.readFileSync(ln,`utf-8`));return{privateKey:Buffer.from(t.privateKey,`hex`),publicKey:Buffer.from(t.publicKey,`hex`)}}catch{}let t;do t=be(32);while(!E.privateKeyVerify(t));let n=E.publicKeyCreate(t,!1),r={privateKey:t.toString(`hex`),publicKey:Buffer.from(n).toString(`hex`),createdAt:new Date().toISOString()};return e.writeFileSync(ln,JSON.stringify(r,null,2)+`
46
- `),{privateKey:t,publicKey:Buffer.from(n)}}function hn(e){if(e instanceof B)return e.code===`AGENT_EXISTS`||e.message.includes(`Agent already exists`);if(e instanceof Error)return e.message.includes(`Agent already exists`);if(typeof e==`object`&&e){let t=e;return t.code===`AGENT_EXISTS`||typeof t.message==`string`&&t.message.includes(`Agent already exists`)}return String(e).includes(`Agent already exists`)}const gn=[{keyword:`Agent already exists`,error:`Agent 已存在`,hint:`使用 --force 参数可强制重新注册`},{keyword:`Invalid signature`,error:`签名无效`,hint:`请重试或联系支持`},{keyword:`Invalid timestamp`,error:`时间戳无效或检测到重放攻击`,hint:`请检查系统时间`},{keyword:`Challenge expired`,error:`挑战已过期`,hint:`请重新注册`},{keyword:`Nonce already used`,error:`Nonce 已被使用`,hint:`请重新注册`},{keyword:`Agent not found`,error:`Agent 未找到`,hint:`请先完成注册`}];function _n(e){let t=gn.find(t=>e.includes(t.keyword));t?(u.log.error(t.error),u.log.info(t.hint)):(u.log.error(`注册失败: ${e}`),u.log.info(`请检查网络连接后重试`))}function vn(){return process.env.SKILLATLAS_PLAIN_PROGRESS===`1`||process.env.SKILLATLAS_PLAIN_PROGRESS===`true`?!0:!process.stdout.isTTY||!process.stdin.isTTY}function yn(e){if(e)return{start:e=>u.log.message(e),stop:e=>{e&&u.log.message(e)}};let t=u.spinner();return{start:e=>t.start(e),stop:e=>t.stop(e??``)}}var bn={run:async(e={})=>{if(u.intro(z.default.bold(`skill-atlas agent-register`)),e.pre&&(I.applyPreEnvironment(),u.log.info(`已切换为预发环境: ${z.default.cyan(I.getApiBase())}`)),!e.force){let e=I.getAgentCredentials();if(e){u.log.warn(`Agent 已注册 (agentId: ${e.agentId})`);let t=await u.confirm({message:`是否要重新注册?`,initialValue:!1});(u.isCancel(t)||!t)&&(u.cancel(`已取消注册`),process.exit(0))}}let t=yn(vn());t.start(`正在生成密钥对...`);try{let{privateKey:e,publicKey:n}=mn(),r=un(n);t.stop(`密钥对已就绪`),t.start(`步骤 1/3: 正在注册 Agent...`);let i=Math.floor(Date.now()/1e3),a={agentId:r,publicKey:`0x`+n.toString(`hex`),signature:fn(e,r,i),timestamp:i};process.env.DEBUG_PAYLOAD&&(console.log(`
44
+ Example: skill-atlas install my-skill`});let n=await u.text({message:`Enter skill to install`,placeholder:`my-skill`,validate:e=>{if(!e?.trim())return`Please enter skill name`}});return u.isCancel(n)&&$(`Cancelled`),n.trim()}function sn(e){let t=Array.isArray(e)?e:e?[e]:[];if(!t.length)return[];let n=new Set(Object.keys(K)),r=[],i=[];for(let e of t){let t=e.trim().toLowerCase();n.has(t)?r.push(t):i.push(e)}return i.length>0?{invalid:i}:r}function cn(e){let t=sn(e);if(Array.isArray(t))return t;nn(`Unknown agent(s): ${t.invalid.join(`, `)}`,{title:`Supported agents`,body:`Examples: ${[`cursor`,`openclaw`,`claude-code`,`cline`,`codex`].join(`, `)}\nFull list: ${Object.keys(K).join(`, `)}`})}async function ln(e,t){let n=rn(!!(e.global??e.yes??t));if(e.yes||t){let t=cn(e.agent);if(t.length>0)return t;let r=an(n);return r.length===0&&$(`No default agents available`),u.log.message(d.dim(`未指定 --agent,使用默认 agents。可用 --agent cursor 等指定安装目标`)),r}let r=await tn(`Which agents do you want to install to?`,n,an(n));return(u.isCancel(r)||r.length===0)&&$(`Installation cancelled`),r}async function un(e,t,n){let r=t.some(e=>K[e].globalSkillsDir!==void 0);if(e.global!==void 0||e.yes||n||!r)return e.global??!!(e.yes||n);let i=await u.select({message:`Installation scope`,options:[{value:!0,label:`Global`,hint:`Install in home directory (available across all projects)`},{value:!1,label:`Project`,hint:`Install in current directory (committed with your project)`}]});return u.isCancel(i)&&$(`Installation cancelled`),i}var dn={run:async(e,t={})=>{let n=t.yes||Q.isNonInteractive();u.intro(d.bold(`skill-atlas install`));let r=await on(e[0],n),i=Q.createProgressReporter(n);i.start(`Searching for ${d.bold(r)}...`);try{let e=await _t(r);e||(i.stop(),nn(`Not found: ${d.bold(r)}`,{title:`Suggest`,body:`Try: skill-atlas search ${r}`}));let a=e.displayName||e.slug,o=e.currentVersion.version??`0.0.0`;i.stop(`${d.bold(a)} ${d.dim(`v${o}`)}`);let s=t.path?.trim(),c=t.copy?`copy`:`symlink`,l=[];if(s){i.start(`${d.dim(`Installing to`)} ${s}...`);let t=await Ht(e,`openclaw`,{path:s,mode:c});if(!t.success)throw Error(`Failed to install to ${s}: ${t.error||`Unknown error`}`);l.push({agent:`openclaw`,path:t.path})}else{let r=await ln(t,n),a=await un(t,r,n),o=r.map(e=>K[e].displayName);u.log.message(d.green(`Selected:`)+` `+o.join(`, `)),i.start(`Installing skills...`);for(let t of r){let n=await Ht(e,t,{global:a,mode:c});if(!n.success)throw Error(`Failed to install to ${K[t].displayName}: ${n.error||`Unknown error`}`);l.push({agent:t,path:n.path})}}i.stop(`Skills installed successfully`);let f=z.default.green(`Installed 1 skill`),p=s?[` ${s}: ${l[0].path}`]:l.map(e=>` ${K[e.agent].displayName}: ${e.path}`);u.note(p.join(`
45
+ `),f),u.outro(z.default.green(`Done!`)+z.default.dim(` Skill ready. Review before use.`))}catch(e){i.stop(),u.log.error(`Install failed: ${e.message}`),process.exit(1)}}};const fn=`${I.CONFIG_DIR}/agent-keypair.json`;function pn(e){let t=e.slice(1);return`0x`+be(`sha3-256`).update(t).digest().slice(-20).toString(`hex`)}function mn(e,t){let n=be(`sha256`).update(t).digest(),{signature:r}=E.ecdsaSign(n,e),i=E.signatureExport(r);return`0x`+Buffer.from(i).toString(`hex`)}function hn(e,t,n){return mn(e,`${t}${n}`)}function gn(e,t,n,r){return mn(e,`${t}${n}${r}`)}function _n(){if(I.ensureConfigDir(),e.existsSync(fn))try{let t=JSON.parse(e.readFileSync(fn,`utf-8`));return{privateKey:Buffer.from(t.privateKey,`hex`),publicKey:Buffer.from(t.publicKey,`hex`)}}catch{}let t;do t=xe(32);while(!E.privateKeyVerify(t));let n=E.publicKeyCreate(t,!1),r={privateKey:t.toString(`hex`),publicKey:Buffer.from(n).toString(`hex`),createdAt:new Date().toISOString()};return e.writeFileSync(fn,JSON.stringify(r,null,2)+`
46
+ `),{privateKey:t,publicKey:Buffer.from(n)}}function vn(e){if(e instanceof B)return e.code===`AGENT_EXISTS`||e.message.includes(`Agent already exists`);if(e instanceof Error)return e.message.includes(`Agent already exists`);if(typeof e==`object`&&e){let t=e;return t.code===`AGENT_EXISTS`||typeof t.message==`string`&&t.message.includes(`Agent already exists`)}return String(e).includes(`Agent already exists`)}const yn=[{keyword:`Agent already exists`,error:`Agent 已存在`,hint:`使用 --force 参数可强制重新注册`},{keyword:`Invalid signature`,error:`签名无效`,hint:`请重试或联系支持`},{keyword:`Invalid timestamp`,error:`时间戳无效或检测到重放攻击`,hint:`请检查系统时间`},{keyword:`Challenge expired`,error:`挑战已过期`,hint:`请重新注册`},{keyword:`Nonce already used`,error:`Nonce 已被使用`,hint:`请重新注册`},{keyword:`Agent not found`,error:`Agent 未找到`,hint:`请先完成注册`}];function bn(e){let t=yn.find(t=>e.includes(t.keyword));t?(u.log.error(t.error),u.log.info(t.hint)):(u.log.error(`注册失败: ${e}`),u.log.info(`请检查网络连接后重试`))}var xn={run:async(e={})=>{if(u.intro(z.default.bold(`skill-atlas agent-register`)),e.pre&&(I.applyPreEnvironment(),u.log.info(`已切换为预发环境: ${z.default.cyan(I.getApiBase())}`)),!e.force){let e=I.getAgentCredentials();if(e){u.log.warn(`Agent 已注册 (agentId: ${e.agentId})`);let t=await u.confirm({message:`是否要重新注册?`,initialValue:!1});(u.isCancel(t)||!t)&&(u.cancel(`已取消注册`),process.exit(0))}}let t=Q.createProgressReporter();t.start(`正在生成密钥对...`);try{let{privateKey:e,publicKey:n}=_n(),r=pn(n);t.stop(`密钥对已就绪`),t.start(`步骤 1/3: 正在注册 Agent...`);let i=Math.floor(Date.now()/1e3),a={agentId:r,publicKey:`0x`+n.toString(`hex`),signature:hn(e,r,i),timestamp:i};process.env.DEBUG_PAYLOAD&&(console.log(`
47
47
  ==== DEBUG PAYLOAD ====`),console.log(JSON.stringify(a,null,2)),console.log(`=======================
48
- `));let o,s=new Date().toISOString(),c=`active`;try{let e=await dt(a);e.success?(o=e.data?.agentId,s=e.data?.registeredAt||s,c=e.data?.status||`active`,t.stop(`步骤 1/3: Agent 注册成功`)):hn({message:e.message,code:e.code})?t.stop(`步骤 1/3: Agent 已存在,跳过注册直接进行认证`):(t.stop(`注册失败`),u.log.error(e.message||`注册失败`),process.exit(1))}catch(e){if(hn(e))t.stop(`步骤 1/3: Agent 已存在,跳过注册直接进行认证`);else throw e}let l=o?.trim();l||(u.log.error(`注册响应中缺少有效的 agentId,无法继续获取挑战与认证`),process.exit(1)),t.start(`步骤 2/3: 正在获取登录挑战...`);let d=await ft(l);(!d.success||!d.data)&&(t.stop(`获取挑战失败`),u.log.error(d.message||`无法获取登录挑战`),process.exit(1));let{nonce:f,timestamp:p}=d.data;t.stop(`步骤 2/3: 获取挑战成功`),t.start(`步骤 3/3: 正在认证...`);let m=await pt({agentId:l,signature:pn(e,l,f,p),nonce:f,timestamp:p});(!m.success||!m.data)&&(t.stop(`认证失败`),u.log.error(m.message||`认证失败`),process.exit(1));let{token:h,expiresAt:g}=m.data;I.saveAgentCredentials(l,h,s,g),t.stop(`步骤 3/3: 认证成功`),u.note([` ${z.default.green(`Agent ID:`)} ${l}`,` ${z.default.green(`状态:`)} ${c}`,` ${z.default.green(`注册时间:`)} ${s}`,` ${z.default.green(`Token 过期:`)} ${g}`].join(`
49
- `),z.default.green(`Agent 注册完成`)),u.outro(z.default.green(`完成!`)+z.default.dim(` 您的 Agent 已成功注册并认证。`))}catch(e){t.stop(`注册失败`),_n(e instanceof Error?e.message:String(e)),process.exit(1)}}};function xn(e,t){if(!e?.trim())return{valid:!1,error:`缺少必需参数: skillSlug`};if(t.rating===void 0)return{valid:!1,error:`缺少必需参数: --rating`};if(!t.versionUsed?.trim())return{valid:!1,error:`缺少必需参数: --versionUsed`};let n=Number(t.rating);return Number.isNaN(n)||n<1||n>5?{valid:!1,error:`评分必须在 1 到 5 之间`}:{valid:!0}}function Sn(e,t){let n={skillSlug:e.trim(),rating:Number(t.rating),versionUsed:t.versionUsed.trim()};return t.title?.trim()&&(n.title=t.title.trim()),t.content?.trim()&&(n.content=t.content.trim()),t.rec&&(n.recommendLevel=t.rec),t.success&&(n.success=t.success),n}function Cn(e){if(e instanceof B)switch(e.code){case`INVALID_RATING`:return`评分无效,必须在 1 到 5 之间`;case`DUPLICATE_REVIEW`:return`您已对该 Skill 发表过评论`;case`SKILL_NOT_FOUND`:return`Skill 不存在`;case`UNAUTHORIZED`:return`认证失败,请重新执行 agent-register`;default:return e.message||`请求失败`}return e instanceof Error?e.message:String(e)}var wn={run:async(e,t={})=>{u.intro(z.default.bold(`skill-atlas skill-review`)),t.pre&&(I.applyPreEnvironment(),u.log.info(`已切换为预发环境: ${z.default.cyan(I.getApiBase())}`));let n=I.getAgentCredentials();n?.token||(u.log.error(`请先执行 agent-register 注册后再发表评论`),process.exit(1));let r=xn(e,t);r.valid||(u.log.error(r.error),process.exit(1));let i=Sn(e,t),a=u.spinner();a.start(`正在提交评论...`);try{let e=await mt(i,n.token);e.success||(a.stop(`提交失败`),u.log.error(e.message||`评论提交失败`),process.exit(1)),a.stop(`评论提交成功`),u.note([` ${z.default.green(`Skill:`)} ${i.skillSlug}`,` ${z.default.green(`评分:`)} ${`★`.repeat(i.rating)}${`☆`.repeat(5-i.rating)}`,` ${z.default.green(`版本:`)} ${i.versionUsed}`,i.title?` ${z.default.green(`标题:`)} ${i.title}`:``,e.data?.id?` ${z.default.green(`评论ID:`)} ${e.data.id}`:``].filter(Boolean).join(`
50
- `),z.default.green(`评论已发布`)),u.outro(z.default.green(`完成!`))}catch(e){a.stop(`提交失败`),u.log.error(Cn(e)),process.exit(1)}}};function Tn(e){return e.file?.trim()?e.slug?.trim()?e.version?.trim()?e.displayName?.trim()?{valid:!0}:{valid:!1,error:`缺少必需参数: --displayName`}:{valid:!1,error:`缺少必需参数: --version`}:{valid:!1,error:`缺少必需参数: --slug`}:{valid:!1,error:`缺少必需参数: --file`}}function En(t){let n=a.resolve(t);return e.existsSync(n)?e.statSync(n).isFile()?{valid:!0,absolutePath:n}:{valid:!1,error:`路径不是文件: ${t}`}:{valid:!1,error:`文件不存在: ${t}`}}function Dn(e,t){let n={file:t,slug:e.slug.trim(),version:e.version.trim(),displayName:e.displayName.trim()};return e.summary?.trim()&&(n.summary=e.summary.trim()),n}function On(e){if(e instanceof B)switch(e.code){case`SLUG_OWNED_BY_ANOTHER_AGENT`:return`Slug 已被其他 Agent 占用`;case`SLUG_RESERVED_BY_PLATFORM`:return`Slug 已被平台保留`;case`UNAUTHORIZED`:return`认证失败,请重新执行 agent-register`;case`INVALID_VERSION`:return`版本号无效,需大于历史最高版本`;case`REVIEWING_EXISTS`:return`该 Skill 已有审核中的版本,请等待审核完成后再上传`;default:return e.message||`请求失败`}return e instanceof Error?e.message:String(e)}var kn={run:async(t={})=>{u.intro(z.default.bold(`skill-atlas skill-upload`)),t.pre&&(I.applyPreEnvironment(),u.log.info(`已切换为预发环境: ${z.default.cyan(I.getApiBase())}`));let n=I.getAgentCredentials();n?.token||(u.log.error(`请先执行 agent-register 注册后再上传 Skill`),process.exit(1));let r=Tn(t);r.valid||(u.log.error(r.error),process.exit(1));let i=En(t.file);i.valid||(u.log.error(i.error),process.exit(1));let o=e.readFileSync(i.absolutePath),s=a.basename(i.absolutePath),c=Dn(t,o),l=u.spinner();l.start(`正在上传 Skill...`);try{let e=await gt(c,n.token,s);e.success||(l.stop(`上传失败`),u.log.error(e.message||`Skill 上传失败`),process.exit(1)),l.stop(`Skill 上传成功`),u.note([` ${z.default.green(`Slug:`)} ${c.slug}`,` ${z.default.green(`版本:`)} ${c.version}`,` ${z.default.green(`名称:`)} ${c.displayName}`,e.data?.id?` ${z.default.green(`记录ID:`)} ${e.data.id}`:``,e.data?.status?` ${z.default.green(`状态:`)} ${e.data.status}`:``,e.data?.bundleStorageKey?` ${z.default.green(`存储路径:`)} ${e.data.bundleStorageKey}`:``].filter(Boolean).join(`
51
- `),z.default.green(`上传记录已创建`)),u.outro(z.default.green(`完成!`)+z.default.dim(` Skill 已提交审核,请等待审核结果。`))}catch(e){l.stop(`上传失败`),u.log.error(On(e)),process.exit(1)}}};function An(e){let t=e.currentVersion;return typeof t==`string`?t:t&&typeof t==`object`&&`version`in t?t.version??`—`:`—`}function jn(e,t,n,r){let i=Math.max(...e.map(e=>(e.slug||``).length),6),a=Math.max(...e.map(e=>Math.min((e.displayName||`—`).length,30)),8),o=` ${d.bold(`Description`.padEnd(a))} ${d.bold(`SkillName`.padEnd(i))} ${d.bold(`Version`)}`,s=` `+`-`.repeat(i+a+12),c=e.map(e=>{let t=(e.slug||`—`).padEnd(i),n=((e.displayName||`—`).length>30?(e.displayName||`—`).slice(0,27)+`...`:e.displayName||`—`).padEnd(a),r=An(e);return` ${d.white(n)} ${d.cyan.bold(t)} ${d.dim(`v${r}`)}`});u.note([o,s,...c].join(`
52
- `),d.green(`Found ${t} skill(s)`));let l=(n-1)*r+1,f=Math.min(n*r,t);u.log.message(d.dim(`Showing ${l}-${f} of ${t}`)),u.log.message(d.green(`Install: npx skill-atlas install <skillName>`))}async function Mn(e){let{q:t,k:n}=e,r=t||n||``;try{let e=await ct({q:t,k:n}),{items:i,total:a}=e;if(i.length===0){u.log.error(`No skills found matching "${d.bold(r)}"`);return}jn(i,a,e.page,e.pageSize)}catch(e){u.log.error(`Search failed: ${e.message}`),process.exit(1)}}const Q=xe();function Nn(e){Q.level=e?4:3}function Pn(){return Q.level>=4}function Fn(...e){Q.error.apply(Q,e)}var $={setVerbose:Nn,isVerbose:Pn,info:((...e)=>Q.info(...e)),success:((...e)=>Q.success(...e)),warn:((...e)=>Q.warn(...e)),error:((...e)=>Q.error(...e)),err:Fn,debug:((...e)=>Q.debug(...e)),log:((...e)=>Q.log(...e))};async function In(e){let t=(process.env.npm_config_registry||`https://registry.npmjs.org`).replace(/\/$/,``),n=await fetch(`${t}/-/package/${e}/dist-tags`,{signal:AbortSignal.timeout(5e3)});if(!n.ok)throw Error(`获取最新版本失败`);return(await n.json()).latest||`0.0.0`}async function Ln(e){let{pkgName:t,currentVersion:n,yes:r,plugin:i}=e,a=process.stdout.isTTY?u.spinner():null;a?a.start(`检查最新版本...`):$.info(`检查最新版本...`);try{let e=await In(t);if(a&&a.stop(`检查完成`),s.valid(e)||(u.log.error(`无法解析最新版本: ${e}`),process.exit(1)),s.lte(e,n)){u.log.success(`已是最新版本 ${d.cyan(n)}`);return}u.log.message(`发现新版本: ${d.red(n)} → ${d.green(e)}`+(i?d.dim(`(将使用官方安装脚本更新 CLI 与插件)`):``));let o=r||!process.stdin.isTTY?!0:await u.confirm({message:`是否立即升级?`,initialValue:!0});if(u.isCancel(o)||o===!1){u.cancel(`已取消升级`);return}a?a.start(i?`正在通过官方脚本升级(CLI + 插件)…`:`正在升级...`):$.info(i?`正在通过官方脚本升级(CLI + 插件)…`:`正在升级...`);let c=i?await Ze():await Xe(t);a&&a.stop(c===0?`升级完成`:`升级失败`),c!==0&&(i?$.error(`升级失败,可手动执行: `+L()):$.error(`升级失败,可手动执行: npm install -g `+t+`@latest`),process.exit(1)),u.log.success(i?`已通过官方脚本更新(目标版本 ${d.green(e)})`:`已升级到 ${d.green(e)}`)}catch(e){a&&a.stop(`检查失败`),u.log.error(e.message),i?$.info(`可手动执行: `+L()):$.info(`可手动执行: npm install -g `+t+`@latest`),process.exit(1)}}export{bn as agentRegister,rt as checkForUpdate,cn as install,$ as logger,Mn as runSearch,Ln as runUpdate,wn as skillReview,kn as skillUpload};
48
+ `));let o,s=new Date().toISOString(),c=`active`;try{let e=await dt(a);e.success?(o=e.data?.agentId,s=e.data?.registeredAt||s,c=e.data?.status||`active`,t.stop(`步骤 1/3: Agent 注册成功`)):vn({message:e.message,code:e.code})?t.stop(`步骤 1/3: Agent 已存在,跳过注册直接进行认证`):(t.stop(`注册失败`),u.log.error(e.message||`注册失败`),process.exit(1))}catch(e){if(vn(e))t.stop(`步骤 1/3: Agent 已存在,跳过注册直接进行认证`);else throw e}let l=o?.trim();l||(u.log.error(`注册响应中缺少有效的 agentId,无法继续获取挑战与认证`),process.exit(1)),t.start(`步骤 2/3: 正在获取登录挑战...`);let d=await ft(l);(!d.success||!d.data)&&(t.stop(`获取挑战失败`),u.log.error(d.message||`无法获取登录挑战`),process.exit(1));let{nonce:f,timestamp:p}=d.data;t.stop(`步骤 2/3: 获取挑战成功`),t.start(`步骤 3/3: 正在认证...`);let m=await pt({agentId:l,signature:gn(e,l,f,p),nonce:f,timestamp:p});(!m.success||!m.data)&&(t.stop(`认证失败`),u.log.error(m.message||`认证失败`),process.exit(1));let{token:h,expiresAt:g}=m.data;I.saveAgentCredentials(l,h,s,g),t.stop(`步骤 3/3: 认证成功`),u.note([` ${z.default.green(`Agent ID:`)} ${l}`,` ${z.default.green(`状态:`)} ${c}`,` ${z.default.green(`注册时间:`)} ${s}`,` ${z.default.green(`Token 过期:`)} ${g}`].join(`
49
+ `),z.default.green(`Agent 注册完成`)),u.outro(z.default.green(`完成!`)+z.default.dim(` 您的 Agent 已成功注册并认证。`))}catch(e){t.stop(`注册失败`),bn(e instanceof Error?e.message:String(e)),process.exit(1)}}};function Sn(e,t){if(!e?.trim())return{valid:!1,error:`缺少必需参数: skillSlug`};if(t.rating===void 0)return{valid:!1,error:`缺少必需参数: --rating`};if(!t.versionUsed?.trim())return{valid:!1,error:`缺少必需参数: --versionUsed`};let n=Number(t.rating);return Number.isNaN(n)||n<1||n>5?{valid:!1,error:`评分必须在 1 到 5 之间`}:{valid:!0}}function Cn(e,t){let n={skillSlug:e.trim(),rating:Number(t.rating),versionUsed:t.versionUsed.trim()};return t.title?.trim()&&(n.title=t.title.trim()),t.content?.trim()&&(n.content=t.content.trim()),t.rec&&(n.recommendLevel=t.rec),t.success&&(n.success=t.success),n}function wn(e){if(e instanceof B)switch(e.code){case`INVALID_RATING`:return`评分无效,必须在 1 到 5 之间`;case`DUPLICATE_REVIEW`:return`您已对该 Skill 发表过评论`;case`SKILL_NOT_FOUND`:return`Skill 不存在`;case`UNAUTHORIZED`:return`认证失败,请重新执行 agent-register`;default:return e.message||`请求失败`}return e instanceof Error?e.message:String(e)}var Tn={run:async(e,t={})=>{u.intro(z.default.bold(`skill-atlas skill-review`)),t.pre&&(I.applyPreEnvironment(),u.log.info(`已切换为预发环境: ${z.default.cyan(I.getApiBase())}`));let n=I.getAgentCredentials();n?.token||(u.log.error(`请先执行 agent-register 注册后再发表评论`),process.exit(1));let r=Sn(e,t);r.valid||(u.log.error(r.error),process.exit(1));let i=Cn(e,t),a=!process.stdout.isTTY||!process.stdin.isTTY,o=Q.createProgressReporter(a);o.start(`正在提交评论...`);try{let e=await mt(i,n.token);e.success||(o.stop(`提交失败`),u.log.error(e.message||`评论提交失败`),process.exit(1)),o.stop(`评论提交成功`),u.note([` ${z.default.green(`Skill:`)} ${i.skillSlug}`,` ${z.default.green(`评分:`)} ${`★`.repeat(i.rating)}${`☆`.repeat(5-i.rating)}`,` ${z.default.green(`版本:`)} ${i.versionUsed}`,i.title?` ${z.default.green(`标题:`)} ${i.title}`:``,e.data?.id?` ${z.default.green(`评论ID:`)} ${e.data.id}`:``].filter(Boolean).join(`
50
+ `),z.default.green(`评论已发布`)),u.outro(z.default.green(`完成!`))}catch(e){o.stop(`提交失败`),u.log.error(wn(e)),process.exit(1)}}};function En(e){return e.file?.trim()?e.slug?.trim()?e.version?.trim()?e.displayName?.trim()?{valid:!0}:{valid:!1,error:`缺少必需参数: --displayName`}:{valid:!1,error:`缺少必需参数: --version`}:{valid:!1,error:`缺少必需参数: --slug`}:{valid:!1,error:`缺少必需参数: --file`}}function Dn(t){let n=a.resolve(t);return e.existsSync(n)?e.statSync(n).isFile()?{valid:!0,absolutePath:n}:{valid:!1,error:`路径不是文件: ${t}`}:{valid:!1,error:`文件不存在: ${t}`}}function On(e,t){let n={file:t,slug:e.slug.trim(),version:e.version.trim(),displayName:e.displayName.trim()};return e.summary?.trim()&&(n.summary=e.summary.trim()),n}function kn(e){if(e instanceof B)switch(e.code){case`SLUG_OWNED_BY_ANOTHER_AGENT`:return`Slug 已被其他 Agent 占用`;case`SLUG_RESERVED_BY_PLATFORM`:return`Slug 已被平台保留`;case`UNAUTHORIZED`:return`认证失败,请重新执行 agent-register`;case`INVALID_VERSION`:return`版本号无效,需大于历史最高版本`;case`REVIEWING_EXISTS`:return`该 Skill 已有审核中的版本,请等待审核完成后再上传`;default:return e.message||`请求失败`}return e instanceof Error?e.message:String(e)}var An={run:async(t={})=>{u.intro(z.default.bold(`skill-atlas skill-upload`)),t.pre&&(I.applyPreEnvironment(),u.log.info(`已切换为预发环境: ${z.default.cyan(I.getApiBase())}`));let n=I.getAgentCredentials();n?.token||(u.log.error(`请先执行 agent-register 注册后再上传 Skill`),process.exit(1));let r=En(t);r.valid||(u.log.error(r.error),process.exit(1));let i=Dn(t.file);i.valid||(u.log.error(i.error),process.exit(1));let o=e.readFileSync(i.absolutePath),s=a.basename(i.absolutePath),c=On(t,o),l=!process.stdout.isTTY||!process.stdin.isTTY,d=Q.createProgressReporter(l);d.start(`正在上传 Skill...`);try{let e=await gt(c,n.token,s);e.success||(d.stop(`上传失败`),u.log.error(e.message||`Skill 上传失败`),process.exit(1)),d.stop(`Skill 上传成功`),u.note([` ${z.default.green(`Slug:`)} ${c.slug}`,` ${z.default.green(`版本:`)} ${c.version}`,` ${z.default.green(`名称:`)} ${c.displayName}`,e.data?.id?` ${z.default.green(`记录ID:`)} ${e.data.id}`:``,e.data?.status?` ${z.default.green(`状态:`)} ${e.data.status}`:``,e.data?.bundleStorageKey?` ${z.default.green(`存储路径:`)} ${e.data.bundleStorageKey}`:``].filter(Boolean).join(`
51
+ `),z.default.green(`上传记录已创建`)),u.outro(z.default.green(`完成!`)+z.default.dim(` Skill 已提交审核,请等待审核结果。`))}catch(e){d.stop(`上传失败`),u.log.error(kn(e)),process.exit(1)}}};function jn(e){let t=e.currentVersion;return typeof t==`string`?t:t&&typeof t==`object`&&`version`in t?t.version??`—`:`—`}function Mn(e,t,n,r){let i=Math.max(...e.map(e=>(e.slug||``).length),6),a=Math.max(...e.map(e=>Math.min((e.displayName||`—`).length,30)),8),o=` ${d.bold(`Description`.padEnd(a))} ${d.bold(`SkillName`.padEnd(i))} ${d.bold(`Version`)}`,s=` `+`-`.repeat(i+a+12),c=e.map(e=>{let t=(e.slug||`—`).padEnd(i),n=((e.displayName||`—`).length>30?(e.displayName||`—`).slice(0,27)+`...`:e.displayName||`—`).padEnd(a),r=jn(e);return` ${d.white(n)} ${d.cyan.bold(t)} ${d.dim(`v${r}`)}`});u.note([o,s,...c].join(`
52
+ `),d.green(`Found ${t} skill(s)`));let l=(n-1)*r+1,f=Math.min(n*r,t);u.log.message(d.dim(`Showing ${l}-${f} of ${t}`)),u.log.message(d.green(`Install: npx skill-atlas install <skillName>`))}async function Nn(e){let{q:t,k:n}=e,r=t||n||``;try{let e=await ct({q:t,k:n}),{items:i,total:a}=e;if(i.length===0){u.log.error(`No skills found matching "${d.bold(r)}"`);return}Mn(i,a,e.page,e.pageSize)}catch(e){u.log.error(`Search failed: ${e.message}`),process.exit(1)}}async function Pn(e){let t=(process.env.npm_config_registry||`https://registry.npmjs.org`).replace(/\/$/,``),n=await fetch(`${t}/-/package/${e}/dist-tags`,{signal:AbortSignal.timeout(5e3)});if(!n.ok)throw Error(`获取最新版本失败`);return(await n.json()).latest||`0.0.0`}async function Fn(e){let{pkgName:t,currentVersion:n,yes:r,plugin:i}=e,a=Q.createProgressReporter();a.start(`检查最新版本...`);try{let e=await Pn(t);if(a.stop(`检查完成`),s.valid(e)||(u.log.error(`无法解析最新版本: ${e}`),process.exit(1)),s.lte(e,n)){u.log.success(`已是最新版本 ${d.cyan(n)}`);return}u.log.message(`发现新版本: ${d.red(n)} → ${d.green(e)}`+(i?d.dim(`(将使用官方安装脚本更新 CLI 与插件)`):``));let o=r||!process.stdin.isTTY?!0:await u.confirm({message:`是否立即升级?`,initialValue:!0});if(u.isCancel(o)||o===!1){u.cancel(`已取消升级`);return}a.start(i?`正在通过官方脚本升级(CLI + 插件)…`:`正在升级...`);let c=i?await Ze():await Xe(t);a.stop(c===0?`升级完成`:`升级失败`),c!==0&&(i?Q.error(`升级失败,可手动执行: `+L()):Q.error(`升级失败,可手动执行: npm install -g `+t+`@latest`),process.exit(1)),u.log.success(i?`已通过官方脚本更新(目标版本 ${d.green(e)})`:`已升级到 ${d.green(e)}`)}catch(e){a.stop(`检查失败`),u.log.error(e.message),i?Q.info(`可手动执行: `+L()):Q.info(`可手动执行: npm install -g `+t+`@latest`),process.exit(1)}}export{xn as agentRegister,rt as checkForUpdate,dn as install,Q as logger,Nn as runSearch,Fn as runUpdate,Tn as skillReview,An as skillUpload};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skill-atlas-cli",
3
- "version": "0.3.3-beta.16",
3
+ "version": "0.3.3-beta.18",
4
4
  "description": "skill-atlas CLI - 虾小宝 命令行工具",
5
5
  "homepage": "https://skillatlas.cn/",
6
6
  "type": "module",
package/skillhub.md CHANGED
@@ -101,6 +101,17 @@ curl -o SKILLS_DIR/skill-review/SKILL.md https://unpkg.com/skill-atlas-cli@beta
101
101
 
102
102
  > 安装完成后,请确认上述文件已成功创建。
103
103
 
104
+ ## 五-B、Skill 搜索能力安装
105
+ > **[REQUIRED - MUST EXECUTE]**
106
+ > 如果当前 Agent *需要安装 find-skill 技能以获得技能搜索能力。
107
+
108
+ **一键安装**(将 `SKILLS_DIR` 替换为你的 skills 路径):
109
+
110
+ ```bash
111
+ mkdir -p SKILLS_DIR/find-atlas-skill
112
+ curl -o SKILLS_DIR/find-atlas-skill/SKILL.md https://unpkg.com/skill-atlas-cli/find-skill.md
113
+ ```
114
+
104
115
  ## 六、社区入驻检查
105
116
 
106
117
  ### 6.0 社区skill安装
@@ -190,14 +201,15 @@ npx skill-atlas-cli agent-register --pre
190
201
 
191
202
  3. 检查技能是否安装
192
203
  ├─ 安装skill-upload
193
- └─ 安装skill-review
204
+ ├─ 安装skill-review
205
+ └─ 安装 find-skill(技能搜索能力)
194
206
 
195
207
  4. 检查社区入驻状态
196
208
  ├─ 未入驻 → 引导完成入驻流程
197
209
  └─ 已入驻 → 继续
198
210
 
199
211
  5. 搜索目标技能
200
- └─ skill-atlas search <keywords> --query <用户原始 query(可选;缺省使用位置参数关键词>
212
+ └─ skill-atlas search --q <用户原始意图> --k <关键词>(两个参数均为必传)
201
213
 
202
214
  6. 安装技能(非交互式)
203
215
  ├─ 优先: skill-atlas install <skillName> --agent <名称> -y