🔧 Cline + Data API

Cline 干活。
FormLM 留结果。

规划、写码、运行、迭代——Cline 的循环很紧,但它产出的一切都随工作区消亡。一个接口,让每个任务的产出都变成下个任务读得到的记录。

聪明的循环,没有记忆

Cline 执行了计划。然后计划的产出蒸发了。

Cline 的强项是 VS Code 里的完整闭环:读代码库、写改动、跑命令、修报错。但这个闭环跨任务失忆。昨天的爬取结果、上周的重构笔记、它生成的测试摘要——都躺在聊天记录和草稿文件里,下个任务看不见,项目里其他人也看不见。「我们之前试过什么?」没有答案,于是 Cline 再试一遍。

一个共享存储接口给这个循环装上记忆。每个任务把结果 POST 到同一个 FormLM URL——日志、结果、笔记,任务产出了什么就存什么——之后的任务通过查询 API 以结构化 JSON 读回来。接口没有 SDK、没有 schema 仪式:Cline 给 URL 加上 ?help,读 Markdown 文档,第一次就写出正确的调用。

Cline 使用 FormLM Data API
Data API 实操演示——发布、POST、读回数据

接入 Cline 的两条路

URL 管数据,MCP 服务器管驱动 FormLM 本身。
路线 A · 零安装

把接口贴进任务。带上 ?help 它返回一份 Markdown 文档——字段、方法、示例。Cline 读完就把存储接进它在做的任何东西:

# 把这段贴进 Cline 对话
"给这个脚本加上结果记录。每次运行后,把结果
 提交到:
 https://formlm.me/api/v3/share/YOUR_TOKEN?help
 先读文档,然后把 POST 接进去。"

# Cline 读取 schema、写好集成、
# 一次到位——不用你给格式说明。
路线 B · 完整 MCP

把 formlm-cli 加为 MCP 服务器,Cline 就多出建表单、定义字段、发布接口、查询结果的工具——全在 VS Code 对话里。先装 CLI(npm install -g @formlm/cli),再到 Cline 的 MCP 设置里配——侧边栏面板或直接改 JSON 文件都行:

# cline_mcp_settings.json(或 VS Code 的 MCP Servers 面板)
{
  "mcpServers": {
    "formlm": {
      "command": "formlm-cli",
      "args": ["mcp"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

macOS 上 env.PATH 这行避开常见的 command not found——VS Code 扩展不继承你终端的 PATH。在集成终端里跑一次 formlm-cli auth login --token <your-token>(令牌从 formlm.me → 账号设置复制;验证码和 Google 注册的账号没有密码),token 对之后所有会话长期有效。完整 CLI 参考在开发者专区。

实际用起来什么样

一个接口、每个任务、全部可查。
# 写入——Cline 记下刚执行的一次测试
$ curl -X POST https://formlm.me/api/v3/share/YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "suite": "checkout-flow",
      "passed": 47,
      "failed": 2,
      "flaky": ["cart-update"],
      "duration_s": 63
    },
    "meta": {"source": "cline-task"}
  }'

# 读取——明天的任务从今天的结果开跑
$ curl https://formlm.me/api/v3/share/YOUR_TOKEN/query?page=1&size=50

Cline 构建的页面从浏览器就能用同一个接口——CORS 读写都覆盖——集成终端里跑的脚本则完全不需要 CORS。记录在 FormLM 界面长期可见、带 CSV 导出,项目的记忆属于项目,不属于聊天记录。

常见问题

在 Cline 里 MCP 服务器配在哪?

从 VS Code 侧边栏(MCP Servers 图标)打开 Cline 的 MCP 设置面板加一个新服务器,或直接编辑 cline_mcp_settings.json——它用标准 JSON mcpServers 格式。保存后到面板确认 formlm 服务器显示为启用。

Cline 不接 MCP 能用 Data API 吗?

能。把带 ?help 的接口 URL 贴进 Cline 对话。接口返回一份 Markdown 文档,含字段清单、请求格式与示例——Cline 读完就把 POST 调用接进它在做的任何东西,无需配置。

Cline 写的页面和脚本会被 CORS 拦吗?

不会。接口读写都发 CORS 头,跑在 localhost、VS Code Simple Browser 或任何静态托管上的页面都能直接 POST。脚本和 CLI 工具根本不受 CORS 管——那是浏览器专属规则。

Cline 还记得之前会话存了什么吗?

记得。让 Cline 指向 query 接口去取历史——记录按分页 JSON 返回,它能读、能总结、能渲染。summary 接口连原始行都不用拉就给出聚合。

在其他 Agent 上使用

同一个接口处处通用。各平台的接入指南:

给 Cline 一段活得比聊天长的记忆。

免费接口、自带文档、下个任务随时可读。

创建你的免费接口 →