fedincms-cli

v0.0.5

a month ago

Fedin CMS Skill CLI

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（需在项目根执行）。

npm install -g fedincms-cli

或使用 scope 包名（若已发布）：

npm install -g @your-scope/fedin-cms-cli

安装后可使用 fedincms 命令。

进入你的项目根目录：
```
cd /path/to/your-project
```
初始化：只需传入站点密钥（格式 cms_<base64>），会解密得到 websiteId 与 userId 并写入脚本：
```
fedincms init cms_website_key=你的站点密钥
fedincms init --cms-website-key=你的站点密钥
```
在 Cursor / CodeBuddy / Claude Code 等中打开该项目，AI 助手会根据 SKILL 说明在项目根执行：
```
node .cursor/skills/fedin-cms/scripts/fedin-cms-cli.js <command> [args]
```
脚本为单文件（依赖已打包），无需在 scripts/ 下执行 npm install。若在其它编辑器中已将 Skill 复制到别处，请使用该目录下的 scripts/fedin-cms-cli.js 路径。

登录 npm（若未登录）：
```
npm login
```
若使用 scope 包名，修改 package.json 中的 name，例如：
```
"name": "@your-username/fedin-cms-cli"
```
发布：
```
npm publish
```
若为 scope 包且首次发布，需执行：
```
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

MIT