Yzr Outline Wiki

Outline Wiki

通过 Outline Wiki MCP 与工作区打交道——搜 / 读（search / read）+ 写 / 编辑 （create / edit）+ 扩展写操作（图片附件 / @mention / 评论 / Collection 管理 / 移动 / 删除 / 归档），产出遵守仓库既有的 Markdown 风格指纹（* bullet / ==高亮== / 正文首块 ```yaml 元数据块等），并按 OKF（Open Knowledge Format） 控制上传格式——使 Outline 文档可被 agent 读回理解。

本 skill 是 outline-wiki 家族中唯一的操作 skill（搜 / 读 / 写全合一）； MCP server 接入与鉴权在 agent 配置文件中维护（见 §接入）。

输入 / 输出

输入

启动时需具备以下前置条件（MCP server 的接入与鉴权见 §接入）：

• MCP 已注册：当前 session 能调 outline MCP 工具 （若未注册，按 §接入 配置后重启会话再回来）
• Collection ID（写文档必传；如 schema 允许按名称引用，按 schema 调用）
• 用户自然语言指令：搜索关键词 / 文档 ID / 新建、编辑指令、目标 Collection

输出

• 搜索结果：匹配的文档列表（含 ID、标题、摘要 / context 摘录）
• 文档内容：元数据（标题 / Collection / 时间 / 作者等）+ Markdown 正文
• 创建 / 编辑结果：新文档 ID + URL；或 patch 后返回的更新版本
• 图片附件 ID：走完 attachment 3 步后返回的 /api/attachments.redirect?id=<uuid>
• 错误信息：工具名不匹配 / 文档 ID 无效 / attachment 0 字节 / Markdown 换行 被吞 / 连接被拒等

接入（MCP 未注册时）

MCP server 在 agent 启动时一次性读入，mid-session 改配置不会被重读—— 未注册时需要在 agent 配置文件中添加 server 后重启会话。本 skill 不做 配置操作，只给最小接入信息：

• endpoint：https://<your-subdomain>.getoutline.com/mcp 或自托管 https://<your-domain>/mcp（路径固定为 /mcp）
• 鉴权：Authorization: Bearer <API key>（Settings → API 生成）或 OAuth
• 落盘位置（因 agent 而异）：
  • opencode：~/.config/opencode/opencode.json#mcp.outline（type: remote + url + headers.Authorization）
  • Claude Code：项目根 .mcp.json（project scope）或 ~/.claude.json#mcpServers.outline（user / local scope）
• 验证：重启后能看到 outline MCP 工具（tools/list 能拉到清单）即可

401 / 403：Authorization header 里的 key 过期 / 被撤销——重新生成 key 并更新配置（改完重启会话生效）。

连接被拒：确认工作区 Settings → AI 的 MCP toggle 已开启（自托管需管理员 在控制台开启）；内网穿透 / 反向代理环境注意走 https://——HTTP 端口可能被 middlebox 占位返回空 200，真正的 MCP 只在 HTTPS 443 透到上游。

设计决策（按 ProseMirror JSON 的"投影"写 Markdown）

Outline 持久化的是 ProseMirror 节点树，MCP 只收 Markdown 字符串——写每条 Markdown 前先想它会被解析成哪个节点；schema 不接受的语法不要用，Markdown 表达不出的（如彩色 高亮）走「进阶」。完整原则、§1-§13 映射表、图片附件上传流程、@mention 语法均在 references/doc_style.md，本文件只列风格速查 + 关键反模式。

OKF 上传格式（agent 可读基线）

为什么：推到 Outline 的文档要能被 agent 读回理解——OKF（Open Knowledge Format， "markdown + frontmatter"）元数据头 + 可预测正文结构是读回 / 检索 / 分块的前提。完整 定义、字段表、type 枚举、载体选型实测与最小骨架示例见 references/doc_style.md → OKF agent 可读基线。

Outline 侧载体（SSOT 在 doc_style.md）：OKF 标准用 ---...--- frontmatter， 但 Outline 的 MCP 往返实测不支持（--- 被吃掉、YAML 泄漏成可见正文）， 故载体 = **正文首块 ```yaml 围栏**（存成 code_block 逐字保留），title 由 Outline 原生字段承载不进块。**硬门槛只有 type 非空**——其余字段消费端 一律容忍，能填都填（description / tags / created / updated）； okf_version（单篇无 bundle）与 title 不放本块；x-outline 为可选溯源块。

