在codeium中需用动宾结构英文注释明确函数意图，补充关键约束、嵌入变量名及分步骤说明，以提升ai补全准确性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Codeium中准确描述函数意图，能让AI补全更贴合你真正想写的逻辑，而不是泛泛生成语法正确的无效代码。直接写“处理数据”或“返回结果”这类模糊表述，Codeium往往无法区分上下文差异，容易补全出与业务无关的通用模板。
用动宾结构明确动作和对象
在函数定义上方空一行，用英文单行注释（//）或文档字符串开头，以动词+名词短语直述该函数要完成的具体操作。
例如：// Calculate total price after discount → 这比 // Get price 更具体，Codeium能识别“计算”是动作、“总价”和“折扣后”是关键约束条件。
避免使用抽象名词作主语，如“PriceCalculator”“Handler”“Manager”，这些词不会触发Codeium对行为的理解。
补充关键约束条件
在动宾描述后，用括号追加1～2个不可省略的限定信息，格式为：// [动宾描述] (when X, if Y, for Z)。
例如：// Validate user email format (for signup flow, not password reset) → 明确区分场景，防止Codeium混用正则表达式或调用错误的校验服务。
注意：括号内必须是实际影响实现路径的条件，不是泛泛而谈的“in production”或“with error handling”。【缺少具体约束时，Codeium默认按最简路径补全，可能跳过权限检查、空值防护等关键分支】
嵌入变量名暗示数据流向
方法一：在注释中直接写出输入参数名和期望输出形态，用箭头连接。
// transformRawInput → sanitizedOutput (input: string, config: {stripHtml: true})
方法二：若函数已声明参数，注释中复用其名并标注角色。
// processOrder(orderId: string) → orderStatus: 'shipped' | 'cancelled'
这一步让Codeium把注释和签名绑定理解，补全时会严格匹配类型和命名上下文，而非猜测任意字符串处理逻辑。
分步骤写多行意图（适用于复杂函数）
第一步：用一句话定义核心目的，不带任何实现细节。
第二步：列出必须满足的3个以内硬性规则，每条单独一行，以“Must”开头。
第三步：指出一个典型输入输出示例，用“e.g.”引导。
// Generate invoice PDF for paid orders only
Must check order.status === 'paid'
Must embed merchant logo from config.logoUrl
Must fail fast if lineItems.length === 0
e.g. input: {orderId: 'ord_abc123'}, output: Buffer with PDF bytes
