#部署与首次配置

#准备环境

你可以在下载与部署获取 Windows 64 位可执行程序，或准备匹配目标服务器架构的 Linux / macOS 可执行文件。把程序放在有读写权限的目录即可直接运行，不需要安装 Go、Maven 或 Docker。

企智盒已将内置技能所需的 JAR 包、平台原生库和离线模型编译在单个可执行文件中；当任务需要调用以下工具时，宿主机需具备相应的基础软件：

程序启动后，管理员可随时在“管理 → 运行环境”页面查看各项依赖的自动探测结果，或手动指定安装路径。

#启动程序

在 Windows PowerShell 中启动（以 qizhihe.exe 为例）：

.\qizhihe.exe

在 Linux 或 macOS 终端中启动：

chmod +x ./qizhihe
./qizhihe

启动后默认监听 8080 端口：

• 本机访问：打开 http://127.0.0.1:8080
• 团队局域网访问：同一内网成员打开 http://部署机器IP:8080（请确认系统防火墙已放行该端口）

企智盒以前台进程方式运行，不自动篡改系统服务或注册开机自启。关闭浏览器不会影响后台任务；关闭企智盒进程则会停止服务，当时尚未跑完的任务在下次启动时会标记为“已中断”。

#数据目录与监听地址

默认情况下，程序会在可执行文件同级自动创建 data/ 目录，用来存放 SQLite 数据库、用户与部门文件、会话记录、助手内容以及按版本释放的内置运行时资源。

你可以通过命令行参数指定数据目录或监听地址：

# 指定独立的数据目录
./qizhihe --data-dir /path/to/qizhihe-data

# 仅允许本机回环地址访问
./qizhihe --listen 127.0.0.1:8080

Windows 下用法完全相同：

.\qizhihe.exe --data-dir D:/qizhihe-data --listen :8080

#首次登录

使用全新数据目录首次启动时，系统会自动初始化默认部门与管理员账号：

登录后请先点击左下角账户菜单修改管理员密码，再进入“管理”后台配置模型和团队账号。

#添加模型

企智盒不捆绑特定的大模型供应商。进入“管理 → 模型”点击添加，填写：

• 显示名称（如 DeepSeek-V3 或 内网 Qwen3）
• 完整 Chat Completions 地址（如 https://.../v1/chat/completions）
• 接口模型名、API Key 与最大上下文长度
• 若该模型支持视觉输入，勾选开启图片输入能力

所接入的模型需支持 OpenAI 兼容的流式输出（Streaming）、工具调用（Tool Calling）与结构化摘要。添加的第一个模型会自动设为全局默认模型。

#创建用户与第一项任务

1. 管理员在“部门”和“用户”页面建立部门并添加团队成员账号。
2. 成员使用浏览器登录，即可看到系统自动创建的默认助手（也可自行新建多个助手）。
3. 上传一份手头的表格或文档，发消息交代处理要求。
4. 在会话中实时查看工具调用过程与生成的交付文件。操作演示见完成第一个任务与操作示例。

#更新与迁移

升级版本时无需改动数据目录，按以下顺序操作即可：

1. 先到“管理 → 备份与审计”导出全量备份，并阅读目标版本的更新日志。
2. 停止正在运行的旧版企智盒进程。
3. 用新版本可执行文件替换旧文件，保持原 data/ 目录不动，重新启动程序并刷新浏览器。

启动时程序会自动执行数据库升级脚本（Migration）并释放当前版本的内置运行时资源，用户原有的文件、会话和自定义技能均完整保留。

跨机器迁移实例时，请使用后台的全量备份导出与恢复功能，不要在程序运行期间直接用系统命令拷贝 SQLite 数据库文件。当前企智盒为全新架构实现，不兼容旧版 Hermes 企智盒的数据目录或备份包。

#访问边界

局域网默认使用 HTTP 通信，请结合企业内网安全规范控制端口访问范围。在宿主机权限上，助手的 Bash 与浏览器工具直接使用企智盒进程所属系统账号的权限运行，不设操作系统级沙箱；工具人工审批用于防止误操作，不代替宿主机权限隔离。