自定义
Cline 自定义指南
.clineignore 支持
为了给您更多控制权,决定哪些文件可以被Cline访问,我们实现了.clineignore
功能,类似于.gitignore
。这允许您指定Cline不应访问或处理的文件和目录。这在以下情况下非常有用:
- 隐私: 防止Cline访问工作区中的敏感或私人文件。
- 性能: 排除与任务无关的大型目录或文件,可能提高Cline的效率。
- 上下文管理: 将Cline的注意力集中在项目的相关部分。
如何使用.clineignore
-
创建
.clineignore
文件: 在您的工作区根目录(与.vscode
文件夹同级,或在VS Code中打开的顶级文件夹)中,创建一个名为.clineignore
的新文件。 -
定义忽略模式: 打开
.clineignore
文件并指定您希望Cline忽略的文件和目录的模式。语法与.gitignore
相同:-
文件中的每一行代表一个模式。
-
支持标准glob模式:
*
匹配零个或多个字符?
匹配一个字符[]
匹配字符范围**
匹配任意数量的目录和子目录。
-
目录模式: 在模式末尾添加
/
以指定目录。 -
否定模式: 在模式前添加
!
以否定(取消忽略)先前忽略的模式。 -
注释: 在行首添加
#
以添加注释。
示例
.clineignore
文件:# 忽略日志文件 *.log # 忽略整个'node_modules'目录 node_modules/ # 忽略'temp'目录及其子目录中的所有文件 temp/** # 但不要忽略根目录中的'important.log' !important.log # 忽略任何子目录中名为'secret.txt'的文件 **/secret.txt
-
-
Cline尊重您的
.clineignore
: 一旦您保存了.clineignore
文件,Cline将自动识别并应用这些规则。- 文件访问控制: Cline将无法使用
read_file
等工具读取被忽略文件的内容。如果您尝试在忽略的文件上使用工具,Cline将告知您由于.clineignore
设置,访问被阻止。 - 文件列表: 当您要求Cline列出目录中的文件时(例如使用
list_files
),被忽略的文件和目录仍会被列出,但它们旁边会标记一个🔒符号,表示它们被忽略。这有助于您了解Cline可以和不与之交互的文件。
- 文件访问控制: Cline将无法使用
-
动态更新: Cline会监控您的
.clineignore
文件的更改。如果您修改、创建或删除.clineignore
文件,Cline将自动更新其忽略规则,而无需重新启动VS Code或扩展。
总结
.clineignore
文件提供了一种强大而灵活的方式来控制Cline对工作区文件的访问,增强了隐私、性能和上下文管理。通过利用熟悉的.gitignore
语法,您可以轻松地将Cline的注意力集中在项目中最相关的部分。