MoonshotAI / MoonshotAI/kimi-code

[Windows] kimi web 实例/端口管理混乱 + Zed ACP 文档误导:Windows 用户体验极差

Open
#2,732 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
7.5k
Forks
1.2k
Avg merge
11h 53m
Merged PRs (30d)
350

Description

我是一名 Windows 用户,今天的使用体验非常糟糕,集中反馈几个问题。这不是挑刺,是真实踩了一天的坑。

环境

  • kimi 0.34.0(Windows 原生安装)
  • Windows 11

问题 1:文档推荐 Zed,但 Windows 下基本不可用

按官方文档配置 Zed 的 ACP(agent_servers + kimi acp)后完全无响应。我自己验证过 kimi acp 本身能正常应答 initialize,问题出在 Zed 对 Windows 的支持上。文档把 Zed 列为推荐方案,却没有标注其在 Windows 下的实际可用状态,用户白白折腾。请文档明确标注各 IDE 方案在 Windows 下的可用性。

问题 2:kimi web 实例/端口管理混乱

  • 默认端口被占就静默 +1(58627 → 58628 → …),每次启动端口都不一样,用户根本不知道该连哪个。
  • 实例死亡后,~/.kimi-code/server/instances/ 下的登记文件不会自动清理,残留成僵尸登记。
  • 浏览器连上已死实例的端口后,页面报 "WebSocket error",所有操作(包括删除会话)无响应,没有任何提示告诉用户这个服务已经死了,请换端口。

问题 3:后台服务没有可见的管理入口

web 服务若由后台方式启动,没有终端窗口,Windows 桌面上找不到任何可以查看/停止它的入口——没有托盘图标、没有管理界面。普通用户想停掉服务只能去任务管理器里找 kimi.exe 碰运气。

建议

  1. 为 Windows 提供一键启停/查看 web 服务的可见入口(托盘图标或 kimi web --stop / kimi web --status 之类)。
  2. 实例死亡后自动清理 instances 登记;web UI 连不上时明确提示服务已死及正确端口。
  3. 文档标注 IDE 集成在各平台的实际可用状态。

Windows 用户也是用户,希望官方正视。

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the Windows behavior with kimi web, kimi acp, and the ~/.kimi-code/server/instances/ directory, including a port conflict and a dead instance. Verify the documented Zed ACP setup and the WebSocket failure path. Done should include an agreed approach for visible service management, stale-instance handling, clear connection errors, and accurate Windows IDE documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
cli, devtools, documentation, operating-systems
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.