Kimi Stage

一个本地 HTML 舞台：浏览器只连接本机服务，API Key 和 OAuth token 只在本机服务端使用，不写进页面。

本仓库开发

pnpm dev:html-panel

打开启动日志里显示的本地 URL。默认从 http://localhost:8789 开始，端口被占用时会自动换到下一个端口。

npm 体验

发布后，同事可以任选一种方式启动：

npx kimi-stage
pnpm dlx kimi-stage

如果经常使用，也可以全局安装：

npm install -g kimi-stage
kimi-stage

Kimi for Coding

kimi-code/kimi-for-coding 不走 ARENA 网关，它走 TUI 同款 OAuth。启动页面后可以直接点右上角 Kimi 登录 完成授权。

kimi-stage --kimi-base-url "$KIMI_CODE_BASE_URL" --kimi-oauth-host "$KIMI_CODE_OAUTH_HOST"
kimi-stage --login-kimi --kimi-oauth-host "$KIMI_CODE_OAUTH_HOST"

OAuth 凭证会按 TUI 兼容格式保存到 ~/.kimi-code/credentials/kimi-code.json。

启动参数

kimi-stage --gateway "$ARENA_GATEWAY" --key "$ARENA_KEY" --arena-model kimi-k2.6-300 --model kimi-k2.6-300

| 参数 | 环境变量 | 默认值 | 说明 | |---|---|---|---| | --key | ARENA_KEY | 空 | ARENA 网关 API Key。推荐启动时传入，不在页面显示。 | | --arena-model | ARENA_MODEL | 空 | 要加入下拉框的 ARENA 模型名，例如 kimi-k2.6-300。不传就不显示 ARENA 模型。 | | --arena-label | ARENA_LABEL | 模型名 | ARENA 模型在页面里的显示名。 | | --arena-wire | ARENA_WIRE | chat | ARENA provider 类型。chat 走现有 Kimi/OpenAI-compatible provider，anthropic 走现有 Anthropic provider。 | | --max-completion-tokens | KIMI_MODEL_MAX_COMPLETION_TOKENS | 复用 agent-core 动态预算逻辑，未知模型 fallback 到 32000 | 手动限制输出 token 上限。遇到上游 429 时可以先压低这个值。 | | --gateway | ARENA_GATEWAY | 空 | ARENA 上游网关地址。使用 ARENA 模型时必须传入。 | | --kimi-base-url | KIMI_CODE_BASE_URL | 空 | Kimi for Coding API 地址。 | | --kimi-oauth-host | KIMI_CODE_OAUTH_HOST | 空 | Kimi OAuth 登录地址。 | | --port | PORT | 8789 | 本地服务起始端口。若端口被占用，会自动尝试后续端口。 | | --model | HTML_PANEL_MODEL | kimi-code/kimi-for-coding | 默认选中的模型。若传入的不是 kimi-code/kimi-for-coding，且没有显式传 --arena-model，会自动把它作为 ARENA 模型加入下拉框。 | | --sessions-dir | HTML_PANEL_SESSIONS_DIR | ~/.kimi-code/sessions-html | 本地会话目录。 | | --login-kimi | - | - | 执行 Kimi OAuth 设备码登录，供 kimi-code/kimi-for-coding 使用。 |

包里不内置任何外部上游域名。需要访问外部服务时，请通过启动参数或对应环境变量传入。

页面只显示模型选择，不显示 API Key。

常用例子：

kimi-stage
kimi-stage --kimi-base-url "$KIMI_CODE_BASE_URL" --kimi-oauth-host "$KIMI_CODE_OAUTH_HOST"
kimi-stage --gateway "$ARENA_GATEWAY" --key "$ARENA_KEY" --arena-model kimi-k2.6-300 --model kimi-k2.6-300
kimi-stage --gateway "$ARENA_GATEWAY" --key "$ARENA_KEY" --arena-model kimi-k2.6-300 --model kimi-k2.6-300 --max-completion-tokens 64000
kimi-stage --gateway "$ARENA_GATEWAY" --key "$ARENA_KEY" --model kimi-k2.6-300
kimi-stage --gateway "$ARENA_GATEWAY" --key "$ARENA_KEY" --arena-model claude-opus-4-7 --arena-wire anthropic --model claude-opus-4-7

发布

pnpm publish:stage

这条命令会自动执行 patch 版本号递增、语法检查、npm pack --dry-run 和 npm publish。