m3u8-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: m3u8-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: HLS 视频下载与格式转换工具
 Author: r1a
 Author-email: r1a <m@zcq100.com>
@@ -200,6 +200,11 @@ m3u8-cli serve --host 0.0.0.0 --port 8787 --output-dir ./downloads
 
 启动日志会打印监听地址、输出目录与 API token；省略 --token 时会自动生成。
 
+来源为回环地址（`127.0.0.0/8`、`::1`，含 IPv4-mapped IPv6）的请求**免 token**，方便本机扩展/脚本直接使用；其他来源仍需 `Authorization: Bearer <token>`。注意：
+
+- 这意味着同一台机器上的其他用户或进程也能免 token 访问；如果通过监听在本机的反向代理转发请求，所有流量看起来都来自回环地址。
+- API 的 CORS 为 `*`，免 token 也意味着浏览器里的任意网页都能调用本机 serve（读取任务、提交下载）。如果在意这一点，请保留 Token（网页无法获取 Token），或自行收紧 CORS。
+
 ```bash
 # 创建任务
 curl -X POST http://127.0.0.1:8787/api/tasks \
@@ -217,6 +222,9 @@ curl -X POST http://127.0.0.1:8787/api/tasks \
 curl http://127.0.0.1:8787/api/tasks -H "Authorization: Bearer <token>"
 curl http://127.0.0.1:8787/api/tasks/<id> -H "Authorization: Bearer <token>"
 
+# 服务版本
+curl http://127.0.0.1:8787/api/version -H "Authorization: Bearer <token>"
+
 # 取消任务
 curl -X DELETE http://127.0.0.1:8787/api/tasks/<id> \
   -H "Authorization: Bearer <token>"
@@ -235,7 +243,8 @@ curl -X DELETE http://127.0.0.1:8787/api/tasks/<id> \
 - 监听页面网络请求并结合 DOM 扫描，列出当前标签页的 m3u8 地址；
 - 采集页面标题（`og:title`、Twitter Card、JSON-LD、`document.title`）作为默认下载文件名，也可在设置中改用 URL 短 hash；
 - 复制链接，或生成带 `Referer`/`Cookie`/`User-Agent` 的 `m3u8-cli download` 命令；
-- 一键提交到本地 `m3u8-cli serve` 下载，并在弹窗中查看进度、取消任务。
+- 一键提交到本地 `m3u8-cli serve` 下载，并在弹窗中查看进度、取消任务；
+- 设置页显示扩展版本与后端 `serve` 版本（依赖 `GET /api/version`）。
 
 安装步骤：打开 `chrome://extensions`，开启“开发者模式”，点击“加载已解压的扩展程序”，选择仓库中的 `chrome-extension/` 目录。
 
@@ -316,7 +325,8 @@ movie/
 - HLS AES-128 加密不是 DRM；能访问 `key.bin` 的客户端即可解密。
 - FFmpeg 的 HLS muxer 会写入固定 `IV=0`，所有分片共用同一密钥与 IV。
 - 不支持自定义密钥、密钥 URI 或 IV。
-- serve 不做 SSRF 内网地址屏蔽，依赖 token 与局域网部署。
+- serve 不做 SSRF 内网地址屏蔽；回环地址请求免 token，非本机来源仍依赖 token 与局域网部署。
+- 回环免 token 对同一台机器上的所有用户生效；多用户主机或本机反向代理场景请谨慎，必要时只监听 `127.0.0.1`。
 - Windows 默认 `MAX_PATH=260`：serve 会按输出目录长度截短过长的文件名（保留扩展名），任务响应中返回实际名字；CLI 的 `-o` 不做改写。
 - serve 不提供下载产物接口，文件留在服务器。
 - serve 重启后任务标记为 `interrupted`，不会自动恢复。

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/README.md

@@ -187,6 +187,11 @@ m3u8-cli serve --host 0.0.0.0 --port 8787 --output-dir ./downloads
 
 启动日志会打印监听地址、输出目录与 API token；省略 --token 时会自动生成。
 
+来源为回环地址（`127.0.0.0/8`、`::1`，含 IPv4-mapped IPv6）的请求**免 token**，方便本机扩展/脚本直接使用；其他来源仍需 `Authorization: Bearer <token>`。注意：
+
+- 这意味着同一台机器上的其他用户或进程也能免 token 访问；如果通过监听在本机的反向代理转发请求，所有流量看起来都来自回环地址。
+- API 的 CORS 为 `*`，免 token 也意味着浏览器里的任意网页都能调用本机 serve（读取任务、提交下载）。如果在意这一点，请保留 Token（网页无法获取 Token），或自行收紧 CORS。
+
 ```bash
 # 创建任务
 curl -X POST http://127.0.0.1:8787/api/tasks \
@@ -204,6 +209,9 @@ curl -X POST http://127.0.0.1:8787/api/tasks \
 curl http://127.0.0.1:8787/api/tasks -H "Authorization: Bearer <token>"
 curl http://127.0.0.1:8787/api/tasks/<id> -H "Authorization: Bearer <token>"
 
+# 服务版本
+curl http://127.0.0.1:8787/api/version -H "Authorization: Bearer <token>"
+
 # 取消任务
 curl -X DELETE http://127.0.0.1:8787/api/tasks/<id> \
   -H "Authorization: Bearer <token>"
@@ -222,7 +230,8 @@ curl -X DELETE http://127.0.0.1:8787/api/tasks/<id> \
 - 监听页面网络请求并结合 DOM 扫描，列出当前标签页的 m3u8 地址；
 - 采集页面标题（`og:title`、Twitter Card、JSON-LD、`document.title`）作为默认下载文件名，也可在设置中改用 URL 短 hash；
 - 复制链接，或生成带 `Referer`/`Cookie`/`User-Agent` 的 `m3u8-cli download` 命令；
-- 一键提交到本地 `m3u8-cli serve` 下载，并在弹窗中查看进度、取消任务。
+- 一键提交到本地 `m3u8-cli serve` 下载，并在弹窗中查看进度、取消任务；
+- 设置页显示扩展版本与后端 `serve` 版本（依赖 `GET /api/version`）。
 
 安装步骤：打开 `chrome://extensions`，开启“开发者模式”，点击“加载已解压的扩展程序”，选择仓库中的 `chrome-extension/` 目录。
 
