fedincms-cli 0.0.4 → 0.0.5

package/README.md

@@ -1,6 +1,11 @@
 # fedincms-cli
 
-Fedin CMS Skill 的全局 CLI：通过 `fedincms init` 将 Skill 安装到当前项目，在 Cursor 中通过项目内脚本调用 Fedin CMS API，无需运行 MCP Server。
+Fedin CMS Skill 的全局 CLI：通过 `fedincms init` 将 Skill 安装到当前项目，在 **Cursor、CodeBuddy、Claude Code** 等 AI 编程助手中通过项目内脚本调用 Fedin CMS API，无需运行 MCP Server。
+
+## 支持的环境
+
+- **Cursor**：Skill 安装到 `.cursor/skills/fedin-cms/`，开箱即用。
+- **CodeBuddy / Claude Code 等**：执行 `fedincms init` 后，将 `.cursor/skills/fedin-cms/` 整个目录复制到该编辑器所要求的 Skill 目录（请查阅对应文档），或在该编辑器中配置使用项目内脚本路径 `.cursor/skills/fedin-cms/scripts/fedin-cms-cli.js`（需在项目根执行）。
 
 ## 安装
 
@@ -26,17 +31,14 @@ npm install -g @your-scope/fedin-cms-cli
 2. 初始化：只需传入**站点密钥**（格式 `cms_<base64>`），会解密得到 websiteId 与 userId 并写入脚本：
    ```bash
    fedincms init cms_website_key=你的站点密钥
-   # 或带可选 API 地址、密钥
-   fedincms init cms_website_key=你的站点密钥 apiUrl=https://... anonKey=你的密钥
-   # 长选项
-   fedincms init --cms-website-key=你的站点密钥 --api-url=... --anon-key=...
+   fedincms init --cms-website-key=你的站点密钥
    ```
 
-3. 在 Cursor 中打开该项目，AI 将根据 `.cursor/skills/fedin-cms/SKILL.md` 在需要时执行：
+3. 在 Cursor / CodeBuddy / Claude Code 等中打开该项目，AI 助手会根据 SKILL 说明在**项目根**执行：
    ```bash
    node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]
    ```
-   脚本为单文件（依赖已打包），无需在 `scripts/` 下执行 `npm install`。
+   脚本为单文件（依赖已打包），无需在 `scripts/` 下执行 `npm install`。若在其它编辑器中已将 Skill 复制到别处，请使用该目录下的 `scripts/fedin-cms-cli.js` 路径。
 
 ## 发布到 npm
 

package/dist/cli.js

@@ -3,10 +3,28 @@
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
+const inquirer = require('inquirer');
 
 const TEMPLATE_DIR = path.join(__dirname, '..', 'templates', 'skill');
