fedincms-cli 0.0.1

package/README.md

@@ -0,0 +1,73 @@
+# fedincms-cli
+
+Fedin CMS Skill 的全局 CLI：通过 `fedincms init` 将 Skill 安装到当前项目，在 Cursor 中通过项目内脚本调用 Fedin CMS API，无需运行 MCP Server。
+
+## 安装
+
+```bash
+npm install -g fedincms-cli
+```
+
+或使用 scope 包名（若已发布）：
+
+```bash
+npm install -g @your-scope/fedin-cms-cli
+```
+
+安装后可使用 `fedincms` 命令。
+
+## 使用
+
+1. 进入你的项目根目录：
+   ```bash
+   cd /path/to/your-project
+   ```
+
+2. 初始化并配置站点 ID（必填）与可选 API 地址、密钥：
+   ```bash
+   fedincms init website=你的站点ID
+   # 或带可选参数
+   fedincms init website=你的站点ID apiUrl=https://... anonKey=你的密钥
+   # 或长选项
+   fedincms init --website=你的站点ID --api-url=https://... --anon-key=你的密钥
+   ```
+
+3. 在 Cursor 中打开该项目，AI 将根据 `.cursor/skills/fedin-cms/SKILL.md` 在需要时执行：
+   ```bash
+   node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]
+   ```
+   脚本为单文件（依赖已打包），无需在 `scripts/` 下执行 `npm install`。
+
+## 发布到 npm
+
+1. 登录 npm（若未登录）：
+   ```bash
+   npm login
+   ```
+
+2. 若使用 scope 包名，修改 `package.json` 中的 `name`，例如：
+   ```json
+   "name": "@your-username/fedin-cms-cli"
+   ```
+
+3. 发布：
+   ```bash
+   npm publish
+   ```
+   若为 scope 包且首次发布，需执行：
+   ```bash
+   npm publish --access public
+   ```
+
+发布时 `prepublishOnly` 会自动将 `src/cli.js` 复制到 `dist/cli.js`，仅 `dist` 与 `templates` 会包含在包中。
+
+## 开发
+
+- 全局 CLI 源码：`src/cli.js`（发布前会复制到 `dist/cli.js`）
+- Skill 脚本源码：`src/fedin-cms-cli.js`，运行 `npm run build:skill` 打包为 `templates/skill/scripts/fedin-cms-cli.js`（axios、dotenv 已内联，用户无需安装依赖）
+- 模板：`templates/skill/`（SKILL.md、reference.md、scripts/fedin-cms-cli.js）
+- 本地测试：在项目根执行 `npm link`，在任意目录执行 `fedincms init website=test`
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const TEMPLATE_DIR = path.join(__dirname, '..', 'templates', 'skill');
+const SKILL_DIR = '.cursor/skills/fedin-cms';
+const SKILL_SCRIPTS_DIR = '.cursor/skills/fedin-cms/scripts';
+
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--help' || arg === '-h') {
+      args.help = true;
+      continue;
+    }
+    if (arg === '--force' || arg === '-f') {
+      args.force = true;
+      continue;
+    }
+    if (arg.startsWith('--')) {
+      const eq = arg.indexOf('=');
+      if (eq > 0) {
+        const k = arg.slice(2, eq).replace(/-/g, '');
+        const v = arg.slice(eq + 1);
+        if (k === 'website') args.website = v;
+        else if (k === 'apiurl') args.apiUrl = v;
+        else if (k === 'anonkey') args.anonKey = v;
+      }
+      continue;
+    }
+    if (arg.includes('=')) {
+      const [k, v] = arg.split('=').map(s => s.trim());
+      if (k === 'website') args.website = v;
+      else if (k === 'apiUrl') args.apiUrl = v;
+      else if (k === 'anonKey') args.anonKey = v;
+      continue;
+    }
+    args._.push(arg);
+  }
+  return args;
+}
+
+function ensureDir(dir) {
+  const full = path.isAbsolute(dir) ? dir : path.join(process.cwd(), dir);
+  fs.mkdirSync(full, { recursive: true });
+  return full;
+}
+
+function copyFile(src, dest, force) {
+  const destFull = path.join(process.cwd(), dest);
+  if (!force && fs.existsSync(destFull)) return false;
+  ensureDir(path.dirname(destFull));
+  fs.copyFileSync(src, destFull);
+  return true;
+}
+
+function readOrCreateEnv() {
+  const envPath = path.join(process.cwd(), '.env');
+  let content = '';
+  if (fs.existsSync(envPath)) {
+    content = fs.readFileSync(envPath, 'utf8');
+    if (!content.endsWith('\n')) content += '\n';
+  }
+  return { envPath, content };
+}
+
+function appendEnv(lines) {
+  const { envPath, content } = readOrCreateEnv();
+  const toAdd = lines.filter(line => {
+    const key = line.split('=')[0].trim();
+    return !content.includes(key + '=');
+  });
+  if (toAdd.length === 0) return;
+  fs.writeFileSync(envPath, content + '\n# Fedin CMS (fedincms init)\n' + toAdd.join('\n') + '\n', 'utf8');
+}
+
+function runInit(options) {
+  const cwd = process.cwd();
+  const templateBase = path.join(__dirname, '..', 'templates', 'skill');
+  if (!fs.existsSync(templateBase)) {
+    console.error('fedincms: 模板目录不存在:', templateBase);
+    process.exit(1);
+  }
+
+  const website = options.website;
+  if (!website) {
+    console.error('fedincms init: 缺少必填参数 website。用法: fedincms init website=xxxxx [apiUrl=...] [anonKey=...]');
+    process.exit(1);
+  }
+
+  const skillDirFull = path.join(cwd, SKILL_DIR);
+  const exists = fs.existsSync(skillDirFull);
+  if (exists && !options.force) {
+    console.log('fedincms: .cursor/skills/fedin-cms/ 已存在，跳过复制。使用 --force 覆盖。');
+  } else {
+    ensureDir(SKILL_SCRIPTS_DIR);
+    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)) copyFile(scriptJs, path.join(SKILL_DIR, 'scripts', 'fedin-cms-cli.js'), options.force);
+  }
+
+  const defaultContentTypeUrl = 'https://database.fedin.cn/functions/v1/cms_content-type-manager';
+  const defaultContentUrl = 'https://database.fedin.cn/functions/v1/cms_content-manager';
+  const envLines = [
+    `WEBSITE_ID=${website}`,
+    options.apiUrl ? `SUPABASE_CMS_API_URL=${options.apiUrl}` : `SUPABASE_CMS_API_URL=${defaultContentTypeUrl}`,
+    `SUPABASE_CONTENT_API_URL=${defaultContentUrl}`,
+    options.anonKey ? `SUPABASE_ANON_KEY=${options.anonKey}` : 'SUPABASE_ANON_KEY=',
+  ].filter(Boolean);
+  appendEnv(envLines);
+
+  console.log('Skill 已安装到 .cursor/skills/fedin-cms/');
+  if (!options.apiUrl || !options.anonKey) {
+    console.log('如未配置 API 地址或密钥，请在项目根 .env 中设置 SUPABASE_CMS_API_URL、SUPABASE_CONTENT_API_URL、SUPABASE_ANON_KEY。');
+  }
+  console.log('脚本为单文件打包，无需在 scripts/ 下安装依赖。');
+}
+
+function printHelp() {
+  console.log(`
+fedincms init - 将 Fedin CMS Skill 安装到当前项目
+
+用法:
+  fedincms init website=<站点ID> [apiUrl=<API地址>] [anonKey=<密钥>]
+  fedincms init --website=<站点ID> [--api-url=<API地址>] [--anon-key=<密钥>]
+
+参数:
+  website    必填。站点 ID，对应环境变量 WEBSITE_ID。
+  apiUrl     可选。Fedin CMS API 根地址，对应 SUPABASE_CMS_API_URL。
+  anonKey    可选。API 密钥，对应 SUPABASE_ANON_KEY。
+
+选项:
+  --force, -f  已存在 .cursor/skills/fedin-cms/ 时覆盖复制。
+  --help, -h   显示此帮助。
+
+行为:
+  - 创建 .cursor/skills/fedin-cms/ 并复制 SKILL.md 与 scripts/fedin-cms-cli.js
+  - 在项目根写入或追加 .env（WEBSITE_ID、SUPABASE_CMS_API_URL、SUPABASE_ANON_KEY）
+`);
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 0) {
+    console.log('用法: fedincms init website=xxxxx [apiUrl=...] [anonKey=...]');
+    console.log('查看帮助: fedincms init --help');
+    process.exit(0);
+  }
+
+  const sub = argv[0].toLowerCase();
+  if (sub !== 'init') {
+    console.error('未知子命令:', sub, '。当前仅支持: init');
+    process.exit(1);
+  }
+
+  const options = parseArgs(argv.slice(1));
+  if (options.help) {
+    printHelp();
+    process.exit(0);
+  }
+  runInit(options);
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "fedincms-cli",
+  "version": "0.0.1",
+  "description": "Fedin CMS Skill CLI",
+  "main": "dist/cli.js",
+  "bin": {
+    "fedincms": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "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');}\""
+  },
+  "devDependencies": {
+    "axios": "^1.6.0",
+    "dotenv": "^16.3.1",
+    "esbuild": "^0.24.0"
+  },
+  "keywords": [
+    "fedin",
+    "cms",
+    "cursor",
+    "skill",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  }
+}

