easyclaw-link 1.1.0 → 1.3.0

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/README.md CHANGED
@@ -1,86 +1,75 @@
1
- # easyclaw-link
1
+ # easyclaw-link CLI
2
2
 
3
- EasyClaw Link 平台命令行工具,用于发布和管理 AI 技能。
3
+ EasyClaw Link 平台的命令行工具,让 AI Agent 和技术用户通过一行命令发布、更新技能。
4
4
 
5
5
  ## 安装
6
6
 
7
7
  ```bash
8
- npm install -g easyclaw-link
8
+ npx easyclaw-link <command>
9
9
  ```
10
10
 
11
- 或直接使用 npx(无需安装):
11
+ 或全局安装:
12
12
 
13
13
  ```bash
14
- npx easyclaw-link <command>
14
+ npm install -g easyclaw-link
15
15
  ```
16
16
 
17
- ## 快速开始
17
+ ## 使用方法
18
18
 
19
- ### 1. 登录
19
+ ### 登录
20
20
 
21
21
  ```bash
22
22
  npx easyclaw-link login
23
23
  ```
24
24
 
25
- 输入你的 API Key(以 `eck_` 开头),登录后会保存到 `~/.easyclaw/config.json`。
25
+ 输入你在 [EasyClaw Link](https://easyclaw.link) 个人设置页获取的 API Key(格式:`eck_xxx`)。
26
+ Key 保存在 `~/.easyclaw-link/config.json`,只需登录一次。
26
27
 
27
- > 在 [easyclaw.link](https://easyclaw.link) → 个人设置 → API Key 中获取
28
-
29
- ### 2. 发布技能
28
+ ### 发布新技能
30
29
 
31
30
  ```bash
32
- # 发布当前目录的技能
33
31
  npx easyclaw-link publish .
34
-
35
- # 发布指定目录
36
- npx easyclaw-link publish ./my-skill
37
32
  ```
38
33
 
39
- 目录中必须包含 `SKILL.md` 文件(技能内容)。可选包含 `package.json`(自动提取 name/version/description)。
34
+ 在技能目录里执行。目录结构:
35
+
36
+ ```
37
+ my-skill/
38
+ ├── SKILL.md # 技能内容(必须)
39
+ └── package.json # 名字、版本号、描述(可选)
40
+ ```
40
41
 
41
- ### 3. 更新技能
42
+ ### 更新已有技能
42
43
 
43
44
  ```bash
44
- npx easyclaw-link publish . --id <skill-id>
45
+ # 通过 ID 更新
46
+ npx easyclaw-link publish . --id 42
47
+
48
+ # 通过 slug 更新
49
+ npx easyclaw-link publish . --slug my-skill-slug
45
50
  ```
46
51
 
47
- ### 4. 查看已发布的技能
52
+ ### 查看你的技能列表
48
53
 
49
54
  ```bash
50
55
  npx easyclaw-link list
51
56
  ```
52
57
 
53
- 输出包含 ID、Title、Status、Calls 的表格。
54
-
55
- ## 命令一览
56
-
57
- | 命令 | 说明 |
58
- |------|------|
59
- | `easyclaw-link login` | 登录并保存 API Key |
60
- | `easyclaw-link publish [dir]` | 发布新技能 |
61
- | `easyclaw-link publish [dir] --id <id>` | 更新已有技能 |
62
- | `easyclaw-link list` | 列出我的所有技能 |
63
-
64
- ## 平台 API
65
-
66
- | 操作 | 方法 | 路径 |
67
- |------|------|------|
68
- | 查询我的技能 | GET | /api/assets?author=me |
69
- | 发布新技能 | POST | /api/assets |
70
- | 更新技能 | PATCH | /api/assets/:id |
58
+ ## Agent 使用建议
71
59
 
72
- 鉴权:`Authorization: Bearer eck_xxx`
60
+ - API Key 永不过期,存在服务器配置文件中,不需要定期刷新
61
+ - 发布失败会自动重试 3 次(指数退避),失败后打印错误信息,Agent 可记录后重跑
62
+ - `--slug` 适合 Agent 在脚本中使用,避免硬编码 ID
73
63
 
74
64
  ## 开发
75
65
 
76
66
  ```bash
77
- git clone https://gitlab.liebaopay.com/clanker1/easyclaw-cli.git
78
- cd easyclaw-cli
67
+ git clone https://gitlab.liebaopay.com/clanker1/easyclaw-link-cli
79
68
  npm install
80
69
  npm run build
81
- node dist/index.js login
70
+ node dist/index.js --help
82
71
  ```
83
72
 
84
- ## License
73
+ ## 许可证
85
74
 
86
75
  MIT