@@ -303,7 +312,8 @@ movie/
 - HLS AES-128 加密不是 DRM；能访问 `key.bin` 的客户端即可解密。
 - FFmpeg 的 HLS muxer 会写入固定 `IV=0`，所有分片共用同一密钥与 IV。
 - 不支持自定义密钥、密钥 URI 或 IV。
-- serve 不做 SSRF 内网地址屏蔽，依赖 token 与局域网部署。
+- serve 不做 SSRF 内网地址屏蔽；回环地址请求免 token，非本机来源仍依赖 token 与局域网部署。
+- 回环免 token 对同一台机器上的所有用户生效；多用户主机或本机反向代理场景请谨慎，必要时只监听 `127.0.0.1`。
 - Windows 默认 `MAX_PATH=260`：serve 会按输出目录长度截短过长的文件名（保留扩展名），任务响应中返回实际名字；CLI 的 `-o` 不做改写。
 - serve 不提供下载产物接口，文件留在服务器。
 - serve 重启后任务标记为 `interrupted`，不会自动恢复。

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/chrome-extension/README.md

@@ -48,7 +48,7 @@ uv run m3u8-cli serve --host 127.0.0.1 --port 8787 --token mytoken --output-dir
 | 设置项 | 说明 |
 | --- | --- |
 | 服务地址 | 默认 `http://127.0.0.1:8787`，需与 `--host/--port` 一致 |
-| Token | 与 `--token` 一致；点击“测试连接”确认 |
+| Token | 与 `--token` 一致；本机 serve（回环地址）可留空，点击“测试连接”确认 |
 | 下载格式 | `mp4`（合并封装）或 `hls`（保留分片） |
 | 文件名 | `页面标题`（默认）或 `URL 短 hash`（12 位十六进制；URL 带临时 token 时每次可能不同） |
 | 覆盖已存在的文件 | 对应 serve 的 `overwrite` 字段 |
@@ -60,7 +60,7 @@ uv run m3u8-cli serve --host 127.0.0.1 --port 8787 --token mytoken --output-dir
 
 1. 打开包含视频的页面并开始播放，或等待页面加载完成。
 2. 扩展图标上的 badge 显示当前标签页识别到的 m3u8 数量。
-3. 点击扩展图标，候选条目会显示页面标题和 m3u8 URL：
+3. 点击扩展图标，弹窗分为「链接 / 任务 / 设置 / 关于」四个标签页；「关于」页分为「项目描述 / 使用帮助 / 项目信息」：使用帮助包含 `pip install m3u8-cli`、可折行展示的 serve 启动命令与扩展配置提示，项目信息包含 PyPI 主页、作者/邮箱与 MIT 许可证链接；「链接」中候选条目会显示页面标题和 m3u8 URL：
    - **复制**：复制 m3u8 URL。
    - **复制 CLI**：生成 `m3u8-cli download ...` 命令，按设置决定是否包含 `--referer`、`--cookie`、`--user-agent`；`-o` 默认使用页面标题。
    - **下载**：提交到本地 serve 服务，默认文件名同样来自页面标题；若提示文件名冲突，可点击“换名重试”自动加时间戳。
@@ -101,6 +101,7 @@ uv run m3u8-cli serve --host 127.0.0.1 --port 8787 --token mytoken --output-dir
 - 服务地址不是本机（`127.0.0.1`/`localhost`/`::1`）且开启 Cookie 透传时，设置区会显示警告。
 - Token 保存在 `storage.local`，请勿在不信任的共享 Chrome 配置中使用。
 - serve 端请求头只保留在内存，不落盘、不在任务响应中返回；详见仓库 README。
+- serve 对回环地址请求免 token：Token 留空时扩展默认只适合连接本机 serve；同一台机器上的其他用户/进程也能免 token 访问该服务。API 的 CORS 为 `*`，因此任意网页也能调用本机 serve；若在意请在扩展里保留 Token（网页拿不到它）。
 - 扩展不会自动提交下载，必须由用户点击，避免页面借扩展触发 serve 请求。
 - 「跳过 TLS 证书校验」会关闭 serve 到源站的证书与主机名校验，可能暴露下载内容给中间人；仅在确认源站可信（如自签名内网服务）时开启。
 - CORS `*` 不是安全边界，真正的访问控制是 Bearer token。
