kindle-calendar/bootstrap-new-kindle.sh

#!/usr/bin/env sh
set -eu

ROOT_DIR="$(CDPATH= cd -- "$(dirname "$0")" && pwd)"
WATCHTHIS_DIR="$ROOT_DIR/dash/staging/watchthis"
POST_JAILBREAK_ROOT="$ROOT_DIR/dash/staging/post-jailbreak-root"
SSH_HELPERS_DIR="$ROOT_DIR/scripts/kindle"
SYNC_SCRIPT="$ROOT_DIR/scripts/sync-layered-clock-to-kindle.sh"
THEMES_JSON="$ROOT_DIR/calendar/config/themes.json"

MODE="all"
VOLUME_PATH="/Volumes/Kindle"
HOST_TARGET="kindle"
THEME_ID=""
ORIENTATION=""
SHOW_BACKGROUND=true
START_DASHBOARD=false

print_usage() {
  cat <<'EOF'
用法：
  sh bootstrap-new-kindle.sh [模式] [选项]

模式：
  all                默认。能预置 USB 存储就先预置；能连 SSH 就继续做 SSH 后半段
  prepare-storage    只做 USB 存储预置
  post-ssh           只做 SSH 打通后的自动化收尾

选项：
  -v, --volume <path>          Kindle 挂载目录，默认 /Volumes/Kindle
  -k, --kindle <host>          Kindle SSH 主机名，默认 kindle
  -t, --theme <theme-id>       SSH 阶段切换到指定主题；默认使用 themes.json 的默认主题
  -o, --orientation <value>    SSH 阶段切换到指定方向；默认使用 themes.json 的默认方向
      --no-background          SSH 阶段不同步后立即切主题出图
      --start-dashboard        SSH 阶段额外后台启动 dashboard 主循环
  -h, --help                   查看帮助

说明：
  这不是 100% 零交互刷机脚本。
  受 Kindle 本机流程限制，下面这些步骤仍然必须人工完成：
  1. 进入 demo mode / WatchThis 流程
  2. 在正确时机执行 Sideload Content
  3. 触发 Get Started 完成越狱
  4. 搜索 ;log mrpi 安装 KUAL / MRPI / USBNetwork
  5. 首次进 KTerm 执行 sh /mnt/us/ssh-force-dropbear-22.sh

推荐操作顺序：

  阶段 A：先做 USB 预置
  1. 用 USB 线把 Kindle 接到 Mac。
  2. 确认 Finder 里已经出现 Kindle，默认挂载目录是 /Volumes/Kindle。
  3. 执行：
     sh bootstrap-new-kindle.sh prepare-storage
  4. 预期结果：
     - Kindle 根目录出现 Update_hotfix_watchthis_custom.bin
     - Kindle 根目录出现 ssh-force-dropbear-22.sh 等脚本
     - Kindle 根目录出现 dashboard/、extensions/、mrpackages/
     - Kindle 根目录出现 .demo/KV-5.13.6.zip、.demo/demo.json、.demo/goodreads/
  5. 安全弹出 Kindle。

  阶段 B：在 Kindle 上完成 WatchThis 和越狱
  1. 恢复出厂。
  2. 语言只选 English (United Kingdom)。
  3. 到 Wi-Fi 页面时，不要真的联网；先按 WatchThis 文档进入 demo mode。
  4. 第一次出现 Add Content / Sideload Content 时，只点 Done，不要接 USB。
  5. 遇到 misconfiguration / Configure Device 时，执行隐藏手势回到可操作界面。
  6. 再次进入 ;demo -> Sideload Content，这一次才是真正导入 payload 的时机。
     因为阶段 A 已经预置好 .demo 内容，这里不需要再从 Mac 手工拷文件。
  7. 退出 demo menu 后，进入 Help & User Guides -> Get Started 触发越狱。
  8. 越狱成功后，Kindle 根目录应出现 mkk、libkh、rp。

  阶段 C：安装 KUAL / MRPI / USBNetwork / dashboard
  1. 在 Kindle 首页搜索：
     ;log mrpi
  2. 等 MRPI 安装完成。
  3. 预期结果：
     - 首页出现 KUAL
     - KUAL 菜单里有 Rename OTA Binaries
     - KUAL 菜单里有 kindle-dash
  4. 先在 KUAL 中执行：
     Rename OTA Binaries -> Rename

  阶段 D：打通 Wi-Fi 和 SSH
  1. 让 Kindle 连到和 Mac 同一个主 Wi-Fi，不要用 Guest 网络。
  2. 打开 KTerm。
  3. 在 KTerm 执行：
     sh /mnt/us/ssh-force-dropbear-22.sh
  4. 回到 Mac，先测试：
     ssh kindle
  5. 如果这一步还不通，不要继续盲试，先回看：
     dash/docs/kindle-voyage-5.13.6-dual-ssh-playbook-zh.md

  阶段 E：SSH 打通后自动同步并出图
  1. 执行：
     sh bootstrap-new-kindle.sh post-ssh -t simple -o portrait
  2. 预期结果：
     - 自动同步 dashboard 运行时和主题包
     - Kindle 立即切到 simple / portrait
     - 屏幕马上显示背景和时钟
  3. 如果还希望后台常驻 dashboard 主循环，再执行：
     sh bootstrap-new-kindle.sh post-ssh -t simple -o portrait --start-dashboard

最省事的直接用法：
  1. USB 挂载时先运行：
     sh bootstrap-new-kindle.sh all -t simple -o portrait
     这会先做完能做的 USB 预置。
  2. 等你在 Kindle 上完成越狱、MRPI、Wi-Fi、KTerm 拉起 SSH 后，
     再重新运行同一条命令：
     sh bootstrap-new-kindle.sh all -t simple -o portrait
     这时它会自动继续做 SSH 后半段。

最容易做错的地方：
  1. 第一次 Add Content / Sideload Content 只能点 Done，不能在这一步导 payload。
  2. 真正导 payload 的时机，是隐藏手势返回后，再次进入 ;demo -> Sideload Content。
  3. 首次 SSH 最稳的入口是 KTerm，不是 USB 直连盲试。
  4. post-ssh 阶段如果不带 -t/-o，会退回 themes.json 里的默认主题和方向。

示例：
  sh bootstrap-new-kindle.sh prepare-storage
  sh bootstrap-new-kindle.sh all -t simple -o portrait
  sh bootstrap-new-kindle.sh post-ssh -k kindle --start-dashboard
EOF
}

