桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载Trellis 通过trellis init会在项目内生成.trellis/与各类平台目录.claude/、.cursor/、.codex/等本文基于仓库内.cursor/skills/trellis-meta/references/customize-local/overview.md展开为在 EcoPaste 这类用户项目中工作的 AI或开发者提供一份该改哪个文件、按什么顺序改、哪些绝对不要碰的本地定制全景指南。读完本文你将掌握按用户诉求快速定位定制入口的方法、一套安全的本地操作流程以及判断何时需要回退到 Trellis 上游源码改动的边界。先明确本地定制的适用范围overview.md 的开篇就划定了本目录的适用前提Trellis 已通过 npm 安装且项目内已执行过trellis init。在这种场景下本地 AI 应修改项目内生成的.trellis/与各平台目录而不是去改 Trellis CLI 的上游源码。从 SKILL.md 可以确认默认操作范围是用户项目内的本地文件具体包括.trellis/workflow、config、tasks、spec、workspace、scripts、bundled runtime agents 与运行时状态平台目录.claude/、.codex/、.cursor/、.opencode/、.kiro/、.gemini/、.qoder/、.codebuddy/、.github/、.factory/、.pi/、.reasonix/、.kilocode/、.agent/、.devin/等共享技能层.agents/skills/项目树之外的用户级 channel 存储~/.trellis/channels/project/channel/events.jsonl可通过trellis mem查询的原始平台会话日志~/.claude/projects/、~/.codex/sessions/、~/.pi/agent/sessions/。一句话概括凡是trellis init生成在项目里的文件都是本地定制的合法目标凡是node_modules或全局 npm 安装目录里的东西都不应该作为本地定制的默认目标。第一步判断用户到底想改什么overview.md 给出的核心方法论是动手之前先根据用户的措辞决定优先阅读哪一份定制文档。这张决策表是整个定制体系的入口用户措辞User wording优先阅读Change the Trellis flow / phases / next prompt改流程/阶段/下一步提示change-workflow.mdChange task creation, status, archive, or hooks改任务创建/状态/归档/钩子change-task-lifecycle.mdAI did not read context / change injected contentAI 没读上下文/改注入内容change-context-loading.mdA platform hook is not behaving as expected平台钩子行为异常change-hooks.mdChange implement/check/research agent behavior改执行/检查/研究 Agent 行为change-agents.mdAdd a skill/command/workflow/prompt新增技能/命令/流程/提示词change-skills-or-commands.mdAdjust the project spec structure调整项目 spec 结构change-spec-structure.mdAdd team conventions and local notes添加团队约定与本地笔记add-project-local-conventions.md这八份文档共同构成了 overview.md 所说的定制主题库。例如用户说Trellis 的 flow / phases 不对→ 入口是.trellis/workflow.md具体改动点包括Phase Index、[workflow-state:STATUS]状态块和Skill Routing表见 change-workflow.md用户说AI 没读 specs / 任务上下文丢了→ 入口是.trellis/scripts/get_context.py、session_context.py、task_context.py与active_task.py见 change-context-loading.md用户说某个平台钩子行为不对→ 入口是平台 settings/config 与 hooks 目录见 change-hooks.md。通用操作顺序先确认、再读取、后窄改、最后同步overview.md 规定了一套五步通用操作顺序适用于所有本地定制请求确认平台与目录先检查项目里实际存在哪些平台目录如.claude/、.codex/、.cursor/、.zcode/只改真实存在的平台。确认当前激活任务运行python3 ./.trellis/scripts/task.py current --source确认当前任务是什么、从哪个来源激活的。读取本地事实源优先读.trellis/workflow.md、.trellis/config.yaml以及相关平台文件而不是凭记忆或旧会话规则行事。窄幅修改只编辑与用户请求直接相关的文件不顺手重构无关内容。同步语义这是最容易被忽略的一步——如果共享流程.trellis/workflow.md变了要检查平台入口文件是否需要同步修改如果平台入口变了要检查.trellis/workflow.md是否仍然与之保持一致。以任务生命周期定制为例change-task-lifecycle.md 明确要求的读取顺序先读.trellis/workflow.md、.trellis/config.yaml、.trellis/scripts/task.py、.trellis/scripts/common/task_store.py、.trellis/scripts/common/task_utils.py再读当前任务的.trellis/tasks/task/task.json。配置类需求优先改.trellis/config.yaml脚本行为需求再改.trellis/scripts/AI 流程变了再同步.trellis/workflow.md。本地文件优先级从 workflow 到 platform 的分层视图overview.md 给出了一张本地文件优先级表这是定位改动点时最重要的分层视图层Layer文件Files工作流.trellis/workflow.md项目配置.trellis/config.yaml任务材料.trellis/tasks/task/项目规格.trellis/spec/运行时脚本.trellis/scripts/平台集成.claude/、.codex/、.cursor/、.opencode/、.zcode/等目录共享技能.agents/skills/各层职责在 SKILL.md 的 Current Rules 中有更细的落地说明.trellis/workflow.md是本地工作流的事实源。它的初始内容在trellis init时从内置模板native、tdd、channel-driven-subagent-dispatch或 marketplace 模板中选取之后可用trellis workflow --template id重新选择。若激活模板引用的.trellis/agents/name.md缺失CLI 会输出指向trellis update的非阻塞 stderr 警告。.trellis/config.yaml是项目级配置入口承载任务生命周期钩子hooks.after_create/after_start/after_finish/after_archive、日志形态session_commit_message/max_journal_lines/session_auto_commit、channel worker 守护channel.worker_guard.idle_timeout/max_live_workers、Codex 分发模式codex.dispatch_mode: inline | sub-agent以及 spec registry 块registry.spec.sourceregistry.spec.template。.trellis/spec/存项目专属编码约定与设计约束可由trellis update按registry.spec刷新本地修改会在.trellis/.template-hashes.json中标记为 modified by user 冲突。.trellis/tasks/存任务 PRD、设计笔记、实施计划、研究文件与 JSONL 上下文任务形成父子树结构可通过task.py create --parent slug、add-subtask、remove-subtask、list-context管理。.trellis/workspace/只存刻意书写的开发者日志原始跨会话对话不在这里而是通过trellis mem search|extract|context从磁盘上的原始日志恢复。.trellis/agents/{check,implement}.md是平台无关的 channel 运行时 Agent 定义由trellis channel spawn --agent name加载可编辑注意修改各平台的trellis-implement.md/trellis-check.md并不会改变 channel 运行时 worker 的行为。~/.trellis/channels/project/channel/events.jsonl是每项目每 channel 的运行时事件日志文件锁分配序号、支持持久化idempotencyKey永不落入.trellis/内。默认不要做的事Things Not To Do By Defaultoverview.md 明确列出了本地定制的五条禁区违规操作往往会导致更新被覆盖或改动不生效不编辑全局 npm 安装目录不编辑node_modules/mindfoldhq/trellis同样应避开mindfoldhq/trellis-core两个包同版本发布不假设用户持有 Trellis 的 GitHub 仓库——本地定制不需要上游源码不用默认模板覆盖用户已修改的本地文件——先检查.trellis/.template-hashes.json优先使用.newsidecar 文件而非破坏性覆盖不把团队项目规则放进公开的trellis-meta——项目规则应放在.trellis/spec/或本地技能中因为trellis update会覆盖 bundled skill 目录里的任何内容。这条规则在技能层面有直接对应SKILL.md 的 Do Not 部分进一步补充——不要手工编辑~/.trellis/channels/project/channel/events.jsonl序号在文件锁下分配回放安全写入必须走trellis channelCLI 或mindfoldhq/trellis-core/channelSDK当目标是改变 channel 运行时 worker 行为时不要编辑.claude/agents/trellis-implement.md等各平台子 Agent 文件而要改.trellis/agents/name.md。何时才需要切换到上游源码视角overview.md 指出只有用户明确表达以下四种目标之一时才切换到 Trellis 上游源码视角I want to open a PR to Trellis想向 Trellis 提交 PRI want to change npm package publish contents想改变 npm 包发布内容I want to fork Trellis想 fork TrellisI want to modify the generation logic fortrellis init/update想修改trellis init/update的生成逻辑。除此之外默认都在用户项目内的本地 Trellis 文件中修改。例如想给 Trellis 上游贡献 bundled skill 改动应编辑 CLI 仓库中的packages/cli/src/templates/common/bundled-skills/name/而不是改部署副本见 change-skills-or-commands.md 的 Which Entry Type To Choose 表。实战组合一次完整定制请求的拆解示例把上面的方法论串起来可以模拟一个典型请求的处理路径例如AI 在实施阶段没有读安全 spec措辞归类属于 AI did not read context → 读 change-context-loading.md确认任务python3 ./.trellis/scripts/task.py current --source确认 JSONL 正确python3 ./.trellis/scripts/task.py list-context task与task.py validate task确认任务与 JSONL 无误后再动 hooks/agents判断平台模式若平台是 hook push则编辑inject-subagent-context钩子若是 agent pull则编辑trellis-implement/trellis-check的读取步骤检查 JSONL 内容implement.jsonl/check.jsonl中只应包含 spec/research 文件如{file: .trellis/spec/backend/index.md, reason: Backend conventions}不应放入将被修改的代码文件同步流程若改动影响流程语义回到.trellis/workflow.md检查一致性。这条链路正是 overview.md 决策表 通用操作顺序 文件优先级三者的实际合体也体现了钩子负责注册、脚本负责行为settings 与 hook 必须一起检查的要点change-hooks.md。结语本地定制的三条底线综合 overview.md 与其子文档本地定制始终要守住三条底线改动范围最小化只动与请求相关的.trellis/或平台文件流程语义变化务必同步到.trellis/workflow.md上游/本地界限分明node_modules与全局安装目录不是定制目标只有明确的 PR / 发布 / fork / 生成逻辑诉求才切换到上游源码视角冲突意识改 bundled skill 或模板派生文件前先看.trellis/.template-hashes.json项目私有约定一律落到.trellis/spec/或项目本地技能否则下一次trellis update会把改动冲掉。以此为纲无论是改 workflow、任务生命周期、上下文注入、钩子、Agent还是新增技能/命令/spec都能在 overview.md 这张定制地图上快速找到正确的落笔位置。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐gogcli gog sheets freeze 命令详解在终端中冻结 Google Sheets 行与列gogcli gog sheets freeze 命令详解在终端中冻结 Google Sheets 行与列 本指南以 gogcli 仓库中 gog sheet桌面应用EcoPaste 项目中的 Trellis 本地架构实战指南从 trellis-meta 技能理解工作流、多 Agent 通道与定制入口EcoPaste 项目中的 Trellis 本地架构实战指南从 trellis meta 技能理解工作流、多 Agent 通道与定制入口 本指南以 EcoPa桌面应用深入解析 Trellis 本地架构项目内三层系统模型与 AI 定制入口EcoPaste 实战视角深入解析 Trellis 本地架构项目内三层系统模型与 AI 定制入口EcoPaste 实战视角 导读 Trellis 是一套运行在用户项目内部的 AI桌面应用上一篇英雄联盟本地自动化工具 League Akari 完整上手指南免费开源、数据全在本地的 LCU API 客户端下一篇Bebas Neue 字体快速上手指南3 步安装、5 个技巧免费商用不纠结创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考