快速开始
5 个步骤把千手 AI 智能工作台部署到企业终端:试用申请、客户端安装、服务端连接、数据源配置、首次 AI 调用。单台终端从安装到首次 AI 调用通常在 30 分钟内完成。
环境准备
| 操作系统 | Windows 10/11、macOS 12+(Intel / Apple Silicon)、主流 Linux 发行版(Ubuntu、Debian;统信 UOS / 麒麟 KylinOS 适配验证中) |
| 内存 | 建议 ≥ 8 GB RAM;处理大量本地文档时建议 16 GB |
| 磁盘 | 安装占用以下载页实际安装包为准;本地索引按文件量增长,常见 1 GB ~ 10 GB |
| 网络 | 本地版可离线使用;团队/企业服务需访问企业服务端(HTTPS);可选:访问外部 AI 厂商(用于 DirectEngine 直连) |
| 账号 | 本地版无需账号;团队/企业服务账号由企业管理员通过管理后台创建,或通过服务申请获得 |
首次试用通常通过公网企业服务端 qianshou-api.octoooo.com。生产环境推荐私有化部署 — 把整套服务跑在企业内网的 Docker 集群中,参见 部署指南。
5 步部署流程
下载本地版或获取服务账号
本地桌面版可直接安装使用;需要团队/企业服务时,在 /trial 提交企业信息,团队在 1-2 个工作日内联系并确认服务端域名与登录凭据。已经是部署客户的企业用户,请联系本企业的 IT 管理员通过 qianshou-portal.octoooo.com/admin(或私有部署地址)创建账号。
下载并安装客户端
前往下载页获取当前系统的安装包:
- macOS:dmg 安装包,拖入 Applications 即完成安装
- Windows:exe 安装器,双击按引导安装
- Linux:AppImage / deb 即将开放
客户端基于 Electron 自带 Chromium,不依赖各 Linux 发行版的系统 WebView(统信 UOS / 麒麟 KylinOS 适配验证中)。
连接企业服务端
首次启动时,客户端会展示连接配置面板。填入企业服务端域名(例如 https://qianshou-api.octoooo.com,私有部署填本企业地址),输入账号密码后客户端通过 HTTPS 完成 JWT 认证。
认证成功后,客户端自动从 /api/models/sync 与 /api/agents/sync 拉取组织模型与智能体清单。后续运行期间使用 access + refresh 双令牌机制,token 自动续期,无需重复登录。
配置文件夹与邮箱
两类核心数据源在初始化阶段配置:
本地文件夹
在 设置 → 文件管理 中点击「添加监控目录」选择本机文件夹。客户端使用 chokidar 实时监听变更,PDF、DOCX、XLSX、Markdown 等文档进入索引队列,最终建立 SQLite FTS5 全文索引。索引仅在客户端本地,不上传服务端。
邮箱账户
在 设置 → 邮箱 添加 IMAP/SMTP 账户,或使用 OAuth 接入 Gmail(Google)与 Outlook(Microsoft Modern Auth)。同步策略可按账户独立配置,IMAP 邮件存入本地加密 SQLite,附件解析后参与全文检索。
执行第一个 AI 任务
在主界面 AI 工作区选择一个内置智能体(如「文档摘要」「邮件草拟」「合规检查」),将文件拖入或在输入框附加。提交后客户端按智能体配置选择引擎类型 —— DirectEngine 直连用户模型,ProxyEngine 走 /api/ai/execute 服务端代理,AgenticRAGEngine 触发多轮文档检索。
AI 输出通过 SSE 流式返回,前端实时渲染。如果智能体涉及高风险操作(发送邮件、执行 Bash 命令、修改文件),会触发人工确认对话框 —— 用户审阅参数后才会执行;所有调用、确认结果、最终输出都进入审计日志。
部署验证清单
完成 5 步后,按下面列表逐项核对。任意一项不通过即说明对应阶段未完成。
常见问题排查
首次连接服务端失败
检查服务端域名前缀是否为 https://、防火墙是否放行、客户端机器系统时间是否正确(JWT 校验严格依赖时间)。私有部署常见原因是企业自签 CA 未导入到客户端信任链。
本地文件索引卡在 0%
在 设置 → 文件管理 查看索引任务队列状态。常见原因:监控目录被系统索引服务(Spotlight、Windows Search)占用文件锁。临时方案是先在 macOS 系统设置中将该目录加入 Spotlight 排除列表。
邮箱 OAuth 授权后仍提示未连接
检查 OAuth 回调地址是否在企业 IdP 白名单中。Microsoft Modern Auth 需要管理员同意(admin consent)。
客户端在 Windows 上启动后白屏
优先重新下载与系统架构(x64 / arm64)匹配的安装包并重装;若仍无法启动,请联系技术支持并附启动日志,常见原因是本机缺少运行库或安装包架构不匹配。