#193、#318、#320、#325、#326 等)延期到 v0.7 及以后。仅 bug 修复会以后续的 0.6.0-rc.* 形式发布。
本 changelog 汇总 v0.6 线 23 个 beta release 的累计交付,外加 0.6.0-beta.23 到 0.6.0-rc.0 之间的唯一修复。
Enhancements
trellis mem —— 跨会话记忆底座
本地 CLI,索引机器上已有的 Claude Code / Codex 会话日志,通过 list、search、context、extract、projects 五个子命令暴露。extract --phase brainstorm|implement|all 按 task.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 init和trellis 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.10 到 beta.19 逐步交付。
Channel runtime agent 定义在 init/update 时自动落盘
trellis init 和 trellis 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-implement、trellis-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 感知的默认行为(latest、beta、rc)、--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-bootstarp 在 v0.6.0-beta.23 被改名;参见 #296)。
.trellis/config.yaml 驱动的可配置 hooks
项目级配置现在控制 hook 行为:
| 配置项 | 控制 |
|---|---|
session_commit_message / max_journal_lines / session_auto_commit | journal 自动 commit 的形态 |
hooks.after_create / after_start / after_finish / after_archive | 每个 task 生命周期事件后跑的用户 shell 命令 |
channel.worker_guard.idle_timeout / max_live_workers | channel worker 的 OOM 保护 |
codex.dispatch_mode: inline | sub-agent | Codex 主 agent 是直接编辑代码还是派发到 trellis-implement / trellis-check 子 agent |
Bug Fixes
trellis-implement / trellis-check 在没装 Exa MCP 时不再 silent-skip
bundled 的 trellis-implement 和 trellis-check agent 定义里显式声明了 mcp__exa__web_search_exa 和 mcp__exa__get_code_context_exa。Claude Code 的 tools: 解析器在显式 MCP 工具名解析不到时静默跳过整个 agent 注册——没装 Exa MCP server 的用户,所有 Trellis 子代理直接从 dispatch 列表里消失,主 agent 没的选只好自己上。
修复:
trellis-implement和trellis-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.ts的mapLegacyToolToCopilot)加了一条mcp__*case,输出 Copilot 完整的 MCP 等价工具集。
mcp__exa__*: allow),不会 silent-skip 整个 agent,所以这次故意没动。
关闭 #302。
Upgrade
0.6.0-beta.22 或更老的版本上来,还要跑 trellis update --migrate 把 rename-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 的稳定度走。