DSH Plugins Marketplace

DSH Plugins

Plugins

/

ai-agent-engine-deepseek

a

ai-agent-engine-deepseek

Manifest valid★ 1

Engineering Skill Set for DeepSeek Harness

UI (client)hasBundlePatch

AI Agent Engine for DeepSeek Harness

让 DeepSeek Harness 按需组织前端、后端和测试工程师协作,并支持右键永久删除对话。

本项目参考 AI Agent Engine for Codex,将其七项工程技能适配为 DeepSeek Harness 原生插件。

功能介绍 · 安装 · 更新与回退 · 快速使用 · 常见问题 · 版本下载

功能介绍

功能可以做什么
多角色协作按任务需要创建前端、后端、需求分析和测试队友,支持并行工作与消息沟通;开启团队协作后由共享任务板跟踪进度
专业角色显示队友按“前端工程师”“后端工程师”等职责命名,Subagent 成员行显示职责描述,共享任务负责人显示中文职称
七项工程技能覆盖需求澄清、前后端开发、单元测试、集成测试和浏览器测试
永久删除对话从对话菜单删除主对话及其所属队友记录,同时清理对应的缓存和搜索索引
可配置工程角色本机 $DSH_HOME/ai-agent-engine/roles.json 覆盖/追加 Lead 策略;插件设置 settings.section「工程角色」 可可视化编辑 skill/responsibility 与自定义 id
一键更新插件设置 → 插件更新:读取官方发布渠道、比较版本、下载并交给宿主插件管理器就地安装;git 检出安装则走 fetch + --ff-only 合并后重建

简单任务可以由当前助手直接完成;需要分工时再组队。安装后可继续使用标准模式,也可以选择 AI Agent Engine 模式。

安装

环境要求

项目当前支持范围
插件版本0.2.10
DeepSeek Harness(允许加载)>=0.2.1-rc.5(只有下限)
Windows 官方源码宿主 + Chromium 隔离验证0.2.1-rc.5、0.2.2-rc.1
当前 Desktop 运行时隔离冒烟Windows 0.2.2-rc.3:宿主启动与 Chromium 插件状态页;未替换用户安装

其他版本和平台尚未完成实机验证。

宿主加载门禁只看 engines.dsh,本插件已改为只声明下限 >=0.2.1-rc.5: Harness 升到 0.2.2、1.0 等更高版本时不再因版本号被判不兼容而拒绝加载。 dsh.compatibility.verifiedThrough 记录最高实测宿主版本 0.2.2-rc.1;verifiedRuntimes 明确列出实际验证过的 0.2.1-rc.5 和 0.2.2-rc.1。未列出的版本会标注“未经实测”,不阻止加载,也不把两个实测点之间的所有版本当作已验证。 运行依赖与 peer 仍固定在 rc.5 的库窗口 >=0.2.1-rc.5 <0.2.2-0;这与宿主实测版本分开记录,本轮没有自动升级插件依赖。 基础加载协议、RPC 或模块导出发生破坏性变化时仍需更新插件;设置页的“插件状态”会指出具体哪一层不可用。 已发布的旧标签(v0.2.7 及更早)安装包里写死的仍是旧的兼容范围与旧行为, 要使用本次团队协作模式适配及 0.2.8 的预设/运行时修复,需安装 ai-agent-engine-deepseek-0.2.10.tgz 或更新构建, 不能靠重新安装原有固定标签获得。github:YaoGUanquan/ai-agent-engine-deepseek#v0.2.10 仅在该标签正式发布后可用。

自动兼容与降级

宿主升级到范围内的新版本时,不再因为版本号变化直接禁用整个插件。 工程协作、角色、永久删除和版本更新分别等待所需服务并检查接口,失败时只停用对应模块; 打开设置中的“插件状态”可查看宿主及界面各模块的可用状态。 基础加载协议、RPC 或模块导出发生破坏性变化时仍需更新插件。

永久删除只接受已知的 JSONL 后端和搜索索引结构。 能力检查在恢复删除日志、安装方法包装和删除数据前执行;不兼容时禁止删除。 插件保留 Desktop 代码,不自动添加版本豁免;更新只发生在你点击“立即更新”之后, 由宿主的插件管理器安装;失败时报告实际结果,检出更新会保留可重试的阶段和备份。

Windows Desktop 的内置 pnpm 路径缺失时,0.2.8 起会在所有者点击“立即更新”、新包校验通过后检查已知运行时布局。仅在目标运行时目录不存在、当前 Home 下已有元数据和必要文件可核对的官方运行时时,创建指向该运行时的目录映射;已有目录不会覆盖,正常环境不变。权限不足或运行时不完整时会提示修复 Desktop。映射会保留供宿主管理器后续使用,不复制或下载可执行文件,也不批准依赖构建脚本。

