跳转到主内容
← 文档总览快速开始

快速开始

5 个步骤把千手 AI 智能工作台部署到企业终端:试用申请、客户端安装、服务端连接、数据源配置、首次 AI 调用。单台终端从安装到首次 AI 调用通常在 30 分钟内完成。

个人免费使用

下载安装后即可使用,无需账号、无需企业服务端。首次 AI 任务前在「设置 → 模型」填入你自己的模型 API Key(BYOK)——任何 OpenAI 兼容供应商均可(DeepSeek、Kimi、智谱、通义等),费用按你与模型供应商的计费直接结算,轻量使用通常每月几元到几十元。文件、邮件、检索等本地能力完全免费离线可用;之后随时可接入企业服务端。

适合:个人知识工作者、先试后买的团队成员

企业部署接入

需要组织统一管控模型、成员与审计时,走企业服务端路径:在 /trial 申请团队服务或私有化评估,拿到服务端域名与账号后按下方 5 步接入。

适合:政企组织、需要集中治理与合规审计的团队

环境准备

操作系统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 步部署流程

01试用申请提交企业信息STEP 0102客户端安装macOS / Win / LinuxSTEP 0203服务端连接JWT 双令牌STEP 0304文件 · 邮箱chokidar + IMAP/OAuthSTEP 0405首个 AI 调用SSE 流式输出STEP 05约 30 分钟 · 高风险操作触发人工确认 · 全流程审计
01

下载本地版或获取服务账号

本地桌面版可直接安装使用;需要团队/企业服务时,在 /trial 提交企业信息,团队在 1-2 个工作日内联系并确认服务端域名与登录凭据。已经是部署客户的企业用户,请联系本企业的 IT 管理员通过 qianshou-portal.octoooo.com/admin(或私有部署地址)创建账号。

02

下载并安装客户端

前往下载页获取当前系统的安装包:

  • macOS:dmg 安装包,拖入 Applications 即完成安装
  • Windows:exe 安装器,双击按引导安装
  • Linux:AppImage / deb 即将开放

客户端基于 Electron 自带 Chromium,不依赖各 Linux 发行版的系统 WebView(统信 UOS / 麒麟 KylinOS 适配验证中)。

03

连接企业服务端

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

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

04

配置文件夹与邮箱

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

本地文件夹

设置 → 文件管理 中点击「添加监控目录」选择本机文件夹。客户端使用 chokidar 实时监听变更,PDF、DOCX、XLSX、Markdown 等文档进入索引队列,最终建立 SQLite FTS5 全文索引。索引仅在客户端本地,不上传服务端。

邮箱账户

设置 → 邮箱 添加 IMAP/SMTP 账户,或使用 OAuth 接入 Gmail(Google)与 Outlook(Microsoft Modern Auth)。同步策略可按账户独立配置,IMAP 邮件存入本地加密 SQLite,附件解析后参与全文检索。

05

执行第一个 AI 任务

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

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

部署验证清单

完成 5 步后,按下面列表逐项核对。任意一项不通过即说明对应阶段未完成。

客户端右下角连接状态显示「已连接」且无 token 过期警告
设置 → 文件管理 中至少看到 1 个监控目录,索引进度条到 100%
设置 → 邮箱 中至少看到 1 个账户,最近一次同步在 5 分钟内
在 AI 工作区可下拉选择至少 1 个智能体,发送测试请求后 5 秒内开始流式输出
设置 → 审计 看到刚才的 AI 调用记录,包含完整 prompt 与 response

常见问题排查

首次连接服务端失败

检查服务端域名前缀是否为 https://、防火墙是否放行、客户端机器系统时间是否正确(JWT 校验严格依赖时间)。私有部署常见原因是企业自签 CA 未导入到客户端信任链。

本地文件索引卡在 0%

在 设置 → 文件管理 查看索引任务队列状态。常见原因:监控目录被系统索引服务(Spotlight、Windows Search)占用文件锁。临时方案是先在 macOS 系统设置中将该目录加入 Spotlight 排除列表。

邮箱 OAuth 授权后仍提示未连接

检查 OAuth 回调地址是否在企业 IdP 白名单中。Microsoft Modern Auth 需要管理员同意(admin consent)。

客户端在 Windows 上启动后白屏

优先重新下载与系统架构(x64 / arm64)匹配的安装包并重装;若仍无法启动,请联系技术支持并附启动日志,常见原因是本机缺少运行库或安装包架构不匹配。