正文结构纪律：yaml 块是正文第一个块（前面无任何内容）；标题从 ## 起、 不跳级、同级不重名（agent 用标题做分块锚点）；一篇一主题；链接用 Outline 链接 / 绝对 URL，不裸写本地相对路径。

MCP 工具发现（重要）

本 skill 不写死任何工具名——会话开始时必须先调用 MCP 的 tools/list 端点，核实当前 MCP server 实际暴露的工具名、参数 schema、返回结构，再据此 调用。约定：下文出现的"搜索 / 读取 / 创建 / 编辑 / 图片附件 / 评论 / Collection 管理"等指能力而非具体工具名；调用前先 tools/list 取真实 工具名再做映射。

不同 self-hosted 部署工具集可能略有差异；扩展能力（如评论 / 图片附件） 也以 tools/list 实际返回为准。参考（当前 server 实测）：list_documents / fetch / list_collection_documents / list_collections / create_document / update_document / create_attachment / list_users / list_comments / create_comment / update_comment / delete_comment / create_collection / update_collection / delete_collection / move_document / delete_document / restore_document / list_templates。

能力清单

按"工具来源"分两组。核心能力对应官方文档明列的 4 个高层操作（search / read / create / edit）；扩展能力对应官方文档未明列但当前 server 实测可用、 且在不同 self-hosted 部署里通常也暴露的工具。

核心能力

1. Search（搜索）

按关键词在工作区执行全文搜索，返回匹配的文档列表（含元数据 + context 正文摘录片段，短文档接近全文，长文档会截——别据此判断全文）。

典型参数（具体以 tools/list 实际返回为准）：

• query：搜索关键词（必选）
• collection_id（可选）：限定 Collection 范围
• limit / offset（可选）：分页

2. Read（读取）

按文档 ID 获取元数据（标题 / Collection / 时间 / 作者等）+ Markdown 正文。 Outline MCP 服务端返回 2 个 content block：block[0] = JSON 元数据、 block[1] = 完整 markdown 正文。多数原生 MCP 客户端（如 opencode）能完整收到 两个 block，直接拿正文；若当前客户端只呈现首个 block（如 Claude Code， 2026-07-01 实测），正文走 REST 旁路 POST /api/documents.info （curl 见 §故障排查项 1）。

3. Create（创建）

在指定 Collection 下新建文档；如需嵌套子页需传入父文档 ID。

典型参数：

• title（必选）
• content（必选）：Markdown 原文
• collection_id（必选）：目标 Collection
• parent_document_id（可选）：父文档 ID（创建子页时设置）

4. Edit（编辑）

修改已有文档的标题或 Markdown 正文。

典型参数：

• id（必选）：目标文档 ID
• title（可选）
• content（可选）
• editMode（可选）：replace（全量替换，默认）/ append / prepend / patch（精准局部替换，配合 findText）

注：编辑操作可能要求传完整正文，也可能支持局部替换，以 tools/list 实际返回的参数 schema 为准。

扩展能力

以下工具官方 MCP 文档未明列，但是当前 server（及大多数 self-hosted 部署） 实际暴露的能力；本 skill 收录并以正式流程对待。使用前 tools/list 确认即可。

5. Image / 文件附件（create_attachment + fetch attachment）

MCP create_document / update_document 只接受 Markdown 字符串，不接收 文件二进制。要把图片或文件嵌进文档，必须先走 attachment 通道 （create_attachment → curl 上传 → Markdown 引用 attachment URL），3 步 流程 + curl 模板详见下方"工作流 / 步骤 / 图片插入 / 文件附件工作流"小节。

6. @mention 用户（list_users）

