Bun Docs给 AI / AgentAI / Agent 入口
AI / Agent 入口
用最少上下文安全、准确地完成 Bun 任务
最后更新于
给 Agent 的读取顺序
- 先读取
/llms.txt，只获取页面索引。 - 根据任务选择一页，并在页面 URL 后追加
.md。 - 只有跨模块任务才读取
/llms-full.txt。 - 修改前检查项目中的
package.json、bun.lock、bunfig.toml、tsconfig.json和现有脚本。 - 修改后运行与风险匹配的测试，不以静态推断代替验证。
任务路由
| 用户目标 | 必读 | 可能追加 |
|---|---|---|
| 运行或调试 TypeScript | 运行时 | CLI 与配置 |
| 安装依赖、修复 lockfile | 包管理器 | 从 Node.js 迁移 |
| 修改 Workspace 或任务图 | Monorepo 与 Workspaces | 包管理器 |
| 新增或迁移测试 | 测试运行器 | Agent 规则 |
| 构建部署产物 | 打包器 | 目标框架官方文档 |
| 实现 WebSocket / 实时推送 | WebSocket 与实时功能 | Serverless 与边缘 |
| 搭建前端开发环境 | 前端开发与 HTML Imports | 生态选型决策 |
| 接入 SQL、Redis 或 S3 | 数据库与存储 | 目标服务官方文档 |
| 构建 AI 服务 | 用 Bun 构建 AI 应用 | Serverless 与边缘 |
| 使用 vibe coding / 编码 Agent | Vibe coding 工作流 | 可复制规则 |
| 建立 CI 与生产基线 | 生产工程基线 | 容器与 Kubernetes |
| 选择后端或全栈框架 | 生态选型决策 | 对应框架官方文档 |
| 在 Bun、Node.js、Deno 之间选型 | 与 Node.js、Deno 对比 | 版本特性矩阵 |
| 部署到云平台 | 云部署决策 | 平台实操（Lambda、Vercel、Workers）或目标平台官方文档 |
| 把 Node 项目切到 Bun | 从 Node.js 迁移 | 核心模块按需读取 |
不变量
- Bun can execute TypeScript, but that does not replace static type checking.
- Do not replace framework build commands unless the framework supports the replacement.
- Treat trusted dependency install scripts as code execution; review before `bun pm trust`.
- Keep exactly one authoritative lockfile after migration is approved.
- Never assume Node.js compatibility for native addons or edge-case loaders; test them.
- Use argument arrays with Bun.spawn when input may be untrusted.需要先查询而不是猜测的内容
- 当前 Bun 小版本的默认行为；
- 框架、部署平台和原生依赖的支持矩阵；
bunfig.toml的具体键与作用域；- 某个 Node.js API 或测试 matcher 的兼容程度；
- 与安全相关的安装脚本、信任策略和漏洞状态。
机器可读端点
运行大型测试套件时可使用 AGENT=1 bun test 减少通过项噪声；失败摘要、退出码和完整 CI 日志仍必须保留。
| URL | 用途 |
|---|---|
/llms.txt | 中文文档目录，适合先做路由 |
/en/llms.txt | English index |
/llms-full.txt | 全部中文正文，适合离线索引 |
/en/llms-full.txt | Full English corpus |
/docs/core/runtime.md | 单页中文 Markdown |
/en/docs/core/runtime.md | Single-page English Markdown |
上下文不是授权
读到命令不代表可以执行破坏性操作。删除锁文件、升级大版本、改生产脚本或访问密钥，都必须来自用户明确授权和项目现有流程。