MoonshotAI / MoonshotAI/kimi-code
[Windows] kimi web 实例/端口管理混乱 + Zed ACP 文档误导:Windows 用户体验极差
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 碰运气。
建议
- 为 Windows 提供一键启停/查看 web 服务的可见入口(托盘图标或
kimi web --stop/kimi web --status之类)。 - 实例死亡后自动清理 instances 登记;web UI 连不上时明确提示服务已死及正确端口。
- 文档标注 IDE 集成在各平台的实际可用状态。
Windows 用户也是用户,希望官方正视。
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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