MPM-Coding

check_update - 检查 MPM-Coding 新版本 用途: 检查 GitHub Releases 是否有新版本, 提示用户手动更新。 参数: 无 触发词: "mpm 更新", "mpm update", "mpm check update"

code_impact - 改动风险报警 用途： 基于静态索引提示明显上游/下游风险点；用于改前优先检查，不是完整影响范围证明 参数： symbol_name (必填) 要分析的符号名（函数名或类名） 注意：必须是精确的代码符号，不支持字符串搜索 direction (默认: backward) - backward: 谁调用了我（影响上游） - forward: 我调用了谁（影响下游） - both: 双向分析 返回： - 风险等级（low/medium/high） - 明显风险点列表（前10个） - 间接风险线索数量 - 改前优先检查锚点 示例： code_impact(symbol_name="Login", direction="backward") -> 分析谁在调用 Login 函数 触发词： "mpm 影响", "mpm 依赖", "mpm impact"

code_search - 代码符号定位 (比 grep 更懂代码) 用途： 【精确定位】当你只知道名字（函数名/类名），但不知道它在哪个文件时，别用 grep，用我。 参数速查： query (必填) 符号名，如 "SessionManager"、"handleRequest" scope (可选) 限定目录，如 "internal/core" search_type (可选) any|function|class（默认 any） ⚠️ 注意：query 是符号名，不要写自然语言。 调用示例： { "query": "SessionManager" } { "query": "handleRequest", "scope": "internal/services", "search_type": "function" } 触发词： "mpm 搜索", "mpm 定位", "mpm 符号", "mpm find"

ensure_languages - 确保 tree-sitter grammar 已下载 用途： 扫描项目文件扩展名，下载缺失的 tree-sitter grammar。通常在 initialize_project 时自动执行。 参数： project_root (可选) 指定项目根路径。留空时使用当前会话项目。 触发词： "mpm 下载语法", "mpm ensure languages"

flow_trace - 业务流程追踪(文件/函数) 用途: 给 LLM 建立代码阅读候选主链: 先定位入口锚点, 再看上下游候选依赖, 按关键节点顺序阅读源码。 参数: symbol_name 函数名、类名或文件路径, 系统自动识别 scope 限定目录(大项目建议填), 例如 "internal/services" direction both|forward|backward(默认 both) mode brief|standard|deep(默认 brief) max_nodes 输出节点上限(默认 40) 触发词: "mpm 流程", "mpm flow"

index_status - 查看 AST 索引后台任务状态 用途： 查询 initialize_project 启动的后台索引任务进度、心跳和数据库文件大小。 参数： project_root (可选) 指定项目根路径。留空时使用当前会话项目。 返回： - status/mode/started_at/finished_at - heartbeat(processed/total) - symbols.db / symbols.db-wal / symbols.db-shm 文件大小 触发词： "mpm 索引状态", "mpm index status"

initialize_project - 初始化项目环境与数据库 用途： 任何其他 MPM 操作前，必须先调用此工具初始化项目环境。它会建立数据库索引、检测技术栈并生成项目规则。 参数： project_root (必填) 项目根目录的绝对路径。如果留空，工具会尝试自动探测。 force_full_index (可选) 强制全量索引（禁用大仓库 bootstrap 策略）。默认 false。 skip_rules (可选) 跳过 AGENTS.md 协议注入。默认 false。 说明： - 手动指定 project_root 时必须使用绝对路径。 - 调用前先检查你的上下文/系统提示词中是否已包含 MPM 协议（如用户级 AGENTS.md 已有 MPM 工具协议）。若已包含，传 skip_rules=true 避免项目级 重复注入；若未包含，协议将注入项目根 AGENTS.md 顶部（marker 区段， 幂等更新），客户端自动加载。 示例： initialize_project(project_root="D:/AI_Project/MyProject") -> 初始化指定路径的项目 initialize_project(project_root="D:/AI_Project/MyProject", skip_rules=true) -> 上下文已有 MPM 协议，跳过项目级注入 触发词： "mpm 初始化", "mpm init"

