kimi-html-test

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

本仓库开发

pnpm dev:html-test

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

npm 体验

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

npx kimi-html-test
pnpm dlx kimi-html-test

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

npm install -g kimi-html-test
kimi-html-test

Kimi for Coding

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

kimi-html-test --kimi-base-url "$KIMI_CODE_BASE_URL" --kimi-oauth-host "$KIMI_CODE_OAUTH_HOST"
kimi-html-test --login-kimi --kimi-oauth-host "$KIMI_CODE_OAUTH_HOST"

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

启动参数

kimi-html-test --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 模型时必须传入。可以传网关根地址，也可以传 provider 风格的 /v1 base URL，服务端会避免重复拼接 /v1。 | | --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 使用。 |

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

页面只显示模型选择和 Thinking 开关，不显示 API Key。ARENA/stage 模型默认 Thinking=off，优先缩短 HTML 首屏等待；需要更强推理时可以在页面右上角切到 high，下一轮生效。

内容区宿主已经内置 Tailwind-like utility classes 和短组件预设类，例如 kc-card、kc-btn-primary、kc-table。模型提示词会优先使用这些类，减少重复输出整段 CSS。

常用例子：

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

发布

pnpm publish:html-test

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