在 /trial 提交企业信息，团队在 1 个工作日内创建账号并发送企业服务端域名与登录凭据。已经是部署客户的企业用户，请联系本企业的 IT 管理员通过 qianshou-portal.octoooo.com/admin（或私有部署地址）创建账号。

根据操作系统选择安装包：

• macOS：qianshou-mac-arm64.dmg（Apple Silicon）或 qianshou-mac-x64.dmg（Intel）
• Windows：NSIS 安装器或 portable 版（无需管理员权限）
• Linux：AppImage（开箱即用）或 deb（apt 安装）

客户端基于 Electron 39 自带 Chromium，规避了国产 Linux 发行版（KylinOS、UOS）原生 WebView 兼容问题。安装包大小约 200 MB。

首次启动时，客户端会展示连接配置面板。填入企业服务端域名（例如 https://qianshou-api.octoooo.com，私有部署填本企业地址），输入账号密码后客户端通过 HTTPS 完成 JWT 认证。

认证成功后，客户端自动从 /api/models/sync 与 /api/agents/sync 拉取组织模型与智能体清单。后续运行期间使用 access + refresh 双令牌机制，token 自动续期，无需重复登录。

两类核心数据源在初始化阶段配置：

在主界面 AI 工作区选择一个内置智能体（如「文档摘要」「邮件草拟」「合规检查」），将文件拖入或在输入框附加。提交后客户端按智能体配置选择引擎类型 —— DirectEngine 直连用户模型，ProxyEngine 走 /api/ai/execute 服务端代理，AgenticRAGEngine 触发多轮文档检索。

AI 输出通过 SSE 流式返回，前端实时渲染。如果智能体涉及高风险操作（发送邮件、执行 Bash 命令、修改文件），会触发人工确认对话框 —— 用户审阅参数后才会执行；所有调用、确认结果、最终输出都进入审计日志。