学习模式

Seed 的学习模式不是训练模型，也不是上传项目数据。它指的是：把项目里反复出现的术语、偏好、规则、踩坑经验和本机差异放到正确文件里，让下一次 AI 会话可以直接读取。

以博客搜索为例：第一次你可能要解释“博客模块在哪里”“搜索只做标题和摘要”“不要碰后端”。如果这些规则会反复出现，就不应该每次重讲。

三层沉淀

层级	放什么	推荐位置
项目共享记忆	术语、固定流程、项目偏好、可复用经验。	docs/ai-instructions/
任务恢复状态	当前任务做到哪一步、跑过哪些检查、下一步是什么。	Task Pack 的 SESSION_STATE.md
本机差异	本机端口、工具路径、浏览器 profile、临时代理。	.local/

共享记忆可以提交；本机差异默认不提交真实内容，只提交 README 或 example。

博客搜索里的项目记忆

当规则会影响后续任务边界，就值得沉淀。

#项目记忆：本项目里“博客搜索”默认只匹配文章标题和摘要；如果要搜索正文、标签、作者或权限过滤，必须先升级为 Task Pack 并补验收标准。

适合写入项目共享记忆的内容：

• “博客模块”对应哪些页面、API、文档和测试。
• 搜索功能默认的匹配字段。
• 什么时候只做前端过滤，什么时候必须加后端搜索。
• 收口里必须说明分页、权限和大数据量风险。

不适合写入项目共享记忆的内容：

• 你的本机端口。
• 你的浏览器 profile。
• 临时代理、临时下载路径或个人账号。

本机记忆

如果博客搜索需要本机调试入口，只写入 .local/：

#本机记忆：这台电脑调试博客前端时使用 127.0.0.1:5173，只写入 .local，不提交真实路径。

共享文档可以写“本机调试入口见 .local/ 说明”，不要写真实本机路径、账号或临时链接。

任务状态

复杂博客搜索任务使用 Task Pack，并维护 SESSION_STATE.md：

# SESSION_STATE

status: in_progress
current_task: 02-implement-search-ui
next_task: 03-run-checks
resume_from: search_ui_done

done:
  - 01-audit-current-blog-list

changed_files:
  - code/client/src/pages/blog/index.tsx
  - docs/modules/blog/module.md

commands_run:
  - git diff --check

risks:
  - 当前只做前端过滤，未覆盖后端分页。

状态文件的目的不是写日报，而是让下一次会话能继续。

经验沉淀

如果 AI 先跑错命令，后来找到正确命令，可以让它记录：

#项目记忆：本项目验证博客搜索应先运行 npm run test:plan，再运行前端实际测试入口；没有测试入口时必须在收口说明 not_configured。

经验要短、可复用、可检索。不要把整段聊天贴进文档。

常见错误

错误	修正方式
把所有聊天都粘进文档	只提炼稳定规则、术语和经验。
把本机路径写进共享文档	写入 .local/，共享文档只写占位或规则。
每次都重新解释博客边界	用 #项目记忆 沉淀默认匹配字段和升级条件。
任务中断后靠人回忆	用 Task Pack 和 SESSION_STATE.md 保存恢复点。

下一步

阅读 内置指令，用短语调用任务包、模块地图、项目记忆和收口流程。