list_users 按关键字（名字 / email）查工作区成员；配合 Markdown 语法 @[Display Name](mention://user/<userId>) 即可在文档里 @ 到具体用户，Outline UI 会渲染成可点击链接。

7. 评论（create_comment / list_comments / update_comment / delete_comment）

在指定文档（或顶层 / 内联）下创建 / 列出 / 修改 / 删除评论；支持嵌套回复 （parentCommentId）。update_comment 还能 resolve / unresolve 顶层评论 （status: resolved / unresolved）。对他人文档建议先 list_comments 看现有 讨论再决定新建还是回复。

8. Collection 管理

• list_collections：列出工作区可见的 Collection
• list_collection_documents：返回 Collection 的完整文档树（含嵌套子文档）
• create_collection / update_collection：新建 / 修改 Collection （name / description / icon / color）
• delete_collection：删除 Collection；可设置 archive=true 走归档

注意：删除 Collection 会级联删除其下未归档的文档；批量移动前先用 list_collection_documents 看清楚结构。

9. Move / Delete 文档

• move_document：把文档移到别的 Collection 或父文档下，可指定 index 控制同级排序
• delete_document：删除文档（默认进 trash，30 天内可在 trash 中恢复）； 可设 archive=true 直接归档而不进 trash

文档风格（仓库指纹速查）

完整 Markdown ↔ ProseMirror 映射、图片附件上传流程、彩色高亮等 Markdown 写不出来的特性如何处理，见 references/doc_style.md。 写新文档 / 大幅改写前的最后一道防线是 references/style_checklist.md 的 9 大类 checklist——按顺序勾选一遍能避免 90% 的风格漂移。

风格基线（速查表）

反模式（写之前先看）

与 doc_style.md「反模式」节双写：本表是常驻闸门摘要，完整版在 doc_style—— 新增条目两边同步。

• 正文首块不是 OKF ```yaml 元数据块，或块内缺非空 type（agent 读回被跳过；硬门槛说明见 §OKF 上传格式）
• 把 OKF title 重复写进 yaml 块（title 已由 Outline 字段承载）
• 在 yaml 块写 okf_version（标准只在 bundle 根 index.md 声明，单篇文档不该有）
• 正文裸写 ---...--- frontmatter——Outline 往返会吃掉 ---、YAML 泄漏成可见正文（实测确认）
• 用 - 或 + 起 bullet（破坏统一）
• 正文以 H1 开头（title 已单独传，再加正文 H1 与标题重复）
• 期望 ==text== 出现彩色高亮（Markdown 写不出来，详见 doc_style.md §进阶）
• 私造非 Outline 支持的语法（!!!、HTML 标签等）
• 引入外部私有扩展（MathJax、:::tip 等）
• 大段纯段落不分 bullet（仓库内极少用纯段落）
• 引用未上传的本地图片路径（只会渲染成破图，必须先走 attachment 流程）

论文笔记 / 设计文档：关键架构图 / 示意图默认必须

仓库内 论文笔记 Collection、数据结构与算法 → 索引类 这类以展示系统 / 算法设计为核心的文档，关键架构图 / 示意图是默认要求——而不是可选项。判定标准与完整操作流程见 references/style_checklist.md §9。

执行原则 / 边界

核心原则

1. 写前先搜（Read-First）
   • 创建新文档前必须先 search 查重，确认是否已有同类但内容过期
   • 若已有同类文档，用 edit 更新而不是 create 重复
   • 搜索结果按相关度排序展示，不要凭缓存的 ID 直接 read（文档可能被归档 / 重命名）
2. 严格 Markdown 格式
   • Outline Wiki 是 Markdown 优先平台，所有内容必须用合法、纯净的 Markdown
   • 用 # / ## / ### 体现逻辑层级，自动生成清晰目录
   • 不引入 Outline Wiki 不支持的非标准私有扩展语法
3. 工具名核实（Tools-First）
   • 不假定工具名的拼写、是否带前缀（如 outline_ / mcp__outline__）
   • 任何操作前先 tools/list 拿真实工具清单
4. 能力边界分两组处理
   • 核心能力（search / read / create / edit）：官方文档明列，直接调用
   • 扩展能力（图片附件 / @mention / 评论 / Collection 管理 / move / delete）：server 实际暴露但官方文档未列；调用前 tools/list 确认是否 暴露
   • 用户要求"分享 / 导出 / 权限调整"等操作时，明确告知这些不在本 skill 覆盖范围，建议走 Outline Wiki 自身 UI 或直接调 REST API
5. 破坏性操作先确认
   • 删除 / 归档他人文档、移动文档、改 Collection 等破坏性操作必须先 在会话内显式确认
   • 对他人文档建议用 create_comment 提议而非直接覆盖

边界

• 不处理非 Outline Wiki 的知识库
• 不在 MCP 未启用时尝试操作（先按 §接入 配置并重启会话）
• 不在 server 端生成 / 撤销 API Key（那是 Outline Wiki 用户在 Settings → API 中的操作）

工作流 / 步骤

标准流程

1. 核实配置与工具：会话开始时——
   • 确认 outline 相关 MCP 工具在当前 session 已注册；若未注册，按 §接入 配置 MCP server 并重启会话后再回来
   • 调 MCP tools/list 取实际工具清单（核心能力 + 扩展能力各自对应的 真实工具名、参数 schema）
2. 理解意图：把用户的自然语言指令映射到能力清单之一（核心或扩展）； 看用户意图里是否包含写动作（"找到后改一下"→ 直接进入编辑流程； "找到后告诉我内容"→ 只读）
3. 先搜后写：涉及"创建 / 编辑"前，先 search 查重 / 定位目标文档； 涉及"图片"前先确认 attachment 通道（create_attachment）可用
4. 执行操作：
   • 调用对应工具
   • 组织正文：写新文档 / 大幅改写时，正文首块写 OKF ```yaml 元数据 块（要求与字段详见 §OKF 上传格式），标题从 ## 起不跳级
   • 图片场景走"create_attachment → curl 上传 → Markdown 引用 attachment URL" 3 步（详见下方"图片插入 / 文件附件工作流"）
   • 评论场景先 list_comments 看现有讨论再决定新建还是回复
   • 写论文笔记 / 设计文档时，关键架构图默认就要走这 3 步嵌入， 不要写文字占位（参见上文"文档风格 / 论文笔记"小节）
   • 破坏性操作（delete / move_document / delete_collection）先确认
5. 验证结果：检查返回是否成功；失败时按故障排查流程定位
6. 报告：把做了什么、结果如何、是否需要后续动作告诉用户

图片插入 / 文件附件工作流

本 skill 的图片能力 = 上传 + 引用——只解决"把本地文件变成 outline 里 能渲染的图片"。不管图片怎么来：

• 截图 / 配图 / logo 等任意本地图片：直接走下面 3 步

完整 3 步流程（每张图独立走一遍）：

1. 预签名上传 URL：调 create_attachment(name, contentType, size)

   name: （如 figure-p1-f1.png）
   contentType: image/png（或 image/jpeg / image/webp）
   size: 文件字节数
   

   返回 uploadUrl（multipart 接收端点）+ 一组表单字段

2. 上传二进制：用 curl 把本地文件 POST 到 uploadUrl（即 /api/files.create）。 attachments.create 返回的 form 字段必须逐字回传（Cache-Control / Content-Type / key / acl / maxUploadSize / _csrf），再附 file=@<path>：

   $> KEY=$(jq -r '.data.form.key' <(curl -sS -X POST \
         -H "Authorization: Bearer $OUTLINE_API_KEY" \
         -H "Content-Type: application/json" \
         -d '{"name":"figure-p1-f1.png","contentType":"image/png","size":12345}' \
         "$OUTLINE_BASE/api/attachments.create"))
   $> curl -X POST "$OUTLINE_BASE/api/files.create" \
        -F 'Cache-Control=max-age=31557600' \
        -F 'Content-Type=image/png' \
        -F "key=$KEY" \
        -F 'acl=private' \
        -F 'maxUploadSize=26214400' \
        -F '_csrf=' \
        -F "file=@<本地文件路径>" \
        -H "Authorization: Bearer $OUTLINE_API_KEY"
   

   响应 {"success":true, ...} 才算上传成功（仅 metadata 返回但 success=false 仍意味着文件未落盘，必须重试）

   ⚠️ create_attachment 只注册元数据，二进制必须自己 curl

   上一行 create_attachment 成功 ≠ 文件已上传。MCP 工具只接收 name / contentType / size 三个参数，不会接收二进制内容。缺了 step 2 的 curl，attachment 记录存在但内容是 0 字节，文档嵌进去后浏览器加载图片 失败 → 空白 / 破图。特别坑：当时不报错，事后才发现图都没显示。

   认证：用 outline MCP 配置里的 API key（<endpoint 域名>/mcp 对应的 Authorization: Bearer <key> 头，见 §接入 落盘位置）。 agent 可以直接拿来用——跟 MCP server 用同一把 key，curl /api/attachments.create 和 /api/files.create 都能过。不需要用户手动 抓 cookie。

   拿 key 的安全姿势：先看 tools/list 里 attachment 工具能用 → 说明 key 已在 MCP 端生效 → 直接用同一份 key 走 curl。

   API key 拿不到 / curl 401 时的退路（按优先级）：

   1. 检查 MCP server 配置里 headers.Authorization 是否真的填了 key； 空 key 是 silent failure
   2. 重新生成 API key 并更新 MCP 配置（改完重启会话生效）
   3. 用户在 Outline UI 拖拽图片进编辑器（编辑器自带 session auth）

3. 插入引用：在 Markdown 里写

   ![图 N：<caption>](<attachment.url> "=WxH")
   

   • attachment.url 形如 /api/attachments.redirect?id=<uuid>
   • =宽x高 给渲染尺寸（仓库内 =WxH 等宽约定，参见 doc_style.md §7）
   • 非图片附件可省略 =WxH

4. 必做验证：写完 Markdown 引用必须核验 attachment 真有内容

   fetch attachment id=<attachment.id> → 拿到 signedUrl
   → 用 WebFetch / 浏览器访问 signedUrl
   → 必须返回 200 + 实际图片字节；404 / 0 字节 / HTML 错误页都算失败
   

   失败则不能写入文档，先解决 upload 再继续

写入 / 替换方式（视场景选）：

• 新建文档时：直接把第 3 步的 ![...](...) 嵌进 create_document 的 text 参数

• 替换已有文档中的图引用：用 update_document + editMode: "patch" + findText 精准替换

  findText: ![图 1：xxx](figures/figure-p1-f1.png)
  text: ![图 1：xxx](/api/attachments.redirect?id=<uuid> "=WxH")
  

  这样可保留其他内容（评论 / 高亮 / 表格宽度）不被破坏

整篇重写（replace 模式 + 大文档）改用 REST API（2026-06-21 经验）：

• 踩坑：update_document 的 text 字段在某些场景下会吞掉换行符—— 实测 3K 字符 markdown 经 tool 调用后，首行表格的 3 个 row 之间的 \n 全部丢失，三行被压成一行，表格渲染成单行 inline 元素。其他位置（list / 章节标题）换行正常，但首行表格三行是必杀。patch 模式更糟： findText 短匹配会追加而不是替换，导致 "3 句话总结" list 变成 5 条 1-2-3-4-5。

• 退路：整篇重写时不要用 mcp tool，改用 POST /api/documents.update 走 curl + API key（key 同 MCP server 配置）， payload 用文件传避免命令行转义：

  python3 -c "import json; json.dump({'id': '<doc-id>', 'text': open('summary.md').read()}, open('payload.json', 'w'), ensure_ascii=False)"
  curl -sS -X POST https://<endpoint>/api/documents.update \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <api-key>" \
    --data-binary @payload.json
  

  REST API 正确保留所有换行；返回 {"data": {...}, "status": 200, "ok": true}。

• 校验必做：写完立刻 fetch 看返回的 markdown body 是否有损坏 （首行表格 / 列表 / 章节标题），如发现 → 重发。tool 返回 success 不代表存盘 OK

• patch 模式坑：findText 一定要足够长（至少含相邻 2-3 行），否则会被 误追加；实测只匹配 1 行 list item 时，patch 行为是"在该 item 后追加"而不是 "替换整段"

反模式（别这么干）：

• 引用未上传的本地路径（![x](figures/figure-p1-f1.png) 或 ![x](PDF p.X ...)）—— outline 渲染成破图，读者看不到
• 把整页 PDF 截图 / 包含页眉 / 段尾段落上传——必须只截图本身的 bbox
• 在 create_document / update_document 的 text 参数里直接传图片二进制—— 这两个工具不接收文件，只接受 Markdown 字符串

读取已上传附件：调 fetch(resource="attachment", id=<id 或完整 redirect URL>) 返回 short-lived 签名 URL，可直接下载。

故障排查

按以下顺序定位：

1. fetch 只返元数据、读不到正文 — 客户端只呈现首个 content block（客户端侧问题， 别往文档空 / ID 错 / 鉴权方向排查；机制与实测见「能力清单 · Read」）——正文走下方 REST 旁路；或 list_documents(query) 的 context 拿正文片段（短文档接近全文， 长文档会截）
2. 认证失败（401 / 403） — key 过期 / 被撤销：重新生成 API key 并更新 MCP 配置（§接入），改完重启会话生效
3. MCP 未启用 / 连接被拒 — 按 §接入 排查（MCP toggle / endpoint 协议）
4. 工具名不匹配 — 重新调 tools/list 拿当前工具清单；不要凭记忆调用
5. 文档 ID 无效 — 用 search 重新定位拿新 ID；别凭缓存 ID 调用（文档可能 已归档 / 重命名）
6. 图片 attachment 0 字节 / 404 — 重跑 attachment 3 步 （create_attachment → curl 上传 → Markdown 引用）；验证 fetch 返回 signedUrl 能 200 下载到字节
7. 首行表格 \n 丢失 — 改走 REST API POST /api/documents.update （key 同 MCP server 配置）

读正文 REST 旁路（故障项 1 展开）—— token / <base> 同 MCP 配置 （与 MCP server 同一把 key，setup 时已写好）：

# <base> = outline MCP url 去掉尾部 /mcp
curl -sS -X POST "<base>/api/documents.info" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"id":"<docId>"}' | jq -r '.data.text'

