DSH下载安装官方正版(DeepSeek Harness)

DSH下载安装官方正版(DeepSeek Harness)是由社区开发者salathleizhang维护的开源项目，本质上是DeepSeek Harness（简称DSH）的可嵌入式SDK封装。DSH Agent SDK通过暴露简洁的TypeScript API，让开发者能够更便捷地将AI智能体能力集成到自己的应用中。DSH Agent SDK默认运行时包含完整的编程循环：DeepSeek模型路由、持久化会话事件、沙箱化Bash执行、文件系统读写编辑、glob与grep搜索、任务取消与审批、确定性资源清理等核心能力。而技能、目标、作业、浏览器工具、子Agent和UI集成等高级能力则作为可选插件按需加载，应用可在其提供者、消费者、策略和生命周期完备时再添加这些能力。DSH Agent SDK支持通过npm一键安装（npm install dsh-agent-sdk），并提供query()一次性查询和createRuntime()可复用运行时两种使用方式。在安全性方面，DSH Agent SDK默认将文件系统和进程操作限制在workspaceRoot工作目录内，并提供onApproval审批回调机制，高危操作需人工确认。开发者还可通过runtimeSetup和createAgent的setup回调自由注册自定义工具与Cordis插件。无论你是希望将AI编程能力集成到自有应用中的开发者，还是想探索Agent技术的爱好者，DSH Agent SDK都能提供灵活、安全的解决方案。快来了解DSH Agent SDK，开启你的AI Agent集成之旅吧。

DSH Agent SDK核心功能与亮点

DSH Agent SDK的核心价值在于将DeepSeek Harness的强大能力以轻量级SDK形式提供给开发者，以下5个功能是开发者日常使用中频率最高的：

可嵌入式Agent运行时：DSH Agent SDK提供可嵌入的插件化编码Agent运行时，通过简洁的TypeScript API即可在应用中集成完整的AI智能体能力。

DeepSeek模型路由：DSH Agent SDK默认支持DeepSeek模型适配器，开发者仅需配置DEEPSEEK_API_KEY即可快速接入DeepSeek系列模型进行推理。

沙箱化安全执行：DSH Agent SDK内置文件系统和进程操作的沙箱隔离机制，默认将操作限制在workspaceRoot工作目录内，高危操作需通过onApproval审批回调确认。

完整的编码工具链：DSH Agent SDK提供沙箱Bash执行、文件读写编辑、glob与grep搜索、任务取消与审批、确定性资源清理等完整的编码Agent工具链。

插件化能力扩展：DSH Agent SDK继承DeepSeek Harness的“一切皆插件”理念，开发者可通过runtimeSetup和createAgent的setup回调自由注册自定义工具与Cordis插件。

DSH Agent SDK怎么在项目中使用？快速入门指南

DSH Agent SDK提供了两种主要的使用方式，开发者可根据实际场景灵活选择：

1、一次性查询（query）：适用于简单的单次任务场景。通过import { query } from 'dsh-agent-sdk'引入，调用query()方法传入工作目录和提示词即可，query()会拥有一个全新的运行时和Agent，提前退出迭代器会取消当前工作并自动清理资源。

2、可复用运行时（createRuntime）：适用于需要多次交互的复杂场景。通过import { createRuntime } from 'dsh-agent-sdk'创建运行时，再通过runtime.createAgent()创建Agent实例，可多次调用agent.prompt()进行连续对话，使用完毕后需调用agent.close()和runtime.close()释放资源。

3、环境要求：DSH Agent SDK需要Node.js ^22.19.0或>=24.0.0版本，以及有效的DEEPSEEK_API_KEY。

DeepSeek Harness 怎么在手机上用？Android Termux 与移动端方案

一、官方没有手机 App

dsh 官方目前只有 Web UI（浏览器界面）和命令行两种形态，没有 iOS/Android 官方客户端。手机使用主要靠两条路：

方式一：在 Android 手机上用 Termux 直接运行 dsh（推荐）

方式二：用社区打包的 APK 安装包

二、方式一：Termux 直接运行（推荐）

Termux 是 Android 上的终端模拟器，可以在上面跑 Linux 环境。社区项目 deepseek-harness-termux 专门做了适配，让 dsh 能在手机上运行。

大致流程：

第 1 步：安装 Termux

从 Termux 官方渠道（F-Droid 或 GitHub Releases）下载安装，不要用应用商店里的旧版本。

第 2 步：安装 Node.js 等依赖

