优化

2026-09-28 11:16:37 +08:00 · 2026-09-10 22:30:17 +08:00 · 2026-09-10 22:06:28 +08:00 · 2026-09-10 16:58:41 +08:00 · 2026-09-09 22:24:45 +08:00 · 2026-09-09 22:03:52 +08:00
692 changed files with 27224 additions and 5146 deletions
@@ -0,0 +1,16 @@
+{
+  "mcpServers": {
+    "ssh": {
+      "command": "cmd.exe",
+      "args": [
+        "/c",
+        "npx",
+        "-y",
+        "@aiondadotcom/mcp-ssh"
+      ],
+      "env": {
+        "ProgramData": "C:\\ProgramData"
+      }
+    }
+  }
+}
@@ -18,7 +18,7 @@ verify-downloads/
 .tmp_*
 .tmp-deploy-*
 .tmp-deploy-data/
-.mmtl.pid
+.mebox.pid
 *.db
 *.db-journal
 *.db-shm
@@ -1,5 +1,5 @@
 blank_issues_enabled: true
 contact_links:
-  - name: Telegram MMTL 交流群
-    url: https://t.me/MMTL
+  - name: Telegram MeBox 交流群
+    url: https://t.me/MeBox
    about: 适合快速交流部署经验、使用问题和排查线索。
@@ -12,7 +12,7 @@ assignees: ""

 ## 期望方案

-请描述你希望 MMTL 如何工作。
+请描述你希望 MeBox 如何工作。

 ## 使用场景

@@ -1,4 +1,4 @@
-name: MMTL CodeQL
+name: MeBox CodeQL

 paths-ignore:
  - internal/service/fileid_other.go
@@ -1,122 +1,78 @@
-name: AuTo Docker Image
-
+name: Build & Publish

+# 版本策略（version 分支托管，main 零污染）：
+# - VERSION 文件单独存放在 version 分支，CI 构建时读取并自增写回 version 分支，
+#   main 分支不再出现任何 CI 提交，本地推送永不与远程冲突。
+# - push 到 main：版本号自动 patch+1，发布 latest + 版本镜像、GitHub Release、
+#   多平台单文件二进制，并部署服务器。
+# - push tag v*：正式发版，版本号取 tag 名（不 bump version 分支），其余同上。
+# - 手动触发：版本号在 version 分支当前值上自增，等同 push main 全量发布。
+# 查看当前版本号：git show origin/version:VERSION
 on:
  push:
    branches: [main]
+    tags: ['v*']

-  # 保留手动触发作为备选
  workflow_dispatch:
-    inputs:
-      version_type:
-        description: '版本递增类型'
-        required: true
-        default: 'patch'
-        type: choice
-        options:
-          - patch    # 0.0.x
-          - minor    # 0.x.0
-          - major    # x.0.0

 permissions:
-  contents: write  # 需要写入权限来更新版本文件
+  contents: write  # 读写 version 分支、发布 Release 与上传二进制需要
  packages: write

 jobs:
-  version-and-publish:
+  build-image:
    runs-on: ubuntu-latest
    outputs:
-      new_version: ${{ steps.bump_version.outputs.new_version }}
-      tag: ${{ steps.bump_version.outputs.tag }}
+      version: ${{ steps.version.outputs.version }}
+      release_tag: ${{ steps.version.outputs.release_tag }}
    steps:
      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0  # 获取完整历史以便版本计算
-          token: ${{ secrets.GITHUB_TOKEN }}

-      # 1. 获取或初始化版本号
-      - name: Get current version
-        id: get_version
+      # 1. 解析版本号：tag 触发取 tag 名（去掉 v 前缀）；其余场景读 version 分支并 patch+1
+      - name: Resolve version
+        id: version
        run: |
-          # 从文件读取版本号，或使用默认值
-          if [ -f VERSION ]; then
-            CURRENT_VERSION=$(cat VERSION)
+          if [ "${{ github.ref_type }}" = "tag" ]; then
+            VERSION="${GITHUB_REF_NAME#v}"
          else
-            CURRENT_VERSION="0.0.0"
-            echo $CURRENT_VERSION > VERSION
+            git fetch origin version
+            BASE=$(git show FETCH_HEAD:VERSION 2>/dev/null || echo "0.0.0")
+            MAJOR=$(echo "$BASE" | cut -d. -f1)
+            MINOR=$(echo "$BASE" | cut -d. -f2)
+            PATCH=$(echo "$BASE" | cut -d. -f3)
+            VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
          fi
-          echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
-          
-          # 分离版本组成部分
-          MAJOR=$(echo $CURRENT_VERSION | cut -d. -f1)
-          MINOR=$(echo $CURRENT_VERSION | cut -d. -f2)
-          PATCH=$(echo $CURRENT_VERSION | cut -d. -f3)
-          echo "major=$MAJOR" >> $GITHUB_OUTPUT
-          echo "minor=$MINOR" >> $GITHUB_OUTPUT
-          echo "patch=$PATCH" >> $GITHUB_OUTPUT
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "release_tag=mebox-v${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "new_version=${VERSION}" >> "$GITHUB_OUTPUT"

-      # 2. 计算新版本号
-      - name: Bump version
-        id: bump_version
-        run: |
-          MAJOR=${{ steps.get_version.outputs.major }}
-          MINOR=${{ steps.get_version.outputs.minor }}
-          PATCH=${{ steps.get_version.outputs.patch }}
-          
-          # 手动触发时根据选择递增
-          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            TYPE="${{ github.event.inputs.version_type }}"
-            if [ "$TYPE" = "major" ]; then
-              MAJOR=$((MAJOR + 1))
-              MINOR=0
-              PATCH=0
-            elif [ "$TYPE" = "minor" ]; then
-              MINOR=$((MINOR + 1))
-              PATCH=0
-            else  # patch
-              PATCH=$((PATCH + 1))
-            fi
-          else
-            # 自动触发时默认 patch 递增
-            PATCH=$((PATCH + 1))
-          fi
-          
-          NEW_VERSION="${MAJOR}.${MINOR}.${PATCH}"
-          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
-          echo "tag=MMTL-v${NEW_VERSION}" >> $GITHUB_OUTPUT
-          echo "tag=mmtl-v${NEW_VERSION}" >> $GITHUB_OUTPUT
-
-      # 3. 更新 VERSION 文件
-      - name: Update version file
-        run: |
-          echo "${{ steps.bump_version.outputs.new_version }}" > VERSION
-          
-          # 如果存在 go.mod，也更新其中的版本（可选）
-          # if [ -f go.mod ]; then
-          #   sed -i "s/^version .*/version ${{ steps.bump_version.outputs.new_version }}/" go.mod
-          # fi
-
-      # 4. 提交版本变更
-      - name: Commit version bump
+      # 2. 把新版本号写回 version 分支（clone 单分支写入，冲突时 rebase 重试）
+      #    tag 触发的正式发版版本号来自 tag 本身，跳过自增。
+      - name: Bump version branch
+        if: github.ref_type != 'tag'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
+          REPO="https://x-access-token:${GH_TOKEN}@github.com/${{ github.repository }}.git"
+          git clone --depth 1 --branch version "$REPO" "$RUNNER_TEMP/version-branch"
+          cd "$RUNNER_TEMP/version-branch"
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add VERSION
-          git commit -m "chore: bump version to ${{ steps.bump_version.outputs.new_version }} [skip ci]"
-          git push
+          echo "${{ steps.version.outputs.new_version }}" > VERSION
+          git commit -am "chore: bump version to ${{ steps.version.outputs.new_version }}"
+          ok=0
+          for i in 1 2 3 4 5; do
+            if git push origin version; then ok=1; break; fi
+            git pull --rebase origin version || true
+            sleep 5
+          done
+          [ "$ok" = "1" ] || { echo "::error::version 分支推送冲突，重试 5 次仍失败"; exit 1; }

-      # 5. 创建 Git Tag
-      - name: Create and push tag
-        run: |
-          TAG="${{ steps.bump_version.outputs.tag }}"
-          git tag $TAG
-          git push origin $TAG
-
-      # 6. 设置 Docker QEMU 和 Buildx
+      # 3. 设置 Docker QEMU 和 Buildx
      - uses: docker/setup-qemu-action@v3
      - uses: docker/setup-buildx-action@v3

-      # 7. 登录 GHCR
+      # 3. 登录 GHCR
      - name: Log in to GHCR
        uses: docker/login-action@v3
        with:
@@ -124,18 +80,17 @@ jobs:
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

-      # 8. 提取镜像元数据
+      # 4. 提取镜像元数据
      - name: Extract image metadata
        id: meta
        uses: docker/metadata-action@v5
        with:
-          images: ghcr.io/${{ github.repository_owner }}/mmtl
+          images: ghcr.io/${{ github.repository_owner }}/mebox
          tags: |
            type=raw,value=latest
-            type=raw,value=${{ steps.bump_version.outputs.tag }}
-            type=raw,value=${{ steps.bump_version.outputs.new_version }}
+            type=raw,value=${{ steps.version.outputs.version }}

-      # 9. 构建并推送
+      # 5. 构建并推送
      - name: Build & push
        uses: docker/build-push-action@v6
        with:
@@ -147,13 +102,14 @@ jobs:
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          build-args: |
-            VERSION=${{ steps.bump_version.outputs.new_version }}
+            VERSION=${{ steps.version.outputs.release_tag }}
          cache-from: type=gha
          cache-to: type=gha,mode=max

  # 单文件可执行构建：把前端打包进二进制（go:embed），交叉编译 Windows /
  # Linux / macOS 的 amd64 / arm64 产物，作为 GitHub Release 附件发布。
  build-frontend:
+    needs: [build-image]
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
@@ -178,7 +134,7 @@ jobs:
  # 先创建（幂等）空的 GitHub Release，供后续 build-binaries 并行上传附件，
  # 也避免矩阵各 job 并发 upload 时 release 尚不存在而互相竞争。
  publish-create-release:
-    needs: [version-and-publish]
+    needs: [build-image]
    runs-on: ubuntu-latest
    permissions:
      contents: write
@@ -187,17 +143,21 @@ jobs:
      - name: Create release
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          RELEASE_TAG: ${{ needs.version-and-publish.outputs.tag }}
+          RELEASE_TAG: ${{ needs.build-image.outputs.release_tag }}
        run: |
          set -eux
-          # tag 已由 version-and-publish 推送；若 release 已存在则忽略（--verify-tag 幂等）
+          # tag push 时 tag 已存在；手动触发时基于当前 main 创建 tag（幂等）
+          if ! git rev-parse "$RELEASE_TAG" >/dev/null 2>&1; then
+            git tag "$RELEASE_TAG"
+            git push origin "$RELEASE_TAG"
+          fi
          gh release create "$RELEASE_TAG" \
-            --title "MMTL ${{ needs.version-and-publish.outputs.new_version }}" \
-            --notes "自动化发布 ${{ needs.version-and-publish.outputs.new_version }}" \
+            --title "MeBox ${{ needs.build-image.outputs.version }}" \
+            --notes "自动化发布 ${{ needs.build-image.outputs.version }}" \
            --verify-tag --latest || true

  build-binaries:
-    needs: [version-and-publish, build-frontend, publish-create-release]
+    needs: [build-image, build-frontend, publish-create-release]
    runs-on: ubuntu-latest
    permissions:
      contents: write
@@ -237,26 +197,26 @@ jobs:
      - name: Build binary
        run: |
          CGO_ENABLED=0 GOOS=${{ matrix.goos }} GOARCH=${{ matrix.goarch }} \
-            go build -trimpath -ldflags="-s -w -X main.version=${{ needs.version-and-publish.outputs.tag }}" \
-            -o "dist/mmtl-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.ext }}" ./cmd/server
+            go build -trimpath -ldflags="-s -w -X main.version=${{ needs.build-image.outputs.release_tag }}" \
+            -o "dist/mebox-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.ext }}" ./cmd/server
      - name: Package
        run: |
-          mkdir -p package/mmtl
-          cp "dist/mmtl-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.ext }}" package/mmtl/mmtl${{ matrix.ext }}
-          cp README.md package/mmtl/ 2>/dev/null || true
+          mkdir -p package/mebox
+          cp "dist/mebox-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.ext }}" package/mebox/mebox${{ matrix.ext }}
+          cp README.md package/mebox/ 2>/dev/null || true
          if [ "${{ matrix.goos }}" = "windows" ]; then
-            (cd package && zip -r "../mmtl_${{ matrix.goos }}_${{ matrix.goarch }}.zip" mmtl)
+            (cd package && zip -r "../mebox_${{ matrix.goos }}_${{ matrix.goarch }}.zip" mebox)
          else
-            tar -czf "mmtl_${{ matrix.goos }}_${{ matrix.goarch }}.tar.gz" -C package mmtl
+            tar -czf "mebox_${{ matrix.goos }}_${{ matrix.goarch }}.tar.gz" -C package mebox
          fi
      - name: Upload to GitHub Release
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          RELEASE_TAG: ${{ needs.version-and-publish.outputs.tag }}
+          RELEASE_TAG: ${{ needs.build-image.outputs.release_tag }}
        run: |
          set -eux
-          PKG="mmtl_${{ matrix.goos }}_${{ matrix.goarch }}.zip"
-          TAR="mmtl_${{ matrix.goos }}_${{ matrix.goarch }}.tar.gz"
+          PKG="mebox_${{ matrix.goos }}_${{ matrix.goarch }}.zip"
+          TAR="mebox_${{ matrix.goos }}_${{ matrix.goarch }}.tar.gz"
          # 并发上传到同一 release 各自文件，--clobber 幂等覆盖
          if [ -f "$PKG" ]; then
            for i in 1 2 3; do gh release upload "$RELEASE_TAG" "$PKG" --clobber && break || sleep 5; done
@@ -264,3 +224,41 @@ jobs:
          if [ -f "$TAR" ]; then
            for i in 1 2 3; do gh release upload "$RELEASE_TAG" "$TAR" --clobber && break || sleep 5; done
          fi
+
+  deploy:
+    name: Deploy to Server
+    needs: [build-image]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USER }}
+          password: ${{ secrets.SERVER_PASSWORD }}
+          port: ${{ secrets.SERVER_PORT }}
+          script: |
+            set -e
+            echo "==== 开始部署 MeBox ===="
+            cd /root/dockerData/mebox
+
+            # 判断 compose 命令版本兼容性（docker compose 或 docker-compose）
+            if docker compose version >/dev/null 2>&1; then
+              COMPOSE_CMD="docker compose"
+            elif command -v docker-compose >/dev/null 2>&1; then
+              COMPOSE_CMD="docker-compose"
+            else
+              echo "错误: 未找到 docker compose 或 docker-compose"
+              exit 1
+            fi
+
+            echo "正在拉取最新镜像..."
+            $COMPOSE_CMD pull
+
+            echo "正在重启服务..."
+            $COMPOSE_CMD up -d
+
+            echo "清理旧的无用镜像..."
+            docker image prune -f
+
+            echo "==== 部署完成并已启动 ===="
@@ -4,7 +4,7 @@
 # 产出：
 #   1. 前端 + 后端编译验证（go vet / go test / go build）
 #   2. 多平台可执行二进制 artifact（linux/amd64、linux/arm64、windows/amd64）
-#   3. ghcr.io/{owner}/mmtl:beta 多架构 Docker 镜像（linux/amd64 + linux/arm64）
+#   3. ghcr.io/{owner}/mebox:beta 多架构 Docker 镜像（linux/amd64 + linux/arm64）
 #
 # 与 main 分支的发布流（Auto-docker-publish.yml）隔离：beta 不做版本递增、
 # 不打 release tag，只构建带 -beta 标识的产物供测试。
@@ -73,21 +73,21 @@ jobs:

      # 多平台可执行文件（嵌入刚构建的 web/dist）
      - name: Build linux/amd64
-        run: CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${{ steps.version.outputs.full_version }}" -o dist/mmtl-beta-linux-amd64 ./cmd/server
+        run: CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${{ steps.version.outputs.full_version }}" -o dist/mebox-beta-linux-amd64 ./cmd/server
      - name: Build linux/arm64
-        run: CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -ldflags="-s -w -X main.version=${{ steps.version.outputs.full_version }}" -o dist/mmtl-beta-linux-arm64 ./cmd/server
+        run: CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -ldflags="-s -w -X main.version=${{ steps.version.outputs.full_version }}" -o dist/mebox-beta-linux-arm64 ./cmd/server
      - name: Build windows/amd64
-        run: CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${{ steps.version.outputs.full_version }}" -o dist/mmtl-beta-windows-amd64.exe ./cmd/server
+        run: CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${{ steps.version.outputs.full_version }}" -o dist/mebox-beta-windows-amd64.exe ./cmd/server

      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
