# Awesome DSH

[English](README.md) | 中文

最短清单：帮你接到官方 DeepSeek Harness，而不是装错包。

## 注意

- **不要** pip 安装同样会暴露 `dsh` 的包。无关的 PyPI 包 `deepseek-harness-cli` (Henry Zhang) 带有 `dsh doctor` / `dsh chat`，占用了这个名字。
- 官方 CLI：`npx @deepseek-ai/dsh web` → http://127.0.0.1:3080
- 官方 Python SDK：`pip install deepseek-harness-sdk` （不是 `deepseek-harness`，也不是 CLI）
- 自检：`which -a dsh`。帮助信息应出现 `profile` / `web` / `plugin`，而不是 `doctor`。
- 截至 2026-08-16 的官方 npm： `@deepseek-ai/dsh@0.1.0-rc.6` 若需更新版本请自行核实。

## 官方

- 站点：https://deepseek.com/harness
- 源码：https://github.com/deepseek-ai/deepseek-harness
- [Web UI 指南](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md)
- [Python SDK](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/python-sdk.md)
- [架构](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md)
- [开发](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/development.md)

## 学习

[dsh-getting-started](https://github.com/guobinmengxiang-rgb/dsh-getting-started) — 中文 20 课教程。

## 一个插件

[dsh-xhs-note](https://github.com/guobinmengxiang-rgb/dsh-xhs-note)

```sh
dsh plugin --profile web add github:guobinmengxiang-rgb/dsh-xhs-note
node demo.mjs
```

## 完整目录

[awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 体量很大。插件代码在你本机运行。该目录不是安全审计。

## 坑

- 预览版会不兼容地变更。
- Preset 只有 `standard` / `PTC` / `minimal` / `cordis`。
- 不要 fork `packages/`。
- `npx` 可能加载不了本地 TypeScript。
- Git 上的 TypeScript 插件需要 `prepare` + `allowBuilds`。
- GitHub topic `dsh-plugin` 很嘈杂。

## 贡献

只收「从这里开始」的链接，不要刷 UI 主题。见 [CONTRIBUTING.md](CONTRIBUTING.md)。

## 许可

[MIT](LICENSE) © 2026 国彬 张