aixxai 1.4.2 → 1.4.4

package/templates/references/apps.md

@@ -1,150 +1,208 @@
-# 应用层能力（10个应用直连）
-
-让你的AI直接替用户操作真实应用：往钉钉/飞书/企微群发消息、发邮件、建GitHub Issue、推送到微信/iPhone/Discord/Slack。
-
-**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和错误处理。**
-
----
-
-## 订阅制（统一价格）
-
-- **¥2.99/月，全部10个应用不限次使用**（不是每个应用单独买）
-- 购买：调下单接口，`plan` 固定传 `app_monthly`：
-  ```bash
-  curl -X POST http://14.103.27.195/v1/capability/{id}/purchase \
-    -H "Content-Type: application/json" \
-    -d '{"plan": "app_monthly", "user_compute_key": "sk-用户的key"}'
-  ```
-  返回支付链接（`pay_url`），给用户打开付款即可，付完即生效。
-
-## 执行（所有应用统一格式）
-
-```bash
-curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
-  -H "Content-Type: application/json" \
-  -d '{
-    "params": { "参数": "值" },
-    "user_compute_key": "sk-用户的key"
-  }'
-```
-
-能力层地址：`http://14.103.27.195/v1`（和LLM对话的 `{AIXX_BASE_URL}` 不是同一个入口）。
-
----
-
-## 10个应用能力清单
-
-> 带 `*` 的是必填参数，其余可选。
-
-### 1. 钉钉群消息推送（`app-dingtalk-group-send`）
-往钉钉群发消息（通知/日报/告警），支持加签和@人。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `webhook` | * | 群里创建"自定义机器人"得到的webhook地址（https://开头） |
-| `secret` | | 机器人安全设置选了"加签"时填密钥，没选就不填 |
-| `message` | * | 要发送的文本内容 |
-| `at_mobiles` | | 要@的手机号列表（数组） |
-| `at_all` | | 是否@所有人（true/false） |
-
-### 2. 飞书群消息推送（`app-feishu-group-send`）
-往飞书群发消息，支持加签和@所有人。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `webhook` | * | 群里创建"自定义机器人"得到的webhook地址 |
-| `secret` | | 选了"加签"时填密钥 |
-| `message` | * | 要发送的文本内容 |
-| `at_all` | | 是否@所有人（true/false） |
-
-### 3. 企微群消息推送（`app-wecom-group-send`）
-往企业微信群发消息，可@指定成员。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `webhook` | * | 群里创建"群机器人"得到的webhook地址 |
-| `secret` | | 选了"加签"时填密钥 |
-| `message` | * | 要发送的文本内容 |
-| `at_mobiles` | | 要@的手机号列表（数组） |
-| `at_all` | | 是否@所有人（true/false） |
-
-### 4. 邮件发送（`app-email-send`）
-通过任意SMTP邮箱发正式邮件（QQ邮箱/163/Gmail/企业邮箱都行）。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `smtp_host` | * | SMTP服务器（QQ邮箱 smtp.qq.com / 163 smtp.163.com / Gmail smtp.gmail.com） |
-| `smtp_port` | | SSL填465，STARTTLS填587（默认465） |
-| `username` | * | 发件邮箱账号（如 xxx@qq.com） |
-| `password` | * | 邮箱**授权码**（不是登录密码！邮箱设置-账户里开通SMTP时获取） |
-| `to` | * | 收件人邮箱 |
-| `subject` | | 邮件主题（默认"AIXX邮件"） |
-| `message` | * | 邮件正文 |
-
-### 5. GitHub建Issue（`app-github-create-issue`）
-在你的GitHub仓库建Issue（记bug/提需求/记待办）。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `token` | * | Personal Access Token（GitHub → Settings → Developer settings → Tokens创建，勾repo权限） |
-| `repo` | * | 仓库名，owner/repo格式（如 octocat/hello-world） |
-| `title` | * | Issue标题 |
-| `body` | | Issue正文 |
-
-### 6. Server酱微信推送（`app-serverchan-wechat-push`）
-把消息直接推到用户微信（sct.ftqq.com微信扫码拿SendKey）。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `sendkey` | * | SendKey（sct.ftqq.com微信扫码登录后获取，SCT开头） |
-| `title` | | 消息标题（默认"AIXX消息"） |
-| `message` | * | 消息内容（支持Markdown） |
-
-### 7. PushPlus微信推送（`app-pushplus-wechat-push`）
-消息推到微信公众号（pushplus.plus微信登录拿token）。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `token` | * | token（pushplus.plus微信登录后，"一对一推送"页复制） |
-| `title` | | 消息标题 |
-| `message` | * | 消息内容 |
-
-### 8. Bark苹果推送（`app-bark-ios-push`）
-推送通知到iPhone（App Store装Bark App）。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `key` | * | 设备Key（打开Bark App首页直接复制那一串） |
-| `server` | | Bark服务地址（默认官方，自建服务填自己的） |
-| `title` | | 通知标题 |
-| `message` | * | 通知内容 |
-
-### 9. Discord频道推送（`app-discord-webhook-send`）
-往Discord频道发消息，可自定义机器人显示名。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `webhook` | * | 频道设置 → 整合 → Webhook → 新建 → 复制URL |
-| `username` | | 机器人显示名 |
-| `message` | * | 消息内容 |
-
-### 10. Slack频道推送（`app-slack-webhook-send`）
-往Slack频道发消息（Incoming Webhook）。
-| 参数 | 必填 | 说明 |
-|---|---|---|
-| `webhook` | * | Slack → Apps → Incoming Webhook → 添加到频道 → 复制URL |
-| `message` | * | 消息内容 |
-
----
-
-## agent 该怎么做
-
-1. 用户说"帮我发钉钉群通知"这类需求 → 先确认用户有没有对应参数（webhook/token等），**没有就引导用户去拿**（每个能力的参数表里写了怎么拿）
-2. 参数齐了 → 调 `/v1/capability/{id}/execute`，带 `params` 和 `user_compute_key`
-3. 未订阅时执行会返回订阅引导（402类错误）→ 调 `purchase` 接口（`plan=app_monthly`）生成支付链接给用户："应用层订阅¥2.99/月，全部应用不限次，要开吗？"
-4. 发送成功 → 告诉用户"已发送"；失败 → 按错误信息提示用户检查参数（webhook对不对、授权码是不是用成了登录密码等）
-
-**注意**：webhook/token/授权码这类凭据是用户自己的，让用户自己提供，**绝不替用户编造**。用户的凭据只用于本次发送，不要存储、不要外传。
-
-## 错误处理
-
-| 错误 | agent该怎么做 |
-|---|---|
-| 402/未订阅 | 生成订阅支付链接（¥2.99/月）给用户 |
-| 400 缺参数 | 按参数表补齐，缺的问用户要 |
-| 发送失败（凭据错） | 提示用户检查webhook/token/授权码是否正确 |
-| 5xx | 告诉用户"发送暂时异常，稍后再试" |
-
----
-维护者：龙龙（AIXX PM）| 2026-08-14 建立（任务书A）
+# 应用层能力（10个应用直连）
+
+让你的AI直接替用户操作真实应用：往钉钉/飞书/企微群发消息、发邮件、建GitHub Issue、推送到微信/iPhone/Discord/Slack。
+
+**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和错误处理。**
+
+---
+
+## 订阅制（统一价格）
+
+- **¥2.99/月，全部10个应用不限次使用**（不是每个应用单独买）
+- 购买：调下单接口，`plan` 固定传 `app_monthly`：
+  ```bash
+  curl -X POST http://14.103.27.195/v1/capability/{id}/purchase \
+    -H "Content-Type: application/json" \
+    -d '{"plan": "app_monthly", "user_compute_key": "sk-用户的key"}'
+  ```
+  返回支付链接（`pay_url`），给用户打开付款即可，付完即生效。
+
+## 执行（所有应用统一格式）
+
+```bash
+curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
+  -H "Content-Type: application/json" \
+  -d '{
+    "params": { "参数": "值" },
+    "user_compute_key": "sk-用户的key"
+  }'
+```
+
+能力层地址：`http://14.103.27.195/v1`（和LLM对话的 `{AIXX_BASE_URL}` 不是同一个入口）。
+
+---
+
+## 10个应用能力清单
+
+> 带 `*` 的是必填参数，其余可选。
+
+### 1. 钉钉群消息推送（`app-dingtalk-group-send`）
+往钉钉群发消息（通知/日报/告警），支持加签和@人。
+
+> ⚠️ **webhook链接不要用浏览器打开测试（会报 `errcode:43002 需要POST请求`），直接交给agent调用即可验证。** webhook只接受POST，浏览器地址栏是GET请求，报43002不代表配置有问题。
+
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `webhook` | * | 群里创建"自定义机器人"得到的webhook地址（https://开头） |
+| `secret` | | 机器人安全设置选了"加签"时填密钥，没选就不填 |
+| `message` | * | 要发送的文本内容 |
+| `at_mobiles` | | 要@的手机号列表（数组） |
+| `at_all` | | 是否@所有人（true/false） |
+
+**配置指引（用户操作）**：
+1. 打开钉钉目标群 → 右上角"⋯" → 机器人 → 添加机器人 → 选"自定义（通过Webhook接入）"
+2. 名字随便填 → 安全设置勾选"加签" → 完成
+3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，同一页的**密钥**填 `secret`
+4. ⚠️ webhook别用浏览器打开测试（浏览器是GET，钉钉报 `errcode:43002`，不代表配置错了），直接让agent调用验证
+
+### 2. 飞书群消息推送（`app-feishu-group-send`）
+往飞书群发消息，支持加签和@所有人。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `webhook` | * | 群里创建"自定义机器人"得到的webhook地址 |
+| `secret` | | 选了"加签"时填密钥 |
+| `message` | * | 要发送的文本内容 |
+| `at_all` | | 是否@所有人（true/false） |
+
+**配置指引（用户操作）**：
+1. 打开飞书目标群 → 右上角"⋯" → 设置 → 群机器人 → 添加机器人 → 选"自定义机器人"
+2. 名字随便填 → 权限默认 → 安全设置选"签名校验" → 完成
+3. 添加成功页面：复制 **Webhook地址** 填 `webhook`，**签名密钥**填 `secret`
+4. ⚠️ webhook别用浏览器打开测试（GET请求会被拒），直接让agent调用验证
+
+### 3. 企微群消息推送（`app-wecom-group-send`）
+往企业微信群发消息，可@指定成员。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `webhook` | * | 群里创建"群机器人"得到的webhook地址 |
+| `secret` | | 选了"加签"时填密钥 |
+| `message` | * | 要发送的文本内容 |
+| `at_mobiles` | | 要@的手机号列表（数组） |
+| `at_all` | | 是否@所有人（true/false） |
+
+**配置指引（用户操作）**：
+1. 打开企业微信目标群 → 右上角"⋯" → 添加群机器人 → 新建
+2. 名字随便填 → 复制 **Webhook地址** 填 `webhook`
+3. 企微群机器人不支持加签，`secret` 不用填
+4. ⚠️ webhook别用浏览器打开测试（会报错），直接让agent调用验证
+
+### 4. 邮件发送（`app-email-send`）
+通过任意SMTP邮箱发正式邮件（QQ邮箱/163/Gmail/企业邮箱都行）。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `smtp_host` | * | SMTP服务器（QQ邮箱 smtp.qq.com / 163 smtp.163.com / Gmail smtp.gmail.com） |
+| `smtp_port` | | SSL填465，STARTTLS填587（默认465） |
+| `username` | * | 发件邮箱账号（如 xxx@qq.com） |
+| `password` | * | 邮箱**授权码**（不是登录密码！邮箱设置-账户里开通SMTP时获取） |
+| `to` | * | 收件人邮箱 |
+| `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/提需求/记待办）。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `token` | * | Personal Access Token（GitHub → Settings → Developer settings → Tokens创建，勾repo权限） |
+| `repo` | * | 仓库名，owner/repo格式（如 octocat/hello-world） |
+| `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）。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `sendkey` | * | SendKey（sct.ftqq.com微信扫码登录后获取，SCT开头） |
+| `title` | | 消息标题（默认"AIXX消息"） |
+| `message` | * | 消息内容（支持Markdown） |
+
+**配置指引（拿SendKey）**：
+1. 打开 **sct.ftqq.com** → 微信扫码登录
+2. 首页就能看到 **SendKey**（SCT开头），复制填 `sendkey`
+3. 免费账户每天限5条消息，第二天自动重置；不够用可升级额度
+
+### 7. PushPlus微信推送（`app-pushplus-wechat-push`）
+消息推到微信公众号（pushplus.plus微信登录拿token）。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `token` | * | token（pushplus.plus微信登录后，"一对一推送"页复制） |
+| `title` | | 消息标题 |
+| `message` | * | 消息内容 |
+
+**配置指引（拿token）**：
+1. 打开 **pushplus.plus** → 微信扫码登录
+2. 左侧菜单"一对一推送" → 页面上的 **token**（32位）复制填 `token`
+3. 关注它的微信公众号才能收到推送（页面上有二维码）
+
+### 8. Bark苹果推送（`app-bark-ios-push`）
+推送通知到iPhone（App Store装Bark App）。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `key` | * | 设备Key（打开Bark App首页直接复制那一串） |
+| `server` | | Bark服务地址（默认官方，自建服务填自己的） |
+| `title` | | 通知标题 |
+| `message` | * | 通知内容 |
+
+**配置指引（拿Key）**：
+1. App Store 搜索 **Bark** 装（官方免费）
+2. 打开App，首页中间"Your Key is:"下面那串就是设备Key，点击复制填 `key`
+3. 用官方默认服务器，`server` 不用填
+
+### 9. Discord频道推送（`app-discord-webhook-send`）
+往Discord频道发消息，可自定义机器人显示名。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `webhook` | * | 频道设置 → 整合 → Webhook → 新建 → 复制URL |
+| `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）。
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `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 该怎么做
+
+1. 用户说"帮我发钉钉群通知"这类需求 → 先确认用户有没有对应参数（webhook/token等），**没有就引导用户去拿**（每个能力的参数表里写了怎么拿）
+2. 参数齐了 → 调 `/v1/capability/{id}/execute`，带 `params` 和 `user_compute_key`
+3. 未订阅时执行会返回订阅引导（402类错误）→ 调 `purchase` 接口（`plan=app_monthly`）生成支付链接给用户："应用层订阅¥2.99/月，全部应用不限次，要开吗？"
+4. 发送成功 → 告诉用户"已发送"；失败 → 按错误信息提示用户检查参数（webhook对不对、授权码是不是用成了登录密码等）
+
+**注意**：webhook/token/授权码这类凭据是用户自己的，让用户自己提供，**绝不替用户编造**。用户的凭据只用于本次发送，不要存储、不要外传。
+
+## 错误处理
+
+| 错误 | agent该怎么做 |
+|---|---|
+| 402/未订阅 | 生成订阅支付链接（¥2.99/月）给用户 |
+| 400 缺参数 | 按参数表补齐，缺的问用户要 |
+| 发送失败（凭据错） | 提示用户检查webhook/token/授权码是否正确 |
+| 5xx | 告诉用户"发送暂时异常，稍后再试" |
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-14 建立（任务书A）

