> ## 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.4.0-rc.0

> 2026-04-14

**v0.4.0 进入功能冻结。** 首个 RC 版本。除 bug 修复外不再引入新功能。请测试并反馈任何回归问题。

## SessionStart 上下文大小修复 (#154)

Vanilla 项目的 `additionalContext` 从 **\~29 KB 降到 \~7 KB**，稳定在 Claude Code 的 \~20 KB 截断阈值以下。此前大多数非 trivial 项目的任务状态（ACTIVE TASKS、CURRENT TASK）会被静默丢失。感谢 @21nak 提供详尽的定位数据和两个 PR。

* **#161 workflow\.md 章节索引**：将 `workflow.md` 全文注入（\~12 KB）替换为紧凑的 `##` 标题索引。5 平台（含 copilot）全部覆盖。AI 按需读取完整文件。
* **#160 移除 start.md 注入**：`<instructions>` 块之前预注入了 `start.md`（\~11 KB），但 slash command 本身就是按需展开的——重复工作。4 平台移除（copilot 原本就没注入）。
* **后续清理**：`<ready>` 文案不再引用 `<instructions>` 移除后不存在的 "Steps 1-3 / Step 4"。顺手清掉了 `claude_dir` / `codex_dir` / `iflow_dir` 三个失去使用者的 orphan 变量。

## OpenCode 插件 v1 重构 (#159)

OpenCode 模板升级到 v1 plugin API（`export default { id, server }`）。修复了上下文注入不持久化的问题：`experimental.chat.messages.transform` 不会写回历史，导致重开 session 时注入的 Trellis 上下文丢失。现在走 `chat.message` hook 并通过 SDK 历史读取 + `metadata.trellis.sessionStart` 标记做去重。`task` 工具的 prompt 改为原地修改（`args.prompt = ...`），因为 runtime 持有的是 args 对象的本地引用。感谢 @Adamcf123。

## Windows 编码修复 (#163)

`statusline.py` 在 Windows 下渲染信息行的 `·` 分隔符时会触发 `UnicodeEncodeError: 'gbk' codec can't encode`。live hook 和 claude 模板现在都会在 Windows 上把 `stdout`/`stderr` 包装成 UTF-8。感谢 @xiangagou163。

## 功能

* **`feat(init)`：re-init 快速路径 (#157)** — 当 `.trellis/` 已存在时，`trellis init` 提供精简流程而非完整交互式初始化：
  * `trellis init --codex` → 仅配置 Codex，跳过其他步骤
  * `trellis init -u name` → 设置开发者身份（新设备同步）
  * `trellis init`（无参）→ 菜单：添加平台 / 添加开发者 / 完整重新初始化
  * `--force` / `--skip-existing` → 跳过快速路径，执行完整初始化

## 修复

* **`fix(init)`：re-init 时跳过 bootstrap 任务创建** — 重新运行 `trellis init` 不再创建重复的 bootstrap 任务

## 文档

* **`docs(spec)`：SessionStart 大小约束** — platform-integration spec 现在记录了 \~20 KB `additionalContext` 截断阈值和 size budget 表，防止后续 hooks 静默超限

## 说明

* RC 安装：`npm install -g @mindfoldhq/trellis@rc`
* 请在已有项目上运行 `trellis update` 并反馈任何回归问题
* session-start hooks 结构有较大调整——如果你本地做过定制，更新后需要重新核对
* Windows 用户如遇 statusline 乱码也请更新