memo - 项目的"黑匣子" (如果不记，等于没做) 用途： 【修改后必选】任何代码/文档修改后，严禁不留记录直接结束。 这不仅是给用户看的，更是为了你自己以后能检索到 "当时为什么这么改"。它是项目演进的唯一真理源 (SSOT)。 参数： items (必填 - JSON 数组): ⚠️ 注意：items 本身就是一个数组，即使只记录一条也要用 [{...}] 包裹 每个数组元素包含以下字段（全部必填）： - category: 分类，如 "修改"、"开发"、"决策"、"重构"、"避坑" - entity: 改动的实体（文件名、函数名、模块名） - act: 简要行为描述，如 "修复Bug"、"新增功能"、"技术选型" - path: 文件路径 - content: 详细说明，解释"为什么这么改"而非只说"改了什么" lang (可选，默认 zh): 记录语言，建议始终使用中文 fact_observations (可选): 本次修改揭示的可复用项目经验（每条一句），会追加到项目根 known-facts.md 作 candidate。 只写可复用经验（格式："在XX条件下应该/不应该YY"），不写任务完成确认或流水账；没有就别填。 完整调用示例（JSON格式）： { "items": [ { "category": "修改", "entity": "SessionManager", "act": "修复空指针异常", "path": "core/session.go", "content": "添加 nil 检查，防止未初始化的配置导致 panic" } ], "lang": "zh" } 触发词： "mpm memo", "mpm 记录", "mpm 存档"

open_timeline - 项目演进可视化界面 用途： 生成并展示交互式时间线，可视化项目的开发历史和决策演进。 参数： 无 说明： - 基于 memo 记录生成 project_timeline.html。 - 会尝试自动在默认浏览器中打开生成的文件（Windows 下已加强空格/中文等路径的兼容性，优先使用系统文件关联）。 示例： open_timeline() -> 在浏览器中打开项目演进时间线 触发词： "mpm 时间线", "mpm timeline"

persona - AI 人格管理工具 用途： 切换或列出可用的 AI 人格（角色）。通过改变语气、回复风格和思维协议，提升交互体验或特定场景的处理效率。 参数： mode (默认: list) - list: 列出所有可用的预设人格。 - activate: 激活指定的人格。 - create: 新增人格（写入 .mcp-config/personas.json）。 - update: 更新人格（支持重命名）。 - delete: 删除人格。 name (activate/update/delete 模式必填) 目标人格名称或别名。 自然语言触发示例： - "激活人格 孔明" - "切换到白起人格" - "列出所有人格" - "创建人格 xxx" - "删除人格 xxx" create/update 可选字段: - new_name, display_name, hard_directive, aliases - style_must, style_signature, style_taboo, triggers 说明： - 激活人格后，LLM 将严格遵守该角色的语言特征和指令。 - 常驻角色包括诸葛（孔明）、懂王（特朗普）、哆啦（哆啦 A 梦）等。 - 建议在对话中展示简要结果（如已激活人格名称），避免输出冗长内部提示文本。 示例： persona(mode="activate", name="zhuge") -> 切换到孔明人格，使用文言文风格响应 persona(mode="create", name="my_architect", display_name="架构师", hard_directive="回答要简洁严谨") -> 新增自定义人格 触发词： "mpm 人格", "mpm persona", "激活人格", "切换人格", "切换到.*人格", "列出人格", "创建人格", "删除人格"

project_map - 项目导航仪（不知道代码在哪时用） 用途： 宏观视角：当你迷路了，或不知道该改哪个文件时，用我获取项目导航锚点。 参数速查： level symbols|structure（默认 symbols） scope 项目内相对目录（留空=整个项目） ⚠️ 注意：scope 是相对路径，如 "internal/services"，不要填绝对路径。 调用示例： { "level": "structure" } { "level": "symbols", "scope": "internal/core" } 触发词： "mpm 地图", "mpm 结构", "mpm map"

system_hook - 系统钩子 (挂起/列表/释放) 用途： 当任务被阻塞（缺信息/待确认/无法继续）时，用 Hook 挂起当前进度；之后可随时列出/释放并记录结果。 参数： mode (必填): - create: 创建并挂起 Hook - list: 列出 Hook - release: 释放并闭合 Hook create 模式参数： - description (必填) - priority (默认: medium) high/medium/low - task_id (可选) - tag (可选) - expires_in_hours (默认: 0) list 模式参数： - status (默认: open) open/closed release 模式参数： - hook_id (必填) 例如 "#001" - result_summary (可选) 示例： system_hook(mode="create", description="等待用户提供 API 密钥", priority="high") system_hook(mode="list", status="open") system_hook(mode="release", hook_id="#001", result_summary="API 密钥已配置并测试通过") 触发词： "mpm hook", "mpm hooks", "mpm 挂起", "mpm 待办", "mpm 待办列表", "mpm 释放", "mpm 完成"

system_recall - 你的记忆回溯器 (少走弯路) 用途： 【下手前推荐】想改某个功能，但不确定以前有没有类似的逻辑？或者怕踩到以前的坑？ 用此工具查一下记忆库，避免重复造轮子或重蹈覆辙。 参数策略： keywords (必填) 想查什么就填什么，支持模糊匹配（空格拆分）。 category (可选) 缩小范围：如 "避坑" / "开发" / "决策" 触发词： "mpm 召回", "mpm 历史", "mpm recall"