picoaide-harness

PicoAide Harness

企业级 DeepSeek 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。 拿到这些安装包只有两条路：

1. 企业服务器（推荐）：管理员部署完成后，员工打开 https:// /，门户页直接列出三平台下载入口； 2. 官方镜像包（试用 / 单机）：从更新服务器或 GitHub Release 取服务端镜像包，再从镜像里解出安装包： 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； 自动化任务：上游 Schedule 的定时提醒（单次 / 间隔 / 每日 / 每周 / cron），到点把提示词发回原会话；按账号隔离，执行记录由 Host 保留； 内嵌浏览器：Agent 可接管浏览器执行操作，多标签、地址栏、权限审批与下载管控； 语音输入：输入框麦克风把说话转成草稿文字，识别在本机跑（音频不出机器、离线可用），识别模型随客户端分发（装上即用、零下载；权重本身约 230MiB，安装包增幅视平台打包格式的压缩率而定，约 +140～250 MiB）；只有渠道包显式写 desktop.speech_bundle_model: false 时才回到首次使用下载； 五轨记忆：用户档案、全局事实、项目关键记忆、项目日志与每日日志，按目录与 git 分支隔离，确认制写入。 安全与合规 凭据以 0600/0700 权限原子写入，防符号链接、路径逃逸与超大读取； OAuth state 校验与超时控制，登录/登出整页刷新切断旧会话； 管理后台操作留痕，审计日志覆盖用户、部门、配额、网关、商店与共享审批操作； 上游密钥 AES-GCM 加密存储，API token 只存哈希（90 天过期），改密/降权/禁用自动吊销； 上游 DeepSeek Harness 以固定版本运行，桌面壳与插件保持单向依赖，不魔改上游源码

普通用户直接从官网 Wiki开始即可；开发者文档只在需要扩展或维护时才需要阅读。 用户文档（官网） 开发者与维护者文档（仓库） 插件生态

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

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

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

官方项目提供核心的智能体能力、插件系统和 Web UI。本项目主要负责： 桌面应用封装（窗口、托盘、更新与工作配置） 本地服务的启动、停止与恢复 企业级管理后台（用户、部门、网关、用量、商城与审计） macOS、Windows、Linux 安装包构建与发布 更适合桌面与团队使用的界面体验