PROJECT MEMORY · 项目知识

下一次开发，
从已有知识开始。

把架构约定、调研结论和开发记录留在项目里。
让编程 Agent 找到依据，接着往下做。

本地 Markdown · 按需检索 · 多 Agent 共享

使用示例

mini-trellis~/project

# 在 Agent 中记录一条已确认的决定
把回调幂等规则更新到已有规范，
使用 mini-trellis-remember 记录主题链接。

# 在新会话中查找来源
$ mini-trellis mem recall "回调 幂等"

[doc] .trellis/spec/backend/callbacks.md
每个回调携带幂等键…
ref: <ref-from-recall>

# 需要完整条件时展开原文
$ mini-trellis mem read "<ref-from-recall>"

依据当前约定修改代码，
验证结果后更新同一篇笔记。

.trellis/spec/backend/callbacks.md

回调幂等

每个回调携带幂等键。重复投递返回第一次的结果。

项目约定 · 随代码维护

01 / CONTINUITY

有用的结论，
留在项目中。

代码会变化，决定也会更新。把当前约定与当时的依据写清楚，后续开发就有资料可循。

01
保存
更新已有主题，用日志链接这次修改与验证。
02
查找
在文档和已支持的本地对话中检索，先读短摘录。
03
更新
沿用当前规则，结论变化时修改原文档。

02 / YOUR REPOSITORY

文档在原处，
知识在手边。

继续维护已有 README、docs 和项目规范。Markdown 可以编辑、审阅，也能通过 Git 分享给团队。

了解工作原理 →

~/your-project

├── README.md
├── docs/
└── .trellis/
    ├── spec/       项目约定
    ├── research/   调研与依据
    └── workspace/  开发日志

03 / GET STARTED

从一条值得留下的决定开始。

安装、记录，再到新会话里找回。

开始使用 →

npm install -g mini-trellis
mini-trellis init -u your-name --claude
mini-trellis doctor

Node.js ≥ 18.17 · Python ≥ 3.9 · Git

在你使用的 Agent 中继续

Claude Code
Codex
Cursor
OpenCode
Pi
OMP
Kiro
DeepSeek Harness
CodeBuddy
ZCode

查看平台能力与配置 →

从上手到日常维护

完整文档 →

开始使用

安装与第一次记录

整理历史

从聊天到项目文档

命令参考

参数、技能与配置

故障排查

从现象找到下一步

FAQ

你可能想知道

查看全部问题 →

已有 README 和 AGENTS.md，还能直接使用吗？

可以。已有文档继续在原处维护，mini-trellis 为这些资料提供检索入口，并帮助 Agent 更新主题和记录结论。

需要手动保存每次聊天吗？

保存后续还会用到的决定、调研和修复经验即可。选定历史对话可以用 session-insight 整理成项目文档。

支持哪些本地对话记录？

v0.3.8 读取 Claude Code、Codex、OpenCode V1 和 Pi 的原始历史。其他已接入 Agent 可以使用项目文档，或整理明确提供的文本导出。

从 Trellis 迁移时会保留什么？

迁移保留 spec、research 和 workspace，将旧任务材料整理到 research。执行前预览计划并备份自定义配置，具体文件处理见迁移指南。

实测与方法

查看指定版本下的任务耗时、处理 Token 与注入字符测量。

下一次开发，从已有知识开始。