yuanflow-cli 0.1.0 → 0.1.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 YuanFlow
+Copyright (c) 2026 zktlove
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,77 +1,61 @@
 # yuanflow-cli
 
-Agent-friendly local CLI wrapper for YuanFlow cloud APIs.
+YuanFlow 的 npm 包，包含两个命令入口：
+
+- `yuanflow-cli`：社媒 API 转 CLI，覆盖完整 registry、快捷命令、schema、dry-run 和 agent-json 输出。
+- `yuanflow-skill`：把 `YuanFlow-skill` 注入到本机支持的 AI Agent skills 目录。
 
 ## 安装
 
+需要 Node.js 20 或更高版本。
+
 ```bash
 npm install -g yuanflow-cli
 ```
 
-## 初始化 token
-
-推荐直接写入本地配置：
+安装后可用：
 
 ```bash
-ycloud config set-token <your-token>
+yuanflow-cli --help
+yuanflow-skill list-agents
 ```
 
-也支持环境变量：
+## API CLI
 
 ```bash
-export YUANCHUANG_API_TOKEN=<your-token>
+yuanflow-cli config set-token <你的令牌>
+yuanflow-cli config set-base-url https://open.yuanchuangai.com
+yuanflow-cli douyin video-detail "https://v.douyin.com/xxx/" --format agent-json
+yuanflow-cli shortcuts douyin
+yuanflow-cli commands list
+yuanflow-cli schema douyin.video-detail
+yuanflow-cli list douyin
 ```
 
-Windows PowerShell:
+环境变量：
 
-```powershell
-$env:YUANCHUANG_API_TOKEN="<your-token>"
+```bash
+YUANFLOW_TOKEN=<你的令牌>
 ```
 
-## 常用命令
+## Skill 安装器
 
 ```bash
-ycloud auth status
-ycloud commands list --output json
-ycloud health check --output json
-ycloud social bilibili-fetch-one-video-v3 --url "https://www.bilibili.com/video/BV1GJ411x7h7" --output json
+yuanflow-skill list-agents
+yuanflow-skill list-skills
+yuanflow-skill install
+yuanflow-skill install --agent codex,cursor
+yuanflow-skill install --project
+yuanflow-skill install --dry-run
+yuanflow-skill uninstall --agent codex
 ```
 
-## 说明
-
-发布包由仓库内独立的 NPM 封装目录维护，不直接在业务源码根目录做发包逻辑。
-
----
-
-下面内容面向仓库维护者。
-
-## 目录职责
-
-- 独立维护 NPM 发布所需的 `package.json`
-- 生成可发布的 `dist/` 目录
-- 放安装说明、打包脚本、发布收口逻辑
+安装器会自动发现 `YuanFlow-skill` 根目录和一级子目录中的 `SKILL.md`，并以 `yuanflow-skill` bundle 形式注入到目标 Agent。
 
-## 源码来源
+## 开发检查
 
-当前发布包源码来自仓库主源码目录：
-
-- `../../src/ycloud`
-
-打包脚本会把这部分源码复制到：
-
-- `./dist/src/ycloud`
-
-这样做的目的很简单：
-
-- NPM 封装逻辑和 CLI 主源码分离
-- 后续调整发布逻辑时，不容易和 CLI 开发逻辑冲突
-
-## 常用命令
-
-```powershell
-npm run build
-npm run check:version-sync
-npm run check:publish
-npm run pack:dry-run
-npm run pack
+```bash
+npm test
+npm run pack:check
+npm run release:check
 ```

package/bin/yuanflow-cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+import { main } from '../src/cli.js';
+import { createAgentError } from '../src/agent-protocol.js';
+
+function parseFormat(argv) {
+  const index = argv.indexOf('--format');
+  if (index === -1) {
+    return '';
+  }
+  return argv[index + 1] || '';
+}
+
+main(process.argv).catch((error) => {
+  if (parseFormat(process.argv.slice(2)) === 'agent-json') {
+    const { payload, exitCode } = createAgentError(
+      process.argv.slice(2, 4).filter((item) => !item.startsWith('--')).join(' '),
+      error,
+    );
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+    process.exitCode = exitCode;
+    return;
+  }
+  console.error(error?.message || error);
+  process.exitCode = 1;
+});

package/bin/yuanflow-skill.cjs

