yuanflow-cli 0.1.5 → 0.1.7

package/skills/yuanflow-skill//347/273/274/345/220/210/347/224/250/346/210/267/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: 综合用户搜索工具
+description: Use when the user wants to search creators, accounts, users, channels, authors, or profiles across Douyin, Xiaohongshu, WeChat Channels, TikTok, Instagram, Kuaishou, Weibo, YouTube, or Zhihu.
+builtin_skill_version: 1.0.0
+tags:
+  - 自媒体
+  - 用户搜索
+  - 作者搜索
+  - 账号搜索
+emoji: 👤
+---
+
+# 综合用户搜索工具
+
+本技能把用户的“搜索账号、作者、用户、频道、达人”需求稳定映射到 `yuanflow-cli search users`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+
+## 什么时候使用
+
+用户出现以下意图时使用：
+
+- 按关键词搜索某个平台上的账号、作者、达人、用户、频道。
+- 查找某个品牌、昵称、抖音号、小红书号、YouTube 频道等候选账号。
+- 做账号调研、达人筛选、用户线索查找。
+
+不要用于搜索作品、笔记、文章、帖子或视频；内容搜索应使用 `综合搜索工具`。不要用于批量抓取、绕过平台限制或未授权数据访问。
+
+## 调用优先级
+
+1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `search users` 开始。
+2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli search users ...`。
+3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
+
+YuanFlow 内置调用示例：
+
+```json
+{
+  "args": [
+    "search",
+    "users",
+    "--platform",
+    "instagram",
+    "--keyword",
+    "nasa",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+外部 CLI 示例：
+
+```powershell
+yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
+```
+
+## 先查命令和 schema
+
+不确定参数时先查，不要猜：
+
+```json
+{"args":["commands","list"]}
+{"args":["schema","search.instagram.users"]}
+{"args":["schema","search.douyin.users"]}
+```
+
+命令 key 格式是：
+
+```text
+search.<platform>.users
+```
+
+## 平台识别
+
+| 平台参数 | 用户常见说法 | 搜索对象 | 常用补充参数 |
+|---|---|---|---|
+| `douyin` | 抖音、Douyin | 用户、达人、账号 | `--cursor` |
+| `xiaohongshu` | 小红书、XHS | 用户 | `--page` |
+| `wechat_channels` | 微信视频号、视频号 | 视频号用户 | `--page` |
+| `tiktok` | TikTok | 用户 | `--offset`、`--count` |
+| `instagram` | Instagram、ins | 用户 | `--rank-token` |
+| `kuaishou` | 快手 | 用户 | `--page` |
+| `weibo` | 微博 | 用户 | `--page`、`--region`、`--auth`、`--gender` |
+| `youtube` | YouTube、油管 | 频道 | `--continuation-token` |
+| `zhihu` | 知乎 | 用户 | `--offset`、`--limit` |
+
+B站、Reddit、Twitter/X 当前没有单独接入稳定用户搜索综合命令；如果用户指定这些平台，先说明当前工具不支持单独用户搜索，再建议使用 `综合搜索工具` 做内容/综合搜索，或用 `yuanflow-cli commands list` 查找可用原子接口。
+
+## 参数规则
+
+通用参数：
+
+- `--platform`：平台标识。
+- `--keyword`：用户、账号、频道或达人关键词。
+- `--cursor`、`--offset`、`--page`、`--continuation-token`：翻页参数，必须来自上一次响应，不要编造。
+- `--count`、`--limit`：数量参数，仅平台支持时传。
+- `--extra`：JSON 字符串补充参数。
+- `--format agent-json`：Agent 调用时必须加，便于稳定解析。
+
+## 输出要求
+
+成功后用中文简短说明：
+
+- 搜索的平台和关键词。
+- 返回结果中的昵称、账号 ID、主页标识、粉丝数等常用字段要按用户需求整理。
+- 如果响应里有下一页游标或 continuation token，要提示用户。
+
+失败时按 `agent-json` 的 `error.code` 和 `error.message` 解释。不要展示完整 Authorization 请求头、token、cookie 或敏感账号信息。

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

@@ -0,0 +1,103 @@
+---
+name: 自媒体知识库
+description: 当用户需要做自媒体选题、开头钩子、脚本、文案、标题、改写、评分、剪辑建议、发布策略，或明确要求查询 YuanFlow 自媒体知识库时使用。
+---
+
+# 自媒体知识库
+
+这个 Skill 负责使用 YuanFlow 的自媒体知识库原子能力。它和社媒数据采集、作品评论、作品下载是独立能力，不要混用接口。
+
+## 环境判断
+
+1. 在 YuanFlow 主程序内，优先调用内置工具 `yuanflow_cli_call`。
+2. 在外部 Agent 中，如果本地有 `yuanflow-cli`，直接执行 CLI。
+3. 如果外部环境没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
+
+不要让用户手动提供 token。YuanFlow 主程序会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+
+## 能做什么
+
+适合以下任务：
+
+- 选题生成、选题分析。
+- 开头钩子、短视频脚本、口播脚本。
+- 自媒体文案、标题、内容改写。
+- 内容评分、复盘、优化建议。
+- 剪辑建议、发布策略、平台适配。
+
+当前公开方向包括：
+
+- `topic_generation`：选题生成。
+- `hook_generation`：开头钩子。
+- `script_generation`：脚本生成。
+- `topic_analysis`：选题分析。
+- `content_evaluation`：内容评分。
+- `copywriting`：文案创作。
+- `title_generation`：标题生成。
+- `rewrite`：内容改写。
+- `editing_strategy`：剪辑建议。
+- `publishing_strategy`：发布策略。
+
+## 推荐流程
+
+1. 先查看知识库公开目录：
+
+```bash
+yuanflow-cli knowledge docs --format agent-json
+```
+
+2. 把用户需求整理为 `task_frame`，再进入知识库：
+
+```bash
+yuanflow-cli knowledge entry \
+  --task-intent generate_script \
+  --output-format short_video_script \
+  --domain 自媒体运营 \
+  --content-goal "写一个面向创业者的短视频选题" \
+  --tone 清晰直接 \
+  --communication-mode 口播 \
+  --format agent-json
+```
+
+3. 读取返回结果里的 `next_actions`，继续调用 `packs`、`rules` 或 `rule-detail`。
+
+```bash
+yuanflow-cli knowledge rules \
+  --pack-code topic_pain_point_pack \
+  --task-intent generate_script \
+  --content-goal "写一个面向创业者的短视频选题" \
+  --format agent-json
+```
+
+4. 最后基于接口返回的公开规则摘要，完成创作、评估或优化。
+
+## YuanFlow 内置工具调用示例
+
+在 YuanFlow 主程序内，调用 `yuanflow_cli_call`，参数数组不要包含 token：
+
+```json
+{
+  "args": [
+    "knowledge",
+    "entry",
+    "--task-intent",
+    "generate_script",
+    "--output-format",
+    "short_video_script",
+    "--domain",
+    "自媒体运营",
+    "--content-goal",
+    "写一个面向创业者的短视频选题",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+## 注意事项
+
+- 不要让 Agent 自己拼 SQL。
+- 不要使用 `/atomic/aliyun-db/query` 查询知识库内部表。
+- 不要把知识库核心方法论静态写入回复，只按接口返回内容使用。
+- 如果接口返回 `next_actions`，优先按它推荐的动作继续查询。
+- 如果用户只是在问“有什么知识库方向”，先用 `knowledge docs`。

package/src/agent-protocol.js

@@ -1,6 +1,9 @@
 import { listEndpoints } from './registry.js';
 import { listShortcuts } from './shortcuts.js';
 import { listCommentCommands } from './comment-collector.js';
+import { listKnowledgeCommands } from './knowledge-tools.js';
+import { listOssCommands } from './oss-tools.js';
+import { listSearchCommands, listWorkCommands } from './work-tools.js';
 
 const ERROR_MAP = [
   {
@@ -83,9 +86,19 @@ export function buildCommandRegistry() {
   const shortcuts = listShortcuts().map((shortcut) => shortcutToCommand(shortcut));
   const endpoints = listEndpoints().map((endpoint) => endpointToCommand(endpoint));
   const commentCommands = listCommentCommands();
-  return [...shortcuts, ...endpoints, ...commentCommands].sort((left, right) =>
-    left.key.localeCompare(right.key),
-  );
+  const workCommands = listWorkCommands();
+  const searchCommands = listSearchCommands();
+  const knowledgeCommands = listKnowledgeCommands();
+  const ossCommands = listOssCommands();
+  return [
+    ...shortcuts,
+    ...endpoints,
+    ...commentCommands,
+    ...workCommands,
+    ...searchCommands,
+    ...knowledgeCommands,
+    ...ossCommands,
+  ].sort((left, right) => left.key.localeCompare(right.key));
 }
 
 export function findCommandByKey(key) {
@@ -109,7 +122,8 @@ export function commandToSchema(command) {
     api: {
       method: command.method,
       socialPath: command.socialPath,
-      url: `/social${command.socialPath}`,
+      apiPath: command.apiPath,
+      url: command.apiPath || `/social${command.socialPath}`,
       queryParams: command.queryParams || [],
       requestBody: command.requestBody || null,
     },

package/src/atomic-request.js

@@ -0,0 +1,106 @@
+import { readFile } from 'node:fs/promises';
+import { readConfig } from './config.js';
+
+export async function callAtomic(path, options = {}) {
+  const config = await readConfig();
+  const baseUrl = cleanBaseUrl(options.baseUrl || config.baseUrl);
+  const token = options.token || process.env.YUANCHUANG_API_TOKEN || config.token || '';
+  const method = String(options.method || 'POST').toUpperCase();
+  const normalizedPath = normalizePath(path);
+  const url = new URL(normalizedPath, baseUrl);
+  const body = await resolveBody(options);
+
+  if (method === 'GET' && body && typeof body === 'object') {
+    for (const [key, value] of Object.entries(body)) {
+      if (value !== undefined && value !== null) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+
+  if (options.dryRun) {
+    return {
+      dryRun: true,
+      method,
+      url: url.toString(),
+      headers: {
+        ...(token ? { Authorization: `Bearer ${maskToken(token)}` } : {}),
+      },
+      body: method === 'GET' ? undefined : body || {},
+    };
+  }
+
+  if (options.requiresToken !== false && !token) {
+    throw new Error('缺少 token。请设置 YUANCHUANG_API_TOKEN，或执行 yuanflow-cli config set-token <你的令牌>');
+  }
+
+  const response = await fetch(url, {
+    method,
+    headers: {
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      Accept: 'application/json',
+      ...(method === 'GET' ? {} : { 'Content-Type': 'application/json' }),
+    },
+    body: method === 'GET' ? undefined : JSON.stringify(body || {}),
+  });
+
+  const text = await response.text();
+  const payload = parseMaybeJson(text);
+  if (!response.ok) {
+    const message = typeof payload === 'object' ? JSON.stringify(payload) : text;
+    throw new Error(`请求失败：HTTP ${response.status} ${message}`);
+  }
+  return payload;
+}
+
+export async function readJsonFile(filePath) {
+  const raw = await readFile(filePath, 'utf8');
+  const payload = JSON.parse(raw);
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    throw new Error('JSON 文件内容必须是对象。');
+  }
+  return payload;
+}
+
+export function cleanBaseUrl(value) {
+  return (value || 'https://open.yuanchuangai.com').replace(/\/+$/, '');
+}
+
+function normalizePath(path) {
+  const normalized = String(path || '').trim();
+  if (!normalized.startsWith('/')) {
+    return `/${normalized}`;
+  }
+  return normalized;
+}
+
+async function resolveBody(options) {
+  if (options.json) {
+    return JSON.parse(options.json);
+  }
+  if (options.body) {
+    return options.body;
+  }
+  return {};
+}
+
+function parseMaybeJson(text) {
+  if (!text) {
+    return null;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+function maskToken(token) {
+  if (!token) {
+    return '';
+  }
+  if (token.length <= 10) {
+    return '***';
+  }
+  return `${token.slice(0, 6)}...${token.slice(-4)}`;
+}

package/src/cli.js

@@ -17,6 +17,14 @@ import {
 } from './agent-protocol.js';
 import { findShortcut, listShortcuts } from './shortcuts.js';
 import { collectComments } from './comment-collector.js';
+import { getKnowledgeDocs, navigateKnowledge } from './knowledge-tools.js';
+import { copyObject, signedUrl, tempUpload } from './oss-tools.js';
+import {
+  getWorkDetail,
+  getWorkDownload,
+  searchContent,
+  searchUsers,
+} from './work-tools.js';
 
 export async function main(argv) {
   const args = argv.slice(2);
@@ -52,6 +60,26 @@ export async function main(argv) {
     return;
   }
 
+  if (command === 'works') {
+    await handleWorks(rest);
+    return;
+  }
+
+  if (command === 'search') {
+    await handleSearch(rest);
+    return;
+  }
+
+  if (command === 'knowledge') {
+    await handleKnowledge(rest);
+    return;
+  }
+
+  if (command === 'oss') {
+    await handleOss(rest);
+    return;
+  }
+
   if (command === 'schema') {
     await handleSchema(rest);
     return;
@@ -77,6 +105,7 @@ async function handleCommands(args) {
       description: item.description,
       method: item.method,
       socialPath: item.socialPath,
+      apiPath: item.apiPath,
     }));
     await outputResult(
       createAgentSuccess('commands list', { commands }),
@@ -114,6 +143,7 @@ async function handleSchema(args) {
       kind: item.kind,
       method: item.method,
       socialPath: item.socialPath,
+      apiPath: item.apiPath,
     }));
     await outputResult(createAgentSuccess('schema list', { commands }), {
       ...options,
@@ -243,6 +273,113 @@ async function handleComments(args) {
   });
 }
 
+async function handleWorks(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'detail'] = positionals;
+  const platform = options.named?.platform;
+  const target = options.named?.target || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、youtube、bilibili。');
+  }
+  if (!target) {
+    throw new Error('缺少 --target 或目标位置参数。');
+  }
+
+  let result;
+  if (action === 'detail') {
+    result = await getWorkDetail({
+      platform,
+      target,
+      prefer: options.named?.prefer || 'primary',
+      kind: options.named?.kind,
+      targetKind: options.named?.['target-kind'],
+      options,
+    });
+  } else if (action === 'download') {
+    result = await getWorkDownload({
+      platform,
+      target,
+      prefer: options.named?.prefer || 'primary',
+      kind: options.named?.kind,
+      targetKind: options.named?.['target-kind'],
+      options,
+    });
+  } else {
+    throw new Error('未知 works 命令。用法：yuanflow-cli works detail|download --platform douyin --target <作品链接或ID>');
+  }
+  await outputResult(result, options, {
+    command: `works ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: result.endpoint.kind || `work-${action}` },
+  });
+}
+
+async function handleSearch(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'content'] = positionals;
+  const platform = options.named?.platform;
+  const keyword = options.named?.keyword || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、xiaohongshu、instagram。');
+  }
+  if (!keyword) {
+    throw new Error('缺少 --keyword 或关键词位置参数。');
+  }
+
+  let result;
+  if (action === 'content') {
+    result = await searchContent({ platform, keyword, options });
+  } else if (action === 'users' || action === 'user') {
+    result = await searchUsers({ platform, keyword, options });
+  } else {
+    throw new Error('未知 search 命令。用法：yuanflow-cli search content|users --platform douyin --keyword <关键词>');
+  }
+  await outputResult(result, options, {
+    command: `search ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: result.endpoint.kind || `${action}-search` },
+  });
+}
+
+async function handleKnowledge(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'docs'] = positionals;
+  if (action === 'docs') {
+    const result = await getKnowledgeDocs({ options });
+    await outputResult(result, options, {
+      command: 'knowledge docs',
+      meta: { endpoint: result.endpoint.path, kind: 'knowledge-base' },
+    });
+    return;
+  }
+  if (['entry', 'packs', 'rules', 'rule-detail', 'evaluate'].includes(action)) {
+    const result = await navigateKnowledge({ action, options });
+    await outputResult(result, options, {
+      command: `knowledge ${action}`,
+      meta: { endpoint: result.endpoint.path, kind: 'knowledge-base' },
+    });
+    return;
+  }
+  throw new Error('未知 knowledge 命令。用法：yuanflow-cli knowledge docs|entry|packs|rules|rule-detail|evaluate');
+}
+
+async function handleOss(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action] = positionals;
+  let result;
+  if (action === 'temp-upload') {
+    result = await tempUpload({ options });
+  } else if (action === 'signed-url') {
+    result = await signedUrl({ options });
+  } else if (action === 'copy') {
+    result = await copyObject({ options });
+  } else {
+    throw new Error('未知 oss 命令。用法：yuanflow-cli oss temp-upload|signed-url|copy');
+  }
+  await outputResult(result, options, {
+    command: `oss ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: 'oss-atomic' },
+  });
+}
+
 async function handleGeneratedCommand(platform, args) {
   if (!getPlatforms().includes(platform)) {
     throw new Error(`未知平台：${platform}。可用平台：${getPlatforms().join(', ')}`);
@@ -397,10 +534,18 @@ function printHelp() {
   yuanflow-cli commands list
   yuanflow-cli schema douyin.video-detail
   yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --dry-run
+  yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --dry-run
+  yuanflow-cli works download --platform youtube --target "dQw4w9WgXcQ" --dry-run
+  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 oss signed-url --key path/to/file.png --ttl-seconds 1800 --format agent-json
   yuanflow-cli list douyin
 
 说明：
-  所有请求都会调用 Yuan API 的 /social/*path，并使用 Authorization: Bearer <token>。
+  社媒请求调用 Yuan API 的 /social/*path；知识库和 OSS 原子能力调用 /api/* 或 /atomic/*。
+  需要鉴权的请求都会使用 Authorization: Bearer <token>。
   token 优先级：--token > YUANCHUANG_API_TOKEN > 本地 config.token。
   YuanFlow 主程序内使用时，token 由主程序认证系统注入，不需要手动配置。
   AI Agent 推荐使用 --format agent-json 获取稳定 JSON 外壳。