← Back to home@picoaide

picoaide-harness

PicoAide Harness：企业级 DeepSeek Harness 一体化平台。桌面客户端 + 本地智能体引擎 + 管理后台，支持私有化部署。

Stars
14
Language
TypeScript
Created
Aug 16, 2026
Updated
Oct 6, 2026
Desktop
GitHub repoHomepage

Introduction

PicoAide Harness

企业级 DeepSeek Harness 一体化平台。
桌面客户端 + 本地智能体引擎 + 管理后台，开箱即用。
一切皆插件，桌面本身也是插件。

Latest release Total downloads GitHub stars MIT License

PicoAide Harness 官方交流群二维码
扫码加入 PicoAide Harness 官方交流群

PicoAide Harness 把 DeepSeek Harness 的本地智能体、Host 服务、插件系统与企业级管理能力装进一个平台：

  • 桌面客户端：原生窗口、系统托盘、自动更新，无需安装 Node.js 或执行命令；
  • 本地服务：自动启动、停止与恢复本地 Harness 服务，数据留在本机；
  • 管理后台：Web 化管理台，覆盖用户、部门、网关、用量、市场与能力中心（共享审批）、审计；
  • 插件生态：官方 DeepSeek Harness 以固定版本原样运行，桌面壳与业务插件通过官方机制组合。

界面预览

桌面客户端

主界面能力中心连接器中心
桌面主界面能力中心连接器中心
定时任务设置
定时任务设置

管理后台

用户管理能力中心网关配置
用户管理能力中心网关配置
用量统计审计日志服务器信息
用量统计审计日志服务器信息

下载与安装

客户端安装包随服务端镜像一起发布（不单独挂在下载站），支持 Windows x64、macOS（Apple Silicon）和 Linux x64（AppImage）。普通用户不需要单独安装 Node.js、pnpm 或 DSH。

平台安装包安装方式
Windows x64PicoAide-Harness-<版本>-x64-Setup.exe运行 NSIS 安装程序并按提示完成安装
macOS（Apple Silicon）PicoAide-Harness-<版本>-mac.dmg打开 DMG，将 PicoAide Harness 拖入 Applications
Linux x64PicoAide-Harness-<版本>-x86_64.AppImage授予执行权限后运行

拿到这些安装包只有两条路：

  1. 企业服务器（推荐）：管理员部署完成后，员工打开 https://<企业域名>/，门户页直接列出三平台下载入口；
  2. 官方镜像包（试用 / 单机）：从更新服务器或 GitHub Release 取服务端镜像包，再从镜像里解出安装包：
VER=<版本，取自 latest.json 的 server.version>      # 预发布渠道把 official 换成 beta
curl -fL -O "https://release.picoaide.com/official/releases/${VER}/picoaide-server-${VER}-amd64.zip"
curl -fL -O "https://release.picoaide.com/official/releases/${VER}/SHA256SUMS"
sha256sum -c SHA256SUMS                            # ← 用 SHA256SUMS 校验下载到的镜像包
unzip -p "picoaide-server-${VER}-amd64.zip" image.tar | docker load
mkdir -p ./picoaide-stack
docker run --rm -v "$PWD/picoaide-stack:/out" -e PICOAI_UNPACK_STACK=/out \
  "picoaide-harness-server:${VER}"
ls -1 ./picoaide-stack/client                       # 三平台安装包 + CLIENT-RELEASE.json

GitHub Release 的附件是服务端镜像包（picoaide-server-<版本>-amd64.zip）与校验文件 SHA256SUMS —— 客户端安装包在镜像里，不在 Release 附件里；校验文件名是 SHA256SUMS（没有 .txt）。

客户端升级与首次安装也可以直接问它登录的那台服务端要包（GET /api/client/v2/updates/manifest）——企业部署下员工机器因此不需要访问任何外网。首次启动会创建默认 desktop profile，并在本机启动官方 DSH Web 界面。完整步骤（含从镜像取包、离线部署与渠道交付）见官网快速开始、客户端分发与升级，插件命令与故障排查见桌面客户端与常见问题。

说明：Windows 安装程序与 Linux 安装包暂未签名（macOS 正式发布版经签名/公证）。首次运行 Windows 安装包时 SmartScreen 可能提示"未知发布者"—— 请先用镜像包同目录的 SHA256SUMS 校验镜像（安装包从中解出），Linux 安装包同理。

核心优势

企业级一体化

  • 桌面 + 服务 + 后台：客户端负责交互，本地服务负责智能体运行，管理后台负责账号、配额与审计，三层协同；
  • 多用户隔离：连接器凭据、浏览器会话、定时任务按账号隔离，退出登录即解除所有会话；
  • 用量与配额：按用户按模型计费、限额与豁免，高峰时段自动分级计价。

开箱即用的生产力工具

  • 能力中心：我的 / 市场两分区，技能与智能体类型筛选，来源（市场/组织/本地）与质量（官方/精选）徽章，多版本归并与历史，一键安装/更新/卸载；
  • 连接器中心：内置销售易（NeoCRM）等 MCP 连接器，OAuth 授权 + PKCE，凭据本地加密存储，动态注册 MCP；
  • 定时任务：cron 定时执行，指定智能体与提示词、工作区与权限，执行详情（会话/结果/错误）随时可查，支持会话跳转，由 Host 统一调度；
  • 内嵌浏览器：Agent 可接管浏览器执行操作，多标签、地址栏、权限审批与下载管控；
  • 语音输入：输入框麦克风把说话转成草稿文字，识别在本机跑（音频不出机器、离线可用），识别模型随客户端分发（装上即用、零下载；权重本身约 230MiB，安装包增幅视平台打包格式的压缩率而定，约 +140～250 MiB）；只有渠道包显式写 desktop.speech_bundle_model: false 时才回到首次使用下载；
  • 五轨记忆：用户档案、全局事实、项目关键记忆、项目日志与每日日志，按目录与 git 分支隔离，确认制写入。

