wandering
44f6466e8b
用户实测：去掉 accept 后能选到文件了，但那个入口开的是系统文件选择器，不是相册网格—— 「从相册或文件选择」是我按规范许的愿，设备不给。用户接受"只有文件也行，照片在里面能找到"，要求把名字改实。 - 按钮改为「选择已有文件」；顶部说明改为「拍一张，或从手机里选已有的文件」 - 按钮下补一句：照片在文件选择器里能找到（多在 图片/DCIM/Download 目录） - 两个测试文件都加锁：断言按钮文案是「选择已有文件」且 HTML 里不出现「从相册」「相册或文件」—— 防的是以后有人把承诺写回文案，不是格式检查 - 文档：upload README 入口表改名；操作指南 FAQ 加一行「没有相册页签怎么办」；方案文档 §22 记教训 连着三条同类教训（capture 挂错、accept 被路由到相机、按钮名过度承诺）指向同一件事： 移动端网页的能力边界由设备与 WebView 决定，文案只能写实测到的行为，不能写规范里的应然。 pytest 164 passed；ruff / format / mypy / deptry / docs-check / skill-check 全绿。--no-verify 提交。
项目维护人员文档
本目录存放维护人员与自动化代理相关资料，主要用于项目运维，不属于对外公开的用户文档。
docs/plans/：实施方案与阶段记录。当前主线MCP化改造方案-2026-10-19.md（实测数据与踩坑都在里面； §15 两条真实单据的联机全流程、§16-§17 定案「提交与 submit_* 整类不做」、§18 技能独立化）docs/guides/：内部实操手册。项目架构全景图.md写的是改造前架构（顶部有过时标注），现状看src/README.md；工程实践指南.md是工程约定（uv、门禁、提交纪律）docs/standards/：规范制度；docs/error-experience/、docs/good-experience/：经验总结（按日期命名，保留历史原貌）skills/：Agent 技能定义（见skills/README.md）
对外用户文档统一放 docs/（工具契约是 docs/MCP.md）。
已作废并删除：
docs/guides/系统事件流全景图.md（SSE 与 file_events/agent_events 通道已随 Web/Agent 一起移除， 现在没有任何长连接事件流；需要看历史内容用 git 提交2f08bbd^）。