自定义

Cline 自定义指南

.clineignore 支持

为了给您更多控制权,决定哪些文件可以被Cline访问,我们实现了.clineignore功能,类似于.gitignore。这允许您指定Cline不应访问或处理的文件和目录。这在以下情况下非常有用:

  • 隐私: 防止Cline访问工作区中的敏感或私人文件。
  • 性能: 排除与任务无关的大型目录或文件,可能提高Cline的效率。
  • 上下文管理: 将Cline的注意力集中在项目的相关部分。

如何使用.clineignore

  1. 创建.clineignore文件: 在您的工作区根目录(与.vscode文件夹同级,或在VS Code中打开的顶级文件夹)中,创建一个名为.clineignore的新文件。

  2. 定义忽略模式: 打开.clineignore文件并指定您希望Cline忽略的文件和目录的模式。语法与.gitignore相同:

    • 文件中的每一行代表一个模式。

    • 支持标准glob模式:

      • * 匹配零个或多个字符
      • ? 匹配一个字符
      • [] 匹配字符范围
      • ** 匹配任意数量的目录和子目录。
    • 目录模式: 在模式末尾添加/以指定目录。

    • 否定模式: 在模式前添加!以否定(取消忽略)先前忽略的模式。

    • 注释: 在行首添加#以添加注释。

    示例.clineignore文件:

    # 忽略日志文件
    *.log
    
    # 忽略整个'node_modules'目录
    node_modules/
    
    # 忽略'temp'目录及其子目录中的所有文件
    temp/**
    
    # 但不要忽略根目录中的'important.log'
    !important.log
    
    # 忽略任何子目录中名为'secret.txt'的文件
    **/secret.txt
    
  3. Cline尊重您的.clineignore: 一旦您保存了.clineignore文件,Cline将自动识别并应用这些规则。

    • 文件访问控制: Cline将无法使用read_file等工具读取被忽略文件的内容。如果您尝试在忽略的文件上使用工具,Cline将告知您由于.clineignore设置,访问被阻止。
    • 文件列表: 当您要求Cline列出目录中的文件时(例如使用list_files),被忽略的文件和目录仍会被列出,但它们旁边会标记一个🔒符号,表示它们被忽略。这有助于您了解Cline可以和不与之交互的文件。
  4. 动态更新: Cline会监控您的.clineignore文件的更改。如果您修改、创建或删除.clineignore文件,Cline将自动更新其忽略规则,而无需重新启动VS Code或扩展。

总结

.clineignore文件提供了一种强大而灵活的方式来控制Cline对工作区文件的访问,增强了隐私、性能和上下文管理。通过利用熟悉的.gitignore语法,您可以轻松地将Cline的注意力集中在项目中最相关的部分。