# feature/exec-interpreters 任务卡

任务主记录：Backend https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Backend/pulls/33 ；Dev https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/113 ；状态：已完成（回填）；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-exec-interpreters（worktree）；分支：feature/exec-interpreters
- 授权与交付终点：落地 run_shell / run_python 并打开 Backend 与 Dev PR。合入 main 由所有者执行。不恢复 write_docx。

## 目标与非目标

- 目标：注册 run_shell / run_python。脚本落盘到会话沙箱 .agent/ 并保留；解释器限 bash / python3 绝对路径；超时与请求取消先到者生效，超时杀掉进程组；非零退出与超时以文本返回。
- 附带：register_artifact 按扩展名写入 Office/PDF/图片 MIME，避免二进制被当成文本索引。
- 非目标：写侧护栏与 indexTextOf（feature/binary-doc-index）、预览嗅探、输入排队。

## 同步记录

| 节点 | sync_base_sha | tested_head_sha | checked_at |
|---|---|---|---|
| 启动 | 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3 | 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3 | 2026-10-01T03:58:48Z |
| 同步前验收 | 4c4071e5d8e256dd8f82ba9c74efa1effd1e9df3 | d62f6806d2 | 2026-10-01T04:04:49Z |

## 结果与验证

- 结果：Backend feature/exec-interpreters @ 2880b58 注册两个执行器，并在 app.go 挂上。
- 验证：Backend `go test ./...` 19 包 ok（含 echo 留痕、空脚本、runtime.exec 闸、进程组超时、python ZIP 魔数、register_artifact 回填）。Dev `make test` 通过：core、backend、frontend vitest 40、ui vitest 68、agent-command。
- 影响与剩余项：模型可执行工作区脚本并登记二进制交付物。合入顺序为 Backend PR 然后 Dev PR。部署后的真人模型验收留到所有者合入之后。

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

- 依据：merge 345d9db1e6486ec818c9b4f3c5139a903d4eee8b（PR #113）已包含于 origin/main，分支成果已落盘；本段为合入后回填。
- 合并主题：Merge pull request 'Point backend at run_shell and run_python executors' (#113) from feature/exec-interpreters into main
- 归档：随闭合移入 .task/archive/；任务执行期的过程证据见原任务记录与 PR。