# 来源目录批量标注口径（S6 冻结）

本文件冻结“来源与目录”页批量标注（处理策略）的产品口径。后续任何页面、API 或测试改动与本文件冲突时，必须先修改本文件并经主人确认，不能悄悄改变行为。

## 冻结规则

```text
1. 文件和目录均可勾选。
2. 批量选择仅提供“全选当前页”；不提供“递归全选当前目录”。
3. 目录被单独勾选并标注后，策略递归作用于全部后代文件。
4. 顶部批量策略按钮仅提供三个：对内、对外、禁止导入。
5. 历史“对内 + 对外”（both）数据只读展示为“对内 + 对外”，
   顶部不提供该批量入口（P3/后续如要开放须先修订本文件）。
6. “未选择/未设置”仅在状态列显示，不生成任何专属批量按钮；
   批量按钮只在存在勾选节点时可用。
```

## 语义边界

- “标注”只写治理策略（`directory_scope_rules` / `source_item_scope_overrides`）与审计事件，
  不代表已上传、解析或发布。
- 目录标注写入目录级规则并递归生效；文件级覆盖（override）优先于最近的目录规则，
  目录规则优先于来源默认可见性。
- “禁止导入”表示从测试知识库移除（retrieval 进入 disabling），
  不删除来源文件，也不操作生产知识库。
- 每次用户动作使用一个新的 `Idempotency-Key`；网络重试复用原键（见 OpenAPI C4 契约）。

## 验收口径

1. UI：`catalog-policy-actions` 区域内恰好 3 个策略按钮（对内/对外/禁止导入）；
   页面不出现“递归全选当前目录”入口；不出现可选择的“对内 + 对外”批量控件。
2. Store 集成：标注一级目录后，其二级目录子项与深层文件的 effective visibility
   均递归变为该策略；进入子目录、返回父目录、刷新读回结果一致。
3. 历史 both 行在文件表中仍显示“对内 + 对外”，只读。

对应测试：
- `web/src/SourceCatalogBrowser.test.tsx`
- `internal/platform/postgres/s6_scope_policy_integration_test.go`