Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add cline #78

Merged
merged 3 commits into from
Jan 15, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,11 @@ English/[简体中文](https://github.com/deepseek-ai/awesome-deepseek-integrati
<td> <a href="https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/continue/README.md"> Continue </a> </td>
<td> Continue is an open-source autopilot in IDE </td>
</tr>
<tr>
<td> <img src="https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/cline/assets/favicon.png?raw=true" alt="Icon" width="64" height="auto" /> </td>
<td> <a href="https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/cline/README.md"> Cline </a> </td>
<td> Meet Cline, an AI assistant that can use your CLI aNd Editor. </td>
</tr>
</table>

### neovim Extensions
Expand Down
5 changes: 5 additions & 0 deletions README_cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,6 +132,11 @@
<td> <a href="https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/continue/README_cn.md"> Continue </a> </td>
<td> 开源 IDE 插件,使用 LLM 做你的编程助手 </td>
</tr>
<tr>
<td> <img src="https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/cline/assets/favicon.png?raw=true" alt="Icon" width="64" height="auto" /> </td>
<td> <a href="https://github.com/deepseek-ai/awesome-deepseek-integration/blob/main/docs/cline/README.md"> Cline </a> </td>
<td> Cline 是一款能够使用您的 CLI 和编辑器的 AI 助手。 </td>
</tr>
</table>

### neovim 插件
Expand Down
49 changes: 49 additions & 0 deletions docs/cline/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# [Cline](https://github.com/cline/cline)

Meet Cline, an AI assistant that can use your CLI aNd Editor.

## Installation

![image](./assets/cline-00.png)

## Key Features of Cline

1. **Agentic Coding with Claude 3.5 Sonnet**: Cline leverages advanced AI capabilities to handle complex software development tasks step-by-step, going beyond simple code completion or tech support.

2. **File and Project Management**: Cline can create, edit, and explore files within large projects, enabling seamless navigation and modification of codebases.

3. **Terminal Integration**: With user permission, Cline can execute terminal commands and monitor their output, allowing it to react dynamically to issues like dev server errors.

4. **Browser Automation**: For web development, Cline can launch sites in a headless browser, interact with pages (click, type, scroll), and capture screenshots and console logs to debug runtime errors and visual bugs.

5. **Human-in-the-Loop Safety**: Every file change and terminal command requires user approval via a GUI, ensuring a secure and controlled environment for exploring agentic AI capabilities.

6. **Context-Aware Assistance**: Cline analyzes file structures, source code ASTs, and runs regex searches to understand existing projects, ensuring efficient and relevant assistance without overwhelming the context window.

7. **Proactive Error Handling**: Cline monitors linter/compiler errors and proactively fixes issues like missing imports and syntax errors during file editing.

8. **Model Context Protocol (MCP)**: Cline can extend its own capabilities by creating new tools using the MCP, enabling continuous adaptation to user needs.

9. **Task Completion with Ease**: Once a task is completed, Cline presents results with simple terminal commands (e.g., `open -a "Google Chrome" index.html`), which users can execute with a single click.

## UI

![image](./assets/cline-01.png)

## Integrate with DeepSeek API

![image](./assets/cline-02.png)

## Best practices

1. **Disable Cline's Auto Approve Feature**: It is recommended to disable Cline's Auto Approve feature when using DeepSeek to reduce resource consumption and minimize the risk of lag caused by concurrent multiple requests.

2. **Use Modified Versions of Cline**: For example, Roo-Cline or ALine. These modified versions carry relatively shorter contexts, handle requests more smoothly, and have a higher cache hit rate, which can help save API call costs.

3. **Use DeepSeek with Caution for Large Projects**: For large code projects, it is not recommended to use DeepSeek + Cline. Large projects typically carry a large amount of code context, which can significantly slow down API request processing.

4. **Switch to Other LLM Providers**: It is recommended to switch to other LLM providers when using Cline for a smoother experience.

## Roo Cline

![image](./assets/roocline-00.png)
49 changes: 49 additions & 0 deletions docs/cline/README_cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# [Cline](https://github.com/cline/cline)

Cline 是一款能够使用您的 CLI 和编辑器的 AI 助手。

## 安装

![image](./assets/cline-00.png)

## Cline 的主要特点

1. **基于 Claude 3.5 Sonnet 的智能编码**:Cline 利用先进的 AI 技术,逐步处理复杂的软件开发任务,超越简单的代码补全或技术支持。

2. **文件与项目管理**:Cline 可以创建、编辑和浏览大型项目中的文件,实现无缝的代码库导航和修改。

3. **终端集成**:在用户授权的情况下,Cline 可以执行终端命令并监控其输出,从而动态响应开发服务器错误等问题。

4. **浏览器自动化**:对于 Web 开发,Cline 可以在无头浏览器中启动网站,与页面交互(点击、输入、滚动),并捕获截图和控制台日志,以调试运行时错误和视觉问题。

5. **人机交互安全保障**:每次文件更改和终端命令都需要通过 GUI 获得用户批准,确保在探索智能 AI 功能时提供一个安全可控的环境。

6. **上下文感知辅助**:Cline 分析文件结构、源代码 AST 并运行正则表达式搜索,以理解现有项目,确保在不超出上下文窗口的情况下提供高效且相关的帮助。

7. **主动错误处理**:Cline 监控 linter/编译器错误,并在文件编辑过程中主动修复诸如缺少导入和语法错误等问题。

8. **模型上下文协议 (MCP)**:Cline 可以通过 MCP 创建新工具来扩展其功能,从而持续适应用户需求。

9. **轻松完成任务**:任务完成后,Cline 会以简单的终端命令(例如 `open -a "Google Chrome" index.html`)呈现结果,用户只需点击一下即可执行。

## 用户界面

![image](./assets/cline-01.png)

## 与 DeepSeek API 集成

![image](./assets/cline-02.png)

## 最佳实践

1. **关闭 Cline 的 Auto Approve 功能**:建议在使用 DeepSeek 时,关闭 Cline 的 Auto Approve 功能,以降低资源消耗,降低多请求因并发带来的卡顿风险。

2. **使用 Cline 改版**:例如 Roo-Cline 或 ALine。这些改版携带的上下文相对短,处理请求时表现更为流畅,且缓存命中率更高,可以帮助节省 API 调用成本。

3. **慎用 DeepSeek 处理大型工程**:对于大型代码工程,不建议使用 DeepSeek + Cline。大型工程通常会携带大量代码上下文,会导致 API 请求处理速度明显变慢。

4. **更换其他 LLM 提供商**:建议您在使用 Cline 时,更换其他 LLM 提供商,以获得更流畅的体验。

## Roo Cline

![image](./assets/roocline-00.png)
Binary file added docs/cline/assets/cline-00.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cline/assets/cline-01.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cline/assets/cline-02.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cline/assets/favicon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cline/assets/roocline-00.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.