package/templates/skill/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: fedin-cms
+description: 通过 Fedin CMS 脚本管理内容类型与条目：列出/获取/创建/更新/删除 content types 与 entries。当用户提到 Fedin CMS、内容管理、内容类型、条目、list content types、get entries 等时使用。
+---
+
+# Fedin CMS Skill
+
+## 前提
+
+- 项目已通过 `fedincms init website=xxxxx` 初始化。
+- 项目根 `.env` 中已配置 `WEBSITE_ID`；若需调用 API，请配置 `SUPABASE_CMS_API_URL`（内容类型）、`SUPABASE_CONTENT_API_URL`（条目，可选）、`SUPABASE_ANON_KEY`。
+- 脚本为单文件打包（依赖已内联），**无需**在 `scripts/` 下执行 `npm install`。
+
+## 执行约定
+
+- **必须在项目根目录**执行脚本，以便从项目根加载 `.env`。
+- 唯一入口命令：
+  ```bash
+  node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]
+  ```
+- 所有 Fedin CMS 能力（列内容类型、查/增/删/改条目与 content type）**必须**通过上述脚本完成，不得手写请求 CMS API 的代码。
+
+## 能力与命令对应
+
+| 能力 | 命令 | 必填参数 | 可选参数 |
+|------|------|----------|----------|
+| 列内容类型 | `list_content_types` | - | - |
+| 获取条目列表 | `get_entries` | `--uid=<uid>` | `--options='{"pagination":{"page":1,"pageSize":10},"sort":["updated_at:desc"]}'` |
+| 获取单条条目 | `get_entry` | `--uid=<uid>` `--id=<id>` | - |
+| 创建条目 | `create_entry` | `--uid=<uid>` `--data='...'` 或 `--data-file=path` | `--status=draft\|published` |
+| 更新条目 | `update_entry` | `--uid=<uid>` `--id=<id>` `--data='...'` 或 `--data-file=path` | `--status=` |
+| 删除条目 | `delete_entry` | `--uid=<uid>` `--id=<id>` | - |
+| 获取内容类型 schema | `get_content_type_schema` | `--contentType=<uid>` | - |
+| 创建内容类型 | `create_content_type` | `--uid=` `--title=` | `--description=` |
+| 更新内容类型 | `update_content_type` | `--contentType=<uid>` | `--title=` `--description=` |
+| 删除内容类型 | `delete_content_type` | `--contentType=<uid>` | - |
+
+## 输出与错误
+
+- **成功**：脚本将结果 JSON 打印到 **stdout**。
+- **失败**：错误信息打印到 **stderr**，并以非 0 退出码退出；可根据 stderr 与退出码判断失败并解析错误信息。
+
+## 详细参数说明
+
+详见 [reference.md](./reference.md)。
+
+## 示例
+
+```bash
+# 列出所有内容类型
+node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js list_content_types
+
+# 获取 blog 类型单条
+node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js 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 .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js create_entry --uid=blog --data='{"title":"Hello","body":"World"}'
+```

