> ## Documentation Index > Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt > Use this file to discover all available pages before exploring further. # v0.6.0-rc.0 > 2026-06-08 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.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///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 ` 在运行时加载的 bundled agent 定义。`trellis workflow --template ` 在解析出的 workflow 引用了磁盘上不存在的 `.trellis/agents/.md` 时输出非阻塞 stderr 警告。检测逻辑在 `packages/cli/src/utils/agent-refs.ts`。 在 `v0.6.0-beta.23` 交付（关闭 `#323`）。 ### Registry-backed `.trellis/spec` 通过 `trellis update` 刷新 `trellis init --template ` 会把 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 感知的默认行为（`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 等价工具集。 OpenCode 的 agent 用的是另一套权限映射语法（`mcp__exa__*: allow`），不会 silent-skip 整个 agent，所以这次故意没动。 关闭 `#302`。 ## Upgrade ```bash theme={null} npm install -g @mindfoldhq/trellis@rc trellis update ``` 如果你从 `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 的稳定度走。