<!-- Last updated: 2026-09-07 | Commit: 891678d -->
# 项目约束

本项目所有工作必须严格遵守 `项目背景.md` 中定义的全部规范，包括：

- 项目结构规范（三端目录划分、模块分目录）
- HTML 原型编写规范（独立文件粒度、自包含、视觉尺寸、设计令牌）
- 交互效果规范（导航跳转、Tab切换、交互注释标注）
- 命名规范（小写短横线文件名、BEM 类名）
- 墨刀导入兼容约束（禁止外部引用、简洁DOM、内联SVG）
- 模块文档规范（CHANGELOG、PRD、截图，详见 `项目背景.md` 第七部分）

每次生成或修改 HTML 原型文件前，必须先确认符合上述约束。

# Agent 行为约束（补充项目背景.md 中未涉及的 Agent 专属规则）

## PRD 文档更新时机

- **禁止自动更新**：修改原型页面时不得自动同步更新 PRD 文档
- **仅在用户明确要求时**才编写、更新 PRD 或重新截取页面截图
- PRD 的具体编写规范和截图规范见 `项目背景.md` 第 7.3 和 7.4 节

## CHANGELOG 更新时机

- 每次提交代码前，自动整理本次变更内容并追加到对应模块的 `doc/CHANGELOG.md` 中
- 格式规范见 `项目背景.md` 第 7.2 节

## 导航页同步

- 新增原型页面时，必须同步在 `index.html` 的 `SITE_MAP` 中添加对应条目
- PRD 文档生成后需要在导航页对应的一级菜单卡片左下角加上 PRD 文档的跳转逻辑

## 文件写入安全（严重事故教训 2026-05-15）

> **绝对禁止**：批量操作时覆盖已完成的文件修改。

- 对文件执行写入/编辑前，**必须先读取该文件当前最新内容**，禁止使用内存中缓存的旧版本写入
- 批量处理多文件时，每个文件独立「读取→修改→写入」，不得跨文件复用旧内容
- 同一会话中若一个文件被多次修改，后续修改必须基于前次修改后的最新状态
- **提交前必须执行 `git diff --staged` 审查**，确认所有变更符合预期、无意外回退
- 若发现 diff 中出现非预期的删除或回退，必须立即中止提交并向用户报告

## 记忆体系（会话启动必读）

> **强制规则**：每次新会话启动时，必须先读取本项目的记忆体系索引，再按需加载关键记忆文件，然后才能开始处理用户请求。长会话中若上下文被压缩，同样需要重新加载。

### 读取流程

1. **读取索引**：`cat .claude/memory/MEMORY.md` — 获取记忆文件清单与最近更新状态
2. **必读文件**（每次会话必须加载）：
   - `decisions.md` — 关键决策与架构约定，避免重复讨论已决事项
   - `feedback.md` — 协作规范与用户纠正，避免重犯已纠正的错误
   - `project_progress.md` — 当前阶段进度与待办，避免重复已完成工作
   - `project_overview.md` — 项目技术栈与三端架构，避免对项目结构产生误解
3. **按需加载**（与当前任务相关时加载）：
   - `user_profile.md` — 用户角色与偏好（需要个性化回复时）
   - `feedback_medical_pad_migration.md` — 医疗点PAD端原型规范：无前缀英文名、无模块导航页、简单弹窗页内实现、1280×800 外壳（涉及 medical-pad 页面时）
   - `feedback_shell_sidebar_scope.md` — Web 管理端壳层规范：顶栏=一级分组、侧栏仅当前分组二级菜单、页头不放面包屑（涉及管理端新模块壳层时）
   - `lint_report.md` — 记忆健康检查报告（发现记忆体系存在待处理问题时）
   
### 记忆体系的更新与同步

1. **记忆体系文件更新**：当收到git指令并完成本地代码提交之后要自动调用/memory-sync插件完成记忆文件的更新

### 记忆目录

```
.claude/memory/
├── MEMORY.md                          # 索引（入口）
├── decisions.md                       # 关键决策
├── feedback.md                        # 协作规范
├── feedback_medical_pad_migration.md  # 医疗点PAD端原型规范（按需）
├── feedback_shell_sidebar_scope.md    # Web管理端壳层导航规范（按需）
├── project_progress.md                # 阶段进度
├── project_overview.md                # 技术栈与架构
├── user_profile.md                    # 用户画像
└── lint_report.md                     # 记忆健康检查报告（按需）
```

> 记忆文件是跨会话持久化的知识，优先级高于 Agent 的默认推断。若记忆内容与当前代码状态冲突，以代码为准并更新记忆。