前言¶
在 DeepSeek Harness(DSH)里做复杂任务时,很多人会把 Google Antigravity 风格的智能体定义放在 .agents/agents/ 目录,用 Markdown 描述协调者与子智能体分工。若要在 DSH 会话里直接选用这些人格,常见做法是手工复制说明、或改文件格式以便框架识别。dsh-plugin-antigravity-agents 的定位是:在不改写既有 Antigravity 安装的前提下,发现、分类并执行这些规范,并把协调者选择与委派接到 DSH 的 Web UI 和工具链上。
这是什么¶
dsh-plugin-antigravity-agents 是面向 DeepSeek Harness 的插件,由 Domush(Phillip Webber)维护,在 npm 上发布,当前资料中的版本为 1.0.4,许可证为 MIT。插件在社区目录中归类为「工作流」。
它解决的核心问题是:把 Google Antigravity agent personas 接入 DSH 的加载、协调者切换与子智能体编排,同时保持磁盘上的 .agents/agents/*.agent.md 只读;运行时偏好(默认协调者、禁用列表)写入 .agents/agents/settings.json。
智能体定义的发现路径包括:
- 项目级:工作区下的
.agents/agents/ - 用户全局:
~/.agents/agents/
解析 frontmatter 中的 name、description、mainAgent、subagent、model、tools,并保留正文中的 Markdown 指令块。
核心功能¶
协调者与子智能体分类¶
插件自动把已发现的智能体分为 Main Agents(主会话协调者)和 Subagents(按领域委派的专家)。
会话中的智能体选择器¶
在对话撰写工具栏和新会话界面中提供交互式下拉菜单,可在标准 DSH 提示与指定 Antigravity 协调者之间切换。
默认协调者与 Web 设置页¶
在 DeepSeek Harness 设置页的 Agents 区域可以:
- 选择默认协调者(新建会话时自动预选)。
- 查看已发现智能体列表(角色徽章、模型标签、悬停完整描述)。
- 对单个智能体启用或禁用。
子智能体委派与系统提示注入¶
主智能体可通过 invoke_subagent,或 DSH 原生的 subagent、spawn_teammate 委派子智能体;目标子智能体的说明与角色约定会注入到被拉起智能体的 system prompt。
antigravity_agent 工具¶
用于查看与列举 Antigravity 智能体及其角色、模型与能力,例如:
antigravity_agent(action: "list")
antigravity_agent(action: "read", name: "vogel-auditor")
(read 中的 name 需替换为你环境中存在的智能体名称。)
其它行为要点(资料中明确说明)¶
- 与既有 Antigravity 安装兼容:无需转换或改动 agent 文件。
- 零磁盘变异:
*.agent.md严格只读;状态集中在settings.json。 - 配置项
injectInSystemPrompt为true时,会把当前活动智能体指令注入系统提示。
安装与启用¶
社区插件通过 DSH 的插件机制安装;也可在 SkillHub 目录页 查看条目,源码与说明见 GitHub 仓库。以下安装方式均来自仓库 README。
在 Web UI 中安装(无需命令行)¶
- 打开 DeepSeek Harness Web UI,进入 Settings → Plugins。
- 点击 Add Plugin。
- 填入插件包名:
dsh-plugin-antigravity-agents
- 点击 Install,插件从 NPM 拉取并立即激活。
通过 CLI 安装¶
在终端执行:
dsh plugin install dsh-plugin-antigravity-agents
通过 Profile 的 package.json¶
在 Harness profile 的依赖中声明插件,并加入 bundles(资料中的示例使用 ^1.0.0,实际安装时以你需要的版本范围为准):
{
"dependencies": {
"dsh-plugin-antigravity-agents": "^1.0.0"
},
"dsh": {
"profile": {
"bundles": [
"dsh-plugin-antigravity-agents"
]
}
}
}
配置¶
在 profile 的 cordis.patch.yml 中可插入如下片段(与仓库示例一致):
- insert:
- id: antigravity-agents
name: 'dsh-plugin-antigravity-agents'
config:
enabled: true
agentsDir: '.agents/agents'
injectInSystemPrompt: true
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
enabled |
boolean |
true |
Antigravity 支持总开关。 |
agentsDir |
string |
".agents/agents" |
相对于工作区的 agents 目录路径。 |
injectInSystemPrompt |
boolean |
true |
是否将活动智能体指令注入系统提示。 |
若你的 agent 文件不在默认相对路径,只需调整 agentsDir,并保证该目录下存在符合 Antigravity 约定的 .agent.md 文件。
典型用法¶
- 准备智能体文件:在项目或用户目录的
agents路径下放置 Antigravity 格式的*.agent.md(无需为 DSH 单独改写格式)。 - 安装并启用插件:按上一节任选一种方式安装;在设置页 Agents 中确认列表中出现预期智能体,必要时设置默认协调者或禁用不需要的条目。
- 新建或切换会话:在 composer 工具栏的下拉菜单中选择协调者,开始对话;需要领域分解时,由主智能体通过委派机制拉起 subagent。
- 在会话内自检:调用
antigravity_agent(action: "list")核对当前可见智能体;对单个智能体使用antigravity_agent(action: "read", name: "...")查看详情。
经过上述步骤,DSH 会话即可在不大改仓库的前提下复用既有 Antigravity 资产。
适用场景与注意¶
适合谁:已经在使用或计划使用 Google Antigravity 风格 agent 定义的 DSH 用户;需要在同一 Harness 环境里做协调者切换、默认人格和子智能体编排的团队。
权限与安全:插件与当前 DSH 进程权限相同,会读取工作区与用户目录下的 agent 定义。安装前建议阅读 仓库源码 与 MIT 许可证,确认符合你的合规要求。社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态奉行「一切皆插件」,本文不构成官方背书。
依赖前提:需要已部署可用的 DeepSeek Harness,且 agent 文件布局与 Antigravity 约定一致;子智能体名称与 frontmatter 需与文件内容一致,否则列表与 read 可能对不上。
结尾¶
dsh-plugin-antigravity-agents 把 Antigravity 的协调者/子智能体模型接到 DSH 的 UI、设置页与委派链路上,并强调对既有安装只读兼容。若你要在 Harness 里直接用 .agents/agents/ 里的人格定义,可从目录页或 GitHub 查看说明后按 README 安装。
- 目录页:https://www.skillhub.cn/plugins/Domush/dsh-plugin-antigravity-agents
- GitHub:https://github.com/Domush/dsh-plugin-antigravity-agents