log_step() {
  printf '\n[%s] %s\n' "$1" "$2"
}

require_path() {
  target_path=$1
  label=$2
  if [ ! -e "$target_path" ]; then
    echo "缺少${label}: $target_path" >&2
    exit 1
  fi
}

kindle_volume_available() {
  [ -d "$VOLUME_PATH" ]
}

ssh_reachable() {
  ssh -o BatchMode=yes -o ConnectTimeout=5 "$HOST_TARGET" true >/dev/null 2>&1
}

resolve_theme_selection() {
  python3 - "$THEMES_JSON" "$THEME_ID" "$ORIENTATION" <<'PY'
import json
import pathlib
import sys

path = pathlib.Path(sys.argv[1])
requested_theme = sys.argv[2]
requested_orientation = sys.argv[3]
data = json.loads(path.read_text())

themes = {theme["id"]: theme for theme in data.get("themes", [])}
theme_id = requested_theme or data.get("defaultThemeId", "")
if theme_id not in themes:
    raise SystemExit(f"未知主题: {theme_id}")

orientations = list(themes[theme_id].get("variants", {}).keys())
if not orientations:
    raise SystemExit(f"主题 {theme_id} 没有任何方向配置")

orientation = requested_orientation or data.get("defaultOrientation", "")
if orientation not in orientations:
    orientation = orientations[0]

print(f"THEME_ID={theme_id}")
print(f"ORIENTATION={orientation}")
PY
}

load_theme_selection() {
  resolved_output="$(resolve_theme_selection)"
  RESOLVED_THEME_ID=""
  RESOLVED_ORIENTATION=""

  while IFS='=' read -r key value; do
    case "$key" in
      THEME_ID)
        RESOLVED_THEME_ID=$value
        ;;
      ORIENTATION)
        RESOLVED_ORIENTATION=$value
        ;;
    esac
  done <<EOF
$resolved_output
EOF

  if [ -z "$RESOLVED_THEME_ID" ] || [ -z "$RESOLVED_ORIENTATION" ]; then
    echo "无法解析主题和方向。" >&2
    exit 1
  fi
}

