跳转到主要内容
v0.6.0 的首个 release candidate。功能面已冻结,v0.6.0 周期从 beta 转入稳定化阶段。tracker 上 open 的功能需求(#193#318#320#325#326 等)延期到 v0.7 及以后。仅 bug 修复会以后续的 0.6.0-rc.* 形式发布。 本 changelog 汇总 v0.6 线 23 个 beta release 的累计交付,外加 0.6.0-beta.230.6.0-rc.0 之间的唯一修复。

Enhancements

trellis mem —— 跨会话记忆底座

本地 CLI,索引机器上已有的 Claude Code / Codex 会话日志,通过 listsearchcontextextractprojects 五个子命令暴露。extract --phase brainstorm|implement|alltask.py create / task.py start 边界切分一次 session,AI 据此可恢复任意历史 task 的 brainstorm 段。可复用检索 / 阶段切片逻辑封装在 @mindfoldhq/trellis-core/mem;纯本地,不上传任何内容。 v0.6.0-beta.15 起逐步交付(核心 + CLI),适配器与阶段切片在 beta.18 完善。

trellis-session-insight bundled skill

教 AI 何时该伸手调 trellis mem(过往解法回忆、决策回溯、跨会话续作、似曾相识的 bug、自身模式识别、finish-work 回顾)的能力 skill,有意不固定一个写回的文件。mem 返回的内容怎么用,由 AI 根据当下对话情境自行判断。
  • 源:packages/cli/src/templates/common/bundled-skills/trellis-session-insight/
  • trellis inittrellis update 时自动落盘到每个支持的平台
v0.6.0-beta.23 交付。

Channel runtime —— 多 agent 协作

trellis channel 提供多 AI 进程协作的 worker-supervisor 原语:
  • channel create | send | wait | spawn | run | list | messages | kill | rm | prune 子命令
  • Claude stream-json 与 Codex app-server adapter,把平台输出翻译为 channel 的 message / progress / done / error 事件
  • Forum 与 thread 频道:--type forum|threads + channel context|title|thread rename
  • 跨 channel 命令的 --scope project|global 解析
  • 项目级 channel 日志存于 ~/.trellis/channels/<project>/<channel>/events.jsonl,sequence 用 lock 分配
  • 默认 OOM 守护:channel.worker_guard.idle_timeout(5m)+ channel.worker_guard.max_live_workers(6),可在 spawn 时单独调或写到 .trellis/config.yaml
  • 可复用 worker runtime API(在 @mindfoldhq/trellis-core/channel):readWorkerInbox()watchWorkerInbox()WorkerInboxError
  • sendMessage / postThread 接受 idempotencyKey,重试返回原始 JSONL 事件
v0.6.0-beta.10beta.19 逐步交付。

Channel runtime agent 定义在 init/update 时自动落盘

trellis inittrellis update 现在会落盘 .trellis/agents/{check,implement}.md——这就是 trellis channel spawn --agent <name> 在运行时加载的 bundled agent 定义。trellis workflow --template <id> 在解析出的 workflow 引用了磁盘上不存在的 .trellis/agents/<name>.md 时输出非阻塞 stderr 警告。检测逻辑在 packages/cli/src/utils/agent-refs.ts v0.6.0-beta.23 交付(关闭 #323)。

Registry-backed .trellis/spec 通过 trellis update 刷新

trellis init --template <id> 会把 spec 来源和 template id 持久化到 .trellis/config.yaml 的新 registry.spec 块。trellis update 会读这一块,把配置的 spec registry 下载到临时目录,再走 hash / conflict / “modified by you” 的现有流程。支持直接的 spec registry 和 marketplace 风格 registry,包含 SSH 与自建 Git 源。 v0.6.0-beta.23 交付(关闭 #315)。

Reasonix (DeepSeek-Reasonix) 平台支持

Reasonix 是第 15 个受支持的 AI 编码工具,通过 trellis init --reasonix 启用。子代理 skill(trellis-implementtrellis-check)使用 runAs: subagent frontmatter,Reasonix 会把它们当作隔离的子代理循环来跑。 v0.6.0-beta.23 交付(关闭 #301)。

Pi Agent —— 原生 trellis_subagent 扩展

Pi 扩展现在暴露 trellis_subagent,带原生进度卡、single / parallel / chain 三种 dispatch 模式、节流的实时刷新、Trellis-agent 校验。 v0.6.0-beta.19 交付(关闭 #286#290)。

@mindfoldhq/trellis-core SDK 包

新发布包 @mindfoldhq/trellis-core,把 CLI 背后可复用的 channel / task / mem 原语暴露给 Node 消费者。两个包共用同一 git tag、同一 npm dist-tag、同一版本号。 v0.6.0-beta.13 交付。

trellis upgrade 命令

封装 npm install -g @mindfoldhq/trellis@<channel>,带 channel 感知的默认行为(latestbetarc)、--tag--dry-run。替代以前 session-start 提示里那一长串 npm install -g … 字符串。 v0.6.0-beta.9 交付。

trellis-spec-bootstrap bundled skill

内置 bundled skill,帮 AI 用真实代码库内容引导 .trellis/spec/,附带 repository analysis、spec task planning、spec writing、MCP setup 四份带源代码引用的 references。每个支持的平台都会自动装上。 v0.6.0-beta.18 交付(历史 typo trellis-spec-bootstarpv0.6.0-beta.23 被改名;参见 #296)。

.trellis/config.yaml 驱动的可配置 hooks

项目级配置现在控制 hook 行为:
配置项控制
session_commit_message / max_journal_lines / session_auto_commitjournal 自动 commit 的形态
hooks.after_create / after_start / after_finish / after_archive每个 task 生命周期事件后跑的用户 shell 命令
channel.worker_guard.idle_timeout / max_live_workerschannel worker 的 OOM 保护
codex.dispatch_mode: inline | sub-agentCodex 主 agent 是直接编辑代码还是派发到 trellis-implement / trellis-check 子 agent

Bug Fixes

trellis-implement / trellis-check 在没装 Exa MCP 时不再 silent-skip

bundled 的 trellis-implementtrellis-check agent 定义里显式声明了 mcp__exa__web_search_examcp__exa__get_code_context_exa。Claude Code 的 tools: 解析器在显式 MCP 工具名解析不到时静默跳过整个 agent 注册——没装 Exa MCP server 的用户,所有 Trellis 子代理直接从 dispatch 列表里消失,主 agent 没的选只好自己上。 修复:
  • trellis-implementtrellis-check 去掉两个 mcp__exa__* 条目。这两个 agent 本来就不需要外部搜索;tools: 现在缩成 Read, Write, Edit, Bash, Glob, Grep
  • trellis-research 把原本的 mcp__exa__*mcp__chrome-devtools__* 合并成一个 mcp__* 通配符。Claude Code 对通配符是 lazy resolve(找不到匹配也不 silent-skip 整个 agent),所以这种方式让 research 启用用户任何已配置的 MCP,源模板不绑定具体 provider。
  • Copilot 转换器(packages/cli/src/configurators/shared.tsmapLegacyToolToCopilot)加了一条 mcp__* case,输出 Copilot 完整的 MCP 等价工具集。
OpenCode 的 agent 用的是另一套权限映射语法(mcp__exa__*: allow),不会 silent-skip 整个 agent,所以这次故意没动。 关闭 #302

Upgrade

npm install -g @mindfoldhq/trellis@rc
trellis update
如果你从 0.6.0-beta.22 或更老的版本上来,还要跑 trellis update --migraterename-dir migration 应用一下——它会跨 13 个平台 skill 根目录把已安装的 trellis-spec-bootstarp/ 目录重命名为 trellis-spec-bootstrap/ 这条线的下一个 release 将是 0.6.0-rc.1(只 bug fix),除非有 feature 回归把我们打回 beta。v0.6.0 GA 跟着 RC 的稳定度走。