# @ai-wendao/ant 中文文档

规范地址：https://npmcn.com/package/%40ai-wendao/ant/

版本：0\.6\.3
npm 元数据更新时间：2026-11-07T19:21:39.827Z
中文译文更新时间：2026-11-07T19:22:17.982Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ai-wendao/ant
原文对照：https://npmcn.com/package/%40ai-wendao/ant/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.2 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/dsh-app-boot \>=0\.2\.1-rc\.3
- 首次发布：2026-10-11T08:09:45.379Z
- 最新版本发布：2026-11-07T19:21:39.682Z
- 近 30 天下载量：6006（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

ANT(AI-native Teams)将DeepSeek Harness桌面配置与团队身份和被批准的模型相接.

## 安装

```sh
npm install @ai-wendao/ant
```

也可以使用：`pnpm add @ai-wendao/ant`、`yarn add @ai-wendao/ant`、`bun add @ai-wendao/ant`

## README

# ANT for DeepSeek Harness

ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's membership and approved models.

## 安装包与更新通道

ANT 同一份源码可发布为 `@ai-wendao/ant` 和 `dsh-ant`，DSH 添加插件时直接输入其中一个包名。两者连接同一 ANT 服务并使用相同业务协议；同一 DSH profile 只安装并启用其中一份，不同时启用两个包，也不使用 npm alias。选择新包不代表自动迁移旧包；需要跨包切换时先另行验证凭证和本机配置的保留流程。

每个包只查询和安装自己的已审核更新。缺省更新指引 `/ant-update` 对应原包；`dsh-ant` 使用 `/ant-update?package_name=dsh-ant`，该指引分发以 `.tgz` 结尾、不带查询参数的 `/api/ant-bundles/dsh-ant/<版本>/package.tgz` 安装地址。服务端须先升级到支持双包的版本；旧服务端返回原包信息时，新包拒绝安装，不跨包回退。历史 `ant` alias 的迁移工具仍只处理 `@ai-wendao/ant`，不用于切换包名。

## DSH 客户端兼容性

当前 Bundle 声明的 DSH 最低版本是 `0.2.1-rc.3`。DSH 会在安装和启动 profile 时检查此范围；低于最低版本时，DSH 插件管理器会报告并跳过 ANT Bundle。高于最低版本的 DSH 不会被版本上限拦截；ANT 只把 `0.2.1-rc.3` 标为已记录的验收基线，其他版本显示为“未验收”。ANT 的“关于”页会检查当前 DSH 与候选 ANT 制品的兼容状态；低于最低版本、版本未知或候选制品未提供范围时，不提供自动更新操作。

`0.2.1-rc.3` 是仓库当前有记录的 DSH 基线。更高的稳定版和预发布版都可以通过最低版本门禁，但在完成对应 Desktop/DSH-IM 验证前仍标为“未验收”。ANT 协作会话还会在实际调用前检查 Session 事件接口；缺少该接口时会提示检查 DSH 兼容状态，不发送协作 prompt。

## 团队模型默认值与路由升级

团队管理员在 ANT 控制台设置团队默认模型，并授权成员可用模型。成员第一次在 ANT 插件中同步模型时，团队默认会写入 DSH 的全局默认模型；成员之后可在“团队模型”页选另一项已获准模型。成员也可按 provider 选择同步到本机 DSH 的模型路由；关闭某项并刷新后会从本机 Profile 移除。升级到 provider-config v3 时，Bundle 会清理旧的固定 provider 路由和兼容 alias；保存了旧路由的历史会话需要成员手动选择管理员配置并授权的 ANT provider 模型，会话正文仍保留。DSH 会将手动选模应用到当前会话，并在后台保存为本机 Profile 默认；保存成功后也会影响该 Profile 的新会话和 ANT 对话/任务。迁移后如需恢复其他本机默认，可在“团队模型”页重新设置。旧 Bundle 的连接/目录请求会收到升级提示；旧固定 gateway URL、已删除 provider 或模式失配的会话请求会返回“升级 ANT 插件并手动改选”的错误提示，不再转发旧模型请求。普通同步保留成员默认选择；若模型被撤销，插件会回到仍获准的团队默认。该默认写入 DSH profile，因此也影响同一 profile 新建的普通 DSH 会话。ANT 对话和任务会额外校验当前用户的获准模型；Codex 与 Claude Code 使用各自执行器的默认模型。

图片输入能力由管理员按团队模型配置；成员默认继承。成员可在“团队模型”页关闭当前 DSH Profile 中单个模型的图片输入，并通过刷新应用；这只限制本机同步，不修改团队设置或授权。管理员未开放图片输入时，成员不能自行打开。

