aixxai 1.4.3 → 1.5.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.
@@ -1,53 +1,53 @@
1
- # 微信通知绑定
2
-
3
- 引导用户绑定微信通知,AIXX能主动给用户发提醒(余额不足/充值成功/新能力上架)。
4
-
5
- ---
6
-
7
- ## 什么时候引导用户绑定
8
-
9
- - install完成后(可选,不强制)
10
- - 用户第一次余额不足时(这时候最有动力绑)
11
-
12
- ## 怎么绑定(用户操作)
13
-
14
- 1. 用户访问 **https://sct.ftqq.com/?name=AIXX** (Server酱官网)
15
- 2. 用微信扫码登录
16
- 3. 拿到一个key(SCT开头的,如 `SCT123456abcdef`)
17
- 4. 对agent说"我的通知key是SCT123456abcdef"
18
- 5. agent调AIXX接口绑定
19
-
20
- ## 用户说"绑定通知" / "绑定微信提醒"
21
-
22
- agent引导:
23
- "想接收余额提醒和重要通知?按这个步骤绑定微信:
24
- 1. 用微信扫这个码(或访问 https://sct.ftqq.com/?name=AIXX )
25
- 2. 登录后会给你一个key(SCT开头的)
26
- 3. 把key告诉我,我帮你绑定"
27
-
28
- ## 用户给了key("我的通知key是SCTxxx")
29
-
30
- agent调AIXX绑定接口:
31
- ```bash
32
- curl -X POST {AIXX_BASE_URL}/api/user/bind_notify \
33
- -H "Authorization: Bearer {AIXX_API_KEY}" \
34
- -H "Content-Type: application/json" \
35
- -d '{"notify_key": "SCT123456abcdef"}'
36
- ```
37
-
38
- 绑定成功后告诉用户:"已绑定!以后余额不足、充值成功、新能力上架,都会发微信通知你。"
39
-
40
- ## 绑定后用户会收到什么通知
41
-
42
- - 🔴 余额不足(余额低于¥2时)
43
- - ✅ 充值成功
44
- - 🎉 新能力上架(AIXX上了新能力时)
45
- - ⚠️ 能力执行异常
46
-
47
- ## 解绑
48
-
49
- 用户说"取消通知" → 调同样的接口,notify_key传空字符串。
50
-
51
- ---
52
-
53
- 维护者:龙龙(AIXX PM)| 2026-08-10 建立
1
+ # 微信通知绑定
2
+
3
+ 引导用户绑定微信通知,AIXX能主动给用户发提醒(余额不足/充值成功/新能力上架)。
4
+
5
+ ---
6
+
7
+ ## 什么时候引导用户绑定
8
+
9
+ - install完成后(可选,不强制)
10
+ - 用户第一次余额不足时(这时候最有动力绑)
11
+
12
+ ## 怎么绑定(用户操作)
13
+
14
+ 1. 用户访问 **https://sct.ftqq.com/?name=AIXX** (Server酱官网)
15
+ 2. 用微信扫码登录
16
+ 3. 拿到一个key(SCT开头的,如 `SCT123456abcdef`)
17
+ 4. 对agent说"我的通知key是SCT123456abcdef"
18
+ 5. agent调AIXX接口绑定
19
+
20
+ ## 用户说"绑定通知" / "绑定微信提醒"
21
+
22
+ agent引导:
23
+ "想接收余额提醒和重要通知?按这个步骤绑定微信:
24
+ 1. 用微信扫这个码(或访问 https://sct.ftqq.com/?name=AIXX )
25
+ 2. 登录后会给你一个key(SCT开头的)
26
+ 3. 把key告诉我,我帮你绑定"
27
+
28
+ ## 用户给了key("我的通知key是SCTxxx")
29
+
30
+ agent调AIXX绑定接口:
31
+ ```bash
32
+ curl -X POST {AIXX_BASE_URL}/api/user/bind_notify \
33
+ -H "Authorization: Bearer {AIXX_API_KEY}" \
34
+ -H "Content-Type: application/json" \
35
+ -d '{"notify_key": "SCT123456abcdef"}'
36
+ ```
37
+
38
+ 绑定成功后告诉用户:"已绑定!以后余额不足、充值成功、新能力上架,都会发微信通知你。"
39
+
40
+ ## 绑定后用户会收到什么通知
41
+
42
+ - 🔴 余额不足(余额低于¥2时)
43
+ - ✅ 充值成功
44
+ - 🎉 新能力上架(AIXX上了新能力时)
45
+ - ⚠️ 能力执行异常
46
+
47
+ ## 解绑
48
+
49
+ 用户说"取消通知" → 调同样的接口,notify_key传空字符串。
50
+
51
+ ---
52
+
53
+ 维护者:龙龙(AIXX PM)| 2026-08-10 建立
@@ -1,96 +1,96 @@
1
- # 找skill / 发现AI能力
2
-
3
- 帮用户找到合适的 AI 能力(专业能力/工具),并给出**中文推荐理由**。
4
-
5
- > 找skill/能力的需求统一走 `/v1/capability` 发现接口。
6
-
7
- ---
8
-
9
- ## 什么时候用
10
-
11
- 用户想找新的 AI 能力时:
12
- - "我要个审美的skill"
13
- - "帮我找个写代码的AI工具"
14
- - "有没有做翻译的agent"
15
- - "推荐个分析数据的能力"
16
- - 任何"找/推荐/需要...skill/工具/agent/能力"的请求
17
-
18
- **不用的场景**:
19
- - 用户要的是"直接调用AI"(翻译这段、写个文案)→ 走 chat(见 chat.md)
20
- - 用户要查数据 → 走 data.md
21
- - 用户要发通知/推送 → 走 apps.md
22
- - 用户要查自己的余额/用量 → 走 account.md
23
-
24
- ---
25
-
26
- ## 怎么调(能力发现接口)
27
-
28
- ```bash
29
- curl -X POST http://14.103.27.195/v1/capability \
30
- -H "Content-Type: application/json" \
31
- -d '{"need": "审美", "top_n": 5}'
32
- ```
33
-
34
- **参数**:
35
- - `need`:用户的自然语言需求(必填,可中文)
36
- - `input`:可选,补充描述
37
- - `top_n`:返回数量,默认5,最大20
38
-
39
- 发现接口**免费、不需要API Key**。
40
-
41
- ---
42
-
43
- ## 返回什么
44
-
45
- ```json
46
- {
47
- "matched": true,
48
- "capabilities": [
49
- {
50
- "id": "能力ID(执行时原样使用)",
51
- "name": "能力名称",
52
- "description": "能力说明(做什么、怎么用)",
53
- "pricing": { "per_use": 1.99, "weekly": 2.99, "monthly": 3.99, "free_quota": 1 },
54
- "match_score": 95,
55
- "estimated_time": "约30秒"
56
- }
57
- ]
58
- }
59
- ```
60
-
61
- ---
62
-
63
- ## agent 该怎么做
64
-
65
- 1. 拿到结果后**不要直接吐 JSON**,按 match_score 从高到低转述:
66
-
67
- ```
68
- 我帮你找了,匹配度最高的几个:
69
-
70
- 【1】专业文案(匹配度98)
71
- 它是干什么的:覆盖广告、品牌故事、社媒文案的全场景写作,直接产出可用版本
72
- 价格:¥1.99/次(有1次免费试用)
73
-
74
- 【2】...
75
- ```
76
-
77
- 2. **重点说"为什么适合"**(对照用户的原始需求说)
78
- 3. 用户说"就用第X个" → 帮用户执行:
79
- ```bash
80
- curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
81
- -H "Content-Type: application/json" \
82
- -d '{"task": "用户的具体任务", "user_compute_key": "sk-用户的key"}'
83
- ```
84
- 4. 没命中(`matched: false`)→ 按SKILL.md的"怪需求"规则回复:"已记下这个需求,AIXX能力库持续扩展中,上架后第一时间告诉你。"
85
-
86
- ---
87
-
88
- ## 错误处理
89
-
90
- | 错误 | agent该怎么做 |
91
- |---|---|
92
- | 5xx | 告诉用户"能力服务暂时异常,稍后再试" |
93
- | 0结果/没命中 | 见上面第4条,标准回复 |
94
-
95
- ---
96
- 维护者:龙龙(AIXX PM)| 2026-08-09 建立(2.0流量腿)| 2026-08-14 更新:统一走 /v1/capability(任务书A)
1
+ # 找skill / 发现AI能力
2
+
3
+ 帮用户找到合适的 AI 能力(专业能力/工具),并给出**中文推荐理由**。
4
+
5
+ > 找skill/能力的需求统一走 `/v1/capability` 发现接口。
6
+
7
+ ---
8
+
9
+ ## 什么时候用
10
+
11
+ 用户想找新的 AI 能力时:
12
+ - "我要个审美的skill"
13
+ - "帮我找个写代码的AI工具"
14
+ - "有没有做翻译的agent"
15
+ - "推荐个分析数据的能力"
16
+ - 任何"找/推荐/需要...skill/工具/agent/能力"的请求
17
+
18
+ **不用的场景**:
19
+ - 用户要的是"直接调用AI"(翻译这段、写个文案)→ 走 chat(见 chat.md)
20
+ - 用户要查数据 → 走 data.md
21
+ - 用户要发通知/推送 → 走 apps.md
22
+ - 用户要查自己的余额/用量 → 走 account.md
23
+
24
+ ---
25
+
26
+ ## 怎么调(能力发现接口)
27
+
28
+ ```bash
29
+ curl -X POST http://14.103.27.195/v1/capability \
30
+ -H "Content-Type: application/json" \
31
+ -d '{"need": "审美", "top_n": 5}'
32
+ ```
33
+
34
+ **参数**:
35
+ - `need`:用户的自然语言需求(必填,可中文)
36
+ - `input`:可选,补充描述
37
+ - `top_n`:返回数量,默认5,最大20
38
+
39
+ 发现接口**免费、不需要API Key**。
40
+
41
+ ---
42
+
43
+ ## 返回什么
44
+
45
+ ```json
46
+ {
47
+ "matched": true,
48
+ "capabilities": [
49
+ {
50
+ "id": "能力ID(执行时原样使用)",
51
+ "name": "能力名称",
52
+ "description": "能力说明(做什么、怎么用)",
53
+ "pricing": { "per_use": 1.99, "weekly": 2.99, "monthly": 3.99, "free_quota": 1 },
54
+ "match_score": 95,
55
+ "estimated_time": "约30秒"
56
+ }
57
+ ]
58
+ }
59
+ ```
60
+
61
+ ---
62
+
63
+ ## agent 该怎么做
64
+
65
+ 1. 拿到结果后**不要直接吐 JSON**,按 match_score 从高到低转述:
66
+
67
+ ```
68
+ 我帮你找了,匹配度最高的几个:
69
+
70
+ 【1】专业文案(匹配度98)
71
+ 它是干什么的:覆盖广告、品牌故事、社媒文案的全场景写作,直接产出可用版本
72
+ 价格:¥1.99/次(有1次免费试用)
73
+
74
+ 【2】...
75
+ ```
76
+
77
+ 2. **重点说"为什么适合"**(对照用户的原始需求说)
78
+ 3. 用户说"就用第X个" → 帮用户执行:
79
+ ```bash
80
+ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
81
+ -H "Content-Type: application/json" \
82
+ -d '{"task": "用户的具体任务", "user_compute_key": "sk-用户的key"}'
83
+ ```
84
+ 4. 没命中(`matched: false`)→ 按SKILL.md的"怪需求"规则回复:"已记下这个需求,AIXX能力库持续扩展中,上架后第一时间告诉你。"
85
+
86
+ ---
87
+
88
+ ## 错误处理
89
+
90
+ | 错误 | agent该怎么做 |
91
+ |---|---|
92
+ | 5xx | 告诉用户"能力服务暂时异常,稍后再试" |
93
+ | 0结果/没命中 | 见上面第4条,标准回复 |
94
+
95
+ ---
96
+ 维护者:龙龙(AIXX PM)| 2026-08-09 建立(2.0流量腿)| 2026-08-14 更新:统一走 /v1/capability(任务书A)