diff --git a/i18n/zh-CN/code.json b/i18n/zh-CN/code.json index d30fdbc..62950aa 100644 --- a/i18n/zh-CN/code.json +++ b/i18n/zh-CN/code.json @@ -4,7 +4,7 @@ "description": "The title of the fallback page when the page crashed" }, "theme.BackToTopButton.buttonAriaLabel": { - "message": "回到顶部", + "message": "返回顶部", "description": "The ARIA label for the back to top button" }, "theme.blog.archive.title": { @@ -32,31 +32,32 @@ "description": "The ARIA label for the blog posts pagination" }, "theme.blog.post.paginator.newerPost": { - "message": "较新一篇", + "message": "下一篇", "description": "The blog post button label to navigate to the newer/previous post" }, "theme.blog.post.paginator.olderPost": { - "message": "较旧一篇", + "message": "上一篇", "description": "The blog post button label to navigate to the older/next post" }, "theme.tags.tagsPageLink": { "message": "查看所有标签", "description": "The label of the link targeting the tag list page" }, - "theme.colorToggle.ariaLabel.mode.system": { - "message": "system mode", - "description": "The name for the system color mode" - }, +"theme.colorToggle.ariaLabel.mode.system": { + "message": "跟随系统", + "description": "The name for the system color mode" +} +, "theme.colorToggle.ariaLabel.mode.light": { "message": "浅色模式", "description": "The name for the light color mode" }, "theme.colorToggle.ariaLabel.mode.dark": { - "message": "暗黑模式", + "message": "深色模式", "description": "The name for the dark color mode" }, "theme.colorToggle.ariaLabel": { - "message": "切换浅色/暗黑模式（当前为{mode}）", + "message": "切换浅色/深色模式（当前为{mode}）", "description": "The ARIA label for the color mode toggle" }, "theme.docs.DocCard.categoryDescription.plurals": { @@ -68,7 +69,7 @@ "description": "The ARIA label for the breadcrumbs" }, "theme.docs.paginator.navAriaLabel": { - "message": "文件选项卡", + "message": "文档导航", "description": "The ARIA label for the docs pagination" }, "theme.docs.paginator.previous": { @@ -80,23 +81,23 @@ "description": "The label used to navigate to the next doc" }, "theme.docs.tagDocListPageTitle.nDocsTagged": { - "message": "{count} 篇文档带有标签", + "message": "共 {count} 篇文档", "description": "Pluralized label for \"{count} docs tagged\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.docs.tagDocListPageTitle": { - "message": "{nDocsTagged}「{tagName}」", + "message": "标签「{tagName}」 - {nDocsTagged}", "description": "The title of the page for a docs tag" }, "theme.docs.versions.unreleasedVersionLabel": { - "message": "此为 {siteTitle} {versionLabel} 版尚未发行的文档。", + "message": "这是 {siteTitle} {versionLabel} 版本的未发布文档。", "description": "The label used to tell the user that he's browsing an unreleased doc version" }, "theme.docs.versions.unmaintainedVersionLabel": { - "message": "此为 {siteTitle} {versionLabel} 版的文档，现已不再积极维护。", + "message": "这是 {siteTitle} {versionLabel} 版本的文档，已不再维护。", "description": "The label used to tell the user that he's browsing an unmaintained doc version" }, "theme.docs.versions.latestVersionSuggestionLabel": { - "message": "最新的文档请参阅 {latestVersionLink} ({versionLabel})。", + "message": "请查看最新文档 {latestVersionLink} ({versionLabel})。", "description": "The label used to tell the user to check the latest version" }, "theme.docs.versions.latestVersionLinkLabel": { @@ -111,7 +112,7 @@ "description": "The link label to edit the current page" }, "theme.common.headingLinkTitle": { - "message": "{heading}的直接链接", + "message": "{heading}的链接", "description": "Title for link to heading" }, "theme.lastUpdated.atDate": { @@ -147,7 +148,7 @@ "description": "The default label used for the Caution admonition (:::caution)" }, "theme.admonition.danger": { - "message": "危险", + "message": "风险", "description": "The default label used for the Danger admonition (:::danger)" }, "theme.admonition.info": { @@ -179,7 +180,7 @@ "description": "The ARIA label to collapse the sidebar category" }, "theme.NavBar.navAriaLabel": { - "message": "主导航", + "message": "网站地图", "description": "The ARIA label for the main navigation" }, "theme.NotFound.p1": { @@ -191,7 +192,7 @@ "description": "The 2nd paragraph of the 404 page" }, "theme.TOCCollapsible.toggleButtonLabel": { - "message": "本页总览", + "message": "目录", "description": "The label used by the button on the collapsible TOC component" }, "theme.navbar.mobileLanguageDropdown.label": { @@ -239,7 +240,7 @@ "description": "The ARIA label for the sidebar navigation" }, "theme.docs.breadcrumbs.home": { - "message": "主页面", + "message": "主页", "description": "The ARIA label for the home page in the breadcrumbs" }, "theme.docs.sidebar.closeSidebarButtonAriaLabel": { @@ -247,7 +248,7 @@ "description": "The ARIA label for close button of mobile sidebar" }, "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": { - "message": "← 回到主菜单", + "message": "← 返回主菜单", "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)" }, "theme.docs.sidebar.toggleSidebarButtonAriaLabel": { @@ -263,11 +264,11 @@ "description": "The ARIA label and title attribute for expand button of doc sidebar" }, "theme.navbar.mobileDropdown.collapseButton.expandAriaLabel": { - "message": "Expand the dropdown", + "message": "展开下拉菜单", "description": "The ARIA label of the button to expand the mobile dropdown navbar item" }, "theme.navbar.mobileDropdown.collapseButton.collapseAriaLabel": { - "message": "Collapse the dropdown", + "message": "折叠下拉菜单", "description": "The ARIA label of the button to collapse the mobile dropdown navbar item" }, "theme.SearchPage.existingResultsTitle": { @@ -275,7 +276,7 @@ "description": "The search page title for non-empty query" }, "theme.SearchPage.emptyResultsTitle": { - "message": "搜索文档", + "message": "查找文档", "description": "The search page title for empty query" }, "theme.SearchPage.searchContext.everywhere": { @@ -286,11 +287,11 @@ "description": "Pluralized label for \"{count} documents found\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)" }, "theme.SearchPage.noResultsText": { - "message": "没有找到任何文档", + "message": "未找到任何文档", "description": "The paragraph for empty search result" }, "theme.SearchBar.noResultsText": { - "message": "没有找到任何文档" + "message": "未找到任何文档" }, "theme.SearchBar.seeAllOutsideContext": { "message": "查看“{context}”以外的全部结果" @@ -330,11 +331,11 @@ "description": "The text for authors with 0 blog post" }, "theme.contentVisibility.unlistedBanner.title": { - "message": "未列出页", + "message": "未公开页面", "description": "The unlisted content banner title" }, "theme.contentVisibility.unlistedBanner.message": { - "message": "此页面未列出。搜索引擎不会对其索引，只有拥有直接链接的用户才能访问。", + "message": "此页面未公开。搜索引擎无法索引它，只有通过直接链接的用户才能访问。", "description": "The unlisted content banner message" }, "theme.contentVisibility.draftBanner.title": { @@ -350,7 +351,7 @@ "description": "The label of the button to try again rendering when the React error boundary captures an error" }, "theme.common.skipToMainContent": { - "message": "跳到主要内容", + "message": "跳转到主要内容", "description": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation" }, "theme.tags.tagsPageTitle": { @@ -358,3 +359,4 @@ "description": "The title of the tag list page" } } + diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current.json b/i18n/zh-CN/docusaurus-plugin-content-docs/current.json index 85c9236..074af06 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current.json +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current.json @@ -1,62 +1,63 @@ { "version.label": { - "message": "Next", + "message": "下一个", "description": "The label for version current" }, "sidebar.tutorialSidebar.category.Getting Started": { - "message": "Getting Started", + "message": "入门", "description": "The label for category Getting Started in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Using Kilo Code": { - "message": "Using Kilo Code", + "message": "使用 Kilo Code", "description": "The label for category Using Kilo Code in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Basic Features": { - "message": "Basic Features", + "message": "基本功能", "description": "The label for category Basic Features in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Core Concepts": { - "message": "Core Concepts", + "message": "核心概念", "description": "The label for category Core Concepts in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Advanced Usage": { - "message": "Advanced Usage", + "message": "高级用法", "description": "The label for category Advanced Usage in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Customizing Kilo Code": { - "message": "Customizing Kilo Code", + "message": "自定义 Kilo Code", "description": "The label for category Customizing Kilo Code in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Advanced Context Features": { - "message": "Advanced Context Features", + "message": "高级上下文功能", "description": "The label for category Advanced Context Features in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Advanced AI Features": { - "message": "Advanced AI Features", + "message": "高级 AI 功能", "description": "The label for category Advanced AI Features in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Customization": { - "message": "Customization", + "message": "自定义", "description": "The label for category Customization in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Extending Kilo Code": { - "message": "Extending Kilo Code", + "message": "扩展 Kilo Code", "description": "The label for category Extending Kilo Code in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Model Providers": { - "message": "Model Providers", + "message": "模型供应商", "description": "The label for category Model Providers in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Model Context Protocol (MCP)": { - "message": "Model Context Protocol (MCP)", + "message": "模型上下文协议 (MCP)", "description": "The label for category Model Context Protocol (MCP) in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.category.Tools Reference": { - "message": "Tools Reference", + "message": "工具参考", "description": "The label for category Tools Reference in sidebar tutorialSidebar" }, "sidebar.tutorialSidebar.doc.Setup": { - "message": "Setup", + "message": "设置", "description": "The label for the doc item Setup in sidebar tutorialSidebar, linking to the doc getting-started/setting-up" } } + diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/available-tools/codebase-search.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/available-tools/codebase-search.md index 9533c06..b763b70 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/available-tools/codebase-search.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/available-tools/codebase-search.md @@ -1,7 +1,7 @@ # codebase_search :::warning 实验性功能 -`codebase_search` 工具是实验性功能 [代码库索引](/features/codebase-indexing) 的一部分。该功能正在积极开发中，可能在未来的版本中有重大变化。它需要额外的设置，包括嵌入提供程序和向量数据库。 +`codebase_search` 工具需要额外的设置，包括嵌入提供程序和向量数据库。 ::: `codebase_search` 工具使用 AI 嵌入在整个代码库中执行语义搜索。与传统的基于文本的搜索不同，它能理解查询的含义，即使没有完全匹配的关键字，也能找到相关的代码。 @@ -60,28 +60,33 @@ 当调用 `codebase_search` 工具时，它会遵循以下过程： 1. **可用性验证**： + - 验证 CodeIndexManager 是否可用并已初始化 - 确认设置中已启用代码库索引 - 检查索引是否正确配置（API 密钥、Qdrant URL） - 验证当前索引状态是否允许搜索 2. **查询处理**： + - 获取你的自然语言查询并生成嵌入向量 - 使用为索引配置的相同嵌入提供程序（OpenAI 或 Ollama） - 将查询的语义转换为数学表示 3. **向量搜索执行**： + - 在 Qdrant 向量数据库中搜索相似的代码嵌入 - 使用余弦相似度查找最相关的代码块 - 应用最小相似度阈值（0.4）以过滤结果 - 将结果限制为 50 个匹配项以优化性能 4. **路径过滤**（如果指定）： + - 过滤结果，仅包括指定目录路径中的文件 - 使用标准化路径比较以进行准确过滤 - 在过滤范围内保持相关性排序 5. **结果处理和格式化**： + - 将绝对文件路径转换为工作区相对路径 - 使用文件路径、行范围、相似度分数和代码内容构建结果 - 格式化为 AI 使用和 UI 显示，并带有语法高亮 @@ -184,10 +189,10 @@ ## 使用示例 -当 Kilo Code 实现新功能时，搜索 "身份验证中间件" 以在编写新代码之前了解现有模式。 -当调试问题时，Kilo Code 搜索 "API 调用中的错误处理" 以查找代码库中相关的错误模式。 -当重构代码时，Kilo Code 搜索 "数据库事务模式" 以确保所有数据库操作的一致性。 -当加入新代码库时，Kilo Code 搜索 "配置加载" 以了解应用程序如何引导。 +- 当 Kilo Code 实现新功能时，搜索 "身份验证中间件" 以在编写新代码之前了解现有模式。 +- 当调试问题时，Kilo Code 搜索 "API 调用中的错误处理" 以查找代码库中相关的错误模式。 +- 当重构代码时，Kilo Code 搜索 "数据库事务模式" 以确保所有数据库操作的一致性。 +- 当加入新代码库时，Kilo Code 搜索 "配置加载" 以了解应用程序如何引导。 ## 使用示例 @@ -232,4 +237,4 @@ 环境变量和应用程序配置 -``` \ No newline at end of file +``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-instructions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-instructions.md index 850154a..4576ed3 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-instructions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-instructions.md @@ -40,4 +40,4 @@ - [自定义模式](/features/custom-modes) - [自定义规则](/advanced-usage/custom-rules) - [设置管理](/features/settings-management) -- [自动批准设置](/features/auto-approving-actions) \ No newline at end of file +- [自动批准设置](/features/auto-approving-actions) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-rules.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-rules.md index d6e677c..89366d0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-rules.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/custom-rules.md @@ -4,11 +4,7 @@ ## 概述 -自定义规则允许你创建基于文本的指令，所有 AI 模型在与你的项目交互时都会遵循这些规则。这些规则充当护栏和约定，确保与代码库的所有交互都保持一致。 - -:::info 自定义规则与指令的区别 -自定义规则是项目特定的，允许你设置基于工作区的规则集。对于 IDE 范围的配置，[自定义指令](/advanced-usage/custom-instructions.md) 将是更好的选择，因为它们会保持你的偏好，无论你正在处理哪个项目。 -::: +自定义规则允许您创建文本指令，所有 AI 模型在与您的项目交互时都将遵循这些指令。这些规则充当护栏和约定，在与您的代码库的所有交互中始终得到遵守。规则可以通过文件系统和内置 UI 界面进行管理。 ## 规则格式 @@ -18,8 +14,21 @@ - 使用列表（`-`, `*`）枚举特定项目或约束 - 使用代码块（``` ```）在需要时包含代码示例 +## 规则类型 + +Kilo Code 支持两种类型的自定义规则： + +- **项目规则**：仅适用于当前项目工作区 +- **全局规则**：适用于所有项目和工作区 + +:::note UI 支持 +内置规则管理 UI 仅适用于一般规则。模式特定规则必须通过文件系统进行管理。 +::: + ## 规则位置 +### 项目规则 + 自定义规则主要从 **`.kilocode/rules/` 目录** 加载。这是组织项目特定规则的推荐方法。每个规则通常放置在具有描述性名称的 Markdown 文件中： ``` @@ -37,17 +46,16 @@ project/ ### 通用规则（所有模式） -为了向后兼容，如果没有找到规则文件夹，代理将检查其他位置。 +规则按以下优先级顺序加载： -加载顺序如下： +1. 存放在 `~/.kilocode/rules/` 目录的**全局规则** +2. 存放在 `.kilocode/rules/` 目录的**项目规则** +3. **旧版回退文件**（为了向后兼容）： + - `.roorules` + - `.clinerules` + - `.kilocoderules`（已弃用） -1. 首先尝试从 `.kilocode/rules/` 目录加载 -2. 如果该目录不存在或为空，则回退检查以下文件： - - `.roorules` - - `.clinerules` - - `.kilocoderules`（已弃用） - -代理使用找到的第一个包含内容的来源。例如，如果找到了包含内容的 `.roorules`，则不会读取 `.clinerules`。 +当全局规则和项目规则都存在时，它们将合并，存在冲突时项目规则优先于全局规则。 :::note 我们强烈建议将规则保留在 `.kilocode/rules/` 文件夹中，因为它提供了更好的组织，并且是未来版本的首选方法。基于文件夹的结构允许更细粒度的规则组织和更清晰的关注点分离。基于文件的旧方法为了向后兼容而保留，但可能会在未来的版本中发生变化。 @@ -60,17 +68,38 @@ project/ 1. 首先检查 `.kilocode/rules-${mode}/` 目录 2. 如果该目录不存在或为空，则回退到 `.kilocoderules-${mode}` 文件（已弃用） +目前，模式特定规则仅在项目级别受支持。 当通用规则和模式特定规则同时存在时，模式特定规则在最终输出中具有优先权。 ## 创建自定义规则 -要创建自定义规则： +### 使用 UI 界面 + +Kilo Code 中的规则选项卡 + +创建和管理规则的最简单方法是通过内置 UI： + +1. 从 Kilo Code 面板访问规则管理界面 +2. 选择创建项目特定规则或全局规则 +3. 使用界面创建、编辑或切换规则 +4. 规则会自动保存并立即应用 +### 使用文件系统 + +手动创建规则： + +**对于项目规则：** 1. 如果不存在，请创建 `.kilocode/rules/` 目录 2. 在此目录中创建一个具有描述性名称的新 Markdown 文件 3. 使用 Markdown 格式编写你的规则 4. 保存文件 +**对于全局规则：** +1. 如果 `~/.kilocode/rules/` 目录尚不存在，则创建它 +2. 在此目录中创建一个新的 Markdown 文件，并带有描述性名称 +3. 使用 Markdown 格式编写您的规则 +4. 保存文件 + 该规则将自动应用于你项目中所有未来的 Kilo Code 交互。任何新更改都会立即生效。 ## 规则示例 @@ -136,9 +165,10 @@ project/ ## 限制 -- 规则由 AI 模型尽力而为地应用 +- 规则由 AI 模型尽力应用 - 复杂规则可能需要多个示例才能清晰理解 -- 规则仅适用于定义它们的项目 +- 项目规则仅适用于定义它们的项目 +- 全局规则适用于所有项目 ## 故障排除 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/local-models.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/local-models.md index 441f57f..5321bb1 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/local-models.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/advanced-usage/local-models.md @@ -32,5 +32,7 @@ Kilo Code 目前支持两个主要的本地模型提供商： ## 故障排除 * **“由于目标计算机主动拒绝，无法建立连接”**：这通常意味着 Ollama 或 LM Studio 服务器未运行，或者 Kilo Code 配置的端口/地址与服务器不一致。请仔细检查 Base URL 设置。 + * **响应时间慢**：本地模型可能比云端模型慢，尤其是在硬件性能较低的情况下。如果遇到性能问题，请尝试使用较小的模型。 -* **找不到模型**：请确保你正确输入了模型名称。如果使用 Ollama，请使用与 `ollama run` 命令中相同的名称。 \ No newline at end of file + +* **找不到模型**：请确保你正确输入了模型名称。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/connecting-providers.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/connecting-providers.md new file mode 100644 index 0000000..42a9e63 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/connecting-providers.md @@ -0,0 +1,71 @@ +--- +sidebar_label: Overview +--- + +# API 提供商概述 + +**总结**：Kilo Code，像任何代理 AI 编码工具一样，需要 AI 模型提供商才能运行。您可以使用我们的[内置提供商](/providers/kilocode)（最简单）或连接来自 **30 多个提供商**的您自己的 API 密钥。 + +## Kilo Code 扩展与 API 提供商 + +### 扩展 +- 您从市场安装的 VS Code 工具 +- 处理 UI、文件操作和工作流管理 +- [开源](https://github.com/Kilo-Org/kilocode) +- 连接到任何 AI 提供商 + +### Kilo Code API 提供商 +- **内置选项**，随扩展一起提供 +- 包含免费积分的 Google 登录 +- 无需 API 密钥管理 +- 访问前沿编码模型 +- [有竞争力的定价](https://kilocode.ai/pricing) + +**关键点**：该扩展适用于任何提供商——我们的 API 服务只是“包含电池”的选项。 + +## 入门：两条路径 + +### 选项 1：内置提供商（推荐） +✅ **最快设置** +- 在 kilocode.ai 使用 Google 登录 +- 包含免费积分 +- 零 API 密钥管理 +- 提供最新模型 + +→ [完整设置指南](/providers/kilocode) + +### 选项 2：您自己的提供商 +**更多控制，更多设置** +1. 从 30 多个受支持的提供商中选择 +2. 从您的提供商处获取 API 密钥 +3. 在 Kilo Code 设置中配置 + +## 为什么要使用多个提供商？ + +- **成本**：比较不同提供商的定价 +- **模型**：访问不同的 AI 功能 +- **可靠性**：停机时的备份选项 +- **功能**：某些提供商提供独家模型 +- **区域**：在某些位置提供更好的性能 + +## 本节内容 + +### [连接您的第一个 AI 提供商](/getting-started/connecting-api-provider) +**面向初学者**：分步设置，包括： +- 推荐的提供商 +- 如何获取 API 密钥 +- 初始 VS Code 配置 +- 开始您的第一个 AI 聊天 + +### [API 配置配置文件](/features/api-configuration-profiles) +**面向高级用户**：高级管理，包括： +- 多个提供商配置 +- 模型切换策略 +- 安全的 API 密钥管理 +- 任务特定优化 + +## 安全注意事项 + +所有 API 密钥都使用 VS Code 的 Secret Storage——从不以纯文本形式存储。行业标准的安全实践保护您的凭据。 + +**准备好开始了吗？** → [连接您的第一个提供商](/getting-started/connecting-api-provider)或跳转到[高级配置文件](/features/api-configuration-profiles)。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/context-mentions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/context-mentions.md index 8e59536..fd04eca 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/context-mentions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/context-mentions.md @@ -28,13 +28,13 @@ *文件提及结合行号引用源代码，以便精确定位。* -| 能力 | 详情 | -|------------|---------| -| **格式** | `@/path/to/file.ts`（始终从工作区根目录开始使用 `/`） | -| **提供** | 包含行号的完整文件内容 | -| **支持** | 文本文件、PDF 和 DOCX 文件（带文本提取） | +| 功能 | 详情 | +|----------|---------| +| **格式** | `@/path/to/file.ts`（始终从工作区根目录开始使用 `/`） | +| **提供** | 包含行号的完整文件内容 | +| **支持** | 文本文件、PDF 和 DOCX 文件（带文本提取） | | **适用场景** | 初始请求、反馈响应和后续消息 | -| **限制** | 非常大的文件可能会被截断；不支持二进制文件 | +| **限制** | 非常大的文件可能会被截断；不支持二进制文件 | ### 文件夹提及 @@ -42,7 +42,7 @@ *文件夹提及以可读的树状格式显示目录结构。* -| 能力 | 详情 | +| 功能 | 详情 | |------------|---------| | **格式** | `@/path/to/folder/`（注意尾部的斜杠） | | **提供** | 使用 ├── 和 └── 前缀的分层树状显示 | @@ -56,7 +56,7 @@ *问题提及直接从 VS Code 的问题面板导入诊断信息。* -| 能力 | 详情 | +| 功能 | 详情 | |------------|---------| | **格式** | `@problems` | | **提供** | VS Code 问题面板中的所有错误和警告 | @@ -69,7 +69,7 @@ *终端提及捕获最近的命令输出以便调试和分析。* -| 能力 | 详情 | +| 功能 | 详情 | |------------|---------| | **格式** | `@terminal` | | **捕获** | 最后一条命令及其完整输出 | @@ -93,7 +93,7 @@ *URL 提及导入外部网页内容并将其转换为可读的 Markdown 格式。* -| 能力 | 详情 | +| 功能 | 详情 | |------------|---------| | **格式** | `@https://example.com` | | **处理** | 使用无头浏览器获取内容 | diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/git-commit-generation.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/git-commit-generation.md new file mode 100644 index 0000000..e3a4919 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/git-commit-generation.md @@ -0,0 +1,146 @@ +# 生成提交消息 + +根据您暂存的 git 更改自动生成描述性提交消息。Kilo Code 会分析您暂存的文件并创建遵循最佳实践的约定式提交消息。 + +:::info +此功能仅分析**暂存的更改**。在生成提交消息之前，请务必使用 `git add` 或通过 `VS Code` 界面暂存您的文件。 +::: + +## 工作原理 + +git 提交消息生成器： +- 仅分析您的**暂存更改**（未暂存或未跟踪的文件） +- 使用 AI 理解更改的上下文和目的 +- 创建描述性提交消息，解释更改了什么以及为什么遵循[约定式提交](https://www.conventionalcommits.org/)（默认情况下，可自定义） + +## 使用功能 + +### 生成提交消息 + +1. 使用 `git add` 或 VS Code git 界面暂存您的更改 +2. 在 VS Code 源代码管理面板中，查找提交消息字段旁边的 `Kilo Code` 徽标) +3. 单击徽标以生成提交消息 + + +生成的邮件将出现在提交消息字段中，您可以根据需要进行审查和修改。 + +生成的提交消息示例 + +### 约定式提交格式 + +默认情况下，生成的邮件遵循约定式提交规范： + +``` +(): + + +``` + +常见类型包括： +- `feat`：新功能 +- `fix`：错误修复 +- `docs`：文档更改 +- `style`：代码样式更改（格式等） +- `refactor`：代码重构 +- `test`：添加或更新测试 +- `chore`：维护任务 + +## 配置 + +### 自定义提交模板 + +您可以通过修改提示模板来自定义提交消息的生成方式： + +1. 单击齿轮图标 → `Prompts` 打开设置 +2. 找到“提交消息生成”部分 +3. 编辑 `Prompt` 模板以匹配您项目的约定 + +提交消息生成设置 + +默认模板创建约定式提交消息，但您可以修改它以： +- 使用不同的提交消息格式 +- 包含与您的项目相关的特定信息 +- 遵循您团队的提交消息约定 +- 为 AI 添加自定义指令 + +### API 配置 + +您可以配置用于提交消息生成的 API 配置文件： + +1. 在 `Prompts` 设置中，滚动到“API 配置” +2. 选择特定配置文件或使用当前选定的配置文件 + +:::tip +考虑创建一个专用的 [API 配置配置文件](/features/api-configuration-profiles)，其中包含更快、更具成本效益的模型，专门用于提交消息生成。 +::: + +## 最佳实践 + +### 暂存策略 +- 将相关更改一起暂存，以获得更连贯的提交消息 +- 避免在单个提交中暂存不相关的更改 +- 需要时使用 `git add -p` 进行部分文件暂存 + +### 消息审查 +- 始终在提交前审查生成的邮件 +- 编辑邮件以添加 AI 可能遗漏的上下文 +- 确保邮件准确描述更改 + +### 自定义模板 +- 根据您的项目需求定制提示模板 +- 包含项目特定的术语或约定 +- 添加处理特定类型更改的说明 + +## 生成的示例消息 + +以下是该功能可能生成的消息示例： + +``` +feat(auth): add OAuth2 integration with Google + +Implement Google OAuth2 authentication flow including: +- OAuth2 client configuration +- User profile retrieval +- Token refresh mechanism +``` + +``` +fix(api): resolve race condition in user data fetching + +Add proper error handling and retry logic to prevent +concurrent requests from causing data inconsistency +``` + +``` +docs(readme): update installation instructions + +Add missing dependency requirements and clarify +setup steps for new contributors +``` + +## 故障排除 + +### 没有暂存的更改 +如果按钮未出现或生成失败，请确保您已暂存更改： +```bash +git add +# 或暂存所有更改 +git add . +``` + +### 消息质量差 +如果生成的邮件没有帮助： +- 审查您的暂存策略 - 不要将不相关的更改一起暂存 +- 使用更具体的指令自定义提示模板 +- 通过 API 配置尝试不同的 AI 模型 + +### 集成问题 +该功能与 VS Code 的内置 git 功能集成。如果您遇到问题： +- 确保您的存储库已正确初始化 +- 检查 VS Code 是否可以访问您的 git 存储库 +- 验证 git 是否已安装并可从 VS Code 访问 + +## 相关功能 + +- [API 配置配置文件](/features/api-configuration-profiles) - 使用不同的模型进行提交生成 +- [设置管理](/features/settings-management) - 管理您的所有 Kilo Code 首选项 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/task-todo-list.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/task-todo-list.md new file mode 100644 index 0000000..4860440 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/task-todo-list.md @@ -0,0 +1,93 @@ +# 任务待办事项列表 + +**大局**：再也不会丢失复杂的开发任务。任务待办事项列表创建交互式、持久的清单，直接显示在您的聊天界面中。 + +**为什么重要**：复杂的工作流程有很多移动部件。如果没有结构，很容易遗漏步骤、重复工作或忘记下一步是什么。 + +任务待办事项列表概述，显示 Kilo Code 中的交互式清单 + +## 如何触发待办事项列表 + +**自动触发**： +- 包含多个步骤的复杂任务 +- 在 Architect 模式下工作 +- 具有依赖关系的多阶段工作流 + +**手动触发**： +- 要求 Kilo“使用 [update_todo_list 工具](/features/tools/update-todo-list)” +- 说“创建待办事项列表” + +**底线**：Kilo 决定列表中包含什么，但您可以在批准对话框中提供反馈。 + +--- + +## 旧方式与新方式 + +**以前**：您在脑海中或分散的笔记中处理任务步骤，不断思考“下一步是什么？” + +**现在**：Kilo 创建结构化清单，随着工作的进展自动更新。您清楚地知道自己所处的位置以及接下来要做什么。 + +--- + +## 待办事项列表出现的位置 + +**1. 任务标题摘要** +快速进度概览，显示您的下一个重要事项 + +任务标题摘要显示待办事项列表进度 + +**2. 交互式工具块** +聊天中的完整待办事项界面，您可以在其中： +- 查看所有项目及其状态 +- 当 Kilo 请求批准时编辑描述 +- 使用“编辑”按钮暂存更改 + +**3. 环境详细信息** +后台“提醒”表，让 Kilo 了解当前进度 + +## 任务状态解读 + +**待处理** → 空复选框（未开始） + +待处理待办事项，带空复选框 + +--- + +**进行中** → 黄点（当前正在工作） + +进行中待办事项，带黄点指示器 + +--- + +**已完成** → 绿勾（已完成） + +已完成待办事项，带绿勾 + +--- + +## 常见问题 + +**“可以创建自己的待办事项列表吗？”** +是的，只需要求 Kilo 使用 update_todo_list 工具。但 Kilo 仍控制内容和工作流。 + +**“简单的任务怎么办？”** +Kilo 通常会跳过简单任务的待办事项列表。开销不值得。 + +**“为什么不能直接编辑列表？”** +设计选择。Kilo 保持对任务管理的控制，以确保一致的进度跟踪。您提供输入，Kilo 执行。 + +--- + +:::tip + +## 专业提示：自动批准 + +**作用**：自动批准待办事项列表更新，无需确认提示。 + +**何时使用**：长时间工作流中，持续中断会降低您的速度。 + +**如何启用**：检查[更新待办事项列表自动批准设置](/features/auto-approving-actions#update-todo-list)。 + +**缺点**：控制较少，但执行速度更快。 + +::: \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/the-chat-interface.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/the-chat-interface.md index bc34f1d..e1615f0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/the-chat-interface.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/the-chat-interface.md @@ -1,43 +1,83 @@ import Image from '@site/src/components/Image'; -# 聊天界面 +# 与 Kilo Code 聊天 -Kilo Code 的聊天界面是你与其交互的主要方式。它位于 Kilo Code 面板中，你可以通过点击 VS Code 主侧边栏中的 Kilo Code 图标（）来打开它。 +:::tip -Kilo Code 面板也可以移动到 VS Code 的次侧边栏。如果你不小心关闭了 Kilo Code 面板，可以通过 视图 > 打开视图... 并搜索 "Kilo Code" 来重新打开它。 +**总结：** Kilo Code 是一个 AI 编码助手，它存在于 VS Code 中。您可以用简单的英语与它聊天，它会为您编写、编辑和解释代码。 -## 聊天界面的组成部分 +::: -聊天界面由以下主要元素组成： +## 快速设置 -1. **聊天/任务历史记录：** 该区域显示你与 Kilo Code 之间的对话历史记录，或者如果你没有当前任务，则显示你创建的所有任务的历史记录。它显示你的请求、Kilo Code 的响应以及任何已执行的操作（如文件编辑或命令执行）。 +在 VS Code 的主侧边栏中找到 Kilo Code 图标（）。单击它以打开聊天面板。 -2. **输入框：** 这是你输入任务和问题的地方。你可以使用 [纯英文](/) 来传达你希望 Kilo Code 执行的操作。 +**找不到面板？** 转到“视图”>“打开视图...”并搜索“Kilo Code” -3. **操作按钮：** 这些按钮出现在输入框下方，允许你批准或拒绝 Kilo Code 提出的操作。根据上下文和你的 [自动批准设置](/features/auto-approving-actions)，可用的按钮会有所不同。 +## 如何与 Kilo Code 对话 -4. **发送按钮：** 这是一个小飞机图标，位于输入框的最右侧。在你输入消息后，点击此按钮即可发送消息。或者，你可以直接按 `Enter` 键。 +**关键见解：** 只需用普通英语输入您想要的内容。无需特殊命令。 -5. **加号按钮：** 加号按钮位于顶部的标题栏中，用于启动一个新的任务会话。 +在 Kilo Code 中输入请求的示例 -6. **设置按钮：** 设置按钮是一个齿轮图标，用于打开设置以自定义功能或行为。 +**好的请求：** -7. **模式选择器：** 模式选择器是一个下拉菜单，位于聊天输入框的左侧。它用于选择 Kilo Code 执行任务时使用的模式。 +``` +创建一个名为 utils.py 的新文件，并添加一个名为 add 的函数，该函数接受两个数字作为参数并返回它们的和 +``` + +``` +在文件 @src/components/Button.tsx 中，将按钮的颜色更改为蓝色 +``` + +``` +在 @/src/App.js 中查找变量 oldValue 的所有实例，并将其替换为 newValue +``` + +**使请求生效的因素：** +- **具体** - “修复 `calculateTotal` 中返回不正确结果的错误”胜过“修复代码” +- **使用 @ 提及** - 使用 `@filename` 直接引用文件和代码 +- **一次一个任务** - 将复杂工作分解为可管理的步骤 +- **包含示例** - 显示您想要的样式或格式 + + +## 聊天界面 聊天界面组件标注 -## 与消息交互 +**基本控件：** +- **聊天历史记录** - 查看您的对话和任务历史记录 +- **输入字段** - 在此处输入您的请求（按 Enter 发送） +- **操作按钮** - 批准或拒绝 Kilo 的提议更改 +- **加号按钮** - 开始新的任务会话 +- **模式选择器** - 选择 Kilo 应如何处理您的任务 + +## 快速交互 + +**点击操作：** +- 文件路径 → 打开文件 +- URL → 在浏览器中打开 +- 消息 → 展开/折叠详细信息 +- 代码块 → 出现复制按钮 + +**状态信号：** +- 旋转 → Kilo 正在工作 +- 红色 → 发生错误 +- 绿色 → 成功 + +## 需要避免的常见错误 -* **可点击的链接：** 聊天历史记录中的文件路径、URL 和其他提及内容是可点击的。点击文件路径将在编辑器中打开该文件。点击 URL 将在默认浏览器中打开它。 -* **复制文本：** 你可以通过选择文本并使用标准复制命令（`Ctrl/Cmd + C`）来复制聊天历史记录中的文本。某些元素（如代码块）具有专用的“复制”按钮。 -* **展开和折叠：** 点击消息以展开或折叠它。 +| 替代这个... | 尝试这个 | +|----------------|----------| +| "Fix the code" | "修复 `calculateTotal` 中返回不正确结果的错误" | +| 假设 Kilo 知道上下文 | 使用 `@` 引用特定文件 | +| 多个不相关的任务 | 一次提交一个重点突出的请求 | +| 技术术语过多 | 清晰、直接的语言效果最好 | -## 状态指示器 +**重要的原因：** 当您像与需要明确指导的聪明队友交谈一样进行交流时，Kilo Code 的效果最佳。 -* **加载旋转器：** 当 Kilo Code 正在处理请求时，你会看到一个加载旋转器。 -* **错误消息：** 如果发生错误，将显示一条红色错误消息。 -* **成功消息：** 绿色消息表示操作已成功完成。 \ No newline at end of file +准备好开始编码了吗？打开聊天面板并描述您想要构建的内容！ \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/typing-your-requests.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/typing-your-requests.md deleted file mode 100644 index c2578a9..0000000 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/basic-usage/typing-your-requests.md +++ /dev/null @@ -1,49 +0,0 @@ -import Image from '@site/src/components/Image'; - -# 输入你的请求 - -Kilo Code 设计为理解自然语言。你不需要使用任何特殊命令或语法来与其交流。只需用简单的英语输入你的请求，就像与人类开发者对话一样。 - -在 Kilo Code 中输入请求的示例 - -## 有效的请求策略 - -清晰地表达你希望 Kilo Code 执行的操作。避免使用模糊或模棱两可的语言。 - -| 策略 | 实现 | -|----------|----------------| -| **具体明确** | 使用“修复 `calculateTotal` 中返回错误结果的 bug”而不是“修复代码” | -| **提供上下文** | 使用 `@` [上下文提及](/basic-usage/context-mentions) 来引用文件和代码 | -| **分解任务** | 将复杂任务拆分为更小、可管理的步骤 | -| **包含示例** | 当需要特定格式或样式时，提供示例代码（或使用 `@` 引用现有代码） | - -## 示例请求 - -``` -创建一个名为 `utils.py` 的新文件，并添加一个名为 `add` 的函数，该函数接受两个数字作为参数并返回它们的和 -``` -``` -在文件 @src/components/Button.tsx 中，将按钮的颜色更改为蓝色 -``` -``` -在 @/src/App.js 中找到所有变量 `oldValue` 的实例，并将它们替换为 `newValue` -``` -``` -在终端中运行命令 `npm install` -``` -``` -解释 @/src/utils.ts 中的函数 `calculateTotal` -``` -``` -@problems 解决所有检测到的问题 -``` - -## 需要避免的常见错误 - -| 不要 | 应该 | -|-------|---------| -| 模糊的请求 | 明确指定需要完成的操作 | -| 假设上下文 | 明确引用文件和函数 | -| 过多的技术术语 | 使用清晰、直接的语言 | -| 多个不相关的任务 | 一次提交一个专注的请求 | -| 未经确认就继续 | 检查代码以确保其完整 | \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/api-configuration-profiles.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/api-configuration-profiles.md index 872e3e1..724222a 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/api-configuration-profiles.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/api-configuration-profiles.md @@ -1,92 +1,97 @@ -# API 配置档案 +# API 配置配置文件 -API 配置档案允许你创建和切换不同的 AI 设置集合。每个档案可以为每个模式配置不同的设置，让你根据任务优化使用体验。 +API 配置配置文件允许您创建和切换不同的 AI 设置集。每个配置文件可以为每种模式设置不同的配置，让您根据手头的任务优化您的体验。 :::info -拥有多个配置档案可以让你快速在不同 AI 提供商、模型和设置之间切换，而无需每次更改设置时重新配置所有内容。 +拥有多个配置配置文件可以让您快速切换不同的 AI 提供商、模型和设置，而无需每次更改设置时都重新配置所有内容。 ::: - ## 工作原理 -配置档案可以包含以下内容： +配置配置文件可以拥有自己的： - API 提供商（OpenAI、Anthropic、OpenRouter、Glama 等） -- API 密钥和认证信息 +- API 密钥和身份验证详细信息 - 模型选择（o3-mini-high、Claude 3.7 Sonnet、DeepSeek R1 等） -- [温度设置](/features/model-temperature)，用于控制响应随机性 -- 思考预算 -- 提供商特定设置 +- [温度设置](/features/model-temperature)用于控制响应随机性 +- 思维预算 +- 特定于提供商的设置 -请注意，可用设置因提供商和模型而异。每个提供商提供不同的配置选项，即使在同一提供商中，不同模型也可能支持不同的参数范围或功能。 +请注意，可用设置因提供商和模型而异。每个提供商提供不同的配置选项，即使在同一提供商内，不同的模型也可能支持不同的参数范围或功能。 -## 创建和管理档案 +## 创建和管理配置文件 -### 创建档案 +### 创建配置文件 -1. 打开设置，点击齿轮图标 → 提供商 -2. 点击档案选择器旁边的 "+" 按钮 +1. 单击齿轮图标 → Providers 打开设置 +2. 单击配置文件选择器旁边的“+”按钮 - 带有加号按钮的档案选择器 -3. 输入新档案的名称 + 带加号按钮的配置文件选择器 +3. 输入新配置文件的名称 - 创建新档案对话框 -4. 配置档案设置： - - 选择你的 API 提供商 + 创建新配置文件对话框 +4. 配置配置文件设置： + - 选择您的 API 提供商 提供商选择下拉菜单 - - 输入 API 密钥 + - 输入 API 密钥 API 密钥输入字段 - - 选择模型 + - 选择模型 模型选择界面 - - 调整模型参数 + - 调整模型参数 模型参数调整控件 -### 切换档案 +### 切换配置文件 + +通过两种方式切换配置文件： +1. 从设置面板：从下拉菜单中选择不同的配置文件 -切换档案的两种方式： -1. 从设置面板：从下拉菜单中选择不同的档案 + 设置中的配置文件选择下拉菜单 +2. 聊天期间：访问聊天界面中的 API 配置下拉菜单 - 设置中的档案选择下拉菜单 -2. 在聊天过程中：访问聊天界面中的 API 配置下拉菜单 + 聊天界面中的 API 配置下拉菜单 +### 固定和排序配置文件 - 聊天界面中的 API 配置下拉菜单 +API 配置下拉菜单现在支持固定您喜欢的配置文件，以便更快访问： -### 固定和排序档案 +1. 将鼠标悬停在下拉菜单中的任何配置文件上以显示图钉图标 +2. 单击图钉图标将配置文件添加到您的固定列表 +3. 固定配置文件显示在下拉菜单顶部，按字母顺序排序 +4. 未固定配置文件显示在分隔符下方，也按字母顺序排序 +5. 您可以再次单击同一图标以取消固定配置文件 -API 配置下拉菜单现在支持固定常用档案以便快速访问： +固定 API 配置配置文件 -1. 将鼠标悬停在下拉菜单中的任何档案上以显示固定图标 -2. 点击固定图标将档案添加到固定列表 -3. 固定的档案将按字母顺序显示在下拉菜单的顶部 -4. 未固定的档案将显示在分隔符下方，同样按字母顺序排序 -5. 你可以再次点击该图标取消固定档案 +此功能使您更容易在常用配置文件之间导航，尤其是在您有许多配置时。 -固定 API 配置档案 -此功能使你更容易在常用配置之间切换，特别是在你拥有许多配置时。 +### 编辑和删除配置文件 -### 编辑和删除档案 +配置文件编辑界面 +- 在设置中选择配置文件以修改任何设置 +- 单击铅笔图标以重命名配置文件 +- 单击垃圾桶图标以删除配置文件（您不能删除唯一剩余的配置文件） -档案编辑界面 -- 在设置中选择档案以修改任何设置 -- 点击铅笔图标重命名档案 -- 点击垃圾桶图标删除档案（不能删除最后一个档案） +## 将配置文件链接到模式 +在 提示选项卡中，您可以将特定配置配置文件与每个模式明确关联。系统还会自动记住您上次与每个模式一起使用的配置文件，从而提高您的工作效率。 -## 将档案与模式关联 +观看此演示，了解如何将配置配置文件与特定模式连接以优化工作流： -在 提示标签中，你可以显式地将特定配置档案与每个模式关联。系统还会自动记住你上次与每个模式一起使用的档案，从而提高工作效率。 + -提示标签中的档案-模式关联界面 -## 安全提示 +## 安全注意事项 -API 密钥安全地存储在 VSCode 的 Secret Storage 中，永远不会以明文形式暴露。 +API 密钥安全地存储在 VSCode 的 Secret Storage 中，绝不会以纯文本形式公开。 ## 相关功能 -- 与你创建的[自定义模式](/features/custom-modes)配合使用 -- 集成[本地模型](/advanced-usage/local-models)以进行离线工作 +- 适用于您创建的[自定义模式](/features/custom-modes) +- 与[本地模型](/advanced-usage/local-models)集成以进行离线工作 - 支持每个模式的[温度设置](/features/model-temperature) -- 通过[速率限制和使用跟踪](/advanced-usage/rate-limits-costs)增强成本管理 \ No newline at end of file +- 通过[速率限制和使用跟踪](/advanced-usage/rate-limits-costs)增强成本管理 + diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions copy.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions copy.md deleted file mode 100644 index cdc395f..0000000 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions copy.md +++ /dev/null @@ -1,34 +0,0 @@ -# 自动批准操作 - -本文档描述了如何在 Kilo Code 中配置和使用自动批准操作功能。自动批准操作允许用户在特定条件下自动批准某些操作，而无需手动确认。 - -## 启用自动批准操作 - -要启用自动批准操作，请按照以下步骤操作： - -1. 打开 Kilo Code 设置。 -2. 导航到“自动批准”部分。 -3. 启用“自动批准操作”选项。 -4. 配置你希望自动批准的操作类型和条件。 - -## 配置条件 - -你可以配置以下条件来自动批准操作： - -- **操作类型**：选择要自动批准的操作类型（例如，文件修改、命令执行等）。 -- **触发条件**：设置触发自动批准的条件（例如，特定文件路径、命令模式等）。 -- **批准范围**：定义自动批准的范围（例如，当前会话、所有会话等）。 - -## 注意事项 - -- 自动批准操作可能会影响系统的安全性，请谨慎使用。 -- 建议在启用自动批准操作之前，仔细审查配置的条件和范围。 -- 定期检查自动批准操作的日志，确保其按预期工作。 - -## 故障排除 - -如果你遇到自动批准操作无法正常工作的问题，请尝试以下步骤： - -1. 检查设置是否正确配置。 -2. 查看日志文件以获取更多信息。 -3. 如果问题仍然存在，请联系技术支持。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions.md index 9f1b286..813ef2b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/auto-approving-actions.md @@ -1,119 +1,121 @@ # 自动批准操作 -> ⚠️ **安全警告：** 自动批准设置会绕过确认提示，使 Kilo Code 可以直接访问你的系统。这可能导致**数据丢失、文件损坏或其他更严重的后果**。命令行访问尤其危险，因为它可能执行有害操作，损害你的系统或危及安全性。仅对你完全信任的操作启用自动批准。 +> ⚠️ **安全警告：** 自动批准设置会绕过确认提示，使 Kilo Code 直接访问您的系统。这可能导致**数据丢失、文件损坏，甚至更糟**。命令行访问尤其危险，因为它可能执行有害操作，从而损坏您的系统或危及安全。仅对您完全信任的操作启用自动批准。 -自动批准设置通过消除重复的确认提示来加快你的工作流程，但会显著增加安全风险。 +自动批准设置通过消除重复的确认提示来加快您的工作流程，但它们会显著增加安全风险。 ## 快速入门指南 -1. 点击聊天输入框上方的“自动批准工具栏” -2. 选择 Kilo Code 可以无需许可执行的操作 -3. 使用主开关（最左侧的复选框）快速启用/禁用所有权限 +1. 单击聊天输入上方的自动批准工具栏 +2. 选择 Kilo Code 可以执行哪些操作而无需请求权限 +3. 使用主开关（最左侧的复选框）快速启用/禁用所有权限 ## 自动批准工具栏 自动批准工具栏折叠状态 -*提示框和自动批准工具栏，显示已启用的权限* +*提示框和自动批准工具栏显示已启用的权限* -点击工具栏以展开并配置各个权限： +单击工具栏以展开它并配置单个权限： 自动批准工具栏展开状态 -*提示文本框和展开的工具栏，显示所有选项* +*提示文本框和展开的工具栏，包含所有选项* ### 可用权限 -| 权限 | 功能 | 风险等级 | +| 权限 | 作用 | 风险级别 | |------------|--------------|------------| | **读取文件和目录** | 允许 Kilo Code 无需询问即可访问文件 | 中 | | **编辑文件** | 允许 Kilo Code 无需询问即可修改文件 | **高** | | **执行已批准的命令** | 自动运行白名单中的终端命令 | **高** | | **使用浏览器** | 允许无头浏览器交互 | 中 | -| **使用 MCP 服务器** | 允许 Kilo Code 使用配置的 MCP 服务 | 中高 | +| **使用 MCP 服务器** | 允许 Kilo Code 使用配置的 MCP 服务 | 中-高 | | **切换模式** | 自动在 Kilo Code 模式之间切换 | 低 | -| **创建和完成任务** | 无需确认即可管理子任务 | 低 | +| **创建和完成子任务** | 无需确认即可管理子任务 | 低 | | **重试失败的请求** | 自动重试失败的 API 请求 | 低 | +| **回答后续问题** | 为后续问题选择默认答案 | 低 | +| **更新待办事项列表** | 自动更新任务进度 | 低 | -## 主开关快速控制 +## 快速控制的主开关 最左侧的复选框作为主开关： 自动批准工具栏中的主开关 -*主开关（复选框）可一次性控制所有自动批准权限* +*主开关（复选框）一次控制所有自动批准权限* 在以下情况下使用主开关： -- 处理敏感代码时（关闭） -- 进行快速开发时（开启） -- 在探索和编辑任务之间切换时 +- 在敏感代码中工作（关闭） +- 进行快速开发（打开） +- 在探索和编辑任务之间切换 ## 高级设置面板 -设置面板提供了详细的控制和重要的安全上下文： +设置面板提供详细控制和重要的安全上下文： -> **允许 Kilo Code 自动执行操作而无需批准。仅在你完全信任 AI 并了解相关安全风险时启用这些设置。** +> **允许 Kilo Code 自动执行操作而无需批准。仅在您完全信任 AI 并了解相关安全风险的情况下才启用这些设置。** 要访问这些设置： -1. 点击右上角的 -2. 导航到“自动批准设置” +1. 单击右上角的 +2. 导航到自动批准设置 -设置面板中的自动批准选项 +设置面板自动批准选项 -*完整设置面板视图* +*完整的设置面板视图* ### 读取操作 :::caution 读取操作 只读操作设置 -**设置：**“始终批准只读操作” +**设置：** “始终批准只读操作” -**描述：**“启用后，Kilo Code 将自动查看目录内容并读取文件，而无需你点击批准按钮。” +**描述：** “启用后，Kilo Code 将自动查看目录内容并读取文件，无需您单击批准按钮。” -**风险等级：**中 +**风险级别：** 中 -虽然此设置仅允许读取文件（不允许修改），但它可能会暴露敏感数据。对于大多数用户来说，仍建议作为起点，但要注意 Kilo Code 可以访问哪些文件。 +虽然此设置只允许读取文件（不修改它们），但它可能会暴露敏感数据。对于大多数用户来说，仍然建议将其作为起点，但请注意 Kilo Code 可以访问哪些文件。 ::: ### 写入操作 :::caution 写入操作 -写入操作设置，带有延迟滑块 +带延迟滑块的写入操作设置 -**设置：**“始终批准写入操作” +**设置：** “始终批准写入操作” -**描述：**“自动创建和编辑文件而无需批准” +**描述：** “自动创建和编辑文件，无需批准” -**延迟滑块：**“写入后的延迟时间，以便诊断工具检测潜在问题”（默认：1000ms） +**延迟滑块：** “写入后延迟以允许诊断检测潜在问题”（默认：1000ms） -**风险等级：**高 +**风险级别：** 高 -此设置允许 Kilo Code 无需确认即可修改你的文件。延迟计时器至关重要： -- 较高的值（2000ms+）：适用于诊断时间较长的复杂项目 +此设置允许 Kilo Code 无需确认即可修改您的文件。延迟计时器至关重要： +- 较高值（2000ms+）：建议用于诊断时间较长的复杂项目 - 默认值（1000ms）：适用于大多数项目 -- 较低的值：仅在速度至关重要且处于受控环境中时使用 -- 零：无诊断延迟（不建议用于关键代码） +- 较低值：仅在速度至关重要且您处于受控环境中时使用 +- 零：诊断无延迟（不建议用于关键代码） -#### 写入延迟与问题面板集成 +#### 写入延迟和问题窗格集成 -VSCode 问题面板显示诊断信息 +显示诊断信息的 VSCode 问题窗格 -*VSCode 问题面板，Kilo Code 在写入延迟期间检查该面板* +*Kilo Code 在写入延迟期间检查的 VSCode 问题窗格* -当你启用写文件的自动批准时，延迟计时器会与 VSCode 的问题面板配合使用： +当您启用文件写入的自动批准时，延迟计时器与 VSCode 的问题窗格一起工作： -1. Kilo Code 更改你的文件 -2. VSCode 的诊断工具分析更改 -3. 问题面板更新，显示任何错误或警告 -4. Kilo Code 在继续之前注意到这些问题 +1. Kilo Code 对您的文件进行更改 +2. VSCode 的诊断工具分析更改 +3. 问题窗格更新任何错误或警告 +4. Kilo Code 在继续之前注意到这些问题 -这类似于开发人员在更改代码后暂停检查错误。你可以根据以下因素调整延迟时间： +这就像人类开发人员在更改代码后暂停检查错误一样。您可以根据以下因素调整延迟时间： - 项目复杂性 - 语言服务器速度 -- 错误检测对你工作流程的重要性 +- 错误检测对您的工作流程的重要性 ::: ### 浏览器操作 @@ -121,38 +123,38 @@ :::info 浏览器操作 浏览器操作设置 -**设置：**“始终批准浏览器操作” +**设置：** “始终批准浏览器操作” -**描述：**“自动执行浏览器操作而无需批准” +**描述：** “自动执行浏览器操作，无需批准” -**注意：**“仅当模型支持计算机使用时适用” +**注意：** “仅当模型支持计算机使用时才适用” -**风险等级：**中 +**风险级别：** 中 -允许 Kilo Code 无需确认即可控制无头浏览器。这包括： +允许 Kilo Code 无需确认即可控制无头浏览器。这可以包括： - 打开网站 - 导航页面 - 与网页元素交互 -考虑允许自动浏览器访问的安全影响。 +考虑允许自动化浏览器访问的安全隐患。 ::: ### API 请求 :::info API 请求 -API 请求重试设置，带有延迟滑块 +带延迟滑块的 API 请求重试设置 -**设置：**“始终重试失败的 API 请求” +**设置：** “始终重试失败的 API 请求” -**描述：**“当服务器返回错误响应时，自动重试失败的 API 请求” +**描述：** “当服务器返回错误响应时，自动重试失败的 API 请求” -**延迟滑块：**“重试请求前的延迟时间”（默认：5s） +**延迟滑块：** “重试请求前的延迟”（默认：5s） -**风险等级：**低 +**风险级别：** 低 -此设置在 API 调用失败时自动重试。延迟控制 Kilo Code 在重试前的等待时间： -- 较长的延迟对 API 速率限制更友好 -- 较短的延迟可以更快地从临时错误中恢复 +此设置会在 API 调用失败时自动重试。延迟控制 Kilo Code 在重试之前等待多长时间： +- 较长的延迟对 API 速率限制更温和 +- 较短的延迟可以更快地从瞬时错误中恢复 ::: ### MCP 工具 @@ -160,13 +162,13 @@ :::caution MCP 工具 MCP 工具设置 -**设置：**“始终批准 MCP 工具” +**设置：** “始终批准 MCP 工具” -**描述：**“在 MCP 服务器视图中启用各个 MCP 工具的自动批准（需同时启用此设置和工具的‘始终允许’复选框）” +**描述：** “在 MCP 服务器视图中启用单个 MCP 工具的自动批准（需要此设置和工具的单独‘始终允许’复选框）” -**风险等级：**中高（取决于配置的 MCP 工具） +**风险级别：** 中-高（取决于配置的 MCP 工具） -此设置与 MCP 服务器视图中的各个工具权限配合使用。必须同时启用此全局设置和工具特定权限才能实现自动批准。 +此设置与 MCP 服务器视图中的单个工具权限结合使用。此全局设置和工具特定权限都必须启用才能进行自动批准。 ::: ### 模式切换 @@ -174,13 +176,13 @@ :::info 模式切换 模式切换设置 -**设置：**“始终批准模式切换” +**设置：** “始终批准模式切换” -**描述：**“自动在不同模式之间切换而无需批准” +**描述：** “自动在不同模式之间切换，无需批准” -**风险等级：**低 +**风险级别：** 低 -允许 Kilo Code 无需许可即可在不同模式（代码、架构师等）之间切换。这主要影响 AI 的行为，而不是系统访问。 +允许 Kilo Code 在不同模式（代码、架构师等）之间切换，无需请求权限。这主要影响 AI 的行为，而不是系统访问。 ::: ### 子任务 @@ -188,37 +190,94 @@ :::info 子任务 子任务设置 -**设置：**“始终批准子任务的创建和完成” +**设置：** “始终批准子任务的创建和完成” -**描述：**“允许创建和完成子任务而无需批准” +**描述：** “允许创建和完成子任务，无需批准” -**风险等级：**低 +**风险级别：** 低 -允许 Kilo Code 自动创建和完成子任务。这涉及工作流程组织而非系统访问。 +启用 Kilo Code 自动创建和完成子任务。这与工作流组织有关，而不是系统访问。 ::: ### 命令执行 :::caution 命令执行 -命令执行设置，带有白名单界面 +带白名单界面的命令执行设置 -**设置：**“始终批准允许的执行操作” +**设置：** “始终批准允许的执行操作” -**描述：**“自动执行允许的终端命令而无需批准” +**描述：** “自动执行允许的终端命令，无需批准” -**命令管理：**“当启用‘始终批准执行操作’时，可以自动执行的命令前缀。添加 * 以允许所有命令（请谨慎使用）。” +**命令管理：** “当启用‘始终批准执行操作’时，可以自动执行的命令前缀。添加 * 以允许所有命令（谨慎使用）。” -**风险等级：**高 +**风险级别：** 高 -此设置允许终端命令执行并带有控制。虽然风险较高，但白名单功能限制了可以运行的命令。重要的安全功能： +此设置允许通过控制执行终端命令。虽然有风险，但白名单功能限制了可以运行的命令。重要的安全功能： -- 白名单特定的命令前缀（推荐） -- 切勿在生产环境或处理敏感数据时使用 * 通配符 -- 考虑每个允许命令的安全影响 +- 白名单特定命令前缀（推荐） +- 切勿在生产环境或敏感数据中使用 * 通配符 +- 考虑每个允许命令的安全隐患 - 始终验证与外部系统交互的命令 **界面元素：** -- 输入命令前缀的文本字段（例如 'git'） -- 添加新前缀的“添加”按钮 -- 带 X 的可点击命令按钮以删除它们 -::: \ No newline at end of file +- 文本字段用于输入命令前缀（例如，“git”） +- “添加”按钮用于添加新前缀 +- 可单击的命令按钮，带 X 可删除它们 +::: + +### 后续问题 + +:::info 后续问题（风险：低） + +**设置：** `始终为后续问题提供默认答案` + +**描述：** 在可配置的超时后，自动为后续问题选择第一个 AI 建议的答案。这通过让 Roo 无需手动干预即可继续操作来加快您的工作流程。 + +**视觉倒计时：** 启用后，第一个建议按钮上会出现一个倒计时计时器，显示自动选择前的剩余时间。计时器显示为圆形进度指示器，随着时间推移而耗尽。 + +**超时滑块：** 使用滑块设置等待时间，从 1 到 300 秒（默认：60 秒）。 + +**覆盖选项：** 您可以通过以下方式随时取消自动选择： +- 单击不同的建议 +- 编辑任何建议 +- 输入您自己的响应 +- 单击计时器以暂停它 + +**风险级别：** 低 + +**用例：** +- 您希望 Roo 继续工作的隔夜运行 +- 默认建议通常正确的重复任务 +- 交互不重要的测试工作流 +::: + +### 更新待办事项列表 + +:::info 更新待办事项列表（风险：低） + +**设置：** “始终批准待办事项列表更新” + +**描述：** “自动更新待办事项列表，无需批准” + +**风险级别：** 低 + +此设置允许 Roo 在工作会话期间自动更新任务进度和待办事项列表。这包括： +- 将任务标记为已完成 +- 添加新发现的任务 +- 更新任务状态（待处理、进行中、已完成） +- 重新组织任务优先级 + +**优点：** +- 保持实时任务进度可见性 +- 减少多步骤工作流中的中断 +- 保持项目状态准确反映 +- 帮助跟踪复杂的任务依赖关系 + +**用例：** +- 长期开发会话 +- 多步骤重构项目 +- 复杂调试工作流 +- 具有许多子任务的功能实现 + +当与子任务权限结合使用时，这尤其有用，因为它允许 Roo 在没有持续批准请求的情况下保持项目进度的完整视图。 +::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/browser-use.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/browser-use.md index d0c9b54..6e28e17 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/browser-use.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/browser-use.md @@ -1,34 +1,29 @@ # 浏览器使用 -Kilo Code 提供了先进的浏览器自动化功能，让你可以直接在 VS Code 中与网站进行交互。该功能使你无需离开开发环境即可测试 Web 应用程序、自动化浏览器任务并捕获屏幕截图。 +Kilo Code 提供复杂的浏览器自动化功能，让您可以直接从 VS Code 与网站交互。此功能支持测试 Web 应用程序、自动化浏览器任务和捕获屏幕截图，而无需离开您的开发环境。 - - -:::info 模型支持要求 -Kilo Code 中的浏览器功能需要使用 Claude Sonnet 3.5 或 3.7 模型 +:::info 需要模型支持 +Kilo Code 中的浏览器使用需要使用高级代理模型，并且仅在 Claude Sonnet 3.5、3.7 和 4 上进行过测试。 ::: -## 浏览器功能的工作原理 +## 浏览器使用工作原理 默认情况下，Kilo Code 使用内置浏览器，该浏览器： -- 当你要求 Kilo 访问网站时会自动启动 -- 捕获网页截图 +- 当您要求 Kilo 访问网站时自动启动 +- 捕获网页屏幕截图 - 允许 Kilo 与网页元素交互 - 在后台隐形运行 -所有这些操作都在 VS Code 中直接完成，无需任何设置。 +所有这些都直接在 VS Code 中发生，无需设置。 -## 使用浏览器功能 +## 使用浏览器 典型的浏览器交互遵循以下模式： -1. 让 Kilo 访问一个网站 -2. Kilo 启动浏览器并显示截图 -3. 请求其他操作（点击、输入、滚动） -4. Kilo 在完成后关闭浏览器 +1. 要求 Kilo 访问网站 +2. Kilo 启动浏览器并向您显示屏幕截图 +3. 请求其他操作（单击、键入、滚动） +4. 完成后 Kilo 关闭浏览器 例如： @@ -37,118 +32,118 @@ Kilo Code 中的浏览器功能需要使用 Claude Sonnet 3.5 或 3.7 模型 ``` ``` -你能检查一下我在 https://kilocode.ai 的网站是否显示正确吗？ +您能检查一下我的网站 https://kilocode.ai 是否正常显示吗？ ``` ``` -浏览 http://localhost:3000，向下滚动到页面底部并检查页脚信息是否显示正确。 +浏览 http://localhost:3000，滚动到页面底部并检查页脚信息是否正常显示。 ``` 浏览器使用示例 -## 浏览器操作的工作原理 +## 浏览器操作工作原理 -`browser_action` 工具控制一个浏览器实例，在每次操作后返回截图和控制台日志，让你可以看到交互结果。 +`browser_action` 工具控制一个浏览器实例，该实例在每次操作后返回屏幕截图和控制台日志，让您可以看到交互结果。 -关键特性： -- 每个浏览器会话必须以 `launch` 开始，以 `close` 结束 -- 每条消息只能使用一个浏览器操作 -- 当浏览器处于活动状态时，不能使用其他工具 -- 在执行下一个操作之前，必须等待响应（截图和日志） +主要特点： +- 每个浏览器会话必须以 `launch` 开始并以 `close` 结束 +- 每个消息只能使用一个浏览器操作 +- 浏览器处于活动状态时，不能使用其他工具 +- 在执行下一个操作之前，您必须等待响应（屏幕截图和日志） ### 可用的浏览器操作 -| 操作 | 描述 | 使用场景 | +| 操作 | 描述 | 何时使用 | |--------|-------------|------------| -| `launch` | 在 URL 处打开浏览器 | 开始新的浏览器会话 | -| `click` | 在特定坐标处点击 | 与按钮、链接等交互 | -| `type` | 在活动元素中输入文本 | 填写表单、搜索框 | -| `scroll_down` | 向下滚动一页 | 查看折叠内容 | -| `scroll_up` | 向上滚动一页 | 返回之前的内容 | +| `launch` | 在 URL 处打开浏览器 | 启动新的浏览器会话 | +| `click` | 在特定坐标处单击 | 与按钮、链接等交互 | +| `type` | 将文本键入活动元素 | 填写表单、搜索框 | +| `scroll_down` | 向下滚动一页 | 查看折叠下方的内容 | +| `scroll_up` | 向上滚动一页 | 返回到以前的内容 | | `close` | 关闭浏览器 | 结束浏览器会话 | -## 浏览器功能配置/设置 +## 浏览器使用配置/设置 :::info 默认浏览器设置 - **启用浏览器工具**：已启用 -- **视口大小**：小桌面 (900x600) -- **截图质量**：75% +- **视口大小**：小型桌面 (900x600) +- **屏幕截图质量**：75% - **使用远程浏览器连接**：已禁用 ::: ### 访问设置 -要更改 Kilo 中的浏览器/电脑使用设置： +要更改 Kilo 中的浏览器/计算机使用设置： -1. 点击齿轮图标 → 浏览器/电脑使用 打开设置 +1. 单击齿轮图标 → 浏览器/计算机使用 打开设置 - 浏览器设置菜单 + 浏览器设置菜单 -### 启用/禁用浏览器功能 +### 启用/禁用浏览器使用 -**用途**：主开关，启用 Kilo 使用 Puppeteer 控制的浏览器与网站交互。 +**目的**：主开关，使 Kilo 能够使用 Puppeteer 控制的浏览器与网站交互。 要更改此设置： -1. 在浏览器/电脑使用设置中勾选或取消勾选 "启用浏览器工具" 复选框 +1. 在浏览器/计算机使用设置中选中或取消选中“启用浏览器工具”复选框 - 启用浏览器工具设置 + 启用浏览器工具设置 ### 视口大小 -**用途**：确定 Kilo Code 使用的浏览器会话的分辨率。 +**目的**：确定 Kilo Code 使用的浏览器会话的分辨率。 -**权衡**：更高的值提供更大的视口，但会增加 token 使用量。 +**权衡**：较高的值提供更大的视口，但会增加 token 使用量。 要更改此设置： -1. 在浏览器/电脑使用设置中点击 "视口大小" 下的下拉菜单 -2. 选择以下选项之一： - - 大桌面 (1280x800) - - 小桌面 (900x600) - 默认 - - 平板 (768x1024) - - 手机 (360x640) -2. 选择所需分辨率。 +1. 单击浏览器/计算机使用设置中“视口大小”下的下拉菜单 +2. 选择可用选项之一： + - 大型桌面 (1280x800) + - 小型桌面 (900x600) - 默认 + - 平板电脑 (768x1024) + - 移动设备 (360x640) +2. 选择您所需的分辨率。 - 视口大小设置 + 视口大小设置 -### 截图质量 +### 屏幕截图质量 -**用途**：控制浏览器截图的 WebP 压缩质量。 +**目的**：控制浏览器屏幕截图的 WebP 压缩质量。 -**权衡**：更高的值提供更清晰的截图，但会增加 token 使用量。 +**权衡**：较高的值提供更清晰的屏幕截图，但会增加 token 使用量。 要更改此设置： -1. 在浏览器/电脑使用设置中调整 "截图质量" 下的滑块 -2. 设置 1-100% 之间的值（默认为 75%） -3. 更高的值提供更清晰的截图，但会增加 token 使用量： - - 40-50%：适用于基本文本网站 - - 60-70%：适用于大多数一般浏览 - - 80%+：当需要精细视觉细节时使用 +1. 在浏览器/计算机使用设置中调整“屏幕截图质量”下的滑块 +2. 设置 1-100% 之间的值（默认值为 75%） +3. 较高的值提供更清晰的屏幕截图，但会增加 token 使用量： + - 40-50%：适用于基本的基于文本的网站 + - 60-70%：适用于大多数通用浏览 + - 80%+：在精细视觉细节至关重要时使用 - 截图质量设置 + 屏幕截图质量设置 ### 远程浏览器连接 -**用途**：将 Kilo 连接到现有的 Chrome 浏览器，而不是使用内置浏览器。 +**目的**：将 Kilo 连接到现有 Chrome 浏览器，而不是使用内置浏览器。 **优点**： -- 适用于容器化环境和远程开发工作流 -- 在浏览器使用之间保持认证会话 -- 消除重复登录步骤 -- 允许使用具有特定扩展的自定义浏览器配置文件 +- 在容器化环境和远程开发工作流中工作 +- 在浏览器使用之间保持经过身份验证的会话 +- 消除重复的登录步骤 +- 允许使用带有特定扩展的自定义浏览器配置文件 -**要求**：Chrome 必须启用远程调试。 +**要求**：Chrome 必须运行并启用远程调试。 要启用此功能： -1. 在浏览器/电脑使用设置中勾选 "使用远程浏览器连接" 框 -2. 点击 "测试连接" 进行验证 +1. 在浏览器/计算机使用设置中选中“使用远程浏览器连接”框 +2. 单击“测试连接”以验证 - 远程浏览器连接设置 + 远程浏览器连接设置 #### 常见用例 -- **DevContainers**：从容器化的 VS Code 连接到主机 Chrome 浏览器 -- **远程开发**：使用本地 Chrome 与远程 VS Code 服务器 -- **自定义 Chrome 配置文件**：使用具有特定扩展和设置的配置文件 +- **DevContainers**：从容器化 VS Code 连接到主机 Chrome 浏览器 +- **远程开发**：将本地 Chrome 与远程 VS Code 服务器一起使用 +- **自定义 Chrome 配置文件**：使用带有特定扩展和设置的配置文件 #### 连接到可见的 Chrome 窗口 @@ -167,4 +162,4 @@ Kilo Code 中的浏览器功能需要使用 Claude Sonnet 3.5 或 3.7 模型 **Linux** ```bash google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug --no-first-run -``` \ No newline at end of file +``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/checkpoints.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/checkpoints.md index 1165abe..b6655b0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/checkpoints.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/checkpoints.md @@ -1,49 +1,49 @@ # 检查点 -检查点会在Kilo Code任务期间自动对你的工作区文件进行版本控制，使你能够安全地探索AI建议并轻松恢复不想要的更改。 +检查点在 Kilo Code 任务期间自动对您的工作区文件进行版本控制，从而实现对 AI 建议的非破坏性探索，并轻松从不需要的更改中恢复。 -检查点让你可以： -- 安全地尝试AI建议的更改 -- 轻松恢复不想要的修改 +检查点让您能够： +- 安全地试验 AI 建议的更改 +- 轻松从不需要的修改中恢复 - 比较不同的实现方法 -- 恢复到之前的项目状态而不会丢失工作 +- 恢复到以前的项目状态而不会丢失工作 -:::info 重要提示 +:::info 重要说明 - **检查点默认启用。** -- **必须安装Git**才能使用检查点功能 - [查看安装说明](#git-installation) -- 不需要GitHub账号或仓库 -- 不需要配置Git个人信息 -- 影子Git仓库独立于你项目现有的Git配置 +- **必须安装 Git** 才能使检查点正常工作 - [请参阅安装说明](#git-installation) +- 无需 GitHub 帐户或仓库 +- 无需 Git 个人信息配置 +- 影子 Git 仓库独立于您项目现有的 Git 配置运行 ::: ## 配置选项 -在Kilo Code设置的"检查点"部分可以配置检查点： +在 Kilo Code 设置的“检查点”部分访问检查点设置： -1. 点击齿轮图标 → 检查点 打开设置 -2. 勾选或取消勾选"启用自动检查点"选项 +1. 单击齿轮图标 → Checkpoints 打开设置 +2. 选中或取消选中“启用自动检查点”复选框 - Kilo Code配置中的检查点设置 + Kilo Code 配置中的检查点设置 ## 检查点工作原理 -Kilo Code使用一个独立于主版本控制系统的影子Git仓库来捕获项目状态的快照。这些快照称为检查点，会在AI辅助工作流中自动记录更改——无论是任务开始、文件更改还是命令运行时。 +Kilo Code 使用一个影子 Git 仓库（独立于您的主版本控制系统）捕获项目状态的快照。这些快照称为检查点，会在您的 AI 辅助工作流中自动记录更改——无论任务何时开始、文件何时更改或命令何时运行。 -检查点作为提交存储在影子仓库中，记录： +检查点作为 Git 提交存储在影子仓库中，捕获： - 文件内容更改 -- 新增的文件 +- 添加的新文件 - 删除的文件 -- 重命名的文件 -- 二进制文件的更改 +- 重命名文件 +- 二进制文件更改 ## 使用检查点 -检查点通过聊天界面直接集成到你的工作流中。 +检查点直接通过聊天界面集成到您的工作流中。 -检查点在聊天历史记录中以两种形式出现： +检查点以两种形式直接出现在您的聊天历史记录中： -- **初始检查点**标记项目开始状态 +- **初始检查点**标记您的起始项目状态 聊天中的初始检查点指示器 - **常规检查点**在文件修改或命令执行后出现 @@ -53,43 +53,43 @@ Kilo Code使用一个独立于主版本控制系统的影子Git仓库来捕获 ### 查看差异 -要比较当前工作区与之前的检查点： +要将当前工作区与以前的检查点进行比较： -1. 在聊天历史记录中找到检查点 -2. 点击检查点的`查看差异`按钮 +1. 在聊天历史记录中找到检查点 +2. 单击检查点的 `View Differences` 按钮 查看差异按钮界面 -3. 在比较视图中查看差异： - - 新增的行以绿色高亮显示 - - 删除的行以红色高亮显示 - - 修改的文件会列出详细更改 - - 重命名和移动的文件会跟踪路径更改 - - 新增或删除的文件会被明确标记 +3. 在比较视图中查看差异： + - 添加的行以绿色突出显示 + - 删除的行以红色突出显示 + - 修改的文件列出详细更改 + - 重命名和移动的文件跟踪其路径更改 + - 新建或删除的文件清晰标记 检查点的查看差异选项 ### 恢复检查点 -要将项目恢复到之前的检查点状态： +要将项目恢复到以前的检查点状态： -1. 在聊天历史记录中找到检查点 -2. 点击检查点的`恢复检查点`按钮 +1. 在聊天历史记录中找到检查点 +2. 单击检查点的 `Restore Checkpoint` 按钮 恢复检查点按钮界面 -3. 选择以下恢复选项之一： +3. 选择以下恢复选项之一： 恢复检查点选项 - - **仅恢复文件** - 仅将工作区文件恢复到检查点状态，不修改对话历史记录。适用于在保持聊天上下文的同时比较不同实现方案的理想选择。此选项不需要确认，可以快速在不同实现方案之间切换。 + - **仅恢复文件** - 仅将工作区文件恢复到检查点状态，而不修改对话历史记录。非常适合在保持聊天上下文的同时比较替代实现，让您可以在不同项目状态之间无缝切换。此选项无需确认，可让您快速在不同实现之间切换。 - - **恢复文件和任务** - 恢复工作区文件并删除所有后续对话消息。当你想完全重置代码和对话到检查点的时间点时使用。此选项需要在对话框中确认，因为无法撤销。 + - **恢复文件和任务** - 恢复工作区文件并删除所有后续对话消息。当您希望将代码和对话完全重置回检查点的时间点时使用。此选项需要在对话框中进行确认，因为它无法撤消。 - 恢复检查点文件和任务的确认对话框 + 恢复文件和任务检查点的确认对话框 ### 限制和注意事项 -- **范围**：检查点仅捕获Kilo Code任务期间所做的更改 -- **外部更改**：在任务之外所做的修改（手动编辑、其他工具）不会被包含 +- **范围**：检查点仅捕获在活动 Kilo Code 任务期间所做的更改 +- **外部更改**：在任务之外进行的修改（手动编辑、其他工具）不包括在内 - **大文件**：非常大的二进制文件可能会影响性能 - **未保存的工作**：恢复将覆盖工作区中任何未保存的更改 @@ -97,140 +97,140 @@ Kilo Code使用一个独立于主版本控制系统的影子Git仓库来捕获 ### 检查点架构 -检查点系统由以下部分组成： +检查点系统包括： -1. **影子Git仓库**：专门为检查点跟踪创建的独立Git仓库，作为检查点状态的持久存储机制。 +1. **影子 Git 仓库**：专门为检查点跟踪创建的独立 Git 仓库，作为检查点状态的持久存储机制。 -2. **检查点服务**：通过以下方式处理Git操作和状态管理： +2. **检查点服务**：通过以下方式处理 Git 操作和状态管理： - 仓库初始化 - 检查点创建和存储 - 差异计算 - 状态恢复 -3. **UI组件**：显示在聊天界面中与检查点交互的界面元素。 +3. **UI 组件**：聊天中显示的界面元素，可实现与检查点的交互。 ### 恢复过程 当执行恢复时，Kilo Code： -- 硬重置到指定的检查点提交 -- 将影子仓库中的所有文件复制到工作区 +- 对指定的检查点提交执行硬重置 +- 将所有文件从影子仓库复制到您的工作区 - 更新内部检查点跟踪状态 ### 存储类型 -检查点是任务范围的，意味着它们只针对单个任务。 +检查点是任务范围的，这意味着它们特定于单个任务。 ### 差异计算 -检查点比较使用Git的底层差异功能来生成结构化的文件差异： +检查点比较使用 Git 的底层差异功能生成结构化的文件差异： - 修改的文件显示逐行更改 -- 二进制文件被正确检测和处理 -- 重命名和移动的文件被正确跟踪 -- 文件的创建和删除被明确标识 +- 正确检测和处理二进制文件 +- 正确跟踪重命名和移动的文件 +- 清晰识别文件创建和删除 ### 文件排除和忽略模式 -检查点系统使用智能文件排除来跟踪相关文件： +检查点系统使用智能文件排除来仅跟踪相关文件： #### 内置排除 -系统有全面的内置排除模式，自动忽略： -- 构建产物和依赖目录（`node_modules/`, `dist/`, `build/`） -- 媒体文件和二进制资源（图片、视频、音频） -- 缓存和临时文件（`.cache/`, `.tmp/`, `.bak`） +系统具有全面的内置排除模式，自动忽略： +- 构建工件和依赖项目录（`node_modules/`、`dist/`、`build/`） +- 媒体文件和二进制资产（图像、视频、音频） +- 缓存和临时文件（`.cache/`、`.tmp/`、`.bak`） - 包含敏感信息的配置文件（`.env`） -- 大数据文件（归档文件、可执行文件、二进制文件） +- 大型数据文件（存档、可执行文件、二进制文件） - 数据库文件和日志 -这些模式在初始化时被写入影子仓库的`.git/info/exclude`文件。 +这些模式在初始化期间写入影子仓库的 `.git/info/exclude` 文件。 -#### .gitignore支持 +#### .gitignore 支持 -检查点系统尊重工作区中的`.gitignore`模式： -- 被`.gitignore`排除的文件不会触发检查点创建 +检查点系统尊重工作区中的 `.gitignore` 模式： +- 被 `.gitignore` 排除的文件不会触发检查点创建 - 排除的文件不会出现在检查点差异中 -- 在暂存文件更改时应用标准Git忽略规则 +- 暂存文件更改时应用标准 Git 忽略规则 -#### .kilocodeignore行为 +#### .kilocodeignore 行为 -`.kilocodeignore`文件（控制AI对文件的访问）与检查点跟踪是分开的： -- 被`.kilocodeignore`排除但未被`.gitignore`排除的文件仍会被检查点跟踪 -- 对AI不可访问文件的更改仍可以通过检查点恢复 +`.kilocodeignore` 文件（控制 AI 对文件的访问）与检查点跟踪是分开的： +- 被 `.kilocodeignore` 排除但未被 `.gitignore` 排除的文件仍将被检查点 +- 对 AI 无法访问的文件的更改仍可通过检查点恢复 -这种分离是故意的，因为`.kilocodeignore`限制的是AI可以访问的文件，而不是应该被跟踪进行版本历史记录的文件。 +这种分离是故意的，因为 `.kilocodeignore` 限制了 AI 可以访问的文件，而不是应该跟踪版本历史的文件。 -#### 嵌套Git仓库 +#### 嵌套 Git 仓库 -检查点系统对嵌套Git仓库有特殊处理： -- 在操作期间将嵌套的`.git`目录临时重命名为`.git_disabled` +检查点系统包括对嵌套 Git 仓库的特殊处理： +- 在操作期间临时将嵌套的 `.git` 目录重命名为 `.git_disabled` - 操作完成后恢复它们 - 允许正确跟踪嵌套仓库中的文件 -- 确保嵌套仓库保持功能不受影响 +- 确保嵌套仓库保持功能正常且不受影响 ### 并发控制 -操作被排队以防止可能破坏仓库状态的并发Git操作。这确保了即使快速连续请求检查点操作也能安全完成。 +操作排队以防止可能损坏仓库状态的并发 Git 操作。这确保了即使在快速连续请求时，快速检查点操作也能安全完成。 -## Git安装 +## Git 安装 -检查点要求系统上安装Git。该实现使用`simple-git`库，它依赖Git命令行工具来创建和管理影子仓库。 +检查点要求您的系统上安装 Git。该实现使用 `simple-git` 库，该库依赖于 Git 命令行工具来创建和管理影子仓库。 ### macOS -1. **使用Homebrew安装（推荐）**： - ``` - brew install git - ``` +1. **使用 Homebrew 安装（推荐）**： + ``` + brew install git + ``` -2. **替代方案：使用Xcode命令行工具安装**： - ``` - xcode-select --install - ``` +2. **替代方案：使用 Xcode 命令行工具安装**： + ``` + xcode-select --install + ``` -3. **验证安装**： - - 打开终端 - - 输入`git --version` - - 你应该看到类似`git version 2.40.0`的版本号 +3. **验证安装**： + - 打开终端 + - 键入 `git --version` + - 您应该会看到版本号，例如 `git version 2.40.0` ### Windows -1. **下载Git for Windows**： - - 访问 https://git-scm.com/download/win - - 下载应该会自动开始 +1. **下载适用于 Windows 的 Git**： + - 访问 https://git-scm.com/download/win + - 下载应自动开始 -2. **运行安装程序**： - - 接受许可协议 - - 选择安装位置（推荐默认） - - 选择组件（通常默认选项足够） - - 选择默认编辑器 - - 选择如何使用Git命令行（推荐：Git from the command line and also from 3rd-party software） - - 配置行尾转换（推荐：Checkout Windows-style, commit Unix-style） - - 完成安装 +2. **运行安装程序**： + - 接受许可协议 + - 选择安装位置（推荐默认） + - 选择组件（默认选项通常足够） + - 选择默认编辑器 + - 选择如何从命令行使用 Git（推荐：从命令行和第三方软件使用 Git） + - 配置行尾转换（推荐：Checkout Windows-style, commit Unix-style） + - 完成安装 -3. **验证安装**： - - 打开命令提示符或PowerShell - - 输入`git --version` - - 你应该看到类似`git version 2.40.0.windows.1`的版本号 +3. **验证安装**： + - 打开命令提示符或 PowerShell + - 键入 `git --version` + - 您应该会看到版本号，例如 `git version 2.40.0.windows.1` ### Linux -**Debian/Ubuntu**: +**Debian/Ubuntu**： ``` sudo apt update sudo apt install git ``` -**Fedora**: +**Fedora**： ``` sudo dnf install git ``` -**Arch Linux**: +**Arch Linux**： ``` sudo pacman -S git ``` **验证安装**： - 打开终端 -- 输入`git --version` -- 你应该看到版本号 \ No newline at end of file +- 键入 `git --version` +- 您应该会看到版本号 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/code-actions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/code-actions.md index 6d5bc42..d39556f 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/code-actions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/code-actions.md @@ -2,89 +2,89 @@ import Image from '@site/src/components/Image'; # 代码操作 -代码操作是 VS Code 的一项强大功能，它可以直接在编辑器中提供快速修复、重构和其他代码相关建议。Kilo Code 与这一系统集成，为常见的编码任务提供 AI 驱动的辅助。 +代码操作是 VS Code 的强大功能，它直接在编辑器中提供快速修复、重构和其他与代码相关的建议。Kilo Code 与此系统集成，为常见的编码任务提供 AI 辅助。 ## 什么是代码操作？ -代码操作以灯泡图标（💡）的形式出现在编辑器左侧的装订线（行号左侧的区域）中。它们也可以通过右键菜单或键盘快捷键访问。触发代码操作的情况包括： +代码操作在编辑器装订线（行号左侧区域）中显示为灯泡图标（💡）。它们也可以通过右键单击上下文菜单或通过键盘快捷键访问。它们在以下情况下触发： -* 你选择了一段代码。 -* 你的光标位于有问题的行（错误、警告或提示）。 -* 你通过命令调用它们。 +* 您选择了一段代码。 +* 您的光标位于有问题（错误、警告或提示）的行上。 +* 您通过命令调用它们。 -点击灯泡、右键选择“Kilo Code”或使用键盘快捷键（默认情况下，Windows/Linux 为 `Ctrl+.`，macOS 为 `Cmd+.`），会显示可用操作的菜单。 +单击灯泡、右键单击并选择“Kilo Code”，或使用键盘快捷键（macOS 上默认为 `Ctrl+.` 或 `Cmd+.`），将显示可用操作菜单。 -VS Code 代码操作 +VS Code 代码操作与代码在同一行 ## Kilo Code 的代码操作 Kilo Code 提供以下代码操作： -* **添加上下文：** 快速将选中的代码添加到与 Kilo 的聊天中，包括行号以便 Kilo 知道代码的确切位置。它位于菜单顶部以便快速访问。（详见下文）。 -* **解释代码：** 让 Kilo Code 解释选中的代码。 -* **修复代码：** 让 Kilo Code 修复选中代码中的问题（当存在诊断信息时可用）。 -* **改进代码：** 让 Kilo Code 建议对选中代码的改进。 +* **添加到上下文：** 快速将选定的代码添加到与 Kilo 的聊天中，包括行号，以便 Kilo 确切知道代码来自何处。它在菜单中排在第一位，以便于访问。（更多详细信息见下文）。 +* **解释代码：** 要求 Kilo Code 解释选定的代码。 +* **修复代码：** 要求 Kilo Code 修复选定代码中的问题（在存在诊断时可用）。 +* **改进代码：** 要求 Kilo Code 建议改进选定的代码。 -### 添加上下文深入解析 +### 添加到上下文深入探讨 -**添加上下文** 操作位于代码操作菜单的顶部，以便你可以快速将代码片段添加到对话中。当你使用它时，Kilo Code 会包含文件名和行号以及代码。 +**添加到上下文**操作在代码操作菜单中排在第一位，因此您可以快速将代码片段添加到对话中。当您使用它时，Kilo Code 会将文件名和行号以及代码包含在内。 -这有助于 Kilo 理解代码在项目中的确切上下文，从而提供更相关和准确的帮助。 +这有助于 Kilo 理解代码在项目中的确切上下文，从而使其能够提供更相关和准确的帮助。 -代码操作 - 添加上下文 +代码操作 - 添加到上下文 gif **示例聊天输入：** ``` -你能解释这个函数吗？ +你能解释一下这个函数吗？ @myFile.js:15:25 ``` -*(其中 `@myFile.js:15:25` 表示通过“添加上下文”添加的代码)* +*（其中 `@myFile.js:15:25` 表示通过“添加到上下文”添加的代码）* -每个操作都可以在“新任务”或“当前任务”中执行。 +这些操作中的每一个都可以在“新任务中”或“当前任务中”执行。 ## 使用代码操作 -使用 Kilo Code 代码操作的主要方式有三种： +使用 Kilo Code 的代码操作有三种主要方式： -### 1. 通过灯泡图标（💡） +### 1. 从灯泡 (💡) -1. **选择代码：** 选择你要处理的代码。你可以选择单行、多行或整个代码块。 -2. **寻找灯泡：** 灯泡图标会出现在选中代码（或有错误/警告的行）旁边的装订线中。 -3. **点击灯泡：** 点击灯泡图标以打开代码操作菜单。 -4. **选择一个操作：** 从菜单中选择所需的 Kilo Code 操作。 -5. **审查并批准：** Kilo Code 会在聊天面板中提出解决方案。审查提出的更改并批准或拒绝它们。 +1. **选择代码：** 选择您要处理的代码。您可以选择单行、多行或整个代码块。 +2. **查找灯泡：** 灯泡图标将出现在选定代码（或带有错误/警告的行）旁边的装订线中。 +3. **单击灯泡：** 单击灯泡图标以打开代码操作菜单。 +4. **选择操作：** 从菜单中选择所需的 Kilo Code 操作。 +5. **审查和批准：** Kilo Code 将在聊天面板中提出解决方案。审查提议的更改并批准或拒绝它们。 -### 2. 通过右键菜单 +### 2. 从右键上下文菜单 -1. **选择代码：** 选择你要处理的代码。 -2. **右键点击：** 右键点击选中的代码以打开上下文菜单。 -3. **选择“Kilo Code”：** 从上下文菜单中选择“Kilo Code”选项。将出现一个子菜单，显示可用的 Kilo Code 操作。 -4. **选择一个操作：** 从子菜单中选择所需的操作。 -5. **审查并批准：** Kilo Code 会在聊天面板中提出解决方案。审查提出的更改并批准或拒绝它们。 +1. **选择代码：** 选择您要处理的代码。 +2. **右键单击：** 右键单击选定的代码以打开上下文菜单。 +3. **选择“Kilo Code”：** 从上下文菜单中选择“Kilo Code”选项。将出现一个子菜单，其中包含可用的 Kilo Code 操作。 +4. **选择操作：** 从子菜单中选择所需的操作。 +5. **审查和批准：** Kilo Code 将在聊天面板中提出解决方案。审查提议的更改并批准或拒绝它们。 -### 3. 通过命令面板 +### 3. 从命令面板 -1. **选择代码：** 选择你要处理的代码。 -2. **打开命令面板：** 按 `Ctrl+Shift+P`（Windows/Linux）或 `Cmd+Shift+P`（macOS）。 -3. **输入命令：** 输入“Kilo Code”以过滤命令，然后选择相关的代码操作（例如，“Kilo Code: 解释代码”）。你也可以输入命令的开头，如“Kilo Code: 解释”，并从过滤列表中选择。 -4. **审查并批准：** Kilo Code 会在聊天面板中提出解决方案。审查提出的更改并批准或拒绝它们。 +1. **选择代码：** 选择您要处理的代码。 +2. **打开命令面板：** 按 `Ctrl+Shift+P` (Windows/Linux) 或 `Cmd+Shift+P` (macOS)。 +3. **键入命令：** 键入“Kilo Code”以过滤命令，然后选择相关的代码操作（例如，“Kilo Code: Explain Code”）。您也可以键入命令的开头，例如“Kilo Code: Explain”，然后从过滤列表中选择。 +4. **审查和批准：** Kilo Code 将在聊天面板中提出解决方案。审查提议的更改并批准或拒绝它们。 -## 代码操作与当前任务 +## 代码操作和当前任务 -每个代码操作都提供两个选项： +每个代码操作都为您提供两个选项： -* **在新任务中：** 选择此项以开始一个围绕此代码操作的对话。 -* **在当前任务中：** 如果对话已经开始，此选项将代码操作作为附加消息添加到当前对话中。 +* **在新任务中：** 选择此选项以开始与 Kilo 的对话，围绕此代码操作进行。 +* **在当前任务中：** 如果对话已经开始，此选项将代码操作添加为附加消息。 ## 自定义代码操作提示 -你可以通过修改**提示**选项卡中的“支持提示”来自定义每个代码操作的提示。这允许你微调给 AI 模型的指令，并根据你的具体需求定制响应。 +您可以通过修改“提示”选项卡中的“支持提示”来自定义每个代码操作使用的提示。这允许您微调提供给 AI 模型的指令，并根据您的特定需求调整响应。 -1. **打开提示选项卡：** 点击 Kilo Code 顶部菜单栏中的 图标。 -2. **找到“支持提示”：** 你会看到支持提示，包括“增强提示”、“解释代码”、“修复代码”和“改进代码”。 -3. **编辑提示：** 修改你要自定义的提示的文本区域。你可以使用占位符，如 `${filePath}` 和 `${selectedText}` 来包含当前文件和选择的信息。 -4. **点击“完成”：** 保存你的更改。 +1. **打开提示选项卡：** 单击 Kilo Code 顶部菜单栏中的 图标。 +2. **查找“支持提示”：** 您将看到支持提示，包括“增强提示”、“解释代码”、“修复代码”和“改进代码”。 +3. **编辑提示：** 修改您要自定义的提示的文本区域中的文本。您可以使用 `${filePath}` 和 `${selectedText}` 等占位符来包含有关当前文件和选择的信息。 +4. **单击“完成”：** 保存您的更改。 -通过使用 Kilo Code 的代码操作，你可以直接在编码工作流程中快速获得 AI 驱动的辅助。这可以节省时间并帮助你编写更好的代码。 \ No newline at end of file +通过使用 Kilo Code 的代码操作，您可以直接在编码工作流中快速获得 AI 辅助。这可以节省您的时间并帮助您编写更好的代码。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/codebase-indexing.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/codebase-indexing.md new file mode 100644 index 0000000..3c085d5 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/codebase-indexing.md @@ -0,0 +1,230 @@ +import Codicon from '@site/src/components/Codicon'; + +# 代码库索引 + +代码库索引通过 AI 嵌入实现对整个项目的语义代码搜索。它不是搜索精确的文本匹配，而是理解您查询的*含义*，帮助 Kilo Code 找到相关代码，即使您不知道特定的函数名称或文件位置。 + +代码库索引设置 + +## 作用 + +启用后，索引系统： + +1. **使用 Tree-sitter 解析您的代码**以识别语义块（函数、类、方法） +2. **使用 AI 模型创建每个代码块的嵌入** +3. **将向量存储在 Qdrant 数据库中**以进行快速相似性搜索 +4. **为 Kilo Code 提供 [`codebase_search`](/advanced-usage/available-tools/codebase-search) 工具**以进行智能代码发现 + +这使得自然语言查询（如“用户身份验证逻辑”或“数据库连接处理”）能够查找整个项目中的相关代码。 + +## 主要优点 + +- **语义搜索**：通过含义查找代码，而不仅仅是关键字 +- **增强 AI 理解**：Kilo Code 可以更好地理解和使用您的代码库 +- **跨项目发现**：搜索所有文件，而不仅仅是打开的文件 +- **模式识别**：查找相似的实现和代码模式 + +## 设置要求 + +### 嵌入提供商 + +选择以下选项之一来生成嵌入： + +**OpenAI（推荐）** + +- 需要 OpenAI API 密钥 +- 支持所有 OpenAI 嵌入模型 +- 默认：`text-embedding-3-small` +- 每批处理多达 100,000 个 token + +**Gemini** + +- 需要 Google AI API 密钥 +- 支持 Gemini 嵌入模型，包括 `gemini-embedding-001` +- OpenAI 的经济高效替代方案 +- 用于代码理解的高质量嵌入 + +**Ollama（本地）** + +- 需要本地 Ollama 安装 +- 无 API 成本或互联网依赖 +- 支持任何 Ollama 兼容的嵌入模型 +- 需要 Ollama 基本 URL 配置 + +### 向量数据库 + +**Qdrant** 是存储和搜索嵌入所必需的： + +- **本地**：`http://localhost:6333`（推荐用于测试） +- **云**：Qdrant Cloud 或自托管实例 +- **身份验证**：安全部署的可选 API 密钥 + +## 设置 Qdrant + +### 快速本地设置 + +**使用 Docker：** + +```bash +docker run -p 6333:6333 qdrant/qdrant +``` + +**使用 Docker Compose：** + +```yaml +version: '3.8' +services: + qdrant: + image: qdrant/qdrant + ports: + - '6333:6333' + volumes: + - qdrant_storage:/qdrant/storage +volumes: + qdrant_storage: +``` + +### 生产部署 + +用于团队或生产： + +- [Qdrant Cloud](https://cloud.qdrant.io/) - 托管服务 +- 在 AWS、GCP 或 Azure 上自托管 +- 带有网络访问的本地服务器，用于团队共享 + +## 配置 + +1. 打开 Kilo Code 设置（ 图标） +2. 导航到 **代码库索引** 部分 +3. 使用切换开关启用 **“启用代码库索引”** +4. 配置您的嵌入提供商： + - **OpenAI**：输入 API 密钥并选择模型 + - **Gemini**：输入 Google AI API 密钥并选择嵌入模型 + - **Ollama**：输入基本 URL 并选择模型 +5. 设置 Qdrant URL 和可选的 API 密钥 +6. 配置 **最大搜索结果**（默认：20，范围：1-100） +7. 单击 **保存** 开始初始索引 + +### 启用/禁用切换 + +代码库索引功能包含一个方便的切换开关，允许您： + +- **启用**：开始索引您的代码库并使搜索工具可用 +- **禁用**：停止索引、暂停文件监视并禁用搜索功能 +- **保留设置**：关闭时您的配置仍会保存 + +此切换对于在密集开发工作期间或处理敏感代码库时暂时禁用索引很有用。 + +## 理解索引状态 + +界面显示带有颜色指示器的实时状态： + +- **待机**（灰色）：未运行，等待配置 +- **索引中**（黄色）：当前正在处理文件 +- **已索引**（绿色）：最新且可供搜索 +- **错误**（红色）：失败状态，需要注意 + +## 文件处理方式 + +### 智能代码解析 + +- **Tree-sitter 集成**：使用 AST 解析识别语义代码块 +- **语言支持**：Tree-sitter 支持的所有语言 +- **Markdown 支持**：完全支持 markdown 文件和文档 +- **回退**：对于不支持的文件类型，基于行的分块 +- **块大小**： + - 最小：100 个字符 + - 最大：1,000 个字符 + - 智能拆分大型函数 + +### 自动文件过滤 + +索引器自动排除： + +- 二进制文件和图像 +- 大文件（>1MB） +- Git 仓库（`.git` 文件夹） +- 依赖项（`node_modules`、`vendor` 等） +- 与 `.gitignore` 和 `.kilocode` 模式匹配的文件 + +### 增量更新 + +- **文件监视**：监视工作区中的更改 +- **智能更新**：仅重新处理修改过的文件 +- **基于哈希的缓存**：避免重新处理未更改的内容 +- **分支切换**：自动处理 Git 分支更改 + +## 最佳实践 + +### 模型选择 + +**对于 OpenAI：** + +- **`text-embedding-3-small`**：性能和成本的最佳平衡 +- **`text-embedding-3-large`**：更高精度，成本高 5 倍 +- **`text-embedding-ada-002`**：旧模型，成本较低 + +**对于 Ollama：** + +- **`mxbai-embed-large`**：最大和最高质量的嵌入模型。 +- **`nomic-embed-text`**：性能和嵌入质量的最佳平衡。 +- **`all-minilm`**：紧凑型模型，质量较低但性能更快。 + +### 安全注意事项 + +- **API 密钥**：安全地存储在 VS Code 的加密存储中 +- **代码隐私**：仅发送少量代码片段用于嵌入 +- **本地处理**：所有解析均在本地进行 +- **Qdrant 安全**：在生产环境部署时使用身份验证 + +## 当前限制 + +- **文件大小**：每个文件最大 1MB +- **单个工作区**：一次一个工作区 +- **依赖项**：需要外部服务（嵌入提供商 + Qdrant） +- **语言覆盖**：仅限于 Tree-sitter 支持的语言以实现最佳解析 + +## 使用搜索功能 + +索引后，Kilo Code 可以使用 [`codebase_search`](/advanced-usage/available-tools/codebase-search) 工具查找相关代码： + +**示例查询：** + +- “用户身份验证如何处理？” +- “数据库连接设置” +- “错误处理模式” +- “API 端点定义” + +该工具为 Kilo Code 提供： + +- 相关代码片段（最多达到您配置的最大结果限制） +- 文件路径和行号 +- 相似度分数 +- 上下文信息 + +### 搜索结果配置 + +您可以通过调整 **最大搜索结果** 设置来控制返回的搜索结果数量： + +- **默认**：20 个结果 +- **范围**：1-100 个结果 +- **性能**：较低的值可提高响应速度 +- **全面性**：较高的值提供更多上下文，但可能会减慢响应速度 + +## 隐私与安全 + +- **代码保留在本地**：仅发送少量代码片段用于嵌入 +- **嵌入是数字的**：不是人类可读的表示 +- **安全存储**：API 密钥在 VS Code 存储中加密 +- **本地选项**：使用 Ollama 进行完全本地处理 +- **访问控制**：尊重现有文件权限 + +## 未来增强 + +计划的改进： + +- 附加嵌入提供商 +- 多工作区索引 +- 增强的过滤和配置选项 +- 团队共享功能 +- 与 VS Code 本机搜索集成 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/custom-modes.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/custom-modes.md index 06ec063..9870088 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/custom-modes.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/custom-modes.md @@ -1,40 +1,40 @@ # 自定义模式 -Kilo Code允许你创建**自定义模式**来定制Kilo的行为以适应特定任务或工作流程。自定义模式可以是**全局的**（在所有项目中可用）或**项目特定的**（在单个项目中定义）。 +Kilo Code 允许您创建**自定义模式**，以根据特定任务或工作流调整 Kilo 的行为。自定义模式可以是**全局**（适用于所有项目）或**项目特定**（在单个项目中定义）。 -## 为什么使用自定义模式？ +## 为什么要使用自定义模式？ -* **专业化**：创建针对特定任务优化的模式，如"文档编写者"、"测试工程师"或"重构专家" -* **安全性**：限制模式对敏感文件或命令的访问。例如，"审查模式"可以限制为只读操作 -* **实验性**：安全地尝试不同的提示和配置，而不会影响其他模式 -* **团队协作**：与团队共享自定义模式以标准化工作流程 +* **专业化：** 创建针对特定任务优化的模式，例如“文档编写器”、“测试工程师”或“重构专家” +* **安全：** 限制模式对敏感文件或命令的访问。例如，“审查模式”可以限制为只读操作 +* **实验：** 安全地尝试不同的提示和配置，而不会影响其他模式 +* **团队协作：** 与您的团队共享自定义模式以标准化工作流 -自定义模式界面概览 -*Kilo Code创建和管理自定义模式的界面* + 自定义模式界面概述 + *Kilo Code 用于创建和管理自定义模式的界面。* -## 自定义模式包含什么？ +## 自定义模式中包含什么？ -自定义模式允许你定义： +自定义模式允许您定义： -* **唯一名称和slug**：便于识别 -* **角色定义**：放置在系统提示的开头，定义Kilo在该模式下的核心专业知识和个性。这个位置至关重要，因为它塑造了Kilo对任务的基本理解和处理方法 -* **自定义指令**：添加到系统提示末尾，提供修改或优化Kilo行为的特定指南。与`.clinerules`文件（仅在末尾添加规则）不同，这种角色和指令的结构化放置允许更精细地控制Kilo的响应 -* **允许的工具**：该模式可以使用的Kilo Code工具（例如：读取文件、写入文件、执行命令） -* **文件限制**：（可选）将文件访问限制为特定文件类型或模式（例如：仅允许编辑`.md`文件） +* **唯一的名称和 slug：** 便于识别 +* **角色定义：** 放置在系统提示的开头，这定义了 Kilo 在该模式下的核心专业知识和个性。此位置至关重要，因为它塑造了 Kilo 对任务的基本理解和方法 +* **自定义指令：** 放置在系统提示的末尾，这些指令提供了修改或完善 Kilo 行为的特定指南。与 `.clinerules` 文件（仅在末尾添加规则）不同，这种角色和指令的结构化放置允许对 Kilo 的响应进行更细致的控制 +* **允许的工具：** 该模式可以使用的 Kilo Code 工具（例如，读取文件、写入文件、执行命令） +* **文件限制：** （可选）将文件访问限制为特定文件类型或模式（例如，仅允许编辑 `.md` 文件） -## 自定义模式配置（JSON格式） +## 自定义模式配置（JSON 格式） -全局和项目特定配置使用相同的JSON格式。每个配置文件包含一个模式定义的`customModes`数组： +全局和项目特定配置都使用相同的 JSON 格式。每个配置文件都包含一个模式定义数组 `customModes`： ```json { "customModes": [ { "slug": "mode-name", - "name": "模式显示名称", - "roleDefinition": "模式的角色和能力", + "name": "Mode Display Name", + "roleDefinition": "Mode's role and capabilities", "groups": ["read", "edit"], - "customInstructions": "附加指南" + "customInstructions": "Additional guidelines" } ] } @@ -49,206 +49,204 @@ Kilo Code允许你创建**自定义模式**来定制Kilo的行为以适应特定 * 示例：`"docs-writer"`, `"test-engineer"` #### `name` -* 在UI中显示的名称 -* 可以包含空格和适当的大小写 -* 示例：`"文档编写者"`, `"测试工程师"` +* 在 UI 中显示的名称 +* 可以包含空格和正确的大小写 +* 示例：`"Documentation Writer"`, `"Test Engineer"` #### `roleDefinition` -* 模式角色和能力的详细描述 -* 定义Kilo在该模式下的专业知识和个性 -* 示例：`"你是一位专注于编写清晰文档的技术写作者"` +* 模式角色和功能的详细描述 +* 定义 Kilo 在此模式下的专业知识和个性 +* 示例：`"您是一位专注于清晰文档的技术作家"` #### `groups` * 允许的工具组数组 * 可用组：`"read"`, `"edit"`, `"browser"`, `"command"`, `"mcp"` -* 可以为`"edit"`组包含文件限制 +* 可以包含文件限制 for the `"edit"` group ##### 文件限制格式 ```json ["edit", { "fileRegex": "\\.md$", - "description": "仅限Markdown文件" + "description": "Markdown files only" }] ``` ### 理解文件限制 -`fileRegex`属性使用正则表达式来控制模式可以编辑哪些文件： +The `fileRegex` property uses regular expressions to control which files a mode can edit: -* `\\.md$` - 匹配以".md"结尾的文件 -* `\\.(test|spec)\\.(js|ts)$` - 匹配测试文件（例如"component.test.js"） -* `\\.(js|ts)$` - 匹配JavaScript和TypeScript文件 +* `\\.md$` - Match files ending in ".md" +* `\\.(test|spec)\\.(js|ts)$` - Match test files (e.g., "component.test.js") +* `\\.(js|ts)$` - Match JavaScript and TypeScript files -常见正则表达式模式： -* `\\.` - 匹配字面量点 -* `(a|b)` - 匹配"a"或"b" -* `$` - 匹配文件名结尾 +Common regex patterns: +* `\\.` - Match a literal dot +* `(a|b)` - Match either "a" or "b" +* `$` - Match the end of the filename -[了解更多关于正则表达式的知识](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) +[Learn more about regular expressions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) -### 可选属性 +### Optional Properties #### `customInstructions` -* 模式的附加行为指南 -* 示例：`"专注于解释概念和提供示例"` +* Additional behavioral guidelines for the mode +* Example: `"Focus on explaining concepts and providing examples"` #### `apiConfiguration` -* 自定义该模式的AI模型和参数的可选设置 -* 允许针对特定任务优化模型选择 -* 示例：`{"model": "gpt-4", "temperature": 0.2}` +* Optional settings to customize the AI model and parameters for this mode +* Allows optimizing the model selection for specific tasks +* Example: `{"model": "gpt-4", "temperature": 0.2}` -### 模式特定的自定义指令文件 +### Mode-Specific Custom Instructions Files -除了JSON中的`customInstructions`属性外，你还可以使用专门的文件来存储模式特定的指令： +In addition to the `customInstructions` property in JSON, you can use a dedicated file for mode-specific instructions: -1. 在工作区根目录创建名为`.clinerules-{mode-slug}`的文件 - * 将`{mode-slug}`替换为你的模式slug（例如`.clinerules-docs-writer`） -2. 将你的自定义指令添加到此文件 -3. Kilo Code会自动将这些指令应用于指定模式 +1. Create a file named `.clinerules-{mode-slug}` in your workspace root + * Replace `{mode-slug}` with your mode's slug (e.g., `.clinerules-docs-writer`) +2. Add your custom instructions to this file +3. Kilo Code will automatically apply these instructions to the specified mode -这种方法特别适用于： -* 保持冗长的指令与模式配置分离 -* 使用版本控制管理指令 -* 允许非技术团队成员修改指令而无需编辑JSON +This approach is particularly useful for: +* Keeping lengthy instructions separate from your mode configuration +* Managing instructions with version control +* Allowing non-technical team members to modify instructions without editing JSON -注意：如果同时存在`.clinerules-{mode-slug}`和`customInstructions`属性，它们将被合并，文件内容会附加在JSON属性之后。 +Note: If both `.clinerules-{mode-slug}` and the `customInstructions` property exist, they will be combined, with the file contents appended after the JSON property. -## 配置优先级 +## Configuration Precedence -模式配置按以下顺序应用： +Mode configurations are applied in this order: -1. 项目级模式配置（来自`.kilocodemodes`） -2. 全局模式配置（来自`custom_modes.json`） -3. 默认模式配置 +1. Project-level mode configurations (from `.kilocodemodes`) +2. Global mode configurations (from `custom_modes.yaml`) +3. Default mode configurations -这意味着项目特定的配置将覆盖全局配置，而全局配置又将覆盖默认配置。 +This means that project-specific configurations will override global configurations, which in turn override default configurations. -## 创建自定义模式 +## Creating Custom Modes -你有三种创建自定义模式的选项： +You have three options for creating custom modes: -### 1. 询问Kilo!（推荐） +### 1. Ask Kilo! (Recommended) -你可以通过要求Kilo Code快速创建一个基本自定义模式。例如： +You can quickly create a basic custom mode by asking Kilo Code to do it for you. For example: ``` -创建一个名为"文档编写者"的新模式。它应该只能读取文件和编写Markdown文件。 +Create a new mode called "Documentation Writer". It should only be able to read files and write Markdown files. ``` -Kilo Code将引导你完成整个过程。但是，对于微调模式或进行特定调整，你需要使用下面描述的"提示"标签页或手动配置方法。 - +Kilo Code will guide you through the process. However, for fine-tuning modes or making specific adjustments, you'll want to use the Prompts tab or manual configuration methods described below. :::info -#### 自定义模式创建设置 -启用后，Kilo允许你使用类似'Make me a custom mode that...'的提示创建自定义模式。禁用此功能可在不需要此功能时减少约700 tokens的系统提示。禁用时，你仍然可以使用上方的+按钮或编辑相关配置JSON手动创建自定义模式。 -启用通过提示创建自定义模式的设置 -你可以通过点击Kilo Code顶部菜单栏中的图标在提示设置中找到此设置。 +#### Custom Mode Creation Settings +When enabled, Kilo allows you to create custom modes using prompts like 'Make me a custom mode that...'. Disabling this reduces your system prompt by about 700 tokens when this feature isn't needed. When disabled you can still manually create custom modes using the + button above or by editing the related config JSON. +Enable Custom Mode Creation Through Prompts setting +You can find this setting within the prompt settings by clicking the icon in the Kilo Code top menu bar. ::: -### 2. 使用提示标签页 +### 2. Using the Prompts Tab -1. **打开提示标签页**：点击Kilo Code顶部菜单栏中的图标 -2. **创建新模式**：点击模式标题右侧的按钮 -3. **填写字段**： +1. **Open Prompts Tab:** Click the icon in the Kilo Code top menu bar +2. **Create New Mode:** Click the button to the right of the Modes heading +3. **Fill in Fields:** - 提示标签页中的自定义模式创建界面 - *显示名称、slug、保存位置、角色定义、可用工具和自定义指令字段的自定义模式创建界面* + Custom mode creation interface in the Prompts tab + *The custom mode creation interface showing fields for name, slug, save location, role definition, available tools, and custom instructions.* - * **名称**：输入模式的显示名称 - * **Slug**：输入小写标识符（仅限字母、数字和连字符） - * **保存位置**：选择全局（通过`custom_modes.json`，在所有工作区可用）或项目特定（在项目根目录的`.kilocodemodes`文件中） - * **角色定义**：定义Kilo在该模式下的专业知识和个性（出现在系统提示的开头） - * **可用工具**：选择该模式可以使用的工具 - * **自定义指令**：（可选）添加该模式特定的行为指南（出现在系统提示的末尾） -4. **创建模式**：点击"创建模式"按钮保存你的新模式 + * **Name:** Enter a display name for the mode + * **Slug:** Enter a lowercase identifier (letters, numbers, and hyphens only) + * **Save Location:** Choose Global (via `custom_modes.yaml`, available across all workspaces) or Project-specific (via `.kilocodemodes` file in project root) + * **Role Definition:** Define Kilo's expertise and personality for this mode (appears at the start of the system prompt) + * **Available Tools:** Select which tools this mode can use + * **Custom Instructions:** (Optional) Add behavioral guidelines specific to this mode (appears at the end of the system prompt) +4. **Create Mode:** Click the "Create Mode" button to save your new mode -注意：文件类型限制只能通过手动配置添加。 +Note: File type restrictions can only be added through manual configuration. -### 3. 手动配置 +### 3. Manual Configuration -你可以通过编辑提示标签页中的JSON文件来配置自定义模式： +You can configure custom modes by editing JSON files through the Prompts tab: -全局和项目特定的配置都可以通过提示标签页编辑： +Both global and project-specific configurations can be edited through the Prompts tab: -1. **打开提示标签页**：点击Kilo Code顶部菜单栏中的图标 -2. **访问设置菜单**：点击模式标题右侧的按钮 -3. **选择配置**： - * 选择"编辑全局模式"来编辑`custom_modes.json`（在所有工作区可用） - * 选择"编辑项目模式"来编辑项目根目录中的`.kilocodemodes`文件 -4. **编辑配置**：修改打开的JSON文件 -5. **保存更改**：Kilo Code会自动检测更改 +1. **Open Prompts Tab:** Click the icon in the Kilo Code top menu bar +2. **Access Settings Menu:** Click the button to the right of the Modes heading +3. **Choose Configuration:** + * Select "Edit Global Modes" to edit `custom_modes.yaml` (available across all workspaces) + * Select "Edit Project Modes" to edit `.kilocodemodes` file (in project root) +4. **Edit Configuration:** Modify the JSON file that opens +5. **Save Changes:** Kilo Code will automatically detect the changes -## 配置示例 +## Example Configurations -每个示例展示模式配置的不同方面： +Each example shows different aspects of mode configuration: -### 基本文档编写者 +### Basic Documentation Writer ```json { "customModes": [{ "slug": "docs-writer", - "name": "文档编写者", - "roleDefinition": "你是一位专注于编写清晰文档的技术写作者", + "name": "Documentation Writer", + "roleDefinition": "您是一位专注于清晰文档的技术作家", "groups": [ "read", - ["edit", { "fileRegex": "\\.md$", "description": "仅限Markdown文件" }] + ["edit", { "fileRegex": "\\.md$", "description": "Markdown files only" }] ], "customInstructions": "专注于清晰的解释和示例" }] } ``` -### 具有文件限制的测试工程师 +### Test Engineer with File Restrictions ```json { "customModes": [{ "slug": "test-engineer", "name": "测试工程师", - "roleDefinition": "你是一位专注于代码质量的测试工程师", + "roleDefinition": "您是一位专注于代码质量的测试工程师", "groups": [ "read", - ["edit", { "fileRegex": "\\.(test|spec)\\.(js|ts)$", "description": "仅限测试文件" }] + ["edit", { "fileRegex": "\\.(test|spec)\\.(js|ts)$", "description": "Test files only" }] ] }] } ``` -### 项目特定的模式覆盖 +### Project-Specific Mode Override ```json { "customModes": [{ "slug": "code", "name": "代码（项目特定）", - "roleDefinition": "你是具有项目特定约束的软件工程师", + "roleDefinition": "您是一位具有项目特定约束的软件工程师", "groups": [ "read", - ["edit", { "fileRegex": "\\.(js|ts)$", "description": "仅限JS/TS文件" }] + ["edit", { "fileRegex": "\\.(js|ts)$", "description": "JS/TS files only" }] ], - "customInstructions": "专注于项目特定的JS/TS开发" + "customInstructions": "专注于项目特定的 JS/TS 开发" }] } ``` +By following these instructions, you can create and manage custom modes to enhance your workflow with Kilo Code. -按照这些说明，你可以创建和管理自定义模式以增强与Kilo Code的工作流程。 - -## 理解自定义模式中的正则表达式 +## Understanding Regex in Custom Modes -自定义模式中的正则表达式模式让你可以精确控制Kilo可以编辑哪些文件： +Regex patterns in custom modes let you precisely control which files Kilo can edit: -### 基本语法 +### Basic Syntax -当你在自定义模式中指定`fileRegex`时，你创建了一个文件路径必须匹配的模式： +When you specify `fileRegex` in a custom mode, you're creating a pattern that file paths must match: ```json -["edit", { "fileRegex": "\\.md$", "description": "仅限Markdown文件" }] +["edit", { "fileRegex": "\\.md$", "description": "Markdown files only" }] ``` -### 重要规则 +### Important Rules -- **双反斜杠**：在JSON中，反斜杠必须用另一个反斜杠转义。所以`\.md$`变成`\\.md$` -- **路径匹配**：模式匹配完整文件路径，而不仅仅是文件名 -- **大小写敏感**：正则表达式模式默认区分大小写 +- **Double Backslashes:** In JSON, backslashes must be escaped with another backslash. So `\\.md$` becomes `\\.md$` +- **Path Matching:** Patterns match against the full file path, not just the filename +- **Case Sensitivity:** Regex patterns are case-sensitive by default -### 常见模式示例 +### Common Pattern Examples -| 模式 | 匹配 | 不匹配 | +| Pattern | Matches | Doesn't Match | |---------|---------|---------------| | `\\.md$` | `readme.md`, `docs/guide.md` | `script.js`, `readme.md.bak` | | `^src/.*` | `src/app.js`, `src/components/button.tsx` | `lib/utils.js`, `test/src/mock.js` | @@ -256,30 +254,32 @@ Kilo Code将引导你完成整个过程。但是，对于微调模式或进行 | `docs/.*\\.md$` | `docs/guide.md`, `docs/api/reference.md` | `guide.md`, `src/docs/notes.md` | | `^(?!.*(test\|spec)).*\\.js$` | `app.js`, `utils.js` | `app.test.js`, `utils.spec.js` | -### 模式构建块 +### Pattern Building Blocks + +- `\\.` - Match a literal dot (period) +- `$` - Match the end of the string +- `^` - Match the beginning of the string +- `.*` - Match any character (except newline) zero or more times +- `(a|b)` - Match either "a" or "b" +- `(?!...)` - Negative lookahead (exclude matches) + +### Testing Your Patterns -- `\\.` - 匹配字面量点（句号） -- `$` - 匹配字符串结尾 -- `^` - 匹配字符串开头 -- `.*` - 匹配任何字符（换行符除外）零次或多次 -- `(a|b)` - 匹配"a"或"b" -- `(?!...)` - 否定前瞻（排除匹配） +Before applying a regex pattern to a custom mode: -### 测试你的模式 +1. Test it on sample file paths to ensure it matches what you expect +2. Remember that in JSON, each backslash needs to be doubled (`\d` becomes `\\d`) +3. Start with simpler patterns and build complexity gradually -在将正则表达式模式应用于自定义模式之前： -1. 在示例文件路径上测试它以确保它匹配你期望的内容 -2. 记住在JSON中每个反斜杠都需要加倍（`\d`变成`\\d`） -3. 从更简单的模式开始，逐步增加复杂性 :::tip -### 让Kilo构建你的正则表达式模式 -与其手动编写复杂的正则表达式模式，你可以要求Kilo为你创建它们！只需描述你想要包含或排除哪些文件： +### Let Kilo Build Your Regex Patterns +Instead of writing complex regex patterns manually, you can ask Kilo to create them for you! Simply describe which files you want to include or exclude: ``` -创建一个匹配JavaScript文件但排除测试文件的正则表达式模式 +Create a regex pattern that matches JavaScript files but excludes test files ``` -Kilo将生成带有适当JSON转义的适当模式。 +Kilo will generate the appropriate pattern with proper escaping for JSON configuration. ::: -## 社区画廊 -准备好探索更多？查看[Show and Tell](https://github.com/Kilo-Org/kilocode/discussions/categories/show-and-tell)来发现和分享社区创建的自定义模式！ \ No newline at end of file +## Community Gallery +Ready to explore more? Check out the [Show and Tell](https://github.com/Kilo-Org/kilocode/discussions/categories/show-and-tell) to discover and share custom modes created by the community! diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/enhance-prompt.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/enhance-prompt.md index 688c87a..004a856 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/enhance-prompt.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/enhance-prompt.md @@ -1,54 +1,54 @@ # 增强提示 -Kilo Code 中的“增强提示”功能可以帮助你在将提示发送给 AI 模型之前，提高提示的质量和有效性。通过点击聊天输入框中的 图标，你可以自动优化初始请求，使其更清晰、更具体，更有可能产生预期的结果。 +Kilo Code 中的“增强提示”功能可帮助您在将提示发送到 AI 模型之前提高其质量和有效性。通过单击聊天输入中的 图标，您可以自动优化您的初始请求，使其更清晰、更具体，并更有可能产生所需的结果。 ## 为什么要使用增强提示？ -* **提高清晰度：** Kilo Code 可以重新表述你的提示，使其对 AI 模型更易理解。 -* **添加上下文：** 增强过程可以为你的提示添加相关上下文，例如当前文件路径或选中的代码。 -* **更好的指令：** Kilo Code 可以添加指令，引导 AI 提供更有帮助的响应（例如，请求特定的格式或详细的说明）。 -* **减少歧义：** 增强提示有助于消除歧义，确保 Kilo Code 理解你的意图。 -* **一致性：** Kilo 会以相同的方式格式化提示，确保一致性。 +* **提高清晰度：** Kilo Code 可以重新措辞您的提示，使其更易于 AI 模型理解。 +* **添加上下文：** 增强过程可以为您的提示添加相关上下文，例如当前文件路径或选定的代码。 +* **更好的指令：** Kilo Code 可以添加指令来引导 AI 给出更有帮助的响应（例如，请求特定格式或特定详细程度）。 +* **减少歧义：** 增强提示有助于消除歧义并确保 Kilo Code 理解您的意图。 +* **一致性**：Kilo 将始终以相同的方式格式化提示给 AI。 -### 使用前后对比 +### 之前和之后 -非常简单的提示 -增强后的提示 +非常原始的提示 +增强的提示 ## 如何使用增强提示 -1. **输入初始提示：** 像往常一样在 Kilo Code 聊天输入框中输入你的请求。这可以是一个简单的问题、复杂的任务描述或介于两者之间的任何内容。 -2. **点击 图标：** 不要按下 Enter 键，而是点击聊天输入框右下角的 图标。 -3. **查看增强后的提示：** Kilo Code 会将你的原始提示替换为增强后的版本。查看增强后的提示，确保它准确反映了你的意图。你可以在发送前进一步优化增强后的提示。 -4. **发送增强后的提示：** 按下 Enter 键或点击发送图标（）将增强后的提示发送给 Kilo Code。 +1. **输入您的初始提示：** 像往常一样在 Kilo Code 聊天输入框中输入您的请求。这可以是一个简单的问题、一个复杂的任务描述，或介于两者之间的任何内容。 +2. **单击 图标：** 不要按 Enter 键，而是单击聊天输入框右下角的 图标。 +3. **审查增强提示：** Kilo Code 将用增强版本替换您的原始提示。审查增强提示，确保它准确反映您的意图。您可以在发送之前进一步优化增强提示。 +4. **发送增强提示：** 按 Enter 键或单击发送图标（）将增强提示发送到 Kilo Code。 ## 自定义增强过程 ### 自定义模板 -“增强提示”功能使用可自定义的提示模板。你可以修改此模板，以根据你的特定需求定制增强过程。 +“增强提示”功能使用可自定义的提示模板。您可以修改此模板以根据您的特定需求调整增强过程。 -1. **打开提示标签页：** 点击 Kilo Code 顶部菜单栏中的 图标。 -2. **选择“ENHANCE”标签：** 你应该会看到一个列出的支持提示列表，包括“ENHANCE”。点击此标签。 -3. **编辑提示模板：** 修改“Prompt”字段中的文本。 +1. **打开“提示”选项卡：** 单击 Kilo Code 顶部菜单栏中的 图标。 +2. **选择“ENHANCE”选项卡：** 您应该会看到列出的支持提示，包括“ENHANCE”。单击此选项卡。 +3. **编辑提示模板：** 修改“提示”字段中的文本。 -默认的提示模板包含占位符 `${userInput}`，它将被替换为你的原始提示。你可以修改此模板以适应模型的提示格式，并指示它如何增强你的请求。 +默认提示模板包含占位符 `${userInput}`，它将被您的原始提示替换。您可以修改它以适应模型的提示格式，并指示它如何增强您的请求。 -### 自定义提供者 +### 自定义提供商 -通过切换到更轻量级的 LLM 模型提供者（例如 GPT 4.1 Nano），可以加快提示增强的速度。这可以在保持质量的同时以更低的成本提供更快的响应。 +通过切换到更轻量级的 LLM 模型提供商（例如 GPT 4.1 Nano）来加快提示增强。这可以以更低的成本提供更快的结果，同时保持质量。 -按照 [API 配置配置文件指南](/features/api-configuration-profiles) 为增强提示创建专用配置文件。 +按照[API 配置配置文件指南](/features/api-configuration-profiles)为增强提示创建专用配置文件。 增强提示功能的自定义配置文件配置 -详细教程：https://youtu.be/R1nDnCK-xzw +有关详细演练：https://youtu.be/R1nDnCK-xzw ## 限制和最佳实践 -* **实验性功能：** 提示增强是一个实验性功能。增强提示的质量可能会根据请求的复杂性和底层模型的能力而有所不同。 -* **仔细查看：** 在发送增强提示之前，请务必仔细查看。Kilo Code 可能会做出不符合你意图的更改。 -* **迭代过程：** 你可以多次使用“增强提示”功能来迭代优化你的提示。 -* **不能替代清晰的指令：** 虽然“增强提示”可以帮助你，但从一开始就编写清晰、具体的提示仍然很重要。 +* **实验性功能：** 提示增强是一项实验性功能。增强提示的质量可能因您的请求的复杂性和底层模型的功能而异。 +* **仔细审查：** 在发送之前务必仔细审查增强提示。Kilo Code 可能会进行与您的意图不符的更改。 +* **迭代过程：** 您可以多次使用“增强提示”功能来迭代优化您的提示。 +* **不能替代清晰的指令：** 尽管“增强提示”可以提供帮助，但从一开始就编写清晰具体的提示仍然很重要。 -通过使用“增强提示”功能，你可以提高与 Kilo Code 的交互质量，并获得更准确、更有帮助的响应。 \ No newline at end of file +通过使用“增强提示”功能，您可以提高与 Kilo Code 交互的质量，并获得更准确和有用的响应。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/codebase-indexing.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/codebase-indexing.md deleted file mode 100644 index 03b1410..0000000 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/codebase-indexing.md +++ /dev/null @@ -1,205 +0,0 @@ -import Codicon from '@site/src/components/Codicon'; - -# 代码库索引 - -**⚠️ 实验性功能：** 该功能正在积极开发中，可能在未来的版本中发生重大变化。 - -代码库索引功能使用 AI 嵌入实现对整个项目的语义代码搜索。它不局限于精确的文本匹配，而是理解查询的_含义_，帮助 Kilo Code 即使在你不知道具体函数名或文件位置的情况下也能找到相关代码。 - -代码库索引设置 - -## 功能概述 - -启用后，索引系统会： - -1. **解析代码**：使用 Tree-sitter 识别语义块（函数、类、方法） -2. **创建嵌入**：使用 AI 模型为每个代码块生成嵌入 -3. **存储向量**：将向量存储在 Qdrant 数据库中以便快速相似性搜索 -4. **提供 [`codebase_search`](/advanced-usage/available-tools/codebase-search) 工具**：为 Kilo Code 提供智能代码发现功能 - -这使得你可以使用自然语言查询，如“用户认证逻辑”或“数据库连接处理”，在整个项目中找到相关代码。 - -## 主要优势 - -- **语义搜索**：通过含义而非关键字查找代码 -- **增强的 AI 理解**：Kilo Code 能更好地理解和处理你的代码库 -- **跨项目发现**：搜索所有文件，而不仅仅是打开的文件 -- **模式识别**：定位相似的实现和代码模式 - -## 设置要求 - -### 嵌入提供者 - -选择以下选项之一来生成嵌入： - -**OpenAI（推荐）** - -- 需要 OpenAI API 密钥 -- 支持所有 OpenAI 嵌入模型 -- 默认：`text-embedding-3-small` -- 每批最多处理 100,000 个 token - -**Ollama（本地）** - -- 需要本地 Ollama 安装 -- 无需 API 费用或网络依赖 -- 支持任何与 Ollama 兼容的嵌入模型 -- 需要配置 Ollama 基础 URL - -### 向量数据库 - -**Qdrant** 是存储和搜索嵌入的必需组件： - -- **本地**：`http://localhost:6333`（推荐用于测试） -- **云端**：Qdrant Cloud 或自托管实例 -- **认证**：可选的 API 密钥，用于安全部署 - -## 设置 Qdrant - -### 快速本地设置 - -**使用 Docker：** - -```bash -docker run -p 6333:6333 qdrant/qdrant -``` - -**使用 Docker Compose：** - -```yaml -version: '3.8' -services: - qdrant: - image: qdrant/qdrant - ports: - - '6333:6333' - volumes: - - qdrant_storage:/qdrant/storage -volumes: - qdrant_storage: -``` - -### 生产部署 - -对于团队或生产环境： - -- [Qdrant Cloud](https://cloud.qdrant.io/) - 托管服务 -- 在 AWS、GCP 或 Azure 上自托管 -- 本地服务器并配置网络访问以支持团队共享 - -## 配置 - -1. 打开 Kilo Code 设置（ 图标） -2. 导航到 **实验性** 部分 -3. 启用 **“启用代码库索引”** -4. 配置嵌入提供者： - - **OpenAI**：输入 API 密钥并选择模型 - - **Ollama**：输入基础 URL 并选择模型 -5. 设置 Qdrant URL 和可选的 API 密钥 -6. 点击 **保存** 开始初始索引 - -## 理解索引状态 - -界面会显示实时状态，并用颜色标识： - -- **待机**（灰色）：未运行，等待配置 -- **索引中**（黄色）：正在处理文件 -- **已索引**（绿色）：最新且可进行搜索 -- **错误**（红色）：需要关注失败状态 - -## 文件处理方式 - -### 智能代码解析 - -- **Tree-sitter 集成**：使用 AST 解析识别语义代码块 -- **语言支持**：Tree-sitter 支持的所有语言 -- **回退**：对不支持的文件类型使用基于行的分块 -- **块大小**： - - 最小：100 字符 - - 最大：1,000 字符 - - 智能分割大型函数 - -### 自动文件过滤 - -索引器会自动排除： - -- 二进制文件和图像 -- 大文件（>1MB） -- Git 仓库（`.git` 文件夹） -- 依赖项（`node_modules`、`vendor` 等） -- 符合 `.gitignore` 和 `.kilocode` 模式的文件 - -### 增量更新 - -- **文件监控**：监视工作区的变化 -- **智能更新**：仅重新处理修改过的文件 -- **基于哈希的缓存**：避免重新处理未更改的内容 -- **分支切换**：自动处理 Git 分支变更 - -## 最佳实践 - -### 模型选择 - -**对于 OpenAI：** - -- **`text-embedding-3-small`**：性能与成本的最佳平衡 -- **`text-embedding-3-large`**：更高的准确性，成本增加 5 倍 -- **`text-embedding-ada-002`**：旧版模型，成本较低 - -**对于 Ollama：** - -- **`mxbai-embed-large`**：最大且最高质量的嵌入模型。 -- **`nomic-embed-text`**：性能与嵌入质量的最佳平衡。 -- **`all-minilm`**：紧凑模型，质量较低但性能更快。 - -### 安全考虑 - -- **API 密钥**：安全存储在 VS Code 的加密存储中 -- **代码隐私**：仅发送小段代码片段进行嵌入（非完整文件） -- **本地处理**：所有解析均在本地进行 -- **Qdrant 安全性**：生产部署时使用认证 - -## 当前限制 - -- **文件大小**：每个文件最大 1MB -- **Markdown**：由于解析复杂性，目前不支持 -- **单一工作区**：一次只能处理一个工作区 -- **依赖项**：需要外部服务（嵌入提供者 + Qdrant） -- **语言覆盖**：仅限于 Tree-sitter 支持的语言 - -## 使用搜索功能 - -索引完成后，Kilo Code 可以使用 [`codebase_search`](/advanced-usage/available-tools/codebase-search) 工具查找相关代码： - -**示例查询：** - -- “用户认证是如何处理的？” -- “数据库连接设置” -- “错误处理模式” -- “API 端点定义” - -该工具为 Kilo Code 提供： - -- 相关代码片段 -- 文件路径和行号 -- 相似度分数 -- 上下文信息 - -## 隐私与安全 - -- **代码保留在本地**：仅发送小段代码片段进行嵌入 -- **嵌入为数值**：非人类可读的表示 -- **安全存储**：API 密钥在 VS Code 存储中加密 -- **本地选项**：使用 Ollama 实现完全本地处理 -- **访问控制**：尊重现有文件权限 - -## 未来改进 - -计划中的改进包括： - -- 增加更多嵌入提供者 -- 改进 Markdown 和文档支持 -- 多工作区索引 -- 增强过滤和配置选项 -- 团队共享功能 -- 与 VS Code 原生搜索集成 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/experimental-features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/experimental-features.md index 38ead34..fc147a3 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/experimental-features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/experimental/experimental-features.md @@ -1,5 +1,3 @@ -import Codicon from '@site/src/components/Codicon'; - # 实验性功能 Kilo Code 包含一些仍在开发中的实验性功能。这些功能可能不稳定，会在未来版本中发生重大变化，甚至可能被移除。请谨慎使用，并注意它们可能无法按预期工作。 @@ -18,15 +16,15 @@ Kilo Code 包含一些仍在开发中的实验性功能。这些功能可能不 ## 当前可用的实验性功能 -以下实验性功能目前可用： - -### 搜索和替换 +## 当前实验性功能 -添加了一个用于在文件中搜索和替换文本的新工具。 +目前提供以下实验性功能： -### 插入内容 +## 自动完成 +启用后，Kilo Code 将在您键入时提供内联代码建议。目前，这需要 Kilo Code API 提供商才能使用。 -添加了一个用于在文件中任意位置插入内容的新工具。 +## 并发文件编辑 +启用后，Kilo Code 可以在单个请求中编辑多个文件。禁用后，Kilo Code 必须一次编辑一个文件。禁用此功能有助于在使用功能较弱的模型时或当您希望对文件修改进行更多控制时。 ### 强力转向 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/fast-edits.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/fast-edits.md index cfc6689..8e3560f 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/fast-edits.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/fast-edits.md @@ -1,34 +1,36 @@ # 快速编辑 :::info 默认设置 -在 Kilo Code 中，快速编辑（使用"通过差异启用编辑"设置）默认是启用的。除非遇到特定问题或想要尝试不同的差异策略，否则通常不需要更改这些设置。 +Kilo Code 默认启用快速编辑（使用“通过差异启用编辑”设置）。除非您遇到特定问题或想尝试不同的差异策略，否则通常无需更改这些设置。 ::: -Kilo Code 提供了一个高级设置，可以更改它编辑文件的方式，使用差异（diff）而不是重写整个文件。启用此功能提供了显著的优势。 +Kilo Code 提供了一个高级设置，可以使用差异（差异）而不是重写整个文件来更改其编辑文件的方式。启用此功能可带来显著优势。 -## 启用通过差异编辑 +## 通过差异启用编辑 -打开设置，点击齿轮图标 → 高级 +单击齿轮图标 → 高级 打开设置 -当**启用通过差异编辑**被勾选时： - Kilo Code 设置显示启用通过差异编辑 -1. **更快的文件编辑**：Kilo 通过仅应用必要的更改来更快地修改文件。 -2. **防止截断写入**：系统会自动检测并拒绝 AI 尝试写入不完整文件内容的情况，这可能发生在大型文件或复杂指令时。这有助于防止文件损坏。 + +当选中“**通过差异启用编辑**”时： + + Kilo Code 设置显示通过差异启用编辑 +1. **更快的文件编辑**：Kilo 通过仅应用必要的更改来更快地修改文件。 +2. **防止截断写入**：系统自动检测并拒绝 AI 写入不完整文件内容的尝试，这可能发生在大型文件或复杂指令中。这有助于防止文件损坏。 :::note 禁用快速编辑 -如果取消勾选**启用通过差异编辑**，Kilo 将恢复为每次编辑时使用 [`write_to_file`](/features/tools/write-to-file) 工具写入整个文件内容，而不是使用 [`apply_diff`](/features/tools/apply-diff) 应用目标更改。这种全量写入的方法在修改现有文件时通常较慢，并且会导致更高的 token 使用量。 +如果您取消选中“**通过差异启用编辑**”，Kilo 将恢复为使用 [`write_to_file`](/features/tools/write-to-file) 工具为每次编辑写入整个文件内容，而不是使用 [`apply_diff`](/features/tools/apply-diff) 应用有针对性的更改。这种完全写入的方法通常在修改现有文件时速度较慢，并导致更高的 token 使用量。 ::: ## 匹配精度 -此滑块控制 AI 识别的代码部分在应用更改之前必须与实际文件中的代码匹配的紧密程度。 +此滑块控制 AI 识别的代码部分在应用更改之前必须与文件中实际代码匹配的紧密程度。 - Kilo Code 设置显示启用通过差异编辑复选框和匹配精度滑块 + Kilo Code 设置显示通过差异启用编辑复选框和匹配精度滑块 -* **100%（默认）**：要求完全匹配。这是最安全的选项，最大限度地降低错误更改的风险。 -* **较低值（80%-99%）**：允许"模糊"匹配。即使代码部分与 AI 预期的内容有轻微差异，Kilo 也可以应用更改。这在文件被轻微修改时可能有用，但**会增加**在错误位置应用更改的风险。 +* **100%（默认）**：需要精确匹配。这是最安全的选择，可最大程度地降低错误更改的风险。 +* **较低值（80%-99%）**：允许“模糊”匹配。即使代码部分与 AI 预期有细微差异，Kilo 也可以应用更改。这在文件略有修改时很有用，但**增加了**在错误位置应用更改的风险。 -**使用低于 100% 的值时要格外小心。** 较低精度可能偶尔是必要的，但始终要仔细审查提议的更改。 +**请极其谨慎地使用低于 100% 的值。** 较低的精度可能偶尔是必要的，但请务必仔细审查提议的更改。 -在内部，此设置会调整一个 `fuzzyMatchThreshold`，使用 Levenshtein 距离等算法来比较代码相似性。 \ No newline at end of file +在内部，此设置调整用于比较代码相似性的 `fuzzyMatchThreshold`（例如 Levenshtein 距离）算法。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/footgun-prompting.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/footgun-prompting.md index 76109e4..72d11c0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/footgun-prompting.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/footgun-prompting.md @@ -1,26 +1,26 @@ --- -sidebar_label: 'Footgun Prompting' +sidebar_label: '足枪式提示' --- -# Footgun Prompting：覆盖系统提示 +# 足枪式提示：覆盖系统提示 -Footgun Prompting，也称为覆盖系统提示，允许高级用户完全替换特定 Kilo Code 模式的默认系统提示。这提供了对 AI 行为的精细控制，但会绕过内置的安全机制。 +足枪式提示，又称覆盖系统提示，允许高级用户完全替换特定 Kilo Code 模式的默认系统提示。这提供了对 AI 行为的精细控制，但绕过了内置的安全措施。 -:::info **footgun** *(名词)* +:::info **足枪** *(名词)* -1. *(编程俚语，幽默，贬义)* 任何可能导致程序员搬起石头砸自己脚的功能。 +1. *(编程俚语，幽默，贬义)* 任何可能导致程序员自作自受的功能。 -> 系统提示覆盖被称为 "footgun"，因为在不深入了解其核心指令的情况下修改它可能会导致意外或损坏的行为，特别是在工具使用和响应一致性方面。 +> 系统提示覆盖被认为是一种足枪，因为在没有深入理解的情况下修改核心指令可能导致意外或错误的行为，尤其是在工具使用和响应一致性方面。 ::: ## 工作原理 -1. **覆盖文件：** 在项目根目录下创建一个名为 `.kilo/system-prompt-{mode-slug}` 的文件（例如，对于 Code 模式，文件名为 `.kilo/system-prompt-code`）。 -2. **内容：** 该文件的内容将成为该特定模式的新系统提示。 -3. **激活：** Kilo Code 会自动检测此文件。当文件存在时，它将替换大部分标准系统提示部分。 -4. **保留部分：** 只有核心的 `roleDefinition` 和你为该模式设置的 `customInstructions` 会与覆盖内容一起保留。标准部分如工具描述、规则和功能将被绕过。 -5. **构建：** 最终发送给模型的提示如下： +1. **覆盖文件：** 在您的工作区根目录中创建一个名为 `.kilo/system-prompt-{mode-slug}` 的文件（例如，Code 模式的 `.kilo/system-prompt-code`）。 +2. **内容：** 此文件的内容将成为该特定模式的新系统提示。 +3. **激活：** Kilo Code 会自动检测此文件。如果存在，它将替换大多数标准系统提示部分。 +4. **保留部分：** 只有核心 `roleDefinition` 和您为该模式设置的任何 `customInstructions` 会与您的覆盖内容一起保留。工具描述、规则和功能等标准部分将被绕过。 +5. **构建：** 发送到模型的最终提示如下所示： ``` ${roleDefinition} @@ -29,23 +29,24 @@ Footgun Prompting，也称为覆盖系统提示，允许高级用户完全替换 ${customInstructions} ``` -## 访问该功能 +## 访问功能 -你可以在 Kilo Code UI 中找到该功能和说明： +您可以在 Kilo Code UI 中找到选项和说明： -1. 点击 Kilo Code 顶部菜单栏中的 图标。 -2. 展开 **"高级：覆盖系统提示"** 部分。 -3. 点击说明中的文件路径链接，将在 VS Code 中打开或创建当前所选模式的覆盖文件。 +1. 单击 Kilo Code 文本输入框左下角的 MODE 选择器。 +2. 单击模式选择列表底部的“编辑...” +3. 展开底部的“**高级：覆盖系统提示**”部分。 +4. 单击说明中的文件路径链接将在 VS Code 中打开或创建当前选定模式的正确覆盖文件。 UI 显示高级：覆盖系统提示部分 -## 关键注意事项与警告 +## 主要注意事项和警告 -- **目标用户：** 最适合对 Kilo Code 提示系统和修改核心指令的影响有深入了解的用户。 -- **对功能的影响：** 自定义提示会覆盖标准指令，包括工具使用和响应一致性的指令。如果不小心处理，可能会导致意外行为或错误。 -- **模式特定：** 每个覆盖文件仅适用于文件名中指定的模式（`{mode-slug}`）。 +- **目标受众：** 最适合深入了解 Kilo Code 提示系统以及修改核心指令所带来影响的用户。 +- **对功能的影响：** 自定义提示会覆盖标准指令，包括工具使用和响应一致性的指令。如果管理不当，这可能导致意外行为或错误。 +- **模式特定：** 每个覆盖文件仅适用于其文件名中指定的模式（`{mode-slug}`）。 - **无文件，无覆盖：** 如果 `.kilo/system-prompt-{mode-slug}` 文件不存在，Kilo Code 将使用该模式的标准系统提示生成过程。 -- **目录创建：** Kilo Code 会在读取或创建覆盖文件之前确保 `.kilo` 目录存在。 +- **目录创建：** Kilo Code 确保 `.kilo` 目录存在，然后才尝试读取或创建覆盖文件。 -请谨慎使用此功能。虽然它对于自定义非常强大，但错误的实现可能会显著降低 Kilo Code 在受影响模式下的性能和可靠性。 \ No newline at end of file +请谨慎使用此功能。虽然它在自定义方面功能强大，但错误的实现可能会显著降低 Kilo Code 在受影响模式下的性能和可靠性。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/mcp/using-mcp-in-kilo-code.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/mcp/using-mcp-in-kilo-code.md index 3658a2f..59f0420 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/mcp/using-mcp-in-kilo-code.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/mcp/using-mcp-in-kilo-code.md @@ -25,35 +25,31 @@ MCP服务器配置可以在两个级别进行管理： 你可以直接从Kilo Code MCP设置视图编辑全局和项目级MCP配置文件： -1. 点击Kilo Code窗格顶部导航中的图标。 +1. 单击 Kilo Code 窗格顶部导航栏中的 图标以打开 `Settings`。 +2. 单击左侧的 `MCP Servers` 选项卡 +3. 选择 `Installed` 服务器 +3. 单击相应的按钮： + * **`Edit Global MCP`**：打开全局 `mcp_settings.json` 文件。 + * **`Edit Project MCP`**：打开项目特定的 `.kilocode/mcp.json` 文件。如果此文件不存在，Kilo Code 将为您创建它。 - Kilo Code中的MCP服务器界面 - -2. 滚动到MCP设置视图的底部。 -3. 点击适当的按钮： - * **`编辑全局MCP`**：打开全局`mcp_settings.json`文件。 - * **`编辑项目MCP`**：打开项目特定的`.kilocode/mcp.json`文件。如果该文件不存在，Kilo Code将为你创建。 - - 编辑全局MCP和编辑项目MCP按钮 + 编辑全局 MCP 和编辑项目 MCP 按钮 两个文件都使用JSON格式，其中包含一个`mcpServers`对象，包含命名的服务器配置： - -```json -{ - "mcpServers": { - "server1": { - "command": "python", - "args": ["/path/to/server.py"], - "env": { - "API_KEY": "your_api_key" - }, - "alwaysAllow": ["tool1", "tool2"], - "disabled": false + ```json + { + "mcpServers": { + "server1": { + "command": "python", + "args": ["/path/to/server.py"], + "env": { + "API_KEY": "your_api_key" + }, + "alwaysAllow": ["tool1", "tool2"], + "disabled": false + } } } -} ``` - *Kilo Code中的MCP服务器配置示例（STDIO传输）* ### 理解传输类型 @@ -118,34 +114,6 @@ SSE配置示例： } ``` -## 启用或禁用MCP服务器 - -在此处禁用MCP服务器将从系统提示中删除所有与MCP相关的逻辑和定义，减少token使用。这将阻止Kilo Code连接任何MCP服务器，并且`use_mcp_tool`和`access_mcp_resource`工具将不可用。如果你不打算使用MCP服务器，请取消勾选此选项。默认情况下为启用。 - -1. 点击Kilo Code窗格顶部导航中的图标 -2. 勾选/取消勾选`启用MCP服务器` - - 启用MCP服务器切换 - -## 启用或禁用MCP服务器创建 - -在此处禁用MCP服务器创建将仅从系统提示中删除Kilo Code用于编写MCP服务器的指令，而不删除操作它们的上下文。这减少了token使用。默认情况下为启用。 - -1. 点击Kilo Code窗格顶部导航中的图标 -2. 勾选/取消勾选`启用MCP服务器创建` - - 启用MCP服务器创建切换 - -## 管理单个MCP服务器 - - MCP服务器配置面板示例 - -每个MCP服务器都有自己的配置面板，你可以在此修改设置、管理工具并控制其操作。要访问这些设置： - -1. 点击Kilo Code窗格顶部导航中的图标 -2. 在列表中定位要管理的MCP服务器 - MCP服务器列表 - ### 删除服务器 1. 点击要删除的MCP服务器旁边的 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/model-temperature.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/model-temperature.md index 3f49d85..debfbc7 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/model-temperature.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/model-temperature.md @@ -1,93 +1,93 @@ # 模型温度 -温度控制控制着 AI 模型输出的随机性。调整此设置可以优化不同任务的结果 - 从精确的代码生成到创意头脑风暴。温度是控制 AI 行为最强大的参数之一。经过良好调优的温度设置可以显著提高特定任务响应的质量和适用性。 +温度控制 AI 模型输出的随机性。调整此设置可优化不同任务的结果——从精确的代码生成到创意头脑风暴。温度是控制 AI 行为最强大的参数之一。精心调整的温度设置可以显著提高特定任务响应的质量和适用性。 -展示温度滑块调整的动画 +显示温度滑块调整的动画 ## 什么是温度？ -温度是一个设置（通常在 0.0 到 2.0 之间），用于控制 AI 输出的随机性或可预测性。找到合适的平衡点很关键：较低的值使输出更加集中和一致，而较高的值则鼓励更多的创造性和多样性。对于许多编码任务，适中的温度（大约 0.3 到 0.7）通常效果很好，但最佳设置取决于你想要实现的目标。 +温度是一个设置（通常在 0.0 到 2.0 之间），用于控制 AI 输出的随机性或可预测性。找到正确的平衡是关键：较低的值使输出更集中和一致，而较高的值则鼓励更多的创造性和多样性。对于许多编码任务，中等温度（约 0.3 到 0.7）通常效果很好，但最佳设置取决于您要实现的目标。 :::info 温度和代码：常见误解 温度控制输出随机性，而不是直接控制代码质量或准确性。关键点： -* **低温（接近 0.0）：** 产生可预测、一致的代码。适用于简单任务，但可能重复且缺乏创造性。它不保证代码更好。 -* **高温：** 增加随机性，可能导致创造性解决方案，但也可能产生更多错误或无意义的代码。它不保证代码质量更高。 -* **准确性：** 代码准确性取决于模型的训练和提示的清晰度，而不是温度。 -* **温度 0.0：** 对一致性很有用，但限制了解决复杂问题所需的探索。 +* **低温度（接近 0.0）：** 生成可预测、一致的代码。适用于简单任务，但可能重复且缺乏创造力。它不能保证*更好*的代码。 +* **高温度：** 增加随机性，可能导致创造性解决方案，但也可能导致更多错误或无意义的代码。它不能保证*更高质量*的代码。 +* **准确性：** 代码准确性取决于模型的训练和提示清晰度，而不是温度。 +* **温度 0.0：** 有助于一致性，但限制了复杂问题所需的探索。 ::: ## Kilo Code 中的默认值 -Kilo Code 对大多数模型使用默认温度 0.0，优化代码生成的最大确定性和精确性。这适用于 OpenAI 模型、Anthropic 模型（非思考变体）、LM Studio 模型和大多数其他提供者。 +Kilo Code 对大多数模型使用 0.0 的默认温度，以优化代码生成的最大确定性和精度。这适用于 OpenAI 模型、Anthropic 模型（非思考变体）、LM Studio 模型和大多数其他提供商。 -一些模型使用更高的默认温度 - DeepSeek R1 模型和某些以推理为重点的模型默认温度为 0.6，在确定性和创造性探索之间提供了平衡。 +某些模型使用较高的默认温度——DeepSeek R1 模型和某些以推理为重点的模型默认为 0.6，在确定性和创造性探索之间取得了平衡。 -具有思考能力的模型（AI 显示其推理过程）需要固定的温度 1.0，无法更改，因为此设置确保了思考机制的最佳性能。这适用于任何启用了 ":thinking" 标志的模型。 +具有思考能力的模型（AI 显示其推理过程）需要固定温度 1.0，无法更改，因为此设置可确保思考机制的最佳性能。这适用于任何启用“:thinking”标志的模型。 -一些特殊模型根本不支持温度调整，在这种情况下，Kilo Code 会自动尊重这些限制。 +某些专业模型根本不支持温度调整，在这种情况下，Kilo Code 会自动遵守这些限制。 ## 何时调整温度 -以下是一些适用于不同任务的温度设置示例： +以下是一些可能适用于不同任务的温度设置示例： -* **代码模式（0.0-0.3）：** 用于编写精确、正确的代码，具有一致的确定性结果 -* **架构模式（0.4-0.7）：** 用于头脑风暴架构或设计解决方案，平衡创造性和结构 -* **问答模式（0.7-1.0）：** 用于需要多样化和有洞察力的响应的解释或开放式问题 -* **调试模式（0.0-0.3）：** 用于以一致的精确性排除故障 +* **代码模式 (0.0-0.3)：** 用于编写精确、正确的代码，具有一致、确定性的结果 +* **架构师模式 (0.4-0.7)：** 用于头脑风暴架构或设计解决方案，具有平衡的创造性和结构 +* **询问模式 (0.7-1.0)：** 用于需要多样化和有见地的解释或开放式问题 +* **调试模式 (0.0-0.3)：** 用于以一致的精度排除故障 -这些都是起点 - 重要的是[尝试不同的设置](#experimentation)以找到最适合你特定需求和偏好的设置。 +这些是起点——重要的是[尝试不同的设置](#experimentation)以找到最适合您特定需求和偏好的设置。 ## 如何调整温度 -1. **打开 Kilo Code 面板：** 点击 VS Code 侧边栏中的 Kilo Code 图标（） -2. **打开设置：** 点击右上角的 图标 -3. **找到温度控制：** 导航到提供者部分 -4. **启用自定义温度：** 勾选 "使用自定义温度" 复选框 -5. **设置你的值：** 将滑块调整为你偏好的值 +1. **打开 Kilo Code 面板：** 单击 VS Code 侧边栏中的 Kilo Code 图标（） +2. **打开设置：** 单击右上角的 图标 +3. **查找温度控制：** 导航到“提供商”部分 +4. **启用自定义温度：** 选中“使用自定义温度”框 +5. **设置您的值：** 将滑块调整到您喜欢的值 - Kilo Code 设置面板中的温度滑块 + Kilo Code 设置面板中的温度设置 *Kilo Code 设置面板中的温度滑块* -## 使用 API 配置配置文件设置温度 +## 使用 API 配置配置文件进行温度设置 创建多个具有不同温度设置的[API 配置配置文件](/features/api-configuration-profiles)： -**如何设置特定任务的温度配置文件：** +**如何设置任务特定温度配置文件：** -1. 创建专门配置文件，如 "代码 - 低温"（0.1）和 "问答 - 高温"（0.8） -2. 为每个配置文件配置适当的温度设置 -3. 使用设置或聊天界面中的下拉菜单在配置文件之间切换 -4. 为每个模式设置不同的默认配置文件，以便在更改模式时自动切换 +1. 创建专业配置文件，例如“代码 - 低温”（0.1）和“询问 - 高温”（0.8） +2. 为每个配置文件配置适当的温度设置 +3. 使用设置或聊天界面中的下拉菜单在配置文件之间切换 +4. 为每种模式设置不同的配置文件作为默认值，以便在切换模式时自动切换 -这种方法无需手动调整即可优化特定任务的模型行为。 +这种方法可以优化模型行为以适应特定任务，而无需手动调整。 ## 技术实现 -Kilo Code 实现温度处理时考虑以下因素： +Kilo Code 在实现温度处理时考虑了以下因素： -* 用户定义的设置优先于默认值 -* 尊重提供者特定的行为 +* 用户定义的设置优先于默认设置 +* 尊重提供商特定的行为 * 强制执行模型特定的限制： - * 启用思考的模型需要固定的温度 1.0 - * 一些模型不支持温度调整 + * 启用思考功能的模型需要固定温度 1.0 + * 某些模型不支持温度调整 ## 实验 -尝试不同的温度设置是发现最适合你特定需求的最有效方法： +尝试不同的温度设置是发现最适合您特定需求的最有效方法： ### 有效的温度测试 -1. **从默认值开始** - 以 Kilo Code 的预设值（大多数任务为 0.0）作为基线 -2. **逐步调整** - 以小步长（±0.1）更改值以观察细微差异 -3. **一致测试** - 在不同温度设置下使用相同的提示进行有效比较 -4. **记录结果** - 记下哪些值对特定类型的任务产生最佳结果 -5. **创建配置文件** - 将有效设置保存为[API 配置配置文件](/features/api-configuration-profiles)以便快速访问 +1. **从默认值开始** - 从 Kilo Code 的预设值（大多数任务为 0.0）作为您的基线 +2. **进行增量调整** - 以小步（±0.1）更改值以观察细微差异 +3. **一致测试** - 在不同的温度设置下使用相同的提示进行有效比较 +4. **记录结果** - 记录哪些值对特定类型的任务产生最佳结果 +5. **创建配置文件** - 将有效设置保存为[API 配置配置文件](/features/api-configuration-profiles)以便快速访问 -请记住，不同的模型可能对相同的温度值有不同的响应，而启用思考的模型无论你的设置如何，始终使用固定的温度 1.0。 +请记住，不同的模型可能对相同的温度值有不同的响应，并且启用思考功能的模型始终使用固定温度 1.0，无论您的设置如何。 ## 相关功能 -- 与 Kilo Code 支持的所有[API 提供者](/providers/openai)一起使用 -- 与[自定义指令](/advanced-usage/custom-instructions)相辅相成，用于微调响应 -- 与你创建的[自定义模式](/features/custom-modes)一起使用 \ No newline at end of file +- 适用于 Kilo Code 支持的所有 [API 提供商](/providers/openai) +- 补充[自定义指令](/advanced-usage/custom-instructions)以微调响应 +- 与您创建的[自定义模式](/features/custom-modes)一起使用 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/more-features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/more-features.md index e2c2d77..40730e6 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/more-features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/more-features.md @@ -1,26 +1,27 @@ --- -sidebar_label: 更多功能 +sidebar_label: Additional Features --- -# 更多功能 -本页面描述了 Kilo Code 中增强开发工作流程的更多功能。 +# 附加功能 -## 建议响应 +Kilo Code 的附加功能简化了日常任务并提高了可访问性。 -Kilo Code 提供问题的建议响应，节省你打字的时间。这些建议在提问后以按钮的形式出现在聊天输入框下方。点击建议即可快速将其用作你的下一个提示。 +## 建议回复 -此功能旨在通过预测你可能的后续问题并提供一键访问相关提示来简化你的工作流程。 +Kilo Code 提供建议回复，让您减少打字时间。 +- 提问后，聊天框下方会出现按钮。 +- 单击按钮可将其用作您的下一个提示。 ## 文本转语音 -Kilo Code 包含一个文本转语音（TTS）功能，可以朗读 AI 的响应，让你可以听取信息而不是阅读。这对于无障碍访问、学习或简单地改变节奏很有帮助。 - -要使用文本转语音功能，只需在 Kilo Code 设置中启用它。启用后，聊天中每个 AI 响应旁边都会出现一个扬声器图标。点击图标开始收听。 +文本转语音功能让 Kilo Code 可以朗读回复。 +1. 在设置中启用 TTS。 +2. 单击任何回复旁边的扬声器图标即可开始收听。 ## 全球语言支持 -Kilo Code 支持 14 种语言，使其对全球更广泛的用户群体更加易用。你现在可以使用以下语言的 Kilo Code： +Kilo Code 支持 14 种语言： - 简体中文 - 繁体中文 @@ -37,6 +38,4 @@ Kilo Code 支持 14 种语言，使其对全球更广泛的用户群体更加易 - 波兰语 - 加泰罗尼亚语 -要更改你的语言，请前往 Kilo Code 设置面板中的**高级设置 > 语言**。 - -此次全球更新确保了全球用户更流畅、更包容的编码体验。 \ No newline at end of file +在**高级设置 > 语言**下更改语言。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/settings-management.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/settings-management.md index 9a6e66d..b75c644 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/settings-management.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/settings-management.md @@ -1,60 +1,60 @@ --- title: 导入、导出和重置设置 sidebar_label: 导入/导出/重置设置 -description: 通过导出、导入或重置为默认值来管理你的 Kilo Code 设置。 +description: 通过导出、导入或重置为默认值来管理您的 Kilo Code 设置。 --- # 导入、导出和重置设置 -Kilo Code 允许你通过导出、导入和重置选项有效地管理配置设置。这些功能可用于备份设置、与他人共享配置或在需要时恢复默认设置。 +Kilo Code 允许您通过导出、导入和重置选项有效地管理您的配置设置。这些功能对于备份您的设置、与他人共享配置或在需要时恢复默认设置非常有用。 -你可以在 Kilo Code 设置页面的底部找到这些选项，通过 Kilo Code 聊天视图中的齿轮图标（）访问。 +您可以在 Kilo Code 设置页面的底部找到这些选项，通过 Kilo Code 聊天视图中的齿轮图标（）访问。 Kilo Code 设置中的导出、导入和重置按钮 *图片：导出、导入和重置按钮。* ## 导出设置 -点击**导出**按钮将你当前的 Kilo Code 设置保存为 JSON 文件。 +单击“**导出**”按钮会将您当前的 Kilo Code 设置保存到 JSON 文件中。 -* **导出的内容：** 文件包括你配置的 API 提供者配置文件和全局设置（UI 偏好、模式配置、上下文设置等）。 -* **安全警告：** 导出的 JSON 文件包含**所有**你配置的 API 提供者配置文件和全局设置。关键是，这包括**明文中的 API 密钥**。将此文件视为高度敏感。不要公开分享或与不受信任的个人分享，因为它授予访问你的 API 帐户的权限。 +* **导出内容：** 文件包含您配置的 API 提供商配置文件和全局设置（UI 首选项、模式配置、上下文设置等）。 +* **安全警告：** 导出的 JSON 文件包含**所有**您配置的 API 提供商配置文件和全局设置。至关重要的是，这包括**纯文本形式的 API 密钥**。请将此文件视为高度敏感。请勿公开或与不受信任的个人共享，因为它会授予对您的 API 帐户的访问权限。 * **过程：** - 1. 点击**导出**。 - 2. 出现文件保存对话框，建议文件名为 `kilo-code-settings.json`（通常在 `~/Documents` 文件夹中）。 - 3. 选择位置并保存文件。 + 1. 单击“**导出**”。 + 2. 出现文件保存对话框，建议将 `kilo-code-settings.json` 作为文件名（通常在您的 `~/Documents` 文件夹中）。 + 3. 选择位置并保存文件。 -这将创建配置的备份或可共享的文件。 +这将创建您的配置备份或您可以共享的文件。 ## 导入设置 -点击**导入**按钮允许你从之前导出的 JSON 文件加载设置。 +单击“**导入**”按钮允许您从以前导出的 JSON 文件加载设置。 * **过程：** - 1. 点击**导入**。 - 2. 出现文件打开对话框。选择要导入的 `kilo-code-settings.json` 文件（或类似命名的文件）。 - 3. Kilo Code 读取文件，根据预期模式验证其内容，并应用设置。 -* **合并：** 导入设置**合并**配置。它根据文件内容添加新的 API 配置文件并更新现有配置和全局设置。它不会删除当前设置中存在但导入文件中缺少的配置。 -* **验证：** 只有与内部模式匹配的有效设置才能被导入，防止配置错误。完成后会出现成功通知。 + 1. 单击“**导入**”。 + 2. 出现文件打开对话框。选择您要导入的 `kilo-code-settings.json` 文件（或类似名称的文件）。 + 3. Kilo Code 读取文件，根据预期模式验证其内容，并应用设置。 +* **合并：** 导入设置会**合并**配置。它会添加新的 API 配置文件并根据文件内容更新现有配置文件和全局设置。它**不会**删除您当前设置中存在但导入文件中缺失的配置。 +* **验证：** 只有与内部模式匹配的有效设置才能导入，从而防止配置错误。完成后会出现成功通知。 ## 重置设置 -点击**重置**按钮将完全清除所有 Kilo Code 配置数据并将扩展恢复到默认状态。这是一个破坏性操作，旨在进行故障排除或重新开始。 +单击“**重置**”按钮会完全清除所有 Kilo Code 配置数据，并将扩展恢复到其默认状态。这是一个破坏性操作，旨在用于故障排除或重新开始。 -* **警告：** 此操作是**不可逆的**。它永久删除所有 API 配置（包括存储在秘密存储中的密钥）、自定义模式、全局设置和任务历史记录。 +* **警告：** 此操作**不可逆**。它会永久删除所有 API 配置（包括存储在秘密存储中的密钥）、自定义模式、全局设置和任务历史记录。 * **过程：** - 1. 点击红色的**重置**按钮。 - 2. 出现确认对话框，警告此操作无法撤销。 - 3. 点击“是”确认。 + 1. 单击红色“**重置**”按钮。 + 2. 出现确认对话框，警告此操作无法撤消。 + 3. 单击“是”以确认。 -* **重置的内容：** - * **API 提供者配置文件：** 从设置和秘密存储中删除所有配置。 - * **全局设置：** 所有偏好（UI、模式、批准、浏览器等）重置为默认值。 - * **自定义模式：** 删除所有用户定义的模式。 - * **秘密存储：** 清除 Kilo Code 管理的所有 API 密钥和其他秘密。 - * **任务历史记录：** 清除当前任务堆栈。 +* **重置内容：** + * **API 提供商配置文件：** 所有配置都从设置和秘密存储中删除。 + * **全局设置：** 所有首选项（UI、模式、批准、浏览器等）都重置为默认值。 + * **自定义模式：** 所有用户定义的模式都删除。 + * **秘密存储：** Kilo Code 管理的所有 API 密钥和其他秘密都清除。 + * **任务历史记录：** 当前任务堆栈清除。 -* **结果：** Kilo Code 恢复到初始状态，就像刚安装一样，具有默认设置且没有用户配置。 +* **结果：** Kilo Code 返回到其初始状态，就像刚安装一样，具有默认设置且没有用户配置。 -仅在你确定要删除所有 Kilo Code 数据或在进行故障排除时被指示时使用此选项。如果以后可能需要恢复设置，请考虑先导出你的设置。 \ No newline at end of file +仅当您确定要删除所有 Kilo Code 数据或在故障排除期间收到指示时才使用此选项。如果您以后可能需要恢复设置，请考虑先导出您的设置。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/shell-integration.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/shell-integration.md index 6f832c0..4d7ce97 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/shell-integration.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/shell-integration.md @@ -1,153 +1,153 @@ # 终端 Shell 集成 -终端 Shell 集成是 Kilo Code 的核心功能，使其能够在您的终端执行命令并智能处理输出。这种 AI 与开发环境的双向通信解锁了强大的自动化能力。 +终端 Shell 集成是一项关键功能，它使 Kilo Code 能够在您的终端中执行命令并智能地处理其输出。AI 与您的开发环境之间的这种双向通信解锁了强大的自动化功能。 -## Shell 集成是什么？ +## 什么是 Shell 集成？ -Shell 集成在 Kilo Code 中自动启用，无需任何设置即可直接连接至终端命令执行生命周期。该内置功能允许 Kilo Code： +Shell 集成在 Kilo Code 中自动启用，并直接连接到您的终端命令执行生命周期，无需您进行任何设置。此内置功能允许 Kilo Code： -- 通过 [`execute_command`](/features/tools/execute-command) 工具代您执行命令 +- 通过 [`execute_command`](/features/tools/execute-command) 工具代表您执行命令 - 实时读取命令输出，无需手动复制粘贴 -- 自动检测并修复运行中的应用程序错误 -- 通过退出代码判断命令执行成败 -- 跟踪工作目录变化 -- 智能响应终端输出而无需用户干预 +- 自动检测并修复正在运行的应用程序中的错误 +- 观察命令退出代码以确定成功或失败 +- 在您导航项目时跟踪工作目录更改 +- 无需用户干预即可智能地响应终端输出 -当 Kilo Code 需要执行安装依赖、启动开发服务器或分析构建错误等任务时，Shell 集成会在后台确保交互流程顺畅高效。 +当 Kilo Code 需要执行安装依赖项、启动开发服务器或分析构建错误等任务时，shell 集成会在后台工作，使这些交互顺畅有效。 -## 开始使用 Shell 集成 +## Shell 集成入门 -Shell 集成已内置在 Kilo Code 中，多数情况下自动工作。若出现"Shell 集成不可用"提示或命令执行问题，可尝试以下解决方案： +Shell 集成内置于 Kilo Code 中，在大多数情况下会自动工作。如果您看到“Shell 集成不可用”消息或遇到命令执行问题，请尝试以下解决方案： -1. **更新 VSCode/Cursor** 至最新版本（要求 VSCode 1.93+） -2. **选择兼容的 Shell**：命令面板（`Ctrl+Shift+P` 或 `Cmd+Shift+P`）→ "Terminal: Select Default Profile" → 选择 bash、zsh、PowerShell 或 fish -3. **Windows PowerShell 用户**：运行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` 后重启 VSCode -4. **WSL 用户**：在 `~/.bashrc` 中添加 `. "$(code --locate-shell-integration-path bash)"` +1. **将 VSCode/Cursor 更新**到最新版本（需要 VSCode 1.93+） +2. **确保选择了兼容的 shell**：命令面板（`Ctrl+Shift+P` 或 `Cmd+Shift+P`）→ “终端：选择默认配置文件”→ 选择 bash、zsh、PowerShell 或 fish +3. **Windows PowerShell 用户**：运行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`，然后重新启动 VSCode +4. **WSL 用户**：将 `. "$(code --locate-shell-integration-path bash)"` 添加到您的 `~/.bashrc` ## 终端集成设置 -Kilo Code 提供多项设置来微调 Shell 集成。通过 Kilo Code 侧边栏的 Settings → Terminal 访问这些设置。 +Kilo Code 提供了几个设置来微调 shell 集成。在 Kilo Code 侧边栏的“设置”→“终端”下访问这些设置。 -### 基础设置 +### 基本设置 #### 终端输出限制 -终端输出限制滑块设置为500行 -控制从终端捕获的最大行数。超出限制时，保留开头20%和结尾80%的内容，中间显示截断提示。在保持上下文的同时避免过度消耗 token。默认值： 500 行。 -控制从终端捕获的最大行数。超出限制时，系统会从内容中间删除部分行以节省 token。默认值：500 行。 +终端输出限制滑块设置为 500 +控制从终端输出捕获的最大行数。超出时，它会保留开头 20% 和结尾 80%，中间有截断消息。这可以防止过度使用 token，同时保持上下文。默认值：500 行。 +控制从终端输出捕获的最大行数。超出时，会从中间删除行以节省 token。默认值：500 行。 -#### Shell 集成超时 -Shell集成超时滑块设置为15秒 +#### 终端 Shell 集成超时 +终端 shell 集成超时滑块设置为 15 秒 -等待 Shell 集成初始化的最长时间。若遇到"Shell 集成不可用"错误可增加此值。默认：15秒。 +在执行命令之前等待 shell 集成初始化的最长时间。如果您遇到“Shell 集成不可用”错误，请增加此值。默认值：15 秒。 #### 终端命令延迟 -终端命令延迟滑块设置为0毫秒 +终端命令延迟滑块设置为 0 毫秒 -在命令执行后添加短暂停顿，确保 Kilo Code 正确捕获所有输出。此设置对不同操作系统和 Shell 配置的可靠性影响显著： +在运行命令后添加一个短暂的暂停，以帮助 Kilo Code 正确捕获所有输出。由于 VSCode 在不同操作系统和 shell 配置中实现终端集成的方式，此设置可能会显著影响 shell 集成的可靠性： -- **默认值**：0毫秒 -- **常用值**： - * 0毫秒：新版 VSCode 用户最佳选择 - * 50毫秒：历史默认值，对多数用户仍有效 - * 150毫秒：PowerShell 用户推荐值 -- **注意**：最佳值可能取决于： +- **默认**：0 毫秒 +- **常见值**： + * 0 毫秒：对于某些使用较新 VSCode 版本的用户效果最佳 + * 50 毫秒：历史默认值，对许多用户仍然有效 + * 150 毫秒：推荐用于 PowerShell 用户 +- **注意**：不同的值可能更适合您的： * VSCode 版本 - * Shell 定制程度（如 oh-my-zsh、powerlevel10k 等） + * Shell 自定义（oh-my-zsh、powerlevel10k 等） * 操作系统和环境 ### 高级设置 -:::info 重要提示 -**修改后需重启终端** +:::info 重要 +**这些设置需要重新启动终端** -高级终端设置的变更仅在重启终端后生效。重启步骤： +高级终端设置的更改仅在重新启动终端后生效。要重新启动终端： -1. 点击终端面板的垃圾桶图标关闭当前终端 -2. 通过 Terminal → New Terminal 或 Ctrl+` 新建终端 +1. 单击终端面板中的垃圾桶图标以关闭当前终端 +2. 使用“终端”→“新建终端”或 Ctrl+`（反引号）打开新终端 -修改任何设置后请务必重启所有打开的终端。 +更改任何这些设置后，务必重新启动所有打开的终端。 ::: -#### PowerShell 计数器解决方案 -PowerShell计数器解决方案复选框 +#### PowerShell 计数器解决方法 +PowerShell 计数器解决方法复选框 -解决 PowerShell 连续执行相同命令的问题。若发现 Kilo Code 无法在 PowerShell 中连续运行相同命令，请启用此选项。 +帮助 PowerShell 连续多次运行相同的命令。如果您发现 Kilo Code 无法在 PowerShell 中连续运行相同的命令，请启用此功能。 #### 清除 ZSH EOL 标记 -清除ZSH行尾标记复选框 +清除 ZSH EOL 标记复选框 -阻止 ZSH 在输出行尾添加可能干扰 Kilo Code 读取结果的特殊字符。 +防止 ZSH 在输出行末尾添加特殊字符，这些字符在 Kilo Code 读取终端结果时可能会造成混淆。 #### Oh My Zsh 集成 -启用Oh My Zsh集成复选框 +启用 Oh My Zsh 集成复选框 -优化与流行 Shell 框架 [Oh My Zsh](https://ohmyz.sh/) 的兼容性。使用 Oh My Zsh 时若遇到终端问题请开启。 +使 Kilo Code 更好地与流行的 [Oh My Zsh](https://ohmyz.sh/) shell 自定义框架配合使用。如果您使用 Oh My Zsh 并遇到终端问题，请打开此功能。 #### Powerlevel10k 集成 -启用Powerlevel10k集成复选框 +启用 Powerlevel10k 集成复选框 -提升与 ZSH 主题 Powerlevel10k 的兼容性。若花哨的终端提示符导致问题请启用。 +如果您使用 ZSH 的 Powerlevel10k 主题，则可提高兼容性。如果您的花哨终端提示导致 Kilo Code 出现问题，请打开此功能。 #### ZDOTDIR 处理 -启用ZDOTDIR处理复选框 +启用 ZDOTDIR 处理复选框 -使 Kilo Code 能兼容自定义 ZSH 配置，同时不影响您的个人 Shell 设置。 +帮助 Kilo Code 与自定义 ZSH 配置配合使用，而不会干扰您的个人 shell 设置和自定义。 -## 故障排除 +## Shell 集成故障排除 -### PowerShell 执行策略（Windows） +### PowerShell 执行策略 (Windows) -PowerShell 默认限制脚本执行。配置方法： +PowerShell 默认限制脚本执行。要配置： -1. 以管理员身份打开 PowerShell -2. 查看当前策略：`Get-ExecutionPolicy` -3. 设置合适策略：`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` +1. 以管理员身份打开 PowerShell +2. 检查当前策略：`Get-ExecutionPolicy` +3. 设置适当的策略：`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` -常用策略： -- `Restricted`：禁止所有脚本（默认） -- `RemoteSigned`：本地脚本可运行，下载脚本需签名 -- `Unrestricted`：所有脚本带警告运行 -- `AllSigned`：所有脚本必须签名 +常见策略： +- `Restricted`：不允许任何脚本（默认） +- `RemoteSigned`：本地脚本可以运行；下载的脚本需要签名 +- `Unrestricted`：所有脚本都带警告运行 +- `AllSigned`：所有脚本都必须签名 -### 手动安装 Shell 集成 +### 手动 Shell 集成安装 -若自动集成失败，请将对应代码添加到 Shell 配置中： +如果自动集成失败，请将适当的行添加到您的 shell 配置中： -**Bash**（`~/.bashrc`）： +**Bash** (`~/.bashrc`)： ```bash [[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)" ``` -**Zsh**（`~/.zshrc`）： +**Zsh** (`~/.zshrc`)： ```bash [[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)" ``` -**PowerShell**（`$Profile`）： +**PowerShell** (`$Profile`)： ```powershell if ($env:TERM_PROGRAM -eq "vscode") { . "$(code --locate-shell-integration-path pwsh)" } ``` -**Fish**（`~/.config/fish/config.fish`）： +**Fish** (`~/.config/fish/config.fish`)： ```fish string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish) ``` -## 终端定制问题 +### 终端自定义问题 -若使用终端定制工具： +如果您使用终端自定义工具： **Powerlevel10k**： ```bash -# 在 ~/.zshrc 中 sourcing powerlevel10k 之前添加 +# 在 ~/.zshrc 中 source powerlevel10k 之前添加 typeset -g POWERLEVEL9K_TERM_SHELL_INTEGRATION=true ``` -**替代方案**：在 Kilo Code 设置中启用 Powerlevel10k 集成选项 +**替代方案**：在 Kilo Code 设置中启用 Powerlevel10k 集成设置。 -## Shell 集成状态验证 +### 验证 Shell 集成状态 -使用以下命令确认集成是否激活： +使用以下命令确认 shell 集成处于活动状态： **Bash**： ```bash @@ -174,209 +174,209 @@ functions | grep -i vsc functions fish_prompt | grep -i vsc ``` -集成激活的视觉指示： -1. 终端标题栏中的集成标识 -2. 命令检测高亮显示 -3. 终端标题中的工作目录更新 -4. 命令执行时间和退出码显示 - -## WSL 终端集成方案 - -使用 Windows Subsystem for Linux (WSL) 时，有两种集成方式： - -### 方案1：Windows版VSCode + WSL终端 -特点： -- VSCode 运行于 Windows -- 使用 WSL 终端桥接 -- 需手动确保 WSL 环境中加载了集成脚本： - ```bash - source "$(code --locate-shell-integration-path )" - ``` - -### 方法二：在WSL中运行VSCode - -在此设置中： -- 你可以使用 `code .` 命令直接从WSL中启动VSCode -- VSCode服务端在Linux环境中本地运行 -- 可直接访问Linux文件系统和工具 -- 为Shell集成提供更好的性能和可靠性 -- 由于VSCode在Linux环境中本地运行，Shell集成会自动加载 -- 这是WSL开发的推荐方式 - -要实现WSL的最佳Shell集成，我们建议： -1. 打开你的WSL发行版 -2. 导航到项目目录 -3. 使用 `code .` 启动VSCode -4. 使用VSCode内的集成终端 - -## 常见问题解决方案 - -### Windows 上 Fish + Cygwin 的 VS Code Shell 集成 - -对于在 Cygwin 环境中运行 Fish 终端的 Windows 用户，以下是配置 VS Code Shell 集成的方法： - -1. **（可选）定位 Shell 集成脚本** - 在 **VS Code 内**打开 Fish 终端并执行： - ```bash - code --locate-shell-integration-path fish - ``` - 该命令会输出 `shellIntegration.fish` 脚本的路径，请记录此路径。 - -2. **更新 Fish 配置** - 编辑 `config.fish` 文件（通常位于 Cygwin 主目录下的 `~/.config/fish/config.fish`）。添加以下行，建议放在 `if status is-interactive` 块内或文件末尾： - - ```fish - # 示例 config.fish 结构 - if status is-interactive - # 其他交互式 shell 配置... - # 自动定位集成脚本： - string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish) - - # 若上述方法失败： - # 手动引入 VS Code shell 集成脚本 - # 重要：将下方示例路径替换为步骤 1 中获取的实际路径 - # 确保路径格式符合 Cygwin 规范（例如 /cygdrive/c/...） - # source "/cygdrive/c/Users/你的用户名/.vscode/extensions/..../shellIntegration.fish" - end - ``` - *请将示例路径替换为步骤 1 中的实际路径，并确保格式符合 Cygwin 要求。* - -3. **配置 VS Code 终端配置文件** - 打开 VS Code 的 `settings.json` 文件（Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"）。在 `terminal.integrated.profiles.windows` 下更新或添加 Fish 配置文件： - - ```json - { - // ... 其他设置 ... - - "terminal.integrated.profiles.windows": { - // ... 其他配置文件 ... - - // 推荐：使用 bash.exe 以登录 shell 方式启动 fish - "fish": { - "path": "C:\\cygwin64\\bin\\bash.exe", // 或你的 Cygwin bash 路径 - "args": [ - "--login", // 确保执行登录脚本（对 Cygwin 环境很重要） - "-i", // 确保 bash 以交互模式运行 - "-c", - "exec fish" // 用 fish 替换 bash 进程 - ], - "icon": "terminal-bash" // 可选：使用可识别的图标 - }, - // 备选方案（若上述方法失败）：直接启动 fish - "fish-direct": { - "path": "C:\\cygwin64\\bin\\fish.exe", // 确保此路径在 Windows PATH 中或提供完整路径 - // 此处使用 'options' 而非 'args'，否则可能遇到 "终端进程终止，退出代码 1" 错误 - "options": ["-l", "-c"], // 示例：登录和交互标志 - "icon": "terminal-fish" // 可选：使用 fish 图标 - } - }, - - // 可选：如需将 fish 设置为默认终端 - // "terminal.integrated.defaultProfile.windows": "fish", // 或 "fish-direct"，取决于你使用的配置 - - // ... 其他设置 ... - } - ``` - *注意：在 Cygwin 环境中，使用 `bash.exe --login -i -c "exec fish"` 通常能更可靠地确保在启动 `fish` 前正确设置环境。但若此方法无效，请尝试 `fish-direct` 配置文件。* - -4. **重启 VS Code** - 完全关闭并重新打开 Visual Studio Code 以应用更改。 - -5. **验证配置** - 在 VS Code 中打开新的 Fish 终端。Shell 集成功能（如命令装饰、更便捷的命令历史导航等）应已激活。你可以通过运行简单命令（如 `echo "Hello from integrated Fish!"`）测试基本功能。 - Fish Cygwin 集成示例 - -此配置在使用 Cygwin、Fish 和 Starship 提示符的 Windows 系统上运行稳定，适用于类似环境的用户。 - -### VSCode 1.98 之后 Shell 集成失败问题 - -**问题描述**：在将 VSCode 更新到 1.98 版本之后，Shell 集成功能可能会失效，并显示错误信息 "VSCE output start escape sequence (]633;C or ]133;C) not received"。 +活动 shell 集成的视觉指示器： +1. 终端标题栏中的 shell 集成指示器 +2. 命令检测高亮显示 +3. 终端标题中的工作目录更新 +4. 命令持续时间和退出代码报告 -**解决方案**： -1. **设置终端命令延迟** - - 在 Kilo Code 设置中将终端命令延迟（Terminal Command Delay）设为 50ms - - 修改设置后重启所有终端 - - 该设置模拟了旧版本的默认行为，可能会解决问题。不过部分用户反馈设为 0ms 效果更好。这是针对 VSCode 上游问题的临时解决方案 +## WSL 终端集成方法 + +使用 Windows Subsystem for Linux (WSL) 时，有两种不同的方法可以使用 VSCode 和 WSL，每种方法对 shell 集成都有不同的影响： + +### 方法 1：VSCode Windows 与 WSL 终端 -2. **回退 VSCode 版本** - - 从 [VSCode 更新页面](https://code.visualstudio.com/updates/v1_98) 下载 VSCode v1.98 版本 - - 替换当前的 VSCode 安装 - - 无需备份 Kilo 设置 +在此设置中： +- VSCode 在 Windows 中原生运行 +- 您在 VSCode 中使用 WSL 终端集成功能 +- Shell 命令通过 WSL 桥接执行 +- 由于 Windows-WSL 通信，可能会出现额外的延迟 +- Shell 集成标记可能会受到 WSL-Windows 边界的影响：您必须确保在 WSL 环境中为您的 shell 加载 `source "$(code --locate-shell-integration-path )"`，因为它可能不会自动加载；请参阅上文。 -3. **WSL 专用解决方案** - - 如果使用 WSL，请确保通过 `code .` 命令从 WSL 内部启动 VSCode +### 方法 2：VSCode 在 WSL 中运行 -4. **ZSH 用户** - - 尝试在 Kilo Code 设置中启用部分或全部与 ZSH 相关的解决方案 - - 无论使用何种操作系统，这些设置都可能有所帮助 +在此设置中： +- 您直接从 WSL 中使用 `code .` 启动 VSCode +- VSCode 服务器在 Linux 环境中原生运行 +- 直接访问 Linux 文件系统和工具 +- 更好的 shell 集成性能和可靠性 +- Shell 集成会自动加载，因为 VSCode 在 Linux 环境中原生运行 +- WSL 开发的推荐方法 + +为了与 WSL 实现最佳 shell 集成，我们建议： +1. 打开您的 WSL 发行版 +2. 导航到您的项目目录 +3. 使用 `code .` 启动 VSCode +4. 使用 VSCode 中的集成终端 ## 已知问题与解决方法 -### Ctrl+C 行为问题 +### 针对 Windows 上 Fish + Cygwin 的 VS Code Shell 集成 + +对于在 Cygwin 环境中运行 Fish 终端的 Windows 用户，以下是 VS Code shell 集成的配置方法： + +1. **（可选）定位 Shell 集成脚本：** + 在 *VS Code 内* 打开您的 Fish 终端并运行以下命令： + ```bash + code --locate-shell-integration-path fish + ``` + 这会输出 `shellIntegration.fish` 脚本的路径。请记下此路径。 + +2. **更新您的 Fish 配置：** + 编辑您的 `config.fish` 文件（通常位于 Cygwin 主目录下的 `~/.config/fish/config.fish`）。添加以下行，最好放在 `if status is-interactive` 代码块内或文件的末尾： + + ```fish + # config.fish 结构示例 + if status is-interactive + # 您的其他交互式 shell 配置... + # 自动定位集成脚本： + string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish) + + # 或者，如果上述方法对您无效： + # 加载 VS Code shell 集成脚本 + # 重要提示：请将下面的示例路径替换为您在第 1 步中找到的实际路径。 + # 确保路径格式是 Cygwin 可以识别的（例如，使用 /cygdrive/c/...）。 + # source "/cygdrive/c/Users/YourUser/.vscode/extensions/..../shellIntegration.fish" + end + ``` + *请记得将示例路径替换为第 1 步中获得的实际路径，并确保其格式适用于 Cygwin。* + +3. **配置 VS Code 终端配置文件：** + 打开您的 VS Code `settings.json` 文件（Ctrl+Shift+P -\> "首选项: 打开用户设置 (JSON)"）。在 `terminal.integrated.profiles.windows` 下更新或添加 Fish 配置文件，如下所示： + + ```json + { + // ... 其他设置 ... + + "terminal.integrated.profiles.windows": { + // ... 其他配置文件 ... + + // 推荐：使用 bash.exe 以登录 shell 方式启动 fish + "fish": { + "path": "C:\\cygwin64\\bin\\bash.exe", // 或您的 Cygwin bash 路径 + "args": [ + "--login", // 确保登录脚本运行（对 Cygwin 环境很重要） + "-i", // 确保 bash 以交互模式运行 + "-c", + "exec fish" // 将 bash 进程替换为 fish + ], + "icon": "terminal-bash" // 可选：使用一个易于识别的图标 + } + // 备选方案（如果上述方法失败）：直接启动 fish + "fish-direct": { + "path": "C:\\cygwin64\\bin\\fish.exe", // 确保此路径在您的 Windows PATH 中或提供完整路径 + // 此处使用 'options' 而非 'args'；否则可能会遇到“终端进程已终止，退出代码 1”的错误。 + "options": ["-l", "-c"], // 示例：登录和交互式标志 + "icon": "terminal-fish" // 可选：使用 fish 图标 + } + }, + + // 可选：如果需要，将 fish 设置为默认终端 + // "terminal.integrated.defaultProfile.windows": "fish", // 或 "fish-direct"，取决于您使用的配置 + + // ... 其他设置 ... + } + ``` + *注意：在 Cygwin 环境中，使用 `bash.exe --login -i -c "exec fish"` 通常更可靠，可以确保在 `fish` 启动前正确设置环境。但是，如果该方法无效，请尝试 `fish-direct` 配置文件。* + +4. **重启 VS Code：** + 完全关闭并重新打开 Visual Studio Code 以应用更改。 + +5. **验证：** + 在 VS Code 中打开一个新的 Fish 终端。Shell 集成功能（如命令修饰、更好的命令历史导航等）现在应该已激活。您可以通过运行像 `echo "Hello from integrated Fish!"` 这样的简单命令来测试基本功能。 \Fish Cygwin Integration Example + +此设置在使用 Cygwin、Fish 和 Starship 提示符的 Windows 系统上运行稳定，并应能帮助有类似配置的用户。 + + +### VSCode 1.98 版本后 Shell 集成失败 + +**问题**：VSCode 更新到 1.98 以上版本后，shell 集成可能会失败，并显示错误 “VSCE output start escape sequence (]633;C or ]133;C) not received”。 + +**解决方案**： +1. **设置终端命令延迟**： + - 在 Kilo Code 设置中将“终端命令延迟”设置为 50 毫秒。 + - 更改此设置后，重启所有终端。 + - 这与旧版的默认行为匹配，可能解决问题，但有用户报告称设置为 0 毫秒效果更好。这是针对上游 VSCode 问题的解决方法。 + +2. **回退 VSCode 版本**： + - 从 [VSCode 更新页面](https://code.visualstudio.com/updates/v1_98) 下载 VSCode v1.98。 + - 替换您当前的 VSCode 安装。 + - 无需备份 Kilo 设置。 + +3. **WSL 特定解决方法**： + - 如果使用 WSL，请确保您是从 WSL 内部通过 `code .` 命令启动 VSCode。 + +4. **ZSH 用户**： + - 尝试在 Kilo Code 设置中启用部分或全部 ZSH 相关的解决方法。 + - 无论您的操作系统是什么，这些设置都可能有所帮助。 + +## 已知问题及解决方法 + +### Ctrl+C 的行为 -**问题描述**：当 Kilo Code 尝试在终端中执行命令时，如果终端中已有输入的文本，Kilo Code 会先按下 Ctrl+C 清除当前行，这可能会中断正在运行的进程。 +**问题**：当 Kilo Code 尝试运行命令时，如果终端中已经输入了文本，Kilo Code 会先按 Ctrl+C 来清空当前行，这可能会中断正在运行的进程。 -**解决方法**：在让 Kilo Code 执行终端命令之前，确保终端提示符为空（没有输入任何部分命令）。 +**解决方法**：在要求 Kilo Code 执行终端命令之前，请确保您的终端提示符是空的（没有输入任何部分命令）。 ### 多行命令问题 -**问题描述**：跨越多行的命令可能会让 Kilo Code 产生混淆，导致当前命令的输出中混入之前命令的输出。 +**问题**：跨多行的命令可能会让 Kilo Code 混淆，并可能将先前命令的输出与当前输出混合在一起。 -**解决方法**：避免使用多行命令，而是使用 `&&` 进行命令链，将所有操作放在同一行（例如，使用 `echo a && echo b` 代替分行输入每个命令）。 +**解决方法**：不要使用多行命令，而是使用 `&&` 进行命令链接，将所有内容保持在一行（例如，使用 `echo a && echo b`，而不是分行输入每个命令）。 ### PowerShell 特定问题 -1. **过早完成**：PowerShell 有时会在命令输出全部显示之前就告诉 Kilo Code 命令已完成。 -2. **重复命令拒绝执行**：PowerShell 可能会拒绝连续两次执行相同的命令。 +1. **过早完成**：PowerShell 有时会在所有输出显示完毕前就通知 Kilo Code 命令已完成。 +2. **重复命令**：PowerShell 可能会拒绝连续两次运行相同的命令。 -**解决方法**：启用 "PowerShell counter workaround" 设置，并在设置中将终端命令延迟（Terminal Command Delay）设为 150ms，以给命令更多的执行时间。 +**解决方法**：启用“PowerShell 计数器解决方法”设置，并在设置中将终端命令延迟设置为 150 毫秒，以便为命令留出更多完成时间。 ### 终端输出不完整 -**问题描述**：有时 VS Code 不会显示或捕获命令的全部输出。 +**问题**：有时 VS Code 不会显示或捕获命令的全部输出。 -**解决方法**：如果发现输出缺失，尝试关闭并重新打开终端标签，然后再次运行命令。这会刷新终端连接。 +**解决方法**：如果您发现输出缺失，请尝试关闭并重新打开终端选项卡，然后再次运行该命令。这会刷新终端连接。 ## 故障排除资源 -### 查看调试日志 -当发生 shell 集成问题时，检查调试日志： -1. 打开 "帮助" → "切换开发者工具" → "控制台" -2. 设置 "显示所有级别" 以查看所有日志消息 -3. 查找包含 `[Terminal Process]` 的消息 -4. 检查错误消息中的 `preOutput` 内容： - - 空的 preOutput (`''`) 表示 VSCode 没有发送任何数据 - - 这可能表示存在 VSCode shell 集成问题，或无法控制的上游错误 - - 缺少 shell 集成标记可能需要调整设置，以解决可能的上游错误或与 shell 初始化和 VSCode 加载特殊 shell 集成钩子相关的本地工作站配置问题 - -### 使用 VSCode 终端集成测试扩展 - -[VSCode 终端集成测试扩展](https://github.com/KJ7LNW/vsce-test-terminal-integration) 可以通过测试不同的设置组合来帮助诊断 shell 集成问题： - -1. **命令停滞时**： - - 如果你看到 "command already running" 警告，点击 "Reset Stats" 重置终端状态 - - 这些警告表明 shell 集成未正常工作 - - 尝试不同的设置组合，直到找到有效的配置 - - 如果终端确实卡住了，通过关闭窗口并按 F5 重启扩展 - -2. **测试设置**： - - 系统地尝试不同的组合： - * 终端命令延迟（Terminal Command Delay） - * Shell 集成设置 - - 记录哪些组合成功或失败 - - 这有助于识别 shell 集成问题的模式 - -3. **报告问题**： - - 一旦发现有问题的配置 - - 记录确切的设置组合 - - 记录你的环境信息（操作系统、VSCode 版本、shell 类型以及任何 shell 提示符自定义设置） - - 使用这些详细信息创建一个问题，以帮助改进 shell 集成 +### 检查调试日志 +当出现 shell 集成问题时，请检查调试日志： +1. 打开“帮助” → “切换开发人员工具” → “控制台”。 +2. 将日志级别设置为“显示所有级别”以查看所有日志消息。 +3. 查找包含 `[Terminal Process]` 的消息。 +4. 检查错误消息中的 `preOutput` 内容： + - 空的 `preOutput` (`''`) 意味着 VSCode 没有发送任何数据。 + - 这表明可能存在 VSCode shell 集成问题，或者是我们无法控制的上游 bug。 + - 缺少 shell 集成标记可能需要调整设置，以解决与 shell 初始化和 VSCode 加载特殊 shell 集成钩子相关的上游 bug 或本地工作站配置问题。 + +### 使用 VSCode Terminal Integration Test 扩展 +[VSCode Terminal Integration Test 扩展](https://github.com/KJ7LNW/vsce-test-terminal-integration) 通过测试不同的设置组合来帮助诊断 shell 集成问题： + + +1. **当命令卡住时**： + - 如果您看到“命令已在运行”的警告，请单击“重置统计信息”以重置终端状态。 + - 这些警告表明 shell 集成未正常工作。 + - 尝试不同的设置组合，直到找到一个可行的。 + - 如果问题确实卡住了，通过关闭窗口并按 F5 来重启扩展。 + +2. **测试设置**： + - 系统地尝试以下设置的不同组合： + * 终端命令延迟 + * Shell 集成设置 + - 记录哪些组合成功或失败。 + - 这有助于识别 shell 集成问题的模式。 + +3. **报告问题**： + - 一旦找到有问题的配置。 + - 记录下确切的设置组合。 + - 注明您的环境（操作系统、VSCode 版本、shell 以及任何 shell 提示符自定义）。 + - 提交一个包含这些详细信息的问题，以帮助改进 shell 集成。 ## 支持 -如果你已按照上述步骤操作但仍然遇到问题，请： +如果您已遵循上述步骤但仍遇到问题，请： -1. 查看 [Kilo Code GitHub 问题](https://github.com/Kilo-Org/kilocode/issues)，看是否有其他用户报告过类似问题 -2. 如果没有，请创建一个新问题，详细说明你的操作系统、VSCode/Cursor 版本以及你尝试过的步骤 +1. 查看 [Kilo Code GitHub Issues](https://github.com/Kilo-Org/kilocode/issues) 页面，看是否有人报告了类似的问题。 +2. 如果没有，请创建一个新 issue，并提供有关您的操作系统、VSCode/Cursor 版本以及您已尝试过的步骤的详细信息。 -如需更多帮助，请加入我们的 [Discord](https://kilocode.ai/discord)。 \ No newline at end of file +如需更多帮助，请加入我们的 [Discord](https://kilocode.ai/discord)。如需其他帮助，请加入我们的 [Discord](https://kilocode.ai/discord)。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/slash-commands/workflows.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/slash-commands/workflows.mdx new file mode 100644 index 0000000..e9e648d --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/slash-commands/workflows.mdx @@ -0,0 +1,88 @@ +--- +title: "工作流" +sidebarTitle: "工作流" +--- + +Workflows 通过为 Kilo Code 定义分步指令来自动化重复性任务。通过在聊天中键入 `/[workflow-name.md]` 来调用任何工作流。 + +Kilo Code 中的工作流选项卡 + +## 创建工作流 + +工作流是存储在 `.kilocode/workflows/` 中的 markdown 文件： +- **全局工作流**：`~/.kilocode/workflows/`（在所有项目中可用） +- **项目工作流**：`[project]/.kilocode/workflows/`（项目特定） + +### 基本设置 + +1. 创建一个包含分步指令的 `.md` 文件 +2. 将其保存在您的工作流目录中 +3. 键入 `/filename.md` 执行 + +### 工作流功能 + +工作流可以利用： +- [内置工具](/features/tools/tool-use-overview)：[`read_file()`](/features/tools/read-file)、[`search_files()`](/features/tools/search-files)、[`execute_command()`](/features/tools/execute-command) +- CLI 工具：`gh`、`docker`、`npm`、自定义脚本 +- [MCP 集成](/features/mcp/overview)：Slack、数据库、API +- [模式切换](/basic-usage/using-modes)：[`new_task()`](/features/tools/new-task) 用于专业上下文 + +## 常见工作流模式 + +**发布管理** +```markdown +1. 收集自上次发布以来合并的 PR +2. 从提交消息生成更新日志 +3. 更新版本号 +4. 创建发布分支和标签 +5. 部署到 staging 环境 +``` + +**项目设置** +```markdown +1. 克隆仓库模板 +2. 安装依赖项（`npm install`、`pip install -r requirements.txt`） +3. 配置环境文件 +4. 初始化数据库/服务 +5. 运行初始测试 +``` + +**代码审查准备** +```markdown +1. 搜索 TODO 注释和 debug 语句 +2. 运行 linting 和格式化 +3. 执行测试套件 +4. 从最近的提交生成 PR 描述 +``` + +## 示例：PR 提交工作流 + +让我们逐步创建一个用于提交拉取请求的工作流。此工作流处理从代码审查到部署通知的整个过程。 + +在您的 `.kilocode/workflows` 目录中创建一个名为 `submit-pr.md` 的文件： + +```markdown +# 提交 PR 工作流 + +您正在帮助提交拉取请求。请按照以下步骤操作： + +1. 首先，使用 `search_files` 检查是否有任何不应提交的 TODO 注释或 console.log 语句 +2. 使用 `execute_command` 运行测试，使用 `npm test` 或适当的测试命令 +3. 如果测试通过，则暂存并提交更改，并附上描述性提交消息 +4. 使用 `gh pr create` 推送分支并创建拉取请求 +5. 使用 `ask_followup_question` 从用户那里获取 PR 标题和描述 + +所需参数（如果未提供则询问）： +- 分支名称 +- 要分配的审阅者 +``` + +现在您可以通过在聊天中键入 `/submit-pr.md` 来触发此工作流。Kilo Code 将： + +- 在提交之前扫描您的代码以查找常见问题 +- 运行您的测试套件以尽早发现问题 +- 处理 Git 操作和 PR 创建 +- 自动通知您的团队 +- 设置部署的后续任务 + +这使您无需手动运行相同的 7 步过程，每次您想提交代码进行审查时。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/suggested-responses.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/suggested-responses.md index 2f51047..af2196b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/suggested-responses.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/suggested-responses.md @@ -1,45 +1,45 @@ --- -sidebar_label: 建议响应 +sidebar_label: Suggested Responses --- import Codicon from '@site/src/components/Codicon'; -# 建议响应 +# 建议回复 -当 Kilo Code 需要更多信息来完成任务时，它会使用 [`ask_followup_question` 工具](/features/tools/ask-followup-question)。为了更轻松、更快速地响应，Kilo Code 通常会提供建议答案。 +当 Kilo Code 需要更多信息来完成任务时，它会使用 [`ask_followup_question` 工具](/features/tools/ask-followup-question)。为了使回复更轻松、更快捷，Kilo Code 通常会在问题旁边提供建议答案。 ## 概述 -建议响应以可点击按钮的形式出现在 Kilo Code 问题下方的聊天界面中。它们提供了与问题相关的预制答案，帮助你快速提供输入。 +建议回复以可点击按钮的形式直接显示在 Kilo Code 问题下方，位于聊天界面中。它们提供与问题相关的预设答案，帮助您快速提供输入。 -Kilo Code 提问并附有建议响应按钮的示例 +Kilo Code 提问并显示建议回复按钮的示例 ## 工作原理 1. **问题出现**：Kilo Code 使用 `ask_followup_question` 工具提问。 -2. **显示建议**：如果 Kilo Code 提供了建议，它们会以按钮的形式出现在问题下方。 -3. **交互**：你可以通过两种方式与这些建议进行交互。 +2. **显示建议**：如果 Kilo Code 提供了建议，它们将作为按钮显示在问题下方。 +3. **交互**：您可以通过两种方式与这些建议进行交互。 ## 与建议交互 -你有两种使用建议响应的选项： +您有两种使用建议回复的选项： 1. **直接选择**： - * **操作**：只需点击包含你想要提供的答案的按钮。 - * **结果**：选定的答案会立即作为你的响应发送回 Kilo Code。如果某个建议完全符合你的意图，这是最快的回复方式。 + * **操作**：只需单击包含您要提供的答案的按钮。 + * **结果**：选定的答案会立即作为您的回复发送回 Kilo Code。如果其中一个建议完全符合您的意图，这是最快的回复方式。 2. **发送前编辑**： - * **操作**： - * 按住 `Shift` 并点击建议按钮。 - * *或者*，将鼠标悬停在建议按钮上，点击出现的铅笔图标（）。 - * **结果**：建议的文本会复制到聊天输入框中。然后你可以根据需要修改文本，然后按下 Enter 键发送自定义的响应。当建议接近但需要稍作调整时，这很有用。 + * **操作**： + * 按住 `Shift` 并单击建议按钮。 + * *或者*，将鼠标悬停在建议按钮上，然后单击出现的铅笔图标（）。 + * **结果**：建议的文本被复制到聊天输入框中。您可以在按 Enter 键发送自定义回复之前根据需要修改文本。当建议接近但需要微调时，这很有用。 -聊天输入框显示从建议响应复制的文本，准备编辑 +聊天输入框显示从建议回复中复制的文本，准备编辑 -## 优势 +## 优点 -* **速度**：无需输入完整答案即可快速响应。 -* **清晰度**：建议通常阐明了 Kilo Code 所需的信息类型。 -* **灵活性**：在需要时编辑建议以提供精确、自定义的答案。 +* **速度**：无需输入完整答案即可快速回复。 +* **清晰度**：建议通常会阐明 Kilo Code 需要的信息类型。 +* **灵活性**：根据需要编辑建议以提供精确、自定义的答案。 -此功能在 Kilo Code 需要澄清时简化了交互，让你能够以最少的努力有效地指导任务。 \ No newline at end of file +此功能简化了 Kilo Code 需要澄清时的交互，让您能够以最少的精力有效指导任务。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/apply-diff.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/apply-diff.md index 42bc305..193850e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/apply-diff.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/apply-diff.md @@ -6,10 +6,10 @@ 该工具接受以下参数： -- `path`（必填）：要修改的文件路径，相对于当前工作目录。 -- `diff`（必填）：使用特定于活动diff策略的格式定义更改的搜索/替换块。 -- `start_line`（可选）：搜索内容开始的提示，某些策略会使用。 -- `end_line`（可选）：搜索内容结束的提示，某些策略会使用。 +- `path`（必填）：相对于当前工作目录要修改的文件的路径。 +- `diff`（必填）：定义更改的搜索/替换块。**对于所有当前实现的策略，diff 内容格式中必须包含行号**。 + +**注意**：虽然系统设计为可扩展不同的 diff 策略，但所有当前实现的策略都要求在 diff 内容本身中使用 `:start_line:` 标记指定行号。 ## 功能 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/codebase-search.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/codebase-search.md new file mode 100644 index 0000000..6430861 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/codebase-search.md @@ -0,0 +1,244 @@ +# codebase_search + +:::info 需要设置 +`codebase_search` 工具是[代码库索引](/features/codebase-indexing)功能的一部分。它需要额外的设置，包括嵌入提供商和向量数据库。 +::: + +`codebase_search` 工具使用 AI 嵌入对整个代码库执行语义搜索。与传统的基于文本的搜索不同，它理解您查询的含义，即使关键字不完全匹配，也能找到相关代码。 + +--- + +## 参数 + +该工具接受以下参数： + +- `query`（必需）：描述您要查找内容的自然语言搜索查询 +- `path`（可选）：目录路径，用于将搜索范围限制在代码库的特定部分 + +--- + +## 作用 + +此工具通过语义相似性而不是精确文本匹配来搜索您的索引代码库。它会找到与您的查询概念相关的代码块，即使它们不包含您搜索的精确单词。结果包括相关的代码片段，以及文件路径、行号和相似度分数。 + +--- + +## 何时使用？ + +- 当 Kilo Code 需要在您的项目中查找与特定功能相关的代码时 +- 当查找实现模式或相似的代码结构时 +- 当搜索错误处理、身份验证或其他概念性代码模式时 +- 当探索不熟悉的代码库以了解功能如何实现时 +- 当查找可能受更改或重构影响的相关代码时 + +--- + +## 主要功能 + +- **语义理解**：通过含义查找代码，而不仅仅是关键字匹配 +- **跨项目搜索**：搜索整个索引代码库，而不仅仅是打开的文件 +- **上下文结果**：返回带有文件路径和行号的代码片段，便于导航 +- **相似度评分**：结果按相关性排序，并带有相似度分数（0-1 范围） +- **范围过滤**：可选的路径参数，用于将搜索限制在特定目录 +- **智能排名**：结果按与您的查询的语义相关性排序 +- **UI 集成**：结果显示语法高亮和导航链接 +- **性能优化**：快速的基于向量的搜索，具有可配置的结果限制 + +--- + +## 要求 + +此工具仅在正确配置代码库索引功能时可用： + +- **功能已配置**：必须在设置中配置代码库索引 +- **嵌入提供商**：需要 OpenAI API 密钥或 Ollama 配置 +- **向量数据库**：Qdrant 实例正在运行且可访问 +- **索引状态**：代码库必须已索引（状态：“已索引”或“正在索引”） + +--- + +## 限制 + +- **需要配置**：依赖于外部服务（嵌入提供商 + Qdrant） +- **索引依赖**：仅搜索索引代码块 +- **结果限制**：每次搜索最多 50 个结果以保持性能 +- **相似度阈值**：仅返回高于相似度阈值的结果（默认：0.4，可配置） +- **文件大小限制**：仅限于成功索引的 1MB 以下的文件 +- **语言支持**：有效性取决于 Tree-sitter 语言支持 + +--- + +## 工作原理 + +当调用 `codebase_search` 工具时，它遵循以下过程： + +1. **可用性验证**： + - 验证 CodeIndexManager 是否可用并已初始化 + - 确认设置中已启用代码库索引 + - 检查索引是否已正确配置（API 密钥、Qdrant URL） + - 验证当前索引状态是否允许搜索 + +2. **查询处理**： + - 获取您的自然语言查询并生成嵌入向量 + - 使用与索引配置相同的嵌入提供商（OpenAI 或 Ollama） + - 将查询的语义含义转换为数学表示 + +3. **向量搜索执行**： + - 在 Qdrant 向量数据库中搜索相似的代码嵌入 + - 使用余弦相似度查找最相关的代码块 + - 应用最小相似度阈值（默认：0.4，可配置）以过滤结果 + - 将结果限制为 50 个匹配项以获得最佳性能 + +4. **路径过滤**（如果指定）： + - 过滤结果以仅包含指定目录路径中的文件 + - 使用规范化路径比较进行准确过滤 + - 在过滤范围内保持相关性排名 + +5. **结果处理和格式化**： + - 将绝对文件路径转换为工作区相对路径 + - 使用文件路径、行范围、相似度分数和代码内容构建结果 + - 格式化以供 AI 消费和 UI 显示，并带有语法高亮 + +6. **双重输出格式**： + - **AI 输出**：带有查询、文件路径、分数和代码块的结构化文本格式 + - **UI 输出**：带有语法高亮和导航功能的 JSON 格式 + +--- + +## 搜索查询最佳实践 + +### 有效查询模式 + +**好：概念性和具体性** +```xml + +用户身份验证和密码验证 + +``` + +**好：以功能为中心** +```xml + +数据库连接池设置 + +``` + +**好：面向问题** +```xml + +API 请求的错误处理 + +``` + +**效果较差：过于通用** +```xml + +函数 + +``` + +### 效果良好的查询类型 + +- **功能描述**：“文件上传处理”、“电子邮件验证逻辑” +- **技术模式**：“单例模式实现”、“工厂方法使用” +- **领域概念**：“用户配置文件管理”、“支付处理工作流” +- **架构组件**：“中间件配置”、“数据库迁移脚本” + +--- + +## 目录范围 + +使用可选的 `path` 参数将搜索重点放在代码库的特定部分： + +**在 API 模块中搜索：** +```xml + +端点验证中间件 +src/api + +``` + +**在测试文件中搜索：** +```xml + +模拟数据设置模式 +tests + +``` + +**搜索特定功能目录：** +```xml + +组件状态管理 +src/components/auth + +``` + +--- + +## 结果解释 + +### 相似度分数 + +- **0.8-1.0**：高度相关的匹配，可能正是您要查找的内容 +- **0.6-0.8**：具有强烈概念相似性的良好匹配 +- **0.4-0.6**：可能相关但可能需要审查 +- **低于 0.4**：因过于不相似而被过滤掉 + +### 结果结构 + +每个搜索结果包括： +- **文件路径**：包含匹配项的文件的相对于工作区的路径 +- **分数**：表示相关性的相似度分数（0.4-1.0） +- **行范围**：代码块的起始和结束行号 +- **代码块**：与您的查询匹配的实际代码内容 + +--- + +## 使用示例 + +- 在实现新功能时，Kilo Code 搜索“身份验证中间件”以了解现有模式，然后才编写新代码。 +- 在调试问题时，Kilo Code 搜索“API 调用中的错误处理”以查找代码库中相关的错误模式。 +- 在重构代码时，Kilo Code 搜索“数据库事务模式”以确保所有数据库操作的一致性。 +- 在熟悉新代码库时，Kilo Code 搜索“配置加载”以了解应用程序如何启动。 + +--- + +## 用法示例 + +在整个项目中搜索与身份验证相关的代码： +```xml + +用户登录和身份验证逻辑 + +``` + +在特定目录中查找与数据库相关的代码： +```xml + +数据库连接和查询执行 +src/data + +``` + +在 API 代码中查找错误处理模式： +```xml + +HTTP 错误响应和异常处理 +src/api + +``` + +搜索测试实用程序和模拟设置： +```xml + +测试设置和模拟数据创建 +tests + +``` + +查找配置和环境设置代码： +```xml + +环境变量和应用程序配置 + \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/search-files.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/search-files.md index 2e003be..af13125 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/search-files.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/search-files.md @@ -93,7 +93,14 @@ ## 使用示例 -搜索所有 JavaScript 文件中的 TODO 注释： +- 当要求重构函数时，Kilo Code 首先搜索该函数的所有使用位置，以确保全面更改。 +- 在调查错误时，Kilo Code 搜索相似模式以识别代码库中相关的错误。 +- 在处理技术债务时，Kilo Code 查找项目中所有 TODO 注释。 +- 在分析依赖项时，Kilo Code 查找特定模块的所有导入。 + +## 用法示例 + +在所有 JavaScript 文件中搜索 TODO 注释： ``` src @@ -117,4 +124,4 @@ . import\s+.*\s+from\s+['"]@components/ -``` \ No newline at end of file +``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/tool-use-overview.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/tool-use-overview.md index e6e91ee..c237fb4 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/tool-use-overview.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/tool-use-overview.md @@ -25,6 +25,7 @@ Kilo Code 实现了一个复杂的工具系统，允许 AI 模型以受控和安 - [attempt_completion](/features/tools/attempt-completion)：标记任务完成 - [switch_mode](/features/tools/switch-mode)：更改操作模式 - [new_task](/features/tools/new-task)：创建子任务 +- [update_todo_list](/features/tools/update-todo-list)：管理分步任务跟踪 ## 可用工具 @@ -65,6 +66,7 @@ Kilo Code 实现了一个复杂的工具系统，允许 AI 模型以受控和安 - [attempt_completion](/features/tools/attempt-completion) - 呈现最终结果 - [switch_mode](/features/tools/switch-mode) - 切换到不同模式以执行专门任务 - [new_task](/features/tools/new-task) - 创建新子任务 +- [update_todo_list](/features/tools/update-todo-list) - 通过分步清单跟踪任务进度 ## 工具调用机制 @@ -207,6 +209,11 @@ Kilo Code 实现了一个复杂的工具系统，允许 AI 模型以受控和安 [new_task](/features/tools/new-task) → [switch_mode](/features/tools/switch-mode) → [execute_command](/features/tools/execute-command) ``` +4. **进度跟踪** + ``` + [update_todo_list](/features/tools/update-todo-list) → [execute_command](/features/tools/execute-command) → [update_todo_list](/features/tools/update-todo-list) + ``` + ## 错误处理与恢复 ### 错误类型 @@ -236,4 +243,4 @@ Kilo Code 实现了一个复杂的工具系统，允许 AI 模型以受控和安 2. **用户干预** - 错误通知 - 恢复建议 - - 手动干预选项 \ No newline at end of file + - 手动干预选项 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/update-todo-list.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/update-todo-list.md new file mode 100644 index 0000000..410e55b --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/update-todo-list.md @@ -0,0 +1,160 @@ +# update_todo_list + +`update_todo_list` 工具用反映当前状态的更新清单替换整个 TODO 列表。它提供分步任务跟踪，允许在更新和在复杂任务期间发现新待办事项时动态添加新待办事项之前确认完成。 + +## 参数 + +该工具接受以下参数： + +- `todos`（必需）：带有任务描述和状态指示器的 markdown 清单 + +## 作用 + +此工具管理一个全面的 TODO 列表，该列表通过不同的状态跟踪任务进度。它在每次更新时替换整个列表，确保当前状态准确反映所有待处理、进行中和已完成的任务。系统将 TODO 列表显示为后续消息中的提醒。 + +## 何时使用？ + +- 当任务涉及需要系统跟踪的多个步骤时 +- 当新 actionable items are discovered during task execution +- 当更新多个待办事项的状态时 +- 当复杂项目受益于清晰、分步的进度跟踪时 +- 当组织多阶段工作流 with dependencies + +## 主要功能 + +- 维护具有三种状态的单级 markdown 清单 +- 在单个操作中更新多个任务状态 +- 动态添加新待办事项 as they're discovered during execution +- 通过状态指示器提供视觉进度跟踪 +- 与提醒系统集成 for persistent task visibility +- 支持任务 reordering based on execution priority +- Preserves all unfinished tasks unless explicitly removed +- Enables efficient batch status updates + +## 限制 + +- Limited to single-level checklists (no nesting or subtasks) +- Cannot remove tasks unless they're completed or no longer relevant +- Requires complete list replacement rather than incremental updates +- Status changes must be explicitly managed through tool calls +- No built-in task dependency tracking +- Cannot schedule tasks for future execution +- Limited to three status states (pending, in-progress, completed) + +## 状态指示器 + +该工具使用三种不同的状态指示器： + +- `[ ]` **待处理**：任务尚未开始 +- `[-]` **进行中**：任务当前正在进行中 +- `[x]` **已完成**：任务已完全完成，没有未解决的问题 + +## 工作原理 + +当调用 `update_todo_list` 工具时，它遵循以下过程： + +1. **状态验证**： + - 解析 markdown 清单格式 + - 验证状态指示器格式是否正确 + - 确保任务描述清晰且可操作 + +2. **列表替换**： + - 完全替换现有 TODO 列表 + - Preserves task order as specified in the update + - Maintains task descriptions and status states + +3. **提醒集成**： + - 将更新的列表与提醒系统集成 + - Displays current tasks in subsequent message headers + - Provides persistent visibility of task progress + +4. **进度跟踪**： + - 跟踪多个更新的完成状态 + - Maintains task history for reference + - Supports workflow continuation across sessions + +## 最佳实践 + +### 任务管理指南 + +- Mark tasks as completed immediately after all work is finished +- Start the next task by marking it as in-progress +- Add new todos as soon as they are identified during execution +- Use clear, descriptive task names that indicate specific actions +- Order tasks by logical execution sequence or priority + +### 状态更新模式 + +- Update multiple statuses simultaneously when transitioning between tasks +- Confirm task completion before marking as finished +- Keep in-progress tasks focused on current work +- Add blocking tasks when dependencies are discovered + +### 何时使用 + +Use this tool when: +- The task involves multiple steps or requires ongoing tracking +- New actionable items are discovered during task execution +- Multiple todos need status updates simultaneously +- Complex tasks benefit from clear progress visualization + +Avoid using when: +- There is only a single, trivial task +- The task can be completed in one or two simple steps +- The request is purely conversational or informational + +## Examples When Used + +- When implementing a multi-component feature requiring frontend, backend, and database changes +- When debugging issues that reveal multiple related problems requiring fixes +- When setting up development environments with multiple configuration steps +- When documenting systems that require research, writing, and review phases +- When refactoring code that affects multiple files and requires testing + +## 用法示例 + +Initial task breakdown: +``` + + +[-] Analyze requirements and create technical specification +[ ] Design database schema and API endpoints +[ ] Implement backend authentication service +[ ] Create frontend login components +[ ] Write comprehensive tests +[ ] Update documentation + + +``` + +Updating progress and adding discovered tasks: +``` + + +[x] Analyze requirements and create technical specification +[x] Design database schema and API endpoints +[-] Implement backend authentication service +[ ] Create frontend login components +[ ] Write comprehensive tests +[ ] Update documentation +[ ] Add password reset functionality +[ ] Implement rate limiting for login attempts + + +``` + +Completing multiple tasks and transitioning focus: +``` + + +[x] Analyze requirements and create technical specification +[x] Design database schema and API endpoints +[x] Implement backend authentication service +[x] Create frontend login components +[-] Write comprehensive tests +[ ] Update documentation +[ ] Add password reset functionality +[ ] Implement rate limiting for login attempts + + +``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/use-mcp-tool.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/use-mcp-tool.md index a7c3924..9db1b81 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/use-mcp-tool.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/features/tools/use-mcp-tool.md @@ -99,6 +99,15 @@ MCP 架构提供了多项安全功能： ## 使用示例 +- 使用服务器端处理工具分析专业数据格式 +- 通过托管在外部服务器上的 AI 模型生成图像或其他媒体 +- 执行复杂的领域特定计算，无需本地实现 +- 通过受控接口访问专有 API 或服务 +- 从专业数据库或数据源检索数据 + +## 用法示例 + +请求天气预报数据并返回文本响应： 使用文本响应请求天气预报数据： ``` @@ -177,4 +186,4 @@ MCP 架构提供了多项安全功能： {} -``` \ No newline at end of file +``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/connecting-api-provider.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/connecting-api-provider.md index a2cbbfa..43ae9d2 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/connecting-api-provider.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/connecting-api-provider.md @@ -2,20 +2,30 @@ sidebar_label: 连接到提供商 --- -# 连接您的第一个AI提供商 +# 连接 AI 提供商 -Kilo Code需要一个AI模型提供商的API密钥才能运行。我们推荐以下选项来访问强大的**Claude 3.7 Sonnet**模型： +Kilo Code 需要 AI 模型提供商的 API 密钥才能运行。 -- **OpenRouter（推荐）：**通过单个API密钥访问多个AI模型。适合快速入门，设置简单。[查看价格](https://openrouter.ai/models?order=pricing-low-to-high) -- **Anthropic：**直接访问Claude模型。需要API访问批准，可能会有[根据您的等级设置速率限制](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier)。查看[Anthropic的价格页面](https://www.anthropic.com/pricing#anthropic-api)了解详情 +我们推荐以下选项来访问强大的 **Claude 4 Sonnet** 模型： -## 获取您的API密钥 +- **Kilo Code API 提供商（推荐）：** 以有竞争力的价格提供对 OpenRouter 可用的所有模型的访问权限，并提供免费积分以供入门。 [查看定价](https://kilocode.ai/pricing) +- **OpenRouter：** 通过单个 API 密钥提供对多个 AI 模型的访问权限。 [查看定价](https://openrouter.ai/models?order=pricing-low-to-high)。 +- **Anthropic：** 直接访问 Claude 模型。需要 API 访问批准，并且可能[根据您的层级有速率限制](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier)。有关详细信息，请参阅 [Anthropic 的定价页面](https://www.anthropic.com/pricing#anthropic-api)。 -### 选项1：LLM路由器 +## 使用 Kilo Code 提供商 +默认情况下，当您安装 Kilo Code 扩展时，系统会提示您在 [Kilo Code 提供商](/providers/kilocode)中登录或创建帐户。 + +这将引导您完成帐户设置并*自动*正确配置 Kilo Code 以帮助您入门。如果您更喜欢使用其他提供商，则需要按照以下说明手动获取您的 API 密钥。 + +## 使用其他 API 提供商 + +### 获取您的API密钥 + +#### 选项1：LLM路由器 LLM路由器让您可以通过一个API密钥访问多个AI模型，简化了成本管理和模型切换。通常提供[更具竞争力的价格](https://openrouter.ai/models?order=pricing-low-to-high)。 -#### OpenRouter +##### OpenRouter 1. 访问 [openrouter.ai](https://openrouter.ai/) 2. 使用Google或GitHub账号登录 @@ -26,7 +36,7 @@ LLM路由器让您可以通过一个API密钥访问多个AI模型，简化了成 *OpenRouter仪表板，带有"创建密钥"按钮。命名您的密钥并在创建后复制它。* -#### Requesty +##### Requesty 1. 访问 [requesty.ai](https://requesty.ai/) 2. 使用Google账号或电子邮件登录 @@ -37,11 +47,11 @@ LLM路由器让您可以通过一个API密钥访问多个AI模型，简化了成 *Requesty API管理页面，带有"创建API密钥"按钮。立即复制您的密钥 - 它只会显示一次。* -### 选项2：直接提供商 +#### 选项2：直接提供商 直接访问特定模型的原提供商，完全使用其功能和特性： -#### Anthropic +##### Anthropic 1. 访问 [console.anthropic.com](https://console.anthropic.com/) 2. 注册账号或登录 @@ -52,7 +62,7 @@ LLM路由器让您可以通过一个API密钥访问多个AI模型，简化了成 *Anthropic控制台API密钥部分，带有"创建密钥"按钮。命名您的密钥，设置过期时间，并立即复制它。* -#### OpenAI +##### OpenAI 1. 访问 [platform.openai.com](https://platform.openai.com/) 2. 注册账号或登录 @@ -63,7 +73,7 @@ LLM路由器让您可以通过一个API密钥访问多个AI模型，简化了成 *OpenAI平台，带有"创建新密钥"按钮。命名您的密钥并在创建后立即复制它。* -## 在VS Code中配置Kilo Code +### 在VS Code中配置Kilo Code 获取API密钥后： @@ -71,6 +81,6 @@ LLM路由器让您可以通过一个API密钥访问多个AI模型，简化了成 2. 在欢迎界面，从下拉菜单中选择您的API提供商 3. 将API密钥粘贴到相应字段中 4. 选择您的模型： - - 对于**OpenRouter**：选择`anthropic/claude-3.7-sonnet` ([模型详情](https://openrouter.ai/anthropic/claude-3.7-sonnet)) - - 对于**Anthropic**：选择`claude-3-7-sonnet-20250219` ([模型详情](https://www.anthropic.com/pricing#anthropic-api)) -5. 点击"Let's go!"保存设置并开始使用Kilo Code \ No newline at end of file + - 对于**OpenRouter**：选择`anthropic/claude-3.7-sonnet` ([模型详情](https://openrouter.ai/anthropic/claude-3.7-sonnet)) + - 对于**Anthropic**：选择`claude-3-7-sonnet-20250219` ([模型详情](https://www.anthropic.com/pricing#anthropic-api)) +5. 点击"Let's go!"保存设置并开始使用Kilo Code diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/setting-up.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/setting-up.mdx index be34fd6..5176126 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/setting-up.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/setting-up.mdx @@ -14,12 +14,19 @@ export const FreeTierAmount = () => { 注册Kilo Code时，你将获得**价值的免费token**作为启动资源。领取免费token的步骤： -1. 完成注册流程 -2. 立即获得$5或$20的免费token -3. 要获取完整的额度，需要验证信用卡信息（仅用于身份验证） - -:::note 关于临时预授权 -为保护社区并确保服务质量，注册时会临时冻结信用卡$10额度。此预授权通常持续一周左右，**不会实际扣款**。此措施旨在防止免费资源滥用，同时确保正常用户获得最佳体验。我们正在努力在未来取消此限制。 +1. 完成注册过程 - 你将立即获得初始数量的免费积分 +2. 要解锁额外积分（总计高达 ）： + * 添加支付方式以进行身份验证 + * 授权 Kilo Code 在你的卡上进行*临时* 10 美元冻结 +3. 只要此支付方式以前未通过其他 Kilo Code 帐户领取过免费积分，你就可以立即享受您的免费 token 并开始编码！ + +:::note 关于临时冻结 +为了保持我们服务的可靠性并防止滥用，我们在验证期间会在您的信用卡上进行*临时* 10 美元冻结。以下是您需要了解的信息： + +- **这不是收费** - 这是一项临时授权，不会向您的帐户收费 +- **银行处理时间** - Kilo Code 在 7 天后解除冻结。解除后，资金可能需要**数周**（平均 5-10 个工作日）才能返回您的帐户。具体时间表取决于您的银行。 +- **如何显示** - 某些银行可能会将其显示为常规交易，但它仍然是临时冻结 +- **可追踪** - 冻结解除后（7 天），如果需要，我们可以提供 STAN 号码以帮助您通过银行追踪交易。 ::: ## 注册流程 @@ -38,4 +45,4 @@ Kilo Code提供简单的注册流程，通过你的账号即可使用前沿的 :::tip 需要帮助？ 如有任何定价或token相关问题，请联系[支持团队](mailto:hi@kilocode.ai)或加入我们的Discord社区。 -::: \ No newline at end of file +::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/your-first-task.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/your-first-task.md index 64283da..b2e7526 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/your-first-task.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/your-first-task.md @@ -4,7 +4,9 @@ sidebar_label: 第一个任务 # 开始你的第一个Kilo Code任务 -完成[初始设置](/getting-started/setting-up)后，即可开始使用Kilo Code！本指南将引导你完成第一次交互。 +本快速教程将展示 Kilo Code 如何从头到尾处理一个简单的请求。 + +完成[初始设置](/getting-started/setting-up)后，请按照以下步骤操作： ## 第一步：打开Kilo Code面板 @@ -67,4 +69,4 @@ Kilo Code以迭代方式工作。每个操作后都会等待你的反馈，然 * 让你保持控制的基于批准的工作流 * Kilo Code用于逐步解决问题的迭代方法 -这种迭代的、基于批准的工作流是Kilo Code的核心——让AI处理编码的繁琐部分，同时你保持完全监督。现在你已掌握基础知识，可以尝试更复杂的任务，探索不同的[模式](/basic-usage/using-modes)进行专门的工作流，或试用[自动批准功能](/features/auto-approving-actions)来加速重复性任务。 \ No newline at end of file +这种迭代的、基于批准的工作流是Kilo Code的核心——让AI处理编码的繁琐部分，同时你保持完全监督。现在你已掌握基础知识，可以尝试更复杂的任务，探索不同的[模式](/basic-usage/using-modes)进行专门的工作流，或试用[自动批准功能](/features/auto-approving-actions)来加速重复性任务。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.mdx index afda9fa..e5c52a0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/index.mdx @@ -7,7 +7,7 @@ import Image from '@site/src/components/Image'; # Kilo Code 文档 -Kilo Code 是一个开源的 AI 助手 VS Code 扩展。它通过生成代码、自动化任务和提供建议来帮助你更高效地编写代码。 +Kilo Code 通过 AI 驱动的代码生成和任务自动化**加速**开发。这个开源扩展直接集成到 VS Code 中。 ## Kilo Code 能做什么？ @@ -30,7 +30,11 @@ Kilo Code 是一个开源的 AI 助手 VS Code 扩展。它通过生成代码、 ### 基础功能 -你通过[聊天界面](/basic-usage/the-chat-interface)与 Kilo Code 交互 - 只需输入你的需求，Kilo Code 将使用最新的编码优化 AI 模型来满足你的请求。你可以切换[模式](/basic-usage/using-modes)以让 Kilo Code 以不同的方式工作，控制 Kilo Code 可以执行的操作，并通过[代码操作](/features/code-actions)直接与你的代码交互。 +使用[聊天界面](/basic-usage/the-chat-interface)告诉 Kilo Code 您需要什么。它依赖于针对编码优化的 AI 模型来完成每个请求。 + +- 切换[模式](/basic-usage/using-modes)以适应任务 +- 控制允许的[操作](/features/auto-approving-actions) +- 运行直接[代码操作](/features/code-actions) ### 使用 Kilo Code @@ -79,4 +83,4 @@ Kilo Code 配备了强大的[工具](/features/tools/tool-use-overview)，可以 - **YouTube：** 查看我们的 YouTube以学习使用 Kilo Code 的实践技能 - **GitHub：** 在问题页面报告问题或在功能请求页面提出建议 -准备好开始了吗？点击下方的**下一步**按钮，开启你的 Kilo Code 之旅！ \ No newline at end of file +准备好开始了吗？点击下方的**下一步**按钮，开启你的 Kilo Code 之旅！ diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/chutes-ai.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/chutes-ai.md new file mode 100644 index 0000000..a1eb4d3 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/chutes-ai.md @@ -0,0 +1,32 @@ +--- +sidebar_label: Chutes AI +--- + +# 在 Kilo Code 中使用 Chutes AI + +Chutes.ai 提供对多个大型语言模型 (LLM) 的免费 API 访问，允许开发人员集成和试验这些模型，而无需立即承担财务承诺。他们提供对精选的开源和专有语言模型的访问，通常侧重于特定功能或区域语言支持。 + +**网站：** [https://chutes.ai/](https://chutes.ai/) + +## 获取 API 密钥 + +要将 Chutes AI 与 Kilo Code 一起使用，请从 [Chutes AI 平台](https://chutes.ai/)获取 API 密钥。注册或登录后，您应该可以在您的帐户仪表板或设置中找到生成或检索 API 密钥的选项。 + +## 支持的模型 + +Kilo Code 将尝试从 Chutes AI API 获取可用模型列表。可用的特定模型将取决于 Chutes AI 当前提供的产品。 + +请务必参考 Chutes AI 官方文档或您的仪表板，以获取最新支持的模型列表。 + +## Kilo Code 中的配置 + +1. **打开 Kilo Code 设置：** 单击 Kilo Code 面板中的齿轮图标（）。 +2. **选择提供商：** 从“API 提供商”下拉菜单中选择“Chutes AI”。 +3. **输入 API 密钥：** 将您的 Chutes AI API 密钥粘贴到“Chutes AI API 密钥”字段中。 +4. **选择模型：** 从“模型”下拉菜单中选择您想要的模型。 + +## 提示和注意事项 + +* **免费访问：** Chutes AI 提供免费 API 访问，使其成为无需立即付费即可进行实验和开发的绝佳选择。 +* **模型多样性：** 该平台提供对开源和专有模型的访问，让您可以灵活选择适合您需求的模型。 +* **速率限制：** 与任何免费服务一样，请注意可能适用于您的 API 密钥的潜在速率限制或使用限制。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/claude-code.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/claude-code.md new file mode 100644 index 0000000..c555700 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/claude-code.md @@ -0,0 +1,47 @@ +--- +sidebar_label: Claude Code +--- + +# 在 Kilo Code 中使用 Claude Code + +Claude Code 是 Anthropic 的官方 CLI，它提供从终端直接访问 Claude 模型的功能。在 Kilo Code 中使用 Claude Code 可以让您利用现有的 CLI 设置，而无需单独的 API 密钥。 + +**网站：** [https://docs.anthropic.com/en/docs/claude-code/setup](https://docs.anthropic.com/en/docs/claude-code/setup) + +## 安装和设置 Claude Code + +1. **安装 Claude Code：** 按照 [Anthropic 的 Claude Code 文档](https://docs.anthropic.com/en/docs/claude-code/setup)中的安装说明进行操作。 +2. **身份验证：** 在终端中运行 `claude`。Claude Code 提供多种身份验证选项，包括 Anthropic Console（默认）、带有 Pro/Max 计划的 Claude App 以及 Amazon Bedrock 或 Google Vertex AI 等企业平台。有关完整详细信息，请参阅 [Anthropic 的身份验证文档](https://docs.anthropic.com/en/docs/claude-code/setup)。 +3. **验证安装：** 在终端中运行 `claude --version` 以测试一切是否正常。 + +## 支持的模型 + +Kilo Code 通过 Claude Code 支持以下 Claude 模型： + +* `claude-sonnet-4`（推荐） +* `claude-4-opus` + +可用的特定模型取决于您的 Claude 订阅和计划。有关每个模型功能的更多详细信息，请参阅 [Anthropic 的模型文档](https://docs.anthropic.com/en/docs/about-claude/models)。 + +## Kilo Code 中的配置 + +1. **打开 Kilo Code 设置：** 单击 Kilo Code 面板中的齿轮图标（）。 +2. **选择提供商：** 从“API 提供商”下拉菜单中选择“Claude Code”。 +3. **选择模型：** 从“模型”下拉菜单中选择您想要的 Claude 模型。 +4. **（可选）自定义 CLI 路径：** 如果您将 Claude Code 安装到默认 `claude` 命令以外的位置，请在“Claude Code 路径”字段中输入 Claude 可执行文件的完整路径。大多数用户不需要更改此项。 + +## 提示和注意事项 + +* **无需 API 密钥：** Claude Code 使用您现有的 CLI 身份验证，因此您无需管理单独的 API 密钥。 +* **成本透明：** 使用成本由 Claude CLI 直接报告，让您清楚地了解您的支出。 +* **高级推理：** 完全支持 Claude 的思考模式和推理功能（如果可用）。 +* **上下文窗口：** Claude 模型具有大型上下文窗口，允许您在提示中包含大量代码和上下文。 +* **增强提示功能：** 完全兼容 Kilo Code 的增强提示功能，允许您在将提示发送到 Claude 之前自动改进和优化提示。 +* **自定义路径：** 如果您将 Claude Code 安装在非标准位置，您可以在设置中指定完整路径。示例： + * Windows：`C:\tools\claude\claude.exe` + * macOS/Linux：`/usr/local/bin/claude` 或 `~/bin/claude` + +## 故障排除 + +* **“Claude Code 进程退出并出现错误”：** 验证 Claude Code 是否已安装（`claude --version`）并已通过身份验证（`claude auth login`）。确保您的订阅包含所选模型。 +* **自定义路径不起作用：** 使用 Claude 可执行文件的完整绝对路径，并验证文件是否存在且可执行。在 Windows 上，包含 `.exe` 扩展名。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/gemini.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/gemini.md index 5cc213d..ffb2e7f 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/gemini.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/gemini.md @@ -19,6 +19,8 @@ Kilo Code通过Google AI Gemini API支持Google的Gemini系列模型。 Kilo Code支持以下Gemini模型： +### 聊天模型 + * `gemini-2.5-pro-exp-03-25` * `gemini-2.0-flash-001` * `gemini-2.0-flash-lite-preview-02-05` @@ -33,7 +35,11 @@ Kilo Code支持以下Gemini模型： * `gemini-1.5-pro-exp-0827` * `gemini-exp-1206` -参考[Gemini文档](https://ai.google.dev/models/gemini)获取各模型详细信息。 +### 嵌入模型 + +* `gemini-embedding-001` - 针对代码库索引和语义搜索进行了优化 + +有关每个模型的更多详细信息，请参阅 [Gemini 文档](https://ai.google.dev/models/gemini)。 ## 在Kilo Code中的配置 @@ -44,4 +50,5 @@ Kilo Code支持以下Gemini模型： ## 提示与注意事项 -* **定价:** Gemini API使用根据输入和输出的token计费。参考[Gemini定价页面](https://ai.google.dev/pricing)获取详细信息。 \ No newline at end of file +* **定价:** Gemini API使用根据输入和输出的token计费。参考[Gemini定价页面](https://ai.google.dev/pricing)获取详细信息。 +* **代码库索引：** `gemini-embedding-001` 模型专门支持[代码库索引](/features/codebase-indexing)，为语义代码搜索提供高质量嵌入。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/groq.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/groq.md new file mode 100644 index 0000000..1953ae7 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/groq.md @@ -0,0 +1,92 @@ +--- +sidebar_label: Groq +--- + +# 在 Kilo Code 中使用 Groq + +Groq 通过其高性能基础设施为各种 AI 模型提供超快速推理。Kilo Code 支持通过 Groq API 访问模型。 + +**网站：** [https://groq.com/](https://groq.com/) + +## 获取 API 密钥 + +要将 Groq 与 Kilo Code 一起使用，您需要从 [GroqCloud 控制台](https://console.groq.com/)获取 API 密钥。注册或登录后，导航到仪表板的 API 密钥部分以创建和复制您的密钥。 + +## 支持的模型 + +Kilo Code 将尝试从 Groq API 获取可用模型列表。通过 Groq 通常可用的模型包括： + +* `llama3-8b-8192` +* `llama3-70b-8192` +* `mixtral-8x7b-32768` +* `gemma-7b-it` +* `moonshotai/kimi-k2-instruct` (Kimi K2 模型) + +**注意：** 模型可用性和规格可能会发生变化。请参阅 [Groq 文档](https://console.groq.com/docs/models)以获取最新支持的模型列表及其功能。 + +## Kilo Code 中的配置 + +1. **打开 Kilo Code 设置：** 单击 Kilo Code 面板中的齿轮图标（）。 +2. **选择提供商：** 从“API 提供商”下拉菜单中选择“Groq”。 +3. **输入 API 密钥：** 将您的 Groq API 密钥粘贴到“Groq API 密钥”字段中。 +4. **选择模型：** 从“模型”下拉菜单中选择您想要的模型。 + +## 提示和注意事项 + +* **高速推理：** Groq 的 LPU 提供异常快速的响应时间，使其成为交互式开发工作流的理想选择。 +* **Token 限制：** 某些模型具有特定的 `max_tokens` 限制，Kilo Code 会自动处理（例如，`moonshotai/kimi-k2-instruct` 模型）。 +* **成本效益：** 高性能推理具有竞争力的定价。 +* **模型选择：** 根据您的特定需求选择模型 - 对于复杂推理任务，选择 `llama3-70b-8192` 等大型模型，或者对于更快、更简单的操作，选择 `llama3-8b-8192` 等小型模型。 + +## 支持的模型 + +Kilo Code 通过 Groq 支持以下模型： + +| Model ID | Provider | Context Window | Notes | +|----------|----------|----------------|-------| +| `moonshotai/kimi-k2-instruct` | Moonshot AI | 128K tokens | 已配置优化 `max_tokens` 限制 | +| `llama-3.3-70b-versatile` | Meta | 128K tokens | 高性能 Llama 模型 | +| `llama-3.1-70b-versatile` | Meta | 128K tokens | 通用推理能力 | +| `llama-3.1-8b-instant` | Meta | 128K tokens | 快速推理，适用于快速任务 | +| `mixtral-8x7b-32768` | Mistral AI | 32K tokens | 专家混合架构 | + +**注意：** 模型可用性可能会发生变化。请参阅 [Groq 文档](https://console.groq.com/docs/models)以获取最新的模型列表和规格。 + +## Kilo Code 中的配置 + +1. **打开 Kilo Code 设置：** 单击 Kilo Code 面板中的齿轮图标（）。 +2. **选择提供商：** 从“API 提供商”下拉菜单中选择“Groq”。 +3. **输入 API 密钥：** 将您的 Groq API 密钥粘贴到“Groq API 密钥”字段中。 +4. **选择模型：** 从“模型”下拉菜单中选择您想要的模型。 + +## 模型特定功能 + +### Kimi K2 模型 + +`moonshotai/kimi-k2-instruct` 模型包含优化配置： + +- **最大 Token 限制：** 自动配置适当的限制以获得最佳性能 +- **上下文理解：** 非常适合复杂推理和长上下文任务 +- **多语言支持：** 在多种语言中表现出色 + +## 提示和注意事项 + +- **超快速推理：** Groq 的硬件加速提供异常快速的响应时间 +- **成本效益：** 高性能推理具有竞争力的定价 +- **速率限制：** 请注意根据您的 Groq 计划的 API 速率限制 +- **模型选择：** 根据您的特定用例选择模型： + - **Kimi K2**：最适合复杂推理和多语言任务 + - **Llama 3.3 70B**：出色的通用性能 + - **Llama 3.1 8B Instant**：最快的响应，适用于简单任务 + - **Mixtral**：性能和效率的良好平衡 + +## 故障排除 + +- **“无效 API 密钥”：** 验证您的 API 密钥在 Groq 控制台中是否正确且处于活动状态 +- **“模型不可用”：** 检查所选模型在您所在区域是否可用 +- **速率限制错误：** 在 Groq 控制台中监视您的使用情况并考虑升级您的计划 +- **连接问题：** 确保您有稳定的互联网连接并且 Groq 服务正常运行 + +## 定价 + +Groq 根据输入和输出 token 提供有竞争力的定价。访问 [Groq 定价页面](https://groq.com/pricing/)以获取当前费率和计划选项。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/kilocode.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/kilocode.md index cc6a9b5..f63a4c0 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/kilocode.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/kilocode.md @@ -1,45 +1,62 @@ --- -sidebar_label: Kilo Code +sidebar_label: Kilo Code Provider --- # 使用 Kilo Code 的 API 提供商 -:::warning +Kilo Code 提供自己的内置 API 提供商，通过简单的注册过程即可访问最新的前沿编码模型。无需管理来自多个提供商的 API 密钥——只需注册即可开始编码。 -此文档目前仅针对 Anthropic 和 Claude Sonnet 3.7，并不反映使用 Kilo Code 作为提供商的简单性 - 它只是一个占位符 +**网站：** [https://kilocode.ai/](https://kilocode.ai/) +## 免费积分入门 + +当您注册 Kilo Code 时，您将获得免费积分以帮助您入门： + +1. **初始注册：** 完成注册过程，立即获得初始数量的免费积分 +2. **解锁额外积分：** 要访问更多免费积分： + * 添加支付方式以进行身份验证 + * 授权临时冻结您的卡 10 美元（不收费） +3. **开始编码：** 验证后，立即享受您的免费 token 并开始使用 Kilo Code + +:::note 关于临时冻结 +10 美元的冻结仅用于身份验证： +- **不收费** - 这是一项临时授权，不会收费 +- **7 天后解除** - Kilo Code 会自动解除冻结 +- **银行处理** - 解除后，资金可能需要 5-10 个工作日才能返回（因银行而异） +- **可追踪** - 如果需要，我们可以提供 STAN 号码以帮助银行追踪 ::: -Anthropic 是一家 AI 安全和研究公司，致力于构建可靠、可解释和可控制的 AI 系统。他们的 Claude 模型以其强大的推理能力、帮助性和诚实性而闻名。 +## 注册流程 -**网站：** [https://www.anthropic.com/](https://www.anthropic.com/) +Kilo Code 提供简化的注册流程，可将您直接连接到前沿编码模型： -## 获取 API 密钥 +1. **开始注册：** 在扩展中单击“免费试用 Kilo Code” +2. **登录：** 使用您的 Google 帐户在 kilocode.ai 登录 +3. **授权 VS Code：** + * kilocode.ai 将提示您打开 Visual Studio Code + * 对于基于 Web 的 IDE，您将手动复制 API 密钥 +4. **完成设置：** 提示时允许 VS Code 打开授权 URL -1. **注册/登录：** 前往 [Anthropic 控制台](https://console.anthropic.com/)。创建账户或登录。 -2. **导航到 API 密钥：** 前往 [API 密钥](https://console.anthropic.com/settings/keys) 部分。 -3. **创建密钥：** 点击“创建密钥”。为您的密钥命名（例如，“Kilo Code”）。 -4. **复制密钥：** **重要：** 立即复制 API 密钥。您将无法再次查看它。请妥善保存。 + ## 支持的模型 -Kilo Code 支持以下 Anthropic Claude 模型： +Kilo Code 通过其内置提供商提供对最新前沿编码模型的访问。可用的特定模型由 Kilo Code 服务自动更新和管理，确保您始终可以访问最强大的编码任务模型。 -* `claude-3-7-sonnet-20250219` +## Kilo Code 中的配置 -有关每个模型功能的更多详细信息，请参阅 [Anthropic 的模型文档](https://docs.anthropic.com/en/docs/about-claude/models)。 +完成注册过程后，Kilo Code 会自动配置： -## 在 Kilo Code 中配置 - -1. **打开 Kilo Code 设置：** 点击 Kilo Code 面板中的齿轮图标 ()。 -2. **选择提供商：** 从 "API 提供商" 下拉菜单中选择 "Anthropic"。 -3. **输入 API 密钥：** 将您的 Anthropic API 密钥粘贴到 "Anthropic API 密钥" 字段中。 -4. **选择模型：** 从 "模型" 下拉菜单中选择您想要的 Claude 模型。 -5. **（可选）自定义基础 URL：** 如果您需要为 Anthropic API 使用自定义基础 URL，请勾选“使用自定义基础 URL”并输入 URL。大多数人不需要调整此项。 +1. **自动设置：** 成功注册后，Kilo Code 即可立即使用 +2. **无需 API 密钥管理：** 您的身份验证通过注册过程无缝处理 +3. **模型选择：** 通过您的 Kilo Code 帐户自动提供对前沿模型的访问 ## 提示和注意事项 -* **提示缓存：** Claude 3 模型支持 [提示缓存](https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching)，这可以显著降低重复提示的成本和延迟。 -* **上下文窗口：** Claude 模型具有较大的上下文窗口（200,000 个 token），允许您在提示中包含大量代码和上下文。 -* **定价：** 请参阅 [Anthropic 定价](https://www.anthropic.com/pricing) 页面获取最新定价信息。 -* **速率限制：** Anthropic 根据 [使用层级](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier) 设置了严格的速率限制。如果您反复遇到速率限制，请考虑联系 Anthropic 销售或通过 [OpenRouter](/providers/openrouter) 或 [Requesty](/providers/requesty) 等其他提供商访问 Claude。 \ No newline at end of file +* **免费积分：** 新用户获得免费积分以探索 Kilo Code 的功能 +* **身份验证：** 临时冻结系统确保服务可靠性，同时防止滥用 +* **无缝集成：** 无需管理多个 API 密钥或提供商配置 +* **最新模型：** 自动访问最新的前沿编码模型 +* **提供支持：** 有关定价或 token 的问题，请联系 [hi@kilocode.ai](mailto:hi@kilocode.ai) + +有关详细设置说明，请参阅[设置 Kilo Code](/getting-started/setting-up)。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/lmstudio.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/lmstudio.md index bfb49c5..1f16776 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/lmstudio.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/lmstudio.md @@ -2,40 +2,39 @@ sidebar_label: LM Studio --- -# 使用 LM Studio 的 API 提供商 +# 在 Kilo Code 中使用 LM Studio -LM Studio 是一个本地运行的 AI 模型管理工具，允许您在本地计算机上运行各种开源 LLM 模型，并为其提供 API 访问。 +Kilo Code 支持使用 LM Studio 在本地运行模型。LM Studio 提供了一个用户友好的界面，用于下载、配置和运行本地语言模型。它还包括一个内置的本地推理服务器，模拟 OpenAI API，使其易于与 Kilo Code 集成。 **网站：** [https://lmstudio.ai/](https://lmstudio.ai/) ## 设置 LM Studio -1. **下载并安装：** 从 [LM Studio 网站](https://lmstudio.ai/) 下载并安装适用于您操作系统的版本。 -2. **下载模型：** 在 LM Studio 中，从 Hugging Face 下载您想要使用的模型。建议使用经过测试的模型，如 Mistral 7B 或 Llama 2。 -3. **启动服务器：** 在 LM Studio 中，点击“Server”选项卡，然后点击“Start Server”。默认情况下，服务器将在 `http://localhost:1234` 上运行。 +1. **下载并安装 LM Studio：** 从 [LM Studio 网站](https://lmstudio.ai/)下载 LM Studio。 +2. **下载模型：** 使用 LM Studio 界面搜索并下载模型。一些推荐的模型包括： + * CodeLlama 模型（例如，`codellama:7b-code`、`codellama:13b-code`、`codellama:34b-code`） + * Mistral 模型（例如，`mistralai/Mistral-7B-Instruct-v0.1`） + * DeepSeek Coder 模型（例如，`deepseek-coder:6.7b-base`） + * 任何其他受 Kilo Code 支持的模型，或者您可以设置上下文窗口的模型。 -## 支持的模型 + 查找 GGUF 格式的模型。LM Studio 提供搜索界面以查找和下载模型。 +3. **启动本地服务器：** + * 打开 LM Studio。 + * 单击“**本地服务器**”选项卡（图标看起来像 `<->`）。 + * 选择您下载的模型。 + * 单击“**启动服务器**”。 -Kilo Code 支持以下 LM Studio 模型： +## Kilo Code 中的配置 -* `mistral-7b-instruct-v0.1` -* `llama-2-7b-chat` -* `llama-2-13b-chat` -* `llama-2-70b-chat` - -有关每个模型功能的更多详细信息，请参阅 [LM Studio 的文档](https://lmstudio.ai/docs)。 - -## 在 Kilo Code 中配置 - -1. **打开 Kilo Code 设置：** 点击 Kilo Code 面板中的齿轮图标 ()。 -2. **选择提供商：** 从 "API 提供商" 下拉菜单中选择 "LM Studio"。 -3. **输入 API 密钥：** 将您的 LM Studio API 密钥粘贴到 "LM Studio API 密钥" 字段中。如果未设置 API 密钥，可以留空。 -4. **选择模型：** 从 "模型" 下拉菜单中选择您想要的模型。 -5. **（可选）自定义基础 URL：** 如果您需要为 LM Studio API 使用自定义基础 URL，请勾选“使用自定义基础 URL”并输入 URL。大多数人不需要调整此项。 +1. **打开 Kilo Code 设置：** 单击 Kilo Code 面板中的齿轮图标（）。 +2. **选择提供商：** 从“API 提供商”下拉菜单中选择“LM Studio”。 +3. **输入模型 ID：** 输入您在 LM Studio 中加载的模型的文件名（例如，`codellama-7b.Q4_0.gguf`）。您可以在 LM Studio 的“本地服务器”选项卡中找到此信息。 +4. **（可选）基本 URL：** 默认情况下，Kilo Code 将连接到 `http://localhost:1234` 处的 LM Studio。如果您已将 LM Studio 配置为使用不同的地址或端口，请在此处输入完整的 URL。 ## 提示和注意事项 -* **本地运行：** LM Studio 允许您在本地运行模型，这对于隐私和安全性至关重要。 -* **模型选择：** 选择适合您任务的模型大小。较大的模型需要更多的计算资源，但可能提供更好的结果。 -* **硬件要求：** 确保您的计算机具有足够的 RAM 和 GPU 内存来运行您选择的模型。 -* **速率限制：** LM Studio 没有严格的速率限制，但您的硬件可能会限制性能。 \ No newline at end of file +* **资源要求：** 在本地运行大型语言模型可能资源密集。确保您的计算机满足您选择的模型的最低要求。 +* **模型选择：** LM Studio 提供各种模型。尝试找到最适合您需求的模型。 +* **本地服务器：** LM Studio 本地服务器必须运行，Kilo Code 才能连接到它。 +* **LM Studio 文档：** 有关更多信息，请参阅 [LM Studio 文档](https://lmstudio.ai/docs)。 +* **故障排除：** 如果您看到“请检查 LM Studio 开发人员日志以调试出了什么问题”错误，您可能需要调整 LM Studio 中的上下文长度设置。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/mistral.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/mistral.md index 64f3381..919ae0c 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/mistral.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/mistral.md @@ -2,32 +2,32 @@ sidebar_label: Mistral AI --- -# 在Kilo Code中使用Mistral AI +# 在 Kilo Code 中使用 Mistral AI -Kilo Code支持通过Mistral AI API访问模型，包括标准Mistral模型和专门用于代码的Codestral模型。 +Kilo Code 支持通过 Mistral AI API 访问模型，包括标准 Mistral 模型和代码专用 Codestral 模型。 -**官网:** [https://mistral.ai/](https://mistral.ai/) +**网站：** [https://mistral.ai/](https://mistral.ai/) -## 获取API密钥 +## 获取 API 密钥 -1. **注册/登录:** 访问[Mistral控制台](https://console.mistral.ai/)。创建账户或登录。您可能需要完成验证流程。 -2. **创建API密钥:** - - [La Plateforme API密钥](https://console.mistral.ai/api-keys/) 和/或 - - [Codestral API密钥](https://console.mistral.ai/codestral) +1. **注册/登录：** 访问 [Mistral 平台](https://console.mistral.ai/)。创建帐户或登录。您可能需要通过验证过程。 +2. **创建 API 密钥：** + - [La Plateforme API 密钥](https://console.mistral.ai/api-keys/)和/或 + - [Codestral API 密钥](https://console.mistral.ai/codestral) ## 支持的模型 -Kilo Code支持以下Mistral模型： +Kilo Code 支持以下 Mistral 模型： -| 模型ID | 默认温度 | 函数调用 | 视觉/图像支持 | +| 模型 ID | 模型默认温度 | 函数调用 | 视觉/图像支持 | |------------------------|-------------------------|------------------|--------| -| codestral-latest | 0.3 | ✅ | ❌ | -| mistral-large-latest | 0.7 | ✅ | ❌ | -| ministral-8b-latest | 0.3 | ✅ | ❌ | -| ministral-3b-latest | 0.3 | ✅ | ❌ | -| mistral-small-latest | 0.3 | ✅ | ❌ | -| pixtral-large-latest | 0.7 | ✅ | ✅ | - +| codestral-latest | 0.3 | ✅ | ❌ | +| devstral | 0.3 | ✅ | ❌ | +| mistral-large-latest | 0.7 | ✅ | ❌ | +| ministral-8b-latest | 0.3 | ✅ | ❌ | +| ministral-3b-latest | 0.3 | ✅ | ❌ | +| mistral-small-latest | 0.3 | ✅ | ❌ | +| pixtral-large-latest | 0.7 | ✅ | ✅ | Kilo Code中的默认模型温度为0.0，因此您应该考虑尝试[调整温度](/features/model-temperature)！ **注意:** 模型的可用性和规格可能会发生变化。 @@ -50,4 +50,4 @@ Kilo Code中的默认模型温度为0.0，因此您应该考虑尝试[调整温 1. **选择"Mistral"作为API提供商。** 2. **选择Codestral模型** -3. **输入您的Codestral (codestral.mistral.ai)或La Plateforme (api.mistral.ai) API密钥。** \ No newline at end of file +3. **输入您的Codestral (codestral.mistral.ai)或La Plateforme (api.mistral.ai) API密钥。** diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/ollama.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/ollama.md index 9238160..84de956 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/ollama.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/ollama.md @@ -5,70 +5,137 @@ # 在Kilo Code中使用Ollama Kilo Code 支持通过 Ollama 在本地运行模型。这提供了隐私保护、离线访问能力，并可能降低成本，但需要更多设置且依赖高性能计算机。 +**官方网站：** [https://ollama.com/](https://ollama.com/) + +使用 devstral 编写贪吃蛇游戏 +*使用 devstral 编写贪吃蛇游戏* + +## 管理期望 -**官方网站**：[https://ollama.com/](https://ollama.com/) +本地 LLM 比高级云托管 LLM（如 Claude 和 Gemini）小得多，结果也会逊色得多。 +它们更容易陷入循环，无法正确使用工具或在代码中产生语法错误。 +需要更多的试错才能找到正确的提示。 +本地 LLM 通常速度也不是很快。 +使用简单的提示、保持对话简短和禁用 MCP 工具可以提高速度。 -## 安装配置Ollama -1. **下载并安装Ollama**：从[Ollama官网](https://ollama.com/)下载对应操作系统的安装程序，按指引完成安装。确保Ollama已启动： +## 硬件要求 + +您将需要大量的 RAM（32GB 或更多）和强大的 CPU（例如 Ryzen 9000 系列）才能运行下面列出的模型。 +GPU 可以更快地运行 LLM，但需要大量的 VRAM（24GB 或更多），这在消费级 GPU 上并不常见。 +较小的模型可以在更普通的 GPU 上运行，但效果不佳。 +具有足够统一内存的 MacBook 可以使用 GPU 加速，但在我们的测试中，其性能不如高端桌面 CPU。 - ```bash - ollama serve - ``` -2. **下载模型**：Ollama 支持多种模型，可在[Ollama模型库](https://ollama.com/library)查看可用列表。以下是推荐用于编码任务的模型： +## 选择模型 - * `codellama:7b-code`（入门首选，模型较小） - * `codellama:13b-code`（质量更佳，模型较大） - * `codellama:34b-code`（质量最优，模型极大） - * `qwen2.5-coder:32b` - * `mistralai/Mistral-7B-Instruct-v0.1`（通用型优质模型） - * `deepseek-coder:6.7b-base`（适合编码任务） - * `llama3:8b-instruct-q5_1`（适合常规任务） +Ollama 支持许多不同的模型。 +您可以在 [Ollama 网站](https://ollama.com/library)上找到可用模型列表。 +选择适合您的用例、在您的硬件配置上运行并达到所需速度的模型需要一些试错。 +以下规则和启发式方法可用于查找模型： + +* 必须至少有 32k 的上下文窗口（这是 Kilo Code 的要求）。 +* 列出为支持工具。 +* 参数数量在 7b 到 24b 范围内。 +* 优先选择流行模型。 +* 优先选择较新的模型。 - 在终端运行以下命令下载模型： - ```bash - ollama pull <模型名称> - ``` +### Kilo Code 推荐 - 示例： +我们使用以下提示测试了一些模型： - ```bash - ollama pull qwen2.5-coder:32b - ``` +``` +创建一个简单的网页，其中包含一个按钮，单击时会向用户问好。 +``` -3. **配置模型**：默认情况下，Ollama 使用 2048 tokens的上下文窗口，这对 Kilo Code 的请求来说过小。建议至少设置为12k，理想情况下为32k。配置模型需设置参数并保存副本： +如果模型在几次尝试内产生了一个可用的结果，则认为它通过。我们发现可以正常工作的模型是： - - 加载模型（以`qwen2.5-coder:32b`为例）： +| 模型名称 | 完成时间 | +| --- | --- | +| qwen2.5-coder:7b | 1x（基线） | +| devstral:24b | 2x | +| gemma3:12b | 4x | +| qwen3-8b | 12x | - ```bash - ollama run qwen2.5-coder:32b - ``` +我们的建议是，如果您的硬件能够处理，请使用 **devstral:24b**，因为它比 qwen2.5-coder:7b 犯的错误更少。 +qwen2.5-coder:7b 值得考虑，因为它速度快，如果您能忍受它的错误。 +该表还显示速度难以预测，因为专用 devstral:24b 在这里优于较小的通用模型 gemma3:12b 和 qwen3-8b。 +gemma3:12b 的结果引人注目，因为它能够正确使用工具（至少有时），而 Ollama 网站上并未将其列为适合工具使用的模型。 - - 修改上下文大小参数： +devstral:24b 产生的结果如下： - ```bash - /set parameter num_ctx 32768 - ``` +```html + + + + + + 问候用户按钮 + + + + - - 使用新名称保存模型： + + + +``` - ```bash - /save 你的模型名称 - ``` +以下模型看起来是合理的选择，但发现与 Kilo Code 的默认配置**不**兼容： -4. **配置Kilo Code**： - * 打开Kilo Code侧边栏（图标）。 - * 点击设置齿轮图标（）。 - * 选择“ollama”作为API提供商。 - * 输入上一步设置的模型名称（如`你的模型名称`）。 - * （可选）若Ollama运行在其他设备上，可配置基础URL（默认：`http://localhost:11434`）。 - * （可选）在高级设置中配置模型上下文大小，以便Kilo Code管理滑动窗口。 +| 模型名称 | 失败原因 | +| --- | --- | +| deepseek-r1:7b | 无法正确使用工具 | +| deepseek-r1:8b | 陷入推理循环 | -## 注意事项 -* **资源要求**：本地运行大型语言模型需要较高资源配置，请确保计算机满足所选模型的最低要求。 -* **模型选择**：建议尝试不同模型，找到最符合需求的选项。 -* **离线使用**：模型下载完成后，Kilo Code 可离线使用该模型。 -* **Ollama文档**：更多关于安装、配置和使用Ollama的信息，请参考[Ollama官方文档](https://ollama.com/docs)。 +## 设置 Ollama + +1. **下载并安装 Ollama：** 从 [Ollama 网站](https://ollama.com/)下载适用于您操作系统的 Ollama 安装程序。按照安装说明进行操作，并*设置 `OLLAMA_CONTEXT_LENGTH` 环境变量*以防止 Ollama 截断提示。确保 Ollama 正在运行： + + ```bash + OLLAMA_CONTEXT_LENGTH=131072 ollama serve + ``` + +2. **下载模型：** 下载模型后，您可以离线使用 Kilo Code 和该模型。要下载模型，请打开终端并运行： + + ```bash + ollama pull + ``` + + 例如： + + ```bash + ollama pull devstral:24b + ``` + +4. **配置 Kilo Code：** + * 打开 Kilo Code 侧边栏（ 图标）。 + * 单击设置齿轮图标（）。 + * 选择“ollama”作为 API 提供商。 + * 输入模型名称。 + * （可选）如果您在不同的机器上运行 Ollama，则可以配置基本 URL。默认值为 `http://localhost:11434`。 + + +## 进一步阅读 + +有关安装、配置和使用 Ollama 的更多信息，请参阅 [Ollama 文档](https://ollama.com/docs)。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/openai-compatible.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/openai-compatible.md index b24ef40..d0d443c 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/openai-compatible.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/openai-compatible.md @@ -34,6 +34,29 @@ Kilo Code 支持多种提供 OpenAI API 标准兼容的 AI 模型提供商。这 - 输入价格 - 输出价格 +### 完整端点 URL 支持 + +Kilo Code 支持在基本 URL 字段中输入完整端点 URL，为提供商配置提供更大的灵活性： + +**标准基本 URL 格式：** +``` +https://api.provider.com/v1 +``` + +**完整端点 URL 格式：** +``` +https://api.provider.com/v1/chat/completions +https://custom-endpoint.provider.com/api/v2/models/chat +``` + +此增强功能允许您： +- 连接到具有非标准端点结构的提供商 +- 使用自定义 API 网关或代理服务 +- 与需要特定端点路径的提供商合作 +- 与企业或自托管 API 部署集成 + +**注意：** 使用完整端点 URL 时，请确保 URL 指向您的提供商的正确聊天完成端点。 + ## 支持的模型（适用于 OpenAI 原生端点） 虽然此提供商类型允许连接到各种端点，但如果你直接连接到官方 OpenAI API（或完全镜像它的端点），Kilo Code 会根据其源代码中的 `openAiNativeModels` 定义识别以下模型 ID： @@ -57,4 +80,4 @@ Kilo Code 支持多种提供 OpenAI API 标准兼容的 AI 模型提供商。这 * **连接错误:** 验证基础 URL 是否正确，以及你的提供商 API 是否可访问。 * **意外结果:** 如果你得到意外的结果，请尝试使用不同的模型。 -通过使用 OpenAI 兼容的提供商，你可以利用 Kilo Code 的灵活性与更广泛的 AI 模型。请始终参考你提供商的文档以获取最准确和最新的信息。 \ No newline at end of file +通过使用 OpenAI 兼容的提供商，你可以利用 Kilo Code 的灵活性与更广泛的 AI 模型。请始终参考你提供商的文档以获取最准确和最新的信息。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/v0.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/v0.md new file mode 100644 index 0000000..8304ba3 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/v0.md @@ -0,0 +1,47 @@ +--- +sidebar_label: v0 +--- + +# 在 Kilo Code 中使用 v0 + +Kilo Code 支持 v0，Vercel 的 AI 模型提供商，它提供与 OpenAI 兼容的 API。这允许您通过熟悉的 OpenAI API 界面在 Kilo Code 中使用 v0 的模型。 + +## 先决条件 + +要在 Kilo Code 中使用 v0，您需要： + +* 一个带有 Vercel v0 的团队帐户 +* 一个 v0 API 密钥 + +## 配置 + +在 Kilo Code 中设置 v0 非常简单： + +1. 在 Kilo Code 设置中（单击 图标）： + * 在 **API 提供商**下，选择：**OpenAI 兼容** + * 设置 **基本 URL**：`https://api.v0.dev/v1` + * 粘贴您的 v0 API 密钥 + * 设置 **模型 ID**：`v0-1.0-md` + * 单击 **验证** 以确认连接 + +Kilo Code 设置中的 v0 配置 + +## 支持的模型 + +目前，v0 提供以下模型： + +* `v0-1.0-md` - v0 的多模态模型，支持文本和图像输入 +* `v0-1.5-lg` - 复合模型（[了解更多](https://vercel.com/blog/v0-composite-model-family)） +* `v0-1.5.md` - 复合模型（[了解更多](https://vercel.com/blog/v0-composite-model-family)） + +## 故障排除 + +* **“无效 API 密钥”：** 仔细检查您是否正确输入了 API 密钥。 +* **“模型未找到”：** 确保您使用的是正确的模型 ID（`v0-1.0-md`）。 +* **连接错误：** 验证基本 URL 是否正确（`https://api.v0.dev/v1`）。 +* **访问问题：** 确认您的 Vercel v0 团队帐户处于活动状态并已正确设置。 + +## 附加资源 + +* [v0 官方文档](https://v0.dev) +* [Vercel AI 文档](https://vercel.com/docs/ai) \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/vertex.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/vertex.md index 69912af..17d3e84 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/vertex.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/vertex.md @@ -16,12 +16,14 @@ Kilo Code 支持通过 Google Cloud Platform 的 Vertex AI 访问模型，这是 * **应用程序默认凭据 (ADC):** Kilo Code 使用应用程序默认凭据来与 Vertex AI 进行身份验证。最简单的设置方法是： 1. 安装 Google Cloud CLI: [https://cloud.google.com/sdk/docs/install](https://cloud.google.com/sdk/docs/install) 2. 使用以下命令进行身份验证：`gcloud auth application-default login` +* **服务帐户密钥（替代方案）：** 或者，您可以使用 Google Cloud 服务帐户密钥文件进行身份验证。您需要在 GCP 项目中生成此密钥。请参阅 [Google Cloud 文档中关于创建服务帐户密钥](https://cloud.google.com/iam/docs/creating-managing-service-account-keys)的部分。 ## 支持的模型 Kilo Code 通过 Vertex AI 支持以下模型（基于源代码）： -* **Google Gemini 模型:** +* **Google Gemini 模型：** + * `gemini-2.5-flash-preview-05-20` * `gemini-2.0-flash-001` * `gemini-2.5-pro-exp-03-25` * `gemini-2.0-pro-exp-02-05` @@ -29,9 +31,13 @@ Kilo Code 通过 Vertex AI 支持以下模型（基于源代码）： * `gemini-2.0-flash-thinking-exp-01-21` * `gemini-1.5-flash-002` * `gemini-1.5-pro-002` -* **Anthropic Claude 模型:** +* **Anthropic Claude 模型：** + * `claude-opus-4@20250514:thinking` + * `claude-opus-4@20250514` + * `claude-sonnet-4@20250514:thinking` + * `claude-sonnet-4@20250514` * `claude-3-7-sonnet@20250219:thinking` - * `claude-极客3-7-sonnet@20250219` + * `claude-3-7-sonnet@20250219` * `claude-3-5-sonnet-v2@20241022` * `claude-3-5-sonnet@20240620` * `claude-3-5-haiku@20241022` @@ -44,11 +50,16 @@ Kilo Code 通过 Vertex AI 支持以下模型（基于源代码）： 1. **打开 Kilo Code 设置:** 点击 Kilo Code 面板中的齿轮图标 ()。 2. **选择提供商:** 从 "API 提供商" 下拉菜单中选择 "GCP Vertex AI"。 -3. **输入项目 ID:** 输入您的 Google Cloud 项目 ID。 -4. **选择区域:** 选择您的 Vertex AI 资源所在的区域 (例如 `us-east5`)。 -5. **选择模型:** 从 "模型" 下拉菜单中选择您想要的模型。 +3. **配置身份验证：** + * **如果使用应用程序默认凭据 (ADC)：** 此处无需进一步操作。如果配置正确（请参阅先决条件），ADC 将自动使用。 + * **如果*不*使用 ADC（服务帐户密钥）：** + * **选项 A：粘贴 JSON 内容：** 将您的服务帐户 JSON 密钥文件的全部内容粘贴到 **Google Cloud 凭据**字段中。 + * **选项 B：提供文件路径：** 在 **Google Cloud 密钥文件路径**字段中输入您下载的服务帐户 JSON 密钥文件的绝对路径。 +4. **输入项目 ID：** 输入您的 Google Cloud 项目 ID。 +5. **选择区域：** 选择您的 Vertex AI 资源所在的区域（例如，`us-east5`）。 +6. **选择模型：** 从“模型”下拉菜单中选择您想要的模型。 ## 提示和注意事项 * **权限:** 确保您的 Google Cloud 账户具有访问 Vertex AI 和您想要使用的特定模型所需的权限。 -* **定价:** 请参阅 [Vertex AI 定价](https://cloud.google.com/vertex-ai/pricing) 页面了解详情。 \ No newline at end of file +* **定价:** 请参阅 [Vertex AI 定价](https://cloud.google.com/vertex-ai/pricing) 页面了解详情。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/xai.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/xai.md new file mode 100644 index 0000000..a875090 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/providers/xai.md @@ -0,0 +1,81 @@ +--- +sidebar_label: xAI (Grok) +--- + +# 在 Kilo Code 中使用 xAI (Grok) + +xAI 是 Grok 背后的公司，Grok 是一种大型语言模型，以其对话能力和大型上下文窗口而闻名。Grok 模型旨在提供有用、信息丰富且与上下文相关的响应。 + +**网站：** [https://x.ai/](https://x.ai/) + +## 获取 API 密钥 + +1. **注册/登录：** 访问 [xAI 控制台](https://console.x.ai/)。创建帐户或登录。 +2. **导航到 API 密钥：** 转到仪表板中的 API 密钥部分。 +3. **创建密钥：** 单击以创建新的 API 密钥。为您的密钥指定一个描述性名称（例如，“Kilo Code”）。 +4. **复制密钥：** **重要提示：** 立即复制 API 密钥。您将无法再次看到它。请妥善保管。 + +## 支持的模型 + +Kilo Code 支持以下 xAI Grok 模型： + +### Grok-3 模型 +* `grok-3-beta`（默认）- xAI 的 Grok-3 beta 模型，具有 131K 上下文窗口 +* `grok-3-fast-beta` - xAI 的 Grok-3 快速 beta 模型，具有 131K 上下文窗口 +* `grok-3-mini-beta` - xAI 的 Grok-3 mini beta 模型，具有 131K 上下文窗口 +* `grok-3-mini-fast-beta` - xAI 的 Grok-3 mini 快速 beta 模型，具有 131K 上下文窗口 + +### Grok-2 模型 +* `grok-2-latest` - xAI 的 Grok-2 模型 - 最新版本，具有 131K 上下文窗口 +* `grok-2` - xAI 的 Grok-2 模型，具有 131K 上下文窗口 +* `grok-2-1212` - xAI 的 Grok-2 模型（版本 1212），具有 131K 上下文窗口 + +### Grok 视觉模型 +* `grok-2-vision-latest` - xAI 的 Grok-2 视觉模型 - 最新版本，支持图像，具有 32K 上下文窗口 +* `grok-2-vision` - xAI 的 Grok-2 视觉模型，支持图像，具有 32K 上下窗口 +* `grok-2-vision-1212` - xAI 的 Grok-2 视觉模型（版本 1212），支持图像，具有 32K 上下文窗口 +* `grok-vision-beta` - xAI 的 Grok 视觉 Beta 模型，支持图像，具有 8K 上下文窗口 + +### 遗留模型 +* `grok-beta` - xAI 的 Grok Beta 模型（遗留），具有 131K 上下文窗口 + +## Kilo Code 中的配置 + +1. **打开 Kilo Code 设置：** 单击 Kilo Code 面板中的齿轮图标（）。 +2. **选择提供商：** 从“API 提供商”下拉菜单中选择“xAI”。 +3. **输入 API 密钥：** 将您的 xAI API 密钥粘贴到“xAI API 密钥”字段中。 +4. **选择模型：** 从“模型”下拉菜单中选择您想要的 Grok 模型。 + +## 推理能力 + +Grok 3 Mini 模型具有专业的推理能力，允许它们“在响应前思考”——这对于复杂的解决问题任务特别有用。 + +### 启用推理的模型 + +推理仅受以下模型支持： +* `grok-3-mini-beta` +* `grok-3-mini-fast-beta` + +Grok 3 模型 `grok-3-beta` 和 `grok-3-fast-beta` 不支持推理。 + +### 控制推理工作量 + +使用启用推理的模型时，您可以使用 `reasoning_effort` 参数控制模型思考的努力程度： + +* `low`：最小思考时间，使用更少的 token 以实现快速响应 +* `high`：最大思考时间，利用更多 token 解决复杂问题 + +对于应快速完成的简单查询，选择 `low`；对于响应延迟不那么重要的更难问题，选择 `high`。 + +### 主要功能 + +* **分步解决问题**：模型在提供答案之前有条不紊地思考问题 +* **数学和定量能力**：擅长数字挑战和逻辑谜题 +* **推理跟踪访问**：模型的思考过程可通过响应完成对象中的 `reasoning_content` 字段获取 + +## 提示和注意事项 + +* **上下文窗口：** 大多数 Grok 模型具有大型上下文窗口（高达 131K token），允许您在提示中包含大量代码和上下文。 +* **视觉功能：** 当您需要处理或分析图像时，选择启用视觉的模型（`grok-2-vision-latest`、`grok-2-vision` 等）。 +* **定价：** 定价因模型而异，输入成本从每百万 token 0.3 美元到 5.0 美元不等，输出成本从每百万 token 0.5 美元到 25.0 美元不等。有关最新定价信息，请参阅 xAI 文档。 +* **性能权衡：** “快速”变体通常提供更快的响应时间，但成本可能更高，而“迷你”变体更经济，但功能可能有所降低。 \ No newline at end of file diff --git a/i18n/zh-CN/docusaurus-theme-classic/footer.json b/i18n/zh-CN/docusaurus-theme-classic/footer.json index d34e7c0..5f32c59 100644 --- a/i18n/zh-CN/docusaurus-theme-classic/footer.json +++ b/i18n/zh-CN/docusaurus-theme-classic/footer.json @@ -1,6 +1,6 @@ { "link.title.Community": { - "message": "Community", + "message": "社区", "description": "The title of the footer links column with title=Community in the footer" }, "link.title.GitHub": { @@ -8,11 +8,11 @@ "description": "The title of the footer links column with title=GitHub in the footer" }, "link.title.Download": { - "message": "Download", + "message": "下载", "description": "The title of the footer links column with title=Download in the footer" }, "link.title.Company": { - "message": "Company", + "message": "公司", "description": "The title of the footer links column with title=Company in the footer" }, "link.item.label.Discord": { @@ -28,15 +28,15 @@ "description": "The label of footer link with label=Twitter linking to https://x.com/Kilo_Code" }, "link.item.label.Issues": { - "message": "Issues", + "message": "问题与反馈", "description": "The label of footer link with label=Issues linking to https://github.com/Kilo-Org/kilocode/issues" }, "link.item.label.Feature Requests": { - "message": "Feature Requests", + "message": "功能建议", "description": "The label of footer link with label=Feature Requests linking to https://github.com/Kilo-Org/kilocode/discussions/categories/ideas" }, "link.item.label.VS Code Marketplace": { - "message": "VS Code Marketplace", + "message": "VS Code 扩展市场", "description": "The label of footer link with label=VS Code Marketplace linking to https://marketplace.visualstudio.com/items?itemName=kilocode.kilo-code" }, "link.item.label.Open VSX Registry": { @@ -44,19 +44,20 @@ "description": "The label of footer link with label=Open VSX Registry linking to https://open-vsx.org/extension/kilocode/kilo-code" }, "link.item.label.Contact": { - "message": "Contact", + "message": "联系我们", "description": "The label of footer link with label=Contact linking to mailto:hi@kilocode.ai" }, "link.item.label.Careers": { - "message": "Careers", + "message": "官网", "description": "The label of footer link with label=Careers linking to https://kilocode.ai" }, "link.item.label.Website Privacy Policy": { - "message": "Website Privacy Policy", + "message": "网站隐私政策", "description": "The label of footer link with label=Website Privacy Policy linking to https://kilocode.ai/privacy" }, "link.item.label.Extension Privacy Policy": { - "message": "Extension Privacy Policy", + "message": "扩展隐私政策", "description": "The label of footer link with label=Extension Privacy Policy linking to https://github.com/Kilo-Org/kilocode/blob/main/PRIVACY.md" } } + diff --git a/i18n/zh-CN/docusaurus-theme-classic/navbar.json b/i18n/zh-CN/docusaurus-theme-classic/navbar.json index b66f5a6..47725fd 100644 --- a/i18n/zh-CN/docusaurus-theme-classic/navbar.json +++ b/i18n/zh-CN/docusaurus-theme-classic/navbar.json @@ -12,7 +12,7 @@ "description": "Navbar item with label GitHub" }, "item.label.Install Extension": { - "message": "Install Extension", + "message": "安装扩展", "description": "Navbar item with label Install Extension" } }