docs: document the community fork, bilingual README + license + modification notes

- README.md / README.zh.md: add a bilingual "community fork" banner noting this is a
  derivative of deepseek-ai/deepseek-harness with a desktop app, plugin marketplace,
  image recognition, and a release channel; link to the modification notes.
- MODIFICATIONS.md / MODIFICATIONS.zh.md: standard, bilingual list of changes vs upstream.
- LICENSE: keep MIT, add PineSound as derivative copyright holder while preserving the
  original DeepSeek copyright, and point to MODIFICATIONS.md.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Pine
2026-08-15 18:05:42 +08:00
parent d64ff6e3d4
commit 3dacd6e399
5 changed files with 111 additions and 1 deletions
+12 -1
View File
@@ -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
+44
View File
@@ -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.
+41
View File
@@ -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。
+8
View File
@@ -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).
+6
View File
@@ -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)。