在 Termux 里执行：

pkg update && pkg upgrade 

pkg install nodejs git

第 3 步：安装并启动 dsh

npx @deepseek-ai/dsh web

启动后按终端提示访问本地地址（通常也是 http://127.0.0.1:3080），用手机浏览器打开即可。

注意事项：

手机端运行的是完整 dsh，功能不受裁剪，但性能受手机硬件限制，复杂任务会慢

建议在 Wi-Fi 环境下使用，避免流量消耗

长时间运行注意手机发热与耗电

三、方式二：社区 APK 安装包

社区有第三方打包的移动端安装包（如 dsh-mobile-apk 等项目），把运行环境一起打包成 APK，安装后直接打开使用，省去 Termux 的配置过程。

使用建议：

第三方 APK 非官方出品，安装前确认项目活跃度与来源可信度

按自己的安全习惯评估后再安装

遇到问题优先看项目 README 或提 issue

四、如果你用的是 iPhone

目前社区方案主要集中在 Android（Termux 生态），iOS 上运行 dsh 的成熟方案较少。iOS 用户可以：

在电脑上跑 dsh Web UI，用手机浏览器访问（需电脑与手机在同一网络，且需自行处理端口与访问配置）

关注官方后续是否推出移动端

五、手机端使用的小建议

1. 任务选轻量

手机跑复杂任务（大仓库、长时间多步操作）会比较吃力，适合发一些轻量任务：问答、查资料、简单文件操作。

2. 注意密钥安全

手机上配置 API 密钥时，留意屏幕截图、剪贴板等泄露风险。密钥存储在 $DSH_HOME/.credentials.yaml，别把手机上的配置目录同步到云端网盘。

3. 网络环境要稳

手机端跑任务依赖网络连接模型 API，网络不稳定会导致任务中断，建议在稳定 Wi-Fi 下使用。

总结：DeepSeek Harness 官方没有手机 App，但 Android 用户可以通过 Termux 直接运行 dsh（社区已做好适配），或使用第三方打包的 APK；iPhone 用户目前选择较少，主要靠浏览器访问电脑端。手机端适合轻量任务，注意密钥安全与网络稳定，体验会更顺畅。

DSH Agent SDK的安全与权限机制

DSH Agent SDK在安全方面设计了多层次的防护机制，确保Agent执行的安全性：

工作目录隔离：默认的workspace-write模式将文件系统和进程操作限制在codingTools.workspaceRoot指定的目录内，默认为process.cwd()。

审批回调机制：开发者可通过codingTools.onApproval提供审批回调，对高危操作进行人工确认。审批请求包含Agent标识、工具标识、调用ID和可读原因，不重复传递工具参数。

灵活的工具禁用：开发者可通过codingTools: false一次性禁用全部六个内置编码工具，或通过spine.toolBash: false仅禁用Bash执行能力。

DSH Agent SDK适合哪些人群？

DSH Agent SDK的受众范围非常广泛，无论你是AI应用开发者、技术研究人员还是爱好者，都能从中获得价值：

AI应用开发者：DSH Agent SDK帮助开发者快速将AI编程能力集成到自有应用中，省去从零构建Agent基础设施的工作。

技术研究团队：DSH Agent SDK提供完整的插件化架构，研究人员可基于Cordis进行深度定制与实验。

开源贡献者：DSH Agent SDK完全开源，欢迎开发者贡献代码、提交Issue或开发插件生态。

技术极客与学生党：DSH Agent SDK是学习AI Agent技术原理、探索智能体集成的最佳实践平台。

DSH Agent SDK值得使用吗？常见问题解答

对于初次接触DSH Agent SDK的开发者，以下是一些常见问题的解答：

Q：DSH Agent SDK是免费的吗？A：DSH Agent SDK完全免费开源，可自由使用、修改与分发。

Q：DSH Agent SDK和DeepSeek Harness是什么关系？A：DSH Agent SDK是基于DeepSeek Harness构建的可嵌入式SDK封装，通过TypeScript API暴露Harness的核心能力。

Q：使用DSH Agent SDK需要付费调用模型吗？A：DSH Agent SDK框架本身免费，但调用DeepSeek或第三方模型API需要按各厂商标准支付Token费用。

Q：DSH Agent SDK可以在安卓手机上使用吗？A：DSH Agent SDK本身是Node.js包，可在支持Node.js的环境中使用。社区同时提供了dsh-mobile-apk等安卓移动端方案。