跳到主要内容

安装 KnoxCoder

从 GitHub Releases 下载 桌面构建。Knox Agent 已在应用内。不要再装 VSIX,也不要在 Open VSX 里搜 Knox。

当前系列: 2.2.x · 最新发布 · 同一页上的 SHA256SUMS。

选和操作系统、CPU 匹配的资源。文件名形如 KnoxCoder-<version>-<platform>-<arch>…。

Apple Silicon(arm64)和 Intel(x64)是两套构建。

资源用途
KnoxCoder-darwin-arm64.dmg 或 KnoxCoder-<version>-darwin-arm64.zipApple Silicon
KnoxCoder-darwin-x64.dmg 或 KnoxCoder-<version>-darwin-x64.zipIntel

DMG(推荐)。 打开镜像,把 KnoxCoder 拖进「应用程序」。macOS 构建已签名、公证并 staple。Gatekeeper 应能直接打开。

ZIP。 解压后把 KnoxCoder.app 放到「应用程序」。如果系统提示来自身份不明的开发者,改下 DMG。

在 帮助 → 关于 确认显示 KnoxCoder 且产品版本为 2.2.x。

校验下载​

每个 GitHub Release 都附带 SHA256SUMS。核对你下的文件:

# macOS / Linux
shasum -a 256 KnoxCoder-*
# 对照 SHA256SUMS 里的那一行

# Windows(PowerShell)
Get-FileHash .\KnoxCoder-*-setup.exe -Algorithm SHA256

自动更新用同一套哈希:应用从 https://github.com/knoxchat/knoxcoder/releases/latest/download/ 拉取 latest-<platform>-<arch>.json,Windows 应用更新前检查 sha256hash。

第一次启动​

  1. 打开 KnoxCoder。Knox 已在活动栏(Knox 图标)。不用开预览开关。
  2. 不要 从任何市场安装 knoxchat.knoxchat。若有残留副本,KnoxCoder 会禁用它;内置 vscode.knox 优先。
  3. 打开文件夹(见 打开文件夹)。没有文件夹时,对话无处安全地改文件。
  4. 登录或添加模型(登录与模型),然后发消息(第一次对话)。

第一次使用时会在 ~/.knoxcoder 创建全局状态(Windows 上是 C:\Users\<you>\.knoxcoder)。

自动更新​

打包构建会轮询 GitHub Releases(不需要 API token):

https://github.com/knoxchat/knoxcoder/releases/latest/download/latest-<platform>-<arch>[-<target>].json

JSON 里的 productVersion 和 帮助 → 关于 比较。Download Update 下载该 JSON 里的包地址,而不是通用的 releases HTML 页。

需要钉死某个版本时,在编辑器里关掉更新。除编辑器自带的更新服务外,没有另一套 Knox 更新器。

这次安装不会给你的东西​

  • Remote SSH / WSL / 开发容器 — 2.2 里 Knox 宿主不在远程文件系统上跑。请在本机编辑。
  • Web — gulp vscode-web 会跳过 Knox;激活时拒绝 UIKind.Web。
  • 无界面 CLI — 2.2 没有 knox run。
  • 从源码构建 — 用户不需要。贡献者看仓库 README。

接下来​

登录或添加模型,然后 发第一条消息。