| name | medmemo |
| description | 用于在 MedMemo 仓库内进行开发、重构、审查、Debug、推进版本号， 或处理 Wails/Wire 架构、对话-记忆-合规流水线、SQLCipher/sqlite-vec 存储、 ChatOrchestrator、Provider、脱敏、embedding 迁移等相关任务时。 |
MedMemo Project Skill
开源桌面健康咨询信息工具（非医疗器械）。本地优先、多模型对话、分层记忆、四级合规拦截。
当前版本：以 wails.json → info.productVersion 为准（勿硬编码版本号）。
开始工作前
- 读 reference-architecture.md 确认分层与数据流
- 改代码前对照 reference-conventions.md 铁律
- 推进版本时执行 reference-release.md 检查清单
- 写/改文档前必须触发
codebase-documenter Skill，完成后触发 submission-checker Skill
- 写/改/审/重构代码注释时必须触发
code-comment Skill
- 实质性变更后更新 tracker.md
项目速览
| 项 | 值 |
|---|
| 入口 | 仓库根 main.go + wails_app.go（非 cmd/health-assistant/） |
| DI | wire.go 手改 → wire . 生成 wire_gen.go（禁止手改） |
| 前端 | web/ — React 18 + TS strict + Zustand + HashRouter |
| 主库 | SQLCipher + sqlite-vec 向量检索 |
| 本地 AI | Hugot/ONNX — NER 脱敏 + Embedding（Session 非线程安全，mutex 串行） |
| Wails 绑定 | wails_app.go → 前端 useWails() |
未落地存根（严禁自行实现）
以下模块仅保留接口或占位实现，不要假设可用，也不要主动补全实现：
- DuckDB（
internal/infrastructure/database/duckdb.go）— 已冻结，项目已降级至 SQLite
- Kùzǔ 家族图谱（
FamilyRepoKuzu）— 未接入 Wire，无实际调用路径
若需求涉及上述模块，必须先与维护者确认技术路线。
对话主路径（简图）
用户输入 → CheckEmergency → [云端] DeidentifyPipeline（L1 规则 → L2 NER）→ MemoryRetriever
→ IntentResolver / LocalAnswerService（高置信本地短路）
→ LLM StreamChat → ComplianceInterceptor 分句检测 → Events 推送前端
→ saveMessages + extractFactsAsync
本地模型（Ollama/Local）跳过脱敏。详见 reference-modules.md。
常见任务工作流
新增 Wire 依赖
- [ ] 在对应层 ProviderSet 添加构造函数
- [ ] 修改 wire.go 添加 wire.Bind（如需要）
- [ ] 运行 wire .（仓库根目录）
- [ ] 确认 wire_gen.go 已更新，未手改
修改 Provider / 多模型
- 路由：
internal/adapters/ai/provider.go（Ollama→LocalAdapter，Local→OpenAIAdapter，云端→OpenAIAdapter）
- 同步
web/src/data/provider-templates.json
- 运行
scripts/validate-provider-templates.js
修改合规 / 脱敏 / 紧急症状
- 合规规则：
resources/rules/compliance_rules_v1.json
- 拦截器：
internal/application/compliance_interceptor.go
- 脱敏流水线：
internal/application/pipeline/deidentify.go
- 紧急关键词：
internal/application/emergency_detector.go
- UI 文案须过合规红线（见 conventions）
修改记忆 / Embedding
- 事实层：
fact_repo + HealthFact
- 向量层：
embedding_repo + SemanticEmbedding
- 检索：
usecase/MemoryRetriever
- 版本迁移：
EmbeddingMigrator，ONNX 预热后门控（wails_app.go）
强制规则（摘要）
| 规则 | 要求 |
|---|
| domain 层 | 仅标准库 + pkg/models/ |
| 错误处理 | fmt.Errorf("...: %w", err)，禁止裸 return err |
| Wire | 只改 wire.go，禁止手改 wire_gen.go |
| TODO | // TODO(作者): 描述 [Issue#N]，同步 medmemo/开发日志/issues.md |
| 合规红线 | 禁止确诊/处方/治疗建议/"AI医生"；紧急症状必须提醒 |
| Skill 触发 | 文档变更触发 codebase-documenter + submission-checker；注释变更触发 code-comment |
| 双语文档 | 顶层文档英文撰写，docs/i18n/zh-Hans-CN/ 同步中文翻译 |
| 前端 | TS strict；Wails 调用走 useWails()；@/ 别名 |
完整约定见 reference-conventions.md。
版本发布
推进版本号时必须同步（常规 Minor/Patch）：
□ wails.json → info.productVersion（唯一事实来源）
□ web/package.json → version（与上完全一致，无 v 前缀）
□ web/package-lock.json → 执行 `cd web && npm install` 刷新锁定文件
□ internal/domain/entity/changelog/zh-Hans.json → 数组末尾新增条目
□ medmemo/开发日志/ → 对应版本日志
□ tracker.md → 追加滚动记录
大版本（如 v1.1.x → v1.2.0）额外要求见 reference-release.md。
构建命令
wails dev
wails build
wire .
go test ./...
cd web && npm test
滚动更新
每次实质性代码修改、架构理解深化或版本推进后，在 tracker.md 顶部追加记录（格式见该文件）。
延伸阅读
