# 千手 AI 智能工作台 (OctoDesk)

> 本地优先的 AI 原生桌面工作台。本地版永久免费；团队/企业服务提供托管中继、服务端同步、组织治理与私有化部署。
> Local-first AI-native desktop workbench. Local edition is permanently free; team/enterprise services add managed relay, server sync, governance, and private deployment.

## 文档 / Documentation

- [技术总览 Technical Overview](/docs)：架构、功能、技术栈
- [快速开始 Getting Started](/docs/getting-started)：本地安装与可选的团队/企业服务接入
- [系统架构 System Architecture](/docs/architecture)：多引擎 AI、客户端-服务端模型、IPC 安全、服务清单
- [集成生态 Integrations](/docs/integrations)：MCP、OAuth、本地幻灯片、远程调研交接、Web 研究工具
- [安全与合规 Security & Compliance](/docs/security)：加密、凭据管理、IPC 信任模型、审计链
- [网络行为清单 Network Behavior](/docs/network-behavior)：客户端会发生与永不发生的网络请求逐条清单
- [千手 vs AnythingLLM](/compare/anythingllm)：与本地 RAG 知识库应用的逐项对照（附出处）
- [千手 vs Cherry Studio](/compare/cherry-studio)：与多模型桌面客户端的逐项对照（附出处）
- [支持 Support](/support)：技术支持与服务响应说明
- [浏览器扩展 Browser Extension](/extension)：OctoDesk 随手记扩展，网页内容一键存入本机千手
- [隐私选择 Privacy Choices](/privacy/choices)：AI 数据共享许可与本机数据管理

## 核心能力（中文）

- 多引擎 AI：DirectEngine（用户自有模型，Key 存本地钥匙串）+ ProxyEngine（组织模型经服务端代理）+ AgenticRAGEngine（本地检索增强）+ 本地外部 Agent 桥接（BYOA，接入本机 Claude Code / Codex 等）
- 本地优先：SQLite + FTS5 全文检索，jieba-wasm 中文分词；本地版与 BYOK 工作流不经千手服务端
- 桌面远程：局域网与自带安全网络（Tailscale / WireGuard 等）配对免费；托管中继属团队/企业服务，且保持端到端加密
- 17 个内置智能体 + 自定义智能体（allowedTools 白名单精确控制可调用工具）
- MCP（Model Context Protocol）客户端：接入任意兼容 MCP 的工具与数据源，支持 OAuth 流
- 邮件：IMAP/SMTP + Google/Microsoft OAuth；本地出站队列自动重试；自动回复规则
- 本地幻灯片生成：智能体产出 SlideDeckSpec，本机导出 HTML / PDF / 渲染图 PPTX（页面为渲染图版式）
- 深度调研本地执行 + 远程 OctoReport 交接（本地不重建采集后台）
- 人工确认（Human-in-the-loop）：邮件发送、Bash、文件编辑、MCP 调用等高风险操作需确认
- 全链路审计：AI 调用、邮件发送、文件操作等关键类别完整记录 request/response，可导出 PDF/Excel
- 平台：macOS（仅 Apple 芯片）、Windows（x64）已开放公开下载；Linux 即将开放（Electron 39.x 自带 Chromium；统信 UOS / 麒麟 KylinOS 适配验证中）
- 商业口径：本地版永久免费、无需账号；团队/企业付费项为托管中继、服务端同步、组织治理、私有化与 SLA

## Key Features (English)

- Multi-engine AI: DirectEngine (user models, local Keychain) + ProxyEngine (org models via server proxy) + AgenticRAGEngine (local retrieval) + local external-agent bridge (BYOA)
- Local-first: SQLite + FTS5 full-text search with jieba-wasm Chinese tokenizer; local/BYOK workflows do not use OctoDesk servers
- Desktop remote: LAN and bring-your-own secure network pairing are free; managed relay is a team/enterprise service and remains end-to-end encrypted
- 17 built-in AI agents + custom agents with allowedTools whitelist (per-agent tool restrictions)
- MCP (Model Context Protocol) client: connect any MCP-compliant tool/data source with OAuth flow
- Email: IMAP/SMTP + Google/Microsoft Modern Auth (OAuth); local SMTP outbox queue with auto-retry; auto-responder rules
- Local slideDeck: agent supplies SlideDeckSpec; exports HTML, PDF, rendered-image PPTX on device
- Local deep research + remote OctoReport handoff (no local collector backend)
- Human-in-the-loop: high-risk ops (email send, bash, file edit, MCP tool calls) require confirmation
- Full audit trail: key operation categories with complete request/response logging, exportable to PDF/Excel
- Platforms: macOS (Apple silicon only) and Windows (x64) available for public download; Linux coming soon (Electron 39.x with bundled Chromium; KylinOS/UOS validation in progress)
- Operations: featureFlagService for gradual rollout, metricsService for runtime telemetry

## 移动应用 / Mobile Apps

- iOS：已上架 App Store — https://apps.apple.com/app/id6768164675
- Android：已上架 Google Play — https://play.google.com/store/apps/details?id=com.octoooo.desk
- 官网 APK 直链 Direct APK: https://files.octoooo.com/octodesk.apk
- 国内 Android 应用商店与华为 AppGallery（HarmonyOS）即将上架 / Domestic Android stores and HarmonyOS coming soon

## 技术栈 / Tech Stack

- 客户端 Client: Electron 39.x, React 18, in-house design-system (headless + Tailwind), SQLite FTS5, Vite 6, Zustand 5.0+ (SplitView + Activity routing for layout)
- 服务端 Server: Hono.js 4.x, Node.js ≥ 22 (official container on Node 26), PostgreSQL 16 + Prisma 5.x, Redis 7.x, JWT (access + refresh), AES-256
- 部署 Deployment: Docker Compose (server + postgres + redis); private deployment supported

## 架构面 / Architecture Surface

- 主进程 90+ 服务模块（Core / Integration / Infrastructure 三层）
- 渲染进程 11 个 ActivityId（src/app/viewRegistry.ts）：
  - 9 个默认可见：home、mail、calendar、chat（含深度调研与任务观测）、files、aisearch、knowledge、library、schedules
  - 1 个随功能开关灰度开放：work-steward（工作总管）
  - 1 个固底：settings
- Shell chrome（src/shell/*）：TitleBarV2、ActivityBar、StatusBar、NotificationCenter、CommandPalette、CustomizeMenu、DialogHost、ToastHost、UndoBridge——全部消费自研 design-system primitives
- design-system：23 个自研 headless 组件（14 primitives + 3 layout + 6 overlays），Tailwind 着色，无外部 UI 库
- 服务端 API 16+ 个 /api/* 面 + /health
- 550+ IPC handlers，assertTrustedSender 来源校验 + schema 验证

## 对比 / Comparisons

- [千手 vs AnythingLLM](/compare/anythingllm)：办公执行闭环工作台 vs 本地 RAG 知识库应用（附出处与检索日期）
- [千手 vs Cherry Studio](/compare/cherry-studio)：企业办公闭环工作台 vs 多模型桌面客户端（附出处与检索日期）

## 链接 / Links

- 官网 Website: https://qianshou.octoooo.com
- 下载 Download: https://qianshou.octoooo.com/download
- 定价 Pricing: https://qianshou.octoooo.com/pricing
- 团队/企业服务 Team/enterprise services: https://qianshou.octoooo.com/trial
- 客户门户 Customer portal: https://qianshou-portal.octoooo.com
- 联系 Contact: octoooo@octoooo.com