@ai-wendao/ant 0.5.9 → 0.5.11

package/README.md

@@ -20,15 +20,19 @@ Logo 与侧栏品牌使用 DSH 正式 UI 插槽。新会话标题目前没有官
 
 飞书机器人连接和消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥，也不直连 IM 平台。成员在 ANT 插件的“协作”页选择机器人、启用本机协作，并设置私聊和各群的普通聊天开关。群第一次 @ 机器人后会出现在群列表。群聊天开关只控制普通聊天；任务卡还要单独指定私聊或群、请求人范围和有效期。
 
-开放任务时，成员用自然语言描述什么时候执行、要看哪些资料、怎样处理和返回结果。描述中的 Gitea PR 链接、仓库和编号也用自然语言表达。点击“识别规则”会调用一次当前获准的 DSH 团队模型，只生成草稿，不保存任务；草稿包含明确触发短语，由机器人主人检查后再开放。触发短语会显示在任务概览顶部，允许机器人主人直接修改；修改描述后重新识别会更新摘要，保留手动调整的短语并提示复核。只有请求消息以已保存短语开头时任务才会执行。机器人主人指在本人 DSH 中连接并管理该 DSH-IM 机器人的 ANT 成员，不代表群管理员身份；群内谁能请求任务仍由规则中的群范围和请求人范围决定。任务名称、意图、PR 信息和其他参数由识别结果转成内部规则，不要求逐项编辑。执行方式、使用范围、请求人和有效期由固定控件控制；新任务有效期可选 1、7、30 或 90 天，编辑已有任务时保留原到期时间。
+开放任务时，成员用自然语言描述要完成什么、可以使用哪些资料、怎样处理和返回结果。输入停顿后，ANT 会调用当前获准的 DSH 团队模型，在描述旁检查并显示必需信息缺项、可选限定建议、自然语言请求示例和运行方式；草稿不会自动开放，机器人主人检查后明确开放。机器人主人指在本人 DSH 中连接并管理该 DSH-IM 机器人的 ANT 成员，不代表群管理员身份；群内谁能请求仍由规则中的群范围和请求人范围决定。任务由模型在当前请求人和会话可申请的能力中按语义匹配；意图不明确或信息不足时先追问，不要求固定触发前缀。模型匹配不是安全边界，服务端每次仍核验任务状态、机器人、会话、请求人、有效期和参数。
 
-群任务和群聊天设置只在 ANT 协作页配置。当前版本不设群管理员身份绑定，也不支持在群里开放任务、确认授权或开关群聊。群成员可以普通聊天，或按已开放任务的群范围、请求人范围、触发条件和有效期发起任务；未开放的任务不会因为群成员的消息而执行。关闭群普通聊天不会撤销已开放任务。服务端升级时会停用没有明确触发方式的旧任务卡；要继续使用这类任务，需在新界面重新描述规则并开放。
+PR 来源和仓库由机器人主人写在任务描述中，AI 提取候选范围供主人复核；B 的原始描述仍是任务行为的主要依据。若机器人尚未绑定 Gitea 主机，主人确认并开放首个 PR 任务卡时会明确看到绑定来源，服务端在保存任务卡的事务中完成首次绑定；此后每张 PR 任务卡和每次请求都必须匹配该主机。无需填写固定地址表单，也不单独设置机器人的可信地址。请求人每次提供 PR 链接或编号，也可以明确指定 Head SHA；没有指定时，按任务开始处理时读取到的最新 Head。ANT 会校验来源、仓库、PR、base/head，并在执行后再次核对快照。
 
-普通文字任务由没有本机工具权限的 DSH 会话处理。执行方可选择 DSH、Codex 或这台 DSH 已注册的 Claude Code；Codex 和 Claude Code 当前用于单个必填 PR 的快照审查。任务描述里写 PR 链接、仓库和审查要求。“本机与任务”页仅在需要 PR 读取时设置本机允许访问的 Gitea 来源和只读令牌；来源按机器人登记，令牌由 DSH 安全凭据保存，不同步到 ANT 服务端，也不会交给执行器。普通文字任务无需配置 Gitea。
+DSH Agent 负责自然语言理解和任务执行；B 原始描述决定任务行为，AI 整理摘要只辅助理解。A 本次请求、已核验参数和 Host 实际提供的资源上下文作为本次任务输入。ANT Server 逐次核验身份、会话、范围、有效期和参数，ANT Host 只代取 ANT 自己管理的资源。当前委托任务会话不开放 DSH connector/tool，不能据 DSH Profile 拥有这些连接器推断任务 Agent 已可使用它们；授权路径列入[待决策事项](../../docs/decisions/2026-10-22-delegation-ux-pending.md)。
 
