flycode-mcp 1.14.2 → 1.14.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -1
- package/dist/cli.js +6893 -0
- package/dist/skills/flycode-mcp-skill/SKILL.md +321 -0
- package/dist/skills/flycode-mcp-skill/scripts/save_full_via_mcp.mjs +199 -0
- package/dist/skills/flycode-mcp-skill/tools/core.md +56 -0
- package/dist/skills/flycode-mcp-skill/tools/entity.md +255 -0
- package/dist/skills/flycode-mcp-skill/tools/form.md +248 -0
- package/dist/skills/flycode-mcp-skill/tools/function.md +114 -0
- package/dist/skills/flycode-mcp-skill/tools/gateway.md +65 -0
- package/dist/skills/flycode-mcp-skill/tools/h5.md +70 -0
- package/dist/skills/flycode-mcp-skill/tools/logic.md +296 -0
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -62,7 +62,7 @@ npm run typecheck
|
|
|
62
62
|
npm run dev
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
构建产物有两份：`dist/flycode-mcp.min.js`（MCP server，minify 后折叠为单行以减小体积）与 `dist/cli.js`（命令行入口，不 minify、不折叠——内含界面文案）；`package.json` 的 `bin` 将 `flycode-mcp` 命令注册到 `dist/cli.js`。运行时依赖 `@modelcontextprotocol/sdk` / `axios` / `zod` / `@clack/prompts` 保持外置。
|
|
66
66
|
|
|
67
67
|
> **注意（构建期易踩坑）**：单行折叠由 `scripts/collapse.mjs` 完成，**不可**退化为 `code.replace(/\n/g, '')`。
|
|
68
68
|
> esbuild 为省一个字符会把含换行的字符串打印成「内含真实换行字符的模板字符串」（`` `\<LF>` ``，而非转义写法 `"\n"`），
|
|
@@ -73,6 +73,52 @@ npm run dev
|
|
|
73
73
|
|
|
74
74
|
---
|
|
75
75
|
|
|
76
|
+
## CLI（flycode-mcp 命令）
|
|
77
|
+
|
|
78
|
+
全局安装后即可使用 `flycode-mcp` 命令：
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npm install -g flycode-mcp
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
| 命令 | 说明 |
|
|
85
|
+
| ----------------------------------- | -------------------------------------------------------------------------------------- |
|
|
86
|
+
| `flycode-mcp` / `flycode-mcp mcp` | 启动 MCP stdio server（兼容 `key=value` 启动参数写法，行为与直跑 `dist/flycode-mcp.min.js` 一致） |
|
|
87
|
+
| `flycode-mcp setup` | 交互安装配套 skill 到所选智能体（初版支持 WorkBuddy / Trae CN），不写任何 `mcp.json` |
|
|
88
|
+
| `flycode-mcp update` | 自更新全局包，并刷新本工具安装过的 skill |
|
|
89
|
+
| `flycode-mcp --version` / `--help` | 版本与帮助 |
|
|
90
|
+
|
|
91
|
+
### setup：安装 skill
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
flycode-mcp setup # 交互：选 WorkBuddy / Trae CN → 预览计划 → 回车确认
|
|
95
|
+
flycode-mcp setup -c workbuddy -c trae-cn --yes # 非交互执行
|
|
96
|
+
flycode-mcp setup --dry-run # 只打印安装计划，零写入
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
安装目标（初版只装 skill）：
|
|
100
|
+
|
|
101
|
+
| 客户端 | skill 目录 |
|
|
102
|
+
| --------- | -------------------------------------------- |
|
|
103
|
+
| WorkBuddy | `~/.workbuddy/skills/flycode-mcp-skill/` |
|
|
104
|
+
| Trae CN | `~/.trae-cn/skills/flycode-mcp-skill/` |
|
|
105
|
+
|
|
106
|
+
保护机制：
|
|
107
|
+
|
|
108
|
+
- **已存在即更新替换**：目标目录已有 skill（无论当初是 CLI 安装还是手工放置）都会直接更新到当前版本；内容与版本均已一致时跳过写入。
|
|
109
|
+
- **旧目录移入废纸篓**：替换时**不在同目录留任何备份**——旧目录整体移入系统废纸篓（macOS 废纸篓 / Windows 回收站 / Linux `gio trash`），需要时可从废纸篓手动恢复，绝不 `rm -rf`。
|
|
110
|
+
- **事务写入**：先复制到临时 staging 目录并回读校验（文件清单 + `SKILL.md` + marker），校验通过、旧目录成功进废纸篓之后才原子切换为正式目录；全程 fail-closed，任何一步失败旧目录都原封不动。
|
|
111
|
+
|
|
112
|
+
### update：自更新
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
flycode-mcp update
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
自动检测安装方式（npm / bun 全局安装）→ 从 npm registry 查最新版本 → 全局升级 → 回读包根校验版本 → 刷新已安装的 skill 目录（未安装的智能体跳过，旧目录移入废纸篓）。`npx` 临时安装或本地源码运行时给出对应的手动升级提示，不会盲改；失败路径（registry 不可达 / 安装命令失败 / 版本校验失败）均给出 remediation 提示。
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
76
122
|
## 配置
|
|
77
123
|
|
|
78
124
|
服务启动时需要一组连接参数，格式为**命令行参数字符串**，以 `&` 拼接的 `key=value` 形式传入（与 `URLSearchParams` 解析一致）：
|