yuanflow-cli 0.1.7 → 0.1.8

package/README.md

@@ -36,7 +36,7 @@ yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx
 yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --format agent-json
 yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
 yuanflow-cli knowledge docs --format agent-json
-yuanflow-cli knowledge entry --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
+yuanflow-cli knowledge entry --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
 yuanflow-cli oss signed-url --key path/to/file.png --ttl-seconds 1800 --format agent-json
 yuanflow-cli list douyin
 ```
@@ -96,12 +96,12 @@ Agent 不确定参数时先执行 `commands list`，再用 `schema works.douyin.
 
 ```bash
 yuanflow-cli knowledge docs --format agent-json
-yuanflow-cli knowledge entry --task-intent generate_script --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --format agent-json
-yuanflow-cli knowledge rules --pack-code topic_pain_point_pack --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
-yuanflow-cli knowledge rule-detail --rule-code some_rule_code --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
+yuanflow-cli knowledge entry --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
+yuanflow-cli knowledge rules --pack-code topic_pain_point_pack --output-format short_video_script --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
+yuanflow-cli knowledge rule-detail --rule-code some_rule_code --output-format short_video_script --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
 ```
 
-Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`，按接口返回的 `next_actions` 渐进查询。
+Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`，按接口返回的 `next_actions` 渐进查询。v2 接口不要求 `task_intent`；旧字段仅保留兼容。`packs`、`rules` 的 `data` 可能直接是数组，Agent 不应假设固定对象结构，应优先读取 `next_actions` 继续下钻。
 
 ### OSS 原子能力
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/347/237/245/350/257/206/345/272/223/SKILL.md

@@ -50,10 +50,10 @@ yuanflow-cli knowledge docs --format agent-json
 
 ```bash
 yuanflow-cli knowledge entry \
-  --task-intent generate_script \
   --output-format short_video_script \
   --domain 自媒体运营 \
   --content-goal "写一个面向创业者的短视频选题" \
+  --target-audience 创业者 \
   --tone 清晰直接 \
   --communication-mode 口播 \
   --format agent-json
@@ -64,8 +64,9 @@ yuanflow-cli knowledge entry \
 ```bash
 yuanflow-cli knowledge rules \
   --pack-code topic_pain_point_pack \
-  --task-intent generate_script \
+  --output-format short_video_script \
   --content-goal "写一个面向创业者的短视频选题" \