-PR 审查固定并复核 PR base branch SHA 和 Head SHA；任一 SHA、标题或 diff 在审查期间变化，任务失败并要求重新发起。提示会列出执行器实际获得的材料及缺失项：提供 PR 标题、base/head SHA 和 diff；任务卡中的 Codex/Claude Code 原生执行方还可读当前 Head 的受限快照，DSH 以及旧版固定授权路径只收到 diff。不会提供 PR 描述、既有评论、CI 状态、关联 PR/issue 内容或 Git 历史。DSH 的单 PR 任务提示始终保留所有者复核的任务语义；若所有者要求代码审查，使用结构化审查格式；摘要、翻译等其他 PR 任务则按所有者要求处理，请求人文字不能改变任务类型。所有者经复核的要求可指定关注点、输出语言和简洁度，但代码审查不能缩小完整 diff 的范围。任务卡 Codex 使用固定只读权限配置；旧版固定授权路径的 Codex 由 DSH 子代理 provider 启动，权限取决于该 provider 的本机配置，ANT 无法从通用 provider 列表核验。Claude Code 沿用 DSH 提供方的本机权限设置，提示词本身不构成操作系统级写保护；DSH 审查会话禁用工具。仓库脚本不会运行，受限快照不含 Git 元数据目录、符号链接或子模块，也不会下载 Git LFS 实际文件；若 diff 含 LFS 指针，执行器不能声称审查了对应实际文件内容。Gitea 只读令牌不会传给执行器。结果按 P1/P2/P3 汇总，并逐项列位置、触发条件、证据、影响、建议和确认状态，同时标明缺失材料与范围外问题。能力所有者可设置每次并行运行全部已选 Agent，或默认运行一个 Agent、由请求人逐次提出交叉审查。
+群任务和群聊天设置只在 ANT 协作页配置。当前版本不设群管理员身份绑定，也不支持在群里开放任务、确认授权或开关群聊。群成员可以普通聊天，或按已开放任务的群范围、请求人范围和有效期用自然语言发起任务；未开放的任务不会因为群成员的消息而执行。关闭群普通聊天不会撤销已开放任务。
 
-本机与任务页还显示执行器状态、最近任务和运行状态，并提供本机并发与仓库缓存设置。每台 DSH 默认同时处理三项任务，可调整；长期 bare 仓库缓存默认上限 10 GiB，可设为 1–100 GiB，按仓库文件逻辑大小计算，不含临时工作目录。单仓库快照最多 512 MiB、10,000 个文件、单文件 64 MiB；超出预算的任务会失败关闭。停止 ANT 授权后，若需恢复 DSH-IM 原有收件行为，请在 DSH-IM 中切回普通模式。
+当前所有协作任务都由 DSH 获准团队模型处理。`ant-delegated-task` 会话的 DSH 工具 allowlist 为空，只能处理对话内容和 ANT Host 明确提供的资源；Codex 与 Claude Code 即使已在 DSH 注册，也暂不可用于协作任务。DSH 的外部 provider 不继承 ANT 的任务 preset，ANT 也没有接口核验其逐任务文件、Git 和网络权限，因此服务端会拒绝外部执行器任务卡，Bundle 运行时也会失败关闭。执行策略版本头只用于拒绝旧 Bundle 的 legacy PR 授权路径，防止服务端先升级后旧 Bundle 仍可启动外部 provider。
+
+ANT Host 只代取 ANT 自己管理的资源。当前 Host Connector 使用成员保存在 DSH 凭据服务中的 Gitea 只读令牌读取已授权 PR；令牌不会同步到 ANT 服务端，也不会提供给任务模型。任务来源仍由 B 的自然语言描述并经主人复核，但服务端要求它与该机器人的 Gitea 连接器来源一致；Host 不会把全局令牌发送给任务描述里任意填写的主机。当前每台机器人只绑定一个 Gitea 来源；未来若需支持多来源，须按来源隔离令牌，见[待决策事项](../../docs/decisions/2026-10-22-delegation-ux-pending.md)。Host 核验来源、仓库、PR、base/head 和 diff 后，将只读资源上下文交给 DSH。PR 数据是不可信内容，不能改变 B 原始任务描述。任务可以审查、总结或解释 PR，由 B 描述决定。当前只提供 PR diff 和快照元信息，不提供仓库工作树或完整文件访问；diff 含 Git LFS 指针时，任务模型看不到对应文件内容。ANT 只核验自己的连接器资源，不管理 DSH Profile 中的 workspace、skill、connector 或本机凭据。DSH 自有资源的任务级授权方式仍待决策，见[待决策事项](../../docs/decisions/2026-10-22-delegation-ux-pending.md)。
+
+本机与任务页显示执行器状态、最近任务和运行状态，并允许调整本机任务并发。当前不创建 PR 仓库快照；旧的仓库缓存上限设置暂不可修改，仅在停用或到期能力清理旧缓存时保留原值。停止 ANT 授权后，若需恢复 DSH-IM 原有收件行为，请在 DSH-IM 中切回普通模式。
 
 ## 企业精选技能