安全与合规

  • 凭据以 0600/0700 权限原子写入，防符号链接、路径逃逸与超大读取；
  • OAuth state 校验与超时控制，登录/登出整页刷新切断旧会话；
  • 管理后台操作留痕，审计日志覆盖用户、部门、配额、网关、商店与共享审批操作；
  • 上游密钥 AES-GCM 加密存储，API token 只存哈希（90 天过期），改密/降权/禁用自动吊销；
  • 上游 DeepSeek Harness 以固定版本运行，桌面壳与插件保持单向依赖，不魔改上游源码。

插件优先的架构

  • 一切皆插件：核心智能体、Web UI、桌面外壳、连接器、定时任务、浏览器、记忆全部通过官方 Cordis 插件机制组合；
  • 桌面壳自身就是合法的 DSH 插件，第三方插件与桌面能力走同一条组合路径；
  • 上游固定 pin，后续同步只跟随版本号，不破坏本地扩展。

文档

普通用户直接从官网 Wiki开始即可；开发者文档只在需要扩展或维护时才需要阅读。

用户文档（官网）

目标入口
安装和日常使用桌面客户端 · 快速开始
快速确认平台、环境和使用边界常见问题
了解项目为什么存在产品哲学
系统架构与 API系统架构 · API 参考

开发者与维护者文档（仓库）

目标入口
编写普通或 Desktop 插件插件开发（官网）
参与统一插件 contract 讨论DSH Community Fabric Draft
了解桌面插件可以使用的能力桌面插件服务 contract
了解桌面应用如何工作架构说明（维护者视角）
查阅包级构建与发布细节dsh-plugin-desktop/README.md
查看全部文档分工文档索引

插件生态

插件是给 DSH 添加能力的扩展包——模型、工具、界面、工作流都可以做成插件，像搭积木一样自由组合。

PicoAide Harness 没有魔改上游源码，也不是一个固定写死的外壳。官方 DeepSeek Harness 以固定版本原样运行；桌面壳本身——窗口、托盘、更新、工作配置——就是一个合法的 DSH 插件，通过官方插件机制与官方能力组合进同一个运行时。从核心 agent 到桌面外壳，整个产品遵守同一条"一切皆插件"的规则：官方生态里的插件可以直接用，桌面能力也按插件的方式组合、替换和演进。

与官方项目的关系

本项目基于 deepseek-ai/deepseek-harness 构建。

官方项目提供核心的智能体能力、插件系统和 Web UI。本项目主要负责：

  • 桌面应用封装（窗口、托盘、更新与工作配置）
  • 本地服务的启动、停止与恢复
  • 企业级管理后台（用户、部门、网关、用量、商城与审计）
  • macOS、Windows、Linux 安装包构建与发布
  • 更适合桌面与团队使用的界面体验

如果你希望通过命令行运行 Harness，或者参与核心功能开发，请优先查看官方仓库。

特别感谢

特别感谢 DeepSeek Harness 原始仓库和 DeepSeek AI 团队。本项目基于固定版本的上游源码构建，核心的智能体、模型、工具、会话、Web UI 和插件生态都来自这个项目。

特别感谢 anywhere-labs/dsh-desktop（原 anywhere-labs/deepseek-harness-desktop）项目提供的源码与灵感——本项目的桌面封装、插件化组合思路与产品体验从该项目起步，并在此基础上持续演进。

同时感谢 Cordis 项目提供的插件化基础，以及 Koishi.js 项目和社区长期积累的插件化实践、工具与经验。

感谢以下社区插件为产品体验做出的贡献：

  • dsh-memory-evolve（分层记忆与自我进化）：为 DSH 带来全局、用户、项目、分支与每日分层记忆，以及技能与待办管理
  • DeepSeek Harness 插件生态中的连接器、任务、定时任务与浏览器等能力提供者

以及每一个使用、支持和参与共建的你。

开发

桌面端代码位于 packages/host/desktop/，外层仓库使用 Yarn，固定的 deepseek-harness/ 子模块继续使用自己的 pnpm workspace。从仓库根目录执行：

git submodule update --init --recursive
corepack yarn install --immutable
corepack yarn dev

headless 检查使用 corepack yarn check；完整的构建、测试和发布边界见架构说明和包级 README。如何参与贡献见 CONTRIBUTING.md。

社区交流

遇到问题或需要支持，请前往 提交 Issue。

License

本项目遵循 MIT License。

本项目是基于 DeepSeek Harness 构建的社区版本，并非 DeepSeek 官方产品。

本项目完全开源免费。如果有人向您以任何形式出售此软件，请拒绝交易。

DeepSeek 是 DeepSeek AI 的商标。PicoAide Harness 是独立的社区项目，与 DeepSeek 官方没有隶属关系，也未获得其背书。

Star History

Star History Chart