DeepSeek Harness 完整教程课件

DeepSeekHarnessCompleteGuideDeepSeekHarnessAIAgent框架实战教程解锁本地AIAgent的无限潜能插件化架构灵活扩展，一切皆插件安全可控本地部署，数据零泄露高度定制按需配置，适配业务场景CONTENTS01

环境与安装从零开始搭建开发环境，完成基础配置与依赖安装，为后续开发打下坚实基础。04

会话与模式掌握核心交互方式，熟悉不同会话模式的切换与管理，灵活应对各类交互场景。07

插件生态探索丰富的插件资源，学习如何安装与使用插件，扩展框架的功能边界与无限可能。02

模型接入配置并接入各类主流AI模型，自定义模型参数，实现与框架的无缝对接与调用。05

高效使用技巧学习实用的操作技巧与优化策略，提升Agent的响应速度与任务处理效率。08

架构要点深入剖析系统的核心架构设计，理解模块间的交互逻辑与底层运行机制。03

工作区与权限配置工作区环境，设置精细的权限管理体系，保障系统运行的安全性与可控性。06

高级能力探索多智能体协作、自动化流程编排等高级功能，解锁更复杂的业务应用场景。09

注意事项与速查汇总常见问题的解决方案与关键操作速查，快速排查故障，高效解决使用难题。01环境与安装从零开始搭建开发环境环境依赖Node.js环境版本需≥22.19，建议使用LTS长期支持版，确保运行环境稳定兼容。跨平台兼容完美适配Windows、macOS、Linux三大主流桌面操作系统，无平台限制。终端守护进程服务需保持终端窗口开启，网页仅作为可视化交互的控制前端。默认端口3080默认监听localhost:3080，支持通过命令行参数自定义端口号。⚠️核心机制DSH是本地运行的服务，网页只是控制器。关闭启动终端会导致服务立即停止，请务必保持终端窗口运行。🔧端口冲突解决若3080被占用，启动时指定端口：

dshweb--port3081

替换端口号即可解决。图示为终端命令行操作界面，展示了服务启动参数配置与运行状态反馈。通过命令行交互，您可以灵活配置服务参数，确保DSH服务在本地环境中稳定运行。安装启动方式（一）01快速体验·零安装即用$npx@deepseek-ai/dshweb极简高效：

无需下载安装包，跳过配置流程，执行命令即刻启动服务，秒级响应。适用场景：

初次功能验证、临时测试需求，或不想在本地环境留下冗余文件的场景。02日常推荐·全局环境部署$npminstall-g@deepseek-ai/dsh

$dshweb全域可用：

安装后成为系统全局命令，在任意终端目录均可直接调用，无缝融入开发工作流。核心场景：

高频日常开发、团队协作共享环境，是追求效率与稳定性的最佳实践方案。注意：若全局安装时遇到权限问题，Mac/Linux用户可尝试添加sudo前缀，Windows用户建议使用管理员权限运行终端。安装启动方式（二）03/源码编译部署●

克隆仓库：

gitclone<repository-url>●

进入目录：

cd<project-directory>●

安装依赖：

pnpminstall●

构建启动：

pnpmbuild&&pnpmstart核心价值获取最新开发版本，支持深度定制与功能扩展，是开发者贡献代码、调试新特性或进行私有化部署的首选方式。04/AI助手自动部署智能交互驱动部署利用自然语言交互替代传统命令行操作，通过ChatGPT、Claude等AI助手自动解析指令并执行部署流程，将复杂的技术步骤转化为简单的对话式操作。轻量化与低门槛适配专为非技术背景用户设计，同时适配追求高效部署的团队场景。无需记忆复杂命令，即可快速完成环境配置，显著降低操作门槛与人为失误风险。常见故障排查01.node命令未识别原因：Node.js未安装，或安装后未正确添加到系统环境变量(PATH)。解决：下载并安装Node.js≥22.19版本，安装时务必勾选“AddtoPATH”选项，或手动配置系统环境变量。02.Node.js版本过低原因：当前安装的Node.js版本低于项目依赖的最低要求，导致兼容性问题。解决：推荐使用nvm版本管理器灵活切换版本，或前往Node.js官网下载最新LTS版本覆盖安装。03.默认端口被占用原因：3080端口被其他应用程序（如数据库服务、其他开发项目）占用。解决：执行命令dshweb--port3081更换端口启动，或使用任务管理器关闭占用端口的进程。04.网页无法访问原因：服务未成功启动、网络配置异常，或浏览器访问地址输入错误。解决：检查终端是否有报错信息，确认服务已正常启动，访问正确地址：http://localhost:3080。排查核心原则：优先查看终端的报错日志信息，这是定位问题最直接、最高效的方式，任何红色或黄色的提示文本都是关键线索。02模型接入配置您自己的AI模型配置DeepSeek模型注册账号访问DeepSeek开放平台，完成账号注册与实名认证，开启AI探索之旅。创建APIKey在开发者控制台生成专属API密钥，作为模型调用的身份凭证。进入模型设置登录DSHWebUI界面，导航至“设置”菜单下的“模型配置”选项。填入并保存将APIKey粘贴至指定输入框，确认无误后点击保存，即刻生效。推荐模型DeepSeekV4Flash

