桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载导读本文聚焦 Trellis 将本地架构接入不同 AI 工具的核心机制——平台文件Platform Files。内容围绕.claude/、.codex/、.cursor/、.opencode/、.kiro/、.gemini/等平台目录的定位、分类与三种集成模式展开并结合 EcoPaste 仓库中实际存在的适配文件进行佐证。读者读完可掌握如何区分共享文件与平台文件、各类平台文件的职责边界、平台接入的三种工作模式以及自定义行为时的本地修改顺序与排查路径。平台文件的定位连接本地架构与 AI 工具的适配层Trellis 将同一套本地架构连接到不同的 AI 工具。.trellis/存放共享运行时平台目录存放适配文件定义每种 AI 工具如何进入 Trellis。平台文件不存储业务状态只负责让对应的 AI 工具读取 Trellis 状态、调用 Trellis 脚本、加载 Trellis 的 skills/agents/hooks。在 EcoPaste 仓库中这一结构已经实际落地共享文件.trellis/workflow.md、.trellis/tasks/、.trellis/spec/、.trellis/scripts/、.trellis/agents/、.trellis/config.yaml、.trellis/workspace/平台文件.claude/、.codex/、.cursor/、.opencode/、.kiro/、.gemini/、.agents/skills/Codex 写入的共享 skills 层、.github/等平台文件分类五大职责域类别常见路径用途设置/配置.claude/settings.json、.codex/hooks.json、.qoder/settings.json、.trae/hooks.json注册 hooks、插件、扩展或平台行为hooks/插件/扩展.claude/hooks/、.opencode/plugins/、.pi/extensions/在会话开始、用户输入、Agent 启动、shell 执行等事件注入上下文agents.claude/agents/、.codex/agents/、.kiro/agents/定义trellis-research、trellis-implement、trellis-checkskills.claude/skills/、.agents/skills/、.qoder/skills/能力描述可自动触发或按需读取commands/prompts/workflows.cursor/commands/、.github/prompts/、.devin/workflows/由用户显式调用的入口EcoPaste 仓库实际验证了这一分类。以.claude/为例设置文件.claude/settings.json注册了 SessionStart、UserPromptSubmit、PreToolUseTask/Agent三类 hookshooks 目录.claude/hooks/存放session-start.py、inject-workflow-state.py、inject-subagent-context.pyagents 目录.claude/agents/存放trellis-research.md、trellis-implement.md、trellis-check.mdskills 目录.claude/skills/存放trellis-meta、trellis-brainstorm、trellis-before-dev等commands 目录.claude/commands/trellis/存放continue.md、finish-work.md三种平台集成模式1. Hook / Extension 驱动模式这类平台能在特定事件触发脚本或插件主动向 AI 注入 Trellis 上下文。常见能力会话开始注入.trellis/概览每轮用户输入注入 workflow 状态提示子 Agent 启动时注入 PRD/spec/researchShell 命令继承会话身份要修改AI 何时知道什么先检查 hooks/plugins/extensions 和 settings。EcoPaste 中.claude/settings.json的 SessionStart 钩子在 startup/clear/compact 三个 matcher 下运行session-start.pyUserPromptSubmit 钩子运行inject-workflow-state.py解析[workflow-state:STATUS]块PreToolUse 钩子为 Task/Agent 注入子 Agent 上下文。.cursor/hooks.json对应地注册了beforeShellExecution、preToolUsematcher:Task|Subagent、sessionStart三类钩子。2. Agent Prelude / 拉取模式部分平台无法让 hooks 可靠改写子 Agent 提示词因此 agent 文件自身指示 agent 在启动后读取活动任务、PRD 和 JSONL 上下文。要修改子 Agent 的上下文加载方式直接检查 agent 文件。3. 主会话工作流模式Kilo、Antigravity、Devin 等平台没有 Trellis 子 Agent 或 hook 能力依赖 workflows/skills/commands 引导主会话 AI 读取文件、运行脚本、推进任务。修改行为需检查平台 workflows/skills/commands 和.trellis/workflow.md。本地修改顺序五步操作法当用户要求定制某平台行为时按此顺序检查读.trellis/workflow.md确认共享流程读目标平台的 settings/config确认注册了哪些 hooks/agents/skills/commands读目标平台的 agents/skills/commands/hooks修改最贴近用户需求的本地文件若改动影响共享流程同步更新.trellis/workflow.md或.trellis/spec/不要只改平台文件而忘了共享 workflow也不要只改.trellis/workflow.md而忘了平台入口可能仍含旧描述。平台文件映射与决策规则平台目录矩阵平台CLI flag主目录skills 目录agents 目录hooks/扩展Claude Code--claude.claude/.claude/skills/.claude/agents/.claude/hooks/.claude/settings.jsonCursor--cursor.cursor/.cursor/skills/.cursor/agents/.cursor/hooks.json.cursor/hooks/OpenCode--opencode.opencode/.opencode/skills/.opencode/agents/.opencode/plugins/Codex--codex.codex/.agents/skills/.codex/agents/.codex/hooks/.codex/hooks.jsonKilo--kilo.kilocode/.kilocode/skills/通常无.kilocode/workflows/Kiro--kiro.kiro/.kiro/skills/.kiro/agents/.kiro/hooks/Gemini CLI--gemini.gemini/.agents/skills/.gemini/agents/.gemini/settings.json.gemini/hooks/Qoder--qoder.qoder/.qoder/skills/.qoder/agents/.qoder/hooks/.qoder/settings.jsonGitHub Copilot--copilot.github/.github/skills/.github/agents/.github/copilot/hooks/ promptsPi Agent--pi.pi/.pi/skills/.pi/agents/.pi/extensions/trellis/.pi/settings.jsonTrae IDE--trae.trae/.trae/skills/.trae/agents/.trae/hooks/.trae/hooks.jsonReasonix--reasonix.reasonix/.reasonix/skills/无无修改平台文件时的决策规则用户指定某平台只改该平台目录除非共享 workflow/spec 文件也必须改用户说所有平台都要这样做逐个平台同步等价入口不能只改一个目录用户只说我的 AI检查项目中实际存在的配置目录推断当前 AI 平台用户想要项目规则优先用.trellis/spec/或项目本地 skill用户想要 Trellis 行为编辑.trellis/workflow.md及平台 hooks/agents/skills/commands路径不一致时以实际文件为准平台生态会变用户项目可能已被定制。若矩阵与本地文件不一致以用户项目中实际的 settings/config 为准检查 settings 注册的 hook 指向检查 command/prompt/workflow 指向的脚本依据 agent 文件当前的读取规则判断行为不要因为路径表没列出就删除自定义文件。平台文件的分工与修改要点agents角色定义文件Trellis agent 文件定义专业化角色trellis-research调查问题并把发现写入当前任务research/、trellis-implement依据 prd.md、可选 design.md/implement.md、implement.jsonl 和相关 spec/research 实现、trellis-check审查变更、修复发现的问题并运行必要检查。各平台 agent 路径不同Claude Code.claude/agents/trellis-*.mdCodex.codex/agents/trellis-*.tomlKiro.kiro/agents/trellis-*.jsonCursor.cursor/agents/trellis-*.mdOpenCode.opencode/agents/trellis-*.md两种上下文加载模式hook push平台 hook 在 agent 启动前注入任务上下文agent 文件专注职责与边界和agent pullagent 文件指示 agent 启动后读取task.py current --source、implement.jsonl/check.jsonl、JSONL 引用的 spec/research、prd.md、design.md、implement.md。修改原则保持单一职责、明确读取顺序、明确写入边界、多平台语义同步。EcoPaste 中.trellis/agents/check.md与 implement.md 是平台无关的 channel runtime agent 定义编辑平台内 trellis-implement/check.md 不会改变 channel worker 行为。hooks 与 settings连接平台的入口层settings/config 通常注册session-start hook会话开始注入 Trellis 概览、workflow-state hook解析[workflow-state:STATUS]块并发出匹配当前任务状态的内容、sub-agent context hook子 Agent 启动时注入任务上下文、shell/session bridge让 shell 命令看到同一 Trellis 会话身份、平台插件/扩展入口。常见脚本类型脚本用途session-start.py生成会话开始上下文inject-workflow-state.py解析.trellis/workflow.md中[workflow-state:STATUS]块发出匹配当前任务状态的内容无匹配块时回退为Refer to workflow.md for current step.inject-subagent-context.py向子 Agent 注入 PRD、JSONL 上下文及相关 spec/researchinject-shell-session-context.py让 shell 命令继承 Trellis 会话身份EcoPaste 中.claude/hooks/inject-workflow-state.py正是这样解析 workflow.md 中的[workflow-state:no_task]、[workflow-state:planning]、[workflow-state:in_progress]、[workflow-state:completed]等块。.claude/hooks/session-start.py则输出session-context、current-state含 git 分支状态、当前任务状态、journal 行数、spec index 数、trellis-workflowPhase Index 摘要、task-status等结构化块并支持TRELLIS_HOOKS0/TRELLIS_DISABLE_HOOKS1及非交互标志跳过注入。Cursor 的.cursor/hooks/inject-shell-session-context.py负责 shell 会话桥接。修改原则settings 负责接线、hooks 定义行为先确认平台事件名hooks 读本地.trellis/而非上游源码错误必须可见。skills、commands、prompts、workflows文本入口类型触发模式最适合skillAI 自动匹配或用户显式提及长期能力、工作流规则、修改指南command用户显式调用明确的操作入口如 continue、finish-workprompt用户显式调用或平台选择类似 command但采用平台 prompt 格式workflow用户显式选择或平台自动匹配无子 Agent/hook 时引导主会话常见 skill 结构为目录SKILL.mdreferences/SKILL.md说明何时使用、先读哪个 reference、不该做什么references 承载长文解释。命令/提示词/工作流通常是单文件包含何时使用、读哪些.trellis/文件、运行哪些脚本、完成后如何汇报不存储任务状态。修改原则入口文件保持简短、触发描述具体、跨平台语义一致、项目特定能力放入本地 skill。排障路径AI 未读取 Trellis 状态时若用户反馈AI 没有读取 Trellis 状态检查平台 settings 是否注册了 hook检查 hook 文件是否存在手动运行 hook 依赖的命令.trellis/scripts/get_context.py或task.py current --source检查.trellis/.runtime/sessions/是否存在活动任务状态检查平台 shell 是否传递会话身份关键配置文件实例.claude/settings.json的 hook 注册结构{ hooks: { PreToolUse: [ { hooks: [{ command: python3 .claude/hooks/inject-subagent-context.py, timeout: 30, type: command }], matcher: Task }, { hooks: [{ command: python3 .claude/hooks/inject-subagent-context.py, timeout: 30, type: command }], matcher: Agent } ], SessionStart: [ { hooks: [{ command: python3 .claude/hooks/session-start.py, timeout: 30, type: command }], matcher: startup }, { hooks: [{ command: python3 .claude/hooks/session-start.py, timeout: 30, type: command }], matcher: clear }, { hooks: [{ command: python3 .claude/hooks/session-start.py, timeout: 30, type: command }], matcher: compact } ], UserPromptSubmit: [ { hooks: [{ command: python3 .claude/hooks/inject-workflow-state.py, timeout: 15, type: command }] } ] } }.cursor/hooks.json的对应注册{ hooks: { beforeShellExecution: [{ command: python3 .cursor/hooks/inject-shell-session-context.py, timeout: 5 }], preToolUse: [{ command: python3 .cursor/hooks/inject-subagent-context.py, matcher: Task|Subagent, timeout: 30 }], sessionStart: [{ command: python3 .cursor/hooks/session-start.py, timeout: 30 }] }, version: 1 }.trellis/config.yaml中的平台相关配置channel: worker_guard: idle_timeout: 5m max_live_workers: 6 # codex: # dispatch_mode: inline # 或 sub-agent 派发 trellis-* 子 Agentcodex.dispatch_mode是 Codex 专属开关默认inline主 Agent 直接改代码因为 Codex 子 Agent 以fork_turnsnone隔离运行无法继承父会话上下文设为sub-agent可启用旧式派发模型。其他平台忽略此键。结论Trellis 平台文件的本质是一层薄适配共享运行时在.trellis/平台目录只负责接线。EcoPaste 仓库展示了多平台Claude Code、Cursor、Codex、OpenCode、Kiro、Gemini CLI同时接入的实际布局涵盖 hooks 驱动、agent 拉取、主会话工作流三种模式。理解共享/平台文件的边界、按序检查、以本地文件为准是安全定制多平台 AI 工作流的关键。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐EcoPaste 仓库中的 Trellis 跨平台文件地图15 个 AI 平台的目录布局与修改决策规则EcoPaste 仓库中的 Trellis 跨平台文件地图15 个 AI 平台的目录布局与修改决策规则 导读 Trellis 通过 .trellis/ 目录保桌面应用Ptex性能基准测试与其他纹理系统的对比分析Ptex性能基准测试与其他纹理系统的对比分析 Ptex作为一款面向生产渲染的每面纹理映射系统在计算机图形学领域具有独特的技术优势。本文将通过客观的性能基准测桌面应用Trellis trellis init 生成文件全解析.trellis/ 目录结构、模板哈希与平台集成层定制边界Trellis trellis init 生成文件全解析 .trellis/ 目录结构、模板哈希与平台集成层定制边界 trellis init 会在用户项目中桌面应用上一篇超实用图像处理功能扩展工具ComfyUI_essentials全解析下一篇10个你必须掌握的Untitled UI React高级组件从数据表格到图表可视化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考