小塔 (中文AI编程助手) 🗼

1、简介

小塔是一个AI编程助手，以 vscode 扩展的方式使用，基于 Cline 和 Cline-Chinese 开发，针对中文用户的使用场景进行了优化开发，主要改进点包括：

用户界面、提示语使用中文，阅读起来更亲切和容易。
支持自定义多个模型厂商、每个厂商可以定义多个模型。
多台设备共享配置。可以用微信扫码登录，登录后可以同步用户的设置。数据加密后保存在国内的云服务器上，中文用户访问快速、数据安全有保障。而且加密、解密过程都在本地进行，数据不会泄露到云端。云端只存放加密后的数据，且秘钥只存放在本地，需要牢记。
将国内大语言模型厂商作为首选。
支持使用代理服务器访问海外AI模型厂商的API，而 Cline 使用代理服务器时会出错。
模型的费用以人民币作为单位计算和显示，更符合中文习惯。
可以读写GB18030等非UTF-8编码的文件，而 Cline 等只能读取UTF-8编码的文件。对中文项目更友好，例如一些C++项目的文件就需要是GB18030字符编码的，而这是 Cline 所不支持的。
支持读写"多根工作区（Multi-root Workspace）"。小塔支持访问工作空间(Workspace)下的多个根目录，一个根目录就是一个项目，这些根目录项目是用 "File > Add Folder to Workspace" 菜单项添加的。Cline 只能访问第一个根目录，小塔可以访问工作空间下全部的项目。这对于包含多个根目录的复杂工作空间非常有用，比如可以让 AI 对比两个项目。
对话界面优化：将推理内容默认展开，这样可以更快看到模型反馈的内容，了解模型的思考过程。
支持生成 git 提交消息，且对“多根目录的工作空间”支持良好，而 Cline 对“多根目录工作空间”的支持不好。

点击 'source control' 界面中git提交信息输入框上方的‘塔形’图标就可以用小塔自动生成 git 提交信息了。

小塔支持多根工作区（Multi-root Workspace），这种情况下可能有多个 Git 仓库在同一个 VS Code 窗口中打开。小塔能正确根据按钮所属的 git 仓库生成提交信息并填入正确的消息输入框。

也可以使用 Ctrl+Alt+G 快捷键触发生成git提交消息的命令。
可以显示大模型 API 的响应速度，即每秒输出多少Tokens，方便对比不同API的性能。

小塔的使命是服务好中文用户，所以将 DeepSeek、阿里千问等中文大模型厂商的 API 作为首选，支持自定义多个模型厂商、每个厂商可以定义多个模型。

同时，小塔还会不断加入 Cline 没有的功能，不断创新、进步。

2、使用说明

使用小塔需要有 DeepSeek 或者阿里百炼等模型厂商的 API Key。可以在 DeepSeek 开放平台和阿里百炼注册账号获取。

要添加自定义模型时，可以参考下面的模型信息：

阿里百炼的模型列表
硅基流动的模型列表(含邀请码) 注意：硅基流动的API的基础url是 https://api.siliconflow.cn/v1 而不是 https://api.siliconflow.cn/v1/chat/completions。

如果您有更便宜、更好用的模型，欢迎通过提issue推荐，我们会添加到这里。

下面是一些功能的具体使用说明。

2.1 读取GB18030字符编码文件的方法

小塔在读取文件时会遵循 vscode 编辑器打开文件时所使用的字符编码。vscode 打开文件的字符编码默认是 UTF-8 编码，但也可以指定文件的字符编码，具体方法是：

方法一，指定整个workspace的默认编码在工作空间的设置文件 .vscode/settings.json 中添加 files.encoding 设置，这样可以指定整个工作区的默认编码。它会影响工作区中所有文件打开时使用的字符编码。
方法二，指定某种语言的编码在工作空间的设置文件 .vscode/settings.json 中添加 [cpp]:{"files.encoding": "utf8"} 设置，指定具体语言文件的字符编码。下面的示例中，我们将一个 C++ 项目的全局编码设置为 GB18030，然后将项目下的 html 文件设置为 utf8 编码，完整的settings.json设置是：

{
   "files.encoding": "GB18030", // 工作区的默认编码
   "files.associations": {
        "*.html": "html",
    },
   "[html]": {
      "files.encoding": "utf8" // html文件编码设置为 UTF-8
   }
}

这样，小塔就知道用GB18030字符编码读取项目下的所有文件例如.cpp文件，而用utf8字符编码读取 html 文件了。

3、项目地址

本项目文档、问题反馈的地址是 https://gitee.com/terawin/xiaota，欢迎大家star、反馈问题并提出改进建议。

4、反馈与贡献

如果您在使用过程中遇到任何问题，或有任何建议，欢迎提交问题反馈。

5、免责声明

使用风险 软件按原样提供，不提供任何技术支持和承诺，用户在使用过程中可能会遇到的任何问题或风险，开发者不承担任何责任。
数据安全 小塔替换了 Cline 的后端服务，改用国内云服务器实现用户登录、设置同步等功能，让扩展更符合中文用户的安全需求。
许可证 小塔基于 Cline 和 Cline Chinese 开发，但使用商业许可证，不是开源许可证。
- 小塔的许可证是私有协议, 具体请看 LICENSE 文件。
- Cline 和 Cline Chinese 采用 Apache-2.0许可证，具体请看 LICENSE-ApacheV2
- 用户在使用过程中应遵守相关的协议。
免责声明
- 本项目不提供任何明示或暗示的保证，包括但不限于适销性和特定用途适用性的保证。
- 开发者不对任何直接或间接损失负责，包括但不限于利润损失、数据丢失等。
- 用户使用本插件即表示同意承担使用过程中的所有风险。
更新和维护
- 开发者将努力维护本项目，但不保证及时更新或修复所有问题。
- 本项目可能随时变更或终止，会及时同步到本项目中。

6、开发者介绍

我们致力于开发AI助理软件，有着丰富的客户端软件开发经验，例如 vscode 插件、JavaFX 客户端开发技术等。希望小塔能帮助中文用户不断提高开发效率。

在开发小塔的过程中，我们还开发了一项高级的 vscode扩展调试技术，可以调试、热重载 vscode 的 webview 内容，提高 vscode 扩展开发速度，我们称之为“高级扩展DEBUG技术（ADET，Advanced Debug Extension Technology）”。使用该技术可以在 vscode 扩展开发过程中，自动热重载 webview 中 react 的变化，而不需要重新启动、刷新整个扩展，这样可以提高开发效率，让开发过程更流畅。

小塔AI助手

TeraWinCN