DeepSeek Harness 最近受到不少开发者关注。作为 DeepSeek 推出的开源 Agent 框架，它不仅能与大模型对话，还能使用工具、处理工作区文件，并通过 Skill 扩展能力。
但如果想让 Agent 帮忙写行业报告、整理学习资料，一个问题很快就会出现：AI不知道你以前看过哪些视频、听过哪些播客，也不知道那些PDF报告放在哪里。 每次重新上传文件、复制摘要，效率依然不高。
解决思路是先用 Ai好记 把视频、播客、PDF等内容整理成可搜索的笔记，再通过 Ai好记Skill 让兼容的 Agent 按需检索、读取这些资料，把它们作为当前任务的上下文。
这篇教程按照 准备知识库 → 启动 DeepSeek Harness → 安装 Skill → 配置授权 → 检索笔记并生成报告 的顺序，讲清楚每一步怎么做，以及如何判断是否真的连接成功。
一、DeepSeek Harness是什么？为什么要给它连接知识库？
DeepSeek Harness（简称 dsh）是 DeepSeek 开源的 Agent Harness 框架，采用可组合的插件架构，用来协调模型、工具、工作区和任务执行。它与普通聊天窗口的区别，是能够在合适的权限下执行实际操作，而不只是生成回答。
比如，你可以让 Agent 阅读已有文件、梳理调研资料、生成报告大纲，或者调用外部技能检索其他系统中的内容。官方资料可以查看 DeepSeek Harness GitHub 和 使用指南。
Skill与Harness插件并不是同一种东西。 Harness插件用于扩展运行系统本身；Agent Skill则是一组帮助Agent使用特定能力的指令与工具说明。Ai好记提供的是后者，作用是让Agent访问用户授权的外部个人知识库，而不是把所有笔记直接写进模型记忆。
例如你要写《AI Agent企业应用趋势报告》，可以先让Agent从Ai好记知识库里搜索相关访谈、技术课程和PDF研究报告，再根据实际检索到的资料形成提纲。这样比单纯让AI凭通用知识写作，更容易核对来源，也能复用自己长期积累的内容。
二、安装Skill之前：先把视频、播客和PDF整理成笔记
Ai好记Skill目前主要负责查找、读取、导出和整理已经存在的笔记。因此，新视频或PDF要先在Ai好记里完成解析，不能把安装Skill理解为“让Harness直接转写任何视频”。
1. 视频和播客：从链接到结构化笔记
打开 Ai好记官网，创建笔记。对于支持的平台，可以直接粘贴B站、抖音、小红书、小宇宙、喜马拉雅等音视频链接；也可以上传本地音视频、会议录音，或导入网盘中的课程文件。
Ai好记会把音视频转成带时间戳的逐字稿，并生成精华速览、结构化总结、文字大纲和思维导图。对于包含PPT、图表或软件操作的视频，还能提取关键画面，和对应讲解一起整理成图文笔记。
例如把一条RAG技术课程保存进知识库，以后就能让Agent搜索“向量数据库”“知识检索”等关键词，找到实际课程笔记，而不是只得到大模型自己的概括。
2. PDF、Word和PPT：保留原文，再提炼重点
在创建页面选择「文档」，上传PDF、Word、PPT、Markdown或图片。Ai好记可以提取内容、生成AI总结和思维导图，并保留原文方便核对。
比如一份行业报告，建议同时保留AI总结和原始文档。以后Agent提取数据和结论时，还可以继续回查，而不是只能依赖一段简短摘要。
详细操作可参考：《如何用AI整理文档信息？PDF、Word、PPT一键提炼重点》。
3. 建立笔记本：让Agent更容易找到资料
如果准备研究AI Agent，可以建立「AI Agent研究」笔记本，把技术分享、播客访谈和PDF报告放在同一个主题下；其他资料则按项目或课程分类。
这样后续就可以直接让Agent“查找AI Agent研究笔记本里的相关资料”，而不是反复提供文件名和链接。想了解完整的知识库搭建流程，也可以阅读 《AI知识库怎么搭？5步整理视频、播客和PDF》。
三、DeepSeek Harness怎么安装和启动？
第1步：下载桌面端，或启动Web UI
新手可以从 DeepSeek Harness官网 选择与电脑系统对应的桌面端；如果习惯使用命令行，先安装Node.js，再运行官方提供的命令：
npx @deepseek-ai/dsh web
默认的本地Web UI地址是 http://127.0.0.1:3080，以终端实际输出为准。Harness目前仍处于开发者预览阶段，具体界面和兼容性可能随着版本调整。
第2步：配置模型并选择工作区
按照 Harness官方Web UI教程，进入「设置 → 模型」，配置可用的模型提供方及模型API Key；再选择一个工作区，建立新会话。
注意两个Key的区别： Harness里的模型API Key用于运行AI模型；后面配置的Ai好记API Key用于授权访问笔记，两者不是同一把密钥。
四、在DeepSeek Harness里安装Ai好记Skill
第1步：输入官方安装提示词
打开 Ai好记Skill技能中心，可以看到「一键复制安装提示词」入口。进入DeepSeek Harness的新会话，将提示词粘贴到输入框：
请安装 Ai好记 技能，帮我查找、阅读、创建、导出和整理笔记，并管理笔记本。
使用：npx skills add AiHaoJi-Agent/aihaoji-skills -g 来进行安装
这张截图展示的是安装指令已输入、尚未执行。发送后，Agent会尝试运行对应命令；涉及终端命令或文件改动时，可能需要你按照当前权限设置确认。不要仅凭输入框里出现文字就认为安装完成。
如果要自己在终端安装，也可以直接运行Ai好记官方GitHub README提供的命令：
npx skills add AiHaoJi-Agent/aihaoji-skills -g
对应项目：Ai好记Skill官方GitHub仓库。-g 表示用户级安装。
第2步：检查Harness是否识别到Skill
DeepSeek Harness能够从项目级 .dsh/skills、.agents/skills 和用户级Agent Skill目录查找技能；详细的发现顺序以 Harness Skills官方文档 为准。
Ai好记Skill官方仓库目前以用户级 ~/.agents/skills/aihaoji 为主要安装目录。可以先检查 SKILL.md 是否存在，再询问Harness：
请检查当前会话是否加载了Ai好记Skill。告诉我实际识别到的技能名称及来源目录，不要猜测，也不要先修改我的笔记。
如果目录存在，但当前会话没有识别到，可以重新建立会话，并检查工作区和Skill加载位置。Harness支持Skill不等于Ai好记Skill已经在每个版本上完成兼容实测，因此应以自己设备上的实际调用结果为准。
第3步：获取并配置Ai好记API Key
前往 Ai好记Skill页面 获取开放平台API Key，按照Skill的授权说明完成配置。首次查询时，如果尚未配置密钥，兼容的Agent通常会给出相关提示。
Ai好记Skill官方项目提供了共享配置和环境变量等方式。密钥不要放进公开截图、代码仓库或博客正文。首次授权建议只开放必要的读取权限，创建、移动或删除笔记时再单独确认操作。
第4步：用真实笔记验证连接
完成安装和授权后，在Harness中输入：
请使用Ai好记Skill读取我的笔记本列表，并列出最近5篇笔记的真实标题。只允许使用Ai好记开放平台返回的结果；如果无法访问，请告诉我具体错误，不要编造标题。
判断是否成功，要看实际返回： 是否调用了Ai好记相关能力、返回的笔记本和标题是否与你的账号一致。如果出现未识别Skill、认证失败或权限不足，先修复连接，再尝试复杂任务。
五、怎么让Agent真正用上视频、播客和PDF知识？
建议先从小任务验证，再逐步尝试跨笔记研究和报告生成。以下提示词可直接复制使用，但结果取决于你知识库中真实存在的资料。
场景1：检索B站课程，定位讲过的知识点
请调用Ai好记Skill，在我的笔记中搜索“RAG”“向量数据库”和“知识检索”相关的B站课程。先列出真实笔记标题，再读取最相关一篇的精华速览和文字大纲。请说明课程如何解释RAG的工作流程，并附上相关笔记来源；没有检索到的内容不要自行补充。
这时Agent使用的是你之前整理的课程，而不只是大模型的通用知识。需要核对公式、代码或讲解细节时，还可以让它继续读取原文。
场景2：对比播客访谈与PDF行业报告
请使用Ai好记Skill搜索我保存的AI Agent行业访谈播客及相关PDF报告。分别提取其中关于企业应用、成本、安全性和未来趋势的观点，整理成对比表。请保留各篇资料的标题，观点有冲突时分别列出，不要自行合并。
如果暂时不使用Harness，也可以直接在Ai好记中通过跨笔记AI助理选择多个笔记或笔记本，让AI联合检索、对比和问答。
场景3：让Agent根据知识库生成调研报告
这也是“知识库作为Agent上下文”最实用的场景之一。
请通过Ai好记Skill查找「AI Agent研究」笔记本中与企业应用、Agent工作流、知识库有关的资料。
- 先列出找到的真实笔记标题和资料类型。
- 读取相关笔记的总结与文字大纲，对关键数据继续查阅原文。
- 整理不同资料的共同观点、分歧和待核查问题。
- 生成《AI Agent企业应用趋势》报告大纲，每个关键观点注明参考笔记来源。
- 不要编造资料中没有的数据或案例。
它对应的工作流是：
检索知识库 → 阅读相关笔记 → 提取任务上下文 → 对比观点 → 生成报告大纲 → 人工核对出处。
这里需要明确：Ai好记Skill负责提供已有笔记，是否能进一步生成Word、PPT等文件，取决于Harness启用的工具和权限。以上是可复现的操作示例，不是已经完成的Harness调用实测结果。
六、常见问题：安装成功了却用不了怎么办？
1. DeepSeek Harness里找不到Ai好记Skill怎么办？
先确认 npx skills add AiHaoJi-Agent/aihaoji-skills -g 是否实际执行成功、用户级目录中是否存在 aihaoji/SKILL.md，再对照Harness官方文档检查Skill发现目录，并重新打开会话测试。
2. 连接时报401、403或权限不足怎么办？
检查Ai好记API Key是否有效，以及授权是否包含必要的笔记读取权限。模型API Key与Ai好记API Key不能互相替代。不要让Agent在接口失败时凭空生成笔记内容。
3. Ai好记Skill能直接把一个新视频转成文字吗？
目前Skill主要用于访问和管理已有笔记。B站视频、播客或PDF需要先通过Ai好记解析和总结，保存到知识库后，再由Agent检索和读取。
4. 连接知识库后，Agent是不是就拥有长期记忆了？
不是。知识库是可按需访问的外部资料来源；Agent需要时检索并读取相关内容，作为当前任务的上下文。这不等于把全部笔记自动写进模型的永久记忆。
5. 不使用DeepSeek Harness，还能安装Ai好记Skill吗？
可以。官方仓库提供了Codex、OpenClaw、Claude Code和Hermes Agent等兼容宿主的说明。使用腾讯WorkBuddy的读者也可以参考 《WorkBuddy怎么用？搭配Ai好记Skill，从视频总结到高效AI知识库管理》。具体安装方式和兼容性应以对应平台版本为准。
总结：让Agent按需调用你积累的知识
DeepSeek Harness提供了Agent的运行环境，而真正有价值的任务上下文，很多时候来自你已经看过的视频、听过的播客和整理过的PDF。
用 Ai好记 先把这些资料转成逐字稿、图文笔记、思维导图和结构化总结，再通过 Ai好记Skill 让兼容的Agent查找、读取和导出笔记，就能把过去积累的知识重新用于学习、调研和内容创作。
关键不是让AI一次读完所有资料，而是需要时能找到、读懂，并且回查来源。