@ai-wendao/ant 0.4.1 → 0.4.4

package/README.md

@@ -6,11 +6,11 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 ## 协作机器人与任务卡
 
-成员在 ANT 插件设置页选择一个 DSH-IM 飞书机器人并启用协作收件。私聊可以自然对话；成员可创建任务卡，写明任务意图、参数、请求人、适用的私聊或群聊及有效期。模型根据同一会话的消息提出任务与参数，ANT 服务端再次核对请求人、群、参数和授权，才交给没有本机工具权限的 DSH 文字会话处理。Gitea PR 参数还会在本机用只读令牌核对存在性，并把固定大小的标题与差异交给当前获准的团队模型。成员可查询或取消任务；每台电脑默认同时处理三项任务，成员可调整，旧版 PR 审查与新任务共用名额。
+成员在 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 审查与新任务共用名额。
 
-群聊须由所有者逐群启用：群里有人 @ 机器人后，群 ID 出现在插件列表。所有者可在插件里启用任务卡；若所有者也在群里，可先私聊机器人绑定飞书身份，再在群内提出“在本群启用任务 任务名称”，按提示确认。群任务只在明确 @ 时处理，结果公开回复原群／原话题；要求私聊回复的群消息会提示请求人改为私聊发起。当前 DSH-IM 不提供可核验的机器人进／出群发起者，所以不会因被拉群自动启用。不同群、话题和私聊的上下文默认隔离；群历史按需读取，默认先看十条、最多检查一百条平台记录，实际可见范围由飞书权限决定。
+群聊由所有者逐群启用普通聊天，任务授权再按卡单独设置。群里有人 @ 机器人后，群 ID 出现在插件列表；所有者也可手动填写群 ID。若所有者在群里，可先私聊机器人绑定飞书身份，再在群内提出“在本群启用聊天”，或按提示确认“在本群启用任务 任务名称”。群消息只在明确 @ 时处理，任务结果公开回复原群／原话题；要求私聊回复的群消息会提示请求人改为私聊发起。当前 DSH-IM 未提供可核验的机器人进／出群发起者，所以不会因被拉群自动启用。不同群、话题和私聊的上下文默认隔离；群历史按需读取，默认先看十条、最多检查一百条平台记录，实际可见范围由飞书权限决定。
 
-旧版指定 Gitea PR 审查授权仍可继续使用，默认由无工具的 DSH 会话处理。所有者可在本机手动将这类**差异审查**改为已安装的 Codex 或 Claude Code 子代理试用；ANT 固定任务模板和临时目录，不主动把 IM 原话或 Gitea 令牌传给子代理，但子代理沿用本机已有权限，可能读取本机凭证或修改文件，ANT 不能保证它只读。新任务卡仍只使用 DSH 文字会话，ACP 和 DSH SDK 子代理不能由 IM 自动启动。普通聊天与 DSH 文字任务的模型会话不提供文件、命令或网络工具；PR 参数的 Gitea 查证由本机 ANT Host 在授权后执行。机器人独占收件模式由 DSH-IM 保存；停止 ANT 授权后若需恢复 DSH-IM 原有聊天，需要在 DSH-IM 中切回普通模式。执行器边界见[本机权限记录](../../docs/decisions/2026-10-21-im-executor-boundary.md)。
+新建任务卡的 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 中切回普通模式。
 
 ## 企业精选技能