# asciinema-流媒体-备份用于将 asciinema 录音流式传输到 GitHub 并具有自动 brotli 归档功能的完整系统。使用空闲检测进行智能分块，使用 zstd 进行可串联流压缩，并使用 GitHub Actions 进行最终 brotli 重新压缩。 ## 何时使用此技能在以下情况下使用此技能： * 设置 asciinema 录音实时备份到 GitHub * 为录音配置空闲检测分块 * 创建用于记录存储的孤儿分支基础设施 * 集成 GitHub Actions 以进行 brotli 重新压缩 > **平台**：macOS、Linux **隔离**：使用 Git 孤儿分支（单独的历史记录，不能污染主分支） ** ** ## 架构概述 ┌──────────────────┐ zstd 块 ┌──────────────────┐ 动作 ┌────────────────┐ │ asciinema rec │ ────────────────▶ │ GitHub 孤儿版 │ ────────────────▶ │ brotli 档案 │ │ + 空闲分块器 │ （可连接） │ gh-recordings │ │ （300x 压缩）│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │ │ │ 空闲≥30s触发chunk │ 单独的历史记录 ▼ │ 无法 PR 到 main ~/asciinema_recordings/ ▼ └── 仓库名称/ .github/workflows/ └── chunks/*.zst └── recompress.yml ** ** ## 要求组件|必填|安装|版本 ---|---|---|--- **asciinema CLI** |是的 | `brew 安装 asciinema` | 3.0+（铁锈） **zstd** |是的 | `brew 安装 zstd` |任意 **布罗特利** |是的 | `brew 安装 brotli` |任意 **git** |是的 |预装| 2.20+ **gh CLI** |是的 | `brew 安装 gh` |任意 **fswatch** |可选| `brew 安装 fswatch` |对于实时 ** ** ## 工作流程阶段 ### 第 0 阶段：飞行前验证验证已安装的所有工具，如果缺少，请进行自我更正。运行预检检查脚本，然后询问用户问题以提供缺少工具的安装。有关完整的“preflight-check.sh”脚本，请参阅[安装脚本]()。 **自我更正**：如果缺少工具，则生成安装命令并提供运行它。 ** ** ### 第 1 阶段：GitHub 帐户检测从 5 个来源（SSH 配置、SSH 密钥、gh CLI、mise env、git config）检测可用的 GitHub 帐户，并让用户选择要使用的帐户。有关检测脚本、评分逻辑和 AskUserQuestion 流程，请参阅[帐户和存储库检测]()。 ** ** ### 阶段 1.5：当前存储库检测检测当前 git 存储库上下文（`CURRENT_REPO_OWNER`、`CURRENT_REPO_NAME`、`DETECTED_FROM`），为第 2 阶段提供智能默认值。有关检测脚本，请参阅[帐户和存储库检测]()。 ** ** ### 第二阶段：核心配置收集基本配置：存储库 URL（从阶段 1.5 开始自动检测）、记录目录和分支名称。有关所有 AskUserQuestion 序列和 URL 规范化逻辑，请参阅[配置参考]()。 ** ** ### 第 3 阶段：高级配置允许自定义压缩和行为参数：参数|默认 |范围 ---|---|--- 空闲阈值| 30 多岁 | 5-300秒 zstd 级别 | 3 | 1-22 布罗特利水平| 9 | 1-11 自动推送 |是的 |是/否轮询间隔 | 5秒| 2秒、5秒、10秒有关所有 AskUserQuestion 序列，请参阅[配置参考]()。 ** ** ### 第 4 阶段：孤儿分支设置使用 GitHub Actions 工作流程创建或配置孤立分支。首先检查现有分支并提供克隆/重置/验证选项。关键行动： 1. 通过 `git ls-remote` 检查远程是否存在分支 2. 如果存在：询问用户克隆/重置/验证问题 3.如果是新的：创建孤立分支，添加工作流程+目录结构，推送有关完整的“setup-orphan-branch.sh”脚本，请参阅[安装脚本]()。请参阅 [GitHub 工作流程]() 了解完整的 `recompress.yml` 操作工作流程。 ** ** ### 第 5 阶段：本地环境设置配置本地目录并使用第 3 阶段嵌入的用户参数生成自定义的“idle-chunker.sh”。关键行动： 1. 将孤立分支克隆到 `~/asciinema_recordings//` 2. 生成带有嵌入配置的`idle-chunker.sh` 3. 显示配置摘要和使用说明有关本地安装脚本，请参阅[安装脚本]()。请参阅 [Idle Chunker]() 了解完整的分块器实现。 ** ** ### 第 6 阶段：自主验证 Claude 自主执行 8 项测试，显示格式化结果。只有 2 个测试需要用户操作（录制测试、分块器实时测试）。测试类别 |计数 |自主？ ---|---|--- 工具预检 | 5 |是的压缩往返 | 3 |是的存储库验证 | 4 |是的 GitHub Actions 触发器 | 1 |是的录音测试| 1 |否（用户） Chunker 现场测试 | 1 |否（用户）有关完整的验证脚本、用户所需的测试流程和故障排除表，请参阅[自主验证]()。 ** ** ## 快速入门 ### 首次设置 /usr/bin/env bash << 'PREFLIGHT_EOF' # 1. 检查需求对于 asciinema zstd brotli git gh 中的工具；做命令 -v "$tool" &>/dev/null && echo "$tool: OK" ||回声“$工具：丢失” 完成 # 2. 创建孤立分支（替换为您的存储库） REPO="git@github.com:YOUR/REPO.git" ./setup-orphan-branch.sh "$REPO" # 3. 验证设置 ./validate-setup.sh "$HOME/asciinema_recordings/REPO" 预检_EOF ### 录音会议 /usr/bin/env bash << 'SKILL_SCRIPT_EOF' # 终端1：开始录音 WORKSPACE=$(基本名称“$PWD”) asciinema rec $PWD/tmp/${WORKSPACE}_$(日期 +%Y-%m-%d_%H-%M).cast # Terminal 2: 启动空闲分块〜/asciinema_recordings/REPO/idle-chunker.sh $PWD/tmp/${WORKSPACE}_*.cast 技能脚本EOF ** ** ## 关键设计决策决定|基本原理 ---|--- **zstd 用于流式传输** |支持帧串联（brotli 不支持） **用于存档的 brotli** |最佳压缩比（.cast 文件约为 300 倍） **孤儿分支** |完全隔离，不能污染主历史 **基于空闲的分块** |语义断点，而不是中间输出分割 **浅克隆** |最小的磁盘使用率，不会意外访问主目录 **30 秒空闲阈值** |平衡块频率与语义完整性 ** ** ## 故障排除有关常见问题和修复，请参阅[故障排除指南]()。 ** ** ## 变更后清单修改该技能后： 1. 孤儿分支创建脚本使用heredoc包装器 2.所有bash块与zsh兼容（无声明-A，无grep -P） 3. GitHub Actions 工作流程验证 brotli 重新压缩 4. Idle chunker 处理 macOS 和 Linux stat 语法 5. 检测流程输出可解析的key=value格式 6. 引用验证外部文档的链接 ** ** ## 参考文档 * [帐户和存储库检测]() \- GitHub 帐户检测 + 存储库上下文 * [配置参考]() \- AskUserQuestion 序列 + 任务模板 * [空闲分块器脚本]() \- 完整的分块器实现 * [GitHub 工作流程]() \- 完整操作工作流程 * [安装脚本]() \- 所有安装和验证脚本 * [自主验证]() \- 验证脚本和用户所需的测试 * [故障排除指南]() \- 常见问题和修复 * [asciinema 3.0 文档]() * [zstd 帧格式]() * [Git 孤儿分支]()

Asciinema 流式备份

包含技能