AI 智能体与 Ultra API
通过本地回环 Ultra 桥接，把 Claude Code、Codex、Devin 等编码智能体接入 PineTune。
开发者版允许本地编码智能体操作 PineTune：读取策略、修改 Pine 源码、启动寻优、等待完成并应用最佳结果。
架构
Chrome MV3 扩展无法监听 TCP 端口，因此 PineTune 作为 WebSocket 客户端，主动连接一个绑定在 127.0.0.1、零依赖的 Node 桥接服务。智能体通过 HTTP 调用桥接。
| 端点 | 用途 |
|---|---|
POST /api |
发送 action（{ "action": "...", ... }） |
GET /health |
桥接与扩展的连接状态 |
GET /connect |
唤醒页：促使扩展（重新）连接 |
GET /events |
实时状态流（SSE 或 WebSocket） |
默认端口 5678。所有响应形如 { "ok": true, "data": ... } 或 { "ok": false, "error": "..." }。
设置
- 在弹窗中激活 开发者版 授权。
- 设置 → Ultra Agent API：启用并设置端口（默认
5678）。 - 打开加载了策略并显示策略测试器的 TradingView 图表。
- 运行 CLI 客户端。端口无人监听时，它会自动启动桥接，并固定首个连接的扩展。
curl http://127.0.0.1:5678/health
node tools/ultra-client.js status
node tools/ultra-client.js listTabs若 /health 显示 connected: false，请在安装了 PineTune 的浏览器中打开 http://127.0.0.1:5678/connect。
研发循环
- 读取：
snapshot --inputs --pine返回策略、参数、可编辑的 Pine 源码、指标与近期结果。 - 改代码（可选）：
updatePineSource校验、整体替换源码、保存、更新图表并校验结果。 - 配置：
setConfig设置参数、区间、模式、目标与过滤（支持局部更新合并）。 - 运行：
call --method start，再用waitDone阻塞等待任务结束。 - 分析：
getResults/getHistory。 - 应用：
applyBest或applyResult，会等待回测稳定。
「最佳」指在你的目标与过滤条件下、已测试组合中的最佳，而非全局最优。
Agent Skill
PineTune 附带 SKILL.md，向支持 skill 的智能体说明完整循环、API 参考与常见坑。让智能体加载它，再用自然语言描述目标即可。
安全
- 桥接只绑定回环地址，切勿暴露到局域网或公网。
- API 响应不会包含完整授权码或第三方 API Key。
- 不要在通过
--file传入的请求文件中放置密钥。 - 只读或受保护的脚本不会被绕过限制修改。