MiMo Code的技术债务管理是结构化、可检索、主动介入的活地图。它要求债务条目含模块位置、类型、原因等必填字段，通过SQLite FTS5索引，支持语义检索，并在开发关键节点自动提醒、规划和强制审查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
技术债务标记不是随手记个 TODO 就完事，关键在于让 MiMo Code 真正“记住它、理解它、后续主动提醒你”。它的项目记忆（MEMORY.md）不是静态笔记，而是被 SQLite FTS5 全文索引的结构化知识节点，能被 AI 在规划、审查、重构时主动调用。
技术债务必须带上下文才进得去记忆库
直接写“TODO: 优化登录接口”会被忽略。MiMo Code 只收录含明确背景、影响范围和判断依据的条目。它需要知道：这是谁留下的、为什么算债务、改不改会出什么问题。
-
必填字段：模块位置（如
auth/service.go）、债务类型（耦合/重复/过期依赖/硬编码）、触发原因（如“因 v3.2 API 升级导致兼容层冗余”） - 推荐补充：关联 PR/Issue 编号、当前阻塞的业务需求（如“阻碍 SSO 接入”）、临时规避方案（如“已加 fallback 日志但未降级”）
-
格式示例：
[TECH-DEBT] auth/service.go —— 耦合型<br> ▸ 原因：LoginHandler 直接调用 DB 层，绕过 Repository 抽象层（违反 clean architecture）<br> ▸ 影响：无法在测试中 mock 数据源；阻塞「多租户隔离」需求（#421）<br> ▸ 临时方案：已加 @Deprecated 注释，保留旧路径供 legacy client 使用
用命令行一键注入，别手动改 MEMORY.md
MiMo Code 提供专用指令，确保内容被正确解析、索引并关联到代码位置。手动编辑 MEMORY.md 不仅容易格式错，还可能跳过 FTS5 索引更新。
- 运行
mimo debt add --file auth/service.go --type coupling --reason "violates repository layer" - 系统自动提取文件 AST 结构，将债务锚定到具体函数或类型（如
LoginHandler.ServeHTTP），而非整行文本 - 注入后立即触发本地 FTS5 重建，5 秒内即可在后续会话中被语义检索命中（例如你问“哪些地方违反了 clean architecture？”）
让它在关键节点自动浮现，而不是等你翻记录
存进去只是第一步。MiMo Code 的记忆系统会在你执行相关操作时主动介入，把债务变成可行动项。
- 当你修改
auth/下任意文件，AI 会弹出提示：“检测到对 auth 模块的变更，关联 2 条技术债务，是否纳入本次重构范围？” - 执行
mimo plan --feature sso-integration时，它自动把 #421 对应的债务列为前置任务，并生成迁移路径（如“先抽离 DB 调用 → 再注入 Repository 接口 → 最后移除旧 handler”） - Git commit 前运行
mimo review，若改动触及已标记债务区域，会强制要求填写--resolve-debt或--defer-reason参数
真正起作用的技术债务管理，是让 AI 把它当真——当成代码的一部分来读、来查、来调度。MiMo Code 不是记事本，它是债务的活地图。