-const SKILL_DIR = '.cursor/skills/fedin-cms';
-const SKILL_SCRIPTS_DIR = '.cursor/skills/fedin-cms/scripts';
+
+// --ai 预设：决定 Skill 安装到哪个目录；交互式时只展示 AI_CHOICES 列表
+const AI_SKILL_BASE = {
+  cursor: '.cursor/skills',
+  codebuddy: '.codebuddy/skills',
+  claude: '.claude/skills',
+};
+const AI_CHOICES = ['cursor', 'codebuddy', 'claude'];
+
+function getSkillDir(ai) {
+  const key = (ai || 'cursor').toLowerCase().trim();
+  const base = AI_SKILL_BASE[key];
+  if (!base) {
+    console.error('fedincms init: 不支持的 AI 助手: ' + ai + '。支持: cursor, codebuddy, claude');
+    process.exit(1);
+  }
+  return base + '/fedin-cms';
+}
 
 /**
  * 解密站点密钥，得到 websiteId 和 userId
@@ -47,12 +65,16 @@ function parseArgs(argv) {
         const k = arg.slice(2, eq).replace(/-/g, '');
         const v = arg.slice(eq + 1);
         if (k === 'cmswebsitekey' || k === 'cms_website_key') args.cmsWebsiteKey = v;
+        else if (k === 'ai') args.ai = v;
+      } else if (arg === '--ai' && argv[i + 1]) {
+        args.ai = argv[++i];
       }
       continue;
     }
     if (arg.includes('=')) {
       const [k, v] = arg.split('=').map(s => s.trim());
       if (k === 'cms_website_key' || k === 'cmsWebsiteKey') args.cmsWebsiteKey = v;
+      else if (k === 'ai') args.ai = v;
       continue;
     }
     args._.push(arg);
@@ -74,6 +96,17 @@ function copyFile(src, dest, force) {
   return true;
 }
 
+// 复制文件并替换内容中的 __FEDINCMS_SCRIPT_PATH__
+function copyFileWithScriptPath(srcPath, destRel, scriptPath, force) {
+  const destFull = path.join(process.cwd(), destRel);
+  if (!force && fs.existsSync(destFull)) return false;
+  ensureDir(path.dirname(destFull));
+  let content = fs.readFileSync(srcPath, 'utf8');
+  content = content.replace(/__FEDINCMS_SCRIPT_PATH__/g, scriptPath);
+  fs.writeFileSync(destFull, content, 'utf8');
+  return true;
+}
+
 // 复制脚本并替换占位符 __FEDINCMS_WEBSITE_ID__、__FEDINCMS_USER_ID__
 function copyScriptWithPlaceholders(srcPath, destRel, placeholders, force) {
   const destFull = path.join(process.cwd(), destRel);
@@ -94,9 +127,9 @@ function runInit(options) {
     process.exit(1);
   }
 
-  const key = options.cmsWebsiteKey;
+  const key = (options.cmsWebsiteKey || '').trim();
   if (!key) {
-    console.error('fedincms init: 缺少必填参数 cms_website_key。用法: fedincms init cms_website_key=xxxxx [apiUrl=...] [anonKey=...]');
+    console.error('fedincms init: 缺少站点密钥。用法: fedincms init cms_website_key=xxxxx [--ai cursor|codebuddy|claude]，或直接运行 fedincms init 按提示输入。');
     process.exit(1);
   }
 
@@ -111,21 +144,25 @@ function runInit(options) {
     process.exit(1);
   }
 
-  const skillDirFull = path.join(cwd, SKILL_DIR);
+  const skillDir = getSkillDir(options.ai);
+  const scriptsDir = skillDir + '/scripts';
+  const scriptPath = skillDir + '/scripts/fedin-cms-cli.js';
+
+  const skillDirFull = path.join(cwd, skillDir);
   const exists = fs.existsSync(skillDirFull);
   if (exists && !options.force) {
-    console.log('fedincms: .cursor/skills/fedin-cms/ 已存在，跳过复制。使用 --force 覆盖。');
+    console.log('fedincms: ' + skillDir + '/ 已存在，跳过复制。使用 --force 覆盖。');
   } else {
-    ensureDir(SKILL_SCRIPTS_DIR);
+    ensureDir(scriptsDir);
     const skillMd = path.join(templateBase, 'SKILL.md');
     const refMd = path.join(templateBase, 'reference.md');
     const scriptJs = path.join(templateBase, 'scripts', 'fedin-cms-cli.js');
-    if (fs.existsSync(skillMd)) copyFile(skillMd, path.join(SKILL_DIR, 'SKILL.md'), options.force);
-    if (fs.existsSync(refMd)) copyFile(refMd, path.join(SKILL_DIR, 'reference.md'), options.force);
-    if (fs.existsSync(scriptJs)) copyScriptWithPlaceholders(scriptJs, path.join(SKILL_DIR, 'scripts', 'fedin-cms-cli.js'), { websiteId, userId }, options.force);
+    if (fs.existsSync(skillMd)) copyFileWithScriptPath(skillMd, skillDir + '/SKILL.md', scriptPath, options.force);
+    if (fs.existsSync(refMd)) copyFileWithScriptPath(refMd, skillDir + '/reference.md', scriptPath, options.force);
+    if (fs.existsSync(scriptJs)) copyScriptWithPlaceholders(scriptJs, skillDir + '/scripts/fedin-cms-cli.js', { websiteId, userId }, options.force);
   }
 
-  console.log('Skill 已安装到 .cursor/skills/fedin-cms/');
+  console.log('Skill 已安装到 ' + skillDir + '/');
   console.log('站点 ID 与用户 ID 已从密钥解密并写入脚本。');
   console.log('脚本为单文件打包，无需在 scripts/ 下安装依赖。');
 }
@@ -135,27 +172,87 @@ function printHelp() {
 fedincms init - 将 Fedin CMS Skill 安装到当前项目
 
 用法:
-  fedincms init cms_website_key=<站点密钥>
-  fedincms init --cms-website-key=<站点密钥>
+  交互式（推荐）:
+    fedincms init
+    按提示输入站点密钥，然后从列表选择 AI 助手（cursor / codebuddy / claude）
+
+  命令行参数:
+    fedincms init cms_website_key=<站点密钥> [--ai cursor|codebuddy|claude]
+    fedincms init --cms-website-key=<站点密钥> --ai cursor
 
 参数:
-  cms_website_key  必填。站点密钥（格式 cms_<base64>），解密后得到 websiteId 与 userId，并写入脚本占位符。
+  cms_website_key  站点密钥（格式 cms_<base64>），解密后得到 websiteId 与 userId。
+  --ai             目标 AI 环境。cursor → .cursor/skills/fedin-cms/
+                    codebuddy → .codebuddy/skills/fedin-cms/
+                    claude → .claude/skills/fedin-cms/
 
 选项:
-  --force, -f  已存在 .cursor/skills/fedin-cms/ 时覆盖复制并重新替换占位符。
+  --force, -f  已存在目标目录时覆盖复制。
   --help, -h   显示此帮助。
-
-行为:
-  - 解密 cms_website_key 得到 websiteId、userId
-  - 创建 .cursor/skills/fedin-cms/ 并复制 SKILL.md、reference.md
-  - 复制 scripts/fedin-cms-cli.js 并将占位符 __FEDINCMS_WEBSITE_ID__、__FEDINCMS_USER_ID__ 替换为解密后的值
 `);
 }
 
+function ask(rl, prompt) {
+  return new Promise(function (resolve) {
+    rl.question(prompt, function (answer) {
+      resolve((answer || '').trim());
+    });
+  });
+}
+
+/**
+ * 列表选择：使用 inquirer list，上下键选择、回车确认。
+ * @param {string[]} items - 选项列表，如 ['cursor', 'codebuddy']
+ * @returns {Promise<string>} 选中的项
+ */
+function askSelectList(items) {
+  return inquirer
+    .prompt([
+      {
+        type: 'list',
+        name: 'ai',
+        message: '请选择当前使用的 AI 助手或编辑器:',
+        choices: items,
+        default: items[0],
+      },
+    ])
+    .then(function (answers) {
+      return answers.ai;
+    });
+}
+
+function runInteractiveInit(options, done) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  ask(rl, '请输入站点密钥: ')
+    .then(function (key) {
+      if (!key) {
+        console.error('未输入站点密钥，已取消。');
+        rl.close();
+        process.exit(1);
+      }
+      rl.close();
+      return askSelectList(AI_CHOICES).then(function (ai) {
+        return { key: key, ai: ai };
+      });
+    })
+    .then(function (result) {
+      runInit({
+        cmsWebsiteKey: result.key,
+        ai: result.ai,
+        force: options.force,
+      });
+      if (typeof done === 'function') done();
+    })
+    .catch(function (err) {
+      console.error(err);
+      process.exit(1);
+    });
+}
+
 function main() {
   const argv = process.argv.slice(2);
   if (argv.length === 0) {
-    console.log('用法: fedincms init cms_website_key=xxxxx');
+    console.log('用法: fedincms init  或  fedincms init cms_website_key=xxxxx [--ai cursor|codebuddy|claude]');
     console.log('查看帮助: fedincms init --help');
     process.exit(0);
   }
@@ -171,7 +268,12 @@ function main() {
     printHelp();
     process.exit(0);
   }
-  runInit(options);
+
+  if (options.cmsWebsiteKey) {
+    runInit(options);
+  } else {
+    runInteractiveInit(options);
+  }
 }
 
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fedincms-cli",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Fedin CMS Skill CLI",
   "main": "dist/cli.js",
   "bin": {
@@ -14,6 +14,9 @@
     "build:skill": "node build-skill.js",
     "prepublishOnly": "npm run build:skill && node -e \"const fs=require('fs');const p='src/cli.js';if(fs.existsSync(p)){fs.mkdirSync('dist',{recursive:true});fs.copyFileSync(p,'dist/cli.js');}\""
   },