这项恢复逻辑需要新版插件已安装才能运行:旧版本已经因 pnpm 路径缺失而无法升级时,首次更新仍需先修复 Desktop 路径或安装完整 Desktop。0.2.8 同时移除了会遮蔽宿主标准预设的旧 dsh-agent-preset 运行依赖。

在 Desktop 中安装

  1. 打开 DeepSeek Harness,进入 插件,点击 添加插件。
  2. 在“包名或地址”中填写以下地址,点击 安装。
  3. 安装完成后点击 立即启用。
  4. 完全退出并重新打开 Desktop。
github:YaoGUanquan/ai-agent-engine-deepseek#v0.2.10

已经安装旧版时,按下文的更新步骤操作。

安装包已包含构建产物。普通用户无需安装 Node.js、执行脚本或构建源码,也无需替换 Desktop。

下载安装包

也可以打开 Releases,下载 ai-agent-engine-deepseek-0.2.10.tgz,在插件管理器的“包名或地址”中填写该文件的绝对路径,再安装、启用并重启。

每个 Release 都提供版本说明、兼容范围和 SHA256SUMS.txt 校验文件。普通用户选择 .tgz 插件包即可;GitHub 自动生成的 “Source code” 是源码归档,供开发者使用。

更新与回退

能直接在插件里点击更新吗?

可以。设置 → 插件更新 里有两个按钮:

  • 检查更新:读取官方发布渠道(GitHub Release),显示已安装版本、最新版本、当前 Harness 版本与兼容状态。
  • 立即更新:下载新版本并交给宿主的插件管理器就地安装,不需要先卸载旧版。

安装完成后必须完全退出并重新打开 Desktop(Windows 下包括托盘实例),新版本才会被加载。 按钮的判定规则:

情况结果
发布版本更高允许“立即更新”
已是最新只提示“当前已是最新发布版本”
宿主没有插件管理器按钮禁用,提示无法安装
新版本 engines.dsh 拒绝当前 Harness报告不兼容,不安装;先升级 Harness
包名、版本或包内清单与 Release 不符阻止安装,报告身份不匹配
缺少摘要、摘要无法唯一匹配安装包或字节不符校验失败,不安装
宿主安装失败、取消或被配置覆盖如实显示结果,不标记更新成功;可恢复的失败允许重试
依赖脚本等待批准显示脚本名称,由用户在宿主插件管理器处理,不自动批准
插件以 link: 检出方式安装固定上游目标,在隔离目录安装依赖、构建后再 merge --ff-only 和替换产物;有本地改动时拒绝执行

更新通道由安装方式决定:安装包(.tgz、github: 地址)走下载安装,link: 或本地 git 检出走上游合并。 dsh.compatibility.verifiedThrough 记录的版本是实测基线;Harness 更新后即使版本号超出该基线, 插件仍会加载,设置页标注“未经实测”,不会静默禁用。

安装地址中的 #v0.2.10 表示固定版本。重新启动 Desktop 本身不会自动变成未来的新版本; 自动更新只发生在你点击“立即更新”之后。

检出更新会把未完成的目标和阶段保存在该检出的 Git 元数据目录中。依赖安装、构建或产物替换失败后,设置页保留原因并允许继续剩余步骤;重启后也能读取待完成任务。准备过程不改变原有依赖和产物,替换前再次检查分支、HEAD 和本地改动。旧的依赖及产物目录保留为备份,不自动重置源码或删除用户未跟踪文件。依赖安装使用 --ignore-scripts,只显式执行插件构建脚本。

若快进合并已经完成、随后产物替换失败,HEAD 不会自动回退;此时磁盘上的源码、依赖和产物可能尚未全部切换。应先重试完成保留的更新任务,再重启 Desktop;这类失败不能视为旧版安装完全未变。

手动升级

不想用按钮时,仍可手动升级:

  1. 打开最新版本页面,查看更新内容和兼容的 Harness 版本。
  2. 等待相关任务结束,记录你自定义过的插件配置。
  3. 在 插件 页打开 ai-agent-engine-deepseek,点击 卸载。
  4. 点击 添加插件,填写新版本页面提供的安装地址。
  5. 安装并启用后,完全退出并重新打开 Desktop。Windows 下也要退出系统托盘中的后台实例,再核对版本和配置。

例如,从 0.2.1 升级到当前版本时填写:

github:YaoGUanquan/ai-agent-engine-deepseek#v0.2.10

