# feature/binary-doc-index 任务卡

任务主记录：Backend https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Backend/pulls/34 ；Dev https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/114 ；状态：已完成（回填）；owner：weichen

## 基线与授权

- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-binary-doc-index（worktree）；分支：feature/binary-doc-index
- 授权与交付终点：重放 #99 里仍然有效的两项（写侧护栏、二进制工件抽文本再索引）。不恢复 format=docx。合入顺序在 run_shell/run_python（Dev #113）之后。合入由所有者执行。

## 目标与非目标

- 目标：write_artifact 与 fs_write_file 拒绝 .doc/.docx/.xls/.xlsx/.xlsm/.ppt/.pptx/.pdf，文案指向 run_python + register_artifact。二进制 mime 的工件经 ingest.Parse 抽出文本后才进索引。
- 非目标：不带回 MarkdownToDocx 参数；不改上传路径的解析。

## 同步记录

| 节点 | sync_base_sha | tested_head_sha | checked_at |
|---|---|---|---|
| 启动 | 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3 | 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3 | 2026-10-01T04:10:44Z |

## 结果与验证

- 结果：Backend feature/binary-doc-index @ 3e5699c。Dev #99 与 Backend #27 已关闭并注明被 agent-native 路线取代。
- 验证：go test ./... 19 包 ok（含 Office 扩展拒绝、docgen docx 可检索、坏 ZIP 不入库）。Dev `make test` 通过（2026-10-01，sync_base=4c4071e）。
- 影响与剩余项：请在 Dev #113 合入后再合本 PR。
| 同步前验收 | 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3 | 90a3a1d722a69d3637f45f1a8c387077aff8d9cf | 2026-10-01T04:12:41Z |
| 同步前验收 | 4968f97b8531b90caa64534eae2a3bc8ec75bb5b | 46f89cf921fea1961b1176d1e3f288f7edcc0690 | 2026-10-01T05:25:41Z |
| 同步前验收 | 22ecacf3f7d4ba3cb38f449056e74957fb75c016 | e7140825d8985535a37a30381e28bb0df85c6ce3 | 2026-10-01T05:27:47Z |
| 同步前验收 | 8aef26aa4e2f781c4709d545effe014d7cb8e1c5 | 427263cee5f744b1cf88bc795b6c3165925cb0e7 | 2026-10-01T05:29:28Z |
| 同步前验收 | c3dd50c39e0393b6d11e63c46a2a33c3585d7816 | 3584792eb1a21b2573bd30ad673e0dac34fab70c | 2026-10-01T05:31:23Z |

## 闭合记录（card-autoclose 回填）

- 依据：merge 22ecacf3f7d4ba3cb38f449056e74957fb75c016（PR #114）已包含于 origin/main，分支成果已落盘；本段为合入后回填。
- 合并主题：Merge pull request 'Point backend at binary write guard and text indexing' (#114) from feature/binary-doc-index into main
- 归档：随闭合移入 .task/archive/；任务执行期的过程证据见原任务记录与 PR。