Skip to content

Getting Started.zh CN

Jump to bottom
phinn edited this page Jul 12, 2026 · 1 revision

🌐 Language: English | 中文

Getting Started

从零到第一个任务跑通。

装依赖

需要 Node.js 18+ + 联网(better-sqlite3 原生模块要编译)。

cd KinetAiosWin
npm install      # postinstall 重建 better-sqlite3 给 Electron 用
npm run build
npm start

CN 网络提示:npm install 拉 Electron 二进制可能超时。.npmrc 已经配好 npmmirror;真挂了可以手动跑:

ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ node node_modules/electron/install.js

详见 Development。

配 API

第一次启动 → 右上角 ⚙ → API 区:

字段 说明
Provider OpenAI 兼容 / Anthropic 二选一(决定请求协议)
Base URL 默认 GLM 智谱;内置 preset 按钮:GLM / DeepSeek / OpenAI / Anthropic
Model 例 glm-4.6,claude-sonnet-4-6,gpt-4o
API Key 存在 userData 的 settings.json,通过 safeStorage 加密(macOS Keychain / Windows DPAPI)

填完点 测试连接。通过 = 能用了。

API key 存储详见 Settings;协议差异详见 Engines。

发第一条任务

主窗口底部输入框:

帮我看下当前目录结构,列出所有 .md 文件并告诉我每个的开头一句话

回车 = 发送;Shift+Enter = 换行;拖文件到输入框 = 加附件。

模型会:

  1. 调 glob 找 .md 文件
  2. 调 read_file 读开头
  3. 流式回答

每个工具调用在聊天框里折叠显示(▸ shell、▸ read_file…),点开看完整结果。下面有 token 实时计数。

选工作目录(cwd)

会话头部第二行 工作目录 输入框:

  • 直接输路径 + 回车
  • 或点 📁 选目录

agent 的所有 shell / read_file / write_file 都以此为根。换会话时 cwd 跟着切;每个会话独立 cwd。

切引擎

会话头部 引擎 下拉:

  • Kaios (Direct) —— 内置 ReAct loop,默认。
  • Claude Code —— 本机装了 claude CLI 才能开。
  • Codex —— 本机装了 codex CLI 才能开。

切换清空跨引擎上下文(三套引擎历史格式不互通)。详见 Engines。

试全局热键

任意应用前台时按 Ctrl/Cmd+Alt+Space → 弹出快速面板:

  • 输入任务 → Enter → 后台跑一个临时会话
  • 完成后通知 + 显示结果

主窗口关掉时快速面板不工作(关窗 = 退应用)。详见 Global-Hotkey。

接下来

Clone this wiki locally