-          name: mmtl-beta-binaries
+          name: mebox-beta-binaries
          path: dist/*
          if-no-files-found: error

  # ─────────────────────────────────────────────────────────────────────────────
-  # 2) Beta Docker 镜像（ghcr.io/{owner}/mmtl:beta）
+  # 2) Beta Docker 镜像（ghcr.io/{owner}/mebox:beta）
  # ─────────────────────────────────────────────────────────────────────────────
  docker-beta:
    name: Build & push beta Docker image
@@ -123,7 +123,7 @@ jobs:
          push: true
          provenance: false
          sbom: false
-          tags: ghcr.io/${{ github.repository_owner }}/mmtl:beta
+          tags: ghcr.io/${{ github.repository_owner }}/mebox:beta
          labels: |
            org.opencontainers.image.revision=${{ github.sha }}
            org.opencontainers.image.source=${{ github.repository }}
@@ -4,7 +4,7 @@ on:
  workflow_dispatch:
    inputs:
      version:
-        description: 'Image tag to publish, for example MMTL-v0.0.32'
+        description: 'Image tag to publish, for example MeBox-v0.0.32'
        required: true
        type: string
      ref:
@@ -42,7 +42,7 @@ jobs:
        uses: docker/metadata-action@v5
        with:
          # 自动使用当前仓库所有者
-          images: ghcr.io/${{ github.repository_owner }}/mmtl
+          images: ghcr.io/${{ github.repository_owner }}/mebox
          tags: |
            type=raw,value=latest
            type=raw,value=${{ env.RELEASE_VERSION }}
@@ -61,3 +61,41 @@ jobs:
            VERSION=${{ env.RELEASE_VERSION }}
          cache-from: type=gha
          cache-to: type=gha,mode=max
+
+  deploy:
+    name: Deploy to Server
+    needs: [docker]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USER }}
+          password: ${{ secrets.SERVER_PASSWORD }}
+          port: ${{ secrets.SERVER_PORT }}
+          script: |
+            set -e
+            echo "==== 开始部署 MeBox ===="
+            cd /root/dockerData/mebox
+
+            if docker compose version >/dev/null 2>&1; then
+              COMPOSE_CMD="docker compose"
+            elif command -v docker-compose >/dev/null 2>&1; then
+              COMPOSE_CMD="docker-compose"
+            else
+              echo "错误: 未找到 docker compose 或 docker-compose"
+              exit 1
+            fi
+
+            echo "正在拉取最新镜像..."
+            $COMPOSE_CMD pull
+
+            echo "正在重启服务..."
+            $COMPOSE_CMD up -d
+
+            echo "清理旧的无用镜像..."
+            docker image prune -f
+
+            echo "==== 部署完成并已启动 ===="
+
@@ -32,7 +32,7 @@ logs/
 .tmp-deploy-cache/
 .tmp-deploy-server.*
 .tmp-live-server.*
-.mmtl.pid
+.mebox.pid
 *.log
 *.db
 *.db-journal
@@ -0,0 +1,96 @@
+## 删除用户云下载任务
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 删除用户云下载任务                  |
+| 接口版本      | v1.0                              |
+| 接口路径      | /del_task                         |
+| 请求方法      | POST                              |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+删除当前授权用户的指定云下载任务，可选择同时删除对应源文件。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/del_task
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名          | 类型   | 必填 | 默认值 | 说明                       | 约束/示例    |
+|:----------------|:-------|:-----|:-------|:---------------------------|:-------------|
+| info_hash       | string | 是   | -      | 需删除的任务Hash            | `<info_hash>` |
+| del_source_file | int    | 否   | 0      | 是否删除源文件，1=删除 0=不删除 | 0            |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/offline/del_task' \
+  -H 'Authorization: Bearer <access_token>' \
+  --form-string 'info_hash=<info_hash>' \
+  --form-string 'del_source_file=0'
+```
+
+### 响应字段说明
+
+| 字段    | 类型    | 描述                  |
+|:--------|:--------|:----------------------|
+| state   | boolean | 操作结果状态            |
+| message | string  | 返回信息               |
+| code    | int     | 错误码                 |
+| data    | object[] | 返回数据，成功时为空数组  |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码 | 说明     | 解决方案                 |
+|:-------|:---------|:-------------------------|
+| 990002 | 参数错误 | 检查 `info_hash` 参数     |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 业务规则
+
+- 未传 `del_source_file` 时默认不删除源文件。
+- `del_source_file=1` 会删除任务对应的源文件，操作前需确认影响范围。
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+
+### 注意事项
+
+- 删除结果以响应中的 `state`、`code` 和 `message` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,111 @@
+## 添加云下载BT任务
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 添加云下载BT任务                   |
+| 接口版本      | v1.0                              |
+| 接口路径      | /add_task_bt                      |
+| 请求方法      | POST                              |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+根据已解析的BT种子信息添加云下载BT任务。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/add_task_bt
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型   | 必填 | 默认值 | 说明                              | 约束/示例        |
+|:-------------|:-------|:-----|:-------|:----------------------------------|:----------------|
+| info_hash    | string | 是   | -      | BT任务Hash                        | `<info_hash>`    |
+| wanted       | string | 是   | -      | 选中下载的文件索引，使用半角逗号分隔 | `<file_indexes>` |
+| save_path    | string | 是   | -      | BT任务文件保存路径                 | `A/B`           |
+| torrent_sha1 | string | 是   | -      | BT种子SHA1                        | `<torrent_sha1>` |
+| pick_code    | string | 是   | -      | BT种子文件提取码                   | `<pick_code>`    |
+| wp_path_id   | string | 否   | 0      | 保存目标文件夹ID                   | 0               |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/offline/add_task_bt' \
+  -H 'Authorization: Bearer <access_token>' \
+  --form-string 'info_hash=<info_hash>' \
+  --form-string 'wanted=<file_indexes>' \
+  --form-string 'save_path=A/B' \
+  --form-string 'torrent_sha1=<torrent_sha1>' \
+  --form-string 'pick_code=<pick_code>' \
+  --form-string 'wp_path_id=0'
+```
+
+### 响应字段说明
+
+| 字段    | 类型    | 描述                  |
+|:--------|:--------|:----------------------|
+| state   | boolean | 操作结果状态            |
+| message | string  | 返回信息               |
+| code    | int     | 错误码                 |
+| data    | object[] | 返回数据，成功时为空数组  |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码  | 说明                 | 解决方案                       |
+|:--------|:---------------------|:-------------------------------|
+| 20018   | 文件不存在或已删除     | 检查提取码、文件归属和种子SHA1  |
+| 91006   | 存储空间不足          | 扩充存储空间后重试              |
+| 990002  | 参数错误              | 检查必填参数                    |
+| 1000012 | 云下载配额已用完       | 购买配额或获得更多配额后重试     |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 业务规则
+
+- `wanted` 可以为 `0`，但不能是空字符串。
+- 种子文件需属于当前授权用户、位于指定存储区域，并且文件SHA1与 `torrent_sha1` 一致。
+- 不传 `wp_path_id` 时默认保存到根目录；`save_path` 是相对于 `wp_path_id` 所在文件夹的路径。例如，`wp_path_id` 不传或传云下载文件夹ID且 `save_path=A/B` 时，最终路径为根目录下的 `A/B/`。
+- 添加任务前会检查当前授权账号的剩余存储空间；空间不足时不扣减云下载配额。
+- 云下载服务返回状态码 `10007` 或 `10010` 时，接口统一返回错误码 `1000012`。
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+- 种子文件必须属于当前授权账号，并且文件SHA1与 `torrent_sha1` 一致。
+
+### 注意事项
+
+- 任务处理结果以响应中的 `data` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,115 @@
+## 添加云下载链接任务
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 添加云下载链接任务                  |
+| 接口版本      | v1.0                              |
+| 接口路径      | /add_task_urls                    |
+| 请求方法      | POST                              |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+批量添加云下载链接任务。多个链接使用换行符分隔，支持HTTP(S)、FTP、磁力链和电驴链接。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/add_task_urls
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名     | 类型   | 必填 | 默认值 | 说明                                    | 约束/示例       |
+|:-----------|:-------|:-----|:-------|:----------------------------------------|:----------------|
+| urls       | string | 是   | -      | 云下载链接，多个链接使用换行符分隔          | `<download_url>` |
+| wp_path_id | string | 否   | 0      | 保存目标文件夹ID；不传或传0时保存到根目录   | 0               |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/offline/add_task_urls' \
+  -H 'Authorization: Bearer <access_token>' \
+  --form-string 'urls=<download_url>' \
+  --form-string 'wp_path_id=0'
+```
+
+### 响应字段说明
+
+| 字段             | 类型     | 描述                           |
+|:-----------------|:---------|:-------------------------------|
+| state            | boolean  | 操作结果状态                     |
+| message          | string   | 返回信息                        |
+| code             | int      | 错误码                          |
+| data             | object[] | 各链接任务的添加结果              |
+| data[].state     | boolean  | 链接任务添加状态                  |
+| data[].code      | int      | 链接任务状态码                    |
+| data[].message   | string   | 链接任务状态描述                  |
+| data[].info_hash | string   | 链接任务SHA1，仅任务成功时返回      |
+| data[].url       | string   | 链接任务URL                      |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码  | 说明                       | 解决方案                     |
+|:--------|:---------------------------|:-----------------------------|
+| 91006   | 存储空间不足                | 扩充存储空间后重试             |
+| 980004  | 操作失败                   | 稍后重试                     |
+| 990002  | 参数错误                   | 检查必填参数                 |
+| 1000011 | 链接数量超过115个           | 将链接拆分为每批不超过115个     |
+| 1000012 | 云下载配额已用完            | 购买配额或获得更多配额后重试    |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": [
+    {
+      "state": true,
+      "code": 0,
+      "message": "",
+      "info_hash": "",
+      "url": ""
+    }
+  ]
+}
+```
+
+### 业务规则
+
+- 服务端按换行符拆分并清理链接，单次最多提交115个链接。
+- 添加任务前会检查当前授权账号的剩余存储空间；空间不足时不扣减云下载配额。
+- 云下载服务返回状态码 `10007` 或 `10010` 时，接口统一返回错误码 `1000012`。
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+- 本接口限制单批链接数量，避免不受控的批量请求。
+
+### 注意事项
+
+- 任务处理结果以响应中的 `data` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,104 @@
+## 清空云下载任务
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 清空云下载任务                     |
+| 接口版本      | v1.0                              |
+| 接口路径      | /clear_task                       |
+| 请求方法      | POST                              |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+按指定类型清空当前授权用户的云下载任务。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/clear_task
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明                   | 约束/示例 |
+|:-------|:-----|:-----|:-------|:-----------------------|:----------|
+| flag   | int  | 是   | -      | 清空任务类型，见下方枚举表格 | 1         |
+
+#### 请求参数中的 flag 参数枚举
+
+| 值 | 说明                         | 备注 |
+|:---|:-----------------------------|:-----|
+| 0  | 清空已完成任务               | -    |
+| 1  | 清空全部任务                 | -    |
+| 2  | 清空失败任务                 | -    |
+| 3  | 清空进行中任务               | -    |
+| 4  | 清空已完成任务并删除对应源文件 | -    |
+| 5  | 清空全部任务并删除对应源文件   | -    |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/offline/clear_task' \
+  -H 'Authorization: Bearer <access_token>' \
+  --form-string 'flag=1'
+```
+
+### 响应字段说明
+
+| 字段    | 类型    | 描述             |
+|:--------|:--------|:-----------------|
+| state   | boolean | 操作结果状态       |
+| message | string  | 返回信息          |
+| code    | int     | 错误码            |
+| data    | object[] | 返回数据，成功时为空数组 |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码 | 说明     | 解决方案                  |
+|:-------|:---------|:--------------------------|
+| 990002 | 参数错误 | 检查 `flag` 是否为0至5的整数 |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 业务规则
+
+- `flag=4` 或 `flag=5` 会同时删除对应源文件，操作前需确认清理范围。
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+
+### 注意事项
+
+- 清空结果以响应中的 `state`、`code` 和 `message` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,101 @@
+## 获取云下载配额信息
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 获取云下载配额信息                  |
+| 接口版本      | v1.0                              |
+| 接口路径      | /get_quota_info                   |
+| 请求方法      | GET                               |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+获取当前授权用户各类云下载配额的使用情况和过期明细。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/get_quota_info
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+无。
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/offline/get_quota_info' \
+  -H 'Authorization: Bearer <access_token>'
+```
+
+### 响应字段说明
+
+| 字段                                        | 类型     | 描述                 |
+|:--------------------------------------------|:---------|:---------------------|
+| state                                       | boolean  | 状态，true表示成功     |
+| message                                     | string   | 返回信息              |
+| code                                        | int      | 错误码                |
+| data                                        | object   | 云下载配额数据         |
+| data.package                                | object[] | 配额类型列表           |
+| data.package[].surplus                      | int      | 该类型剩余配额         |
+| data.package[].used                         | int      | 该类型已用配额         |
+| data.package[].count                        | int      | 该类型总配额           |
+| data.package[].name                         | string   | 该类型配额名称         |
+| data.package[].expire_info                  | object[] | 该类型配额过期明细      |
+| data.package[].expire_info[].surplus        | int      | 明细项剩余配额         |
+| data.package[].expire_info[].expire_time    | int      | 明细项过期时间         |
+| data.count                                  | int      | 用户总配额数量         |
+| data.surplus                                | int      | 用户总剩余配额数量      |
+| data.used                                   | int      | 用户总已用配额数量      |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码 | 说明     | 解决方案     |
+|:-------|:---------|:-------------|
+| 990002 | 参数错误 | 检查授权信息 |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "package": [],
+    "count": 0,
+    "surplus": 0,
+    "used": 0
+  }
+}
+```
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+
+### 注意事项
+
+- 云下载配额以响应中的 `data` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,136 @@
+## 获取用户云下载任务列表
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 获取用户云下载任务列表              |
+| 接口版本      | v1.0                              |
+| 接口路径      | /get_task_list                    |
+| 请求方法      | GET                               |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+分页获取当前授权用户的云下载任务列表。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/get_task_list
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明     | 约束/示例 |
+|:-------|:-----|:-----|:-------|:---------|:----------|
+| page   | int  | 否   | 1      | 页码     | 1         |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/offline/get_task_list' \
+  -H 'Authorization: Bearer <access_token>' \
+  --data-urlencode 'page=1'
+```
+
+### 响应字段说明
+
+| 字段                        | 类型     | 描述                                  |
+|:----------------------------|:---------|:--------------------------------------|
+| state                       | boolean  | 状态，true表示成功                      |
+| message                     | string   | 返回信息                               |
+| code                        | int      | 错误码                                 |
+| data                        | object   | 分页任务数据                            |
+| data.page                   | int      | 当前页码                               |
+| data.page_count             | int      | 总页数                                 |
+| data.count                  | int      | 任务总数                               |
+| data.tasks                  | object[] | 云下载任务列表                          |
+| data.tasks[].info_hash      | string   | 任务SHA1                               |
+| data.tasks[].add_time       | int      | 任务添加时间戳                          |
+| data.tasks[].percentDone    | int      | 任务下载进度                            |
+| data.tasks[].size           | int      | 任务总大小，单位为字节                   |
+| data.tasks[].name           | string   | 任务名称                               |
+| data.tasks[].last_update    | int      | 任务最后更新时间戳                       |
+| data.tasks[].file_id        | string   | 任务源文件或文件夹ID                     |
+| data.tasks[].delete_file_id | string   | 删除任务并删除源文件时需传递的文件或文件夹ID |
+| data.tasks[].status         | int      | 任务状态，见下方枚举表格                  |
+| data.tasks[].url            | string   | 链接任务URL                            |
+| data.tasks[].wp_path_id     | string   | 任务源文件所在父文件夹ID                  |
+| data.tasks[].def2           | int      | 视频清晰度，见下方枚举表格                |
+| data.tasks[].play_long      | int      | 视频时长                               |
+| data.tasks[].can_appeal     | int      | 是否可以申诉                            |
+
+#### 响应的 data.tasks[].status 字段枚举
+
+| 值 | 说明     | 备注 |
+|:---|:---------|:-----|
+| -1 | 下载失败 | -    |
+| 0  | 分配中   | -    |
+| 1  | 下载中   | -    |
+| 2  | 下载成功 | -    |
+
+#### 响应的 data.tasks[].def2 字段枚举
+
+| 值  | 说明  | 备注 |
+|:----|:------|:-----|
+| 1   | 标清  | -    |
+| 2   | 高清  | -    |
+| 3   | 超清  | -    |
+| 4   | 1080P | -    |
+| 5   | 4K    | -    |
+| 100 | 原画  | -    |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码 | 说明     | 解决方案       |
+|:-------|:---------|:---------------|
+| 990002 | 参数错误 | 检查授权信息   |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "page": 1,
+    "page_count": 0,
+    "count": 0,
+    "tasks": []
+  }
+}
+```
+
+### 业务规则
+
+- 未传 `page` 或参数值为空时，默认查询第1页。
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+- 任务列表按 `page` 分页，实际返回数量以响应为准。
+
+### 注意事项
+
+- 云下载任务状态和字段以响应中的 `data` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,118 @@
+## 解析BT种子
+
+### 基本信息
+
+| 属性          | 内容                              |
+|:-------------|:----------------------------------|
+| 接口名称      | 解析BT种子                         |
+| 接口版本      | v1.0                              |
+| 接口路径      | /torrent                          |
+| 请求方法      | POST                              |
+| 接口状态      | 生产环境                           |
+
+### 接口说明
+
+解析已上传的BT种子文件，返回种子任务信息和文件列表。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/offline/torrent
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型   | 必填 | 默认值 | 说明           | 约束/示例        |
+|:-------------|:-------|:-----|:-------|:---------------|:----------------|
+| torrent_sha1 | string | 是   | -      | BT种子文件SHA1 | `<torrent_sha1>` |
+| pick_code    | string | 是   | -      | BT种子文件提取码 | `<pick_code>`    |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/offline/torrent' \
+  -H 'Authorization: Bearer <access_token>' \
+  --form-string 'torrent_sha1=<torrent_sha1>' \
+  --form-string 'pick_code=<pick_code>'
+```
+
+### 响应字段说明
+
+| 字段                           | 类型     | 描述                 |
+|:-------------------------------|:---------|:---------------------|
+| state                          | boolean  | 状态，true表示成功     |
+| message                        | string   | 返回信息              |
+| code                           | int      | 错误码                |
+| data                           | object   | 种子解析结果           |
+| data.file_size                 | int      | 任务大小              |
+| data.torrent_name              | string   | 任务名称              |
+| data.file_count                | int      | 文件数量              |
+| data.info_hash                 | string   | 任务SHA1              |
+| data.torrent_filelist          | object[] | 文件列表              |
+| data.torrent_filelist[].size   | int      | 文件大小              |
+| data.torrent_filelist[].path   | string   | 文件路径              |
+| data.torrent_filelist[].wanted | int      | 文件是否默认选中       |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码 | 说明                 | 解决方案                         |
+|:-------|:---------------------|:---------------------------------|
+| 20018  | 文件不存在或已删除     | 检查提取码、文件归属和种子SHA1    |
+| 990002 | 参数错误             | 检查必填参数                     |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "file_size": 0,
+    "torrent_name": "",
+    "file_count": 0,
+    "info_hash": "",
+    "torrent_filelist": [
+      {
+        "size": 0,
+        "path": "",
+        "wanted": 0
+      }
+    ]
+  }
+}
+```
+
+### 业务规则
+
+- 种子文件需属于当前授权用户、位于指定存储区域，并且文件SHA1与 `torrent_sha1` 一致。
+- 现有开放平台文档建议先将种子文件上传至“云下载/种子文件”文件夹，但该目录不是硬性要求。
+
+### 性能与安全说明
+
+- 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
+- 接口按应用、用户和接口维度执行频率限制。
+- 种子文件必须属于当前授权账号，并且文件SHA1与 `torrent_sha1` 一致。
+
+### 注意事项
+
+- 种子解析结果以响应中的 `data` 字段为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,172 @@
+## 开发者商业价值转化：推广产品得收益
+
+### 基本信息
+
+| 属性     | 内容                  |
+|:-------|:--------------------|
+| 文档名称   | 开发者商业价值转化：推广产品得收益 |
+| 文档版本   | v1.0                |
+
+## 一、简介
+
+为帮助开发者实现商业价值转化，115生活开放平台推出“推广产品得收益”计划，通过“推广有奖、收益共享”的方式，与开发者共同构建可持续发展的开放生态。
+
+开发者接入标准化服务接口后，可以在用户需要升级使用权限、扩充长期存储空间或增加云下载配额时，引导用户购买对应的 115 增值服务，并基于用户实际购买的产品获取相应推广收益。
+
+## 二、服务形式说明
+
+### 1. 标准化服务接口
+
+标准化服务接口覆盖以下核心场景。
+
+#### 1.1. VIP 服务
+
+适用于用户对应功能使用权限不足的场景：
+
+- 视频播放权限升级：解决非 VIP 用户不支持在线预览视频、年费VIP以下用户不支持视频 4K 超轻转码等权限限制。
+- 大文件上传权限升级：解决月费VIP以下用户不支持上传 115GB 大文件等权限限制。
+
+开发者可以引导用户升级至更高的 VIP 类型，以获取对应使用权限。
+
+#### 1.2. 长期存储空间扩容服务
+
+适用于用户存储空间不足的场景，可解决因空间容量不足导致文件上传、复制及添加云下载失败等问题。
+
+开发者可以引导用户购买 VIP 服务以获取更多长期存储空间，或单独购买长期存储空间进行扩容。
+
+#### 1.3. 云下载配额
+
+适用于用户云下载配额不足的场景，可解决因服务配额不足导致添加云下载失败等问题。
+
+开发者可以引导用户升级至更高的 VIP 类型以获取更多云下载配额，或单独购买云下载配额。
+
+### 2. 收益获取模式
+
+用户通过开发者应用进入购买页面并成功购买以下任一服务产品后，开发者可以获得对应推广收益：
+
+- 115生活 VIP 服务，包括月费VIP、年费VIP等。
+- 长期存储空间扩容。
+- 云下载配额。
+
+VIP 服务购买页面示例：
+
+![VIP服务购买页](图片/推广产品得收益/VIP服务购买页.png)
+
+长期存储空间扩容购买页面示例：
+
+![长期存储空间购买页](图片/推广产品得收益/长期存储空间购买页.png)
+
+## 三、接入流程
+
+### 1. 成为开发者
+
+已成为 115 生活开发者的用户可以直接进行接口接入；未注册的开发者，请先参考[接入流程](../接入指南/接入流程.md)完成注册。
+
+### 2. 接口接入
+
+开发者可以调用“获取产品列表地址”接口取得购买页面地址，并在对应业务场景中引导用户访问。
+
+#### 接口信息
+
+| 属性     | 内容          |
+|:-------|:------------|
+| 接口名称   | 获取产品列表地址    |
+| 接口版本   | v1.0        |
+| 接口路径   | /vip/qr_url |
+| 请求方法   | GET         |
+| 接口状态   | 生产环境        |
+
+### 接口说明
+
+该接口用于获取 115 生活开放平台增值服务产品列表地址。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/vip/qr_url
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名                | 类型     | 必填 | 默认值  | 说明                         | 约束/示例                                                   |
+|:-------------------|:-------|:---|:-----|:---------------------------|:--------------------------------------------------------|
+| default_product_id | int    | 否  | null | 打开产品列表时默认选中的产品 ID         | 月费：`5`；年费：`1`；尝鲜 1 天：`101`；长期VIP(至尊版)：`24072401` |
+| open_device        | string | 是  | -    | 设备号                        | `DEVICE_ID_PLACEHOLDER`                                 |
+| hide_title         | int    | 否  | 0    | 是否隐藏购买页推荐人信息：0-不隐藏；1-隐藏 | `0`                                                     |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/vip/qr_url' \
+  -H 'Authorization: Bearer ACCESS_TOKEN_PLACEHOLDER' \
+  --data-urlencode 'default_product_id=1' \
+  --data-urlencode 'open_device=DEVICE_ID_PLACEHOLDER' \
+  --data-urlencode 'hide_title=0'
+```
+
+### 响应字段说明
+
+| 字段              | 类型      | 描述            |
+|:----------------|:--------|:--------------|
+| state           | boolean | 状态码，true 表示成功 |
+| message         | string  | 响应信息          |
+| code            | int     | 错误码           |
+| data            | object  | 响应数据          |
+| data.qrcode_url | string  | 开放平台产品列表地址    |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "qrcode_url": "PRODUCT_LIST_URL_PLACEHOLDER"
+  }
+}
+```
+
+### 注意事项
+
+- 接口根据 `access_token` 识别授权信息，调用方无需额外传入 115 账号和 AppID。
+- `open_device` 不能为空；未传或传入空值时，接口返回参数错误。
+- `default_product_id` 未传或为空时，服务端不指定默认产品。
+- `hide_title` 大于 0 时，服务端会将该参数传递给产品列表服务。
+- `access_token` 属于敏感凭证，不得写入公开仓库、客户端日志或公开沟通内容。
+
+### 3. 场景触发与收益
+
+完成接口接入后，开发者可以在用户使用权限不足、长期存储空间不足或云下载配额不足时触发对应引导。用户完成购买后，开发者可以获得对应推广收益。
+
+## 四、收益管理与结算
+
+### 1. 收益查看与提现
+
+开发者可以登录“115生活-生活-联盟”，或直接访问[115联盟](https://union.115.com/)，查看收益明细等推广收益情况并进行提现操作。
+
+![推广收益管理页](图片/推广产品得收益/推广收益管理页.png)
+
+### 2. 规则说明
+
+收益计算方式、结算方式和提现流程等详情，参见[联盟规则](https://union.115.com/?ac=help&i=10)。
+
+### 修改历史
+
+| 修改时间                         | 修改说明             |
+|:-----------------------------|:-----------------|
+| 2025年04月01日(周二) 00:00:00 | 创建文档             |
+| 2026年08月05日(周三) 17:30:01 | 恢复业务说明、接入流程及示例图片 |
+| 2026年08月19日(周三) 11:00:08 | 长期VIP默认产品名称改为至尊版 |
@@ -0,0 +1,79 @@
+## 删除或清空回收站
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 删除或清空回收站                        |
+| 接口版本       | v1.0                            |
+| 接口路径       | /del                            |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+批量彻底删除回收站中的文件(夹)，或在不传 `tid` 时清空回收站。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/rb/del
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名 | 类型     | 必填 | 默认值 | 说明                              | 约束/示例 |
+|:----|:-------|:---|:----|:--------------------------------|:------|
+| tid | string | 否  | ""  | 需要删除的回收站ID，多个ID用半角逗号分隔，最多 1150 个；不传时清空回收站 | 1,2,3,4 |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/rb/del' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'tid=1,2,3,4'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述            |
+|:--------|:---------|:--------------|
+| state   | boolean  | 状态码，true 表示成功 |
+| message | string   | 错误信息          |
+| code    | int      | 错误码           |
+| data    | string[] | 响应数据          |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+- 不传 `tid` 会清空当前授权用户的整个回收站，操作后无法恢复。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,80 @@
+## 删除文件
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 删除文件                            |
+| 接口版本       | v1.0                            |
+| 接口路径       | /delete                         |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+批量删除文件(夹)，删除操作异步执行并将目标移入回收站。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/delete
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明                     | 约束/示例                                      |
+|:----------|:-------|:---|:----|:-----------------------|:-------------------------------------------|
+| file_ids   | string | 是  | -   | 需要删除的文件(夹)ID，多个ID用半角逗号分隔 | 3073323042143855813,3073323042143855822 |
+| parent_id  | string | 否  | 0   | 待删除文件(夹)所在的父目录ID        | 3073311192547189943                         |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/delete' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'file_ids=3073323042143855813,3073323042143855822' \
+  --form-string 'parent_id=3073311192547189943'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述               |
+|:--------|:---------|:-----------------|
+| state   | boolean  | 状态码，true 表示请求已受理 |
+| message | string   | 错误信息             |
+| code    | int      | 错误码              |
+| data    | string[] | 响应数据             |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,126 @@
+## 回收站列表
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 回收站列表                           |
+| 接口版本       | v1.0                            |
+| 接口路径       | /list                           |
+| 请求方法       | GET                             |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+分页获取当前授权用户的回收站文件(夹)列表。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/rb/list
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名    | 类型  | 必填 | 默认值 | 说明      | 约束/示例 |
+|:-------|:----|:---|:----|:--------|:------|
+| limit  | int | 否  | 30  | 单页记录数   | 最大 200 |
+| offset | int | 否  | 0   | 数据显示偏移量 | 0     |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/rb/list' \
+  -H 'Authorization: Bearer access_token' \
+  --data-urlencode 'limit=30' \
+  --data-urlencode 'offset=0'
+```
+
+### 响应字段说明
+
+| 字段                    | 类型      | 描述                             |
+|:----------------------|:--------|:-------------------------------|
+| state                 | boolean | 状态码，true 表示成功                  |
+| message               | string  | 错误信息                           |
+| code                  | int     | 错误码                            |
+| data                  | object  | 响应数据                           |
+| data.offset           | int     | 数据显示偏移量                        |
+| data.limit            | int     | 单页记录数                          |
+| data.count            | string  | 回收站文件(夹)总数                     |
+| data.rb_pass          | int     | 是否设置回收站密码：1-是，0-否              |
+| data.{回收站ID}          | object  | 以回收站ID为键的文件(夹)信息                |
+| data.{回收站ID}.id       | string  | 回收站ID                          |
+| data.{回收站ID}.file_name | string  | 文件(夹)名称                        |
+| data.{回收站ID}.type     | string  | 类型：1-文件，2-文件夹                  |
+| data.{回收站ID}.file_size | string  | 文件大小，单位为字节                     |
+| data.{回收站ID}.dtime    | string  | 删除时间                           |
+| data.{回收站ID}.thumb_url | string  | 缩略图地址                          |
+| data.{回收站ID}.status   | string  | 还原状态：-1-还原中，0-正常                |
+| data.{回收站ID}.cid      | int     | 原文件(夹)的父目录ID                   |
+| data.{回收站ID}.parent_name | string  | 原文件(夹)的父目录名称                   |
+| data.{回收站ID}.pick_code | string  | 文件提取码                          |
+| data.{回收站ID}.isv      | int     | 是否为视频文件，按文件类型返回               |
+| data.{回收站ID}.def2     | int     | 视频清晰度，按文件类型返回                 |
+| data.{回收站ID}.ico      | string  | 文件扩展名，按文件类型返回                 |
+| data.{回收站ID}.muc      | string  | 音频封面地址，按文件类型返回                |
+| data.{回收站ID}.d_img    | string  | 文档缩略图地址，按文件类型返回               |
+| data.{回收站ID}.play_long | int     | 音视频时长，按文件类型返回                 |
+| data.{回收站ID}.sha1     | string  | 文件 SHA1 值，按文件类型返回              |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "offset": 0,
+    "limit": 30,
+    "count": "0",
+    "rb_pass": 0,
+    "3074054555277845747": {
+      "id": "3074054555277845747",
+      "file_name": "",
+      "type": "1",
+      "file_size": "0",
+      "dtime": "",
+      "thumb_url": "",
+      "status": "0",
+      "cid": 0,
+      "parent_name": "",
+      "pick_code": "",
+      "isv": 0,
+      "def2": 0,
+      "ico": "",
+      "muc": "",
+      "d_img": "",
+      "play_long": 0,
+      "sha1": ""
+    }
+  }
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
+| 2026年08月05日(周三) 17:15:28 | 补充单页记录数上限 |
@@ -0,0 +1,78 @@
+## 回收站还原
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 回收站还原                           |
+| 接口版本       | v1.0                            |
+| 接口路径       | /revert                         |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+批量还原回收站中的文件(夹)。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/rb/revert
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名 | 类型     | 必填 | 默认值 | 说明                         | 约束/示例         |
+|:----|:-------|:---|:----|:---------------------------|:--------------|
+| tid | string | 是  | -   | 需要还原的回收站ID，多个ID用半角逗号分隔，最多 1150 个 | 111,222,333,444 |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/rb/revert' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'tid=111,222,333,444'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述            |
+|:--------|:---------|:--------------|
+| state   | boolean  | 状态码，true 表示成功 |
+| message | string   | 错误信息          |
+| code    | int      | 错误码           |
+| data    | string[] | 响应数据          |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,87 @@
+## 文件(夹)更新
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 文件(夹)更新                         |
+| 接口版本       | v1.0                            |
+| 接口路径       | /update                         |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+更新文件(夹)名称或星标状态。`file_name` 与 `star` 至少传入一个。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/update
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型     | 必填 | 默认值 | 说明                    | 约束/示例             |
+|:---------|:-------|:---|:----|:----------------------|:------------------|
+| file_id   | string | 是  | -   | 需要更新的文件(夹)ID           | 3073323042143855813 |
+| file_name | string | 否  | null | 新的文件(夹)名称，文件夹名称限制 255 字节 | 新的名字              |
+| star      | int    | 否  | null | 是否星标：1-星标，0-取消星标       | 1                 |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/update' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'file_id=3073323042143855813' \
+  --form-string 'file_name=新的名字' \
+  --form-string 'star=1'
+```
+
+### 响应字段说明
+
+| 字段             | 类型      | 描述                |
+|:---------------|:--------|:------------------|
+| state          | boolean | 状态码，true 表示成功     |
+| message        | string  | 错误信息              |
+| code           | int     | 错误码               |
+| data           | object  | 响应数据              |
+| data.file_name | string  | 更新后的文件(夹)名称       |
+| data.star      | int     | 更新后的星标状态：1-星标，0-取消星标 |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "file_name": "新的名字",
+    "star": 1
+  }
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,41 @@
+# 上传流程
+
+### 基本信息
+
+| 属性       | 内容                            |
+|:---------|:------------------------------|
+| 文档名称     | 上传流程                         |
+| 文档版本     | v1.0                          |
+| 适用场景     | 115开放平台文件上传                |
+
+### 文档说明
+
+本文档说明 115 开放平台的文件秒传、普通上传和断点续传流程。
+
+## 流程概览
+
+1. 请求「文件上传」接口初始化上传。
+2. 若响应中 `status=2`，表示秒传成功，上传流程结束。
+3. 若响应提示需要二次认证，按 `sign_check` 指定的字节范围计算大写 SHA1，然后携带 `sign_key` 和 `sign_val` 重新请求「文件上传」接口。
+4. 若 `status=1`，携带初始化响应中的 `bucket`、`object`、`callback` 及「获取上传凭证」接口返回的凭证，向对象存储上传文件。
+5. 需要续传时，携带初始化响应中的 `pick_code` 及待上传文件信息请求「断点续传」接口，获取新的对象存储上传参数。
+6. 对象存储返回上传成功后，普通上传或断点续传完成。
+
+## 相关接口
+
+- [文件上传](文件上传.md)
+- [获取上传凭证](获取上传凭证.md)
+- [断点续传](断点续传.md)
+- [阿里云 OSS 上传文件说明](https://help.aliyun.com/zh/oss/user-guide/upload-objects-to-oss/)
+
+## 注意事项
+
+- 对象存储上传不请求 `proapi.115.com`，应使用「获取上传凭证」和上传调度接口返回的域名、对象标识、临时凭证与回调参数发起请求。
+- `sign_check` 的起止字节均在 SHA1 计算范围内。例如 `0-99` 表示计算共 100 字节的内容。
+- 调用开放平台接口时必须携带 `Authorization: Bearer access_token`，并妥善保管临时上传凭证。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,141 @@
+## 文件上传
+
+### 基本信息
+
+| 属性       | 内容                            |
+|:---------|:------------------------------|
+| 接口名称     | 文件上传                         |
+| 接口版本     | v1.0                          |
+| 接口路径     | /upload/init                  |
+| 请求方法     | POST                          |
+| 接口状态     | 生产环境                          |
+
+### 接口说明
+
+初始化断点续传调度，完成秒传判定、二次认证调度或返回对象存储上传参数。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/upload/init
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型   | 必填 | 默认值 | 说明                         | 约束/示例               |
+|:----------|:-----|:---|:----|:---------------------------|:--------------------|
+| file_name | string | 是  | -   | 文件名                        | 图片.jpg              |
+| file_size | int    | 是  | -   | 文件大小，单位为字节               | 5335                |
+| target    | string | 是  | -   | 文件上传目标                    | `U_1_0`，格式为 `U_1_<文件夹ID>` |
+| fileid    | string | 是  | -   | 文件 SHA1 值                  | `<FILE_SHA1>`        |
+| preid     | string | 否  | ""  | 文件前 128 KiB 内容的 SHA1 值       | `<PREID_SHA1>`       |
+| path      | string | 否  | ""  | 上传路径                       | ""                  |
+| pick_code | string | 否  | ""  | 上传任务唯一标识，用于续传           | `<PICK_CODE>`        |
+| topupload | int    | 否  | ""  | 上传调度文件类型标记，见下方枚举表格 | 0                   |
+| sign_key  | string | 否  | ""  | 二次认证标识                  | `<SIGN_KEY>`         |
+| sign_val  | string | 否  | ""  | 根据 `sign_check` 计算的大写 SHA1 值 | `<SIGN_VAL>`         |
+
+#### 请求参数中的 topupload 字段枚举
+
+| 值  | 说明                         | 备注 |
+|:---|:---------------------------|:---|
+| -1 | 没有上传调度文件类型标记             | - |
+| 0  | 单文件上传任务，记录一条独立上传记录    | - |
+| 1  | 文件夹任务的第一个子文件，记录一次文件夹上传 | - |
+| 2  | 文件夹任务的其他子文件，不单独记录上传记录   | - |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/upload/init' \
+  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
+  -F 'file_name=图片.jpg' \
+  -F 'file_size=5335' \
+  -F 'target=U_1_0' \
+  -F 'fileid=<FILE_SHA1>' \
+  -F 'topupload=0'
+```
+
+### 响应字段说明
+
+| 字段                        | 类型    | 描述                                      |
+|:--------------------------|:------|:----------------------------------------|
+| state                     | boolean | 状态码，是表示成功，否表示异常                      |
+| message                   | string  | 异常信息                                    |
+| code                      | int     | 异常码                                     |
+| data                      | object  | 上传调度数据                                 |
+| data.status               | int     | 上传状态：1-非秒传 2-秒传                      |
+| data.code                 | int     | 上传调度状态码                                |
+| data.pick_code            | string  | 上传任务唯一标识，用于续传                        |
+| data.target               | string  | 文件上传目标                                 |
+| data.bucket               | string  | 对象存储 bucket                              |
+| data.object               | string  | OSS 对象标识                                |
+| data.callback             | object  | 上传完成回调数据                               |
+| data.callback.callback    | string  | 上传完成回调信息                               |
+| data.callback.callback_var | string  | 上传完成回调参数                               |
+| data.sign_key             | string  | 本次二次认证的 SHA1 标识                       |
+| data.sign_check           | string  | 二次认证所需本地文件 SHA1 计算的字节范围               |
+| data.file_id              | string  | 秒传成功时新增文件 ID                          |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "status": 1,
+    "code": 0,
+    "pick_code": "",
+    "target": "U_1_0",
+    "bucket": "",
+    "object": "",
+    "callback": {
+      "callback": "",
+      "callback_var": ""
+    },
+    "sign_key": "",
+    "sign_check": "",
+    "file_id": ""
+  }
+}
+```
+
+### 业务规则
+
+- `target` 必须匹配 `U_1_<数字文件夹ID>`；`U_1_0` 表示网盘根目录。
+- 非 VIP 用户单文件大小不得超过 5 GiB；尝鲜VIP、体验VIP用户单文件大小不得超过 15 GiB。
+- 上传前会检查用户剩余空间和盗播上传封禁状态。
+- 二次认证调度结果见下表。
+
+| code | status | 说明       | 后续处理 |
+|:-----|:-------|:---------|:------|
+| 700  | 6      | 签名认证后失败 | 按 `sign_check` 截取包含起止字节的文件内容计算大写 SHA1，再传入 `sign_key` 和 `sign_val` |
+| 701  | 7      | 需要认证签名   | 按 `sign_check` 截取包含起止字节的文件内容计算大写 SHA1，再传入 `sign_key` 和 `sign_val` |
+| 702  | 8      | 签名认证失败   | 按 `sign_check` 截取包含起止字节的文件内容计算大写 SHA1，再传入 `sign_key` 和 `sign_val` |
+
+### 注意事项
+
+- `sign_check` 格式为 `起始字节-结束字节`，起止字节均包含在 SHA1 计算范围内；例如 `2392148-2392298` 需计算该范围内文件内容的 SHA1。
+- 省略 `topupload` 时，服务端会将其归一化为空字符串；显式传入枚举值时会归一化为整数。
+- 请妥善保管 `access_token`、上传凭证与回调数据，不要在日志或客户端可见信息中输出。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,110 @@
+## 断点续传
+
+### 基本信息
+
+| 属性       | 内容                            |
+|:---------|:------------------------------|
+| 接口名称     | 断点续传                         |
+| 接口版本     | v1.0                          |
+| 接口路径     | /upload/resume                |
+| 请求方法     | POST                          |
+| 接口状态     | 生产环境                          |
+
+### 接口说明
+
+根据已有上传任务和待上传文件信息，获取断点续传所需的对象存储上传参数。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/upload/resume
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型   | 必填 | 默认值 | 说明                | 约束/示例               |
+|:----------|:-----|:---|:----|:------------------|:--------------------|
+| file_size | int    | 是  | -   | 文件大小，单位为字节      | 5335                |
+| target    | string | 是  | -   | 文件上传目标           | `U_1_0`，格式为 `U_1_<文件夹ID>` |
+| fileid    | string | 是  | -   | 文件 SHA1 值         | `<FILE_SHA1>`        |
+| pick_code | string | 是  | -   | 上传任务唯一标识       | `<PICK_CODE>`        |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/upload/resume' \
+  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
+  -F 'file_size=5335' \
+  -F 'target=U_1_0' \
+  -F 'fileid=<FILE_SHA1>' \
+  -F 'pick_code=<PICK_CODE>'
+```
+
+### 响应字段说明
+
+| 字段                        | 类型    | 描述                    |
+|:--------------------------|:------|:----------------------|
+| state                     | boolean | 状态码，是表示成功，否表示异常    |
+| message                   | string  | 异常信息                  |
+| code                      | int     | 异常码                   |
+| data                      | object  | 续传调度数据               |
+| data.version              | string  | 上传接口版本               |
+| data.target               | string  | 文件上传目标               |
+| data.pick_code            | string  | 上传任务唯一标识             |
+| data.bucket               | string  | 对象存储 bucket            |
+| data.object               | string  | OSS 对象标识              |
+| data.callback             | object  | 上传完成回调数据             |
+| data.callback.callback    | string  | 上传完成回调信息             |
+| data.callback.callback_var | string  | 上传完成回调参数             |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "version": "",
+    "target": "U_1_0",
+    "pick_code": "",
+    "bucket": "",
+    "object": "",
+    "callback": {
+      "callback": "",
+      "callback_var": ""
+    }
+  }
+}
+```
+
+### 业务规则
+
+- `target` 必须匹配 `U_1_<数字文件夹ID>`；`U_1_0` 表示网盘根目录。
+- 非 VIP 用户单文件大小不得超过 5 GiB；尝鲜VIP、体验VIP用户单文件大小不得超过 15 GiB。
+- 续传前会检查用户剩余空间和盗播上传封禁状态。
+- 上游调度结果的 `status` 只有为 1 或 2 时才按成功响应返回续传参数。
+
+### 注意事项
+
+- `pick_code` 必须来自原上传初始化调度响应，并与当前文件信息匹配。
+- 请妥善保管 `access_token`、上传凭证与回调数据，不要在日志或客户端可见信息中输出。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,87 @@
+## 获取上传凭证
+
+### 基本信息
+
+| 属性       | 内容                            |
+|:---------|:------------------------------|
+| 接口名称     | 获取上传凭证                      |
+| 接口版本     | v1.0                          |
+| 接口路径     | /upload/get_token             |
+| 请求方法     | GET                           |
+| 接口状态     | 生产环境                          |
+
+### 接口说明
+
+获取对象存储上传域名和临时上传凭证。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/upload/get_token
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+无
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/upload/get_token' \
+  -H 'Authorization: Bearer <ACCESS_TOKEN>'
+```
+
+### 响应字段说明
+
+| 字段                 | 类型    | 描述             |
+|:-------------------|:------|:---------------|
+| state              | boolean | 状态码，是表示成功，否表示异常 |
+| message            | string  | 异常信息           |
+| code               | int     | 异常码            |
+| data               | object  | 上传凭证数据         |
+| data.endpoint      | string  | 上传域名           |
+| data.AccessKeySecret | string  | 临时上传凭证密钥       |
+| data.SecurityToken | string  | 临时安全令牌         |
+| data.Expiration    | string  | 上传凭证过期时间       |
+| data.AccessKeyId   | string  | 临时上传凭证 ID      |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "endpoint": "",
+    "AccessKeySecret": "",
+    "SecurityToken": "",
+    "Expiration": "",
+    "AccessKeyId": ""
+  }
+}
+```
+
+### 注意事项
+
+- 网页版文档中的密钥字段名存在拼写误差，服务端实际返回字段为 `AccessKeySecret`。
+- 上传凭证为敏感信息，仅用于当前上传流程；不要写入日志、持久化存储或对外暴露。
+- 服务端通过当前 `access_token` 识别用户，不接收用户账号请求参数。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,84 @@
+## 文件复制
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 文件复制                             |
+| 接口版本       | v1.0                             |
+| 接口路径       | /copy                            |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+将一个或多个文件、文件夹复制到指定目录。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/copy
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名     | 类型     | 必填 | 默认值 | 说明                                  | 约束/示例               |
+|:--------|:-------|:---|:----|:------------------------------------|:--------------------|
+| pid     | string | 否  | "0" | 目标目录ID，根目录ID为 `0`                    | 1054251402869818368 |
+| file_id | string | 是  | -   | 待复制的文件或文件夹ID，多个ID使用半角逗号分隔          | 2323423573680609857 |
+| nodupli | int    | 否  | 0   | 目标目录是否不允许同名：0-允许，1-不允许              | 1                   |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/copy' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'pid=1054251402869818368' \
+  --form-string 'file_id=2323423573680609857' \
+  --form-string 'nodupli=1'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述                  |
+|:--------|:---------|:--------------------|
+| state   | boolean  | 接口状态，true表示成功      |
+| message | string   | 异常信息                |
+| code    | int      | 异常码                 |
+| data    | object[] | 响应数据                |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `pid` 不传或传 `0` 时复制到根目录。
+- 接口受文件操作频率限制；触发限制时返回异常。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,121 @@
+## 文件搜索
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 文件搜索                             |
+| 接口版本       | v1.0                             |
+| 接口路径       | /search                          |
+| 请求方法       | GET                              |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+根据文件名搜索文件或文件夹，支持按目录、文件标签、时间范围和文件类型筛选。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/search
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名         | 类型     | 必填 | 默认值 | 说明                                                        | 约束/示例    |
+|:------------|:-------|:---|:----|:----------------------------------------------------------|:---------|
+| search_value | string | 否  | ""  | 搜索关键词；与 `file_label` 至少传一个，最多取前40个字符                  | "文件"     |
+| limit       | int    | 否  | 20  | 单页记录数；`offset + limit` 最大不超过10000                         | 20       |
+| offset      | int    | 否  | 0   | 数据显示偏移量                                                   | 0        |
+| file_label  | string | 否  | ""  | 文件标签；与 `search_value` 至少传一个                              | "1"      |
+| cid         | int    | 否  | 0   | 目标目录ID；`-1` 表示不返回任何列表内容                                | 0        |
+| gte_day     | string | 否  | ""  | 搜索结果匹配的开始日期                                                | 2020-11-19 |
+| lte_day     | string | 否  | ""  | 搜索结果匹配的结束日期                                                | 2020-11-20 |
+| fc          | int    | 否  | 0   | 显示类型：1-只显示文件夹，2-只显示文件，0-全部                              | 0        |
+| type        | int    | 否  | 0   | 一级筛选大分类，见下方枚举表格                                          | 1        |
+| suffix      | string | 否  | ""  | 一级筛选选择“其他”时填写的后缀名                                        | "pdf"    |
+
+#### 请求参数中的 type 字段枚举
+
+| 值 | 说明  | 备注 |
+|:--|:----|:---|
+| 1 | 文档  | -  |
+| 2 | 图片  | -  |
+| 3 | 音频  | -  |
+| 4 | 视频  | -  |
+| 5 | 压缩包 | -  |
+| 6 | 应用  | -  |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/ufile/search' \
+  -H 'Authorization: Bearer access_token' \
+  --data-urlencode 'search_value=文件' \
+  --data-urlencode 'limit=20' \
+  --data-urlencode 'offset=0'
+```
+
+### 响应字段说明
+
+| 字段                 | 类型       | 描述                                      |
+|:-------------------|:---------|:----------------------------------------|
+| count              | int      | 符合条件的文件或文件夹总数                          |
+| data               | object[] | 文件或文件夹列表                                |
+| data[].file_id     | string   | 文件或文件夹ID                                |
+| data[].user_id     | string   | 115账号                                   |
+| data[].sha1        | string   | 文件SHA-1值                                |
+| data[].file_name   | string   | 文件或文件夹名称                               |
+| data[].file_size   | string   | 文件大小                                    |
+| data[].user_ptime  | string   | 上传时间                                    |
+| data[].user_utime  | string   | 更新时间                                    |
+| data[].pick_code   | string   | 文件提取码                                   |
+| data[].parent_id   | string   | 父目录ID                                   |
+| data[].area_id     | string   | 文件状态：1-正常，7-已删除(回收站)，120-彻底删除          |
+| data[].is_private  | int      | 文件是否隐藏：0-未隐藏，1-已隐藏                      |
+| data[].file_category | string | 文件属性：1-文件，0-文件夹                          |
+| data[].ico         | string   | 文件后缀                                    |
+| limit              | int      | 分页数量                                    |
+| offset             | int      | 偏移量                                     |
+| state              | boolean  | 接口状态，true表示成功                          |
+| message            | string   | 异常信息                                    |
+| code               | int      | 异常码                                     |
+
+### 响应示例
+
+```json
+{
+  "count": 0,
+  "data": [],
+  "limit": 20,
+  "offset": 0,
+  "state": true,
+  "message": "",
+  "code": 0
+}
+```
+
+### 注意事项
+
+- `search_value` 与 `file_label` 至少传一个；搜索关键词最多取前40个字符。
+- 当 `offset + limit` 超过10000时，服务端按 `offset=0`、`limit=115` 查询。
+- 搜索结果会过滤不属于正常区域的文件；当前账号未开启隐藏文件展示时，也会过滤隐藏文件。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,91 @@
+## 文件移动
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 文件移动                             |
+| 接口版本       | v1.0                             |
+| 接口路径       | /move                            |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+将一个或多个文件、文件夹移动到指定目录。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/move
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型     | 必填 | 默认值 | 说明                                  | 约束/示例                                   |
+|:---------|:-------|:---|:----|:------------------------------------|:----------------------------------------|
+| file_ids | string | 是  | -   | 待移动的文件或文件夹ID，多个ID使用半角逗号分隔          | 3073323042143855813,3073323042143855822 |
+| to_cid   | string | 否  | "0" | 目标目录ID；`0` 表示根目录，非 `0` 时必须指向正常可用的目录 | 3073311192547189943                     |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/move' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'file_ids=3073323042143855813,3073323042143855822' \
+  --form-string 'to_cid=3073311192547189943'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述                  |
+|:--------|:---------|:--------------------|
+| state   | boolean  | 接口状态，true表示成功      |
+| message | string   | 异常信息                |
+| code    | int      | 异常码                 |
+| data    | object[] | 响应数据                |
+
+#### 响应的 code 字段(错误码)说明
+
+| 错误码 | 说明                               | 解决方案                     |
+|:-------|:-----------------------------------|:-----------------------------|
+| 20009  | 目标目录不存在或目标ID不是目录     | 确认 to_cid 指向存在的目录   |
+| 20018  | 目标目录不在正常区域或已经删除     | 选择正常可用的目标目录       |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `to_cid` 不传或传 `0` 时移动到根目录。
+- `to_cid` 非 `0` 时，目标必须是正常可用的目录；目标不存在、不是目录或已经删除时，移动失败。
+- 接口受文件操作频率限制；触发限制时返回异常。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明                               |
+|:---------------------------------|:---------------------------------------|
+| 2025年04月01日(周二) 00:00:00   | 创建文档                               |
+| 2026年08月14日(周五) 15:38:44   | 补充移动目标目录有效性约束及错误码     |
@@ -0,0 +1,86 @@
+## 新建文件夹
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 新建文件夹                            |
+| 接口版本       | v1.0                             |
+| 接口路径       | /add                             |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+在指定父目录下新建文件夹。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/folder/add
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型     | 必填 | 默认值 | 说明                         | 约束/示例               |
+|:---------|:-------|:---|:----|:---------------------------|:--------------------|
+| pid      | string | 否  | "0" | 父目录ID，根目录ID为 `0`           | 3073323042143855813 |
+| file_name | string | 是  | -   | 文件夹名称，最多255个字符             | 新建文件夹名称             |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/folder/add' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'pid=3073323042143855813' \
+  --form-string 'file_name=新建文件夹名称'
+```
+
+### 响应字段说明
+
+| 字段             | 类型      | 描述                    |
+|:---------------|:--------|:----------------------|
+| state          | boolean | 接口状态，true表示成功        |
+| message        | string  | 异常信息                  |
+| code           | int     | 异常码                   |
+| data           | object  | 响应数据                  |
+| data.file_name | string  | 新建的文件夹名称              |
+| data.file_id   | string  | 新建的文件夹ID              |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "file_name": "",
+    "file_id": ""
+  }
+}
+```
+
+### 注意事项
+
+- `pid` 不传或传 `0` 时在根目录下新建文件夹。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,114 @@
+## 按ID获取
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 按ID获取                            |
+| 接口版本       | v1.0                             |
+| 接口路径       | /get_info                        |
+| 请求方法       | GET                              |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+根据文件或文件夹ID获取详情。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/folder/get_info
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型     | 必填 | 默认值 | 说明        | 约束/示例               |
+|:---------|:-------|:---|:----|:----------|:--------------------|
+| file_id  | string | 是  | -   | 文件或文件夹ID | 1288444975268439877 |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/folder/get_info' \
+  -H 'Authorization: Bearer access_token' \
+  --data-urlencode 'file_id=1288444975268439877'
+```
+
+### 响应字段说明
+
+| 字段                    | 类型       | 描述                                      |
+|:----------------------|:---------|:----------------------------------------|
+| state                 | boolean  | 接口状态，true表示成功                          |
+| message               | string   | 异常信息                                    |
+| code                  | int      | 异常码                                     |
+| data                  | object   | 文件或文件夹详情                                |
+| data.count            | int      | 包含的文件总数                                 |
+| data.size             | string   | 文件或文件夹总大小                               |
+| data.size_byte        | int      | 文件或文件夹总大小，单位为字节                         |
+| data.folder_count     | int      | 包含的文件夹总数                                |
+| data.play_long        | int      | 视频时长；`-1` 表示正在统计，其他数值单位为秒              |
+| data.show_play_long   | int      | 是否开启展示视频时长                              |
+| data.ptime            | string   | 上传时间                                    |
+| data.utime            | string   | 修改时间                                    |
+| data.file_name        | string   | 文件或文件夹名称                                |
+| data.pick_code        | string   | 文件提取码                                   |
+| data.sha1             | string   | 文件SHA-1值                                |
+| data.file_id          | string   | 文件或文件夹ID                                |
+| data.is_mark          | string   | 是否星标                                    |
+| data.open_time        | int      | 文件或文件夹最近打开时间                            |
+| data.file_category    | string   | 文件属性：1-文件，0-文件夹                          |
+| data.paths            | object[] | 文件或文件夹所在路径                               |
+| data.paths[].file_id  | string   | 父目录ID                                   |
+| data.paths[].file_name | string   | 父目录名称                                   |
+| data.paths[].iss      | int      | 父目录共享状态标识                               |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "count": 0,
+    "size": "",
+    "size_byte": 0,
+    "folder_count": 0,
+    "play_long": 0,
+    "show_play_long": 0,
+    "ptime": "",
+    "utime": "",
+    "file_name": "",
+    "pick_code": "",
+    "sha1": "",
+    "file_id": "",
+    "is_mark": "",
+    "open_time": 0,
+    "file_category": "",
+    "paths": []
+  }
+}
+```
+
+### 注意事项
+
+- 文件或文件夹已进入回收站或被彻底删除时，接口返回异常。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,115 @@
+## 按路径获取
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 按路径获取                           |
+| 接口版本       | v1.0                             |
+| 接口路径       | /get_info                        |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+根据文件或文件夹路径获取详情。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/folder/get_info
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名 | 类型     | 必填 | 默认值 | 说明                                                              | 约束/示例              |
+|:----|:-------|:---|:----|:----------------------------------------------------------------|:-------------------|
+| path | string | 是  | -   | 文件路径，支持 `/`、`>` 两种分隔符；路径需以分隔符开头，并用同一分隔符分隔目录层级 | /a/b/c.png 或 >a>b>c |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/folder/get_info' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'path=/a/b/c.png'
+```
+
+### 响应字段说明
+
+| 字段                    | 类型       | 描述                                      |
+|:----------------------|:---------|:----------------------------------------|
+| state                 | boolean  | 接口状态，true表示成功                          |
+| message               | string   | 异常信息                                    |
+| code                  | int      | 异常码                                     |
+| data                  | object   | 文件或文件夹详情                                |
+| data.count            | int      | 包含的文件总数                                 |
+| data.size             | string   | 文件或文件夹总大小                               |
+| data.size_byte        | int      | 文件或文件夹总大小，单位为字节                         |
+| data.folder_count     | int      | 包含的文件夹总数                                |
+| data.play_long        | int      | 视频时长；`-1` 表示正在统计，其他数值单位为秒              |
+| data.show_play_long   | int      | 是否开启展示视频时长                              |
+| data.ptime            | string   | 上传时间                                    |
+| data.utime            | string   | 修改时间                                    |
+| data.file_name        | string   | 文件或文件夹名称                                |
+| data.pick_code        | string   | 文件提取码                                   |
+| data.sha1             | string   | 文件SHA-1值                                |
+| data.file_id          | string   | 文件或文件夹ID                                |
+| data.is_mark          | string   | 是否星标                                    |
+| data.open_time        | int      | 文件或文件夹最近打开时间                            |
+| data.file_category    | string   | 文件属性：1-文件，0-文件夹                          |
+| data.paths            | object[] | 文件或文件夹所在路径                               |
+| data.paths[].file_id  | string   | 父目录ID                                   |
+| data.paths[].file_name | string   | 父目录名称                                   |
+| data.paths[].iss      | int      | 父目录共享状态标识                               |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "count": 0,
+    "size": "",
+    "size_byte": 0,
+    "folder_count": 0,
+    "play_long": 0,
+    "show_play_long": 0,
+    "ptime": "",
+    "utime": "",
+    "file_name": "",
+    "pick_code": "",
+    "sha1": "",
+    "file_id": "",
+    "is_mark": "",
+    "open_time": 0,
+    "file_category": "",
+    "paths": []
+  }
+}
+```
+
+### 注意事项
+
+- 文件或文件夹已进入回收站或被彻底删除时，接口返回异常。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,98 @@
+## 获取文件下载地址
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 获取文件下载地址                        |
+| 接口版本       | v1.0                            |
+| 接口路径       | /downurl                        |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+根据文件提取码获取文件下载地址。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/downurl
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型     | 必填 | 默认值 | 说明    | 约束/示例            |
+|:---------|:-------|:---|:----|:------|:-----------------|
+| pick_code | string | 是  | -   | 文件提取码，多个提取码用半角逗号分隔 | dtctprlmfkl4exiok |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/downurl' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'pick_code=dtctprlmfkl4exiok'
+```
+
+### 响应字段说明
+
+| 字段                         | 类型      | 描述                         |
+|:---------------------------|:--------|:---------------------------|
+| state                      | boolean | 状态码，true 表示成功              |
+| message                    | string  | 错误信息                       |
+| code                       | int     | 错误码                        |
+| errno                      | int     | 下载地址获取失败时返回的错误码             |
+| data                       | object  | 响应数据                       |
+| data.{文件ID}                | object  | 以文件ID为键的文件下载信息              |
+| data.{文件ID}.file_name      | string  | 文件名                        |
+| data.{文件ID}.file_size      | int     | 文件大小，单位为字节                  |
+| data.{文件ID}.pick_code      | string  | 文件提取码                      |
+| data.{文件ID}.sha1           | string  | 文件 SHA1 值                   |
+| data.{文件ID}.url            | object  | 下载地址信息                     |
+| data.{文件ID}.url.url        | string  | 文件下载地址                     |
+| data.can_appeal            | boolean | 文件违规时是否可以申诉，按错误场景返回         |
+| data.want_appeal_id        | string  | 文件违规时的申诉标识，按错误场景返回          |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "2323423573680609857": {
+      "file_name": "",
+      "file_size": 0,
+      "pick_code": "",
+      "sha1": "",
+      "url": {
+        "url": ""
+      }
+    }
+  }
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,204 @@
+## 获取文件列表
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 获取文件列表                          |
+| 接口版本       | v1.0                             |
+| 接口路径       | /files                           |
+| 请求方法       | GET                              |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+获取指定目录中的文件和文件夹列表，支持分页、排序以及按文件类型、后缀名和星标状态筛选。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/files
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名        | 类型     | 必填 | 默认值       | 说明                                                     | 约束/示例     |
+|:-----------|:-------|:---|:----------|:-------------------------------------------------------|:----------|
+| cid        | string | 否  | "0"       | 目录ID，对应 `parent_id`；根目录ID为 `0`                         | "0"       |
+| type       | int    | 否  | 0         | 文件类型，见下方枚举表格                                          | 1         |
+| limit      | int    | 否  | 20        | 查询数量，最大1150                                            | 20        |
+| offset     | int    | 否  | 0         | 查询起始位置                                                 | 0         |
+| suffix     | string | 否  | ""        | 文件后缀名                                                  | "pdf"     |
+| asc        | int    | 否  | 0         | 排序方向：1-升序，0-降序                                        | 0         |
+| o          | string | 否  | user_ptime | 排序字段，见下方枚举表格                                          | file_name |
+| custom_order | int    | 否  | 0         | 排序模式，见下方枚举表格                                          | 0         |
+| stdir      | int    | 否  | 0         | 筛选文件时是否显示文件夹：1-显示，0-不显示                              | 1         |
+| star       | int    | 否  | 0         | 星标筛选：1-仅显示星标文件，0-全部                                  | 0         |
+| cur        | int    | 否  | 0         | 是否只显示当前文件夹内的文件：1-是，0-否                              | 1         |
+| show_dir   | int    | 否  | 0         | 是否显示目录：1-是，0-否                                        | 0         |
+
+#### 请求参数中的 type 字段枚举
+
+| 值 | 说明  | 备注 |
+|:--|:----|:---|
+| 1 | 文档  | -  |
+| 2 | 图片  | -  |
+| 3 | 音频  | -  |
+| 4 | 视频  | -  |
+| 5 | 压缩包 | -  |
+| 6 | 应用  | -  |
+| 7 | 书籍  | -  |
+
+#### 请求参数中的 o 字段枚举
+
+| 值          | 说明     | 备注 |
+|:-----------|:-------|:---|
+| file_name  | 文件名    | -  |
+| file_size  | 文件大小   | -  |
+| user_ptime | 上传时间   | 默认值 |
+| user_utime | 更新时间   | -  |
+| file_type  | 文件类型   | -  |
+
+#### 请求参数中的 custom_order 字段枚举
+
+| 值 | 说明                    | 备注 |
+|:--|:----------------------|:---|
+| 0 | 使用记忆排序，自定义排序失效       | 默认值 |
+| 1 | 使用自定义排序，不使用记忆排序      | -  |
+| 2 | 使用自定义排序，非文件夹置顶       | -  |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/ufile/files' \
+  -H 'Authorization: Bearer access_token' \
+  --data-urlencode 'cid=0' \
+  --data-urlencode 'limit=20' \
+  --data-urlencode 'offset=0'
+```
+
+### 响应字段说明
+
+| 字段                    | 类型       | 描述                                                        |
+|:----------------------|:---------|:----------------------------------------------------------|
+| data                  | object[] | 文件和文件夹列表                                                   |
+| data[].fid            | string   | 文件或文件夹ID                                                   |
+| data[].aid            | string   | 文件状态：1-正常，7-已删除(回收站)，120-彻底删除                            |
+| data[].pid            | string   | 父目录ID                                                      |
+| data[].fc             | string   | 文件分类：0-文件夹，1-文件                                         |
+| data[].fn             | string   | 文件或文件夹名称                                                  |
+| data[].fco            | string   | 文件夹封面                                                      |
+| data[].ism            | string   | 是否星标，1表示星标                                                |
+| data[].isp            | int      | 是否加密，1表示加密                                                |
+| data[].pc             | string   | 文件提取码                                                      |
+| data[].upt            | int      | 修改时间                                                       |
+| data[].uet            | int      | 修改时间                                                       |
+| data[].uppt           | int      | 上传时间                                                       |
+| data[].cm             | int      | 特殊目录标识                                                     |
+| data[].fdesc          | string   | 文件备注                                                       |
+| data[].ispl           | int      | 是否统计文件夹下视频时长                                               |
+| data[].fl             | object[] | 文件标签                                                       |
+| data[].fl[].id        | string   | 文件标签ID                                                     |
+| data[].fl[].name      | string   | 文件标签名称                                                     |
+| data[].fl[].sort      | string   | 文件标签排序                                                     |
+| data[].fl[].color     | string   | 文件标签颜色                                                     |
+| data[].fl[].is_default | int      | 文件标签类型：0-最近使用，1-非最近使用，2-默认标签                            |
+| data[].fl[].update_time | int      | 文件标签更新时间                                                  |
+| data[].fl[].create_time | int      | 文件标签创建时间                                                  |
+| data[].sha1           | string   | 文件SHA-1值                                                   |
+| data[].fs             | int      | 文件大小，单位为字节                                                |
+| data[].fta            | string   | 文件状态：0或2-未上传完成，1-已上传完成                                  |
+| data[].ico            | string   | 文件后缀名                                                      |
+| data[].fatr           | string   | 音频长度                                                       |
+| data[].isv            | int      | 是否为视频                                                      |
+| data[].def            | int      | 视频清晰度：1-标清，2-高清，3-超清，4-1080P，5-4K，100-原画                  |
+| data[].def2           | int      | 视频清晰度：1-标清，2-高清，3-超清，4-1080P，5-4K，100-原画                  |
+| data[].play_long      | int      | 音视频时长，单位为秒                                                |
+| data[].v_img          | string   | 视频缩略图地址                                                    |
+| data[].thumb          | string   | 图片缩略图地址                                                    |
+| data[].uo             | string   | 原图地址                                                       |
+| count                 | int      | 当前目录文件数量                                                   |
+| sys_count             | int      | 系统文件夹数量                                                    |
+| offset                | int      | 偏移量                                                        |
+| limit                 | int      | 分页数量                                                       |
+| aid                   | string   | 文件状态：1-正常，7-已删除(回收站)，120-彻底删除                            |
+| cid                   | int      | 父目录ID                                                      |
+| is_asc                | int      | 排序方向：1-升序，0-降序                                            |
+| min_size              | int      | 最小文件大小筛选值                                                  |
+| max_size              | int      | 最大文件大小筛选值                                                  |
+| sys_dir               | string   | 系统目录                                                       |
+| hide_data             | string   | 是否返回文件数据                                                  |
+| record_open_time      | string   | 是否记录文件夹打开时间                                                |
+| star                  | int      | 是否星标：1-星标，0-未星标                                           |
+| type                  | int      | 一级筛选大分类，见请求参数中的 `type` 字段枚举                               |
+| suffix                | string   | 一级筛选选择“其他”时填写的后缀名                                        |
+| path                  | object[] | 父目录树                                                       |
+| path[].name           | string   | 父目录名称                                                      |
+| path[].aid            | int      | 父目录文件状态                                                    |
+| path[].cid            | int      | 父目录ID                                                      |
+| path[].pid            | int      | 上级父目录ID                                                    |
+| path[].isp            | int      | 父目录是否加密                                                   |
+| path[].p_cid          | string   | 父目录路径标识                                                    |
+| path[].fv             | string   | 父目录属性                                                      |
+| cur                   | int      | 是否只显示当前文件夹内的文件                                            |
+| stdir                 | int      | 筛选文件时是否显示文件夹                                               |
+| fields                | string   | 指定返回字段                                                     |
+| order                 | string   | 实际使用的排序字段                                                  |
+| state                 | boolean  | 接口状态，true表示成功                                              |
+| code                  | int      | 异常码                                                        |
+| message               | string   | 异常信息                                                       |
+
+### 响应示例
+
+```json
+{
+  "data": [],
+  "count": 0,
+  "sys_count": 0,
+  "offset": 0,
+  "limit": 20,
+  "aid": "1",
+  "cid": 0,
+  "is_asc": 0,
+  "min_size": 0,
+  "max_size": 0,
+  "sys_dir": "",
+  "hide_data": "",
+  "record_open_time": "",
+  "star": 0,
+  "type": 0,
+  "suffix": "",
+  "path": [],
+  "cur": 0,
+  "stdir": 0,
+  "fields": "",
+  "order": "user_ptime",
+  "state": true,
+  "code": 0,
+  "message": ""
+}
+```
+
+### 注意事项
+
+- `limit` 最大为1150。
+- 当 `cid` 指向不存在或已删除的目录时，接口返回异常；当目录为加密目录时，不返回目录内容。
+- `user_id` 由服务端根据 access token 获取，无需传入。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,140 @@
+## 用户信息
+
+### 基本信息
+
+| 属性       | 内容                            |
+|:---------|:------------------------------|
+| 接口名称     | 用户信息                         |
+| 接口版本     | v1.0                          |
+| 接口路径     | /user/info                    |
+| 请求方法     | GET                           |
+| 接口状态     | 生产环境                          |
+
+### 接口说明
+
+获取当前授权用户的基本信息、网盘空间信息、VIP 等级信息以及第三方畅用权益信息。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/user/info
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+无
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/user/info' \
+  -H 'Authorization: Bearer <ACCESS_TOKEN>'
+```
+
+### 响应字段说明
+
+| 字段                                      | 类型    | 描述                                      |
+|:----------------------------------------|:------|:----------------------------------------|
+| state                                   | boolean | 状态码，是表示成功，否表示异常                      |
+| message                                 | string  | 异常信息                                    |
+| code                                    | int     | 异常码                                     |
+| data                                    | object  | 响应数据                                    |
+| data.user_id                            | int     | 用户115账号                                 |
+| data.user_name                          | string  | 用户名称                                    |
+| data.user_face_s                        | string  | 小尺寸用户头像                                 |
+| data.user_face_m                        | string  | 中尺寸用户头像                                 |
+| data.user_face_l                        | string  | 大尺寸用户头像                                 |
+| data.rt_space_info                      | object  | 用户实时空间信息                               |
+| data.rt_space_info.all_total            | object  | 用户总空间                                   |
+| data.rt_space_info.all_total.size       | int     | 用户总空间大小，单位为字节                          |
+| data.rt_space_info.all_total.size_format | string  | 用户总空间大小，格式化文本                            |
+| data.rt_space_info.all_remain           | object  | 用户剩余空间                                  |
+| data.rt_space_info.all_remain.size      | int     | 用户剩余空间大小，单位为字节                         |
+| data.rt_space_info.all_remain.size_format | string  | 用户剩余空间大小，格式化文本                           |
+| data.rt_space_info.all_use              | object  | 用户已使用空间                                 |
+| data.rt_space_info.all_use.size         | int     | 用户已使用空间大小，单位为字节                        |
+| data.rt_space_info.all_use.size_format  | string  | 用户已使用空间大小，格式化文本                          |
+| data.vip_info                           | object  | 用户 VIP 等级信息                              |
+| data.vip_info.level_name                | string  | VIP 等级名称，见下方枚举表格                      |
+| data.vip_info.expire                    | int     | VIP 过期时间戳，无 VIP 时为 0                   |
+| data.vip_info.tp_rights                 | object  | 第三方畅用权益信息                              |
+| data.vip_info.tp_rights.is_tp_rights    | int     | 是否具有当前应用的第三方畅用权益：0-否 1-是              |
+| data.vip_info.tp_rights.tp_rights_time  | int     | 第三方畅用权益过期时间戳，无有效权益时为 0                |
+
+#### 响应的 data.vip_info.level_name 字段枚举
+
+| 值        | 说明 | 备注 |
+|:----------|:---|:---|
+| 原石会员      | 原石用户 | 无有效 VIP 等级时的服务端固定返回值 |
+| 尝鲜VIP     | 尝鲜VIP | - |
+| 体验VIP     | 体验VIP | - |
+| 月费VIP     | 月费VIP | - |
+| 年费VIP     | 年费VIP | - |
+| 长期VIP(高级版) | 长期VIP(高级版) | - |
+| 长期VIP(特级版) | 长期VIP(特级版) | - |
+| 长期VIP(超级版) | 长期VIP(超级版) | - |
+| 长期VIP(至尊版) | 长期VIP(至尊版) | - |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "user_id": 0,
+    "user_name": "",
+    "user_face_s": "",
+    "user_face_m": "",
+    "user_face_l": "",
+    "rt_space_info": {
+      "all_total": {
+        "size": 0,
+        "size_format": ""
+      },
+      "all_remain": {
+        "size": 0,
+        "size_format": ""
+      },
+      "all_use": {
+        "size": 0,
+        "size_format": ""
+      }
+    },
+    "vip_info": {
+      "expire": 0,
+      "level_name": "原石会员",
+      "tp_rights": {
+        "is_tp_rights": 0,
+        "tp_rights_time": 0
+      }
+    }
+  }
+}
+```
+
+### 注意事项
+
+- `access_token` 决定当前用户和开放应用，接口不接收用户账号请求参数。
+- `rt_space_info` 为实时空间数据，`all_use` 由总空间减去剩余空间计算得出。
+- 请妥善保管 `access_token`，不要在日志或客户端可见信息中输出。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
+| 2026年08月18日(周二) 14:40:25 | 更新四种长期VIP等级名称枚举 |
@@ -0,0 +1,88 @@
+## 提交视频转码
+
+### 基本信息
+
+| 属性           | 内容                              |
+|:-------------|:--------------------------------|
+| 接口名称         | 提交视频转码                          |
+| 接口版本         | v1.0                            |
+| 接口路径         | /video_push                     |
+| 请求方法         | POST                            |
+| 接口状态         | 生产环境                            |
+
+### 接口说明
+
+按 VIP 等级或消耗枫币提交视频加速转码。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/video/video_push
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明                                      | 约束/示例            |
+|:----------|:-------|:---|:----|:----------------------------------------|:-----------------|
+| pick_code | string | 是  | -   | 视频文件提取码                                 | b53gu6z3hvqji8wrm |
+| op        | string | 是  | -   | 加速转码方式，`vip_push`：按 VIP 等级加速；`pay_push`：消耗枫币加速 | vip_push         |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/video/video_push' \
+  -H 'Authorization: Bearer <access_token>' \
+  -F 'pick_code=b53gu6z3hvqji8wrm' \
+  -F 'op=vip_push'
+```
+
+### 响应字段说明
+
+| 字段    | 类型       | 描述                    |
+|:------|:---------|:----------------------|
+| state | boolean  | 操作结果状态，true：成功；false：失败 |
+| message | string | 返回信息，成功时为空字符串          |
+| code  | int      | 错误码                   |
+| data  | object[] | 响应数据，成功时为空数组            |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 业务规则
+
+- 仅支持为当前授权用户所属的视频文件提交加速转码。
+- 已完成转码的视频无需重复提交。
+- 两种加速转码方式均要求当前用户具备 VIP 权益；`pay_push` 在枫币余额不足时提交失败。
+- 提交成功后，系统通知转码服务重新计算排队信息，并在 3 小时内记录已加速状态。
+
+### 注意事项
+
+- `access_token` 通过 `Authorization` 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
+- 请勿对同一视频重复提交加速转码。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,125 @@
+## 获取视频在线播放地址
+
+### 基本信息
+
+| 属性           | 内容                              |
+|:-------------|:--------------------------------|
+| 接口名称         | 获取视频在线播放地址                     |
+| 接口版本         | v1.0                            |
+| 接口路径         | /play                           |
+| 请求方法         | GET                             |
+| 接口状态         | 生产环境                            |
+
+### 接口说明
+
+获取指定视频的在线播放地址、清晰度、音轨及文件基础信息。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/video/play
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明        | 约束/示例            |
+|:----------|:-------|:---|:----|:----------|:-----------------|
+| pick_code | string | 是  | -   | 视频文件提取码   | b53gu6z3hvqji8wrm |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/video/play' \
+  -H 'Authorization: Bearer <access_token>' \
+  --data-urlencode 'pick_code=b53gu6z3hvqji8wrm'
+```
+
+### 响应字段说明
+
+| 字段                               | 类型       | 描述                                      |
+|:---------------------------------|:---------|:----------------------------------------|
+| state                            | boolean  | 操作结果状态，true：成功；false：失败                   |
+| message                          | string   | 返回信息，成功时为空字符串                           |
+| code                             | int      | 错误码                                     |
+| data                             | object   | 视频播放及文件数据                              |
+| data.file_id                     | string   | 文件ID                                    |
+| data.parent_id                   | string   | 文件父目录ID                                 |
+| data.file_name                   | string   | 文件名称                                    |
+| data.file_size                   | string   | 文件大小，单位为字节                              |
+| data.file_sha1                   | string   | 文件哈希值                                   |
+| data.file_type                   | string   | 文件类型                                    |
+| data.is_private                  | string   | 文件是否加密隐藏，0：否；1：是                        |
+| data.play_long                   | string   | 视频时长                                    |
+| data.user_def                    | int      | 记忆的清晰度，1：标清；2：高清；3：超清；4：1080P；5：4K；100：原画 |
+| data.user_rotate                 | int      | 记忆的视频旋转角度，取值为 0、90、180、270             |
+| data.user_turn                   | int      | 视频翻转方向，0：不翻转；1：水平翻转；2：垂直翻转            |
+| data.multitrack_list             | object   | 多音轨列表，键为音轨序号                            |
+| data.multitrack_list.*.title     | string   | 音轨标题                                    |
+| data.multitrack_list.*.is_selected | string | 音轨是否为上次选中，1：是                           |
+| data.multitrack_list.*.sync_time | string   | 音轨同步时间                                  |
+| data.definition_list             | object   | 清晰度列表，键为清晰度值，值为清晰度名称                   |
+| data.definition_list_new         | object   | 新版清晰度列表，键为清晰度值，值为清晰度名称                 |
+| data.video_url                   | object[] | 各清晰度的播放地址信息                            |
+| data.video_url[].url             | string   | 播放地址                                    |
+| data.video_url[].height          | int      | 视频高度                                    |
+| data.video_url[].width           | int      | 视频宽度                                    |
+| data.video_url[].definition      | int      | 视频清晰度                                   |
+| data.video_url[].title           | string   | 视频清晰度名称                                 |
+| data.video_url[].definition_n    | int      | 新版视频清晰度                                 |
+| data.video_push_state            | boolean  | 视频尚未完成转码时是否已提交加速转码，仅对应失败响应返回            |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "file_id": "",
+    "parent_id": "",
+    "file_name": "",
+    "file_size": "0",
+    "file_sha1": "",
+    "file_type": "",
+    "is_private": "0",
+    "play_long": "0",
+    "user_def": 0,
+    "user_rotate": 0,
+    "user_turn": 0,
+    "multitrack_list": {},
+    "definition_list": {},
+    "definition_list_new": {},
+    "video_url": []
+  }
+}
+```
+
+### 业务规则
+
+- 切换音轨时，在返回的播放地址后增加整型参数 `audio_track`，参数值取 `multitrack_list` 对应的键；音轨下标从 `0` 开始。
+- 年费VIP以下用户不支持播放 4K 视频；选择 4K 清晰度时会返回引导升级的视频地址。
+- 接口不返回下载地址字段 `down_url`。
+
+### 注意事项
+
+- `access_token` 通过 `Authorization` 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
+- 播放地址具有时效性，请勿缓存或向无关方披露。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,96 @@
+## 获取视频播放进度
+
+### 基本信息
+
+| 属性           | 内容                              |
+|:-------------|:--------------------------------|
+| 接口名称         | 获取视频播放进度                       |
+| 接口版本         | v1.0                            |
+| 接口路径         | /history                        |
+| 请求方法         | GET                             |
+| 接口状态         | 生产环境                            |
+
+### 接口说明
+
+获取指定视频已记录的播放进度。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/video/history
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明        | 约束/示例            |
+|:----------|:-------|:---|:----|:----------|:-----------------|
+| pick_code | string | 是  | -   | 视频文件提取码   | b53gu6z3hvqji8wrm |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/video/history' \
+  -H 'Authorization: Bearer <access_token>' \
+  --data-urlencode 'pick_code=b53gu6z3hvqji8wrm'
+```
+
+### 响应字段说明
+
+| 字段           | 类型      | 描述                           |
+|:-------------|:--------|:-----------------------------|
+| state        | boolean | 操作结果状态，true：成功；false：失败        |
+| message      | string  | 返回信息，成功时为空字符串                 |
+| code         | int     | 错误码                          |
+| data         | object  | 播放进度数据；没有记录时为空数组              |
+| data.add_time | int    | 记录添加时间，Unix 时间戳                |
+| data.file_id | string  | 文件ID                         |
+| data.file_name | string | 文件名称                       |
+| data.hash    | string  | 文件哈希值                        |
+| data.pick_code | string | 文件提取码                       |
+| data.time    | int     | 已播放时长，单位为秒                   |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "add_time": 0,
+    "file_id": "",
+    "file_name": "",
+    "hash": "",
+    "pick_code": "b53gu6z3hvqji8wrm",
+    "time": 0
+  }
+}
+```
+
+### 业务规则
+
+- 接口只返回当前 `pick_code` 对应的单条播放进度记录。
+- 视频是否播放完毕可通过文件列表中的 `played_end` 字段查看，`1` 表示已播放完毕。
+
+### 注意事项
+
+- `access_token` 通过 `Authorization` 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
+- `pick_code` 对应的文件不存在或不在有效文件区域时，接口返回失败。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,119 @@
+## 视频字幕列表
+
+### 基本信息
+
+| 属性           | 内容                              |
+|:-------------|:--------------------------------|
+| 接口名称         | 视频字幕列表                          |
+| 接口版本         | v1.0                            |
+| 接口路径         | /subtitle                       |
+| 请求方法         | GET                             |
+| 接口状态         | 生产环境                            |
+
+### 接口说明
+
+获取指定视频的自动载入字幕和可用字幕列表。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/video/subtitle
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明        | 约束/示例            |
+|:----------|:-------|:---|:----|:----------|:-----------------|
+| pick_code | string | 是  | -   | 视频文件提取码   | b53gu6z3hvqji8wrm |
+
+### 请求示例
+
+```shell
+curl -G 'https://proapi.115.com/open/video/subtitle' \
+  -H 'Authorization: Bearer <access_token>' \
+  --data-urlencode 'pick_code=b53gu6z3hvqji8wrm'
+```
+
+### 响应字段说明
+
+| 字段                          | 类型       | 描述                          |
+|:----------------------------|:---------|:----------------------------|
+| state                       | boolean  | 操作结果状态，true：成功；false：失败       |
+| message                     | string   | 返回信息，成功时为空字符串                |
+| code                        | int      | 错误码                         |
+| data                        | object   | 响应数据                       |
+| data.autoload               | object   | 默认自动载入的字幕；无可用字幕时为空数组          |
+| data.autoload.sid           | string   | 字幕标识                        |
+| data.autoload.language      | string   | 字幕语言                        |
+| data.autoload.title         | string   | 字幕标题                        |
+| data.autoload.url           | string   | 字幕文件地址                      |
+| data.autoload.type          | string   | 字幕文件类型                      |
+| data.autoload.key           | string   | 内置字幕键，仅内置字幕返回               |
+| data.autoload.sha1          | string   | 字幕文件哈希值                     |
+| data.autoload.file_id       | string   | 外挂或内嵌字幕文件ID                 |
+| data.autoload.file_name     | string   | 外挂或内嵌字幕文件名                  |
+| data.autoload.pick_code     | string   | 外挂或内嵌字幕文件提取码                |
+| data.autoload.caption_map_id | string  | 内嵌字幕映射ID                    |
+| data.autoload.is_caption_map | int     | 是否为内嵌字幕，0：否；1：是             |
+| data.autoload.sync_time     | float    | 字幕同步时间                      |
+| data.autoload.from          | int      | 记忆字幕来源标识                    |
+| data.autoload.user_sub      | int      | 是否为用户记忆字幕，1：是               |
+| data.list                   | object[] | 字幕列表                        |
+| data.list[].sid             | string   | 字幕标识                        |
+| data.list[].language        | string   | 字幕语言                        |
+| data.list[].title           | string   | 字幕标题                        |
+| data.list[].url             | string   | 字幕文件地址                      |
+| data.list[].type            | string   | 字幕文件类型                      |
+| data.list[].key             | string   | 内置字幕键，仅内置字幕返回               |
+| data.list[].sha1            | string   | 字幕文件哈希值                     |
+| data.list[].file_id         | string   | 外挂或内嵌字幕文件ID                 |
+| data.list[].file_name       | string   | 外挂或内嵌字幕文件名                  |
+| data.list[].pick_code       | string   | 外挂或内嵌字幕文件提取码                |
+| data.list[].caption_map_id  | string   | 内嵌字幕映射ID                    |
+| data.list[].is_caption_map  | int      | 是否为内嵌字幕，0：否；1：是             |
+| data.list[].sync_time       | float    | 字幕同步时间                      |
+| data.list[].from            | int      | 记忆字幕来源标识                    |
+| data.list[].user_sub        | int      | 是否为用户记忆字幕，1：是               |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "autoload": [],
+    "list": []
+  }
+}
+```
+
+### 业务规则
+
+- 用户记忆字幕不在列表中时会被前置；其余字幕按同目录同名外挂字幕、内嵌字幕、内置字幕、其他外挂字幕的顺序组合。
+- 存在用户记忆字幕时优先将其作为自动载入字幕；否则依次选择内嵌字幕、同名外挂字幕或内置字幕。
+- 字幕项来源不同，部分来源专属字段可能不返回。
+
+### 注意事项
+
+- `access_token` 通过 `Authorization` 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
+- 字幕文件地址具有时效性，请以本次接口返回值为准。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,89 @@
+## 记忆视频播放进度
+
+### 基本信息
+
+| 属性           | 内容                              |
+|:-------------|:--------------------------------|
+| 接口名称         | 记忆视频播放进度                        |
+| 接口版本         | v1.0                            |
+| 接口路径         | /history                        |
+| 请求方法         | POST                            |
+| 接口状态         | 生产环境                            |
+
+### 接口说明
+
+记录指定视频的播放进度及是否播放完毕。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/video/history
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明                 | 约束/示例            |
+|:----------|:-------|:---|:----|:-------------------|:-----------------|
+| pick_code | string | 是  | -   | 视频文件提取码            | b53gu6z3hvqji8wrm |
+| time      | int    | 否  | 0   | 视频播放进度，单位为秒        | 10               |
+| watch_end | int    | 否  | 0   | 是否播放完毕，0：否；1：是     | 0                |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/video/history' \
+  -H 'Authorization: Bearer <access_token>' \
+  -F 'pick_code=b53gu6z3hvqji8wrm' \
+  -F 'time=10' \
+  -F 'watch_end=0'
+```
+
+### 响应字段说明
+
+| 字段    | 类型       | 描述                    |
+|:------|:---------|:----------------------|
+| state | boolean  | 操作结果状态，true：成功；false：失败 |
+| message | string | 返回信息，成功时为空字符串          |
+| code  | int      | 错误码                   |
+| data  | object[] | 响应数据，成功时为空数组            |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 业务规则
+
+- `time` 和 `watch_end` 均不传时，两个参数均按 `0` 处理，即播放进度为 0 秒且未播放完毕。
+- 非本人文件不写入播放进度，但接口按操作成功返回。
+- 同一视频未播放完毕的进度在 5 秒内重复上报时不重复持久化；标记为播放完毕时会立即持久化。
+
+### 注意事项
+
+- `access_token` 通过 `Authorization` 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
+- `pick_code` 必须属于当前授权用户可记录播放进度的视频文件。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,30 @@
+# 开发须知
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 文档名称       | 开发须知                             |
+| 文档版本       | v1.0                             |
+
+## 注意事项
+
+为共同建设开放、共赢的合作生态并保障平台服务的可持续发展，开发者在接入平台服务前，须认真阅读并严格遵循《115生活开放平台开发者协议》的相关要求，确保合规运营、维护平台秩序。
+
+基于平台与用户权益保护原则，平台会持续监测开发者的服务使用行为。如发现违反平台规范的行为，平台将视情节采取包括但不限于服务限流、接口冻结、资质回收等限制措施，并保留依法追责的权利。
+
+开发者严禁实施包括但不限于以下行为：
+
+1. **数据隐私违规行为**：侵害用户数据隐私安全，包括未经用户授权或未明确用途，违规收集、下载、存储、传播、加工用户存储数据等。开发者需要确保用户数据的获取与使用全程透明、可追溯。
+2. **商业利益侵犯行为**：损害 115 科技的商业利益，包括多人共享开发者账号及会员权益、开展竞争关系业务、未经授权获取平台相关服务运营数据等。
+3. **不当使用行为**：违规或未按要求使用 API 服务，包括违反国家相关政策法规、侵犯第三方合法权益、调用非公开接口、实际用途与申请信息不符等。
+
+## 限流说明
+
+为确保系统安全并保障服务稳定运行，115生活开放平台对所有 API 实施频率控制策略。出于安全防护需要，相关策略细则暂不公开，平台会持续动态优化该机制。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,60 @@
+# 授权错误码
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 文档名称       | 授权错误码                           |
+| 文档版本       | v1.0                             |
+
+| 错误码    | 描述                                  | 建议                                                           |
+|:-------|:------------------------------------|:-------------------------------------------------------------|
+| 40100000 | 参数缺失                                | -                                                            |
+| 40101017 | 用户验证失败                              | -                                                            |
+| 40110000 | 请求异常，需要重试                           | -                                                            |
+| 40140100 | `client_id` 错误                       | -                                                            |
+| 40140101 | `code_challenge` 必填                  | -                                                            |
+| 40140102 | `code_challenge_method` 必须是 `sha256`、`sha1`、`md5` 之一 | - |
+| 40140103 | `sign` 必填                            | -                                                            |
+| 40140104 | `sign` 签名失败                         | -                                                            |
+| 40140105 | 生成二维码失败                             | -                                                            |
+| 40140106 | AppID 无效                              | -                                                            |
+| 40140107 | 应用不存在                               | -                                                            |
+| 40140108 | 应用未审核通过                             | -                                                            |
+| 40140109 | 应用已被停用                              | -                                                            |
+| 40140110 | 应用已过期                               | -                                                            |
+| 40140111 | AppSecret 错误                          | -                                                            |
+| 40140112 | `code_verifier` 长度要求为 43 至 128 位     | -                                                            |
+| 40140113 | `code_verifier` 验证失败                 | -                                                            |
+| 40140114 | `refresh_token` 格式错误(防篡改)           | -                                                            |
+| 40140115 | `refresh_token` 签名校验失败(防篡改)         | -                                                            |
+| 40140116 | `refresh_token` 无效(已解除授权)            | 重新授权。终态错误，重试不会成功；继续重试将被标记为永久失效，见 `40140137`      |
+| 40140117 | `access_token` 刷新太频繁                 | -                                                            |
+| 40140118 | 开发者认证已过期                            | -                                                            |
+| 40140119 | `refresh_token` 已过期                   | 重新授权。终态错误，重试不会成功；继续重试将被标记为永久失效，见 `40140137`      |
+| 40140120 | `refresh_token` 检验失败(防篡改)            | 调用 `/open/refreshToken` 后会重新生成 `refresh_token`，检查本地是否已更新其值。终态错误，持续用旧值重试将被标记为永久失效，见 `40140137` |
+| 40140121 | `access_token` 刷新失败                  | 重试                                                           |
+| 40140122 | 超出授权应用数量上限                          | -                                                            |
+| 40140123 | `access_token` 格式错误(防篡改)            | -                                                            |
+| 40140124 | `access_token` 签名校验失败(防篡改)          | -                                                            |
+| 40140125 | `access_token` 无效(已过期、已解除授权或授权缓存不存在) | 调用 `/open/refreshToken` 获取新凭证；若 `refresh_token` 无效或已过期，重新授权 |
+| 40140126 | `access_token` 与当前授权记录不匹配           | 重新读取刷新后保存的最新凭证，禁止使用原 `access_token` 重试；没有可用新凭证时调用 `/open/refreshToken` |
+| 40140127 | `response_type` 错误                    | -                                                            |
+| 40140128 | `redirect_uri` 缺少协议                  | -                                                            |
+| 40140129 | `redirect_uri` 缺少域名                  | -                                                            |
+| 40140130 | 没有配置重定向域名                           | 到应用管理中配置域名                                                  |
+| 40140131 | `redirect_uri` 域名不合法                | 需要与应用管理中配置的应用域名一致                                           |
+| 40140132 | `grant_type` 错误                       | -                                                            |
+| 40140133 | `client_secret` 验证失败                 | -                                                            |
+| 40140134 | 授权码 `code` 验证失败                     | -                                                            |
+| 40140135 | `client_id` 验证失败                    | -                                                            |
+| 40140136 | `redirect_uri` 验证失败(防 MITM 攻击)      | -                                                            |
+| 40140137 | `refresh_token` 已失效，请停止重试并重新授权(终态) | 同一 `refresh_token` 连续多次以 `40140116`/`40140119`/`40140120` 失败后被服务端标记为永久失效。收到后必须停止用该令牌重试，引导用户重新授权；重新授权产生的新令牌不受影响 |
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
+| 2026年08月10日(周一) 10:23:15 | 修正 `40140125`、`40140126` 的原因及处理建议 |
+| 2026年08月24日(周一) 10:16:52 | 新增终态错误码 `40140137`，补充 `40140116`/`40140119`/`40140120` 的永久失效判定说明 |
@@ -0,0 +1,92 @@
+## 刷新access_token
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 刷新access_token                   |
+| 接口版本       | v1.0                             |
+| 接口路径       | /refreshToken                    |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+该接口用于通过 `refresh_token` 获取新的 `access_token` 和 `refresh_token`。
+
+### 接口地址
+
+```
+https://passportapi.115.com/open/refreshToken
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: application/x-www-form-urlencoded
+```
+
+### 认证方式
+
+```
+OAuth 2.0 刷新凭证
+```
+
+### 请求参数
+
+| 参数名          | 类型     | 必填 | 默认值 | 说明                   | 约束/示例                       |
+|:-------------|:-------|:---|:----|:---------------------|:----------------------------|
+| refresh_token | string | 是  | -   | 用于刷新访问凭证的刷新凭证        | `REFRESH_TOKEN_PLACEHOLDER` |
+
+### 请求示例
+
+```shell
+curl 'https://passportapi.115.com/open/refreshToken' \
+  -H 'Content-Type: application/x-www-form-urlencoded' \
+  --data-urlencode 'refresh_token=REFRESH_TOKEN_PLACEHOLDER'
+```
+
+### 响应字段说明
+
+| 字段                 | 类型     | 描述                                  |
+|:-------------------|:-------|:------------------------------------|
+| state              | int    | 状态码                                 |
+| code               | int    | 错误码                                 |
+| message            | string | 响应信息                                |
+| data               | object | 响应数据                                |
+| data.access_token  | string | 新的 `access_token`，同时刷新有效期            |
+| data.refresh_token | string | 新的 `refresh_token`，其有效期不延长、不改变       |
+| data.expires_in    | int    | `access_token` 有效期，单位为秒               |
+
+### 响应示例
+
+```json
+{
+  "state": 1,
+  "code": 0,
+  "message": "",
+  "data": {
+    "access_token": "ACCESS_TOKEN_PLACEHOLDER",
+    "refresh_token": "REFRESH_TOKEN_PLACEHOLDER",
+    "expires_in": 7200
+  }
+}
+```
+
+### 注意事项
+
+- `access_token` 有效期为 7200 秒，调用方应以响应中的 `expires_in` 计算刷新时间。
+- 同一授权在 60 秒内重复刷新会触发频率控制；多进程或多节点调用方应确保同一授权同一时间只有一个刷新请求。
+- 调用后会同时生成新的 `access_token` 和 `refresh_token`。调用方必须将两者作为一组原子保存，并停止使用刷新前的旧凭证；刷新凭证本身的有效期不延长、不改变。
+- 收到 `40140125` 或 `40140126` 时，不要使用原 `access_token` 重复重试。应先读取已保存的最新凭证；没有可用新凭证时，再调用本接口刷新。
+- `40140116`、`40140119`、`40140120` 是终态错误，用同一个 `refresh_token` 重试永远不会成功。同一 `refresh_token` 连续多次以这三种原因失败会被服务端标记为永久失效，之后每次刷新都直接返回 `40140137`。客户端收到这三种错误或 `40140137` 时必须停止重试，引导用户重新授权；后台常驻程序（如 NAS 同步任务）尤其要实现该逻辑，避免长期无效轮询。
+- `access_token` 和 `refresh_token` 属于敏感凭证，不得写入公开仓库、客户端日志或公开沟通内容。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
+| 2026年08月10日(周一) 10:23:15 | 修正 `access_token` 有效期示例，补充凭证轮换及并发刷新说明 |
+| 2026年08月24日(周一) 10:16:52 | 新增 `refresh_token` 永久失效判定规则与终态错误码 `40140137` 说明 |
@@ -0,0 +1,88 @@
+## 获取access_token
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 获取access_token                   |
+| 接口版本       | v1.0                             |
+| 接口路径       | /deviceCodeToToken               |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+该接口用于在用户确认手机扫码授权后，使用设备码和 PKCE 原始校验值换取 `access_token`。
+
+### 接口地址
+
+```
+https://passportapi.115.com/open/deviceCodeToToken
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: application/x-www-form-urlencoded
+```
+
+### 认证方式
+
+```
+OAuth 2.0 + PKCE
+```
+
+### 请求参数
+
+| 参数名        | 类型     | 必填 | 默认值 | 说明                              | 约束/示例                                                          |
+|:-----------|:-------|:---|:----|:--------------------------------|:---------------------------------------------------------------|
+| uid        | string | 是  | -   | 二维码 ID/设备码                      | `DEVICE_CODE_PLACEHOLDER`                                      |
+| code_verifier | string | 是  | -   | 计算 `code_challenge` 时使用的原始随机字符串 | `IGKN6CJanWxCDPDhHZJrhswQdlcPBGLqExkhyujysXaQ4fJKBk_6dlPJo47s` |
+
+### 请求示例
+
+```shell
+curl 'https://passportapi.115.com/open/deviceCodeToToken' \
+  -H 'Content-Type: application/x-www-form-urlencoded' \
+  --data-urlencode 'uid=DEVICE_CODE_PLACEHOLDER' \
+  --data-urlencode 'code_verifier=IGKN6CJanWxCDPDhHZJrhswQdlcPBGLqExkhyujysXaQ4fJKBk_6dlPJo47s'
+```
+
+### 响应字段说明
+
+| 字段                 | 类型     | 描述                              |
+|:-------------------|:-------|:--------------------------------|
+| state              | int    | 状态码                             |
+| code               | int    | 错误码                             |
+| message            | string | 响应信息                            |
+| data               | object | 响应数据                            |
+| data.access_token  | string | 访问资源接口的凭证                       |
+| data.refresh_token | string | 刷新 `access_token` 的凭证，有效期 1 年     |
+| data.expires_in    | int    | `access_token` 有效期，单位为秒           |
+
+### 响应示例
+
+```json
+{
+  "state": 1,
+  "code": 0,
+  "message": "",
+  "data": {
+    "access_token": "ACCESS_TOKEN_PLACEHOLDER",
+    "refresh_token": "REFRESH_TOKEN_PLACEHOLDER",
+    "expires_in": 7200
+  }
+}
+```
+
+### 注意事项
+
+- `code_verifier` 必须与生成 `code_challenge` 时使用的原始值一致。
+- `access_token` 和 `refresh_token` 属于敏感凭证，不得写入公开仓库、客户端日志或公开沟通内容。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,103 @@
+## 获取设备码和二维码内容
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 获取设备码和二维码内容                    |
+| 接口版本       | v1.0                             |
+| 接口路径       | /authDeviceCode                  |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+该接口用于 OAuth 2.0 + PKCE 手机扫码授权流程的第一步，获取设备码和二维码内容。此模式适用于无后端服务的第三方客户端，无需提供 AppSecret。
+
+第三方客户端需要根据响应中的 `data.qrcode` 生成二维码，供 115 客户端扫码授权。
+
+### 接口地址
+
+```
+https://passportapi.115.com/open/authDeviceCode
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: application/x-www-form-urlencoded
+```
+
+### 认证方式
+
+```
+OAuth 2.0 + PKCE
+```
+
+### 请求参数
+
+| 参数名                  | 类型     | 必填 | 默认值 | 说明                              | 约束/示例                                                      |
+|:---------------------|:-------|:---|:----|:--------------------------------|:-----------------------------------------------------------|
+| client_id            | string | 是  | -   | AppID                           | `YOUR_APP_ID`                                              |
+| code_challenge       | string | 是  | -   | PKCE 挑战码                        | `THHodGWg-FZfv8XYz7QArNGIK_aVomSHPldlSOTUtkw`              |
+| code_challenge_method | string | 是  | -   | `code_challenge` 的哈希算法，见下方枚举表格 | `sha256`                                                   |
+
+#### 请求参数中的 code_challenge_method 字段枚举
+
+| 值      | 说明                         | 备注 |
+|:-------|:---------------------------|:---|
+| md5    | 使用 MD5 计算挑战码               | -  |
+| sha1   | 使用 SHA-1 计算挑战码             | -  |
+| sha256 | 使用 SHA-256 计算挑战码，推荐使用      | -  |
+
+### 请求示例
+
+```shell
+curl 'https://passportapi.115.com/open/authDeviceCode' \
+  -H 'Content-Type: application/x-www-form-urlencoded' \
+  --data-urlencode 'client_id=YOUR_APP_ID' \
+  --data-urlencode 'code_challenge=THHodGWg-FZfv8XYz7QArNGIK_aVomSHPldlSOTUtkw' \
+  --data-urlencode 'code_challenge_method=sha256'
+```
+
+### 响应字段说明
+
+| 字段         | 类型   | 描述                                        |
+|:-----------|:-----|:------------------------------------------|
+| state      | int  | 状态码                                       |
+| code       | int  | 错误码                                       |
+| message    | string | 响应信息                                    |
+| data       | object | 响应数据                                    |
+| data.uid   | string | 设备码，轮询二维码状态时使用                         |
+| data.time  | int    | 校验时间戳，轮询二维码状态时使用                       |
+| data.qrcode | string | 二维码内容，第三方客户端需要据此生成设备二维码                |
+| data.sign  | string | 校验签名，轮询二维码状态时使用                         |
+
+### 响应示例
+
+```json
+{
+  "state": 1,
+  "code": 0,
+  "message": "",
+  "data": {
+    "uid": "DEVICE_CODE_PLACEHOLDER",
+    "time": 0,
+    "qrcode": "QRCODE_CONTENT_PLACEHOLDER",
+    "sign": "SIGN_PLACEHOLDER"
+  }
+}
+```
+
+### 注意事项
+
+- `code_verifier` 为长度 43 至 128 位的随机字符串。
+- `code_challenge` 的计算方式为 `url_safe(base64_encode(hash(code_verifier)))`。哈希结果按二进制数据参与 Base64 编码，算法需要与 `code_challenge_method` 一致。
+- AppID 等应用凭证请使用实际应用配置，不要在公开仓库或日志中记录敏感凭证。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,89 @@
+## 轮询二维码状态
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 轮询二维码状态                         |
+| 接口版本       | v1.0                             |
+| 接口路径       | /get/status/                     |
+| 请求方法       | GET                              |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+该接口用于长轮询设备二维码的扫码和授权状态。当二维码状态没有变化时，接口不会立即响应，直到请求超时或状态发生变化。
+
+### 接口地址
+
+```
+https://qrcodeapi.115.com/get/status/
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+设备码参数校验
+```
+
+### 请求参数
+
+| 参数名 | 类型     | 必填 | 默认值 | 说明                                  | 约束/示例                   |
+|:----|:-------|:---|:----|:------------------------------------|:------------------------|
+| uid  | string | 是  | -   | 二维码 ID/设备码，从 `/open/authDeviceCode` 的 `data.uid` 获取 | `DEVICE_CODE_PLACEHOLDER` |
+| time | int    | 是  | -   | 校验时间戳，从 `/open/authDeviceCode` 的 `data.time` 获取      | `0`                      |
+| sign | string | 是  | -   | 校验签名，从 `/open/authDeviceCode` 的 `data.sign` 获取        | `SIGN_PLACEHOLDER`       |
+
+### 请求示例
+
+```shell
+curl -G 'https://qrcodeapi.115.com/get/status/' \
+  --data-urlencode 'uid=DEVICE_CODE_PLACEHOLDER' \
+  --data-urlencode 'time=0' \
+  --data-urlencode 'sign=SIGN_PLACEHOLDER'
+```
+
+### 响应字段说明
+
+| 字段          | 类型     | 描述                                         |
+|:------------|:-------|:-------------------------------------------|
+| state       | int    | 轮询状态：0-二维码无效，结束轮询；1-继续轮询                |
+| code        | int    | 错误码                                        |
+| message     | string | 响应信息                                       |
+| data        | object | 响应数据；115 客户端扫码或输入设备码后才有值               |
+| data.msg    | string | 操作提示                                       |
+| data.status | int    | 二维码状态：1-扫码成功，等待确认；2-确认登录或授权，结束轮询       |
+| data.version | string | 版本信息                                      |
+
+### 响应示例
+
+```json
+{
+  "state": 1,
+  "code": 0,
+  "message": "",
+  "data": {
+    "msg": "OPERATION_MESSAGE_PLACEHOLDER",
+    "status": 1,
+    "version": "VERSION_PLACEHOLDER"
+  }
+}
+```
+
+### 注意事项
+
+- `state=0` 表示二维码无效，应结束轮询；`state=1` 表示继续轮询。
+- `data.status=1` 表示扫码成功并等待用户确认；`data.status=2` 表示用户已确认登录或授权，应结束轮询并进入换取访问凭证的步骤。
+- 长轮询超时不等同于授权失败，客户端可以按照自身网络策略重新发起请求。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,95 @@
+## 用授权码换取access_token
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 用授权码换取access_token                |
+| 接口版本       | v1.0                             |
+| 接口路径       | /authCodeToToken                 |
+| 请求方法       | POST                             |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+该接口用于通过授权码换取 `access_token`。建议在开发者服务端调用，避免泄露 AppSecret。
+
+### 接口地址
+
+```
+https://passportapi.115.com/open/authCodeToToken
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: application/x-www-form-urlencoded
+```
+
+### 认证方式
+
+```
+OAuth 2.0 授权码模式
+```
+
+### 请求参数
+
+| 参数名          | 类型     | 必填 | 默认值 | 说明                                  | 约束/示例                         |
+|:-------------|:-------|:---|:----|:------------------------------------|:------------------------------|
+| client_id    | string | 是  | -   | AppID                               | `YOUR_APP_ID`                 |
+| client_secret | string | 是  | -   | AppSecret                           | `YOUR_APP_SECRET`             |
+| code         | string | 是  | -   | 请求授权接口重定向返回的授权码                    | `AUTHORIZATION_CODE_PLACEHOLDER` |
+| redirect_uri | string | 是  | -   | 与请求授权时传入的 `redirect_uri` 一致，用于防止 MITM 和 CSRF 攻击 | `https://foo.com?state=123456` |
+| grant_type   | string | 是  | -   | 授权类型，固定为 `authorization_code`         | `authorization_code`          |
+
+### 请求示例
+
+```shell
+curl 'https://passportapi.115.com/open/authCodeToToken' \
+  -H 'Content-Type: application/x-www-form-urlencoded' \
+  --data-urlencode 'client_id=YOUR_APP_ID' \
+  --data-urlencode 'client_secret=YOUR_APP_SECRET' \
+  --data-urlencode 'code=AUTHORIZATION_CODE_PLACEHOLDER' \
+  --data-urlencode 'redirect_uri=https://foo.com?state=123456' \
+  --data-urlencode 'grant_type=authorization_code'
+```
+
+### 响应字段说明
+
+| 字段                 | 类型     | 描述                              |
+|:-------------------|:-------|:--------------------------------|
+| state              | int    | 状态码：0-失败；1-成功                   |
+| code               | int    | 错误码                             |
+| message            | string | 响应信息                            |
+| data               | object | 响应数据                            |
+| data.access_token  | string | 访问资源接口的凭证                       |
+| data.refresh_token | string | 刷新 `access_token` 的凭证，有效期 1 年     |
+| data.expires_in    | int    | `access_token` 有效期，单位为秒           |
+
+### 响应示例
+
+```json
+{
+  "state": 1,
+  "code": 0,
+  "message": "",
+  "data": {
+    "access_token": "ACCESS_TOKEN_PLACEHOLDER",
+    "refresh_token": "REFRESH_TOKEN_PLACEHOLDER",
+    "expires_in": 7200
+  }
+}
+```
+
+### 注意事项
+
+- 必须在服务端安全保存并使用 AppSecret，不得在客户端代码、公开仓库或日志中泄露。
+- `redirect_uri` 必须与请求授权时传入的值一致。
+- `access_token` 和 `refresh_token` 属于敏感凭证，应按照敏感数据规范存储。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,87 @@
+## 请求授权
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 接口名称       | 请求授权                             |
+| 接口版本       | v1.0                             |
+| 接口路径       | /authorize                        |
+| 请求方法       | GET                              |
+| 接口状态       | 生产环境                             |
+
+### 接口说明
+
+该接口用于发起 OAuth 2.0 授权码模式授权，建议由开发者服务端参与授权流程。
+
+用户未登录时，接口会重定向到登录页面；用户已登录时，接口会自动完成授权并重定向到 `redirect_uri` 指定的地址。
+
+### 接口地址
+
+```
+https://passportapi.115.com/open/authorize
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+OAuth 2.0 授权码模式
+```
+
+### 请求参数
+
+| 参数名        | 类型     | 必填 | 默认值 | 说明                                             | 约束/示例                |
+|:-----------|:-------|:---|:----|:-----------------------------------------------|:---------------------|
+| client_id  | string | 是  | -   | AppID                                          | `YOUR_APP_ID`        |
+| redirect_uri | string | 是  | -   | 授权完成后的重定向地址；接口会附加授权码 `code`，并原样附加请求中的 `state` | `https://foo.com/bar` |
+| response_type | string | 是  | -   | 授权模式，固定为 `code`                               | `code`               |
+| state      | string | 否  | ""  | 防止 CSRF 攻击的随机值，重定向时原样返回                      | `123456`             |
+
+### 请求示例
+
+```shell
+curl -G 'https://passportapi.115.com/open/authorize' \
+  --data-urlencode 'client_id=YOUR_APP_ID' \
+  --data-urlencode 'redirect_uri=https://foo.com/bar' \
+  --data-urlencode 'response_type=code' \
+  --data-urlencode 'state=123456'
+```
+
+### 响应字段说明
+
+接口调用成功时会重定向到 `redirect_uri`，并通过查询参数返回授权码 `code` 和请求中携带的 `state`。接口调用失败时返回以下字段：
+
+| 字段      | 类型     | 描述                |
+|:--------|:-------|:------------------|
+| state   | int    | 状态码：0-失败；1-成功     |
+| code    | int    | 错误码               |
+| data    | object | 响应数据              |
+| message | string | 响应信息              |
+
+### 响应示例
+
+```json
+{
+  "state": 0,
+  "code": 40140127,
+  "data": {},
+  "message": "response_type 错误"
+}
+```
+
+### 注意事项
+
+- `redirect_uri` 需要先在[115生活开放平台](https://open.115.com/)的应用管理中配置域名，并在请求时进行 URL 编码。
+- 强烈建议传入随机 `state`，并在换取 `access_token` 前验证重定向返回的 `state` 与请求值一致，以防止 CSRF 攻击。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,57 @@
+# 接入流程
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 文档名称       | 接入流程                             |
+| 文档版本       | v1.0                             |
+
+## 1. 注册“115生活”账号
+
+在使用 115 开放平台服务之前，开发者需要先通过[“115生活”官网](https://115.com/)注册“115生活”账号并登录，完成实名认证。
+
+## 2. 提交入驻申请
+
+访问[115生活开放平台](https://open.115.com/)，按照页面流程填写相关信息。
+
+### 2.1 选择开发者身份类型
+
+开发者可以申请成为“个人开发者”或“企业开发者”。点击页面上方的“切换申请类型”，可以切换身份类型。
+
+### 2.2 签署协议
+
+认真阅读并确认相关协议内容；如无异议，勾选“同意”并点击“下一步”。
+
+### 2.3 填写入驻资料
+
+按照页面指引填写个人信息、API 对接需求、应用场景等入驻资料，然后点击“下一步”。
+
+### 2.4 填写认证信息
+
+根据所选择的开发者身份类型，按照页面指引填写并上传身份认证资料：
+
+- **个人开发者**：姓名、身份证信息(证件号码、有效期)、证件照片(身份证件正反面照片、本人手持身份证照片)。
+- **企业开发者**：企业负责人或法人的姓名、联系方式、身份证信息(证件号码、有效期)、证件照片(身份证件正反面照片、加盖公章的营业执照影印件)、统一社会信用代码。
+
+### 2.5 提交入驻申请
+
+确认上述信息填写无误后，点击“提交验证”提交入驻申请。平台将在 7 个工作日内完成审核。
+
+## 3. 创建应用
+
+入驻申请通过后，进入 115 生活开放平台管理页面，选择“应用管理”，点击“创建应用”，按照页面指引填写应用信息、应用域名、应用描述、接口信息等内容。确认信息填写无误后提交应用申请，平台将在 7 个工作日内完成审核。
+
+应用审核通过后，开发者可以获取该应用的 AppID、AppKey 和 AppSecret 等接入凭证。请妥善保存这些凭证，不要在客户端代码、公开仓库或沟通内容中泄露。
+
+## 4. 接口调试
+
+按照开放平台接口文档完成接入和调用后，即可正式使用开放平台能力。
+
+开放平台 API 基础域名：`https://proapi.115.com/`
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,23 @@
+# 更新记录
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 文档名称       | 更新记录                             |
+| 文档版本       | v1.0                             |
+
+## 更新内容
+
+| 更新模块       | 更新内容                     | 更新时间          |
+|:-----------|:-------------------------|:--------------|
+| 增值服务产品     | 新增增值服务产品，获得推广收益          | 2025年4月17日周四 |
+| 视频播放、云下载   | 新增视频播放、云下载接口             | 2025年4月3日周四  |
+| 接入授权       | 支持 H5 账号密码/短信授权           | 2025年4月2日周三  |
+| 基本框架       | 新增开放平台文档接口               | 2025年1月22日周三 |
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,30 @@
+# 概述
+
+### 基本信息
+
+| 属性         | 内容                               |
+|:-----------|:---------------------------------|
+| 文档名称       | 概述                               |
+| 文档版本       | v1.0                             |
+
+## 115生活简介
+
+“115生活”是一款面向个人用户的数字生活平台，提供海量数据的安全存储、多端同步与快速访问。用户不仅可以便捷地管理和使用各类数字资源，还能使用多维社交、生活服务等多元化功能。
+
+## 115生活开放平台能力说明
+
+115生活开放平台提供“115生活”数据存储、同步、管理等功能的 API 服务。开发者通过对接 API，可以将“115生活”的存储能力集成到自己的应用中。
+
+目前已开放以下能力：
+
+- **用户管理能力**：用户授权与信息查询等。
+- **文件管理能力**：获取文件列表，查看文件属性，以及文件上传、下载、搜索、移动、删除等。
+- **视频管理能力**：视频文件的在线转码与播放等。
+- **云下载服务**：获取云下载任务列表、配额信息，以及添加、删除下载任务等。
+- **商业价值转化**：开发者参与“推广产品得收益”计划，可基于用户实际购买的产品获取相应推广收益。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |
@@ -0,0 +1,67 @@
+# 115 开放平台文档（离线版）
+
+> 来源：https://open.115.com/doc/ （115生活开放平台开发者文档）
+> 抓取时间：2026-09-05，共 42 篇 Markdown 文档，目录结构与官网一致。
+> 目录索引：[tree-index.json](tree-index.json)（官网原始目录树，程序化遍历可用）。
+
+## 文档目录
+
+- [概述](115开放平台/简介/概述.md)
+- [更新记录](115开放平台/简介/更新记录.md)
+- [接入流程](115开放平台/接入指南/接入流程.md)
+- [开发须知](115开放平台/接入指南/开发须知.md)
+- [授权错误码](115开放平台/接入指南/授权错误码.md)
+- **接入授权/**
+  - **手机扫码授权PKCE模式/**
+    - [获取设备码和二维码内容](115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/获取设备码和二维码内容.md)
+    - [轮询二维码状态](115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/轮询二维码状态.md)
+    - [获取access_token](115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/获取access_token.md)
+  - **授权码模式/**
+    - [请求授权](115开放平台/接入指南/接入授权/授权码模式/请求授权.md)
+    - [用授权码换取access_token](115开放平台/接入指南/接入授权/授权码模式/用授权码换取access_token.md)
+  - [刷新access_token](115开放平台/接入指南/接入授权/刷新access_token.md)
+- [开发者商业价值转化：推广产品得收益](115开放平台/API列表/开发者商业价值转化：推广产品得收益.md)
+- **用户管理/**
+  - [用户信息](115开放平台/API列表/用户管理/用户信息.md)
+- **文件管理/**
+  - **文件上传/**
+    - [上传流程](115开放平台/API列表/文件管理/文件上传/上传流程.md)
+    - [获取上传凭证](115开放平台/API列表/文件管理/文件上传/获取上传凭证.md)
+    - [文件上传](115开放平台/API列表/文件管理/文件上传/文件上传.md)
+    - [断点续传](115开放平台/API列表/文件管理/文件上传/断点续传.md)
+  - [新建文件夹](115开放平台/API列表/文件管理/新建文件夹.md)
+  - [获取文件列表](115开放平台/API列表/文件管理/获取文件列表.md)
+  - **获取文件(夹)详情/**
+    - [按ID获取](115开放平台/API列表/文件管理/获取文件(夹)详情/按ID获取.md)
+    - [按路径获取](115开放平台/API列表/文件管理/获取文件(夹)详情/按路径获取.md)
+  - [文件搜索](115开放平台/API列表/文件管理/文件搜索.md)
+  - [文件复制](115开放平台/API列表/文件管理/文件复制.md)
+  - [文件移动](115开放平台/API列表/文件管理/文件移动.md)
+  - [获取文件下载地址](115开放平台/API列表/文件管理/获取文件下载地址.md)
+  - [文件(夹)更新](115开放平台/API列表/文件管理/文件(夹)更新.md)
+  - [删除文件](115开放平台/API列表/文件管理/删除文件.md)
+  - [回收站列表](115开放平台/API列表/文件管理/回收站列表.md)
+  - [回收站还原](115开放平台/API列表/文件管理/回收站还原.md)
+  - [删除或清空回收站](115开放平台/API列表/文件管理/删除或清空回收站.md)
+- **视频播放/**
+  - [记忆视频播放进度](115开放平台/API列表/视频播放/记忆视频播放进度.md)
+  - [视频字幕列表](115开放平台/API列表/视频播放/视频字幕列表.md)
+  - [获取视频播放进度](115开放平台/API列表/视频播放/获取视频播放进度.md)
+  - [获取视频在线播放地址](115开放平台/API列表/视频播放/获取视频在线播放地址.md)
+  - [提交视频转码](115开放平台/API列表/视频播放/提交视频转码.md)
+- **云下载/**
+  - [解析BT种子](115开放平台/API列表/云下载/解析BT种子.md)
+  - [获取用户云下载任务列表](115开放平台/API列表/云下载/获取用户云下载任务列表.md)
+  - [获取云下载配额信息](115开放平台/API列表/云下载/获取云下载配额信息.md)
+  - [清空云下载任务](115开放平台/API列表/云下载/清空云下载任务.md)
+  - [添加云下载链接任务](115开放平台/API列表/云下载/添加云下载链接任务.md)
+  - [删除用户云下载任务](115开放平台/API列表/云下载/删除用户云下载任务.md)
+  - [添加云下载BT任务](115开放平台/API列表/云下载/添加云下载BT任务.md)
+
+## API 接口速查
+
+主要 API 域名与认证方式（详见各文档）：
+
+- 开放 API 基础地址：`https://proapi.115.com/open/...`
+- 认证方式：`Authorization: Bearer access_token`
+- OAuth 授权相关文档见 `115开放平台/接入指南/接入授权/`
@@ -0,0 +1,308 @@
+{
+  "name": "doc",
+  "path": "/doc/",
+  "children": [
+    {
+      "name": "115开放平台",
+      "path": "/doc/115开放平台/",
+      "children": [
+        {
+          "name": "简介",
+          "path": "/doc/115开放平台/简介/",
+          "children": [
+            {
+              "name": "概述.md",
+              "path": "/doc/115开放平台/简介/概述.md",
+              "type": "file"
+            },
+            {
+              "name": "更新记录.md",
+              "path": "/doc/115开放平台/简介/更新记录.md",
+              "type": "file"
+            }
+          ],
+          "type": "directory"
+        },
+        {
+          "name": "接入指南",
+          "path": "/doc/115开放平台/接入指南/",
+          "children": [
+            {
+              "name": "接入流程.md",
+              "path": "/doc/115开放平台/接入指南/接入流程.md",
+              "type": "file"
+            },
+            {
+              "name": "开发须知.md",
+              "path": "/doc/115开放平台/接入指南/开发须知.md",
+              "type": "file"
+            },
+            {
+              "name": "授权错误码.md",
+              "path": "/doc/115开放平台/接入指南/授权错误码.md",
+              "type": "file"
+            },
+            {
+              "name": "接入授权",
+              "path": "/doc/115开放平台/接入指南/接入授权/",
+              "children": [
+                {
+                  "name": "手机扫码授权PKCE模式",
+                  "path": "/doc/115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/",
+                  "children": [
+                    {
+                      "name": "获取设备码和二维码内容.md",
+                      "path": "/doc/115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/获取设备码和二维码内容.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "轮询二维码状态.md",
+                      "path": "/doc/115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/轮询二维码状态.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "获取access_token.md",
+                      "path": "/doc/115开放平台/接入指南/接入授权/手机扫码授权PKCE模式/获取access_token.md",
+                      "type": "file"
+                    }
+                  ],
+                  "type": "directory"
+                },
+                {
+                  "name": "授权码模式",
+                  "path": "/doc/115开放平台/接入指南/接入授权/授权码模式/",
+                  "children": [
+                    {
+                      "name": "请求授权.md",
+                      "path": "/doc/115开放平台/接入指南/接入授权/授权码模式/请求授权.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "用授权码换取access_token.md",
+                      "path": "/doc/115开放平台/接入指南/接入授权/授权码模式/用授权码换取access_token.md",
+                      "type": "file"
+                    }
+                  ],
+                  "type": "directory"
+                },
+                {
+                  "name": "刷新access_token.md",
+                  "path": "/doc/115开放平台/接入指南/接入授权/刷新access_token.md",
+                  "type": "file"
+                }
+              ],
+              "type": "directory"
+            }
+          ],
+          "type": "directory"
+        },
+        {
+          "name": "API列表",
+          "path": "/doc/115开放平台/API列表/",
+          "children": [
+            {
+              "name": "开发者商业价值转化：推广产品得收益.md",
+              "path": "/doc/115开放平台/API列表/开发者商业价值转化：推广产品得收益.md",
+              "type": "file"
+            },
+            {
+              "name": "用户管理",
+              "path": "/doc/115开放平台/API列表/用户管理/",
+              "children": [
+                {
+                  "name": "用户信息.md",
+                  "path": "/doc/115开放平台/API列表/用户管理/用户信息.md",
+                  "type": "file"
+                }
+              ],
+              "type": "directory"
+            },
+            {
+              "name": "文件管理",
+              "path": "/doc/115开放平台/API列表/文件管理/",
+              "children": [
+                {
+                  "name": "文件上传",
+                  "path": "/doc/115开放平台/API列表/文件管理/文件上传/",
+                  "children": [
+                    {
+                      "name": "上传流程.md",
+                      "path": "/doc/115开放平台/API列表/文件管理/文件上传/上传流程.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "获取上传凭证.md",
+                      "path": "/doc/115开放平台/API列表/文件管理/文件上传/获取上传凭证.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "文件上传.md",
+                      "path": "/doc/115开放平台/API列表/文件管理/文件上传/文件上传.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "断点续传.md",
+                      "path": "/doc/115开放平台/API列表/文件管理/文件上传/断点续传.md",
+                      "type": "file"
+                    }
+                  ],
+                  "type": "directory"
+                },
+                {
+                  "name": "新建文件夹.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/新建文件夹.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取文件列表.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/获取文件列表.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取文件(夹)详情",
+                  "path": "/doc/115开放平台/API列表/文件管理/获取文件(夹)详情/",
+                  "children": [
+                    {
+                      "name": "按ID获取.md",
+                      "path": "/doc/115开放平台/API列表/文件管理/获取文件(夹)详情/按ID获取.md",
+                      "type": "file"
+                    },
+                    {
+                      "name": "按路径获取.md",
+                      "path": "/doc/115开放平台/API列表/文件管理/获取文件(夹)详情/按路径获取.md",
+                      "type": "file"
+                    }
+                  ],
+                  "type": "directory"
+                },
+                {
+                  "name": "文件搜索.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/文件搜索.md",
+                  "type": "file"
+                },
+                {
+                  "name": "文件复制.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/文件复制.md",
+                  "type": "file"
+                },
+                {
+                  "name": "文件移动.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/文件移动.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取文件下载地址.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/获取文件下载地址.md",
+                  "type": "file"
+                },
+                {
+                  "name": "文件(夹)更新.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/文件(夹)更新.md",
+                  "type": "file"
+                },
+                {
+                  "name": "删除文件.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/删除文件.md",
+                  "type": "file"
+                },
+                {
+                  "name": "回收站列表.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/回收站列表.md",
+                  "type": "file"
+                },
+                {
+                  "name": "回收站还原.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/回收站还原.md",
+                  "type": "file"
+                },
+                {
+                  "name": "删除或清空回收站.md",
+                  "path": "/doc/115开放平台/API列表/文件管理/删除或清空回收站.md",
+                  "type": "file"
+                }
+              ],
+              "type": "directory"
+            },
+            {
+              "name": "视频播放",
+              "path": "/doc/115开放平台/API列表/视频播放/",
+              "children": [
+                {
+                  "name": "记忆视频播放进度.md",
+                  "path": "/doc/115开放平台/API列表/视频播放/记忆视频播放进度.md",
+                  "type": "file"
+                },
+                {
+                  "name": "视频字幕列表.md",
+                  "path": "/doc/115开放平台/API列表/视频播放/视频字幕列表.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取视频播放进度.md",
+                  "path": "/doc/115开放平台/API列表/视频播放/获取视频播放进度.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取视频在线播放地址.md",
+                  "path": "/doc/115开放平台/API列表/视频播放/获取视频在线播放地址.md",
+                  "type": "file"
+                },
+                {
+                  "name": "提交视频转码.md",
+                  "path": "/doc/115开放平台/API列表/视频播放/提交视频转码.md",
+                  "type": "file"
+                }
+              ],
+              "type": "directory"
+            },
+            {
+              "name": "云下载",
+              "path": "/doc/115开放平台/API列表/云下载/",
+              "children": [
+                {
+                  "name": "解析BT种子.md",
+                  "path": "/doc/115开放平台/API列表/云下载/解析BT种子.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取用户云下载任务列表.md",
+                  "path": "/doc/115开放平台/API列表/云下载/获取用户云下载任务列表.md",
+                  "type": "file"
+                },
+                {
+                  "name": "获取云下载配额信息.md",
+                  "path": "/doc/115开放平台/API列表/云下载/获取云下载配额信息.md",
+                  "type": "file"
+                },
+                {
+                  "name": "清空云下载任务.md",
+                  "path": "/doc/115开放平台/API列表/云下载/清空云下载任务.md",
+                  "type": "file"
+                },
+                {
+                  "name": "添加云下载链接任务.md",
+                  "path": "/doc/115开放平台/API列表/云下载/添加云下载链接任务.md",
+                  "type": "file"
+                },
+                {
+                  "name": "删除用户云下载任务.md",
+                  "path": "/doc/115开放平台/API列表/云下载/删除用户云下载任务.md",
+                  "type": "file"
+                },
+                {
+                  "name": "添加云下载BT任务.md",
+                  "path": "/doc/115开放平台/API列表/云下载/添加云下载BT任务.md",
+                  "type": "file"
+                }
+              ],
+              "type": "directory"
+            }
+          ],
+          "type": "directory"
+        }
+      ],
+      "type": "directory"
+    }
+  ],
+  "type": "directory"
+}
@@ -1,6 +1,6 @@
 # 贡献规范

-感谢你愿意帮助 MMTL 变得更稳定。这个项目主要面向 NAS、Docker 部署、媒体库整理、订阅下载和多端播放场景；提交 Issue 或 Pull Request 时，请尽量提供可复现、可验证的信息。
+感谢你愿意帮助 MeBox 变得更稳定。这个项目主要面向 NAS、Docker 部署、媒体库整理、订阅下载和多端播放场景；提交 Issue 或 Pull Request 时，请尽量提供可复现、可验证的信息。

 ## Issue 提交规范

@@ -16,7 +16,7 @@
 - 期望行为：你认为正确结果应该是什么。
 - 复现步骤：从哪个页面、点击什么、填写什么、触发什么任务。
 - 部署方式：Docker 第一档 / 第二档 / 第三档、裸机运行、反代方式等。
- 环境信息：NAS 型号或系统、Docker / Compose 版本、浏览器、MMTL 镜像版本。
+- 环境信息：NAS 型号或系统、Docker / Compose 版本、浏览器、MeBox 镜像版本。
 - 相关配置：路径映射、下载器保存路径、媒体库路径、站点类型等。请隐藏 Cookie、API Key、密码和 Token。
 - 日志和任务信息：优先提供应用日志、任务队列详情、浏览器控制台错误、网络请求错误。

@@ -28,14 +28,14 @@ Docker 部署常用命令：

 ```bash
 docker compose ps
-docker compose logs --tail=300 mmtl
-docker compose exec mmtl sh -lc 'ls -la /data/logs || true'
+docker compose logs --tail=300 mebox
+docker compose exec mebox sh -lc 'ls -la /data/logs || true'
 ```

 PostgreSQL 部署查询示例：

 ```bash
-docker compose exec postgres psql -U mmtl -d mmtl -c "select key,value,updated_at from settings order by updated_at desc limit 30;"
+docker compose exec postgres psql -U mebox -d mebox -c "select key,value,updated_at from settings order by updated_at desc limit 30;"
 ```

 请勿公开粘贴以下敏感信息：
@@ -1,6 +1,6 @@
 # syntax=docker/dockerfile:1.6
 # =============================================================================
-# Multi-architecture build for MMTL.
+# Multi-architecture build for MeBox.
 #
 # Stage 1 (frontend) :  Node 20  -> static SPA bundle
 # Stage 2 (backend)  :  Go 1.25  -> single static binary (CGO_ENABLED=0)
@@ -8,7 +8,7 @@
 #
 # Build:
 #   docker buildx build --platform linux/amd64,linux/arm64 \
-#     --build-arg VERSION=MMTL-v0.1.16 -t mmtl:latest --push .
+#     --build-arg VERSION=MeBox-v0.1.16 -t mebox:latest --push .
 #
 # Optional Intel VAAPI/QSV runtime packages:
 #   docker buildx build --build-arg WITH_VAAPI=true ...
@@ -39,7 +39,7 @@ COPY . .
 COPY --from=frontend /app/web/dist ./web/dist
 RUN --mount=type=cache,target=/go/pkg/mod \
    CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} \
-    go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o mmtl ./cmd/server
+    go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o mebox ./cmd/server

 # ---- Stage 3: runtime ------------------------------------------------------
 FROM alpine:3.23
@@ -64,22 +64,22 @@ RUN apk add --no-cache \
    && rm -rf /var/cache/apk/*

 # Non-root user for the long-running process.
-RUN addgroup -S mmtl && adduser -S mmtl -G mmtl
+RUN addgroup -S mebox && adduser -S mebox -G mebox

 WORKDIR /app
-COPY --from=backend /app/mmtl /usr/local/bin/mmtl
+COPY --from=backend /app/mebox /usr/local/bin/mebox
 COPY --from=frontend /app/web/dist /app/web/dist

 RUN mkdir -p /data /cache /media \
-    && chown -R mmtl:mmtl /data /cache /media
+    && chown -R mebox:mebox /data /cache /media

 # Default environment (overridable via docker-compose / `docker run -e`).
-ENV MMTL_APP_PORT=8080 \
-    MMTL_APP_DATA_DIR=/data \
-    MMTL_APP_WEB_DIR=/app/web/dist \
-    MMTL_DATABASE_DB_PATH=/data/mmtl.db \
-    MMTL_CACHE_CACHE_DIR=/cache \
-    MMTL_LOGGING_LEVEL=info \
+ENV MEBOX_APP_PORT=8080 \
+    MEBOX_APP_DATA_DIR=/data \
+    MEBOX_APP_WEB_DIR=/app/web/dist \
+    MEBOX_DATABASE_DB_PATH=/data/mebox.db \
+    MEBOX_CACHE_CACHE_DIR=/cache \
+    MEBOX_LOGGING_LEVEL=info \
    TZ=Asia/Shanghai

 EXPOSE 8080
@@ -1,13 +1,13 @@
-# MMTL (My Movie and TV Library)
+# MeBox

 <p align="center">
-  <img src="web/public/brand/logo-192.png" width="96" height="96" alt="MMTL Logo" />
+  <img src="web/public/brand/logo-192.png" width="96" height="96" alt="MeBox Logo" />
 </p>

 <h3 align="center">面向 NAS 与家庭影音场景的私人媒体中心</h3>

 <p align="center">
-  <strong>媒体库 · 刮削整理 · 网盘 STRM · Emby 协议 · 远程 Emby 挂载 · 多用户权限 · Docker 一键部署</strong>
+  <strong>媒体库 · 刮削整理 · 网盘 STRM · 兼容 Emby/Jellyfin 客户端 · 远程 Emby 挂载 · 多用户权限 · Docker 一键部署</strong>
 </p>

 <p align="center">
@@ -17,7 +17,8 @@
  <a href="#鸣谢">鸣谢</a> ·
  <a href="#开发构建">开发构建</a> ·
  <a href="README_EN.md">English</a> ·
-  <a href="CONTRIBUTING.md">贡献规范</a>
+  <a href="CONTRIBUTING.md">贡献规范</a> ·
+  <a href="https://t.me/MeBoxGroup">Telegram 群组</a>
 </p>

 <p align="center">
@@ -31,9 +32,9 @@

 ## 项目简介

-**MMTL** 是一个自托管私人媒体管理系统，适合 NAS、小主机、家庭共享和多端播放场景。本项目由 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) fork 并持续二开维护，在保留「一套服务覆盖网页、手机、电视与第三方播放器」思路的同时，围绕网盘播放、任务队列、远程挂载和权限体系做了大量增强。
+**MeBox** 是一个自托管私人媒体管理系统，适合 NAS、小主机、家庭共享和多端播放场景。本项目由 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) fork 并持续二开维护，在保留「一套服务覆盖网页、手机、电视与第三方播放器」思路的同时，围绕网盘播放、任务队列、远程挂载和权限体系做了大量增强。

-你可以把 MMTL 理解为：
+你可以把 MeBox 理解为：

 - 一个带现代 Web UI 的**媒体库后台**
 - 一个兼容 Emby/Jellyfin 客户端的**协议网关**
@@ -46,12 +47,12 @@
 | **媒体库** | 电影、电视剧、动漫、综艺、音乐与自定义库；多根目录、扫库、海报墙、继续观看 |
 | **元数据刮削** | TMDb、Bangumi、Douban、TheTVDB、Fanart 等；支持 NFO、手动匹配、刮削队列 |
 | **播放** | 网页播放器、HLS 转码、弹幕、字幕、播放配置档、观看历史与收藏 |
-| **Emby 协议** | Infuse、SenPlayer、Fileball 等客户端可直接添加本服务，使用 MMTL 账号登录 |
+| **Emby/Jellyfin 客户端兼容** | 内置完整 Emby 服务端协议实现：Infuse、SenPlayer、Fileball、Emby/Jellyfin 官方客户端等可直接把本服务当作 Emby 服务器添加，使用 MeBox 账号登录，海报墙、进度同步、多用户无缝衔接 |
 | **远程 Emby 挂载** | 将远程 Emby 媒体库挂载到本地界面统一浏览（无需单独开 Emby 客户端） |
 | **网盘与 STRM** | OpenList、CloudDrive2、115、WebDAV 等；STRM 同步、上传/下载队列、直链/302 播放 |
-| **下载与整理** | qBittorrent 接入、站点搜索与订阅、下载后自动整理、文件管理器（复制/移动/硬链/软链） |
+| **下载与整理** | 下载目录定时自动整理（智能分类、自动注册媒体库）、文件管理器（复制/移动/硬链/软链） |
 | **用户与权限** | 管理员/普通用户、有效期、成人内容开关、播放配置 PIN、细粒度操作权限 |
-| **运维能力** | 统一任务队列、回收站、存储统计、DLNA 投屏、系统设置与日志 |
+| **运维能力** | 统一任务队列、存储统计、DLNA 投屏、系统设置与日志 |

 ### 技术栈

@@ -66,13 +67,13 @@
 推荐使用 Docker Compose。仓库提供四份**互相独立**的完整模板，无需 `.env` 即可起步。

 ```bash
-mkdir -p MMTL && cd MMTL
+mkdir -p MeBox && cd MeBox

 # 最省心：单镜像 + 内置 SQLite
-curl -fsSL https://raw.githubusercontent.com/truewhile/MMTL/main/docker-compose.simple.yml -o docker-compose.yml
+curl -fsSL https://raw.githubusercontent.com/truewhile/MeBox/main/docker-compose.simple.yml -o docker-compose.yml

 # 或多用户场景：PostgreSQL 第一档
-# curl -fsSL https://raw.githubusercontent.com/truewhile/MMTL/main/docker-compose.yml -o docker-compose.yml
+# curl -fsSL https://raw.githubusercontent.com/truewhile/MeBox/main/docker-compose.yml -o docker-compose.yml

 docker compose up -d
 ```
@@ -85,10 +86,12 @@ http://服务器IP:18080

 默认账号：`admin` / `admin123`（首次登录后请立即修改密码）

+> 💡 **Emby 用户无缝切换**：MeBox 完整兼容 Emby/Jellyfin 客户端协议。手机、电视、平板上的 Infuse、SenPlayer、Fileball、Emby/Jellyfin 官方客户端，直接按「添加 Emby 服务器」填入 `http://服务器IP:18080`，用 MeBox 账号登录即可，无需改变原有使用习惯。
+
 镜像地址：

 ```text
-ghcr.io/truewhile/mmtl:latest
+ghcr.io/truewhile/mebox:latest
 ```

 ---
@@ -99,16 +102,16 @@ ghcr.io/truewhile/mmtl:latest

 | 档位 | 配置文件 | 组件 | 适合场景 |
 | --- | --- | --- | --- |
-| 单镜像档 | `docker-compose.simple.yml` | MMTL + SQLite | 新手、单人、低配 NAS，只想一个容器跑起来 |
-| 第一档 | `docker-compose.yml` | MMTL + PostgreSQL | 大多数家庭 NAS，多用户更稳 |
+| 单镜像档 | `docker-compose.simple.yml` | MeBox + SQLite | 新手、单人、低配 NAS，只想一个容器跑起来 |
+| 第一档 | `docker-compose.yml` | MeBox + PostgreSQL | 大多数家庭 NAS，多用户更稳 |
 | 第二档 | `docker-compose.standard.yml` | + Redis | 多用户、Emby 客户端频繁刷新、首页/列表访问多 |
 | 第三档 | `docker-compose.search.yml` | + OpenSearch | 超大媒体库、复杂全文搜索（内存占用更高） |

 ### 单镜像档要点

- 只启动 **一个** MMTL 容器，数据在 `./data/mmtl.db`
+- 只启动 **一个** MeBox 容器，数据在 `./data/mebox.db`
 - 通常只需改端口与媒体目录挂载
- **不要**设置 `MMTL_DATABASE_DSN`，否则会切到 PostgreSQL
+- **不要**设置 `MEBOX_DATABASE_DSN`，否则会切到 PostgreSQL

 ```yaml
 ports:
@@ -124,11 +127,11 @@ volumes:
 ### PostgreSQL 档位要点

 - 主库在 `./postgres`，配置与密钥在 `./data`
- 若存在旧版 `./data/mmtl.db`，首次启动会自动迁移到 PostgreSQL
- 迁移完成后可将 `MMTL_DATABASE_DB_PATH` 改为不存在路径，避免重复检查：
+- 若存在旧版 `./data/mebox.db`，首次启动会自动迁移到 PostgreSQL
+- 迁移完成后可将 `MEBOX_DATABASE_DB_PATH` 改为不存在路径，避免重复检查：

 ```yaml
-MMTL_DATABASE_DB_PATH: /data/no-sqlite-migration.db
+MEBOX_DATABASE_DB_PATH: /data/no-sqlite-migration.db
 ```

 ### 必须备份与可重建
@@ -144,11 +147,11 @@ MMTL_DATABASE_DB_PATH: /data/no-sqlite-migration.db
 ### 更新镜像

 ```bash
-docker compose pull mmtl
-docker compose up -d --no-deps mmtl
+docker compose pull mebox
+docker compose up -d --no-deps mebox
 ```

-日常更新只拉 `mmtl` 服务即可，不要随意 `docker compose pull` 升级 PostgreSQL/Redis/OpenSearch 基础镜像。
+日常更新只拉 `mebox` 服务即可，不要随意 `docker compose pull` 升级 PostgreSQL/Redis/OpenSearch 基础镜像。

 ---

@@ -158,7 +161,7 @@ Docker 部署最常见的问题是路径填错。记住：

 - `volumes` **左侧**是宿主机真实路径，**右侧**是容器内路径
 - 网页后台添加媒体库时，应填写**容器内**路径（如 `/media/电影`）
- 若使用自动整理/下载入库，`MMTL_MEDIA_DIR` 与 `MMTL_DOWNLOAD_DIR` 需与挂载一致
+- 若使用自动整理/下载入库，`MEBOX_MEDIA_DIR` 与 `MEBOX_DOWNLOAD_DIR` 需与挂载一致

 NAS 示例：

@@ -167,10 +170,10 @@ volumes:
  - /vol1/1000/Media:/media
  - /vol1/1000/Downloads:/downloads
 environment:
-  MMTL_MEDIA_DIR: /vol1/1000/Media
-  MMTL_MEDIA_CONTAINER_DIR: /media
-  MMTL_DOWNLOAD_DIR: /vol1/1000/Downloads
-  MMTL_DOWNLOAD_CONTAINER_DIR: /downloads
+  MEBOX_MEDIA_DIR: /vol1/1000/Media
+  MEBOX_MEDIA_CONTAINER_DIR: /media
+  MEBOX_DOWNLOAD_DIR: /vol1/1000/Downloads
+  MEBOX_DOWNLOAD_CONTAINER_DIR: /downloads
 ```

 ---
@@ -179,9 +182,9 @@ environment:

 1. **创建媒体库** → 填写 `/media/...` → 执行扫库
 2. **配置元数据源** → 系统设置中添加 TMDb、Bangumi 等 API
-3. **（可选）连接 qBittorrent** → 下载客户端设置，宿主机可用 `http://host.docker.internal:8085`
+3. **（可选）配置下载目录自动整理** → 文件管理中将下载目录设为整理源，下载完成后自动分类入库
 4. **（可选）配置网盘账号** → STRM 管理中添加 OpenList / 115 / WebDAV 等
-5. **第三方播放器** → 以 Emby 服务器添加 `http://服务器IP:18080`，使用 MMTL 账号登录
+5. **第三方播放器** → 以 Emby 服务器添加 `http://服务器IP:18080`，使用 MeBox 账号登录

 ---

@@ -190,14 +193,14 @@ environment:
 **扫库或入库很慢？**  
 先确认路径映射与数据库档位。网盘扫描还受接口限速与目录规模影响；大库可考虑第二档 Redis 或第三档 OpenSearch。

-**qBittorrent 下载后无法整理？**  
-确认下载目录已通过 `volumes` 挂进容器，且 `MMTL_DOWNLOAD_*` 环境变量对应正确。
+**下载目录文件没有被自动整理？**  
+确认下载目录已通过 `volumes` 挂进容器，且 `MEBOX_DOWNLOAD_*` 环境变量对应正确。MeBox 负责目录整理入库，qBittorrent 等下载器按普通软件自行部署即可。

 **硬链接失败（cross-device link）？**  
 硬链接要求源与目标在同一文件系统/子卷；跨盘、跨 btrfs 子卷或网盘挂载时请改用复制或软链接。

 **第三方播放器连不上？**  
-确认地址为 `http://IP:18080`，使用 MMTL 用户账号；反代部署需正确配置外部 URL 与 HTTPS 头。
+确认地址为 `http://IP:18080`，使用 MeBox 用户账号；反代部署需正确配置外部 URL 与 HTTPS 头。

 ---

@@ -220,7 +223,7 @@ CI 会在 Release 中提供 Windows / Linux / macOS 的 amd64、arm64 单文件

 ## 鸣谢

-MMTL 在 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) 的基础上 fork 并持续演进。感谢上游项目在媒体库架构、Emby 协议兼容和自托管体验上的奠基工作。
+MeBox 在 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) 的基础上 fork 并持续演进。感谢上游项目在媒体库架构、Emby 协议兼容和自托管体验上的奠基工作。

 项目中许多网盘同步、STRM 与媒体整理相关的设计与实现，也参考了 [qmediasync](https://github.com/qicfan/qmediasync)。感谢该项目的思路与实践经验。

@@ -238,11 +241,11 @@ MMTL 在 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) 的基础

 ## Star History

-<a href="https://www.star-history.com/?repos=truewhile%2FMMTL&type=date&legend=top-left">
+<a href="https://www.star-history.com/?repos=truewhile%2FMeBox&type=date&legend=top-left">
 <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=truewhile/MMTL&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=truewhile/MMTL&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=truewhile/MMTL&type=date&legend=top-left" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=truewhile/MeBox&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=truewhile/MeBox&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=truewhile/MeBox&type=date&legend=top-left" />
 </picture>
 </a>

@@ -251,3 +254,18 @@ MMTL 在 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) 的基础
 ## 许可证

 本项目采用 [GPL-3.0](LICENSE) 许可证。
+
+---
+
+## 赞赏
+
+如果 MeBox 帮你把家庭影音折腾明白了，欢迎请作者喝杯咖啡 ☕
+
+<p align="center">
+  <img src="docs/images/donation-qr.png" width="320" alt="WhileTrue 的赞赏码" />
+</p>
+
+<p align="center">
+  <strong>Telegram 交流群</strong>：<a href="https://t.me/MeBoxGroup">https://t.me/MeBoxGroup</a><br/>
+  使用问题、功能建议、更新动态，欢迎来群里聊
+</p>
@@ -1,13 +1,13 @@
-# MMTL (My Movie and TV Library)
+# MeBox

 <p align="center">
-  <img src="web/public/brand/logo-192.png" width="96" height="96" alt="MMTL Logo" />
+  <img src="web/public/brand/logo-192.png" width="96" height="96" alt="MeBox Logo" />
 </p>

 <h3 align="center">A self-hosted media center for NAS and home theater</h3>

 <p align="center">
-  <strong>Libraries · Metadata · Cloud STRM · Emby protocol · Remote Emby mounts · Multi-user · Docker-first</strong>
+  <strong>Libraries · Metadata · Cloud STRM · Emby/Jellyfin client compatible · Remote Emby mounts · Multi-user · Docker-first</strong>
 </p>

 <p align="center">
@@ -16,7 +16,8 @@
  <a href="#quick-start">Quick Start</a> ·
  <a href="#deployment-tiers">Deployment</a> ·
  <a href="#acknowledgements">Acknowledgements</a> ·
-  <a href="#development">Development</a>
+  <a href="#development">Development</a> ·
+  <a href="https://t.me/MeBoxGroup">Telegram</a>
 </p>

 <p align="center">
@@ -30,9 +31,9 @@

 ## Overview

-**MMTL** is a self-hosted private media management system for NAS, mini PCs, family sharing, and multi-device playback. This repository is a maintained fork of [MediaStationGo](https://github.com/ShukeBta/MediaStationGo), extended with stronger cloud playback, task queues, remote mounts, and permission controls.
+**MeBox** is a self-hosted private media management system for NAS, mini PCs, family sharing, and multi-device playback. This repository is a maintained fork of [MediaStationGo](https://github.com/ShukeBta/MediaStationGo), extended with stronger cloud playback, task queues, remote mounts, and permission controls.

-In practice, MMTL gives you:
+In practice, MeBox gives you:

 - A modern **web media library**
 - An **Emby/Jellyfin-compatible protocol gateway** for third-party players
@@ -45,12 +46,12 @@ In practice, MMTL gives you:
 | **Libraries** | Movies, TV, anime, variety, music, custom libraries; multi-root scanning; poster wall; continue watching |
 | **Metadata** | TMDb, Bangumi, Douban, TheTVDB, Fanart, NFO import, manual matching, scrape queue |
 | **Playback** | Web player, HLS transcoding, danmaku, subtitles, play profiles, history and favourites |
-| **Emby protocol** | Add MMTL in Infuse, SenPlayer, Fileball, etc. and sign in with MMTL accounts |
-| **Remote Emby mounts** | Browse remote Emby libraries inside MMTL without a separate Emby client |
+| **Emby/Jellyfin client compatible** | Full Emby server protocol implementation: Infuse, SenPlayer, Fileball, and official Emby/Jellyfin clients can add MeBox as an Emby server and sign in with MeBox accounts — poster walls, watch progress, and multi-user work out of the box |
+| **Remote Emby mounts** | Browse remote Emby libraries inside MeBox without a separate Emby client |
 | **Cloud & STRM** | OpenList, CloudDrive2, 115, WebDAV; STRM sync; upload/download queues; direct or 302 playback |
-| **Downloads & organize** | qBittorrent, site search/subscriptions, post-download organization, file manager |
+| **Downloads & organize** | Scheduled download-folder organization (smart classification, auto library registration), file manager (copy/move/hardlink/symlink) |
 | **Users & permissions** | Admin/regular users, expiry, NSFW toggle, play-profile PIN, granular permissions |
-| **Operations** | Unified task queue, recycle bin, storage stats, DLNA casting, settings and logs |
+| **Operations** | Unified task queue, storage stats, DLNA casting, settings and logs |

 ### Tech stack

@@ -65,13 +66,13 @@ In practice, MMTL gives you:
 Docker Compose is the recommended path. The repo ships four **standalone** templates; no `.env` is required.

 ```bash
-mkdir -p MMTL && cd MMTL
+mkdir -p MeBox && cd MeBox

 # Simplest: one container with built-in SQLite
-curl -fsSL https://raw.githubusercontent.com/truewhile/MMTL/main/docker-compose.simple.yml -o docker-compose.yml
+curl -fsSL https://raw.githubusercontent.com/truewhile/MeBox/main/docker-compose.simple.yml -o docker-compose.yml

 # Or PostgreSQL tier for multi-user setups
-# curl -fsSL https://raw.githubusercontent.com/truewhile/MMTL/main/docker-compose.yml -o docker-compose.yml
+# curl -fsSL https://raw.githubusercontent.com/truewhile/MeBox/main/docker-compose.yml -o docker-compose.yml

 docker compose up -d
 ```
@@ -84,10 +85,12 @@ http://SERVER_IP:18080

 Default login: `admin` / `admin123` — change the password immediately.

+> 💡 **Seamless for Emby users**: MeBox fully implements the Emby/Jellyfin client protocol. Infuse, SenPlayer, Fileball, and official Emby/Jellyfin apps on phones, TVs, and tablets can add it as an Emby server at `http://SERVER_IP:18080` and sign in with MeBox accounts — no change to your existing workflow.
+
 Image:

 ```text
-ghcr.io/truewhile/mmtl:latest
+ghcr.io/truewhile/mebox:latest
 ```

 ---
@@ -98,22 +101,22 @@ Pick one compose file. Do **not** stack multiple `-f` files.

 | Tier | File | Stack | Best for |
 | --- | --- | --- | --- |
-| Single image | `docker-compose.simple.yml` | MMTL + SQLite | Beginners, single-user, low-resource NAS |
-| Tier 1 | `docker-compose.yml` | MMTL + PostgreSQL | Most home NAS deployments |
+| Single image | `docker-compose.simple.yml` | MeBox + SQLite | Beginners, single-user, low-resource NAS |
+| Tier 1 | `docker-compose.yml` | MeBox + PostgreSQL | Most home NAS deployments |
 | Tier 2 | `docker-compose.standard.yml` | + Redis | Multi-user, frequent Emby client refreshes |
 | Tier 3 | `docker-compose.search.yml` | + OpenSearch | Very large libraries, advanced full-text search |

 ### Single-image notes

- Only one MMTL container; database lives in `./data/mmtl.db`
- Do **not** set `MMTL_DATABASE_DSN` or it switches to PostgreSQL
+- Only one MeBox container; database lives in `./data/mebox.db`
+- Do **not** set `MEBOX_DATABASE_DSN` or it switches to PostgreSQL
 - Back up `./data`; `./cache` can be rebuilt

 ### PostgreSQL notes

 - Primary DB: `./postgres`; secrets and runtime files: `./data`
- Existing `./data/mmtl.db` migrates automatically on first start
- After migration, point `MMTL_DATABASE_DB_PATH` at a non-existent file to disable re-checks
+- Existing `./data/mebox.db` migrates automatically on first start
+- After migration, point `MEBOX_DATABASE_DB_PATH` at a non-existent file to disable re-checks

 ### Backup

@@ -126,8 +129,8 @@ Pick one compose file. Do **not** stack multiple `-f` files.
 ### Update

 ```bash
-docker compose pull mmtl
-docker compose up -d --no-deps mmtl
+docker compose pull mebox
+docker compose up -d --no-deps mebox
 ```

 ---
@@ -138,7 +141,7 @@ The most common Docker mistake is mixing host paths with container paths.

 - Left side of `volumes` = real host/NAS path
 - Right side = container path; use `/media/...` in the web UI
- Keep `MMTL_MEDIA_DIR` / `MMTL_DOWNLOAD_DIR` aligned with mounts when organizing or ingesting downloads
+- Keep `MEBOX_MEDIA_DIR` / `MEBOX_DOWNLOAD_DIR` aligned with mounts when organizing or ingesting downloads

 Example:

@@ -147,10 +150,10 @@ volumes:
  - /vol1/1000/Media:/media
  - /vol1/1000/Downloads:/downloads
 environment:
-  MMTL_MEDIA_DIR: /vol1/1000/Media
-  MMTL_MEDIA_CONTAINER_DIR: /media
-  MMTL_DOWNLOAD_DIR: /vol1/1000/Downloads
-  MMTL_DOWNLOAD_CONTAINER_DIR: /downloads
+  MEBOX_MEDIA_DIR: /vol1/1000/Media
+  MEBOX_MEDIA_CONTAINER_DIR: /media
+  MEBOX_DOWNLOAD_DIR: /vol1/1000/Downloads
+  MEBOX_DOWNLOAD_CONTAINER_DIR: /downloads
 ```

 ---
@@ -159,9 +162,9 @@ environment:

 1. Create a library with a container path such as `/media/Movies`, then scan
 2. Add metadata providers (TMDb, Bangumi, etc.) in system settings
-3. Optionally connect qBittorrent (`http://host.docker.internal:8085` when qB runs on the host)
+3. Optionally set up download-folder auto-organization under file management so finished downloads land in the right library
 4. Optionally configure cloud accounts under STRM management
-5. Add the server in Emby-compatible players at `http://SERVER_IP:18080` using MMTL credentials
+5. Add the server in Emby-compatible players at `http://SERVER_IP:18080` using MeBox credentials

 ---

@@ -170,14 +173,14 @@ environment:
 **Library scan is slow**  
 Check path mapping and DB tier. Cloud scans also depend on API limits and folder size.

-**qBittorrent downloads are not organized**  
-Ensure the download directory is mounted into the container and env vars match.
+**Downloaded files are not organized**  
+Ensure the download directory is mounted into the container and env vars match. MeBox handles folder organization; run qBittorrent or any downloader yourself as a regular app.

 **Hardlink fails with cross-device link**  
 Hardlinks require the same filesystem/subvolume; use copy or symlink across disks or cloud mounts.

 **External player cannot connect**  
-Use `http://IP:18080` and a MMTL user account; reverse proxies need correct external URL and HTTPS headers.
+Use `http://IP:18080` and a MeBox user account; reverse proxies need correct external URL and HTTPS headers.

 ---

@@ -200,7 +203,7 @@ Release builds ship single-file binaries for Windows, Linux, and macOS on amd64

 ## Acknowledgements

-MMTL is forked from and continues to evolve [MediaStationGo](https://github.com/ShukeBta/MediaStationGo). Thank you to the upstream project for the media-library architecture, Emby-protocol compatibility, and self-hosted foundation.
+MeBox is forked from and continues to evolve [MediaStationGo](https://github.com/ShukeBta/MediaStationGo). Thank you to the upstream project for the media-library architecture, Emby-protocol compatibility, and self-hosted foundation.

 Many cloud sync, STRM, and media-organization ideas in this project were also informed by [qmediasync](https://github.com/qicfan/qmediasync). Thank you for the reference implementation and design patterns.

@@ -214,11 +217,11 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md) before ope

 ## Star History

-<a href="https://www.star-history.com/?repos=truewhile%2FMMTL&type=date&legend=top-left">
+<a href="https://www.star-history.com/?repos=truewhile%2FMeBox&type=date&legend=top-left">
 <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=truewhile/MMTL&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=truewhile/MMTL&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=truewhile/MMTL&type=date&legend=top-left" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=truewhile/MeBox&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=truewhile/MeBox&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=truewhile/MeBox&type=date&legend=top-left" />
 </picture>
 </a>

@@ -227,3 +230,18 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md) before ope
 ## License

 This project is licensed under [GPL-3.0](LICENSE).
+
+---
+
+## Support & Donate
+
+If MeBox makes your home theater life easier, feel free to buy the maintainer a coffee ☕
+
+<p align="center">
+  <img src="docs/images/donation-qr.png" width="320" alt="WhileTrue donation QR" />
+</p>
+
+<p align="center">
+  <strong>Telegram group</strong>: <a href="https://t.me/MeBoxGroup">https://t.me/MeBoxGroup</a><br/>
+  Questions, feature requests, and release news — come chat with us
+</p>
@@ -1,13 +1,13 @@
 # 安全策略

-MMTL 是自托管媒体系统，常部署在 NAS、家庭网络、Docker、反向代理和第三方下载器环境中。安全问题通常会同时涉及应用代码、容器配置、路径映射、站点 Cookie / API Key、下载器凭据和外部访问入口。请按本策略报告和处理安全问题。
+MeBox 是自托管媒体系统，常部署在 NAS、家庭网络、Docker、反向代理和第三方下载器环境中。安全问题通常会同时涉及应用代码、容器配置、路径映射、站点 Cookie / API Key、下载器凭据和外部访问入口。请按本策略报告和处理安全问题。

 ## 支持范围

 我们优先支持以下版本和部署方式的安全修复：

 - 当前 `main` 分支。
- 最新发布镜像：`ghcr.io/truewhile/mmtl:latest`。
+- 最新发布镜像：`ghcr.io/truewhile/mebox:latest`。
 - README 中推荐的 Docker Compose 第一档、第二档、第三档部署方式。

 历史版本、私有魔改镜像、未公开补丁分支和非标准部署仍可报告，但维护者可能要求先在最新 `main` 或最新镜像中复现。
@@ -16,7 +16,7 @@ MMTL 是自托管媒体系统，常部署在 NAS、家庭网络、Docker、反

 请不要在公开 Issue、PR、讨论区或群聊中披露可利用细节。优先使用 GitHub Security Advisory 私密报告：

-<https://github.com/ShukeBta/MMTL/security/advisories/new>
+<https://github.com/truewhile/MeBox/security/advisories/new>

 如果无法使用 GitHub 私密报告，可以先通过项目 README 中的社区入口联系维护者，说明“需要私下报告安全问题”，不要直接贴出利用细节、密钥或完整日志。

@@ -68,14 +68,14 @@ MMTL 是自托管媒体系统，常部署在 NAS、家庭网络、Docker、反

 ## 自托管安全基线

-部署 MMTL 时建议：
+部署 MeBox 时建议：

 - 首次登录后立即修改默认 `admin / admin123`。
 - 不要把 PostgreSQL、Redis、OpenSearch、qBittorrent WebUI 暴露到公网。
 - 反向代理公网访问时启用 HTTPS，并限制管理后台访问来源。
 - 使用强随机的 JWT / 加密密钥，妥善备份 `./data` 和数据库。
 - 不要在 Issue、PR、截图或日志中公开站点 Cookie、API Key、Passkey、下载器密码。
- Docker `volumes` 只挂载 MMTL 需要访问的目录，媒体库目录需要写入时再授予写权限。
+- Docker `volumes` 只挂载 MeBox 需要访问的目录，媒体库目录需要写入时再授予写权限。
 - 定期更新镜像，并在升级前备份 `./postgres` 和 `./data`。

 ## 安全修复 PR
@@ -1 +0,0 @@
-0.0.77
@@ -7,7 +7,7 @@ import (
 	"sync"
 	"time"

-	"github.com/ShukeBta/MMTL/internal/config"
+	"github.com/truewhile/MeBox/internal/config"
 )

 const defaultLogMaxSizeMB = 20
@@ -8,7 +8,7 @@ import (
 	"go.uber.org/zap"
 	"go.uber.org/zap/zapcore"

-	"github.com/ShukeBta/MMTL/internal/config"
+	"github.com/truewhile/MeBox/internal/config"
 )

 // newLogger 根据 cfg.Logging 构建 Zap。
@@ -8,7 +8,7 @@ import (

 	"go.uber.org/zap"

-	"github.com/ShukeBta/MMTL/internal/config"
+	"github.com/truewhile/MeBox/internal/config"
 )

 func TestProductionLoggerWritesConfiguredInfoToAppLogAndSplitsWarnError(t *testing.T) {
@@ -1,6 +1,6 @@
-// Package main is the MMTL HTTP server entry point.
+// Package main is the MeBox HTTP server entry point.
 //
-// MMTL is a Go rewrite of the legacy Python implementation,
+// MeBox is a Go rewrite of the legacy Python implementation,
 // adopting the same tech stack as cropflre/nowen-video:
 //
 //	Backend:  Go 1.25 + Gin + GORM + PostgreSQL/SQLite + Viper + Zap + JWT
@@ -21,10 +21,11 @@ import (

 	"go.uber.org/zap"

-	"github.com/ShukeBta/MMTL/internal/config"
-	"github.com/ShukeBta/MMTL/internal/database"
-	"github.com/ShukeBta/MMTL/internal/repository"
-	"github.com/ShukeBta/MMTL/internal/service"
+	"github.com/truewhile/MeBox/internal/config"
+	"github.com/truewhile/MeBox/internal/database"
+	"github.com/truewhile/MeBox/internal/helper"
+	"github.com/truewhile/MeBox/internal/repository"
+	"github.com/truewhile/MeBox/internal/service"
 )

 // version is overwritten at build time via -ldflags="-X main.version=...".
@@ -35,7 +36,7 @@ func effectiveVersion(buildVersion string) string {
 	if buildVersion != "" && buildVersion != "dev" {
 		return buildVersion
 	}
-	if envVersion := strings.TrimSpace(os.Getenv("MMTL_VERSION")); envVersion != "" {
+	if envVersion := strings.TrimSpace(os.Getenv("MEBOX_VERSION")); envVersion != "" {
 		return envVersion
 	}
 	if buildVersion == "" {
@@ -59,7 +60,7 @@ func main() {
 	defer func() { _ = logger.Sync() }()

 	appVersion := effectiveVersion(version)
-	logger.Info("starting MMTL",
+	logger.Info("starting MeBox",
 		zap.String("version", appVersion),
 		zap.Int("port", cfg.App.Port),
 		zap.String("data_dir", cfg.App.DataDir),
@@ -121,7 +122,7 @@ func main() {
 			)
 		}
 	}()
-	go services.Boot()
+	helper.Go(logger, "services.boot", services.Boot)

 	// Graceful shutdown.
 	stop := make(chan os.Signal, 1)
@@ -135,5 +136,5 @@ func main() {
 		logger.Error("graceful shutdown failed", zap.Error(err))
 	}
 	services.Close()
-	logger.Info("MMTL stopped")
+	logger.Info("MeBox stopped")
 }
@@ -12,23 +12,23 @@ import (
 )

 func TestEffectiveVersionPrefersBuildVersion(t *testing.T) {
-	t.Setenv("MMTL_VERSION", "MMTL-v0.1.15")
+	t.Setenv("MEBOX_VERSION", "MeBox-v0.1.15")

-	if got := effectiveVersion("MMTL-v0.1.16"); got != "MMTL-v0.1.16" {
-		t.Fatalf("effectiveVersion = %q, want MMTL-v0.1.16", got)
+	if got := effectiveVersion("MeBox-v0.1.16"); got != "MeBox-v0.1.16" {
+		t.Fatalf("effectiveVersion = %q, want MeBox-v0.1.16", got)
 	}
 }

 func TestEffectiveVersionUsesEnvWhenBuildVersionIsDev(t *testing.T) {
-	t.Setenv("MMTL_VERSION", " MMTL-v0.1.16 ")
+	t.Setenv("MEBOX_VERSION", " MeBox-v0.1.16 ")

-	if got := effectiveVersion("dev"); got != "MMTL-v0.1.16" {
-		t.Fatalf("effectiveVersion = %q, want MMTL-v0.1.16", got)
+	if got := effectiveVersion("dev"); got != "MeBox-v0.1.16" {
+		t.Fatalf("effectiveVersion = %q, want MeBox-v0.1.16", got)
 	}
 }

 func TestEffectiveVersionDefaultsToDev(t *testing.T) {
-	t.Setenv("MMTL_VERSION", "")
+	t.Setenv("MEBOX_VERSION", "")

 	if got := effectiveVersion(""); got != "dev" {
 		t.Fatalf("effectiveVersion = %q, want dev", got)
@@ -85,7 +85,7 @@ func TestServeSPAServesAssetsImmutableAndBypassesAPIRoutes(t *testing.T) {
 	if err := os.WriteFile(filepath.Join(webDir, "assets", "app.js"), []byte("console.log('ok')"), 0o644); err != nil {
 		t.Fatal(err)
 	}
-	if err := os.WriteFile(filepath.Join(webDir, "brand", "mmtl-logo.svg"), []byte("<svg></svg>"), 0o644); err != nil {
+	if err := os.WriteFile(filepath.Join(webDir, "brand", "mebox-logo.svg"), []byte("<svg></svg>"), 0o644); err != nil {
 		t.Fatal(err)
 	}
 	if err := os.WriteFile(filepath.Join(webDir, "artwork-cache-sw.js"), []byte("self.addEventListener('fetch', () => {})"), 0o644); err != nil {
@@ -105,7 +105,7 @@ func TestServeSPAServesAssetsImmutableAndBypassesAPIRoutes(t *testing.T) {
 		t.Fatalf("asset Cache-Control = %q, want immutable", got)
 	}

-	brandReq := httptest.NewRequest(http.MethodGet, "/brand/mmtl-logo.svg", nil)
+	brandReq := httptest.NewRequest(http.MethodGet, "/brand/mebox-logo.svg", nil)
 	brandResp := httptest.NewRecorder()
 	router.ServeHTTP(brandResp, brandReq)
 	if brandResp.Code != http.StatusOK {
@@ -11,12 +11,12 @@ import (
 	"github.com/gin-gonic/gin"
 	"go.uber.org/zap"

-	"github.com/ShukeBta/MMTL/internal/config"
-	"github.com/ShukeBta/MMTL/internal/handler"
-	"github.com/ShukeBta/MMTL/internal/middleware"
-	"github.com/ShukeBta/MMTL/internal/service"
+	"github.com/truewhile/MeBox/internal/config"
+	"github.com/truewhile/MeBox/internal/handler"
+	"github.com/truewhile/MeBox/internal/middleware"
+	"github.com/truewhile/MeBox/internal/service"

-	"github.com/ShukeBta/MMTL/web"
+	"github.com/truewhile/MeBox/web"
 )

 func buildRouter(cfg *config.Config, logger *zap.Logger, svc *service.Container) *gin.Engine {
@@ -53,6 +53,7 @@ func buildRouter(cfg *config.Config, logger *zap.Logger, svc *service.Container)
 // comes from root, which is either the compiled-in SPA or an on-disk web dir.
 func serveSPA(r *gin.Engine, root fs.FS) {
 	assets := r.Group("/assets")
+	assets.Use(middleware.GzipStatic())
 	assets.Use(func(c *gin.Context) {
 		c.Header("Cache-Control", "public, max-age=31536000, immutable")
 		c.Next()
@@ -69,8 +70,11 @@ func serveSPA(r *gin.Engine, root fs.FS) {
 		r.GET(rootFile, serveFSFile(root, name))
 		r.HEAD(rootFile, serveFSFile(root, name))
 	}
-	r.NoRoute(func(c *gin.Context) {
-		path := c.Request.URL.Path
+		r.NoRoute(middleware.GzipStatic(), func(c *gin.Context) {
+			if handler.TryHandleEmbyNormalizedRoute(c, r) {
+				return
+			}
+			path := c.Request.URL.Path
 		if shouldBypassSPAFallback(path) {
 			c.Status(http.StatusNotFound)
 			return
@@ -78,7 +82,7 @@ func serveSPA(r *gin.Engine, root fs.FS) {
 		setNoCacheHeaders(c)
 		data, err := fs.ReadFile(root, "index.html")
 		if err != nil {
-			c.String(http.StatusNotFound, "MMTL web UI not found")
+			c.String(http.StatusNotFound, "MeBox web UI not found")
 			return
 		}
 		c.Data(http.StatusOK, "text/html; charset=utf-8", data)
@@ -13,8 +13,8 @@ import (

 	"go.uber.org/zap"

-	"github.com/ShukeBta/MMTL/internal/config"
-	"github.com/ShukeBta/MMTL/internal/service"
+	"github.com/truewhile/MeBox/internal/config"
+	"github.com/truewhile/MeBox/internal/service"
 )

 // tlsPair 记录当前正在服务的证书，用于判断是否需要重新绑定监听。
@@ -27,7 +27,7 @@ type tlsPair struct {
 	version string
 }

-// serverManager 负责 MMTL 的 HTTP/HTTPS 监听。HTTPS 设置保存后调用 Reload，
+// serverManager 负责 MeBox 的 HTTP/HTTPS 监听。HTTPS 设置保存后调用 Reload，
 // 在同一个端口上把明文 HTTP 与 TLS 监听热切换，无需重启进程：
 //
 //   - 关闭旧监听释放端口（同一进程内 Windows 不允许重复绑定同一端口）；
@@ -130,26 +130,35 @@ func (m *serverManager) Shutdown(ctx context.Context) error {
 // desiredPair 根据当前配置计算目标监听形态：nil 表示明文 HTTP，非 nil 表示 TLS。
 // 证书/私钥按"路径优先、内容兜底"解析，并校验是否匹配。
 func (m *serverManager) desiredPair() (*tlsPair, error) {
-	if m.cfg == nil || !m.cfg.App.HTTPSEnabled {
+	// 与 ApplyRuntimeSetting 的写锁配对：HTTPS 相关字段可能被运行时设置
+	// 热更新，无锁读存在数据竞争（string 撕裂）。
+	config.RuntimeMu.RLock()
+	httpsEnabled := m.cfg != nil && m.cfg.App.HTTPSEnabled
+	cert := m.cfg.App.SSLCert
+	certPath := m.cfg.App.SSLCertPath
+	key := m.cfg.App.SSLKey
+	keyPath := m.cfg.App.SSLKeyPath
+	config.RuntimeMu.RUnlock()
+	if !httpsEnabled {
 		return nil, nil
 	}
-	certPEM, err := service.ResolveSSLMaterial(m.cfg.App.SSLCert, m.cfg.App.SSLCertPath, "证书")
+	certPEM, err := service.ResolveSSLMaterial(cert, certPath, "证书")
 	if err != nil {
 		return nil, err
 	}
-	keyPEM, err := service.ResolveSSLMaterial(m.cfg.App.SSLKey, m.cfg.App.SSLKeyPath, "私钥")
+	keyPEM, err := service.ResolveSSLMaterial(key, keyPath, "私钥")
 	if err != nil {
 		return nil, err
 	}
 	if err := service.ValidateSSLKeyPair(certPEM, keyPEM); err != nil {
 		return nil, err
 	}
-	cert, err := tls.X509KeyPair([]byte(certPEM), []byte(keyPEM))
+	pairCert, err := tls.X509KeyPair([]byte(certPEM), []byte(keyPEM))
 	if err != nil {
 		return nil, fmt.Errorf("SSL 证书/私钥无效：%v", err)
 	}
 	return &tlsPair{
-		cert:    cert,
+		cert:    pairCert,
 		certPEM: certPEM,
 		keyPEM:  keyPEM,
 		version: certPEM + "\x00" + keyPEM,
@@ -171,6 +180,8 @@ func (m *serverManager) maybeStartAutoReloadLocked() {

 // pathBased 是否至少有一侧证书/私钥通过文件路径配置。
 func (m *serverManager) pathBased() bool {
+	config.RuntimeMu.RLock()
+	defer config.RuntimeMu.RUnlock()
 	return strings.TrimSpace(m.cfg.App.SSLCertPath) != "" || strings.TrimSpace(m.cfg.App.SSLKeyPath) != ""
 }

@@ -17,7 +17,7 @@ import (

 	"go.uber.org/zap"

-	"github.com/ShukeBta/MMTL/internal/config"
+	"github.com/truewhile/MeBox/internal/config"
 )

 func makeTestPairPEM(t *testing.T) (certPEM, keyPEM string) {
@@ -8,7 +8,7 @@ import (

 	"go.uber.org/zap"

-	"github.com/ShukeBta/MMTL/internal/config"
+	"github.com/truewhile/MeBox/internal/config"
 )

 func applyCPUThreadLimit(cfg *config.Config, logger *zap.Logger) {
@@ -1,7 +1,7 @@
-# MMTL 第三档完整 Docker Compose 部署文件
+# MeBox 第三档完整 Docker Compose 部署文件
 #
 # 组件：
-#   MMTL + PostgreSQL + Redis + OpenSearch
+#   MeBox + PostgreSQL + Redis + OpenSearch
 #
 # 使用方式二选一：
 #   1. 保存为 docker-compose.yml 后执行：
@@ -19,8 +19,8 @@
 #   admin / admin123

 services:
-  mmtl:
-    image: ghcr.io/truewhile/mmtl:latest
+  mebox:
+    image: ghcr.io/truewhile/mebox:latest

    restart: unless-stopped
    init: true
@@ -55,7 +55,7 @@ services:
        bind:
          create_host_path: false

-      # 下载目录。需要和 qBittorrent 保存路径保持一致。
+      # 下载目录。需要和下载器保存路径保持一致。
      # NAS 示例：source: /vol1/1000/Downloads
      # Windows Docker Desktop 示例：source: D:/Downloads
      - type: bind
@@ -74,45 +74,45 @@ services:
      PUID: "1000"
      PGID: "1000"

-      MMTL_APP_HOST: 0.0.0.0
-      MMTL_APP_PORT: 8080
-      MMTL_APP_WEB_DIR: /app/web/dist
-      MMTL_APP_DATA_DIR: /data
-      MMTL_LOGGING_LEVEL: info
-      MMTL_LOGGING_FORMAT: console
-      MMTL_LOGGING_OUTPUT_PATH: /data/logs
-      MMTL_LOGGING_MAX_SIZE_MB: "50"
-      MMTL_LOGGING_MAX_BACKUPS: "20"
-      MMTL_LOGGING_MAX_AGE_DAYS: "30"
+      MEBOX_APP_HOST: 0.0.0.0
+      MEBOX_APP_PORT: 8080
+      MEBOX_APP_WEB_DIR: /app/web/dist
+      MEBOX_APP_DATA_DIR: /data
+      MEBOX_LOGGING_LEVEL: info
+      MEBOX_LOGGING_FORMAT: console
+      MEBOX_LOGGING_OUTPUT_PATH: /data/logs
+      MEBOX_LOGGING_MAX_SIZE_MB: "50"
+      MEBOX_LOGGING_MAX_BACKUPS: "20"
+      MEBOX_LOGGING_MAX_AGE_DAYS: "30"

-      MMTL_DATABASE_TYPE: postgres
-      MMTL_DATABASE_DSN: postgres://mmtl:mmtl@postgres:5432/mmtl?sslmode=disable
-      MMTL_DATABASE_DB_PATH: /data/mmtl.db
+      MEBOX_DATABASE_TYPE: postgres
+      MEBOX_DATABASE_DSN: postgres://mebox:mebox@postgres:5432/mebox?sslmode=disable
+      MEBOX_DATABASE_DB_PATH: /data/mebox.db

-      MMTL_CACHE_REDIS_URL: redis://redis:6379/0
-      MMTL_CACHE_CACHE_DIR: /cache
+      MEBOX_CACHE_REDIS_URL: redis://redis:6379/0
+      MEBOX_CACHE_CACHE_DIR: /cache

      # OpenSearch 只做搜索索引，主数据仍以 PostgreSQL 为准。
-      MMTL_SEARCH_BACKEND: opensearch
-      MMTL_SEARCH_OPENSEARCH_URL: http://opensearch:9200
-      MMTL_SEARCH_INDEX: mmtl_media
+      MEBOX_SEARCH_BACKEND: opensearch
+      MEBOX_SEARCH_OPENSEARCH_URL: http://opensearch:9200
+      MEBOX_SEARCH_INDEX: mebox_media

-      MMTL_UPDATE_IMAGE: ghcr.io/truewhile/mmtl:latest
+      MEBOX_UPDATE_IMAGE: ghcr.io/truewhile/mebox:latest

      # 默认推荐在网页里使用容器路径 /media。
      # 如果旧媒体库已经保存了宿主机路径 /vol1/1000/Media，
      # 再把这里改成同一个宿主机真实路径用于旧路径换算。
-      MMTL_MEDIA_DIR: /media
-      MMTL_MEDIA_CONTAINER_DIR: /media
-      MMTL_DOWNLOAD_DIR: /downloads
-      MMTL_DOWNLOAD_CONTAINER_DIR: /downloads
+      MEBOX_MEDIA_DIR: /media
+      MEBOX_MEDIA_CONTAINER_DIR: /media
+      MEBOX_DOWNLOAD_DIR: /downloads
+      MEBOX_DOWNLOAD_CONTAINER_DIR: /downloads

-      MMTL_TRANSCODER_ENABLED: "true"
-      MMTL_TRANSCODER_HARDWARE_ACCEL: "false"
-      MMTL_TRANSCODER_REALTIME: "true"
-      MMTL_TRANSCODER_THREADS: "2"
-      MMTL_TRANSCODER_MAX_CONCURRENT: "1"
-      MMTL_TRANSCODER_IDLE_TIMEOUT_SECONDS: "120"
+      MEBOX_TRANSCODER_ENABLED: "true"
+      MEBOX_TRANSCODER_HARDWARE_ACCEL: "false"
+      MEBOX_TRANSCODER_REALTIME: "true"
+      MEBOX_TRANSCODER_THREADS: "2"
+      MEBOX_TRANSCODER_MAX_CONCURRENT: "1"
+      MEBOX_TRANSCODER_IDLE_TIMEOUT_SECONDS: "120"

    healthcheck:
      test: ["CMD-SHELL", "busybox wget -qO- http://127.0.0.1:8080/api/health || exit 1"]
@@ -129,18 +129,18 @@ services:

  postgres:
    image: postgres:16-alpine
-    # 首次部署允许拉取；日常更新请只 pull mmtl。
+    # 首次部署允许拉取；日常更新请只 pull mebox。
    pull_policy: missing
    restart: unless-stopped
    environment:
-      POSTGRES_DB: mmtl
-      POSTGRES_USER: mmtl
-      POSTGRES_PASSWORD: mmtl
+      POSTGRES_DB: mebox
+      POSTGRES_USER: mebox
+      POSTGRES_PASSWORD: mebox
      TZ: Asia/Shanghai
    volumes:
      - ./postgres:/var/lib/postgresql/data
    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mmtl -d mmtl"]
+      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mebox -d mebox"]
      interval: 10s
      timeout: 5s
      retries: 10
@@ -1,4 +1,4 @@
-# MMTL 单镜像部署模板（SQLite）
+# MeBox 单镜像部署模板（SQLite）
 #
 # 适合：新手、单人使用、低配 NAS / 小主机。
 # 特点：只有一个镜像，不需要 PostgreSQL / Redis / .env。
@@ -12,10 +12,10 @@
 # 首次登录后请立刻修改密码。

 services:
-  mmtl:
-    image: ghcr.io/truewhile/mmtl:latest
+  mebox:
+    image: ghcr.io/truewhile/mebox:latest

-    container_name: mmtl
+    container_name: mebox
    restart: unless-stopped
    init: true

@@ -31,23 +31,7 @@ services:
      - ./cache:/cache

      # 媒体库。网页里添加媒体库时填写 /media 或 /media/子目录。
-      # NAS 示例：source: /vol1/1000/Media
-      # Windows Docker Desktop 示例：source: D:/Media
-      # create_host_path=false 可以避免路径写错时 Docker 自动创建空文件夹。
-      - type: bind
-        source: ./media
-        target: /media
-        bind:
-          create_host_path: false
-
-      # 下载目录。qBittorrent / Transmission 的保存目录建议也对齐到 /downloads。
-      # NAS 示例：source: /vol1/1000/Downloads
-      # Windows Docker Desktop 示例：source: D:/Downloads
-      - type: bind
-        source: ./downloads
-        target: /downloads
-        bind:
-          create_host_path: false
+      - ./media:/media

      # 可选：Intel 核显硬解/转码。需要时取消注释，并在后台开启硬件加速。
      # - /dev/dri:/dev/dri
@@ -59,35 +43,33 @@ services:
      TZ: Asia/Shanghai

      # Linux/NAS 文件权限。写入文件权限异常时，改成宿主机实际 uid/gid。
-      PUID: "1000"
-      PGID: "1000"
+      PUID: "0"
+      PGID: "0"

-      MMTL_APP_HOST: 0.0.0.0
-      MMTL_APP_PORT: 8080
-      MMTL_APP_WEB_DIR: /app/web/dist
-      MMTL_APP_DATA_DIR: /data
+      MEBOX_APP_HOST: 0.0.0.0
+      MEBOX_APP_PORT: 8080
+      MEBOX_APP_WEB_DIR: /app/web/dist
+      MEBOX_APP_DATA_DIR: /data

-      # 单镜像档固定使用 SQLite。主数据库文件：./data/mmtl.db。
-      MMTL_DATABASE_TYPE: sqlite
-      MMTL_DATABASE_DB_PATH: /data/mmtl.db
-      MMTL_CACHE_CACHE_DIR: /cache
+      # 单镜像档固定使用 SQLite。主数据库文件：./data/mebox.db。
+      MEBOX_DATABASE_TYPE: sqlite
+      MEBOX_DATABASE_DB_PATH: /data/mebox.db
+      MEBOX_CACHE_CACHE_DIR: /cache

      # 路径映射保持容器内统一，网页和下载器里优先使用 /media、/downloads。
-      MMTL_MEDIA_DIR: /media
-      MMTL_MEDIA_CONTAINER_DIR: /media
-      MMTL_DOWNLOAD_DIR: /downloads
-      MMTL_DOWNLOAD_CONTAINER_DIR: /downloads
+      MEBOX_MEDIA_DIR: /media
+      MEBOX_MEDIA_CONTAINER_DIR: /media

      # 完整应用日志默认写入 ./data/logs/app.log；排查复杂问题时可临时改成 debug。
-      MMTL_LOGGING_LEVEL: info
-      MMTL_LOGGING_FORMAT: console
-      MMTL_LOGGING_OUTPUT_PATH: /data/logs
-      MMTL_LOGGING_MAX_SIZE_MB: "50"
-      MMTL_LOGGING_MAX_BACKUPS: "20"
-      MMTL_LOGGING_MAX_AGE_DAYS: "30"
+      MEBOX_LOGGING_LEVEL: info
+      MEBOX_LOGGING_FORMAT: console
+      MEBOX_LOGGING_OUTPUT_PATH: /data/logs
+      MEBOX_LOGGING_MAX_SIZE_MB: "50"
+      MEBOX_LOGGING_MAX_BACKUPS: "20"
+      MEBOX_LOGGING_MAX_AGE_DAYS: "30"

    extra_hosts:
-      # 容器访问宿主机服务用，例如 qBittorrent: http://host.docker.internal:8085
+      # 容器访问宿主机服务（如下载器等）用: http://host.docker.internal:8085
      - "host.docker.internal:host-gateway"

    healthcheck:
@@ -1,7 +1,7 @@
-# MMTL 第二档完整 Docker Compose 部署文件
+# MeBox 第二档完整 Docker Compose 部署文件
 #
 # 组件：
-#   MMTL + PostgreSQL + Redis
+#   MeBox + PostgreSQL + Redis
 #
 # 使用方式二选一：
 #   1. 保存为 docker-compose.yml 后执行：
@@ -16,8 +16,8 @@
 #   admin / admin123

 services:
-  mmtl:
-    image: ghcr.io/truewhile/mmtl:latest
+  mebox:
+    image: ghcr.io/truewhile/mebox:latest

    restart: unless-stopped
    init: true
@@ -50,7 +50,7 @@ services:
        bind:
          create_host_path: false

-      # 下载目录。需要和 qBittorrent 保存路径保持一致。
+      # 下载目录。需要和下载器保存路径保持一致。
      # NAS 示例：source: /vol1/1000/Downloads
      # Windows Docker Desktop 示例：source: D:/Downloads
      - type: bind
@@ -69,39 +69,39 @@ services:
      PUID: "1000"
      PGID: "1000"

-      MMTL_APP_HOST: 0.0.0.0
-      MMTL_APP_PORT: 8080
-      MMTL_APP_WEB_DIR: /app/web/dist
-      MMTL_APP_DATA_DIR: /data
-      MMTL_LOGGING_LEVEL: info
-      MMTL_LOGGING_FORMAT: console
-      MMTL_LOGGING_OUTPUT_PATH: /data/logs
-      MMTL_LOGGING_MAX_SIZE_MB: "50"
-      MMTL_LOGGING_MAX_BACKUPS: "20"
-      MMTL_LOGGING_MAX_AGE_DAYS: "30"
+      MEBOX_APP_HOST: 0.0.0.0
+      MEBOX_APP_PORT: 8080
+      MEBOX_APP_WEB_DIR: /app/web/dist
+      MEBOX_APP_DATA_DIR: /data
+      MEBOX_LOGGING_LEVEL: info
+      MEBOX_LOGGING_FORMAT: console
+      MEBOX_LOGGING_OUTPUT_PATH: /data/logs
+      MEBOX_LOGGING_MAX_SIZE_MB: "50"
+      MEBOX_LOGGING_MAX_BACKUPS: "20"
+      MEBOX_LOGGING_MAX_AGE_DAYS: "30"

-      MMTL_DATABASE_TYPE: postgres
-      MMTL_DATABASE_DSN: postgres://mmtl:mmtl@postgres:5432/mmtl?sslmode=disable
-      MMTL_DATABASE_DB_PATH: /data/mmtl.db
+      MEBOX_DATABASE_TYPE: postgres
+      MEBOX_DATABASE_DSN: postgres://mebox:mebox@postgres:5432/mebox?sslmode=disable
+      MEBOX_DATABASE_DB_PATH: /data/mebox.db

      # Redis 只做热缓存，源数据仍在 PostgreSQL；Redis 丢失可自动重建。
-      MMTL_CACHE_REDIS_URL: redis://redis:6379/0
-      MMTL_CACHE_CACHE_DIR: /cache
+      MEBOX_CACHE_REDIS_URL: redis://redis:6379/0
+      MEBOX_CACHE_CACHE_DIR: /cache

-      MMTL_UPDATE_IMAGE: ghcr.io/truewhile/mmtl:latest
+      MEBOX_UPDATE_IMAGE: ghcr.io/truewhile/mebox:latest

      # 路径换算配置。左边宿主机真实路径要和 volumes 左边保持一致。
-      MMTL_MEDIA_DIR: /media
-      MMTL_MEDIA_CONTAINER_DIR: /media
-      MMTL_DOWNLOAD_DIR: /downloads
-      MMTL_DOWNLOAD_CONTAINER_DIR: /downloads
+      MEBOX_MEDIA_DIR: /media
+      MEBOX_MEDIA_CONTAINER_DIR: /media
+      MEBOX_DOWNLOAD_DIR: /downloads
+      MEBOX_DOWNLOAD_CONTAINER_DIR: /downloads

-      MMTL_TRANSCODER_ENABLED: "true"
-      MMTL_TRANSCODER_HARDWARE_ACCEL: "false"
-      MMTL_TRANSCODER_REALTIME: "true"
-      MMTL_TRANSCODER_THREADS: "2"
-      MMTL_TRANSCODER_MAX_CONCURRENT: "1"
-      MMTL_TRANSCODER_IDLE_TIMEOUT_SECONDS: "120"
+      MEBOX_TRANSCODER_ENABLED: "true"
+      MEBOX_TRANSCODER_HARDWARE_ACCEL: "false"
+      MEBOX_TRANSCODER_REALTIME: "true"
+      MEBOX_TRANSCODER_THREADS: "2"
+      MEBOX_TRANSCODER_MAX_CONCURRENT: "1"
+      MEBOX_TRANSCODER_IDLE_TIMEOUT_SECONDS: "120"

    healthcheck:
      test: ["CMD-SHELL", "busybox wget -qO- http://127.0.0.1:8080/api/health || exit 1"]
@@ -118,18 +118,18 @@ services:

  postgres:
    image: postgres:16-alpine
-    # 首次部署允许拉取；日常更新请只 pull mmtl。
+    # 首次部署允许拉取；日常更新请只 pull mebox。
    pull_policy: missing
    restart: unless-stopped
    environment:
-      POSTGRES_DB: mmtl
-      POSTGRES_USER: mmtl
-      POSTGRES_PASSWORD: mmtl
+      POSTGRES_DB: mebox
+      POSTGRES_USER: mebox
+      POSTGRES_PASSWORD: mebox
      TZ: Asia/Shanghai
    volumes:
      - ./postgres:/var/lib/postgresql/data
    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mmtl -d mmtl"]
+      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mebox -d mebox"]
      interval: 10s
      timeout: 5s
      retries: 10
@@ -1,4 +1,4 @@
-# MMTL 最简单 Docker Compose 部署文件
+# MeBox 最简单 Docker Compose 部署文件
 #
 # 新手建议：
 #   1. 不用 .env。
@@ -15,8 +15,8 @@
 #   admin / admin123

 services:
-  mmtl:
-    image: ghcr.io/truewhile/mmtl:latest
+  mebox:
+    image: ghcr.io/truewhile/mebox:latest

    restart: unless-stopped
    init: true
@@ -29,7 +29,7 @@ services:
    ports:
      - "18080:8080"

-    # 让容器可以访问宿主机上的 qBittorrent。
+    # 让容器可以访问宿主机上的服务（如下载器）。
    # qB 地址通常可填：http://host.docker.internal:8085
    extra_hosts:
      - "host.docker.internal:host-gateway"
@@ -83,52 +83,52 @@ services:
      PGID: "1000"

      # 程序基础配置，通常不用改。
-      MMTL_APP_HOST: 0.0.0.0
-      MMTL_APP_PORT: 8080
-      MMTL_APP_WEB_DIR: /app/web/dist
-      MMTL_APP_DATA_DIR: /data
+      MEBOX_APP_HOST: 0.0.0.0
+      MEBOX_APP_PORT: 8080
+      MEBOX_APP_WEB_DIR: /app/web/dist
+      MEBOX_APP_DATA_DIR: /data
      # 详细应用日志会保存在 ./data/logs/app.log，warn/error 也会拆分保存。
      # 排查复杂问题时可临时改成 debug。
-      MMTL_LOGGING_LEVEL: info
-      MMTL_LOGGING_FORMAT: console
-      MMTL_LOGGING_OUTPUT_PATH: /data/logs
-      MMTL_LOGGING_MAX_SIZE_MB: "50"
-      MMTL_LOGGING_MAX_BACKUPS: "20"
-      MMTL_LOGGING_MAX_AGE_DAYS: "30"
+      MEBOX_LOGGING_LEVEL: info
+      MEBOX_LOGGING_FORMAT: console
+      MEBOX_LOGGING_OUTPUT_PATH: /data/logs
+      MEBOX_LOGGING_MAX_SIZE_MB: "50"
+      MEBOX_LOGGING_MAX_BACKUPS: "20"
+      MEBOX_LOGGING_MAX_AGE_DAYS: "30"

      # 轻量模式默认只使用 PostgreSQL，适合大多数 NAS。
-      # 旧版 ./data/mmtl.db 存在时，首次启动会自动迁移到 PostgreSQL。
-      MMTL_DATABASE_TYPE: postgres
-      MMTL_DATABASE_DSN: postgres://mmtl:mmtl@postgres:5432/mmtl?sslmode=disable
+      # 旧版 ./data/mmtl.db 或 ./data/mebox.db 存在时，首次启动会自动迁移到 PostgreSQL。
+      MEBOX_DATABASE_TYPE: postgres
+      MEBOX_DATABASE_DSN: postgres://mebox:mebox@postgres:5432/mebox?sslmode=disable

      # SQLite 旧库迁移源：
-      # - 首次从旧版 ./data/mmtl.db 导入时保持此路径。
+      # - 首次从旧版 SQLite（mmtl.db / mebox.db）导入时保持此路径。
      # - 确认迁移完成后，建议改成 /data/no-sqlite-migration.db 这类不存在的路径。
-      MMTL_DATABASE_DB_PATH: /data/mmtl.db
-      MMTL_CACHE_CACHE_DIR: /cache
+      MEBOX_DATABASE_DB_PATH: /data/mebox.db
+      MEBOX_CACHE_CACHE_DIR: /cache

      # 管理面板热更新默认拉取此镜像，并用 Watchtower 一次性重建当前容器。
-      MMTL_UPDATE_IMAGE: ghcr.io/truewhile/mmtl:latest
+      MEBOX_UPDATE_IMAGE: ghcr.io/truewhile/mebox:latest

      # 路径换算配置。
      # 默认推荐在网页里使用容器路径 /media。
      # 如果旧媒体库已经保存了宿主机路径 /vol1/1000/Media，
      # 再把这里改成同一个宿主机真实路径用于旧路径换算。
-      MMTL_MEDIA_DIR: /media
-      MMTL_MEDIA_CONTAINER_DIR: /media
+      MEBOX_MEDIA_DIR: /media
+      MEBOX_MEDIA_CONTAINER_DIR: /media

      # 默认推荐下载器保存路径使用 /downloads。
      # 如果下载器只能返回宿主机路径，再改成同一个宿主机真实路径。
-      MMTL_DOWNLOAD_DIR: /downloads
-      MMTL_DOWNLOAD_CONTAINER_DIR: /downloads
+      MEBOX_DOWNLOAD_DIR: /downloads
+      MEBOX_DOWNLOAD_CONTAINER_DIR: /downloads

      # NAS 友好的低负载默认值。
-      MMTL_TRANSCODER_ENABLED: "true"
-      MMTL_TRANSCODER_HARDWARE_ACCEL: "false"
-      MMTL_TRANSCODER_REALTIME: "true"
-      MMTL_TRANSCODER_THREADS: "2"
-      MMTL_TRANSCODER_MAX_CONCURRENT: "1"
-      MMTL_TRANSCODER_IDLE_TIMEOUT_SECONDS: "120"
+      MEBOX_TRANSCODER_ENABLED: "true"
+      MEBOX_TRANSCODER_HARDWARE_ACCEL: "false"
+      MEBOX_TRANSCODER_REALTIME: "true"
+      MEBOX_TRANSCODER_THREADS: "2"
+      MEBOX_TRANSCODER_MAX_CONCURRENT: "1"
+      MEBOX_TRANSCODER_IDLE_TIMEOUT_SECONDS: "120"

    healthcheck:
      test: ["CMD-SHELL", "busybox wget -qO- http://127.0.0.1:8080/api/health || exit 1"]
@@ -146,20 +146,20 @@ services:

  postgres:
    image: postgres:16-alpine
-    # 首次部署允许拉取；日常更新请只 pull mmtl。
+    # 首次部署允许拉取；日常更新请只 pull mebox。
    # 如需升级 PostgreSQL，请先备份 ./postgres 后再手动调整镜像版本并拉取。
    pull_policy: missing
    restart: unless-stopped
    environment:
-      POSTGRES_DB: mmtl
-      POSTGRES_USER: mmtl
-      POSTGRES_PASSWORD: mmtl
+      POSTGRES_DB: mebox
+      POSTGRES_USER: mebox
+      POSTGRES_PASSWORD: mebox
      TZ: Asia/Shanghai
    volumes:
      # PostgreSQL 主数据目录。升级/重建容器时必须保留。
      - ./postgres:/var/lib/postgresql/data
    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mmtl -d mmtl"]
+      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mebox -d mebox"]
      interval: 10s
      timeout: 5s
      retries: 10
@@ -1,8 +1,8 @@
 #!/bin/sh
 set -eu

-run_uid="${PUID:-$(id -u mmtl 2>/dev/null || echo 1000)}"
-run_gid="${PGID:-$(id -g mmtl 2>/dev/null || echo 1000)}"
+run_uid="${PUID:-$(id -u mebox 2>/dev/null || echo 1000)}"
+run_gid="${PGID:-$(id -g mebox 2>/dev/null || echo 1000)}"

 case "$run_uid" in
  ''|*[!0-9]*)
@@ -19,10 +19,10 @@ case "$run_gid" in
 esac

 if [ "$run_uid" = "0" ]; then
-  exec mmtl
+  exec mebox
 fi

 chown -R "$run_uid:$run_gid" /data /cache 2>/dev/null || true
 chown "$run_uid:$run_gid" /media 2>/dev/null || true

-exec su-exec "$run_uid:$run_gid" mmtl
+exec su-exec "$run_uid:$run_gid" mebox
@@ -0,0 +1,190 @@
+# 【开源推荐】MeBox：把 NAS / 网盘 / 远程 Emby 统一家里的观影入口，Docker 一键部署
+
+> 配图已托管在 GitHub 仓库（`raw.githubusercontent.com` 直链），发帖时可直接引用，或下载 `docs/tutorial-screenshots/` 后作为附件上传。
+
+---
+
+## 写在前面
+
+给论坛的朋友们推荐一个我维护的开源项目 —— **MeBox**，一个面向 NAS 与家庭影音场景的**自托管私人媒体中心**（GPL-3.0，Go + React）。
+
+GitHub：https://github.com/truewhile/MeBox
+
+一句话介绍：**部署一个服务，同时获得媒体库后台、网盘 STRM 整理、Emby 客户端协议网关三件套。** 内置完整 Emby/Jellyfin 服务端协议实现——手机、电视、平板上的 Infuse、SenPlayer、Fileball、Emby/Jellyfin 官方客户端直接「添加 Emby 服务器」就能连，一套账号体系全搞定，Emby 老用户零学习成本。
+
+项目 fork 自 MediaStationGo 并持续二开，围绕网盘播放、任务队列、远程挂载和权限体系做了大量增强。
+
+---
+
+## 它能解决什么问题？
+
+家里看电影电视的痛点，MeBox 基本一把梭：
+
+| 痛点 | MeBox 的解法 |
+| --- | --- |
+| 硬盘散落各处，海报墙乱七八糟 | 多根目录媒体库 + TMDb/Bangumi/Douban 自动刮削，海报墙、继续观看、多季剧集一应俱全 |
+| 网盘资源看一部下一部太麻烦 | OpenList / CloudDrive2 / 115 / WebDAV 接入，STRM 同步 + 直链/302 播放，不占本地空间 |
+| 已经有一台 Emby，出门还得开 App | **远程 Emby 挂载**：把远程 Emby 的媒体库直接挂进 MeBox 界面统一浏览 |
+| 家人乱动设置、小孩看不该看的 | 多用户 + 有效期 + 成人内容开关 + 播放配置 PIN，细粒度权限 |
+| 每个设备装一套专属 App 太折腾 | **完整兼容 Emby/Jellyfin 客户端**：Infuse、SenPlayer、Fileball、官方客户端按「添加 Emby 服务器」填地址 + MeBox 账号即可，海报墙、观看进度、多用户直接同步 |
+
+---
+
+## 特点一览
+
+**1. 现代化 Web UI，海报墙开箱即用**
+
+![登录页](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/01-login.png)
+
+深色系登录页，默认账号 `admin / admin123`（首次登录请立即改密）。
+
+![首页](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/02-home.png)
+
+首页自带焦点推荐轮播 + 媒体库入口卡片，继续观看、最近添加直接呈现。
+
+**2. 媒体库与刮削**
+
+![媒体库总览](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/03-libraries.png)
+
+20 个媒体库、1600+ 条目一眼尽收：每库自带封面拼贴、条目数统计，支持「全库修复+重刮」「刮削队列」批量处理。
+
+![海报墙](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/04-library-posters.png)
+
+库内海报墙带评分、集数角标，支持按最后集添加日期排序，点开即看。
+
+**3. 详情页与多季管理**
+
+![详情页](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/05-media-detail.png)
+
+剧情简介、类型标签、多季分集（特别篇/第 1-N 季）、每集缩略图与时长；一键立即播放、调用外部播放器、加入收藏。
+
+**4. Emby/Jellyfin 客户端无缝兼容**
+
+这是我最想强调的一点：**MeBox 内置了完整的 Emby 服务端协议实现**。手机、电视、平板上的 Infuse、SenPlayer、Fileball，甚至 Emby/Jellyfin 官方客户端，都不需要任何插件或改造——按「添加 Emby 服务器」填入 `http://服务器IP:18080`，用 MeBox 账号登录，海报墙、观看进度、收藏、多用户权限全部无缝衔接。已经习惯 Emby 生态的朋友可以零成本迁移，家人只用电视端 App 也完全无感。
+
+**5. 网页播放器 + 弹幕自动匹配**
+
+![播放器与弹幕](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/06-player-danmu.png)
+
+内置网页播放器支持 HLS 转码、字幕、播放配置档；**弹幕按剧名自动匹配全季分集**（截图中自动匹配到《一拳超人》39 集），屏幕占比/透明度/字号随意调，追新番体验直接拉满。
+
+**6. 网盘 STRM：网盘当本地盘用**
+
+![STRM 管理](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/07-strm-cloud.png)
+
+添加网盘账号（**115 支持二维码扫码登录**）→ 添加同步目录 → 系统把网盘/本地目录里的视频生成 `.strm` 文件，元数据经下载/上传队列双向同步，播放走直链/302 不落盘。
+
+**7. 远程 Emby 挂载（特色功能）**
+
+![Emby 挂载](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/08-emby-mount.png)
+
+已有远程 Emby 服务器？填一次账号，按需勾选要挂载的媒体库（支持同服务器多线路自动切换、直连开关、排序），远程库直接出现在 MeBox 首页，不必再开 Emby 客户端。
+
+**8. 任务队列统一管理**
+
+![任务队列](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/09-task-queue.png)
+
+刮削 / 下载 / 上传三类任务统一看板，排队中、进行中、已匹配、失败分类计数，支持搜索与批量清理。
+
+**9. 下载与自动整理**
+
+![文件管理](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/11-file-manager.png)
+
+配合任意下载器（qBittorrent、Transmission 等下载到本地目录即可），MeBox 定时自动整理入媒体库：智能分类子库、自动注册目的地媒体库、复制/移动/硬链/软链多种整理方式，命名规则可配。
+
+**10. 多用户与权限**
+
+![用户管理](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/12-user-admin.png)
+
+管理员/普通用户分级、单实例用户数上限、账号有效期、成人内容开关、播放配置 PIN——给家人开号放心给。
+
+**11. 运维省心**
+
+![系统设置](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/10-settings.png)
+
+FFmpeg/FFprobe 一键下载安装、转码与硬件加速开关、TMDb 语言、识别词、弹幕、Adult/NSFW 开关全在设置页分组管理；另有 DLNA 投屏、存储统计、海报墙聚合视图：
+
+![海报墙聚合](https://raw.githubusercontent.com/truewhile/MeBox/main/docs/tutorial-screenshots/13-poster-wall.png)
+
+---
+
+## 使用教程：从零到海报墙只要 5 步
+
+### 第 1 步：Docker 一键部署
+
+推荐 Docker Compose（仓库提供 4 份互相独立的完整模板，无需 `.env`）：
+
+```bash
+mkdir -p MeBox && cd MeBox
+
+# 最省心：单镜像 + 内置 SQLite
+curl -fsSL https://raw.githubusercontent.com/truewhile/MeBox/main/docker-compose.simple.yml -o docker-compose.yml
+
+# 多用户/大数据量可选 PostgreSQL 档、Redis 档、OpenSearch 档，见仓库 README「部署档位」
+
+docker compose up -d
+```
+
+浏览器访问 `http://服务器IP:18080`，镜像：`ghcr.io/truewhile/mebox:latest`（amd64 / arm64 都有，也提供 Windows/Linux/macOS 单文件可执行程序，不想装 Docker 直接下载跑）。
+
+### 第 2 步：登录并修改密码
+
+默认账号 `admin / admin123`，登录后右上角头像 → 个人资料修改密码。
+
+### 第 3 步：创建媒体库 + 扫库
+
+后台 → 媒体库 → 管理媒体库，添加本地路径（Docker 部署记得填**容器内**路径，如 `/media/电影`，`volumes` 左侧挂宿主机真实目录）→ 执行扫库。
+
+### 第 4 步：配置元数据刮削
+
+系统设置 → 外部 API，填入 TMDb / Bangumi / Douban 等 API Key；媒体库页可对单个库「全库修复+重刮」，刮削进度在任务队列实时可见。
+
+### 第 5 步（可选但强烈推荐）：
+
+- **网盘用户**：STRM 管理 → 添加网盘账号（115 可扫码）→ 添加同步目录 → 生成 STRM 后直链播放；
+- **已有 Emby**：Emby 挂载 → 添加 Emby 账号 → 勾选要挂载的媒体库；
+- **第三方播放器（Emby 客户端全兼容）**：Infuse / SenPlayer / Fileball / Emby、Jellyfin 官方客户端，按「添加 Emby 服务器」填 `http://服务器IP:18080`，用 MeBox 账号登录即可，原有使用习惯完全不变；
+- **下载党**：qBittorrent 等任意下载器把视频下到下载目录，在文件管理里把它设为整理源，下完自动分类入库。
+
+### 路径映射小抄（Docker 最常见坑）
+
+```yaml
+volumes:
+  - /vol1/1000/Media:/media        # 左：宿主机真实路径；右：容器内路径（网页里填这个）
+environment:
+  MEBOX_MEDIA_DIR: /vol1/1000/Media
+  MEBOX_MEDIA_CONTAINER_DIR: /media
+```
+
+硬链接要求同一文件系统/子卷，跨盘请改复制或软链。
+
+---
+
+## 部署档位怎么选？
+
+| 档位 | 文件 | 组件 | 适合 |
+| --- | --- | --- | --- |
+| 极简 | `docker-compose.simple.yml` | 单镜像 + SQLite | 个人使用、低配设备 |
+| 标准 | `docker-compose.yml` | + PostgreSQL | 多用户家庭共享 |
+| 增强 | `docker-compose.standard.yml` | + Redis | 大媒体库高频访问 |
+| 搜索 | `docker-compose.search.yml` | + OpenSearch | 超大库全文搜索 |
+
+---
+
+## 技术栈与致谢
+
+- 后端：Go · Gin · GORM · SQLite/PostgreSQL · 可选 Redis / OpenSearch
+- 前端：React 18 · Vite · TypeScript · Tailwind CSS · Zustand
+- 部署：Docker Compose 多档模板，amd64/arm64 镜像 + 单文件可执行
+
+感谢上游 [MediaStationGo](https://github.com/ShukeBta/MediaStationGo) 的奠基，网盘同步/STRM/整理部分参考了 [qmediasync](https://github.com/qicfan/qmediasync) 的思路。
+
+---
+
+## 链接
+
+- GitHub：https://github.com/truewhile/MeBox
+- Issue / PR：欢迎提 bug（附部署方式+复现步骤+日志）与功能建议
+- License：GPL-3.0
+
+觉得有用的话求个 Star ⭐，也欢迎论坛里的朋友反馈使用体验，我长期维护。
@@ -1,60 +1,74 @@
-module github.com/ShukeBta/MMTL
+module github.com/truewhile/MeBox

 go 1.25.0

 require (
 	github.com/aliyun/alibabacloud-oss-go-sdk-v2 v1.5.2
 	github.com/fsnotify/fsnotify v1.7.0
-	github.com/gin-gonic/gin v1.9.1
+	github.com/gin-contrib/gzip v1.2.6
+	github.com/gin-gonic/gin v1.12.0
 	github.com/glebarez/sqlite v1.11.0
-	github.com/golang-jwt/jwt/v5 v5.2.0
+	github.com/golang-jwt/jwt/v5 v5.2.2
 	github.com/google/uuid v1.6.0
 	github.com/gorilla/websocket v1.5.3
+	github.com/metatube-community/metatube-sdk-go v1.4.0
 	github.com/redis/go-redis/v9 v9.7.0
 	github.com/shirou/gopsutil/v3 v3.24.5
 	github.com/spf13/viper v1.18.2
-	github.com/stretchr/testify v1.9.0
+	github.com/stretchr/testify v1.11.1
+	github.com/ulikunitz/xz v0.5.12
 	go.uber.org/zap v1.27.0
-	golang.org/x/crypto v0.21.0
-	golang.org/x/sys v0.20.0
+	golang.org/x/crypto v0.49.0
+	golang.org/x/image v0.37.0
+	golang.org/x/sys v0.42.0
 	golang.org/x/time v0.15.0
-	gorm.io/driver/postgres v1.5.7
-	gorm.io/gorm v1.30.0
+	gopkg.in/yaml.v3 v3.0.1
+	gorm.io/driver/postgres v1.6.0
+	gorm.io/gorm v1.31.1
 )

 require (
-	github.com/bytedance/sonic v1.9.1 // indirect
+	github.com/bytedance/gopkg v0.1.4 // indirect
+	github.com/bytedance/sonic v1.15.0 // indirect
+	github.com/bytedance/sonic/loader v0.5.0 // indirect
 	github.com/cespare/xxhash/v2 v2.2.0 // indirect
-	github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311 // indirect
+	github.com/cloudwego/base64x v0.1.6 // indirect
 	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
 	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
+	github.com/disintegration/imaging v1.6.3-0.20201218193011-d40f48ce0f09 // indirect
 	github.com/dustin/go-humanize v1.0.1 // indirect
-	github.com/gabriel-vasile/mimetype v1.4.2 // indirect
-	github.com/gin-contrib/sse v0.1.0 // indirect
-	github.com/glebarez/go-sqlite v1.21.2 // indirect
+	github.com/esimov/pigo v1.4.7-0.20240801095032-7465ed14de47 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.13 // indirect
+	github.com/gin-contrib/sse v1.1.0 // indirect
+	github.com/glebarez/go-sqlite v1.22.0 // indirect
 	github.com/go-ole/go-ole v1.2.6 // indirect
 	github.com/go-playground/locales v0.14.1 // indirect
 	github.com/go-playground/universal-translator v0.18.1 // indirect
-	github.com/go-playground/validator/v10 v10.14.0 // indirect
-	github.com/goccy/go-json v0.10.2 // indirect
+	github.com/go-playground/validator/v10 v10.30.1 // indirect
+	github.com/goccy/go-json v0.10.6 // indirect
+	github.com/goccy/go-yaml v1.19.2 // indirect
 	github.com/hashicorp/hcl v1.0.0 // indirect
 	github.com/jackc/pgpassfile v1.0.0 // indirect
-	github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a // indirect
-	github.com/jackc/pgx/v5 v5.4.3 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
+	github.com/jackc/pgx/v5 v5.8.0 // indirect
+	github.com/jackc/puddle/v2 v2.2.2 // indirect
 	github.com/jinzhu/inflection v1.0.0 // indirect
 	github.com/jinzhu/now v1.1.5 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
-	github.com/klauspost/cpuid/v2 v2.2.4 // indirect
-	github.com/leodido/go-urn v1.2.4 // indirect
+	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0 // indirect
 	github.com/magiconair/properties v1.8.7 // indirect
-	github.com/mattn/go-isatty v0.0.19 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mitchellh/mapstructure v1.5.0 // indirect
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 	github.com/modern-go/reflect2 v1.0.2 // indirect
-	github.com/pelletier/go-toml/v2 v2.1.0 // indirect
+	github.com/ncruces/go-strftime v1.0.0 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.4 // indirect
 	github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
 	github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c // indirect
+	github.com/quic-go/qpack v0.6.0 // indirect
+	github.com/quic-go/quic-go v0.59.0 // indirect
 	github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
 	github.com/sagikazarmark/locafero v0.4.0 // indirect
 	github.com/sagikazarmark/slog-shim v0.1.0 // indirect
@@ -67,19 +81,19 @@ require (
 	github.com/tklauser/go-sysconf v0.3.12 // indirect
 	github.com/tklauser/numcpus v0.6.1 // indirect
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
-	github.com/ugorji/go/codec v1.2.11 // indirect
-	github.com/ulikunitz/xz v0.5.12 // indirect
+	github.com/ugorji/go/codec v1.3.1 // indirect
 	github.com/yusufpapurcu/wmi v1.2.4 // indirect
+	go.mongodb.org/mongo-driver/v2 v2.5.0 // indirect
 	go.uber.org/multierr v1.10.0 // indirect
-	golang.org/x/arch v0.3.0 // indirect
-	golang.org/x/exp v0.0.0-20230905200255-921286631fa9 // indirect
-	golang.org/x/net v0.21.0 // indirect
-	golang.org/x/text v0.20.0 // indirect
-	google.golang.org/protobuf v1.31.0 // indirect
+	golang.org/x/arch v0.25.0 // indirect
+	golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 // indirect
+	golang.org/x/net v0.52.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/text v0.35.0 // indirect
+	google.golang.org/protobuf v1.36.11 // indirect
 	gopkg.in/ini.v1 v1.67.0 // indirect
-	gopkg.in/yaml.v3 v3.0.1 // indirect
-	modernc.org/libc v1.22.5 // indirect
-	modernc.org/mathutil v1.5.0 // indirect
-	modernc.org/memory v1.5.0 // indirect
-	modernc.org/sqlite v1.23.1 // indirect
+	modernc.org/libc v1.70.0 // indirect
+	modernc.org/mathutil v1.7.1 // indirect
+	modernc.org/memory v1.11.0 // indirect
+	modernc.org/sqlite v1.47.0 // indirect
 )
@@ -4,34 +4,42 @@ github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
 github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
 github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
 github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
-github.com/bytedance/sonic v1.5.0/go.mod h1:ED5hyg4y6t3/9Ku1R6dU/4KyJ48DZ4jPhfY1O2AihPM=
-github.com/bytedance/sonic v1.9.1 h1:6iJ6NqdoxCDr6mbY8h18oSO+cShGSMRGCEo7F2h0x8s=
-github.com/bytedance/sonic v1.9.1/go.mod h1:i736AoUSYt75HyZLoJW9ERYxcy6eaN6h4BZXU064P/U=
+github.com/bytedance/gopkg v0.1.4 h1:oZnQwnX82KAIWb7033bEwtxvTqXcYMxDBaQxo5JJHWM=
+github.com/bytedance/gopkg v0.1.4/go.mod h1:v1zWfPm21Fb+OsyXN2VAHdL6TBb2L88anLQgdyje6R4=
+github.com/bytedance/sonic v1.15.0 h1:/PXeWFaR5ElNcVE84U0dOHjiMHQOwNIx3K4ymzh/uSE=
+github.com/bytedance/sonic v1.15.0/go.mod h1:tFkWrPz0/CUCLEF4ri4UkHekCIcdnkqXw9VduqpJh0k=
+github.com/bytedance/sonic/loader v0.5.0 h1:gXH3KVnatgY7loH5/TkeVyXPfESoqSBSBEiDd5VjlgE=
+github.com/bytedance/sonic/loader v0.5.0/go.mod h1:AR4NYCk5DdzZizZ5djGqQ92eEhCCcdf5x77udYiSJRo=
 github.com/cespare/xxhash/v2 v2.2.0 h1:DC2CZ1Ep5Y4k3ZQ899DldepgrayRUGE6BBZ/cd9Cj44=
 github.com/cespare/xxhash/v2 v2.2.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
-github.com/chenzhuoyu/base64x v0.0.0-20211019084208-fb5309c8db06/go.mod h1:DH46F32mSOjUmXrMHnKwZdA8wcEefY7UVqBKYGjpdQY=
-github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311 h1:qSGYFH7+jGhDF8vLC+iwCD4WpbV1EBDSzWkJODFLams=
-github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311/go.mod h1:b583jCggY9gE99b6G5LEC39OIiVsWj+R97kbl5odCEk=
+github.com/cloudwego/base64x v0.1.6 h1:t11wG9AECkCDk5fMSoxmufanudBtJ+/HemLstXDLI2M=
+github.com/cloudwego/base64x v0.1.6/go.mod h1:OFcloc187FXDaYHvrNIjxSe8ncn0OOM8gEHfghB2IPU=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
 github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
+github.com/disintegration/imaging v1.6.3-0.20201218193011-d40f48ce0f09 h1:MJFqtdxTq94XqUgg7DcGCaOIXrDTJE/tPHK66Jshguc=
+github.com/disintegration/imaging v1.6.3-0.20201218193011-d40f48ce0f09/go.mod h1:44/5580QXChDfwIclfc/PCwrr44amcmDAg8hxG0Ewe4=
 github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
 github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
+github.com/esimov/pigo v1.4.7-0.20240801095032-7465ed14de47 h1:48iGRx9HamDuG4pCbPG5IXt4bKHhgn33KGynzHUgeIA=
+github.com/esimov/pigo v1.4.7-0.20240801095032-7465ed14de47/go.mod h1:bIH3W2QoHvchgAPl6DUwIUguIHJwvMS6sePQIvhxPTc=
 github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
 github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
 github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
 github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
-github.com/gabriel-vasile/mimetype v1.4.2 h1:w5qFW6JKBz9Y393Y4q372O9A7cUSequkh1Q7OhCmWKU=
-github.com/gabriel-vasile/mimetype v1.4.2/go.mod h1:zApsH/mKG4w07erKIaJPFiX0Tsq9BFQgN3qGY5GnNgA=
-github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
-github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
-github.com/gin-gonic/gin v1.9.1 h1:4idEAncQnU5cB7BeOkPtxjfCSye0AAm1R0RVIqJ+Jmg=
-github.com/gin-gonic/gin v1.9.1/go.mod h1:hPrL7YrpYKXt5YId3A/Tnip5kqbEAP+KLuI3SUcPTeU=
-github.com/glebarez/go-sqlite v1.21.2 h1:3a6LFC4sKahUunAmynQKLZceZCOzUthkRkEAl9gAXWo=
-github.com/glebarez/go-sqlite v1.21.2/go.mod h1:sfxdZyhQjTM2Wry3gVYWaW072Ri1WMdWJi0k6+3382k=
+github.com/gabriel-vasile/mimetype v1.4.13 h1:46nXokslUBsAJE/wMsp5gtO500a4F3Nkz9Ufpk2AcUM=
+github.com/gabriel-vasile/mimetype v1.4.13/go.mod h1:d+9Oxyo1wTzWdyVUPMmXFvp4F9tea18J8ufA774AB3s=
+github.com/gin-contrib/gzip v1.2.6 h1:OtN8DplD5DNZCSLAnQ5HxRkD2qZ5VU+JhOrcfJrcRvg=
+github.com/gin-contrib/gzip v1.2.6/go.mod h1:BQy8/+JApnRjAVUplSGZiVtD2k8GmIE2e9rYu/hLzzU=
+github.com/gin-contrib/sse v1.1.0 h1:n0w2GMuUpWDVp7qSpvze6fAu9iRxJY4Hmj6AmBOU05w=
+github.com/gin-contrib/sse v1.1.0/go.mod h1:hxRZ5gVpWMT7Z0B0gSNYqqsSCNIJMjzvm6fqCz9vjwM=
+github.com/gin-gonic/gin v1.12.0 h1:b3YAbrZtnf8N//yjKeU2+MQsh2mY5htkZidOM7O0wG8=
+github.com/gin-gonic/gin v1.12.0/go.mod h1:VxccKfsSllpKshkBWgVgRniFFAzFb9csfngsqANjnLc=
+github.com/glebarez/go-sqlite v1.22.0 h1:uAcMJhaA6r3LHMTFgP0SifzgXg46yJkgxqyuyec+ruQ=
+github.com/glebarez/go-sqlite v1.22.0/go.mod h1:PlBIdHe0+aUEFn+r2/uthrWq4FxbzugL0L8Li6yQJbc=
 github.com/glebarez/sqlite v1.11.0 h1:wSG0irqzP6VurnMEpFGer5Li19RpIRi2qvQz++w0GMw=
 github.com/glebarez/sqlite v1.11.0/go.mod h1:h8/o8j5wiAsqSPoWELDUdJXhjAhsVliSn7bWZjOhrgQ=
 github.com/go-ole/go-ole v1.2.6 h1:/Fpf6oFPoeFik9ty7siob0G6Ke8QvQEuVcuChpwXzpY=
@@ -42,53 +50,59 @@ github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/o
 github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
 github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
 github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
-github.com/go-playground/validator/v10 v10.14.0 h1:vgvQWe3XCz3gIeFDm/HnTIbj6UGmg/+t63MyGU2n5js=
-github.com/go-playground/validator/v10 v10.14.0/go.mod h1:9iXMNT7sEkjXb0I+enO7QXmzG6QCsPWY4zveKFVRSyU=
-github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
-github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
-github.com/golang-jwt/jwt/v5 v5.2.0 h1:d/ix8ftRUorsN+5eMIlF4T6J8CAt9rch3My2winC1Jw=
-github.com/golang-jwt/jwt/v5 v5.2.0/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
-github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
-github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/go-playground/validator/v10 v10.30.1 h1:f3zDSN/zOma+w6+1Wswgd9fLkdwy06ntQJp0BBvFG0w=
+github.com/go-playground/validator/v10 v10.30.1/go.mod h1:oSuBIQzuJxL//3MelwSLD5hc2Tu889bF0Idm9Dg26cM=
+github.com/goccy/go-json v0.10.6 h1:p8HrPJzOakx/mn/bQtjgNjdTcN+/S6FcG2CTtQOrHVU=
+github.com/goccy/go-json v0.10.6/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
+github.com/goccy/go-yaml v1.19.2 h1:PmFC1S6h8ljIz6gMRBopkjP1TVT7xuwrButHID66PoM=
+github.com/goccy/go-yaml v1.19.2/go.mod h1:XBurs7gK8ATbW4ZPGKgcbrY1Br56PdM69F7LkFRi1kA=
+github.com/golang-jwt/jwt/v5 v5.2.2 h1:Rl4B7itRWVtYIHFrSNd7vhTiz9UpLdi6gZhZ3wEeDy8=
+github.com/golang-jwt/jwt/v5 v5.2.2/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
 github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
-github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
-github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
-github.com/google/pprof v0.0.0-20221118152302-e6195bd50e26 h1:Xim43kblpZXfIBQsbuBVKCudVG457BR2GZFIz3uw3hQ=
-github.com/google/pprof v0.0.0-20221118152302-e6195bd50e26/go.mod h1:dDKJzRmX4S37WGHujM7tX//fmj1uioxKzKxz3lo4HJo=
+github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs=
+github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
 github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/hashicorp/golang-lru v0.5.4 h1:YDjusn29QI/Das2iO9M0BHnIbxPeyuCHsjMW+lJfyTc=
+github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k=
+github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM=
 github.com/hashicorp/hcl v1.0.0 h1:0Anlzjpi4vEasTeNFn2mLJgTSwt0+6sfsiTG8qcWGx4=
 github.com/hashicorp/hcl v1.0.0/go.mod h1:E5yfLk+7swimpb2L/Alb/PJmXilQ/rhwaUYs4T20WEQ=
 github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
 github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
-github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a h1:bbPeKD0xmW/Y25WS6cokEszi5g+S0QxI/d45PkRi7Nk=
-github.com/jackc/pgservicefile v0.0.0-20221227161230-091c0ba34f0a/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
-github.com/jackc/pgx/v5 v5.4.3 h1:cxFyXhxlvAifxnkKKdlxv8XqUf59tDlYjnV5YYfsJJY=
-github.com/jackc/pgx/v5 v5.4.3/go.mod h1:Ig06C2Vu0t5qXC60W8sqIthScaEnFvojjj9dSljmHRA=
+github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
+github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
+github.com/jackc/pgx/v5 v5.8.0 h1:TYPDoleBBme0xGSAX3/+NujXXtpZn9HBONkQC7IEZSo=
+github.com/jackc/pgx/v5 v5.8.0/go.mod h1:QVeDInX2m9VyzvNeiCJVjCkNFqzsNb43204HshNSZKw=
+github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
+github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
 github.com/jinzhu/inflection v1.0.0 h1:K317FqzuhWc8YvSVlFMCCUb36O/S9MCKRDI7QkRKD/E=
 github.com/jinzhu/inflection v1.0.0/go.mod h1:h+uFLlag+Qp1Va5pdKtLDYj+kHp5pxUVkryuEj+Srlc=
 github.com/jinzhu/now v1.1.5 h1:/o9tlHleP7gOFmsnYNz3RGnqzefHA47wQpKrrdTIwXQ=
 github.com/jinzhu/now v1.1.5/go.mod h1:d3SSVoowX0Lcu0IBviAWJpolVfI5UJVZZ7cO71lE/z8=
 github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
 github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
-github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
-github.com/klauspost/cpuid/v2 v2.2.4 h1:acbojRNwl3o09bUq+yDCtZFc1aiwaAAxtcn8YkZXnvk=
-github.com/klauspost/cpuid/v2 v2.2.4/go.mod h1:RVVoqg1df56z8g3pUjL/3lE5UfnlrJX8tyFgg4nqhuY=
+github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y=
+github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
 github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
 github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
-github.com/leodido/go-urn v1.2.4 h1:XlAE/cm/ms7TE/VMVoduSpNBoyc2dOxHs5MZSwAN63Q=
-github.com/leodido/go-urn v1.2.4/go.mod h1:7ZrI8mTSeBSHl/UaRyKQW1qZeMgak41ANeCNaVckg+4=
+github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
+github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
 github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0 h1:6E+4a0GO5zZEnZ81pIr0yLvtUWk2if982qA3F3QD6H4=
 github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0/go.mod h1:zJYVVT2jmtg6P3p1VtQj7WsuWi/y4VnjVBn7F8KPB3I=
 github.com/magiconair/properties v1.8.7 h1:IeQXZAiQcpL9mgcAe1Nu6cX9LLw6ExEHKjN0VQdvPDY=
 github.com/magiconair/properties v1.8.7/go.mod h1:Dhd985XPs7jluiymwWYZ0G4Z61jb3vdS329zhj2hYo0=
-github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA=
-github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/metatube-community/metatube-sdk-go v1.4.0 h1:NBbjxU5SuzgMABM58/f/tmbuTg+hn+Nv1PnlF+gihGI=
+github.com/metatube-community/metatube-sdk-go v1.4.0/go.mod h1:FRgPioGhlkXgD6RmOKQDWITwxlsl0K9cXONFz06jymw=
 github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY=
 github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo=
 github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
@@ -96,20 +110,25 @@ github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
 github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
-github.com/pelletier/go-toml/v2 v2.1.0 h1:FnwAJ4oYMvbT/34k9zzHuZNrhlz48GB3/s6at6/MHO4=
-github.com/pelletier/go-toml/v2 v2.1.0/go.mod h1:tJU2Z3ZkXwnxa4DPO899bsyIoywizdUvyaeZurnPPDc=
+github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
+github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
+github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
+github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=
 github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c h1:ncq/mPwQF4JjgDlrVEn3C11VoGHZN7m8qihwgMEtzYw=
 github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c/go.mod h1:OmDBASR4679mdNQnz2pUhc2G8CO2JrUAVFDRBDP/hJE=
+github.com/quic-go/qpack v0.6.0 h1:g7W+BMYynC1LbYLSqRt8PBg5Tgwxn214ZZR34VIOjz8=
+github.com/quic-go/qpack v0.6.0/go.mod h1:lUpLKChi8njB4ty2bFLX2x4gzDqXwUpaO1DP9qMDZII=
+github.com/quic-go/quic-go v0.59.0 h1:OLJkp1Mlm/aS7dpKgTc6cnpynnD2Xg7C1pwL6vy/SAw=
+github.com/quic-go/quic-go v0.59.0/go.mod h1:upnsH4Ju1YkqpLXC305eW3yDZ4NfnNbmQRCMWS58IKU=
 github.com/redis/go-redis/v9 v9.7.0 h1:HhLSs+B6O021gwzl+locl0zEDnyNkxMtf/Z3NNBMa9E=
 github.com/redis/go-redis/v9 v9.7.0/go.mod h1:f6zhXITC7JUJIlPEiBOTXxJgPLdZcA93GewI7inzyWw=
-github.com/remyoudompheng/bigfft v0.0.0-20200410134404-eec4a21b6bb0/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=
-github.com/rogpeppe/go-internal v1.9.0 h1:73kH8U+JUqXU8lRuOHeVHaa/SZPifC7BkcraZVejAe8=
-github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs=
+github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M=
+github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA=
 github.com/sagikazarmark/locafero v0.4.0 h1:HApY1R9zGo4DBgr7dqsTH/JJxLTTsOt7u6keLGt6kNQ=
 github.com/sagikazarmark/locafero v0.4.0/go.mod h1:Pe1W6UlPYUk/+wc/6KFhbORCfqzgYEpgQ3O5fPuL3H4=
 github.com/sagikazarmark/slog-shim v0.1.0 h1:diDBnUNK9N/354PgrxMywXnAwEr1QZcOr6gto+ugjYE=
@@ -133,15 +152,15 @@ github.com/spf13/viper v1.18.2/go.mod h1:EKmWIqdnk5lOcmR72yw6hS+8OPYcwD0jteitLMV
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
-github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
 github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
-github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
 github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8=
 github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
 github.com/tklauser/go-sysconf v0.3.12 h1:0QaGUFOdQaIVdPgfITYzaTegZvdCjmYO52cSFAEVmqU=
@@ -150,43 +169,54 @@ github.com/tklauser/numcpus v0.6.1 h1:ng9scYS7az0Bk4OZLvrNXNSAO2Pxr1XXRAPyjhIx+F
 github.com/tklauser/numcpus v0.6.1/go.mod h1:1XfjsgE2zo8GVw7POkMbHENHzVg3GzmoZ9fESEdAacY=
 github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
 github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
-github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU=
-github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+github.com/ugorji/go/codec v1.3.1 h1:waO7eEiFDwidsBN6agj1vJQ4AG7lh2yqXyOXqhgQuyY=
+github.com/ugorji/go/codec v1.3.1/go.mod h1:pRBVtBSKl77K30Bv8R2P+cLSGaTtex6fsA2Wjqmfxj4=
 github.com/ulikunitz/xz v0.5.12 h1:37Nm15o69RwBkXM0J6A5OlE67RZTfzUxTj8fB3dfcsc=
 github.com/ulikunitz/xz v0.5.12/go.mod h1:nbz6k7qbPmH4IRqmfOplQw/tblSgqTqBwxkY0oWt/14=
 github.com/yusufpapurcu/wmi v1.2.4 h1:zFUKzehAFReQwLys1b/iSMl+JQGSCSjtVqQn9bBrPo0=
 github.com/yusufpapurcu/wmi v1.2.4/go.mod h1:SBZ9tNy3G9/m5Oi98Zks0QjeHVDvuK0qfxQmPyzfmi0=
+go.mongodb.org/mongo-driver/v2 v2.5.0 h1:yXUhImUjjAInNcpTcAlPHiT7bIXhshCTL3jVBkF3xaE=
+go.mongodb.org/mongo-driver/v2 v2.5.0/go.mod h1:yOI9kBsufol30iFsl1slpdq1I0eHPzybRWdyYUs8K/0=
 go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
 go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
+go.uber.org/mock v0.6.0 h1:hyF9dfmbgIX5EfOdasqLsWD6xqpNZlXblLB/Dbnwv3Y=
+go.uber.org/mock v0.6.0/go.mod h1:KiVJ4BqZJaMj4svdfmHM0AUx4NJYO8ZNpPnZn1Z+BBU=
 go.uber.org/multierr v1.10.0 h1:S0h4aNzvfcFsC3dRF1jLoaov7oRaKqRGC/pUEJ2yvPQ=
 go.uber.org/multierr v1.10.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
 go.uber.org/zap v1.27.0 h1:aJMhYGrd5QSmlpLMr2MftRKl7t8J8PTZPA732ud/XR8=
 go.uber.org/zap v1.27.0/go.mod h1:GB2qFLM7cTU87MWRP2mPIjqfIDnGu+VIO4V/SdhGo2E=
-golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
-golang.org/x/arch v0.3.0 h1:02VY4/ZcO/gBOH6PUaoiptASxtXU10jazRCP865E97k=
-golang.org/x/arch v0.3.0/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
-golang.org/x/crypto v0.21.0 h1:X31++rzVUdKhX5sWmSOFZxx8UW/ldWx55cbf08iNAMA=
-golang.org/x/crypto v0.21.0/go.mod h1:0BP7YvVV9gBbVKyeTG0Gyn+gZm94bibOW5BjDEYAOMs=
-golang.org/x/exp v0.0.0-20230905200255-921286631fa9 h1:GoHiUyI/Tp2nVkLI2mCxVkOjsbSXD66ic0XW0js0R9g=
-golang.org/x/exp v0.0.0-20230905200255-921286631fa9/go.mod h1:S2oDrQGGwySpoQPVqRShND87VCbxmc6bL1Yd2oYrm6k=
-golang.org/x/net v0.21.0 h1:AQyQV4dYCvJ7vGmJyKki9+PBdyvhkSd8EIx/qb0AYv4=
-golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44=
+golang.org/x/arch v0.25.0 h1:qnk6Ksugpi5Bz32947rkUgDt9/s5qvqDPl/gBKdMJLE=
+golang.org/x/arch v0.25.0/go.mod h1:0X+GdSIP+kL5wPmpK7sdkEVTt2XoYP0cSjQSbZBwOi8=
+golang.org/x/crypto v0.49.0 h1:+Ng2ULVvLHnJ/ZFEq4KdcDd/cfjrrjjNSXNzxg0Y4U4=
+golang.org/x/crypto v0.49.0/go.mod h1:ErX4dUh2UM+CFYiXZRTcMpEcN8b/1gxEuv3nODoYtCA=
+golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 h1:mgKeJMpvi0yx/sU5GsxQ7p6s2wtOnGAHZWCHUM4KGzY=
+golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546/go.mod h1:j/pmGrbnkbPtQfxEe5D0VQhZC6qKbfKifgD0oM7sR70=
+golang.org/x/image v0.0.0-20191009234506-e7c1f5e7dbb8/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0=
+golang.org/x/image v0.37.0 h1:ZiRjArKI8GwxZOoEtUfhrBtaCN+4b/7709dlT6SSnQA=
+golang.org/x/image v0.37.0/go.mod h1:/3f6vaXC+6CEanU4KJxbcUZyEePbyKbaLoDOe4ehFYY=
+golang.org/x/mod v0.33.0 h1:tHFzIWbBifEmbwtGz65eaWyGiGZatSrT9prnU8DbVL8=
+golang.org/x/mod v0.33.0/go.mod h1:swjeQEj+6r7fODbD2cqrnje9PnziFuw4bmLbBZFrQ5w=
+golang.org/x/net v0.52.0 h1:He/TN1l0e4mmR3QqHMT2Xab3Aj3L9qjbhRm78/6jrW0=
+golang.org/x/net v0.52.0/go.mod h1:R1MAz7uMZxVMualyPXb+VaqGSa3LIaUqk0eEt3w36Sw=
+golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
+golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
 golang.org/x/sys v0.0.0-20190916202348-b4ddaad3f8a3/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20201204225414-ed752295db88/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20220704084225-05e143d24a9e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y=
-golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/text v0.20.0 h1:gK/Kv2otX8gz+wn7Rmb3vT96ZwuoxnQlY+HlJVj7Qug=
-golang.org/x/text v0.20.0/go.mod h1:D4IsuqiFMhST5bX19pQ9ikHC2GsaKyk/oF+pn3ducp4=
+golang.org/x/sys v0.42.0 h1:omrd2nAlyT5ESRdCLYdm3+fMfNFE/+Rf4bDIQImRJeo=
+golang.org/x/sys v0.42.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.35.0 h1:JOVx6vVDFokkpaq1AEptVzLTpDe9KGpj5tR4/X+ybL8=
+golang.org/x/text v0.35.0/go.mod h1:khi/HExzZJ2pGnjenulevKNX1W67CUy0AsXcNubPGCA=
 golang.org/x/time v0.15.0 h1:bbrp8t3bGUeFOx08pvsMYRTCVSMk89u4tKbNOZbp88U=
 golang.org/x/time v0.15.0/go.mod h1:Y4YMaQmXwGQZoFaVFk4YpCt4FLQMYKZe9oeV/f4MSno=
+golang.org/x/tools v0.43.0 h1:12BdW9CeB3Z+J/I/wj34VMl8X+fEXBxVR90JeMX5E7s=
+golang.org/x/tools v0.43.0/go.mod h1:uHkMso649BX2cZK6+RpuIPXS3ho2hZo4FVwfoy1vIk0=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
-google.golang.org/protobuf v1.31.0 h1:g0LDEJHgrBl9N9r17Ru3sqWhkIx2NB67okBHPwC7hs8=
-google.golang.org/protobuf v1.31.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
+google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
+google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
@@ -195,16 +225,35 @@ gopkg.in/ini.v1 v1.67.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-gorm.io/driver/postgres v1.5.7 h1:8ptbNJTDbEmhdr62uReG5BGkdQyeasu/FZHxI0IMGnM=
-gorm.io/driver/postgres v1.5.7/go.mod h1:3e019WlBaYI5o5LIdNV+LyxCMNtLOQETBXL2h4chKpA=
-gorm.io/gorm v1.30.0 h1:qbT5aPv1UH8gI99OsRlvDToLxW5zR7FzS9acZDOZcgs=
-gorm.io/gorm v1.30.0/go.mod h1:8Z33v652h4//uMA76KjeDH8mJXPm1QNCYrMeatR0DOE=
-modernc.org/libc v1.22.5 h1:91BNch/e5B0uPbJFgqbxXuOnxBQjlS//icfQEGmvyjE=
-modernc.org/libc v1.22.5/go.mod h1:jj+Z7dTNX8fBScMVNRAYZ/jF91K8fdT2hYMThc3YjBY=
-modernc.org/mathutil v1.5.0 h1:rV0Ko/6SfM+8G+yKiyI830l3Wuz1zRutdslNoQ0kfiQ=
-modernc.org/mathutil v1.5.0/go.mod h1:mZW8CKdRPY1v87qxC/wUdX5O1qDzXMP5TH3wjfpga6E=
-modernc.org/memory v1.5.0 h1:N+/8c5rE6EqugZwHii4IFsaJ7MUhoWX07J5tC/iI5Ds=
-modernc.org/memory v1.5.0/go.mod h1:PkUhL0Mugw21sHPeskwZW4D6VscE/GQJOnIpCnW6pSU=
-modernc.org/sqlite v1.23.1 h1:nrSBg4aRQQwq59JpvGEQ15tNxoO5pX/kUjcRNwSAGQM=
-modernc.org/sqlite v1.23.1/go.mod h1:OrDj17Mggn6MhE+iPbBNf7RGKODDE9NFT0f3EwDzJqk=
-rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=
+gorm.io/driver/postgres v1.6.0 h1:2dxzU8xJ+ivvqTRph34QX+WrRaJlmfyPqXmoGVjMBa4=
+gorm.io/driver/postgres v1.6.0/go.mod h1:vUw0mrGgrTK+uPHEhAdV4sfFELrByKVGnaVRkXDhtWo=
+gorm.io/gorm v1.31.1 h1:7CA8FTFz/gRfgqgpeKIBcervUn3xSyPUmr6B2WXJ7kg=
+gorm.io/gorm v1.31.1/go.mod h1:XyQVbO2k6YkOis7C2437jSit3SsDK72s7n7rsSHd+Gs=
+modernc.org/cc/v4 v4.27.1 h1:9W30zRlYrefrDV2JE2O8VDtJ1yPGownxciz5rrbQZis=
+modernc.org/cc/v4 v4.27.1/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL0=
+modernc.org/ccgo/v4 v4.32.0 h1:hjG66bI/kqIPX1b2yT6fr/jt+QedtP2fqojG2VrFuVw=
+modernc.org/ccgo/v4 v4.32.0/go.mod h1:6F08EBCx5uQc38kMGl+0Nm0oWczoo1c7cgpzEry7Uc0=
+modernc.org/fileutil v1.4.0 h1:j6ZzNTftVS054gi281TyLjHPp6CPHr2KCxEXjEbD6SM=
+modernc.org/fileutil v1.4.0/go.mod h1:EqdKFDxiByqxLk8ozOxObDSfcVOv/54xDs/DUHdvCUU=
+modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI=
+modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito=
+modernc.org/gc/v3 v3.1.2 h1:ZtDCnhonXSZexk/AYsegNRV1lJGgaNZJuKjJSWKyEqo=
+modernc.org/gc/v3 v3.1.2/go.mod h1:HFK/6AGESC7Ex+EZJhJ2Gni6cTaYpSMmU/cT9RmlfYY=
+modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks=
+modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI=
+modernc.org/libc v1.70.0 h1:U58NawXqXbgpZ/dcdS9kMshu08aiA6b7gusEusqzNkw=
+modernc.org/libc v1.70.0/go.mod h1:OVmxFGP1CI/Z4L3E0Q3Mf1PDE0BucwMkcXjjLntvHJo=
+modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU=
+modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg=
+modernc.org/memory v1.11.0 h1:o4QC8aMQzmcwCK3t3Ux/ZHmwFPzE6hf2Y5LbkRs+hbI=
+modernc.org/memory v1.11.0/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw=
+modernc.org/opt v0.1.4 h1:2kNGMRiUjrp4LcaPuLY2PzUfqM/w9N23quVwhKt5Qm8=
+modernc.org/opt v0.1.4/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns=
+modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w=
+modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE=
+modernc.org/sqlite v1.47.0 h1:R1XyaNpoW4Et9yly+I2EeX7pBza/w+pmYee/0HJDyKk=
+modernc.org/sqlite v1.47.0/go.mod h1:hWjRO6Tj/5Ik8ieqxQybiEOUXy0NJFNp2tpvVpKlvig=
+modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0=
+modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A=
+modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y=
+modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM=
@@ -4,7 +4,7 @@
 //  1. 内置默认值
 //  2. 工作目录中的 config.yaml（嵌套格式）
 //  3. config/*.yaml 分片文件（按模块）
-//  4. 以 MMTL_ 为前缀的环境变量
+//  4. 以 MEBOX_ 为前缀的环境变量
 package config

 import (
@@ -12,12 +12,19 @@ import (
 	"os"
 	"path/filepath"
 	"strings"
+	"sync"

 	"github.com/spf13/viper"
 )

 // EnvPrefix 是所有环境变量驱动的覆盖使用的前缀。
-const EnvPrefix = "MMTL"
+const EnvPrefix = "MeBox"
+
+// RuntimeMu 保护运行时热更新配置字段的并发读写：ApplyRuntimeSetting 在
+// HTTP goroutine 中写字段，serverManager 的证书轮询等后台协程在无锁读取
+// 同一批字段。string 是双字结构，无锁并发读写可读到撕裂的 header。
+// 写方在 ApplyRuntimeSetting 内 Lock，读方（cmd/server）在轮询处 RLock。
+var RuntimeMu sync.RWMutex

 // Load 从默认值 / 文件 / 环境读取配置。
 //
@@ -45,8 +52,13 @@ func Load() (*Config, error) {
 			}
 			s := viper.New()
 			s.SetConfigFile(filepath.Join("config", e.Name()))
-			if err := s.ReadInConfig(); err == nil {
-				_ = v.MergeConfigMap(s.AllSettings())
+			if err := s.ReadInConfig(); err != nil {
+				// 分片解析失败不能静默吞掉：database.yaml 语法错误会让
+				// database.dsn 缺失 → type=auto 静默回退 SQLite，新数据
+				// 全部写进一个空库而用户无感知。
+				fmt.Fprintf(os.Stderr, "warning: parse config/%s failed: %v\n", e.Name(), err)
+			} else {
+				v.MergeConfigMap(s.AllSettings())
 			}
 		}
 	}
@@ -40,13 +40,13 @@ func TestLoadDefaults(t *testing.T) {
 	if cfg.Database.MaxOpenConns != defaultDatabaseMaxOpenConns {
 		t.Fatalf("expected default MaxOpenConns %d, got %d", defaultDatabaseMaxOpenConns, cfg.Database.MaxOpenConns)
 	}
-	if cfg.Cache.RedisPrefix != "mmtl" {
+	if cfg.Cache.RedisPrefix != "mebox" {
 		t.Fatalf("expected default redis prefix, got %q", cfg.Cache.RedisPrefix)
 	}
-	if cfg.Cache.MediaTTLSeconds != 15 {
-		t.Fatalf("expected default media cache ttl 15, got %d", cfg.Cache.MediaTTLSeconds)
+	if cfg.Cache.MediaTTLSeconds != 90 {
+		t.Fatalf("expected default media cache ttl 90, got %d", cfg.Cache.MediaTTLSeconds)
 	}
-	if cfg.Search.Index != "mmtl_media" {
+	if cfg.Search.Index != "mebox_media" {
 		t.Fatalf("expected default search index, got %q", cfg.Search.Index)
 	}
 	if cfg.Database.MaxIdleConns != defaultDatabaseMaxIdleConns {
@@ -74,7 +74,7 @@ func TestLoadDefaults(t *testing.T) {
 	}
 }

-// TestEnvOverride checks that MMTL_* env vars override the defaults.
+// TestEnvOverride checks that MEBOX_* env vars override the defaults.
 func TestEnvOverride(t *testing.T) {
 	dir := t.TempDir()
 	wd, _ := os.Getwd()
@@ -83,16 +83,16 @@ func TestEnvOverride(t *testing.T) {
 		t.Fatalf("chdir: %v", err)
 	}

-	t.Setenv("MMTL_APP_PORT", "9090")
-	t.Setenv("MMTL_DATABASE_TYPE", "postgres")
-	t.Setenv("MMTL_DATABASE_DSN", "postgres://mmtl:secret@postgres:5432/mmtl?sslmode=disable")
-	t.Setenv("MMTL_CACHE_REDIS_URL", "redis://redis:6379/0")
-	t.Setenv("MMTL_CACHE_MEDIA_TTL_SECONDS", "30")
-	t.Setenv("MMTL_SEARCH_BACKEND", "opensearch")
-	t.Setenv("MMTL_SEARCH_OPENSEARCH_URL", "http://opensearch:9200")
-	t.Setenv("MMTL_LICENSE_SERVER_URL", "https://license.example.com")
-	t.Setenv("MMTL_LICENSE_HMAC_SECRET", "override-secret")
-	t.Setenv("MMTL_LICENSE_PUBLIC_KEY", "override-public-key")
+	t.Setenv("MEBOX_APP_PORT", "9090")
+	t.Setenv("MEBOX_DATABASE_TYPE", "postgres")
+	t.Setenv("MEBOX_DATABASE_DSN", "postgres://mebox:secret@postgres:5432/mebox?sslmode=disable")
+	t.Setenv("MEBOX_CACHE_REDIS_URL", "redis://redis:6379/0")
+	t.Setenv("MEBOX_CACHE_MEDIA_TTL_SECONDS", "30")
+	t.Setenv("MEBOX_SEARCH_BACKEND", "opensearch")
+	t.Setenv("MEBOX_SEARCH_OPENSEARCH_URL", "http://opensearch:9200")
+	t.Setenv("MEBOX_LICENSE_SERVER_URL", "https://license.example.com")
+	t.Setenv("MEBOX_LICENSE_HMAC_SECRET", "override-secret")
+	t.Setenv("MEBOX_LICENSE_PUBLIC_KEY", "override-public-key")
 	cfg, err := Load()
 	if err != nil {
 		t.Fatalf("Load() error: %v", err)
@@ -25,7 +25,7 @@ func setDefaults(v *viper.Viper) {
 	v.SetDefault("app.server_url", "")

 	v.SetDefault("database.type", "auto")
-	v.SetDefault("database.db_path", "./data/mmtl.db")
+	v.SetDefault("database.db_path", "./data/mebox.db")
 	v.SetDefault("database.dsn", "")
 	v.SetDefault("database.wal_mode", true)
 	v.SetDefault("database.busy_timeout", 5000)
@@ -46,12 +46,12 @@ func setDefaults(v *viper.Viper) {
 	v.SetDefault("cache.images_max_size_mb", 500)
 	v.SetDefault("cache.cleanup_interval_min", 60)
 	v.SetDefault("cache.redis_url", "")
-	v.SetDefault("cache.redis_prefix", "mmtl")
-	v.SetDefault("cache.media_ttl_seconds", 15)
+	v.SetDefault("cache.redis_prefix", "mebox")
+	v.SetDefault("cache.media_ttl_seconds", 90)

 	v.SetDefault("search.backend", "")
 	v.SetDefault("search.opensearch_url", "")
-	v.SetDefault("search.index", "mmtl_media")
+	v.SetDefault("search.index", "mebox_media")
 	v.SetDefault("search.username", "")
 	v.SetDefault("search.password", "")

@@ -64,7 +64,7 @@ func setDefaults(v *viper.Viper) {

 	v.SetDefault("flaresolverr.enabled", false)
 	v.SetDefault("flaresolverr.url", "http://localhost:8191")
-	v.SetDefault("flaresolverr.session", "mmtl")
+	v.SetDefault("flaresolverr.session", "mebox")
 	v.SetDefault("flaresolverr.timeout", 60)

 	v.SetDefault("downloads.smart_classify", true)
@@ -15,7 +15,7 @@ func (c *Config) normalize() error {
 		c.App.DataDir = "./data"
 	}
 	if c.Database.DBPath == "" {
-		c.Database.DBPath = filepath.Join(c.App.DataDir, "mmtl.db")
+		c.Database.DBPath = filepath.Join(c.App.DataDir, "mebox.db")
 	}
 	if c.Database.Type == "" {
 		c.Database.Type = "auto"
@@ -48,14 +48,14 @@ func (c *Config) normalize() error {
 		c.Cache.ImagesMaxSizeMB = 0
 	}
 	if c.Cache.RedisPrefix == "" {
-		c.Cache.RedisPrefix = "mmtl"
+		c.Cache.RedisPrefix = "mebox"
 	}
 	if c.Cache.MediaTTLSeconds < 1 {
-		c.Cache.MediaTTLSeconds = 15
+		c.Cache.MediaTTLSeconds = 90
 	}
 	c.Search.Backend = strings.ToLower(strings.TrimSpace(c.Search.Backend))
 	if c.Search.Index == "" {
-		c.Search.Index = "mmtl_media"
+		c.Search.Index = "mebox_media"
 	}
 	if c.Secrets.JWTSecret == "" {
 		// 持久化自动生成的密钥以在操作员忘记配置时保持会话稳定。
@@ -68,8 +68,14 @@ func (c *Config) normalize() error {
 				return fmt.Errorf("generate jwt secret: %w", err)
 			}
 			c.Secrets.JWTSecret = hex.EncodeToString(buf)
-			_ = os.MkdirAll(c.App.DataDir, 0o750)
-			_ = os.WriteFile(path, []byte(c.Secrets.JWTSecret), 0o600)
+			// 持久化失败（DataDir 只读/权限异常）会导致每次重启重新生成
+			// 密钥、全部会话静默失效、多实例各持不同 secret——必须让
+			// 操作员感知。
+			if mkErr := os.MkdirAll(c.App.DataDir, 0o750); mkErr != nil {
+				fmt.Fprintf(os.Stderr, "warning: persist jwt secret failed (mkdir): %v\n", mkErr)
+			} else if wErr := os.WriteFile(path, []byte(c.Secrets.JWTSecret), 0o600); wErr != nil {
+				fmt.Fprintf(os.Stderr, "warning: persist jwt secret failed (write): %v\n", wErr)
+			}
 		}
 	}
 	return nil
@@ -34,8 +34,15 @@ func SaveDatabaseConfig(dbType, dsn string) error {
 		return fmt.Errorf("marshal config.yaml: %w", err)
 	}

-	if err := os.WriteFile(configPath, out, 0644); err != nil {
-		return fmt.Errorf("write config.yaml: %w", err)
+	// 原子写：临时文件 + rename，避免进程崩溃/断电留下截断的 config.yaml
+	// （下次启动会硬失败）；DSN 含数据库密码，权限收窄到 0600。
+	tmp := configPath + ".tmp"
+	if err := os.WriteFile(tmp, out, 0o600); err != nil {
+		return fmt.Errorf("write config.yaml.tmp: %w", err)
+	}
+	if err := os.Rename(tmp, configPath); err != nil {
+		_ = os.Remove(tmp)
+		return fmt.Errorf("replace config.yaml: %w", err)
 	}
 	return nil
 }
@@ -14,7 +14,7 @@ func TestSaveDatabaseConfig(t *testing.T) {
 		t.Fatalf("chdir: %v", err)
 	}

-	dsn := "postgres://admin:pass@127.0.0.1:5432/mmtl?sslmode=disable"
+	dsn := "postgres://admin:pass@127.0.0.1:5432/mebox?sslmode=disable"
 	if err := SaveDatabaseConfig("postgres", dsn); err != nil {
 		t.Fatalf("SaveDatabaseConfig error: %v", err)
 	}
@@ -152,7 +152,7 @@ type AIConfig struct {
 	MaxConcurrent int    `mapstructure:"max_concurrent"`
 }

-// LicenseConfig configures the optional MMTL license server bridge.
+// LicenseConfig configures the optional MeBox license server bridge.
 type LicenseConfig struct {
 	ServerURL  string `mapstructure:"server_url"`
 	HMACSecret string `mapstructure:"hmac_secret"`
@@ -6,6 +6,7 @@ import (
 	"errors"
 	"fmt"
 	"strings"
+	"time"

 	"github.com/glebarez/sqlite"
 	"go.uber.org/zap"
@@ -13,7 +14,7 @@ import (
 	"gorm.io/gorm"
 	"gorm.io/gorm/logger"

-	"github.com/ShukeBta/MMTL/internal/config"
+	"github.com/truewhile/MeBox/internal/config"
 )

 // Open initialises the configured GORM database. database.type=auto chooses
@@ -73,6 +74,14 @@ func configureConnectionPool(db *gorm.DB, cfg *config.Config) error {
 	if cfg.Database.MaxIdleConns > 0 {
 		sqlDB.SetMaxIdleConns(cfg.Database.MaxIdleConns)
 	}
+	// 连接生命周期：默认 0 意味着 Postgres 重启/故障切换后的陈旧连接
+	// 永不过期，首次复用才报错，运行期断连恢复慢且可能批量报错。
+	if isPostgres(db) {
+		sqlDB.SetConnMaxLifetime(time.Hour)
+		sqlDB.SetConnMaxIdleTime(10 * time.Minute)
+	} else if isSQLite(db) {
+		sqlDB.SetConnMaxLifetime(24 * time.Hour)
+	}
 	return nil
 }

@@ -12,8 +12,8 @@ import (
 	"gorm.io/gorm"
 	"gorm.io/gorm/logger"

-	"github.com/ShukeBta/MMTL/internal/config"
-	"github.com/ShukeBta/MMTL/internal/model"
+	"github.com/truewhile/MeBox/internal/config"
+	"github.com/truewhile/MeBox/internal/model"
 )

 // DatabaseStatus describes the currently active database engine and runtime metrics.
@@ -6,8 +6,8 @@ import (
 	"github.com/glebarez/sqlite"
 	"gorm.io/gorm"

-	"github.com/ShukeBta/MMTL/internal/config"
-	"github.com/ShukeBta/MMTL/internal/model"
+	"github.com/truewhile/MeBox/internal/config"
+	"github.com/truewhile/MeBox/internal/model"
 )

 func TestMaskDSN(t *testing.T) {
@@ -16,16 +16,16 @@ func TestMaskDSN(t *testing.T) {
 		want string
 	}{
 		{
-			in:   "postgres://admin:secret123@localhost:5432/mmtl?sslmode=disable",
-			want: "postgres://admin:******@localhost:5432/mmtl?sslmode=disable",
+			in:   "postgres://admin:secret123@localhost:5432/mebox?sslmode=disable",
+			want: "postgres://admin:******@localhost:5432/mebox?sslmode=disable",
 		},
 		{
-			in:   "host=localhost port=5432 user=admin password=secret dbname=mmtl sslmode=disable",
-			want: "host=localhost port=5432 user=admin password=****** dbname=mmtl sslmode=disable",
+			in:   "host=localhost port=5432 user=admin password=secret dbname=mebox sslmode=disable",
+			want: "host=localhost port=5432 user=admin password=****** dbname=mebox sslmode=disable",
 		},
 		{
-			in:   "sqlite://data/mmtl.db",
-			want: "sqlite://data/mmtl.db",
+			in:   "sqlite://data/mebox.db",
+			want: "sqlite://data/mebox.db",
 		},
 		{
 			in:   "",
@@ -53,7 +53,7 @@ func TestInspectDatabaseStatus(t *testing.T) {

 	cfg := &config.Config{}
 	cfg.Database.Type = "sqlite"
-	cfg.Database.DBPath = "./data/mmtl.db"
+	cfg.Database.DBPath = "./data/mebox.db"

 	st := InspectDatabaseStatus(db, cfg)
 	if st == nil {
@@ -62,7 +62,7 @@ func TestInspectDatabaseStatus(t *testing.T) {
 	if st.Type != "sqlite" {
 		t.Fatalf("expected sqlite, got %s", st.Type)
 	}
-	if st.DBPath != "./data/mmtl.db" {
+	if st.DBPath != "./data/mebox.db" {
 		t.Fatalf("expected db_path, got %s", st.DBPath)
 	}
 	if st.TableCounts["users"] != 1 {
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
truewhile	9ca1b28cb4	优化	2026-09-10 22:30:17 +08:00
truewhile	9effb1422b	优化	2026-09-10 22:06:28 +08:00
truewhile	b855e00345	优化	2026-09-10 16:58:41 +08:00
truewhile	8f2551a1b6	优化排序	2026-09-09 22:24:45 +08:00
truewhile	18e6cb40fd	完善动漫特别内容分类与版本判定 Co-authored-by: Cursor <cursoragent@cursor.com>	2026-09-09 22:03:52 +08:00
truewhile	92e693ccac	优化	2026-09-09 20:32:03 +08:00
truewhile	62206aa05a	优化	2026-09-09 19:26:22 +08:00
truewhile	f9dd082159	优化动漫刮削	2026-09-09 17:36:11 +08:00
truewhile	d489c1608e	优化strm多版本显示	2026-09-09 17:07:21 +08:00
truewhile	1ea29cca9e	bug处理	2026-09-09 00:39:00 +08:00
truewhile	ec5f81e6cb	bug处理	2026-09-09 00:18:04 +08:00
truewhile	8eb017fedc	优化	2026-09-09 00:03:14 +08:00
truewhile	fb4e762026	优化	2026-09-08 23:44:20 +08:00
truewhile	4239474100	优化	2026-09-08 23:11:57 +08:00
truewhile	8225b4e319	优化	2026-09-08 23:05:07 +08:00
truewhile	c086b01381	优化	2026-09-08 22:44:36 +08:00
truewhile	f196e5621f	优化	2026-09-08 22:12:26 +08:00
truewhile	13d60b3bd9	分集图片设置落库	2026-09-08 22:00:06 +08:00
truewhile	3d30f6f27c	bug处理	2026-09-08 21:08:47 +08:00
truewhile	bd02e194ff	优化	2026-09-08 20:52:35 +08:00
truewhile	1c9b742c8d	优化	2026-09-08 20:24:45 +08:00
truewhile	20e7d7fa99	bug处理	2026-09-08 18:12:52 +08:00
truewhile	394ea0382e	优化	2026-09-08 09:46:02 +08:00
truewhile	4d698d2757	优化播放	2026-09-08 09:24:29 +08:00
truewhile	fdfb2ee987	bug处理	2026-09-08 08:41:01 +08:00
truewhile	b23b1d728e	bug处理	2026-09-08 00:36:56 +08:00
truewhile	ad427fc0d2	bug处理	2026-09-08 00:10:25 +08:00
truewhile	c489374b61	bug处理	2026-09-07 23:45:59 +08:00
truewhile	5a47e6f52d	bug处理	2026-09-07 23:21:24 +08:00
truewhile	c4b8114115	优化转码逻辑	2026-09-07 23:10:48 +08:00
truewhile	0e592105c4	fix(web): STRM 直连失败后回退 HLS 转码 fix(web): STRM 直连失败后回退 HLS 转码	2026-09-07 22:56:29 +08:00
truewhile	f20c9c3234	fix(web): STRM 直连失败后回退 HLS 转码不再把 STRM/云盘媒体锁死为直连，解析远端源后允许 ffmpeg 转码播放。 Co-authored-by: Cursor <cursoragent@cursor.com>	2026-09-07 22:52:54 +08:00
truewhile	38b85bb487	feat(strm): 同名多版本择优 / keep_ext，并支持合并展示与播放切换 (#30 ) * feat(strm): 同名多版本择优/keep_ext，并支持合并展示与播放切换默认对同名不同扩展（如 .mkv/.mp4）按体积→mtime→扩展名优先级择优生成一条 strm，冲突打日志；开启 keep_ext 则分别生成 name.ext.strm。媒体详情与播放器可切换版本，列表继续合并同片多版本，Emby MediaSources 名称区分容器/分辨率。 Co-authored-by: truewhile <truewhile@users.noreply.github.com> * fix(meta): 边车匹配忽略 .mkv.strm 中间扩展，同片共享 NFO/海报/字幕 NFO、海报、字幕与刮削写出统一使用 mediaSidecarBase 词干，使竞女01.mkv.strm 与竞女01.mp4.strm 配对同一套竞女01.nfo / 竞女01-poster / 竞女01.srt；仍兼容历史上的 name.mkv.nfo 命名。 Co-authored-by: truewhile <truewhile@users.noreply.github.com> * fix(emby): People NFO 按共享词干匹配 keep_ext strm resolveMediaPeople 改为查找竞女01.nfo（并兼容旧的竞女01.mkv.nfo），同时修正把 decodeNFOFile 的 partial 误当 ok 导致完整 NFO 被跳过的问题。 Co-authored-by: truewhile <truewhile@users.noreply.github.com> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-07 13:56:30 +08:00
truewhile	6bf8a6878a	fix(strm): 115 元数据上传幂等，避免重复上传 (#29 ) 上传/重试前按父目录+文件名+SHA1 探活，已有同内容副本则跳过并清脏副本；成功后回写新 file_id；同步扫描认可 30 分钟内同路径同大小的 done 任务，缩短「任务已完成但列表未反映」导致的再入队窗口。 Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-07 09:01:58 +08:00
truewhile	2e636ce43f	feat(web): 支持生成电视端临时登录码 - 新增创建临时登录密码的 API 请求 - 新增电视端临时登录密码弹窗组件并在用户菜单中提供入口 - 在个人资料页面添加电视临时登录码生成与倒计时展示	2026-09-06 23:22:34 +08:00
truewhile	28aa466107	feat: 支持临时登录密码并完善 Emby 媒体详情兼容 - 新增 6 位临时密码生成与验证接口，支持 TV 及客户端快速登录 - 媒体及剧集详情补充 People 演职员信息解析与返回 - 优化剧集背景图与海报标签继承机制及播放时长兜底逻辑 - 增加临时密码登录相关的单元测试	2026-09-06 22:58:41 +08:00
truewhile	f1b8010496	bug处理+emby客户端兼容	2026-09-06 22:10:23 +08:00
truewhile	394d1a3cda	feat(danmaku): 支持快捷填入当前片名并优化重新搜索机制	2026-09-06 20:32:12 +08:00
truewhile	465e98a792	bug	2026-09-06 19:02:53 +08:00
truewhile	292ae22dcd	fix(sync): deduplicate remoteMeta by file ID to prevent deleting valid remote metadata copies	2026-09-06 17:36:54 +08:00
truewhile	bc7e5fc79d	内网挂载emby封面无法加载问题处理	2026-09-06 17:35:33 +08:00
truewhile	f7fec93d44	fix(upload): eliminate concurrent temp file name collision and support direct local file upload for 115	2026-09-06 17:05:56 +08:00
truewhile	b4a1dc38bb	优化同步逻辑优化同步逻辑	2026-09-06 16:17:42 +08:00
truewhile	3150971f10	feat(sync): implement 115 adaptive hierarchical flat scan to bypass deep paging limit	2026-09-06 16:15:26 +08:00
truewhile	a71a18ce82	fix(upload): 删旧元数据失败时不中止任务，继续上传新文件旧逻辑：DeleteFiles 失败 → uploadTaskFailWithRetry → 任务重试 → 再次 DeleteFiles 失败 → 永远无法上传，形成死循环。新逻辑：DeleteFiles 失败时记录 warn 日志后继续上传新文件。旧副本由下次同步的 scanLocalMetaForUpload 检测（新旧两个副本，命中新版本后把旧版本 cid 收入 pendingDeletes）并通过 cleanupBatchRedundantFiles 异步批量清理。这修复了小姐姐库在 115 限流环境下每次增量同步都重复上传大量元数据的问题（Heyzo 等目录文件被上传了 7 次以上）。	2026-09-06 13:42:20 +08:00
truewhile	5a189a44fc	Merge pull request #27 from gaodyoffice/fix/strm-sync-metadata fix: OpenList metadata download 401 - use API instead of WebDAV	2026-09-06 12:30:40 +08:00
truewhile	fb84c62e9a	fix(sync): fallback to recursive traversal when 115 flat list hits deep-paging limit 115 API's flat list (search under the hood) enforces a hard limit of offset+limit <= 10000. When syncing huge directories (e.g. >10000 files), this silently truncates results, causing remote files to appear as missing locally, leading to infinite metadata re-upload loops and potential wrongful deletion of strm files. This patch auto-detects if the total file count >= 9500 and dynamically falls back to the standard recursive concurrent traversal (walkRemote).	2026-09-06 12:27:56 +08:00
Gaodaiyang	355fd06036	fix: OpenList metadata download using API instead of WebDAV OpenList 同步目录下载元数据（nfo/jpg/png/srt 等）全部失败，错误 http 401。根因：Resolve() 中非视频文件走 WebDAV 直接下载，用 API token 作为 Authorization。但 AList WebDAV 端点不接受 API token 认证，需要 Basic Auth。修复：OpenList 在有 apiBase 时，所有文件都走 API /api/fs/get 获取直链，不再走 WebDAV。API 失败时非视频文件可回退到 WebDAV。影响范围： - 只影响 OpenList 类型的非视频文件下载 - 不影响 115、CloudDrive2 等其他网盘 - 不影响视频播放/strm 生成	2026-09-06 11:41:12 +08:00
truewhile	4173caac5d	bug处理	2026-09-06 01:16:30 +08:00
truewhile	2aeedcc182	bug处理	2026-09-06 00:01:40 +08:00
truewhile	d96782622d	bug处理	2026-09-05 23:02:26 +08:00
truewhile	ebe425036b	CI调整：每次push main也发布Release与多平台二进制（保留原有发布习惯）	2026-09-05 18:33:27 +08:00
truewhile	edbaa1c84b	CI改造：VERSION文件迁移至独立version分支，CI读取并自增写回该分支，main不再含版本文件	2026-09-05 18:27:39 +08:00
truewhile	0179332013	CI改造：版本号改为tag驱动，移除每次push回写VERSION的bump提交，消除本地推送冲突	2026-09-05 18:16:50 +08:00
github-actions[bot]	7fb3db0f4c	chore: bump version to 0.1.15 [skip ci]	2026-09-05 10:10:42 +00:00
truewhile	e4a101b502	Merge branch 'main' of https://github.com/truewhile/MeBox	2026-09-05 18:10:22 +08:00
truewhile	28551c7883	清理qBittorrent接入残留：删除死schema分组与前端下载类型，下载器保存目录键改为downloader.savepath并兼容旧键	2026-09-05 18:08:52 +08:00
github-actions[bot]	a826ed9613	chore: bump version to 0.1.14 [skip ci]	2026-09-05 10:00:38 +00:00
truewhile	030ed5f325	文档修正：移除已不存在的qBittorrent接入与站点订阅描述，改为下载目录自动整理口径	2026-09-05 18:00:21 +08:00
github-actions[bot]	60308800fb	chore: bump version to 0.1.13 [skip ci]	2026-09-05 09:18:29 +00:00
truewhile	582495dece	论坛教程图片改为 GitHub 直链	2026-09-05 17:18:14 +08:00
github-actions[bot]	2a4545eb44	chore: bump version to 0.1.12 [skip ci]	2026-09-05 09:17:14 +00:00
truewhile	2bde71099e	优化，添加Telegram群组与赞赏区，强化Emby客户端兼容说明，新增论坛图文教程与截图，修正MetaTube文档链接	2026-09-05 17:16:52 +08:00
github-actions[bot]	1b06a01603	chore: bump version to 0.1.11 [skip ci]	2026-09-05 08:31:45 +00:00
truewhile	fe407caf9e	Bump version from 0.0.110 to 0.1.10	2026-09-05 16:31:30 +08:00
github-actions[bot]	ae02c14d27	chore: bump version to 0.0.110 [skip ci]	2026-09-05 08:22:11 +00:00
truewhile	5404e7773f	优化	2026-09-05 16:21:58 +08:00
github-actions[bot]	a368110e60	chore: bump version to 0.0.109 [skip ci]	2026-09-05 06:33:12 +00:00
truewhile	0e9fb2c937	优化，添加115接口文档	2026-09-05 14:32:58 +08:00
github-actions[bot]	d00b14df55	chore: bump version to 0.0.108 [skip ci]	2026-09-05 04:34:31 +00:00
truewhile	1407b9b5c4	优化，排查项目问题	2026-09-05 12:34:17 +08:00
github-actions[bot]	7fa05391e1	chore: bump version to 0.0.107 [skip ci]	2026-09-04 17:15:28 +00:00
truewhile	4790f7753e	bug处理	2026-09-05 01:15:11 +08:00
github-actions[bot]	a311438aa1	chore: bump version to 0.0.106 [skip ci]	2026-09-04 03:56:49 +00:00
truewhile	203abd106a	优化	2026-09-04 11:56:29 +08:00
github-actions[bot]	cc40169616	chore: bump version to 0.0.105 [skip ci]	2026-09-04 01:06:30 +00:00
truewhile	cd720ae879	优化	2026-09-04 09:06:15 +08:00
github-actions[bot]	fc84291346	chore: bump version to 0.0.104 [skip ci]	2026-09-03 15:12:00 +00:00
truewhile	c37e936f48	bug	2026-09-03 23:11:42 +08:00
github-actions[bot]	389cb99bcf	chore: bump version to 0.0.103 [skip ci]	2026-09-03 14:48:19 +00:00
truewhile	1b611a6181	bug处理	2026-09-03 22:48:02 +08:00
github-actions[bot]	25c03f2b0d	chore: bump version to 0.0.102 [skip ci]	2026-09-03 13:18:35 +00:00
truewhile	a56b1801f9	bug处理	2026-09-03 21:18:20 +08:00
github-actions[bot]	99c755dc29	chore: bump version to 0.0.101 [skip ci]	2026-09-03 12:51:41 +00:00
truewhile	086c0307c3	bug处理	2026-09-03 20:51:24 +08:00
github-actions[bot]	51d0f5010e	chore: bump version to 0.0.100 [skip ci]	2026-09-03 12:20:20 +00:00
truewhile	b9dd09a5d2	bug处理	2026-09-03 20:19:31 +08:00
github-actions[bot]	e79f393969	chore: bump version to 0.0.99 [skip ci]	2026-09-03 11:37:58 +00:00
truewhile	e422ecce53	优化	2026-09-03 19:37:29 +08:00
github-actions[bot]	d0e29a0d8d	chore: bump version to 0.0.98 [skip ci]	2026-09-03 09:43:17 +00:00
truewhile	a7eeb8fbeb	优化	2026-09-03 17:42:52 +08:00
github-actions[bot]	64906d659d	chore: bump version to 0.0.97 [skip ci]	2026-09-03 08:53:39 +00:00
truewhile	c702a68cfb	优化	2026-09-03 16:53:12 +08:00
github-actions[bot]	4150d03852	chore: bump version to 0.0.96 [skip ci]	2026-09-03 06:13:05 +00:00
truewhile	a79bbb80a8	Remove unused recycle bin and add optional local file delete (#26 ) Soft-delete restore/purge/list and the recycle_purge job are gone. Admin delete now removes library index rows, with an optional delete_files query that also deletes local media + sidecar NFO. UI copy is renamed from 移入回收站 to 删除, with a confirm checkbox. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 14:12:52 +08:00
github-actions[bot]	205c71b0ad	chore: bump version to 0.0.95 [skip ci]	2026-09-03 04:46:22 +00:00
truewhile	5474784107	优化	2026-09-03 12:46:02 +08:00
github-actions[bot]	fb92373f0d	chore: bump version to 0.0.94 [skip ci]	2026-09-03 02:39:57 +00:00
truewhile	2b99f5f108	fix: enforce user library ACL on mounted Emby libraries (#25 ) Mounted Emby libraries were always appended to web/Emby library lists and detail/play routes without checking allowed_library_ids, so restricted users could still see and open them. Filter remotes with the same visibility policy as local libraries across list/detail/series/stream and Emby Views/Items/search/playback, and label mounts in the admin ACL UI. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 10:39:44 +08:00
github-actions[bot]	9ab32c10ca	chore: bump version to 0.0.93 [skip ci]	2026-09-03 02:26:16 +00:00
truewhile	e872223b4e	feat: honor pinned libraries in Emby client Views order (#24 ) Sort /Users/.../Views so libraries the user pinned on the web appear first for Infuse/Emby/Jellyfin clients. Unpinned libraries keep their existing sort_order / remote-mount order. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 10:26:04 +08:00
github-actions[bot]	c7441e06d4	chore: bump version to 0.0.92 [skip ci]	2026-09-03 02:13:21 +00:00
truewhile	936be24328	fix: stop pinned-library toggle from saving an empty list (#23 ) The pin hook captured the optimistic ID list inside a React setState updater. That updater can run after the following lines, so save ran with optimistic=[] and overwrote server pins — matching the flash then wipe when pinning a mounted Emby library after a local pin. Compute previous/optimistic synchronously from a ref before calling setState. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 10:13:04 +08:00
github-actions[bot]	b7f2760728	chore: bump version to 0.0.91 [skip ci]	2026-09-03 01:41:06 +00:00
truewhile	ea732e5bd7	fix: allow pinning mounted Emby libraries without wiping local pins (#22 ) accessibleLibraryIDSet only consulted the local libraries table, so embyremote~ mount IDs were stripped on every GET/PUT. Saving a pin that included a remote library could then persist a filtered list and clear existing local pins from the client state. Include enabled Emby mounts in the accessible set, and refuse pin toggles until the server list has loaded successfully. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 09:40:52 +08:00
github-actions[bot]	4e02692aeb	chore: bump version to 0.0.90 [skip ci]	2026-09-03 00:50:58 +00:00
truewhile	e8c710c261	fix: sync mounted Emby favourites across web and Emby clients (#21 ) Unify favourite writes through SyncUserFavorite so remote mounted media is stored locally and proxied to the upstream Emby server. Emby clients now query favourites from the local table (including remote pseudo IDs), and remote item payloads merge local IsFavorite state. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 08:50:46 +08:00
github-actions[bot]	27d2b79e1f	chore: bump version to 0.0.89 [skip ci]	2026-09-03 00:47:22 +00:00
truewhile	1e291df647	feat: persist pinned libraries per user with cross-device sync (#20 ) Store pinned library IDs on the user record and expose GET/PUT /me/pinned-libraries endpoints. The web client now loads and saves pins through the API, migrates legacy localStorage data once, and applies pinned ordering on both the libraries and home pages. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-03 08:47:06 +08:00
github-actions[bot]	1025e3c693	chore: bump version to 0.0.88 [skip ci]	2026-09-02 15:05:55 +00:00
truewhile	ba27d48d10	优化	2026-09-02 23:05:38 +08:00
github-actions[bot]	6d20dc65de	chore: bump version to 0.0.87 [skip ci]	2026-09-02 14:15:40 +00:00
truewhile	d4c82ac07e	优化	2026-09-02 22:15:24 +08:00
github-actions[bot]	acdb7b2ead	chore: bump version to 0.0.86 [skip ci]	2026-09-02 12:56:27 +00:00
truewhile	32ae1aeba9	优化	2026-09-02 20:56:09 +08:00
github-actions[bot]	55badfa6ad	chore: bump version to 0.0.85 [skip ci]	2026-09-02 12:38:08 +00:00
truewhile	8754ee615f	优化	2026-09-02 20:37:54 +08:00
github-actions[bot]	4943d28743	chore: bump version to 0.0.84 [skip ci]	2026-09-02 11:08:22 +00:00
truewhile	ee2272f743	优化	2026-09-02 19:08:06 +08:00
github-actions[bot]	e4f41c0b3d	chore: bump version to 0.0.83 [skip ci]	2026-09-02 11:00:16 +00:00
truewhile	a02583ee7d	优化	2026-09-02 19:00:01 +08:00
github-actions[bot]	e079a3cbb2	chore: bump version to 0.0.82 [skip ci]	2026-09-02 10:26:53 +00:00
truewhile	5cd1aa3e91	优化	2026-09-02 18:26:31 +08:00
github-actions[bot]	e923c9d7a1	chore: bump version to 0.0.81 [skip ci]	2026-09-02 09:10:18 +00:00
truewhile	bbb512760a	feat: make user limit configurable from admin user management (#18 ) Store the per-instance user cap in settings (default 20) and expose GET/PUT /admin/users/limit endpoints. The user management page now lets admins view and update the limit without touching system settings. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-02 17:10:07 +08:00
github-actions[bot]	da99182222	chore: bump version to 0.0.80 [skip ci]	2026-09-02 08:55:31 +00:00
truewhile	c43d1ca637	优化部署配置	2026-09-02 16:55:16 +08:00
github-actions[bot]	b51eee3d94	chore: bump version to 0.0.79 [skip ci]	2026-09-02 08:26:41 +00:00
truewhile	b0fe40142a	Rebrand MMTL to MeBox (name, logo, Docker image) (#17 ) * Rebrand MMTL to MeBox across codebase and assets Rename the project display name, Go module path, environment variable prefix (MEBOX_), Docker image references, and UI branding from MMTL/mmtl to MeBox/mebox. Replace logo assets with the new MeBox icon and keep legacy SQLite migration support for existing mmtl.db deployments. Co-authored-by: truewhile <truewhile@users.noreply.github.com> Fix logo icons: use cube-only crop without truncated text Previous icon generation cropped too much of the source image, including partial MeBox wordmark text that was cut off in square icon containers. Regenerate logo-64/192/512, favicon, and SVG from cube-only region. Co-authored-by: truewhile <truewhile@users.noreply.github.com> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-02 16:26:28 +08:00
github-actions[bot]	a50ceaf1a7	chore: bump version to 0.0.78 [skip ci]	2026-09-02 07:51:44 +00:00
truewhile	bf49323789	feat(strm): auto-append remote directory tail to local output path (#16 ) When adding or editing a cloud sync path, append the last segment of the remote directory to the local output directory (e.g. /home/ubuntu/strm + 电影). Remote changes replace the previous auto-appended tail; local browse and blur commit the base path with the current remote tail. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: truewhile <truewhile@users.noreply.github.com>	2026-09-02 15:51:31 +08:00