copy_watchthis_payload() {
  require_path "$WATCHTHIS_DIR/KV-5.13.6/KV-5.13.6.zip" "WatchThis payload"
  require_path "$WATCHTHIS_DIR/KV-5.13.6/demo.json" "WatchThis demo.json"
  require_path "$WATCHTHIS_DIR/Update_hotfix_watchthis_custom.bin" "WatchThis hotfix"

  mkdir -p "$VOLUME_PATH/.demo/goodreads"
  cp "$WATCHTHIS_DIR/KV-5.13.6/KV-5.13.6.zip" "$VOLUME_PATH/.demo/"
  cp "$WATCHTHIS_DIR/KV-5.13.6/demo.json" "$VOLUME_PATH/.demo/"
  cp "$WATCHTHIS_DIR/Update_hotfix_watchthis_custom.bin" "$VOLUME_PATH/"
}

copy_post_jailbreak_bundle() {
  require_path "$POST_JAILBREAK_ROOT/extensions" "post-jailbreak extensions"
  require_path "$POST_JAILBREAK_ROOT/mrpackages" "post-jailbreak mrpackages"
  require_path "$POST_JAILBREAK_ROOT/dashboard" "post-jailbreak dashboard"

  mkdir -p "$VOLUME_PATH/extensions" "$VOLUME_PATH/mrpackages" "$VOLUME_PATH/dashboard"

  rsync -av --no-o --no-g "$POST_JAILBREAK_ROOT/extensions/" "$VOLUME_PATH/extensions/"
  rsync -av --no-o --no-g "$POST_JAILBREAK_ROOT/mrpackages/" "$VOLUME_PATH/mrpackages/"
  rsync -av --no-o --no-g "$POST_JAILBREAK_ROOT/dashboard/" "$VOLUME_PATH/dashboard/"
}

copy_ssh_helpers() {
  require_path "$SSH_HELPERS_DIR/ssh-force-dropbear-22.sh" "SSH helper scripts"

  rsync -av --no-o --no-g "$SSH_HELPERS_DIR/" "$VOLUME_PATH/"
}

print_storage_next_steps() {
  cat <<'EOF'

下一步请在 Kindle 上继续：
1. 按 [dash/docs/kindle-voyage-5.13.6-watchthis-zh.md] 的流程进入 demo mode。
2. 走到真正的 Sideload Content 时，脚本已预置好：
   - .demo/KV-5.13.6.zip
   - .demo/demo.json
   - .demo/goodreads/
3. 触发 Get Started 完成越狱。
4. 搜索 `;log mrpi` 安装 KUAL / MRPI / USBNetwork / dashboard。
5. 先在 KUAL 里执行 `Rename OTA Binaries -> Rename`。
6. 连上 Wi-Fi。
7. 打开 KTerm，执行：
   sh /mnt/us/ssh-force-dropbear-22.sh
8. 回到 Mac 后，再运行：
   sh bootstrap-new-kindle.sh post-ssh
EOF
}

prepare_storage() {
  if ! kindle_volume_available; then
    echo "未找到 Kindle 挂载目录: $VOLUME_PATH" >&2
    exit 1
  fi

  log_step "USB" "预置 WatchThis payload"
  copy_watchthis_payload

  log_step "USB" "预置越狱后安装包"
  copy_post_jailbreak_bundle

  log_step "USB" "预置 SSH 恢复脚本"
  copy_ssh_helpers

  log_step "完成" "USB 存储预置已完成：$VOLUME_PATH"
  print_storage_next_steps
}

prepare_remote_helpers() {
  ssh "$HOST_TARGET" "chmod +x /mnt/us/ssh-collect.sh /mnt/us/ssh-fix-all-keys.sh /mnt/us/ssh-force-dropbear-22.sh /mnt/us/ssh-force-openssh-22.sh /mnt/us/ssh-stop-all.sh 2>/dev/null || true"
  ssh "$HOST_TARGET" "if [ -f /mnt/us/ssh-fix-all-keys.sh ]; then sh /mnt/us/ssh-fix-all-keys.sh; fi"
}

sync_dashboard_runtime() {
  if [ -n "$THEME_ID" ]; then
    if [ -n "$ORIENTATION" ]; then
      sh "$SYNC_SCRIPT" "$HOST_TARGET" --theme "$THEME_ID" --orientation "$ORIENTATION"
    else
      sh "$SYNC_SCRIPT" "$HOST_TARGET" --theme "$THEME_ID"
    fi
  else
    sh "$SYNC_SCRIPT" "$HOST_TARGET"
  fi
}