+  "dependencies": {
+    "inquirer": "^8.2.6"
+  },
   "devDependencies": {
     "axios": "^1.6.0",
     "dotenv": "^16.3.1",

package/templates/skill/SKILL.md

@@ -14,7 +14,7 @@ description: 通过 Fedin CMS 脚本管理内容类型与条目：列出/获取/
 - **必须在项目根目录**执行脚本，以便从项目根加载 `.env`。
 - 唯一入口命令：
   ```bash
-  node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]
+  node __FEDINCMS_SCRIPT_PATH__ <command> [args]
   ```
 - 所有 Fedin CMS 能力（列内容类型、查/增/删/改条目与 content type）**必须**通过上述脚本完成，不得手写请求 CMS API 的代码。
 
@@ -46,14 +46,14 @@ description: 通过 Fedin CMS 脚本管理内容类型与条目：列出/获取/
 
 ```bash
 # 列出所有内容类型
-node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js list_content_types
+node __FEDINCMS_SCRIPT_PATH__ list_content_types
 
 # 获取 blog 类型单条
-node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js get_entry --uid=blog --id=123
+node __FEDINCMS_SCRIPT_PATH__ get_entry --uid=blog --id=123
 
 # 获取 blog 列表（分页）
-node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js get_entries --uid=blog --options='{"pagination":{"page":1,"pageSize":10},"sort":["updated_at:desc"]}'
+node __FEDINCMS_SCRIPT_PATH__ get_entries --uid=blog --options='{"pagination":{"page":1,"pageSize":10},"sort":["updated_at:desc"]}'
 
 # 创建条目
-node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js create_entry --uid=blog --data='{"title":"Hello","body":"World"}'
+node __FEDINCMS_SCRIPT_PATH__ create_entry --uid=blog --data='{"title":"Hello","body":"World"}'
 ```

package/templates/skill/reference.md

@@ -1,15 +1,11 @@
 # Fedin CMS 脚本命令参考
 
 所有命令均在**项目根目录**执行：
-`node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]`
+`node __FEDINCMS_SCRIPT_PATH__ <command> [args]`
 
 ## 环境
 
-- **站点 ID 与用户 ID**：由 `fedincms init cms_website_key=xxx` 解密密钥后写入脚本，**不从环境变量读取**。
-- 脚本从项目根加载 `.env`，仅用于：
-  - `SUPABASE_CMS_API_URL`（内容类型 API）
-  - `SUPABASE_CONTENT_API_URL`（条目 API）
-  - `SUPABASE_ANON_KEY`（API 密钥）
+- **站点 ID 与用户 ID**：由 `fedincms init cms_website_key=xxx` 解密密钥后写入脚本。
 - 成功时结果 JSON 输出到 stdout；失败时错误信息输出到 stderr 并以非 0 退出码退出。
 
 ---