@ai-wendao/ant 0.4.9 → 0.4.11

package/README.md

@@ -2,12 +2,20 @@
 
 ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's membership and approved models.
 
+## 团队模型默认值
+
+团队管理员在 ANT 控制台设置团队默认模型，并授权成员可用模型。成员第一次在 ANT 插件中同步模型时，团队默认会写入 DSH 的全局默认模型；成员之后可在“团队模型”页选另一项已获准模型。普通同步保留成员选择；若模型被撤销，插件会回到仍获准的团队默认。该默认写入 DSH profile，因此也影响同一 profile 新建的普通 DSH 会话。ANT 对话和任务会额外校验当前用户的获准模型；Codex 与 Claude Code 使用各自执行器的默认模型。
+
+每个 OpenAI 兼容模型可配置 Chat Completions 或 Responses API。旧模型记录在升级后按 Chat Completions 解释；ANT 服务端继续使用原配置的 `/chat/completions` URL，并从相同 API 根路径派生 `/responses` 上游路径。
+
 飞书和企业微信的机器人连接、消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥或直连 IM 平台。ANT 继续负责团队成员身份和模型授权，并可在成员显式开启时接管一个专用飞书机器人的文本收件，按成员授权范围处理协作请求。
 
 ## 协作机器人与任务卡
 
 成员在 ANT 插件设置页选择一个 DSH-IM 飞书机器人并启用协作收件。每段私聊、群聊或话题由同一受限 DSH 会话自然回答和追问；只有 DSH 准备执行任务时，才通过 ANT 工具提交任务卡 ID 和参数，由服务端再次核对真实请求人、群、参数及授权。成员按需创建任务卡，设置意图、参数、请求人、适用会话和有效期；PR 审查只是可选示例。普通文字任务由没有本机工具权限的 DSH 会话处理。单个 Gitea PR 参数还可选择 Codex 专用只读 CLI，或 DSH 已注册的 Claude Code 子代理试用：ANT 用只读 Gitea 令牌为每项 PR 审查能力维护本机仓库缓存，并按已核验的 PR Head SHA 创建独立工作树；令牌不会交给执行器。Codex 使用固定只读权限配置，Claude Code 沿用 DSH 提供方的本机权限设置。执行器可查看完整源码和已核验 diff；工作区不含 `.git`、符号链接或子模块，也不会运行仓库脚本。Claude Code 仍是所有者手动开放的本机试用，不宣称具备操作系统级只读隔离。成员可查询或取消任务；每台电脑默认同时处理三项任务，成员可调整，旧版 PR 审查与新任务共用名额。
 
