桌面應(yīng)用【免費(fèi)下載鏈接】EcoPaste跨平臺(tái)的剪貼板管理工具 | Cross-platform clipboard management tool項(xiàng)目地址https://gitcode.com/ayangweb/EcoPaste點(diǎn)擊查看免費(fèi)下載Trellis 是 EcoPaste 倉庫中用于組織 AI 開發(fā)任務(wù)的工作流系統(tǒng)詳見 .trellis/workflow.md 與 .trellis/scripts/task.py。任務(wù)生命周期涵蓋任務(wù)的創(chuàng)建、啟動(dòng)、上下文配置、完成、歸檔、父子任務(wù)關(guān)系以及生命周期鉤子。本文以.cursor/skills/trellis-meta/references/customize-local/change-task-lifecycle.md為核心骨架結(jié)合 EcoPaste 倉庫內(nèi)的.trellis/實(shí)際配置與 Python 腳本源碼講解如何為項(xiàng)目定制 Trellis 任務(wù)生命周期幫助讀者掌握 hooks 配置、任務(wù)字段擴(kuò)展與活躍任務(wù)指針機(jī)制的實(shí)現(xiàn)細(xì)節(jié)。任務(wù)生命周期的組成與默認(rèn)定制目標(biāo)Trellis 的任務(wù)生命周期包括以下階段創(chuàng)建createtask.py create生成任務(wù)目錄寫入task.json默認(rèn)statusplanning啟動(dòng)starttask.py start寫入活躍任務(wù)指針并將status從planning翻轉(zhuǎn)為in_progress上下文配置context通過implement.jsonl/check.jsonl為子代理注入規(guī)格與研究上下文完成finishtask.py finish清除活躍任務(wù)指針觸發(fā)after_finishhooks歸檔archivetask.py archive將status置為completed并把任務(wù)目錄移動(dòng)到archive/{YYYY-MM}/觸發(fā)after_archivehooks父子任務(wù)parent/child通過--parent、add-subtask/remove-subtask建立層級(jí)關(guān)系默認(rèn)的定制目標(biāo)集中在三個(gè)目錄目標(biāo)用途.trellis/tasks/任務(wù) PRD、設(shè)計(jì)文檔、實(shí)施計(jì)劃、JSONL 上下文與歸檔目錄.trellis/config.yaml項(xiàng)目級(jí) Trellis 配置入口承載生命周期 hooks.trellis/scripts/生命周期行為的腳本實(shí)現(xiàn)task.py及各common/模塊動(dòng)手修改前先讀這些文件根據(jù)原文檔在進(jìn)行任何定制之前應(yīng)按順序閱讀以下文件以建立完整的心智模型.trellis/workflow.md —— 工作流階段、路由與[workflow-state:*]面包屑契約.trellis/config.yaml —— 項(xiàng)目級(jí)配置入口hooks 在此聲明.trellis/scripts/task.py —— 任務(wù)管理 CLI 入口create/start/finish/archive等子命令.trellis/scripts/common/task_store.py —— 任務(wù) CRUD 核心實(shí)現(xiàn)cmd_create、cmd_archive等.trellis/scripts/common/task_utils.py —— 任務(wù)路徑解析、查找與 hooks 執(zhí)行器run_task_hooks當(dāng)前任務(wù)的.trellis/tasks/task/task.json—— 任務(wù)元數(shù)據(jù)可參考倉庫中已歸檔的 task.json常見需求與對(duì)應(yīng)修改點(diǎn)速查表原文檔給出了一張需求 → 修改點(diǎn)映射表是生命周期定制最常用的導(dǎo)航工具需求修改點(diǎn)任務(wù)創(chuàng)建后自動(dòng)同步外部系統(tǒng).trellis/config.yaml中的hooks.after_create任務(wù)啟動(dòng)后自動(dòng)更新狀態(tài).trellis/config.yaml中的hooks.after_start任務(wù)完成后運(yùn)行腳本.trellis/config.yaml中的hooks.after_finish歸檔后清理外部資源.trellis/config.yaml中的hooks.after_archive修改任務(wù)默認(rèn)字段.trellis/scripts/common/task_store.py修改任務(wù)解析/搜索邏輯.trellis/scripts/common/task_utils.py修改活躍任務(wù)行為.trellis/scripts/common/active_task.py生命周期 hooks配置與執(zhí)行原理配置示例.trellis/config.yaml支持四個(gè)生命周期事件。原文檔給出的完整配置示例hooks: after_create: - python3 .trellis/scripts/hooks/my_sync.py create after_start: - python3 .trellis/scripts/hooks/my_sync.py start after_finish: - python3 .trellis/scripts/hooks/my_sync.py finish after_archive: - python3 .trellis/scripts/hooks/my_sync.py archive每個(gè)事件的值是字符串列表可以注冊(cè)多個(gè)命令。倉庫的 .trellis/config.yaml 中保留了同樣的 hooks 配置骨架注釋并補(bǔ)充了最簡(jiǎn)演示形式hooks: after_create: - echo Task created after_start: - echo Task started after_finish: - echo Task finished after_archive: - echo Task archived執(zhí)行語義TASK_JSON_PATH 與容錯(cuò)環(huán)境變量注入每個(gè) hook 命令執(zhí)行時(shí)都會(huì)收到TASK_JSON_PATH環(huán)境變量指向當(dāng)前任務(wù)的task.json絕對(duì)路徑。hook 腳本可以讀取它來獲取任務(wù)元數(shù)據(jù)標(biāo)題、狀態(tài)、meta等。工作目錄hook 命令在倉庫根目錄cwdrepo_root下以shellTrue執(zhí)行。非阻塞容錯(cuò)hook 失敗只打印[WARN] Hook failed (...)警告不會(huì)阻斷主任務(wù)操作。這一語義在源碼中有直接體現(xiàn)——task_utils.py 的run_task_hooks對(duì)每個(gè)命令捕獲非零退出碼與異常僅輸出黃色警告日志后繼續(xù)。源碼執(zhí)行鏈如下cmd_create/cmd_archive/cmd_start/cmd_finish等命令在完成自身邏輯后調(diào)用run_task_hooks(event, task_json_path, repo_root)run_task_hooks從配置模塊讀取hooks.event命令列表見 config.py 的get_hooks為每條命令構(gòu)造包含TASK_JSON_PATH的 env用subprocess.run(cmd, shellTrue, cwdrepo_root)執(zhí)行非零退出碼或異常僅產(chǎn)生警告不中斷流程。hooks 的觸發(fā)時(shí)機(jī)關(guān)鍵差異在 task.py 中可以看到各事件的確切觸發(fā)點(diǎn)after_create在task.py create完成目錄創(chuàng)建、task.json寫入、PRD 生成與 JSONL 種子文件寫入之后觸發(fā)見 task_store.pyafter_start在task.py start將status翻轉(zhuǎn)為in_progress之后觸發(fā)見 task.pyafter_finish在task.py finish清除活躍任務(wù)指針之后觸發(fā)。注意after_finish不等于狀態(tài)變更——它只是清除 active-task 指針status字段保持不變?nèi)蝿?wù)真正完成的通知應(yīng)使用after_archive見 task.pyafter_archive在task.py archive將status置為completed、目錄移動(dòng)到archive/{YYYY-MM}/之后以歸檔后的task.json路徑觸發(fā)見 task_store.py。修改任務(wù)字段優(yōu)先使用 meta如果要在項(xiàng)目里新增項(xiàng)目私有的任務(wù)字段優(yōu)先放在task.json的meta字段下避免破壞現(xiàn)有腳本對(duì)標(biāo)準(zhǔn)字段的假設(shè)。原文檔給出了示例meta: { linearIssue: ENG-123, risk: high }倉庫源碼印證了這一點(diǎn)cmd_create在構(gòu)建task_data時(shí)專門預(yù)留了meta: {}空對(duì)象見 task_store.py作為項(xiàng)目級(jí)擴(kuò)展的默認(rèn)掛載點(diǎn)。已歸檔任務(wù)的 task.json 也顯示meta: {}是標(biāo)準(zhǔn)字段。只有在確實(shí)需要修改標(biāo)準(zhǔn)字段如status、assignee、base_branch時(shí)才應(yīng)改動(dòng)task_store.py中cmd_create的task_data字典但必須先逐一審查所有讀取task.json的本地腳本確認(rèn)兼容性。修改活躍任務(wù)會(huì)話級(jí)指針而非全局指針設(shè)計(jì)原則活躍任務(wù)是會(huì)話級(jí)狀態(tài)存儲(chǔ)在.trellis/.runtime/sessions/下不要回退到全局.current-task模型。如果需要修改活躍任務(wù)行為編輯以下位置.trellis/scripts/common/active_task.py —— 活躍任務(wù)解析與指針讀寫平臺(tái) hooks 或 shell 會(huì)話橋接層.trellis/workflow.md 中活躍任務(wù)的描述會(huì)話身份context key如何解析從源碼看active_task.py 的resolve_context_key按以下優(yōu)先級(jí)解析穩(wěn)定的會(huì)話標(biāo)識(shí)TRELLIS_CONTEXT_ID環(huán)境變量—— CLI 腳本與子進(jìn)程的顯式覆蓋鍵hook 輸入platform_input中的session_id/conversation_id/transcript_path字段支持嵌套在input、properties、event等鍵下平臺(tái)原生環(huán)境變量—— 例如 Claude Code 的CLAUDE_SESSION_ID、Cursor 的CURSOR_SESSION_ID、OpenCode 的OPENCODE_SESSION_ID等見_ENV_SESSION_KEYSCursor shell ticket 橋接—— Cursor 不向 shell 導(dǎo)出會(huì)話 ID因此 hook 會(huì)在task.py運(yùn)行前寫入一個(gè)短生命周期30 秒 TTL的 ticket.trellis/.runtime/cursor-shell/*.json腳本通過匹配子命令與唯一的 fresh context key 來還原會(huì)話身份。task.py create會(huì)設(shè)置活躍指針best-effort這是原文檔重點(diǎn)講解的行為源碼位于cmd_create的末尾見 task_store.py有會(huì)話身份時(shí)調(diào)用 shell 攜帶TRELLIS_CONTEXT_ID或平臺(tái)會(huì)話環(huán)境變量resolve_context_key能識(shí)別參見active_task.py的_ENV_SESSION_KEYS則.trellis/.runtime/sessions/context_key.json會(huì)被重寫指向新任務(wù)。此時(shí)任務(wù)的statusplanning并且[workflow-state:planning]會(huì)在下一個(gè)UserPromptSubmit時(shí)立即生效無會(huì)話身份時(shí)AI 會(huì)話之外的裸 CLI 調(diào)用或平臺(tái)不向 shell 傳播身份任務(wù)目錄照常創(chuàng)建、statusplanning照常寫入但活躍指針保持不變。用戶回到 AI 會(huì)話后可以用task.py start dir手動(dòng)附加該任務(wù)。這一行為使得[workflow-state:planning]在task.py create之后的頭腦風(fēng)暴與 JSONL 策展期間成為活的面包屑。原文檔指出R7 之前的行為會(huì)讓面包屑一直停留在no_task直到task.py start導(dǎo)致規(guī)劃區(qū)塊實(shí)際上是死文本。其他活躍指針操作task.py startset_active_task寫入會(huì)話指針并冪等地把status從planning翻轉(zhuǎn)為in_progresstask.py finishclear_active_task刪除當(dāng)前會(huì)話的.runtime/sessions/context_key.json文件status保持不變task.py archiveclear_task_from_sessions刪除所有仍指向該任務(wù)的會(huì)話文件再把目錄移入歸檔見 task_store.py。如果 forktask.py新增創(chuàng)建路徑原文檔給出重要提醒如果 forktask.py增加新的創(chuàng)建路徑例如繞過cmd_create的外部導(dǎo)入必須審計(jì)新路徑是否也調(diào)用了set_active_task。缺少該調(diào)用創(chuàng)建的任務(wù)不會(huì)成為活躍任務(wù)。完整的狀態(tài)寫入方表格位于.trellis/spec/cli/backend/workflow-state-contract.md倉庫中該路徑為 .trellis/spec/ 目錄實(shí)際契約文檔需確認(rèn)存在后引用。修改步驟一套可復(fù)現(xiàn)的操作流程原文檔給出的標(biāo)準(zhǔn)修改流程用python3 ./.trellis/scripts/task.py current --source確認(rèn)當(dāng)前任務(wù)閱讀當(dāng)前任務(wù)的task.json確認(rèn)狀態(tài)與字段配置類需求先編輯 .trellis/config.yaml腳本行為類需求再編輯 .trellis/scripts/如果 AI 流程變了同步更新 .trellis/workflow.md。倉庫的 workflow.md 同時(shí)提供了生命周期常用命令的權(quán)威清單# Task lifecycle python3 ./.trellis/scripts/task.py create title [--slug name] [--parent dir] python3 ./.trellis/scripts/task.py start name # set active task (session-scoped when available) python3 ./.trellis/scripts/task.py current --source # show active task and source python3 ./.trellis/scripts/task.py finish # clear active task (triggers after_finish hooks) python3 ./.trellis/scripts/task.py archive name # move to archive/{year-month}/ python3 ./.trellis/scripts/task.py list [--mine] [--status s] python3 ./.trellis/scripts/task.py list-archiveDo Not生命周期定制的紅線原文檔明確的禁止事項(xiàng)不要直接編輯.trellis/.runtime/sessions/去修復(fù)業(yè)務(wù)狀態(tài)——會(huì)話指針是運(yùn)行時(shí)產(chǎn)物直接改會(huì)造成狀態(tài)與磁盤不一致不要把項(xiàng)目私有字段硬編碼進(jìn)腳本——優(yōu)先使用meta字段承載項(xiàng)目級(jí)擴(kuò)展數(shù)據(jù)不要默認(rèn)讓用戶 fork Trellis CLI——絕大多數(shù)定制都能在.trellis/內(nèi)部完成fork 上游只應(yīng)在確認(rèn)無法通過本地定制實(shí)現(xiàn)時(shí)考慮?？偨Y(jié)EcoPaste 倉庫內(nèi)的 Trellis 任務(wù)生命周期由.trellis/config.yamlhooks 聲明、.trellis/scripts/task.pyCLI 入口、.trellis/scripts/common/task_store.pyCRUD 與活躍指針設(shè)置、.trellis/scripts/common/task_utils.pyhooks 執(zhí)行器與.trellis/scripts/common/active_task.py會(huì)話級(jí)指針協(xié)同實(shí)現(xiàn)。定制時(shí)遵循配置優(yōu)先、meta 擴(kuò)展、會(huì)話級(jí)活躍指針、hook 非阻塞四條原則即可在不觸碰上游 CLI 的前提下將任務(wù)生命周期與項(xiàng)目的外部系統(tǒng)、自定義字段和 AI 工作流深度整合。贊分享桌面應(yīng)用【免費(fèi)下載鏈接】EcoPaste跨平臺(tái)的剪貼板管理工具 | Cross-platform clipboard management tool項(xiàng)目地址https://gitcode.com/ayangweb/EcoPaste點(diǎn)擊查看免費(fèi)下載相關(guān)推薦深入定制 Trellis 本地任務(wù)生命周期hooks、task.json 字段與活動(dòng)任務(wù)指針的完整改造指南深入定制 Trellis 本地任務(wù)生命周期hooks、task.json 字段與活動(dòng)任務(wù)指針的完整改造指南 導(dǎo)讀 本文面向需要深度定制 Trellis 本地任桌面應(yīng)用Trellis 任務(wù)生命周期定制指南從創(chuàng)建到歸檔的 Hook 機(jī)制與活動(dòng)任務(wù)原理Trellis 任務(wù)生命周期定制指南從創(chuàng)建到歸檔的 Hook 機(jī)制與活動(dòng)任務(wù)原理 Trellis 的本地任務(wù)系統(tǒng)把任務(wù)生命周期拆分為創(chuàng)建create、啟動(dòng)桌面應(yīng)用Trigger.dev任務(wù)取消機(jī)制靈活控制任務(wù)生命周期的終極指南Trigger.dev任務(wù)取消機(jī)制靈活控制任務(wù)生命周期的終極指南 在構(gòu)建可靠的后臺(tái)任務(wù)系統(tǒng)時(shí) 任務(wù)取消機(jī)制 是確保資源有效管理和用戶體驗(yàn)的關(guān)鍵功能。TrigAI Agent后端任務(wù)調(diào)度開發(fā)工具可觀測(cè)性AI 應(yīng)用上一篇SweetAlert 使用指南優(yōu)雅替代JavaScript原生彈窗下一篇Qlib量化研究平臺(tái)詳細(xì)工作流程解析創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考