教程

dsh 是一个启动器，自带五个 profile——web、headless、sdk、sdk-minimal、acp——首次使用时自动初始化。本文把每个运行面对应到 CLI reference 为它文档化的用途：日常交互用 Web UI，CI 与脚本用一次性 headless，嵌入程序用 Python SDK，编辑器接入用 ACP，外加本站地图收录的社区 TUI 与桌面客户端。

阅读全文 →

从零到第一次 agent 会话只要五分钟：装好 Node.js，跑 npx @deepseek-ai/dsh web，贴上 DeepSeek API key，选一个工作区，发出第一句 prompt。本指南严格沿官方路径走，外加三个真正容易绊倒人的坑。

阅读全文 →

DeepSeek Harness（dsh）是 DeepSeek 开源的 Agent 框架，其架构中一切能力——模型接入、工具、会话、乃至 agent 循环本身——都是插件，没有特权核心。本指南解释 harness 这个概念，带你走完一个 turn 的完整流程，并说明「model-visible means logged」这条会话日志不变量为什么让整个系统可审计。

阅读全文 →

DSH 如何决定由哪个模型回答：模型页把 DeepSeek 密钥以只写方式存进凭据库，目录提供方直接继承已安装目录的端点与模型列表，自定义提供方经一个永久 Provider ID 接入任何 OpenAI 兼容网关——外加一行图片输入声明，和一个解决大多数网关兼容问题的 compat 块。

阅读全文 →

DSH「bundle / profile」两个名词与 dsh plugin 命令的实战指南。profile 是 $DSH_HOME/profiles/<name> 下的目录，列出它叠加的 bundle；dsh plugin 把参数转发给该目录下的 pnpm，所以 pnpm 的每个动词都能用。官方发行的 profile 是 web 与 headless；web 也可以用 dsh web 别名访问。

阅读全文 →

插件就是一个导出 apply(ctx) 的 TypeScript 模块——全部契约仅此而已。本指南按官方路径从零写一个：先用 cordis.yml patch 层实时开发，再打包成带 dsh.bundle manifest 的可安装组合包，并讲清 bundle 和 profile 为什么是两个不同的名词。

阅读全文 →

Cordis 是 DeepSeek Harness 底层的插件框架，其设计被形式化在预印本《A Programming Paradigm for Spatiotemporal Composability》中。本指南用人话精读这篇论文：时间可组合性指组件移除时副作用完全回退，空间可组合性指依赖被声明并被响应式管理——两者即 revertible effects 与 reactive coeffects，最终统一进单一 context type。

阅读全文 →