show_background_once() {
  load_theme_selection
  ssh "$HOST_TARGET" "/mnt/us/dashboard/switch-theme.sh '$RESOLVED_THEME_ID' '$RESOLVED_ORIENTATION'"
}

start_dashboard_loop() {
  # 当前仓库里最稳的是 SSH 触发启动；这里后台拉起，便于 bootstrap 脚本直接返回。
  ssh "$HOST_TARGET" "mkdir -p /mnt/us/dashboard/logs && cd /mnt/us/dashboard && nohup ./start.sh >/mnt/us/dashboard/logs/bootstrap-start.log 2>&1 </dev/null &"
}

print_post_ssh_summary() {
  load_theme_selection
  cat <<EOF

SSH 阶段已完成：
- 主机：$HOST_TARGET
- 已同步 dashboard 运行时与主题包
- 当前用于出图的主题：$RESOLVED_THEME_ID / $RESOLVED_ORIENTATION

如果你要继续验证：
- SSH 登录：ssh $HOST_TARGET
- 立即切主题：ssh $HOST_TARGET '/mnt/us/dashboard/switch-theme.sh $RESOLVED_THEME_ID $RESOLVED_ORIENTATION'
- 抓图到本地：sh snapshot.sh -t $RESOLVED_THEME_ID -o $RESOLVED_ORIENTATION
EOF
}

post_ssh() {
  if ! ssh_reachable; then
    echo "当前还无法通过 SSH 连接 $HOST_TARGET。" >&2
    echo "请先在 Kindle 上连上 Wi-Fi，并在 KTerm 执行 sh /mnt/us/ssh-force-dropbear-22.sh" >&2
    exit 1
  fi

  log_step "SSH" "修复设备侧 SSH 辅助脚本权限与 authorized_keys"
  prepare_remote_helpers

  log_step "同步" "同步 dashboard 运行时和主题包到 Kindle"
  sync_dashboard_runtime

  if [ "$SHOW_BACKGROUND" = true ]; then
    log_step "显示" "立即切到当前主题并出图"
    show_background_once
  fi

  if [ "$START_DASHBOARD" = true ]; then
    log_step "启动" "后台启动 dashboard 主循环"
    start_dashboard_loop
  fi

  log_step "完成" "SSH 阶段自动化已完成"
  print_post_ssh_summary
}

while [ "$#" -gt 0 ]; do
  case "$1" in
    all|prepare-storage|post-ssh)
      MODE=$1
      ;;
    -v|--volume)
      shift
      VOLUME_PATH=${1:?"missing volume path"}
      ;;
    -k|--kindle)
      shift
      HOST_TARGET=${1:?"missing kindle host"}
      ;;
    -t|--theme)
      shift
      THEME_ID=${1:?"missing theme id"}
      ;;
    -o|--orientation)
      shift
      ORIENTATION=${1:?"missing orientation"}
      ;;
    --no-background)
      SHOW_BACKGROUND=false
      ;;
    --start-dashboard)
      START_DASHBOARD=true
      ;;
    -h|--help)
      print_usage
      exit 0
      ;;
    *)
      echo "未知参数: $1" >&2
      print_usage >&2
      exit 1
      ;;
  esac
  shift
done

require_path "$THEMES_JSON" "themes.json"
require_path "$SYNC_SCRIPT" "sync-layered-clock-to-kindle.sh"

case "$MODE" in
  prepare-storage)
    prepare_storage
    ;;
  post-ssh)
    post_ssh
    ;;
  all)
    did_anything=false

    if kindle_volume_available; then
      prepare_storage
      did_anything=true
    else
      log_step "跳过" "未检测到 Kindle 存储挂载：$VOLUME_PATH"
    fi

    if ssh_reachable; then
      post_ssh
      did_anything=true
    else
      log_step "等待" "SSH 还未打通；等 Kindle 连上 Wi-Fi 并在 KTerm 执行 sh /mnt/us/ssh-force-dropbear-22.sh 后，再重跑本脚本或执行 post-ssh。"
    fi

    if [ "$did_anything" != true ]; then
      echo "既没有检测到 Kindle 存储挂载，也没有检测到可用 SSH。" >&2
      echo "请先通过 USB 挂载 Kindle，或先恢复 SSH 后再执行。" >&2
      exit 1
    fi
    ;;
esac