dsh-ant 0.5.12 → 0.6.1

package/README.md

@@ -14,13 +14,13 @@ ANT 同一份源码可发布为 `@ai-wendao/ant` 和 `dsh-ant`，DSH 添加插
 
 `0.2.1-rc.3` 是仓库当前有记录的 DSH 基线。更高的稳定版和预发布版都可以通过最低版本门禁，但在完成对应 Desktop/DSH-IM 验证前仍标为“未验收”。ANT 协作会话还会在实际调用前检查 Session 事件接口；缺少该接口时会提示检查 DSH 兼容状态，不发送协作 prompt。
 
-## 团队模型默认值
+## 团队模型默认值与路由升级
 
-团队管理员在 ANT 控制台设置团队默认模型，并授权成员可用模型。成员第一次在 ANT 插件中同步模型时，团队默认会写入 DSH 的全局默认模型；成员之后可在“团队模型”页选另一项已获准模型。成员也可按 provider 选择同步到本机 DSH 的模型路由；首次升级保留已有路由，关闭某项并刷新后会从本机 Profile 移除，保存了该路由的历史会话可能暂时无法调用，重新启用并刷新可恢复。普通同步保留成员默认选择；若模型被撤销，插件会回到仍获准的团队默认。该默认写入 DSH profile，因此也影响同一 profile 新建的普通 DSH 会话。ANT 对话和任务会额外校验当前用户的获准模型；Codex 与 Claude Code 使用各自执行器的默认模型。
+团队管理员在 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。旧模型记录在升级后按 Chat Completions 解释；ANT 服务端继续使用原配置的 `/chat/completions` URL，并从相同 API 根路径派生 `/responses` 上游路径。
+每个 OpenAI 兼容模型可配置 Chat Completions 或 Responses API。请求通过显式 provider ID 路由，并按模型、provider、企业集成的配置继承 URL 与 Token；Bundle 不再创建 legacy provider alias 或兼容路由。管理员应先把需继续使用的旧模型配置、默认值和授权迁到目标 provider，再删除不再需要的旧 provider。删除 provider 不删除已保存的用量记录。
 
 ## 企业品牌
 
@@ -32,21 +32,21 @@ Logo 与侧栏品牌使用 DSH 正式 UI 插槽。新会话标题目前没有官
 
 ## 协作机器人与任务卡
 
-飞书机器人连接和消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥，也不直连 IM 平台。成员在 ANT 插件的“协作”页选择机器人、启用本机协作，并设置私聊和各群的普通聊天开关。群第一次 @ 机器人后会出现在群列表。群聊天开关只控制普通聊天；任务卡还要单独指定私聊或群、请求人范围和有效期。
+飞书机器人连接和消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥，也不直连 IM 平台。成员在 ANT 插件的“协作”页选择机器人、启用本机协作，并设置私聊和各群的普通聊天开关。主人还要一次性绑定自己的 IM 私聊身份，供机器人发送和接收审批。群第一次 @ 机器人后会出现在群列表；群聊天开关只控制普通聊天。
 
-开放任务时，成员用自然语言描述要完成什么、可以使用哪些资料、怎样处理和返回结果。输入停顿后，ANT 会调用当前获准的 DSH 团队模型，在描述旁检查并显示必需信息缺项、可选限定建议、自然语言请求示例和运行方式；草稿不会自动开放，机器人主人检查后明确开放。机器人主人指在本人 DSH 中连接并管理该 DSH-IM 机器人的 ANT 成员，不代表群管理员身份；群内谁能请求仍由规则中的群范围和请求人范围决定。任务由模型在当前请求人和会话可申请的能力中按语义匹配；意图不明确或信息不足时先追问，不要求固定触发前缀。模型匹配不是安全边界，服务端每次仍核验任务状态、机器人、会话、请求人、有效期和参数。
+任务卡是可选的重复任务预授权。每张卡由主人确认任务描述、消息触发短语、可用执行方集合和默认执行方、请求范围和有效期；只有请求消息以卡片触发短语开头时才直接执行。普通请求运行默认执行方；请求人明确要求交叉审查时，并行运行其他已选执行方。开放任务时，点击“立即分析”后 ANT 才会调用当前获准的 DSH 团队模型，检查必需信息、可选条件、自然语言示例和触发短语；修改描述后必须重新分析。草稿不会自动开放，主人检查后明确开放。
 
