edit | blame | history | raw

青枫浦上Q 动态归档目录导读

本目录是 B 站创作者“青枫浦上Q”（UID 1420210197）的用户可见归档根。正文、专栏、原图、视频转写、纪要和必要的不可变迁移记录可以进入 Git；原始视频、下载映射、FLAC、Cookie、token、Profile 和原始网络材料不得进入本目录的 Git 交付。

文件命名

所有用户可见成果使用同一 basename：

YYYYMMDD-HHMMSS_<content-kind>_<sanitized-title>_<stable-id>

  • 时间取 append-only formal/mapping 冻结的 published_at，按其中明确的时区格式化。
  • content-kind 为 text、article、image 或 video。
  • 标题按 Windows 文件名规则确定性清洗，连续空白折叠，尾部空格/点移除，保留名加前导下划线，最长 64 个字符。
  • stable-id 永远位于末尾；视频使用 BVID，动态/专栏使用其正式稳定 ID。
  • 同一条动态的原图沿 basename 增加 _01、_02 等两位序号。

视频派生成果布局：

  • <video-base>.transcript/<video-base>.txt|.srt|.json
  • <video-base>.minutes/<video-base>.md|.pdf

原始媒体与中间文件不采用用户可见命名：MKV 和 .download.json 固定保存在 F:\video\青枫浦上Q\<BVID>.*；转写 FLAC 固定保存在 F:\video\青枫浦上Q\intermediate\transcription\<BVID>.audio.flac。这些文件均不进入 Git。

账本与兼容解析

  • manifest.jsonl 和 video-processing-handoffs.jsonl 是 append-only 历史事实，不因文件改名而重写。
  • artifact-relocations/<batch-sha256>.json 是 CreateNew、内容寻址、不可变的迁移/别名记录。它把历史 receipt 中的旧路径绑定到新路径、字节数和 SHA-256；协调器消费历史 receipt 时先验证旧身份，再经该记录解析到现行路径。
  • 迁移不得同时保留新旧两套用户可见文件；异常重启可按同一 report 继续，不能覆盖目标。

半小时运行与故障恢复

周期入口是 dev/project-dev/bili_half_hour_pipeline.py 与其受管配置。每轮非阻塞加锁，依次执行 begin、一次受信页面刷新、reconcile、下游 exact-once handoff、任务临时 Git index 交付和 finish。RUN_FAILED、E_TRUSTED_ADAPTER_UNAVAILABLE 或无可验证 Host terminal 不能解释为“没有新动态”；修复后应从最后 accepted cursor 补采到当前时间。

受信页面刷新由本机 unpacked MV3 扩展 1.1 与 com.project_info.bili_dynamic_refresh Native Host 完成。扩展只从已登录 allowlisted 页面提取可见正文、公开原图候选和 BVID；Host 把原图放入短期 intake 后调用既有收集器，并把视频 metadata 追加到同一 formal。Cookie、token、signed URL、Profile、原始网络记录和 capture bundle 不进入本目录或 durable terminal。任一 owner/页面/字段/覆盖证明不一致均是失败，不是 no-new。

操作前先运行只读 git-preflight。若报告共享 index 相对 HEAD 回退、已暂存删除但工作区同路径仍存在，或 .git/index.lock 残留，应停止并核对；工具只诊断，不 reset、不改写共享 index。Git 交付始终使用任务自有 GIT_INDEX_FILE、精确文件清单和非强推目标分支。

其他 allowlisted 创作者复用时，只修改受管配置中的 creator、archive/video root 和下游路由；不得在源码硬编码 UID、BVID、标题或时间。

部署顺序固定为：原 reviewer 一次合并 PASS/0 → 固定离线 builder 构建 → Chrome 可见 unpacked-load 事实只读确认 → NativeMessagingHosts 缺失键安装 → Chrome 可见界面受控 reload 本机 unpacked 扩展 → 点击扩展自带的一次性当前时槽入口完成真实回补 → reconcile/下游/Git/finish → 当前 RUN_COMPLETE 后才恢复 q。该入口仍服从 durable slot exact-once，日常轮次由 30 分钟 alarm 自动执行；不得为某一动态或某一 BVID 另开审批链，也不得回退到 node_repl/globalThis 标签页循环。