卸载插件不会替你删除已有对话。更新期间也不需要移除 Harness 的会话目录、记忆或项目文件。

如何确认升级成功

  1. 在最新版本页面确认最新正式版本号。
  2. 安装完成时,核对“已安装”提示中的版本;设置 → 插件更新 顶部也显示“已安装版本”。
  3. 重启后,在 插件 页打开 ai-agent-engine-deepseek,核对版本、安装来源和启用状态。
  4. 打开原有对话,确认历史仍可查看;已有自定义配置也应重新核对。

插件版本 0.2.10 与 Harness 版本 0.2.1-rc.5 是两个不同的版本号。更新插件不会替你升级或替换 Desktop。

如果重启后仍显示旧版,请先确认卸载、安装操作发生在当前正在使用的 Desktop 中,再检查是否还有旧的后台实例。只下载 .tgz 或只打开 Release 页面不会更新已安装插件。

如何回退

先卸载当前插件,再用已发布的旧版本地址安装。例如回到 0.2.2:

github:YaoGUanquan/ai-agent-engine-deepseek#v0.2.2

启用后重启 Desktop。回退只切换插件版本,不会恢复已经永久删除的对话。

快速使用

让不同角色协作

进入你的项目,在标准模式或 AI Agent Engine 模式中直接描述任务。例如:

实现订单列表的筛选功能。请让前端工程师和后端工程师分工,
先确认接口和验收标准,完成后由测试工程师验证。

是否启用团队协作由根会话的 模型与推理等级 菜单控制。打开 启用智能体团队协作 后,宿主会提供共享任务工具,会话顶部的 Subagent 入口同时显示成员树和共享任务板;新会话默认关闭,关闭时不会创建共享任务。

开启后,助手会根据任务组织协作:队友用 subagent 创建并按职责命名,成员行显示职责描述,共享任务由任务板跟踪,任务负责人显示中文职称。关闭时仍可用普通子代理分派独立任务,但进度由主对话自己跟踪。

需要明确验证组队功能时,可以这样提问:

请实际创建后端工程师和前端工程师两个队友,
分别只回复 BACKEND_OK 和 FRONTEND_OK,不要读写项目文件。

协作使用当前会话的模型与权限。创建多个队友会增加模型调用和用量,请按任务需要使用。

使用某一项技能

也可以在对话中直接点名技能。例如:

使用 ae-grill,帮我澄清登录改造的需求和验收标准。
使用 ae-backend,排查重复提交导致的订单重复创建问题。
使用 ae-unit-test,为订单金额计算补充边界测试并执行。
技能适用场景
ae-grill澄清需求、方案和验收标准
ae-frontend开发或修复前端页面与交互
ae-backend开发后端服务、接口,排查根因
ae-unit-test编写和执行单元测试
ae-integration-test验证接口、认证、数据持久化等环节的配合
ae-e2e-test编写或执行浏览器端到端测试用例
ae-e2e-suite整理端到端测试基础设施、套件和持续集成

永久删除对话

  1. 在左侧对话列表中,右键目标对话,或打开该对话的“更多”菜单。
  2. 选择 永久删除。
  3. 核对确认框中的对话名称、关联队友数量和运行状态。
  4. 点击 永久删除;点击 取消则保留记录。

确认后会先停止相关任务,再删除主对话及其所属队友对话,并清理对应的工作区引用、缓存和搜索索引。

非 JSONL 持久化时删除入口不可用;损坏的删除记录会被隔离,不会导致插件无法启动。详见常见问题。

永久删除无法撤销。 项目文件和独立分叉对话会保留;独立分叉中已经复制的历史、外部备份也会保留。此操作仅允许当前 Harness 的所有者执行。

常见问题

安装后为什么需要重启?

插件需要从会话创建或恢复时接管它的生命周期。首次启用前已经打开的会话,需要重启后才能正常执行删除。

为什么没有出现多个队友?

安装后不会为每个任务自动创建固定数量的队友。简单任务可以由当前助手直接完成;需要分工时,请明确说明角色和任务。是否正确调用协作工具也取决于所用模型。

为什么旧会话仍显示原来的成员名称?

新工程队友使用专业角色名称。历史会话中没有明确职责的自定义名称会保留,插件不会猜测和改写。

删除后为什么目录里还可能有少量文件?

插件保留不含对话正文和标题的删除身份记录及锁文件,用于阻止已删除身份被重新打开,并在中断后继续清理。这不表示对话正文仍被保留。

非 JSONL 存储或删除记录损坏时会怎样?

永久删除依赖 JSONL 会话持久化。若宿主使用非 JSONL 后端,插件会关闭删除能力并继续加载工程技能;调用删除时返回不可用(delete-unsupported),不会拖垮整插件。