@@ -113,7 +114,7 @@ uv run m3u8-cli serve --host 127.0.0.1 --port 8787 --token mytoken --output-dir
 | 提示“未配置 Token” | 在扩展设置中填写 serve 的 `--token` |
 | “无法连接 http://...（Failed to fetch）” | serve 未启动、地址/端口错误，或协议不是 `http/https` |
 | 提示“连接 ... 超时（8 秒）” | 服务可达性差或进程卡住；确认 serve 正常运行并检查网络/防火墙 |
-| 401 / “未授权” | Token 与服务端不一致；serve 未指定 `--token` 时每次启动都会生成新 token |
+| 401 / “未授权” | 非本机请求需要 Token；本机回环请求免 token，若仍 401 检查是否经过代理或填了错误 Token |
 | 409 / 目标文件已存在 | 点击“换名重试”，或在设置中开启“覆盖已存在的文件” |
 | 下载失败，提示 403 | 源站可能校验 `Referer`/`Cookie`/`User-Agent`；确认候选来自“网络”且页面仍处于登录状态 |
 | 失败原因是 `CERTIFICATE_VERIFY_FAILED` / Hostname mismatch | 源站证书不匹配（自签名或内网域名）；确认可信后开启「跳过 TLS 证书校验」 |
@@ -153,7 +154,7 @@ uv run python scripts/build_extension.py
 - `storage.session["hdr:<candidateId>"]`：`{cookie, referer, userAgent}`，仅 background 读取。
 - `storage.local["settings"]`：服务地址、token、格式、`naming`（`title`/`hash`）、`insecure`（跳过源站 TLS 校验）等设置。
 - `storage.local["tasks"]`：最近的任务摘要（最多 20 条，优先保留活动任务），不含请求头。
-- popup 通过 `chrome.runtime.sendMessage` 发送 `download:submit`、`task:cancel`、`tasks:refresh`、`settings:test`、`cli:build`、`tab:clear`、`dom:rescan`。
+- popup 通过 `chrome.runtime.sendMessage` 发送 `download:submit`、`task:cancel`、`tasks:refresh`、`settings:test`、`server:version`、`cli:build`、`tab:clear`、`dom:rescan`。`server:version` 请求后端的 `GET /api/version`；设置页底部显示「插件 vX · 后端 vY」，并附 PyPI 链接；无法连接/需要 Token/旧版 serve（无该接口）分别显示对应状态。
 - content script 通过 `dom:candidates` 上报 URL 与 `title`（附 `frameTop` 标记是否顶层 frame），用 `sender.tab.id` 归属标签页。
 
 ## 已知限制

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/chrome-extension/background.js

@@ -418,7 +418,9 @@ async function apiFetch(path, options) {
     headers: { ...((options && options.headers) || {}) },
     signal: AbortSignal.timeout(8000),
   };
