kooyu本地工作台可通过npm启动host,再在浏览器首次引导中配置自己的模型服务。windows、macos和linux需要node.js 24.13.0或更新版本;模型提供商及第三方编程cli需要各自的账号或安装。下面先完成本地监听与模型绑定,不把工作台直接开放到公网。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Kooyu官方npm安装、端口与数据目录说明
启动本机Host
先检查Node和npm,再按官方npm文档启动。保持终端运行,打开终端实际打印的本地地址,默认是http://127.0.0.1:4310;Ctrl+C用于停止。安装会从npm获取软件,请核对包名为kooyu及项目来源。
node --version npm --version npx kooyu@latest
需要长期使用时可选择全局安装,两种方式任选一种,不要同时启动同一数据目录的多个Host。
npm install -g kooyu kooyu --version kooyu
配置Provider、模型与Harness绑定
首次引导中配置模型;需要调整时,进入“Harness与配置—Provider与模型”。先添加Provider,选择该服务真实支持的接口格式、服务地址和凭据;再获取模型列表,检查实际账号列出的模型ID。不要把接口Base URL、模型列表URL、上下文窗口和网络端口混填。
从模型库补齐上下文、输出和思考参数后,按提供商文档核对,必要时手工覆盖。最后把选择的模型和思考档位应用到指定Harness,在新对话的模型配置中检查绑定结果。接口列出模型不证明推理端点已经可用,也不证明账号有余额;先发一条简短测试请求,查看真实成功结果和提供商用量。

Kooyu官方深色工作台界面
处理端口与数据目录冲突
桌面版和npm版可能使用同一Host数据目录,官方要求一个目录同时只由一个Host持有。已有桌面Host运行时先停止它;若确实需要独立实例,可同时更换端口和数据目录。
kooyu start --port 4320 --data-dir ./kooyu-data
默认数据目录分别位于Windows的%LOCALAPPDATA%/Kooyu/host、macOS的~/Library/Application Support/Kooyu/host,以及Linux的XDG数据目录。更换数据目录不会自动迁移已有会话,更新或卸载npm包也不会自动删除这些数据。
按已安装版本验证并升级
检查Host地址可打开、当前模型绑定正确、首次模型请求真实成功,再逐项启用其他工具能力。托管浏览器额外需要文档指定的Chromium安装;没有这项需求时不必为了启动普通工作台增加该组件。
npx playwright@1.56.1 install chromium
升级全局npm版前停止Kooyu,再执行npm install -g kooyu@latest后重新启动。npm更新不会替你安装桌面EXE或DMG。需要远程访问时应另按官方部署文档配置HTTPS、配对和访问控制,不能只把监听地址改为0.0.0.0就当作安全部署。