+PR 任务卡可勾选 DSH、Codex 和 Claude Code 等这台 DSH 可用的审查 Agent，并指定普通请求的默认执行方。普通审查只启动默认 Agent；请求人明确提出“交叉 review”时，ANT 会并行启动所有勾选项、提供分别标明执行方的结果。交叉审查至少需要两位 Agent；个别 Agent 失败时保留成功结果并标明失败项。Codex 和 Claude Code 只支持一个必填的 Gitea PR 参数；DSH 审查已提供的 diff，不读取完整仓库。
+
 私聊默认开启，所有者可按机器人单独关闭或重新开启；关闭后新私聊消息不会进入 DSH，机器人每五分钟最多向同一请求人发送一次静态恢复指引；所有者身份绑定命令仍可用。关闭前已提交的任务不会撤销，仍回复原私聊；群聊设置不受影响。群聊由所有者逐群启用普通聊天，任务授权再按卡单独设置。群里有人 @ 机器人后，群 ID 出现在插件列表；所有者也可手动填写群 ID。若所有者在群里，可先私聊机器人绑定飞书身份，再在群内提出“在本群启用聊天”，或按提示确认“在本群启用任务 任务名称”。群消息只在明确 @ 时处理，任务结果公开回复原群／原话题；要求私聊回复的群消息会提示请求人改为私聊发起。当前 DSH-IM 未提供可核验的机器人进／出群发起者，所以不会因被拉群自动启用。不同群、话题和私聊的上下文默认隔离；每项能力当前只能关联一个范围，即私聊或一个群；要让多个群或私聊都能执行，需分别建立能力卡，并分别设定请求人和有效期。群历史按需读取，默认先看十条、最多检查一百条平台记录，实际可见范围由飞书权限决定。
 
 新建任务卡的 Codex 与 Claude Code 执行方目前只接受一个必填 Gitea PR 参数。Gitea PR 源仓库和目标仓库大小按 API KiB 换算为 bytes，并在 fetch 前与 512 MiB 单仓库快照上限及本机总缓存预算核对。每台 DSH 的长期 bare 仓库缓存默认最多 10 GiB，可在插件的“本机处理设置”调整为 1–100 GiB；按缓存文件逻辑大小计算，不含临时工作目录及文件系统分配开销。预算也为即将拉取的仓库预留空间。Git fetch 强制使用单 pack；POSIX 系统用进程文件大小限制约束 pack 与 index 的总预算，并监控缓存总量。正常情况下不会淘汰仍启用能力的缓存；若实际 fetch 越界，会清理本项能力的仓库缓存（旧 PR 可在后续任务重新下载）。Windows 暂未实现等效的原生 fetch 硬限制，Codex/Claude Code PR 快照会失败关闭，界面会禁用对应选项并提示 DSH 差异审查。停用/过期能力的缓存会在刷新时回收。任务工作树是短期目录，受单快照 512 MiB、最多 10,000 个文件、单文件最多 64 MiB 限制，不计入长期缓存预算，完成后删除。快照不支持符号链接或子模块，也不下载 Git LFS 实际文件；快照中的 LFS 指针不能代表已审查的实际文件内容。Codex/Claude Code 的 granular Gitea Token 还需 `read:repository` 和 `read:user`，后者仅用于本机获取 Git HTTPS 用户名。超限时任务失败，不降级为 diff-only。快照与权限验收范围见[Claude Code 任务卡计划](../../docs/plans/2026-10-22-claude-code-task-card.md)及[执行方隔离](../../docs/decisions/2026-10-22-im-native-executor-isolation.md)。普通对话和 DSH 文字任务不直接获得文件、命令或网络工具。机器人独占收件模式由 DSH-IM 保存；停止 ANT 授权后若需恢复 DSH-IM 原有聊天，需要在 DSH-IM 中切回普通模式。
@@ -20,11 +28,11 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 ## 企业精选插件
 
-管理员可从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展”总览或“插件”分类查看审核信息和本机状态。对无新增依赖、无安装阶段脚本且归档符合首批准入条件的草稿，管理员可从 npm 官方源锁定实际 `.tgz` 并查看文件清单、下载核验制品；这类草稿经审核发布后，成员可让 DSH 从 ANT 的固定制品地址一键安装。其他版本仍是目录项，需联系管理员安排。安全撤回版本会停止新的 ANT 下载，但不会自动删除本机副本；ANT 设置页继续显示相应风险公告。范围与限制见[上线边界](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
+管理员从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展”总览或“插件”分类查看审核信息和本机状态；发布后可让 DSH 官方插件管理器从 npm 安装目录中的精确版本，无须先由管理员锁定 ANT tarball。ANT 也保留可选的固定 tarball 安装路径。直接安装时，DSH 按 registry/fallback 配置解析依赖，设备间版本可能不同；ANT 不会批准依赖构建脚本，如安装因此中断需按 DSH 提示转到原生插件管理页处理。ANT 目录不控制插件之后的自更新；部分插件可提供自己的更新器，DSH 原生插件管理页也可更换版本。安全撤回版本会停止通过 ANT 目录发起的新安装，但不会自动删除本机副本。范围与限制见[上线边界](../../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 原生插件管理页自行安装其他包。第一批一键安装只分发 ANT 已核验并保存的顶层包，不把有依赖或安装脚本的版本伪装成已受控；DSH RC2 后续包管理能否一直保留这一固定制品仍需真机验收。上线边界见[待决策记录](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
+企业精选是团队推荐目录，不是强制白名单；ANT 不能阻止成员从 DSH 原生插件管理页或插件自身更新器安装其他版本。DSH `0.2.0-rc.2` 本身不自动更新已安装 Bundle；插件可以提供自己的更新操作。ANT 目录只约束它发起的安装，不对本机安装后的版本持续强制管理。上线边界见[待决策记录](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
 
 ## Existing `ant` alias installations