Franklin Agent
用 USDC 钱包为研究、代码和交易任务按次付费执行。
这个 Agent 能做什么，适合哪些场景？
Franklin Agent 是 BlockRun 提供的 TypeScript 命令行智能体，核心是由用户钱包支付的任务执行循环。它通过 Smart Router 在多种模型之间选择，并经 BlockRun Gateway 调用模型、搜索、图像和其他付费服务；每次付费操作使用 x402 USDC 微支付结算。CLI 具备持久化会话、会话搜索、成本洞察、MCP 自动发现和插件 SDK，并可通过 Telegram 或 VS Code 扩展使用同一份钱包配置与会话历史。交易是其重点场景：它可从 CoinGecko 获取行情、在本地计算技术指标，并为 Jupiter、0x 和 Polymarket 交易生成需用户批准的交易计划。它适合愿意使用 BlockRun 钱包和网关、希望把模型与工具成本限制在 USDC 余额内的终端用户。
用户在 franklin CLI 中描述目标后，运行时依次执行 Intent → Smart Router → Tool Use → Spend Control → Result。它可使用 Read、Write、Edit、Bash、Glob、Grep、WebFetch、WebSearch、Task、ImageGen、MemoryRecall、AskUser、SubAgent 和 Trading* 工具读取与修改文件、运行命令、检索网页、生成图像、调用子任务及处理交易工作流。TradingSignal 从 CoinGecko 获取市场数据，并在本地计算 RSI、MACD、Bollinger 和波动率；真实交易会先提出包含场所、资产、规模、滑点、止损和总支出的 trade plan，只有批准后才会执行。会话流式写入磁盘，可用 /history、/resume 和 /session-search 恢复或检索；/cost 与 franklin insights 展示支出。付费调用由钱包签名的 x402 微支付结算，余额耗尽时停止。
- 加密资产交易者在终端询问 BTC 或 SOL 行情，希望依据本地计算的 RSI、MACD、Bollinger 和波动率获得信号，再审阅交易计划。
- 开发者希望在一个命令行会话中让工具读取 src/auth.ts、编辑代码并运行 npm test，同时查看每个步骤的费用。
- 研究人员需要让 /goal 在限定轮次和 --max-spend 下调查多个 x402 兼容数据 API，并由对抗性审阅者核验完成声明。
- 独立创作者想在没有 OpenAI API key 的情况下，通过已充值的钱包从 CLI 生成 logo 或其他图像。
- 需要远程处理任务的用户，可在常驻机器配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_OWNER_ID，通过所有者锁定的 Telegram bot 恢复会话并执行请求。
这个 Agent 有哪些优点和局限？
- 以钱包余额作为硬预算上限；付费操作按 x402 USDC 微支付结算，文档声明无月费和无透支。
- Smart Router 提供 auto、eco、premium、free 四种策略，并在输出中显示所选模型、成本和节省情况。
- 交易执行有不可绕过的交易计划审批门槛，且可通过 lifecycle hooks 添加日限额、代币黑名单或支出账本等否决规则。
- CLI、VS Code 扩展和 Telegram 入口可共用 ~/.blockrun/ 配置与会话历史；会话可持久化、恢复和全文搜索。
- 核心模型与付费服务通过 BlockRun Gateway 和其钱包流程提供，采用时需接受该网关与支付路径。
- 付费能力依赖 Base 或 Solana 上的 USDC；余额为空时，付费模型和工具无法继续执行。
- 运行环境要求 Node.js 20.19+；文档明确指出较旧 Node 版本会在 Solana 依赖处因 ERR_REQUIRE_ESM 崩溃。
- 交易虽需审批，但文档列出的执行场所包括 Jupiter、0x 和 Polymarket；使用者仍需自行判断交易风险与审批内容。
如何安装或部署这个 Agent？
需要 Node.js 20.19+，项目建议 Node 22 LTS。安装并启动：
npm install -g @blockrun/franklin
franklin
也可以直接运行：
npx @blockrun/franklin
默认免费 NVIDIA 模型可直接使用。要使用付费模型和付费工具，执行 franklin setup base 或 franklin setup solana，然后向生成的钱包地址转入 USDC；franklin balance 可查看地址和余额。
如何使用这个 Agent？
首次可运行 franklin，或明确使用免费档：
franklin --model free
在交互界面输入任务，例如“what's BTC looking like today?”或要求重构文件并运行测试。用 /model 选择模型、/plan 进入只读规划、/execute 切换执行、/cost 查看会话支出；长任务可用 /goal，定时任务可用 /loop。真实交易必须先审阅并批准 trade plan；批准预算会在 15 分钟后过期。远程控制需设置 TELEGRAM_BOT_TOKEN 与 TELEGRAM_OWNER_ID 后运行 franklin telegram。
这个 Agent 与同类方案有什么区别？
项目将自身与订阅制编码智能体、编辑器 IDE 和聊天机器人对比，主张其差异在于钱包原生 USDC/x402 支付、按结果计费、自动模型路由，以及可购买数据、搜索和图像服务。README 同时将按调用计费的 OpenAI API 列为“每次尝试均收费”的对照。