DeepSeek Harness 使用教程

DeepSeek Harness (dsh) 是 DeepSeek AI 开发的开源 agent harness 框架,采用"一切皆插件"的架构设计,基于 Cordis 构建。

GitHub: https://github.com/deepseek-ai/deepseek-harness

⚠️ 注意: 目前处于开发者预览阶段,可能会有破坏性变更。
📦 安装指南 : 请先参考 安装教程 完成安装和模型配置。


目录


使用 Web UI

启动命令

bash 复制代码
# npm 方式
npx @deepseek-ai/dsh web

# 源码方式
pnpm dsh web

默认访问地址

bash 复制代码
http://127.0.0.1:3080

功能概览

  • 会话管理: 创建、保存、恢复会话
  • 模型选择: 在已配置的模型间切换
  • 插件系统: 通过插件扩展功能
  • 工具调用: 内置 Bash、文件编辑器等工具

使用 Python SDK

基本用法

python 复制代码
from pathlib import Path
from deepseek_harness import DeepSeekHarness

# 配置路径
config = Path("examples/jsonrpc-agent/minimal.cordis.yml").resolve()
workspace = Path("/path/to/your/workspace").resolve()
sessions = Path("/path/to/sessions").resolve()

# 创建 harness 实例
with DeepSeekHarness(
    provider="deepseek-official",
    model="deepseek-v4-flash",
    max_tokens=49_152,
    cwd=str(workspace),
    session_root=str(sessions),
    cordis=str(config),
) as harness:
    # 运行任务
    result = harness.run(
        "检查仓库并修复失败的测试。",
        session_id="my-session-001",
    )

    print(result.final_response)

环境变量配置

bash 复制代码
export DEEPSEEK_API_KEY=sk-your-key-here
# export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1
# export DSH_MODEL=deepseek-v4-flash
# export DSH_SYSTEM_PROMPT='你是一个有用的软件工程助手。'

运行示例

bash 复制代码
python examples/jsonrpc-agent/minimal.py \
  --workspace /absolute/path/to/workspace \
  --session-root /absolute/path/to/sessions \
  --session-id example-001 \
  "检查仓库并修复失败的测试。"

会话管理

  • 使用新的 session_id 开始独立任务
  • 复用 session_id 继续之前的对话和持久化 Shell 状态
  • 会话日志以 JSONL 格式存储在 session_root 目录

常用命令

源码开发命令

bash 复制代码
# 安装依赖
pnpm install

# 构建项目
pnpm run build

# 类型检查
pnpm run typecheck

# 代码检查
pnpm run lint

# 运行测试
pnpm run test

# 运行所有检查
pnpm run check:all

# 启动 Web UI
pnpm dsh web

# Headless 模式(命令行)
pnpm dsh --profile headless "你的任务描述"

# ACP 自动化服务器
pnpm run demo:acp

# Cordis 演示
pnpm run demo:cordis

演示命令

bash 复制代码
# 构建后运行演示
pnpm run build

# Headless 编码代理
pnpm dsh --profile headless "summarize this workspace"

# Cordis 自检演示
pnpm run demo:cordis

# ACP 自动化服务器
pnpm run demo:acp

社区与支持

贡献指南

目前项目暂不接受外部 Pull Request,但欢迎通过以下方式参与:

  1. 在 GitHub Discussions 中报告问题
  2. 创建并分享插件
  3. 撰写博客和教程
  4. 帮助回答社区问题

相关资源


相关推荐
工程小白菜8 小时前
ai-code-review 全链路:让 AI 来审 AI 的代码
ci/cd·ai编程
小虎AI生活9 小时前
8万星开源HyperFrames,我用WorkBuddy免费模型做了3条视频
aigc·ai编程
佛系18910 小时前
从服务端日志精确分离搜索抓取、监控探测与真实流量的实操清单
ai·大模型·seo·geo·结构化数据·indexnow
AI大模型-小华12 小时前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
huangfuyk12 小时前
前端融入/转后端避坑指南:AI 时代的安全边界、数据防线与实战细节
后端·ai编程
MSTcheng.13 小时前
【AI应用实战】用 FastAPI + SSE 做一个自己的 AI 聊天网页:流式输出、多轮对话与完整源码
人工智能·python·大模型·fastapi·sse·ai聊天助手
ZzT13 小时前
AI-SDLC 实践 06|开发阶段的知识库:Agent 写代码前该读哪些规则和业务知识
ai编程·claude
Bigger13 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程
前端双越老师14 小时前
程序员 1v1 访谈系列第十六期:裸辞后失业半年了
前端·ai编程·全栈
ZerekZhang14 小时前
Harness:把裸模型变成能用的 Agent
agent·maf·harness