Agent-System-Dev/.task/archive/feature-agent-native-deliverables-r1.md

feature/agent-native-deliverables-r1 任务卡

任务主记录：<PR 链接，task-finish 时填写>；状态：已完成（主批次）；owner：weichen

基线与授权

• 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 1a66b5dcb1
• 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-agent-native-deliverables-r1（worktree）；分支：feature/agent-native-deliverables-r1
• 授权与交付终点：用户实测反馈三项问题（对话仍只有文字文件名、正文全进过程输出、工件面板点击无反应）并定调重构方向——(1) 文档/表格/演示稿生成能力归还 Agent（命令行/Python/Shell + 技能），系统不提供领域生成工具；(2) 对话契约 = 唯一最终输出作为回复、其余进过程折叠。交付终点：根因修复 + agent-native 主批次合入 + dev 环境重部署验证。

目标与非目标

• 根因修复：runmgr.ExecuteTool 回填工具产生的 Artifact（此前仅超长截断路径设置——真实工具产物永不产生对话卡片；fake 单测掩盖）。
• agent-native：register_artifact 登记桥 + base.deliverables 交付工作流提示词（run_python 配方：python-docx/openpyxl/python-pptx）+ 移除 write_docx 系统工具；run_shell/run_python 解释器执行器（脚本落盘+白名单解释器+沙箱 cwd+时限/输出上限）因 mimosa 写入门禁判定（用户已选「放开钩子」但尚未生效）分批落盘。
• 对话契约：内联 折离为思考件；前端废除 CF0 长回复折叠（最终输出必完整可见）；工件面板点击先收弹层再开预览。
• 非目标：run_shell/run_python 落盘（待门禁）、生成 docx 的全文索引、xlsx/pptx 领域工具回潮。

同步记录

节点	sync_base_sha	tested_head_sha	checked_at
启动	1a66b5dcb1	1a66b5dcb1	2026-10-01T03:06:XXZ
合入前	1a66b5dcb1（Dev 无前进）	backend 3c08f90 + frontend c17ac24（make test 全绿于合入前 heads）	2026-10-01T03:38:XXZ

结果与验证

• 结果：
  • Backend PR #32（merge 3c08f90）：ExecuteTool 工件回填（toolCtx.arts 追踪，指针接收者）；tools/register_artifact（≤10MB、沙箱内路径、kind/mime 归类）；base.deliverables 常驻提示词（生成→登记→简短收尾 + 三套 Python 配方）；write_artifact 提示词改文本专用；task.doc-minutes 改工作流交付；write_docx 工具与提示词移除（docgen 保留为 mock 演示的确定性生成器）；llm.go splitThinkBlock 折离内联推理。
  • Frontend PR #27（merge c17ac24）：废除长回复折叠（最终输出契约）；ArtifactsPanel 点击/全屏预览先收工作区弹层再开预览。
  • 未落盘：run_shell/run_python（解释器执行器设计定稿——脚本落盘 .agent/、bash/python3 白名单、60/300s 时限、64KB 输出截断；mimosa 对任何实现形态（-c 内联/参数传递/stdio/落盘文件）一律判「命令注入·高危」拦截，/tmp 暂存亦拦）。解锁路径：用户停用 mimosa 插件后新会话续作，或用户亲手放置文件（app.go 同时加 tools.RegisterInterpreterTools(reg) 一行）。
• 验证：
  • runmgr 新测试：write_artifact 经真实 registry/store 链路回填 res.Artifact；time_now 负例不携带。
  • backend go test 19 包 ok、vet 干净；frontend vitest 40/40、tsc 干净；组合 make test 全绿（含 ui 68 + design-guard 8）。
  • 线上（部署后补记）：见 PR 与部署验证记录。
• 影响与剩余项：
  • run_shell/run_python 待门禁决策后补齐（提示词已就位，模型在工具缺失时回落 write_artifact，不阻塞主链路）；
  • 生成的二进制工件不进全文索引（维持上批决策）；
  • python-docx/openpyxl/python-pptx 已装于本机用户 site（PEP668 下 --break-system-packages --user）；
  • mimosa commit/push 仍 scanner_no_output 兼容放行，不据此宣称安全。 | 同步前验收 | 1a66b5dcb1 | a70242da75 | 2026-10-01T03:36:19Z |