aixxai 1.4.0 → 1.4.2

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aixxai",
3
- "version": "1.4.0",
3
+ "version": "1.4.2",
4
4
  "description": "AIXX CLI - 让你的AI调用万物。安装:npx aixxai install",
5
5
  "type": "module",
6
6
  "bin": {
@@ -31,4 +31,4 @@
31
31
  "engines": {
32
32
  "node": ">=18"
33
33
  }
34
- }
34
+ }
@@ -116,7 +116,7 @@ agent判断:需要AI能力吗?
116
116
  |---|---|---|
117
117
  | `deepseek-chat` | DeepSeek,便宜能打 | 默认首选,日常任务 |
118
118
  | `deepseek-reasoner` | DeepSeek推理 | 复杂推理、数学 |
119
- | `glm-4-flash` | GLM智谱,免费档 | 轻量任务 |
119
+ | `glm-4-flash` | GLM智谱,免费档。不支持工具调用(function calling) | 轻量纯文本任务;需工具调用用 `deepseek-chat` |
120
120
  | `glm-4-plus` | GLM智谱,旗舰(渠道维护中) | 文案任务先用 `deepseek-chat` |
121
121
  | `moonshot-v1-8k` | Kimi,短文本 | 短文翻译 |
122
122
  | `moonshot-v1-32k` | Kimi,中长文 | 中长文档 |
@@ -39,6 +39,7 @@ AIXX 会自动选最优模型,但 agent 也可以按任务指定。
39
39
  | 复杂任务/最强 | `claude-opus-4-8` | 能力最强 |
40
40
  | 通用旗舰 | `gpt-4o` | 通用 |
41
41
  | 审美/UI/设计 | (先搜索skill,见 search.md) | 专门skill比通用模型强 |
42
+ | 轻量免费任务 | `glm-4-flash` | 免费,但不支持工具调用(function calling);需工具调用用 `deepseek-chat` |
42
43
 
43
44
  **不指定 model 时**:用 `deepseek-chat`(最便宜,省用户额度)。
44
45
 
@@ -55,21 +55,69 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
55
55
  |---|---|
56
56
  | 抖音视频点赞/播放/分享数、博主信息、评论 | 抖音视频数据 / 抖音博主数据 |
57
57
  | 小红书笔记数据、博主粉丝 | 小红书数据 |
58
+ | 快手视频/博主数据 | 快手视频数据 |
58
59
  | TikTok海外视频/博主数据 | TikTok视频数据 |
59
60
  | B站视频/UP主数据 | B站数据 |
60
61
  | 微博、知乎内容和用户数据 | 微博数据 / 知乎数据 |
61
- | 淘宝商品、搜索、销量、评价 | 淘宝电商数据 |
62
+ | YouTube / Instagram 海外社媒数据 | YouTube数据 / Instagram数据 |
63
+ | 淘宝天猫商品、搜索、销量 | 淘宝电商数据 |
64
+ | 京东 / 亚马逊 / Temu / Shopee / 1688 / 闲鱼 电商数据 | 京东商品数据 / 亚马逊商品数据 / Temu数据 等 |
65
+ | 豆瓣影视评分/评论 | 豆瓣影视数据 |
62
66
 
63
67
  能力库持续扩展。用户要的数据平台没列到,也先调发现接口探一下。
64
68
 
65
69
  ---
66
70
 
71
+ ## 小红书笔记详情参数(`fetch_note_detail`)
72
+
73
+ 查小红书**笔记详情**(`fetch_note_detail` 类能力)需要两个参数,缺一不可:
74
+
75
+ | 参数 | 说明 |
76
+ |---|---|
77
+ | `note_id` | 笔记ID(笔记的唯一标识) |
78
+ | `xsec_token` | 笔记的访问令牌(防爬校验用) |
79
+
80
+ **`xsec_token` 从哪来**:从小红书**分享链接**里取。让用户在小红书 App 里对目标笔记点"分享→复制链接",链接形如:
81
+
82
+ ```
83
+ http://xhslink.com/xxxx 或 https://www.xiaohongshu.com/explore/{note_id}?xsec_token=ABcd1234...&xsec_source=pc_feed
84
+ ```
85
+
86
+ - 链接 query 里的 `xsec_token=...` 就是令牌,`explore/` 后面那串就是 `note_id`
87
+ - 短链(`xhslink.com`)先访问展开成长链接再取参
88
+ - **别自己编造**这两个值:编错的 `note_id`/`xsec_token` 会查不到数据,缺哪个就让用户提供分享链接
89
+
90
+ ```bash
91
+ curl -X POST http://14.103.27.195/v1/capability/data-tikhub-xiaohongshu-fetch_note_detail/execute \
92
+ -H "Content-Type: application/json" \
93
+ -d '{
94
+ "params": { "note_id": "笔记ID", "xsec_token": "从分享链接取的token" },
95
+ "user_compute_key": "sk-用户的key"
96
+ }'
97
+ ```
98
+
99
+ > 能力ID以发现接口实际返回为准(上例仅示意)。其他小红书能力(博主数据、笔记列表等)参数不同,按各自 `description` 填。
100
+
101
+ ---
102
+
67
103
  ## 计费
68
104
 
69
105
  - **按次计费**:每个能力单价不同(见发现接口返回的 `pricing`)
70
106
  - **免费额度**:1次试用(先试用再决定要不要继续用)
71
107
  - 额度不足时接口会返回明确的错误提示,转告用户即可
72
108
 
109
+ ### 计费说明(重要口径,别答错)
110
+
111
+ > **购买 per_use = 预付1次执行;每次执行扣1次额度;`billed.capability_fee` 是该次对应费用(用免费额度时显示0)。**
112
+
113
+ 拆开讲:
114
+ - 用户购买 per_use(如 ¥1.99)那一刻,钱已付、1次额度已到账;之后执行不再扣钱,只扣这1次额度。
115
+ - 每次执行(不管额度来自购买还是免费额度)成功扣1次;执行失败(上游错误/查不到数据)额度自动返还,不白扣。
116
+ - 返回里的 `billed.capability_fee` 是**该次执行的记账费用**,不是用户当次又付了钱:
117
+ - 用**免费额度**执行的那次 → 显示 `0`(额度是送的,用户没花钱)
118
+ - 用**购买额度**执行的那次 → 显示该能力单价(购买的钱在购买那步已付过)
119
+ - 所以用户问"我买了1.99怎么显示0"→ 答:"那1.99在下单时已经付过了,执行只扣次数不再扣钱;显示0的那次用的是免费/赠送额度。"
120
+
73
121
  ---
74
122
 
75
123
  ## ⚠️ 黑盒红线(必守)
@@ -2,7 +2,6 @@
2
2
 
3
3
  帮用户找到合适的 AI 能力(专业能力/工具),并给出**中文推荐理由**。
4
4
 
5
- > ⚠️ 旧的直连搜索入口(8091端口)已内网化,公网不通是设计,**不要再调**。
6
5
  > 找skill/能力的需求统一走 `/v1/capability` 发现接口。
7
6
 
8
7
  ---
@@ -94,4 +93,4 @@ curl -X POST http://14.103.27.195/v1/capability \
94
93
  | 0结果/没命中 | 见上面第4条,标准回复 |
95
94
 
96
95
  ---
97
- 维护者:龙龙(AIXX PM)| 2026-08-09 建立(2.0流量腿)| 2026-08-14 更新:8091直连下线,统一走 /v1/capability(任务书A)
96
+ 维护者:龙龙(AIXX PM)| 2026-08-09 建立(2.0流量腿)| 2026-08-14 更新:统一走 /v1/capability(任务书A)