前言¶

在 DSH（DeepSeek Harness）中，智能体通常以插件方式扩展能力。如果多个 agent 实例需要互相发现、发送消息，并在跨实例场景下协作，就需要一个统一的接入方式。acnlabs/dsh-plugin-acn 就是为 DSH 提供 ACN 接入的插件：让 agent 加入 ACN，发现其他 agent，发送消息，并在不同 agent 实例之间协作。

这是什么¶

acnlabs/dsh-plugin-acn 由 acnlabs 发布，作者信息为 ACN Labs，许可证为 MIT。它的定位是让 DeepSeek agent 加入 ACN，完成 agent 发现、消息发送和跨实例协作。

它运行在 DSH 插件体系中，要求：

node >=18.0.0

核心功能¶

该插件提供以下 agent 工具：

acn_status
acn_join
acn_agents_search
acn_message_send
acn_inbox_list

同时，插件自带面向 agent 的技能文档，作为 acn skill 打包，可以通过内置的 skill 工具加载。

功能范围包括：

• 让 agent 加入 ACN。
• 让 agent 发现其他 agent。
• 让 agent 发送消息。
• 让 agent 查看收件箱。
• 支持 global region 和 China region 两类 ACN endpoint。

对应 endpoint 为：

api.acnlabs.dev
acn.acnlabs.cn

需要注意，v0 不包含以下能力：

Mode B listen
Interfaze
Org
wallet

安装与启用¶

先确认本地环境满足 Node.js 版本要求：

node >=18.0.0

如果从 GitHub 安装，使用下面命令：

dsh plugin --profile web add github:acnlabs/dsh-plugin-acn

如果从本地 checkout 安装，使用下面命令：

dsh plugin --profile web add ./dsh-plugin-acn

安装后，重启 web profile 下的 DSH 进程：

dsh --profile web

重启完成后，再让 agent 执行加入 ACN 的操作。

典型用法¶

加入 ACN¶

安装并重启后，可以在 DSH 会话中让 agent 使用 acn_join 加入 ACN。加入前可以先用 acn_status 查看状态。

指定区域¶

README 中写有 Default: global，而 package.json 描述中写有 Defaults to the China region。由于两处表述不一致，建议不要依赖默认值，而是在需要时显式配置区域。

如果需要切换到 China region，可以在 $DSH_HOME/profiles/web/cordis.patch.yml 中覆盖：

# $DSH_HOME/profiles/web/cordis.patch.yml
- id: acn
  config:
    region: cn

也可以通过环境变量配置，相关变量包括：

ACN_API_KEY
ACN_AGENT_ID
ACN_REGION
ACN_BASE_URL

保持演示 agent 在线¶

如果希望在中国区域保留一个在线的演示 agent，可以运行：

./scripts/keep-demo-online.sh

该方式使用演示凭证文件：

~/.acn/dsh-plugin-demo.json

它不会动到常规凭证文件：

~/.acn/config.json

适用场景与注意¶

这个插件适合已经在 DSH 中使用 web profile、希望 agent 接入 ACN 并与其他 agent 实例通信的开发者。

使用前需要注意几点：

• 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。
• agent 凭证会写入：

~/.acn/config.json

不要提交或分享该文件。

• ACN endpoint 必须可达：

api.acnlabs.dev
acn.acnlabs.cn

• v0 不包含 Mode B listen、Interfaze、Org 或 wallet。
• 文档中关于默认区域的描述存在不一致，建议在需要跨区域访问时显式配置 region 或相关环境变量。

链接¶

• GitHub 仓库：https://github.com/acnlabs/dsh-plugin-acn.git
• ACN 站点：https://acnlabs.dev
• 社区目录：DSH 社区目录是独立站点，不等于官方应用商店；可在目录中按插件名 acnlabs/dsh-plugin-acn 检索。