feat: 只保留 S3 一条路径 + 上限 800MB + 失败即回滚清空

用户裁决：严格禁止退回模式，只能 S3；失败给提示、撤回消息、清空页面；
大小上限统一 800MB，两台容器都要改。

App 侧：
- 删除 mxc 回退模式（SendMode 只留 url，历史 localStorage 键自动清除）
- CLOUD_LIMIT_BYTES: Infinity → 800MB，不再按模式分支
- 新增 rollbackSend()：移除刚插入的消息 + 文字回草稿 + 清空暂存附件
- 附件上传失败不再继续发文字（原来「附件失败不阻塞文字」）
- 失败走全局提示（原来只写 _error，正常会话看不到）

顺带修复：
- step-list 补 !turn().live，消除同一张卡内上下重复
- turnEnded 补 !isLastTurn，修复旧卡片计时不停

验证：tsc ✅ / 1783 SUCCESS / build ✅ / 线上 main-4GSYDIKS.js 一致

Co-Authored-By: Claude Code <noreply@anthropic.com>

docs/00-tracking/操作追踪.md

@@ -8255,3 +8255,19 @@ URL 不会重复显示：`chat.service.ts:2349` 的 `stripLinks` 会把已提取
 | **连带修复 2** | 模板/样式注释里**不能出现反引号**（`\``），Angular 会当表达式解析，报 `NG1001: Decorator argument must be literal` + 一串 `TS2304`。本次因注释里写了 `` `.seg-wait` `` 触发，已去掉 |
 | **测试** | 新增 2 条（非最后一轮必停、最后一轮命中即停）；改写 1 条（断言 `.seg-wait` 数量为 0、`.card-wait` 存在） |
 | **验证** | `tsc` ✅ / `npm test` **1784 SUCCESS** / `build` ✅ / 线上 `main-TYUGNXKE.js` 与本地一致 |
+
+## 2026-11-14（续十）· 只保留 S3 一条路径 + 上限统一 800MB + 失败即回滚
+
+| 项 | 内容 |
+|---|---|
+| **用户裁决** | ① 严格禁止退回模式，**只能 S3** ② 失败必须给出提示 ③ 撤回输出以及回复 ④ 清空会话页面 ⑤ 大小上限改 **800MB**，两台都改 |
+| **App·删 mxc 回退** | `send-mode.ts` 重写：`SendMode` 只留 `'url'`，`fmode.sendMode='mxc'` 的历史键读取时**自动清除**。同步清掉 4 处死分支（`chat.service` / `group-send.service` / `groups.ts` / `upload-limits`） |
+| **App·上限 800MB** | `CLOUD_LIMIT_BYTES` 从 `Infinity` 改为 `800 * 1024 * 1024`；`uploadLimitBytes()` 不再按模式分支，恒取该值 |
+| **App·失败即回滚** | 新增 `rollbackSend()`：① 移除刚插入的我方消息 ② 文字还回草稿 ③ 清空暂存附件。`uploadPending` 失败后**不再继续发文字**，直接 return |
+| **App·失败必提示** | 原来只写 `_error`（仅在 error 空态渲染，用户看不到）→ 改为同时走 `alerts.show()` 全局提示：「附件只走云盘直链，不会退回其它通道 —— 本条消息未发送」 |
+| **App·重复渲染修复** | `step-list` 的渲染条件补 `!turn().live`（原来只判 `expanded() && stepCount > 0`），执行中只由 `app-live-activity` 承担 → 消除「同一张卡内上下重复」 |
+| **App·计时不停修复** | `turnEnded` 补判据 `!isLastTurn`：非最后一轮一律视为已结束（`turnEndedAfter` 只存一个 id，多轮必被覆盖导致严格相等永远失败） |
+| **容器·上限** | lj-test 已改：`fmode-deliverable-hook.py:124` → `MAX_BYTES = int(os.environ.get("FMODE_DELIVERABLE_MAX_BYTES", str(800 * 1024 * 1024)))` |
+| **容器·40MB 真相** | 该限制在 **`fmode-deliverable-hook.py`**，是交付物进队的门槛（超限就不进队列 → 不产生 https → 出站报 `no-preuploaded-url`）。**注意：这台文件 kangshifu 侧不存在**，两台底座确有差异 |
+| **验证** | `tsc` ✅ / `npm test` **1783 SUCCESS** / `build` ✅ / 线上 `main-4GSYDIKS.js` 与本地一致 |
+| **未完成** | kangshifu 侧的 40MB 定位与 mxc 分支删除仍在进行；两台最终一致性尚未比对 |

docs/03-interface/kangshifu-文件链路梳理-回答.md

@@ -0,0 +1,618 @@
+# 容器取证问答：agent-node-kangshifu
+
+- 时间：2026-11-14T08:19:31.534Z
+- 房间：`!HkH3Pa-Nv8t30_9wWLblLpAuWMUpuzoa6D19ItKnPh8`（临时房间，可保留查阅）
+- 消息统计：正文 17 段 / 工具过程 1 段 / 文件 0 个
+- 结束原因：收到 ✅ reaction
+
+## 我发出的问题
+
+```text
+# 梳理：文件传输的完整链路（找出为什么会有多个上限、多条路径）
+
+用户裁决：
+1. 文件**不能**通过 Matrix 传输，必须是 S3 链接
+2. **取消上传大小上限**，改为 800MB
+3. lj-test 和 kangshifu **都要改**
+4. **先梳理，再设计**，不要直接改
+
+---
+
+# 一、请如实回答这几个问题（只读）
+
+## Q1：App → 容器，文件到底怎么过去的
+
+**这是用户最关心的一点**：文件本体到底有没有经过 Matrix？
+
+```bash
+# 看入站媒体插件如何处理 App 发来的 m.file
+ls -la /opt/data/plugins/plugin-matrix-inbound-s3/ 2>/dev/null
+grep -n "def \|mxc\|download\|fetch\|http" /opt/data/plugins/plugin-matrix-inbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：
+- App 发来 `m.file`，`url` 字段是 `https://s3...` 还是 `mxc://`？
+- 容器是**直接下载那个 https URL**，还是先转成 mxc 再下载？
+- **文件本体有没有经过 Matrix 服务器？**
+
+## Q2：容器 → App，文件怎么过去的
+
+```bash
+grep -n "def \|send_content_event\|msg_content\|url" /opt/data/plugins/plugin-matrix-outbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：发出去的 `m.file` 里，`url` 是 https 还是 mxc？文件本体经过 Matrix 吗？
+
+## Q3：现在有几处大小限制（全部列出来）
+
+```bash
+echo "=== App 侧（我不知道，你只看容器侧）==="
+grep -rn "max_media_bytes\|MAX_FILE_BYTES\|max_inbound\|max_size\|too large\|oversize\|104857600\|20971520" \
+  /opt/data/plugins/ /opt/data/scripts/ /opt/data/config.yaml /opt/data/.env 2>/dev/null | grep -v ".pyc" | head -30
+
+echo "=== Hermes 内核默认值 ==="
+grep -rn "DEFAULT_INBOUND_MEDIA_MAX_BYTES\|_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" \
+  /opt/hermes/ 2>/dev/null | head -20
+```
+
+**要回答**：把所有限制列成表 —— 哪个文件、哪一行、值是多少、在哪一步生效。
+
+## Q4：超限时的行为
+
+```bash
+grep -rn "Rejecting oversized\|too large\|oversize" /opt/hermes/ /opt/data/plugins/ 2>/dev/null | head -20
+```
+
+**要回答**：超限时是**静默丢弃**还是**回复用户**？
+
+---
+
+# 二、我这边已知的事实（供你对照）
+
+| 项 | App 侧现状 |
+|---|---|
+| App → 容器 | `sendFileByUrl()`：先传云盘，事件里 `url = https://s3...`，**文件本体不进 Matrix** |
+| 容器 → App | 容器发 `m.file`，`url = https://s3.../deliverables/...` |
+| App 侧大小限制 | `CLOUD_LIMIT_BYTES = Infinity`（**不限制**） |
+
+**所以 App 侧本来就是「只传链接」。** 需要确认容器侧是不是也这样。
+
+---
+
+# 三、回答格式
+
+```
+## Q1 App → 容器
+url 字段 = https / mxc
+文件本体经过 Matrix 吗 = 是/否
+代码位置 = ?
+
+## Q2 容器 → App
+url 字段 = https / mxc
+文件本体经过 Matrix 吗 = 是/否
+代码位置 = ?
+
+## Q3 所有大小限制
+| 文件:行号 | 值 | 在哪一步生效 |
+|---|---|---|
+| ... | ... | ... |
+
+## Q4 超限行为
+静默 / 回复用户 = ?
+代码位置 = ?
+```
+
+🔴 只要事实和代码原文。**不要提建议，先梳理清楚。**
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+收到。这一轮只做只读检查：先查这四处代码路径，再按 Q1–Q4 给您代码原文。
+```
+
+### 2【prose】
+
+```text
+```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+
+### 3【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+```
+
+### 4【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+💻 terminal
+```
+grep -rn "_max_media_bytes\|max_media...
+```
+📖 Reading __init__.py L309-428
+```
+
+### 5【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+💻 terminal
+```
+grep -rn "_max_media_bytes\|max_media...
+```
+📖 Reading __init__.py L309-428
+💻 terminal
+```
+which hermes 2>/dev/null; ls -d /opt/...
+```
+```
+grep -rn "MATRIX_MAX_MEDIA_BYTES\|mat...
+```
+```
+
+### 6【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+💻 terminal
+```
+grep -rn "_max_media_bytes\|max_media...
+```
+📖 Reading __init__.py L309-428
+💻 terminal
+```
+which hermes 2>/dev/null; ls -d /opt/...
+```
+```
+grep -rn "MATRIX_MAX_MEDIA_BYTES\|mat...
+```
+```
+sym=/usr/local/lib/python3.13/dist-pa...
+```
+```
+grep -rn "hermes" /opt/data/config.ya...
+```
+```
+
+### 7【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+💻 terminal
+```
+grep -rn "_max_media_bytes\|max_media...
+```
+📖 Reading __init__.py L309-428
+💻 terminal
+```
+which hermes 2>/dev/null; ls -d /opt/...
+```
+```
+grep -rn "MATRIX_MAX_MEDIA_BYTES\|mat...
+```
+```
+sym=/usr/local/lib/python3.13/dist-pa...
+```
+```
+grep -rn "hermes" /opt/data/config.ya...
+```
+```
+sed -n '870,900p' /opt/hermes/plugins...
+```
+```
+grep -rn "matrix_platform\|sys.path.i...
+```
+```
+
+### 8【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+💻 terminal
+```
+grep -rn "_max_media_bytes\|max_media...
+```
+📖 Reading __init__.py L309-428
+💻 terminal
+```
+which hermes 2>/dev/null; ls -d /opt/...
+```
+```
+grep -rn "MATRIX_MAX_MEDIA_BYTES\|mat...
+```
+```
+sym=/usr/local/lib/python3.13/dist-pa...
+```
+```
+grep -rn "hermes" /opt/data/config.ya...
+```
+```
+sed -n '870,900p' /opt/hermes/plugins...
+```
+```
+grep -rn "matrix_platform\|sys.path.i...
+```
+```
+find / -name "matrix_platform*" -not ...
+```
+```
+sed -n '1440,1530p' /opt/hermes/plugi...
+```
+```
+
+### 9【prose】
+
+```text
+...
+```
+
+### 10【prose】
+
+```text
+* ```
+grep -n "def \|mxc\|download\|fetch\|...
+```
+```
+grep -n "def \|send_content_event\|ms...
+```
+📖 Reading __init__.py L196-315
+💻 terminal
+```
+grep -rn "_max_media_bytes\|max_media...
+```
+📖 Reading __init__.py L309-428
+💻 terminal
+```
+which hermes 2>/dev/null; ls -d /opt/...
+```
+```
+grep -rn "MATRIX_MAX_MEDIA_BYTES\|mat...
+```
+```
+sym=/usr/local/lib/python3.13/dist-pa...
+```
+```
+grep -rn "hermes" /opt/data/config.ya...
+```
+```
+sed -n '870,900p' /opt/hermes/plugins...
+```
+```
+grep -rn "matrix_platform\|sys.path.i...
+```
+```
+find / -name "matrix_platform*" -not ...
+```
+```
+sed -n '1440,1530p' /opt/hermes/plugi...
+```
+```
+sed -n '490,520p' /opt/hermes/gateway...
+```
+```
+echo "=== cache funcs enforcing cap =...
+```
+```
+
+### 11【prose】
+
+```text
+```
+echo "=== adapter 2130-2160 inbound s...
+```
+```
+sed -n '575,595p;650,695p' /opt/herme...
+```
+```
+
+### 12【prose】
+
+```text
+* ```
+echo "=== adapter 2130-2160 inbound s...
+```
+```
+sed -n '575,595p;650,695p' /opt/herme...
+```
+```
+echo "=== config.yaml keys (no secret...
+```
+```
+echo "=== which python runs gateway /...
+```
+```
+
+### 13【prose】
+
+```text
+* ```
+echo "=== adapter 2130-2160 inbound s...
+```
+```
+sed -n '575,595p;650,695p' /opt/herme...
+```
+```
+echo "=== config.yaml keys (no secret...
+```
+```
+echo "=== which python runs gateway /...
+```
+```
+echo "=== outbound 180-210 ==="; sed ...
+```
+```
+echo "=== running process ==="; ps au...
+```
+```
+
+### 14【prose】
+
+```text
+* ```
+echo "=== adapter 2130-2160 inbound s...
+```
+```
+sed -n '575,595p;650,695p' /opt/herme...
+```
+```
+echo "=== config.yaml keys (no secret...
+```
+```
+echo "=== which python runs gateway /...
+```
+```
+echo "=== outbound 180-210 ==="; sed ...
+```
+```
+echo "=== running process ==="; ps au...
+```
+```
+echo "=== E2EE mode in .env (value on...
+```
+```
+ps aux | grep "gateway run" | grep -v...
+```
+```
+
+### 15【prose】
+
+```text
+* ```
+echo "=== adapter 2130-2160 inbound s...
+```
+```
+sed -n '575,595p;650,695p' /opt/herme...
+```
+```
+echo "=== config.yaml keys (no secret...
+```
+```
+echo "=== which python runs gateway /...
+```
+```
+echo "=== outbound 180-210 ==="; sed ...
+```
+```
+echo "=== running process ==="; ps au...
+```
+```
+echo "=== E2EE mode in .env (value on...
+```
+```
+ps aux | grep "gateway run" | grep -v...
+```
+```
+echo "=== document cache func ==="; g...
+```
+```
+tr '\0' '\n' < /proc/161280/environ 2...
+```
+```
+
+### 16【prose】
+
+```text
+* ```
+echo "=== adapter 2130-2160 inbound s...
+```
+```
+sed -n '575,595p;650,695p' /opt/herme...
+```
+```
+echo "=== config.yaml keys (no secret...
+```
+```
+echo "=== which python runs gateway /...
+```
+```
+echo "=== outbound 180-210 ==="; sed ...
+```
+```
+echo "=== running process ==="; ps au...
+```
+```
+echo "=== E2EE mode in .env (value on...
+```
+```
+ps aux | grep "gateway run" | grep -v...
+```
+```
+echo "=== document cache func ==="; g...
+```
+```
+tr '\0' '\n' < /proc/161280/environ 2...
+```
+```
+echo "=== 1) .env 里所有 media/size/limi...
+```
+```
+
+### 17【prose】
+
+```text
+全部只读核查已完成。以下是**代码原文事实**。
+
+## Q1 App → 容器
+
+**url 字段 = `https`**（``）
+**文件本体经过 Matrix 吗 = 否**
+**代码位置** = 
+
+上游原版 `/opt/hermes/plugins/platforms/matrix/adapter.py:2138-2141` 会写死拒收：
+```python
+url = source_content.get("url", "")
+if url and not str(url).startswith("mxc://"):
+    logger.warning("[Matrix] Rejecting inbound media %s with non-MXC URL", event_id)
+    return
+```
+本插件 `__init__.py:45` 白名单只放行精确的 host：
+```python
+FMODE_MEDIA_HOSTS = frozenset({"s3.fmode.cn"})
+```
+`__init__.py:168-183` 处，入口会无条件包一层，并直接把 `https_url` 交给自己的 `_handle_https_media`，**不会**转成 mxc：
+```python
+if _u and not str(_u).startswith("mxc://"):
+    https_url = str(_u)
+if https_url:
+    return await _handle_https_media(self, ..., https_url)
+```
+`__init__.py:272-274` 直接对那个 https URL 发 GET，并显式禁止重定向：
+```python
+async with http.get(url, timeout=aiohttp.ClientTimeout(total=120), allow_redirects=False, **req_kw) as resp:
+```
+**结论：文件本体从 App 直达 S3 再到容器，从不进入 Matrix 服务器。** 已核实的依据还有：`MATRIX_E2EE_MODE=off`，进程 161280 的 environ 中无 `MATRIX_MAX_MEDIA_BYTES`。
+
+## Q2 容器 → App
+
+**url 字段 = `https`**（`https://s3.fmode.cn/deliverables/...`）
+**文件本体经过 Matrix 吗 = 否**
+**代码位置** = 
+
+插件文件头 `:1-7` 即写明：「事件 content.url 直接写 https 直链，**不调 upload_media**」。
+`:281-290` 拼事件体，`url` 用的就是 S3 直链：
+```python
+msg_content = {
+    "msgtype": msgtype, "body": caption or filename,
+    "url": url,
+    "info": {"mimetype": content_type, "size": len(data)},
+```
+`:302` 直接发事件，不经过 upload：`return await self._send_content_event(room_id, msg_content)`
+`:249-251` 还有强校验：只要不是 `` 开头就拒发：
+```python
+if not url.startswith(""):
+    return self._fmode_outbound_fail("bad deliverables url: %s" % url)
+```
+**唯一例外（会让文件进 Matrix）**：`:196-203` E2EE 房间会回退到上游走 mxc。当前 `E2EE_MODE=off`，这条分支未启用。
+
+## Q3 所有大小限制（全部）
+
+| 文件:行号 | 值 | 在哪一步生效 |
+|---|---|---|
+| `plugin-matrix-inbound-s3/__init__.py:262` | `max_bytes = 50 * 1024 * 1024`（50 MiB） | **入站下载**。在 `_fetch_and_cache_attachment` 里硬编码，与 env 无关 |
+| `plugin-matrix-inbound-s3/__init__.py:282-283` | 同上 50 MiB | 入站 Content-Length 预检，超出就 `raise ValueError("media exceeds size limit")` |
+| `plugin-matrix-inbound-s3/__init__.py:288-289` | 同上 50 MiB | 入站流式累加，超出就 raise |
+| `plugin-matrix-inbound-s3/__init__.py:325-329` | `self._max_media_bytes`（见下，实际 100 MiB） | 入站事件 `info.size` 预检，超出直接 return（更早于上一条） |
+| `/opt/hermes/plugins/platforms/matrix/adapter.py:884` | `_env_number("MATRIX_MAX_MEDIA_BYTES", 100 * 1024 * 1024)` → **100 MiB**（env 未设，取默认） | 适配器级总闸，入站+出站都读它 |
+| `adapter.py:2144-2147` | 100 MiB | 上游入站事件 size 预检（被插件的 325 行先行拦截） |
+| `adapter.py:1514-1515` | 100 MiB | `_download_external_media_with_cap` Content-Length 预检（仅 image） |
+| `adapter.py:1520-1521` | 100 MiB | 同上，流式累加 |
+| `adapter.py:1745` | 100 MiB | `_upload_and_send` 开头上限判断 |
+| `adapter.py:1817` | 100 MiB | `_send_local_file` 读盘前 `p.stat.st_size` 判断 |
+| `adapter.py:1793` | 100 MiB | `_media_too_large` 组装错误文案 |
+| `plugin-matrix-outbound-s3/__init__.py:186-188` | `self._max_media_bytes`（100 MiB） | **出站上传前**判断，复用上游取值 |
+| `/opt/hermes/gateway/platforms/base.py:504` | `DEFAULT_INBOUND_MEDIA_MAX_BYTES = 128 * 1024 * 1024`（128 MiB） | 兜底终局。实测 `get_inbound_media_max_bytes` = **134217728** |
+| `base.py:586 / 657 / 685 / 526-539` | 128 MiB | `cache_image/audio/video_from_bytes` + `_cache_media_from_url` 真正落盘前 |
+| `base.py:1428-1441` `cache_document_from_bytes` | **无任何大小校验** | 文档类落盘不过闸 |
+
+**上限汇总：链路上一共有 50 MiB（入站，插件硬编码）、100 MiB（适配器级，env 可调）和 128 MiB（gateway 兜底）三重限制，实际瓶颈是 50 MiB。**
+另外确认：`uploader.mjs` 与 `fmode-app-deliver.py` **均无大小上限**（无命中）； 与 `config.yaml` 中**没有任何** media/size 键，故 100 MiB 全靠默认值。
+
+## Q4 超限行为
+
+**入站 = 静默丢弃（不回复用户）**，只在服务端记一条 warning。
+- 位置 1，事件预检：`plugin-matrix-inbound-s3/__init__.py:326-329`
+```python
+if event_size_int and max_bytes and event_size_int > max_bytes:
+    logger.warning("[Matrix] Rejecting oversized inbound media %s (%d > %d bytes)", event_id, event_size_int, max_bytes)
+    return
+```
+- 位置 2，下载抛错后被兜住：`:338-340`
+```python
+except Exception as e:
+    logger.warning("[Matrix] Failed to cache https media %s: %s", event_id, e)
+    return
+```
+同一层路径 `:342-344` 缓存无路径时也只 warning + return。
+
+**上游同款**（`adapter.py:2144-2147`）：`logger.warning(...)` 后 `return`，同样静默。
+
+**出站 = 返回失败，但用户看不到**：`adapter.py:1789-1793`
+```python
+def _media_too_large(self, size: int) -> SendResult:
+    return SendResult(success=False, error=f"Media file exceeds Matrix limit ({size} > {self._max_media_bytes} bytes)")
+```
+出站侧由 `plugin-matrix-outbound-s3/__init__.py:186-188` 沿用同一判断，返回的 `SendResult(success=False)` 不会变成聊天里的一条提示。
+
+## 补充事实：为什么会有多条路径
+
+- **两套入站入口并存**：上游原版只认 `mxc://`，本插件是运行时 monkey-patch 出来的旁路（`plugin.yaml` 自述不修改 `/opt/hermes` 只读上游）。所以插件 `_handle_https_media` 是「复刻上游流程」，代码里同样保留了一份 100 MiB 判断（325 行）和一份自己的 50 MiB（262 行）。
+- **三重阈值不同源**：50 MiB 是插件作者自定；100 MiB 是 Hermes 适配器默认（可由 `MATRIX_MAX_MEDIA_BYTES` 覆盖，当前未设）；128 MiB 是 gateway 平台层的内存保护默认（可由 `config.yaml: gateway.max_inbound_media_bytes` 覆盖，当前未设）。
+- **文档类不过 gateway 闸**：`cache_document_from_bytes` 无校验，所以 `.pdf/.xlsx/.md` 等只受 50 MiB 和 100 MiB 约束；图片音视频还会被 128 MiB 兜一层。
+- **出站文档中提到的另一处 8 MiB**：`plugin-fmode/plugin/fmode_core/security.py:48 MAX_FILE_BYTES = 8MB` 是**安全扫描**跳过阈值，与传输无关，但同一份配置里易混淆。
+
+以上均为只读检查：未改动任何文件、未重启服务、未写入存储。
+```
+
+### 18【ack】
+
+```text
+✅ 容器已标记完成
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` ls -la /opt/data/plugins/ 2>/dev/null... ````

docs/03-interface/ksf-40MB核实-回答.md

@@ -0,0 +1,233 @@
+# 容器取证问答：agent-node-kangshifu
+
+- 时间：2026-11-14T08:38:55.963Z
+- 房间：`!NYpVRa-RcmYIMyhc5qGmYNYl2DiWxvjenAgfM2QSgI0`（临时房间，可保留查阅）
+- 消息统计：正文 6 段 / 工具过程 1 段 / 文件 0 个
+- 结束原因：收到 ✅ reaction
+
+## 我发出的问题
+
+```text
+# 40MB 这个限制，到底在哪台、哪个文件？
+
+## 我收到的两份矛盾反馈
+
+**lj-test 说：**
+> `fmode-deliverable-hook.py:124,159` → `MAX_BYTES = 40 * 1024 * 1024`
+> `classify()` 返回 `(False, "too-large(>40MB)")` → 文件不进交付物队列
+
+**kangshifu 说：**
+> 「`fmode-deliverable-hook.py` 并不存在」「我确认了事实：40MB 在磁盘上并不存在」
+
+---
+
+# 两条都要给证据（只读，原样贴输出）
+
+## 1. 列出所有 py 里含 40MB / 41943040 的地方
+
+```bash
+grep -rn "40 \* 1024 \* 1024\|41943040\|40MB\|too-large" \
+  /opt/data/scripts/ /opt/data/plugins/ /opt/data/*.py 2>/dev/null | grep -v ".pyc"
+```
+
+## 2. 你这台到底有哪些 deliver 相关脚本
+
+```bash
+ls -la /opt/data/scripts/*deliver* /opt/data/scripts/*artifact* 2>/dev/null
+```
+
+## 3. 所有大小上限（含 100MB 那些）
+
+```bash
+grep -rn "1024 \* 1024" /opt/data/scripts/ /opt/data/plugins/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+## 4. Hermes 内核的 100MB
+
+```bash
+grep -n "_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" /opt/hermes/*/adapter.py /opt/hermes/**/adapter.py 2>/dev/null | head -10
+ls -la /opt/hermes/*/adapter.py /opt/hermes/**/*/adapter.py 2>/dev/null | head -5
+```
+
+---
+
+# 回答格式
+
+```
+## 1. 40MB 命中
+<grep 原文输出>
+
+## 2. deliver 脚本清单
+<ls 原文>
+
+## 3. 所有 1024*1024 上限
+<grep 原文>
+
+## 4. 内核 100MB
+<grep 原文>
+
+## 结论
+40MB 在这台存在吗 = 是/否
+如果存在，在哪个文件:行号 = ?
+```
+
+🔴 原样贴输出，不要总结、不要推测。
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+I'll run all four checks now — read-only, no writes.
+```
+
+### 2【prose】
+
+```text
+```
+ls -la /opt/data/scripts/*deliver* /o...
+```
+```
+grep -rn "1024 \* 1024" /opt/data/scr...
+```
+```
+
+### 3【prose】
+
+```text
+四个都跑完了。第 4 条 grep 的路径可能是 `/opt/hermes/gateway/relay/adapter.py`，我再补跑一次，确认其中 100MB 的具体位置，避免出现「空输出」的误判。
+```
+
+### 4【prose】
+
+```text
+* ```
+ls -la /opt/data/scripts/*deliver* /o...
+```
+```
+grep -rn "1024 \* 1024" /opt/data/scr...
+```
+```
+grep -n "_max_media_bytes\|MATRIX_MAX...
+```
+```
+grep -rn "_max_media_bytes\|MATRIX_MA...
+```
+```
+
+### 5【prose】
+
+```text
+```
+echo "=== 全盘找 fmode-deliverable-hook....
+```
+```
+
+### 6【prose】
+
+```text
+## 1. 40MB 命中
+
+第一条命令（你给的原始路径）：
+
+```
+$ grep -rn "40 \* 1024 \* 1024\|41943040\|40MB\|too-large"    2>/dev/null | grep -v ".pyc"
+(空)
+
+exit_code: 1
+exit_code_meaning: No matches found (not an error)
+```
+
+再加一次全  递归（不限 extensions）：
+
+```
+$ find / -name "fmode-deliverable-hook*" -not -path "*/proc/*" 2>/dev/null
+(空)
+=== 结束 ===
+$ grep -rn "40 \* 1024 \* 1024\|41943040"  2>/dev/null | grep -v ".pyc" | head -20
+(空)
+=== 结束2 ===
+```
+
+## 2. deliver 脚本清单
+
+```
+$ ls -la   2>/dev/null
+
+-rw-r--r-- 1 hermes hermes 12647 Nov 14 15:57 
+-rw-r--r-- 1 hermes hermes 16576 Nov 14 15:53 
+-rw-r--r-- 1 hermes hermes  1857 Nov 14 08:45 
+```
+
+三个文件里**没有** `fmode-deliverable-hook.py`。
+
+## 3. 所有 1024*1024 上限
+
+```
+        "_max_media_bytes": 50 * 1024 * 1024,
+        "_max_media_bytes": 50 * 1024 * 1024,
+        "_max_media_bytes": 50 * 1024 * 1024,
+                v(mb * 1024 * 1024, media_type="probe")
+ = 8 * 1024 * 1024  # 单文件超过 8MB 跳过(只读扫描不冒险读大文件)
+ = 800 * 1024 * 1024
+ = 800 * 1024 * 1024
+```
+
+## 4. 内核 100MB
+
+你给的路径 `/opt/hermes/*/adapter.py` 是空（真实路径多两层）。扩到全 `/opt/hermes/` 后：
+
+```
+$ grep -rn "_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" /opt/hermes/ 2>/dev/null | grep -v ".pyc" | head -20
+/opt/hermes/plugins/platforms/matrix/adapter.py:14:  MATRIX_MAX_MEDIA_BYTES, MATRIX_ROOM_IDENTITY_TTL_SECONDS; MATRIX_APPROVAL_REQUIRE_SENDER (default
+/opt/hermes/plugins/platforms/matrix/adapter.py:884:        self._max_media_bytes = _env_number("MATRIX_MAX_MEDIA_BYTES", 100 * 1024 * 1024, int)
+/opt/hermes/plugins/platforms/matrix/adapter.py:1461:            "media": {"max_media_bytes": self._max_media_bytes}}
+/opt/hermes/plugins/platforms/matrix/adapter.py:1514:            if size is not None and size > self._max_media_bytes:
+/opt/hermes/plugins/platforms/matrix/adapter.py:1515:                raise ValueError(f"media exceeds Matrix limit ({size} > {self._max_media_bytes} bytes)")
+/opt/hermes/plugins/platforms/matrix/adapter.py:1520:                if total > self._max_media_bytes:
+/opt/hermes/plugins/platforms/matrix/adapter.py:1521:                    raise ValueError(f"media exceeds Matrix limit (> {self._max_media_bytes} bytes)")
+/opt/hermes/plugins/platforms/matrix/adapter.py:1745:        if len(data) > self._max_media_bytes:
+/opt/hermes/plugins/platforms/matrix/adapter.py:1793:            success=False, error=f"Media file exceeds Matrix limit ({size} > {self._max_media_bytes} bytes)")
+/opt/hermes/plugins/platforms/matrix/adapter.py:1817:        if file_size > self._max_media_bytes:
+/opt/hermes/plugins/platforms/matrix/adapter.py:2144:        if event_size_int and event_size_int > self._max_media_bytes:
+/opt/hermes/plugins/platforms/matrix/adapter.py:2147:                self._max_media_bytes)
+```
+
+`ls` 原文：
+
+```
+$ ls -la /opt/hermes/*/adapter.py /opt/hermes/**/*/adapter.py 2>/dev/null | head -5
+-rw-r--r-- 1 root root 119606 Sep 19 00:36 /opt/hermes/gateway/relay/adapter.py
+```
+
+注意：`/opt/hermes/gateway/relay/adapter.py` 里 **无** `_max_media_bytes` 命中（grep 输出里一条都没有它）。100MB 只出现在 `/opt/hermes/plugins/platforms/matrix/adapter.py:884`。
+
+## 结论
+
+**40MB 在这台存在吗 = 否**
+
+- `40 * 1024 * 1024` / `41943040` / `too-large` 在  全盘递归 0 命中。
+- `fmode-deliverable-hook.py` 全盘 `find` 0 命中 —— 这台上不存在这个文件，所以 lj-test 说的 `:124,159 MAX_BYTES = 40 * 1024 * 1024` 在**这台机器上**无法复现，它描述的应是另一台（lj-test 自己那台）的情况。
+- 如果存在，在哪个文件:行号 = **不适用（本机无此文件、无此常量）**
+
+本机实际存在的相关上限（供对照，非 40MB）：
+- Matrix 内核 media 上限 100MB → `/opt/hermes/plugins/platforms/matrix/adapter.py:884`
+- matrix outbound/inbound S3 插件 800MB → `plugin-matrix-outbound-s3/__init__.py:40`、`plugin-matrix-inbound-s3/__init__.py:51`
+- fmode 只读扫描跳过阈值 8MB → `plugin-fmode/plugin/fmode_core/security.py:48`
+- `_archive-20261114/` 里三个探针脚本写的是 50MB（归档，非生产路径）
+
+写入影响面：0（4 条只读 grep + 1 条 ls + 1 条 find，未建文件、未改库、未建会话）。
+```
+
+### 7【ack】
+
+```text
+✅ 容器已标记完成
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` grep -rn "40 \* 1024 \* 1024\|4194304... ````

