mini-trellis v0.3.8 — Kiro、Pi / OMP 与升级自动刷新

2026-11-11。

本版新增 Kiro 与 OMP 项目知识接入，修复 Pi 记录命令的参数传递，并把当前项目刷新纳入日常升级。

Pi / OMP

mini-trellis init -u your-name --pi -y
# 使用 OMP 时选择：
mini-trellis init -u your-name --omp -y

在项目根目录启动 pi 或 omp，用 /mini-trellis-remember <确认结论> 记录，下一次会话通过 mini-trellis mem recall <query> 召回。Pi 提示模板现在显式传递附加参数；OMP 使用原生 .omp 扩展、提示和技能目录，复用同一份启动入口。

已有项目用 refresh --pi 更新 Pi 提示，或用 refresh --omp 添加 OMP。安装或刷新后新开宿主会话。Pi 可检索本地原始会话；OMP 使用已保存的项目 Markdown，整理对话可提供 Markdown/text 导出。中文步骤 / English setup。

Kiro

mini-trellis init -u your-name --kiro -y
kiro-cli chat --v3

适用于 Kiro CLI V3 和 IDE 1.x。打开项目后按宿主提示信任工作区，新会话通过 SessionStart 加载简短项目入口。.kiro/skills/ 提供 remember、session-insight、update-spec 三项技能，复用项目中的 spec、research 与 journal。

用 /mini-trellis-remember 保存已确认结论，更新同一主题并记录 journal 引用；后续通过 mini-trellis mem recall <关键词> 读取。历史整理可直接提供 Markdown/文本材料。compact 后按 AGENTS.md 指引读取已保存知识。

refresh --kiro、doctor、migrate 和 uninstall 同步支持 Kiro。配置步骤见中文使用说明 / English setup。

升级自动刷新

从 0.3.8 开始，在已初始化的项目根目录运行：

mini-trellis upgrade

npm 安装成功后，命令启动新版 CLI 刷新当前项目的技能、Hook 和脚本。常规受管更新直接完成。遇到需要确认覆盖的文件时，刷新会列出文件并统一询问 [y/N]；输入 Y 覆盖列出的文件并完成更新，输入 N 或直接回车保留项目原样。项目知识保留，共享 JSON 配置继续合并。未初始化的目录只升级 CLI，其他项目按需运行 mini-trellis refresh。upgrade --dry-run 预览这两步。

从 0.3.7 或更早版本首次升级时，旧命令仍按原有方式工作，需要再刷新一次：

npm install -g mini-trellis@0.3.8
mini-trellis refresh --dry-run
mini-trellis refresh

以后由 0.3.8 及后续版本执行 upgrade 即可自动完成当前项目刷新。通过 npm 直接更新 CLI 时，仍使用 refresh 同步项目文件。

刷新确认与 Codex 清单修复

手动 refresh 与 upgrade 自动刷新共用同一个确认入口。清单缺失或损坏的已有项目，也可在确认覆盖后重新生成清单。--dry-run 预览更新；--json 和非交互运行在需要确认覆盖时报告相关文件并返回退出码 1，在终端执行 mini-trellis refresh 即可继续确认并完成更新。

修复指定 Python 命令初始化时，Codex Hook 落盘内容与清单模板不一致的问题；清单现在记录实际渲染后的模板，后续正常更新可以直接完成。