若 .ai-agent-engine/deletions/ 下某条删除记录的内容损坏,插件会将其改名为 *.json.corrupt 并写入日志,跳过该条后继续启动,其余有效记录照常恢复。临时读取失败、权限或设备 I/O 错误不会被当作内容损坏:原日志会保留,删除模块报告初始化失败,排除读取故障后重新加载插件可继续恢复。模块不可用期间不能依赖本插件提供删除墓碑保护。

改了角色(设置页或 roles.json),为什么旧队友没变?

约定:只影响之后新创建的队友。已 spawn 或冷恢复的实例不重绑提示词,路由名也保持创建时的值。设置页保存或 Host aeRoles 写回后会重建 Lead 策略,供新 spawn 使用。

如何恢复出厂工程角色?

在设置 「工程角色」 中点击「恢复默认」(会删除同一 overlay 文件);或手动删除/清空 $DSH_HOME/ai-agent-engine/roles.json(若配置了 rolesPath 则删对应文件);也可将 rolesEnabled 设为 false。不必为此卸载插件。正在进行的会话不应因清文件而崩溃;已 spawn 队友不重绑。

角色文件损坏或路径无效会怎样?

策略读取会打日志并退回内置种子,不应导致无法启动。编辑页采用严格读取:文件不可读、JSON 损坏或存在非法行时会显示错误并禁止保存,避免把故障误当空配置覆盖原文件。修好 JSON、修正 rolesPath 或排除读取错误后重新加载;暂时关闭 rolesEnabled 可让策略使用内置种子。

能在设置页里可视化编辑角色吗?

可以。打开宿主设置,在本插件的 settings.section「工程角色」 中编辑。可改 skill(技能)与 responsibility(职责),可添加自定义角色 id,可「恢复默认」。成员行显示派发时写入的职责描述,任务板负责人按角色 id 显示中文职称;本页只改角色策略,不改展示名。

也可以继续手改 $DSH_HOME/ai-agent-engine/roles.json(或 rolesPath);设置页与文件读写同一份 overlay。保存后 Lead 策略会重建,新创建的队友生效;已 spawn 队友不重绑。

页面成功读取角色目录和保存的 overlay 后才允许保存或恢复默认,保存期间锁定编辑,失败保留草稿。rolesEnabled 关闭时页面仍编辑保存的自定义配置,重新开启后继续使用;切换开关会刷新 Lead 策略。

多个对话一起用前端/后端队友会不会串角色?

目录解析和策略构建返回独立结果,并有并发解析、过期刷新及卸载回归;本轮隔离宿主还验证了同一团队的前后端队友并发。跨多个真实模型对话的完整回归仍未重新执行。已创建队友不会因为你改设置页或 roles.json 而重绑角色 brief。

会改变默认模式或数据目录吗?

已有默认模式保持不变。插件沿用 Harness 已配置的会话和数据目录。角色 overlay 默认落在 $DSH_HOME/ai-agent-engine/,不写入项目工作区。

当前版本验证过哪些功能?

当前源码通过 npm run check:all:Host/Client 类型检查、公开资源校验、27 个文件的 163 项测试及构建。本轮官方 rc.5 源码宿主/Chromium 完整隔离回归 10 项通过。当前 Desktop 内置 0.2.2-rc.3 运行时使用实际安装包与本机依赖覆盖配置对比验证:0.2.7 可复现预设列表为空和工程协作失败;独立安装 0.2.8、以及在 0.2.7 安装目录直接升级到 0.2.8 后,标准/工程预设均注册成功,四个模块的宿主与界面均可用。0.2.2-rc.1 的完整回归为此前 0.2.6 的历史记录;本轮未重新运行该版本。 0.2.9 对齐 Lead 协作策略与任务板职称展示,并以 8 项新增测试覆盖策略契约与投影映射;未在真实模型会话中重新启用“启用智能体团队协作”跑完整组队流程,不能把测试当作该层验收。

完整隔离回归使用合成会话和 MockAdapter,rc.3 仅验证启动和状态页;本轮没有调用付费模型、删除既有用户历史或更新当前 Desktop 安装。真实模型与原版 Desktop 的历史验收证据保留在验收记录中;其他平台、任意模型及完整多对话真实模型回归仍未重新验证。

详细环境、检查结果和未验证范围见验收记录。

开发

以下步骤仅面向修改源码的开发者,普通安装无需执行。

要求 Node.js 24+:

npm ci
npm run check:all
npm pack

