配置

海慧智擎的配置极简：面向你的可改项只有两个——API Key 和 模型。其余项均已为你出厂预置、开箱即用，由企业统一管理，无需操心。

本页讲清四件事：配置文件在哪、怎么填 API Key、怎么选模型，以及升级时你的配置会怎样被对待。

配置文件在哪

配置位于：

~/.hi/settings.json

首次启动时自动生成。文件里你真正需要关心的，只有 env.HI_ENGINE_API_KEY（API 密钥）和 model（当前模型）两项。

不用手改文件

日常用命令就够了：/setup 填 API Key、/model 切模型。手动编辑 settings.json 只是备选方式，适合批量预置或排查问题时使用。

一份刚生成的 settings.json 大致长这样（注释为自动写入，方便你看懂每一项）：

{
  // hi-engine 配置文件 · 首次启动自动生成
  // 必填字段请用 /setup 命令交互填写，或直接编辑此文件
  "env": {
    // 必填：API 密钥（用 /setup 填写）。
    "HI_ENGINE_API_KEY": ""
  },
  // 默认 model（在 availableModels 中选一个，可用 /model 切换）
  "model": "deepseek-v4-pro",
  // /model 菜单展示的 model 列表（出厂标准，以 /model 菜单实际列出的为准）
  "availableModels": [
    "qwen36-35A3B",
    "deepseek-v4-pro",
    "qwen37plus"
  ],
  // 每个 model 的上下文长度
  "modelContextLength": {
    "deepseek-v4-pro": "1m",
    "deepseek-v4-flash": "1m",
    "qwen36-35A3B": "256k",
    "qwen37plus": "1m"
  },
  // 默认权限模式：bypassPermissions（出厂默认，省去工具调用确认弹窗）
  // 其他选项：default / acceptEdits / plan
  "permissions": {
    "defaultMode": "bypassPermissions"
  }
}

填 API Key（/setup）

第一次使用前，在交互界面运行：

/setup

向导只问一个问题——输入你的 API Key，回车保存即可，其余项全部自动预置。

输入 API Key（仅此一步）
默认模型 deepseek-v4-pro，之后可用 /model 切换。
> ********

API Key 哪里来

API Key 由贵司管理员或服务提供方下发。把它当密码保管，不要外发、不要提交进代码仓库。

保存后界面会提示配置已写入 ~/.hi/settings.json，并请你重启一次以生效。需要更换 Key 时，随时重跑 /setup 覆盖即可。

没填 Key 会怎样

HI_ENGINE_API_KEY 为空时，模型调用会返回鉴权失败（401）。如果启动后报鉴权错误，先确认这一项是否已正确填写。

选模型（/model）

模型是你能改的第二项配置。日常直接用 /model 切换，无需手动编辑文件：

打开菜单选

/model

直接切到指定模型

/model qwen36-35A3B

只看当前用哪个

/model status

出厂标准清单如下，以 /model 菜单实际列出的为准（可用模型由服务方统一配置，可能与下表略有出入）：

模型	单次上下文	定位
deepseek-v4-pro	约 100 万 token	默认主力，能力最全，适合绝大多数任务
qwen37plus	约 100 万 token	大上下文备选，适合长材料处理
qwen36-35A3B	256K token	响应轻快，适合中短材料的快速处理

切换即时生效，下次启动沿用你上次选的模型，不会被重置。模型的取舍与场景建议，详见模型。

上下文长度

settings.json 里的 modelContextLength 标的是每个模型单次能看到的内容容量上限——本次会话的对话内容，以及你引用进来的文件与图片，合在一起计算。

• 1m（约 100 万 token）：足以一次通读上百页的合同、台账或标书，无需拆分；
• 256k：适合中短篇材料——几十页文档、单份合同、一沓报销单。

这些数值出厂已配好、随版本对齐，你无需手动维护。想深入了解上下文如何累积、如何用 /clear、/compact 给它瘦身，见上下文与引用。

哪些配置你不用管

为了开箱即用、并守住"数据不出域"的保证，下面这些都已为你出厂预置、由企业统一管理，无需在 settings.json 里配置：

项目	状态
模型调用通道	经企业自有通道统一接入，已预置
联网搜索	内置企业搜索服务，已预置
本机 OCR	扫描件 / 图片识别在本机完成，无需配置
自动更新	静默后台更新，已预置
权限默认模式	出厂默认「跳过权限确认」，省去工具调用弹窗

为什么不用配这些

这些项一旦配错，会直接影响数据安全与"数据不出域"。因此由服务方统一预置、统一管理，既保证人人一套标准，也避免误配带来风险。

升级时，你的配置怎么办

升级到新版本后第一次启动时，海慧智擎会把配置自动对齐到最新的出厂标准——服务方调整了可用模型清单，所有客户更新后自动同步，你不用手动改任何东西。

这次自动对齐会：

• ✅ 保留你的 API Key——HI_ENGINE_API_KEY 原样不动；
• ✅ 保留你已选的模型——不会把你切回默认；
• 🔄 更新模型清单与上下文长度到出厂最新值。

因此，若某次更新后 /model 菜单里的模型有了变化，是正常的，以菜单实际列出的为准即可。

接下来

• 还没填 Key？看快速上手，三分钟跑通第一个任务。
• 想搞清各模型的取舍与场景？看模型。
• 配置或鉴权出问题？看常见问题。