deepseek-harness

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# DeepSeek Harness

English | [中文](README.zh.md)

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).

## Developer preview

DeepSeek Harness is currently in _developer preview_ and is iterating rapidly. **THERE WILL BE COMPATIBILITY-BREAKING CHANGES.**

## Run

### Run from `npm`

Install `Node.js`, then run:

```sh
npx @deepseek-ai/dsh web
```

The command starts the Web UI, served at `http://127.0.0.1:3080` by default. See [Web UI guide](docs/user/guide/index.md).

### Run from source

To run from a repository checkout:

```sh
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
```

## Desktop pet (蜗蜗)

This fork ships `@deepseek-ai/dsh-client-ui-pet`, a Sumikko Gurashi-style desktop pet for the Web UI: it crawls around the page with an 8-direction sprite sheet and a fading slime trail, eats image files dropped onto it (they land in the current session's composer), falls asleep when idle, and reacts to conversation activity (messages sent, turns finished, long turns).

### Install into a checkout

```sh
# 1. copy the plugin package into the workspace
cp -R /packages/client/ui-pet packages/client/ui-pet

# 2. register it in the browser roster (packages/bundle/web-app/cordis.patch.yml):
#    - id: ui-pet
#      name: '@deepseek-ai/dsh-client-ui-pet'

# 3. add the dependency to packages/bundle/web-app/package.json:
#    "@deepseek-ai/dsh-client-ui-pet": "workspace:^"

# 4. add the explicit paths entry to tsconfig.base.json:
#    "@deepseek-ai/dsh-client-ui-pet": ["./packages/client/ui-pet/src"],

# 5. install and build
pnpm install
npx tsc -b packages/client/ui-pet
pnpm --filter @deepseek-ai/dsh-client-ui-pet bundle

# 6. restart dsh web — new client packages join the browser roster on restart
```

Bundle edits hot-reload through the client-plugin HMR chain; only the roster/dependency edits above need a restart.

### Regenerating the sprites

- `scripts/make-pet-asset.py ` — rebuild the default single sprite (`src/client/assets/pet.ts`).
- `scripts/generate-360.py --refs  --emit-ts` — generate the 8-direction cartoon sheet with OpenAI `gpt-image-1` (requires `OPENAI_API_KEY`) and rewrite `src/client/assets/sprites360.ts`.
- `scripts/ocr-labels.swift ` — OCR the view labels of a generated turnaround sheet (macOS-only; requires `swiftc`).

## Community and support

- Feel free to submit feedback or bug reports through [GitHub Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions).
- Add the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic to your plugin repository for discoverability.
- Join DeepSeek Harness Discord community.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## Development

Start with the [development guide](docs/development.md) and [architecture documentation](docs/architecture.md).

For agents, follow [AGENTS.md](AGENTS.md).

## License

[MIT](LICENSE)

Third-party dependencies and their licenses are disclosed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).