☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
技术文档代码注释翻译需用语境锚点锁定指代：上传时手动设原文为english并勾选多语种混合识别；指令中绑定函数签名或注入术语表；验证须检查句柄译法、缩写括号标注及函数名原样保留。
技术文档里的代码注释常含缩写、项目专有术语和上下文依赖的指代，直接粘贴翻译会导致“初始化句柄”译成“initialization handle”而丢失其在当前sdk中特指“device context pointer”的语义。必须用语境锚点锁定真实指代关系。
上传前预处理源文件
打开Kimi网页端或App，点击右上角“+”→选择“上传文件”，拖入含代码注释的PDF或Markdown文档。
上传后立即点击预览界面右上角“语言设置”，【手动指定原文为English，禁用自动检测】。若文档混有中文注释（如// 初始化串口 → // init UART），需额外勾选“多语种混合识别”，否则Kimi会把中文注释误判为噪声过滤掉。
构造带语境约束的翻译指令
方法一：绑定函数签名与调用链
在左侧目录中定位到含目标注释的代码块所在章节（如“3.2 UART驱动初始化”），点击进入高亮编辑状态。
在对话框输入：“你是一位嵌入式系统固件工程师，请将下方C语言函数中的英文注释翻译为中文，必须严格遵循：①‘handle’统一译为‘句柄’，但若出现在uart_init(handle)函数签名中，则译为‘UART设备上下文指针’；②所有缩写（如TX/RX/IRQ）首次出现时保留英文并括号标注中文全称；③注释中指向其他函数的名称（如‘see uart_config()’）不翻译，保持原样。”
复制该函数完整代码（含函数声明、注释、第一行实现语句）粘贴至指令后发送。
方法二：注入模块级术语表
使用 Moonshot Kimi API 的 $web_search 内置工具进行联网搜索。当需要进行网络搜索获取实时信息时使用，支持中文和英文搜索查询。需要配置 MOONSHOT_API_KEY。
若文档含术语表附录（如Appendix A: Glossary），先单独上传该页PDF，输入指令：“提取以下术语表中所有带‘UART’前缀的条目，生成键值对映射：英文原词→中文标准译法（按《嵌入式系统术语国家标准GB/T 38654-2020》）。”
收到术语表解析结果后，在主文档翻译指令开头追加：“已知术语映射：{粘贴上一步输出的JSON格式键值对}。请用此映射表校准后续所有注释翻译。”
验证译文是否保留技术指代精度
第一步：检查Kimi输出中是否出现“句柄”字眼——若存在，说明未触发语境替换规则，需返回上一步重新输入指令，重点确认函数签名是否完整复制（缺了uart_init(handle)这行就无法激活上下文判断）。
第二步：逐行比对原文注释与译文，定位所有含“TX”“RX”“IRQ”的位置，确认首次出现处是否形如“TX（发送缓冲区）”。若缺失括号说明术语约束未生效，此时应删掉指令中所有修饰性描述，只保留最简结构：“请将以下注释翻译为中文：①TX→发送缓冲区；②RX→接收缓冲区；③IRQ→中断请求；④其余内容直译。”
第三步：在译文里搜索“参见”“见”“参考”等字样，核对其后跟的函数名是否与原文完全一致（包括大小写和下划线）。若出现“参见uart_config函数”，立刻重发请求——Kimi擅自添加了“函数”二字，违反了“不翻译函数名”的硬性约束。
