产物

​

概述

---

产物（Artifact）是 AI SRE 在会话中用 present_files 工具产出、再发布到产物库的文件。发布有两条路径，两者能接受的类型并不相同：

• Agent 工具 publish_artifact：只发布 HTML / Markdown 文档（.html .htm .md .markdown）——一份自包含的报告或页面，最典型的是在会话里输入 /insight 生成的运营洞察报告。其它类型一律被拒绝，返回 unsupported_format。
• 控制台里 present_files 文件旁的「发布到产物库」按钮（见下文 新建产物）：可发布的类型更宽：

不在上表范围内的文件，会话中不会出现「发布到产物库」按钮。 发布后的产物初始继承来源会话的作用域：来自个人会话的产物归创建者「个人」所有；来自绑定了团队的会话的产物归该「团队」所有，可分享给账户内的其它成员查看。拥有编辑权限时，之后还可以修改产物范围。 入口：左侧导航 AI SRE → 产物，对应路由 /ai-sre/artifacts。

​

列表页

---

​

搜索与范围筛选

• 搜索框：按标题模糊搜索已发布产物，输入停顿 300 毫秒后自动查询。
• 范围：全部 / 个人 / 团队 三态切换（与 AI SRE 下其它资源统一的两级作用域一致）。选择「团队」后会展开一个可搜索、可多选具体团队的选择器；不选择任何团队等价于「我可见的全部团队」。

​

视图切换与排序

列表页右上角提供 卡片视图 / 列表视图 切换，选择会保存在浏览器本地（下次进入沿用）；卡片视图为默认展示。 列表视图 以表格展示产物，列定义如下： 生成时间 与 修改时间 列支持点击列头排序（升序 / 降序切换），排序在服务端执行；默认按 修改时间降序。 无论选哪种排序，你置顶的产物始终排在最前面（最近置顶的排在更前），其后才按所选字段排序。 范围、搜索词、排序、页码与每页条数都会反映在页面地址上（形如 ?scope=team&teams=1,2&q=重建&page=2&size=48），因此直接复制地址就能分享或收藏一份已筛选的列表；从产物详情页返回时也会回到原来的筛选与位置，而不是被重置成默认视图。 每页条数可选 12 / 24 / 48，默认 24（对应地址里的 ?size=，等于默认值时不会写进地址）。地址里被手工改成其它数值时，会取最接近的一档生效，而不是照单执行。

​

产物卡片

每张卡片展示：

• 顶部预览区渲染的是产物自身内容的缩略图：HTML 取文件开头（最多 256 KiB）按一个 1200×630 的桌面页面缩放成小页面，Markdown 在同样的缩放页上排版，图片直接显示图片本身，纯文本显示开头 24 行（最多 1400 字符）；PDF 以及其它无法渲染的类型显示一个空框。缩略图是一张不可交互的静态画面——它以 sandbox='' 渲染，脚本不会执行，链接与按钮也点不动。它还是懒加载的：卡片接近视口（约 400px）之前不签名、不下载，显示为空框骨架；
• 类型图标：按文件扩展名与内容类型区分，图片、PDF、HTML、Markdown、表格（CSV / TSV）、JSON、压缩包、源码各有专属图标，无法识别时回退为通用文件图标。它是骑在缩略图与正文之间分隔线上的 30×30 角标，不再占据预览区；
• 标题（单行显示，超出省略；鼠标悬停可看到完整标题）；
• 时间信息为标题下方灰色说明行里的 「编辑于 …」 相对时间（取产物的最后更新时间；创建后再未更新过的产物，更新时间即创建时间）——刚刚 / N 分钟前 / N 小时前 / N 天前；相对时间适用于任何时长，再久的产物也只显示「N 天前」，不会回退为具体日期；鼠标悬停该时间可看到精确到分钟的时刻，列表视图的 生成时间 / 修改时间 两列则直接给出精确时刻；
• 同一条说明行里还有作用域（小图标 + 名称：团队产物显示团队名称，个人产物显示创建者姓名）——卡片上不使用彩色作用域徽标，徽标只出现在列表视图与详情页；产物开启了公开链接时，说明行开头还会多一个带 tooltip 的小地球字形；已置顶的产物在说明行末尾显示一个图钉字形。

点击卡片正文会打开该产物的详情页；鼠标悬停在卡片上会在右上角露出「更多操作」按钮（触屏设备上始终可见），它旁边还有一个同样是悬停露出的图钉按钮，点一下即可置顶或取消置顶。分享面板里的公开链接预览用的也是这套缩略图。

​

置顶

列表视图的每一行和每张卡片都有图钉按钮——卡片上的图钉与「更多操作」一起放在右上角，悬停露出（触屏设备常显）；列表行里的图钉是一个固定宽度的独立列，位于「修改时间」与操作按钮之间。「更多操作」菜单的第一项也是这个开关，按当前状态显示为「置顶」或「取消置顶」。 置顶是每个人自己的偏好，不是一次编辑：

• 任何你能看到的产物都可以置顶——他人的个人产物、团队产物都包括在内，不需要编辑权限（重命名、修改范围、删除才需要）；
• 置顶只把产物排到你自己的产物库最前面，不修改产物的内容、标题或作用范围，也不影响其它成员看到的顺序；
• 置顶与取消置顶都是幂等的：重复置顶只会刷新置顶时间（置顶时间较晚的排在更前面），取消一个从未置顶过的产物也不会报错；
• 置顶后列表会整页重新拉取。排序由服务端负责，所以在第 2 页置顶的产物会移动到第 1 页，而不是就地重排。

