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:
@@ -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
|
||||
|
||||
@@ -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.
|
||||
@@ -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。
|
||||
@@ -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).
|
||||
|
||||
@@ -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)。
|
||||
|
||||
Reference in New Issue
Block a user