GitHub 热门项目推荐：deepseek-harness（TypeScript

这个项目有什么用

DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的 agent harness（智能体运行框架），基于「一切皆插件」（everything-is-a-plugin）的架构，底层由 Cordis 驱动。它要解决的问题是：把智能体能力的组装与扩展从写死在代码里，变成可以按需插拔的插件组合。

典型场景

需要在本地快速跑起一个带 Web UI 的智能体环境，做功能验证或演示；
希望以插件方式扩展智能体能力，而不是改动框架核心；
团队想基于统一 harness 搭建自己的智能体工作流，并保持各模块可替换。

适合使用的人群包括：做 AI agent 应用开发的工程师、需要快速试验插件化设计的团队，以及希望阅读一套 TypeScript 实现的 harness 架构的开发者。项目 Star 数较高，社区关注度不低。

核心特性

一切皆插件：官方描述即 “Everything is a Plugin”，能力以插件形式组织，便于组合与替换。
基于 Cordis 构建：底层采用 Cordis，其设计思想在论文《A Programming Paradigm for Spatiotemporal Composability》中有说明。
开箱即用的 Web UI：通过 npx 一条命令即可启动 Web 界面，默认监听本地端口并自动打开浏览器。
支持从源码构建：仓库提供完整的 clone、安装、构建、启动流程，便于二次开发。
插件生态可发现：给插件仓库打上 dsh-plugin topic 即可被检索到。
MIT 协议开源：采用宽松的 MIT 许可证，便于在项目中引入。

怎么安装

前提条件：需要先安装 Node.js。README 未说明具体版本要求，官方文档未说明最低 Node.js 版本。

方式一：直接从 npm 运行，无需单独安装。

安装 Node.js。
执行启动命令：
```
npx @deepseek-ai/dsh web
```

方式二：从源码运行，适合需要修改代码或参与开发的场景，需要 pnpm。

克隆仓库：

git clone https://github.com/deepseek-ai/deepseek-harness.git

进入目录：
```
cd deepseek-harness
```
安装依赖：
```
pnpm install
```
构建产物：
```
pnpm run build
```
启动 Web 界面：
```
pnpm dsh web
```

其中 pnpm run build 负责准备仓库构建产物，pnpm dsh web 直接使用这些已构建的产物，不会重新构建。

怎么使用

最基础的用法就是启动 Web UI：

npx @deepseek-ai/dsh web

该命令默认在 http://127.0.0.1:3080 启动 Web UI，并在本地启动时用默认浏览器打开。如果通过 SSH 启动，则只打印主机 URL，因为本地转发地址由 SSH 客户端或编辑器管理。

如果不想自动打开浏览器，可以加上 --no-open 参数：

npx @deepseek-ai/dsh web --no-open

开发场景下，README 提到可以用 pnpm run dev:web 在单个终端中完成构建、服务与源码改动后的客户端 bundle 重建；make help 会列出 Web 与 Desktop 对应的 Make 目标，完整命令表见开发指南的应用命令章节。更多 Web UI 用法见 docs/user/guide/index.md。

适用场景与注意事项

适合的场景：需要插件化组织智能体能力、想快速在本地跑起 Web UI 做验证、或希望阅读并二次开发一套 TypeScript harness 的团队。

需要注意的点：

项目处于 developer preview 阶段，迭代很快，README 明确提示「会出现破坏兼容性的变更」，不建议在稳定性要求高的生产环境中直接依赖。
运行前应先阅读仓库中的 SAFETY.md 安全说明。
通过 npx 方式运行需要联网下载包；Web UI 默认监听本地地址，SSH 场景下需自行处理端口转发。
项目采用 MIT 协议，使用限制较少，但具体合规要求仍应以仓库许可证文件为准。