平衡速度与性能的首选安全保障密钥加密存储，永不回显

请妥善保管您的凭证高性能算力集群，驱动智慧医疗依托高可用服务器集群与先进的分布式计算架构，确保模型在医疗数据分析、辅助诊断等场景下的毫秒级响应，为医疗科技应用提供坚实的算力底座。支持多服务商与自定义网关多服务商生态兼容不仅支持DeepSeek原生模型，更兼容Anthropic、OpenAI等主流服务商。只需在设置中填入对应APIKey，即可实现多模型的灵活切换与调用。自定义网关灵活接入支持接入自建的OpenAI兼容网关（如llama.cpp、text-generation-webui）。通过自定义BaseURL，轻松实现私有化部署模型的无缝对接，保障数据隐私安全。视觉模型能力扩展支持具备图像理解能力的多模态模型。只需在配置文件中声明模型的图片输入能力，即可实现图文混合输入的智能交互，满足医疗影像分析等复杂场景需求。开放架构设计打破了模型与部署的边界，为医疗AI应用提供了极高的灵活性与适配性，助力构建更智能的医疗服务体系。模型使用与故障处理会话模型强绑定机制每个会话在创建时即与选定模型版本锁定，后续修改全局模型配置仅对新会话生效，已建立的会话将保持初始模型运行，确保交互逻辑的稳定性与一致性，避免因配置变更导致业务中断。01密钥鉴权异常检查APIKey是否输入正确，确认服务商账户状态正常（无欠费、账号未被封禁）。鉴权失败是接口调用失败的首要原因，需优先核对密钥有效性与权限范围。02模型资源不可用核实模型名称与服务商官方列表一致，确认模型未被下线或受地域限制。部分模型可能需要额外申请权限或仅支持特定区域调用，建议查阅最新文档。03视觉请求解析失败确认视觉模型已正确配置，检查图片格式是否为JPG/PNG等支持类型，同时核实图片大小与分辨率是否符合接口限制，避免因文件损坏或格式不兼容导致报错。💡核心提示：

若故障持续，建议重新生成API密钥并核对模型权限配置，确保服务端与客户端配置一致，必要时联系服务商技术支持排查。03工作区与权限安全保障系统安全与可控Workspace工作区01/核心定义工作区是Agent拥有文件读写权限的目录范围，是保障系统安全的第一道防线。它严格限定了AI的操作边界，防止越权访问系统敏感文件与核心目录。不可逾越的安全门槛：

必须先选定工作区，聊天输入框才会被激活。这是系统强制的安全校验步骤，确保Agent始终在受控范围内运行。02/概念辨析终端当前工作目录（CWD）≠DSH工作区。前者是系统层面的路径状态，后者是AI的权限边界，二者相互独立，互不影响。01选择目录点击按钮唤起浏览器02确认范围选定目标文件夹03激活交互输入框解锁可用可视化类比：

如同代码编辑器的工作区机制，DSH通过严格的目录隔离，将Agent的操作限制在特定文件夹内，从源头阻断非法访问，确保系统数据安全与操作可控。三档权限机制01只读模式核心权限：

禁止修改任何文件内容，仅开放文件读取与查看权限，确保数据原始性与完整性。适用场景：

适用于代码审计、合规审查、数据分析等仅需信息调研，无需改动文件的静态分析场景，保障环境安全。02工作区写入核心权限：

仅允许修改指定工作区内的文件，严格隔离外部系统目录，保障操作边界可控。适用场景：

