CodeGeeX 可基于 Markdown 需求文档自动生成带类型注解、文档字符串和 TODO 占位符的多语言代码骨架，支持 VS Code 插件、网页版批量解析及 CLI 命令行三种方式，适配 Python/Flask/FastAPI、TypeScript/React 等主流技术栈。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把一份用 Markdown 写的需求说明（比如功能描述、输入输出样例、业务规则）直接变成可运行的代码骨架，而不是手动逐行翻译逻辑。CodeGeeX 能基于语义理解自动提取关键要素并生成带注释、结构清晰的初始代码，跳过重复造轮子环节。
在 VS Code 中用插件一键转换
该方法适用于已打开需求文档 .md 文件且项目结构明确的本地开发场景，CodeGeeX 插件能同时读取当前文件内容和邻近的 src/ 或 app/ 目录上下文，生成更贴合实际工程结构的草案。
1、在 VS Code 中打开你的需求文档（例如 requirements.md），确保它与代码项目根目录处于同一工作区。
2、将光标置于文档中某段核心需求描述末尾（如“用户登录需校验手机号格式，并返回 JWT token”），按下 Ctrl+Shift+D（Windows/Linux）或 Cmd+Shift+D（Mac）触发文档驱动代码生成。
3、CodeGeeX 自动识别动词（“校验”“返回”）、实体（“手机号”“JWT token”）、约束（“格式”）并映射为函数签名、参数类型与占位逻辑，插入类似 validate_phone_and_issue_jwt(phone: str) → dict 的 Python 函数草案。
4、检查生成代码中是否包含 type hint、docstring 占位符及 TODO 注释标记未实现细节；若缺失，说明需求描述中缺少明确的输入类型或返回结构，需补全“手机号为 11 位数字字符串”“返回字段含 access_token 和 expires_in”等信息后重试。
用网页版上传 Markdown 文件批量生成
当你手头有多个独立的需求文档（如 feature-A.md、feature-B.md），需要统一风格生成对应模块草案时，网页版支持批量解析与语言适配。
方法一：直接粘贴文本
1、访问 CodeGeeX 官网「代码生成」页面，选择“从需求文档生成代码”模式。
2、粘贴一段完整 Markdown 需求，例如包含标题、列表项、代码块示例和边界条件说明的内容。
3、在提示框中明确指定目标语言和框架：“生成 Flask 路由函数，处理 POST /api/v1/login，接收 JSON body 含 phone 字段，响应 200 带 token 对象”。
4、点击生成，复制返回的 Python + Flask 草案代码，注意核对 request.get_json() 解析、abort(400) 错误分支是否已预置。
方法二：上传 .md 文件
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
1、点击“上传文件”按钮，选择单个 Markdown 文件（不支持压缩包嵌套）。
2、系统自动提取 H2/H3 标题作为模块名，列表项作为函数职责，代码块中的 curl 示例作为接口调用示意。
3、在语言选项中选择 TypeScript 并勾选“生成 React Hook”，则输出 useLoginMutation() 自定义 Hook 草案，含 mutation 配置与 error 处理占位。
【必须确认上传文件编码为 UTF-8，含中文字符时若出现乱码会导致实体识别失败】
通过 CLI 将需求文档转为多语言草案
适合集成进团队文档协作流程，比如每次 PR 提交新需求文档后自动产出对应代码模板。
第一步：准备原始文档
确保 requirements.md 存放在项目根目录下，且首行含 YAML front matter 标明目标语言：
```
---
target_language: python
framework: fastapi
---
```
第二步：执行转换命令
在终端中运行：codegeex generate --input requirements.md --output src/auth/login_draft.py
第三步：验证生成结果
生成的 login_draft.py 包含 FastAPI 的 @app.post 装饰器、Pydantic 模型定义、依赖注入占位（如 Depends(get_current_user)），以及根据文档中“密码需 AES 加密存储”自动生成的 encrypt_password() 函数 stub。
第四步：导出为 Markdown 报告便于评审
运行 codegeex report --format markdown --input src/auth/login_draft.py，生成含代码差异说明、缺失逻辑标注、安全风险提示的 review_report.md，供产品与研发同步对齐。