每个 OpenAI 兼容模型可配置 Chat Completions 或 Responses API。请求通过显式 provider ID 路由，并按模型、provider、企业集成的配置继承 URL 与 Token；Bundle 不再创建 legacy provider alias 或兼容路由。管理员应先把需继续使用的旧模型配置、默认值和授权迁到目标 provider，再删除不再需要的旧 provider。删除 provider 不删除已保存的用量记录。

## 企业品牌

团队管理员可在 ANT 管理台的“企业品牌”页设置 DSH 侧栏 Logo、品牌名称、品牌徽标和新会话标题。Logo 接受 PNG、JPEG 或 WebP，最大 350 KB；图片和文字保存在当前团队的 ANT 服务端。成员 Bundle 启动时立即同步，DSH 保持打开时每 5 分钟通过 ETag 检查版本；网络暂时不可用时继续使用本机最近一次成功配置，不阻止 DSH 启动。

Logo 与侧栏品牌使用 DSH 正式 UI 插槽。新会话标题目前没有官方文本插槽，Bundle 只在页面中精确匹配 DSH 当前标题原文后替换；上游更改该文案时可能需要更新 ANT Bundle。此项不影响会话和工具功能，也不控制 DSH 原生欢迎/登录窗口、菜单或应用图标。

飞书和企业微信的机器人连接、消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥或直连 IM 平台。ANT 继续负责团队成员身份和模型授权，并可在成员显式开启时接管一个专用飞书机器人的文本收件，按成员授权范围处理协作请求。

## 协作机器人与任务卡

飞书机器人连接和消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥，也不直连 IM 平台。成员在 ANT 插件的“协作”页选择机器人、启用本机协作，并设置私聊和各群的普通聊天开关。主人还要一次性绑定自己的 IM 私聊身份，供机器人发送和接收审批。群第一次 @ 机器人后会出现在群列表；群聊天开关只控制普通聊天。

任务卡是可选的重复任务预授权。每张卡由主人确认任务描述、可用执行方集合和默认执行方、请求范围和有效期；请求不需要固定开头，模型按语义匹配已开放的卡片，意图歧义或信息不足时先澄清。普通请求运行默认执行方；请求人明确要求交叉审查时，并行运行其他已选执行方。开放任务时，点击“立即分析”后 ANT 才会调用当前获准的 DSH 团队模型，检查必需信息、可选条件和自然语言示例；修改描述后必须重新分析。草稿不会自动开放，主人检查后明确开放。

使用 Codex 或 Claude Code 的任务卡默认勾选“启动前需要主人审批”：模型匹配到任务后，先把请求发到主人私聊，主人批准后才启动，执行器由任务卡固定。主人可以在开放时取消勾选，之后模型匹配到任务就直接启动。只用 DSH 的任务卡不受影响。

没有匹配预授权卡片的明确任务，由机器人根据私聊消息或群内 @ 事件识别。模型整理本次执行说明后，会把原始请求、执行说明、请求人、结果去向和可用执行器发到主人私聊。主人选择 DSH、Codex 或 Claude Code 批准，或拒绝；此许可只适用于本次请求，不能复用。执行器尚未得到主人批准时不会启动。

机器人主人指在本人 DSH 中连接并管理该 DSH-IM 机器人的 ANT 成员，不代表群管理员身份。主人审批可以覆盖任务卡未开放的执行方、请求人或会话范围，但必须在私聊里确认这一次的具体请求。若结果回到群聊，群成员都能看见。

DSH 团队模型运行在没有 DSH 工具的受限任务会话中，只能分析本次提供的文本和 ANT 已核验资源。Codex 和 Claude Code 通过本机 DSH 子 Agent 提供方运行，使用对应 Provider Profile 的文件、Git、网络和工具权限。ANT 的任务描述及主人审批不能形成操作系统沙箱，也不能把 Provider Profile 权限缩小到本次任务；审批私聊会明确说明这一点。实际可选执行器以这台 DSH 已注册的提供方为准。

ANT Host 只代取 ANT 自己管理的资源。Gitea 只读令牌保存在本机 DSH 凭据服务，由 Host Connector 使用，不交给 Agent。机器人按主人登记的 HTTPS 来源绑定 Gitea；每次任务都会校验来源、仓库、PR、base/head，并在执行后复核快照。PR 仓库快照工作区不含 Git 元数据、符号链接或子模块；不会下载 Git LFS 实际文件。

群聊天设置与任务授权分开：启用主人审批私聊后，群成员可以 @ 机器人提交没有预授权卡片的任务，即使该群没有任务卡。主人会在审批消息中看到群聊范围；批准后结果回原群，群内可见。私聊请求仍受机器人的私聊开关控制。没有主人审批私聊绑定时，未配置请求不会进入执行流程。

## 企业精选技能