-  init.headers.Authorization = `Bearer ${settings.token}`;
+  if (settings.token) {
+    init.headers.Authorization = `Bearer ${settings.token}`;
+  }
 
   let response;
   try {
@@ -468,12 +470,6 @@ async function submitDownload(message) {
     return { ok: false, error: "无效的标签页" };
   }
   const settings = await getSettings();
-  if (!settings.token) {
-    return {
-      ok: false,
-      error: "未配置 Token：请在扩展设置中填写 serve 的 token",
-    };
-  }
   const state = await readTabState(tabId);
   const candidate = state.items.find((item) => item.id === message.candidateId);
   if (!candidate) {
@@ -523,10 +519,6 @@ async function submitDownload(message) {
 }
 
 async function testConnection() {
-  const settings = await getSettings();
-  if (!settings.token) {
-    return { ok: false, error: "请先填写 Token" };
-  }
   try {
     const result = await apiFetch("/api/tasks?limit=1");
     return { ok: true, total: Number(result.total || 0) };
@@ -722,6 +714,10 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
       return { ok: true, tasks };
     },
     "settings:test": () => testConnection(),
+    "server:version": async () => {
+      const result = await apiFetch("/api/version");
+      return { ok: true, version: String(result.version || "") };
+    },
     "cli:build": () => buildCliMessage(message),
     "tab:clear": () => clearTabAndRescan(message.tabId),
     "dom:rescan": () => rescanTab(message.tabId),

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/chrome-extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "m3u8-cli 链接检测器",
-  "version": "1.3.0",
+  "version": "1.8.0",
   "description": "识别页面中的 m3u8 播放列表，复制链接或发送到本地 m3u8-cli 服务下载。",
   "minimum_chrome_version": "116",
   "permissions": ["webRequest", "storage", "alarms"],

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/chrome-extension/popup.css

@@ -97,10 +97,9 @@ button:disabled {
   top: 0;
   z-index: 2;
   display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 8px;
-  padding: 10px 14px;
+  flex-direction: column;
+  gap: 6px;
+  padding: 10px 14px 0;
   background: var(--panel);
   border-bottom: 1px solid var(--border);
   box-shadow: var(--shadow);
@@ -133,26 +132,74 @@ h1 {
   white-space: nowrap;
 }
 
-.count {
-  min-width: 20px;
-  padding: 0 6px;
+.tabs {
+  display: flex;
+  gap: 2px;
+  margin: 0 -14px;
+  padding: 0 14px;
+}
+
+.tab {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  margin-bottom: -1px;
+  padding: 7px 10px 6px;
+  border: none;
+  border-bottom: 2px solid transparent;
+  border-radius: 0;
+  background: transparent;
+  color: var(--muted);
+  font-size: 12.5px;
+  font-weight: 600;
+}
+
+.tab:hover:not(:disabled) {
+  background: transparent;
+  color: var(--accent-strong);
+}
+
+.tab.active {
+  color: var(--accent-strong);
+  border-bottom-color: var(--accent);
+}
+
+.tab:focus-visible {
+  outline: 2px solid var(--accent-soft);
+  outline-offset: -2px;
+}
+
+.tab-count {
+  min-width: 18px;
+  padding: 0 5px;
   border-radius: 999px;
   background: var(--accent-soft);
   color: var(--accent-strong);
-  font-size: 11px;
+  font-size: 10px;
   font-weight: 600;
+  line-height: 16px;
   text-align: center;
 }
 
-.header-actions {
-  display: flex;
-  gap: 6px;
+.tab.active .tab-count {
+  background: var(--accent);
+  color: #fff;
 }
 
 main {
   padding: 10px 14px 16px;
 }
 
+.section-actions {
+  display: flex;
+  gap: 6px;
+}
+
+.hint {
+  color: var(--muted);
+  font-size: 11px;
+}
+
 .section + .section {
   margin-top: 14px;
 }
@@ -372,24 +419,11 @@ h2 {
   word-break: break-word;
 }
 
-.settings {
-  margin-top: 16px;
-  border-top: 1px solid var(--border);
-  padding-top: 10px;
-}
-
-.settings summary {
-  cursor: pointer;
-  color: var(--muted);
-  font-size: 12px;
-  font-weight: 600;
-}
-
 .settings-grid {
   display: flex;
   flex-direction: column;
   gap: 9px;
-  padding-top: 10px;
+  padding-top: 4px;
 }
 
 .settings-grid > label {
@@ -463,6 +497,124 @@ h2 {
   color: var(--danger);
 }
 
+.version-info {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 8px;
+  margin-top: 12px;
+  padding-top: 8px;
+  border-top: 1px solid var(--border);
+  color: var(--muted);
+  font-size: 11px;
+}
+
+.version-info.connected {
+  color: var(--success);
+}
+
+.version-info a {
+  flex: none;
+  color: var(--accent-strong);
+  text-decoration: none;
+}
+
+.version-info a:hover {
+  text-decoration: underline;
+}
+
+.about-section {
+  margin-top: 14px;
+}
+
+.section-title-row + .about-section {
+  margin-top: 8px;
+}
+
+.about-section h3 {
+  margin: 0 0 6px;
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--muted);
+  letter-spacing: 0.02em;
+}
+
+.about-desc {
+  margin: 0 0 6px;
+  color: var(--muted);
+  font-size: 12px;
+}
+
+.about-list {
+  margin: 0;
+  padding-left: 18px;
+  color: var(--muted);
+  font-size: 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+}
+
+.about-step + .about-step {
+  margin-top: 10px;
+}
+
+.about-step h4 {
+  margin: 0 0 5px;
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.about-note {
+  margin: 5px 0 0;
+  color: var(--muted);
+  font-size: 11.5px;
+}
+
+.about-section pre {
+  margin: 0;
+  padding: 8px 10px;
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  background: var(--accent-soft);
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  font-size: 11.5px;
+  line-height: 1.5;
+}
+
+.about-section code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 11.5px;
+}
+
+.about-section a {
+  color: var(--accent-strong);
+  text-decoration: none;
+}
+
+.about-section a:hover {
+  text-decoration: underline;
+}
+
+.about-info {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 4px 10px;
+  margin: 0;
+  font-size: 12px;
+}
+
+.about-info dt {
+  color: var(--muted);
+}
+
+.about-info dd {
+  margin: 0;
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+
 .toast {
   position: fixed;
   left: 50%;

m3u8_cli-0.2.1/chrome-extension/popup.html

@@ -0,0 +1,293 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>m3u8-cli 链接检测器</title>
+    <link rel="stylesheet" href="popup.css" />
+  </head>
+  <body>
+    <header class="app-header">
+      <div class="title-row">
+        <span class="logo" aria-hidden="true">▶</span>
+        <h1>m3u8 检测器</h1>
+      </div>
+      <nav id="tab-list" class="tabs" role="tablist" aria-label="视图">
+        <button
+          id="tab-candidates"
+          type="button"
+          class="tab active"
+          role="tab"
+          data-tab="candidates"
+          aria-controls="panel-candidates"
+          aria-selected="true"
+        >
+          链接<span id="candidate-count" class="tab-count">0</span>
+        </button>
+        <button
+          id="tab-tasks"
+          type="button"
+          class="tab"
+          role="tab"
+          data-tab="tasks"
+          aria-controls="panel-tasks"
+          aria-selected="false"
+          tabindex="-1"
+        >
+          任务<span id="task-count" class="tab-count" hidden>0</span>
+        </button>
+        <button
+          id="tab-settings"
+          type="button"
+          class="tab"
+          role="tab"
+          data-tab="settings"
+          aria-controls="panel-settings"
+          aria-selected="false"
+          tabindex="-1"
+        >
+          设置
+        </button>
+        <button
+          id="tab-about"
+          type="button"
+          class="tab"
+          role="tab"
+          data-tab="about"
+          aria-controls="panel-about"
+          aria-selected="false"
+          tabindex="-1"
+        >
+          关于
+        </button>
+      </nav>
+    </header>
+
+    <main>
+      <section
+        id="panel-candidates"
+        class="panel"
+        role="tabpanel"
+        aria-labelledby="tab-candidates"
+      >
+        <div class="section-title-row">
+          <h2>检测到的链接</h2>
+          <div class="section-actions">
+            <button id="rescan-button" type="button" class="ghost small">
+              重新扫描
+            </button>
+            <button id="clear-button" type="button" class="ghost small">
+              清空
+            </button>
+          </div>
+        </div>
+        <div id="empty-state" class="empty">
+          未检测到 m3u8 链接。<br />
+          播放视频或刷新页面后再试。
+        </div>
+        <ul id="candidate-list" class="candidate-list"></ul>
+      </section>
+
+      <section
+        id="panel-tasks"
+        class="panel"
+        role="tabpanel"
+        aria-labelledby="tab-tasks"
+        hidden
+      >
+        <div class="section-title-row">
+          <h2>下载任务</h2>
+          <button id="refresh-tasks" type="button" class="ghost small">
+            刷新
+          </button>
+        </div>
+        <div id="task-empty" class="empty small-empty">暂无任务</div>
+        <ul id="task-list" class="task-list"></ul>
+      </section>
+
+      <section
+        id="panel-settings"
+        class="panel"
+        role="tabpanel"
+        aria-labelledby="tab-settings"
+        hidden
+      >
+        <div class="section-title-row">
+          <h2>设置</h2>
+          <span class="hint">修改后自动保存</span>
+        </div>
+        <div class="settings-grid">
+          <label>
+            <span>服务地址</span>
+            <input
+              id="server-url"
+              type="text"
+              spellcheck="false"
+              placeholder="http://127.0.0.1:8787"
+            />
+          </label>
+          <label>
+            <span>Token</span>
+            <input
+              id="token"
+              type="password"
+              autocomplete="off"
+              spellcheck="false"
+              placeholder="本机 serve 可留空"
+            />
+          </label>
+          <label>
+            <span>下载格式</span>
+            <select id="format">
+              <option value="mp4">MP4（合并封装）</option>
+              <option value="hls">HLS（保留分片）</option>
+            </select>
+          </label>
+          <label>
+            <span>文件名</span>
+            <select id="naming">
+              <option value="title">页面标题</option>
+              <option value="hash">URL 短 hash</option>
+            </select>
+          </label>
+          <label class="checkbox">
+            <input id="overwrite" type="checkbox" />
+            <span>覆盖已存在的文件</span>
+          </label>
+          <label class="checkbox">
+            <input id="send-cookie" type="checkbox" />
+            <span>发送捕获到的 Cookie（用于下载）</span>
+          </label>
+          <label class="checkbox">
+            <input id="copy-cookie" type="checkbox" />
+            <span>复制 CLI 命令时包含 Cookie（敏感）</span>
+          </label>
+          <label class="checkbox">
+            <input id="insecure" type="checkbox" />
+            <span>跳过 TLS 证书校验（不安全，仅用于自签名/内网服务）</span>
+          </label>
+          <div id="remote-warning" class="warning" hidden>
+            服务地址不是本机，Cookie 会被发送到该地址，请确认其可信。
+          </div>
+          <div class="settings-actions">
+            <button id="test-connection" type="button" class="primary">
+              测试连接
+            </button>
+            <span id="settings-status" class="status"></span>
+          </div>
+        </div>
+        <div id="version-info" class="version-info">
+          <span id="version-text">插件版本读取中…</span>
+          <a
+            id="version-pypi"
+            href="https://pypi.org/project/m3u8-cli/"
+            target="_blank"
+            rel="noopener noreferrer"
+            >PyPI</a
+          >
+        </div>
+      </section>
+
+      <section
+        id="panel-about"
+        class="panel"
+        role="tabpanel"
+        aria-labelledby="tab-about"
+        hidden
+      >
+        <div class="section-title-row">
+          <h2>关于</h2>
+          <span class="hint">m3u8-cli 链接检测器</span>
+        </div>
+
+        <div class="about-section">
+          <h3>项目描述</h3>
+          <p class="about-desc">
+            本扩展用于发现网页中的 m3u8 播放列表，并与本地
+            <code>m3u8-cli</code> 下载服务配合使用：
+          </p>
+          <ul class="about-list">
+            <li>
+              监听网络请求并扫描页面，识别 m3u8 地址，支持 iframe
+              中的播放器
+            </li>
+            <li>
+              复制链接，或生成带 <code>Referer</code>/<code>Cookie</code>
+              的 <code>m3u8-cli download</code> 命令
+            </li>
+            <li>
+              一键提交到 <code>m3u8-cli serve</code>
+              下载，并在弹窗中查看进度、取消任务
+            </li>
+          </ul>
+        </div>
+
+        <div class="about-section">
+          <h3>使用帮助</h3>
+
+          <div class="about-step">
+            <h4>1. 安装 CLI</h4>
+            <pre><code>pip install m3u8-cli</code></pre>
+          </div>
+
+          <div class="about-step">
+            <h4>2. 启动下载服务</h4>
+            <pre><code>m3u8-cli serve \
+  --host 127.0.0.1 \
+  --port 8787 \
+  --token &lt;token&gt; \
+  --output-dir ./downloads</code></pre>
+            <p class="about-note">
+              本机（回环地址）请求免 Token；其他来源需使用与
+              <code>--token</code> 一致的 Token。
+            </p>
+          </div>
+
+          <div class="about-step">
+            <h4>3. 配置扩展</h4>
+            <p class="about-note">
+              在「设置」中确认服务地址（默认
+              <code>http://127.0.0.1:8787</code>），本机可留空
+              Token。
+            </p>
+          </div>
+        </div>
+
+        <div class="about-section">
+          <h3>项目信息</h3>
+          <dl class="about-info">
+            <dt>项目主页</dt>
+            <dd>
+              <a
+                href="https://pypi.org/project/m3u8-cli/"
+                target="_blank"
+                rel="noopener noreferrer"
+                >pypi.org/project/m3u8-cli</a
+              >
+            </dd>
+            <dt>作者</dt>
+            <dd>r1a</dd>
+            <dt>邮箱</dt>
+            <dd>
+              <a href="mailto:m@zcq100.com">m@zcq100.com</a>
+            </dd>
+            <dt>许可证</dt>
+            <dd>
+              <a
+                href="https://opensource.org/license/mit"
+                target="_blank"
+                rel="noopener noreferrer"
+                >MIT License</a
+              >
+            </dd>
+          </dl>
+        </div>
+      </section>
+    </main>
+
+    <div id="toast" class="toast" role="status" hidden></div>
+
+    <script src="lib.js"></script>
+    <script src="popup.js"></script>
+  </body>
+</html>

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/chrome-extension/popup.js

@@ -23,12 +23,14 @@
     lost: "已丢失",
   };
   const ACTIVE_STATES = new Set(["queued", "running"]);
+  const TAB_NAMES = ["candidates", "tasks", "settings", "about"];
   const REFRESH_INTERVAL_MS = 2000;
   const SETTINGS_SAVE_DELAY_MS = 300;
   // 服务端会按输出目录长度截短文件名；重试名保持较短，避免时间戳被截掉。
   const RETRY_NAME_LIMIT = 100;
 
   const elements = {};
+  let activeTab = "candidates";
   let currentTabId = null;
   let currentPageUrl = "";
   let currentPageTitle = "";
@@ -44,7 +46,11 @@
   }
 
   function cacheElements() {
+    elements.tabList = byId("tab-list");
+    elements.tabs = Array.from(document.querySelectorAll(".tab"));
+    elements.panels = Array.from(document.querySelectorAll(".panel"));
     elements.candidateCount = byId("candidate-count");
+    elements.taskCount = byId("task-count");
     elements.candidateList = byId("candidate-list");
     elements.emptyState = byId("empty-state");
     elements.rescanButton = byId("rescan-button");
@@ -63,6 +69,8 @@
     elements.remoteWarning = byId("remote-warning");
     elements.testConnection = byId("test-connection");
     elements.settingsStatus = byId("settings-status");
+    elements.versionInfo = byId("version-info");
+    elements.versionText = byId("version-text");
     elements.toast = byId("toast");
   }
 
@@ -121,6 +129,56 @@
     }
   }
 
+  /* ------------------------------------------------------------------ */
+  /* 标签页切换                                                          */
+  /* ------------------------------------------------------------------ */
+
+  function activateTab(name, moveFocus) {
+    activeTab = TAB_NAMES.includes(name) ? name : TAB_NAMES[0];
+    for (const tab of elements.tabs) {
+      const selected = tab.dataset.tab === activeTab;
+      tab.classList.toggle("active", selected);
+      tab.setAttribute("aria-selected", selected ? "true" : "false");
+      tab.tabIndex = selected ? 0 : -1;
+      if (selected && moveFocus) {
+        tab.focus();
+      }
+    }
+    for (const panel of elements.panels) {
+      panel.hidden = panel.id !== `panel-${activeTab}`;
+    }
+  }
+
+  function selectTab(name, moveFocus) {
+    activateTab(name, moveFocus);
+    if (activeTab === "candidates") {
+      loadCandidates().catch(() => {});
+    } else if (activeTab === "tasks") {
+      refreshTasks().catch(() => {});
+    } else if (activeTab === "settings") {
+      refreshVersionInfo().catch(() => {});
+    }
+  }
+
+  function handleTabKeydown(event) {
+    const index = TAB_NAMES.indexOf(activeTab);
+    let next = null;
+    if (event.key === "ArrowRight") {
+      next = (index + 1) % TAB_NAMES.length;
+    } else if (event.key === "ArrowLeft") {
+      next = (index - 1 + TAB_NAMES.length) % TAB_NAMES.length;
+    } else if (event.key === "Home") {
+      next = 0;
+    } else if (event.key === "End") {
+      next = TAB_NAMES.length - 1;
+    }
+    if (next === null) {
+      return;
+    }
+    event.preventDefault();
+    selectTab(TAB_NAMES[next], true);
+  }
+
   /* ------------------------------------------------------------------ */
   /* 候选列表                                                            */
   /* ------------------------------------------------------------------ */
@@ -279,10 +337,7 @@
     const settingsButton = createButton(
       "打开设置",
       () => {
-        const panel = document.querySelector(".settings");
-        if (panel) {
-          panel.open = true;
-        }
+        selectTab("settings");
         elements.token.focus();
       },
       "ghost small",
@@ -380,6 +435,11 @@
   }
 
   function renderTasks() {
+    const activeCount = tasks.filter(
+      (task) => ACTIVE_STATES.has(task.state),
+    ).length;
+    elements.taskCount.textContent = String(activeCount);
+    elements.taskCount.hidden = activeCount === 0;
     elements.taskEmpty.hidden = tasks.length > 0;
     elements.taskList.replaceChildren();
     for (const task of tasks) {
@@ -465,9 +525,46 @@
   }
 
   /* ------------------------------------------------------------------ */
-  /* 设置                                                                */
+  /* 设置与版本信息                                                      */
   /* ------------------------------------------------------------------ */
 
+  async function refreshVersionInfo() {
+    let extensionVersion = "?";
+    try {
+      const manifest = chrome.runtime.getManifest
+        ? chrome.runtime.getManifest()
+        : null;
+      extensionVersion = (manifest && manifest.version) || "?";
+    } catch (_) {
+      // 极少数环境拿不到 manifest，保留占位符。
+    }
+
+    let backend = "未连接";
+    let detail = "";
+    try {
+      const response = await sendMessage({ type: "server:version" });
+      if (response && response.ok) {
+        backend = response.version ? `v${response.version}` : "未知";
+        elements.versionInfo.classList.add("connected");
+      } else {
+        const status = Number((response && response.status) || 0);
+        backend = status === 404
+          ? "旧版"
+          : status === 401
+            ? "需 Token"
+            : "未连接";
+        detail = (response && response.error) || "";
+        elements.versionInfo.classList.remove("connected");
+      }
+    } catch (error) {
+      detail = error.message || String(error);
+      elements.versionInfo.classList.remove("connected");
+    }
+    elements.versionText.textContent =
+      `插件 v${extensionVersion} · 后端 ${backend}`;
+    elements.versionText.title = detail;
+  }
+
   async function loadSettings() {
     const data = await chrome.storage.local.get("settings");
     settings = { ...DEFAULT_SETTINGS, ...(data.settings || {}) };
@@ -561,6 +658,7 @@
     } finally {
       elements.testConnection.disabled = false;
     }
+    refreshVersionInfo().catch(() => {});
   }
 
   /* ------------------------------------------------------------------ */
@@ -568,6 +666,12 @@
   /* ------------------------------------------------------------------ */
 
   function bindEvents() {
+    for (const tab of elements.tabs) {
+      tab.addEventListener("click", () => {
+        selectTab(tab.dataset.tab);
+      });
+    }
+    elements.tabList.addEventListener("keydown", handleTabKeydown);
     elements.rescanButton.addEventListener("click", requestRescan);
     elements.clearButton.addEventListener("click", clearCurrentTab);
     elements.refreshTasks.addEventListener("click", () => {
@@ -631,6 +735,7 @@
   async function init() {
     cacheElements();
     bindEvents();
+    activateTab(activeTab);
 
     const [tab] = await chrome.tabs.query({
       active: true,
@@ -643,6 +748,7 @@
     }
 
     await Promise.all([loadSettings(), loadCandidates(), loadTasks()]);
+    refreshVersionInfo().catch(() => {});
     startTaskRefresh();
     await refreshTasks();
   }

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "m3u8-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "HLS 视频下载与格式转换工具"
 readme = "README.md"
 license = "MIT"

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "m3u8-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "HLS 视频下载与格式转换工具"
 readme = "README.md"
 authors = [

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/src/m3u8_cli/__init__.py

@@ -1,3 +1,3 @@
 """HLS 视频下载与格式转换工具。"""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{m3u8_cli-0.2.0 → m3u8_cli-0.2.1}/src/m3u8_cli/serve.py

@@ -1,6 +1,7 @@
 """RESTful 下载服务。"""
 
 import hmac
+import ipaddress
 import json
 import secrets
 import threading
@@ -11,6 +12,7 @@ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 from urllib.parse import parse_qs, urlsplit
 
+from . import __version__
 from .download import DownloadOptions, download_hls
 from .errors import DownloadCancelled, HLSException
 from .paths import fit_output_name
@@ -470,8 +472,22 @@ def parse_task_request(payload, default_jobs=8):
     }
 
 
-def make_handler(manager, token):
-    """创建绑定到指定 TaskManager 与 token 的请求处理器。"""
+def is_loopback_address(address):
+    """判断连接来源是否为本机回环地址（兼容 IPv4-mapped IPv6）。"""
+    try:
+        ip = ipaddress.ip_address(str(address).split("%", 1)[0])
+    except ValueError:
+        return False
+    if isinstance(ip, ipaddress.IPv6Address) and ip.ipv4_mapped:
+        ip = ip.ipv4_mapped
+    return ip.is_loopback
+
+
+def make_handler(manager, token, allow_local=True):
+    """创建绑定到指定 TaskManager 与 token 的请求处理器。
+
+    allow_local 为 True 时，来源为回环地址的请求跳过 token 校验。
+    """
     if not token:
         raise ValueError("token 不能为空")
     valid_states = {
@@ -525,11 +541,15 @@ def make_handler(manager, token):
                 return False
 
         def _require_auth(self):
-            if not self._authorized():
-                self.close_connection = True
-                self._send_json(401, {"error": "未授权"})
-                return False
-            return True
+            if allow_local and is_loopback_address(
+                self.client_address[0]
+            ):
+                return True
+            if self._authorized():
+                return True
+            self.close_connection = True
+            self._send_json(401, {"error": "未授权"})
+            return False
 
         def _path_parts(self):
             return urlsplit(self.path).path.rstrip("/").split("/")
@@ -565,6 +585,13 @@ def make_handler(manager, token):
         def _handle_get(self):
             parts = self._path_parts()
 
+            if parts == ["", "api", "version"]:
+                self._send_json(200, {
+                    "name": "m3u8-cli",
+                    "version": __version__,
+                })
+                return
+
             if parts == ["", "api", "tasks"]:
                 query = parse_qs(urlsplit(self.path).query)
                 state = query.get("state", [None])[0]
@@ -725,6 +752,10 @@ def run_serve(args):
     )
     print(f"输出目录：{output_dir}", flush=True)
     print(f"API token：{token}", flush=True)
+    print(
+        "本机（回环地址）请求免 token；其他来源需要 Bearer token",
+        flush=True,
+    )
 
     try:
         server.serve_forever()

m3u8_cli-0.2.0/chrome-extension/popup.html

@@ -1,112 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>m3u8-cli 链接检测器</title>
-    <link rel="stylesheet" href="popup.css" />
-  </head>
-  <body>
-    <header class="app-header">
-      <div class="title-row">
-        <span class="logo" aria-hidden="true">▶</span>
-        <h1>m3u8 检测器</h1>
-        <span id="candidate-count" class="count">0</span>
-      </div>
-      <div class="header-actions">
-        <button id="rescan-button" type="button" class="ghost">重新扫描</button>
-        <button id="clear-button" type="button" class="ghost">清空</button>
-      </div>
-    </header>
-
-    <main>
-      <section class="section">
-        <div id="empty-state" class="empty">
-          未检测到 m3u8 链接。<br />
-          播放视频或刷新页面后再试。
-        </div>
-        <ul id="candidate-list" class="candidate-list"></ul>
-      </section>
-
-      <section class="section">
-        <div class="section-title-row">
-          <h2>下载任务</h2>
-          <button id="refresh-tasks" type="button" class="ghost small">
-            刷新
-          </button>
-        </div>
-        <div id="task-empty" class="empty small-empty">暂无任务</div>
-        <ul id="task-list" class="task-list"></ul>
-      </section>
-
-      <details class="settings">
-        <summary>设置</summary>
-        <div class="settings-grid">
-          <label>
-            <span>服务地址</span>
-            <input
-              id="server-url"
-              type="text"
-              spellcheck="false"
-              placeholder="http://127.0.0.1:8787"
-            />
-          </label>
-          <label>
-            <span>Token</span>
-            <input
-              id="token"
-              type="password"
-              autocomplete="off"
-              spellcheck="false"
-              placeholder="m3u8-cli serve --token ..."
-            />
-          </label>
-          <label>
-            <span>下载格式</span>
-            <select id="format">
-              <option value="mp4">MP4（合并封装）</option>
-              <option value="hls">HLS（保留分片）</option>
-            </select>
-          </label>
-          <label>
-            <span>文件名</span>
-            <select id="naming">
-              <option value="title">页面标题</option>
-              <option value="hash">URL 短 hash</option>
-            </select>
-          </label>
-          <label class="checkbox">
-            <input id="overwrite" type="checkbox" />
-            <span>覆盖已存在的文件</span>
-          </label>
-          <label class="checkbox">
-            <input id="send-cookie" type="checkbox" />
-            <span>发送捕获到的 Cookie（用于下载）</span>
-          </label>
-          <label class="checkbox">
-            <input id="copy-cookie" type="checkbox" />
-            <span>复制 CLI 命令时包含 Cookie（敏感）</span>
-          </label>
-          <label class="checkbox">
-            <input id="insecure" type="checkbox" />
-            <span>跳过 TLS 证书校验（不安全，仅用于自签名/内网服务）</span>
-          </label>
-          <div id="remote-warning" class="warning" hidden>
-            服务地址不是本机，Cookie 会被发送到该地址，请确认其可信。
-          </div>
-          <div class="settings-actions">
-            <button id="test-connection" type="button" class="primary">
-              测试连接
-            </button>
-            <span id="settings-status" class="status"></span>
-          </div>
-        </div>
-      </details>
-    </main>
-
-    <div id="toast" class="toast" role="status" hidden></div>
-
-    <script src="lib.js"></script>
-    <script src="popup.js"></script>
-  </body>
-</html>