AI 技能AI 插件【免費下載鏈接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.項目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills點擊查看免費下載導(dǎo)讀本文是 AASagentic-awesome-skills技能庫中bun-development技能的詳細指南系統(tǒng)講解如何在 Bun 運行時上完成現(xiàn)代 JavaScript/TypeScript 開發(fā)。你將掌握 Bun 的安裝與項目初始化、包管理、代碼運行與熱更新、內(nèi)置 API文件系統(tǒng)、HTTP/WebSocket 服務(wù)器、SQLite、密碼哈希、內(nèi)置測試運行器、生產(chǎn)級打包與單文件編譯以及從 Node.js 平滑遷移的完整路徑。全文代碼均可在本倉庫對應(yīng)的技能文件 detailed-guide.md 與 SKILL.md 中溯源。在 AAS 技能庫中bun-development是一條由社區(qū)貢獻source: community的技能風險等級標記為critical于 2026-02-27 收錄見 SKILL.md 頭部元數(shù)據(jù)并在技能索引 data/skills_index.json 中被歸類為web-development支持 Codex 與 Claude 兩個插件目標端。它適用于以下場景使用 Bun 啟動新 JS/TS 項目、從 Node.js 遷移到 Bun、優(yōu)化開發(fā)速度、使用 Bun 內(nèi)置工具打包器、測試運行器以及排查 Bun 特有問題的調(diào)試。1. 安裝與選型為什么要用 Bun1.1 多平臺安裝方式原文檔提供了四種主流安裝路徑覆蓋 macOS / Linux / Windows 以及通過 npm 安裝的備選方案# macOS / LinuxHomebrew 官方 tap brew install oven-sh/bun/bun # 備選方案下載官方安裝腳本先審查再執(zhí)行安全性最佳實踐 tmpdir$(mktemp -d) trap rm -rf $tmpdir EXIT curl -fsSLo $tmpdir/bun-install.sh https://bun.sh/install cat $tmpdir/bun-install.sh # 執(zhí)行前完整審閱安裝腳本內(nèi)容 bash $tmpdir/bun-install.sh # WindowsPowerShell powershell -NoProfile -Command Invoke-WebRequest https://bun.sh/install.ps1 -OutFile $env:TEMP\\bun-install.ps1; Get-Content $env:TEMP\\bun-install.ps1 -TotalCount 120; powershell -ExecutionPolicy Bypass -File $env:TEMP\\bun-install.ps1 # Homebrew 二段式安裝先 tap 再 install brew tap oven-sh/bun brew install bun # npm 安裝已有 Node 環(huán)境時使用 npm install -g bun升級直接執(zhí)行bun upgrade即可將 Bun 升級到最新版本。值得強調(diào)的是文檔給出的“下載腳本后先cat審閱再執(zhí)行”的做法與本倉庫 SECURITY_GUARDRAILS.md 強調(diào)的供應(yīng)鏈安全意識一致——在執(zhí)行任何來自網(wǎng)絡(luò)的安裝腳本前應(yīng)確認其內(nèi)容可信。1.2 Bun 與 Node.js 的核心差異原文檔給出了 Bun 相對 Node.js 的對比表這也是選擇 Bun 的核心依據(jù)特性BunNode.js啟動時間~25ms~100ms依賴安裝快 10-100 倍基線BaselineTypeScript原生支持需額外轉(zhuǎn)譯器JSX原生支持需額外轉(zhuǎn)譯器測試運行器內(nèi)置外部Jest、Vitest打包器內(nèi)置外部Webpack、esbuild說明上表數(shù)據(jù)來源于本技能文檔 detailed-guide.md 的原始表述屬于 Bun 官方宣傳口徑的引用實際性能表現(xiàn)會因機器、項目規(guī)模與負載而異建議以你自己的基準測試為準。2. 項目搭建從零初始化到工程化配置2.1 創(chuàng)建新項目# 交互式初始化項目 bun init # 生成的文件結(jié)構(gòu) # ├── package.json # ├── tsconfig.json # ├── index.ts # └── README.md # 使用特定模板創(chuàng)建項目 bun create template project-name # 常見模板示例 bun create react my-app # React 應(yīng)用 bun create next my-app # Next.js 應(yīng)用 bun create vite my-app # Vite 應(yīng)用 bun create elysia my-api # Elysia API 服務(wù)bun init通過交互式問答生成最小可運行的 TypeScript 項目骨架bun create則從官方/社區(qū)模板腳手架完整應(yīng)用適合業(yè)務(wù)項目初始化。2.2 package.json 的 Bun 最佳實踐{ name: my-bun-project, version: 1.0.0, module: index.ts, type: module, scripts: { dev: bun run --watch index.ts, start: bun run index.ts, test: bun test, build: bun build ./index.ts --outdir ./dist, lint: bunx eslint . }, devDependencies: { types/bun: latest }, peerDependencies: { typescript: ^5.0.0 } }關(guān)鍵要點module: index.ts是 Bun 識別的入口字段對 ESM 項目友好dev腳本使用bun run --watch實現(xiàn)文件變更自動重啟測試腳本直接使用內(nèi)置的bun test無需再安裝 Jest/Vitesttypes/bun提供Bun.*全局 API 的類型聲明是 TS 開發(fā)必需。2.3 面向 Bun 優(yōu)化的 tsconfig.json{ compilerOptions: { lib: [ESNext], module: esnext, target: esnext, moduleResolution: bundler, moduleDetection: force, allowImportingTsExtensions: true, noEmit: true, composite: true, strict: true, downlevelIteration: true, skipLibCheck: true, jsx: react-jsx, allowSyntheticDefaultImports: true, forceConsistentCasingInFileNames: true, allowJs: true, types: [bun-types] } }這套配置與原文檔給出的“Bun-optimized”版本一致moduleResolution: bundler適配 Bun 的打包語義allowImportingTsExtensions允許直接導(dǎo)入.ts文件因為noEmit下 Bun 直接執(zhí)行源碼、無需輸出編譯產(chǎn)物jsx: react-jsx啟用 JSX 原生支持。注意types字段隨版本演進可寫為bun-types或types/bun兩者對應(yīng)同一套全局類型。3. 包管理bun install / add / remove / update3.1 安裝依賴bun install # 按 package.json 安裝全部依賴可簡寫 bun i # 添加依賴 bun add express # 常規(guī)依賴 bun add -d typescript # 開發(fā)依賴 bun add -D types/node # 開發(fā)依賴-D 為 -d 的別名 bun add --optional pkg # 可選依賴 # 從指定 registry 安裝 bun add lodash --registry https://registry.npmmirror.com # 安裝指定版本 bun add react18.2.0 # 精確版本 bun add reactlatest # 最新穩(wěn)定版 bun add reactnext # 預(yù)發(fā)布版本 # 從 Git 倉庫安裝 bun add github:user/repo bun add githttps://github.com/user/repo.git3.2 移除與更新bun remove lodash # 移除依賴 bun update # 更新全部依賴遵守版本范圍約束 bun update lodash # 更新指定包 bun update --latest # 忽略版本范圍直接更新到最新 bun outdated # 檢查過期依賴3.3 bunxnpm/npx 的替代品bunx可直接執(zhí)行包內(nèi)的二進制命令無需先寫入node_modulesbunx prettier --write . # 格式化 bunx tsc --init # 初始化 tsconfig bunx create-react-app my-app # 腳手架 bunx -p typescript4.9 tsc --version # 使用指定版本的包執(zhí)行 bunx cowsay Hello from Bun! # 臨時執(zhí)行工具3.4 Lockfile 管理# bun.lockb 是二進制鎖文件解析更快 # 需要調(diào)試時可生成文本鎖文件 bun install --yarn # 生成 yarn.lock文本可讀 # 信任既有鎖文件按鎖定的精確版本安裝CI 常用 bun install --frozen-lockfile--frozen-lockfile在 CI/CD 中保證構(gòu)建可重復(fù)是本倉庫 docs/WORKFLOWS.md 中強調(diào)的可復(fù)現(xiàn)構(gòu)建理念在 Bun 側(cè)的具體映射。4. 運行代碼直接執(zhí)行、Watch 模式與環(huán)境變量4.1 基礎(chǔ)執(zhí)行# 直接運行 TypeScript無需構(gòu)建步驟 bun run index.ts # 運行 JavaScript bun run index.js # 帶參數(shù)運行 bun run server.ts --port 3000 # 運行 package.json 中定義的腳本 bun run dev bun run build # 腳本短格式自動查找 package.json scripts bun dev bun build4.2 Watch 與 Hot 模式# 文件變更后自動重啟進程 bun --watch run index.ts # 熱更新模式保持進程、模塊級熱替換適合開發(fā)服務(wù)器 bun --hot run server.ts4.3 環(huán)境變量.env文件會被自動加載無需引入dotenv// 通過 Bun.env 讀取推薦 const apiKey Bun.env.API_KEY; const port Bun.env.PORT ?? 3000; // 或使用 Node.js 兼容的 process.env const dbUrl process.env.DATABASE_URL;# 指定特定 env 文件運行 bun --env-file.env.production run index.ts--env-file支持指定文件路徑為多環(huán)境dev/staging/production部署提供了與 docs/examples 中環(huán)境隔離實踐一致的方案。5. 內(nèi)置 API 深度解析Bun 內(nèi)置了五大高頻 API全部開箱即用無需任何第三方依賴。5.1 文件系統(tǒng)Bun.file 與 Bun.write// 讀取文件惰性讀取僅在需要時加載 const file Bun.file(./data.json); const text await file.text(); // 文本內(nèi)容 const json await file.json(); // 直接解析 JSON const buffer await file.arrayBuffer(); // ArrayBuffer // 文件元信息 console.log(file.size); // 字節(jié)數(shù) console.log(file.type); // MIME 類型 // 寫入文件 await Bun.write(./output.txt, Hello, Bun!); await Bun.write(./data.json, JSON.stringify({ foo: bar })); // 流式讀取大文件 const reader file.stream(); for await (const chunk of reader) { console.log(chunk); }Bun.file采用惰性求值配合stream()可高效處理大文件避免整文件載入內(nèi)存。5.2 HTTP 服務(wù)器Bun.serveconst server Bun.serve({ port: 3000, // 標準 Web Fetch API 風格的請求處理器 fetch(request) { const url new URL(request.url); if (url.pathname /) { return new Response(Hello World!); } if (url.pathname /api/users) { return Response.json([ { id: 1, name: Alice }, { id: 2, name: Bob }, ]); } return new Response(Not Found, { status: 404 }); }, // 統(tǒng)一錯誤處理 error(error) { return new Response(Error: ${error.message}, { status: 500 }); }, }); console.log(Server running at http://localhost:${server.port});Bun.serve基于 Web 標準 Request/Response 模型fetch處理器天然支持異步error回調(diào)統(tǒng)一兜底異?！@套結(jié)構(gòu)在 7.2 節(jié)構(gòu)建 API 中同樣復(fù)用。5.3 WebSocket 服務(wù)器const server Bun.serve({ port: 3000, // 在 fetch 中通過 server.upgrade 升級連接 fetch(req, server) { if (server.upgrade(req)) { return; // 升級成功進入 WebSocket 生命周期 } return new Response(Upgrade failed, { status: 500 }); }, websocket: { open(ws) { console.log(Client connected); ws.send(Welcome!); }, message(ws, message) { console.log(Received: ${message}); ws.send(Echo: ${message}); }, close(ws) { console.log(Client disconnected); }, }, });Bun 將 HTTP 與 WebSocket 統(tǒng)一在同一個Bun.serve中server.upgrade(req)返回真值表示協(xié)議升級成功之后所有消息通過websocket對象的open/message/close鉤子驅(qū)動天然支持廣播等實時場景。5.4 SQLitebun:sqliteimport { Database } from bun:sqlite; const db new Database(mydb.sqlite); // 建表 db.run( CREATE TABLE IF NOT EXISTS users ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, email TEXT UNIQUE ) ); // 插入預(yù)編譯語句 const insert db.prepare(INSERT INTO users (name, email) VALUES (?, ?)); insert.run(Alice, aliceexample.com); // 單條查詢 const query db.prepare(SELECT * FROM users WHERE name ?); const user query.get(Alice); console.log(user); // { id: 1, name: Alice, email: aliceexample.com } // 全量查詢 const allUsers db.query(SELECT * FROM users).all();bun:sqlite是 Bun 原生內(nèi)置的同步 SQLite 驅(qū)動prepare()預(yù)編譯 run/get/all三步式 API 既直觀又高效適合本地緩存、輕量持久化等場景無需額外安裝better-sqlite3等原生模塊。5.5 密碼哈希Bun.password// 生成隨機密碼crypto 為全局對象 const password crypto.randomUUID(); // 哈希默認算法 const hash await Bun.password.hash(password); // 驗證 const isValid await Bun.password.verify(password, hash); console.log(isValid); // true // 指定算法與成本參數(shù) const bcryptHash await Bun.password.hash(password, { algorithm: bcrypt, cost: 12, // bcrypt 計算成本因子默認 10范圍約 4-31 });Bun.password內(nèi)置多種哈希算法如 bcryptverify會自動識別哈希中的算法標識因此即便哈希參數(shù)變化也能正確校驗——這是用戶認證系統(tǒng)的關(guān)鍵安全特性。6. 測試內(nèi)置測試運行器 bun:test6.1 基礎(chǔ)測試用例// math.test.ts import { describe, it, expect, beforeAll, afterAll } from bun:test; describe(Math operations, () { it(adds two numbers, () { expect(1 1).toBe(2); }); it(subtracts two numbers, () { expect(5 - 3).toBe(2); }); });6.2 運行測試bun test # 運行全部測試 bun test math.test.ts # 運行指定文件 bun test --grep adds # 按名稱模式過濾 bun test --watch # 監(jiān)聽模式 bun test --coverage # 覆蓋率報告 bun test --timeout 5000 # 全局超時毫秒6.3 常用斷言 Matchersimport { expect, test } from bun:test; test(matchers, () { // 相等性 expect(1).toBe(1); expect({ a: 1 }).toEqual({ a: 1 }); expect([1, 2]).toContain(1); // 比較 expect(10).toBeGreaterThan(5); expect(5).toBeLessThanOrEqual(5); // 真值性 expect(true).toBeTruthy(); expect(null).toBeNull(); expect(undefined).toBeUndefined(); // 字符串 expect(hello).toMatch(/ell/); expect(hello).toContain(ell); // 數(shù)組 expect([1, 2, 3]).toHaveLength(3); // 異常 expect(() { throw new Error(fail); }).toThrow(fail); // 異步 await expect(Promise.resolve(1)).resolves.toBe(1); await expect(Promise.reject(err)).rejects.toBe(err); });bun:test的 matcher 覆蓋相等、比較、真值、字符串、數(shù)組、異常與異步 Promiseresolves/rejects等主流斷言場景API 風格與 Jest 高度接近遷移成本低。6.4 Mock 與 Spyimport { mock, spyOn } from bun:test; // Mock 函數(shù) const mockFn mock((x: number) x * 2); mockFn(5); expect(mockFn).toHaveBeenCalled(); expect(mockFn).toHaveBeenCalledWith(5); expect(mockFn.mock.results[0].value).toBe(10); // 對對象方法打樁 const obj { method: () original, }; const spy spyOn(obj, method).mockReturnValue(mocked); expect(obj.method()).toBe(mocked); expect(spy).toHaveBeenCalled();mock用于創(chuàng)建可斷言調(diào)用行為是否被調(diào)用、調(diào)用參數(shù)、返回結(jié)果的函數(shù)spyOn用于替換對象方法并保留調(diào)用記錄。二者共同支撐單元測試中的隔離策略。7. 打包與編譯從源碼到生產(chǎn)產(chǎn)物7.1 CLI 基礎(chǔ)打包# 生產(chǎn)打包 bun build ./src/index.ts --outdir ./dist # 帶完整選項 bun build ./src/index.ts \ --outdir ./dist \ --target browser \ --minify \ --sourcemap--target可選browser/bun/node決定打包產(chǎn)物面向的運行環(huán)境與外部依賴裁剪策略。7.2 Build API以編程方式打包const result await Bun.build({ entrypoints: [./src/index.ts], outdir: ./dist, target: browser, // 或 bun、node minify: true, sourcemap: external, splitting: true, // 代碼分割 format: esm, // 輸出模塊格式 // 外部依賴不打入產(chǎn)物 external: [react, react-dom], // 定義全局常量 define: { process.env.NODE_ENV: JSON.stringify(production), }, // 輸出命名規(guī)則 naming: { entry: [name].[hash].js, chunk: chunks/[name].[hash].js, asset: assets/[name].[hash][ext], }, }); if (!result.success) { console.error(result.logs); // 失敗時輸出診斷日志 }Bun.build是 CLI 的編程式等價物適合在構(gòu)建腳本、CI 管線或工具鏈中動態(tài)調(diào)用result.success與result.logs提供結(jié)構(gòu)化結(jié)果反饋。7.3 編譯為單文件可執(zhí)行程序# 生成獨立可執(zhí)行文件內(nèi)含運行時無需預(yù)裝 Bun bun build ./src/cli.ts --compile --outfile myapp # 交叉編譯到其他平臺 bun build ./src/cli.ts --compile --targetbun-linux-x64 --outfile myapp-linux bun build ./src/cli.ts --compile --targetbun-darwin-arm64 --outfile myapp-mac # 內(nèi)嵌靜態(tài)資源 bun build ./src/cli.ts --compile --outfile myapp --embed ./assets--compile把入口、依賴和 Bun 運行時一起打包成單一可執(zhí)行文件--target支持跨平臺交叉編譯--embed將資源文件內(nèi)嵌進二進制——這一能力與本倉庫 scripts/activate-skills.sh 所倡導(dǎo)的“零外部依賴交付”理念一脈相承非常適合分發(fā) CLI 工具。8. 從 Node.js 遷移到 Bun8.1 兼容性概覽// 絕大多數(shù) Node.js API 開箱即用 import fs from fs; import path from path; import crypto from crypto; // process 為全局對象 console.log(process.cwd()); console.log(process.env.HOME); // Buffer 為全局對象 const buf Buffer.from(hello); // __dirname 與 __filename 可用 console.log(__dirname); console.log(__filename);8.2 遷移四步走# 1. 安裝 Bun brew install oven-sh/bun/bun # 2. 用 Bun 替換包管理器 rm -rf node_modules package-lock.json bun install # 3. 更新 package.json 腳本 # start: node index.js → start: bun run index.ts # test: jest → test: bun test # 4. 添加 Bun 類型 bun add -d types/bun8.3 與 Node.js 的差異對照// ? Node.js 專有寫法在 Bun 中可能不可用 require(module) // 應(yīng)改用 import require.resolve(pkg) // 應(yīng)改用 import.meta.resolve __non_webpack_require__ // 不支持 // ? Bun 等價寫法 import pkg from pkg; const resolved import.meta.resolve(pkg); Bun.resolveSync(pkg, process.cwd()); // ? 存在差異的全局 API process.hrtime() // 應(yīng)使用 Bun.nanoseconds() setImmediate() // 應(yīng)使用 queueMicrotask() // ? Bun 特色能力 const file Bun.file(./data.txt); // 快速文件 API Bun.serve({ port: 3000, fetch: ... }); // 快速 HTTP 服務(wù)器 Bun.password.hash(password); // 內(nèi)置密碼哈希遷移的關(guān)鍵紀律優(yōu)先使用 ESMimport語義、import.meta.resolve做路徑解析、Bun.nanoseconds()替代高精度計時將 Node 兼容寫法替換為 Bun 原生 API 以獲取最佳性能。9. 性能優(yōu)化建議9.1 優(yōu)先使用 Bun 原生 API// 較慢Node 兼容路徑 import fs from fs/promises; const content await fs.readFile(./data.txt, utf-8); // 更快Bun 原生 const file Bun.file(./data.txt); const content await file.text();9.2 HTTP 服務(wù)優(yōu)先 Bun.serve// 不推薦Express/Fastify存在額外開銷 import express from express; const app express(); // 推薦Bun.serve原生實現(xiàn)性能顯著更高 Bun.serve({ fetch(req) { return new Response(Hello!); }, }); // 或使用 Bun 深度優(yōu)化的 Elysia 框架 import { Elysia } from elysia; new Elysia().get(/, () Hello!).listen(3000);原文檔指出Bun.serve相比傳統(tǒng)框架在吞吐上可達 4-10 倍優(yōu)勢若需要路由中間件等框架能力優(yōu)先選擇為 Bun 量身定做的 Elysia。9.3 生產(chǎn)環(huán)境務(wù)必打包壓縮# 生產(chǎn)構(gòu)建壓縮 目標環(huán)境 bun build ./src/index.ts --outdir ./dist --minify --target node # 然后運行打包產(chǎn)物 bun run ./dist/index.js10. 速查表Quick Reference任務(wù)命令初始化項目bun init安裝依賴bun install添加依賴bun add pkg運行腳本bun run script運行文件bun run file.ts監(jiān)聽模式bun --watch run file.ts運行測試bun test打包構(gòu)建bun build ./src/index.ts --outdir ./dist執(zhí)行包命令bunx pkg結(jié)語在 AAS 生態(tài)中使用本技能bun-development技能SKILL.md在本倉庫中被標記為risk: critical意味著技能文檔明確要求執(zhí)行前必須完整閱讀本文detailed-guide并將其中的安全約束、前置條件與驗證要求視為強制項聚焦型任務(wù)按需加載對應(yīng)章節(jié)端到端任務(wù)則需完整通讀見 SKILL.md 的 Detailed Guide 章節(jié)。同時技能自身聲明了使用邊界僅在與上述場景明確匹配時使用不將輸出視為環(huán)境特定驗證、測試或?qū)＜以u審的替代品當輸入、權(quán)限、安全邊界或成功標準缺失時應(yīng)停止并請求澄清——這與 docs/QUALITY_BAR.md 中關(guān)于技能質(zhì)量與責任邊界的約定保持一致。對開發(fā)者而言本文覆蓋的安裝、項目搭建、包管理、運行、內(nèi)置 API、測試、打包、遷移與性能優(yōu)化九大主題構(gòu)成了在 Bun 上從原型到生產(chǎn)的一條完整鏈路。你可以將本文檔的代碼示例直接落地驗證并結(jié)合 data/skills_index.json 中該技能的索引信息分類web-development、Codex/Claude 雙端支持、setup.type為none即開箱即用確認其在 AAS 目錄中的可發(fā)現(xiàn)性與接入方式。贊分享AI 技能AI 插件【免費下載鏈接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.項目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills點擊查看免費下載相關(guān)推薦CubeSandbox調(diào)度增強路線圖資源感知放置與實時再平衡CubeSandbox調(diào)度增強路線圖資源感知放置與實時再平衡 CubeSandbox 是一個面向 AI Agent 的即時、并發(fā)、安全且輕量級的沙箱平臺它的Agent 沙箱虛擬化云原生人工智能后端容器運行時Angular Expert 技能指南基于 Agentic Awesome Skills 掌握 Signals、Standalone 與 Zoneless 現(xiàn)代開發(fā)范式Angular Expert 技能指南基于 Agentic Awesome Skills 掌握 Signals、Standalone 與 Zoneless 現(xiàn)AI 技能AI 插件Azure Cosmos DB Java SDK 實戰(zhàn)指南基于 agentic-awesome-skills 技能的全局分布式 NoSQL 開發(fā)Azure Cosmos DB Java SDK 實戰(zhàn)指南基于 agentic awesome skills 技能的全局分布式 NoSQL 開發(fā) 本文以 agAI 技能AI 插件上一篇Functorch vs JAXPyTorch用戶必須知道的5大差異下一篇ComfyUI-Lumi-Batcher工具啟動延遲問題分析與解決方案創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考