(完整版.pdf ) 以下仅展示部分内容
初次使用AI Agent,用户往往只关注最终的回答文本。然而在实际工作流中,资料来源、工具执行状态、文件存储路径、错误恢复机制以及会话经验的复用等问题,决定了AI交付的是临时文字还是可复用的成果。
近期发布的《从零开始玩转DeepSeek Harness——面向普通用户的Agent实践指南》(以下简称“指南”)共15章、两百余页,从安装部署到实战演练再到源码解析,系统阐述了DeepSeek Harness(简称dsh)的应用逻辑。这不仅是一本操作手册,更是一份关于“AI如何真正落地工作”的实践地图。
为什么需要Harness框架?
以深度调研报告为例,交付物不仅是一段文字,更包括问题拆解、计划制定、资料检索、来源核对及文件归档。若直接使用聊天模型,虽能快速生成文本,但难以追溯数据来源、验证结论依据或保留中间过程。
大模型擅长推理与生成,但搜索网页、运行命令、读写文件等操作需依赖外部工具。任务执行形成一条行动链:模型提出检索词→工具返回结果→模型分析并决定下一步。Harness的作用在于将任务要求、工具结果和交付物整合在同一进程中,使模型处于持续变化的工作环境中,能够根据执行结果修正路线,实现任务的连贯性与可核查性。
dsh的插件化架构设计
dsh是一套本地运行的开源Agent Harness,支持模型接入、工作区管理及工具调用。其核心设计理念是“一切皆插件”,包括模型适配器、工具注册表、会话日志、沙箱及AgentLoop均通过插件接入Cordis运行时。
为解决插件卸载后的资源残留问题,Cordis引入了带清理动作的effect机制。插件在注册监听器、提示词或服务时,需同时提供对应的disposer。此外,运行时通过稳定的ctx.key管理依赖关系,确保服务就绪前组件等待,服务不可用时相关组件自动停用,从而实现时间与空间上的可组合性。
从任务执行到自进化能力
指南通过多个真实案例展示了dsh的应用场景:
调研任务:主代理拆解任务并启动子代理并行调研,主会话负责核验材料冲突与适用范围,最终生成决策报告。
日常办公:集成Excel、Word、PPT Skill处理数据整理、报告撰写及演示文稿生成,并结合视觉模型检查排版,批量处理PDF文档。
飞书数字秘书:连接飞书API,实现文档要点整理、任务创建、日程管理及审批流程自动化。
活动海报设计:通过Design插件实现设计视图实时渲染,支持从简报整理到画布元素精调的全流程操作。
短剧制作:利用drama-skills完成剧本编写、分镜设计及视频生成,最终拼接成成片。
求职辅助:多子Agent协作进行岗位调研、简历优化及模拟面试,提升求职效率。
市场投研:基于历史数据回测策略,生成包含K线图、资金流向及板块对照的个股分析报告。
代码审查:组建多人审查团队并行读取Git历史,汇总形成可追溯的升级决策报告。
这些案例共同揭示了一个逻辑:不仅关注Agent的输出,更要关注其调用过程、遗留产物及依据来源。
指南还介绍了自进化实验:dsh通过读取Skill、生成概念图、评测评分并反馈修改规则,经过多轮迭代优化Skill。这表明Prompt、Skill、工具及Harness结构均可作为自进化的对象。
系统内核解析:Harness与Cordis
任务生命周期:Harness组装上下文(用户要求、历史、工具描述),模型决定直接回答或调用工具。Harness校验并执行工具调用,将结果或错误反馈给模型,形成闭环。失败也是有效反馈,有助于模型修正策略。
会话与消息管理:dsh区分持久事实与运行状态。会话事件可回放,实时事件用于界面交互。针对长会话,Harness采用三层上下文管理策略:溢出文件保存大型输出、裁剪早期大型结果、摘要替换早期历史,既控制Token消耗又保留原始记录。
工具调用与权限:工具调用需经过权限规则和hook检查,不同工具受各自沙箱约束。模型不自动获得全部资源权限,确保执行安全。
Cordis运行时:作为插件组织者,Cordis通过Plugin、Fiber和Context管理组件生命周期。利用Service、inject、Event和Effect机制,协调模型、工具、会话及AgentLoop之间的交互。
指南核心价值
该文档的价值在于超越基础操作,深入探讨Agent的可核查性与协作逻辑。它强调多Agent协作中的文件隔离与核验机制,插件化架构中的资源清理与依赖管理,以及自进化过程中的标准一致性。
核心观点:AI不仅要完成任务,更需确保过程经得起回溯。无论是初学者还是开发者,均可从中获得关于Agent架构、扩展点及运行机制的深刻洞察。
资料下载方式
Download method of report materials
点击下面文字链接下载:
PrismShadow 团队:从零开始玩转DeepSeek Harness-面向普通用户的Agent实践指南
-
荐: 【中国风动漫】《姜子牙》刷屏背后,藏着中国动画100年内幕! 【中国风动漫】除了《哪吒》,这些良心国产动画也应该被更多人知道!
【中国风动漫】《雾山五行》大火,却很少人知道它的前身《岁城璃心》一个拿着十米大刀的男主夭折!
如需获取更多报告
报告部分截图
编辑:Zero
文末福利
1.赠送800G人工智能资源。
获取方式:关注本公众号,回复“人工智能”。
2.「超级公开课NVIDIA专场」免费下载
获取方式:关注本公众号,回复“公开课”。
3.免费微信交流群:
人工智能行业研究报告分享群、
人工智能知识分享群、
智能机器人交流论坛、
人工智能厂家交流群、
AI产业链服务交流群、
STEAM创客教育交流群、
人工智能技术论坛、
人工智能未来发展论坛、
AI企业家交流俱乐部
雄安企业家交流俱乐部
细分领域交流群:
【智能家居系统论坛】【智慧城市系统论坛】【智能医疗养老论坛】【自动驾驶产业论坛】【智慧金融交流论坛】【智慧农业交流论坛】【无人飞行器产业论坛】【人工智能大数据论坛】【人工智能※区块链论坛】【人工智能&物联网论坛】【青少年教育机器人论坛】【人工智能智能制造论坛】【AI/AR/VR/MR畅享畅聊】【机械自动化交流论坛】【工业互联网交流论坛】
入群方式:关注本公众号,回复“入群”
-
戳“阅读原文”下载报告。