团队管理员可在 ANT 管理台从 GitHub 目录、ZIP、TAR、TAR.GZ／TGZ 或单份 `SKILL.md` 导入技能，核对来源、文件和依赖后发布，并为企业技能和插件指定主要用途类别。成员可从 DSH 主侧栏“ANT”或 ANT Bundle 配置页直接进入团队设置；DSH“设置”中的 ANT 项提供打开 ANT 主页面的快捷入口。主侧栏“企业扩展”继续进入统一目录，可组合筛选办公文档、编程开发、设计与多媒体、数据分析、协作沟通、写作与营销、自动化与效率、运维与安全或其他类别，同时按来源范围、技能/插件类型和安装状态筛选或搜索。类别只用于发现内容；“本企业”“全市场精选”和“DSH 官方”是独立来源范围。ANT Host 将固定版本的完整文件集放进 DSH 的用户技能目录，并重新核对本机文件；启用本地技能的 DSH 会话随后由原生技能提供者发现和使用。ANT 不用 Host 全局技能列表判断会话是否已发现技能。

安装不会自动运行技能脚本或安装 Python、Node 等系统依赖。ANT 只更新或卸载自己管理且本机内容未被修改的技能目录；发现同名个人技能或本机改动时会停止覆盖。

## 企业精选插件

管理员从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展”总览或“插件”分类查看审核信息和本机状态；发布后可让 DSH 官方插件管理器从 npm 安装目录中的精确版本，无须先由管理员锁定 ANT tarball。ANT 也保留可选的固定 tarball 安装路径。直接安装时，DSH 按 registry/fallback 配置解析依赖，设备间版本可能不同；ANT 不会批准依赖构建脚本，如安装因此中断需按 DSH 提示转到原生插件管理页处理。ANT 目录不控制插件之后的自更新；部分插件可提供自己的更新器，DSH 原生插件管理页也可更换版本。安全撤回版本会停止通过 ANT 目录发起的新安装，但不会自动删除本机副本。范围与限制见[上线边界](https://npmcn.com/package/docs/decisions/2026-10-15-plugin-center-rollout.md)。

ANT 自身更新使用单独的已审核安装包。管理员将与 npm 发布一致的 `.tgz` 上传到 ANT 服务端并登记版本；新版 ANT 页面可点击“更新”，DSH 原位替换同名 Bundle 后提示重启。旧版 `@ai-wendao/ant` 用户可打开团队服务的 `/ant-update` 指引，在 DSH“添加插件”中粘贴该安装包地址完成一次性原位更新，无需先卸载或使用终端。此入口只分发 ANT 自身，不启用扩展中心其他插件的一键安装。

企业精选是团队推荐目录，不是强制白名单；ANT 不能阻止成员从 DSH 原生插件管理页或插件自身更新器安装其他版本。DSH `0.2.0-rc.2` 本身不自动更新已安装 Bundle；插件可以提供自己的更新操作。ANT 目录只约束它发起的安装，不对本机安装后的版本持续强制管理。上线边界见[待决策记录](https://npmcn.com/package/docs/decisions/2026-10-15-plugin-center-rollout.md)。

## Existing `ant` alias installations

DSH RC2 requires a Bundle's client module identity to match its npm package name. Profiles that installed `ant` as an npm alias for `@ai-wendao/ant` need a one-time package-key migration. Use DSH's Plugins page for the normal Desktop profile; the cross-platform migration CLI is a fallback.

For the normal Desktop profile, migrate from DSH's **Plugins** page by uninstalling the old ANT package and installing `@ai-wendao/ant` directly. This uses DSH's bundled package manager and does not require system Node.js/npm. Read [MIGRATION.md](https://npmcn.com/package/%40ai-wendao/ant/MIGRATION.md) first. The `ant-migrate` CLI is a fallback for profiles where the UI cannot unload the running bundle; it requires Node.js 20+, npm, and the DSH Desktop CLI. Neither path clears ANT credentials or model settings by design. This package does not publish or deploy ANT.

## 常见问题

### @ai-wendao/ant 是什么？

ANT\(AI-native Teams\)将DeepSeek Harness桌面配置与团队身份和被批准的模型相接\.

### 如何安装 @ai-wendao/ant？

在项目目录运行 npm install @ai-wendao/ant，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/dsh-app-boot（\>=0\.2\.1-rc\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 ant-migrate，可以用 npx ant-migrate 直接运行。

### @ai-wendao/ant 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ai-wendao\_\_ant 是否存在。

### @ai-wendao/ant 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @ai-wendao/ant 可以商用吗？

@ai-wendao/ant 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-wendao/ant 的下载量有多少？

根据 npm 官方下载统计，@ai-wendao/ant 在 2026/10/05 – 2026/11/03 这 30 天内被下载 6,006 次，日均约 200 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ai-wendao/ant 还在维护吗？

最新版本 0\.6\.3 发布于 2026/11/08（今天）；至今共发布 45 个版本，其中过去 12 个月发布了 45 个；首次发布于 2026/10/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。