桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载导读本文深入拆解 Trellis 在用户仓库中划分出的平台文件Platform Files体系——它是一组与 AI 工具一一对应的适配层目录负责让 Claude Code、Cursor、Codex、Gemini CLI 等不同工具以统一方式读取 Trellis 的共享运行时状态、调用脚本、加载 skills/agents/hooks。文章以 EcoPaste 仓库中实际落地的一套.claude/平台文件与.trellis/共享文件为真实案例说明平台文件的五大分类、三种平台接入模式、以及当用户要求定制行为时应遵循的本地修改顺序。读完本文你将掌握如何在多平台项目里正确识别共享文件与平台文件、判断当前 AI 工具属于哪种接入模式并知道改哪个文件、何时需要同步.trellis/共享工作流。一、先分清两类文件共享文件 vs 平台文件Trellis 的核心设计是同一套本地架构对接不同的 AI 工具.trellis/目录存放共享运行时shared runtime而各平台目录存放适配文件adapter files后者定义每个 AI 工具如何进入 Trellis。当本地 AI 需要修改 Trellis 时首先必须区分两类文件共享文件Shared files.trellis/workflow.md、.trellis/tasks/、.trellis/spec/、.trellis/scripts/。这些是 Trellis 的状态与逻辑本体与具体 AI 工具无关。平台文件Platform files.claude/、.codex/、.cursor/、.opencode/、.kiro/、.gemini/、.qoder/、.codebuddy/、.github/、.factory/、.pi/、.trae/、.kilocode/、.agent/、.devin/、.reasonix/、.zcode/以及类似的目录。在 EcoPaste 仓库中两者都有真实落地的实例共享运行时完整存在于 .trellis/.trellis/workflow.md工作流定义、.trellis/scripts/task.py、get_context.py等脚本、.trellis/spec/前端/后端规格文档、.trellis/tasks/任务归档以及.trellis/config.yaml配置。平台目录.claude/对应 Claude Code 平台包含 settings、hooks、agents、skills、commands 五个层面的适配文件下文逐一盘点。关键原则平台文件不存储业务状态。它们的作用只有一个——让对应的 AI 工具能够读取 Trellis 状态、调用 Trellis 脚本、加载 Trellis 的 skills/agents/hooks。任务状态永远属于.trellis/tasks/与.trellis/.runtime/平台文件只是入口。二、平台文件的五大分类Trellis 将平台文件按用途划分为五个类别原文表格如下CategoryCommon pathsPurposesettings/config.claude/settings.json、.codex/hooks.json、.qoder/settings.json、.trae/hooks.json注册 hooks、plugins、extensions 或平台行为。hooks/plugins/extensions.claude/hooks/、.opencode/plugins/、.pi/extensions/在会话开始、用户输入、agent 启动、shell 执行等事件时注入上下文。agents.claude/agents/、.codex/agents/、.kiro/agents/定义trellis-research、trellis-implement、trellis-check三个专用角色。skills.claude/skills/、.agents/skills/、.qoder/skills/能力描述文件可自动触发或按需读取。commands/prompts/workflows.cursor/commands/、.github/prompts/、.devin/workflows/由用户显式调用的入口点。以 EcoPaste 仓库的 .claude/ 目录为标本五类文件一一对应settings/config.claude/settings.json 是平台行为的注册中心。它登记了三类 hooksPreToolUsematcher 为Task与Agent→ 调用python3 .claude/hooks/inject-subagent-context.py超时 30 秒SessionStartmatcher 为startup、clear、compact→ 调用python3 .claude/hooks/session-start.py超时 30 秒UserPromptSubmit→ 调用python3 .claude/hooks/inject-workflow-state.py超时 15 秒。同时它还设置了环境变量CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR1并预留了空的enabledPlugins。hooks/plugins/extensions.claude/hooks/ 下实际有三个脚本正好对应三种事件注入session-start.py会话启动时生成结构化上下文inject-workflow-state.py每个用户轮次UserPromptSubmit解析.trellis/workflow.md中的[workflow-state:STATUS]标签并输出面包屑inject-subagent-context.py在 sub-agentimplement/check/research启动前注入 PRD、JSONL 上下文与相关 spec/research。agents.claude/agents/ 下存在trellis-research.md、trellis-implement.md、trellis-check.md三个 Markdown agent 文件分工与命名完全对齐上文表格。skills.claude/skills/ 下存放了trellis-brainstorm、trellis-before-dev、trellis-break-loop、trellis-channel、trellis-check、trellis-meta、trellis-session-insight、trellis-spec-bootstrap、trellis-update-spec等技能其中trellis-meta是多文件复合技能SKILL.mdreferences/分层引用trellis-channel也带references/子目录。commands.claude/commands/trellis/ 下提供continue.md与finish-work.md两个显式命令入口对应工作流的继续与收尾操作。三、三种平台接入模式不同 AI 平台的能力边界差异很大有的支持 hooks 在事件上主动注入有的只能靠 agent 文件里的开场白prelude指示 agent 自己拉取还有的既没有 Trellis sub-agent 也没有 hook 能力只能靠主会话工作流引导。Trellis 据此将平台划分为三种接入模式。模式一Hook / Extension 驱动主动注入这类平台可以在特定事件上触发脚本或插件主动把 Trellis 上下文塞给 AI。常见能力包括会话启动session-start注入一份.trellis/概览每个用户轮次提示工作流状态workflow-state hintssub-agent 启动时注入 PRD/spec/researchshell 命令继承会话身份。EcoPaste 仓库中.claude/settings.json的注册结构就是这种模式的典型实现SessionStart事件让 session-start.py 生成session-context、current-state、trellis-workflow、task-status等块UserPromptSubmit事件让 inject-workflow-state.py 输出workflow-state面包屑PreToolUseTask/Agent matcher事件则让 inject-subagent-context.py 在 sub-agent 工具被调用前注入任务上下文。从源码还可以看到平台感知的细节处理inject-workflow-state.py中_detect_platform通过环境变量如CLAUDE_PROJECT_DIR、CURSOR_PROJECT_DIR、GEMINI_PROJECT_DIR等识别当前宿主从而动态决定两件事——Gemini CLI 0.40.x 将每轮事件改名为BeforeAgent该脚本会为 Gemini 输出BeforeAgent而非 Claude 风格的UserPromptSubmitKiro 平台则直接把 hook 的 stdout 原样拼进对话上下文无 JSON 信封脚本为其单独走纯文本输出分支。session-start.py中同样存在_detect_platform与 Kiro 的裸文本分支。这说明同一套 hook 逻辑适配多平台事件名差异是 Trellis 平台文件的常见职责。何时改AI 知道什么优先检查 hooks/plugins/extensions 与 settings。模式二Agent Prelude / 拉取式Agent Pull有些平台无法可靠地让 hooks 改写 sub-agent 的提示词因此 agent 文件本身会指示 agent 在启动后主动读取活动任务、PRD 与 JSONL 上下文。这类模式下改变 sub-agent 如何加载上下文的落点就在 agent 文件本身。EcoPaste 仓库的 trellis-research.md 就是agent pull模式的教科书式实例它要求 Research Agent 在启动后先执行python3 ./.trellis/scripts/task.py current --source解析当前任务路径然后按需读取.trellis/下的任务与规格文件并严格限定写边界只允许写{TASK_DIR}/research/禁止改代码、spec、.trellis/scripts/等。这正是由 agent 文件自身拉取上下文的形态与 hook push 模式形成互补。模式三主会话工作流Main-Session Workflow部分平台既没有 Trellis sub-agent也没有 hook 能力只能依赖 workflows/skills/commands 引导主会话 AI 去读文件、跑脚本、推进任务。这类平台如 Kilo、Antigravity、Devin通常没有trellis-research/implement/check的 sub-agent 文件行为修改的落点是平台 workflows/skills/commands 与.trellis/workflow.md。对于这种模式修改行为的路径是检查平台工作流/skill/command 入口并同步.trellis/workflow.md中的共享流程描述。四、本地修改顺序五步定准改哪里当用户要求为某个平台定制行为时Trellis 建议 AI 按下述顺序检查文件而不是凭感觉乱改读.trellis/workflow.md确认共享流程读目标平台的 settings/config看已注册了哪些 hooks/agents/skills/commands读目标平台的 agents/skills/commands/hooks理解具体行为修改离用户需求最近的本地文件若改动影响共享流程同步.trellis/workflow.md或.trellis/spec/。原文同时给出两条必须遵守的告诫不要只改平台文件而忘了共享工作流不要只改.trellis/workflow.md而忘了平台入口里可能还残留旧描述。这两条告诫在 EcoPaste 仓库可以找到具象的印证平台 hooks 都从.trellis/读取数据源例如inject-workflow-state.py的注释明确写着Breadcrumb text is pulled exclusively from workflow.md[workflow-state:STATUS]tag blocks — workflow.md is the single source of truth即workflow.md 是唯一事实来源脚本内不存在兜底文案字典因此改了平台脚本却不改 workflow.md行为不会变而改了 workflow.md 却不同步平台入口如 command 文件、skill 的 descriptionAI 仍可能按旧描述行事。实际修改时还可借助trellis-metaskill 下的分层参考资料.claude/skills/trellis-meta/references/platform-files/目录中的 hooks-and-settings.mdhooks/settings 职责与排查路径、agents.mdagent 职责与两种上下文加载模式、skills-and-commands.md入口文件的编写规范、platform-map.md各平台路径矩阵以及.claude/skills/trellis-meta/references/customize-local/下的按场景修改指南change-hooks、change-agents、change-skills-or-commands 等——这些就是该改哪个文件的权威参考。五、常用修改场景速查综合 overview 及其姊妹参考文档常见的定制诉求与修改落点对应关系如下用户诉求修改位置新会话中 AI 看到更多/更少上下文平台session-starthook调整每轮提示策略.trellis/workflow.md中的[workflow-state:STATUS]块hook 原样解析无需改脚本sub-agent 读不到 PRD/specinject-subagent-contexthook 或 agent preludeshell 中task.py current无活动任务shell/session bridge hook 或平台环境变量配置关闭某项自动注入settings/config 中对应的 hook 注册项implement agent 需要额外约束平台trellis-implementagent 文件check agent 要跑项目专属命令trellis-checkagent 文件必要时改.trellis/spec/research agent 输出固定格式trellis-researchagent 文件新增项目级 skill平台 skill 目录或受支持的.agents/skills/共享层修改 continue/finish 入口平台 commands/prompts/workflows三条修改原则Settings 负责接线hooks 定义行为只改 hook 文件平台可能根本不调用它只改 settings 行为却不会变化。两者必须配套。先确认平台事件名不同平台对 SessionStart、UserPromptSubmit、AgentSpawn、shell 执行等事件命名不同仓库中inject-workflow-state.py对BeforeAgentvsUserPromptSubmit的运行时切换就是例证。Hooks 读的是本地.trellis/而非上游源码用户项目里的.trellis/scripts/与.trellis/workflow.md是默认目标错误必须可见——注入失败时应明确告诉用户什么没有注入而不是静默让 AI 处于无上下文状态。六、故障排查路径AI 没有读取 Trellis 状态怎么办当用户反馈AI 没有读取 Trellis 状态时按以下顺序排查检查平台 settings 是否注册了对应 hook检查 hook 文件是否存在手动运行 hook 所依赖的命令例如.trellis/scripts/get_context.py或task.py current --sourceEcoPaste 仓库中两者均存在于 .trellis/scripts/检查.trellis/.runtime/sessions/中是否存在活动任务状态检查平台 shell 是否传递了会话身份。这套路径在 EcoPaste 仓库的 hook 实现里同样有内建支撑inject-workflow-state.py的find_trellis_root会从当前目录向上逐级查找.trellis/支持子目录启动、monorepo 包等 CWD 漂移场景找不到就静默退出而build_breadcrumb在状态标签缺失时输出通用的 Refer to workflow.md for current step. 一行刻意让工作流文件损坏这种状态暴露给用户去修复而不是被 hook 掩盖。七、结语平台文件是入口共享文件是灵魂Trellis 平台文件体系的核心心智模型可以概括为三句话平台文件不存业务状态它们只是每个 AI 工具进入 Trellis 的适配入口三类接入模式决定修改落点hook 驱动改 hooks/settingsagent pull 改 agent prelude主会话工作流改 workflows/skills/commands任何修改都要双向检查同步改了平台文件要回头确认.trellis/workflow.md改了.trellis/workflow.md要回头确认平台入口描述。EcoPaste 仓库为我们提供了一个罕见的完整标本.claude/平台目录五类文件齐备.trellis/共享运行时真实落地hooks 脚本中还能看到面向多平台事件名的自适应逻辑。以此仓库为参照你可以在任何启用 Trellis 的项目中快速定位该改哪个文件并安全地完成跨平台 AI 工作流的本地定制。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐EcoPaste 仓库平台接入文件解析Trellis 平台文件Platform Files架构全解EcoPaste 仓库平台接入文件解析Trellis 平台文件Platform Files架构全解 导读 本文聚焦 Trellis 将本地架构接入不同 A桌面应用EcoPaste 仓库中的 Trellis 平台文件体系AI 工具如何接入共享工作流Platform Files Overview 实战解读EcoPaste 仓库中的 Trellis 平台文件体系AI 工具如何接入共享工作流Platform Files Overview 实战解读 导读 本文聚桌面应用定制 Trellis 本地工作流以 EcoPaste 仓库的 .trellis/workflow.md 修改为例定制 Trellis 本地工作流以 EcoPaste 仓库的 .trellis/workflow.md 修改为例 本指南讲解在 EcoPaste 这类已通过桌面应用上一篇3步获取阿里云盘Refresh Token开源扫码工具使用指南下一篇ComfyUI Photoshop Plugin技术实现与架构解析AI图像生成工作流的无缝集成方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考