桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载trellis init会在用户项目中落下一整套 Trellis 本地运行时包括.trellis/目录、各 AI 平台目录如.claude/、.codex/、.cursor/与共享技能层.agents/skills/而trellis update则借助.trellis/.template-hashes.json区分模板文件被用户改过没有从而决定自动更新、提示覆盖还是按迁移规则处理。本篇指南以 EcoPaste 仓库中实际生成的 Trellis 文件为样本逐一拆解每个生成文件的职责、可编辑性分级、模板哈希的工作原理以及多平台集成文件的协同机制帮助你安全地本地定制 Trellis 而不破坏后续更新。.trellis/Trellis 本地运行时的核心目录运行trellis init之后项目根目录会生成.trellis/目录其典型布局如下.trellis/ ├── workflow.md ├── config.yaml ├── .developer ├── .version ├── .template-hashes.json ├── .runtime/ ├── scripts/ ├── spec/ ├── tasks/ └── workspace/这一结构在 EcoPaste 仓库中完整存在.trellis/下可见workflow.md、config.yaml、agents/、scripts/、spec/、tasks/、workspace/等条目与文档描述一一对应。整个目录从功能上可归入三类本地系统层工作流层Workflow layer.trellis/workflow.md定义阶段phases、AI 路由routing、下一步行动与提示词块prompt blocks。持久化层Persistence layer.trellis/tasks/、.trellis/spec/、.trellis/workspace/分别存放任务、项目规约与会话记忆。平台集成层Platform integration layer各平台目录中的 hooks、settings、agents、skills、commands、prompts、workflows 把 Trellis 工作流接入不同 AI 工具。这三层全部位于用户项目内部因此 AI 可以直接读取和修改它们。各生成文件的可编辑性一览文档对.trellis/下每个路径给出了通常是否可编辑的明确判定路径通常可编辑说明.trellis/workflow.md是本地工作流文档与 AI 路由规则.trellis/config.yaml是项目配置hooks、packages、日志行数上限及相关设置.trellis/spec/是项目规约预期由用户与 AI 定期更新.trellis/tasks/是任务素材与研究产物由任务工作流维护.trellis/workspace/是会话记录通常由add_session.py写入.trellis/scripts/谨慎本地运行时理解调用链之后方可定制.trellis/.runtime/否运行时状态通常由 hooks/scripts 自动写入.trellis/.developer谨慎当前开发者身份.trellis/.version否Trellis 版本记录供 update/migration 逻辑使用.trellis/.template-hashes.json否模板哈希记录不要在此手写业务规则关键文件的仓库实证以 EcoPaste 仓库实际内容为例可以确认这些路径的真实形态与用途.trellis/workflow.md约 708 行开篇定义五项核心原则Plan before code、Specs injected not remembered、Persist everything、Incremental development、Capture learnings随后按 Trellis System、Spec System、Task System、Workspace System 等模块组织。它既是本地工作流的主文档也是 AI 路由和提示词块的来源。.trellis/config.yaml项目级配置的注释模板覆盖会话录制session_commit_message、max_journal_lines、session_auto_commit、任务生命周期 hooksafter_create/after_start/after_finish/after_archive、monorepo 包声明packages、default_package、channel worker 的 OOM 防护channel.worker_guard.idle_timeout、max_live_workers以及 Codex 的分派模式codex.dispatch_mode: inline | sub-agent。.trellis/.version内容为0.6.5即当前 Trellis 运行时版本记录供 update 与迁移逻辑比对。.trellis/scripts/add_session.py工作区会话写入脚本头部 docstring 详细描述了--title、--commit、--summary、--branch、--stdin等参数以及分支解析顺序显式--branch→task.json的 branch 字段 →git branch --show-current自动探测 → 省略。这正是workspace/会话记录通常由add_session.py写入这一行的具体实现。.trellis/.gitignore声明.developer、.current-task、.runtime/、.ralph-state.json、.agents/、.agent-log、.session-id、.plan-log、*.tmp、.backup-*、*.new、Python 缓存等均为本地/临时内容不入库。.trellis/spec/与.trellis/tasks/在本仓库中分别存放了backend/、frontend/、guides/的规约文档以及按月归档tasks/archive/2026-06/、2026-07/的任务目录每个任务含prd.md、task.json、implement.jsonl、check.jsonl等。平台目录一个项目多套 AI 工具入口不同平台会生成不同的目录但整体可归为四类hooks、settings、agents、skills以及 commands/prompts/workflows。类别示例路径用途hooks.claude/hooks/、.codex/hooks/、.cursor/hooks/注入会话上下文、工作流状态与子代理上下文settings.claude/settings.json、.codex/hooks.json、.qoder/settings.json、.trae/hooks.json告知平台何时运行 hooks 或 pluginsagents.claude/agents/、.codex/agents/、.kiro/agents/、.zcode/cli/agents/定义trellis-research、trellis-implement、trellis-check等代理skills.claude/skills/、.agents/skills/、.qoder/skills/可自动触发或由 AI 读取的技能commands/prompts/workflows.cursor/commands/、.github/prompts/、.devin/workflows/、.zcode/commands/用户显式调用的命令或工作流入口EcoPaste 仓库的多平台实证在本仓库中可以同时观察到多套平台目录的实际落盘情况.claude/agents/下含trellis-check.md、trellis-implement.md、trellis-research.md三个代理定义commands/trellis/下含continue.md、finish-work.mdhooks/下含inject-subagent-context.py、inject-workflow-state.py、session-start.py三个 Python hookskills/下挂载了trellis-before-dev至trellis-update-spec等十余个技能目录。settings.json中通过PreToolUseTask/Agent 匹配inject-subagent-context.py、SessionStartstartup/clear/compact匹配session-start.py、UserPromptSubmitinject-workflow-state.py声明了 hook 的触发时机与超时30s / 15s。.cursor/同样有agents/同名三个代理、commands/trellis-continue.md、trellis-finish-work.md、hooks/inject-shell-session-context.py、inject-subagent-context.py、session-start.py。.codex/agents/下是.toml格式的代理定义trellis-check.toml、trellis-implement.toml、trellis-research.tomlhooks/下有inject-workflow-state.py与session-start.py另有hooks.json与config.toml声明触发配置。.kiro/agents/下除三个trellis-*.json外还有trellis.jsonhooks/下含trellis-workflow-state.kiro.hook与三个 Python hook。.gemini/包含agents/、commands/、hooks/与settings.json。.github/prompts/下是continue.prompt.md、finish-work.prompt.md另有agents/、copilot/、hooks/、skills/、workflows/。.opencode/agents/、commands/、plugins/、skills/等。共享技能层.agents/skills/包含trellis-before-dev、trellis-brainstorm、trellis-break-loop、trellis-channel、trellis-check、trellis-continue、trellis-finish-work、trellis-meta、trellis-session-insight、trellis-spec-bootstrap、trellis-start、trellis-update-spec、sync-zh-changelog等技能目录其中trellis-meta又细分为references/customize-local/、references/local-architecture/、references/platform-files/三个参考文档组。从源码结构可以推断同一套 Trellis 工作流通过每个平台一份薄层适配文件的方式接入不同 AI 工具核心逻辑集中在.trellis/scripts/如get_context.py、task.py、add_session.py与.claude/hooks/*.py如 771 行的inject-subagent-context.py、408 行的inject-workflow-state.py、844 行的session-start.py中平台目录只是声明何时、以何种方式调用这些核心逻辑。同步约束修改某个平台目录时必须同时确认.trellis/workflow.md描述的工作流是否仍然一致——平台文件与.trellis/是同一套流程的两个视图只改其一必然产生漂移。模板哈希Template Hashes的工作原理.trellis/.template-hashes.json记录的是 Trellis 上一次写入某个模板文件时的内容哈希content hash。trellis update据此把每个被管理文件归入三种情况之一情况更新行为文件未被用户修改可以自动更新文件已被用户修改提示用户选择覆盖overwrite、保留keep或生成.new文件文件不再是当前模板依据迁移规则决定删除、重命名或保留仓库实证EcoPaste 仓库中的.trellis/.template-hashes.json结构如下顶层含__version: 2字段说明哈希文件格式本身有版本管理。hashes对象按相对路径记录每个 Trellis 管理文件的 SHA-256 内容哈希例如.agents/skills/trellis-meta/references/local-architecture/generated-files.md→1128d45b...e7de4e55.claude/settings.json→d13cd056...cced2855.claude/hooks/session-start.py→688e9d5c...dcb347995全文共 362 行覆盖.agents/skills/、.claude/agents、commands、hooks、settings、skills、.codex/、.cursor/、.kiro/、.github/、.opencode/、.gemini/等多套平台文件。这也印证了文档中的表述哈希覆盖的不只是.trellis/内部文件而是所有由 Trellis 模板生成的文件包括平台目录中的 hooks、agents、settings 等。trellis update通过比对当前文件内容与记录的哈希即可判断用户是否动过某个模板文件。对 AI 定制者的实际含义当 AI 定制本地 Trellis 文件时无需手工维护哈希——trellis update把定制结果识别为已被用户修改是正常现象。换句话说你改了workflow.md、config.yaml、spec/或平台目录文件后下次trellis update会提示文件已被用户修改并给你覆盖 / 保留 / 生成.new三条路你不需要也不应该去手动改动.template-hashes.json里的哈希值来假装没改过手工向.template-hashes.json写入业务规则是被明确禁止的该文件No级不可编辑。从.trellis/.gitignore可以看到*.new冲突解决临时文件与.backup-*更新备份目录都在忽略列表中这从侧面印证了生成.new文件与更新前备份是 update 流程的标准动作。本地定制边界Local Customization BoundariesTrellis 对什么可以改、什么不该碰给出了清晰的默认边界默认可编辑.trellis/workflow.md.trellis/config.yaml.trellis/spec/**.trellis/scripts/**平台 hooks、settings、agents、skills、commands、prompts 与 workflows默认不应编辑全局 npm 安装目录node_modules/mindfoldhq/trellisTrellis GitHub 仓库源码.trellis/.runtime/**下的具体状态文件.trellis/.template-hashes.json内的哈希内容只有在用户明确想向上游贡献修改 Trellis CLI 源码、发布 npm 包或提交 PR时才切换到 Trellis CLI 源码视角。边界背后的工程逻辑把这几条边界与仓库现状对照可以归纳出三条原则用户项目内可改、npm 缓存不可改Trellis 设计上默认定制目标是项目内生成的文件.trellis/、平台目录、.agents/skills/而不是node_modules或全局 npm 安装目录中的包源码。EcoPaste 仓库内存在独立的.trellis/scripts/与各平台 hooks 的本地 Python 实现正是本地运行时的体现。运行时状态自动生成、勿手改.runtime/下的会话级状态如当前任务指针.current-task由 hooks/scripts 自动写入task.py通过它们维持当前活动任务手动修改这些具体状态文件会破坏任务指针与会话身份的一致性。哈希文件是更新元数据、不是配置.template-hashes.json是 update/迁移逻辑的输入业务规则应放在config.yaml、spec/或本地技能中而不是塞进哈希文件。从.trellis/workflow.md的实践部分还能看到配套的定制入口首次使用需运行python3 ./.trellis/scripts/init_developer.py your-name创建本地开发者身份.developer与workspace/your-name/均已被.gitignore排除规约更新走get_context.py与task.py系列命令。这些都符合项目内可编辑、运行时自动维护、哈希不手写的边界划分。结语trellis init生成的文件不是一次性的脚手架垃圾而是 Trellis 工作流在项目内的完整落地形态.trellis/承载工作流、任务、规约、记忆与本地脚本平台目录负责把同一套流程接入.claude/、.codex/、.cursor/、.kiro/等不同 AI 工具.template-hashes.json则是trellis update判断用户是否改过模板的唯一依据。理解这些生成文件的职责与可编辑性分级是安全定制本地 Trellis 的前提——把规则写进workflow.md、config.yaml、spec/和平台文件把状态交给.runtime/与 hooks把哈希留给 update 逻辑你就能在享受trellis update持续更新的同时保住自己的本地定制成果。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐TRELLIS数据集构建TRELLIS-500K完整使用指南TRELLIS数据集构建TRELLIS 500K完整使用指南 TRELLIS 500K是一个包含50万高质量3D资产的大规模数据集专为3D生成任务而设计。该人工智能计算机视觉媒体生成预训练3D渲染TRELLIS项目教程TRELLIS项目教程 1. 项目的目录结构及介绍 TRELLIS项目是一个开源的3D资产生成模型其目录结构如下 TRELLIS/ ├── assets/人工智能计算机视觉媒体生成预训练3D渲染TRELLIS模型架构解析SLAT表示与Rectified Flow TransformersTRELLIS模型架构解析SLAT表示与Rectified Flow Transformers TRELLIS是一个突破性的大规模3D资产生成模型其核心创新人工智能计算机视觉媒体生成预训练3D渲染上一篇3 步用上免费专利APIpublic-apis 帮你建好查询系统下一篇为什么Fleek是开发者的终极环境管理神器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考