aixxai 1.5.0 → 1.5.1

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.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/templates/references/apps.md +199 -208
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aixxai",
3
- "version": "1.5.0",
3
+ "version": "1.5.1",
4
4
  "description": "AIXX CLI - 让你的AI调用万物。安装：npx aixxai install",
5
5
  "type": "module",
6
6
  "bin": {
package/templates/references/apps.md CHANGED
@@ -1,208 +1,199 @@
1
- # 应用层能力（10个应用直连）
2
-
3
- 让你的AI直接替用户操作真实应用：往钉钉/飞书/企微群发消息、发邮件、建GitHub Issue、推送到微信/iPhone/Discord/Slack。
4
-
5
- **先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和错误处理。**
6
-
7
- ---
8
-
9
- ## 订阅制（统一价格）
10
-
11
- - **¥2.99/月，全部10个应用不限次使用**（不是每个应用单独买）
12
- - 购买：调下单接口，`plan` 固定传 `app_monthly`：
13
- ```bash
14
- curl -X POST http://14.103.27.195/v1/capability/{id}/purchase \
15
- -H "Content-Type: application/json" \
16
- -d '{"plan": "app_monthly", "user_compute_key": "sk-用户的key"}'
17
- ```
18
- 返回支付链接（`pay_url`），给用户打开付款即可，付完即生效。
19
-
20
- ## 执行（所有应用统一格式）
21
-
22
- ```bash
23
- curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
24
- -H "Content-Type: application/json" \
25
- -d '{
26
- "params": { "参数": "值" },
27
- "user_compute_key": "sk-用户的key"
28
- }'
29
- ```
30
-
31
- 能力层地址：`http://14.103.27.195/v1`（和LLM对话的 `{AIXX_BASE_URL}` 不是同一个入口）。
32
-
33
- ---
34
-
35
- ## 10个应用能力清单
36
-
37
- > 带 `*` 的是必填参数，其余可选。
38
-
39
- ### 1. 钉钉群消息推送（`app-dingtalk-group-send`）
40
- 往钉钉群发消息（通知/日报/告警），支持加签和@人。
41
-
42
- > ⚠️ **webhook链接不要用浏览器打开测试（会报 `errcode:43002 需要POST请求`），直接交给agent调用即可验证。** webhook只接受POST，浏览器地址栏是GET请求，报43002不代表配置有问题。
43
-
44
- | 参数 | 必填 | 说明 |
45
- |---|---|---|
46
- | `webhook` | * | 群里创建"自定义机器人"得到的webhook地址（https://开头） |
47
- | `secret` | | 机器人安全设置选了"加签"时填密钥，没选就不填 |
48
- | `message` | * | 要发送的文本内容 |
49
- | `at_mobiles` | | 要@的手机号列表（数组） |
50
- | `at_all` | | 是否@所有人（true/false） |
51
-
52
- **配置指引（用户操作）**：
53
- 1. 打开钉钉目标群 → 右上角"⋯" → 机器人 → 添加机器人 → 选"自定义（通过Webhook接入）"
54
- 2. 名字随便填 → 安全设置勾选"加签" → 完成
55
- 3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，同一页的**密钥**填 `secret`
56
- 4. ⚠️ webhook别用浏览器打开测试（浏览器是GET，钉钉报 `errcode:43002`，不代表配置错了），直接让agent调用验证
57
-
58
- ### 2. 飞书群消息推送（`app-feishu-group-send`）
59
- 往飞书群发消息，支持加签和@所有人。
60
- | 参数 | 必填 | 说明 |
61
- |---|---|---|
62
- | `webhook` | * | 群里创建"自定义机器人"得到的webhook地址 |
63
- | `secret` | | 选了"加签"时填密钥 |
64
- | `message` | * | 要发送的文本内容 |
65
- | `at_all` | | 是否@所有人（true/false） |
66
-
67
- **配置指引（用户操作）**：
68
- 1. 打开飞书目标群 → 右上角"⋯" → 设置 → 群机器人 → 添加机器人 → 选"自定义机器人"
69
- 2. 名字随便填 → 权限默认 → 安全设置选"签名校验" → 完成
70
- 3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，**签名密钥**填 `secret`
71
- 4. ⚠️ webhook别用浏览器打开测试（GET请求会被拒），直接让agent调用验证
72
-
73
- ### 3. 企微群消息推送（`app-wecom-group-send`）
74
- 往企业微信群发消息，可@指定成员。
75
- | 参数 | 必填 | 说明 |
76
- |---|---|---|
77
- | `webhook` | * | 群里创建"群机器人"得到的webhook地址 |
78
- | `secret` | | 选了"加签"时填密钥 |
79
- | `message` | * | 要发送的文本内容 |
80
- | `at_mobiles` | | 要@的手机号列表（数组） |
81
- | `at_all` | | 是否@所有人（true/false） |
82
-
83
- **配置指引（用户操作）**：
84
- 1. 打开企业微信目标群 → 右上角"⋯" → 添加群机器人 → 新建
85
- 2. 名字随便填 → 复制 **Webhook地址** 填 `webhook`
86
- 3. 企微群机器人不支持加签，`secret` 不用填
87
- 4. ⚠️ webhook别用浏览器打开测试（会报错），直接让agent调用验证
88
-
89
- ### 4. 邮件发送（`app-email-send`）
90
- 通过任意SMTP邮箱发正式邮件（QQ邮箱/163/Gmail/企业邮箱都行）。
91
- | 参数 | 必填 | 说明 |
92
- |---|---|---|
93
- | `smtp_host` | * | SMTP服务器（QQ邮箱 smtp.qq.com / 163 smtp.163.com / Gmail smtp.gmail.com） |
94
- | `smtp_port` | | SSL填465，STARTTLS填587（默认465） |
95
- | `username` | * | 发件邮箱账号（如 xxx@qq.com） |
96
- | `password` | * | 邮箱**授权码**（不是登录密码！邮箱设置-账户里开通SMTP时获取） |
97
- | `to` | * | 收件人邮箱 |
98
- | `subject` | | 邮件主题（默认"AIXX邮件"） |
99
- | `message` | * | 邮件正文 |
100
-
101
- **配置指引（拿授权码）**：`password`填授权码，不是邮箱登录密码！
102
- - **QQ邮箱**：网页版 → 设置 → 账户 → 开启"POP3/IMAP/SMTP服务" → 短信验证 → 得到16位授权码
103
- - **163邮箱**：设置 → POP3/SMTP/IMAP → 开启SMTP → 设置"客户端授权密码"
104
- - **Gmail**：Google账号 → 安全性 → 开两步验证 → 应用专用密码 → 生成
105
-
106
- ### 5. GitHub建Issue（`app-github-create-issue`）
107
- 在你的GitHub仓库建Issue（记bug/提需求/记待办）。
108
- | 参数 | 必填 | 说明 |
109
- |---|---|---|
110
- | `token` | * | Personal Access Token（GitHub → Settings → Developer settings → Tokens创建，勾repo权限） |
111
- | `repo` | * | 仓库名，owner/repo格式（如 octocat/hello-world） |
112
- | `title` | * | Issue标题 |
113
- | `body` | | Issue正文 |
114
-
115
- **配置指引（拿token）**：
116
- 1. 登录 github.com → 右上角头像 → Settings → 左侧最底 Developer settings
117
- 2. Personal access tokens → Tokens (classic) → Generate new token
118
- 3. 勾选 **repo** 权限 → 生成 → 立刻复制token（只显示这一次，关页面就看不到了）
119
-
120
- ### 6. Server酱微信推送（`app-serverchan-wechat-push`）
121
- 把消息直接推到用户微信（sct.ftqq.com微信扫码拿SendKey）。
122
- | 参数 | 必填 | 说明 |
123
- |---|---|---|
124
- | `sendkey` | * | SendKey（sct.ftqq.com微信扫码登录后获取，SCT开头） |
125
- | `title` | | 消息标题（默认"AIXX消息"） |
126
- | `message` | * | 消息内容（支持Markdown） |
127
-
128
- **配置指引（拿SendKey）**：
129
- 1. 打开 **sct.ftqq.com** → 微信扫码登录
130
- 2. 首页就能看到 **SendKey**（SCT开头），复制填 `sendkey`
131
- 3. 免费账户每天限5条消息，第二天自动重置；不够用可升级额度
132
-
133
- ### 7. PushPlus微信推送（`app-pushplus-wechat-push`）
134
- 消息推到微信公众号（pushplus.plus微信登录拿token）。
135
- | 参数 | 必填 | 说明 |
136
- |---|---|---|
137
- | `token` | * | token（pushplus.plus微信登录后，"一对一推送"页复制） |
138
- | `title` | | 消息标题 |
139
- | `message` | * | 消息内容 |
140
-
141
- **配置指引（拿token）**：
142
- 1. 打开 **pushplus.plus** → 微信扫码登录
143
- 2. 左侧菜单"一对一推送" → 页面上的 **token**（32位）复制填 `token`
144
- 3. 关注它的微信公众号才能收到推送（页面上有二维码）
145
-
146
- ### 8. Bark苹果推送（`app-bark-ios-push`）
147
- 推送通知到iPhone（App Store装Bark App）。
148
- | 参数 | 必填 | 说明 |
149
- |---|---|---|
150
- | `key` | * | 设备Key（打开Bark App首页直接复制那一串） |
151
- | `server` | | Bark服务地址（默认官方，自建服务填自己的） |
152
- | `title` | | 通知标题 |
153
- | `message` | * | 通知内容 |
154
-
155
- **配置指引（拿Key）**：
156
- 1. App Store 搜索 **Bark** 装（官方免费）
157
- 2. 打开App，首页中间"Your Key is:"下面那串就是设备Key，点击复制填 `key`
158
- 3. 用官方默认服务器，`server` 不用填
159
-
160
- ### 9. Discord频道推送（`app-discord-webhook-send`）
161
- 往Discord频道发消息，可自定义机器人显示名。
162
- | 参数 | 必填 | 说明 |
163
- |---|---|---|
164
- | `webhook` | * | 频道设置 → 整合 → Webhook → 新建 → 复制URL |
165
- | `username` | | 机器人显示名 |
166
- | `message` | * | 消息内容 |
167
-
168
- **配置指引（拿webhook）**：
169
- 1. Discord服务器 → 目标频道 ⚙️ 频道设置 → 整合（Integrations） → Webhook
170
- 2. 新建Webhook → 选好频道 → "复制Webhook URL"填 `webhook`
171
- 3. 想改机器人显示名，直接在webhook设置里改，或填 `username`
172
- 4. ⚠️ webhook别用浏览器打开测试（GET请求会报错），直接让agent调用验证
173
-
174
- ### 10. Slack频道推送（`app-slack-webhook-send`）
175
- 往Slack频道发消息（Incoming Webhook）。
176
- | 参数 | 必填 | 说明 |
177
- |---|---|---|
178
- | `webhook` | * | Slack → Apps → Incoming Webhook → 添加到频道 → 复制URL |
179
- | `message` | * | 消息内容 |
180
-
181
- **配置指引（拿webhook）**：
182
- 1. 打开 **api.slack.com/apps** → Create New App → 起名选工作区
183
- 2. 左侧 Incoming Webhooks → 打开Activate → Add New Webhook to Workspace → 选频道
184
- 3. 页面底部 Webhook URL 复制填 `webhook`
185
- 4. ⚠️ webhook别用浏览器打开测试（GET请求会报错），直接让agent调用验证
186
-
187
- ---
188
-
189
- ## agent 该怎么做
190
-
191
- 1. 用户说"帮我发钉钉群通知"这类需求 → 先确认用户有没有对应参数（webhook/token等），**没有就引导用户去拿**（每个能力的参数表里写了怎么拿）
192
- 2. 参数齐了 → 调 `/v1/capability/{id}/execute`，带 `params` 和 `user_compute_key`
193
- 3. 未订阅时执行会返回订阅引导（402类错误）→ 调 `purchase` 接口（`plan=app_monthly`）生成支付链接给用户："应用层订阅¥2.99/月，全部应用不限次，要开吗？"
194
- 4. 发送成功 → 告诉用户"已发送"；失败 → 按错误信息提示用户检查参数（webhook对不对、授权码是不是用成了登录密码等）
195
-
196
- **注意**：webhook/token/授权码这类凭据是用户自己的，让用户自己提供，**绝不替用户编造**。用户的凭据只用于本次发送，不要存储、不要外传。
197
-
198
- ## 错误处理
199
-
200
- | 错误 | agent该怎么做 |
201
- |---|---|
202
- | 402/未订阅 | 生成订阅支付链接（¥2.99/月）给用户 |
203
- | 400 缺参数 | 按参数表补齐，缺的问用户要 |
204
- | 发送失败（凭据错） | 提示用户检查webhook/token/授权码是否正确 |
205
- | 5xx | 告诉用户"发送暂时异常，稍后再试" |
206
-
207
- ---
208
- 维护者：龙龙（AIXX PM）| 2026-08-14 建立（任务书A）
1
+ # 应用层能力（10个应用直连）
2
+
3
+ 让你的AI直接替用户操作真实应用：往钉钉/飞书/企微群发消息、发邮件、建GitHub Issue、推送到微信/iPhone/Slack（Discord 已下线）。
4
+
5
+ **先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和错误处理。**
6
+
7
+ ---
8
+
9
+ ## 订阅制（统一价格）
10
+
11
+ - **¥2.99/月，全部10个应用不限次使用**（不是每个应用单独买）
12
+ - 购买：调下单接口，`plan` 固定传 `app_monthly`：
13
+ ```bash
14
+ curl -X POST http://14.103.27.195/v1/capability/{id}/purchase \
15
+ -H "Content-Type: application/json" \
16
+ -d '{"plan": "app_monthly", "user_compute_key": "sk-用户的key"}'
17
+ ```
18
+ 返回支付链接（`pay_url`），给用户打开付款即可，付完即生效。
19
+
20
+ ## 执行（所有应用统一格式）
21
+
22
+ ```bash
23
+ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
24
+ -H "Content-Type: application/json" \
25
+ -d '{
26
+ "params": { "参数": "值" },
27
+ "user_compute_key": "sk-用户的key"
28
+ }'
29
+ ```
30
+
31
+ 能力层地址：`http://14.103.27.195/v1`（和LLM对话的 `{AIXX_BASE_URL}` 不是同一个入口）。
32
+
33
+ ---
34
+
35
+ ## 10个应用能力清单
36
+
37
+ > 带 `*` 的是必填参数，其余可选。
38
+
39
+ ### 1. 钉钉群消息推送（`app-dingtalk-group-send`）
40
+ 往钉钉群发消息（通知/日报/告警），支持加签和@人。
41
+
42
+ > ⚠️ **webhook链接不要用浏览器打开测试（会报 `errcode:43002 需要POST请求`），直接交给agent调用即可验证。** webhook只接受POST，浏览器地址栏是GET请求，报43002不代表配置有问题。
43
+
44
+ | 参数 | 必填 | 说明 |
45
+ |---|---|---|
46
+ | `webhook` | * | 群里创建"自定义机器人"得到的webhook地址（https://开头） |
47
+ | `secret` | | 机器人安全设置选了"加签"时填密钥，没选就不填 |
48
+ | `message` | * | 要发送的文本内容 |
49
+ | `at_mobiles` | | 要@的手机号列表（数组） |
50
+ | `at_all` | | 是否@所有人（true/false） |
51
+
52
+ **配置指引（用户操作）**：
53
+ > ⚠️ **必须在 PC 版钉钉客户端操作**（手机端不能建自定义机器人；网页端入口已取消）。
54
+ > 且只能在**企业内部群**创建（外部群已无法新增自定义机器人）。
55
+ 1. PC版钉钉打开目标群 → 右上角"⋯" → 机器人 → 添加机器人 → 选"自定义（通过Webhook接入）"
56
+ 2. 名字随便填 → 安全设置**三选一必选**（自定义关键词/加签/IP段，不选无法完成创建）→ 推荐选"加签" → 完成
57
+ 3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，同一页的**密钥**填 `secret`
58
+ 4. ⚠️ 若选"自定义关键词"：**关键词区分大小写**（填 `aixx` 时消息里必须有 `aixx`，`AIXX` 不匹配会被拒收），建议关键词填 `aixx` 并让消息带上
59
+ 5. ⚠️ webhook别用浏览器打开测试（浏览器是GET，钉钉报 `errcode:43002`，不代表配置错了），直接让agent调用验证
60
+
61
+ > 📌 商业化说明：钉钉自定义机器人 2024-02 起全量商业化，免费额度 **5000 条/自然月**（个人使用足够，超出需企业付费版）。另有频率限制（约 20 条/分钟），密集发送会被限流（errcode=6 或频控提示），属正常现象稍后重试。
62
+
63
+ ### 2. 飞书群消息推送（`app-feishu-group-send`）
64
+ 往飞书群发消息，支持加签和@所有人。
65
+ | 参数 | 必填 | 说明 |
66
+ |---|---|---|
67
+ | `webhook` | * | 群里创建"自定义机器人"得到的webhook地址 |
68
+ | `secret` | | 选了"加签"时填密钥 |
69
+ | `message` | * | 要发送的文本内容 |
70
+ | `at_all` | | 是否@所有人（true/false） |
71
+
72
+ **配置指引（用户操作）**：
73
+ 1. 打开飞书目标群 → 右上角"⋯" → 设置 → 群机器人 → 添加机器人 → 选"自定义机器人"
74
+ 2. 名字随便填 → 权限默认 → 安全设置**可选但建议**勾"签名校验"（不选也能创建）→ 完成
75
+ 3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，**签名密钥**填 `secret`
76
+ 4. ⚠️ webhook别用浏览器打开测试（GET请求会被拒），直接让agent调用验证
77
+
78
+ ### 3. 企微群消息推送（`app-wecom-group-send`）
79
+ 往企业微信群发消息，可@指定成员。
80
+ | 参数 | 必填 | 说明 |
81
+ |---|---|---|
82
+ | `webhook` | * | 群里创建"群机器人"得到的webhook地址 |
83
+ | `secret` | | 选了"加签"时填密钥 |
84
+ | `message` | * | 要发送的文本内容 |
85
+ | `at_mobiles` | | 要@的手机号列表（数组） |
86
+ | `at_all` | | 是否@所有人（true/false） |
87
+
88
+ **配置指引（用户操作）**：
89
+ 1. 打开企业微信目标群 → 右上角"⋯" → 添加群机器人 → 新建
90
+ 2. 名字随便填 → 复制 **Webhook地址** 填 `webhook`
91
+ 3. 企微群机器人不支持加签，`secret` 不用填
92
+ 4. ⚠️ webhook别用浏览器打开测试（会报错），直接让agent调用验证
93
+
94
+ ### 4. 邮件发送（`app-email-send`）
95
+ 通过任意SMTP邮箱发正式邮件（QQ邮箱/163/Gmail/企业邮箱都行）。
96
+ | 参数 | 必填 | 说明 |
97
+ |---|---|---|
98
+ | `smtp_host` | * | SMTP服务器（QQ邮箱 smtp.qq.com / 163 smtp.163.com / Gmail smtp.gmail.com） |
99
+ | `smtp_port` | | SSL填465，STARTTLS填587（默认465） |
100
+ | `username` | * | 发件邮箱账号（如 xxx@qq.com） |
101
+ | `password` | * | 邮箱**授权码**（不是登录密码！邮箱设置-账户里开通SMTP时获取） |
102
+ | `to` | * | 收件人邮箱 |
103
+ | `subject` | | 邮件主题（默认"AIXX邮件"） |
104
+ | `message` | * | 邮件正文 |
105
+
106
+ **配置指引（拿授权码）**：`password`填授权码，不是邮箱登录密码！
107
+ - **QQ邮箱**：网页版 → 设置 → 账户 → 开启"POP3/IMAP/SMTP服务" → 短信验证 → 得到16位授权码
108
+ - **163邮箱**：设置 → POP3/SMTP/IMAP → 开启SMTP → 设置"客户端授权密码"
109
+ - **Gmail**：Google账号 → 安全性 → 开两步验证 → 应用专用密码 → 生成
110
+
111
+ ### 5. GitHub建Issue（`app-github-create-issue`）
112
+ 在你的GitHub仓库建Issue（记bug/提需求/记待办）。
113
+ | 参数 | 必填 | 说明 |
114
+ |---|---|---|
115
+ | `token` | * | Personal Access Token（GitHub → Settings → Developer settings → Tokens创建，勾repo权限） |
116
+ | `repo` | * | 仓库名，owner/repo格式（如 octocat/hello-world） |
117
+ | `title` | * | Issue标题 |
118
+ | `body` | | Issue正文 |
119
+
120
+ **配置指引（拿token）**：
121
+ 1. 登录 github.com → 右上角头像 → Settings → 左侧最底 Developer settings
122
+ 2. Personal access tokens → Tokens (classic) → Generate new token
123
+ 3. 勾选 **repo** 权限 → 生成 → 立刻复制token（只显示这一次，关页面就看不到了）
124
+
125
+ ### 6. Server酱微信推送（`app-serverchan-wechat-push`）
126
+ 把消息直接推到用户微信（sct.ftqq.com微信扫码拿SendKey）。
127
+ | 参数 | 必填 | 说明 |
128
+ |---|---|---|
129
+ | `sendkey` | * | SendKey（sct.ftqq.com微信扫码登录后获取，SCT开头） |
130
+ | `title` | | 消息标题（默认"AIXX消息"） |
131
+ | `message` | * | 消息内容（支持Markdown） |
132
+
133
+ **配置指引（拿SendKey）**：
134
+ 1. 打开 **sct.ftqq.com** → 微信扫码登录
135
+ 2. 首页就能看到 **SendKey**（SCT开头），复制填 `sendkey`
136
+ 3. 免费账户每天限5条消息，第二天自动重置；不够用可升级额度
137
+
138
+ ### 7. PushPlus微信推送（`app-pushplus-wechat-push`）
139
+ 消息推到微信公众号（pushplus.plus微信登录拿token）。
140
+ | 参数 | 必填 | 说明 |
141
+ |---|---|---|
142
+ | `token` | * | token（pushplus.plus微信登录后，"一对一推送"页复制） |
143
+ | `title` | | 消息标题 |
144
+ | `message` | * | 消息内容 |
145
+
146
+ **配置指引（拿token）**：
147
+ 1. 打开 **pushplus.plus** → 微信扫码登录
148
+ 2. 左侧菜单"一对一推送" → 页面上的 **token**（32位）复制填 `token`
149
+ 3. 关注它的微信公众号才能收到推送（页面上有二维码）
150
+
151
+ ### 8. Bark苹果推送（`app-bark-ios-push`）
152
+ 推送通知到iPhone（App Store装Bark App）。
153
+ | 参数 | 必填 | 说明 |
154
+ |---|---|---|
155
+ | `key` | * | 设备Key（打开Bark App首页直接复制那一串） |
156
+ | `server` | | Bark服务地址（默认官方，自建服务填自己的） |
157
+ | `title` | | 通知标题 |
158
+ | `message` | * | 通知内容 |
159
+
160
+ **配置指引（拿Key）**：
161
+ 1. App Store 搜索 **Bark** 装（官方免费）
162
+ 2. 打开App，首页中间"Your Key is:"下面那串就是设备Key，点击复制填 `key`
163
+ 3. 用官方默认服务器，`server` 不用填
164
+
165
+ ### 10. Slack频道推送（`app-slack-webhook-send`）
166
+ 往Slack频道发消息（Incoming Webhook）。
167
+ | 参数 | 必填 | 说明 |
168
+ |---|---|---|
169
+ | `webhook` | * | Slack → Apps → Incoming Webhook → 添加到频道 → 复制URL |
170
+ | `message` | * | 消息内容 |
171
+
172
+ **配置指引（拿webhook）**：
173
+ 1. 打开 **api.slack.com/apps** → Create New App → 起名选工作区
174
+ 2. 左侧 Incoming Webhooks → 打开Activate → Add New Webhook to Workspace → 选频道
175
+ 3. 页面底部 Webhook URL 复制填 `webhook`
176
+ 4. ⚠️ webhook别用浏览器打开测试（GET请求会报错），直接让agent调用验证
177
+
178
+ ---
179
+
180
+ ## agent 该怎么做
181
+
182
+ 1. 用户说"帮我发钉钉群通知"这类需求 → 先确认用户有没有对应参数（webhook/token等），**没有就引导用户去拿**（每个能力的参数表里写了怎么拿）
183
+ 2. 参数齐了 → 调 `/v1/capability/{id}/execute`，带 `params` 和 `user_compute_key`
184
+ 3. 未订阅时执行会返回订阅引导（402类错误）→ 调 `purchase` 接口（`plan=app_monthly`）生成支付链接给用户："应用层订阅¥2.99/月，全部应用不限次，要开吗？"
185
+ 4. 发送成功 → 告诉用户"已发送"；失败 → 按错误信息提示用户检查参数（webhook对不对、授权码是不是用成了登录密码等）
186
+
187
+ **注意**：webhook/token/授权码这类凭据是用户自己的，让用户自己提供，**绝不替用户编造**。用户的凭据只用于本次发送，不要存储、不要外传。
188
+
189
+ ## 错误处理
190
+
191
+ | 错误 | agent该怎么做 |
192
+ |---|---|
193
+ | 402/未订阅 | 生成订阅支付链接（¥2.99/月）给用户 |
194
+ | 400 缺参数 | 按参数表补齐，缺的问用户要 |
195
+ | 发送失败（凭据错） | 提示用户检查webhook/token/授权码是否正确 |
196
+ | 5xx | 告诉用户"发送暂时异常，稍后再试" |
197
+
198
+ ---
199
+ 维护者：龙龙（AIXX PM）| 2026-08-14 建立（任务书A）