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 目录发起的新安装，但不会自动删除本机副本。范围与限制见上线边界。
ANT 自身更新使用单独的已审核安装包。管理员将与 npm 发布一致的 .tgz 上传到 ANT 服务端并登记版本；新版 ANT 页面可点击“更新”，DSH 原位替换同名 Bundle 后提示重启。旧版 @ai-wendao/ant 用户可打开团队服务的 /ant-update 指引，在 DSH“添加插件”中粘贴该安装包地址完成一次性原位更新，无需先卸载或使用终端。此入口只分发 ANT 自身，不启用扩展中心其他插件的一键安装。
企业精选是团队推荐目录，不是强制白名单；ANT 不能阻止成员从 DSH 原生插件管理页或插件自身更新器安装其他版本。DSH 0.2.0-rc.2 本身不自动更新已安装 Bundle；插件可以提供自己的更新操作。ANT 目录只约束它发起的安装，不对本机安装后的版本持续强制管理。上线边界见待决策记录。
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 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.