关于 fline
fline skills 提供操作指南,帮助 AI 编码应用在 fline 上准备、部署和管理项目,适用于 Claude Code、Codex、Cursor 等支持 Agent Skills 的应用。Claude Code 插件还会连接 fline 的 MCP 服务。
主要功能
- 01准备项目以便部署
- 02启动、更新和回滚应用
- 03使用数据库和域名
- 04诊断启动及运行问题
- 05分享前检查应用
适用场景
- 01首次上传前准备项目
- 02部署应用并管理后续更新
- 03排查启动失败或线上问题
MCP 相关
Claude Code 插件包含连接 fline MCP 服务的配置,并通过浏览器进行 OAuth 授权。通过其他方式安装的技能不包含该服务,需另行连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.fline.sh/mcpclaude mcp add --transport http sh-fline-fline https://mcp.fline.sh/mcp{"mcpServers":{"sh-fline-fline":{"type":"http","url":"https://mcp.fline.sh/mcp"}}}在 Cursor 中打开{"servers":{"sh-fline-fline":{"type":"http","url":"https://mcp.fline.sh/mcp"}}}在 VS Code 中打开{"mcpServers":{"sh-fline-fline":{"type":"http","url":"https://mcp.fline.sh/mcp"}}}{"mcpServers":{"sh-fline-fline":{"serverUrl":"https://mcp.fline.sh/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
fline 技能
这些技能可教会你的 AI 编码应用(Claude Code、Codex、Cursor 及其他支持 Agent Skills 的应用)如何通过 fline 将项目上线。对于 Claude Code,此仓库还是一个可连接 fline MCP 服务的插件。
安装
| 应用 | 方法 |
|---|---|
| Claude Code,包括 Claude 桌面应用的 Code 标签页 | /plugin marketplace add smartline-ai/fline-skills,然后运行 /plugin install fline@fline |
| Codex、Cursor、Gemini CLI、VS Code 及其他应用 | npx skills add smartline-ai/fline-skills |
| 手动安装 | 将 skills/* 复制到 ~/.claude/skills/(Claude Code)或 ~/.agents/skills/(Codex 及其他应用) |
Claude Code 插件附带 fline MCP 服务:输入 /mcp,选择 fline,然后选择 Authenticate,并在浏览器中批准 fline。通过其他方式安装时,技能本身不包含服务;请按照 fline 文档中的说明连接 fline,或让你的 AI 应用连接,这会加载 fline-connect。
你需要拥有 fline 账户。fline 目前处于私人测试阶段:请参阅获取账户。
它会发送什么,以及发送到哪里
这些技能只是指令;它们本身不会向任何地方发送内容。离开电脑的内容会通过 fline 的 MCP 服务 https://mcp.fline.sh/mcp 传输,而且只会在用户要求 fline 执行操作时发送:
- 项目文件夹。
scripts/pack.sh会将其打包为一份.tar.gz副本,排除.git、node_modules、项目.gitignore忽略的内容,以及.env和密钥文件;随后 Agent 会将其上传到 fline 的存储空间。fline 会保留此副本,以便构建和运行应用。原始文件仍留在文件夹中。 - **部分代码,发送给 OpenAI 制作的 AI 模型,**以便 fline 判断如何构建和运行应用。保存在 fline 上的密码和密钥不会发送给它。
- 工具调用。 项目名称、设置名称、网址以及 fline 工具的其他参数。密码和密钥由用户在私密的 fline 页面中输入,不会通过聊天发送。例外情况是 Agent 已持有的密钥、由 Agent 生成的密钥,或用户粘贴到聊天中的密钥:
set_env会将该值发送给 fline,由 fline 保存,且不会再次显示。 - 返回的内容。 项目状态、构建输出和应用的近期日志行,其中包含应用输出的任何内容。
登录通过浏览器中的 OAuth 完成;插件不持有任何密钥。在 fline 控制面板中断开连接后,设置会在 30 秒内生效。详情请参阅:隐私政策、条款、fline 当前的功能。
技能
| 技能 | 涵盖内容 |
|---|---|
fline-connect | 将 fline 的 MCP 服务添加到 AI 应用、浏览器审批,以及会拒绝所有调用的账户状态 |
fline-prepare | 检查项目中阻碍其在 fline 上运行的问题,并在首次上传前修复,包括供 fline 检查的简易健康检查路由 |
fline-launch | 首次启动、更新、设置、重启和恢复到较早版本;包含 scripts/pack.sh |
fline-database | 由 fline 创建并运行的 Postgres 或 Valkey、用户已在运行的数据库、SQLite 和磁盘上的文件 |
fline-domain | 用户拥有的网址:记录、检查和 48 小时的限制 |
fline-diagnose | 启动失败或在线应用出现异常时,应按什么顺序查看哪些内容,以及常见原因 |
fline-build-plan | fline.json:锁定计划、编辑计划、check_config、多个服务、预构建镜像、卷、健康检查路径 |
fline-share-check | 用户将应用的公开链接发送给任何人之前,应检查应用中的哪些内容 |
这些技能分为三组:使用 fline(connect、launch、database、domain、diagnose)、为 fline 准备项目(prepare、build-plan),以及确保分享安全(share-check)。
MCP 服务提供了提示词,为什么还需要技能
fline 的服务附带了七个包含这些流程的提示词。在 Claude Code 中,MCP 提示词是用户输入的斜杠命令;模型没有工具来获取提示词,因此服务的说明会指向 Agent 无法打开的流程。模型在技能描述与任务匹配时会自行加载技能。
技能中使用不带前缀的 fline 工具名称(create_project,而非
mcp__fline__create_project):插件提供的服务与用户自行添加的服务,其前缀有所不同。
目录结构
.claude-plugin/plugin.json the plugin, including fline's MCP server
.claude-plugin/marketplace.json a marketplace holding that one plugin
skills/<name>/SKILL.md one directory per skill (Agent Skills format)
skills/fline-launch/scripts/ pack.sh, run by the agent, never read
tests/ scenarios and the projects they run on
测试
claude plugin validate --strict .用于检查清单文件。bash skills/fline-launch/scripts/pack.sh <folder>可在 macOS 自带的 bash 3.2 和 bsdtar 上运行,也可在 GNU tar 上运行。tests/scenarios.md包含六个场景及通过时应有的回答,由全新 Agent 在有无技能的情况下运行。tests/make-fixtures.sh会生成这六个场景所用的两个预置项目:一个 Node 商店和一个 Flask 跟踪器。
内容来源
此处的所有信息均基于 fline 自己的文档,尤其是 for-ai.md。此仓库从 fline 的主仓库发布;仅在此处进行的更改会在下次发布时被覆盖。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。