<token> 位置看 §接入 落盘位置（因 agent 而异：~/.config/opencode/opencode.json #mcp.outline.headers.Authorization / .mcp.json / ~/.claude.json）。

参考样例

样例一：搜索文档

用户指令："帮我在 Outline Wiki 里搜一下'CI 部署流程'相关的文档"

执行：

1. 确认 outline MCP 工具已在 session 注册（否则按 §接入 配置后重启会话）
2. 调用 tools/list 拿到 search 工具的实际名称
3. 调用 search 工具，query="CI 部署流程"，limit=10
4. 整理返回的文档列表，按相关度展示给用户
5. 若用户要打开某篇，再 fetch 拉取正文

样例二：按文档 ID 读取

用户指令："把 doc_abc123 这篇文档的 Markdown 原文给我看一下"

执行：

1. 调用 tools/list 拿到 read 工具的实际名称
2. fetch(resource=document, id="doc_abc123") → 标题 + 元数据 + 正文
   （若当前客户端只返元数据，正文走 REST 旁路 POST /api/documents.info）
3. 把标题 + 元数据 + Markdown 正文一并展示
4. 若用户后续要"改这篇"，直接进入编辑流程（本 skill 已覆盖）

样例三：创建新文档

用户指令："在 '后端' Collection 下新建一篇'缓存策略'文档"

