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