@@ -0,0 +1,334 @@
+#!/usr/bin/env node
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { execFileSync } = require('node:child_process');
+
+const { getSupportedAgents, detectInstalledAgents, getAgentConfig } = require('../lib/skill-installer/agents.cjs');
+const { discoverSkills } = require('../lib/skill-installer/discover-skills.cjs');
+const { installSkills, uninstallSkills } = require('../lib/skill-installer/installer.cjs');
+const { buildReleaseChecklist } = require('../lib/skill-installer/publish.cjs');
+const { prepareSkillSource, readRepositoryConfig } = require('../lib/skill-installer/repo-source.cjs');
+
+function print(message = '') {
+  process.stdout.write(`${message}\n`);
+}
+
+function printError(message) {
+  process.stderr.write(`${message}\n`);
+}
+
+function parseArgs(argv) {
+  const args = { _: [] };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const current = argv[index];
+
+    if (current === '--agent') {
+      args.agent = (argv[index + 1] || '')
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+      index += 1;
+      continue;
+    }
+
+    if (current === '--mode') {
+      args.mode = argv[index + 1] || 'symlink';
+      index += 1;
+      continue;
+    }
+
+    if (current === '--scope') {
+      args.scope = argv[index + 1] || 'global';
+      index += 1;
+      continue;
+    }
+
+    if (current === '--skill') {
+      args.skill = (argv[index + 1] || '')
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+      index += 1;
+      continue;
+    }
+
+    if (current === '--dry-run') {
+      args.dryRun = true;
+      continue;
+    }
+
+    if (current === '--project') {
+      args.scope = 'project';
+      continue;
+    }
+
+    if (current === '--global') {
+      args.scope = 'global';
+      continue;
+    }
+
+    if (current === '--postinstall') {
+      args.postinstall = true;
+      continue;
+    }
+
+    args._.push(current);
+  }
+
+  return args;
+}
+
+function shouldSkipPostinstall() {
+  if (process.env.YUANFLOW_SKILL_SKIP_POSTINSTALL === '1') {
+    return true;
+  }
+
+  const isGlobalInstall =
+    process.env.npm_config_global === 'true' || process.env.npm_config_location === 'global';
+
+  return !isGlobalInstall;
+}
+
+function getPackageRoot() {
+  return path.resolve(__dirname, '..');
+}
+
+function listAgents() {
+  const supportedAgents = getSupportedAgents();
+  const detectedAgents = detectInstalledAgents();
+
+  print('Supported agents:');
+  for (const agentName of supportedAgents) {
+    const marker = detectedAgents.includes(agentName) ? '[detected]' : '[not detected]';
+    print(`- ${agentName} ${marker}`);
+  }
+}
+
+async function withSkillSource(run) {
+  const packageRoot = getPackageRoot();
+  const prepared = await prepareSkillSource({ packageRoot });
+
+  try {
+    return await run(prepared.sourceRoot);
+  } finally {
+    prepared.cleanup();
+  }
+}
+
+async function listSkills() {
+  const skills = await withSkillSource((sourceRoot) => discoverSkills(sourceRoot));
+
+  print('Discovered skills:');
+  for (const skill of skills) {
+    print(`- ${skill.name} -> ${skill.sourceDir}`);
+  }
+}
+
+function resolveAgents(requestedAgents) {
+  if (requestedAgents && requestedAgents.length > 0) {
+    return requestedAgents.map((agentName) => getAgentConfig(agentName));
+  }
+
+  return detectInstalledAgents().map((agentName) => getAgentConfig(agentName));
+}
+
+function resolveSkills(sourceRoot, requestedSkillNames) {
+  const skills = discoverSkills(sourceRoot);
+
+  if (!requestedSkillNames || requestedSkillNames.length === 0) {
+    return skills;
+  }
+
+  const requested = new Set(requestedSkillNames.map((item) => item.toLowerCase()));
+  return skills.filter((skill) => requested.has(skill.name.toLowerCase()));
+}
+
+function printInstallResults(results) {
+  for (const result of results) {
+    const actionLabel = result.dryRun ? 'Would install' : 'Installed';
+    const overwriteLabel =
+      result.overwriteCanonical || result.overwriteTarget ? ' overwrite' : '';
+    print(
+      `${actionLabel} ${result.skillName} -> ${result.agentName} (${result.installedBy}, ${result.scope}${overwriteLabel})`
+    );
+    print(`  ${result.targetDir}`);
+  }
+}
+
+function printUninstallResults(results) {
+  for (const result of results) {
+    const actionLabel = result.dryRun ? 'Would remove' : 'Removed';
+    print(`${actionLabel} ${result.skillName} -> ${result.agentName} (${result.scope})`);
+    print(`  ${result.targetDir}`);
+  }
+}
+
+async function runInstall(options = {}) {
+  const packageRoot = getPackageRoot();
+  const agents = resolveAgents(options.agent);
+
+  if (agents.length === 0) {
+    print('No supported agent installation was detected. Nothing to install.');
+    return 0;
+  }
+
+  const results = await withSkillSource((sourceRoot) => {
+    const skills = resolveSkills(sourceRoot, options.skill);
+
+    if (skills.length === 0) {
+      print('No matching skills were found in the skill repository.');
+      return 1;
+    }
+
+    return installSkills({
+      packageRoot,
+      skills,
+      targetAgents: agents,
+      mode: options.mode || 'symlink',
+      scope: options.scope || 'global',
+      cwd: process.cwd(),
+      dryRun: Boolean(options.dryRun),
+    });
+  });
+
+  if (typeof results === 'number') {
+    return results;
+  }
+
+  printInstallResults(results);
+  return 0;
+}
+
+function runUpdate(options = {}) {
+  return runInstall(options);
+}
+
+async function runUninstall(options = {}) {
+  const agents = resolveAgents(options.agent);
+
+  if (agents.length === 0) {
+    print('No supported agent installation was detected. Nothing to remove.');
+    return 0;
+  }
+
+  const results = await withSkillSource((sourceRoot) => {
+    const skills = resolveSkills(sourceRoot, options.skill);
+
+    if (skills.length === 0) {
+      print('No matching skills were found in the skill repository.');
+      return 1;
+    }
+
+    return uninstallSkills({
+      bundleName: skills.find((skill) => skill.rootSkill)?.name || 'yuanflow-skill',
+      targetAgents: agents,
+      scope: options.scope || 'global',
+      cwd: process.cwd(),
+      dryRun: Boolean(options.dryRun),
+    });
+  });
+
+  if (typeof results === 'number') {
+    return results;
+  }
+
+  printUninstallResults(results);
+  return 0;
+}
+
+function runReleaseCheck() {
+  const packageRoot = getPackageRoot();
+  const packageJson = JSON.parse(
+    fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8')
+  );
+  const repoConfig = readRepositoryConfig(packageRoot);
+  const checklist = buildReleaseChecklist({
+    packageJson,
+    packageRoot,
+    repoConfig,
+  });
+
+  print('Release checklist:');
+  for (const item of checklist.items) {
+    print(`- ${item.ok ? 'OK' : 'FAIL'} ${item.label}`);
+  }
+
+  try {
+    const output = execFileSync('npm', ['view', packageJson.name, 'version', '--json'], {
+      cwd: packageRoot,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      encoding: 'utf8',
+    }).trim();
+    if (output) {
+      print(`- INFO package name exists on npm: ${packageJson.name}`);
+      print(`  latest published version: ${output.replace(/^"|"$/g, '')}`);
+    }
+  } catch {
+    print(`- INFO package name not found on npm or registry query failed: ${packageJson.name}`);
+  }
+
+  return checklist.ok ? 0 : 1;
+}
+
+function runPublishHelp() {
+  print('Publish flow for the npm installer package:');
+  print('1. npm test');
+  print('2. npm run pack:check');
+  print('3. npm run release:check');
+  print('4. npm publish --access public');
+  return 0;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const command = args._[0] || 'install';
+
+  if (args.postinstall && shouldSkipPostinstall()) {
+    return;
+  }
+
+  if (command === 'list-agents') {
+    listAgents();
+    return;
+  }
+
+  if (command === 'list-skills') {
+    await listSkills();
+    return;
+  }
+
+  if (command === 'install') {
+    process.exitCode = await runInstall(args);
+    return;
+  }
+
+  if (command === 'update') {
+    process.exitCode = await runUpdate(args);
+    return;
+  }
+
+  if (command === 'uninstall' || command === 'remove') {
+    process.exitCode = await runUninstall(args);
+    return;
+  }
+
+  if (command === 'release-check') {
+    process.exitCode = runReleaseCheck();
+    return;
+  }
+
+  if (command === 'publish-help') {
+    process.exitCode = runPublishHelp();
+    return;
+  }
+
+  printError(`Unsupported command: ${command}`);
+  process.exitCode = 1;
+}
+
+main().catch((error) => {
+  printError(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});