尧图网站建设 
Thunderbolt CLI五大工具实战bash/read/write/edit/webfetch全解析【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderboltThunderbolt CLI 是一个单二进制文件的 AI 终端编码 Agent它在你的工作目录里直接干活只依赖五个核心工具——bash、read、write、edit、webfetch支持 Anthropic、OpenAI、Google 等各家模型没有守护进程、没有繁琐部署一条命令安装即可上手。本文带你逐个拆解这五大工具的工作机制、参数细节与实战用法帮你快速成为终端 AI 编程高手。为什么只需要五个工具大多数 AI 编码工具依赖庞大的插件生态而 Thunderbolt CLI 的思路恰恰相反给模型最少的、职责清晰的工具让它在终端里完成端到端的软件工程任务。五个工具分工明确工具一句话定位是否修改文件bash跑 shell 命令grep、测试、构建✅ 可能read精确读取文件内容❌write创建或覆盖整个文件✅edit对文件内文本做精确替换✅webfetch安全读取一个 HTTP/HTTPS 网址❌工具的完整实现集中在 shared/agent-core/coding-tools/index.tswebfetch 则独立在 cli/src/agent/webfetch.ts 中系统提示词由 cli/src/agent/system-prompt.ts 生成。快速安装一条命令拥有终端 AI 助手推荐使用远程安装器macOS arm64 与 Linux它会自动校验 SHA-256 并把二进制装到~/.local/bin/thunderbolt。也可以从源码构建git clone https://gitcode.com/GitHub_Trending/thund/thunderbolt cd thunderbolt bun install cd cli bun install bun run build ./install.sh首次运行thunderbolt时会引导你选择连接方式绑定 Thunderbolt 账户推荐扫码即可或直接为 Anthropic、OpenAI 等提供商配置 API Key。详细步骤见 cli/README.md 与 docs/quick-start.md。装好后两种用法# 一次性任务跑完即退出 thunderbolt 修复 utils.ts 里失败的测试 # 进入交互式 REPL持续对话 thunderbolt工具一bash —— 测试、日志、构建全能手bash工具在当前工作目录执行任意 shell 命令返回 stdout 和 stderr。三个关键机制值得了解实现见 shared/agent-core/coding-tools/index.ts智能截断输出最多保留最近2000 行或 50KB先到者生效完整输出会自动存到临时文件模型可以再去cat查看见 shared/agent-core/coding-tools/truncate.ts。可选超时支持传入秒级timeout参数避免命令挂死。退出码感知命令失败会以非零退出码报错模型能看到并自行修正。实战提示系统提示词明确鼓励模型优先用 bash 做本地探索grep/find/ls和跑构建、测试。你可以直接说运行测试套件并修复所有报错Agent 会自己循环bash直到通过。工具二read —— 大文件也能精准分段读read工具读取文件文本支持offset起始行号和limit最大行数两个参数。超出2000 行 / 50KB时会自动截断并贴心地附上提示例如Use offset2001 to continue.模型据此逐段读完整个文件不会漏读。如果某一行本身就超长比如压缩过的 JSON它还会主动提示改用sed命令提取而不是硬塞进上下文。相关格式化逻辑见 shared/agent-core/coding-tools/index.ts。实战提示系统提示词要求先 read 再 edit——这是保证修改精准的核心纪律。你可以命令它先读一遍配置文件再告诉我哪里有问题它会带着行号逐段分析。工具三write —— 新建文件的零摩擦方案write工具把完整内容写入指定路径文件不存在则创建存在则覆盖父目录不存在会自动创建实现见 shared/agent-core/coding-tools/index.ts。成功后会回报实际写入的字节数。实战提示适合让 Agent 生成全新文件——测试用例、配置文件、脚手架脚本。对于已有文件它会自动优先选择更安全的edit而不是整文件重写。工具四edit —— 外科手术式精确改代码edit是五个工具里最精细的一个它不做整文件替换而是通过一组oldText → newText替换对在原文中做精确文本替换。规则很严格实现见 shared/agent-core/coding-tools/index.ts每个oldText必须在文件中唯一且各编辑之间不能重叠所有编辑都基于原始文件匹配互不影响自动保留文件的 BOM 头与原换行风格CRLF/LF不破坏代码格式。实战提示让模型把 range.ts 里的 off-by-one 错误修掉它通常只会输出两行改动而非重发整个文件——diff 干净、易审查也天然降低了大文件改错的风险。工具五webfetch —— 带安全防线的网页读取器webfetch读取指定 HTTP/HTTPS 网址并返回可读文本专为让 Agent 查文档、读 API 参考而生。它的安全与工程细节相当扎实完整实现见 cli/src/agent/webfetch.tsSSRF 防护先解析域名并钉住第一个 IP拒绝访问私有/内网地址每次跟随跳转最多 5 次都会重新校验防止跳转攻击。体量限制默认 15 秒超时、响应体最多 1.5MB、交给模型的正文最多 10 万字符超出会明确标注[Content truncated]。HTML 转纯文本内置一个零依赖的 HTML 解析器剥离标签、注释和script/style噪音解码实体后交给模型省 token 又干净。实战提示系统提示词规定的网络访问优先级是web_search如可用→ webfetch → 最后才允许 bash curl。所以让它查一下 Bun 最新 API 用法时它会走 webfetch 而不是让你批准 curl 权限。权限模式从步步审批到全自动写文件、跑命令之前CLI 默认会征求你的同意。四种模式可随时切换交互界面按 ShiftTab 循环或用/permissions命令定义见 cli/src/agent/permissions.ts模式bashwrite / edit适合场景ask默认每次询问每次询问陌生仓库、谨慎操作accept-edits每次询问自动放行常规开发read-only拦截拦截只做分析评审yolo自动放行自动放行可信项目、批量任务命令行也可以直接启动即指定thunderbolt --yolo 跑一遍测试坏什么修什么。最佳实践让五大工具组合发力结合系统提示词中的工作纪律cli/src/agent/system-prompt.ts推荐这样使用先探索后动手让它先用bashgrep/findread摸清代码结构再改。最小改动原则提示词要求做能解决问题最小的改动edit会严格遵守。验证必做提示词要求存在构建和测试就跑起来用输出验证而不是假设成功——放心让它自测。安全边界除非明确要求它不会git commit/push文件中读到的凭据也不会外泄。升级思考深度复杂任务加--thinking high比如thunderbolt --thinking high 找出并修复 src/range.ts 的 off-by-one 漏洞。写在最后Thunderbolt CLI 用 bash、read、write、edit、webfetch 五个简单工具覆盖了终端 AI 编程的绝大多数场景查代码、改代码、跑测试、读文档一气呵成。配合灵活的权限模式与多模型支持它既是一个省心的日常副驾驶也能在yolo模式下成为批量任务的生产力引擎。装一个二进制剩下的交给提示词——这就是 Thunderbolt CLI 的魅力。【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderbolt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Thunderbolt CLI五大工具实战：bash/read/write/edit/webfetch全解析
Thunderbolt CLI五大工具实战bash/read/write/edit/webfetch全解析【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderboltThunderbolt CLI 是一个单二进制文件的 AI 终端编码 Agent它在你的工作目录里直接干活只依赖五个核心工具——bash、read、write、edit、webfetch支持 Anthropic、OpenAI、Google 等各家模型没有守护进程、没有繁琐部署一条命令安装即可上手。本文带你逐个拆解这五大工具的工作机制、参数细节与实战用法帮你快速成为终端 AI 编程高手。为什么只需要五个工具大多数 AI 编码工具依赖庞大的插件生态而 Thunderbolt CLI 的思路恰恰相反给模型最少的、职责清晰的工具让它在终端里完成端到端的软件工程任务。五个工具分工明确工具一句话定位是否修改文件bash跑 shell 命令grep、测试、构建✅ 可能read精确读取文件内容❌write创建或覆盖整个文件✅edit对文件内文本做精确替换✅webfetch安全读取一个 HTTP/HTTPS 网址❌工具的完整实现集中在 shared/agent-core/coding-tools/index.tswebfetch 则独立在 cli/src/agent/webfetch.ts 中系统提示词由 cli/src/agent/system-prompt.ts 生成。快速安装一条命令拥有终端 AI 助手推荐使用远程安装器macOS arm64 与 Linux它会自动校验 SHA-256 并把二进制装到~/.local/bin/thunderbolt。也可以从源码构建git clone https://gitcode.com/GitHub_Trending/thund/thunderbolt cd thunderbolt bun install cd cli bun install bun run build ./install.sh首次运行thunderbolt时会引导你选择连接方式绑定 Thunderbolt 账户推荐扫码即可或直接为 Anthropic、OpenAI 等提供商配置 API Key。详细步骤见 cli/README.md 与 docs/quick-start.md。装好后两种用法# 一次性任务跑完即退出 thunderbolt 修复 utils.ts 里失败的测试 # 进入交互式 REPL持续对话 thunderbolt工具一bash —— 测试、日志、构建全能手bash工具在当前工作目录执行任意 shell 命令返回 stdout 和 stderr。三个关键机制值得了解实现见 shared/agent-core/coding-tools/index.ts智能截断输出最多保留最近2000 行或 50KB先到者生效完整输出会自动存到临时文件模型可以再去cat查看见 shared/agent-core/coding-tools/truncate.ts。可选超时支持传入秒级timeout参数避免命令挂死。退出码感知命令失败会以非零退出码报错模型能看到并自行修正。实战提示系统提示词明确鼓励模型优先用 bash 做本地探索grep/find/ls和跑构建、测试。你可以直接说运行测试套件并修复所有报错Agent 会自己循环bash直到通过。工具二read —— 大文件也能精准分段读read工具读取文件文本支持offset起始行号和limit最大行数两个参数。超出2000 行 / 50KB时会自动截断并贴心地附上提示例如Use offset2001 to continue.模型据此逐段读完整个文件不会漏读。如果某一行本身就超长比如压缩过的 JSON它还会主动提示改用sed命令提取而不是硬塞进上下文。相关格式化逻辑见 shared/agent-core/coding-tools/index.ts。实战提示系统提示词要求先 read 再 edit——这是保证修改精准的核心纪律。你可以命令它先读一遍配置文件再告诉我哪里有问题它会带着行号逐段分析。工具三write —— 新建文件的零摩擦方案write工具把完整内容写入指定路径文件不存在则创建存在则覆盖父目录不存在会自动创建实现见 shared/agent-core/coding-tools/index.ts。成功后会回报实际写入的字节数。实战提示适合让 Agent 生成全新文件——测试用例、配置文件、脚手架脚本。对于已有文件它会自动优先选择更安全的edit而不是整文件重写。工具四edit —— 外科手术式精确改代码edit是五个工具里最精细的一个它不做整文件替换而是通过一组oldText → newText替换对在原文中做精确文本替换。规则很严格实现见 shared/agent-core/coding-tools/index.ts每个oldText必须在文件中唯一且各编辑之间不能重叠所有编辑都基于原始文件匹配互不影响自动保留文件的 BOM 头与原换行风格CRLF/LF不破坏代码格式。实战提示让模型把 range.ts 里的 off-by-one 错误修掉它通常只会输出两行改动而非重发整个文件——diff 干净、易审查也天然降低了大文件改错的风险。工具五webfetch —— 带安全防线的网页读取器webfetch读取指定 HTTP/HTTPS 网址并返回可读文本专为让 Agent 查文档、读 API 参考而生。它的安全与工程细节相当扎实完整实现见 cli/src/agent/webfetch.tsSSRF 防护先解析域名并钉住第一个 IP拒绝访问私有/内网地址每次跟随跳转最多 5 次都会重新校验防止跳转攻击。体量限制默认 15 秒超时、响应体最多 1.5MB、交给模型的正文最多 10 万字符超出会明确标注[Content truncated]。HTML 转纯文本内置一个零依赖的 HTML 解析器剥离标签、注释和script/style噪音解码实体后交给模型省 token 又干净。实战提示系统提示词规定的网络访问优先级是web_search如可用→ webfetch → 最后才允许 bash curl。所以让它查一下 Bun 最新 API 用法时它会走 webfetch 而不是让你批准 curl 权限。权限模式从步步审批到全自动写文件、跑命令之前CLI 默认会征求你的同意。四种模式可随时切换交互界面按 ShiftTab 循环或用/permissions命令定义见 cli/src/agent/permissions.ts模式bashwrite / edit适合场景ask默认每次询问每次询问陌生仓库、谨慎操作accept-edits每次询问自动放行常规开发read-only拦截拦截只做分析评审yolo自动放行自动放行可信项目、批量任务命令行也可以直接启动即指定thunderbolt --yolo 跑一遍测试坏什么修什么。最佳实践让五大工具组合发力结合系统提示词中的工作纪律cli/src/agent/system-prompt.ts推荐这样使用先探索后动手让它先用bashgrep/findread摸清代码结构再改。最小改动原则提示词要求做能解决问题最小的改动edit会严格遵守。验证必做提示词要求存在构建和测试就跑起来用输出验证而不是假设成功——放心让它自测。安全边界除非明确要求它不会git commit/push文件中读到的凭据也不会外泄。升级思考深度复杂任务加--thinking high比如thunderbolt --thinking high 找出并修复 src/range.ts 的 off-by-one 漏洞。写在最后Thunderbolt CLI 用 bash、read、write、edit、webfetch 五个简单工具覆盖了终端 AI 编程的绝大多数场景查代码、改代码、跑测试、读文档一气呵成。配合灵活的权限模式与多模型支持它既是一个省心的日常副驾驶也能在yolo模式下成为批量任务的生产力引擎。装一个二进制剩下的交给提示词——这就是 Thunderbolt CLI 的魅力。【免费下载链接】thunderboltAI You Control: Choose your models. Own your data. Eliminate vendor lock-in.项目地址: https://gitcode.com/GitHub_Trending/thund/thunderbolt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考