在fitten code中需先启用ai代码生成功能，再编写含英文args/returns的结构化注释，最后通过快捷键、右键或命令面板触发生成，并验证函数签名、校验逻辑与执行结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Fitten Code 中通过自然语言注释自动生成完整逻辑代码，需要先启用其 AI 编程辅助核心功能，再确保注释具备明确的输入输出描述和结构化意图。
启用 Fitten Code 的 AI 代码生成能力
打开 VS Code → 点击左侧活动栏的 Fitten Code 图标 → 在右上角点击齿轮图标进入设置 → 找到「AI Assistant」选项卡 → 将「Enable AI Code Generation」开关置为开启状态。
这一步必须完成，否则后续所有注释都不会触发代码生成。关闭状态下即使写满整页注释，右键菜单也不会出现「Generate Code from Comment」选项。
编写可被识别的结构化注释
在编辑器中新建一个 .py 文件，光标定位到函数定义位置上方，输入三重双引号开始写文档注释。
注释第一行写明函数用途，第二行起用「Args:」列出参数名、类型和含义，下一行用「Returns:」说明返回值类型与意义。例如："""计算用户订单总金额，支持折扣叠加。\nArgs:\n items (list[dict]): 商品列表，每个字典含 'price' 和 'qty' 键\n discount_rate (float): 折扣率，范围 0.0～1.0\nReturns:\n float: 折后总金额，保留两位小数\n"""
注意：Fitten Code 不解析中文句式或模糊描述，【Args 和 Returns 必须使用英文冒号+换行缩进格式，且参数名要与后续实际变量名一致】。写成「参数：商品列表」或「返回：钱数」将导致生成失败。
触发注释转代码的三种方式
方法一：快捷键触发
确保光标位于注释块内部或紧贴其下方 → 按 Ctrl+Shift+I（Windows/Linux）或 Cmd+Shift+I（Mac）→ 等待右下角弹出「Generating...」提示 → 生成完成后自动插入函数骨架。
方法二：右键菜单触发
鼠标选中整个注释块（包括三重引号）→ 右键 → 选择「Fitten: Generate Function from Comment」→ 生成结果会以代码块形式浮现在编辑器中部，点击「Insert」即可粘贴到光标位置。
方法三：命令面板触发
按下 Ctrl+Shift+P（或 Cmd+Shift+P）→ 输入「Fitten: Generate」→ 选择「Fitten: Generate Code from Current Comment」→ 此方式适用于注释跨多行且未完全选中的情况，比手动选区更鲁棒。
验证生成逻辑是否符合预期
第一步：检查生成的函数签名是否与注释中 Args/Returns 完全匹配，包括参数顺序、名称、类型提示（如未启用 type hint 插件，Fitten Code 默认不添加）。
第二步：观察函数体内是否包含基础校验逻辑，例如对 items 是否为 list、discount_rate 是否在 0～1 区间做了 assert 或 if 判断。若未生成，说明注释中缺少「需校验输入有效性」等明确指令。
第三步：在函数末尾添加一行 # test: print(calculate_total([{'price': 100, 'qty': 2}], 0.1)) → 保存文件 → 点击右上角「▶ Run」按钮执行 → 查看终端输出是否为 180.0。
