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 与 deb）。普通用户不需要单独安装 Node.js、pnpm 或 DSH。

下载入口统一指向 Releases 最新版本：资产名带版本号（PicoAide-Harness-<版本>-…），硬编码版本的直链会在下一个版本发布后失效（P2-55）。

| 平台 | 下载 | 安装方式 | | --- | --- | --- | | Windows x64 | 下载安装程序（资产 PicoAide-Harness-<版本>-x64-Setup.exe） | 运行 NSIS 安装程序并按提示完成安装 | | macOS | 下载 DMG（资产 PicoAide-Harness-<版本>-mac.dmg） | 打开 DMG，将 PicoAide Harness 拖入 Applications | | Linux x64 | 下载 AppImage（资产 PicoAide-Harness-<版本>-x86_64.AppImage，另有 PicoAide-Harness-<版本>-amd64.deb） | 授予执行权限后运行（deb 用 sudo dpkg -i 安装） |

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

说明：Windows 安装程序与 Linux 安装包暂未签名（macOS 正式发布版经签名/公证）。首次运行 Windows 安装包时 SmartScreen 可能提示"未知发布者"，请先在 Releases 下载 SHA256SUMS.txt 核对后再运行；Linux 安装包同理。

核心优势

企业级一体化

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

开箱即用的生产力工具

• 能力中心：我的 / 市场两分区，技能与智能体类型筛选，来源（市场/组织/本地）与质量（官方/精选）徽章，多版本归并与历史，一键安装/更新/卸载；
• 连接器中心：内置销售易（NeoCRM）、Moka HR 等 MCP 连接器，OAuth 授权 + PKCE，凭据本地加密存储，动态注册 MCP；
• 定时任务：cron 定时执行，指定智能体与提示词、工作区与权限，执行详情（会话/结果/错误）随时可查，支持会话跳转，由 Host 统一调度；
• 内嵌浏览器：Agent 可接管浏览器执行操作，多标签、地址栏、权限审批与下载管控；
• 五轨记忆：用户档案、全局事实、项目关键记忆、项目日志与每日日志，按目录与 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