@ai-wendao/ant 0.4.13 → 0.4.14

package/README.md

@@ -12,13 +12,17 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 ## 协作机器人与任务卡
 
-成员在 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 审查与新任务共用名额。
+飞书机器人连接和消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥，也不直连 IM 平台。成员在 ANT 插件的“协作”页选择机器人、启用本机协作，并设置私聊和各群的普通聊天开关。群第一次 @ 机器人后会出现在群列表。群聊天开关只控制普通聊天；任务卡还要单独指定私聊或群、请求人范围和有效期。
 
-PR 任务卡可勾选 DSH、Codex 和 Claude Code 等这台 DSH 可用的审查 Agent，并指定普通请求的默认执行方。普通审查只启动默认 Agent；请求人明确提出“交叉 review”时，ANT 会并行启动所有勾选项、提供分别标明执行方的结果。交叉审查至少需要两位 Agent；个别 Agent 失败时保留成功结果并标明失败项。Codex 和 Claude Code 只支持一个必填的 Gitea PR 参数；DSH 审查已提供的 diff，不读取完整仓库。
+开放任务时，成员用自然语言描述什么时候执行、要看哪些资料、怎样处理和返回结果。描述中的 Gitea PR 链接、仓库和编号也用自然语言表达。点击“识别规则”会调用一次当前获准的 DSH 团队模型，只生成草稿，不保存任务；检查摘要不合意时，修改描述并重新识别。任务名称、触发条件、PR 信息和参数由识别结果转成内部规则，界面不要求逐项填写。执行方、使用范围、请求人和有效期由通用控件控制。
 
-私聊默认开启，所有者可按机器人单独关闭或重新开启；关闭后新私聊消息不会进入 DSH，机器人每五分钟最多向同一请求人发送一次静态恢复指引；所有者身份绑定命令仍可用。关闭前已提交的任务不会撤销，仍回复原私聊；群聊设置不受影响。群聊由所有者逐群启用普通聊天，任务授权再按卡单独设置。群里有人 @ 机器人后，群 ID 出现在插件列表；所有者也可手动填写群 ID。若所有者在群里，可先私聊机器人绑定飞书身份，再在群内提出“在本群启用聊天”，或按提示确认“在本群启用任务 任务名称”。群消息只在明确 @ 时处理，任务结果公开回复原群／原话题；要求私聊回复的群消息会提示请求人改为私聊发起。当前 DSH-IM 未提供可核验的机器人进／出群发起者，所以不会因被拉群自动启用。不同群、话题和私聊的上下文默认隔离；每项能力当前只能关联一个范围，即私聊或一个群；要让多个群或私聊都能执行，需分别建立能力卡，并分别设定请求人和有效期。群历史按需读取，默认先看十条、最多检查一百条平台记录，实际可见范围由飞书权限决定。
+群任务和群聊天设置只在 ANT 协作页配置。当前版本不设群管理员身份绑定，也不支持在群里开放任务、确认授权或开关群聊。群成员可以普通聊天，或按已开放任务的群范围、请求人范围、触发条件和有效期发起任务；未开放的任务不会因为群成员的消息而执行。关闭群普通聊天不会撤销已开放任务。服务端升级时会停用没有明确触发方式的旧任务卡；要继续使用这类任务，需在新界面重新描述规则并开放。
 
-新建任务卡的 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 中切回普通模式。
+普通文字任务由没有本机工具权限的 DSH 会话处理。执行方可选择 DSH、Codex 或这台 DSH 已注册的 Claude Code；Codex 和 Claude Code 当前用于单个必填 PR 的快照审查。任务描述里写 PR 链接、仓库和审查要求。“本机与任务”页仅在需要 PR 读取时设置本机允许访问的 Gitea 来源和只读令牌；来源按机器人登记，令牌由 DSH 安全凭据保存，不同步到 ANT 服务端，也不会交给执行器。普通文字任务无需配置 Gitea。
+
+PR 快照任务使用已核验的 PR Head SHA 创建独立工作树。Codex 使用固定只读权限配置；Claude Code 沿用 DSH 提供方的本机权限设置。仓库脚本不会运行，工作区不含 Git 元数据目录、符号链接或子模块，也不会下载 Git LFS 实际文件；若 diff 含 LFS 指针，执行器不能声称审查了对应文件内容。Gitea 只读令牌不会传给执行器。PR 审查可选择 DSH、Codex 和 Claude Code 等本机可用 Agent；普通请求只运行默认执行方，请求人明确提出“交叉 review”时并行运行选中的 Agent，并分别返回结果。
+
+本机与任务页还显示执行器状态、最近任务和运行状态，并提供本机并发与仓库缓存设置。每台 DSH 默认同时处理三项任务，可调整；长期 bare 仓库缓存默认上限 10 GiB，可设为 1–100 GiB，按仓库文件逻辑大小计算，不含临时工作目录。单仓库快照最多 512 MiB、10,000 个文件、单文件 64 MiB；超出预算的任务会失败关闭。停止 ANT 授权后，若需恢复 DSH-IM 原有收件行为，请在 DSH-IM 中切回普通模式。
 
 ## 企业精选技能