package/templates/skill/reference.md

@@ -0,0 +1,115 @@
+# Fedin CMS 脚本命令参考
+
+所有命令均在**项目根目录**执行：
+`node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]`
+
+## 环境
+
+- 脚本从项目根加载 `.env`，与 Fedin CMS MCP 一致：
+  - `WEBSITE_ID`（必填）
+  - `SUPABASE_CMS_API_URL`（内容类型 API，默认 `cms_content-type-manager`）
+  - `SUPABASE_CONTENT_API_URL`（条目 API，默认 `cms_content-manager`，可选，未设时与 MCP 一致使用 content-manager 默认）
+  - `SUPABASE_ANON_KEY`、`USER_ID`（可选）
+- 成功时结果 JSON 输出到 stdout；失败时错误信息输出到 stderr 并以非 0 退出码退出。
+
+---
+
+## 1. list_content_types
+
+列出当前站点下所有内容类型。
+
+- **命令**：`list_content_types`
+- **参数**：无
+
+---
+
+## 2. get_entries
+
+获取指定内容类型的条目列表，支持分页与排序。
+
+- **命令**：`get_entries`
+- **必填**：`--uid=<contentTypeUid>`（如 `blog`）
+- **可选**：`--options='{"pagination":{"page":1,"pageSize":10},"sort":["updated_at:desc"],"filters":{"status":"published"}}'`
+
+---
+
+## 3. get_entry
+
+根据内容类型 UID 和条目 ID 获取单条条目。
+
+- **命令**：`get_entry`
+- **必填**：`--uid=<contentTypeUid>`，`--id=<entryId>`
+
+---
+
+## 4. create_entry
+
+在指定内容类型下创建一条条目。
+
+- **命令**：`create_entry`
+- **必填**：`--uid=<contentTypeUid>`，`--data='{"title":"Hello","body":"World"}'` 或 `--data-file=./payload.json`
+- **可选**：`--status=draft` 或 `published`（默认 `published`）
+
+---
+
+## 5. update_entry
+
+更新指定内容类型下的一条条目。
+
+- **命令**：`update_entry`
+- **必填**：`--uid=<contentTypeUid>`，`--id=<entryId>`，`--data='{"title":"Updated"}'` 或 `--data-file=./payload.json`
+- **可选**：`--status=draft` 或 `published`
+
+---
+
+## 6. delete_entry
+
+删除指定内容类型下的一条条目。
+
+- **命令**：`delete_entry`
+- **必填**：`--uid=<contentTypeUid>`，`--id=<entryId>`
+
+---
+
+## 7. get_content_type_schema
+
+获取单个内容类型的 schema（字段定义等）。
+
+- **命令**：`get_content_type_schema`
+- **必填**：`--contentType=<contentTypeUid>`（如 `blog`）
+
+---
+
+## 8. create_content_type
+
+创建新的内容类型（与 MCP 一致：仅 uid、title、description，字段由后端固定）。
+
+- **命令**：`create_content_type`
+- **必填**：`--uid=<uid>`，`--title=<显示名>`
+- **可选**：`--description=<描述>`
+
+---
+
+## 9. update_content_type
+
+更新已有内容类型（与 MCP 一致：仅支持 title、description）。
+
+- **命令**：`update_content_type`
+- **必填**：`--contentType=<contentTypeUid>`
+- **可选**：`--title=`，`--description=`
+
+---
+
+## 10. delete_content_type
+
+删除内容类型。
+
+- **命令**：`delete_content_type`
+- **必填**：`--contentType=<contentTypeUid>`
+
+---
+
+## 复杂 JSON 参数
+
+- 使用 `--options='...'`、`--data='...'` 时，JSON 字符串需正确转义（如 shell 中单引号包裹）。
+- 支持从文件读取：`--data-file=./payload.json`。