+  --target-audience 创业者 \
   --format agent-json
 ```
 
@@ -80,14 +81,14 @@ yuanflow-cli knowledge rules \
   "args": [
     "knowledge",
     "entry",
-    "--task-intent",
-    "generate_script",
     "--output-format",
     "short_video_script",
     "--domain",
     "自媒体运营",
     "--content-goal",
     "写一个面向创业者的短视频选题",
+    "--target-audience",
+    "创业者",
     "--format",
     "agent-json"
   ]
@@ -100,4 +101,6 @@ yuanflow-cli knowledge rules \
 - 不要使用 `/atomic/aliyun-db/query` 查询知识库内部表。
 - 不要把知识库核心方法论静态写入回复，只按接口返回内容使用。
 - 如果接口返回 `next_actions`，优先按它推荐的动作继续查询。
+- v2 接口不要求 `task_intent`；旧字段只作为兼容字段，不要在新调用里默认填写。
+- `packs`、`rules` 的 `data` 可能直接是数组，不要假设固定 `{ packs: [] }` 或 `{ rules: [] }` 结构。
 - 如果用户只是在问“有什么知识库方向”，先用 `knowledge docs`。

package/src/agent-protocol.js

@@ -29,12 +29,27 @@ const ERROR_MAP = [
     retryable: false,
     test: (message) => message.includes('HTTP 401') || message.includes('HTTP 403'),
   },
+  {
+    code: 'UPSTREAM_CONFIG_ERROR',
+    exitCode: 4,
+    retryable: false,
+    test: (message) => message.includes('原子能力主站令牌未配置'),
+  },
   {
     code: 'UPSTREAM_ERROR',
     exitCode: 4,
     retryable: true,
     test: (message) => /HTTP 5\d\d/.test(message),
   },
+  {
+    code: 'UPSTREAM_ROUTE_MISSING',
+    exitCode: 4,
+    retryable: false,
+    test: (message) =>
+      message.includes('Invalid URL') ||
+      message.includes('接口返回了前端 HTML 页面') ||
+      message.includes('接口返回了非 JSON 内容'),
+  },
   {
     code: 'NETWORK_ERROR',
     exitCode: 5,

package/src/atomic-request.js

@@ -45,11 +45,22 @@ export async function callAtomic(path, options = {}) {
   });
 
   const text = await response.text();
+  const contentType = response.headers.get('content-type') || '';
   const payload = parseMaybeJson(text);
   if (!response.ok) {
     const message = typeof payload === 'object' ? JSON.stringify(payload) : text;
     throw new Error(`请求失败：HTTP ${response.status} ${message}`);
   }
+  if (options.expectJson !== false) {
+    assertJsonResponse({
+      contentType,
+      method,
+      path: normalizedPath,
+      status: response.status,
+      payload,
+      text,
+    });
+  }
   return payload;
 }
 
@@ -95,6 +106,34 @@ function parseMaybeJson(text) {
   }
 }
 
+function assertJsonResponse({ contentType, method, path, status, payload, text }) {
+  if (payload !== null && typeof payload === 'object') {
+    return;
+  }
+  const preview = compactPreview(text);
+  const isHtml = looksLikeHtml(text) || contentType.toLowerCase().includes('text/html');
+  if (isHtml) {
+    throw new Error(
+      `接口返回了前端 HTML 页面，不是结构化 JSON。请检查云端接口是否已部署或路径是否正确：HTTP ${status} ${method} ${path}。返回预览：${preview}`,
+    );
+  }
+  throw new Error(
+    `接口返回了非 JSON 内容。请检查云端接口是否已部署或路径是否正确：HTTP ${status} ${method} ${path}。返回预览：${preview}`,
+  );
+}
+
+function looksLikeHtml(text) {
+  const normalized = String(text || '').trim().toLowerCase();
+  return normalized.startsWith('<!doctype') || normalized.startsWith('<html') || normalized.includes('<html');
+}
+
+function compactPreview(text) {
+  return String(text || '')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .slice(0, 160);
+}
+
 function maskToken(token) {
   if (!token) {
     return '';

package/src/cli.js

@@ -539,7 +539,7 @@ function printHelp() {
   yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --dry-run
   yuanflow-cli search users --platform instagram --keyword "nasa" --dry-run
   yuanflow-cli knowledge docs --dry-run
-  yuanflow-cli knowledge entry --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
+  yuanflow-cli knowledge entry --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
   yuanflow-cli oss signed-url --key path/to/file.png --ttl-seconds 1800 --format agent-json
   yuanflow-cli list douyin
 

package/src/knowledge-tools.js

@@ -92,10 +92,11 @@ function knowledgeCommand(action, description, extraOptions = []) {
 
 function taskFrameOptions() {
   return [
-    { flag: '--task-intent', name: 'taskIntent', required: false, label: '任务意图，例如 generate_script、generate_copy、evaluate_content。' },
+    { flag: '--task-intent', name: 'taskIntent', required: false, label: '兼容旧字段；v2 接口不要求填写。' },
     { flag: '--output-format', name: 'outputFormat', required: false, label: '输出格式，例如 short_video_script、social_post、any。' },
     { flag: '--domain', name: 'domain', required: false, label: '内容领域。' },
     { flag: '--content-goal', name: 'contentGoal', required: false, label: '具体创作或评估目标。' },
+    { flag: '--target-audience', name: 'targetAudience', required: false, label: '目标受众，例如 创业者、宝妈、普通用户。' },
     { flag: '--tone', name: 'tone', required: false, label: '语气风格。' },
     { flag: '--communication-mode', name: 'communicationMode', required: false, label: '表达方式，例如 口播、图文、文章。' },
     { flag: '--task-frame-file', name: 'taskFrameFile', required: false, label: '读取 task_frame JSON 文件。' },
@@ -116,10 +117,11 @@ async function buildTaskFrame(options) {
     : {};
   return removeUndefined({
     ...fromFile,
-    task_intent: pick(options, 'task-intent', fromFile.task_intent || 'general'),
+    task_intent: pick(options, 'task-intent', fromFile.task_intent),
     output_format: pick(options, 'output-format', fromFile.output_format || 'any'),
     domain: pick(options, 'domain', fromFile.domain || '自媒体运营'),
     content_goal: pick(options, 'content-goal', fromFile.content_goal || ''),
+    target_audience: pick(options, 'target-audience', fromFile.target_audience || ''),
     tone: pick(options, 'tone', fromFile.tone || ''),
     communication_mode: pick(options, 'communication-mode', fromFile.communication_mode || ''),
   });