真实接口文档必须锚定代码行号、pr评论和错误堆栈，禁用空泛标题；需原样输入带【第87行】等定位信息的cr评论，过滤无日期/人名/物理定位词的文档，并通过jsdoc或json-ld注入seo标题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在MarsCode里生成接口文档时，如果输出全是“用户管理接口”“订单查询API”这类空泛标题和模板化描述，开发者根本不会点开——真实团队只信任带行号、带错误堆栈、带PR评论情绪的文档。必须用真实代码上下文锚定生成过程。
把Git PR评论原样喂给MarsCode
打开MarsCode配置页 → 进入「自定义提示词」→ 在搜索框粘贴最近一次被拒的CR评论原文，例如：“【src/api/auth.ts第87行】token校验没做expired时间戳判断,测试环境已复现401跳转丢失”。
这一步不能改写、不能概括、不能加“请生成文档”之类引导语——MarsCode会识别其中的物理定位（第87行）、缺陷类型（未判expired）、复现场景（测试环境401跳转丢失），从而召回真实项目中已验证过的文档结构。
【必须保留原始引号、方括号、冒号和换行格式，删掉任一符号都可能让模型丢失行号锚定能力】
用三类不可伪造信号过滤结果
第一步：关闭所有标题含“通用”“最佳实践”“万能模板”的文档——这些是知识库早期沉淀，未同步2026年Q2新增的行号锚定与P0/P1风险分级规则。
第二步：只点开带具体日期（如“2026-06-05”）和人名（如“@张工”）的条目。没有时间戳的文档大概率没经过真实CR验证。
第三步：打开文档后立刻扫视是否出现【第X行】、【函数Y】、【变量Z未判null】这类物理定位词。没有就关掉——这种提示词连自己写的代码都找不到位置，更别说评审别人的。
从真实接口文件反向提取SEO标题
方法一：打开你项目里的 src/api/user.ts，找到 export function getUserById(id: string) 函数，复制其JSDoc注释第一行。
方法二：在MarsCode中右键该函数 → 选择「AI生成接口文档」→ 在弹出窗口中手动替换标题为：“获取MarsCode用户详情API|v2.3身份服务接口文档”。
方法三：在生成的Markdown文档中，于新标题正下方紧贴插入JSON-LD标记，不要空行：{"@type":"WebAPI","name":"获取MarsCode用户详情API|v2.3身份服务接口文档","description":"根据用户ID查询完整用户信息，含角色权限与登录态有效期"}。