docs/03-interface/ksf-800MB-回答.md

@@ -0,0 +1,848 @@
+# 容器取证问答：agent-node-kangshifu
+
+- 时间：2026-11-14T08:37:50.964Z
+- 房间：`!zGEDhNH5G0SyU5oIGVN_duPOH54cubog0JQorTkfA9U`（临时房间，可保留查阅）
+- 消息统计：正文 67 段 / 工具过程 20 段 / 文件 0 个
+- 结束原因：静默超时
+
+## 我发出的问题
+
+```text
+# 容器侧改造：只保留 S3 一条路径 + 上限统一 800MB
+
+用户裁决原文：
+
+> **严格禁止退回模式，只能有 s3 的模式。如果失败给出提示，并且撤回输出以及回复，清空会话页面。**
+
+> **文件不能设置上传的大小上限，修改为 800MB。lj-test 和 ksf 都需要优化。**
+
+---
+
+# 必须做到的四件事
+
+## 一、只保留 S3 一条路径
+
+### 1.1 入站：删掉 mxc 分支
+
+你梳理出的现状：
+
+> 「入站有**两条**并存的 URL 通道：`mxc://`（Matrix 中转）与 `https://`（直读 S3），
+>  闸门是二选一的白名单，不是只留一条。」
+
+**改成：只接受 `https://` 的云盘地址，`mxc://` 一律拒绝。**
+
+```python
+# 入站处理里，凡是判断 url 类型的地方，改成：
+if url.startswith("mxc://"):
+    log("REJECT inbound mxc（附件只允许云盘直链）: %s" % url)
+    # 🔴 必须回复用户，不能静默
+    reply_to_user("收到的附件不是云盘直链，已拒绝。请让 App 重新发送。")
+    return
+```
+
+### 1.2 出站：删掉 E2EE 的 mxc 分支
+
+你说：
+
+> 「出站有**两条**产 url 的路径：复用 `pushed[]` 已有 https（主路径），
+>  与 E2EE 下 `upload_media` 产 mxc（例外路径）。」
+
+🔴 **E2EE 这条也是 mxc —— 一并删掉。**
+本项目不使用 E2EE 房间，这条分支永远走不到，留着只会误导。
+
+```python
+# 删掉 needs_encrypted 分支里的 mxc 逻辑
+# 统一改成：
+media_url = _preuploaded_lookup(filename, len(upload_data))
+if not media_url:
+    log("FAIL outbound: 没有可用的云盘直链（filename=%s）" % filename)
+    return _fail("no-preuploaded-url")   # 出站失败要有明确错误
+```
+
+---
+
+## 二、上限统一 800MB（7 处全改）
+
+你梳理出的清单，**每一处都要改**：
+
+| 文件:行号 | 现值 | 改成 |
+|---|---|---|
+| `adapter.py:905` | `100 * 1024 * 1024` | **`800 * 1024 * 1024`** |
+| **`fmode-deliverable-hook.py:159`** | **`40 * 1024 * 1024`** | **`800 * 1024 * 1024`** ← **真瓶颈** |
+| `outbound-s3:253` | 读 `_max_media_bytes` | 跟随上面的值 |
+
+**建议做法**（避免以后再改 7 处）：
+
+```python
+# adapter.py
+MAX_MEDIA_BYTES = int(os.environ.get("MATRIX_MAX_MEDIA_BYTES", str(800 * 1024 * 1024)))
+self._max_media_bytes = MAX_MEDIA_BYTES
+
+# fmode-deliverable-hook.py
+MAX_BYTES = int(os.environ.get("FMODE_DELIVERABLE_MAX_BYTES", str(800 * 1024 * 1024)))
+```
+
+**并在 `/opt/data/.env` 里显式写上这两个值**（不要只靠代码默认，便于以后调整）：
+
+```
+MATRIX_MAX_MEDIA_BYTES=838860800
+FMODE_DELIVERABLE_MAX_BYTES=838860800
+```
+
+---
+
+## 三、失败必须回复用户（不许静默）
+
+你梳理出的现状：
+
+| 场景 | 现在的行为 |
+|---|---|
+| 入站 `info.size` 超限 | **静默丢弃**，只写 WARNING |
+| 入站 https 流式超限 | **静默丢弃** |
+| 出站超限 | 有 `SendResult(error=...)` ✅ |
+| 交付物 >40MB | `classify()` 返回 False → 不进队列，**无提示** |
+
+**全部改成：超限时明确回复用户。**
+
+```python
+# 入站超限
+if size > MAX:
+    log("REJECT oversized inbound: %s (%d bytes)" % (filename, size))
+    send_matrix_message(room_id,
+        "⚠️ 附件「%s」有 %.1f MB，超过 800MB 上限，未接收。" % (filename, size/1048576))
+    return
+
+# 交付物超限（hook）
+if file_size > MAX_BYTES:
+    log("SKIP deliverable too-large: %s (%d bytes)" % (path, file_size))
+    # 在回复正文里加一行说明，不要静默跳过
+    note = "⚠️ 文件「%s」有 %.1f MB，超过 800MB 交付上限，未上传云端。" % (name, file_size/1048576)
+```
+
+---
+
+## 四、失败时清理，不留半截状态
+
+**这条主要是 App 侧（我已改完），你这边要配合的是：**
+
+- 上传失败 → **不要**在 `pushed[]` 里留下半截记录
+- 登记失败 → **不要**在台账里留孤儿记录
+- 任何一步失败 → 明确告知，不要假装成功
+
+---
+
+# 验证（必须实测）
+
+## 验证 1：只有 S3 一条路
+
+```bash
+echo "=== 还有没有 mxc 分支 ==="
+grep -rn "mxc://\|upload_media\|needs_encrypted" \
+  /opt/data/plugins/ /opt/data/scripts/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+**要回答**：还有几处会产生/接受 mxc？**应该为 0。**
+
+## 验证 2：上限全是 800MB
+
+```bash
+grep -rn "100 \* 1024 \* 1024\|40 \* 1024 \* 1024\|104857600\|41943040" \
+  /opt/data/plugins/ /opt/data/scripts/ /opt/hermes/adapter.py 2>/dev/null | grep -v ".pyc" | head
+```
+
+**要回答**：还有没有残留的 100MB / 40MB？**应该为 0。**
+
+## 验证 3：实测一个 100MB 文件
+
+用户在 App 里发一个 100MB 文件 → 你应该能收到并读出正确的大小。
+
+## 验证 4：超限有提示
+
+发一个 900MB 的文件 → 用户应该收到明确的「超过上限」提示，而不是静默。
+
+---
+
+# 回答格式
+
+```
+## 1. mxc 分支
+grep 结果 = ?
+还剩几处 = ?
+
+## 2. 大小上限
+grep 结果 = ?
+7 处都改了吗 = ?
+
+## 3. 100MB 实测
+收到了吗 = ?
+大小对得上吗 = ?
+
+## 4. 超限提示
+有 / 没有
+文案 = ?
+```
+
+🔴 **改完先重启网关**再验证。
+🔴 只要事实，不许说「已优化」而不给数字。
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+我先发个回执：任务已收到，接下来我会先梳理现状、再动手修改。
+
+**收到** — 这次改造包含 4 件事：删掉 mxc 分支、把上限统一到 800MB、失败时给出提示、清理半截状态。我先定位文件与现有代码，再逐处修改，最后重跑实测。我会在约 10 分钟内给出第一版事实报告，不会只给一句「已优化」。
+
+（我先做只读检查，把真实位置摸清再改，避免改错行。）
+```
+
+### 2【prose】
+
+```text
+```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+
+### 3【prose】
+
+```text
+* ```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+
+### 4【prose】
+
+```text
+* ```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+echo "=== 找 deliverable hook 各种名字 ===...
+```
+```
+echo "=== cache 目录 ==="; ls -la /opt/...
+```
+```
+
+### 5【prose】
+
+```text
+* ```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+echo "=== 找 deliverable hook 各种名字 ===...
+```
+```
+echo "=== cache 目录 ==="; ls -la /opt/...
+```
+```
+grep -rn "deliverable-hook" /opt/data...
+```
+```
+grep -n "MAX\|max_bytes\|1024 \* 1024...
+```
+```
+
+### 6【prose】
+
+```text
+* ```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+echo "=== 找 deliverable hook 各种名字 ===...
+```
+```
+echo "=== cache 目录 ==="; ls -la /opt/...
+```
+```
+grep -rn "deliverable-hook" /opt/data...
+```
+```
+grep -n "MAX\|max_bytes\|1024 \* 1024...
+```
+```
+grep -rn "40 \* 1024\|MAX_BYTES\|41" ...
+```
+```
+grep -rn "uploader.mjs\|lj-test\|41\b...
+```
+```
+
+### 7【prose】
+
+```text
+* ```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+echo "=== 找 deliverable hook 各种名字 ===...
+```
+```
+echo "=== cache 目录 ==="; ls -la /opt/...
+```
+```
+grep -rn "deliverable-hook" /opt/data...
+```
+```
+grep -n "MAX\|max_bytes\|1024 \* 1024...
+```
+```
+grep -rn "40 \* 1024\|MAX_BYTES\|41" ...
+```
+```
+grep -rn "uploader.mjs\|lj-test\|41\b...
+```
+```
+ls /opt/data/plugins/; echo "=== 找 lj...
+```
+```
+read_file() { :; }; sed -n '1,60p' /o...
+```
+```
+
+### 8【prose】
+
+```text
+现在我已确认：`fjdeliverable-hook.py` 并不存在。用户所说的「真瓶颈 40MB」实际就在 `fmode-app-deliver.py` 里吗？我再查一遍完整的挂载流程。
+```
+
+### 9【prose】
+
+```text
+* ```
+echo "=== adapter.py 位置 ==="; ls -la ...
+```
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+echo "=== 找 deliverable hook 各种名字 ===...
+```
+```
+echo "=== cache 目录 ==="; ls -la /opt/...
+```
+```
+grep -rn "deliverable-hook" /opt/data...
+```
+```
+grep -n "MAX\|max_bytes\|1024 \* 1024...
+```
+```
+grep -rn "40 \* 1024\|MAX_BYTES\|41" ...
+```
+```
+grep -rn "uploader.mjs\|lj-test\|41\b...
+```
+```
+ls /opt/data/plugins/; echo "=== 找 lj...
+```
+```
+read_file() { :; }; sed -n '1,60p' /o...
+```
+```
+grep -rn "lj\|kangshifu\|ksf" /opt/da...
+```
+📖 Reading fmode-app-deliver.py
+```
+
+### 10【prose】
+
+```text
+我确认了事实：`40MB` 在磁盘上并不存在，具体在代码或配置里的位置我会再核实。接下来看网关 relay 和 App 侧的实际上传路径。
+```
+
+### 11【prose】
+
+```text
+```
+echo "=== mediaStore.ts ==="; find /o...
+```
+```
+sed -n '495,530p' /opt/hermes/gateway...
+```
+```
+
+### 12【prose】
+
+```text
+我已经发现了一个**比清单上任何一项都关键的隐藏上限**：`base.py` 的 128MB 共享入站缓冲区上限。现在开始动手，先通读要改的三个插件。
+```
+
+### 13【prose】
+
+```text
+* ```
+echo "=== mediaStore.ts ==="; find /o...
+```
+```
+sed -n '495,530p' /opt/hermes/gateway...
+```
+📖 Reading __init__.py
+```
+
+### 14【prose】
+
+```text
+发现第 4 处隐藏上限：inbound-s3 的 `_fetch_and_cache_attachment` 里写死了 `max_bytes = 50 * 1024 * 1024`。现在读 outbound 插件。
+```
+
+### 15【prose】
+
+```text
+现有实现已经查清。现在我会逐处备份并修改。先改 `adapter.py`，把 100MB 上限改成 800MB，并删除 mxc 出站分支。
+```
+
+### 16【prose】
+
+```text
+现在开始修改代码。**第 1 处**：把 `adapter.py` 的上限改成 800MB，同时让 `_max_media_bytes` 支持通过环境变量配置。
+```
+
+### 17【prose】
+
+```text
+`adapter.py` 的属主是 root，当前用户 hermes 没有 sudo，不是可写文件。这是**只读上游**，和插件注释里写的一致。因此我改用运行时插件补丁来覆盖，这也正是现有架构的做法。先确认 sudo 是否真的没有：
+```
+
+### 18【prose】
+
+```text
+环境已确认：没有 sudo，`/opt/hermes` 只读。所有改动都必须通过 `/opt/data` 下的插件运行时补丁实现，这也正是现有两条 s3 插件的既有架构。现在重写两个插件。
+
+**第一步：入站插件——删除 mxc 分支，上限设为 800MB，超限时回复用户。**
+```
+
+### 19【prose】
+
+```text
+**第 2 步：重写出站插件——删除 E2EE 的 mxc 分支；没有直链就返回明确失败。**
+```
+
+### 20【prose】
+
+```text
+现在处理**第 5、6 处上限**：gateway 的 128MB 共享入站上限，以及 relay 的 25MB。这两处会让 800MB 形同虚设。
+```
+
+### 21【prose】
+
+```text
+在 config.yaml 里加上 `gateway.max_inbound_media_bytes`，并在 .env 里显式写入这两个上限。这是第 5、6 处。
+```
+
+### 22【prose】
+
+```text
+config.yaml 被安全策略锁住，我改走环境变量；`get_inbound_media_max_bytes()` 会读取 config，但插件层可以覆盖。先验证 128MB 上限的实际生效路径：
+```
+
+### 23【prose】
+
+```text
+好消息：`cache_document_from_bytes` 本身**没有大小校验**，128MB 上限只出现在 `cache_*_from_url` 和 relay 的辅助函数中。我会实证确认这一点，并把它们写进 .env。
+```
+
+### 24【prose】
+
+```text
+```
+sed -n '1420,1450p' /opt/hermes/gatew...
+```
+```
+echo "=== 哪些 cache_*_from_bytes 调了 va...
+```
+```
+
+### 25【prose】
+
+```text
+**关键发现**：`cache_image/audio/video_from_bytes` 会调用 128MB 校验，但 `cache_document_from_bytes` 不校验。因此，800MB 的 PDF、xlsx、mp4 会先被 128MB 挡住。这一点必须在插件层抬升。
+```
+
+### 26【prose】
+
+```text
+```
+sed -n '578,600p;650,700p' /opt/herme...
+```
+```
+
+### 27【prose】
+
+```text
+已确认：128MB 校验是 `validate_inbound_media_size`，它读取 `gateway.max_inbound_media_bytes` 配置。由于 config.yaml 被锁，我改为在运行时 monkeypatch 这个函数，把它抬到 800MB。
+```
+
+### 28【prose】
+
+```text
+**第 7 处：relay 的 25MB。** 我先确认真实情况：
+```
+
+### 29【prose】
+
+```text
+relay 是 `EXPERIMENTAL`，未启用，本项目也不使用，不会影响实际路径。但既然要「只剩一条路径」，我把它一并抬到 800MB，以防将来接入时成为隐患。现在写 .env：
+```
+
+### 30【prose】
+
+```text
+```
+grep -n "MATRIX_MAX_MEDIA_BYTES\|FMOD...
+```
+```
+cd /opt/data && python3 - <<'PY' ...
+```
+```
+
+### 31【prose】
+
+```text
+现在处理「交付物上限」这一处。用户提到 `fmode-deliverable-hook.py:159` 的 40MB，但该文件并不存在。我先查清真实瓶颈在哪：
+```
+
+### 32【prose】
+
+```text
+```
+echo "=== 全盘搜 40MB / 41943040 ==="; g...
+```
+```
+
+### 33【prose】
+
+```text
+```
+grep -n "size\|1024\|MAX" /opt/data/s...
+```
+```
+
+### 34【prose】
+
+```text
+* ```
+grep -n "size\|1024\|MAX" /opt/data/s...
+```
+```
+echo "=== 服务端云函数可能的上限线索 ==="; grep -r...
+```
+```
+
+### 35【prose】
+
+```text
+* ```
+grep -n "size\|1024\|MAX" /opt/data/s...
+```
+```
+echo "=== 服务端云函数可能的上限线索 ==="; grep -r...
+```
+```
+ls -la /opt/data/work/big-15mb.bin 2>...
+```
+```
+
+### 36【prose】
+
+```text
+* ```
+grep -n "size\|1024\|MAX" /opt/data/s...
+```
+```
+echo "=== 服务端云函数可能的上限线索 ==="; grep -r...
+```
+```
+ls -la /opt/data/work/big-15mb.bin 2>...
+```
+```
+cd /opt/data && python3 - <<'PY' ...
+```
+```
+
+### 37【prose】
+
+```text
+那个 `deliverableId=CcPVFo40MB` 只是随机 ID 恰好含 “40MB”，属于误匹配。**磁盘上确实不存在 40MB 限制**。我实测验证一下服务端真实上限：
+```
+
+### 38【prose】
+
+```text
+```
+cd /opt/data && timeout 300 python3 -...
+```
+```
+
+### 39【prose】
+
+```text
+**关键实证**：120MB 文件上传**成功**（`OK=True`, 125829120 bytes, 返回真直链）。这证明 `fmode-deliverable-hook.py` 的 40MB 限制**根本不存在**，那份梳理有误。现在清理测试文件，然后重启网关。
+```
+
+### 40【prose】
+
+```text
+* ```
+cd /opt/data && timeout 300 python3 -...
+```
+```
+rm -f /opt/data/work/probe-120mb.bin ...
+```
+```
+
+### 41【prose】
+
+```text
+现在重启网关，让补丁生效。我先查看重启脚本：
+```
+
+### 42【prose】
+
+```text
+重启会中断当前会话，所以我先把验证脚本写好，重启后再跑。
+```
+
+### 43【prose】
+
+```text
+先在不重启的当前进程里跑一次，暴露导入问题：
+```
+
+### 44【prose】
+
+```text
+需要在网关的 Python 环境里跑，有 venv 和 PYTHONPATH 设置。我先找一下：
+```
+
+### 45【prose】
+
+```text
+```
+ls /opt/hermes/.venv/bin/python3 2>/d...
+```
+```
+
+### 46【prose】
+
+```text
+```
+cd /opt/data && HOME=/opt/data /opt/h...
+```
+```
+
+### 47【prose】
+
+```text
+`gateway` 和 `plugins` 的命名空间都正常。接下来修正自检脚本的导入方式：
+```
+
+### 48【prose】
+
+```text
+* ```
+cd /opt/data && HOME=/opt/data /opt/h...
+```
+✍️ Writing /opt/data/scripts/probe-s3-800mb.py
+```
+
+### 49【prose】
+
+```text
+自检脚本本身的导入路径和插件加载方式都与网关不同；这里显示 MARK=False，只是因为补丁尚未注册。我需要模拟网关的真实加载器：
+```
+
+### 50【prose】
+
+```text
+3 分钟了，还活着，还在跑。 — iteration 46/500, starting API call #46
+```
+
+### 51【prose】
+
+```text
+```
+grep -rln "hermes_plugins" /opt/herme...
+```
+```
+grep -n "hermes_plugins" /opt/hermes/...
+```
+```
+
+### 52【prose】
+
+```text
+插件是以 `hermes_plugins.<slug>` 命名的命名空间导入的。我按同样的方式加载后再跑自检：
+```
+
+### 53【prose】
+
+```text
+正确做法是让网关自己加载插件。我先重启网关，再从日志和运行时状态验证。先确认重启脚本能安全执行：
+```
+
+### 54【prose】
+
+```text
+```
+pgrep -af "hermes gateway run" | head...
+```
+```
+
+### 55【prose】
+
+```text
+网关正在运行，PID 为 161280。重启前，我先记录补丁前的基线：
+```
+
+### 56【prose】
+
+```text
+```
+echo "=== 重启前：日志里有没有 s3-only / 800MB ...
+```
+```
+
+### 57【prose】
+
+```text
+现在重启网关：
+```
+
+### 58【prose】
+
+```text
+```
+LOG_MARK=$(wc -l < /opt/data/logs/gat...
+```
+```
+
+### 59【prose】
+
+```text
+```
+echo "log lines before = $(wc -l < /o...
+```
+```
+sleep 25; echo "=== 进程 ==="; pgrep -a...
+```
+```
+
+### 60【prose】
+
+```text
+网关正在重启。我等待它启动完成后再验证：
+```
+
+### 61【prose】
+
+```text
+❌ Background task failed — `echo "log lines before = $(wc -l < /opt/data/logs/gateway.log)" > /tmp/restart-…` (5s, exit 126). Last output:
+```
+bash: /opt/data/cache/gw-restart.sh: 这门锁着，我走别的门。
+```
+Ask me to rerun it or show the full log.
+```
+
+### 62【prose】
+
+```text
+PID 没变，是同一个进程；重启日志也没生成。我改用 s6 直接重启：
+```
+
+### 63【prose】
+
+```text
+```
+ls /command/s6-svc 2>/dev/null && ech...
+```
+```
+
+### 64【prose】
+
+```text
+网关会重启当前会话所依赖的进程。因此我要用后台方式触发，并在单独的检查调用中确认：
+```
+
+### 65【prose】
+
+```text
+⚠️ 先停一下机——当前任务会断在这儿。我回来后你吱一声，我尽量从断点续上。
+```
+
+### 66【prose】
+
+```text
+```
+/command/s6-svc -r /run/service/gatew...
+```
+```
+
+### 67【prose】
+
+```text
+会话已恢复，网关重启成功。
+
+刚才那次重启是为了让「只保留 S3 一条路径、上限统一为 800MB」的补丁生效。重启前我已经完成并保存到磁盘的改动有：
+
+**代码改动（都在 `/opt/data` 可写区）**
+- `plugin-matrix-inbound-s3`：白名单现在**只放行 ``**，`mxc://` 一律返回 False 并**回复用户**；上限改为 800MB；另外在 gateway 共享入站层也把 128MB 上限提高到 800MB（这是真正会拦截大文件的隐藏上限，`cache_image/audio/video_from_bytes` 都经过它）。
+- `plugin-matrix-outbound-s3`：**删除 E2EE 与 mxc 分支**；如果没有可用直链，就返回 `SendResult(success=False, error="no-preuploaded-url")`，不再静默，也不退回 mxc。
+-  显式写入 `MATRIX_MAX_MEDIA_BYTES=838860800` 和 `FMODE_DELIVERABLE_MAX_BYTES=838860800`。
+
+**两个必须让你知道的事实（和你的清单有出入）**
+1. `fmode-deliverable-hook.py` **这份文件不存在**，磁盘上搜不到任何 40MB 或 41943040 的限制。我实测上传了一个 120MB 文件，**成功**（`OK=True`、125829120 bytes、返回真直链），因此那条「40MB 真瓶颈」的梳理有误。
+2. `/opt/hermes/plugins/platforms/matrix/adapter.py` 属主是 root，本容器**没有 sudo**，无法修改，第 905 行那个 100MB 只能在插件层运行时覆盖，现在已经覆盖。
+
+重启前语法检查通过、补丁逻辑已就绪，但**重启后的实测（grep 结果、100MB 真收、900MB 提示）还没跑完**，按规则我不重跑重启命令。
+
+接下来要我做哪一步？
+- **继续跑验证**（grep 两轮 + 运行时自检脚本 + 你发 100MB 和 900MB 各一个实测）
+- 还是先看我把两个插件改成的最终代码？
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` echo "=== A. mxc 相关 ==="; grep -rn "m... ````
+- `💻 terminal ``` grep -n "1024\|MAX\|max_bytes\|size" ... ````
+- `* 💻 terminal ``` grep -n "1024\|MAX\|max_bytes\|size" ... ``` ``` echo "=== 全库 4xMB 相关 ==="; grep -rn "... ``` ``` echo "=== relay/media.py 全文关键段 ==="; ... ````
+- `📖 Reading __init__.py`
+- `💻 terminal ``` mkdir -p /opt/data/patches/backup-800... ````
+- `🔧 Editing /opt/hermes/plugins/platforms/matrix/...`
+- `💻 terminal ``` id; ls -ld /opt/hermes/plugins/platfo... ````
+- `* 💻 terminal ``` id; ls -ld /opt/hermes/plugins/platfo... ``` ``` which sudo 2>/dev/null; sudo -n true ... ````
+- `✍️ Writing /opt/data/plugins/plugin-matrix-inbou...`
+- `✍️ Writing /opt/data/plugins/plugin-matrix-outbo...`
+- `💻 terminal ``` grep -n "max_inbound_media_bytes" /op... ````
+- `📖 Reading config.yaml`
+- `* 📖 Reading config.yaml 🔧 Editing /opt/data/config.yaml`
+- `💻 terminal ``` grep -n "cache_document_from_bytes_as... ````
+- `🔧 Editing /opt/data/plugins/plugin-matrix-inbou...`
+- `🔧 Editing /opt/data/plugins/plugin-matrix-inbou...`
+- `* 🔧 Editing /opt/data/plugins/plugin-matrix-inbou... 💻 terminal ``` grep -rn "MEDIA_MAX_BYTES" /opt/herme... ````
+- `✍️ Writing /opt/data/scripts/probe-s3-800mb.py`
+- `💻 terminal ``` cd /opt/data && python3 /opt/data/scr... ````
+- `💻 terminal ``` cd /opt/data && set -a && . /opt/data... ``` ``` grep -rn "plugin_matrix_inbound_s3\|h... ````

docs/03-interface/ljtest-40MB核实-回答.md

@@ -0,0 +1,162 @@
+# 容器取证问答：agent-node-lj-test
+
+- 时间：2026-11-14T08:38:25.387Z
+- 房间：`!GGhWxrcPVB4gDoBOt4R9_IBQNs084ciDJC2Ja8LZHtA`（临时房间，可保留查阅）
+- 消息统计：正文 3 段 / 工具过程 3 段 / 文件 0 个
+- 结束原因：收到 ✅ reaction
+
+## 我发出的问题
+
+```text
+# 40MB 这个限制，到底在哪台、哪个文件？
+
+## 我收到的两份矛盾反馈
+
+**lj-test 说：**
+> `fmode-deliverable-hook.py:124,159` → `MAX_BYTES = 40 * 1024 * 1024`
+> `classify()` 返回 `(False, "too-large(>40MB)")` → 文件不进交付物队列
+
+**kangshifu 说：**
+> 「`fmode-deliverable-hook.py` 并不存在」「我确认了事实：40MB 在磁盘上并不存在」
+
+---
+
+# 两条都要给证据（只读，原样贴输出）
+
+## 1. 列出所有 py 里含 40MB / 41943040 的地方
+
+```bash
+grep -rn "40 \* 1024 \* 1024\|41943040\|40MB\|too-large" \
+  /opt/data/scripts/ /opt/data/plugins/ /opt/data/*.py 2>/dev/null | grep -v ".pyc"
+```
+
+## 2. 你这台到底有哪些 deliver 相关脚本
+
+```bash
+ls -la /opt/data/scripts/*deliver* /opt/data/scripts/*artifact* 2>/dev/null
+```
+
+## 3. 所有大小上限（含 100MB 那些）
+
+```bash
+grep -rn "1024 \* 1024" /opt/data/scripts/ /opt/data/plugins/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+## 4. Hermes 内核的 100MB
+
+```bash
+grep -n "_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" /opt/hermes/*/adapter.py /opt/hermes/**/adapter.py 2>/dev/null | head -10
+ls -la /opt/hermes/*/adapter.py /opt/hermes/**/*/adapter.py 2>/dev/null | head -5
+```
+
+---
+
+# 回答格式
+
+```
+## 1. 40MB 命中
+<grep 原文输出>
+
+## 2. deliver 脚本清单
+<ls 原文>
+
+## 3. 所有 1024*1024 上限
+<grep 原文>
+
+## 4. 内核 100MB
+<grep 原文>
+
+## 结论
+40MB 在这台存在吗 = 是/否
+如果存在，在哪个文件:行号 = ?
+```
+
+🔴 原样贴输出，不要总结、不要推测。
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+I'll run those exact commands read-only.
+```
+
+### 2【prose】
+
+```text
+terminal · echo "=== CMD1 ==="; grep -rn "40 \* 1024 \* 1024\|41943040\…
+```
+
+### 3【prose】
+
+```text
+## 1. 40MB 命中
+
+```
+/opt/data/scripts/fmode-deliverable-hook.py.bak-20261114-153807:70:  E2. 文件大小 > 40MB（聊天通道与成果表都放不下，走 bigfile 网关另说）
+/opt/data/scripts/fmode-deliverable-hook.py.bak-20261114-153807:124:MAX_BYTES = 40 * 1024 * 1024
+/opt/data/scripts/fmode-deliverable-hook.py.bak-20261114-153807:160:        return False, "too-large(>40MB)"
+/opt/data/scripts/fmode-deliverable-hook.py.bak-800mb-162930:70:  E2. 文件大小 > 40MB（聊天通道与成果表都放不下，走 bigfile 网关另说）
+/opt/data/scripts/fmode-deliverable-hook.py.bak-800mb-162930:124:MAX_BYTES = 40 * 1024 * 1024
+/opt/data/scripts/fmode-deliverable-hook.py.bak-800mb-162930:160:        return False, "too-large(>40MB)"
+/opt/data/scripts/fmode-deliverable-hook.py:70:  E2. 文件大小 > 40MB（聊天通道与成果表都放不下，走 bigfile 网关另说）
+/opt/data/scripts/fmode-deliverable-hook.py:169:        return False, "too-large(>%dMB)" % (MAX_BYTES // 1048576)
+/opt/data/scripts/fmode-deliverable-hook.py:358:            if why.startswith("too-large"):
+```
+
+## 2. deliver 脚本清单
+
+```
+-rwxr-xr-x 1 hermes hermes   661 Oct 21 10:50 /opt/data/scripts/fmode-artifact-drain.sh
+-rwxr-xr-x 1 hermes hermes 13120 Nov 14 15:38 /opt/data/scripts/fmode-artifact-push.py
+-rw-r--r-- 1 hermes hermes 48767 Nov 14 16:29 /opt/data/scripts/fmode-deliverable-hook.py
+-rw-r--r-- 1 hermes hermes 44592 Nov 14 15:38 /opt/data/scripts/fmode-deliverable-hook.py.bak-20261114-153807
+-rw-r--r-- 1 hermes hermes 47533 Nov 14 16:29 /opt/data/scripts/fmode-deliverable-hook.py.bak-800mb-162930
+```
+
+## 3. 所有 1024*1024 上限
+
+```
+/opt/data/scripts/fmode-deliverable-hook.py.bak-20261114-153807:124:MAX_BYTES = 40 * 1024 * 1024
+/opt/data/scripts/fmode-deliverable-hook.py.bak-800mb-162930:124:MAX_BYTES = 40 * 1024 * 1024
+/opt/data/scripts/fmode-deliverable-hook.py:124:MAX_BYTES = int(os.environ.get("FMODE_DELIVERABLE_MAX_BYTES", str(800 * 1024 * 1024)))
+/opt/data/plugins/plugin-fmode/plugin/fmode_core/security.py:48:MAX_FILE_BYTES = 8 * 1024 * 1024  # 单文件超过 8MB 跳过(只读扫描不冒险读大文件)
+/opt/data/plugins/plugin-matrix-outbound-s3/__init__.py:219:_MAX_MEDIA_BYTES = 800 * 1024 * 1024
+```
+
+## 4. 内核 100MB
+
+```
+（grep 无输出）
+
+---
+-rw-r--r-- 1 root root 119606 Sep 19 06:15 /opt/hermes/gateway/relay/adapter.py
+```
+
+`/opt/hermes` 下只有 `gateway/relay/adapter.py` 一个 adapter.py，里面没有 `_max_media_bytes` / `MATRIX_MAX_MEDIA_BYTES` 任何命中。
+
+## 结论
+
+**40MB 在这台存在吗 = 是，但只在两个 `.bak` 备份文件里，生效脚本里已经没有。**
+
+- 残留在备份：`fmode-deliverable-hook.py.bak-20261114-153807:124` 和 `fmode-deliverable-hook.py.bak-800mb-162930:124`，都是 `MAX_BYTES = 40 * 1024 * 1024`
+- 生效脚本 `/opt/data/scripts/fmode-deliverable-hook.py:124` 实际是：`MAX_BYTES = int(os.environ.get("FMODE_DELIVERABLE_MAX_BYTES", str(800 * 1024 * 1024)))` —— 默认 800MB
+- 该脚本在 `/opt/data/config.yaml:76,79` 被挂为 hook，**文件真实存在**（48767 字节，mtime Nov 14 16:29）
+
+所以 lj-test 的结论对应的是 15:38 那个旧版本（当时确实 40MB），kangshifu 的「文件不存在」与 `ls` 直接矛盾；但他说的「磁盘上不存在 40MB 上限」在**当前生效脚本**范围内成立——40MB 只剩在 .bak 里。两边各对一半，取决于看的是哪个文件。
+```
+
+### 4【ack】
+
+```text
+✅ 容器已标记完成
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` echo "=== CMD1 ==="; grep -rn "40 \* ... ````
+- `* 💻 terminal ``` echo "=== CMD1 ==="; grep -rn "40 \* ... ``` ``` echo "=== CMD2 ==="; ls -la /opt/data... ``` ``` echo "=== CMD3 ==="; grep -rn "1024 \... ````
+- `* 💻 terminal ``` echo "=== CMD1 ==="; grep -rn "40 \* ... ``` ``` echo "=== CMD2 ==="; ls -la /opt/data... ``` ``` echo "=== CMD3 ==="; grep -rn "1024 \... ``` ``` echo "=== CMD4 ==="; grep -n "_max_`

docs/03-interface/ljtest-800MB-回答.md

@@ -0,0 +1,558 @@
+# 容器取证问答：agent-node-lj-test
+
+- 时间：2026-11-14T08:36:13.399Z
+- 房间：`!VTKPREJSpgy0XGGGLzpNebp3Xau8q16DpXuxy8dP96w`（临时房间，可保留查阅）
+- 消息统计：正文 45 段 / 工具过程 17 段 / 文件 0 个
+- 结束原因：静默超时
+
+## 我发出的问题
+
+```text
+# 容器侧改造：只保留 S3 一条路径 + 上限统一 800MB
+
+用户裁决原文：
+
+> **严格禁止退回模式，只能有 s3 的模式。如果失败给出提示，并且撤回输出以及回复，清空会话页面。**
+
+> **文件不能设置上传的大小上限，修改为 800MB。lj-test 和 ksf 都需要优化。**
+
+---
+
+# 必须做到的四件事
+
+## 一、只保留 S3 一条路径
+
+### 1.1 入站：删掉 mxc 分支
+
+你梳理出的现状：
+
+> 「入站有**两条**并存的 URL 通道：`mxc://`（Matrix 中转）与 `https://`（直读 S3），
+>  闸门是二选一的白名单，不是只留一条。」
+
+**改成：只接受 `https://` 的云盘地址，`mxc://` 一律拒绝。**
+
+```python
+# 入站处理里，凡是判断 url 类型的地方，改成：
+if url.startswith("mxc://"):
+    log("REJECT inbound mxc（附件只允许云盘直链）: %s" % url)
+    # 🔴 必须回复用户，不能静默
+    reply_to_user("收到的附件不是云盘直链，已拒绝。请让 App 重新发送。")
+    return
+```
+
+### 1.2 出站：删掉 E2EE 的 mxc 分支
+
+你说：
+
+> 「出站有**两条**产 url 的路径：复用 `pushed[]` 已有 https（主路径），
+>  与 E2EE 下 `upload_media` 产 mxc（例外路径）。」
+
+🔴 **E2EE 这条也是 mxc —— 一并删掉。**
+本项目不使用 E2EE 房间，这条分支永远走不到，留着只会误导。
+
+```python
+# 删掉 needs_encrypted 分支里的 mxc 逻辑
+# 统一改成：
+media_url = _preuploaded_lookup(filename, len(upload_data))
+if not media_url:
+    log("FAIL outbound: 没有可用的云盘直链（filename=%s）" % filename)
+    return _fail("no-preuploaded-url")   # 出站失败要有明确错误
+```
+
+---
+
+## 二、上限统一 800MB（7 处全改）
+
+你梳理出的清单，**每一处都要改**：
+
+| 文件:行号 | 现值 | 改成 |
+|---|---|---|
+| `adapter.py:905` | `100 * 1024 * 1024` | **`800 * 1024 * 1024`** |
+| **`fmode-deliverable-hook.py:159`** | **`40 * 1024 * 1024`** | **`800 * 1024 * 1024`** ← **真瓶颈** |
+| `outbound-s3:253` | 读 `_max_media_bytes` | 跟随上面的值 |
+
+**建议做法**（避免以后再改 7 处）：
+
+```python
+# adapter.py
+MAX_MEDIA_BYTES = int(os.environ.get("MATRIX_MAX_MEDIA_BYTES", str(800 * 1024 * 1024)))
+self._max_media_bytes = MAX_MEDIA_BYTES
+
+# fmode-deliverable-hook.py
+MAX_BYTES = int(os.environ.get("FMODE_DELIVERABLE_MAX_BYTES", str(800 * 1024 * 1024)))
+```
+
+**并在 `/opt/data/.env` 里显式写上这两个值**（不要只靠代码默认，便于以后调整）：
+
+```
+MATRIX_MAX_MEDIA_BYTES=838860800
+FMODE_DELIVERABLE_MAX_BYTES=838860800
+```
+
+---
+
+## 三、失败必须回复用户（不许静默）
+
+你梳理出的现状：
+
+| 场景 | 现在的行为 |
+|---|---|
+| 入站 `info.size` 超限 | **静默丢弃**，只写 WARNING |
+| 入站 https 流式超限 | **静默丢弃** |
+| 出站超限 | 有 `SendResult(error=...)` ✅ |
+| 交付物 >40MB | `classify()` 返回 False → 不进队列，**无提示** |
+
+**全部改成：超限时明确回复用户。**
+
+```python
+# 入站超限
+if size > MAX:
+    log("REJECT oversized inbound: %s (%d bytes)" % (filename, size))
+    send_matrix_message(room_id,
+        "⚠️ 附件「%s」有 %.1f MB，超过 800MB 上限，未接收。" % (filename, size/1048576))
+    return
+
+# 交付物超限（hook）
+if file_size > MAX_BYTES:
+    log("SKIP deliverable too-large: %s (%d bytes)" % (path, file_size))
+    # 在回复正文里加一行说明，不要静默跳过
+    note = "⚠️ 文件「%s」有 %.1f MB，超过 800MB 交付上限，未上传云端。" % (name, file_size/1048576)
+```
+
+---
+
+## 四、失败时清理，不留半截状态
+
+**这条主要是 App 侧（我已改完），你这边要配合的是：**
+
+- 上传失败 → **不要**在 `pushed[]` 里留下半截记录
+- 登记失败 → **不要**在台账里留孤儿记录
+- 任何一步失败 → 明确告知，不要假装成功
+
+---
+
+# 验证（必须实测）
+
+## 验证 1：只有 S3 一条路
+
+```bash
+echo "=== 还有没有 mxc 分支 ==="
+grep -rn "mxc://\|upload_media\|needs_encrypted" \
+  /opt/data/plugins/ /opt/data/scripts/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+**要回答**：还有几处会产生/接受 mxc？**应该为 0。**
+
+## 验证 2：上限全是 800MB
+
+```bash
+grep -rn "100 \* 1024 \* 1024\|40 \* 1024 \* 1024\|104857600\|41943040" \
+  /opt/data/plugins/ /opt/data/scripts/ /opt/hermes/adapter.py 2>/dev/null | grep -v ".pyc" | head
+```
+
+**要回答**：还有没有残留的 100MB / 40MB？**应该为 0。**
+
+## 验证 3：实测一个 100MB 文件
+
+用户在 App 里发一个 100MB 文件 → 你应该能收到并读出正确的大小。
+
+## 验证 4：超限有提示
+
+发一个 900MB 的文件 → 用户应该收到明确的「超过上限」提示，而不是静默。
+
+---
+
+# 回答格式
+
+```
+## 1. mxc 分支
+grep 结果 = ?
+还剩几处 = ?
+
+## 2. 大小上限
+grep 结果 = ?
+7 处都改了吗 = ?
+
+## 3. 100MB 实测
+收到了吗 = ?
+大小对得上吗 = ?
+
+## 4. 超限提示
+有 / 没有
+文案 = ?
+```
+
+🔴 **改完先重启网关**再验证。
+🔴 只要事实，不许说「已优化」而不给数字。
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+I'll start by finding the actual files and current state.
+```
+
+### 2【prose】
+
+```text
+🌐 browser_exec: "from hermes_tools import terminal r =..."
+```
+
+### 3【prose】
+
+```text
+terminal · ls /opt/data/plugins/ 2>&1; echo ---; ls /opt/data/scripts/ …
+```
+
+### 4【prose】
+
+```text
+Let me verify the scope, confirm or refute the task list's claims, and inspect the actual inbound path.
+```
+
+### 5【prose】
+
+```text
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+
+### 6【prose】
+
+```text
+* ```
+cd /opt/hermes/plugins/platforms/matr...
+``` (×2)
+```
+
+### 7【prose】
+
+```text
+* ```
+cd /opt/hermes/plugins/platforms/matr...
+``` (×3)
+```
+
+### 8【prose】
+
+```text
+* ```
+cd /opt/hermes/plugins/platforms/matr...
+``` (×3)
+```
+cd /opt/hermes && grep -n "_env_numbe...
+```
+```
+
+### 9【prose】
+
+```text
+Confirmed: `/opt/hermes` is root-owned and read-only for me (uid=10000). So the adapter changes have to be done via a runtime plugin patch. Let me check the hook script and env first.
+```
+
+### 10【prose】
+
+```text
+* ```
+cd /opt/hermes/plugins/platforms/matr...
+``` (×3)
+```
+cd /opt/hermes && grep -n "_env_numbe...
+```
+```
+cd /opt/data && sed -n '100,200p' scr...
+```
+```
+
+### 11【prose】
+
+```text
+我先确认 `classify()` 的返回值在哪些地方被用到，以及「超出上限」的超大文件该如何提示用户。
+```
+
+### 12【prose】
+
+```text
+```
+cd /opt/data && grep -n "classify(\|t...
+```
+```
+
+### 13【prose】
+
+```text
+```
+cd /opt/data && sed -n '320,400p' scr...
+```
+```
+
+### 14【prose】
+
+```text
+接下来我会查看 `.env` 和网关的重启方式，然后进行修改。
+```
+
+### 15【prose】
+
+```text
+* ```
+cd /opt/data && sed -n '320,400p' scr...
+```
+```
+cd /opt/data && grep -n "^MATRIX_\|^F...
+```
+```
+
+### 16【prose】
+
+```text
+现在我已经掌握了全部情况。先改 `.env`，再调整那两处大小上限，最后再处理适配器补丁。
+```
+
+### 17【prose】
+
+```text
+```
+cd /opt/data && cp .env .env.bak-$(da...
+```
+```
+
+### 18【prose】
+
+```text
+```
+cd /opt/data && sed -n '544,566p' .en...
+```
+```
+
+### 19【prose】
+
+```text
+* ```
+cd /opt/data && sed -n '544,566p' .en...
+```
+🔧 Editing /opt/data/.env
+```
+
+### 20【prose】
+
+```text
+patch · /opt/data/.env
+```
+
+### 21【prose】
+
+```text
+`.env` 在我这里受写保护。我改用能对文本做替换的 `patch` 工具再试：
+```
+
+### 22【prose】
+
+```text
+* ```
+cd /opt/data && sed -n '544,566p' .en...
+```
+🔧 Editing /opt/data/.env (×2)
+```
+
+### 23【prose】
+
+```text
+`.env` 已写入。接下来修改交付物 hook 里的上限，这一处才是真正的瓶颈。
+```
+
+### 24【prose】
+
+```text
+现在修改这个 hook 里的 MAX_BYTES，并按任务书要求加一条「超出上限」的提示，不能静默跳过。
+```
+
+### 25【prose】
+
+```text
+接下来在超限被跳过的地方记录提示，再从回复正文里把它带出去。
+```
+
+### 26【prose】
+
+```text
+接下来我要找到 `transform_llm_output` 这个处理入口，看它返回的回复文本是在哪里拼出来的。
+```
+
+### 27【prose】
+
+```text
+```
+cd /opt/data/scripts && sed -n '973,1...
+```
+```
+
+### 28【prose】
+
+```text
+这里一共有四个各自独立、只输出一次的 return 出口，而超限提示必须出现在所有这些出口上。我会加一个统一的追加函数，并在每个出口调用它。
+```
+
+### 29【prose】
+
+```text
+* ```
+cd /opt/data/scripts && sed -n '973,1...
+```
+🔧 Editing /opt/data/scripts/fmode-deliverable-h...
+```
+
+### 30【prose】
+
+```text
+docstring 里有一个乱码字符。我先修掉它，再把各个出口接到 `_emit` 上。
+```
+
+### 31【prose】
+
+```text
+改动已落地。现在实测这个 hook：先用 100MB 的文件验证是否放行，再用 900MB 的文件验证提示是否出现。
+```
+
+### 32【prose】
+
+```text
+terminal · mkdir -p /opt/data/work/size-test && cd /opt/data/work/size-…
+```
+
+### 33【prose】
+
+```text
+上限判定正确：41MB 和 100MB 通过了体积检查，900MB 被以 `too-large(>800MB)` 拒绝。接下来验证 41MB 和 100MB 在白名单扩展名下的表现，以及提示文本的生成。
+```
+
+### 34【prose】
+
+```text
+```
+cd /opt/data/work/size-test && cp f41...
+```
+```
+
+### 35【prose】
+
+```text
+```
+cd /opt/hermes/plugins/platforms/matr...
+```
+```
+
+### 36【prose】
+
+```text
+hook 已端到端验证通过。接下来处理适配器部分：`mxc` 出站分支、入站 `mxc://`、入站超限，以及 100MB 上限。由于 `/opt/hermes` 对我只读，我会在现有的出站 S3 插件里实现。
+```
+
+### 37【prose】
+
+```text
+接下来我给这个出站 S3 插件写适配器补丁，让它在运行时替换入站处理函数。
+```
+
+### 38【prose】
+
+```text
+接下来修改出站函数：彻底删掉 E2EE 的 mxc 分支，并强制使用 800MB 上限。
+```
+
+### 39【prose】
+
+```text
+现在在 `_install_patch` 里把入站拦截的包装函数接上。
+```
+
+### 40【prose】
+
+```text
+现在重启网关，让改动生效。
+```
+
+### 41【prose】
+
+```text
+```
+cd /opt/data && (s6-svc -r /run/servi...
+```
+```
+
+### 42【prose】
+
+```text
+* ```
+cd /opt/data && (s6-svc -r /run/servi...
+```
+```
+ls /run/s6/basedir/bin/ 2>/dev/null; ...
+```
+```
+
+### 43【prose】
+
+```text
+⚠️ 我要下线一会儿——手上这个任务会中断。等我回来，你随便说句话，我就接着往下做。
+```
+
+### 44【prose】
+
+```text
+* ```
+cd /opt/data && (s6-svc -r /run/servi...
+```
+```
+ls /run/s6/basedir/bin/ 2>/dev/null; ...
+```
+```
+/package/admin/s6/command/s6-svc -r /...
+```
+```
+
+### 45【prose】
+
+```text
+会话已恢复，网关重新上线。
+
+网关重启前，改造工作已经完成，而且都是基于真实执行验证过的：
+
+**已落地的改动：**
+- `/opt/data/.env` 新增 `MATRIX_MAX_MEDIA_BYTES=838860800` 和 `FMODE_DELIVERABLE_MAX_BYTES=838860800`（第 559、560 行）。
+- `scripts/fmode-deliverable-hook.py`：`MAX_BYTES` 改为读环境变量，默认 800MB；因超限被跳过的文件现在会在回复正文追加「超过交付上限」提示，不再静默消失。
+- `plugins/plugin-matrix-outbound-s3/__init__.py`：出站 E2EE 的 `mxc` 分支整段删除，只剩 `_preuploaded_lookup` 一条路，查不到就 `_fail("no-preuploaded-url")`；并新增入站拦截 `_handle_media_message`：`mxc://` 一律拒绝并回复用户，入站超限也回复用户。
+
+**实测数字：**
+- `classify()` 实测：41MB → `allowlisted-ext`（放行）、100MB → `allowlisted-ext`（放行）、900MB → `too-large(>800MB)`（拒绝）。此前的 40MB 瓶颈已经消失。
+- 超限提示实测输出：`文件「f900.pdf」有 900.0 MB，超过 800MB 交付上限，未上传云端。`
+
+**还没做的：**重启后的运行时回读，也就是确认日志里出现 `PATCHED _handle_media_message`、且 900MB 入站真的会回提示。验证 3、4（App 侧真实发 100MB 和 900MB 文件）需要你在 App 里操作。
+
+要我现在做重启后的运行时回读，还是你直接发文件来实测？
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` ls /opt/data/plugins/ 2>&1; echo ---;... ````
+- `* 💻 terminal ``` ls /opt/data/plugins/ 2>&1; echo ---;... ``` ``` cd /opt/data && grep -rn "mxc://\|upl... ````
+- `* 💻 terminal ``` ls /opt/data/plugins/ 2>&1; echo ---;... ``` ``` cd /opt/data && grep -rn "mxc://\|upl... ``` 📖 Reading __init__.py`
+- `* 💻 terminal ``` ls /opt/data/plugins/ 2>&1; echo ---;... ``` ``` cd /opt/data && grep -rn "mxc://\|upl... ``` 📖 Reading __init__.py 💻 terminal ``` cd /opt/data && echo "=== 上限残留 ==="; ... ````
+- `💻 terminal ``` cd /opt/data && python3 - <<'PY' ... ````
+- `* 💻 terminal ``` cd /opt/data && python3 - <<'PY' ... ``` ``` cd /opt/data/scripts && cp fmode-deli... ````
+- `🔧 Editing /opt/data/scripts/fmode-deliverable-h...`
+- `🔧 Editing /opt/data/scripts/fmode-deliverable-h...`
+- `* 🔧 Editing /opt/data/scripts/fmode-deliverable-h... (×2)`
+- `💻 terminal ``` cd /opt/data/scripts && grep -n "def ... ````
+- `🔧 Editing /opt/data/scripts/fmode-deliverable-h...`
+- `💻 terminal ``` cd /opt/data/scripts && python3 - <<'PY' ... ````
+- `* 💻 terminal ``` cd /opt/data/scripts && python3 - <<'PY' ... ``` ``` mkdir -p /opt/data/work/size-test && ... ````
+- `🔧 Editing /opt/data/plugins/plugin-matrix-outbo...`
+- `🔧 Editing /opt/data/plugins/plugin-matrix-outbo...`
+- `🔧 Editing /opt/data/plugins/plugin-matrix-outbo...`
+- `💻 terminal ``` cd /opt/data && python3 -c "import as... ````

docs/03-interface/ljtest-文件链路梳理-回答.md

@@ -0,0 +1,353 @@
+# 容器取证问答：agent-node-lj-test
+
+- 时间：2026-11-14T08:19:20.883Z
+- 房间：`!q9bckJYaxvh_iU9i8xfcAFQ4OF7krQusXwy2ySN5tec`（临时房间，可保留查阅）
+- 消息统计：正文 18 段 / 工具过程 1 段 / 文件 0 个
+- 结束原因：收到 ✅ reaction
+
+## 我发出的问题
+
+```text
+# 梳理：文件传输的完整链路（找出为什么会有多个上限、多条路径）
+
+用户裁决：
+1. 文件**不能**通过 Matrix 传输，必须是 S3 链接
+2. **取消上传大小上限**，改为 800MB
+3. lj-test 和 kangshifu **都要改**
+4. **先梳理，再设计**，不要直接改
+
+---
+
+# 一、请如实回答这几个问题（只读）
+
+## Q1：App → 容器，文件到底怎么过去的
+
+**这是用户最关心的一点**：文件本体到底有没有经过 Matrix？
+
+```bash
+# 看入站媒体插件如何处理 App 发来的 m.file
+ls -la /opt/data/plugins/plugin-matrix-inbound-s3/ 2>/dev/null
+grep -n "def \|mxc\|download\|fetch\|http" /opt/data/plugins/plugin-matrix-inbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：
+- App 发来 `m.file`，`url` 字段是 `https://s3...` 还是 `mxc://`？
+- 容器是**直接下载那个 https URL**，还是先转成 mxc 再下载？
+- **文件本体有没有经过 Matrix 服务器？**
+
+## Q2：容器 → App，文件怎么过去的
+
+```bash
+grep -n "def \|send_content_event\|msg_content\|url" /opt/data/plugins/plugin-matrix-outbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：发出去的 `m.file` 里，`url` 是 https 还是 mxc？文件本体经过 Matrix 吗？
+
+## Q3：现在有几处大小限制（全部列出来）
+
+```bash
+echo "=== App 侧（我不知道，你只看容器侧）==="
+grep -rn "max_media_bytes\|MAX_FILE_BYTES\|max_inbound\|max_size\|too large\|oversize\|104857600\|20971520" \
+  /opt/data/plugins/ /opt/data/scripts/ /opt/data/config.yaml /opt/data/.env 2>/dev/null | grep -v ".pyc" | head -30
+
+echo "=== Hermes 内核默认值 ==="
+grep -rn "DEFAULT_INBOUND_MEDIA_MAX_BYTES\|_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" \
+  /opt/hermes/ 2>/dev/null | head -20
+```
+
+**要回答**：把所有限制列成表 —— 哪个文件、哪一行、值是多少、在哪一步生效。
+
+## Q4：超限时的行为
+
+```bash
+grep -rn "Rejecting oversized\|too large\|oversize" /opt/hermes/ /opt/data/plugins/ 2>/dev/null | head -20
+```
+
+**要回答**：超限时是**静默丢弃**还是**回复用户**？
+
+---
+
+# 二、我这边已知的事实（供你对照）
+
+| 项 | App 侧现状 |
+|---|---|
+| App → 容器 | `sendFileByUrl()`：先传云盘，事件里 `url = https://s3...`，**文件本体不进 Matrix** |
+| 容器 → App | 容器发 `m.file`，`url = https://s3.../deliverables/...` |
+| App 侧大小限制 | `CLOUD_LIMIT_BYTES = Infinity`（**不限制**） |
+
+**所以 App 侧本来就是「只传链接」。** 需要确认容器侧是不是也这样。
+
+---
+
+# 三、回答格式
+
+```
+## Q1 App → 容器
+url 字段 = https / mxc
+文件本体经过 Matrix 吗 = 是/否
+代码位置 = ?
+
+## Q2 容器 → App
+url 字段 = https / mxc
+文件本体经过 Matrix 吗 = 是/否
+代码位置 = ?
+
+## Q3 所有大小限制
+| 文件:行号 | 值 | 在哪一步生效 |
+|---|---|---|
+| ... | ... | ... |
+
+## Q4 超限行为
+静默 / 回复用户 = ?
+代码位置 = ?
+```
+
+🔴 只要事实和代码原文。**不要提建议，先梳理清楚。**
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+我先加载相关技能，再按要求逐项只读核查。
+```
+
+### 2【prose】
+
+```text
+📚 Reading skill matrix-inbound-media
+```
+
+### 3【prose】
+
+```text
+terminal · echo "=== plugins dir ==="; ls -la /opt/data/plugins/ 2>/dev…
+```
+
+### 4【prose】
+
+```text
+第 1 条已有关键发现：**不存在 `plugin-matrix-inbound-s3`**。所以 Q1 的回答点在 Hermes 内核 adapter，而不是我方插件。继续读内核与出站插件。
+```
+
+### 5【prose】
+
+```text
+```
+echo "=== outbound-s3 plugin.yaml ===...
+```
+```
+
+### 6【prose】
+
+```text
+现在读取关键代码段原文：入站闸门与大小检查、出站上传段。
+```
+
+### 7【prose】
+
+```text
+* ```
+echo "=== outbound-s3 plugin.yaml ===...
+```
+```
+cd /opt/hermes ...
+```
+```
+
+### 8【prose】
+
+```text
+注意：内核这段已被本地改过（有 "Fmode:" 注释、`_is_allowed_media_url`）。我要看这个函数本体，它才是真正的入站闸门。
+```
+
+### 9【prose】
+
+```text
+```
+cd /opt/hermes ...
+```
+```
+
+### 10【prose】
+
+```text
+```
+cd /opt/hermes ...
+```
+```
+
+### 11【prose】
+
+```text
+* ```
+cd /opt/hermes ...
+```
+```
+echo "===== outbound-s3 全文 240-330（上传...
+```
+```
+cd /opt/hermes ...
+```
+```
+
+### 12【prose】
+
+```text
+我还需要确认三件事：`_get_scoped_secret` 是否会从 config.yaml 取值、延迟推送脚本中是否有上限、以及入站媒体是否确实经过了真实运行的媒体处理路径（也就是媒体消息分类）。
+```
+
+### 13【prose】
+
+```text
+* ```
+cd /opt/hermes ...
+```
+```
+echo "===== outbound-s3 全文 240-330（上传...
+```
+```
+cd /opt/hermes ...
+```
+```
+echo "===== 插补另查：/opt/data 全域大小限制 =====" ...
+```
+```
+cd /opt/hermes ...
+```
+```
+
+### 14【prose】
+
+```text
+找到第二个真实上限：交付物 hook 的 40MB。接下来看它的生效位置和超限行为。
+```
+
+### 15【prose】
+
+```text
+```
+echo "===== fmode-artifact-push.py 里的...
+```
+```
+echo "===== deliverable-hook 115-175 ...
+```
+```
+
+### 16【prose】
+
+```text
+我还需要确认两点：一是钩子上游（`fmode-artifact-push.py`）是否会把大文件从排队队列中筛掉，二是入站处理路径共有几条（是否只有 `_handle_media_message` 这一条）。
+```
+
+### 17【prose】
+
+```text
+```
+cd /opt/hermes ...
+```
+```
+echo "===== artifact-push 的判定/筛除条件 ==...
+```
+```
+
+### 18【prose】
+
+```text
+核查已完成，下面只列事实。
+
+## Q1 App → 容器
+
+**url 字段**：取决于 App 发什么，但容器**只接受两类**——`mxc://`，或域名在白名单里的 `https://`。白名单只有 `s3.fmode.cn` 一个。
+
+**文件本体经过 Matrix 吗**：**否**（当 url 是  时）。
+
+**代码位置**：
+- 闸门 `/opt/hermes/plugins/platforms/matrix/adapter.py:255-269` — `_FMODE_MEDIA_HOSTS = {"s3.fmode.cn"}`，`_is_allowed_media_url()`：`mxc://` 一律放行；`https://` 只看 hostname 是否等于 `s3.fmode.cn`；其余返回 False
+- 使用点 `:2157`（明文媒体 url）、`:2176`（加密媒体 file.url）——不合法就 `logger.warning` 后 `return`，**不下载**
+- 下载分叉 `:2267-2272`：
+
+```
+if str(url).startswith("https://"):
+    # Fmode: 附件直读个人存储（s3.fmode.cn），不经 Matrix media
+    file_bytes = await self._fetch_http_media(url, event_id)
+else:
+    file_bytes = await self._client.download_media(ContentURI(url))
+```
+
+- `_fetch_http_media()` `:2216-2253`：aiohttp/httpx 直接 GET 那个 https，`allow_redirects=False`
+
+**结论**：App 发 `` 进 `url` 字段时，容器直接向 S3 拉取字节，**文件本体不经过 Matrix 服务器**；只有在 url 为 `mxc://` 时，才走 `download_media` 由 Matrix 中转。你整理的 App 侧事实与容器侧一致。
+
+⚠️ 顺带一个事实差异：`/opt/data/plugins/plugin-matrix-inbound-s3/` **不存在**。入站改 https 的逻辑写在内核 `adapter.py` 里（有 `# Fmode:` 注释，属本地改动，文件 owner 是 root:root），不是插件。所以入站这侧不存在可单独开关的插件。
+
+## Q2 容器 → App
+
+**url 字段**：``（明文房间）。
+
+**文件本体经过 Matrix 吗**：**否**。
+
+**代码位置** `/opt/data/plugins/plugin-matrix-outbound-s3/__init__.py:297-314`：`msg_content["url"] = media_url`，`media_url` 来自 `_preuploaded_lookup()` 查到的已签发 https。
+
+两个例外，都是事实：
+- **E2EE 房间分支 `:276-284`**：`mxc_url = await self._client.upload_media(...)` → `media_url = str(mxc_url)`。这时本体**经过 Matrix**，且 `url` 是 `mxc://`。
+- **查不到预上传记录 `:288-295`**：直接 `return _fail("no-preuploaded-url")`，不自行上传。注释写明「2026-11-14 用户裁决：本插件不再自行上传」。
+
+## Q3 所有大小限制
+
+容器侧真正会拦住文件的限制有 **3 处**（`security.py` 的 8MB 是读文件扫描时的文件大小上限，与传输无关；`artifact-push.py` 没有大小上限）：
+
+| 文件:行号 | 值 | 在哪一步生效 |
+|---|---|---|
+| `adapter.py:905` | `100MB`（`_env_number("MATRIX_MAX_MEDIA_BYTES", 100*1024*1024, int)`） | **源头**：定义 `self._max_media_bytes`，全内核 9 处都读它 |
+| `adapter.py:2168` | 同上 100MB | **入站**：`_handle_media_message()` 读 `info.size`，超过就拒绝——**在下载之前** |
+| `adapter.py:2222` + `:2236`/`:2251` | 同上 100MB | **入站**：`_fetch_http_media()` 流式累计，每 64KB 检查一次，超过就中止 |
+| `adapter.py:1766` | 同上 100MB | **出站**：内核 `_upload_and_send()` 开头 |
+| `adapter.py:1838` | 同上 100MB | **出站**：`_send_local_file()` 读盘前 |
+| `outbound-s3/__init__.py:253` | 同上 100MB | **出站**：插件版 `_upload_and_send()` 开头（**实际生效的是这一行**，因为内核方法被替换） |
+| `adapter.py:1535`/`:1541` | 同上 100MB | 外部 https 图片拉取（`_read_capped`），与本链路无关 |
+| `/opt/data/scripts/fmode-deliverable-hook.py:124,159` | `40MB`（`MAX_BYTES = 40 * 1024 * 1024`） | **上游**：`classify()` 返回 `False, "too-large(>40MB)"` → 文件不进入交付物队列 → **不会产生预上传 https** → 出站插件 `_preuploaded_lookup` 查不到 → `_fail("no-preuploaded-url")` |
+
+**生效顺序**（出站）：交付物 40MB → 出站插件/内核 100MB → 发送。40MB 是真正的瓶颈，100MB 那层永远轮不到。
+
+**环境变量实际值**（回读原文）：
+- shell env：`MATRIX_MAX_MEDIA_BYTES` → `<unset>`
+- `/run/s6/container_environment/MATRIX_MAX_MEDIA_BYTES` → `NOT PRESENT`
+- `/opt/data/.env` → 无该键
+
+即**三处都没配，跑的是代码默认值 100×1024×1024 = 104857600**。`_env_number` 走 `_get_scoped_secret(name, str(default))`（`adapter.py:535-540`），只认环境变量/secret 作用域，**不读 config.yaml**。
+
+## Q4 超限行为
+
+**静默丢弃 + 一条 WARNING 日志，不回复用户。**
+
+| 场景 | 行为 | 代码位置 |
+|---|---|---|
+| 入站 `info.size` 超限 | `logger.warning("Rejecting oversized inbound media ...")` → `return`，**无任何用户可见回执** | `:2168-2172` |
+| 入站 https 流式超限 | `logger.warning("Rejecting oversized HTTP media ...")` → `return None` → `cached_path=None`（后续仍会构造事件，但 `media_urls=None`，即文件丢失只有正文） | `:2236`、`:2251` |
+| 出站超限 | `return self._media_too_large(size)` → `SendResult(success=False, error="Media file exceeds Matrix limit (... bytes)")` | `:1810-1814`、`:253-254` |
+| 交付物 >40MB | `classify()` 返回 `(False, "too-large(>40MB)")`，不进队列 | `deliverable-hook.py:159-160` |
+
+**入站静默、出站有 SendResult**——两边的失败可见性不对称。
+
+## 顺带的事实（与「为什么多条路径」直接相关）
+
+1. 入站有**两条**并存的 URL 通道：`mxc://`（Matrix 中转，`download_media`）与 ``（直读 S3，`_fetch_http_media`）。闸门是二选一的白名单，不是只留一条。
+2. 出站有**两条**产 url 的路径：复用 `pushed[]` 已有 https（主路径），与 E2EE 下 `upload_media` 产 mxc（例外路径）。
+3. 出站上传函数被插件**整段替换**（内核 `_upload_and_send` 被 `MatrixAdapter._upload_and_send = _upload_and_send` 覆盖），所以「内核那行 100MB」和「插件那行 100MB」是同一语义的两次出现，改一处不改另一处不会生效，改插件也不会改到内核的 `_send_local_file`/`_upload_and_send` 原始定义。
+
+已按要求只梳理、未改任何文件、未重启。
+```
+
+### 19【ack】
+
+```text
+✅ 容器已标记完成
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` echo "=== plugins dir ==="; ls -la /o... ``` ``` cd /opt/hermes ... ````

docs/03-interface/ljtest-附件接收-回答.md

@@ -0,0 +1,495 @@
+# 容器取证问答：agent-node-lj-test
+
+- 时间：2026-11-14T08:14:08.110Z
+- 房间：`!3dHDiAVo9j_F7b1pnRvbXwPxGMnpfzw5G-DU7rorHj8`（临时房间，可保留查阅）
+- 消息统计：正文 33 段 / 工具过程 1 段 / 文件 0 个
+- 结束原因：收到 ✅ reaction
+
+## 我发出的问题
+
+```text
+# App 发来的附件，你只收到 3 字节 —— 请查清接收链路
+
+## 现象（用户实测）
+
+用户在 App 里发了一个 `计划.md` 附件，界面显示 `3 B`。
+
+你收到后说：
+
+> 计划.md 收到，但内容没有一并传过来 —— 我这边只看到文件名，正文是空的。
+> 路径：`/opt/data/cache/documents/doc_963e5fa78f1d_计划.md`，3 字节。
+
+**另外那个 100MB 的 `test-100MB.md`，你直接说「没看到附件」。**
+
+---
+
+# App 侧发的是什么（我这边的事实）
+
+App 用 `matrix-client.service.ts:965 sendFileByUrl()` 发送，事件结构：
+
+```js
+{
+  msgtype: 'm.file',
+  body: '计划.md',
+  url: 'https://s3.fmode.cn/user/<uid>/chat/.../xxx-file',   // ← 云盘直链，不是 mxc
+  info: { mimetype: 'text/markdown', size: 3 },
+  'com.fmode.cloud_url': 'https://s3.fmode.cn/user/...'      // ← 双写
+}
+```
+
+**不是 mxc，是 https 直链。**
+
+---
+
+# 要你查的（只读，贴原文）
+
+## 1. 你的 inbound 插件怎么处理 `m.file`
+
+```bash
+ls -la /opt/data/plugins/plugin-matrix-inbound-s3/ 2>/dev/null
+grep -n "m.file\|msgtype\|download\|fetch\|url" /opt/data/plugins/plugin-matrix-inbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：
+- 收到 `m.file` 事件后，它怎么取文件内容？
+- 是下载 `content.url` 吗？还是走 `mxc` 转换？
+- 有没有对 `info.size` 做校验？
+
+## 2. 落盘到 `cache/documents/` 的代码
+
+```bash
+grep -rn "cache/documents\|doc_" /opt/data/plugins/ /opt/data/scripts/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+**要回答**：`doc_<hash>_<name>` 这个文件名是谁生成的？写完有没有校验字节数？
+
+## 3. 实际收一个附件，看日志
+
+请用户配合再发一次，或者你自己造一个：
+
+```bash
+# 先看最近的 inbound 日志
+grep -n "inbound\|attachment\|download\|doc_" /opt/data/logs/*.log 2>/dev/null | tail -30
+```
+
+**要回答**：
+- 下载那个 https URL 时 HTTP 状态码是多少？
+- 实际写入多少字节？
+- 有没有 error / 404 / timeout？
+
+## 4. 100MB 为什么不认
+
+```bash
+grep -rn "MAX.*SIZE\|max_size\|file too large\|20 ?\* ?1024\|10485760\|20971520" \
+  /opt/data/plugins/plugin-matrix-inbound-s3/ /opt/data/scripts/ 2>/dev/null | head -10
+```
+
+**要回答**：有没有大小上限？是多少？
+
+---
+
+# 回答格式
+
+```
+## 1. inbound 处理方式
+取内容的方式 = ?
+代码位置 = ?
+
+## 2. 落盘代码
+doc_ 谁生成 = ?
+有没有校验字节数 = ?
+代码位置 = ?
+
+## 3. 实测日志
+HTTP 状态 = ?
+写入字节 = ?
+有没有错误 = ?
+
+## 4. 大小上限
+有 / 没有
+限制是多少 = ?
+```
+
+🔴 只要事实和代码原文。
+```
+
+## 容器回答（原文，按时间顺序，未删改）
+
+### 1【prose】
+
+```text
+I'll check the actual state of these paths and the inbound handling code.
+```
+
+### 2【prose】
+
+```text
+terminal · ls -la /opt/data/plugins/ 2>/dev/null; echo "---MATRIX INBOU…
+```
+
+### 3【prose】
+
+```text
+The `plugin-matrix-inbound-s3` directory doesn't exist. Let me find what actually handles attachments.
+```
+
+### 4【prose】
+
+```text
+```
+ls -la /opt/data/cache/documents/ 2>/...
+```
+```
+ls -la /opt/data/cache/documents/doc_...
+```
+```
+
+### 5【prose】
+
+```text
+The 3-byte file literally contains `123` — no markdown content. Now let me find the real Hermes core attachment handling code.
+```
+
+### 6【prose】
+
+```text
+```
+grep -rn "cache/documents\|doc_\|docu...
+```
+```
+which hermes; hermes --version 2>&1 |...
+```
+```
+
+### 7【prose】
+
+```text
+```
+grep -rn "documents" /opt/data/logs/g...
+```
+```
+ls -la /opt/hermes/ | head -30; echo ...
+```
+```
+
+### 8【prose】
+
+```text
+Found the core: `/opt/hermes/gateway/platforms/`. Let me examine the Matrix platform's attachment handling.
+```
+
+### 9【prose】
+
+```text
+* ```
+grep -rn "documents" /opt/data/logs/g...
+```
+```
+ls -la /opt/hermes/ | head -30; echo ...
+```
+```
+grep -rn "cache/documents" /opt/herme...
+```
+```
+ls -la /opt/hermes/gateway/platforms/...
+```
+```
+
+### 10【prose】
+
+```text
+Matrix is not a file in gateway/platforms — it's likely a plugin. Let me find the actual Matrix adapter.
+```
+
+### 11【prose】
+
+```text
+```
+sed -n '660,760p' /opt/hermes/gateway...
+```
+```
+find /opt/hermes -name "*.py" -path "...
+```
+```
+
+### 12【prose】
+
+```text
+```
+cat /opt/data/config.yaml 2>/dev/null...
+```
+```
+grep -n "m\.file\|msgtype\|info\.size...
+```
+```
+
+### 13【prose】
+
+```text
+Found the real adapter. `plugin-matrix-inbound-s3` does not exist — the task assumed it. Let me read the actual `m.file` handling.
+```
+
+### 14【prose】
+
+```text
+Now the critical detail — line 2196-2200 and 2263-2300. Let me read them in full, plus the size-limit code.
+```
+
+### 15【prose】
+
+```text
+```
+wc -l /opt/hermes/plugins/platforms/m...
+```
+```
+sed -n '2150,2310p' /opt/hermes/plugi...
+```
+```
+
+### 16【prose】
+
+```text
+Now let me find `_max_media_bytes`, `_is_allowed_media_url` whitelist, and `cache_document_from_bytes` (the `doc_<hash>_` naming).
+```
+
+### 17【prose】
+
+```text
+```
+sed -n '240,275p;500,545p' /opt/herme...
+```
+```
+grep -n "_max_media_bytes\|ALLOWED.*U...
+```
+```
+
+### 18【prose】
+
+```text
+```
+grep -n "def cache_document_from_byte...
+```
+```
+sed -n '1420,1450p' /opt/hermes/gatew...
+```
+```
+
+### 19【prose】
+
+```text
+Now the live evidence: the actual inbound log for that event, and env values in the running gateway process.
+```
+
+### 20【prose】
+
+```text
+* ```
+grep -n "def cache_document_from_byte...
+```
+```
+sed -n '1420,1450p' /opt/hermes/gatew...
+```
+```
+grep -n "MATRIX_MAX_MEDIA_BYTES\|max_...
+```
+```
+grep -n "计划\.md\|963e5fa78f1d\|HTTP m...
+```
+```
+
+### 21【prose】
+
+```text
+`/proc` reads are being blocked by the sandbox. Let me get env and the event details another way.
+```
+
+### 22【prose】
+
+```text
+```
+PID=$(pgrep -f "hermes.*gateway run" ...
+```
+```
+for p in 146069 154360 17; do echo "-...
+```
+```
+
+### 23【prose】
+
+```text
+Key finding: the 附件 arrived in a **different room** (`!hy_WrX1...`, user `pnfapmsbhs`) than this DM. Let me check that room's event log for download/oversize errors, and confirm the effective limit.
+```
+
+### 24【prose】
+
+```text
+```
+sed -n '17800,17840p' /opt/data/logs/...
+```
+```
+grep -n "hy_WrX1vugIhoKTuCJ9qZibTgB_C...
+```
+```
+
+### 25【prose】
+
+```text
+No download error logged for the 16:11 event. Let me correlate precisely — the file was written at 16:11, matching the 附件 event. Let me verify the inbound message's media path and check whether the S3 URL is reachable now.
+```
+
+### 26【prose】
+
+```text
+```
+grep -c "" /opt/data/logs/gateway.log...
+```
+```
+grep -n "16:11:2[0-9]" /opt/data/logs...
+```
+```
+
+### 27【prose】
+
+```text
+The 16:11 event logged **no** "Cached user" and **no** error, and the batch was 15 chars — meaning `media_urls` was likely empty. Let me verify by inspecting the actual Matrix event in that room to see what URL/info it carried.
+```
+
+### 28【prose】
+
+```text
+```
+echo "=== is s3.fmode.cn resolvable/r...
+```
+```
+ls /opt/data/.env 2>/dev/null && grep...
+```
+```
+
+### 29【prose】
+
+```text
+Now let me pull the actual Matrix event from the room to see the real `m.file` content — this is the decisive evidence.
+```
+
+### 30【prose】
+
+```text
+```
+grep -n "non-MXC URL" -B2 -A2 /opt/he...
+```
+```
+cd /opt/data && python3 - <<'PYEOF' ...
+```
+```
+
+### 31【prose】
+
+```text
+Decisive: `info.size` is literally **3** on the wire. Now let me fetch that exact S3 URL to see what the server actually returns.
+```
+
+### 32【prose】
+
+```text
+```
+cd /opt/data && timeout 40 python3 - ...
+```
+```
+
+### 33【prose】
+
+```text
+The chain is verified end to end. The S3 object itself is 3 bytes containing `123` — nothing was lost in transit.
+
+## 1. inbound 处理方式
+
+**取内容的方式** = 直接 HTTP GET `content.url`（https 直链），不走 mxc 转换。仅当 url 以 `mxc://` 开头时才走 `mautrix` 的 `download_media`。
+
+代码位置 = `/opt/hermes/plugins/platforms/matrix/adapter.py`
+
+- `2255-2290` `_fetch_http_media()` — aiohttp 流式 GET，`allow_redirects=False`，**只接受 `status == 200`**，非 200 直接 `return None`
+- `2266-2271` `_download_and_cache_media()`：
+  ```
+  if str(url).startswith("https://"):
+      # Fmode: 附件直读个人存储（s3.fmode.cn），不经 Matrix media
+      file_bytes = await self._fetch_http_media(url, event_id)
+  ```
+- 白名单 `255` `_FMODE_MEDIA_HOSTS = {"s3.fmode.cn"}` —— 你给的域名在册，没被拒
+
+**对 `info.size` 的校验** = 有，但**只当上限用，不当期望值用**：
+```
+2166  if event_size_int and event_size_int > self._max_media_bytes:
+2167      logger.warning("[Matrix] Rejecting oversized inbound media %s (%d > %d bytes)", ...)
+2168      return
+```
+下载完**不与 `info.size` 比对**，写多少算多少。
+
+⚠️ 顺带：`/opt/data/plugins/plugin-matrix-inbound-s3/` **不存在**。入站在 Hermes 核心平台插件里，不是自建插件。
+
+## 2. 落盘代码
+
+**`doc_` 谁生成** = Hermes 核心 `cache_document_from_bytes()`，`uuid4().hex[:12]`
+
+代码位置 = `/opt/hermes/gateway/platforms/base.py:1428-1441`
+```python
+filepath = cache_dir / f"doc_{uuid.uuid4().hex[:12]}_{safe_name}"
+...
+filepath.write_bytes(data)
+return str(filepath)
+```
+调用方 = `adapter.py:2300` `return await cache_document_from_bytes_async(file_bytes, filename)`
+
+**有没有校验字节数** = **没有**。写完不回读、不比对 `info.size`、不比对 `Content-Length`。这就是为什么 3 字节被当成成功落盘，并作为完整正文交给我。
+
+## 3. 实测日志
+
+我用 `.env` 的 token 拉了该房间原始事件（`$q6YtjsM_J9JBNZ-6vB9qpqt0kbGBDU5_5a-Bl0T5gY4`）：
+
+```json
+{"body":"计划.md","com.fmode.cloud_url":"",
+ "info":{"mimetype":"text/markdown","size":3},"msgtype":"m.file",
+ "url":""}
+```
+
+我直接拉了那个 URL：
+
+**HTTP 状态 = 200**
+
+**写入字节 = 3**，回读原文 `content_repr: b'123'`
+
+```
+Content-Type: text/markdown
+Content-Length: 3
+ETag: "202cb962ac59075b964b07152d234b70"   ← 这是 md5("123")
+Last-Modified: Sat, 14 Nov 2026 08:11:23 GMT
+```
+磁盘 `doc_963e5fa78f1d_计划.md` = 3 字节，`od -c` 原文 `1   2   3`。
+
+**有没有错误 = 没有。** 16:11:24 日志只有一行 `inbound message ... msg='计划.md'`，无 404 / 无 timeout / 无 `Failed to cache media`。日志里剩下的 3 条 `non-MXC URL` 是 11-13 的旧告警，早于白名单补丁。
+
+**结论：链路没丢字节。S3 上那个对象本身就是 3 字节 `123`。** 问题在上游写入 —— App 上传时 `size:3` 与对象实际一致，说明 `sendFileByUrl()` 拿到的源内容就已经是 `123`，或上传了错误的对象。不是接收侧截断。
+
+## 4. 大小上限
+
+**有**
+
+**限制是多少 = 100 MiB 硬上限**，两处生效：
+- `adapter.py:905` `self._max_media_bytes = _env_number("MATRIX_MAX_MEDIA_BYTES", 100 * 1024 * 1024, int)`
+- `base.py:519` `DEFAULT_INBOUND_MEDIA_MAX_BYTES = 128 * 1024 * 1024`（文档类走这条，但入站预检先按 100 MiB 拦）
+
+我查了 `config.yaml` 和 `.env`：**均未设置 `MATRIX_MAX_MEDIA_BYTES` / `max_inbound_media_bytes`**，即生效值是默认 100 MiB = `104857600`。
+
+**100MB 为什么不认：** `test-100MB.md` 若真为 100 MiB，`104857600 > 104857600` 为 False 应放行；但只要超过 1 字节（如 `104857601`）就在 `2166` 被静默 `return` —— **只写 WARNING 日志、不回复用户**，所以表现为「没看到附件」。这与你描述一致。要确认得看那条事件的 `info.size` 和当日 WARNING 行——目前 `gateway.log` 里没有该条 `Rejecting oversized` 记录，说明那次事件的 `info.size` 可能缺失或事件根本没到 `_handle_media_message`。给我那个事件 ID 我可以直接拉原始 content 对账。
+```
+
+### 34【ack】
+
+```text
+✅ 容器已标记完成
+```
+
+---
+
+## 工具过程（仅供核对，非回答内容）
+
+- `💻 terminal ``` ls -la /opt/data/plugins/ 2>/dev/null... ````

docs/03-interface/容器侧-统一800MB且只走S3.md

@@ -0,0 +1,176 @@
+# 容器侧改造：只保留 S3 一条路径 + 上限统一 800MB
+
+用户裁决原文：
+
+> **严格禁止退回模式，只能有 s3 的模式。如果失败给出提示，并且撤回输出以及回复，清空会话页面。**
+
+> **文件不能设置上传的大小上限，修改为 800MB。lj-test 和 ksf 都需要优化。**
+
+---
+
+# 必须做到的四件事
+
+## 一、只保留 S3 一条路径
+
+### 1.1 入站：删掉 mxc 分支
+
+你梳理出的现状：
+
+> 「入站有**两条**并存的 URL 通道：`mxc://`（Matrix 中转）与 `https://`（直读 S3），
+>  闸门是二选一的白名单，不是只留一条。」
+
+**改成：只接受 `https://` 的云盘地址，`mxc://` 一律拒绝。**
+
+```python
+# 入站处理里，凡是判断 url 类型的地方，改成：
+if url.startswith("mxc://"):
+    log("REJECT inbound mxc（附件只允许云盘直链）: %s" % url)
+    # 🔴 必须回复用户，不能静默
+    reply_to_user("收到的附件不是云盘直链，已拒绝。请让 App 重新发送。")
+    return
+```
+
+### 1.2 出站：删掉 E2EE 的 mxc 分支
+
+你说：
+
+> 「出站有**两条**产 url 的路径：复用 `pushed[]` 已有 https（主路径），
+>  与 E2EE 下 `upload_media` 产 mxc（例外路径）。」
+
+🔴 **E2EE 这条也是 mxc —— 一并删掉。**
+本项目不使用 E2EE 房间，这条分支永远走不到，留着只会误导。
+
+```python
+# 删掉 needs_encrypted 分支里的 mxc 逻辑
+# 统一改成：
+media_url = _preuploaded_lookup(filename, len(upload_data))
+if not media_url:
+    log("FAIL outbound: 没有可用的云盘直链（filename=%s）" % filename)
+    return _fail("no-preuploaded-url")   # 出站失败要有明确错误
+```
+
+---
+
+## 二、上限统一 800MB（7 处全改）
+
+你梳理出的清单，**每一处都要改**：
+
+| 文件:行号 | 现值 | 改成 |
+|---|---|---|
+| `adapter.py:905` | `100 * 1024 * 1024` | **`800 * 1024 * 1024`** |
+| **`fmode-deliverable-hook.py:159`** | **`40 * 1024 * 1024`** | **`800 * 1024 * 1024`** ← **真瓶颈** |
+| `outbound-s3:253` | 读 `_max_media_bytes` | 跟随上面的值 |
+
+**建议做法**（避免以后再改 7 处）：
+
+```python
+# adapter.py
+MAX_MEDIA_BYTES = int(os.environ.get("MATRIX_MAX_MEDIA_BYTES", str(800 * 1024 * 1024)))
+self._max_media_bytes = MAX_MEDIA_BYTES
+
+# fmode-deliverable-hook.py
+MAX_BYTES = int(os.environ.get("FMODE_DELIVERABLE_MAX_BYTES", str(800 * 1024 * 1024)))
+```
+
+**并在 `/opt/data/.env` 里显式写上这两个值**（不要只靠代码默认，便于以后调整）：
+
+```
+MATRIX_MAX_MEDIA_BYTES=838860800
+FMODE_DELIVERABLE_MAX_BYTES=838860800
+```
+
+---
+
+## 三、失败必须回复用户（不许静默）
+
+你梳理出的现状：
+
+| 场景 | 现在的行为 |
+|---|---|
+| 入站 `info.size` 超限 | **静默丢弃**，只写 WARNING |
+| 入站 https 流式超限 | **静默丢弃** |
+| 出站超限 | 有 `SendResult(error=...)` ✅ |
+| 交付物 >40MB | `classify()` 返回 False → 不进队列，**无提示** |
+
+**全部改成：超限时明确回复用户。**
+
+```python
+# 入站超限
+if size > MAX:
+    log("REJECT oversized inbound: %s (%d bytes)" % (filename, size))
+    send_matrix_message(room_id,
+        "⚠️ 附件「%s」有 %.1f MB，超过 800MB 上限，未接收。" % (filename, size/1048576))
+    return
+
+# 交付物超限（hook）
+if file_size > MAX_BYTES:
+    log("SKIP deliverable too-large: %s (%d bytes)" % (path, file_size))
+    # 在回复正文里加一行说明，不要静默跳过
+    note = "⚠️ 文件「%s」有 %.1f MB，超过 800MB 交付上限，未上传云端。" % (name, file_size/1048576)
+```
+
+---
+
+## 四、失败时清理，不留半截状态
+
+**这条主要是 App 侧（我已改完），你这边要配合的是：**
+
+- 上传失败 → **不要**在 `pushed[]` 里留下半截记录
+- 登记失败 → **不要**在台账里留孤儿记录
+- 任何一步失败 → 明确告知，不要假装成功
+
+---
+
+# 验证（必须实测）
+
+## 验证 1：只有 S3 一条路
+
+```bash
+echo "=== 还有没有 mxc 分支 ==="
+grep -rn "mxc://\|upload_media\|needs_encrypted" \
+  /opt/data/plugins/ /opt/data/scripts/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+**要回答**：还有几处会产生/接受 mxc？**应该为 0。**
+
+## 验证 2：上限全是 800MB
+
+```bash
+grep -rn "100 \* 1024 \* 1024\|40 \* 1024 \* 1024\|104857600\|41943040" \
+  /opt/data/plugins/ /opt/data/scripts/ /opt/hermes/adapter.py 2>/dev/null | grep -v ".pyc" | head
+```
+
+**要回答**：还有没有残留的 100MB / 40MB？**应该为 0。**
+
+## 验证 3：实测一个 100MB 文件
+
+用户在 App 里发一个 100MB 文件 → 你应该能收到并读出正确的大小。
+
+## 验证 4：超限有提示
+
+发一个 900MB 的文件 → 用户应该收到明确的「超过上限」提示，而不是静默。
+
+---
+
+# 回答格式
+
+```
+## 1. mxc 分支
+grep 结果 = ?
+还剩几处 = ?
+
+## 2. 大小上限
+grep 结果 = ?
+7 处都改了吗 = ?
+
+## 3. 100MB 实测
+收到了吗 = ?
+大小对得上吗 = ?
+
+## 4. 超限提示
+有 / 没有
+文案 = ?
+```
+
+🔴 **改完先重启网关**再验证。
+🔴 只要事实，不许说「已优化」而不给数字。

docs/03-interface/梳理-文件传输完整链路.md

@@ -0,0 +1,95 @@
+# 梳理：文件传输的完整链路（找出为什么会有多个上限、多条路径）
+
+用户裁决：
+1. 文件**不能**通过 Matrix 传输，必须是 S3 链接
+2. **取消上传大小上限**，改为 800MB
+3. lj-test 和 kangshifu **都要改**
+4. **先梳理，再设计**，不要直接改
+
+---
+
+# 一、请如实回答这几个问题（只读）
+
+## Q1：App → 容器，文件到底怎么过去的
+
+**这是用户最关心的一点**：文件本体到底有没有经过 Matrix？
+
+```bash
+# 看入站媒体插件如何处理 App 发来的 m.file
+ls -la /opt/data/plugins/plugin-matrix-inbound-s3/ 2>/dev/null
+grep -n "def \|mxc\|download\|fetch\|http" /opt/data/plugins/plugin-matrix-inbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：
+- App 发来 `m.file`，`url` 字段是 `https://s3...` 还是 `mxc://`？
+- 容器是**直接下载那个 https URL**，还是先转成 mxc 再下载？
+- **文件本体有没有经过 Matrix 服务器？**
+
+## Q2：容器 → App，文件怎么过去的
+
+```bash
+grep -n "def \|send_content_event\|msg_content\|url" /opt/data/plugins/plugin-matrix-outbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：发出去的 `m.file` 里，`url` 是 https 还是 mxc？文件本体经过 Matrix 吗？
+
+## Q3：现在有几处大小限制（全部列出来）
+
+```bash
+echo "=== App 侧（我不知道，你只看容器侧）==="
+grep -rn "max_media_bytes\|MAX_FILE_BYTES\|max_inbound\|max_size\|too large\|oversize\|104857600\|20971520" \
+  /opt/data/plugins/ /opt/data/scripts/ /opt/data/config.yaml /opt/data/.env 2>/dev/null | grep -v ".pyc" | head -30
+
+echo "=== Hermes 内核默认值 ==="
+grep -rn "DEFAULT_INBOUND_MEDIA_MAX_BYTES\|_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" \
+  /opt/hermes/ 2>/dev/null | head -20
+```
+
+**要回答**：把所有限制列成表 —— 哪个文件、哪一行、值是多少、在哪一步生效。
+
+## Q4：超限时的行为
+
+```bash
+grep -rn "Rejecting oversized\|too large\|oversize" /opt/hermes/ /opt/data/plugins/ 2>/dev/null | head -20
+```
+
+**要回答**：超限时是**静默丢弃**还是**回复用户**？
+
+---
+
+# 二、我这边已知的事实（供你对照）
+
+| 项 | App 侧现状 |
+|---|---|
+| App → 容器 | `sendFileByUrl()`：先传云盘，事件里 `url = https://s3...`，**文件本体不进 Matrix** |
+| 容器 → App | 容器发 `m.file`，`url = https://s3.../deliverables/...` |
+| App 侧大小限制 | `CLOUD_LIMIT_BYTES = Infinity`（**不限制**） |
+
+**所以 App 侧本来就是「只传链接」。** 需要确认容器侧是不是也这样。
+
+---
+
+# 三、回答格式
+
+```
+## Q1 App → 容器
+url 字段 = https / mxc
+文件本体经过 Matrix 吗 = 是/否
+代码位置 = ?
+
+## Q2 容器 → App
+url 字段 = https / mxc
+文件本体经过 Matrix 吗 = 是/否
+代码位置 = ?
+
+## Q3 所有大小限制
+| 文件:行号 | 值 | 在哪一步生效 |
+|---|---|---|
+| ... | ... | ... |
+
+## Q4 超限行为
+静默 / 回复用户 = ?
+代码位置 = ?
+```
+
+🔴 只要事实和代码原文。**不要提建议，先梳理清楚。**

docs/03-interface/问ljtest-附件只收到3字节.md

@@ -0,0 +1,103 @@
+# App 发来的附件，你只收到 3 字节 —— 请查清接收链路
+
+## 现象（用户实测）
+
+用户在 App 里发了一个 `计划.md` 附件，界面显示 `3 B`。
+
+你收到后说：
+
+> 计划.md 收到，但内容没有一并传过来 —— 我这边只看到文件名，正文是空的。
+> 路径：`/opt/data/cache/documents/doc_963e5fa78f1d_计划.md`，3 字节。
+
+**另外那个 100MB 的 `test-100MB.md`，你直接说「没看到附件」。**
+
+---
+
+# App 侧发的是什么（我这边的事实）
+
+App 用 `matrix-client.service.ts:965 sendFileByUrl()` 发送，事件结构：
+
+```js
+{
+  msgtype: 'm.file',
+  body: '计划.md',
+  url: 'https://s3.fmode.cn/user/<uid>/chat/.../xxx-file',   // ← 云盘直链，不是 mxc
+  info: { mimetype: 'text/markdown', size: 3 },
+  'com.fmode.cloud_url': 'https://s3.fmode.cn/user/...'      // ← 双写
+}
+```
+
+**不是 mxc，是 https 直链。**
+
+---
+
+# 要你查的（只读，贴原文）
+
+## 1. 你的 inbound 插件怎么处理 `m.file`
+
+```bash
+ls -la /opt/data/plugins/plugin-matrix-inbound-s3/ 2>/dev/null
+grep -n "m.file\|msgtype\|download\|fetch\|url" /opt/data/plugins/plugin-matrix-inbound-s3/__init__.py 2>/dev/null | head -30
+```
+
+**要回答**：
+- 收到 `m.file` 事件后，它怎么取文件内容？
+- 是下载 `content.url` 吗？还是走 `mxc` 转换？
+- 有没有对 `info.size` 做校验？
+
+## 2. 落盘到 `cache/documents/` 的代码
+
+```bash
+grep -rn "cache/documents\|doc_" /opt/data/plugins/ /opt/data/scripts/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+**要回答**：`doc_<hash>_<name>` 这个文件名是谁生成的？写完有没有校验字节数？
+
+## 3. 实际收一个附件，看日志
+
+请用户配合再发一次，或者你自己造一个：
+
+```bash
+# 先看最近的 inbound 日志
+grep -n "inbound\|attachment\|download\|doc_" /opt/data/logs/*.log 2>/dev/null | tail -30
+```
+
+**要回答**：
+- 下载那个 https URL 时 HTTP 状态码是多少？
+- 实际写入多少字节？
+- 有没有 error / 404 / timeout？
+
+## 4. 100MB 为什么不认
+
+```bash
+grep -rn "MAX.*SIZE\|max_size\|file too large\|20 ?\* ?1024\|10485760\|20971520" \
+  /opt/data/plugins/plugin-matrix-inbound-s3/ /opt/data/scripts/ 2>/dev/null | head -10
+```
+
+**要回答**：有没有大小上限？是多少？
+
+---
+
+# 回答格式
+
+```
+## 1. inbound 处理方式
+取内容的方式 = ?
+代码位置 = ?
+
+## 2. 落盘代码
+doc_ 谁生成 = ?
+有没有校验字节数 = ?
+代码位置 = ?
+
+## 3. 实测日志
+HTTP 状态 = ?
+写入字节 = ?
+有没有错误 = ?
+
+## 4. 大小上限
+有 / 没有
+限制是多少 = ?
+```
+
+🔴 只要事实和代码原文。

docs/03-interface/问两台-40MB到底在哪.md

@@ -0,0 +1,64 @@
+# 40MB 这个限制，到底在哪台、哪个文件？
+
+## 我收到的两份矛盾反馈
+
+**lj-test 说：**
+> `fmode-deliverable-hook.py:124,159` → `MAX_BYTES = 40 * 1024 * 1024`
+> `classify()` 返回 `(False, "too-large(>40MB)")` → 文件不进交付物队列
+
+**kangshifu 说：**
+> 「`fmode-deliverable-hook.py` 并不存在」「我确认了事实：40MB 在磁盘上并不存在」
+
+---
+
+# 两条都要给证据（只读，原样贴输出）
+
+## 1. 列出所有 py 里含 40MB / 41943040 的地方
+
+```bash
+grep -rn "40 \* 1024 \* 1024\|41943040\|40MB\|too-large" \
+  /opt/data/scripts/ /opt/data/plugins/ /opt/data/*.py 2>/dev/null | grep -v ".pyc"
+```
+
+## 2. 你这台到底有哪些 deliver 相关脚本
+
+```bash
+ls -la /opt/data/scripts/*deliver* /opt/data/scripts/*artifact* 2>/dev/null
+```
+
+## 3. 所有大小上限（含 100MB 那些）
+
+```bash
+grep -rn "1024 \* 1024" /opt/data/scripts/ /opt/data/plugins/ 2>/dev/null | grep -v ".pyc" | head -20
+```
+
+## 4. Hermes 内核的 100MB
+
+```bash
+grep -n "_max_media_bytes\|MATRIX_MAX_MEDIA_BYTES" /opt/hermes/*/adapter.py /opt/hermes/**/adapter.py 2>/dev/null | head -10
+ls -la /opt/hermes/*/adapter.py /opt/hermes/**/*/adapter.py 2>/dev/null | head -5
+```
+
+---
+
+# 回答格式
+
+```
+## 1. 40MB 命中
+<grep 原文输出>
+
+## 2. deliver 脚本清单
+<ls 原文>
+
+## 3. 所有 1024*1024 上限
+<grep 原文>
+
+## 4. 内核 100MB
+<grep 原文>
+
+## 结论
+40MB 在这台存在吗 = 是/否
+如果存在，在哪个文件:行号 = ?
+```
+
+🔴 原样贴输出，不要总结、不要推测。

src/app/components/domain/assistant-turn/assistant-turn.spec.ts

@@ -97,13 +97,20 @@ describe('AssistantTurnComponent', () => {
     expect(fixture.nativeElement.querySelector('.turn-head')).toBeNull();
   });
 
-  it('输出中默认展开，能看到步骤', () => {
+  it('输出中**不**渲染折叠步骤列表（改由 live-activity 承担，2026-11-14）', () => {
+    /*
+     * 用户截图实证「同一张卡内上下重复」：
+     * 卡片头因 !live 被隐藏，但 step-list 只判 expanded() 照常渲染，
+     * 与段内 app-live-activity 撞在一起，同一批步骤出现两次。
+     * 现在 step-list 与卡片头同口径：执行中不渲染。
+     */
     const t = turn({ live: true, phase: 'replying' });
     t.blocks[0].live = true;
     render(t);
 
-    expect(fixture.nativeElement.querySelector('.step-list')).not.toBeNull();
-    expect(fixture.nativeElement.querySelectorAll('.step').length).toBe(1);
+    expect(fixture.nativeElement.querySelector('.step-list'))
+      .withContext('执行中的步骤只由 live-activity 显示')
+      .toBeNull();
   });
 
   it('输出结束后默认收起（用户裁决）', () => {

src/app/components/domain/assistant-turn/assistant-turn.ts

@@ -78,7 +78,19 @@ import { ProcessStep } from '../../../core/message-segments';
         </button>
       }
 
-      @if (expanded() && turn().stepCount > 0) {
+      <!--
+        2026-11-14：折叠步骤列表必须「回合已结束」才渲染。
+
+        原条件只有 expanded + stepCount，不判 live，于是执行中：
+          · 卡片头 turn-head 因 !live 被隐藏
+          · 但这份 step-list 照常渲染
+          · 段内 app-live-activity（seg.live）也在渲染
+        同一批步骤上下各出现一次（用户截图实证「同一张卡内重复」）。
+
+        现在判定与卡片头对齐：执行中只看 app-live-activity，
+        结束后只看这份折叠列表，物理上不可能重复。
+      -->
+      @if (expanded() && turn().stepCount > 0 && !turn().live) {
         <ul class="step-list" [id]="'steps-' + turn().id">
           @for (s of allSteps(); track $index) {
             <li class="step" [attr.data-kind]="s.kind">

src/app/core/chat.service.spec.ts

@@ -1162,7 +1162,7 @@ describe('ChatService', () => {
         .toBeTruthy();
     });
 
-    it('上传失败 → 记录错误且不上传中，附件保留待重试', async () => {
+    it('上传失败 → 记录错误、回滚消息、清空附件（2026-11-14 裁决）', async () => {
       realMode();
       await svc.open('agent-node-lj-test');
       mxStub.sendFileByUrl.and.returnValue(Promise.reject(new Error('上传失败')));
@@ -1171,7 +1171,15 @@ describe('ChatService', () => {
         await svc.sendText('附上');
         expect(svc.error()).toContain('失败');
         expect(svc.uploading()).toBeFalse();
-        expect(svc.pendingFiles().length).withContext('失败后应保留待重试').toBe(1);
+        /*
+         * 🔴 用户裁决：「失败给出提示，并且撤回输出以及回复，清空会话页面」。
+         * 原行为是保留附件待重试 —— 但附件上传已经失败，留着只会让人再点一次。
+         */
+        expect(svc.pendingFiles().length).withContext('失败后清空附件').toBe(0);
+        expect(svc.messages().filter((m) => m.sender === 'me').length)
+          .withContext('未发出的话不能留在消息流里')
+          .toBe(0);
+        expect(svc.draft()).withContext('文字还回草稿').toBe('附上');
       } finally {
         // 还原桩：jasmine 的 spy 返回值是跨用例共享的
         mxStub.sendFileByUrl.and.returnValue(Promise.resolve({ event_id: '$fu' }));
@@ -1182,7 +1190,7 @@ describe('ChatService', () => {
      * 2026-11-10：上云顺序调整为「先 S3、再 Matrix」。
      * 目的：不发出去「聊天记录里有、云盘里没有」的半成品文件。
      */
-    it('🔴 云盘失败 → 不发 Matrix、附件保留待重试', async () => {
+    it('🔴 云盘失败 → 不发 Matrix、整体回滚（2026-11-14 裁决）', async () => {
       realMode();
       await svc.open('agent-node-lj-test');
       apiStub.uploadFile.and.returnValue(Promise.reject(new Error('云盘不可用')));
@@ -1193,7 +1201,9 @@ describe('ChatService', () => {
 
       expect(mxStub.sendFileByUrl).not.toHaveBeenCalled();
       expect(svc.error()).toContain('云盘不可用');
-      expect(svc.pendingFiles().length).withContext('未上云的文件不得被清掉').toBe(1);
+      /* S3 是唯一路径：失败就整体失败，不留半截状态 */
+      expect(svc.pendingFiles().length).withContext('失败后清空附件').toBe(0);
+      expect(svc.messages().filter((m) => m.sender === 'me').length).toBe(0);
     });
 
     it('🔴 顺序为先云盘后 Matrix（避免半成功）', async () => {
@@ -1223,18 +1233,15 @@ describe('ChatService', () => {
        * 🔴 2026-11-13 用户裁决「上传的文件没有大小限制」：`'url'` 模式不拦截。
        *    拦截逻辑本身仍在，这里用 `'mxc'` 回退模式验证它没被删掉。
        */
-      localStorage.setItem('fmode.sendMode', 'mxc');
-      setServerUploadLimit(32 * 1024 * 1024);
       try {
         const big = new File([new Uint8Array(8)], 'big.zip');
-        Object.defineProperty(big, 'size', { value: 40 * 1024 * 1024 });
+        Object.defineProperty(big, 'size', { value: 900 * 1024 * 1024 });
 
         svc.stageFiles([big]);
 
         expect(svc.pendingFiles().length).toBe(0);
         expect(svc.error()).toContain('超过平台单文件上限');
       } finally {
-        localStorage.removeItem('fmode.sendMode');
       }
     });
 
@@ -1264,12 +1271,10 @@ describe('ChatService', () => {
     it('多选时只挡掉超限的，合格的照常暂存', async () => {
       realMode();
       await svc.open('agent-node-lj-test');
-      localStorage.setItem('fmode.sendMode', 'mxc');
-      setServerUploadLimit(32 * 1024 * 1024);
       try {
         const small = file();
         const big = new File([new Uint8Array(8)], 'big.zip');
-        Object.defineProperty(big, 'size', { value: 40 * 1024 * 1024 });
+        Object.defineProperty(big, 'size', { value: 900 * 1024 * 1024 });
 
         svc.stageFiles([small, big]);
 
@@ -1277,7 +1282,6 @@ describe('ChatService', () => {
         expect(svc.pendingFiles()[0].file.name).toBe('doc.txt');
         expect(svc.error()).toContain('big.zip');
       } finally {
-        localStorage.removeItem('fmode.sendMode');
       }
     });
 

src/app/core/chat.service.ts

@@ -16,7 +16,6 @@ import { AlertService } from './alert.service';
 import { extractDeliveredLinks, extractS3Links, isCloudUrl, isUserUploadUrl, prettifyStorageKey, stripLinks } from './s3-link';
 import { isOversize, notifyOversize, oversizeMessage } from './upload-limits';
 import { batchPhase, FileProgress, overallPct, UploadPhase } from './upload-state';
-import { currentSendMode } from './send-mode';
 import { environment } from '../../environments/environment';
 import { LiveService } from './live.service';
 import { SessionService } from './session.service';
@@ -2221,16 +2220,32 @@ export class ChatService {
          */
         /*
          * 🔴 先把暂存的附件发出去（用户要求:选文件 → 点发送 → 图文一起走）。
-         * 附件失败不阻塞文字发送,但要如实告知。
+         *
+         * ## 2026-11-14 用户裁决：附件失败 = **整条发送失败**
+         *
+         * 原实现是「附件失败不阻塞文字发送」—— 文字照发、只提示附件失败。
+         * 用户实测后的要求（原话）：
+         *
+         *   「严格禁止退回模式，只能有 s3 的模式。如果失败给出提示，
+         *     并且撤回输出以及回复，清空会话页面。」
+         *
+         * 理由：附件走不了 S3 时，容器只收到一句没有附件的文字，
+         * 它会回「没看到附件」—— 用户白等一轮，会话里还多出半截对话。
+         * 与其留下脏状态，不如**当场失败、当场清干净**。
          */
         if (this._pendingFiles().length > 0) {
           const { fail } = await this.uploadPending(conversationId);
-          /*
-           * 具体原因由 uploadPending 逐条写入（哪个文件、为什么失败）；
-           * 这里只在**没有具体原因**时补一句汇总，避免覆盖掉有用信息。
-           */
-          if (fail > 0 && !this._error()) {
-            this._error.set(`${fail} 个附件上传失败，可重试`);
+          if (fail > 0) {
+            /*
+             * 逐条失败原因已由 uploadPending 写入 `_error` / 全局提示；
+             * 这里负责**回滚**：撤掉刚插入的本条消息、清空草稿与暂存附件，
+             * 让页面回到「发送前」的状态，用户可以直接重试。
+             */
+            this.rollbackSend(msg.id);
+            this._error.set(
+              this._error() ?? `${fail} 个附件未上传到云盘，本条消息未发送`,
+            );
+            return;
           }
         }
 
@@ -2338,11 +2353,11 @@ export class ChatService {
   /**
    * 发一条「文件已在个人存储」的附件事件（2026-11-13，单聊/群聊共用）。
    *
-   * ## 为什么要按模式分发
+   * ## 🔴 只有一条路径（2026-11-14 用户裁决）
    *
-   * - `'url'`（默认）：文件只在个人 storage 里存一份，事件 `content.url` 就是云盘地址，
-   *   本体**不进 Matrix**（用户裁决：只允许收发 cdn/obs 地址）。
-   * - `'mxc'`（回退）：容器补丁未落地时，把 `file` 整份传进 Matrix 媒体库。
+   * 文件只在个人 storage 里存一份，事件 `content.url` 就是云盘地址，
+   * 本体**永不进 Matrix**。原来的 `'mxc'` 回退模式已删除 ——
+   * 见 `send-mode.ts` 的注释（两条路径 = 两套大小限制 + 两种故障模式）。
    *
    * 调用方**必须先成功拿到 `cloudUrl`** 才能调本方法 —— 保证「发出去的文件 = 能长期访问的文件」。
    */
@@ -2354,13 +2369,6 @@ export class ChatService {
     threadRootId?: string,
     extra?: Record<string, unknown>,
   ): Promise<{ event_id?: string }> {
-    if (currentSendMode() === 'mxc') {
-      // 回退模式：文件整份进 Matrix，cloudUrl 只作 `com.fmode.cloud_url` 附带
-      return this.mx.sendFile(roomId, file, card, threadRootId, undefined, {
-        ...(cloudUrl ? { [CLOUD_URL_KEY]: cloudUrl } : {}),
-        ...(extra ?? {}),
-      });
-    }
     if (!cloudUrl) throw new Error('「' + card.name + '」尚未上传到个人存储，未发送');
     return this.mx.sendFileByUrl(roomId, cloudUrl, card, threadRootId, undefined, {
       [CLOUD_URL_KEY]: cloudUrl,
@@ -2697,19 +2705,24 @@ export class ChatService {
         } catch (e) {
           fail++;
           failedIds.add(pending[i].id);
+          const why = e instanceof Error ? e.message : '上传失败';
           /* 如实告知失败原因（S3 先行后，这里通常是「云盘没存上」⇒ 未发送） */
-          this._error.set(
-            `「${file.name}」发送失败：${e instanceof Error ? e.message : '上传失败'}`,
-          );
+          this._error.set(`「${file.name}」发送失败：${why}`);
           /*
-           * 失败项标成 `failed`：胶囊上显示「上传失败」并保留 ✕ 让用户移除。
-           * 不在这里弹全局提示 —— 失败项本身就在输入框上方可见，
-           * 再弹一条只是噪音；真正需要全局提示的是「根本没进暂存区」的超限。
+           * 🔴 2026-11-14 用户裁决：S3 是唯一路径，失败必须**明确提示**。
+           *
+           * 原来只写 `_error`（仅在「消息区整体 error 空态」渲染）——
+           * 正常会话里用户完全看不到，只感觉「发了没反应」。
+           * 现在同时走全局提示，任何页面都可见、可手动关。
            */
+          this.alerts.show(
+            `「${file.name}」未能上传到云盘`,
+            `${why}。附件只走云盘直链，不会退回其它通道 —— 本条消息未发送。`,
+          );
           this.setFileProgress(pending[i].id, {
             phase: 'failed',
             pct: 0,
-            error: e instanceof Error ? e.message : '上传失败',
+            error: why,
           });
         }
       }
@@ -3763,6 +3776,29 @@ export class ChatService {
     this.rememberDemoHistory();
   }
 
+  /**
+   * 发送失败 → **回滚到发送前**（2026-11-14 用户裁决）。
+   *
+   * 用户原话：「如果失败给出提示，并且撤回输出以及回复，清空会话页面。」
+   *
+   * 三件事：
+   *   ① 把刚插入的那条我方消息**移除**（它根本没发出去，留着就是假的）
+   *   ② 文字**还回草稿**，用户不用重打
+   *   ③ 清空暂存附件（它们的上传已经失败，留着只会让人再点一次）
+   *
+   * 🔴 与 `markFailed` 的区别：那个把消息标红留着重试，
+   *    用于「已发出但回执失败」。这里连消息都没有，留着只剩困惑。
+   */
+  private rollbackSend(localId: string): void {
+    const victim = this._messages().find((m) => m.id === localId);
+    this._messages.update((list) => list.filter((m) => m.id !== localId));
+    /* 文字回填：用户刚打的内容不能丢 */
+    const text = victim?.text?.trim();
+    if (text && !this._draft().trim()) this._draft.set(text);
+    /* 暂存附件清空（上传已失败，重新选比留着更有确定性） */
+    this.clearPendingFiles();
+  }
+
   private markFailed(id: string, error: string): void {
     this._messages.update((list) =>
       list.map((m) => (m.id === id ? { ...m, state: 'failed', error } : m)),

src/app/core/group-send.service.ts

@@ -1,7 +1,6 @@
 import { Injectable, inject, signal } from '@angular/core';
 import { ChatSessionService } from './chat-session.service';
 import { ChatSession } from './chat-session';
-import { currentSendMode } from './send-mode';
 import { ChatService, PendingFile } from './chat.service';
 import { isOversize, oversizeMessage } from './upload-limits';
 import { DispatchAnchor, GroupLiveService } from './group-live.service';
@@ -158,18 +157,16 @@ export class GroupSendService {
        * 群聊这里漏了同一条约束。
        */
       /*
-       * 🔴 `'mxc'` 回退模式**不在这里预上传**（2026-11-13 评审 S1）。
+       * 🔴 2026-11-14 用户裁决：**只有一条路径，不能走 mxc**。
        *
-       * 原先无论模式都先 `uploadToCloud()`，然后 `sendFileToAgent()` 在 mxc 模式下
-       * 忽略 cloudUrl、把 file 传进 Matrix —— 看似正常，但「上云失败就整体 abort」
-       * 这条约束在回退模式下反而帮了倒忙：云盘一抖，本来能发的 Matrix 副本也发不出。
-       * 回退模式的语义是「回到改造前」，所以这里直接跳过，交给 `sendFile()`。
+       * 原实现按 `currentSendMode()` 决定是否预上传，为「回退到整份传 Matrix」
+       * 留了一条分支。现在该模式已删除，这里无条件先上云、再发 https 链接。
+       * 云盘失败就整体 abort —— 这是唯一语义（发出去的文件必须能长期访问）。
        */
-      const useCloud = currentSendMode() === 'url';
       let cloudFailed = false;
-      /** 文件 → 云盘地址（`'url'` 模式下各成员房间复用同一地址，不再各传一份） */
+      /** 文件 → 云盘地址（各成员房间复用同一地址，不再各传一份） */
       const cloudUrls = new Map<File, string>();
-      for (const pf of useCloud ? files : []) {
+      for (const pf of files) {
         try {
           const up = await this.chat.uploadToCloud(pf.file);
           cloudUrls.set(pf.file, up.publicUrl);

src/app/core/send-mode.ts

@@ -1,35 +1,46 @@
 /**
- * 附件发送模式（2026-11-13 用户裁决：走个人 storage，不经 Matrix）
+ * 附件发送模式（2026-11-14 用户裁决：**只有一条路径，不能走 mxc**）
  *
- * ## 两种模式
+ * ## 唯一路径
  *
- * - `'url'`（默认）：文件**只**直传用户个人 storage（OBS `s3.fmode.cn`），
- *   发 `m.file`/`m.image` 事件时 `content.url` 直接填云盘 https 地址。
- *   文件本体**不再进 Matrix 媒体库**。
- * - `'mxc'`：旧的双写路径（`uploadContent` → `mxc://`），仅在容器侧补丁
- *   未落地时用作回退。
+ * 文件**只**直传用户个人 storage（OBS `s3.fmode.cn`），
+ * 发 `m.file`/`m.image` 事件时 `content.url` 直接填云盘 https 地址。
+ * **文件本体永不进 Matrix 媒体库。**
  *
- * ## 回退方式（无需发版）
+ * ## 🔴 为什么删掉了 `'mxc'` 回退
  *
- * 浏览器控制台执行 `localStorage.fmode.sendMode = 'mxc'` 后刷新即可回到旧链路；
- * `localStorage.removeItem('fmode.sendMode')` 恢复默认。
+ * 原实现留了一条「容器补丁没落地时回退到整份传 Matrix」的路径
+ * （`localStorage.fmode.sendMode = 'mxc'`）。用户明确裁决：
  *
- * ## 🔴 切换顺序不能颠倒
+ * > 「不能有旧模式，只能有一条路径，不能走 mxc。」
  *
- * 容器侧 `adapter.py` 在补丁落地前**会拒收非 mxc 的 url**（静默丢附件）。
- * 必须先用 `scripts/probe-url-attachment.mjs` 确认容器能收到 https 附件，
- * 再默认走 `'url'`。详见 `docs/03-interface/容器侧改造-附件直读S3地址-任务书-20261113.md`。
+ * 留回退的代价：
+ *   · 两条路径 = 两套大小限制（Matrix 32MB vs 云盘无限）
+ *   · 两条路径 = 两种故障模式，排查时要先问「你现在是哪个 mode」
+ *   · 一旦有人（或某次调试）切回 mxc，大文件就会静默失败，且没人知道为什么
+ *
+ * 现在**物理上不存在 mxc 路径** —— 读到这里就是唯一真相。
+ *
+ * ## 迁移
+ *
+ * 存量用户浏览器里可能还残留 `fmode.sendMode = 'mxc'`。
+ * `currentSendMode()` 会忽略它（恒返回 `'url'`），并在首次调用时清掉，
+ * 避免那条 key 永远躺在 localStorage 里误导排查。
  */
-export type SendMode = 'url' | 'mxc';
+export type SendMode = 'url';
 
-const STORAGE_KEY = 'fmode.sendMode';
+/** 历史遗留键：读到就删（值不再有任何效果） */
+const LEGACY_STORAGE_KEY = 'fmode.sendMode';
 
-/** 当前生效的附件发送模式 */
+/** 当前生效的附件发送模式 —— 恒为 `'url'` */
 export function currentSendMode(): SendMode {
   try {
-    return localStorage.getItem(STORAGE_KEY) === 'mxc' ? 'mxc' : 'url';
+    if (localStorage.getItem(LEGACY_STORAGE_KEY) !== null) {
+      localStorage.removeItem(LEGACY_STORAGE_KEY);
+      console.info('[sendMode] 已移除历史遗留的 fmode.sendMode 键：附件只走云盘直链');
+    }
   } catch {
-    // 隐私模式/无 storage：按默认走
-    return 'url';
+    /* 隐私模式 / 无 storage：无需清理 */
   }
+  return 'url';
 }

src/app/core/upload-limits.spec.ts

@@ -1,43 +1,45 @@
-import { CLOUD_LIMIT_BYTES, isOversize, notifyOversize, setServerUploadLimit, uploadLimitBytes } from './upload-limits';
+import {
+  CLOUD_LIMIT_BYTES,
+  isOversize,
+  notifyOversize,
+  setServerUploadLimit,
+  uploadLimitBytes,
+} from './upload-limits';
 import { currentSendMode } from './send-mode';
 
 /**
- * 附件上限「跟着发送模式走」（2026-11-13）。
+ * 附件上限（2026-11-14 用户裁决：**只有一条路径，不能走 mxc**）。
  *
- * `'url'` 模式下文件只进个人存储，Matrix 的 `m.upload.size` 与我们无关；
- * `'mxc'` 回退模式下仍要传进 Matrix，必须回到服务端上限。
+ * 文件只进个人 storage，Matrix 的 `m.upload.size` 与我们无关；
+ * 统一上限 800MB。原来的 `'mxc'` 回退模式及其 32MB 口径已删除。
  */
-describe('upload-limits（按发送模式取上限）', () => {
+describe('upload-limits（统一 800MB）', () => {
   afterEach(() => {
     localStorage.removeItem('fmode.sendMode');
     setServerUploadLimit(null);
   });
 
-  it('默认模式为 url', () => {
+  it('当前模式恒为 url（mxc 回退已删除）', () => {
     expect(currentSendMode()).toBe('url');
+    /* 即使 localStorage 里残留旧 key，也不再生效 */
+    localStorage.setItem('fmode.sendMode', 'mxc');
+    expect(currentSendMode()).withContext('旧 key 被忽略').toBe('url');
   });
 
-  it("'url' 模式：**不限制**大小（2026-11-13 用户裁决），忽略 Matrix 的 32MB", () => {
+  it('统一上限 800MB，忽略 Matrix 上报的 32MB', () => {
     setServerUploadLimit(32 * 1024 * 1024);
+    expect(CLOUD_LIMIT_BYTES).withContext('800MB').toBe(800 * 1024 * 1024);
     expect(uploadLimitBytes()).toBe(CLOUD_LIMIT_BYTES);
-    expect(CLOUD_LIMIT_BYTES).withContext('云盘模式不设上限').toBe(Number.POSITIVE_INFINITY);
-    expect(isOversize({ size: 60 * 1024 * 1024 })).toBeFalse();
-    expect(isOversize({ size: 2 * 1024 * 1024 * 1024 })).toBeFalse();
+    /* 600MB 放行（旧实现会被 Matrix 的 32MB 拦掉） */
+    expect(isOversize({ size: 600 * 1024 * 1024 })).toBeFalse();
+    /* 超过 800MB 拦截 */
+    expect(isOversize({ size: 900 * 1024 * 1024 })).toBeTrue();
   });
 
-  it("'mxc' 回退模式：回到 Matrix 服务端上限", () => {
-    localStorage.setItem('fmode.sendMode', 'mxc');
-    setServerUploadLimit(32 * 1024 * 1024);
-    expect(uploadLimitBytes()).toBe(32 * 1024 * 1024);
-    expect(isOversize({ size: 40 * 1024 * 1024 })).toBeTrue();
-  });
-
-  it('超限提示文案用的是**当前生效**的上限（回退模式下为 Matrix 值）', () => {
-    localStorage.setItem('fmode.sendMode', 'mxc');
-    setServerUploadLimit(32 * 1024 * 1024);
+  it('超限提示文案用的是 800MB', () => {
     const shown: string[] = [];
     const alerts = { show: (_t: string, d?: string) => shown.push(d ?? '') };
-    notifyOversize(alerts, [{ name: 'a.zip', size: 40 * 1024 * 1024 }]);
-    expect(shown[0]).toContain('32.0MB');
+    notifyOversize(alerts, [{ name: 'a.zip', size: 900 * 1024 * 1024 }]);
+    expect(shown[0]).toContain('800.0MB');
   });
 });

src/app/core/upload-limits.ts

@@ -16,24 +16,22 @@
  * - `ChatService.uploadPending()` —— 发送前兜底，防止暂存期被替换或绕过
  */
 
-import { currentSendMode } from './send-mode';
 
 /**
- * 云盘单文件上限：**不限制**（2026-11-13 用户裁决「上传的文件没有大小限制」）。
+ * 云盘单文件上限：**800MB**（2026-11-14 用户裁决）。
  *
- * 依据（实测）：云函数 `AlP56LCKFm` 对 60MB / 500MB / 2GB 均正常签名，
- * 后端本身没有大小门槛 —— 限制原本只是前端拍的一个数字。
+ * ## 为什么是 800MB 而不是「不限制」
  *
- * ## 大文件的真实风险在「预签名有效期」，不在体积
+ * 原来写的是 `Infinity`（用户 2026-11-13 裁决「不限制」）。但完全没有上限
+ * 会让 2GB 的文件静默开始上传、失败在几十秒后 —— 用户白等且不知道原因。
+ * 800MB 是「足够大但仍能给早期反馈」的折中：选文件时就拦，立刻告知。
  *
- * 预签名 URL 只有 **5 分钟**有效期。60MB+ 在慢网下可能传不完，
- * 或中途失败后用同一个 URL 重试 → OBS 一律返回 403。
- * 这已由 `parse-api.uploadFile()` 的「过期自动重签 + 重试」兜住。
+ * ## 大文件的真实风险在「预签名有效期」，不在体积
  *
- * ⚠️ 仍保留「单次 PUT、无分片」的事实：超大文件（数 GB）断点续传做不到，
- * 失败只能整份重传。真要支持超大文件需改分片上传，届时改这里即可。
+ * 预签名 URL 只有 5 分钟有效期。已由 `parse-api.uploadFile()` 的
+ * 「过期自动重签 + 重试」兜住；单次 PUT、无分片，失败只能整份重传。
  */
-export const CLOUD_LIMIT_BYTES = Number.POSITIVE_INFINITY;
+export const CLOUD_LIMIT_BYTES = 800 * 1024 * 1024;
 
 /**
  * 服务端上限（字节）。`null` = 尚未探测到。
@@ -48,13 +46,13 @@ export function setServerUploadLimit(bytes: number | null): void {
 }
 
 /**
- * 当前生效的上限：按发送模式取 Matrix 服务端值 / 云盘值。
+ * 当前生效的上限。
  *
- * `'url'` 模式返回 `Infinity`（不限制）；`isOversize()` 对非有限值直接返回 false。
+ * 🔴 2026-11-14：附件只走云盘直链（`mxc` 回退模式已删除），
+ * 所以**恒取云盘口径**，不再按模式分支、也不再读 Matrix 的 `m.upload.size`。
  */
 export function uploadLimitBytes(): number {
-  if (currentSendMode() === 'url') return CLOUD_LIMIT_BYTES;
-  return serverLimitBytes ?? Number.POSITIVE_INFINITY;
+  return CLOUD_LIMIT_BYTES;
 }
 
 /**

src/app/desktop/pages/groups/groups.ts

@@ -37,7 +37,6 @@ import { applyMention, filterMentionCandidates, parseMentionQuery } from '../../
 import { MatrixClientService } from '../../../core/matrix-client.service';
 import { AlertService } from '../../../core/alert.service';
 import { isOversize, notifyOversize } from '../../../core/upload-limits';
-import { currentSendMode } from '../../../core/send-mode';
 import { SessionService } from '../../../core/session.service';
 import { FmodeApi } from '../../../core/api/fmode-api';
 
@@ -1986,14 +1985,11 @@ export class DkGroupPage {
     try {
       for (const f of files) {
         /*
-         * `'url'` 模式（2026-11-13）：先上个人存储、拿到地址再发，云盘失败就**不发**。
-         * `'mxc'` 回退模式：保持改造前的行为 —— 只发 Matrix，不做云端预上传
-         * （评审 S1：原先两种模式都先上云，回退模式下云盘一抖就整批发不出去）。
+         * 🔴 2026-11-14 用户裁决：**只有一条路径，不能走 mxc**。
+         * 先上个人存储、拿到地址再发，云盘失败就**不发**。
          */
-        let publicUrl = '';
-        if (currentSendMode() === 'url') {
-          publicUrl = (await this.api.uploadFile(f, (pct) => this.uploadPct.set(pct))).publicUrl;
-        }
+        const publicUrl = (await this.api.uploadFile(f, (pct) => this.uploadPct.set(pct)))
+          .publicUrl;
         await this.chat.sendCloudFile(rid, f, publicUrl, {
           name: f.name,
           size: f.size,