aixxai 1.4.1 → 1.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aixxai",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "AIXX CLI - 让你的AI调用万物。安装：npx aixxai install",
   "type": "module",
   "bin": {

package/templates/SKILL.md

@@ -115,13 +115,15 @@ agent判断：需要AI能力吗？
 | 模型 | 说明 | 推荐场景 |
 |---|---|---|
 | `deepseek-chat` | DeepSeek，便宜能打 | 默认首选，日常任务 |
-| `deepseek-reasoner` | DeepSeek推理 | 复杂推理、数学 |
-| `glm-4-flash` | GLM智谱，免费档 | 轻量任务 |
+| `glm-4-flash` | GLM智谱，免费档。不支持工具调用(function calling)，也不支持json_object强制格式 | 轻量纯文本任务；需工具调用用 `deepseek-chat` |
 | `glm-4-plus` | GLM智谱，旗舰（渠道维护中） | 文案任务先用 `deepseek-chat` |
 | `moonshot-v1-8k` | Kimi，短文本 | 短文翻译 |
 | `moonshot-v1-32k` | Kimi，中长文 | 中长文档 |
 | `moonshot-v1-128k` | Kimi，长文本 | 长文档分析 |
 
+> ⚠️ **推理类模型（kimi-k2.6 / claude系思考模型等）**：max_tokens 要给足（≥2000）。这类模型的思考token计入max_tokens预算，给小了会返回空内容。
+> ℹ️ **响应里的 model 字段**：上游偶尔会返回内部版本名（如 deepseek-chat 返回 v4-flash），以内容质量为准，不影响计费。
+
 更多模型和实时列表：调 `/v1/models` 接口查询。
 
 ## 设计哲学（K哥的初心）

package/templates/references/apps.md

@@ -38,6 +38,9 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 
 ### 1. 钉钉群消息推送（`app-dingtalk-group-send`）
 往钉钉群发消息（通知/日报/告警），支持加签和@人。
+
+> ⚠️ **webhook链接不要用浏览器打开测试（会报 `errcode:43002 需要POST请求`），直接交给agent调用即可验证。** webhook只接受POST，浏览器地址栏是GET请求，报43002不代表配置有问题。
+
 | 参数 | 必填 | 说明 |
 |---|---|---|
 | `webhook` | * | 群里创建"自定义机器人"得到的webhook地址（https://开头） |
@@ -46,6 +49,12 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `at_mobiles` | | 要@的手机号列表（数组） |
 | `at_all` | | 是否@所有人（true/false） |
 
+**配置指引（用户操作）**：
+1. 打开钉钉目标群 → 右上角"⋯" → 机器人 → 添加机器人 → 选"自定义（通过Webhook接入）"
+2. 名字随便填 → 安全设置勾选"加签" → 完成
+3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，同一页的**密钥**填 `secret`
+4. ⚠️ webhook别用浏览器打开测试（浏览器是GET，钉钉报 `errcode:43002`，不代表配置错了），直接让agent调用验证
+
 ### 2. 飞书群消息推送（`app-feishu-group-send`）
 往飞书群发消息，支持加签和@所有人。
 | 参数 | 必填 | 说明 |
@@ -55,6 +64,12 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `message` | * | 要发送的文本内容 |
 | `at_all` | | 是否@所有人（true/false） |
 
+**配置指引（用户操作）**：
+1. 打开飞书目标群 → 右上角"⋯" → 设置 → 群机器人 → 添加机器人 → 选"自定义机器人"
+2. 名字随便填 → 权限默认 → 安全设置选"签名校验" → 完成
+3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，**签名密钥**填 `secret`
+4. ⚠️ webhook别用浏览器打开测试（GET请求会被拒），直接让agent调用验证
+
 ### 3. 企微群消息推送（`app-wecom-group-send`）
 往企业微信群发消息，可@指定成员。
 | 参数 | 必填 | 说明 |
@@ -65,6 +80,12 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `at_mobiles` | | 要@的手机号列表（数组） |
 | `at_all` | | 是否@所有人（true/false） |
 
+**配置指引（用户操作）**：
+1. 打开企业微信目标群 → 右上角"⋯" → 添加群机器人 → 新建
+2. 名字随便填 → 复制 **Webhook地址** 填 `webhook`
+3. 企微群机器人不支持加签，`secret` 不用填
+4. ⚠️ webhook别用浏览器打开测试（会报错），直接让agent调用验证
+
 ### 4. 邮件发送（`app-email-send`）
 通过任意SMTP邮箱发正式邮件（QQ邮箱/163/Gmail/企业邮箱都行）。
 | 参数 | 必填 | 说明 |
@@ -77,6 +98,11 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `subject` | | 邮件主题（默认"AIXX邮件"） |
 | `message` | * | 邮件正文 |
 
+**配置指引（拿授权码）**：`password`填授权码，不是邮箱登录密码！
+- **QQ邮箱**：网页版 → 设置 → 账户 → 开启"POP3/IMAP/SMTP服务" → 短信验证 → 得到16位授权码
+- **163邮箱**：设置 → POP3/SMTP/IMAP → 开启SMTP → 设置"客户端授权密码"
+- **Gmail**：Google账号 → 安全性 → 开两步验证 → 应用专用密码 → 生成
+
 ### 5. GitHub建Issue（`app-github-create-issue`）
 在你的GitHub仓库建Issue（记bug/提需求/记待办）。
 | 参数 | 必填 | 说明 |
@@ -86,6 +112,11 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `title` | * | Issue标题 |
 | `body` | | Issue正文 |
 
+**配置指引（拿token）**：
+1. 登录 github.com → 右上角头像 → Settings → 左侧最底 Developer settings
+2. Personal access tokens → Tokens (classic) → Generate new token
+3. 勾选 **repo** 权限 → 生成 → 立刻复制token（只显示这一次，关页面就看不到了）
+
 ### 6. Server酱微信推送（`app-serverchan-wechat-push`）
 把消息直接推到用户微信（sct.ftqq.com微信扫码拿SendKey）。
 | 参数 | 必填 | 说明 |
@@ -94,6 +125,11 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `title` | | 消息标题（默认"AIXX消息"） |
 | `message` | * | 消息内容（支持Markdown） |
 
+**配置指引（拿SendKey）**：
+1. 打开 **sct.ftqq.com** → 微信扫码登录
+2. 首页就能看到 **SendKey**（SCT开头），复制填 `sendkey`
+3. 免费账户每天限5条消息，第二天自动重置；不够用可升级额度
+
 ### 7. PushPlus微信推送（`app-pushplus-wechat-push`）
 消息推到微信公众号（pushplus.plus微信登录拿token）。
 | 参数 | 必填 | 说明 |
@@ -102,6 +138,11 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `title` | | 消息标题 |
 | `message` | * | 消息内容 |
 
+**配置指引（拿token）**：
+1. 打开 **pushplus.plus** → 微信扫码登录
+2. 左侧菜单"一对一推送" → 页面上的 **token**（32位）复制填 `token`
+3. 关注它的微信公众号才能收到推送（页面上有二维码）
+
 ### 8. Bark苹果推送（`app-bark-ios-push`）
 推送通知到iPhone（App Store装Bark App）。
 | 参数 | 必填 | 说明 |
@@ -111,6 +152,11 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `title` | | 通知标题 |
 | `message` | * | 通知内容 |
 
+**配置指引（拿Key）**：
+1. App Store 搜索 **Bark** 装（官方免费）
+2. 打开App，首页中间"Your Key is:"下面那串就是设备Key，点击复制填 `key`
+3. 用官方默认服务器，`server` 不用填
+
 ### 9. Discord频道推送（`app-discord-webhook-send`）
 往Discord频道发消息，可自定义机器人显示名。
 | 参数 | 必填 | 说明 |
@@ -119,6 +165,12 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `username` | | 机器人显示名 |
 | `message` | * | 消息内容 |
 
+**配置指引（拿webhook）**：
+1. Discord服务器 → 目标频道 ⚙️ 频道设置 → 整合（Integrations） → Webhook
+2. 新建Webhook → 选好频道 → "复制Webhook URL"填 `webhook`
+3. 想改机器人显示名，直接在webhook设置里改，或填 `username`
+4. ⚠️ webhook别用浏览器打开测试（GET请求会报错），直接让agent调用验证
+
 ### 10. Slack频道推送（`app-slack-webhook-send`）
 往Slack频道发消息（Incoming Webhook）。
 | 参数 | 必填 | 说明 |
@@ -126,6 +178,12 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
 | `webhook` | * | Slack → Apps → Incoming Webhook → 添加到频道 → 复制URL |
 | `message` | * | 消息内容 |
 
+**配置指引（拿webhook）**：
+1. 打开 **api.slack.com/apps** → Create New App → 起名选工作区
+2. 左侧 Incoming Webhooks → 打开Activate → Add New Webhook to Workspace → 选频道
+3. 页面底部 Webhook URL 复制填 `webhook`
+4. ⚠️ webhook别用浏览器打开测试（GET请求会报错），直接让agent调用验证
+
 ---
 
 ## agent 该怎么做

package/templates/references/chat.md

@@ -39,6 +39,7 @@ AIXX 会自动选最优模型，但 agent 也可以按任务指定。
 | 复杂任务/最强 | `claude-opus-4-8` | 能力最强 |
 | 通用旗舰 | `gpt-4o` | 通用 |
 | 审美/UI/设计 | （先搜索skill，见 search.md） | 专门skill比通用模型强 |
+| 轻量免费任务 | `glm-4-flash` | 免费，但不支持工具调用(function calling)；需工具调用用 `deepseek-chat` |
 
 **不指定 model 时**：用 `deepseek-chat`（最便宜，省用户额度）。