workflows/merico/docstring/README.md

### docstring

这个命令用于自动为选中的函数或方法生成文档字符串（docstring）。

#### 用途
- 快速为函数或方法添加标准格式的文档字符串
- 提高代码的可读性和可维护性
- 自动生成包含参数、返回值等信息的详细文档

#### 使用方法
1. 在IDE中选中需要添加文档字符串的函数或方法
2. 执行以下命令之一：
   - 输入 `/docstring` 并回车
   - 点击函数头部的 **docstring** 按钮

#### 操作流程
1. 选中需要添加文档字符串的函数或方法
2. 执行docstring命令
3. 等待文档字符串生成完成
4. 自动弹出Diff View，您可以选择接受或拒绝修改

#### 注意事项
1. 确保在执行命令前已选中完整的函数或方法
2. 生成的文档字符串会插入到函数定义之后
3. 文档字符串的格式会根据编程语言自动调整（如Python使用三引号，Java使用JavaDoc格式）
4. 原有的文档字符串可能会被替换，请在Diff View中仔细检查

#### 示例
选中以下Python函数：
```python
def add(a, b):
    return a + b
```
执行docstring命令后，可能生成如下文档字符串：
```python
def add(a, b):
    """
    将两个数相加。

    参数:
    a (int): 第一个加数
    b (int): 第二个加数

    返回:
    int: 两个数的和
    """
    return a + b
```


额外信息:

- 文档字符串的语言会根据当前IDE的语言设置自动调整
- 对于中文环境，会生成中文文档字符串
- 该命令利用AI技术生成文档字符串，可能需要一定的处理时间

如图所示：

![图片](https://deploy-script.merico.cn/devchat/workflow/readme_docstring.gif)