DeepSeek Harness 快速入门
DeepSeek Harness (harness.vin) 是开源 AI Agent 框架，让 AI 智能体在真实场景中持续工作。本教程将指导你完成安装、配置和创建第一个 AI Agent，体验一切皆插件的灵活架构。
安装与启动
环境准备
确保已安装 Node.js（npx 启动 Web UI 所需）。可通过 node -v 命令检查安装状态。
一键启动
运行 npx @deepseek-ai/dsh web 命令启动 Web 界面，命令会打印访问地址。无需全局安装，npx 会处理一切。
源码安装（可选）
如需深度定制，可通过 git clone https://github.com/deepseek-ai/deepseek-harness 克隆源码，然后按照仓库 README 的说明使用 pnpm 完成构建与运行。
配置插件
DeepSeek Harness 采用一切皆插件架构。在配置层选择所需的模型、工具、技能、沙箱等插件，无需改动源码即可组合出完整的 Agent 能力。
运行 Agent
配置完成后即可运行 AI Agent。DeepSeek Harness 会记录完整的会话轨迹（trajectory）事件流，支持恢复、分叉、检索与回放。
快速上手
从一条命令启动 Web UI 开始，体验 DeepSeek Harness 的插件化架构与工具调用能力。
# 一键启动 Web UI（打印访问地址）
npx @deepseek-ai/dsh web
# 无头模式：一次性运行全新会话并打印最终回复
dsh --profile headless "Summarize this repository."
# 在自己的程序中调用同一套 API（Python 3.10+）
python -m pip install deepseek-harness-sdk
from deepseek_harness import DeepSeekHarness
with DeepSeekHarness(provider="deepseek-official") as harness:
result = harness.run("Summarize this repository.")
print(result.final_response)核心能力
Python SDK
通过 pip 安装 deepseek-harness-sdk，在自己的程序中调用与 Web UI 同一套 API，运行 Agent 并获取最终回复。
插件化架构
模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有能力均由插件提供，支持自由替换和灵活重组。
多种运行模式
标准模式、PTC 模式、极简模式、创造模式，根据不同场景选择最合适的运行方式。
会话轨迹
记录完整的 append-only 事件流，支持恢复、分叉、检索与回放，让 AI 运行有迹可循。
深入了解
常见问题
如何安装 DeepSeek Harness？
运行 npx @deepseek-ai/dsh web 即可快速启动（需要 Node.js），或通过 git clone 从源码安装、按仓库 README 使用 pnpm 构建。
DeepSeek Harness 是开源的吗？
是的，DeepSeek Harness (harness.vin) 是开源 AI Agent 框架，基于 MIT 协议发布，代码托管在 GitHub。
DeepSeek Harness 支持哪些运行模式？
支持标准模式、PTC 模式、极简模式和创造模式四种运行模式。
如何创建自定义插件？
DeepSeek Harness 基于 Cordis 插件系统：插件是导出 apply 函数的 TypeScript 模块，通过 ctx 注册能力并声明依赖。参考插件系统页面获取详细信息。