AI Agent后端任務(wù)調(diào)度開(kāi)發(fā)工具可觀測(cè)性AI 應(yīng)用【免費(fèi)下載鏈接】trigger.devTrigger.dev – build and deploy durable AI agents and workflows項(xiàng)目地址https://gitcode.com/gh_mirrors/tr/trigger.dev點(diǎn)擊查看免費(fèi)下載本篇指南圍繞倉(cāng)庫(kù)內(nèi)的 .claude/rules/sdk-packages.md 規(guī)則展開(kāi)它約束著 Trigger.dev 所有packages/目錄下公開(kāi) SDK 包的每次改動(dòng)從何時(shí)必須寫(xiě) changeset、版本號(hào)默認(rèn)與升級(jí)邊界到trigger.dev/core必須使用子路徑導(dǎo)入、rules/與skills/目錄的治理邊界再到用hello-world項(xiàng)目驗(yàn)證改動(dòng)的實(shí)操流程。讀完本文你將掌握在 Trigger.dev monorepo 中安全修改并發(fā)布公共包的完整工作流以及這些規(guī)則背后的源碼與配置依據(jù)。規(guī)則適用范圍一切面向用戶的packages/**改動(dòng)該規(guī)則通過(guò) frontmatter 中的paths字段聲明了自己的作用域--- paths: - packages/** ---也就是說(shuō)只要改動(dòng)落在packages/目錄下規(guī)則就會(huì)在 Claude Code 等 Agent 工作流中自動(dòng)加載。當(dāng)前倉(cāng)庫(kù)中該目錄包含以下公開(kāi)包見(jiàn) packages/包目錄說(shuō)明cli-v3trigger.devCLI開(kāi)發(fā)、部署、環(huán)境變量、登錄等命令core橫跨 SDK 與平臺(tái)的核心代碼trigger.dev/coreplugins插件包trigger.dev/plugins已加入 changesets 的 ignore 列表pythonPython SDK 相關(guān)工具包react-hooksReact Hooks 包redis-workerRedis Worker 包內(nèi)部消費(fèi)不獨(dú)立發(fā)布rsc、schema-to-json、trigger-sdk其他公開(kāi)/輔助包這些包會(huì)發(fā)布到 npm 并被用戶直接npm install引用因此規(guī)則的第一句話就點(diǎn)明了核心立場(chǎng)Changes topackages/are customer-facing面向客戶。任何改動(dòng)都可能影響線上用戶的 SDK 行為所以不能用內(nèi)部重構(gòu)的心態(tài)對(duì)待。強(qiáng)制 Changesetpnpm run changeset:add規(guī)則要求對(duì)packages/的任何改動(dòng)都必須添加 changeset命令為pnpm run changeset:add該命令是倉(cāng)庫(kù)根 package.json 中對(duì)changesetCLI 的腳本封裝changeset:add: changeset運(yùn)行后會(huì)以交互方式引導(dǎo)你選擇受影響的包、確定版本升級(jí)類型并撰寫(xiě)發(fā)布說(shuō)明。關(guān)于什么時(shí)候加 changeset倉(cāng)庫(kù)的 CHANGESETS.md 給出了更細(xì)的補(bǔ)充changeset 是面向用戶的發(fā)布說(shuō)明user-facing release notes而不是每一次改動(dòng)的流水賬。僅當(dāng)改動(dòng)是用戶能感知、會(huì)據(jù)此行動(dòng)的變化時(shí)才需要添加純內(nèi)部重構(gòu)refactors、事務(wù)性改動(dòng)chores以及不被獨(dú)立消費(fèi)的包例如trigger.dev/redis-worker可以跳過(guò)。想查看精確歷史的人應(yīng)該去讀 commit。配套的配置.changeset/config.json根目錄的 .changeset/config.json 定義了整個(gè)發(fā)布機(jī)制的骨架幾個(gè)關(guān)鍵字段值得注意fixed: [[trigger.dev/*, trigger.dev]]所有trigger.dev/*包與trigger.devCLI 被固定為一組版本號(hào)必須同步升級(jí)避免 SDK 內(nèi)部互相依賴時(shí)出現(xiàn)版本錯(cuò)位access: public發(fā)布到公開(kāi) npm registrybaseBranch: main基于main分支計(jì)算版本與生成發(fā)布 PRignore: [webapp, supervisor, trigger.dev/plugins]apps/下的服務(wù)端應(yīng)用不參與 changesets 版本管理trigger.dev/plugins也被顯式忽略changelog使用remix-run/changelog-github生成 changelog 并關(guān)聯(lián)到triggerdotdev/trigger.dev倉(cāng)庫(kù)。發(fā)布流水線如何被觸發(fā)按照 CHANGESETS.md 的說(shuō)明整個(gè)發(fā)布鏈路是自動(dòng)化的在main分支的提交中新增 changeset 后changesets-pr.ymlworkflow 會(huì)自動(dòng)運(yùn)行創(chuàng)建一個(gè)執(zhí)行pnpm run changeset:version的版本發(fā)布 PR該發(fā)布 PR 的正文會(huì)被自動(dòng)增強(qiáng)合并去重后的包變更與.server-changes/條目摘要版本 PR 合并進(jìn)main后release.ymlworkflow 會(huì)自動(dòng)構(gòu)建、把包發(fā)布到 npm并生成統(tǒng)一的 GitHub Release。因此規(guī)則強(qiáng)調(diào)在包含改動(dòng)的同一個(gè) commit 里就加上 changeset這是讓 CI 流水線正常工作的最佳實(shí)踐。版本號(hào)策略默認(rèn) patch升級(jí)必須走審批規(guī)則的版本邊界非常清晰默認(rèn)選patch修復(fù)性變更如 bugfixminor新增向后兼容功能必須獲得 maintainer 批準(zhǔn)major破壞性變更絕不可以在沒(méi)有明確批準(zhǔn)的情況下選擇。這背后的原因不難從 changesets 的機(jī)制理解由于fixed配置把所有trigger.dev/*包綁定在一起任何一個(gè)包選擇major都會(huì)讓整個(gè) SDK 家族發(fā)生一次破壞性大版本跳躍直接影響所有下游用戶。所以版本號(hào)選擇本質(zhì)上是影響面審批改動(dòng)雖小但發(fā)布邊界必須由維護(hù)者把關(guān)。在運(yùn)行pnpm run changeset:add時(shí)若不確定該選哪個(gè)等級(jí)先向維護(hù)者確認(rèn)而不是自行決定。trigger.dev/core永遠(yuǎn)不要導(dǎo)入根入口規(guī)則中最具技術(shù)含量的一條是trigger.dev/coreNever import the root. Always use subpath imports (e.g.,trigger.dev/core/v3).也就是說(shuō)在 SDK 或平臺(tái)代碼中禁止寫(xiě)// ? 禁止導(dǎo)入根入口 import { something } from trigger.dev/core;必須寫(xiě)成子路徑形式// ? 正確子路徑導(dǎo)入 import { task } from trigger.dev/core/v3; import { tracer } from trigger.dev/core/v3/tracer; import { retry } from trigger.dev/core/v3/utils/retries;為什么exports 映射給出了答案看 packages/core/package.json 的exports字段即可理解trigger.dev/core根入口只導(dǎo)出極少的內(nèi)容——src/index.ts 僅轉(zhuǎn)發(fā)types.js、utils.js、schemas/json.js與version.js四個(gè)模塊而真正的 SDK 能力全部以具名子路徑形式暴露trigger.dev/core/v3→src/v3/index.tsSDK 主入口trigger.dev/core/v3/tracer→src/v3/tracer.tstrigger.dev/core/v3/build、trigger.dev/core/v3/appstrigger.dev/core/v3/errors、trigger.dev/core/v3/logger-apitrigger.dev/core/v3/otel、trigger.dev/core/v3/schemastrigger.dev/core/v3/utils/durations、trigger.dev/core/v3/utils/retries、trigger.dev/core/v3/utils/gitBranch、trigger.dev/core/v3/utils/ioSerialization等工具子路徑trigger.dev/core/v3/workers、trigger.dev/core/v3/machines、trigger.dev/core/v3/runEngineWorker、trigger.dev/core/v3/serverOnly、trigger.dev/core/v3/isomorphictrigger.dev/core/v3/test測(cè)試輔助同一份清單也以typesVersions形式為 TypeScript 提供了對(duì)應(yīng)的類型映射。這種根最小化 子路徑具名化的設(shè)計(jì)至少帶來(lái)三個(gè)收益按需加載、減小打包體積使用方只打包自己真正 import 的模塊避免把整個(gè) core 拖進(jìn) bundle顯式的環(huán)境邊界/v3/serverOnly與/v3/isomorphic等子路徑明確區(qū)分了只能在服務(wù)端使用與可在多端復(fù)用的代碼混用根入口容易破壞這一邊界面向未來(lái)的穩(wěn)定契約子路徑是包對(duì)外承諾的公共 API改動(dòng)它們會(huì)被exports與typesVersions雙重約束防止隱式破壞。因此在修改trigger.dev/core時(shí)新增或調(diào)整功能應(yīng)當(dāng)落在對(duì)應(yīng)的src/v3/...子模塊中并通過(guò)在package.json的tshy.exports中登記新子路徑來(lái)正式公開(kāi)它。受保護(hù)區(qū)rules/與.claude/skills/trigger-dev-tasks/規(guī)則還劃定了兩塊禁區(qū)Do NOT updaterules/or.claude/skills/trigger-dev-tasks/unless explicitly asked. These are maintained in separate dedicated passes.這兩處目錄根目錄的 rules/ 與 .claude/skills/trigger-dev-tasks/分別承載著 SDK 的版本化遷移規(guī)則和 Agent 開(kāi)發(fā)任務(wù)技能庫(kù)屬于由專門流程單獨(dú)維護(hù)的資產(chǎn)。即使你的 PR 涉及 packages 改動(dòng)也不應(yīng)順手修改這些文件——除非任務(wù)被明確要求。這保證了規(guī)則與技能庫(kù)的變更可審計(jì)、可追溯不會(huì)因?yàn)槿粘ｉ_(kāi)發(fā)被悄悄改動(dòng)。用 hello-world 項(xiàng)目驗(yàn)證每次改動(dòng)規(guī)則對(duì)測(cè)試給出了明確指令Test changes using thehello-worldproject in thetriggerdotdev/referencesrepo.即任何對(duì) SDK 包的行為改動(dòng)最終都要在一個(gè)獨(dú)立的references倉(cāng)庫(kù)中的hello-world項(xiàng)目上做真實(shí)驗(yàn)證。這與倉(cāng)庫(kù)內(nèi)使用測(cè)試項(xiàng)目驗(yàn)證的做法一致例如根目錄的 internal-test-projects.mts。實(shí)操建議在本地 monorepo 完成包修改后通過(guò)pnpmworkspace 或file:依賴把改動(dòng)指向hello-world項(xiàng)目運(yùn)行trigger.dev dev或直接執(zhí)行任務(wù)確認(rèn) SDK 在真實(shí)運(yùn)行時(shí)環(huán)境含構(gòu)建、打包、任務(wù)注冊(cè)與執(zhí)行下行為正確尤其要關(guān)注trigger.dev/core子路徑改動(dòng)是否影響現(xiàn)有 import 方。從源碼結(jié)構(gòu)看這種方式能覆蓋單測(cè)難以觸達(dá)的發(fā)布后集成場(chǎng)景——因?yàn)榘?exports 契約、打包產(chǎn)物與運(yùn)行時(shí)行為只有通過(guò)外部消費(fèi)項(xiàng)目才能得到完整驗(yàn)證。相關(guān)約定純服務(wù)端改動(dòng)走.server-changes/這條 SDK 規(guī)則還有一條重要的姊妹約定。當(dāng) PR只改服務(wù)端apps/webapp/、apps/supervisor/等且不涉及需要 changeset 的包改動(dòng)時(shí)按 .claude/rules/server-apps.md 的說(shuō)明應(yīng)添加一個(gè).server-changes/文件而非 changesetcat .server-changes/descriptive-name.md EOF --- area: webapp type: fix --- Fix pages occasionally loading unstyled during deploys. The dashboard now recovers automatically. EOF其中area只能是webapp或supervisortype只能是feature、fix、improvement、breaking。而對(duì)于同時(shí)改動(dòng)包與服務(wù)端的混合 PR規(guī)則約定只要包改動(dòng)需要 changeset就由 changeset 一并覆蓋無(wú)需再寫(xiě).server-changes/反之若包改動(dòng)是內(nèi)部性的、不需要 changeset而服務(wù)端改動(dòng)面向用戶則仍要補(bǔ)一個(gè).server-changes/文件。完整決策可參考 CHANGESETS.md 中的對(duì)照表?？偨Y(jié)一條規(guī)則三層保障.claude/rules/sdk-packages.md雖然只有六行卻把 Trigger.dev 公共 SDK 的開(kāi)發(fā)紀(jì)律壓縮成了三層保障發(fā)布紀(jì)律packages/的任何改動(dòng)都強(qiáng)制寫(xiě) changeset配合fixed版本組與 CI 流水線保證 npm 發(fā)布可追溯、版本一致版本邊界默認(rèn) patch、minor 需批準(zhǔn)、major 絕不擅自動(dòng)把破壞性變更的決策權(quán)收回到維護(hù)者手中工程約束trigger.dev/core只允許子路徑導(dǎo)入、rules/與skills/受保護(hù)、改動(dòng)必須經(jīng)hello-world項(xiàng)目實(shí)測(cè)從代碼邊界到測(cè)試驗(yàn)證全方位保護(hù)消費(fèi)者。對(duì)希望在 Trigger.dev monorepo 中貢獻(xiàn)代碼的開(kāi)發(fā)者而言遵守這條規(guī)則就是對(duì)自己改動(dòng)的用戶影響面負(fù)責(zé)。贊分享AI Agent后端任務(wù)調(diào)度開(kāi)發(fā)工具可觀測(cè)性AI 應(yīng)用【免費(fèi)下載鏈接】trigger.devTrigger.dev – build and deploy durable AI agents and workflows項(xiàng)目地址https://gitcode.com/gh_mirrors/tr/trigger.dev點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Perfetto SDK 發(fā)布流程全解版本策略、發(fā)布分支、Tag 規(guī)范與預(yù)編譯產(chǎn)物打包Perfetto SDK 發(fā)布流程全解版本策略、發(fā)布分支、Tag 規(guī)范與預(yù)編譯產(chǎn)物打包 本文基于 Perfetto 倉(cāng)庫(kù)中的官方貢獻(xiàn)指南 docs/contr可觀測(cè)性后端開(kāi)發(fā)工具前端數(shù)據(jù)可視化Open edX 平臺(tái) sys.path 修改移除決策導(dǎo)入路徑規(guī)范化與舊式導(dǎo)入遷移指南Open edX 平臺(tái) sys.path 修改移除決策導(dǎo)入路徑規(guī)范化與舊式導(dǎo)入遷移指南 導(dǎo)讀 本篇文章圍繞 Open edX 核心倉(cāng)庫(kù) openedx pla后端教育BFS-Best-Face-Swap版本對(duì)比V1到V5哪個(gè)最適合你的換臉需求BFS Best Face Swap版本對(duì)比V1到V5哪個(gè)最適合你的換臉需求 BFSBest Face Swap是一系列專為Qwen Image Edi計(jì)算機(jī)視覺(jué)AI 應(yīng)用大模型上一篇終極指南Weaviate向量數(shù)據(jù)庫(kù)的數(shù)據(jù)序列化與反序列化技術(shù)下一篇ZLUDA指令選擇目標(biāo)架構(gòu)適配創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考