dsh-ant 0.6.0 → 0.6.1

package/README.md

@@ -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 中切回普通模式。
+群聊天设置与任务授权分开：启用主人审批私聊后，群成员可以 @ 机器人提交没有预授权卡片的任务，即使该群没有任务卡。主人会在审批消息中看到群聊范围；批准后结果回原群，群内可见。私聊请求仍受机器人的私聊开关控制。没有主人审批私聊绑定时，未配置请求不会进入执行流程。
 
 ## 企业精选技能