package/templates/references/chat.md

@@ -1,133 +1,135 @@
-# LLM 对话调用
-
-翻译、写作、改写、总结、分析、问答、代码生成等**需要LLM能力**的请求。
-
-**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和调用方式。**
-
----
-
-## 调用方式（OpenAI 兼容）
-
-```bash
-curl -X POST {AIXX_BASE_URL}/chat/completions \
-  -H "Authorization: Bearer {AIXX_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "deepseek-chat",
-    "messages": [
-      {"role": "user", "content": "用户的实际需求"}
-    ]
-  }'
-```
-
-返回标准 OpenAI 格式，结果在 `choices[0].message.content`。
-
----
-
-## 默认模型选择（重要）
-
-AIXX 会自动选最优模型，但 agent 也可以按任务指定。
-
-> **模型列表持续更新，调 `GET /v1/models` 获取最新，下表仅场景参考。**
-
-| 任务类型 | 推荐模型 | 理由 |
-|---|---|---|
-| 翻译/简单问答/日常 | `deepseek-chat` | 最便宜，日常首选 |
-| 复杂推理/数学 | `deepseek-reasoner` | 带思考过程 |
-| 中文写作/文案 | `deepseek-chat` | 中文能力够用且便宜（glm渠道维护中，文案任务先用deepseek-chat） |
-| 长文档分析 | `moonshot-v1-128k` | 超长上下文 |
-| 复杂任务/最强 | `claude-opus-4-8` | 能力最强 |
-| 通用旗舰 | `gpt-4o` | 通用 |
-| 审美/UI/设计 | （先搜索skill，见 search.md） | 专门skill比通用模型强 |
-| 轻量免费任务 | `glm-4-flash` | 免费，但不支持工具调用(function calling)；需工具调用用 `deepseek-chat` |
-
-**不指定 model 时**：用 `deepseek-chat`（最便宜，省用户额度）。
-
----
-
-## 用户常见请求怎么处理
-
-### "帮我翻译这段"
-1. 用 `deepseek-chat`（翻译最便宜够用）
-2. messages 里放：`把下面的内容翻译成英文：{用户的内容}`
-
-### "用Claude分析这个"
-1. 用户指定了Claude，用 `claude-opus-4-8` 或 `claude-sonnet-4-20250514`
-2. 如果用户额度不够用Claude（402错误），提示用户"额度不足，要不要用deepseek-chat代替（更便宜）"
-
-### "用最便宜的模型做"
-1. 直接用 `deepseek-chat`
-
-### "写个中文文案"
-1. 用 `deepseek-chat`（中文能力够用且便宜；glm渠道维护中，恢复后可用 `glm-4-plus`）
-
----
-
-## agent 该怎么做
-
-1. 判断任务类型 → 选模型（或让AIXX自动选）
-2. 把用户需求组织成 messages
-3. 调 `/chat/completions`
-4. 把 `choices[0].message.content` 转述给用户
-5. **不要直接吐 JSON**，用自然语言回复
-
----
-
-## ⚠️ 敏感问题处理（重要·诚信红线）
-
-有些问题**不要直接转给模型**，agent 要自己判断处理。否则模型会瞎编、损害信誉。
-
-### 必须拦截的问题（别转给模型，agent 自己处理）
-
-| 用户问 | ❌ 错误做法 | ✅ 正确做法 |
-|---|---|---|
-| "我账户还有多少钱""余额""额度" | 转给模型（模型会瞎说"无法查看"） | **调 balance 接口**（见 account.md），用真实数据回答 |
-| "我花了多少""用量" | 转给模型 | 调 billing/usage 接口 |
-| "有哪些模型可用" | 转给模型 | 调 /v1/models 接口 |
-| "怎么充值" | 转给模型 | 引导用 `aixx recharge` 命令 |
-
-**原则**：凡是 AIXX 有接口能查到的事实，**必须调接口拿真实数据**，不能让模型猜。
-
-### 身份/来源问题（转给模型，但要加 system 引导）
-
-用户可能问："你是哪家公司""你是DeepSeek吗""源头是哪里""是不是中转站""官方认证吗"。
-
-**处理方式**：调模型时**必须加 system prompt 引导**，避免模型瞎编或撒谎：
-
-```
-messages: [
-  {"role": "system", "content": "你是通过AIXX平台调用的AI助手。回答身份问题时遵守：
-    1. 如实说明自己的模型身份（是DeepSeek就说DeepSeek，是Claude就说Claude，不冒充别的）
-    2. 不编造'通过官网/APP/官方认证'等不实信息（你实际是通过AIXX统一平台调用的）
-    3. 被问到'是不是官方直连/中转站'时，如实回答：你是通过AIXX这个统一AI平台调用的，AIXX聚合了多家官方模型能力
-    4. 不主动暴露过多技术细节，但绝不撒谎"},
-  {"role": "user", "content": "用户的身份问题"}
-]
-```
-
-**这样模型会**：
-- 是DeepSeek就说DeepSeek（真话）
-- 不再编"官网/APP/官方认证"（去掉幻觉）
-- 被直接问中转时说"通过AIXX统一平台调用"（诚实但不生硬）
-
-### 绝对不能做的事（诚信红线）
-
-- ❌ 冒充别的模型（DeepSeek冒充Claude、套壳）—— 这是 apiyi 式造假，AIXX 永不做
-- ❌ 说"官方认证""官方直连"等不实信息
-- ❌ 把查得到的事实（余额/模型列表）让模型瞎猜
-
-**AIXX 的信誉根基是：模型是真的，账本是实的。** 宁可少说，绝不撒谎。
-
----
-维护者：龙龙（AIXX PM）| 2026-08-09 建立（2.0流量腿）
-
----
-
-## 错误处理
-
-见 [`./aixx-shared.md`](./aixx-shared.md) 的错误表。常见：
-- 402 额度不足：提示用户充值（"您额度不足，可以充值或用更便宜的deepseek-chat"）
-- 404 模型不存在：换用 `deepseek-chat`
-
----
-维护者：龙龙（AIXX PM）| 2026-08-09 建立
+# LLM 对话调用
+
+翻译、写作、改写、总结、分析、问答、代码生成等**需要LLM能力**的请求。
+
+**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和调用方式。**
+
+---
+
+## 调用方式（OpenAI 兼容）
+
+```bash
+curl -X POST {AIXX_BASE_URL}/chat/completions \
+  -H "Authorization: Bearer {AIXX_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "deepseek-chat",
+    "messages": [
+      {"role": "user", "content": "用户的实际需求"}
+    ]
+  }'
+```
+
+返回标准 OpenAI 格式，结果在 `choices[0].message.content`。
+
+---
+
+## 默认模型选择（重要）
+
+AIXX 会自动选最优模型，但 agent 也可以按任务指定。
+
+> **模型列表持续更新，调 `GET /v1/models` 获取最新，下表仅场景参考。**
+
+| 任务类型 | 推荐模型 | 理由 |
+|---|---|---|
+| 翻译/简单问答/日常 | `deepseek-chat` | 最便宜，日常首选 |
+| 复杂推理/数学 | `kimi-k2.6` | 带思考过程（deepseek-reasoner 已下架） |
+| 中文写作/文案 | `deepseek-chat` | 中文能力够用且便宜（glm渠道维护中，文案任务先用deepseek-chat） |
+| 长文档分析 | `moonshot-v1-128k` | 超长上下文 |
+| 复杂任务/最强 | `claude-opus-4-8` | 能力最强 |
+| 通用旗舰 | `gpt-5.5` | 通用 |
+| 审美/UI/设计 | （先搜索skill，见 search.md） | 专门skill比通用模型强 |
+| 轻量免费任务 | `glm-4-flash` | 免费，但不支持工具调用(function calling)；需工具调用用 `deepseek-chat` |
+
+> ⚠️ **推理类模型（kimi-k2.6 / claude系思考模型等）**：max_tokens 要给足（≥2000）。思考token计入max_tokens预算，给小了会返回空内容。
+
+**不指定 model 时**：用 `deepseek-chat`（最便宜，省用户额度）。
+
+---
+
+## 用户常见请求怎么处理
+
+### "帮我翻译这段"
+1. 用 `deepseek-chat`（翻译最便宜够用）
+2. messages 里放：`把下面的内容翻译成英文：{用户的内容}`
+
+### "用Claude分析这个"
+1. 用户指定了Claude，用 `claude-opus-4-8` 或 `claude-sonnet-4-20250514`
+2. 如果用户额度不够用Claude（402错误），提示用户"额度不足，要不要用deepseek-chat代替（更便宜）"
+
+### "用最便宜的模型做"
+1. 直接用 `deepseek-chat`
+
+### "写个中文文案"
+1. 用 `deepseek-chat`（中文能力够用且便宜；glm渠道维护中，恢复后可用 `glm-4-plus`）
+
+---
+
+## agent 该怎么做
+
+1. 判断任务类型 → 选模型（或让AIXX自动选）
+2. 把用户需求组织成 messages
+3. 调 `/chat/completions`
+4. 把 `choices[0].message.content` 转述给用户
+5. **不要直接吐 JSON**，用自然语言回复
+
+---
+
+## ⚠️ 敏感问题处理（重要·诚信红线）
+
+有些问题**不要直接转给模型**，agent 要自己判断处理。否则模型会瞎编、损害信誉。
+
+### 必须拦截的问题（别转给模型，agent 自己处理）
+
+| 用户问 | ❌ 错误做法 | ✅ 正确做法 |
+|---|---|---|
+| "我账户还有多少钱""余额""额度" | 转给模型（模型会瞎说"无法查看"） | **调 balance 接口**（见 account.md），用真实数据回答 |
+| "我花了多少""用量" | 转给模型 | 调 billing/usage 接口 |
+| "有哪些模型可用" | 转给模型 | 调 /v1/models 接口 |
+| "怎么充值" | 转给模型 | 引导用 `aixx recharge` 命令 |
+
+**原则**：凡是 AIXX 有接口能查到的事实，**必须调接口拿真实数据**，不能让模型猜。
+
+### 身份/来源问题（转给模型，但要加 system 引导）
+
+用户可能问："你是哪家公司""你是DeepSeek吗""源头是哪里""是不是中转站""官方认证吗"。
+
+**处理方式**：调模型时**必须加 system prompt 引导**，避免模型瞎编或撒谎：
+
+```
+messages: [
+  {"role": "system", "content": "你是通过AIXX平台调用的AI助手。回答身份问题时遵守：
+    1. 如实说明自己的模型身份（是DeepSeek就说DeepSeek，是Claude就说Claude，不冒充别的）
+    2. 不编造'通过官网/APP/官方认证'等不实信息（你实际是通过AIXX统一平台调用的）
+    3. 被问到'是不是官方直连/中转站'时，如实回答：你是通过AIXX这个统一AI平台调用的，AIXX聚合了多家官方模型能力
+    4. 不主动暴露过多技术细节，但绝不撒谎"},
+  {"role": "user", "content": "用户的身份问题"}
+]
+```
+
+**这样模型会**：
+- 是DeepSeek就说DeepSeek（真话）
+- 不再编"官网/APP/官方认证"（去掉幻觉）
+- 被直接问中转时说"通过AIXX统一平台调用"（诚实但不生硬）
+
+### 绝对不能做的事（诚信红线）
+
+- ❌ 冒充别的模型（DeepSeek冒充Claude、套壳）—— 这是 apiyi 式造假，AIXX 永不做
+- ❌ 说"官方认证""官方直连"等不实信息
+- ❌ 把查得到的事实（余额/模型列表）让模型瞎猜
+
+**AIXX 的信誉根基是：模型是真的，账本是实的。** 宁可少说，绝不撒谎。
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-09 建立（2.0流量腿）
+
+---
+
+## 错误处理
+
+见 [`./aixx-shared.md`](./aixx-shared.md) 的错误表。常见：
+- 402 额度不足：提示用户充值（"您额度不足，可以充值或用更便宜的deepseek-chat"）
+- 404 模型不存在：换用 `deepseek-chat`
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-09 建立