diff --git a/LICENSE b/LICENSE index c1f7a78e89..c2f846777e 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,17 @@ MIT License -Copyright (c) 2026 DeepSeek +本项目(DeepSeek Harness 社区版,含桌面端 deepseek-harness-desktop)是基于开源项目 +deepseek-harness(https://github.com/deepseek-ai/deepseek-harness)的衍生作品, +以 MIT 协议开源,并保留原项目版权声明。改动说明见 MODIFICATIONS.md。 + +This project (DeepSeek Harness Community Edition, including the desktop app +deepseek-harness-desktop) is a derivative work of the open-source project +deepseek-harness (https://github.com/deepseek-ai/deepseek-harness), released +under the MIT License with the original copyright preserved. See +MODIFICATIONS.md for the list of changes. + +Copyright (c) 2026 PineSound +Original project deepseek-harness Copyright (c) 2026 DeepSeek Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/MODIFICATIONS.md b/MODIFICATIONS.md new file mode 100644 index 0000000000..49ba29bd1e --- /dev/null +++ b/MODIFICATIONS.md @@ -0,0 +1,44 @@ +# Modifications — Community Fork of deepseek-harness + +This repository is a **community fork** of +[deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (MIT), +maintained by PineSound. The core harness — plugin architecture, agent loop, +server, and web frontend — is **preserved unchanged**; the fork adds a desktop +application and related product capabilities. + +- **Upstream**: https://github.com/deepseek-ai/deepseek-harness (MIT) +- **This fork**: adds `apps/desktop`, new host/client packages, and a release channel +- **License**: [MIT](LICENSE), with the original copyright preserved +- **Desktop repo**: https://github.com/PineKings/deepseek-harness-desktop +- **Publish site**: https://deepseek.pinesound.cn/ + +## Major changes vs. upstream + +### 1. Desktop app (`apps/desktop`, deepseek-harness-desktop) +- An Electron shell that launches the real `dsh` (the `web` profile) on loopback and opens a native window, so no browser tab or manual URL is needed. +- Self-contained: the packaged app bundles the full harness runtime, vendored pnpm, and a platform Node — zero external dependencies on the target machine. +- Cross-platform installers: macOS (`.dmg`) and Windows (`.nsis`). +- Chinese application menu and branded icons. + +### 2. Plugin inventory & marketplace (`packages/host/plugin-inventory`) +- Visual plugin list with search, status, and enable/disable controls. +- Black/whitelist guard: required system plugins cannot be disabled. +- Plugin install from npm / tarball / GitHub via the built-in pnpm, with multi-mirror fallback and hot reload (no restart). +- A plugin marketplace with persistent install state and priority-based ordering. + +### 3. Skill manager (`packages/host/skill-manager`) +- Manage local skills from the settings UI: list, install, uninstall, enable/disable, and edit descriptions. + +### 4. Image recognition / vision +- An OpenAI-compatible HTTP vision provider (e.g. Alibaba DashScope) that fills the gap for text-only models. +- Vision key / endpoint / model are configured independently of the chat model. +- A settings **namespace exposure** mechanism (`configurable` + `exposeSettings`) lets third-party settings namespaces be edited from the UI. + +### 5. Update & release channel +- The About page shows the dynamic version and "check for updates", reading an online `releases.json`. +- Desktop updates and the web publish site share the same manifest — one deploy publishes both. + +## Scope preserved + +The fork does **not** change the harness backend. The desktop is a thin launcher; +native addons keep their system Node ABI and are never loaded under Electron. diff --git a/MODIFICATIONS.zh.md b/MODIFICATIONS.zh.md new file mode 100644 index 0000000000..2a8fd25772 --- /dev/null +++ b/MODIFICATIONS.zh.md @@ -0,0 +1,41 @@ +# 更改说明 — deepseek-harness 社区版 + +本仓库是 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)(MIT) +的**社区衍生版**,由 PineSound 维护。核心 harness——插件架构、agent loop、服务端、前端——**完全保留不变**; +本仓库在其基础上新增了桌面应用与相关产品能力。 + +- **上游**: https://github.com/deepseek-ai/deepseek-harness(MIT) +- **本仓库**: 新增 `apps/desktop`、若干 host/client 包与发布渠道 +- **协议**: [MIT](LICENSE),保留原项目版权 +- **桌面仓库**: https://github.com/PineKings/deepseek-harness-desktop +- **发布站**: https://deepseek.pinesound.cn/ + +## 相比上游的主要改动 + +### 1. 桌面应用(`apps/desktop`,即 deepseek-harness-desktop) +- 基于 Electron 的桌面外壳,启动真正的 `dsh`(`web` 配置)于回环端口并打开原生窗口,无需浏览器标签页或手动输入 URL。 +- 自包含:安装包内置完整 harness 运行时、vendored pnpm 与平台 Node,目标机器**零外部依赖**。 +- 跨平台安装包:macOS(`.dmg`)与 Windows(`.nsis`)。 +- 中文应用菜单与品牌图标。 + +### 2. 插件清单与插件市场(`packages/host/plugin-inventory`) +- 可视化插件列表,支持搜索、状态查看与启用/停用。 +- 黑白名单守卫:核心系统插件不可停用。 +- 经内置 pnpm 从 npm / tarball / GitHub 安装插件,多镜像回退、免重启实时生效。 +- 插件市场:持久化安装状态、按优先级排序。 + +### 3. 技能管理(`packages/host/skill-manager`) +- 在设置页管理本机技能:列表、安装、卸载、启用/停用、编辑描述。 + +### 4. 图像识别 / 视觉能力 +- 通过 OpenAI 兼容 HTTP 视觉提供方(如阿里云 DashScope)为纯文本模型补齐视觉能力。 +- 视觉的密钥 / 接口 / 模型与对话主模型**完全独立**配置。 +- 新增 settings **命名空间暴露**机制(`configurable` + `exposeSettings`),可在界面编辑第三方 settings 命名空间。 + +### 5. 更新与发布渠道 +- 「关于」页显示动态版本号与「检查更新」,读取线上 `releases.json`。 +- 桌面更新与网页发布站读取**同一份**清单,一次发布同时服务桌面与网页。 + +## 保留范围 + +本仓库**不改变 harness 后端**。桌面仅是薄启动器;原生插件仍运行在系统 Node ABI 上,从未加载进 Electron。 diff --git a/README.md b/README.md index 8a4bd01332..861e9b7140 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,14 @@ English | [中文](README.zh.md) +> **Community fork notice**: This repository is a community derivative of +> [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness), +> maintained by PineSound. On top of the **unchanged core harness** it adds a +> **desktop app** ([deepseek-harness-desktop](https://github.com/PineKings/deepseek-harness-desktop)), +> a plugin marketplace, image recognition, and a release channel. This is **not +> the official DeepSeek repository**. See [MODIFICATIONS.md](MODIFICATIONS.md) +> for the full list of changes; licensed under [MIT](LICENSE). + DeepSeek Harness (`dsh`) is an open-source agent harness developed by [DeepSeek AI](https://deepseek.com). It uses an architecture where **everything is a plugin**, and is powered by [Cordis](https://github.com/cordiverse/cordis), whose design is described in [_A Programming Paradigm for Spatiotemporal Composability_](https://github.com/cordiverse/paper). diff --git a/README.zh.md b/README.zh.md index b7bc214bfb..0c954e0cea 100644 --- a/README.zh.md +++ b/README.zh.md @@ -2,6 +2,12 @@ [English](README.md) | 中文 +> **社区衍生版说明**:本仓库是 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) +> 的社区衍生版,由 PineSound 维护。在**核心 harness 完全不变**的基础上,新增了 +> **桌面应用**([deepseek-harness-desktop](https://github.com/PineKings/deepseek-harness-desktop))、 +> 插件市场、图像识别与发布渠道。本仓库**并非 DeepSeek 官方仓库**。完整改动见 +> [MODIFICATIONS.zh.md](MODIFICATIONS.zh.md),以 [MIT](LICENSE) 协议开源。 + DeepSeek Harness(`dsh`)是由 [DeepSeek AI](https://deepseek.com) 开发的开源 agent harness(智能体框架)。 它采用**一切皆插件**的架构,并由 [Cordis](https://github.com/cordiverse/cordis) 驱动,其设计参见论文 [_A Programming Paradigm for Spatiotemporal Composability_](https://github.com/cordiverse/paper)。