跳转到主要内容
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 乱码也请更新