记忆

海慧智擎不是"开一次记一次、关掉就忘"的工具。它有记忆：你的偏好、团队的口径、项目的背景，写一次就长期生效，下次开会话不用再交代一遍。

记忆分两层，作用范围不同：

层级	文件	作用范围	适合放什么
个人偏好	~/.hi/HI.md	你这台机器上的所有项目	称呼、输出语言、汇报风格、常用格式
项目规则	项目根目录 ./HI.md	当前这个目录/项目	红线标准、文档模板、命名规范、目录约定

此外还有一层自动记忆（~/.hi）：海慧智擎在干活过程中自己沉淀的要点，跨会话留存，无需你手写。下面分别说。

个人偏好：~/.hi/HI.md

这里写的东西，对你机器上每一个项目都生效。最适合放"我希望它一直这样做"的事：

# 我的偏好

- 称呼我"李工"。
- 所有文档、表格、汇报一律用中文。
- 写台账默认按部门分页，金额列右对齐、保留两位小数。
- 给我结论时先说判断，再列依据，不要长篇铺垫。
- 涉及对外合同的修订稿，改动处都要标注原文出处。

写完保存即生效，下次启动会话它就照这个来——不用每次重新交代。

项目规则：./HI.md

在某个项目目录下放一个 HI.md，里面的规则只在这个项目里生效。这是把"团队统一口径"固化下来的地方：合同审查的红线标准、文档模板、目录结构约定，写进去之后，所有在这个目录里干活的人（和它）都遵同一套。

# 项目：华东区分包合同审查

## 审查红线（逐条核验，命中即标风险）
- 付款节点不得早于验收节点。
- 质保金比例不得低于合同额 5%。
- 违约金条款双向对等，缺一方即标注。

## 输出规范
- 风险一律标注到原文条款号。
- 出修订稿时保留原文，改动用批注说明理由。

项目规则建议入库

./HI.md 是给团队共享的，建议跟项目代码/文档一起提交（git checked in），这样组里每个人拿到的都是同一套标准。

如果某些规则只想自己本地用、不想共享，写进 ./HI.local.md——它默认不入库（gitignored）。

用 @ 引用其它文件

HI.md 里可以用 @ 把别的文件"包含"进来，便于把长规则拆成几份分别维护：

# 项目规则

@./standards/合同红线.md
@./standards/文档模板说明.md

支持 @./相对路径、@~/家目录路径、@/绝对路径。被引用的文件会一并作为记忆加载，文件不存在则静默忽略。

自动记忆（~/.hi）

除了你手写的两份 HI.md，海慧智擎在干活过程中还会自己沉淀要点到 ~/.hi 下的自动记忆里，跨会话留存。比如它发现"这个项目的报销台账要按区域而不是按部门汇总"，会记下来，下次省得你再说。

这部分不用你手动维护。想查看或清理，用下面的 /memory。

/memory 命令

在会话里输入 /memory，有两种用法：

1. 直接敲 /memory（不带参数） —— 打开记忆文件编辑器，列出可编辑的记忆文件让你挑：

• User memory —— 你的个人偏好 ~/.hi/HI.md
• Project memory —— 当前项目 ./HI.md
• @-imported —— 被 @ 引用进来的文件
• Open auto-memory folder —— 打开自动记忆所在目录

选中后用你的默认编辑器打开（由 $EDITOR / $VISUAL 环境变量决定）。

2. /memory <子命令>（带参数） —— 管理自动记忆条目，按"作用范围（scope）"组织：

命令	作用
/memory list	列出全部记忆（可加 --scope=X 只看某一范围）
/memory show <名称>	打印某条记忆的内容
/memory forget <名称>	删除某条记忆
/memory clear --scope=X	清空某个范围下的全部记忆
/memory promote <名称> --to <范围>	把一条记忆提升到更大的范围

可选的范围（scope）：project（当前项目）、session（仅当前会话）、subdir（子目录/子包）、user（跨项目全局）、runtime（仅本次运行、不落盘）。

clear 必须指定范围

/memory clear 不带 --scope 会被拒绝执行——这是防止一不小心清空所有记忆。删之前想清楚要清哪个范围。

例如：把本次会话里临时记下的一条"今年质保金统一按 5% 核"，提升为整个项目长期生效：

/memory promote 质保金比例 --to project

什么会被记住、什么不会

会被记住	不会被记住
~/.hi/HI.md 里写的个人偏好	普通对话内容（除非它判断值得沉淀进自动记忆，或你写进 HI.md）
./HI.md / ./HI.local.md 里的项目规则	你用 /clear 清掉的会话历史
@ 引用进来的文件内容	API Key、模型等配置（在 settings.json，不是记忆）
它自己沉淀到 ~/.hi 的自动记忆要点	runtime 范围的临时记忆（会话结束即丢弃）

想让它"记住偏好"，最稳的办法是写进 HI.md

对话里随口说"以后都用中文"，它当下会照做，但换个会话不一定还记得。真正想长期生效的偏好，写进 ~/.hi/HI.md（个人）或 ./HI.md（团队）——这是确定无疑会被加载的地方。

记忆 vs. 配置，别搞混

• 记忆（HI.md）= 告诉它"该怎么干活"的规则和偏好，是给它读的指令。
• 配置（~/.hi/settings.json）= API Key 和模型两项，是程序运行参数。改 API Key 请用 /setup，详见配置文件在哪。

相关

• 不想让长对话拖慢请求？用 /clear / /compact，见常见问题。
• 想把贵司业务知识沉淀成可复用能力（而不只是规则文本）？用 skill-creator 自建技能，见快速上手的扩展部分。