-PR 来源和仓库由机器人主人写在任务描述中，AI 提取候选范围供主人复核；B 的原始描述仍是任务行为的主要依据。若机器人尚未绑定 Gitea 主机，主人确认并开放首个 PR 任务卡时会明确看到绑定来源，服务端在保存任务卡的事务中完成首次绑定；此后每张 PR 任务卡和每次请求都必须匹配该主机。无需填写固定地址表单，也不单独设置机器人的可信地址。请求人每次提供 PR 链接或编号，也可以明确指定 Head SHA；没有指定时，按任务开始处理时读取到的最新 Head。ANT 会校验来源、仓库、PR、base/head，并在执行后再次核对快照。
+升级时，缺少明确触发短语的旧任务卡会自动停用，避免没有指定开头的消息继续触发旧授权。要恢复这类任务，请编辑并补充自然语言描述，重新分析和核对触发短语，再由主人重新开放。
 
-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)。
+没有匹配预授权卡片的明确任务，由机器人根据私聊消息或群内 @ 事件识别。模型整理本次执行说明后，会把原始请求、执行说明、请求人、结果去向和可用执行器发到主人私聊。主人选择 DSH、Codex 或 Claude Code 批准，或拒绝；此许可只适用于本次请求，不能复用。执行器尚未得到主人批准时不会启动。
 
-群任务和群聊天设置只在 ANT 协作页配置。当前版本不设群管理员身份绑定，也不支持在群里开放任务、确认授权或开关群聊。群成员可以普通聊天，或按已开放任务的群范围、请求人范围和有效期用自然语言发起任务；未开放的任务不会因为群成员的消息而执行。关闭群普通聊天不会撤销已开放任务。
+机器人主人指在本人 DSH 中连接并管理该 DSH-IM 机器人的 ANT 成员，不代表群管理员身份。主人审批可以覆盖任务卡未开放的执行方、请求人或会话范围，但必须在私聊里确认这一次的具体请求。若结果回到群聊，群成员都能看见。
 
-当前所有协作任务都由 DSH 获准团队模型处理。`ant-delegated-task` 会话的 DSH 工具 allowlist 为空，只能处理对话内容和 ANT Host 明确提供的资源；Codex 与 Claude Code 即使已在 DSH 注册，也暂不可用于协作任务。DSH 的外部 provider 不继承 ANT 的任务 preset，ANT 也没有接口核验其逐任务文件、Git 和网络权限，因此服务端会拒绝外部执行器任务卡，Bundle 运行时也会失败关闭。执行策略版本头只用于拒绝旧 Bundle 的 legacy PR 授权路径，防止服务端先升级后旧 Bundle 仍可启动外部 provider。
+DSH 团队模型运行在没有 DSH 工具的受限任务会话中，只能分析本次提供的文本和 ANT 已核验资源。Codex 和 Claude Code 通过本机 DSH 子 Agent 提供方运行，使用对应 Provider Profile 的文件、Git、网络和工具权限。ANT 的任务描述及主人审批不能形成操作系统沙箱，也不能把 Provider Profile 权限缩小到本次任务；审批私聊会明确说明这一点。实际可选执行器以这台 DSH 已注册的提供方为准。
 
-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)。
+ANT Host 只代取 ANT 自己管理的资源。Gitea 只读令牌保存在本机 DSH 凭据服务，由 Host Connector 使用，不交给 Agent。机器人按主人登记的 HTTPS 来源绑定 Gitea；每次任务都会校验来源、仓库、PR、base/head，并在执行后复核快照。PR 仓库快照工作区不含 Git 元数据、符号链接或子模块；不会下载 Git LFS 实际文件。
 
-本机与任务页显示执行器状态、最近任务和运行状态，并允许调整本机任务并发。当前不创建 PR 仓库快照；旧的仓库缓存上限设置暂不可修改，仅在停用或到期能力清理旧缓存时保留原值。停止 ANT 授权后，若需恢复 DSH-IM 原有收件行为，请在 DSH-IM 中切回普通模式。
+群聊天设置与任务授权分开：启用主人审批私聊后，群成员可以 @ 机器人提交没有预授权卡片的任务，即使该群没有任务卡。主人会在审批消息中看到群聊范围；批准后结果回原群，群内可见。私聊请求仍受机器人的私聊开关控制。没有主人审批私聊绑定时，未配置请求不会进入执行流程。
 
 ## 企业精选技能