lightpointventures 生成文档
为代码自动添加文档注释，省去手写文档的麻烦。
步骤
1. 确定文档目标
如果用户指定了文件或函数，直接读取。
如果没有指定，问：
你想给哪段代码加文档？可以告诉我文件名、函数名或类名。
2. 检查项目的文档风格
查看项目中已有的文档注释，了解：
- 使用的文档格式（Python: Google style / NumPy style / reStructuredText，JS/TS: JSDoc，Go: godoc）
- 文档语言（中文还是英文）
- 详细程度
如果项目没有已有文档，根据语言社区惯例选择最常用的格式。
3. 生成文档
为目标代码生成文档注释，包括：
- 简要描述 — 一句话说明这个函数/类做什么
- 参数说明 — 每个参数的名称、类型、含义
- 返回值 — 返回什么、什么类型
- 异常/错误 — 可能抛出什么异常（如果有）
- 使用示例 — 一个最简单的调用示例（仅对复杂函数添加）
规则：
- 文档要准确反映代码实际行为，不要写代码没做的事情
- 保持简洁，不要把显而易见的事情写进文档
- 与项目已有的文档风格保持一致
4. 写入
展示生成的文档，询问用户：
文档生成好了，要我写入文件吗？
用户确认后写入。