日常开发的默认安全模式，支持代码编写、调试、构建与项目迭代，兼顾开发灵活性与系统基础安全。03全盘读写核心权限：

允许修改整个文件系统，拥有最高级别的操作权限，误操作风险系数极高。适用场景：

仅限系统级配置、环境部署、跨目录迁移等特殊高危操作，需二次身份验证，操作前务必谨慎确认。通过精细化的三级权限分级体系，DSH构建了从安全隔离到灵活开发再到特殊运维的全场景管控，在保障研发效率的同时实现风险可控。安全机制详解01权限精准管控核心限制文件写入操作，筑牢数据篡改防线；文件读取与网络访问不受目录隔离约束，在保障安全的前提下，兼顾业务访问的灵活性与高效性。02高危人工审批针对修改系统配置等高危操作，自动触发强制人工确认流程。需经管理人员手动核验并授权后，操作方可继续执行，从流程源头阻断违规风险。03底层硬核防护依托操作系统沙箱实现环境隔离；内置防无限重试插件阻断死循环，超时中断插件终止卡死任务，从底层保障系统运行的绝对稳定与可控。安全闭环：通过“权限管控+人工审批+底层防护”的三层防御体系，构建了全方位的安全屏障，确保智能体在合规边界内稳定运行，杜绝非法操作与系统失控风险。04会话、模式与斜杠命令掌握核心交互方式会话管理功能01新建会话开启独立的对话实例，建立全新上下文环境，确保交互逻辑纯净无干扰。02自定义命名设置个性化标题，支持关键词检索，快速定位历史对话记录。03智能归档归档低频会话，释放活跃列表空间，数据永久留存，随时可恢复。04Fork会话分叉基于当前状态创建分支，并行探索不同方案，无需重复输入背景。05上下文压缩执行/compact命令精简摘要，有效减少Token消耗，降低使用成本。06全量日志留存完整记录交互细节，支持历史回放与内容溯源，安全可靠。高效操作：

使用Shift+Enter实现快速换行输入，优化交互体验。直观的移动端交互界面，支持多场景下的流畅对话体验，操作便捷，响应迅速，为医疗科技场景下的高效沟通提供坚实支撑。四种会话预设模式重要提示：会话模式在创建后不可切换，请根据业务需求提前规划并谨慎选择。标准模式(Standard)核心能力：

拥有全栈AI能力，整合自然语言理解、多模态交互与通用工具调用，是默认的通用首选模式。适用场景：

适用于病历智能解读、医患沟通辅助、常规医疗咨询、医学报告生成等绝大多数日常医疗业务场景。PTC代码模式(PTCCode)核心能力：

支持运行TypeScript脚本，可自动化批量执行复杂工具调用链，实现高度定制化的业务逻辑编排。适用场景：

适用于批量医疗数据处理、自动化患者随访、多系统联动的医疗流程自动化、科研数据批量分析等场景。合理选择会话模式是保障医疗AI高效运行的基础，建议根据业务复杂度与自动化需求进行决策。四种会话预设模式（续）01极简模式(Minimal)核心能力：

仅保留基础的Bash命令行环境与轻量级文件编辑工具，剔除所有冗余组件与后台服务，确保环境极致纯净、启动极速且无额外资源占用。适用场景：

适用于快速验证新工具兼容性、在资源受限的隔离环境中执行轻量级脚本任务，或作为安全沙箱进行基础命令测试，有效避免环境依赖冲突。02创造模式(Creative)核心能力：

拥有系统级高权限，支持直接修改DSH运行时内核配置与底层参数，可动态加载、卸载自定义插件，实时调试运行逻辑并深度定制运行环境。适用场景：

专为高级开发者与运维专家设计，用于DSH插件的开发、调试与迭代，以及复杂工作流的定制、性能调优与深度系统集成测试工作。安全提示：创造模式具备极高系统权限，操作前请务必确认环境隔离，避免误操作影响核心系统稳定性；建议仅在独立的测试环境中使用该模式进行开发调试。内置斜杠快捷命令/plan

计划模式Agent仅输出执行方案，不直接执行修改操作。需用户确认指令无误后，才会启动后续行动，确保操作安全可控。/goal

目标规划设定长期业务目标，Agent将自主拆解任务步骤，制定阶段性执行计划并持续推进，形成从目标设定到落地的完整闭环。/permission