构建后可在 Desktop 插件管理器中安装生成的 ai-agent-engine-deepseek-0.2.10.tgz。提交源码变更时应同步构建产物 lib/,保证 Git 地址安装可直接使用。

使用未修改的官方 Harness dsh-v0.2.1-rc.5 或 dsh-v0.2.2-rc.1 源码完成其声明的依赖安装和完整构建后运行集成验收。入口检查 engines.dsh 下限,版本门禁放行不等于运行验证;生成目录和截图可通过 AE_HARNESS_TEST_DIR、AE_HARNESS_OUTPUT_ROOT 外置:

node tools/harness-integration.mjs "<official-harness-source-directory>"

插件遵循官方开发文档。开发时可参考生命周期说明。

插件配置

配置位于 cordis.patch.yml:

配置默认值作用
engineeringtrue启用工程技能、协作策略和可选工程模式
conversationManagementtrue显示永久删除菜单和确认框
maxMembers8本插件创建团队服务时允许的队友数量上限
rolesEnabledtrue是否读取用户角色覆盖文件并合并进 Lead 策略
rolesPath空可选绝对路径;空则使用 $DSH_HOME/ai-agent-engine/roles.json

已启用官方团队插件时,会复用它的服务和人数限制。conversationManagement 与 rolesEnabled 支持实时切换;其他配置修改后需要重新加载插件。请保留 ai-agent-engine 配置项的标识。

自定义子智能体角色(设置页 + 文件)

可用本机用户态 overlay覆盖或追加工程队友在 Lead 协作策略中的职责说明与技能映射,无需改插件包或源码。

可视化设置(推荐)
  1. 打开宿主设置。
  2. 进入本插件的 settings.section「工程角色」(locales:roles.section)。
  3. 编辑内置或自定义角色的 技能(skill) 与 职责(responsibility);可添加自定义角色 id;点击「保存覆盖」。
  4. 「恢复默认」会 unlink/删除 同一 overlay 文件,新队友回到出厂种子。

Host 通过 aeRoles(getCatalog / getOverlay / putOverlay / restoreDefaults)读写;非法 payload 拒绝写入(fail-closed)。写成功后发出 ai-agent-engine/roles-updated,重建 Lead 策略。已 spawn / 冷恢复队友不重绑;仅新 spawn使用合并结果。

文件与 Config(仍可用)
  • 默认路径:$DSH_HOME/ai-agent-engine/roles.json($DSH_HOME 为 Harness 用户数据根)
  • 可选路径:配置 rolesPath 为绝对路径(修改后需重新加载插件;rolesEnabled 为 volatile,可实时开关)
  • 不要把角色文件放进工作区 .ai-agent-engine/(该目录仍仅用于删除记录 journal)
  • 可覆盖字段:仅 skill、responsibility(按角色 id)。成员行显示派发时写入的职责描述,任务板负责人按角色 id 显示中文职称;本页/文件不改 UI 展示名
  • 合并:按 id 深合并到包内 builtin 种子;只覆盖文件中出现的字段;未知 id 追加。插件升级后,内置文案随包刷新,未在 overlay 中出现的字段跟随新种子
  • 多对话:并发目录解析和策略刷新有回归;完整多对话真实模型用例尚未重新验证,不能把单元测试或同团队并发等同于该层验收

示例(与设置页保存格式一致):

{
  "version": 1,
  "roles": [
    { "id": "frontend", "responsibility": "Custom frontend brief." },
    { "id": "security", "skill": "ae-grill", "responsibility": "Threat model reviews." }
  ]
}

version 必须为 1。JSON 损坏、非法条目或无效路径时读侧记日志并回退内置表,不拖垮插件启动;写侧校验失败则不落盘。overlay 不会打进安装包或你的 git 仓库,也不会污染 deletions journal。

仓库结构

src/              插件源码
lib/              随版本提供的构建产物
skills/           七项工程技能及参考资源
prompts/          协作提示词
tests/            单元测试
tools/            构建、校验与集成测试工具
compat/harness/   验收记录、上游许可与历史兼容资料

0.1.x 的历史宿主补丁仅用于复现,不包含在当前安装包中。版本变化见 CHANGELOG.md。

问题反馈

请通过 GitHub Issues反馈问题,并提供插件版本、Harness 版本、操作系统、复现步骤和预期结果。日志或截图中请隐藏密钥与私人对话。

许可证与致谢

本项目使用 GPL-2.0-only,完整许可证见 LICENSE。

工程技能直接参考并适配自 AI Agent Engine for Codex。运行时基于 DeepSeek Harness 的原生插件和团队协作能力。

详细来源、固定参考版本和第三方许可证见 NOTICE.md。本项目为社区适配项目。

Comments

Loading…