diff --git a/config.mts b/config.mts new file mode 100644 index 00000000..3da6fac6 --- /dev/null +++ b/config.mts @@ -0,0 +1,87 @@ +import { defineAdditionalConfig } from "vitepress"; + +export default defineAdditionalConfig({ + lang: 'zh-Hans', + description: 'Kimi Code 文档', + themeConfig: { + sidebar: [ + { + text: 'Kimi Code', + items: [ + { text: '产品概览', link: '/' }, + { text: '最新动态', link: '/kimi-code/whats-new' }, + { text: '社区倡议', link: '/kimi-code/community-guidelines' }, + { text: '常见问题', link: '/kimi-code/faq' }, + { text: '错误参考', link: '/kimi-code/error-reference' }, + ], + }, + { + text: 'Kimi Code CLI', + items: [ + { text: '📢 版本升级', link: '/kimi-code-cli/cli-migration' }, + { + text: '指南', + collapsed: false, + items: [ + { text: '开始使用', link: '/kimi-code-cli/getting-started' }, + { text: '交互与输入', link: '/kimi-code-cli/interaction' }, + { text: '会话与上下文', link: '/kimi-code-cli/sessions' }, + { text: '常见使用案例', link: '/kimi-code-cli/use-cases' }, + ], + }, + { + text: '配置', + collapsed: false, + items: [ + { text: '配置文件', link: '/kimi-code-cli/configuration/configuration-files' }, + { text: '配置覆盖', link: '/kimi-code-cli/configuration/overrides-and-precedence' }, + { text: '环境变量', link: '/kimi-code-cli/configuration/environment-variables' }, + { text: '平台与模型', link: '/kimi-code-cli/configuration/providers-and-models' }, + { text: '数据路径', link: '/kimi-code-cli/configuration/data-locations' }, + ], + }, + { + text: '定制化', + collapsed: false, + items: [ + { text: 'Agent 与子 Agent', link: '/kimi-code-cli/customization/sub-agents' }, + { text: 'Hooks', link: '/kimi-code-cli/customization/hooks' }, + { text: 'MCP', link: '/kimi-code-cli/customization/mcp' }, + { text: 'Plugins', link: '/kimi-code-cli/customization/plugins' }, + { text: '官方插件', link: '/kimi-code-cli/customization/datasource' }, + { text: 'Agent Skills', link: '/kimi-code-cli/customization/skills' }, + ], + }, + { + text: '参考手册', + collapsed: true, + items: [ + { text: 'kimi 命令', link: '/kimi-code-cli/reference/kimi-command' }, + { text: '斜杠命令', link: '/kimi-code-cli/reference/slash-commands' }, + { text: '内置工具', link: '/kimi-code-cli/reference/tools' }, + { text: '键盘快捷键', link: '/kimi-code-cli/reference/keyboard-shortcuts' }, + ], + }, + ], + }, + { + text: 'Kimi Code for VS Code', + items: [ + { text: '快速开始', link: '/kimi-code-for-vscode/getting-started' }, + { text: '核心操作', link: '/kimi-code-for-vscode/core-operations' }, + { text: '配置', link: '/kimi-code-for-vscode/configuration' }, + { text: '定制化', link: '/kimi-code-for-vscode/customization' }, + ], + }, + { + text: '在更多第三方工具中使用', + items: [ + { text: 'JetBrains', link: '/third-party-tools/jetbrains' }, + { text: 'Zed', link: '/third-party-tools/zed' }, + { text: 'Zsh', link: '/third-party-tools/zsh' }, + { text: '在其他 coding agent 中使用', link: '/third-party-tools/other-coding-agents' }, + ], + }, + ], + }, +}); diff --git a/zh/kimi-code-cli/configuration/environment-variables.md b/zh/kimi-code-cli/configuration/environment-variables.md new file mode 100644 index 00000000..3d94081d --- /dev/null +++ b/zh/kimi-code-cli/configuration/environment-variables.md @@ -0,0 +1,162 @@ +# 环境变量 + +Kimi Code CLI 通过环境变量控制少数运行时行为——迁移数据目录、关闭遥测、不改配置文件临时切换模型。 + +::: warning 重要：API 密钥不在这里配置 +`KIMI_API_KEY`、`ANTHROPIC_API_KEY`、`OPENAI_API_KEY` 等密钥变量**不会**从 shell 环境变量自动读取。在终端里 `export KIMI_API_KEY=xxx` 不会让任何供应商获得密钥——必须写在 `config.toml` 的 `[providers.]` 段或 `[providers..env]` 子表里。 + +唯一的例外是 `KIMI_MODEL_*` 系列，它是一个显式通道，*确实*会从 shell 读取凭证——详见[用环境变量定义模型](#用环境变量定义模型-kimi-model)。 + +背景说明见[配置覆盖：供应商凭证](./overrides-and-precedence.md#供应商凭证)。 +::: + +## 核心路径 + +### `KIMI_CODE_HOME` + +覆盖数据根目录，默认 `~/.kimi-code`。设置后，配置文件、会话、日志、OAuth 凭据等全部数据都落到新路径下： + +```sh +export KIMI_CODE_HOME="/path/to/custom/kimi-code" +``` + +> 确保目录可写。多个 `kimi` 实例共用同一个 `KIMI_CODE_HOME` 会共享配置和凭证。 + +数据目录的完整结构见[数据路径](./data-locations.md)。 + +### `KIMI_DISABLE_TELEMETRY` + +设为 `1` 关闭匿名遥测上报（也接受 `true`/`yes`/`y`，不区分大小写）： + +```sh +export KIMI_DISABLE_TELEMETRY=1 +``` + +### `KIMI_MODEL_*` 系列 + +不修改 `config.toml` 临时切换模型——设置 `KIMI_MODEL_NAME` 后，CLI 在内存里合成一个临时供应商，重启后失效。详见[用环境变量定义模型](#用环境变量定义模型kimi_model)。 + +## 供应商凭证键（写在 config.toml 里） + +下面这些键名不是直接从 shell 读取的——它们是写在 `config.toml` 的 `[providers..env]` 子表里、作为 `api_key` / `base_url` 备用来源的键名。CLI 只从配置文件读取，不从 `process.env` 读取。 + +这样设计是为了让你保留熟悉的键名写法，同时把密钥放在配置文件里统一管理： + +```toml +[providers.kimi.env] +KIMI_API_KEY = "sk-xxx" +KIMI_BASE_URL = "https://api.moonshot.ai/v1" +``` + +各供应商对应的键名： + +| 键名 | 适用供应商 | 默认值 | +| --- | --- | --- | +| `KIMI_API_KEY` | Kimi / Moonshot | 无 | +| `KIMI_BASE_URL` | Kimi / Moonshot | `https://api.moonshot.ai/v1` | +| `ANTHROPIC_API_KEY` | Anthropic | 无 | +| `ANTHROPIC_BASE_URL` | Anthropic | Anthropic SDK 默认值 | +| `OPENAI_API_KEY` | OpenAI（`openai` 和 `openai_responses`） | 无 | +| `OPENAI_BASE_URL` | OpenAI（`openai` 和 `openai_responses`） | `https://api.openai.com/v1` | +| `GOOGLE_API_KEY` | Google GenAI、Vertex AI | 无 | +| `VERTEXAI_API_KEY` | Vertex AI | 无 | +| `GOOGLE_CLOUD_PROJECT` | Vertex AI | 无 | +| `GOOGLE_CLOUD_LOCATION` | Vertex AI | 无 | + +::: warning +`GOOGLE_APPLICATION_CREDENTIALS`（服务账号 JSON 路径）是唯一走系统环境变量的例外——它由 Google SDK 自身通过 ADC 流程读取，CLI 不参与。其他所有键名都必须写在 `[providers..env]` 子表里。 +::: + +供应商类型与字段的完整说明见[平台与模型](./providers-and-models.md)。 + +## OAuth 与托管端点 + +这组变量用于将 OAuth 认证和托管服务端点指向自建或测试环境，日常使用不需要设置。 + +| 环境变量 | 用途 | 默认值 | +| --- | --- | --- | +| `KIMI_CODE_OAUTH_HOST` | OAuth 认证 host，优先级最高 | 未设时回退到 `KIMI_OAUTH_HOST` | +| `KIMI_OAUTH_HOST` | OAuth 认证 host，作为上一个的 fallback | 未设时使用 `https://auth.kimi.com` | +| `KIMI_CODE_BASE_URL` | OAuth 登录后的托管 API base URL | `https://api.kimi.com/coding/v1` | + +::: warning +`KIMI_CODE_BASE_URL`（OAuth 托管服务，指向 `kimi.com`）和 `KIMI_BASE_URL`（API 密钥直连，指向 `moonshot.ai`）是两个不同的变量，请按场景区分。 +::: + +## 用环境变量定义模型（`KIMI_MODEL_*`） + +测试时想换个模型但不想动 `config.toml`？设置 `KIMI_MODEL_NAME` 后，CLI 会从 `KIMI_MODEL_*` 系列变量在内存里合成出一个临时供应商和模型别名，不写回配置文件。优先级高于 `config.toml` 的 `default_model`，但低于启动时 `-m ` 选项。 + +```sh +export KIMI_MODEL_NAME="kimi-for-coding" +export KIMI_MODEL_API_KEY="YOUR_API_KEY" +export KIMI_MODEL_BASE_URL="https://api.example.com/v1" +export KIMI_MODEL_MAX_CONTEXT_SIZE="262144" +export KIMI_MODEL_CAPABILITIES="image_in,thinking" +kimi +``` + +完整变量列表： + +| 环境变量 | 必填 | 用途 | 默认值 | +| --- | --- | --- | --- | +| `KIMI_MODEL_NAME` | 是（同时是启用开关） | 发送给 API 的模型 ID | — | +| `KIMI_MODEL_API_KEY` | 是 | API 密钥 | — | +| `KIMI_MODEL_PROVIDER_TYPE` | 否 | 供应商类型：`kimi`、`anthropic`、`openai` | `kimi` | +| `KIMI_MODEL_BASE_URL` | 否 | API 基础 URL | 各类型有各自默认值 | +| `KIMI_MODEL_MAX_CONTEXT_SIZE` | 否 | 最大上下文长度（token 数） | `262144`（256K） | +| `KIMI_MODEL_CAPABILITIES` | 否 | 逗号分隔的能力标签，与自动探测的能力取并集 | `image_in,thinking` | +| `KIMI_MODEL_DISPLAY_NAME` | 否 | 在 `/model` 中显示的名称 | 回退到 `KIMI_MODEL_NAME` | +| `KIMI_MODEL_MAX_OUTPUT_SIZE` | 否 | 单次输出上限（仅 `anthropic`） | 模型默认值 | +| `KIMI_MODEL_REASONING_KEY` | 否 | 推理字段名覆盖（仅 `openai`） | 自动探测 | +| `KIMI_MODEL_DEFAULT_THINKING` | 否 | 新会话的默认 Thinking 开关 | 跟随全局默认 | +| `KIMI_MODEL_THINKING_MODE` | 否 | Thinking 触发策略：`auto`/`on`/`off` | — | +| `KIMI_MODEL_THINKING_EFFORT` | 否 | Thinking 强度：`low`/`medium`/`high`/`xhigh`/`max` | — | +| `KIMI_MODEL_ADAPTIVE_THINKING` | 否 | 强制开启或关闭 adaptive thinking（仅 `anthropic`） | 按模型名推断 | + +设置了 `KIMI_MODEL_NAME` 但缺少必填变量时，启动会立即失败并给出明确提示。 + +## 运行时开关 + +控制遥测、后台任务、plugin marketplace 等子系统行为的开关变量： + +| 环境变量 | 用途 | 合法值 | +| --- | --- | --- | +| `KIMI_DISABLE_TELEMETRY` | 关闭匿名遥测上报 | `1`、`true`、`yes`、`y`（不区分大小写） | +| `KIMI_CODE_BACKGROUND_KEEP_ALIVE_ON_EXIT` | 会话关闭时是否保留后台任务，优先级高于 `config.toml` | 真值：`1`/`true`/`yes`/`on`；假值：`0`/`false`/`no`/`off` | +| `KIMI_CODE_PLUGIN_MARKETPLACE_URL` | 替换 `/plugins` 加载的 marketplace JSON | URL 或本地路径 | +| `KIMI_SHELL_PATH` | Windows 上覆盖 Git Bash 路径（自动探测失败时使用） | 绝对路径 | +| `KIMI_MODEL_MAX_COMPLETION_TOKENS` | 单步 LLM 请求的 `max_completion_tokens` 硬上限，仅对 `kimi` 供应商生效 | 正整数；`0` 或负数禁用 clamp | +| `KIMI_DISABLE_CRON` | 禁用定时任务工具（`CronCreate` 拒绝新计划，已有任务不触发） | `1` 表示禁用 | + +## 诊断日志 + +这组变量控制日志级别和文件滚动，进程启动时读取一次： + +| 环境变量 | 用途 | 默认值 | +| --- | --- | --- | +| `KIMI_LOG_LEVEL` | 日志级别：`off`、`error`、`warn`、`info`、`debug` | `info` | +| `KIMI_LOG_GLOBAL_MAX_BYTES` | 全局日志文件单个最大字节数 | `6291456`（6 MB） | +| `KIMI_LOG_GLOBAL_FILES` | 全局日志文件保留份数 | `5` | +| `KIMI_LOG_SESSION_MAX_BYTES` | 会话级日志文件单个最大字节数 | `5242880`（5 MB） | +| `KIMI_LOG_SESSION_FILES` | 会话级日志文件保留份数 | `3` | + +## 系统环境变量 + +CLI 还会读取一些标准系统变量来检测运行环境，不会修改它们： + +- `HOME`：解析默认数据路径 +- `VISUAL`、`EDITOR`：外部编辑器命令（`VISUAL` 优先） +- `PATH`：定位 `rg`、`git` 等依赖 +- `NO_COLOR`、`FORCE_COLOR`：控制颜色输出（遵循 [no-color.org](https://no-color.org) 约定） +- `CI`：非空且非 `"0"` 时关闭主题检测，回退深色主题 +- `TERM_PROGRAM`、`TERM`、`TMUX`：检测终端特性和通知支持 +- `DISPLAY`、`WAYLAND_DISPLAY`、`XDG_SESSION_TYPE`：检测 Linux 图形会话（用于剪贴板和图片功能） +- `WSL_DISTRO_NAME`、`WSLENV`：检测 WSL，用于剪贴板 PowerShell 桥接 +- `LOCALAPPDATA`：Windows 上探测 Git Bash 安装路径 + +## 下一步 + +- [配置覆盖](./overrides-and-precedence.md) — 环境变量、CLI 选项、配置文件的优先级关系 +- [数据路径](./data-locations.md) — `KIMI_CODE_HOME` 影响的完整目录结构 +- [平台与模型](./providers-and-models.md) — 各供应商类型的完整接入示例 diff --git a/zh/kimi-code-cli/customization/datasource.md b/zh/kimi-code-cli/customization/datasource.md new file mode 100644 index 00000000..30ba0bc5 --- /dev/null +++ b/zh/kimi-code-cli/customization/datasource.md @@ -0,0 +1,93 @@ +# 官方插件 + +Kimi Datasource 是 Kimi Code 官方数据插件，通过自然语言直接查询金融行情、宏观经济、企业工商和学术文献，无需手动调用接口或申请数据账号。 + +**前提**：需通过 `/login` 以 Kimi Code 账号完成 OAuth 登录，插件依赖本地凭据访问数据服务。 + +## 安装 + +1. 在 Kimi Code CLI 内运行 `/plugin` +2. 在弹出的菜单中选择 **Marketplace** +3. 找到 **Kimi Datasource**，选择安装 +4. 安装完成后运行 `/new` 开启新会话，再次运行 `/plugin` 确认插件状态为已安装 + +## 数据能力 + +插件涵盖以下几类数据，Agent 会根据问题自动选择，无需手动指定： + +**A 股 / 港股行情与财务** + +实时价格、涨跌幅、成交量、换手率；技术指标（MACD、KDJ、RSI、BOLL、MA 等）；历史财务数据（营收、净利润、ROE、资产负债率等）；自选股管理与持仓盈亏计算。 + +> A 股股票代码需带市场后缀，如 `600519.SH`（上交所）、`002594.SZ`（深交所）、`0700.HK`（港股）。 + +**全球市场行情** + +美股、ETF、全球主要指数的实时与历史价格数据。 + +**宏观经济数据** + +世界银行开放数据：各国 GDP、CPI、贸易额、就业率等宏观指标，支持跨国、跨年度对比。 + +**企业工商信息** + +大陆企业的工商注册、主要股东、近期融资、司法纠纷与失信记录，适合合同签署前的背景调研。 + +**学术文献** + +按关键词检索近期论文，返回标题、作者、核心结论，支持跨数据库查询。 + +## 使用示例 + +直接描述需求即可，不需要指定"用哪个数据源"。 + +**查询实时行情** + +``` +比亚迪今天收盘涨了还是跌了，换手率和成交量怎么样？ +``` + +**技术指标分析** + +``` +帮我看一下宁德时代的 MACD 和 KDJ，现在多空信号怎么样？ +``` + +**财务对比** + +``` +帮我把宁德时代和比亚迪 2024 年的资产负债率、净利润率、ROE 拉出来， +做个对比表，判断哪家财务结构更稳健。 +``` + +**宏观经济研究** + +``` +拉一下中美日三国过去 10 年的 GDP 增速和 CPI 数据， +做成年度对比表，标出关键政策节点的影响。 +``` + +## 案例：数据查询与本地分析联动 + +Kimi Datasource 与 Kimi Code CLI 的工具链结合后，可以在一次会话里完成"查数据 → 本地分析 → 写文件"的完整流程： + +``` +分析新能源板块三只头部股（宁德时代 300750.SZ、比亚迪 002594.SZ、 +隆基绿能 601012.SH）过去三年的财务表现： + +1. 分别拉取三家 2022–2024 年的营收、净利润、ROE，各保存到 /tmp/<股票名>.csv +2. 读取三个文件，用 Python 计算三年复合增长率，生成对比表 +3. 用 matplotlib 画折线图，保存到 /tmp/comparison.png +4. 结合数据写 200 字结论，写入 /tmp/report.md，打印文件路径 +``` + +## 注意事项 + +- 数据查询按次计费，消耗 Kimi Code 账号额度 +- 插件为只读查询，不提供任何写入或交易功能 +- AI 输出内容仅供参考，不构成任何商业决策建议 + +## 下一步 + +- [Plugins](./plugins.md) — Plugin 系统的完整安装与开发文档 +- [MCP](./mcp.md) — kimi-datasource 基于 MCP 协议运行，了解底层机制 diff --git a/zh/kimi-code-cli/customization/mcp.md b/zh/kimi-code-cli/customization/mcp.md new file mode 100644 index 00000000..55d6878a --- /dev/null +++ b/zh/kimi-code-cli/customization/mcp.md @@ -0,0 +1,97 @@ +# Model Context Protocol + +[Model Context Protocol（MCP）](https://modelcontextprotocol.io/) 是一个开放协议，让模型可以安全地调用外部进程或服务暴露的工具——例如读取 GitHub issues、查询数据库、操作本地文件系统。Kimi Code CLI 作为 MCP client 接入这些外部工具，并把它们与内置工具（`Read`、`Bash`、`Grep` 等）一起暴露给 Agent 使用，行为上没有差异。 + +## 接入方式 + +Kimi Code CLI 支持两种 MCP server 接入方式： + +- **stdio**：CLI 以子进程方式启动本地 MCP server，通过标准输入输出通信。适合本地命令行工具。 +- **HTTP**：CLI 连接一个已在运行的 HTTP 端点。适合远程服务或需要持久运行的进程。 + +## 配置 + +MCP server 配置写在 `mcp.json` 中，分两层： + +- **用户级**：`~/.kimi-code/mcp.json`（或 `$KIMI_CODE_HOME/mcp.json`），跨项目共享 +- **项目级**：工作目录下的 `.kimi-code/mcp.json`，只对当前仓库生效 + +同名条目以项目级为准，覆盖用户级。 + +在 TUI 中运行 `/mcp-config` 可以交互式地新增、编辑或删除 server，无需手动编辑 JSON 文件。运行 `/mcp` 可查看当前所有 server 的连接状态。 + +`mcp.json` 的结构： + +```json +{ + "mcpServers": { + "filesystem": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"] + }, + "linear": { + "url": "https://mcp.linear.app/mcp" + } + } +} +``` + +含 `command` 字段的条目为 stdio server，含 `url` 字段的条目为 HTTP server，通常不需要手写 `transport` 字段。 + +可选字段： + +| 字段 | 类型 | 适用方式 | 说明 | +| --- | --- | --- | --- | +| `env` | `Record` | stdio | 注入子进程的环境变量 | +| `cwd` | `string` | stdio | 子进程工作目录 | +| `headers` | `Record` | HTTP | 附加到每次请求的静态请求头 | +| `enabled` | `boolean` | 两者 | 设为 `false` 可禁用该 server | +| `startupTimeoutMs` | `number` | 两者 | 连接超时，默认 `30000` 毫秒 | +| `toolTimeoutMs` | `number` | 两者 | 单次工具调用超时 | +| `enabledTools` | `string[]` | 两者 | 工具白名单 | +| `disabledTools` | `string[]` | 两者 | 工具黑名单 | + +HTTP server 支持通过 `headers` 或 `bearerTokenEnvVar` 提供静态凭证。需要 OAuth 时，运行 `/mcp-config login ` 完成浏览器授权。 + +Plugins 也可以在 manifest 中声明 MCP servers。Plugin 声明的 servers 默认启用，可以在 `/plugins` 中禁用或重新启用，然后开启新会话。详见 [Plugins](./plugins.md)。 + +::: warning 注意 +项目级 `.kimi-code/mcp.json` 中的 stdio 条目会在会话启动时执行本地命令，只在你信任的仓库里启用。 +::: + +## 工具命名与权限 + +MCP 工具按 `mcp____` 格式命名，例如 `mcp__github__create_issue`。权限规则中支持 `*` 和 `**` 通配，例如 `mcp__github__*` 命中该 server 下所有工具。MCP 工具参数不参与权限匹配。 + +未命中权限规则的调用会触发审批请求；在审批弹窗中选择"Approve for this session"后，本次会话内的后续同类调用自动放行。 + +也可以在 `config.toml` 的 `[[permission.rules]]` 中预置永久规则： + +```toml +[[permission.rules]] +decision = "allow" +pattern = "mcp__github__*" + +[[permission.rules]] +decision = "deny" +pattern = "mcp__filesystem__write_file" +``` + +权限规则的完整语法见[配置文件](../configuration/configuration-files.md#permission)。 + +## 安全性 + +接入外部 MCP server 时需注意： + +- 只接入可信来源的 server +- 在审批请求中核查工具名与参数是否合理 +- 对高风险工具（写文件、执行命令等）维持手动审批，避免用 `mcp__*` 通配放行全部工具 + +::: warning 注意 +在 YOLO 模式下，MCP 工具调用会被自动批准。仅在完全信任所接入的 MCP server 时使用此模式。 +::: + +## 下一步 + +- [Plugins](./plugins.md) — 在 plugin manifest 中声明 MCP server，一键打包和分发 +- [配置文件](../configuration/configuration-files.md#permission) — 权限规则的完整字段参考 diff --git a/zh/kimi-code-cli/interaction.md b/zh/kimi-code-cli/interaction.md new file mode 100644 index 00000000..28488daf --- /dev/null +++ b/zh/kimi-code-cli/interaction.md @@ -0,0 +1,85 @@ +# 交互与输入 + +Kimi Code CLI 以交互式 TUI 运行，核心由输入框、对话视图和状态栏三部分组成。本页介绍输入方式、媒体粘贴、审批流程和模式切换。 + +## 输入框基本操作 + +输入框接受自由文本：`Enter` 发送，`Shift-Enter` 或 `Ctrl-J` 插入换行。输入框为空时按 `↑` / `↓` 浏览当前工作目录的历史输入。 + +**退出 CLI**：输入框为空时按 `Ctrl-D`，或空闲状态下连按 `Ctrl-C` 两次，或输入 `/exit`。流式输出期间按 `Ctrl-C` 或 `Esc` 是中断当前轮次，不会退出程序。 + +## 粘贴图片与视频 + +Kimi Code CLI 支持在输入框中直接粘贴图片和视频，让 AI 结合视觉内容理解你的问题——截图报错、UI 设计图、架构图，直接粘贴进去就能讨论，无需上传或转存。 + +**视频输入是 Kimi Code 的特色能力**，支持直接粘贴视频片段让模型分析其中的内容、界面流程或代码演示。 + +操作方式： + +- **macOS / Linux**：`Ctrl-V` +- **Windows**：`Alt-V` + +粘贴后输入框显示占位符，可像普通文本一样编辑；提交时自动替换为实际内容。纯文本剪贴板会回退到普通粘贴。媒体功能是否可用取决于当前模型的多模态能力（`image_in` / `video_in`），登录 Kimi Code 账号后默认开启。 + +## 斜杠命令 + +以 `/` 开头的内容会被识别为斜杠命令。输入 `/` 后弹出补全菜单，随后续字符实时过滤；按 `Esc` 关闭菜单，匹配失败时内容会作为普通消息发送给 Agent。 + +已激活的 [Agent Skills](./customization/skills.md) 会自动注册为斜杠命令，以 `/skill:` 调用；若 Skill 名称与内置命令不冲突，也可以省略 `skill:` 前缀直接输入 `/`。 + +部分命令仅在 Agent 空闲时可用，流式输出或上下文压缩期间需先按 `Esc` 中断。`/yolo`、`/plan`、`/help` 等始终可用。全部命令说明见[斜杠命令参考](./reference/slash-commands.md)。 + +## 文件引用 + +键入 `@` 触发文件路径补全，选中后在输入中插入相对路径，Agent 读取时会直接加载该文件内容。以点开头的目录默认隐藏，可显式输入如 `@.github/` 访问。 + +> `@` 引用和斜杠命令是两套不同的机制：`@` 向 Agent 提供文件上下文，`/` 调用内置功能或 Skill。 + +## 审批流程 + +Agent 调用会产生副作用的工具（修改文件、执行命令等）时，TUI 会弹出审批面板让你确认。YOLO 模式以及 Plan 模式下对计划文件的写入不触发审批。 + +用方向键选择选项，`Enter` 确认；也可以按 `1`/`2`/`3` 数字键直接选择。`Esc`、`Ctrl-C`、`Ctrl-D` 等同于拒绝。 + +面板中通常有「Approve for this session」选项，选择后本次会话内的同类调用将自动放行。如需永久规则，在[配置文件](./configuration/configuration-files.md#permission)里预置 allow / deny 规则即可。 + +## 模式切换 + +### Plan 模式 + +Plan 模式下，Agent 先输出行动计划，等待你确认后才动手修改文件，适合复杂或高风险任务。 + +- 切换：`Shift-Tab` 或 `/plan` +- 清除当前计划：`/plan clear`（仅空闲时） + +Agent 输出方案后会等待你审批——可批准执行、拒绝、或要求修改。退出 Plan 模式始终需要你确认，即使开启了 YOLO 模式也不例外。 + +### YOLO / Auto 模式 + +**YOLO 模式**（`/yolo`）跳过几乎所有工具调用的审批确认，适合已知安全的批处理任务，Plan 模式的退出审批除外。 + +**Auto 模式**（`/auto`）则更克制：工具审批自动处理，但 Agent 不会向用户提问，适合需要无人值守但又不想完全关闭审批的场景。 + +::: warning 注意 +YOLO 模式会跳过文件写入和命令执行的确认，请只在受信任的工作目录下使用。 +::: + +## 流式输出期间 + +Agent 思考或调用工具时，输入框仍然可用，支持以下额外操作： + +- **`Ctrl-S`**：把输入框中的内容立即注入正在运行的轮次，无需等待结束 +- **`Esc` / `Ctrl-C`**：中断当前轮次 +- **`Ctrl-O`**：全局切换工具输出的折叠状态 + +## 外部编辑器 + +按 `Ctrl-G` 把当前输入内容发给外部编辑器，保存后回填到输入框，不保存则保持原样。适合需要输入大段文本或带格式内容的场景。 + +编辑器优先级：`/editor` 配置 > `$VISUAL` 环境变量 > `$EDITOR` 环境变量。未配置时可先运行 `/editor` 选择默认编辑器。 + +## 下一步 + +- [键盘快捷键](./reference/keyboard-shortcuts.md) — 全部快捷键的完整速查表 +- [斜杠命令](./reference/slash-commands.md) — 所有内置命令的说明与别名 +- [会话与上下文](./sessions.md) — 如何恢复会话、压缩上下文、导出对话 diff --git a/zh/kimi-code/whats-new.md b/zh/kimi-code/whats-new.md new file mode 100644 index 00000000..22d77a17 --- /dev/null +++ b/zh/kimi-code/whats-new.md @@ -0,0 +1,220 @@ +# 最新动态 + +记录 Kimi Code 各产品的新功能与核心修复，重点介绍最值得关注的变化。 + +
+ + +
+
+ 最新 + Kimi Code CLI +
v0.8.0
+
2026 年 6 月 2 日
+
+
+ +**自主 Goal 模式（实验）**：输入 `/goal <目标>` 后，Kimi 会在多个轮次里持续推进同一个目标，直到完成、被暂停或遇到阻塞，省去了一轮一轮手动催的步骤。用 `/goal pause` / `/goal resume` / `/goal cancel` 管理进度，需提前设置 `KIMI_CODE_EXPERIMENTAL_GOAL_COMMAND=1` 启用。→ [自主 goal](/kimi-code-cli/reference/slash-commands#自主-goal实验功能) + +**后台结构化提问**：Agent 遇到需要你做选择的问题时，会将提问挂到后台，同时继续处理其他步骤，不再因为一个小问题卡住整个流程。→ [AskUserQuestion](/kimi-code-cli/reference/tools#协作类) + +**`kimi provider` 子命令**：直接在 shell 里管理供应商，无需打开 TUI。`kimi provider add ` 从自定义 registry 批量导入，`catalog list / catalog add` 从 models.dev 公共目录导入，适合脚本或 CI 场景。→ [kimi provider](/kimi-code-cli/reference/kimi-command#kimi-provider) + +此外：**后台自动更新**默认开启（可在 `tui.toml` 中关闭）；**上下文压缩**时会把当前待办列表附在摘要里，防止 Agent 忘记中断前的进度。 + +
+
+ + +
+
+ Kimi Code CLI +
v0.7.0
+
2026 年 6 月 2 日
+
+
+ +**`/provider` 交互式供应商管理器**：在 TUI 中输入 `/provider` 打开可视化管理界面，查看所有已配置供应商、添加新来源、删除旧条目，切换模型时按供应商分标签页选择，不需要手动改 `config.toml`。→ [平台与模型](/kimi-code-cli/configuration/providers-and-models#provider-与供应商管理) + +**`KIMI_MODEL_ADAPTIVE_THINKING` 环境变量**：可强制开启或关闭 adaptive thinking，专为自定义命名端点设计——当模型名无法自动解析 Claude 版本时，用这个变量显式指定，不再依赖自动推断。→ [模型字段](/kimi-code-cli/configuration/configuration-files#models) + +此外：定时任务触发时间现在以**本地时区**格式显示，不再是 UTC。 + +
+
+ + +
+
+ Kimi Code CLI +
v0.6.0
+
2026 年 5 月 29 日
+
+
+ +**`KIMI_MODEL_*` 环境变量通道**：设置 `KIMI_MODEL_NAME` 和 `KIMI_MODEL_API_KEY` 就能让 Kimi Code 使用指定模型，完全不需要修改 `config.toml`，重启后自动失效。供应商类型、Base URL、上下文长度、Thinking 配置均可通过对应的 `KIMI_MODEL_*` 变量覆盖，适合临时测试或 CI 环境快速切换。→ [用环境变量定义模型](/kimi-code-cli/configuration/environment-variables#用环境变量定义模型-kimi-model) + +**从 GitHub URL 直接安装 Plugin**：`/plugins install https://github.com//` 安装最新 release，也支持指定分支、tag 或 commit。Plugin 管理器标注来源信任等级：`kimi-official`（官方）、`curated`（精选）、`third-party`（其他）。→ [安装与管理](/kimi-code-cli/customization/plugins#安装与管理) + +**移除默认步数上限**：之前每轮 Agent 最多执行 1000 步，现已取消，长任务不再被强制打断。如需重新限制，可在 `config.toml` 里手动设 `max_steps_per_turn`。→ [loop\_control](/kimi-code-cli/configuration/configuration-files#loop_control) + +
+
+ + +
+
+ Kimi Code CLI +
v0.5.0
+
2026 年 5 月 28 日
+
+
+ +**定时任务**：在会话里用自然语言设定 cron 计划或一次性提醒，Kimi 会在指定时间自动执行，计划绑定当前会话，`kimi resume` 后重新加载继续触发。 + +``` +每个工作日上午 9 点帮我汇总 CI 失败情况 +30 分钟后提醒我检查部署 +``` + +→ [定时任务](/kimi-code-cli/reference/tools#定时任务) + +**`/auto` 权限模式**：新增 `/auto` 命令和 `--auto` 启动参数。开启后工具审批自动处理，Agent 不会向用户提问，比 `--yolo` 更克制——保留权限判断，不会盲目执行危险操作，适合无人值守但不想完全放开的场景。→ [交互与输入](/kimi-code-cli/interaction#yolo--auto-模式) + +此外：`Ctrl-O` 展开工具输出时 Bash 命令显示完整内容；待办列表面板最多显示 5 行，超出部分显示 `+N more`。 + +
+
+ + +
+
+ Kimi Code CLI +
v0.4.0
+
2026 年 5 月 27 日
+
+
+ +**Plugin 系统上线**：支持按用户安装 Plugin，每个 Plugin 可以携带 Agent Skills、在会话启动时自动加载 Skill，以及声明自己的 MCP servers。`/plugins` 打开交互式管理器，`Space` 安装或更新，`M` 管理 MCP server 开关。官方 marketplace 同步上线，包含 Kimi Datasource 等官方插件。→ [Plugins](/kimi-code-cli/customization/plugins) + +**会话导出**：`/export-md` 把当前会话导出为可读的 Markdown 文件；`/export-debug-zip` 打包会话目录（含诊断日志）为 ZIP，适合提交反馈时附上。→ [会话与上下文](/kimi-code-cli/sessions#导出会话) + +**权限系统重构**：工作目录外的只读操作不再触发审批，减少不必要的确认打断；会话级审批现在精确匹配调用，路径匹配改为大小写不敏感。→ [权限配置](/kimi-code-cli/configuration/configuration-files#permission) + +
+
+ + +
+
+ Kimi Code CLI +
v0.2.0 – v0.3.0
+
2026 年 5 月 26 日
+
+
+ +**OpenAI 兼容推理模型开箱即用**：`openai` 供应商现在自动识别响应中的推理字段（`reasoning_content`、`reasoning_details`、`reasoning`），对含有思考历史的请求自动注入 `reasoning_effort`。DeepSeek、Qwen、One API 等网关托管服务无需额外配置即可使用 thinking。→ [openai 供应商](/kimi-code-cli/configuration/providers-and-models#openai) + +**`/logout` 支持选择供应商**：弹出选择器列出所有已登录供应商，当前供应商默认高亮，避免误退出其他供应商的登录态。 + +**`/connect` 命令**：从 models.dev 公共目录选择供应商并配置，内置搜索过滤，无需手写 TOML。（v0.7.0 起已升级为功能更完整的 `/provider` 命令。） + +
+
+ + +
+
+ Kimi Code CLI +
v0.1.0
+
2026 年 5 月
+
+
+ +**Kimi Code CLI 新版首发**，底层从 Python / uv 完整重写为 TypeScript / Node.js。这不是一次渐进式更新，而是一个新起点——核心架构、安装方式、配置格式全面升级。 + +与旧版 kimi-cli 的主要区别： + +| 对比项 | 旧版 kimi-cli | 新版 Kimi Code CLI | +| --- | --- | --- | +| 运行时 | Python + uv | Node.js（无 Python 依赖） | +| 安装 | `uv tool install` | 一行 `curl` 脚本或 `npm install -g` | +| 配置文件 | `~/.kimi/config.toml` | `~/.kimi-code/config.toml`（格式不兼容） | +| 终端界面 | 基础文本输出 | 全功能 TUI（对话视图 + 状态栏 + 审批面板） | +| 启动速度 | 较慢（Python 冷启动） | 更快（Node.js 原生二进制） | +| 多供应商支持 | 有限 | 内置 Anthropic / OpenAI / Gemini / Vertex 等 | +| Agent 子任务 | 不支持 | 内置 coder / explore / plan 三种子 Agent | +| Plugin 系统 | 不支持 | 支持（v0.4.0 起） | +| 定时任务 | 不支持 | 支持（v0.5.0 起） | + +已有 kimi-cli 数据（配置、会话、MCP 声明）可通过 `kimi migrate` 一键迁移。→ [版本升级](/kimi-code-cli/cli-migration) + +
+
+ +
+ +