> ## 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.5.15

> 2026-05-13

## 修复

### Template manifest ownership

`trellis init`、`trellis update` 和 `trellis uninstall` 不再把用户自有的平台运行时文件当作 Trellis 模板。

* `initializeHashes()` 从 `startRecordingWrites()` 输出中跟踪 platform/root 文件，不再扫描 `.codex/`、`.claude/` 和其他平台目录。
* `pruneOrphanManifestKeys()` 在 `update` 和 `uninstall` 规划前，从 `.trellis/.template-hashes.json` 移除 stale orphan entries。
* `trellis init` 和 `trellis uninstall` 拒绝在 `$HOME` 运行，除非设置 `TRELLIS_ALLOW_HOMEDIR=1`。

### Windows hook encoding

Hook templates 在 Windows 上强制 stdin、stdout 和 stderr 使用 UTF-8。

* `hooks.json` 用 `python -X utf8` 运行 Codex `inject-workflow-state.py`。
* `shared-hooks/inject-workflow-state.py`、`shared-hooks/session-start.py`、`codex/hooks/session-start.py` 和 `copilot/hooks/session-start.py` 将 streams 重新配置为 UTF-8，并用 replacement errors 处理异常字符。

## 升级方式

```bash theme={null}
npm install -g @mindfoldhq/trellis@latest
trellis update
```