权限管控灵活调整Agent的操作权限等级，可临时提升或降低权限范围，精准适配不同业务场景下的安全与功能需求。/export

数据导出一键导出当前会话的完整交互日志、执行记录及关键数据，支持多种主流格式，便于后续归档、审计与复盘分析，保障数据可追溯。/compact

上下文压缩手动触发上下文摘要压缩机制，智能精简历史对话中的冗余信息，优化模型上下文窗口利用率，有效提升Agent的响应效率与处理能力。05高效使用技巧提升Agent工作效率任务提示四要素01目标(Goal)明确任务的最终预期结果与核心导向，让Agent清晰知晓行动的终极愿景，避免方向偏差，确保执行始终围绕核心目标展开。02范围(Scope)清晰界定任务的执行边界与适用范畴，例如指定具体的文件路径、操作对象、业务场景或数据范围，有效防止执行偏离与过度扩展。03禁区(Forbidden)明确任务执行中的禁止操作、规避红线与风险行为，如特定文件不可修改、敏感流程不可触发，保障执行过程的安全可控与合规性。04验收标准(AcceptanceCriteria)定义任务完成的量化与质化判定标准，如功能达标率、代码覆盖率、格式规范等，作为验证任务是否达成预期的核心依据。💡实战示例：“请在src/utils目录下，为所有.ts文件添加Jest单元测试（目标），但禁止修改index.ts文件（禁区），最终需确保测试覆盖率达到80%以上（验收标准）。”长期规则与实时交互长期规则配置(AGENTS.md)在工作区根目录创建配置文件，将项目规范、设计原则与长期规则固化其中。Agent每次会话将自动读取，彻底告别重复指令，确保执行基准的一致性与高效性。动态交互与实时纠偏任务执行过程中可随时中断、插入新任务或调整优先级。通过即时指令动态引导Agent修正方向，实现人机协作的灵活性与精准度，确保目标高效达成。通过代码编辑器配置核心规则文件，建立标准化的智能协作基础，实现高效、可控的AI任务执行流程。轨迹视图(Trajectory)全量操作追溯完整记录Agent执行任务的每一步真实操作，涵盖工具调用、参数传递与状态变更，无遗漏还原执行现场，是系统调试的基础依据。排查与决策洞察快速定位执行偏差（如“声称修改未生效”），深度解析Agent的决策逻辑链条，同时满足医疗场景下的合规审计与行为溯源需求。可信日志与回放采用“只追加”的写入模式，确保日志数据真实不可篡改；支持全流程会话回放，直观复现Agent的操作路径与交互细节。核心价值：

轨迹视图不仅是调试工具，更是医疗AI系统构建“可解释性”与“可信度”的关键组件，确保每一步智能决策都透明、可追溯，为医疗场景的安全落地提供坚实保障。06高级能力探索多智能体与自动化多智能体协作01子代理协同委派主智能体可动态创建子代理，将复杂医疗任务拆解为并行子任务，实现算力资源的高效分配与利用。02临时任务动态Fork针对突发性查询或瞬时计算需求，快速生成轻量化临时子代理，任务结束即刻销毁，避免资源冗余。03工作流自动化编排自定义多步骤协作逻辑，实现智能体间的任务流转与状态同步，适配复杂的医疗诊断与科研分析流程。04自主循环试错机制面对医疗数据的不确定性，智能体自主分析失败原因并动态调整策略，持续重试直至达成目标。基于DeepSeekHarness的插件化架构，多智能体系统实现了高度的模块化与灵活性。通过灵活的任务分发与流程编排，该架构为医疗场景提供了稳定、可扩展的智能计算能力，助力精准医疗诊断与科研创新。Headless无界面运行与生态兼容01无界面执行模式$dshrun<任务描述>无需启动WebUI，直接通过终端命令行调用核心功能，实现轻量化执行。自动化流水线集成无缝嵌入CI/CD流程，实现模型训练、推理任务的自动化触发与部署，提升研发效率。批量脚本处理编写Shell/Python脚本批量执行任务，高效适配大规模数据处理与分布式模型推理需求。无头环境部署完美支持服务器、容器等无图形界面环境运行，降低系统资源占用，适配云端与边缘部署。02广泛的生态兼容能力MCP工具服务器接入支持连接ModelControlPlane工具服务器，实现模型能力的统一调度、管理与分发，兼容行业标准的模型服务协议。ClaudeCode钩子兼容无缝对接ClaudeCode的钩子系统，支持代码解释器的事件触发与实时交互，大幅扩展AI编程的协作与自动化能力。PythonSDK开发支持提供完善的Python开发套件，支持开发者快速在AI应用、数据分析项目中集成DSH能力，赋能业务快速迭代。07插件生态扩展框架无限可能插件化架构01核心架构理念DSH采用极致的插件化设计，整套WebUI及核心功能均由模块化插件动态构建，打破了传统系统的刚性限制，实现了功能的按需插拔与灵活扩展。界面深度重构支持完全替换前端交互界面，适配医疗场景的专属视觉与操作习惯。功能模块扩展按需新增或替换业务工具，快速响应医疗业务的个性化需求变更。业务逻辑定制灵活改写审批流与权限规则，严格匹配医疗行业的合规与管理要求。交互模式创新支持新增智能会话模式，优化医护人员的沟通与协作效率。$dshplugin--profilewebadd<plugin-package-url>关键提示：

