AI 桌面客户端，基于 Electron + React + SQLite。当前为 Beta / 开源 RC（0.5.0-rc.9），秉承本地优先、去中心化、安全至上的理念，支持多模态智能体、知识库、笔记、翻译、P2P 群组、社区 Hub、助手库AI学习系统、项目管理 与会员体系。后期将聚焦于垂直领域的AI办公场景，打造项目管理、标书编制等模块。
- 智能体：分为4种模式，普通模式、计划模式、自动编辑模式、全自动模式，能处理各种类型的任务。详见程序内说明。
- 知识库：分为本地知识库，网络知识库，本地文件（无向量化处理），本地文件工具。
- 笔记：常规笔记工具，但增加了锁定功能。
- 翻译：常规翻译及对照翻译功能，实现PDF与Markdown面到面的对照翻译。
- 群组：P2P群组功能，去中心化，实现点到点连接，分为群组智能体，群组知识库，群组笔记，群组工作流等。加入群组的用户，可以调用分享到群组的智能体，手机端也可以使用桌面端的智能体。
- 社区：同样是去中心化的社区，分为资讯，留言，知识库市场，MCP市场，Skills市场，工作流市场，任务市场，我的，是一个综合性的社区。
- 助手库：苏格拉底问答式AI学习系统，支持PDF等教材知识库创建。
- 项目管理：针对工程项目管理场景，专门打造的AI智能办公平台。
- 跨网 P2P 群组：LAN 已验证；跨 NAT 需 TURN，仍在持续验收中
- 自动更新：需配置 OTA feed；亦可通过 GitHub Release 下载安装包
- 会员支付：当前为模拟支付，非真实扣款
- 工作流 / 自动化：导航占位，群组可共享 workflow 但本地编辑器尚未开放
- 代码签名：开源 RC 使用 adhoc 签名；macOS 需右键打开，Windows 可能触发 SmartScreen
- Node.js ≥ 20
- pnpm 9.x（见
package.json→packageManager） - macOS / Windows / Linux
- 可选：Ollama（本地模型）
- P2P 原生模块：首次
dev会自动执行build:p2p（Rust）
pnpm install
pnpm build
pnpm --filter @toolman/desktop dev常用命令：
| 命令 | 说明 |
|---|---|
pnpm dev |
Turbo 并行 watch |
pnpm build |
构建所有包 |
pnpm typecheck / pnpm test |
类型检查 / 单元测试 |
pnpm rc1:preflight |
RC 发布前自动化门禁 |
pnpm --filter @toolman/desktop dev:p2p:a / dev:p2p:b |
双实例 P2P 联调 |
pnpm db:generate / pnpm db:migrate |
Drizzle migration |
| 主题 | 路径 |
|---|---|
| P2P 架构与联调 | docs/p2p/ |
| 社区 Hub | docs/community/ |
| 账户与认证 | docs/auth/ |
| RC1 内测 | docs/engineering/RC1_DOGFOOD.md |
| OpenDataLoader PDF | docs/engineering/OPENDATALOADER_PDF.md |
| 发布与 OTA | docs/engineering/ |
workspace 包找不到 — 先构建依赖：
pnpm --filter @toolman/desktop^... buildbetter-sqlite3 版本不匹配 — 重新安装或 rebuild：
pnpm install
# 或
pnpm --filter @toolman/desktop exec electron-rebuild -f -w better-sqlite3Electron 无法启动 — 取消 ELECTRON_RUN_AS_NODE 后再 dev：
unset ELECTRON_RUN_AS_NODE
pnpm --filter @toolman/desktop dev无法对话 — 确认已选会话、Ollama 运行中（ollama list），并查看界面错误提示。
P2P 群组 — 设置 → 系统诊断；双实例见 docs/p2p/DUAL_INSTANCE_DEV.md。
Electron 36 · React 19 · better-sqlite3 · Drizzle · Zod · pnpm workspace · Turbo · Rust（P2P 原生模块）
Copyright © 2024–2026 Toolman Contributors