执行：

1. 先 search 查 '后端' Collection 下是否已有同名 / 相似文档（有 → 走编辑不新建）
2. 调 list_collections 拿 '后端' Collection ID（若 create schema 要求）
3. 撰写 Markdown 正文：正文首块写 OKF yaml 元数据块
   （type: reference / tags / description / created / updated），
   再按 doc_style.md 风格基线 + style_checklist.md（§0 OKF + §1-§9）组织正文
4. 调用 create_document 工具传 title / content / collection_id
   （title 走 Outline 字段，不写进 yaml 块）
5. 验证返回成功，把新文档链接 / ID 告诉用户

注：Collection ID 在官方文档中未明示如何获取；如果 tools/list 中 create 工具的 schema 不要求 collection_id（例如允许按 Collection 名称引用）， 则按实际 schema 调用。

样例四：从上游生成工具推图到 outline（以论文摘要产出为例）

用户指令："把上游论文摘要工具生成的 ~/out/<slug>/summary.md + figures/*.png 推到 outline 工作区"

执行：

1. search 查目标 Collection + 是否已有同名文档
2. 正文首块写 OKF yaml 元数据块（type: paper-note / tags / description /
   created / updated）——title 走 Outline 字段
3. 对每张 figures/*.png 走 attachment 3 步（详见上文"图片插入"）
4. 用 read 拿当前 summary.md 中所有 ![图 N](figures/figure-pX-fN.png) 引用
5. 用 update_document + editMode: "patch" + findText 精准替换每张图为
   ![图 N](/api/attachments.redirect?id=<uuid> "=WxH")
6. 验证 fetch 返回每张图 signedUrl 能 200 下载
7. （可选）删本地 figures/ 目录

相关参考

• references/doc_style.md — Markdown ↔ ProseMirror 节点映射（§1-§13）+ 图片附件上传流程（§12）+ @mention（§13）+ OKF agent 可读基线（上传格式控制）+ 进阶
• references/style_checklist.md — 写前必跑的 风格 checklist（§0 OKF 元数据 + §1-§9 风格）