yuanflow-cli 0.1.40 → 0.1.41

package/skills/yuanflow-skill//351/237/263/350/247/206/351/242/221/345/234/250/347/272/277/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -21,11 +21,11 @@ emoji: ☁️
    - 视频：先用 ffmpeg 分离音频，再进入上传流程。
 2. 上传前把待上传音频整理为英文文件名。
    - 官方参数只要求 `metadata.audio_url` 是可公网访问的音频 URL，没有说明必须英文文件名。
-   - 但为避免 OSS URL 编码、上游下载和中文文件名兼容问题，上传前必须使用 ASCII 英文文件名，例如 `transcription-input.mp3`。
-3. 使用 `OSS文件中转工具` 上传音频。
-4. 从 OSS 返回中优先取 `data.signed_url` 作为 ASR 的 `metadata.audio_url`。
-   - 不要优先使用裸域名 `data.url`；实测裸域名可能导致上游报 `Invalid audio URI` 或音频下载失败。
-   - 如果只有 `data.url`，必须补齐 `https://` 后再尝试；失败时说明 OSS URL 不可被 ASR 上游下载。
+   - 但为避免文件中转 URL 编码、服务下载和中文文件名兼容问题，上传前必须使用 ASCII 英文文件名，例如 `transcription-input.mp3`。
+3. 使用 `YuanFlow 文件中转工具` 上传音频。
+4. 从文件中转返回中优先取 `data.signed_url` 作为 ASR 的 `metadata.audio_url`。
+   - 不要优先使用裸域名 `data.url`；实测裸域名可能导致 `Invalid audio URI` 或音频下载失败。
+   - 如果只有 `data.url`，必须补齐 `https://` 后再尝试；失败时说明该文件中转 URL 不可被 ASR 服务下载。
 5. 调用在线 ASR 接口。
 6. 默认只把干净文本返回给用户，不展示原始 JSON。
 7. 只有用户明确要求时间戳、分句、原始结构或调试信息时，才返回 JSON 摘要或原始字段。
@@ -40,9 +40,9 @@ ffmpeg -y -i "C:\path\to\input.mp4" -vn -acodec libmp3lame -ar 44100 -ac 2 "tran
 
 如果 ffmpeg 不可用，必须明确告诉用户缺少 ffmpeg，不能伪造转写结果。
 
-## OSS 上传
+## YuanFlow 文件中转
 
-YuanFlow 主程序内优先调用 `yuanflow_cli_call`，使用 OSS 子命令上传英文命名后的音频：
+YuanFlow 主程序内优先调用 `yuanflow_cli_call`，使用兼容子命令 `oss` 上传英文命名后的音频：
 
 ```json
 {
@@ -95,7 +95,7 @@ Content-Type: application/json
   "model": "doubao-asr",
   "response_format": "json",
   "metadata": {
-    "audio_url": "<OSS signed_url>"
+    "audio_url": "<YuanFlow 文件中转 signed_url>"
   }
 }
 ```
@@ -110,7 +110,7 @@ Content-Type: application/json
     "model": "doubao-asr",
     "response_format": "json",
     "metadata": {
-      "audio_url": "<OSS signed_url>"
+      "audio_url": "<YuanFlow 文件中转 signed_url>"
     }
   },
   "timeout": 180
@@ -138,6 +138,6 @@ Content-Type: application/json
 ## 失败处理
 
 - `Invalid audio URI` / `audio download failed`：优先检查是否误用了 `data.url` 裸域名；改用 `data.signed_url` 重试。
-- OSS 上传成功但 ASR 失败：说明 OSS key 已生成，但上游无法下载或识别该 URL。
+- YuanFlow 文件中转上传成功但 ASR 失败：说明文件对象已生成，但 ASR 服务无法下载或识别该 URL。
 - 视频抽音频失败：报告 ffmpeg 错误，不继续调用 ASR。
 - 不要暴露 token、Authorization header、签名 URL 的完整敏感查询参数，除非用户明确需要调试链接。

package/src/agent-protocol.js

@@ -7,6 +7,7 @@ import { listBrowserCommands } from './browser-tools.js';
 import { listSearchCommands, listWorkCommands } from './work-tools.js';
 import { listVideoCommands } from './video-tools.js';
 import { listTrendingCommands } from './trending-tools.js';
+import { listAiCommands } from './ai-tools.js';
 
 const ERROR_MAP = [
   {
@@ -33,19 +34,19 @@ const ERROR_MAP = [
     test: (message) => message.includes('HTTP 401') || message.includes('HTTP 403'),
   },
   {
-    code: 'UPSTREAM_CONFIG_ERROR',
+    code: 'YUANFLOW_CONFIG_ERROR',
     exitCode: 4,
     retryable: false,
     test: (message) => message.includes('原子能力主站令牌未配置'),
   },
   {
-    code: 'UPSTREAM_ERROR',
+    code: 'PLATFORM_SERVICE_ERROR',
     exitCode: 4,
     retryable: true,
     test: (message) => /HTTP 5\d\d/.test(message),
   },
   {
-    code: 'UPSTREAM_ROUTE_MISSING',
+    code: 'YUANFLOW_ROUTE_MISSING',
     exitCode: 4,
     retryable: false,
     test: (message) =>
@@ -111,6 +112,7 @@ export function buildCommandRegistry() {
   const browserCommands = listBrowserCommands();
   const videoCommands = listVideoCommands();
   const trendingCommands = listTrendingCommands();
+  const aiCommands = listAiCommands();
   return [
     ...shortcuts,
     ...endpoints,
@@ -122,6 +124,7 @@ export function buildCommandRegistry() {
     ...browserCommands,
     ...videoCommands,
     ...trendingCommands,
+    ...aiCommands,
   ].sort((left, right) => left.key.localeCompare(right.key));
 }
 
@@ -151,7 +154,7 @@ export function commandToSchema(command) {
       queryParams: command.queryParams || [],
       requestBody: command.requestBody || null,
     },
-    returns: command.returns || '返回字段以上游接口实际响应为准。',
+    returns: command.returns || '返回字段以 YuanFlow API 实际响应为准。',
   };
 }
 
@@ -192,7 +195,7 @@ function endpointToCommand(endpoint) {
     })),
     queryParams: endpoint.queryParams || [],
     requestBody: endpoint.bodyExample,
-    returns: '返回字段以上游接口实际响应为准。',
+    returns: '返回字段以 YuanFlow API 实际响应为准。',
   };
 }