问题描述：

基础信息

原 repo

github.com

GitHub - mindfold-ai/Trellis: All-in-one AI framework & toolkit

All-in-one AI framework & toolkit

文档站

Trellis Doc

Trellis - Trellis Doc

面向 Claude Code 和 Cursor 的一站式 AI 框架和工具集

v0.3.6 - 任务生命周期 hooks、自定义模板仓库、父子 subtask、修复 PreToolUse hook

新增功能：

• trellis init --registry 支持从自定义 GitHub/GitLab/Bitbucket 仓库拉取 Spec 模板，自动探测 marketplace 模式（index.json）和直接下载模式
• 任务生命周期 hooks：.trellis/config.yaml 新增 hooks 配置块，支持 after_create、after_start、after_finish、after_archive 四个事件，通过 TASK_JSON_PATH 环境变量传递任务信息，附带 Linear sync hook 示例
  参考：任务管理全流程 - Trellis Doc
• 父子 subtask 支持：task.py add-subtask / remove-subtask 命令，task.json 新增 children、parent、meta 字段，task.py create --parent 直接创建子任务
• /record-session prompt 改进：归档判断基于实际工作状态而非 task.json status 字段
• /brainstorm prompt 新增 subtask decomposition 步骤

Bug 修复：

• PreToolUse context injection 失效：Claude Code v2.1.63 将内部工具从 Task 改名为 Agent（anthropics/claude-code#29677），导致 hook 脚本 tool_name != "Task" 检查直接退出，implement/check/debug/research agent 的 code-spec context 注入全部失效。修复：兼容 Task 和 Agent 两种名称，settings.json 新增 "Agent" matcher

v0.3.5 - hotfix 修复 0.3.4 manifest 的 json 文件 key 不对的问题

v0.3.4 - Qoder 平台支持、Kilo workflows 迁移、record-session 任务感知

新增功能：

• 新增 Qoder 平台支持（skills-based），通过 --qoder 启用，模板路径 .qoder/skills/{name}/SKILL.md
• /record-session prompt 优化：执行前强制检查活跃任务，已完成的必须先归档再记录；get_context.py 新增 --mode record 输出精简上下文，MY ACTIVE TASKS 优先展示
• task.py archive 执行后自动提交，新增 --no-commit 参数可跳过

Bug 修复：

• Kilo 平台：commands/trellis/ 重命名为 workflows/，匹配 Kilo 官方规范
• iFlow：session-start hook 新增 IFLOW_NON_INTERACTIVE 环境变量检查，修复非交互模式下的一致性问题
• Multi-agent：清除继承的 CLAUDECODE 环境变量，修复 Claude Code v2.1.39+ 嵌套会话拦截导致子进程启动失败的问题
• trellis update 不再覆盖 workflow.md 和 workspace/index.md，这两个文件仅在 init 时创建

v0.3.3 - Init 下载体验优化、Update 跳过 spec、Windows 编码修复

新增功能：

• 自动检测 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY 环境变量，通过 undici ProxyAgent 为所有网络请求（包括 giget 模板下载）配置代理
• 模板索引获取 5 秒超时，带实时 Loading... 2s/5s 倒计时；模板下载 30 秒超时（Promise.race）
• trellis init 选择模板时展示正在请求的 GitHub 地址
• trellis update 不再修改 .trellis/spec/ 下的文件，用户自定义的 spec 内容受完整保护

Bug 修复：

• 在 common/__init__.py 中集中处理 stdio 编码，新增 sys.stdin 到 _configure_stream()，修复 Windows PowerShell 下通过 stdin 管道传入中文内容乱码的问题
• 删除 add_session.py 和 git_context.py 中重复的编码处理代码，统一由 common/__init__.py 管理
• 移除 8 个平台 record-session 模板中的 auto-commit 实现细节，防止 AI 误用 --no-commit 参数

v0.3.2 - Record Session 自动提交 & 项目级配置

新增功能：

• add_session.py 执行完毕后自动提交 .trellis/workspace 变更，解决 record-session 后工作目录残留 dirty 文件的问题
• 新增 .trellis/config.yaml 项目级配置文件，支持自定义 session_commit_message 和 max_journal_lines
• 新增 common/config.py 模块，读取 config.yaml 并提供硬编码默认值兜底
• add_session.py 新增 --no-commit 参数，可跳过自动提交

模板更新：

• 8 个平台的 record-session 模板同步更新，文档中补充 auto-commit 说明

v0.3.1 - SessionStart 重注入 & 模板精准感知

新增功能：

• SessionStart Hook 现在在 clear 和 compact 事件时也会触发（之前仅 startup），确保会话重置后上下文始终被重新注入（Claude + iFlow）

Bug 修复：

• 修复 iFlow command 模板写入路径缺少 trellis/ 子目录的问题（.iflow/commands/xxx.md → .iflow/commands/trellis/xxx.md）
• 修复 trellis update 会向纯前端/纯后端项目注入不存在的 spec 目录文件的问题（collectTemplateFiles 增加 fs.existsSync 检查）
• 修复 trellis init 不区分项目类型、始终创建全量 spec 目录的问题（createSpecTemplates 现按 projectType 条件创建）
• 清理死代码：移除 guidesCrossPlatformThinkingGuideContent 导出及 guides/index.md 中的失效链接

网友解答：

---

--【壹】--：

好耶好耶！

---

--【贰】--：

已经不是 rc 了呀，前几天就发0.3.0 的 release 了，现在直接 npm install -g @mindfoldhq/trellis@latest --registry=https://registry.npmjs.org 就行

---

--【叁】--：

想记住的事情是指什么？ 聊天习惯这种用户偏好，还是 coding spec 这种？前者建议放在 .trellis/workflow.md ，后者是应该放在 .trellis/specs/ 目录下面， /record-session 是类似工作日报的那种，每次只会加载前几条

---

--【肆】--：

任务归档能也变成slash命令的吗，和record类似那样，感觉更顺手一点

---

--【伍】--：

有 wx 群 Trellis/wx-group-qr.jpg at main · mindfold-ai/Trellis · GitHub

---

--【陆】--：

支持支持，一直在用

---

--【柒】--：

佬，我想让他记住的事情，用/record-session 记录了，但开了新回话它还是记不住，是啥原因呢？

---

--【捌】--：

有没有交流群啊佬

---

--【玖】--：

有方式将工作流安装到全局吗？不想在每个项目都 init

---

--【拾】--：

可以看看 /update-spec 这个slash command能不能解决你的问题

---

--【拾壹】--：

支持独创

---

--【拾贰】--：

国内镜像源可能会同步的比较慢，我们一般都是直接往 npm 官方发包的

---

--【拾叁】--：

比如一些特殊规范、逻辑，想也能自动记录，现在好像还是得手动维护

---

--【拾肆】--：

主要是每个项目的 slash command 大概率都会魔改，做一个全局的没法搞不同项目的差异化使用

---

--【拾伍】--：

哦哦，没加registry哈哈哈

---

--【拾陆】--：

预计这两天更新：

• trellis update 跳过 spec 目录
• trellis init 下载模板的时候优化显示
• trae,qoder 支持

---

--【拾柒】--：

前排支持

---

--【拾捌】--：

太强了，大佬

---

--【拾玖】--：

还没更新到npm嘛？还是在rc版本