AiSOC 演示资产目录 `apps/web/public/demo/`:录屏契约、真实性边界与可复现的再录制流程
AiSOC 演示资产目录 apps/web/public/demo/:录屏契约、真实性边界与可复现的再录制流程
apps/web/public/demo/ 不是一堆随手提交的媒体文件,而是 AiSOC 对外“演示证据”的唯一权威存放点:README 首屏、文档门户和 onboarding 卡片都指向这里的三个固定路径。本文以该目录的说明文档为主体,逐项拆解三个资产的规格与体积红线、录屏里哪些是真实运行结果、哪些是编排输入,以及这条录制流水线(asciinema + Playwright + ffmpeg)在仓库中到底由哪些代码支撑、为什么没有无人值守的重录任务。
一、目录职责:一份被多处引用的稳定契约
该目录的 README 开篇即明确其定位:canonical home(权威存放点),供 README、文档门户与 onboarding hero 共用,并且“treat them as a stable contract”——路径一旦变更,所有下游引用同时失效。这也是本文所有讨论的前提:这里的文件名、尺寸、时长都属于对外承诺,而不是内部实现细节。
三个资产及其在仓库中的实际引用位置:
| 资产 | 内容 | README 标注 | 仓库实际字节数 | 主要消费方 |
|---|---|---|---|---|
demo.mp4 |
部署演练完整录屏,2 分 57 秒,1280×720,H.264,无音轨 | ~1.6 MB | 1,652,681 B | README 首屏链接、onboarding 卡片、文档嵌入 |
hero.gif |
从 demo.mp4 剪出的 README 预览循环,17 秒,860×484 |
~1.2 MB | 1,241,803 B | README 内联动图 |
demo-poster.png |
1280×720 的录制静帧,作为缩略图/封面 | ~0.3 MB | 270,484 B | onboarding 卡片 <img>、<video poster> |
这张表解释了为什么两个“动”的资产一个用 <video>、一个用 <img>:从 README 可以看到,demo.mp4 走的是超链接(部分渲染环境不支持仓库路径的 <video>),而 hero.gif 直接内联为图片——动图在 README、镜像站和包页面都能直接播放,这正是 CHANGELOG 中记录该组合的原因(CHANGELOG.md)。
hero.gif 与 demo.mp4 同源这一点也有代码侧证据:onboarding 卡片把封面图与播放链接拆开渲染,并在注释中说明缩略图是“录制里的一帧,而不是手绘 SVG,因此不会与内容漂移”(StartHero.tsx)。同一段注释还记录了一次真实事故:卡片曾经指向 /demo.mp4——一个根本不存在、写着“Coming v8.0”的占位链接,直到三个大版本之后才被发现(CHANGELOG.md)。这就是“稳定契约”四个字的分量。
二、规格与体积红线
文档给出的硬约束只有一句,却是这个目录最重要的一条工程规则:
Keep the budget in mind if you replace them: these files are committed, so every byte is cloned by everybody.
demo.mp4under 8 MB andhero.gifunder 5 MB are the ceilings.
拆开看是三层意思:
- 文件是被提交进 git 的,不是 CDN 资源,因此每个 clone、每个 CI checkout 都要承担这份体积;
- 上限是天花板而非目标值,当前文件远低于上限(mp4 约 16%、gif 约 24%);
- 一旦替换就必须重新量体积,因为“更清晰一点”的编码参数很容易让文件翻倍。
可以在仓库根目录用以下命令复现这三个数字,不需要额外工具:
# 字节数:确认三个资产没有超出预算
ls -l apps/web/public/demo/
# 媒体规格:时长、分辨率、编码、是否有音轨
ffprobe -v error -show_entries \
format=duration,size,bit_rate \
-show_entries stream=codec_name,width,height,codec_type \
-of default=noprint_wrappers=1 \
apps/web/public/demo/demo.mp4
ffprobe 的输出应当与标注一致:视频流为 H.264、1280×720,没有音频流(录屏故意不配音,浏览器片段与终端片段靠标题卡衔接)。hero.gif 的输出则是 860×484、17 秒的循环图。
三、录屏讲了什么,以及其中什么是真实的
这是该文档信息密度最高的一节,也是它区别于普通“媒体资源说明”的地方:它把“真实”和“编排”逐项分开列明。
记录的流程是:一台通过 LAN 地址(而非 localhost)访问的主机,从零到 AI 研判结论——make up 拉起、登录控制台、CISA 已知被利用漏洞(KEV)数据已就位、一条事件经由文档记载的 ingest 路径推入、make smoke 报告十个阶段、最终告警及其实测 token 数。
真实性边界可以精确成一张表:
| 项目 | 状态 | 说明 |
|---|---|---|
| 整套 stack | 真实 | 真实容器,非 mock |
| 镜像 | 真实 | 从 ghcr.io 拉取,不是本地构建 |
| 威胁情报(CISA KEV) | 真实 | 公共权威数据源,无需 API key |
| 告警与 token 计数 | 真实 | 模型确实被调用并计量 |
| Demo mode | 关闭 | 没有 make demo 播种 |
| 被推送的那条事件 | 编排 | “authored to be representative”,下游全部是产品自身行为 |
| 终端等待时间 | 剪辑 | 空闲间隔被压缩,且每个适用片段的画面上有角标披露 |
| 浏览器片段 | 真实速度 | 未加速 |
“镜像从 ghcr.io 拉取而非本地构建”这一点在 docker-compose.yml 里有对应实现:web 服务声明 image: ghcr.io/beenuar/aisoc-web:${AISOC_VERSION:-latest} 并配合 pull_policy: ${AISOC_PULL_POLICY:-missing},所以一次普通 make up 拿到的是发布镜像而不是工作树产物。
两个研判都走了确定性回退
录屏最容易被误读的地方在这里:两次自动研判都没有返回可用的模型回复,而是落到确定性路径,控制台上的 model_used 字段显示 kafka:auto_triage:deterministic,结尾卡也如实说明了这一点。
这个标签不是拼接出来的展示字符串,而是计量模块里的常量:services/api/app/services/usage_metering.py 定义了 AUTO_TRIAGE_PREFIX = "kafka:auto_triage:",并把 ("cached", "deterministic", "memory") 列为 NON_MODEL_TIERS——也就是说,“这一行不是模型产出”是可以被查询层直接判定的,model_used <> 'kafka:auto_triage:deterministic' 才等价于“走了模型路径”(见 usage_metering.py)。
关键结论是:token 计数依然真实,因为模型确实被调用了;失败的只是它回复的结构。文档随后补充了一条更重要的现状:
Triage now asks the provider to constrain its reply to a JSON object... replies triage could use went from 44 of 50 to 50 of 50.
即通过 gateway 让 provider 以 JSON object 约束输出后,50 条告警中可用回复从 44 条提升到 50 条;六次失败全部是 rationale 结构异常,判定的结论与置信度本身是对的,且没有一次被截断。该结论可按文档给出的命令复现:
python3 scripts/measure_triage_reliability.py --attempts 50 --json-mode
脚本参数在 measure_triage_reliability.py 中可见:--attempts(默认 20)、--base-url、--model、--timeout、--json(写出每次尝试的完整记录)以及 --json-mode(向 OpenAI 兼容端点请求 response_format=json_object)。报告头会打印 structured output response_format=json_object(同文件 L420),因此“是否真的开了 JSON 模式”不会被搞混。
视频保留原样而不是重剪——“kept as recorded rather than re-cut to flatter the product”。这是一条编辑原则:演示素材可以过时,但不能为了好看而隐藏当时的回退行为。
版本不一致是被显式承认的
录屏中的控制台是 v11.0.0,而 apps/web/public/screenshots/ 下的静帧是在 v20.1.0 重拍的(当前仓库根目录 VERSION 即为 20.1.0)。录屏之后导航栏新增了条目,因此两者不可能像素级一致。文档明确:录屏展示的序列没有变,所以保留录制版本。截图目录也在自己的说明里重申了同一规则——图片与图注是“同一个断言”,刷新图片必须同时重读图注(apps/web/public/screenshots/README.md)。
$0.00 是真实零,不是未测量
文档用一句话区分了两种零:模型与 stack 同机运行,每次调用没有外部计费,所以成本看板显示 $0.00;但看板区分“真实零成本”和“未计价调用”,绝不会把后者显示为免费。这条与 NON_MODEL_TIERS 的设计是同一思路:不确定的字段不能被默认成看起来正常的数值。
四、录屏背后的可复制部署路径
录屏本身只有三分钟,装不下“为什么”。文档把这一步交给了书面形式:apps/docs/docs/deployment/walkthrough.mdx。下面按录屏顺序继承其中的关键操作,并补充源码侧的对应实现。
4.1 只改一个文件里的两个变量
cp .env.example .env
复制模板是可选的——make up 会通过 scripts/ensure_env.py 在 .env 缺失时创建它(见 Makefile,up: env _ports _refresh)。显式复制的意义是在启动前设定两个值:
# .env
AISOC_CONSOLE_BIND_ADDR=0.0.0.0
AISOC_CONSOLE_URL=http://192.0.2.10:3000 # 人们真正输入的地址
第一个变量决定控制台的宿主端口发布在哪个接口上。默认所有宿主端口都绑 127.0.0.1——对笔记本正确,对服务器无用:stack 会健康启动,但机器外无人能访问。控制台是浏览器唯一需要的端口,因为它的 Next.js 服务端会把同源路径代理给 API、agents 服务与 realtime 网关(docker-compose.yml 的注释明确写着“publishing one port, not fourteen”)。发布地址的插值规则是:
"${AISOC_CONSOLE_BIND_ADDR:-${AISOC_BIND_ADDR:-127.0.0.1}}:3000:3000"
即 AISOC_CONSOLE_BIND_ADDR → AISOC_BIND_ADDR → loopback 三级回退,所以默认安装仍然只在本机可达。
第二个变量只影响“打印给你看的地址”。make up 与 make bootstrap 在创建管理员时都会打印它;Makefile 里的取值方式是直接从 .env 读 AISOC_CONSOLE_URL,缺失时回退到 http://localhost:${CONSOLE_PORT:-3000}(Makefile)。留默认值意味着服务器部署会打印 http://localhost:3000——在读者自己的机器上解析到别的东西。
4.2 发布端口反而强化了认证
这是文档中最反直觉、也最值得引用的一段:把控制台发布到 0.0.0.0 不会削弱认证,反而会关掉开发期的匿名旁路。
- stack 默认按生产级运行,无 bearer token 的请求得到
401; - compose 把发布地址作为
AISOC_PUBLISHED_BIND_ADDRS传给每个服务(docker-compose.yml 等十二处,取值形如${AISOC_CONSOLE_BIND_ADDR:-...},${AISOC_BIND_ADDR:-...}); - 只要其中包含非 loopback 地址,每个服务都会直接拒绝开发认证 shim,即使有人手工设置
AISOC_DEV_AUTH_BYPASS=1。
容器内部绑的是 0.0.0.0,自己无法判断外部是否可达,所以必须由 compose 把发布地址“告诉”它——这段设计动机在 CHANGELOG.md 中被完整记录。文档也回顾了这个页面的旧写法:ENVIRONMENT 曾在 compose 与 .env.example 中默认 development,而开发类环境下无凭证请求会被解析成带 admin 角色的 demo 用户,且就在真实管理员即将创建的那个租户里。现在想要“笔记本上自动登录”的体验,应显式使用 make up-dev(Makefile 会叠加 infra/compose/docker-compose.dev.yml)。
笔记本上的便利路径与“对任何人都可达的服务器”之间,不应靠一个环境名来切换——这是本节真正的方法论。
:::caution 暴露到不可控网络前先加 TLS
AISOC_CONSOLE_BIND_ADDR=0.0.0.0 发布的是明文 HTTP,需要前置反向代理,配置见 单机部署说明。
:::
4.3 make up 之后应当看到什么
make up
它会拉取发布镜像、启动 16 个 CORE 服务、等待每个声明了健康检查的服务就绪,然后创建第一个管理员。首次运行还会把内置的 llama3.2:3b-instruct-q4_K_M(约 2 GB)下载进一个命名卷,只有 make clean 会让它重新下载。
结束输出形如:
Console: http://192.0.2.10:3000
API: http://localhost:8000 (spec: docs/openapi.yaml; interactive
docs are off in this production-class stack)
Prove the pipeline works: make smoke
────────────────────────────────────────────────────────────────
Administrator created. Sign in at http://192.0.2.10:3000
────────────────────────────────────────────────────────────────
Email admin@aisoc.internal
Password ••••••••••••••••
三条细节值得记住:
- 密码在你的机器上生成,只显示一次,不落库。丢了就
make bootstrap ARGS=--reset-password重新签发(Makefile)。 API:行故意保留 loopback:那是 API 在本机的发布位置,反代后的控制台 URL 并不能告诉你 API 端口落在哪。- 起不来就跑
make doctor(Makefile 调用scripts/doctor.sh),它检查宿主工具、Docker VM 内的内存与磁盘、每个端口,并逐个查询数据存储而不是只看容器是否在跑。
4.4 登录后:诚实的空状态与唯一一份真实数据
控制台大部分页面是空的,因为没有接入任何数据源,而且它明说自己是空的——“No entities are currently being tracked”,零就是零,而不是用占位符填满。
唯一不同的是 Threat Intel 页:启动后一两分钟内出现约 1,700 行,每行标记 cisa-kev。这是 CISA 已知被利用漏洞目录,公开、权威、无需 API key,是全新安装里唯一既非合成、也非你自己的数据。
:::note 这个 feed 有回退,而且会在日志里露面
CISA 目录的主 URL 对非浏览器客户端返回 403 Forbidden。服务会以 warning 级别记录,然后从 cisagov/kev-data 镜像取同一份目录。一行 warning 后面跟着 CISA KEV IOCs ingested 才是健康路径,不是失败。
:::
源码侧的实现是显式的多源回退:cisa_kev.py 定义了 _KEV_FALLBACK_URL,并构造 sources = <a href="https://link.gitcode.com/i/15fd6c52a2806a46d537aab62ca26554" target="_blank">("cisa.gov", ...), ("cisagov/kev-data", ...)];注释说明这不是“第三方副本”,而是同一发布方、同一 schema(catalogVersion、count、vulnerabilities[]),并解释了不加回退的后果:健康容器、已注册 feed、指标永远为零——一种与“还没发布任何内容”完全同形的静默失败。成功写入时由 [feeds/handlers.py 打印 CISA KEV IOCs ingested。失败时 fetch() 返回 [] 并记 error,因为调用方无法从返回值区分“空目录”和“取不到”。
4.5 推一条真实事件
摄取是带认证的,而且凭证自带租户——请求体从不指定租户,也没有任何 header 被信任为租户来源。
export AISOC_INGEST_TOKEN=$(make -s ingest-token ARGS=--quiet | tail -1)
curl -X POST http://localhost:8081/v1/ingest/batch \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $AISOC_INGEST_TOKEN" \
-d '{"connector_id":"edr-1","connector_type":"crowdstrike","source_format":"json",
"events":[{"severity":"high","title":"Encoded PowerShell from Office",
"host":"WIN-FIN-01","process_name":"powershell.exe",
"user":"j.reyes","src_ip":"203.0.113.44"}]}'
成功返回 {"accepted":1,"rejected":0,"request_id":"…"}。事件随后被规范化成统一结构、发布到 Kafka、按可执行检测语料评估、做关联,最后写入 Postgres 成为一条告警——空载 stack 上大约一秒。
make ingest-token 是幂等的:已存在活跃 push token 就复用而不是再签一个,所以 make smoke 可以每次都调用它;make ingest-token ARGS=--rotate 才会替换(Makefile)。
4.6 内置证明:十个阶段
make smoke
它推自己的事件并全程跟随,把 ten 个阶段报成 PASS 或 FAIL,其中包括:无凭证推送被拒绝、严重级别在规范化后存活、来源归属没有被重复拼接、描述是散文而不是序列化 payload。干净的一轮结束于 PASS: 10/10 stages。
这十个阶段在 run_golden_pipeline.py 中逐条可读:ingest 可达、API 可达、凭证可用、同一请求去掉凭证必须被 401/403 拒绝、带凭证的原始遥测被接收且 accepted == 1、事件穿过脊柱变成告警、告警可按 id 单独读取、severity 仍属 {high, critical}、connector_type 无重复词、description 不以 { 或 [ 开头。最后三项的存在理由写在注释里:这三件事在已发布版本中各自错过一次。
make smoke 的外层还有一个 _anonymous_write_is_refused 前置目标(Makefile),它同时探测 http://localhost:8000/api/v1/cases 与 $(console_url)/api/v1/cases,因为控制台代理会把 /api/v1/* 转发给 API:一个在 8000 上拒绝、在 3000 上放行的 stack,对任何有浏览器的人仍然是匿名的。而 3000 正是单机部署指南让运维发布的那个端口。连接失败被明确处理为 SKIP 而非 PASS——“什么都没回答”和“回答正确的东西”不能打印同一个词。
4.7 同一台主机上跑第二套 stack
docker-compose.yml 中每个服务都钉了 container_name,所以仅靠不同的 COMPOSE_PROJECT_NAME 无法并行两套。需要一个覆盖名称和宿主端口的 docker-compose.override.yml:
services:
web:
container_name: other-web
ports: !override
- "0.0.0.0:13000:3000"
ports: !override 是关键:普通覆盖是追加,原绑定仍在,冲突未解。另外 make up 的端口预检读的是 docker compose port,它只认识已经存在的容器——冷启动时看不到还没生效的重映射,会把默认端口报成被占用。先用 docker compose up -d 起一次,之后 make up 就正常了。
五、录制流水线:三种工具,一条链
文档把制作过程压成了四个条目,每一项都能在仓库里找到对应实现:
| 环节 | 工具 | 文档描述 | 代码/配置证据 |
|---|---|---|---|
| 终端 | asciinema + agg |
录制真实 PTY 并用 agg 渲染;命令确实执行过,唯一编辑是把空闲间隔封顶 |
无仓库内脚本(人工操作),披露方式为画面角标 |
| 浏览器 | Playwright 屏幕录制 | 对运行中的控制台按真实速度录制 | screencast.spec.ts、playwright.config.ts |
| 合成 | ffmpeg |
拼接片段,标题卡由浏览器栅格化(该 ffmpeg 构建没有 drawtext 滤镜) |
见工作流中的 ffmpeg 调用 |
| 密钥 | sed 过滤 |
生成的管理员密码在打印时即从终端流中滤掉;ingest token 只存在于 shell 变量;浏览器只显示掩码密码框 | 录制管线内的 sed(录屏中可见) |
浏览器录制侧的配置值得单独说明,因为它决定了“产物长什么样”:
- 全局
video: "off",只有screencast项目把它打开为{ mode: "on", size: { width: 1920, height: 1080 } },并固定deviceScaleFactor: 1,理由是“让编码器在不同代 runner 上保持确定性”(playwright.config.ts); baseURL在 screencast 项目下取process.env.AISOC_SCREENCAST_URL ?? "http://localhost:3000",且注释记录了一次真实缺陷:screencast 与 screenshots 两个项目曾使用不同默认值,导致未设环境变量时静默录到了另一套部署(playwright.config.ts)。
这也解释了为什么录制规范要求“不要录到别人的实例”:默认值指向本地,自建者跑这个工作流时录的是自己的 stack,主机名也就不会随 README 图注流传出去。
录制器不是测试
screencast.spec.ts 的文件头明确写了两条“故意不做”的事:不断言业务行为(选择器消失时录制仍然完成,视频会把这个失败画出来,QA 价值在人工审片而不是绿色对勾),不改变状态(只导航和停留,动作执行覆盖在 Phase 4.8 的 e2e 套件里)。所有镜头时长都是墙上时钟常量(PRE_ROLL_MS 到 OUTRO_MS),不是事件驱动——这样即使种子数据集结构变化,录制也能跑完。
同一份 spec 与 docs/demo/SCREENCAST_SHOTLIST.md 是 1:1 对应的:每个 “Shot N” 块映射到镜头清单里的一个标题,改动镜头顺序或旁白时长必须在同一个 PR 里同步两边,因为“下游没有别的文档”。
六、为什么没有无人值守的重录任务
文档的“Re-recording”一节回答了一个很容易被误解的问题:.github/workflows/screencast.yml 不会写入这个目录。
工作流的真实行为可以从 screencast.yml 读出:
- 只有
workflow_dispatch:录屏是“deliberate human act”,每次 push 都录只会烧掉分钟数且毫无价值; - 输入
target_url默认http://localhost:3000,注释说明默认值故意是本地地址——指向某个具体部署会让自建者录到别人的实例,而那个主机名会随 README 图注和文档流传; permissions: contents: read、concurrency: screencast-${{ github.ref }}(不取消进行中的运行)、timeout-minutes: 15硬上限;- 产物写到
tmp/screencast/:webm 经ffmpeg -c:v libx264 -preset slow -crf 22 -c:a aac -movflags +faststart转 mp4,再切一段-ss 14 -t 10、fps=15,scale=720的 GIF(palettegen/paletteuse保证量化干净,loop=0让它在<img>里无限循环); - 上传为 workflow artifact(保留 30 天);若给了
release_tag,则用gh release upload --clobber挂到已存在的 release 上,release 不存在就报错退出,避免运维静默丢掉录制。
把它与本目录实际提交的资产对照,可以推断两者并非同一条产线:
| 维度 | 工作流产物(按配置推断) | 仓库中提交的资产 |
|---|---|---|
| 时长 | 镜头常量合计 90 秒 | 2 分 57 秒 |
| 分辨率 | 1920×1080(录制即 1080p,转码不缩放) | 1280×720 |
| 预览图 | -ss 14 -t 10、宽 720,约 10 秒 |
宽 860,17 秒 |
三项都不吻合,所以提交的这份是另一条制作路径的产物——与文档的说法一致:该工作流记录的是“a different, older product tour of a deployed instance”,它不写这个目录。文档同时明确:没有任何无人值守任务会重新生成这些文件。
重录意味着再驱动一次真实部署
重录不是“再跑一次工作流”,而是重新走一遍部署。每一步的书面形式(包括录制方法本身)在 apps/docs/docs/deployment/walkthrough.mdx 里,因此过程是可复现的,而不是靠猜。
重录前要准备两件事:
- 一份可被录制的真实部署:按第四节把
.env里的两个变量设好,make up,登录,跑通make smoke。录 LAN 地址而不是localhost,这是文档选定的场景——“大多数自建部署都是这个形状,而且笔记本默认值在这里恰好是错的”。 - 一份镜头脚本:终端片段按 “what each command does / what you should see / what it means when you see something else” 组织,浏览器片段按 shot list 的镜头与切点走。
录制侧的三条密钥纪律在重录时同样适用,建议原样保留:
# 1. 管理员密码在打印时就滤掉(sed 位于录制管线内,且管道本身出现在画面中)
# 2. ingest token 只存在于 shell 变量,不写入文件、不出现在命令行回显里
export AISOC_INGEST_TOKEN=$(make -s ingest-token ARGS=--quiet | tail -1)
# 3. 浏览器里只出现掩码密码框
这三条不是形式主义:录屏会被 clone 到无数台机器上,任何一次明文回显都等于一次凭据泄露。
替换资产时的预算与披露
demo.mp4< 8 MB、hero.gif< 5 MB;- 剪辑动作(压缩等待)必须在整个适用片段内保持画面上有角标披露,而不是只在开头闪一下;
- 版本、导航差异若存在,应在说明中显式写出,而不是靠观众自己发现。
七、改动这个目录时的检查清单
把文档中的规则转成可执行步骤,顺序执行即可:
# 1. 三个文件都在,且没有意外新增
ls -l apps/web/public/demo/
# 2. 规格一致(时长/分辨率/编码/无音轨)
ffprobe -v error -show_entries format=duration,size \
-show_entries stream=codec_name,width,height,codec_type \
-of default=noprint_wrappers=1 apps/web/public/demo/demo.mp4
ffprobe -v error -show_entries stream=width,height -of csv=p=0 \
apps/web/public/demo/hero.gif
# 3. 预算
python3 - <<'PY'
import os
d = "apps/web/public/demo"
caps = {"demo.mp4": 8_000_000, "hero.gif": 5_000_000}
for name, cap in caps.items():
size = os.path.getsize(os.path.join(d, name))
print(f"{name}: {size/1e6:.2f} MB / cap {cap/1e6:.0f} MB", "OK" if size < cap else "OVER")
PY
然后同步这四处引用(任何一处不同步都会留下漂移):
- README.md 的
hero.gif内联图、demo.mp4链接与图注; - StartHero.tsx 的播放链接、封面
<img>与 “2 min 57 s” 徽标文案; - walkthrough.mdx 的
<video>导入与poster; - 本目录 README 的资产表(时长、尺寸、体积)。
最后核对两句话是否仍然为真:图注里“terminal waits shortened and the recording saying so on screen”是否仍被画面证明;以及录屏中的控制台版本与截图目录的版本差异是否仍在说明中被承认。
八、可验证证据索引
| 事实 | 证据位置 |
|---|---|
| 三个资产的存在与字节数 | apps/web/public/demo/ 目录列表;本文表格 |
| 目录是稳定契约、8 MB / 5 MB 上限 | apps/web/public/demo/README.md、同文件 |
| 真实性/编排的逐项划分、终端等待披露 | apps/web/public/demo/README.md |
model_used 回退标签与 44/50 → 50/50 |
apps/web/public/demo/README.md、usage_metering.py、measure_triage_reliability.py |
书面版部署流程(两个变量、make up、ingest、make smoke) |
apps/docs/docs/deployment/walkthrough.mdx |
控制台端口发布与 !override 语义 |
docker-compose.yml |
make up / up-dev / smoke / ingest-token 的实现 |
Makefile、Makefile |
| 十阶段的具体断言 | run_golden_pipeline.py |
| CISA KEV 的 403 回退与健康日志行 | cisa_kev.py、feeds/handlers.py |
| 录制器“不断言、不改状态”的边界与镜头常量 | screencast.spec.ts |
录制分辨率/编码确定性与 AISOC_SCREENCAST_URL |
playwright.config.ts、playwright.config.ts |
| 工作流仅手动触发、转码参数、artifact 与 release 挂载 | .github/workflows/screencast.yml |
| 镜头脚本与 90 秒目标 | docs/demo/SCREENCAST_SHOTLIST.md |
| 录屏 v11.0.0 与静帧 v20.1.0 的版本说明 | apps/web/public/demo/README.md、screenshots/README.md、VERSION |
首页卡片曾指向不存在的 /demo.mp4 |
CHANGELOG.md |
九、小结
apps/web/public/demo/ 的价值不在于“有三个媒体文件”,而在于它把三件容易含糊的事写成了可核查的规则:路径是契约(多处引用,不得单方面改名);真实性有边界(真实镜像、真实 feed、真实 token,与作为编排输入的一条事件、被压缩的终端等待,逐项分开标注);重录有成本与流程(没有无人值守任务,必须再驱动一次真实部署,且资产体积受 git 克隆成本约束)。
对使用者而言,最有操作价值的三条是:录屏里 kafka:auto_triage:deterministic 表示“模型被调用了但回复结构不可用”,token 数依然可信;CISA KEV 的 warning + CISA KEV IOCs ingested 是健康路径而非故障;替换资产后必须同时更新 README、onboarding 卡片、文档嵌入与本目录说明这四处,否则这份契约就会开始漂移。