安装插件后，必须重启DSH服务才能使插件生效，确保系统配置被正确加载。插件安全警告高危权限风险插件拥有执行任意代码的底层权限，完全不受系统权限沙箱管控。若安装来源不明的恶意插件，可能导致数据泄露、系统篡改或隐私侵犯，需保持高度警惕。可信来源核验务必仅从官方插件市场或GitHub等正规开源平台安装。安装前仔细核查开发者资质、社区评分及安全审计记录，坚决拒绝非官方渠道分发的插件包。繁荣社区生态GitHub上的`dsh-plugin`主题已汇聚250+个社区贡献插件，覆盖开发、运维与界面定制等场景，由社区共同维护与审计，安全透明度高。热门社区插件示例侧边栏增强插件自定义侧边栏布局，集成快捷工具入口，优化工作台交互流程，提升操作效率。VSCode代码跳转无缝对接VSCode索引能力，实现跨文件、跨项目的符号快速跳转与定义追踪。@file智能引用解析项目路径，支持`@file`别名自动补全与一键跳转，简化复杂项目的引用管理。进阶：创造模式01核心能力在「创造模式」下，Agent具备自主编写、加载及调用插件的核心能力。它不再局限于预设的功能集，而是能够根据任务需求，动态生成并部署新的功能模块，突破传统AI的固定边界。02进化价值这一模式赋予Agent「自我进化」的底层逻辑，使其从被动执行指令转向主动适配环境。它意味着智能体能够持续更新自身能力，针对复杂的医疗场景、科研分析等需求，实现功能的快速迭代与优化。03场景示例指令示例：「为我安装一个医学数据可视化插件，并使用它将这份临床实验数据生成趋势分析图」。Agent将自动完成插件的编写、部署与调用，独立完成从数据处理到结果呈现的全流程。总结：

创造模式打破了AI的功能桎梏，让智能体具备了“成长性”与“自主性”，这不仅是技术的突破，更是医疗智能化迈向自主决策与持续进化的关键一步。08架构要点深入理解系统设计核心架构设计插件化内核驱动基于成熟的Cordis插件内核构建，支持插件的动态加载与热插拔，为系统提供稳定、灵活的运行底座，是实现高扩展性的核心基础。多层级配置体系采用Bundle、Profile、Patch多层覆盖机制，实现配置的动态调整与环境隔离，快速适配不同部署场景与业务个性化需求。极致的服务解耦设计严格实现服务定义、实现逻辑与调用方的完全解耦，模块间独立开发、测试与替换，有效降低系统耦合度，提升维护效率。图示：DeepSeekHarness插件化架构示意。通过去中心化的节点连接与模块化设计，实现功能组件的灵活组合，体现了架构的高内聚低耦合特性，保障了系统的稳定性与可扩展性。完整执行链路01用户消息触发用户输入自然语言指令，明确任务目标与需求，作为系统启动执行流程的初始触发点。02全域上下文组装自动聚合会话历史记录、工作区环境配置、预设长期规则及实时状态数据，构建完整决策背景。03大模型智能推理将整合后的上下文与用户指令发送至大模型，进行意图深度解析、策略规划与响应生成。04工具调用请求生成大模型基于推理结果，动态生成适配的工具调用请求，明确需执行的具体操作、参数与目标。05权限合规审批系统自动校验操作权限，对高危、敏感或越权指令触发人工复核机制，保障操作