产物列表项上的 pinned_at 字段就是调用者本人的置顶时间（Unix 毫秒），未置顶时不返回该字段——同一条产物在不同成员那里可以有不同的 pinned_at。

​

新建产物

点击页面右上角的 新建产物，会跳转到会话页面并预填一段引导草稿：

我想在 Flashduty AI-SRE 中创建一个可发布的产物：一个自包含的网页或报告，完成后发布到产物库。请先问我几个必要问题，包括目标读者、内容/数据、交互和视觉风格，然后构建并发布它。

Agent 会先向你确认目标读者、内容/数据来源、交互与视觉风格等细节，再动手构建并发布，而不是打开一个表单直接创建。

​

卡片操作

---

每张卡片右上角的「更多操作」菜单提供：

​

详情页

---

详情页路由为 /ai-sre/artifacts/:artifactId，顶部工具栏提供：

• 标题：对有编辑权限的产物可直接点击标题进行行内编辑（无需跳转到独立表单），按 Enter 保存、Esc 取消；
• 创建者：标题下方显示「〈创建者〉创建的产物」；
• 分享：打开分享面板，可选择「仅账户内」或「公开链接」两种可见范围，详见下文 分享产物；
• 删除：仅在你有编辑权限时显示，删除前需二次确认；
• 更多操作：只有以下至少一项可用时才会出现这个菜单——
  • 下载：仅当产物关联着文件时出现。
  • 修改范围：仅当你有编辑权限时出现，可将产物移至可访问的团队；产物创建者还可以改回个人范围。

标题下方是一条 来源会话信息条：

• 展示产物自身的 「编辑于 …」 相对时间（与列表卡片一致，鼠标悬停该时间可看到精确到分钟的时刻）；
• 当产物的来源会话你仍有权限访问时，信息条里会出现 「最近更新来自会话 〈会话名〉」 按钮——会话名由 /safari/session/get 解析来源会话得到，点击跳转到该会话的完整对话（chat?session_id=<会话ID>，消息、工具调用、产物历史）。来源会话已删除或无权访问时，该按钮隐藏，产物本身仍可正常查看。

正文区域按产物的实际内容类型渲染（例如 HTML 报告会直接内联展示为页面）。

​

分享产物

---

详情页工具栏的 分享 按钮会打开分享面板。面板顶部的 管理权限 列出谁可以管理这个产物的分享（创建者标记为「所有者」，团队产物还会列出团队成员）；下方的 可见权限 提供两种模式：

​

公开链接

选择 公开链接 后，面板会先展示一段内容预览和风险提示，再由你点击 生成公开链接 才真正生效： 生成成功后链接会自动复制到剪贴板（提示「公开链接已生成，已复制到剪贴板」）。公开链接的形式为 https://<控制台域名>/share/artifact/<产物 ID>——它以产物自身的 ID 为标识，不携带令牌；匿名访问完全由 CDN 提供，不经过任何需要登录的接口。 打开公开链接的访问者会看到只读的内容页：页面顶部在标题旁标注「内容由用户生成，未经核实。」声明，并提供「反馈」入口——点击跳转到举报表单（已自动预填当前链接），任何人都可以向 Flashduty 举报不当内容；页面同时提供「登录」入口，引导访问者登录控制台。

​

更新已发布产物

---

重新发布同一个文件不会静默覆盖已发布的产物。Agent 用 publish_artifact 更新时，必须同时带上该产物的 artifact_id 和上一次发布返回的 if_revision（一个不透明的版本指纹，形如 rev_…）： 返回 needs_review 时，Agent 会同时把当前已发布内容的副本写进会话工作区，并带上当前的 revision；它先读这份副本、确认合并后再用同一个 artifact_id 与新的 revision 重试，而不是直接覆盖。 另外几点：

• 内容与已发布版本逐字节一致时返回 operation: unchanged，产物不会被改动。
• 用 present_files 重新展示同一个文件不会更新已发布的产物——它只提供预览与下载，发布更新要走 publish_artifact。
• 产物已被删除时，Agent 用路径重新发布会以 artifact_deleted 失败，而不是把删掉的产物复活；只有你在会话里点 present_files 文件旁的「发布到产物库」按钮，才会恢复一个已删除的产物。
• 发布失败会带一个错误码返回：unsupported_format / permission_denied / artifact_deleted / storage_unavailable / file_too_large / invalid_path，其中 storage_unavailable 可以重试。提交结果无法确认时返回 status: unknown 与一个 op_… 操作 ID，此时 Agent 不会另建一份产物。

​

权限

---

产物是否可编辑（重命名、修改范围、删除）由后端返回的 can_edit 字段决定，满足以下任一条件即可管理该产物： 没有编辑权限的产物，卡片与详情页只提供「置顶」「复制链接」「下载」等只读操作，「重命名」「删除」按钮不会出现。其中置顶不参与这套判断：它是个人偏好而不是编辑，任何你能看到的产物（包括他人的个人产物）都能为自己置顶，只改变你自己的列表顺序，不影响任何人。

​

相关页面

---