[ { "path": ".dockerignore", "content": "# Git\n.git\n.gitignore\n.gitattributes\n\n# IDE\n.idea\n.vscode\n*.swp\n*.swo\n\n# Documentation\n*.md\ndocs/\nLICENSE\n\n# Development\n.venv\n__pycache__\n*.pyc\n*.pyo\n.pytest_cache\n.coverage\nhtmlcov/\n\n# macOS\n.DS_Store\n._*\n\n# Frontend source (will be built from GitHub)\nfcb-fronted/\nthemes/\n\n# Test files\ntest_*.py\ntests/\n\n# Data (should be mounted as volume)\ndata/\n\n# GitHub\n.github/\n\n# Docker\nDockerfile\ndocker-compose.yml\n.dockerignore\n\n# Claude\n.claude/\n" }, { "path": ".gitattributes", "content": "*.js linguist-language=python\n*.css linguist-language=python\n*.html linguist-language=python\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: Bug report\nabout: Create a report to help us improve\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\n**Describe the bug**\nA clear and concise description of what the bug is.\n\n**To Reproduce**\nSteps to reproduce the behavior:\n1. Go to '...'\n2. Click on '....'\n3. Scroll down to '....'\n4. See error\n\n**Expected behavior**\nA clear and concise description of what you expected to happen.\n\n**Screenshots**\nIf applicable, add screenshots to help explain your problem.\n\n**Desktop (please complete the following information):**\n - OS: [e.g. iOS]\n - Browser [e.g. chrome, safari]\n - Version [e.g. 22]\n\n**Smartphone (please complete the following information):**\n - Device: [e.g. iPhone6]\n - OS: [e.g. iOS8.1]\n - Browser [e.g. stock browser, safari]\n - Version [e.g. 22]\n\n**Additional context**\nAdd any other context about the problem here.\n" }, { "path": ".github/ISSUE_TEMPLATE/custom.md", "content": "---\nname: Custom issue template\nabout: Describe this issue template's purpose here.\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\n\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.md", "content": "---\nname: Feature request\nabout: Suggest an idea for this project\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\n**Is your feature request related to a problem? Please describe.**\nA clear and concise description of what the problem is. Ex. I'm always frustrated when [...]\n\n**Describe the solution you'd like**\nA clear and concise description of what you want to happen.\n\n**Describe alternatives you've considered**\nA clear and concise description of any alternative solutions or features you've considered.\n\n**Additional context**\nAdd any other context or screenshots about the feature request here.\n" }, { "path": ".github/workflows/docker-image.yml", "content": "name: Build and push Docker image\n\non:\n workflow_dispatch:\n push:\n branches:\n - master\n - dev\n tags:\n - 'v*'\n\nenv:\n REGISTRY_IMAGE: ${{ secrets.DOCKER_USERNAME }}/filecodebox\n\njobs:\n buildx:\n runs-on: ubuntu-latest\n timeout-minutes: 60\n steps:\n - name: Checkout\n uses: actions/checkout@v4\n with:\n submodules: true\n\n - name: Extract metadata\n id: meta\n uses: docker/metadata-action@v5\n with:\n images: ${{ env.REGISTRY_IMAGE }}\n tags: |\n type=ref,event=branch\n type=ref,event=pr\n type=semver,pattern={{version}}\n type=semver,pattern={{major}}.{{minor}}\n type=raw,value=dev,enable=${{ github.ref == 'refs/heads/dev' }}\n type=raw,value=beta,enable={{is_default_branch}}\n type=raw,value=latest,enable={{is_default_branch}}\n\n - name: Set up QEMU\n uses: docker/setup-qemu-action@v3\n\n - name: Set up Docker Buildx\n uses: docker/setup-buildx-action@v3\n with:\n driver-opts: |\n image=moby/buildkit:latest\n network=host\n\n - name: Login to DockerHub\n uses: docker/login-action@v3\n with:\n username: ${{ secrets.DOCKER_USERNAME }}\n password: ${{ secrets.DOCKER_PASSWORD }}\n\n - name: Build and push\n uses: docker/build-push-action@v6\n with:\n context: .\n platforms: linux/amd64,linux/arm64\n push: true\n tags: ${{ steps.meta.outputs.tags }}\n labels: ${{ steps.meta.outputs.labels }}\n cache-from: type=gha\n cache-to: type=gha,mode=max\n provenance: false\n" }, { "path": ".github/workflows/docs.yml", "content": "# 构建 VitePress 站点并将其部署到 GitHub Pages 的示例工作流程\n#\nname: Deploy VitePress site to Pages\n\non:\n # 在针对 `main` 分支的推送上运行。如果你\n # 使用 `master` 分支作为默认分支，请将其更改为 `master`\n push:\n branches: [ master ]\n\n # 允许你从 Actions 选项卡手动运行此工作流程\n workflow_dispatch:\n\n# 设置 GITHUB_TOKEN 的权限，以允许部署到 GitHub Pages\npermissions:\n contents: read\n pages: write\n id-token: write\n\n# 只允许同时进行一次部署，跳过正在运行和最新队列之间的运行队列\n# 但是，不要取消正在进行的运行，因为我们希望允许这些生产部署完成\nconcurrency:\n group: pages\n cancel-in-progress: false\n\njobs:\n # 构建工作\n build:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v4\n with:\n fetch-depth: 0 # 如果未启用 lastUpdated，则不需要\n - uses: pnpm/action-setup@v3\n with:\n version: 9\n # - uses: oven-sh/setup-bun@v1 # 如果使用 Bun，请取消注释\n - name: Setup Node\n uses: actions/setup-node@v4\n with:\n node-version: 20\n cache: 'pnpm'\n cache-dependency-path: 'docs/pnpm-lock.yaml'\n - name: Setup Pages\n uses: actions/configure-pages@v4\n - name: Install dependencies\n working-directory: docs\n run: pnpm install\n - name: Build with VitePress\n working-directory: docs\n run: pnpm run docs:build\n - name: Upload artifact\n uses: actions/upload-pages-artifact@v3\n with:\n path: docs/.vitepress/dist\n\n # 部署工作\n deploy:\n environment:\n name: github-pages\n url: ${{ steps.deployment.outputs.page_url }}\n needs: build\n runs-on: ubuntu-latest\n name: Deploy\n steps:\n - name: Deploy to GitHub Pages\n id: deployment\n uses: actions/deploy-pages@v4\n" }, { "path": ".gitignore", "content": "media/\nlogs/\n.idea\n/data\n__pycache__/\n*.py[cod]\n*$py.class\n# Created by .ignore support plugin (hsz.mobi)\n### Python template\n# Byte-compiled / optimized / DLL files\ndatabase.db\n# C extensions\n*.so\n*.env\n# Distribution / packaging\n.Python\nbuild/\ndevelop-eggs/\ndownloads/\neggs/\n.eggs/\nlib/\nlib64/\nparts/\nsdist/\nvar/\nwheels/\nshare/python-wheels/\n*.egg-info/\n.installed.cfg\n*.egg\nMANIFEST\n.vite/\n# PyInstaller\n# Usually these files are written by a python script from a template\n# before PyInstaller builds the exe, so as to inject date/other infos into it.\n*.manifest\n*.spec\n\n# Installer logs\npip-log.txt\npip-delete-this-directory.txt\n\n# Unit test.pdf / coverage reports\nhtmlcov/\n.tox/\n.nox/\n.coverage\n.coverage.*\n.cache\nnosetests.xml\ncoverage.xml\n*.cover\n*.py,cover\n.hypothesis/\n.pytest_cache/\ncover/\n\n# Translations\n*.mo\n*.pot\n\n# Django stuff:\n*.log\nlocal_settings.py\ndb.sqlite3\ndb.sqlite3-journal\n\n# Flask stuff:\ninstance/\n.webassets-cache\n\n# Scrapy stuff:\n.scrapy\n\n# Sphinx documentation\ndocs/_build/\n\n# PyBuilder\n.pybuilder/\ntarget/\n*.db\n./filecodebox.db-shm\n./filecodebox.db-wal\n# Jupyter Notebook\n.ipynb_checkpoints\n\n# IPython\nprofile_default/\nipython_config.py\n\n# pyenv\n# For a library or package, you might want to ignore these files since the code is\n# intended to run in multiple environments; otherwise, check them in:\n# .python-version\n\n# pipenv\n# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.\n# However, in case of collaboration, if having platform-specific dependencies or dependencies\n# having no cross-platform support, pipenv may install dependencies that don't work, or not\n# install all needed dependencies.\n#Pipfile.lock\n\n# PEP 582; used by e.g. github.com/David-OConnor/pyflow\n__pypackages__/\n\n# Celery stuff\ncelerybeat-schedule\ncelerybeat.pid\n\n# SageMath parsed files\n*.sage.py\n\n# Environments\ndata/.env\n.venv\nenv/\nvenv/\nENV/\nenv.bak/\nvenv.bak/\n\n# Spyder project settings\n.spyderproject\n.spyproject\n\n# Rope project settings\n.ropeproject\n\n# mkdocs documentation\n/site\n\n# mypy\n.mypy_cache/\n.dmypy.json\ndmypy.json\n\n# Pyre type checker\n.pyre/\n\n# pytype static type analyzer\n.pytype/\n\n# Cython debug symbols\ncython_debug/\n\n# Project\n.vscode\n.DS_Store\nfor_test.py\n.html\n/evaluate/temp.py\n/evaluation/back.json\ndata/.env\n.backup/\n/cloc-1.64.exe\n\n# Ignore node_modules\nnode_modules/\n\nAGENTS.md\n\ndist/\n# Frontend themes (built from GitHub during Docker build)\nthemes/" }, { "path": "Dockerfile", "content": "# 第一阶段：构建前端主题\nFROM node:20-alpine AS frontend-builder\n\nRUN apk add --no-cache git python3 make g++\n\nWORKDIR /build\n\n# 克隆并构建 2024 主题\nRUN git clone --depth 1 https://github.com/vastsa/FileCodeBoxFronted.git /build/fronted-2024 && \\\n cd /build/fronted-2024 && \\\n npm install && \\\n npm run build\n\n# 克隆并构建 2023 主题\nRUN git clone --depth 1 https://github.com/vastsa/FileCodeBoxFronted2023.git /build/fronted-2023 && \\\n cd /build/fronted-2023 && \\\n npm install --legacy-peer-deps && \\\n npm run build\n\n# 第二阶段：构建最终镜像\nFROM python:3.12-slim-bookworm\nLABEL author=\"Lan\"\nLABEL email=\"xzu@live.com\"\n\nWORKDIR /app\n\n# 复制项目文件（通过 .dockerignore 排除不必要的文件）\nCOPY . .\n\n# 设置时区\nRUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \\\n echo 'Asia/Shanghai' > /etc/timezone\n\n# 从构建阶段复制编译好的前端主题\nCOPY --from=frontend-builder /build/fronted-2024/dist ./themes/2024\nCOPY --from=frontend-builder /build/fronted-2023/dist ./themes/2023\n\n# 安装 Python 依赖\nRUN pip install --no-cache-dir -r requirements.txt\n\n# 环境变量配置\nENV HOST=\"0.0.0.0\" \\\n PORT=12345 \\\n WORKERS=1 \\\n LOG_LEVEL=\"info\"\n\nEXPOSE 12345\n\n# 生产环境启动命令\nCMD uvicorn main:app \\\n --host $HOST \\\n --port $PORT \\\n --workers $WORKERS \\\n --log-level $LOG_LEVEL \\\n --proxy-headers \\\n --forwarded-allow-ips \"*\"" }, { "path": "LICENSE", "content": " GNU LESSER GENERAL PUBLIC LICENSE\n Version 3, 29 June 2007\n\n Copyright (C) 2007 Free Software Foundation, Inc. \n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n\n This version of the GNU Lesser General Public License incorporates\nthe terms and conditions of version 3 of the GNU General Public\nLicense, supplemented by the additional permissions listed below.\n\n 0. Additional Definitions.\n\n As used herein, \"this License\" refers to version 3 of the GNU Lesser\nGeneral Public License, and the \"GNU GPL\" refers to version 3 of the GNU\nGeneral Public License.\n\n \"The Library\" refers to a covered work governed by this License,\nother than an Application or a Combined Work as defined below.\n\n An \"Application\" is any work that makes use of an interface provided\nby the Library, but which is not otherwise based on the Library.\nDefining a subclass of a class defined by the Library is deemed a mode\nof using an interface provided by the Library.\n\n A \"Combined Work\" is a work produced by combining or linking an\nApplication with the Library. The particular version of the Library\nwith which the Combined Work was made is also called the \"Linked\nVersion\".\n\n The \"Minimal Corresponding Source\" for a Combined Work means the\nCorresponding Source for the Combined Work, excluding any source code\nfor portions of the Combined Work that, considered in isolation, are\nbased on the Application, and not on the Linked Version.\n\n The \"Corresponding Application Code\" for a Combined Work means the\nobject code and/or source code for the Application, including any data\nand utility programs needed for reproducing the Combined Work from the\nApplication, but excluding the System Libraries of the Combined Work.\n\n 1. Exception to Section 3 of the GNU GPL.\n\n You may convey a covered work under sections 3 and 4 of this License\nwithout being bound by section 3 of the GNU GPL.\n\n 2. Conveying Modified Versions.\n\n If you modify a copy of the Library, and, in your modifications, a\nfacility refers to a function or data to be supplied by an Application\nthat uses the facility (other than as an argument passed when the\nfacility is invoked), then you may convey a copy of the modified\nversion:\n\n a) under this License, provided that you make a good faith effort to\n ensure that, in the event an Application does not supply the\n function or data, the facility still operates, and performs\n whatever part of its purpose remains meaningful, or\n\n b) under the GNU GPL, with none of the additional permissions of\n this License applicable to that copy.\n\n 3. Object Code Incorporating Material from Library Header Files.\n\n The object code form of an Application may incorporate material from\na header file that is part of the Library. You may convey such object\ncode under terms of your choice, provided that, if the incorporated\nmaterial is not limited to numerical parameters, data structure\nlayouts and accessors, or small macros, inline functions and templates\n(ten or fewer lines in length), you do both of the following:\n\n a) Give prominent notice with each copy of the object code that the\n Library is used in it and that the Library and its use are\n covered by this License.\n\n b) Accompany the object code with a copy of the GNU GPL and this license\n document.\n\n 4. Combined Works.\n\n You may convey a Combined Work under terms of your choice that,\ntaken together, effectively do not restrict modification of the\nportions of the Library contained in the Combined Work and reverse\nengineering for debugging such modifications, if you also do each of\nthe following:\n\n a) Give prominent notice with each copy of the Combined Work that\n the Library is used in it and that the Library and its use are\n covered by this License.\n\n b) Accompany the Combined Work with a copy of the GNU GPL and this license\n document.\n\n c) For a Combined Work that displays copyright notices during\n execution, include the copyright notice for the Library among\n these notices, as well as a reference directing the user to the\n copies of the GNU GPL and this license document.\n\n d) Do one of the following:\n\n 0) Convey the Minimal Corresponding Source under the terms of this\n License, and the Corresponding Application Code in a form\n suitable for, and under terms that permit, the user to\n recombine or relink the Application with a modified version of\n the Linked Version to produce a modified Combined Work, in the\n manner specified by section 6 of the GNU GPL for conveying\n Corresponding Source.\n\n 1) Use a suitable shared library mechanism for linking with the\n Library. A suitable mechanism is one that (a) uses at run time\n a copy of the Library already present on the user's computer\n system, and (b) will operate properly with a modified version\n of the Library that is interface-compatible with the Linked\n Version.\n\n e) Provide Installation Information, but only if you would otherwise\n be required to provide such information under section 6 of the\n GNU GPL, and only to the extent that such information is\n necessary to install and execute a modified version of the\n Combined Work produced by recombining or relinking the\n Application with a modified version of the Linked Version. (If\n you use option 4d0, the Installation Information must accompany\n the Minimal Corresponding Source and Corresponding Application\n Code. If you use option 4d1, you must provide the Installation\n Information in the manner specified by section 6 of the GNU GPL\n for conveying Corresponding Source.)\n\n 5. Combined Libraries.\n\n You may place library facilities that are a work based on the\nLibrary side by side in a single library together with other library\nfacilities that are not Applications and are not covered by this\nLicense, and convey such a combined library under terms of your\nchoice, if you do both of the following:\n\n a) Accompany the combined library with a copy of the same work based\n on the Library, uncombined with any other library facilities,\n conveyed under the terms of this License.\n\n b) Give prominent notice with the combined library that part of it\n is a work based on the Library, and explaining where to find the\n accompanying uncombined form of the same work.\n\n 6. Revised Versions of the GNU Lesser General Public License.\n\n The Free Software Foundation may publish revised and/or new versions\nof the GNU Lesser General Public License from time to time. Such new\nversions will be similar in spirit to the present version, but may\ndiffer in detail to address new problems or concerns.\n\n Each version is given a distinguishing version number. If the\nLibrary as you received it specifies that a certain numbered version\nof the GNU Lesser General Public License \"or any later version\"\napplies to it, you have the option of following the terms and\nconditions either of that published version or of any later version\npublished by the Free Software Foundation. If the Library as you\nreceived it does not specify a version number of the GNU Lesser\nGeneral Public License, you may choose any version of the GNU Lesser\nGeneral Public License ever published by the Free Software Foundation.\n\n If the Library as you received it specifies that a proxy can decide\nwhether future versions of the GNU Lesser General Public License shall\napply, that proxy's public statement of acceptance of any version is\npermanent authorization for you to choose that version for the\nLibrary." }, { "path": "SECURITY.md", "content": "# Security Policy\n\n## Supported Versions\n\nUse this section to tell people about which versions of your project are\ncurrently being supported with security updates.\n\n| Version | Supported |\n| ------- | ------------------ |\n| 5.1.x | :white_check_mark: |\n| 5.0.x | :x: |\n| 4.0.x | :white_check_mark: |\n| < 4.0 | :x: |\n\n## Reporting a Vulnerability\n\nUse this section to tell people how to report a vulnerability.\n\nTell them where to go, how often they can expect to get an update on a\nreported vulnerability, what to expect if the vulnerability is accepted or\ndeclined, etc.\n" }, { "path": "apps/__init__.py", "content": "# @Time : 2023/8/13 20:43\n# @Author : Lan\n# @File : __init__.py.py\n# @Software: PyCharm\n" }, { "path": "apps/admin/__init__.py", "content": "# @Time : 2023/8/14 14:38\n# @Author : Lan\n# @File : __init__.py.py\n# @Software: PyCharm\n" }, { "path": "apps/admin/dependencies.py", "content": "# @Time : 2023/8/15 17:43\n# @Author : Lan\n# @File : depends.py\n# @Software: PyCharm\nfrom fastapi import Header, HTTPException, Depends\nfrom fastapi.requests import Request\nimport base64\nimport hmac\nimport json\nimport time\nfrom core.settings import settings\nfrom apps.admin.services import FileService, ConfigService, LocalFileService\n\n\ndef create_token(data: dict, expires_in: int = 3600 * 24 * 30) -> str:\n \"\"\"\n 创建JWT token\n :param data: 数据负载\n :param expires_in: 过期时间(秒)\n \"\"\"\n header = base64.b64encode(\n json.dumps({\"alg\": \"HS256\", \"typ\": \"JWT\"}).encode()\n ).decode()\n payload = base64.b64encode(\n json.dumps({**data, \"exp\": int(time.time()) + expires_in}).encode()\n ).decode()\n\n signature = hmac.new(\n settings.admin_token.encode(), f\"{header}.{payload}\".encode(), \"sha256\"\n ).digest()\n signature = base64.b64encode(signature).decode()\n\n return f\"{header}.{payload}.{signature}\"\n\n\ndef verify_token(token: str) -> dict:\n \"\"\"\n 验证JWT token\n :param token: JWT token\n :return: 解码后的数据\n \"\"\"\n try:\n header_b64, payload_b64, signature_b64 = token.split(\".\")\n\n # 验证签名\n expected_signature = hmac.new(\n settings.admin_token.encode(),\n f\"{header_b64}.{payload_b64}\".encode(),\n \"sha256\",\n ).digest()\n expected_signature_b64 = base64.b64encode(expected_signature).decode()\n\n if not hmac.compare_digest(signature_b64, expected_signature_b64):\n raise ValueError(\"无效的签名\")\n\n # 解码payload\n payload = json.loads(base64.b64decode(payload_b64))\n\n # 检查是否过期\n if payload.get(\"exp\", 0) < time.time():\n raise ValueError(\"token已过期\")\n\n return payload\n except Exception as e:\n raise ValueError(f\"token验证失败: {str(e)}\")\n\n\ndef _extract_bearer_token(authorization: str) -> str:\n if not authorization or not authorization.startswith(\"Bearer \"):\n raise HTTPException(status_code=401, detail=\"未授权或授权校验失败\")\n token = authorization.split(\" \", 1)[1].strip()\n if not token:\n raise HTTPException(status_code=401, detail=\"未授权或授权校验失败\")\n return token\n\n\ndef _require_admin_payload(authorization: str) -> dict:\n token = _extract_bearer_token(authorization)\n try:\n payload = verify_token(token)\n except ValueError as e:\n raise HTTPException(status_code=401, detail=str(e))\n if not payload.get(\"is_admin\", False):\n raise HTTPException(status_code=401, detail=\"未授权或授权校验失败\")\n return payload\n\n\nADMIN_PUBLIC_ENDPOINTS = {(\"POST\", \"/admin/login\")}\n\n\nasync def admin_required(\n authorization: str = Header(default=None), request: Request = None\n):\n \"\"\"\n 验证管理员权限\n \"\"\"\n if request and (request.method, request.url.path) in ADMIN_PUBLIC_ENDPOINTS:\n return None\n return _require_admin_payload(authorization)\n\n\nasync def share_required_login(authorization: str = Header(default=None)):\n \"\"\"\n 验证分享上传权限\n \n 当settings.openUpload为False时，要求用户必须登录并具有管理员权限\n 当settings.openUpload为True时，允许游客上传\n \n :param authorization: 认证头信息\n :param request: 请求对象\n :return: 验证结果\n \"\"\"\n if not settings.openUpload:\n if not authorization or not authorization.startswith(\"Bearer \"):\n raise HTTPException(\n status_code=403, detail=\"本站未开启游客上传，如需上传请先登录后台\"\n )\n _require_admin_payload(authorization)\n\n return True\n\n\nasync def get_file_service():\n return FileService()\n\n\nasync def get_config_service():\n return ConfigService()\n\n\nasync def get_local_file_service():\n return LocalFileService()\n" }, { "path": "apps/admin/schemas.py", "content": "import datetime\nfrom typing import Optional, Union\n\nfrom pydantic import BaseModel\n\n\nclass IDData(BaseModel):\n id: int\n\n\nclass ShareItem(BaseModel):\n expire_value: int\n expire_style: str = \"day\"\n filename: str\n\n\nclass DeleteItem(BaseModel):\n filename: str\n\n\nclass LoginData(BaseModel):\n password: str\n\n\nclass UpdateFileData(BaseModel):\n id: int\n code: Optional[str] = None\n prefix: Optional[str] = None\n suffix: Optional[str] = None\n expired_at: Optional[Union[datetime.datetime, str]] = None\n expired_count: Optional[int] = None\n" }, { "path": "apps/admin/services.py", "content": "import os\nimport time\n\nfrom core.response import APIResponse\nfrom core.storage import FileStorageInterface, storages\nfrom core.settings import settings\nfrom apps.base.models import FileCodes, KeyValue, file_codes_pydantic\nfrom apps.base.utils import get_expire_info, get_file_path_name\nfrom fastapi import HTTPException\nfrom core.settings import data_root\nfrom core.utils import hash_password, is_password_hashed\n\n\nclass FileService:\n def __init__(self):\n self.file_storage: FileStorageInterface = storages[settings.file_storage]()\n\n async def delete_file(self, file_id: int):\n file_code = await FileCodes.get(id=file_id)\n await self.file_storage.delete_file(file_code)\n await file_code.delete()\n\n async def list_files(self, page: int, size: int, keyword: str = \"\"):\n offset = (page - 1) * size\n files = (\n await FileCodes.filter(prefix__icontains=keyword).limit(size).offset(offset)\n )\n total = await FileCodes.filter(prefix__icontains=keyword).count()\n files_pydantic = [\n await file_codes_pydantic.from_tortoise_orm(f) for f in files\n ]\n return files_pydantic, total\n\n async def download_file(self, file_id: int):\n file_code = await FileCodes.filter(id=file_id).first()\n if not file_code:\n raise HTTPException(status_code=404, detail=\"文件不存在\")\n if file_code.text:\n return APIResponse(detail=file_code.text)\n else:\n return await self.file_storage.get_file_response(file_code)\n\n async def share_local_file(self, item):\n local_file = LocalFileClass(item.filename)\n if not await local_file.exists():\n raise HTTPException(status_code=404, detail=\"文件不存在\")\n\n text = await local_file.read()\n expired_at, expired_count, used_count, code = await get_expire_info(\n item.expire_value, item.expire_style\n )\n path, suffix, prefix, uuid_file_name, save_path = await get_file_path_name(item)\n\n await self.file_storage.save_file(text, save_path)\n\n await FileCodes.create(\n code=code,\n prefix=prefix,\n suffix=suffix,\n uuid_file_name=uuid_file_name,\n file_path=path,\n size=local_file.size,\n expired_at=expired_at,\n expired_count=expired_count,\n used_count=used_count,\n )\n\n return {\n \"code\": code,\n \"name\": local_file.file,\n }\n\n\nclass ConfigService:\n def get_config(self):\n return dict(settings.items())\n\n async def update_config(self, data: dict):\n admin_token = data.get(\"admin_token\")\n if admin_token is None or admin_token == \"\":\n raise HTTPException(status_code=400, detail=\"管理员密码不能为空\")\n\n if not is_password_hashed(admin_token):\n data[\"admin_token\"] = hash_password(admin_token)\n\n for key, value in data.items():\n if key not in settings.default_config:\n continue\n if key in [\n \"errorCount\",\n \"errorMinute\",\n \"max_save_seconds\",\n \"onedrive_proxy\",\n \"openUpload\",\n \"port\",\n \"s3_proxy\",\n \"uploadCount\",\n \"uploadMinute\",\n \"uploadSize\",\n ]:\n data[key] = int(value)\n elif key in [\"opacity\"]:\n data[key] = float(value)\n else:\n data[key] = value\n\n await KeyValue.filter(key=\"settings\").update(value=data)\n for k, v in data.items():\n settings.__setattr__(k, v)\n\n\nclass LocalFileService:\n async def list_files(self):\n files = []\n if not os.path.exists(data_root / \"local\"):\n os.makedirs(data_root / \"local\")\n for file in os.listdir(data_root / \"local\"):\n local_file = LocalFileClass(file)\n files.append({\n \"file\": local_file.file,\n \"ctime\": local_file.ctime,\n \"size\": local_file.size,\n })\n return files\n\n async def delete_file(self, filename: str):\n file = LocalFileClass(filename)\n if await file.exists():\n await file.delete()\n return \"删除成功\"\n raise HTTPException(status_code=404, detail=\"文件不存在\")\n\n\nclass LocalFileClass:\n def __init__(self, file):\n self.file = file\n self.path = data_root / \"local\" / file\n if os.path.exists(self.path):\n self.ctime = time.strftime(\n \"%Y-%m-%d %H:%M:%S\", time.localtime(os.path.getctime(self.path))\n )\n self.size = os.path.getsize(self.path)\n else:\n self.ctime = None\n self.size = None\n\n async def read(self):\n return open(self.path, \"rb\")\n\n async def write(self, data):\n with open(self.path, \"w\") as f:\n f.write(data)\n\n async def delete(self):\n os.remove(self.path)\n\n async def exists(self):\n return os.path.exists(self.path)\n" }, { "path": "apps/admin/views.py", "content": "# @Time : 2023/8/14 14:38\n# @Author : Lan\n# @File : views.py\n# @Software: PyCharm\nimport datetime\n\nfrom fastapi import APIRouter, Depends, HTTPException\nfrom apps.admin.services import FileService, ConfigService, LocalFileService\nfrom apps.admin.dependencies import (\n admin_required,\n get_file_service,\n get_config_service,\n get_local_file_service,\n)\nfrom apps.admin.schemas import IDData, ShareItem, DeleteItem, LoginData, UpdateFileData\nfrom core.response import APIResponse\nfrom apps.base.models import FileCodes, KeyValue\nfrom apps.admin.dependencies import create_token\nfrom core.settings import settings\nfrom core.utils import get_now, verify_password\n\nadmin_api = APIRouter(\n prefix=\"/admin\", tags=[\"管理\"], dependencies=[Depends(admin_required)]\n)\n\n\n@admin_api.post(\"/login\")\nasync def login(data: LoginData):\n if not verify_password(data.password, settings.admin_token):\n raise HTTPException(status_code=401, detail=\"密码错误\")\n\n token = create_token({\"is_admin\": True})\n return APIResponse(detail={\"token\": token, \"token_type\": \"Bearer\"})\n\n\n@admin_api.get(\"/dashboard\")\nasync def dashboard():\n all_codes = await FileCodes.all()\n all_size = str(sum([code.size for code in all_codes]))\n sys_start = await KeyValue.filter(key=\"sys_start\").first()\n now = await get_now()\n today_start = now.replace(hour=0, minute=0, second=0, microsecond=0)\n yesterday_start = today_start - datetime.timedelta(days=1)\n yesterday_end = today_start - datetime.timedelta(microseconds=1)\n yesterday_codes = FileCodes.filter(\n created_at__gte=yesterday_start, created_at__lte=yesterday_end\n )\n today_codes = FileCodes.filter(created_at__gte=today_start)\n return APIResponse(\n detail={\n \"totalFiles\": len(all_codes),\n \"storageUsed\": all_size,\n \"sysUptime\": sys_start.value,\n \"yesterdayCount\": await yesterday_codes.count(),\n \"yesterdaySize\": str(sum([code.size for code in await yesterday_codes])),\n \"todayCount\": await today_codes.count(),\n \"todaySize\": str(sum([code.size for code in await today_codes])),\n }\n )\n\n\n@admin_api.delete(\"/file/delete\")\nasync def file_delete(\n data: IDData,\n file_service: FileService = Depends(get_file_service),\n):\n await file_service.delete_file(data.id)\n return APIResponse()\n\n\n@admin_api.get(\"/file/list\")\nasync def file_list(\n page: int = 1,\n size: int = 10,\n keyword: str = \"\",\n file_service: FileService = Depends(get_file_service),\n):\n files, total = await file_service.list_files(page, size, keyword)\n return APIResponse(\n detail={\n \"page\": page,\n \"size\": size,\n \"data\": files,\n \"total\": total,\n }\n )\n\n\n@admin_api.get(\"/config/get\")\nasync def get_config(\n config_service: ConfigService = Depends(get_config_service),\n):\n return APIResponse(detail=config_service.get_config())\n\n\n@admin_api.patch(\"/config/update\")\nasync def update_config(\n data: dict,\n config_service: ConfigService = Depends(get_config_service),\n):\n data.pop(\"themesChoices\")\n await config_service.update_config(data)\n return APIResponse()\n\n\n@admin_api.get(\"/file/download\")\nasync def file_download(\n id: int,\n file_service: FileService = Depends(get_file_service),\n):\n file_content = await file_service.download_file(id)\n return file_content\n\n\n@admin_api.get(\"/local/lists\")\nasync def get_local_lists(\n local_file_service: LocalFileService = Depends(get_local_file_service),\n):\n files = await local_file_service.list_files()\n return APIResponse(detail=files)\n\n\n@admin_api.delete(\"/local/delete\")\nasync def delete_local_file(\n item: DeleteItem,\n local_file_service: LocalFileService = Depends(get_local_file_service),\n):\n result = await local_file_service.delete_file(item.filename)\n return APIResponse(detail=result)\n\n\n@admin_api.post(\"/local/share\")\nasync def share_local_file(\n item: ShareItem,\n file_service: FileService = Depends(get_file_service),\n):\n share_info = await file_service.share_local_file(item)\n return APIResponse(detail=share_info)\n\n\n@admin_api.patch(\"/file/update\")\nasync def update_file(\n data: UpdateFileData,\n):\n file_code = await FileCodes.filter(id=data.id).first()\n if not file_code:\n raise HTTPException(status_code=404, detail=\"文件不存在\")\n update_data = {}\n\n if data.code is not None and data.code != file_code.code:\n # 判断code是否存在\n if await FileCodes.filter(code=data.code).first():\n raise HTTPException(status_code=400, detail=\"code已存在\")\n update_data[\"code\"] = data.code\n if data.prefix is not None and data.prefix != file_code.prefix:\n update_data[\"prefix\"] = data.prefix\n if data.suffix is not None and data.suffix != file_code.suffix:\n update_data[\"suffix\"] = data.suffix\n if (\n data.expired_at is not None\n and data.expired_at != \"\"\n and data.expired_at != file_code.expired_at\n ):\n update_data[\"expired_at\"] = data.expired_at\n if data.expired_count is not None and data.expired_count != file_code.expired_count:\n update_data[\"expired_count\"] = data.expired_count\n\n await file_code.update_from_dict(update_data).save()\n return APIResponse(detail=\"更新成功\")\n" }, { "path": "apps/base/__init__.py", "content": "# @Time : 2023/8/13 20:43\n# @Author : Lan\n# @File : __init__.py.py\n# @Software: PyCharm\n" }, { "path": "apps/base/dependencies.py", "content": "from typing import Dict, Union\nfrom datetime import datetime, timedelta\nfrom fastapi import HTTPException, Request\n\n\nclass IPRateLimit:\n def __init__(self, count: int, minutes: int):\n self.ips: Dict[str, Dict[str, Union[int, datetime]]] = {}\n self.count = count\n self.minutes = minutes\n\n def check_ip(self, ip: str) -> bool:\n if ip in self.ips:\n ip_info = self.ips[ip]\n if ip_info[\"count\"] >= self.count:\n if ip_info[\"time\"] + timedelta(minutes=self.minutes) > datetime.now():\n return False\n self.ips.pop(ip)\n return True\n\n def add_ip(self, ip: str) -> int:\n ip_info = self.ips.get(ip, {\"count\": 0, \"time\": datetime.now()})\n ip_info[\"count\"] += 1\n ip_info[\"time\"] = datetime.now()\n self.ips[ip] = ip_info\n return ip_info[\"count\"]\n\n async def remove_expired_ip(self) -> None:\n now = datetime.now()\n expiration = timedelta(minutes=self.minutes)\n self.ips = {\n ip: info\n for ip, info in self.ips.items()\n if info[\"time\"] + expiration >= now\n }\n\n def __call__(self, request: Request) -> str:\n ip = (\n request.headers.get(\"X-Real-IP\")\n or request.headers.get(\"X-Forwarded-For\")\n or request.client.host\n )\n if not self.check_ip(ip):\n raise HTTPException(status_code=423, detail=\"请求次数过多，请稍后再试\")\n return ip\n" }, { "path": "apps/base/migrations/migrations_001.py", "content": "from tortoise import connections\n\n\nasync def create_file_codes_table():\n conn = connections.get(\"default\")\n await conn.execute_script(\n \"\"\"\n CREATE TABLE IF NOT EXISTS filecodes\n (\n id INTEGER not null\n primary key autoincrement,\n code VARCHAR(255) not null\n unique,\n prefix VARCHAR(255) default '' not null,\n suffix VARCHAR(255) default '' not null,\n uuid_file_name VARCHAR(255),\n file_path VARCHAR(255),\n size INT default 0 not null,\n text TEXT,\n expired_at TIMESTAMP,\n expired_count INT default 0 not null,\n used_count INT default 0 not null,\n created_at TIMESTAMP default CURRENT_TIMESTAMP not null\n );\n CREATE INDEX IF NOT EXISTS idx_filecodes_code_1c7ee7\n on filecodes (code);\n \"\"\"\n )\n\n\nasync def create_key_value_table():\n conn = connections.get(\"default\")\n await conn.execute_script(\n \"\"\"\n CREATE TABLE IF NOT EXISTS keyvalue\n (\n id INTEGER not null\n primary key autoincrement,\n key VARCHAR(255) not null\n unique,\n value JSON,\n created_at TIMESTAMP default CURRENT_TIMESTAMP not null\n );\n CREATE INDEX IF NOT EXISTS idx_keyvalue_key_eab890\n on keyvalue (key);\n \"\"\"\n )\n\n\nasync def migrate():\n await create_file_codes_table()\n await create_key_value_table()\n" }, { "path": "apps/base/migrations/migrations_002.py", "content": "from tortoise import connections\n\n\nasync def create_upload_chunk_and_update_file_codes_table():\n conn = connections.get(\"default\")\n await conn.execute_script(\n \"\"\"\n ALTER TABLE \"filecodes\" ADD \"file_hash\" VARCHAR(128);\n ALTER TABLE \"filecodes\" ADD \"is_chunked\" BOOL NOT NULL DEFAULT False;\n ALTER TABLE \"filecodes\" ADD \"upload_id\" VARCHAR(128);\n CREATE TABLE \"uploadchunk\" (\n id INTEGER not null primary key autoincrement,\n \"upload_id\" VARCHAR(36) NOT NULL,\n \"chunk_index\" INT NOT NULL,\n \"chunk_hash\" VARCHAR(128) NOT NULL,\n \"total_chunks\" INT NOT NULL,\n \"file_size\" BIGINT NOT NULL,\n \"chunk_size\" INT NOT NULL,\n \"created_at\" TIMESTAMPTZ NOT NULL,\n \"file_name\" VARCHAR(255) NOT NULL,\n \"completed\" BOOL NOT NULL\n );\n \"\"\"\n )\n\n\nasync def migrate():\n await create_upload_chunk_and_update_file_codes_table()\n" }, { "path": "apps/base/migrations/migrations_003.py", "content": "from tortoise import connections\n\n\nasync def create_presign_upload_session_table():\n conn = connections.get(\"default\")\n await conn.execute_script(\n \"\"\"\n CREATE TABLE IF NOT EXISTS presignuploadsession (\n id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,\n upload_id VARCHAR(36) NOT NULL UNIQUE,\n file_name VARCHAR(255) NOT NULL,\n file_size BIGINT NOT NULL,\n save_path VARCHAR(512) NOT NULL,\n mode VARCHAR(10) NOT NULL,\n expire_value INT NOT NULL DEFAULT 1,\n expire_style VARCHAR(20) NOT NULL DEFAULT 'day',\n created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,\n expires_at TIMESTAMP NOT NULL\n );\n CREATE INDEX IF NOT EXISTS idx_presignuploadsession_upload_id ON presignuploadsession (upload_id);\n \"\"\"\n )\n\n\nasync def migrate():\n await create_presign_upload_session_table()\n" }, { "path": "apps/base/migrations/migrations_004.py", "content": "from tortoise import connections\n\n\nasync def add_save_path_to_uploadchunk():\n conn = connections.get(\"default\")\n await conn.execute_script(\n \"\"\"\n ALTER TABLE uploadchunk ADD COLUMN save_path VARCHAR(512) NULL;\n \"\"\"\n )\n\n\nasync def migrate():\n await add_save_path_to_uploadchunk()\n" }, { "path": "apps/base/migrations/migrations_005.py", "content": "from tortoise import connections\n\n\ndef _need_upgrade(columns: list[tuple]) -> bool:\n for column in columns:\n # PRAGMA table_info 返回 (cid, name, type, notnull, dflt_value, pk)\n if column[1] == \"size\":\n column_type = (column[2] or \"\").upper()\n return \"BIGINT\" not in column_type\n return False\n\n\nasync def migrate():\n conn = connections.get(\"default\")\n result = await conn.execute_query(\"PRAGMA table_info(filecodes)\")\n columns = result[1] if result and len(result) > 1 else []\n\n if not columns or not _need_upgrade(columns):\n return\n\n await conn.execute_script(\n \"\"\"\n BEGIN;\n CREATE TABLE IF NOT EXISTS filecodes_new\n (\n id INTEGER not null\n primary key autoincrement,\n code VARCHAR(255) not null\n unique,\n prefix VARCHAR(255) default '' not null,\n suffix VARCHAR(255) default '' not null,\n uuid_file_name VARCHAR(255),\n file_path VARCHAR(255),\n size BIGINT default 0 not null,\n text TEXT,\n expired_at TIMESTAMP,\n expired_count INT default 0 not null,\n used_count INT default 0 not null,\n created_at TIMESTAMP default CURRENT_TIMESTAMP not null,\n file_hash VARCHAR(128),\n is_chunked BOOL default False not null,\n upload_id VARCHAR(128)\n );\n\n INSERT INTO filecodes_new (id, code, prefix, suffix, uuid_file_name, file_path, size, text,\n expired_at, expired_count, used_count, created_at, file_hash,\n is_chunked, upload_id)\n SELECT id,\n code,\n prefix,\n suffix,\n uuid_file_name,\n file_path,\n size,\n text,\n expired_at,\n expired_count,\n used_count,\n created_at,\n file_hash,\n is_chunked,\n upload_id\n FROM filecodes;\n\n DROP TABLE filecodes;\n ALTER TABLE filecodes_new\n RENAME TO filecodes;\n CREATE INDEX IF NOT EXISTS idx_filecodes_code_1c7ee7\n on filecodes (code);\n COMMIT;\n \"\"\"\n )\n" }, { "path": "apps/base/models.py", "content": "# @Time : 2023/8/13 20:43\n# @Author : Lan\n# @File : models.py\n# @Software: PyCharm\nfrom typing import Optional\n\nfrom tortoise.models import Model\nfrom tortoise.contrib.pydantic import pydantic_model_creator\n\nfrom tortoise import fields, models\nfrom datetime import datetime\nfrom core.utils import get_now\n\n\nclass FileCodes(models.Model):\n id = fields.IntField(pk=True)\n code = fields.CharField(max_length=255, unique=True, index=True)\n prefix = fields.CharField(max_length=255, default=\"\")\n suffix = fields.CharField(max_length=255, default=\"\")\n uuid_file_name = fields.CharField(max_length=255, null=True)\n file_path = fields.CharField(max_length=255, null=True)\n size = fields.BigIntField(default=0)\n text = fields.TextField(null=True)\n expired_at = fields.DatetimeField(null=True)\n expired_count = fields.IntField(default=0)\n used_count = fields.IntField(default=0)\n created_at = fields.DatetimeField(auto_now_add=True)\n file_hash = fields.CharField(max_length=64, null=True)\n is_chunked = fields.BooleanField(default=False)\n upload_id = fields.CharField(max_length=36, null=True)\n\n async def is_expired(self):\n if self.expired_at is None:\n return False\n if self.expired_at and self.expired_count < 0:\n return self.expired_at < await get_now()\n return self.expired_count <= 0\n\n async def get_file_path(self):\n return f\"{self.file_path}/{self.uuid_file_name}\"\n\n\nclass UploadChunk(models.Model):\n id = fields.IntField(pk=True)\n upload_id = fields.CharField(max_length=36, index=True)\n chunk_index = fields.IntField()\n chunk_hash = fields.CharField(max_length=64)\n total_chunks = fields.IntField()\n file_size = fields.BigIntField()\n chunk_size = fields.IntField()\n file_name = fields.CharField(max_length=255)\n save_path = fields.CharField(max_length=512, null=True)\n created_at = fields.DatetimeField(auto_now_add=True)\n completed = fields.BooleanField(default=False)\n\n\nclass KeyValue(Model):\n id: Optional[int] = fields.IntField(pk=True)\n key: Optional[str] = fields.CharField(\n max_length=255, description=\"键\", index=True, unique=True\n )\n value: Optional[str] = fields.JSONField(description=\"值\", null=True)\n created_at: Optional[datetime] = fields.DatetimeField(\n auto_now_add=True, description=\"创建时间\"\n )\n\n\nclass PresignUploadSession(models.Model):\n \"\"\"预签名上传会话模型\"\"\"\n\n id = fields.IntField(pk=True)\n upload_id = fields.CharField(max_length=36, unique=True, index=True)\n file_name = fields.CharField(max_length=255)\n file_size = fields.BigIntField()\n save_path = fields.CharField(max_length=512)\n mode = fields.CharField(max_length=10) # \"direct\" 或 \"proxy\"\n expire_value = fields.IntField(default=1)\n expire_style = fields.CharField(max_length=20, default=\"day\")\n created_at = fields.DatetimeField(auto_now_add=True)\n expires_at = fields.DatetimeField() # 会话过期时间\n\n async def is_expired(self):\n \"\"\"检查会话是否已过期\"\"\"\n return self.expires_at < await get_now()\n\n\nfile_codes_pydantic = pydantic_model_creator(FileCodes, name=\"FileCodes\")\nupload_chunk_pydantic = pydantic_model_creator(UploadChunk, name=\"UploadChunk\")\nkey_value_pydantic = pydantic_model_creator(KeyValue, name=\"KeyValue\")\npresign_upload_session_pydantic = pydantic_model_creator(\n PresignUploadSession, name=\"PresignUploadSession\"\n)\n" }, { "path": "apps/base/schemas.py", "content": "from pydantic import BaseModel\nfrom typing import Optional\n\n\nclass SelectFileModel(BaseModel):\n code: str\n\n\nclass InitChunkUploadModel(BaseModel):\n file_name: str\n chunk_size: int = 5 * 1024 * 1024\n file_size: int\n file_hash: str\n\n\nclass CompleteUploadModel(BaseModel):\n expire_value: int\n expire_style: str\n\n\n# 预签名上传相关模型\nclass PresignUploadInitRequest(BaseModel):\n \"\"\"预签名上传初始化请求\"\"\"\n file_name: str\n file_size: int\n expire_value: int = 1\n expire_style: str = \"day\"\n\n\nclass PresignUploadInitResponse(BaseModel):\n \"\"\"预签名上传初始化响应\"\"\"\n upload_id: str\n upload_url: str\n mode: str # \"direct\" 或 \"proxy\"\n save_path: str\n expires_in: int # URL过期时间（秒）\n" }, { "path": "apps/base/utils.py", "content": "import datetime\nimport hashlib\nimport os\nimport uuid\nfrom urllib.parse import unquote\n\nfrom fastapi import UploadFile, HTTPException\nfrom typing import Optional, Tuple\n\nfrom apps.base.dependencies import IPRateLimit\nfrom apps.base.models import FileCodes\nfrom core.settings import settings\nfrom core.utils import (\n get_random_num,\n get_random_string,\n max_save_times_desc,\n sanitize_filename,\n get_now,\n)\n\n\nasync def get_file_path_name(file: UploadFile) -> Tuple[str, str, str, str, str]:\n today = await get_now()\n storage_path = settings.storage_path.strip(\"/\")\n file_uuid = uuid.uuid4().hex\n filename = await sanitize_filename(unquote(file.filename or \"\"))\n base_path = f\"share/data/{today.strftime('%Y/%m/%d')}/{file_uuid}\"\n path = f\"{storage_path}/{base_path}\" if storage_path else base_path\n prefix, suffix = os.path.splitext(filename)\n save_path = f\"{path}/{filename}\"\n return path, suffix, prefix, filename, save_path\n\n\nasync def get_chunk_file_path_name(\n file_name: str, upload_id: str\n) -> Tuple[str, str, str, str, str]:\n today = await get_now()\n storage_path = settings.storage_path.strip(\"/\")\n base_path = f\"share/data/{today.strftime('%Y/%m/%d')}/{upload_id}\"\n path = f\"{storage_path}/{base_path}\" if storage_path else base_path\n prefix, suffix = os.path.splitext(file_name)\n save_path = f\"{path}/{prefix}{suffix}\"\n return path, suffix, prefix, file_name, save_path\n\n\nasync def get_expire_info(\n expire_value: int, expire_style: str\n) -> Tuple[Optional[datetime.datetime], int, int, str]:\n expired_count, used_count = -1, 0\n now = await get_now()\n code = None\n\n max_timedelta = (\n datetime.timedelta(seconds=settings.max_save_seconds)\n if settings.max_save_seconds > 0\n else datetime.timedelta(days=7)\n )\n detail = (\n await max_save_times_desc(settings.max_save_seconds)\n if settings.max_save_seconds > 0\n else \"7天\"\n )\n detail = f\"限制最长时间为 {detail[0]}，可换用其他方式\"\n\n expire_styles = {\n \"day\": lambda: now + datetime.timedelta(days=expire_value),\n \"hour\": lambda: now + datetime.timedelta(hours=expire_value),\n \"minute\": lambda: now + datetime.timedelta(minutes=expire_value),\n \"count\": lambda: (now + datetime.timedelta(days=1), expire_value),\n \"forever\": lambda: (None, None),\n }\n\n if expire_style in expire_styles:\n result = expire_styles[expire_style]()\n if isinstance(result, tuple):\n expired_at, extra = result\n if expire_style == \"count\":\n expired_count = extra\n elif expire_style == \"forever\":\n code = await get_random_code(style=\"string\")\n else:\n expired_at = result\n if expired_at and expired_at - now > max_timedelta:\n raise HTTPException(status_code=403, detail=detail)\n else:\n expired_at = now + datetime.timedelta(days=1)\n\n if not code:\n code = await get_random_code()\n\n return expired_at, expired_count, used_count, code\n\n\nasync def get_random_code(style: str = \"num\") -> str:\n while True:\n code = await get_random_num() if style == \"num\" else await get_random_string()\n if not await FileCodes.filter(code=code).exists():\n return str(code)\n\n\nasync def calculate_file_hash(file: UploadFile, chunk_size=1024 * 1024) -> str:\n sha = hashlib.sha256()\n await file.seek(0)\n while True:\n chunk = await file.read(chunk_size)\n if not chunk:\n break\n sha.update(chunk)\n await file.seek(0)\n return sha.hexdigest()\n\n\nip_limit = {\n \"error\": IPRateLimit(count=settings.errorCount, minutes=settings.errorMinute),\n \"upload\": IPRateLimit(count=settings.uploadCount, minutes=settings.uploadMinute),\n}\n" }, { "path": "apps/base/views.py", "content": "import datetime\nimport hashlib\nimport os\nimport uuid\nfrom datetime import timedelta\nfrom urllib.parse import unquote\n\nfrom typing import Optional, Tuple, Union\n\nfrom fastapi import APIRouter, Form, UploadFile, File, Depends, HTTPException\nfrom starlette import status\n\nfrom apps.admin.dependencies import share_required_login\nfrom apps.base.models import FileCodes, UploadChunk, PresignUploadSession\nfrom apps.base.schemas import (\n SelectFileModel,\n InitChunkUploadModel,\n CompleteUploadModel,\n PresignUploadInitRequest,\n)\nfrom apps.base.utils import (\n get_expire_info,\n get_file_path_name,\n ip_limit,\n get_chunk_file_path_name,\n)\nfrom core.response import APIResponse\nfrom core.settings import settings\nfrom core.storage import storages, FileStorageInterface\nfrom core.utils import get_select_token, get_now, sanitize_filename\n\nshare_api = APIRouter(prefix=\"/share\", tags=[\"分享\"])\n\n\n# ============ 公共服务层 ============\nclass FileUploadService:\n \"\"\"统一的文件上传服务\"\"\"\n\n @staticmethod\n async def generate_file_path(\n file_name: str, upload_id: Optional[str] = None\n ) -> tuple[str, str, str, str, str]:\n \"\"\"统一的路径生成\"\"\"\n today = datetime.datetime.now()\n storage_path = settings.storage_path.strip(\"/\")\n file_uuid = upload_id or uuid.uuid4().hex\n filename = await sanitize_filename(unquote(file_name))\n base_path = f\"share/data/{today.strftime('%Y/%m/%d')}/{file_uuid}\"\n path = f\"{storage_path}/{base_path}\" if storage_path else base_path\n prefix, suffix = os.path.splitext(filename)\n save_path = f\"{path}/{filename}\"\n return path, suffix, prefix, filename, save_path\n\n @staticmethod\n async def create_file_record(\n file_name: str,\n file_size: int,\n file_path: str,\n expire_value: int,\n expire_style: str,\n **extra_fields,\n ) -> str:\n \"\"\"统一创建FileCodes记录，返回code\"\"\"\n expired_at, expired_count, used_count, code = await get_expire_info(\n expire_value, expire_style\n )\n prefix, suffix = os.path.splitext(file_name)\n\n await FileCodes.create(\n code=code,\n prefix=prefix,\n suffix=suffix,\n uuid_file_name=file_name,\n file_path=file_path,\n size=file_size,\n expired_at=expired_at,\n expired_count=expired_count,\n used_count=used_count,\n **extra_fields,\n )\n return code\n\n\nasync def validate_file_size(file: UploadFile, max_size: int) -> int:\n size = file.size\n if size is None:\n await file.seek(0, 2) # type: ignore[arg-type]\n size = file.file.tell()\n await file.seek(0)\n if size > max_size:\n max_size_mb = max_size / (1024 * 1024)\n raise HTTPException(\n status_code=403, detail=f\"大小超过限制,最大为{max_size_mb:.2f} MB\"\n )\n return size\n\n\nasync def create_file_code(code, **kwargs):\n return await FileCodes.create(code=code, **kwargs)\n\n\n@share_api.post(\"/text/\", dependencies=[Depends(share_required_login)])\nasync def share_text(\n text: str = Form(...),\n expire_value: int = Form(default=1, gt=0),\n expire_style: str = Form(default=\"day\"),\n ip: str = Depends(ip_limit[\"upload\"]),\n):\n text_size = len(text.encode(\"utf-8\"))\n max_txt_size = 222 * 1024\n if text_size > max_txt_size:\n raise HTTPException(status_code=403, detail=\"内容过多,建议采用文件形式\")\n\n expired_at, expired_count, used_count, code = await get_expire_info(\n expire_value, expire_style\n )\n await create_file_code(\n code=code,\n text=text,\n expired_at=expired_at,\n expired_count=expired_count,\n used_count=used_count,\n size=len(text),\n prefix=\"Text\",\n )\n ip_limit[\"upload\"].add_ip(ip)\n return APIResponse(detail={\"code\": code})\n\n\n@share_api.post(\"/file/\", dependencies=[Depends(share_required_login)])\nasync def share_file(\n expire_value: int = Form(default=1, gt=0),\n expire_style: str = Form(default=\"day\"),\n file: UploadFile = File(...),\n ip: str = Depends(ip_limit[\"upload\"]),\n):\n file_size = await validate_file_size(file, settings.uploadSize)\n if expire_style not in settings.expireStyle:\n raise HTTPException(status_code=400, detail=\"过期时间类型错误\")\n expired_at, expired_count, used_count, code = await get_expire_info(\n expire_value, expire_style\n )\n path, suffix, prefix, uuid_file_name, save_path = await get_file_path_name(file)\n file_storage: FileStorageInterface = storages[settings.file_storage]()\n await file_storage.save_file(file, save_path)\n await create_file_code(\n code=code,\n prefix=prefix,\n suffix=suffix,\n uuid_file_name=uuid_file_name,\n file_path=path,\n size=file_size,\n expired_at=expired_at,\n expired_count=expired_count,\n used_count=used_count,\n )\n ip_limit[\"upload\"].add_ip(ip)\n return APIResponse(detail={\"code\": code, \"name\": file.filename})\n\n\nasync def get_code_file_by_code(\n code: str, check: bool = True\n) -> Tuple[bool, Union[FileCodes, str]]:\n file_code = await FileCodes.filter(code=code).first()\n if not file_code:\n return False, \"文件不存在\"\n if await file_code.is_expired() and check:\n return False, \"文件已过期\"\n return True, file_code\n\n\nasync def update_file_usage(file_code: FileCodes) -> None:\n file_code.used_count += 1\n if file_code.expired_count > 0:\n file_code.expired_count -= 1\n await file_code.save()\n\n\n@share_api.get(\"/select/\")\nasync def get_code_file(code: str, ip: str = Depends(ip_limit[\"error\"])):\n file_storage: FileStorageInterface = storages[settings.file_storage]()\n has, file_code = await get_code_file_by_code(code)\n if not has:\n ip_limit[\"error\"].add_ip(ip)\n return APIResponse(code=404, detail=file_code)\n\n assert isinstance(file_code, FileCodes)\n await update_file_usage(file_code)\n return await file_storage.get_file_response(file_code)\n\n\n@share_api.post(\"/select/\")\nasync def select_file(data: SelectFileModel, ip: str = Depends(ip_limit[\"error\"])):\n file_storage: FileStorageInterface = storages[settings.file_storage]()\n has, file_code = await get_code_file_by_code(data.code)\n if not has:\n ip_limit[\"error\"].add_ip(ip)\n return APIResponse(code=404, detail=file_code)\n\n assert isinstance(file_code, FileCodes)\n await update_file_usage(file_code)\n return APIResponse(\n detail={\n \"code\": file_code.code,\n \"name\": file_code.prefix + file_code.suffix,\n \"size\": file_code.size,\n \"text\": (\n file_code.text\n if file_code.text is not None\n else await file_storage.get_file_url(file_code)\n ),\n }\n )\n\n\n@share_api.get(\"/download\")\nasync def download_file(key: str, code: str, ip: str = Depends(ip_limit[\"error\"])):\n file_storage: FileStorageInterface = storages[settings.file_storage]()\n if await get_select_token(code) != key:\n ip_limit[\"error\"].add_ip(ip)\n raise HTTPException(status_code=403, detail=\"下载鉴权失败\")\n has, file_code = await get_code_file_by_code(code, False)\n if not has:\n return APIResponse(code=404, detail=\"文件不存在\")\n assert isinstance(file_code, FileCodes)\n return (\n APIResponse(detail=file_code.text)\n if file_code.text\n else await file_storage.get_file_response(file_code)\n )\n\n\nchunk_api = APIRouter(prefix=\"/chunk\", tags=[\"切片\"])\n\n\n@chunk_api.post(\"/upload/init/\", dependencies=[Depends(share_required_login)])\nasync def init_chunk_upload(data: InitChunkUploadModel):\n # 服务端校验：根据 total_chunks * chunk_size 计算理论最大上传量\n total_chunks = (data.file_size + data.chunk_size - 1) // data.chunk_size\n max_possible_size = total_chunks * data.chunk_size\n if max_possible_size > settings.uploadSize:\n max_size_mb = settings.uploadSize / (1024 * 1024)\n raise HTTPException(\n status_code=403, detail=f\"文件大小超过限制，最大为 {max_size_mb:.2f} MB\"\n )\n\n # # 秒传检查\n # existing = await FileCodes.filter(file_hash=data.file_hash).first()\n # if existing:\n # if await existing.is_expired():\n # file_storage: FileStorageInterface = storages[settings.file_storage](\n # )\n # await file_storage.delete_file(existing)\n # await existing.delete()\n # else:\n # return APIResponse(detail={\n # \"code\": existing.code,\n # \"existed\": True,\n # \"name\": f'{existing.prefix}{existing.suffix}'\n # })\n\n # 断点续传：检查是否存在相同文件的未完成上传会话\n existing_session = await UploadChunk.filter(\n chunk_hash=data.file_hash,\n chunk_index=-1,\n file_size=data.file_size,\n file_name=data.file_name,\n ).first()\n\n if existing_session:\n if not existing_session.save_path:\n await UploadChunk.filter(upload_id=existing_session.upload_id).delete()\n else:\n uploaded_chunks = await UploadChunk.filter(\n upload_id=existing_session.upload_id, completed=True\n ).values_list(\"chunk_index\", flat=True)\n return APIResponse(\n detail={\n \"existed\": False,\n \"upload_id\": existing_session.upload_id,\n \"chunk_size\": existing_session.chunk_size,\n \"total_chunks\": existing_session.total_chunks,\n \"uploaded_chunks\": list(uploaded_chunks),\n }\n )\n\n # 创建新的上传会话\n upload_id = uuid.uuid4().hex\n _, _, _, _, save_path = await get_chunk_file_path_name(data.file_name, upload_id)\n await UploadChunk.create(\n upload_id=upload_id,\n chunk_index=-1,\n total_chunks=total_chunks,\n file_size=data.file_size,\n chunk_size=data.chunk_size,\n chunk_hash=data.file_hash,\n file_name=data.file_name,\n save_path=save_path,\n )\n return APIResponse(\n detail={\n \"existed\": False,\n \"upload_id\": upload_id,\n \"chunk_size\": data.chunk_size,\n \"total_chunks\": total_chunks,\n \"uploaded_chunks\": [],\n }\n )\n\n\n@chunk_api.post(\n \"/upload/chunk/{upload_id}/{chunk_index}\",\n dependencies=[Depends(share_required_login)],\n)\nasync def upload_chunk(\n upload_id: str,\n chunk_index: int,\n chunk: UploadFile = File(...),\n):\n # 获取上传会话信息\n chunk_info = await UploadChunk.filter(upload_id=upload_id, chunk_index=-1).first()\n if not chunk_info:\n raise HTTPException(status.HTTP_404_NOT_FOUND, detail=\"上传会话不存在\")\n\n # 检查分片索引有效性\n if chunk_index < 0 or chunk_index >= chunk_info.total_chunks:\n raise HTTPException(status.HTTP_400_BAD_REQUEST, detail=\"无效的分片索引\")\n\n # 检查是否已上传（支持断点续传）\n existing_chunk = await UploadChunk.filter(\n upload_id=upload_id, chunk_index=chunk_index, completed=True\n ).first()\n if existing_chunk:\n return APIResponse(\n detail={\"chunk_hash\": existing_chunk.chunk_hash, \"skipped\": True}\n )\n\n # 读取分片数据并计算哈希\n chunk_data = await chunk.read()\n chunk_size = len(chunk_data)\n\n # 校验分片大小不超过声明的 chunk_size\n if chunk_size > chunk_info.chunk_size:\n raise HTTPException(\n status.HTTP_400_BAD_REQUEST,\n detail=f\"分片大小超过声明值: 最大 {chunk_info.chunk_size}, 实际 {chunk_size}\",\n )\n\n # 计算已上传分片数，校验累计大小不超限（用分片数 * chunk_size 估算）\n uploaded_count = await UploadChunk.filter(\n upload_id=upload_id, completed=True\n ).count()\n # 已上传分片的最大可能大小 + 当前分片\n max_uploaded_size = uploaded_count * chunk_info.chunk_size + chunk_size\n if max_uploaded_size > settings.uploadSize:\n max_size_mb = settings.uploadSize / (1024 * 1024)\n raise HTTPException(\n status_code=403, detail=f\"累计上传大小超过限制，最大为 {max_size_mb:.2f} MB\"\n )\n\n chunk_hash = hashlib.sha256(chunk_data).hexdigest()\n\n save_path = chunk_info.save_path\n\n # 保存分片到存储\n storage = storages[settings.file_storage]()\n try:\n await storage.save_chunk(\n upload_id, chunk_index, chunk_data, chunk_hash, save_path\n )\n except Exception as e:\n raise HTTPException(\n status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f\"分片保存失败: {str(e)}\"\n )\n\n # 更新或创建分片记录（保存成功后再记录）\n await UploadChunk.update_or_create(\n upload_id=upload_id,\n chunk_index=chunk_index,\n defaults={\n \"chunk_hash\": chunk_hash,\n \"completed\": True,\n \"file_size\": chunk_info.file_size,\n \"total_chunks\": chunk_info.total_chunks,\n \"chunk_size\": chunk_info.chunk_size,\n \"file_name\": chunk_info.file_name,\n \"save_path\": chunk_info.save_path,\n },\n )\n return APIResponse(detail={\"chunk_hash\": chunk_hash})\n\n\n@chunk_api.delete(\"/upload/{upload_id}\", dependencies=[Depends(share_required_login)])\nasync def cancel_upload(upload_id: str):\n \"\"\"取消上传并清理临时文件\"\"\"\n chunk_info = await UploadChunk.filter(upload_id=upload_id, chunk_index=-1).first()\n if not chunk_info:\n raise HTTPException(status.HTTP_404_NOT_FOUND, detail=\"上传会话不存在\")\n\n save_path = chunk_info.save_path\n\n # 清理存储中的临时文件\n storage = storages[settings.file_storage]()\n if save_path:\n try:\n await storage.clean_chunks(upload_id, save_path)\n except Exception as e:\n pass\n\n # 清理数据库记录\n await UploadChunk.filter(upload_id=upload_id).delete()\n\n return APIResponse(detail={\"message\": \"上传已取消\"})\n\n\n@chunk_api.get(\n \"/upload/status/{upload_id}\", dependencies=[Depends(share_required_login)]\n)\nasync def get_upload_status(upload_id: str):\n \"\"\"获取上传状态\"\"\"\n chunk_info = await UploadChunk.filter(upload_id=upload_id, chunk_index=-1).first()\n if not chunk_info:\n raise HTTPException(status.HTTP_404_NOT_FOUND, detail=\"上传会话不存在\")\n\n # 获取已上传的分片列表\n uploaded_chunks = await UploadChunk.filter(\n upload_id=upload_id, completed=True\n ).values_list(\"chunk_index\", flat=True)\n\n return APIResponse(\n detail={\n \"upload_id\": upload_id,\n \"file_name\": chunk_info.file_name,\n \"file_size\": chunk_info.file_size,\n \"chunk_size\": chunk_info.chunk_size,\n \"total_chunks\": chunk_info.total_chunks,\n \"uploaded_chunks\": list(uploaded_chunks),\n \"progress\": len(uploaded_chunks) / chunk_info.total_chunks * 100,\n }\n )\n\n\n@chunk_api.post(\n \"/upload/complete/{upload_id}\", dependencies=[Depends(share_required_login)]\n)\nasync def complete_upload(\n upload_id: str, data: CompleteUploadModel, ip: str = Depends(ip_limit[\"upload\"])\n):\n # 获取上传基本信息\n chunk_info = await UploadChunk.filter(upload_id=upload_id, chunk_index=-1).first()\n if not chunk_info:\n raise HTTPException(status.HTTP_404_NOT_FOUND, detail=\"上传会话不存在\")\n\n storage = storages[settings.file_storage]()\n # 验证所有分片\n completed_chunks_list = await UploadChunk.filter(\n upload_id=upload_id, completed=True\n ).all()\n if len(completed_chunks_list) != chunk_info.total_chunks:\n raise HTTPException(status.HTTP_400_BAD_REQUEST, detail=\"分片不完整\")\n\n # 用分片数 * chunk_size 校验最大可能大小\n max_total_size = len(completed_chunks_list) * chunk_info.chunk_size\n if max_total_size > settings.uploadSize:\n save_path = chunk_info.save_path\n if save_path:\n try:\n await storage.clean_chunks(upload_id, save_path)\n except Exception:\n pass\n await UploadChunk.filter(upload_id=upload_id).delete()\n max_size_mb = settings.uploadSize / (1024 * 1024)\n raise HTTPException(\n status_code=403, detail=f\"实际上传大小超过限制，最大为 {max_size_mb:.2f} MB\"\n )\n\n save_path = chunk_info.save_path\n path = os.path.dirname(save_path) if save_path else \"\"\n prefix, suffix = os.path.splitext(chunk_info.file_name)\n\n try:\n # 合并文件并计算哈希\n _, file_hash = await storage.merge_chunks(upload_id, chunk_info, save_path)\n # 创建文件记录\n expired_at, expired_count, used_count, code = await get_expire_info(\n data.expire_value, data.expire_style\n )\n await FileCodes.create(\n code=code,\n file_hash=file_hash, # 使用合并后计算的哈希\n is_chunked=True,\n upload_id=upload_id,\n size=chunk_info.file_size,\n expired_at=expired_at,\n expired_count=expired_count,\n used_count=used_count,\n file_path=path,\n uuid_file_name=f\"{prefix}{suffix}\",\n prefix=prefix,\n suffix=suffix,\n )\n # 清理临时文件\n await storage.clean_chunks(upload_id, save_path)\n # 清理数据库中的分片记录\n await UploadChunk.filter(upload_id=upload_id).delete()\n ip_limit[\"upload\"].add_ip(ip)\n return APIResponse(detail={\"code\": code, \"name\": chunk_info.file_name})\n except ValueError as e:\n raise HTTPException(status.HTTP_400_BAD_REQUEST, detail=str(e))\n except Exception as e:\n # 合并失败时清理临时文件\n try:\n await storage.clean_chunks(upload_id, save_path)\n except Exception:\n pass\n raise HTTPException(\n status.HTTP_500_INTERNAL_SERVER_ERROR, detail=f\"文件合并失败: {str(e)}\"\n )\n\n\n# ============ 预签名上传API ============\npresign_api = APIRouter(prefix=\"/presign\", tags=[\"预签名上传\"])\n\nPRESIGN_SESSION_EXPIRES = 900 # 15分钟\n\n\nasync def _get_valid_session(\n upload_id: str, expected_mode: Optional[str] = None\n) -> PresignUploadSession:\n \"\"\"获取并验证会话\"\"\"\n session = await PresignUploadSession.filter(upload_id=upload_id).first()\n if not session:\n raise HTTPException(404, \"上传会话不存在\")\n if await session.is_expired():\n await session.delete()\n raise HTTPException(404, \"上传会话已过期\")\n if expected_mode and session.mode != expected_mode:\n raise HTTPException(400, f\"此会话不支持{expected_mode}模式\")\n return session\n\n\n@presign_api.post(\"/upload/init\", dependencies=[Depends(share_required_login)])\nasync def presign_upload_init(\n data: PresignUploadInitRequest, ip: str = Depends(ip_limit[\"upload\"])\n):\n \"\"\"初始化预签名上传，S3返回直传URL，其他存储返回代理URL\"\"\"\n if data.file_size > settings.uploadSize:\n raise HTTPException(\n 403,\n f\"文件大小超过限制，最大为 {settings.uploadSize / (1024 * 1024):.2f} MB\",\n )\n if data.expire_style not in settings.expireStyle:\n raise HTTPException(400, \"过期时间类型错误\")\n\n upload_id = uuid.uuid4().hex\n path, _, _, filename, save_path = await FileUploadService.generate_file_path(\n data.file_name, upload_id\n )\n\n storage: FileStorageInterface = storages[settings.file_storage]()\n presigned_url = await storage.generate_presigned_upload_url(\n save_path, PRESIGN_SESSION_EXPIRES\n )\n\n mode = \"direct\" if presigned_url else \"proxy\"\n upload_url = presigned_url or f\"/api/presign/upload/proxy/{upload_id}\"\n\n await PresignUploadSession.create(\n upload_id=upload_id,\n file_name=filename,\n file_size=data.file_size,\n save_path=save_path,\n mode=mode,\n expire_value=data.expire_value,\n expire_style=data.expire_style,\n expires_at=await get_now() + timedelta(seconds=PRESIGN_SESSION_EXPIRES),\n )\n\n ip_limit[\"upload\"].add_ip(ip)\n return APIResponse(\n detail={\n \"upload_id\": upload_id,\n \"upload_url\": upload_url,\n \"mode\": mode,\n \"expires_in\": PRESIGN_SESSION_EXPIRES,\n }\n )\n\n\n@presign_api.put(\n \"/upload/proxy/{upload_id}\", dependencies=[Depends(share_required_login)]\n)\nasync def presign_upload_proxy(\n upload_id: str, file: UploadFile = File(...), ip: str = Depends(ip_limit[\"upload\"])\n):\n \"\"\"代理模式上传，服务器转存到存储后端\"\"\"\n session = await _get_valid_session(upload_id, expected_mode=\"proxy\")\n\n file_size = await validate_file_size(file, settings.uploadSize)\n if abs(file_size - session.file_size) > 1024:\n raise HTTPException(400, \"文件大小与声明不符\")\n\n storage: FileStorageInterface = storages[settings.file_storage]()\n try:\n await storage.save_file(file, session.save_path)\n except Exception as e:\n raise HTTPException(500, f\"文件保存失败: {str(e)}\")\n\n code = await FileUploadService.create_file_record(\n session.file_name,\n file_size,\n os.path.dirname(session.save_path),\n session.expire_value,\n session.expire_style,\n )\n\n await session.delete()\n ip_limit[\"upload\"].add_ip(ip)\n return APIResponse(detail={\"code\": code, \"name\": session.file_name})\n\n\n@presign_api.post(\n \"/upload/confirm/{upload_id}\", dependencies=[Depends(share_required_login)]\n)\nasync def presign_upload_confirm(upload_id: str, ip: str = Depends(ip_limit[\"upload\"])):\n \"\"\"直传确认，客户端完成S3直传后调用获取分享码\"\"\"\n session = await _get_valid_session(upload_id, expected_mode=\"direct\")\n\n storage: FileStorageInterface = storages[settings.file_storage]()\n if not await storage.file_exists(session.save_path):\n raise HTTPException(404, \"文件未上传或上传失败\")\n\n code = await FileUploadService.create_file_record(\n session.file_name,\n session.file_size,\n os.path.dirname(session.save_path),\n session.expire_value,\n session.expire_style,\n )\n\n await session.delete()\n ip_limit[\"upload\"].add_ip(ip)\n return APIResponse(detail={\"code\": code, \"name\": session.file_name})\n\n\n@presign_api.get(\n \"/upload/status/{upload_id}\", dependencies=[Depends(share_required_login)]\n)\nasync def presign_upload_status(upload_id: str):\n \"\"\"查询上传会话状态\"\"\"\n session = await PresignUploadSession.filter(upload_id=upload_id).first()\n if not session:\n raise HTTPException(404, \"上传会话不存在\")\n\n return APIResponse(\n detail={\n \"upload_id\": session.upload_id,\n \"file_name\": session.file_name,\n \"file_size\": session.file_size,\n \"mode\": session.mode,\n \"created_at\": session.created_at.isoformat(),\n \"expires_at\": session.expires_at.isoformat(),\n \"is_expired\": await session.is_expired(),\n }\n )\n\n\n@presign_api.delete(\"/upload/{upload_id}\", dependencies=[Depends(share_required_login)])\nasync def presign_upload_cancel(upload_id: str):\n \"\"\"取消上传会话\"\"\"\n session = await PresignUploadSession.filter(upload_id=upload_id).first()\n if not session:\n raise HTTPException(404, \"上传会话不存在\")\n\n if session.mode == \"direct\":\n storage: FileStorageInterface = storages[settings.file_storage]()\n try:\n if await storage.file_exists(session.save_path):\n temp_file_code = FileCodes(\n file_path=os.path.dirname(session.save_path),\n uuid_file_name=os.path.basename(session.save_path),\n )\n await storage.delete_file(temp_file_code)\n except Exception:\n pass\n\n await session.delete()\n return APIResponse(detail={\"message\": \"上传会话已取消\"})\n" }, { "path": "core/__init__.py", "content": "# @Time : 2023/8/11 20:06\n# @Author : Lan\n# @File : __init__.py.py\n# @Software: PyCharm\n" }, { "path": "core/config.py", "content": "from apps.base.models import KeyValue\nfrom apps.base.utils import ip_limit\nfrom core.settings import DEFAULT_CONFIG, settings\n\n\nasync def ensure_settings_row() -> None:\n await KeyValue.get_or_create(key=\"settings\", defaults={\"value\": DEFAULT_CONFIG})\n\n\ndef _sync_ip_limits() -> None:\n ip_limit[\"error\"].minutes = settings.errorMinute\n ip_limit[\"error\"].count = settings.errorCount\n ip_limit[\"upload\"].minutes = settings.uploadMinute\n ip_limit[\"upload\"].count = settings.uploadCount\n\n\nasync def refresh_settings() -> None:\n \"\"\"从数据库读取最新配置并应用到运行时。\"\"\"\n config_record = await KeyValue.filter(key=\"settings\").first()\n settings.user_config = config_record.value if config_record and config_record.value else {}\n _sync_ip_limits()\n" }, { "path": "core/database.py", "content": "import asyncio\nimport glob\nimport importlib\nimport os\nfrom contextlib import asynccontextmanager\nfrom typing import IO\n\nfrom tortoise import Tortoise\n\nfrom core.logger import logger\nfrom core.settings import data_root\n\n\n_DB_FILE = os.path.join(data_root, \"filecodebox.db\")\n_STARTUP_LOCK_FILE = os.path.join(data_root, \"filecodebox.startup.lock\")\n\n\ndef get_db_config() -> dict:\n return {\n \"connections\": {\n \"default\": {\n \"engine\": \"tortoise.backends.sqlite\",\n \"credentials\": {\n \"file_path\": _DB_FILE,\n \"journal_mode\": \"WAL\",\n \"busy_timeout\": 10000,\n \"foreign_keys\": \"ON\",\n },\n }\n },\n \"apps\": {\n \"models\": {\n \"models\": [\"apps.base.models\"],\n \"default_connection\": \"default\",\n }\n },\n \"use_tz\": False,\n \"timezone\": \"Asia/Shanghai\",\n }\n\n\ndef _lock_file(file_obj: IO[str]) -> None:\n if os.name == \"nt\":\n import msvcrt\n\n # Windows 需要锁定至少 1 字节\n if os.fstat(file_obj.fileno()).st_size == 0:\n file_obj.write(\"0\")\n file_obj.flush()\n msvcrt.locking(file_obj.fileno(), msvcrt.LK_LOCK, 1)\n else:\n import fcntl\n\n fcntl.flock(file_obj.fileno(), fcntl.LOCK_EX)\n\n\ndef _unlock_file(file_obj: IO[str]) -> None:\n if os.name == \"nt\":\n import msvcrt\n\n msvcrt.locking(file_obj.fileno(), msvcrt.LK_UNLCK, 1)\n else:\n import fcntl\n\n fcntl.flock(file_obj.fileno(), fcntl.LOCK_UN)\n\n\n@asynccontextmanager\nasync def db_startup_lock():\n os.makedirs(data_root, exist_ok=True)\n lock_file = open(_STARTUP_LOCK_FILE, \"a+\", encoding=\"utf-8\")\n try:\n await asyncio.to_thread(_lock_file, lock_file)\n yield\n finally:\n await asyncio.to_thread(_unlock_file, lock_file)\n lock_file.close()\n\n\nasync def init_db():\n try:\n db_config = get_db_config()\n\n if not Tortoise._inited:\n await Tortoise.init(config=db_config)\n\n async with db_startup_lock():\n # 创建migrations表\n await Tortoise.get_connection(\"default\").execute_script(\"\"\"\n CREATE TABLE IF NOT EXISTS migrates (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n migration_file VARCHAR(255) NOT NULL UNIQUE,\n executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n )\n \"\"\")\n\n # 执行迁移\n await execute_migrations()\n\n except Exception as e:\n logger.error(f\"数据库初始化失败: {str(e)}\")\n raise\n\n\nasync def execute_migrations():\n \"\"\"执行数据库迁移\"\"\"\n try:\n # 收集迁移文件\n migration_files = []\n for root, dirs, files in os.walk(\"apps\"):\n if \"migrations\" in dirs:\n migration_path = os.path.join(root, \"migrations\")\n migration_files.extend(glob.glob(os.path.join(migration_path, \"migrations_*.py\")))\n\n # 按文件名排序\n migration_files.sort()\n\n for migration_file in migration_files:\n file_name = os.path.basename(migration_file)\n\n # 检查是否已执行\n executed = await Tortoise.get_connection(\"default\").execute_query(\n \"SELECT id FROM migrates WHERE migration_file = ?\", [file_name]\n )\n\n if not executed[1]:\n logger.info(f\"执行迁移: {file_name}\")\n # 导入并执行migration\n module_path = migration_file.replace(\"/\", \".\").replace(\"\\\\\", \".\").replace(\".py\", \"\")\n try:\n migration_module = importlib.import_module(module_path)\n if hasattr(migration_module, \"migrate\"):\n await migration_module.migrate()\n # 记录执行\n await Tortoise.get_connection(\"default\").execute_query(\n \"INSERT INTO migrates (migration_file) VALUES (?)\",\n [file_name]\n )\n logger.info(f\"迁移完成: {file_name}\")\n except Exception as e:\n logger.error(f\"迁移 {file_name} 执行失败: {str(e)}\")\n raise\n\n except Exception as e:\n logger.error(f\"迁移过程发生错误: {str(e)}\")\n raise\n" }, { "path": "core/logger.py", "content": "import logging\nimport sys\n\n\ndef setup_logger():\n # 创建logger对象\n _logger = logging.getLogger('FileCodeBox')\n _logger.setLevel(logging.INFO)\n\n # 创建控制台处理器\n console_handler = logging.StreamHandler(sys.stdout)\n console_handler.setLevel(logging.INFO)\n\n # 设置日志格式\n formatter = logging.Formatter(\n '%(asctime)s - %(name)s - %(levelname)s - %(message)s',\n datefmt='%Y-%m-%d %H:%M:%S'\n )\n console_handler.setFormatter(formatter)\n\n # 添加处理器到logger\n _logger.addHandler(console_handler)\n\n return _logger\n\n\n# 创建全局logger实例\nlogger = setup_logger()\n" }, { "path": "core/response.py", "content": "# @Time : 2023/8/14 11:48\n# @Author : Lan\n# @File : response.py\n# @Software: PyCharm\nfrom typing import Generic, Optional, TypeVar\n\nfrom pydantic import BaseModel\n\nT = TypeVar(\"T\")\n\n\nclass APIResponse(BaseModel, Generic[T]):\n code: int = 200\n message: str = \"ok\"\n detail: Optional[T] = None\n" }, { "path": "core/settings.py", "content": "# @Time : 2023/8/15 09:51\n# @Author : Lan\n# @File : settings.py\n# @Software: PyCharm\nfrom pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\ndata_root = BASE_DIR / \"data\"\n\nif not data_root.exists():\n data_root.mkdir(parents=True, exist_ok=True)\n\nDEFAULT_CONFIG = {\n \"file_storage\": \"local\",\n \"storage_path\": \"\",\n \"name\": \"文件快递柜 - FileCodeBox\",\n \"description\": \"开箱即用的文件快传系统\",\n \"notify_title\": \"系统通知\",\n \"notify_content\": '欢迎使用 FileCodeBox，本程序开源于 Github ，欢迎Star和Fork。',\n \"page_explain\": \"请勿上传或分享违法内容。根据《中华人民共和国网络安全法》、《中华人民共和国刑法》、《中华人民共和国治安管理处罚法》等相关规定。 传播或存储违法、违规内容，会受到相关处罚，严重者将承担刑事责任。本站坚决配合相关部门，确保网络内容的安全，和谐，打造绿色网络环境。\",\n \"keywords\": \"FileCodeBox, 文件快递柜, 口令传送箱, 匿名口令分享文本, 文件\",\n \"s3_access_key_id\": \"\",\n \"s3_secret_access_key\": \"\",\n \"s3_bucket_name\": \"\",\n \"s3_endpoint_url\": \"\",\n \"s3_region_name\": \"auto\",\n \"s3_signature_version\": \"s3v2\",\n \"s3_hostname\": \"\",\n \"s3_proxy\": 0,\n \"max_save_seconds\": 0,\n \"aws_session_token\": \"\",\n \"onedrive_domain\": \"\",\n \"onedrive_client_id\": \"\",\n \"onedrive_username\": \"\",\n \"onedrive_password\": \"\",\n \"onedrive_root_path\": \"filebox_storage\",\n \"onedrive_proxy\": 0,\n \"webdav_root_path\": \"filebox_storage\",\n \"webdav_proxy\": 0,\n \"admin_token\": \"FileCodeBox2023\",\n \"openUpload\": 1,\n \"uploadSize\": 1024 * 1024 * 10,\n \"expireStyle\": [\"day\", \"hour\", \"minute\", \"forever\", \"count\"],\n \"uploadMinute\": 1,\n \"enableChunk\": 0,\n \"webdav_url\": \"\",\n \"webdav_password\": \"\",\n \"webdav_username\": \"\",\n \"opacity\": 0.9,\n \"background\": \"\",\n \"uploadCount\": 10,\n \"themesChoices\": [\n {\n \"name\": \"2023\",\n \"key\": \"themes/2023\",\n \"author\": \"Lan\",\n \"version\": \"1.0\",\n },\n {\n \"name\": \"2024\",\n \"key\": \"themes/2024\",\n \"author\": \"Lan\",\n \"version\": \"1.0\",\n },\n ],\n \"themesSelect\": \"themes/2024\",\n \"errorMinute\": 1,\n \"errorCount\": 10,\n \"serverWorkers\": 1,\n \"serverHost\": \"0.0.0.0\",\n \"serverPort\": 12345,\n \"showAdminAddr\": 0,\n \"robotsText\": \"User-agent: *\\nDisallow: /\",\n}\n\n\nclass Settings:\n def __init__(self, defaults=None):\n self.default_config = defaults or {}\n self.user_config = {}\n\n def __getattr__(self, attr):\n if attr in self.user_config:\n return self.user_config[attr]\n if attr in self.default_config:\n return self.default_config[attr]\n raise AttributeError(\n f\"'{self.__class__.__name__}' object has no attribute '{attr}'\"\n )\n\n def __setattr__(self, key, value):\n if key in [\"default_config\", \"user_config\"]:\n super().__setattr__(key, value)\n else:\n self.user_config[key] = value\n\n def items(self):\n return {**self.default_config, **self.user_config}.items()\n\n\nsettings = Settings(DEFAULT_CONFIG)\n" }, { "path": "core/storage.py", "content": "# @Time : 2023/8/11 20:06\n# @Author : Lan\n# @File : storage.py\n# @Software: PyCharm\nimport base64\nimport hashlib\nimport os\nimport tempfile\nfrom core.logger import logger\nimport shutil\nfrom typing import Optional\nfrom urllib.parse import quote, unquote\n\nimport aiofiles\nimport aiohttp\nimport asyncio\nfrom pathlib import Path\nimport datetime\nimport re\nimport aioboto3\nfrom botocore.config import Config\nfrom fastapi import HTTPException, Response, UploadFile\nfrom core.response import APIResponse\nfrom core.settings import data_root, settings\nfrom apps.base.models import FileCodes, UploadChunk\nfrom core.utils import get_file_url, sanitize_filename\nfrom fastapi.responses import FileResponse, StreamingResponse\n\n\nclass FileStorageInterface:\n\n async def save_file(self, file: UploadFile, save_path: str):\n \"\"\"\n 保存文件\n \"\"\"\n raise NotImplementedError\n\n async def delete_file(self, file_code: FileCodes):\n \"\"\"\n 删除文件\n \"\"\"\n raise NotImplementedError\n\n async def get_file_url(self, file_code: FileCodes):\n \"\"\"\n 获取文件分享的url\n\n 如果服务不支持直接访问文件，可以通过服务器中转下载。\n 此时，此方法可以调用 utils.py 中的 `get_file_url` 方法，获取服务器中转下载的url\n \"\"\"\n raise NotImplementedError\n\n async def get_file_response(self, file_code: FileCodes):\n \"\"\"\n 获取文件响应\n\n 如果服务不支持直接访问文件，则需要实现该方法，返回文件响应\n 其余情况，可以不实现该方法\n \"\"\"\n raise NotImplementedError\n\n async def save_chunk(self, upload_id: str, chunk_index: int, chunk_data: bytes, chunk_hash: str, save_path: str):\n \"\"\"\n 保存分片文件\n :param upload_id: 上传会话ID\n :param chunk_index: 分片索引\n :param chunk_data: 分片数据\n :param chunk_hash: 分片哈希值\n :param save_path: 文件保存路径\n \"\"\"\n raise NotImplementedError\n\n async def merge_chunks(self, upload_id: str, chunk_info: UploadChunk, save_path: str) -> tuple[str, str]:\n \"\"\"\n 合并分片文件并返回文件路径和完整哈希值\n :param upload_id: 上传会话ID\n :param chunk_info: 分片信息\n :param save_path: 文件保存路径\n :return: (文件路径, 文件哈希值)\n \"\"\"\n raise NotImplementedError\n\n async def generate_presigned_upload_url(self, save_path: str, expires_in: int = 900) -> Optional[str]:\n \"\"\"\n 生成预签名上传URL\n :param save_path: 文件保存路径\n :param expires_in: URL过期时间（秒），默认15分钟\n :return: 预签名URL，如果不支持直传则返回None\n \"\"\"\n return None # 默认不支持直传，使用代理模式\n\n async def file_exists(self, save_path: str) -> bool:\n \"\"\"\n 检查文件是否存在\n :param save_path: 文件路径\n :return: 文件是否存在\n \"\"\"\n raise NotImplementedError\n\n async def clean_chunks(self, upload_id: str, save_path: str):\n \"\"\"\n 清理临时分片文件\n :param upload_id: 上传会话ID\n :param save_path: 文件保存路径\n \"\"\"\n raise NotImplementedError\n\n\nclass SystemFileStorage(FileStorageInterface):\n def __init__(self):\n self.chunk_size = 256 * 1024\n self.root_path = data_root\n\n def _save(self, file, save_path):\n with open(save_path, \"wb\") as f:\n chunk = file.read(self.chunk_size)\n while chunk:\n f.write(chunk)\n chunk = file.read(self.chunk_size)\n\n async def save_file(self, file: UploadFile, save_path: str):\n path_obj = Path(save_path)\n directory = str(path_obj.parent)\n # 提取原始文件名并进行清理\n filename = await sanitize_filename(path_obj.name)\n # 构建安全的完整保存路径\n safe_save_path = self.root_path / directory / filename\n # 确保目录存在\n if not safe_save_path.parent.exists():\n safe_save_path.parent.mkdir(parents=True)\n await asyncio.to_thread(self._save, file.file, safe_save_path)\n\n async def delete_file(self, file_code: FileCodes):\n save_path = self.root_path / await file_code.get_file_path()\n if save_path.exists():\n save_path.unlink()\n\n async def get_file_url(self, file_code: FileCodes):\n return await get_file_url(file_code.code)\n\n async def get_file_response(self, file_code: FileCodes):\n file_path = self.root_path / await file_code.get_file_path()\n if not file_path.exists():\n return APIResponse(code=404, detail=\"文件已过期删除\")\n filename = f\"{file_code.prefix}{file_code.suffix}\"\n encoded_filename = quote(filename, safe='')\n content_disposition = f\"attachment; filename*=UTF-8''{encoded_filename}\"\n \n # 尝试获取文件系统大小，如果成功则设置 Content-Length\n headers = {\"Content-Disposition\": content_disposition}\n try:\n content_length = file_path.stat().st_size\n headers[\"Content-Length\"] = str(content_length)\n except Exception:\n # 如果获取文件大小失败，则不提供 Content-Length\n pass\n \n return FileResponse(\n file_path,\n media_type=\"application/octet-stream\",\n headers=headers,\n filename=filename # 保留原始文件名以备某些场景使用\n )\n\n async def save_chunk(self, upload_id: str, chunk_index: int, chunk_data: bytes, chunk_hash: str, save_path: str):\n \"\"\"\n 保存分片文件到本地文件系统\n :param upload_id: 上传会话ID\n :param chunk_index: 分片索引\n :param chunk_data: 分片数据\n :param chunk_hash: 分片哈希值\n :param save_path: 文件保存路径\n \"\"\"\n chunk_dir = self.root_path / save_path\n chunk_path = chunk_dir.parent / 'chunks' / upload_id / f\"{chunk_index}.part\"\n if not chunk_path.parent.exists():\n chunk_path.parent.mkdir(parents=True, exist_ok=True)\n # 使用临时文件写入，确保原子性\n temp_path = chunk_path.with_suffix('.tmp')\n try:\n async with aiofiles.open(temp_path, \"wb\") as f:\n await f.write(chunk_data)\n # 原子重命名\n temp_path.rename(chunk_path)\n except Exception as e:\n if temp_path.exists():\n temp_path.unlink()\n raise e\n\n async def merge_chunks(self, upload_id: str, chunk_info: UploadChunk, save_path: str) -> tuple[str, str]:\n \"\"\"\n 合并本地文件系统的分片文件并返回文件路径和完整哈希值\n :param upload_id: 上传会话ID\n :param chunk_info: 分片信息\n :param save_path: 文件保存路径\n :return: (文件路径, 文件哈希值)\n \"\"\"\n output_path = self.root_path / save_path\n output_path.parent.mkdir(parents=True, exist_ok=True)\n chunk_base_dir = output_path.parent / 'chunks' / upload_id\n file_sha256 = hashlib.sha256()\n \n # 使用临时文件写入，确保原子性\n temp_output = output_path.with_suffix('.merging')\n try:\n async with aiofiles.open(temp_output, \"wb\") as out_file:\n for i in range(chunk_info.total_chunks):\n # 获取分片记录\n chunk_record = await UploadChunk.filter(upload_id=upload_id, chunk_index=i).first()\n if not chunk_record:\n raise ValueError(f\"分片{i}记录不存在\")\n chunk_path = chunk_base_dir / f\"{i}.part\"\n if not chunk_path.exists():\n raise ValueError(f\"分片{i}文件不存在\")\n async with aiofiles.open(chunk_path, \"rb\") as in_file:\n chunk_data = await in_file.read()\n current_hash = hashlib.sha256(chunk_data).hexdigest()\n if current_hash != chunk_record.chunk_hash:\n raise ValueError(f\"分片{i}哈希不匹配: 期望 {chunk_record.chunk_hash}, 实际 {current_hash}\")\n file_sha256.update(chunk_data)\n await out_file.write(chunk_data)\n # 原子重命名\n temp_output.rename(output_path)\n except Exception as e:\n if temp_output.exists():\n temp_output.unlink()\n raise e\n return str(output_path), file_sha256.hexdigest()\n\n async def clean_chunks(self, upload_id: str, save_path: str):\n \"\"\"\n 清理本地文件系统的临时分片文件\n :param upload_id: 上传会话ID\n :param save_path: 文件保存路径\n \"\"\"\n chunk_dir = (self.root_path / save_path).parent / 'chunks' / upload_id\n if chunk_dir.exists():\n try:\n shutil.rmtree(chunk_dir)\n except Exception as e:\n logger.info(f\"清理本地分片目录失败: {e}\")\n # 清理父级 chunks 目录（如果为空）\n chunks_parent = chunk_dir.parent\n if chunks_parent.exists() and not any(chunks_parent.iterdir()):\n try:\n chunks_parent.rmdir()\n except Exception as e:\n logger.info(f\"清理 chunks 父目录失败: {e}\")\n\n async def file_exists(self, save_path: str) -> bool:\n \"\"\"\n 检查文件是否存在于本地文件系统\n :param save_path: 文件路径\n :return: 文件是否存在\n \"\"\"\n file_path = self.root_path / save_path\n return file_path.exists()\n\n\nclass S3FileStorage(FileStorageInterface):\n def __init__(self):\n self.access_key_id = settings.s3_access_key_id\n self.secret_access_key = settings.s3_secret_access_key\n self.bucket_name = settings.s3_bucket_name\n self.s3_hostname = settings.s3_hostname\n self.region_name = settings.s3_region_name\n self.signature_version = settings.s3_signature_version\n self.endpoint_url = settings.s3_endpoint_url or f\"https://{self.s3_hostname}\"\n self.aws_session_token = settings.aws_session_token\n self.proxy = settings.s3_proxy\n self.session = aioboto3.Session(\n aws_access_key_id=self.access_key_id,\n aws_secret_access_key=self.secret_access_key,\n )\n if not settings.s3_endpoint_url:\n self.endpoint_url = f\"https://{self.s3_hostname}\"\n else:\n # 如果提供了 s3_endpoint_url，则优先使用它\n self.endpoint_url = settings.s3_endpoint_url\n\n async def save_file(self, file: UploadFile, save_path: str):\n async with self.session.client(\n \"s3\",\n endpoint_url=self.endpoint_url,\n aws_session_token=self.aws_session_token,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n # 使用 upload_fileobj 流式上传，避免将整个文件加载到内存\n await s3.upload_fileobj(\n file.file,\n self.bucket_name,\n save_path,\n ExtraArgs={\"ContentType\": file.content_type or \"application/octet-stream\"},\n )\n\n async def delete_file(self, file_code: FileCodes):\n async with self.session.client(\n \"s3\",\n endpoint_url=self.endpoint_url,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n await s3.delete_object(\n Bucket=self.bucket_name, Key=await file_code.get_file_path()\n )\n\n async def get_file_response(self, file_code: FileCodes):\n try:\n filename = file_code.prefix + file_code.suffix\n content_length = None # 初始化为 None，表示未知大小\n \n async with self.session.client(\n \"s3\",\n endpoint_url=self.endpoint_url,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n # 尝试获取文件大小（HEAD请求）\n try:\n head_response = await s3.head_object(\n Bucket=self.bucket_name,\n Key=await file_code.get_file_path()\n )\n # 从HEAD响应中获取Content-Length\n if 'ContentLength' in head_response:\n content_length = head_response['ContentLength']\n elif 'Content-Length' in head_response['ResponseMetadata']['HTTPHeaders']:\n content_length = int(head_response['ResponseMetadata']['HTTPHeaders']['Content-Length'])\n except Exception:\n # 如果HEAD请求失败，则不提供 Content-Length\n pass\n \n link = await s3.generate_presigned_url(\n \"get_object\",\n Params={\n \"Bucket\": self.bucket_name,\n \"Key\": await file_code.get_file_path(),\n },\n ExpiresIn=3600,\n )\n \n # 创建ClientSession并传递给生成器复用\n session = aiohttp.ClientSession()\n \n async def stream_generator():\n try:\n async with session.get(link) as resp:\n if resp.status != 200:\n raise HTTPException(\n status_code=resp.status,\n detail=f\"从S3获取文件失败: {resp.status}\"\n )\n # 设置块大小（例如64KB）\n chunk_size = 65536\n while True:\n chunk = await resp.content.read(chunk_size)\n if not chunk:\n break\n yield chunk\n finally:\n await session.close()\n \n from fastapi.responses import StreamingResponse\n encoded_filename = quote(filename, safe='')\n headers = {\n \"Content-Disposition\": f\"attachment; filename*=UTF-8''{encoded_filename}\"\n }\n if content_length is not None:\n headers[\"Content-Length\"] = str(content_length)\n return StreamingResponse(\n stream_generator(),\n media_type=\"application/octet-stream\",\n headers=headers\n )\n except HTTPException:\n raise\n except Exception:\n raise HTTPException(status_code=503, detail=\"服务代理下载异常，请稍后再试\")\n\n async def get_file_url(self, file_code: FileCodes):\n if file_code.prefix == \"文本分享\":\n return file_code.text\n if self.proxy:\n return await get_file_url(file_code.code)\n else:\n async with self.session.client(\n \"s3\",\n endpoint_url=self.endpoint_url,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n result = await s3.generate_presigned_url(\n \"get_object\",\n Params={\n \"Bucket\": self.bucket_name,\n \"Key\": await file_code.get_file_path(),\n },\n ExpiresIn=3600,\n )\n return result\n\n async def save_chunk(self, upload_id: str, chunk_index: int, chunk_data: bytes, chunk_hash: str, save_path: str):\n \"\"\"\n 保存分片到 S3（使用独立对象存储每个分片）\n 注意：这里不使用 S3 原生的 multipart upload，而是将每个分片作为独立对象存储\n \"\"\"\n chunk_key = str(Path(save_path).parent / \"chunks\" / upload_id / f\"{chunk_index}.part\")\n async with self.session.client(\n 's3',\n endpoint_url=self.endpoint_url,\n aws_session_token=self.aws_session_token,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n # 将分片作为独立对象上传\n await s3.put_object(\n Bucket=self.bucket_name,\n Key=chunk_key,\n Body=chunk_data,\n Metadata={\n 'chunk-hash': chunk_hash,\n 'chunk-index': str(chunk_index)\n }\n )\n\n async def merge_chunks(self, upload_id: str, chunk_info: UploadChunk, save_path: str) -> tuple[str, str]:\n \"\"\"\n 合并 S3 上的分片文件\n 使用 S3 的 multipart upload API 实现流式合并，避免内存问题\n \"\"\"\n file_sha256 = hashlib.sha256()\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n\n async with self.session.client(\n 's3',\n endpoint_url=self.endpoint_url,\n aws_session_token=self.aws_session_token,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n # 创建 multipart upload\n mpu = await s3.create_multipart_upload(\n Bucket=self.bucket_name,\n Key=save_path,\n ContentType='application/octet-stream'\n )\n mpu_id = mpu['UploadId']\n parts = []\n\n try:\n # 按顺序读取、验证并上传每个分片\n for i in range(chunk_info.total_chunks):\n chunk_key = f\"{chunk_dir}/{i}.part\"\n chunk_record = await UploadChunk.filter(upload_id=upload_id, chunk_index=i).first()\n if not chunk_record:\n raise ValueError(f\"分片{i}记录不存在\")\n\n try:\n response = await s3.get_object(\n Bucket=self.bucket_name,\n Key=chunk_key\n )\n chunk_data = await response['Body'].read()\n except Exception as e:\n raise ValueError(f\"分片{i}文件不存在: {e}\")\n\n current_hash = hashlib.sha256(chunk_data).hexdigest()\n if current_hash != chunk_record.chunk_hash:\n raise ValueError(f\"分片{i}哈希不匹配: 期望 {chunk_record.chunk_hash}, 实际 {current_hash}\")\n\n file_sha256.update(chunk_data)\n\n # 上传分片到 multipart upload\n part_response = await s3.upload_part(\n Bucket=self.bucket_name,\n Key=save_path,\n UploadId=mpu_id,\n PartNumber=i + 1, # S3 part numbers start at 1\n Body=chunk_data\n )\n parts.append({\n 'PartNumber': i + 1,\n 'ETag': part_response['ETag']\n })\n\n # 释放内存\n del chunk_data\n\n # 完成 multipart upload\n await s3.complete_multipart_upload(\n Bucket=self.bucket_name,\n Key=save_path,\n UploadId=mpu_id,\n MultipartUpload={'Parts': parts}\n )\n except Exception as e:\n # 出错时取消 multipart upload\n await s3.abort_multipart_upload(\n Bucket=self.bucket_name,\n Key=save_path,\n UploadId=mpu_id\n )\n raise e\n\n return save_path, file_sha256.hexdigest()\n\n async def clean_chunks(self, upload_id: str, save_path: str):\n \"\"\"\n 清理 S3 上的临时分片文件\n :param upload_id: 上传会话ID\n :param save_path: 文件保存路径\n \"\"\"\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n async with self.session.client(\n 's3',\n endpoint_url=self.endpoint_url,\n aws_session_token=self.aws_session_token,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n try:\n # 列出并删除所有分片对象\n paginator = s3.get_paginator('list_objects_v2')\n async for page in paginator.paginate(Bucket=self.bucket_name, Prefix=chunk_dir):\n objects = page.get('Contents', [])\n if objects:\n delete_objects = [{'Key': obj['Key']} for obj in objects]\n await s3.delete_objects(\n Bucket=self.bucket_name,\n Delete={'Objects': delete_objects}\n )\n except Exception as e:\n logger.info(f\"清理 S3 分片数据时出错: {e}\")\n\n async def generate_presigned_upload_url(self, save_path: str, expires_in: int = 900) -> Optional[str]:\n \"\"\"\n 生成S3预签名上传URL\n :param save_path: 文件保存路径\n :param expires_in: URL过期时间（秒），默认15分钟\n :return: 预签名PUT URL\n \"\"\"\n async with self.session.client(\n \"s3\",\n endpoint_url=self.endpoint_url,\n aws_session_token=self.aws_session_token,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n return await s3.generate_presigned_url(\n \"put_object\",\n Params={\n \"Bucket\": self.bucket_name,\n \"Key\": save_path,\n },\n ExpiresIn=expires_in,\n )\n\n async def file_exists(self, save_path: str) -> bool:\n \"\"\"\n 检查文件是否存在于S3\n :param save_path: 文件路径\n :return: 文件是否存在\n \"\"\"\n async with self.session.client(\n \"s3\",\n endpoint_url=self.endpoint_url,\n aws_session_token=self.aws_session_token,\n region_name=self.region_name,\n config=Config(signature_version=self.signature_version),\n ) as s3:\n try:\n await s3.head_object(Bucket=self.bucket_name, Key=save_path)\n return True\n except Exception:\n return False\n\n\nclass OneDriveFileStorage(FileStorageInterface):\n def __init__(self):\n try:\n import msal\n from office365.graph_client import GraphClient\n from office365.runtime.client_request_exception import (\n ClientRequestException,\n )\n except ImportError:\n raise ImportError(\"请先安装`msal`和`Office365-REST-Python-Client`\")\n self.msal = msal\n self.domain = settings.onedrive_domain\n self.client_id = settings.onedrive_client_id\n self.username = settings.onedrive_username\n self.password = settings.onedrive_password\n self.proxy = settings.onedrive_proxy\n self._ClientRequestException = ClientRequestException\n\n try:\n client = GraphClient(self.acquire_token_pwd)\n self.root_path = (\n client.me.drive.root.get_by_path(settings.onedrive_root_path)\n .get()\n .execute_query()\n )\n except ClientRequestException as e:\n if e.code == \"itemNotFound\":\n client.me.drive.root.create_folder(settings.onedrive_root_path)\n self.root_path = (\n client.me.drive.root.get_by_path(\n settings.onedrive_root_path)\n .get()\n .execute_query()\n )\n else:\n raise e\n except Exception as e:\n raise Exception(\"OneDrive验证失败，请检查配置是否正确\\n\" + str(e))\n\n def acquire_token_pwd(self):\n authority_url = f\"https://login.microsoftonline.com/{self.domain}\"\n app = self.msal.PublicClientApplication(\n authority=authority_url, client_id=self.client_id\n )\n result = app.acquire_token_by_username_password(\n username=self.username,\n password=self.password,\n scopes=[\"https://graph.microsoft.com/.default\"],\n )\n return result\n\n def _get_path_str(self, path):\n if isinstance(path, str):\n path = path.replace(\"\\\\\", \"/\").replace(\"//\", \"/\").split(\"/\")\n elif isinstance(path, Path):\n path = str(path).replace(\"\\\\\", \"/\").replace(\"//\", \"/\").split(\"/\")\n else:\n raise TypeError(\"path must be str or Path\")\n path[-1] = path[-1].split(\".\")[0]\n return \"/\".join(path)\n\n def _save(self, file, save_path):\n content = file.file.read()\n name = save_path(file.filename)\n path = self._get_path_str(save_path)\n self.root_path.get_by_path(path).upload(name, content).execute_query()\n\n async def save_file(self, file: UploadFile, save_path: str):\n await asyncio.to_thread(self._save, file, save_path)\n\n def _delete(self, save_path):\n path = self._get_path_str(save_path)\n try:\n self.root_path.get_by_path(path).delete_object().execute_query()\n except self._ClientRequestException as e:\n if e.code == \"itemNotFound\":\n pass\n else:\n raise e\n\n async def delete_file(self, file_code: FileCodes):\n await asyncio.to_thread(self._delete, await file_code.get_file_path())\n\n def _convert_link_to_download_link(self, link):\n p1 = re.search(r\"https://(.+)\\.sharepoint\\.com\", link).group(1)\n p2 = re.search(r\"personal/(.+)/\", link).group(1)\n p3 = re.search(rf\"{p2}/(.+)\", link).group(1)\n return f\"https://{p1}.sharepoint.com/personal/{p2}/_layouts/52/download.aspx?share={p3}\"\n\n def _get_file_url(self, save_path, name):\n path = self._get_path_str(save_path)\n remote_file = self.root_path.get_by_path(path + \"/\" + name)\n expiration_datetime = datetime.datetime.now(\n tz=datetime.timezone.utc\n ) + datetime.timedelta(hours=1)\n expiration_datetime = expiration_datetime.strftime(\n \"%Y-%m-%dT%H:%M:%SZ\")\n permission = remote_file.create_link(\n \"view\", \"anonymous\", expiration_datetime=expiration_datetime\n ).execute_query()\n return self._convert_link_to_download_link(permission.link.webUrl)\n\n async def get_file_response(self, file_code: FileCodes):\n try:\n filename = file_code.prefix + file_code.suffix\n link = await asyncio.to_thread(\n self._get_file_url, await file_code.get_file_path(), filename\n )\n \n content_length = None # 初始化为 None，表示未知大小\n \n # 创建ClientSession并复用\n session = aiohttp.ClientSession()\n \n # 尝试发送HEAD请求获取Content-Length\n try:\n async with session.head(link) as resp:\n if resp.status == 200 and 'Content-Length' in resp.headers:\n content_length = int(resp.headers['Content-Length'])\n except Exception:\n # 如果HEAD请求失败，则不提供 Content-Length\n pass\n \n async def stream_generator():\n try:\n async with session.get(link) as resp:\n if resp.status != 200:\n raise HTTPException(\n status_code=resp.status,\n detail=f\"从OneDrive获取文件失败: {resp.status}\"\n )\n chunk_size = 65536\n while True:\n chunk = await resp.content.read(chunk_size)\n if not chunk:\n break\n yield chunk\n finally:\n await session.close()\n \n encoded_filename = quote(filename, safe='')\n headers = {\n \"Content-Disposition\": f\"attachment; filename*=UTF-8''{encoded_filename}\"\n }\n if content_length is not None:\n headers[\"Content-Length\"] = str(content_length)\n return StreamingResponse(\n stream_generator(),\n media_type=\"application/octet-stream\",\n headers=headers\n )\n except HTTPException:\n raise\n except Exception:\n raise HTTPException(status_code=503, detail=\"服务代理下载异常，请稍后再试\")\n\n async def get_file_url(self, file_code: FileCodes):\n if self.proxy:\n return await get_file_url(file_code.code)\n else:\n return await asyncio.to_thread(\n self._get_file_url,\n await file_code.get_file_path(),\n f\"{file_code.prefix}{file_code.suffix}\",\n )\n\n def _save_chunk(self, chunk_path: str, chunk_data: bytes):\n \"\"\"同步保存分片到 OneDrive\"\"\"\n path_parts = chunk_path.replace(\"\\\\\", \"/\").split(\"/\")\n filename = path_parts[-1]\n dir_path = \"/\".join(path_parts[:-1])\n \n # 确保目录存在\n current_folder = self.root_path\n for part in dir_path.split(\"/\"):\n if part:\n try:\n current_folder = current_folder.get_by_path(part).get().execute_query()\n except self._ClientRequestException as e:\n if e.code == \"itemNotFound\":\n current_folder = current_folder.create_folder(part).execute_query()\n else:\n raise e\n \n # 上传分片\n current_folder.upload(filename, chunk_data).execute_query()\n\n async def save_chunk(self, upload_id: str, chunk_index: int, chunk_data: bytes, chunk_hash: str, save_path: str):\n \"\"\"保存分片到 OneDrive\"\"\"\n chunk_path = str(Path(save_path).parent / \"chunks\" / upload_id / f\"{chunk_index}.part\")\n await asyncio.to_thread(self._save_chunk, chunk_path, chunk_data)\n\n def _read_chunk(self, chunk_path: str) -> bytes:\n \"\"\"同步读取分片\"\"\"\n path = self._get_path_str(chunk_path)\n file_obj = self.root_path.get_by_path(path).get().execute_query()\n return file_obj.get_content().execute_query().value\n\n def _upload_merged(self, save_path: str, data: bytes):\n \"\"\"同步上传合并后的文件\"\"\"\n path_parts = save_path.replace(\"\\\\\", \"/\").split(\"/\")\n filename = path_parts[-1]\n dir_path = \"/\".join(path_parts[:-1])\n \n # 确保目录存在\n current_folder = self.root_path\n for part in dir_path.split(\"/\"):\n if part:\n try:\n current_folder = current_folder.get_by_path(part).get().execute_query()\n except self._ClientRequestException as e:\n if e.code == \"itemNotFound\":\n current_folder = current_folder.create_folder(part).execute_query()\n else:\n raise e\n \n current_folder.upload(filename, data).execute_query()\n\n async def merge_chunks(self, upload_id: str, chunk_info: UploadChunk, save_path: str) -> tuple[str, str]:\n \"\"\"合并 OneDrive 上的分片文件，使用临时文件避免内存问题\"\"\"\n file_sha256 = hashlib.sha256()\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n\n # 使用临时文件存储合并数据\n with tempfile.NamedTemporaryFile(delete=False) as temp_file:\n temp_path = temp_file.name\n\n try:\n async with aiofiles.open(temp_path, 'wb') as out_file:\n for i in range(chunk_info.total_chunks):\n chunk_path = f\"{chunk_dir}/{i}.part\"\n chunk_record = await UploadChunk.filter(upload_id=upload_id, chunk_index=i).first()\n if not chunk_record:\n raise ValueError(f\"分片{i}记录不存在\")\n\n try:\n chunk_data = await asyncio.to_thread(self._read_chunk, chunk_path)\n except Exception as e:\n raise ValueError(f\"分片{i}文件不存在: {e}\")\n\n current_hash = hashlib.sha256(chunk_data).hexdigest()\n if current_hash != chunk_record.chunk_hash:\n raise ValueError(f\"分片{i}哈希不匹配: 期望 {chunk_record.chunk_hash}, 实际 {current_hash}\")\n\n file_sha256.update(chunk_data)\n await out_file.write(chunk_data)\n del chunk_data # 释放内存\n\n # 读取临时文件并上传\n async with aiofiles.open(temp_path, 'rb') as f:\n merged_content = await f.read()\n await asyncio.to_thread(self._upload_merged, save_path, merged_content)\n finally:\n # 清理临时文件\n if os.path.exists(temp_path):\n os.unlink(temp_path)\n\n return save_path, file_sha256.hexdigest()\n\n def _delete_chunk_dir(self, chunk_dir: str):\n \"\"\"同步删除分片目录\"\"\"\n try:\n path = self._get_path_str(chunk_dir)\n self.root_path.get_by_path(path).delete_object().execute_query()\n except self._ClientRequestException as e:\n if e.code != \"itemNotFound\":\n raise e\n\n async def clean_chunks(self, upload_id: str, save_path: str):\n \"\"\"清理 OneDrive 上的临时分片文件\"\"\"\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n try:\n await asyncio.to_thread(self._delete_chunk_dir, chunk_dir)\n except Exception as e:\n logger.info(f\"清理 OneDrive 分片时出错: {e}\")\n\n def _file_exists(self, save_path: str) -> bool:\n \"\"\"同步检查文件是否存在\"\"\"\n try:\n path = self._get_path_str(save_path)\n self.root_path.get_by_path(path).get().execute_query()\n return True\n except self._ClientRequestException as e:\n if e.code == \"itemNotFound\":\n return False\n raise e\n\n async def file_exists(self, save_path: str) -> bool:\n \"\"\"\n 检查文件是否存在于OneDrive\n :param save_path: 文件路径\n :return: 文件是否存在\n \"\"\"\n return await asyncio.to_thread(self._file_exists, save_path)\n\n\nclass OpenDALFileStorage(FileStorageInterface):\n def __init__(self):\n try:\n import opendal\n except ImportError:\n raise ImportError('请先安装 `opendal`, 例如: \"pip install opendal\"')\n self.service = settings.opendal_scheme\n service_settings = {}\n for key, value in settings.items():\n if key.startswith(\"opendal_\" + self.service):\n setting_name = key.split(\"_\", 2)[2]\n service_settings[setting_name] = value\n self.operator = opendal.AsyncOperator(\n settings.opendal_scheme, **service_settings\n )\n\n async def save_file(self, file: UploadFile, save_path: str):\n # 使用 asyncio.to_thread 避免阻塞事件循环\n content = await asyncio.to_thread(file.file.read)\n await self.operator.write(save_path, content)\n\n async def delete_file(self, file_code: FileCodes):\n await self.operator.delete(await file_code.get_file_path())\n\n async def get_file_url(self, file_code: FileCodes):\n return await get_file_url(file_code.code)\n\n async def get_file_response(self, file_code: FileCodes):\n try:\n filename = file_code.prefix + file_code.suffix\n content_length = None # 初始化为 None，表示未知大小\n \n # 尝试获取文件大小\n try:\n stat_result = await self.operator.stat(await file_code.get_file_path())\n if hasattr(stat_result, 'content_length') and stat_result.content_length:\n content_length = stat_result.content_length\n elif hasattr(stat_result, 'size') and stat_result.size:\n content_length = stat_result.size\n except Exception:\n # 如果获取大小失败，则不提供 Content-Length\n pass\n \n # 尝试使用流式读取器\n try:\n # OpenDAL 可能提供 reader 方法返回一个异步读取器\n reader = await self.operator.reader(await file_code.get_file_path())\n except AttributeError:\n # 如果 reader 方法不存在，回退到全量读取（兼容旧版本）\n content = await self.operator.read(await file_code.get_file_path())\n encoded_filename = quote(filename, safe='')\n headers = {\n \"Content-Disposition\": f\"attachment; filename*=UTF-8''{encoded_filename}\"\n }\n if content_length is not None:\n headers[\"Content-Length\"] = str(content_length)\n return Response(\n content, headers=headers, media_type=\"application/octet-stream\"\n )\n \n async def stream_generator():\n chunk_size = 65536\n while True:\n chunk = await reader.read(chunk_size)\n if not chunk:\n break\n yield chunk\n \n encoded_filename = quote(filename, safe='')\n headers = {\n \"Content-Disposition\": f\"attachment; filename*=UTF-8''{encoded_filename}\"\n }\n if content_length is not None:\n headers[\"Content-Length\"] = str(content_length)\n return StreamingResponse(\n stream_generator(),\n media_type=\"application/octet-stream\",\n headers=headers\n )\n except Exception as e:\n logger.info(e)\n raise HTTPException(status_code=404, detail=\"文件已过期删除\")\n\n async def save_chunk(self, upload_id: str, chunk_index: int, chunk_data: bytes, chunk_hash: str, save_path: str):\n \"\"\"保存分片到 OpenDAL 存储\"\"\"\n chunk_path = str(Path(save_path).parent / \"chunks\" / upload_id / f\"{chunk_index}.part\")\n await self.operator.write(chunk_path, chunk_data)\n\n async def merge_chunks(self, upload_id: str, chunk_info: UploadChunk, save_path: str) -> tuple[str, str]:\n \"\"\"合并 OpenDAL 存储上的分片文件，使用临时文件避免内存问题\"\"\"\n file_sha256 = hashlib.sha256()\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n\n # 使用临时文件存储合并数据\n with tempfile.NamedTemporaryFile(delete=False) as temp_file:\n temp_path = temp_file.name\n\n try:\n async with aiofiles.open(temp_path, 'wb') as out_file:\n for i in range(chunk_info.total_chunks):\n chunk_path = f\"{chunk_dir}/{i}.part\"\n chunk_record = await UploadChunk.filter(upload_id=upload_id, chunk_index=i).first()\n if not chunk_record:\n raise ValueError(f\"分片{i}记录不存在\")\n\n try:\n chunk_data = await self.operator.read(chunk_path)\n except Exception as e:\n raise ValueError(f\"分片{i}文件不存在: {e}\")\n\n current_hash = hashlib.sha256(chunk_data).hexdigest()\n if current_hash != chunk_record.chunk_hash:\n raise ValueError(f\"分片{i}哈希不匹配: 期望 {chunk_record.chunk_hash}, 实际 {current_hash}\")\n\n file_sha256.update(chunk_data)\n await out_file.write(chunk_data)\n del chunk_data # 释放内存\n\n # 读取临时文件并写入存储\n async with aiofiles.open(temp_path, 'rb') as f:\n merged_content = await f.read()\n await self.operator.write(save_path, merged_content)\n finally:\n # 清理临时文件\n if os.path.exists(temp_path):\n os.unlink(temp_path)\n \n return save_path, file_sha256.hexdigest()\n\n async def clean_chunks(self, upload_id: str, save_path: str):\n \"\"\"清理 OpenDAL 存储上的临时分片文件\"\"\"\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n try:\n # OpenDAL 支持递归删除\n await self.operator.remove_all(chunk_dir)\n except Exception as e:\n logger.info(f\"清理 OpenDAL 分片时出错: {e}\")\n\n async def file_exists(self, save_path: str) -> bool:\n \"\"\"\n 检查文件是否存在于OpenDAL存储\n :param save_path: 文件路径\n :return: 文件是否存在\n \"\"\"\n try:\n await self.operator.stat(save_path)\n return True\n except Exception:\n return False\n\n\nclass WebDAVFileStorage(FileStorageInterface):\n _instance: Optional[\"WebDAVFileStorage\"] = None\n\n def __init__(self):\n if not hasattr(self, \"_initialized\"):\n self.base_url = settings.webdav_url.rstrip(\"/\") + \"/\"\n self.auth = aiohttp.BasicAuth(\n login=settings.webdav_username, password=settings.webdav_password\n )\n self._initialized = True\n\n def _build_url(self, path: str) -> str:\n encoded_path = quote(str(path.replace(\"\\\\\", \"/\").lstrip(\"/\")).lstrip(\"/\"))\n return f\"{self.base_url}{encoded_path}\"\n\n async def _mkdir_p(self, directory_path: str):\n \"\"\"递归创建目录（类似mkdir -p）\"\"\"\n path_obj = Path(unquote(directory_path))\n current_path = \"\"\n\n async with aiohttp.ClientSession(auth=self.auth) as session:\n # 逐级检查目录是否存在\n for part in path_obj.parts:\n current_path = str(Path(current_path) / part)\n url = self._build_url(current_path)\n\n # 检查目录是否存在\n async with session.head(url) as resp:\n if resp.status == 404:\n # 创建目录\n async with session.request(\"MKCOL\", url) as mkcol_resp:\n if mkcol_resp.status not in (200, 201, 409):\n content = await mkcol_resp.text()\n raise HTTPException(\n status_code=mkcol_resp.status,\n detail=f\"目录创建失败: {content[:200]}\",\n )\n\n async def _is_dir_empty(self, dir_path: str) -> bool:\n \"\"\"检查目录是否为空\"\"\"\n url = self._build_url(dir_path)\n\n async with aiohttp.ClientSession(auth=self.auth) as session:\n async with session.request(\"PROPFIND\", url, headers={\"Depth\": \"1\"}) as resp:\n if resp.status != 207: # 207 是 Multi-Status 响应\n return False\n content = await resp.text()\n # 如果只有一个 response（当前目录），说明目录为空\n return content.count(\"\") <= 1\n\n async def _delete_empty_dirs(self, file_path: str, session: aiohttp.ClientSession):\n \"\"\"递归删除空目录\"\"\"\n path_obj = Path(file_path)\n current_path = path_obj.parent\n\n while str(current_path) != \".\":\n if not await self._is_dir_empty(str(current_path)):\n break\n\n url = self._build_url(str(current_path))\n async with session.delete(url) as resp:\n if resp.status not in (200, 204, 404):\n break\n\n current_path = current_path.parent\n\n async def save_file(self, file: UploadFile, save_path: str):\n \"\"\"保存文件（自动创建目录，流式上传）\"\"\"\n path_obj = Path(save_path)\n directory_path = str(path_obj.parent)\n # 提取原始文件名并进行清理\n filename = await sanitize_filename(path_obj.name)\n # 构建安全的保存路径\n safe_save_path = str(Path(directory_path) / filename)\n\n try:\n # 先创建目录结构\n await self._mkdir_p(directory_path)\n # 上传文件（流式）\n url = self._build_url(safe_save_path)\n\n async def file_sender():\n \"\"\"流式读取文件内容\"\"\"\n chunk_size = 256 * 1024 # 256KB chunks\n while True:\n chunk = await asyncio.to_thread(file.file.read, chunk_size)\n if not chunk:\n break\n yield chunk\n\n async with aiohttp.ClientSession(auth=self.auth) as session:\n async with session.put(\n url,\n data=file_sender(),\n headers={\"Content-Type\": file.content_type or \"application/octet-stream\"}\n ) as resp:\n if resp.status not in (200, 201, 204):\n content = await resp.text()\n raise HTTPException(\n status_code=resp.status,\n detail=f\"文件上传失败: {content[:200]}\",\n )\n except aiohttp.ClientError as e:\n raise HTTPException(\n status_code=503, detail=f\"WebDAV连接异常: {str(e)}\")\n\n async def delete_file(self, file_code: FileCodes):\n \"\"\"删除WebDAV文件及空目录\"\"\"\n file_path = await file_code.get_file_path()\n url = self._build_url(file_path)\n try:\n async with aiohttp.ClientSession(auth=self.auth) as session:\n # 删除文件\n async with session.delete(url) as resp:\n if resp.status not in (200, 204, 404):\n content = await resp.text()\n raise HTTPException(\n status_code=resp.status,\n detail=f\"WebDAV删除失败: {content[:200]}\",\n )\n\n # 使用同一个 session 删除空目录\n await self._delete_empty_dirs(file_path, session)\n\n except aiohttp.ClientError as e:\n raise HTTPException(\n status_code=503, detail=f\"WebDAV连接异常: {str(e)}\")\n\n async def get_file_url(self, file_code: FileCodes):\n return await get_file_url(file_code.code)\n\n async def get_file_response(self, file_code: FileCodes):\n \"\"\"获取文件响应（代理模式）\"\"\"\n try:\n filename = file_code.prefix + file_code.suffix\n url = self._build_url(await file_code.get_file_path())\n content_length = None # 初始化为 None，表示未知大小\n \n # 创建ClientSession并复用（包含认证头）\n session = aiohttp.ClientSession(headers={\n \"Authorization\": f\"Basic {base64.b64encode(f'{settings.webdav_username}:{settings.webdav_password}'.encode()).decode()}\"\n })\n \n # 尝试发送HEAD请求获取Content-Length\n try:\n async with session.head(url) as resp:\n if resp.status == 200 and 'Content-Length' in resp.headers:\n content_length = int(resp.headers['Content-Length'])\n except Exception:\n # 如果HEAD请求失败，则不提供 Content-Length\n pass\n \n async def stream_generator():\n try:\n async with session.get(url) as resp:\n if resp.status != 200:\n raise HTTPException(\n status_code=resp.status,\n detail=f\"文件获取失败{resp.status}: {await resp.text()}\",\n )\n chunk_size = 65536\n while True:\n chunk = await resp.content.read(chunk_size)\n if not chunk:\n break\n yield chunk\n finally:\n await session.close()\n \n encoded_filename = quote(filename, safe='')\n headers = {\n \"Content-Disposition\": f\"attachment; filename*=UTF-8''{encoded_filename}\"\n }\n if content_length is not None:\n headers[\"Content-Length\"] = str(content_length)\n return StreamingResponse(\n stream_generator(),\n media_type=\"application/octet-stream\",\n headers=headers\n )\n except aiohttp.ClientError as e:\n raise HTTPException(\n status_code=503, detail=f\"WebDAV连接异常: {str(e)}\")\n\n async def save_chunk(self, upload_id: str, chunk_index: int, chunk_data: bytes, chunk_hash: str, save_path: str):\n \"\"\"保存分片到 WebDAV\"\"\"\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n chunk_path = f\"{chunk_dir}/{chunk_index}.part\"\n \n # 先创建目录结构\n await self._mkdir_p(chunk_dir)\n \n chunk_url = self._build_url(chunk_path)\n async with aiohttp.ClientSession(auth=self.auth) as session:\n async with session.put(chunk_url, data=chunk_data) as resp:\n if resp.status not in (200, 201, 204):\n content = await resp.text()\n raise HTTPException(\n status_code=resp.status,\n detail=f\"分片上传失败: {content[:200]}\"\n )\n\n async def merge_chunks(self, upload_id: str, chunk_info: UploadChunk, save_path: str) -> tuple[str, str]:\n \"\"\"\n 合并 WebDAV 上的分片文件\n 使用临时文件避免内存问题\n \"\"\"\n file_sha256 = hashlib.sha256()\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n\n # 使用临时文件存储合并数据，避免内存问题\n with tempfile.NamedTemporaryFile(delete=False) as temp_file:\n temp_path = temp_file.name\n\n try:\n async with aiohttp.ClientSession(auth=self.auth) as session:\n # 按顺序读取并验证每个分片，写入临时文件\n async with aiofiles.open(temp_path, 'wb') as out_file:\n for i in range(chunk_info.total_chunks):\n chunk_path = f\"{chunk_dir}/{i}.part\"\n chunk_url = self._build_url(chunk_path)\n\n # 获取分片记录\n chunk_record = await UploadChunk.filter(upload_id=upload_id, chunk_index=i).first()\n if not chunk_record:\n raise ValueError(f\"分片{i}记录不存在\")\n\n # 下载分片数据\n async with session.get(chunk_url) as resp:\n if resp.status != 200:\n raise ValueError(f\"分片{i}文件不存在或无法访问\")\n chunk_data = await resp.read()\n\n # 验证哈希\n current_hash = hashlib.sha256(chunk_data).hexdigest()\n if current_hash != chunk_record.chunk_hash:\n raise ValueError(f\"分片{i}哈希不匹配: 期望 {chunk_record.chunk_hash}, 实际 {current_hash}\")\n\n file_sha256.update(chunk_data)\n await out_file.write(chunk_data)\n del chunk_data # 释放内存\n\n # 确保目标目录存在\n output_dir = str(Path(save_path).parent)\n await self._mkdir_p(output_dir)\n\n # 流式上传合并后的文件\n output_url = self._build_url(save_path)\n\n async def file_sender():\n async with aiofiles.open(temp_path, 'rb') as f:\n while True:\n chunk = await f.read(256 * 1024)\n if not chunk:\n break\n yield chunk\n\n async with session.put(output_url, data=file_sender()) as resp:\n if resp.status not in (200, 201, 204):\n content = await resp.text()\n raise HTTPException(\n status_code=resp.status,\n detail=f\"合并文件上传失败: {content[:200]}\"\n )\n finally:\n # 清理临时文件\n if os.path.exists(temp_path):\n os.unlink(temp_path)\n\n return save_path, file_sha256.hexdigest()\n\n async def clean_chunks(self, upload_id: str, save_path: str):\n \"\"\"\n 清理 WebDAV 上的临时分片文件\n :param upload_id: 上传会话ID\n :param save_path: 文件保存路径\n \"\"\"\n chunk_dir = str(Path(save_path).parent / \"chunks\" / upload_id)\n chunk_dir_url = self._build_url(chunk_dir)\n async with aiohttp.ClientSession(auth=self.auth) as session:\n try:\n # 检查分片目录是否存在\n async with session.request(\"PROPFIND\", chunk_dir_url, headers={\"Depth\": \"1\"}) as resp:\n if resp.status == 207: # 207 表示 Multi-Status\n # 获取目录下的所有分片文件\n xml_data = await resp.text()\n file_paths = re.findall(\n r'(.*?)', xml_data)\n for file_path in file_paths:\n if file_path.endswith(\".part\"):\n # 删除分片文件\n file_url = self._build_url(file_path)\n async with session.delete(file_url) as delete_resp:\n if delete_resp.status not in (200, 204, 404):\n logger.info(f\"删除分片文件失败: {file_path}\")\n\n # 删除分片目录\n async with session.delete(chunk_dir_url) as delete_resp:\n if delete_resp.status not in (200, 204, 404):\n logger.info(f\"删除分片目录失败: {chunk_dir_url}\")\n else:\n logger.info(f\"分片目录不存在: {chunk_dir_url}\")\n except Exception as e:\n logger.info(f\"清理 WebDAV 分片时出错: {e}\")\n\n async def file_exists(self, save_path: str) -> bool:\n \"\"\"\n 检查文件是否存在于WebDAV\n :param save_path: 文件路径\n :return: 文件是否存在\n \"\"\"\n url = self._build_url(save_path)\n async with aiohttp.ClientSession(auth=self.auth) as session:\n async with session.head(url) as resp:\n return resp.status == 200\n\n\nstorages = {\n \"local\": SystemFileStorage,\n \"s3\": S3FileStorage,\n \"onedrive\": OneDriveFileStorage,\n \"opendal\": OpenDALFileStorage,\n \"webdav\": WebDAVFileStorage,\n}\n" }, { "path": "core/tasks.py", "content": "# @Time : 2023/8/15 22:00\n# @Author : Lan\n# @File : tasks.py\n# @Software: PyCharm\nimport asyncio\nimport datetime\nimport logging\nimport os\n\nfrom tortoise.expressions import Q\n\nfrom apps.base.models import FileCodes, UploadChunk\nfrom apps.base.utils import ip_limit, get_chunk_file_path_name\nfrom core.config import refresh_settings\nfrom core.settings import settings, data_root\nfrom core.storage import FileStorageInterface, storages\nfrom core.utils import get_now\n\n\nasync def delete_expire_files():\n while True:\n try:\n await refresh_settings()\n file_storage: FileStorageInterface = storages[settings.file_storage]()\n # 遍历 share目录下的所有文件夹，删除空的文件夹，并判断父目录是否为空，如果为空也删除\n if settings.file_storage == \"local\":\n for root, dirs, files in os.walk(f\"{data_root}/share/data\"):\n if not dirs and not files:\n os.rmdir(root)\n await ip_limit[\"error\"].remove_expired_ip()\n await ip_limit[\"upload\"].remove_expired_ip()\n expire_data = await FileCodes.filter(\n Q(expired_at__lt=await get_now()) | Q(expired_count=0)\n ).all()\n for exp in expire_data:\n try:\n await file_storage.delete_file(exp)\n except Exception as e:\n logging.error(f\"删除过期文件失败 code={exp.code}: {e}\")\n try:\n await exp.delete()\n except Exception as e:\n logging.error(f\"删除记录失败 code={exp.code}: {e}\")\n except Exception as e:\n logging.error(e)\n finally:\n await asyncio.sleep(600)\n\n\nasync def clean_incomplete_uploads():\n while True:\n try:\n await refresh_settings()\n file_storage: FileStorageInterface = storages[settings.file_storage]()\n expire_hours = getattr(settings, \"chunk_expire_hours\", 24)\n now = await get_now()\n expire_time = now - datetime.timedelta(hours=expire_hours)\n expired_sessions = await UploadChunk.filter(\n chunk_index=-1, created_at__lt=expire_time\n ).all()\n\n for session in expired_sessions:\n try:\n save_path = session.save_path\n if not save_path:\n _, _, _, _, save_path = await get_chunk_file_path_name(\n session.file_name, session.upload_id\n )\n await file_storage.clean_chunks(session.upload_id, save_path)\n except Exception as e:\n logging.error(\n f\"清理分片文件失败 upload_id={session.upload_id}: {e}\"\n )\n\n try:\n await UploadChunk.filter(upload_id=session.upload_id).delete()\n logging.info(f\"已清理过期上传会话 upload_id={session.upload_id}\")\n except Exception as e:\n logging.error(\n f\"删除分片记录失败 upload_id={session.upload_id}: {e}\"\n )\n\n except Exception as e:\n logging.error(f\"清理未完成上传任务异常: {e}\")\n finally:\n await asyncio.sleep(3600)\n" }, { "path": "core/utils.py", "content": "# @Time : 2023/8/13 19:54\n# @Author : Lan\n# @File : utils.py\n# @Software: PyCharm\nimport datetime\nimport hashlib\nimport os\nimport random\nimport re\nimport string\nimport time\n\nfrom core.settings import settings\n\n\nasync def get_random_num():\n \"\"\"\n 获取随机数\n :return:\n \"\"\"\n return random.randint(10000, 99999)\n\n\nr_s = string.ascii_uppercase + string.digits\n\n\nasync def get_random_string():\n \"\"\"\n 获取随机字符串\n :return:\n \"\"\"\n return \"\".join(random.choice(r_s) for _ in range(5))\n\n\nasync def get_now():\n \"\"\"\n 获取当前时间\n :return:\n \"\"\"\n return datetime.datetime.now(datetime.timezone(datetime.timedelta(hours=8)))\n\n\nasync def get_select_token(code: str):\n \"\"\"\n 获取下载token\n :param code:\n :return:\n \"\"\"\n token = settings.admin_token\n return hashlib.sha256(\n f\"{code}{int(time.time() / 1000)}000{token}\".encode()\n ).hexdigest()\n\n\nasync def get_file_url(code: str):\n \"\"\"\n 对于需要通过服务器中转下载的服务，获取文件下载地址\n :param code:\n :return:\n \"\"\"\n return f\"/share/download?key={await get_select_token(code)}&code={code}\"\n\n\nasync def max_save_times_desc(max_save_seconds: int):\n \"\"\"\n 获取最大保存时间的描述\n :param max_save_seconds:\n :return:\n \"\"\"\n\n def gen_desc_zh(value: int, desc: str):\n if value > 0:\n return f\"{value}{desc}\"\n else:\n return \"\"\n\n def gen_desc_en(value: int, desc: str):\n if value > 0:\n ret = f\"{value} {desc}\"\n if value > 1:\n ret += \"s\"\n ret += \" \"\n return ret\n else:\n return \"\"\n\n max_timedelta = datetime.timedelta(seconds=max_save_seconds)\n desc_zh, desc_en = \"最长保存时间：\", \"Max save time: \"\n desc_zh += gen_desc_zh(max_timedelta.days, \"天\")\n desc_en += gen_desc_en(max_timedelta.days, \"day\")\n desc_zh += gen_desc_zh(max_timedelta.seconds // 3600, \"小时\")\n desc_en += gen_desc_en(max_timedelta.seconds // 3600, \"hour\")\n desc_zh += gen_desc_zh(max_timedelta.seconds % 3600 // 60, \"分钟\")\n desc_en += gen_desc_en(max_timedelta.seconds % 3600 // 60, \"minute\")\n desc_zh += gen_desc_zh(max_timedelta.seconds % 60, \"秒\")\n desc_en += gen_desc_en(max_timedelta.seconds % 60, \"second\")\n return desc_zh, desc_en\n\n\ndef hash_password(password: str) -> str:\n \"\"\"\n 使用 SHA256 + salt 哈希密码\n 返回格式: sha256$$\n \"\"\"\n salt = os.urandom(16).hex()\n password_hash = hashlib.sha256(f\"{salt}{password}\".encode()).hexdigest()\n return f\"sha256${salt}${password_hash}\"\n\n\ndef verify_password(password: str, hashed: str) -> bool:\n \"\"\"\n 验证密码是否匹配\n 支持新格式 (sha256$salt$hash) 和旧格式 (明文)\n \"\"\"\n if not hashed:\n return False\n\n # 新格式: sha256$salt$hash\n if hashed.startswith(\"sha256$\"):\n parts = hashed.split(\"$\")\n if len(parts) != 3:\n return False\n _, salt, stored_hash = parts\n password_hash = hashlib.sha256(f\"{salt}{password}\".encode()).hexdigest()\n return password_hash == stored_hash\n\n # 旧格式: 明文比较 (兼容迁移前的数据)\n return password == hashed\n\n\ndef is_password_hashed(password: str) -> bool:\n \"\"\"\n 检查密码是否已经是哈希格式\n \"\"\"\n return password.startswith(\"sha256$\") and len(password.split(\"$\")) == 3\n\n\nasync def sanitize_filename(filename: str) -> str:\n \"\"\"\n 安全处理文件名：\n 1. 剥离路径只保留文件名\n 2. 替换非法字符\n 3. 处理空文件名情况\n \"\"\"\n filename = os.path.basename(filename)\n illegal_chars = r'[\\\\/*?:\"<>|\\x00-\\x1F]' # 包含控制字符\n # 替换非法字符为下划线\n cleaned = re.sub(illegal_chars, \"_\", filename)\n # 处理空格（可选替换为_）\n cleaned = cleaned.replace(\" \", \"_\")\n # 处理连续下划线\n cleaned = re.sub(r\"_+\", \"_\", cleaned)\n # 处理首尾特殊字符\n cleaned = cleaned.strip(\"._\")\n # 处理空文件名情况\n if not cleaned:\n cleaned = \"unnamed_file\"\n # 长度限制（按需调整）\n return cleaned[:255]\n" }, { "path": "docker-compose.yml", "content": "version: \"3\"\nservices:\n file-code-box:\n image: lanol/filecodebox:latest\n volumes:\n - fcb-data:/app/data:rw\n restart: unless-stopped\n ports:\n - \"12345:12345\"\nvolumes:\n fcb-data:\n external: false" }, { "path": "docs/.vitepress/cache/deps/_metadata.json", "content": "{\n \"hash\": \"8f855eaf\",\n \"configHash\": \"1b3ca22f\",\n \"lockfileHash\": \"bd28b2c2\",\n \"browserHash\": \"29e84937\",\n \"optimized\": {\n \"vue\": {\n \"src\": \"../../../node_modules/.pnpm/vue@3.5.13/node_modules/vue/dist/vue.runtime.esm-bundler.js\",\n \"file\": \"vue.js\",\n \"fileHash\": \"3215885f\",\n \"needsInterop\": false\n },\n \"vitepress > @vue/devtools-api\": {\n \"src\": \"../../../node_modules/.pnpm/@vue+devtools-api@7.7.1/node_modules/@vue/devtools-api/dist/index.js\",\n \"file\": \"vitepress___@vue_devtools-api.js\",\n \"fileHash\": \"5a5f95ef\",\n \"needsInterop\": false\n },\n \"vitepress > @vueuse/core\": {\n \"src\": \"../../../node_modules/.pnpm/@vueuse+core@12.5.0/node_modules/@vueuse/core/index.mjs\",\n \"file\": \"vitepress___@vueuse_core.js\",\n \"fileHash\": \"0fbf66f0\",\n \"needsInterop\": false\n },\n \"vitepress > @vueuse/integrations/useFocusTrap\": {\n \"src\": \"../../../node_modules/.pnpm/@vueuse+integrations@12.5.0_focus-trap@7.6.4/node_modules/@vueuse/integrations/useFocusTrap.mjs\",\n \"file\": \"vitepress___@vueuse_integrations_useFocusTrap.js\",\n \"fileHash\": \"91b03896\",\n \"needsInterop\": false\n },\n \"vitepress > mark.js/src/vanilla.js\": {\n \"src\": \"../../../node_modules/.pnpm/mark.js@8.11.1/node_modules/mark.js/src/vanilla.js\",\n \"file\": \"vitepress___mark__js_src_vanilla__js.js\",\n \"fileHash\": \"99e4f81c\",\n \"needsInterop\": false\n },\n \"vitepress > minisearch\": {\n \"src\": \"../../../node_modules/.pnpm/minisearch@7.1.1/node_modules/minisearch/dist/es/index.js\",\n \"file\": \"vitepress___minisearch.js\",\n \"fileHash\": \"cc176c9c\",\n \"needsInterop\": false\n }\n },\n \"chunks\": {\n \"chunk-KT7LHMJ2\": {\n \"file\": \"chunk-KT7LHMJ2.js\"\n },\n \"chunk-CQOUZRMK\": {\n \"file\": \"chunk-CQOUZRMK.js\"\n }\n }\n}" }, { "path": "docs/.vitepress/cache/deps/chunk-CQOUZRMK.js", "content": "// node_modules/.pnpm/@vue+shared@3.5.13/node_modules/@vue/shared/dist/shared.esm-bundler.js\nfunction makeMap(str) {\n const map2 = /* @__PURE__ */ Object.create(null);\n for (const key of str.split(\",\")) map2[key] = 1;\n return (val) => val in map2;\n}\nvar EMPTY_OBJ = true ? Object.freeze({}) : {};\nvar EMPTY_ARR = true ? Object.freeze([]) : [];\nvar NOOP = () => {\n};\nvar NO = () => false;\nvar isOn = (key) => key.charCodeAt(0) === 111 && key.charCodeAt(1) === 110 && // uppercase letter\n(key.charCodeAt(2) > 122 || key.charCodeAt(2) < 97);\nvar isModelListener = (key) => key.startsWith(\"onUpdate:\");\nvar extend = Object.assign;\nvar remove = (arr, el) => {\n const i = arr.indexOf(el);\n if (i > -1) {\n arr.splice(i, 1);\n }\n};\nvar hasOwnProperty = Object.prototype.hasOwnProperty;\nvar hasOwn = (val, key) => hasOwnProperty.call(val, key);\nvar isArray = Array.isArray;\nvar isMap = (val) => toTypeString(val) === \"[object Map]\";\nvar isSet = (val) => toTypeString(val) === \"[object Set]\";\nvar isDate = (val) => toTypeString(val) === \"[object Date]\";\nvar isRegExp = (val) => toTypeString(val) === \"[object RegExp]\";\nvar isFunction = (val) => typeof val === \"function\";\nvar isString = (val) => typeof val === \"string\";\nvar isSymbol = (val) => typeof val === \"symbol\";\nvar isObject = (val) => val !== null && typeof val === \"object\";\nvar isPromise = (val) => {\n return (isObject(val) || isFunction(val)) && isFunction(val.then) && isFunction(val.catch);\n};\nvar objectToString = Object.prototype.toString;\nvar toTypeString = (value) => objectToString.call(value);\nvar toRawType = (value) => {\n return toTypeString(value).slice(8, -1);\n};\nvar isPlainObject = (val) => toTypeString(val) === \"[object Object]\";\nvar isIntegerKey = (key) => isString(key) && key !== \"NaN\" && key[0] !== \"-\" && \"\" + parseInt(key, 10) === key;\nvar isReservedProp = makeMap(\n // the leading comma is intentional so empty string \"\" is also included\n \",key,ref,ref_for,ref_key,onVnodeBeforeMount,onVnodeMounted,onVnodeBeforeUpdate,onVnodeUpdated,onVnodeBeforeUnmount,onVnodeUnmounted\"\n);\nvar isBuiltInDirective = makeMap(\n \"bind,cloak,else-if,else,for,html,if,model,on,once,pre,show,slot,text,memo\"\n);\nvar cacheStringFunction = (fn) => {\n const cache = /* @__PURE__ */ Object.create(null);\n return (str) => {\n const hit = cache[str];\n return hit || (cache[str] = fn(str));\n };\n};\nvar camelizeRE = /-(\\w)/g;\nvar camelize = cacheStringFunction(\n (str) => {\n return str.replace(camelizeRE, (_, c) => c ? c.toUpperCase() : \"\");\n }\n);\nvar hyphenateRE = /\\B([A-Z])/g;\nvar hyphenate = cacheStringFunction(\n (str) => str.replace(hyphenateRE, \"-$1\").toLowerCase()\n);\nvar capitalize = cacheStringFunction((str) => {\n return str.charAt(0).toUpperCase() + str.slice(1);\n});\nvar toHandlerKey = cacheStringFunction(\n (str) => {\n const s = str ? `on${capitalize(str)}` : ``;\n return s;\n }\n);\nvar hasChanged = (value, oldValue) => !Object.is(value, oldValue);\nvar invokeArrayFns = (fns, ...arg) => {\n for (let i = 0; i < fns.length; i++) {\n fns[i](...arg);\n }\n};\nvar def = (obj, key, value, writable = false) => {\n Object.defineProperty(obj, key, {\n configurable: true,\n enumerable: false,\n writable,\n value\n });\n};\nvar looseToNumber = (val) => {\n const n = parseFloat(val);\n return isNaN(n) ? val : n;\n};\nvar toNumber = (val) => {\n const n = isString(val) ? Number(val) : NaN;\n return isNaN(n) ? val : n;\n};\nvar _globalThis;\nvar getGlobalThis = () => {\n return _globalThis || (_globalThis = typeof globalThis !== \"undefined\" ? globalThis : typeof self !== \"undefined\" ? self : typeof window !== \"undefined\" ? window : typeof global !== \"undefined\" ? global : {});\n};\nvar GLOBALS_ALLOWED = \"Infinity,undefined,NaN,isFinite,isNaN,parseFloat,parseInt,decodeURI,decodeURIComponent,encodeURI,encodeURIComponent,Math,Number,Date,Array,Object,Boolean,String,RegExp,Map,Set,JSON,Intl,BigInt,console,Error,Symbol\";\nvar isGloballyAllowed = makeMap(GLOBALS_ALLOWED);\nfunction normalizeStyle(value) {\n if (isArray(value)) {\n const res = {};\n for (let i = 0; i < value.length; i++) {\n const item = value[i];\n const normalized = isString(item) ? parseStringStyle(item) : normalizeStyle(item);\n if (normalized) {\n for (const key in normalized) {\n res[key] = normalized[key];\n }\n }\n }\n return res;\n } else if (isString(value) || isObject(value)) {\n return value;\n }\n}\nvar listDelimiterRE = /;(?![^(]*\\))/g;\nvar propertyDelimiterRE = /:([^]+)/;\nvar styleCommentRE = /\\/\\*[^]*?\\*\\//g;\nfunction parseStringStyle(cssText) {\n const ret = {};\n cssText.replace(styleCommentRE, \"\").split(listDelimiterRE).forEach((item) => {\n if (item) {\n const tmp = item.split(propertyDelimiterRE);\n tmp.length > 1 && (ret[tmp[0].trim()] = tmp[1].trim());\n }\n });\n return ret;\n}\nfunction stringifyStyle(styles) {\n if (!styles) return \"\";\n if (isString(styles)) return styles;\n let ret = \"\";\n for (const key in styles) {\n const value = styles[key];\n if (isString(value) || typeof value === \"number\") {\n const normalizedKey = key.startsWith(`--`) ? key : hyphenate(key);\n ret += `${normalizedKey}:${value};`;\n }\n }\n return ret;\n}\nfunction normalizeClass(value) {\n let res = \"\";\n if (isString(value)) {\n res = value;\n } else if (isArray(value)) {\n for (let i = 0; i < value.length; i++) {\n const normalized = normalizeClass(value[i]);\n if (normalized) {\n res += normalized + \" \";\n }\n }\n } else if (isObject(value)) {\n for (const name in value) {\n if (value[name]) {\n res += name + \" \";\n }\n }\n }\n return res.trim();\n}\nfunction normalizeProps(props) {\n if (!props) return null;\n let { class: klass, style } = props;\n if (klass && !isString(klass)) {\n props.class = normalizeClass(klass);\n }\n if (style) {\n props.style = normalizeStyle(style);\n }\n return props;\n}\nvar HTML_TAGS = \"html,body,base,head,link,meta,style,title,address,article,aside,footer,header,hgroup,h1,h2,h3,h4,h5,h6,nav,section,div,dd,dl,dt,figcaption,figure,picture,hr,img,li,main,ol,p,pre,ul,a,b,abbr,bdi,bdo,br,cite,code,data,dfn,em,i,kbd,mark,q,rp,rt,ruby,s,samp,small,span,strong,sub,sup,time,u,var,wbr,area,audio,map,track,video,embed,object,param,source,canvas,script,noscript,del,ins,caption,col,colgroup,table,thead,tbody,td,th,tr,button,datalist,fieldset,form,input,label,legend,meter,optgroup,option,output,progress,select,textarea,details,dialog,menu,summary,template,blockquote,iframe,tfoot\";\nvar SVG_TAGS = \"svg,animate,animateMotion,animateTransform,circle,clipPath,color-profile,defs,desc,discard,ellipse,feBlend,feColorMatrix,feComponentTransfer,feComposite,feConvolveMatrix,feDiffuseLighting,feDisplacementMap,feDistantLight,feDropShadow,feFlood,feFuncA,feFuncB,feFuncG,feFuncR,feGaussianBlur,feImage,feMerge,feMergeNode,feMorphology,feOffset,fePointLight,feSpecularLighting,feSpotLight,feTile,feTurbulence,filter,foreignObject,g,hatch,hatchpath,image,line,linearGradient,marker,mask,mesh,meshgradient,meshpatch,meshrow,metadata,mpath,path,pattern,polygon,polyline,radialGradient,rect,set,solidcolor,stop,switch,symbol,text,textPath,title,tspan,unknown,use,view\";\nvar MATH_TAGS = \"annotation,annotation-xml,maction,maligngroup,malignmark,math,menclose,merror,mfenced,mfrac,mfraction,mglyph,mi,mlabeledtr,mlongdiv,mmultiscripts,mn,mo,mover,mpadded,mphantom,mprescripts,mroot,mrow,ms,mscarries,mscarry,msgroup,msline,mspace,msqrt,msrow,mstack,mstyle,msub,msubsup,msup,mtable,mtd,mtext,mtr,munder,munderover,none,semantics\";\nvar VOID_TAGS = \"area,base,br,col,embed,hr,img,input,link,meta,param,source,track,wbr\";\nvar isHTMLTag = makeMap(HTML_TAGS);\nvar isSVGTag = makeMap(SVG_TAGS);\nvar isMathMLTag = makeMap(MATH_TAGS);\nvar isVoidTag = makeMap(VOID_TAGS);\nvar specialBooleanAttrs = `itemscope,allowfullscreen,formnovalidate,ismap,nomodule,novalidate,readonly`;\nvar isSpecialBooleanAttr = makeMap(specialBooleanAttrs);\nvar isBooleanAttr = makeMap(\n specialBooleanAttrs + `,async,autofocus,autoplay,controls,default,defer,disabled,hidden,inert,loop,open,required,reversed,scoped,seamless,checked,muted,multiple,selected`\n);\nfunction includeBooleanAttr(value) {\n return !!value || value === \"\";\n}\nvar isKnownHtmlAttr = makeMap(\n `accept,accept-charset,accesskey,action,align,allow,alt,async,autocapitalize,autocomplete,autofocus,autoplay,background,bgcolor,border,buffered,capture,challenge,charset,checked,cite,class,code,codebase,color,cols,colspan,content,contenteditable,contextmenu,controls,coords,crossorigin,csp,data,datetime,decoding,default,defer,dir,dirname,disabled,download,draggable,dropzone,enctype,enterkeyhint,for,form,formaction,formenctype,formmethod,formnovalidate,formtarget,headers,height,hidden,high,href,hreflang,http-equiv,icon,id,importance,inert,integrity,ismap,itemprop,keytype,kind,label,lang,language,loading,list,loop,low,manifest,max,maxlength,minlength,media,min,multiple,muted,name,novalidate,open,optimum,pattern,ping,placeholder,poster,preload,radiogroup,readonly,referrerpolicy,rel,required,reversed,rows,rowspan,sandbox,scope,scoped,selected,shape,size,sizes,slot,span,spellcheck,src,srcdoc,srclang,srcset,start,step,style,summary,tabindex,target,title,translate,type,usemap,value,width,wrap`\n);\nvar isKnownSvgAttr = makeMap(\n `xmlns,accent-height,accumulate,additive,alignment-baseline,alphabetic,amplitude,arabic-form,ascent,attributeName,attributeType,azimuth,baseFrequency,baseline-shift,baseProfile,bbox,begin,bias,by,calcMode,cap-height,class,clip,clipPathUnits,clip-path,clip-rule,color,color-interpolation,color-interpolation-filters,color-profile,color-rendering,contentScriptType,contentStyleType,crossorigin,cursor,cx,cy,d,decelerate,descent,diffuseConstant,direction,display,divisor,dominant-baseline,dur,dx,dy,edgeMode,elevation,enable-background,end,exponent,fill,fill-opacity,fill-rule,filter,filterRes,filterUnits,flood-color,flood-opacity,font-family,font-size,font-size-adjust,font-stretch,font-style,font-variant,font-weight,format,from,fr,fx,fy,g1,g2,glyph-name,glyph-orientation-horizontal,glyph-orientation-vertical,glyphRef,gradientTransform,gradientUnits,hanging,height,href,hreflang,horiz-adv-x,horiz-origin-x,id,ideographic,image-rendering,in,in2,intercept,k,k1,k2,k3,k4,kernelMatrix,kernelUnitLength,kerning,keyPoints,keySplines,keyTimes,lang,lengthAdjust,letter-spacing,lighting-color,limitingConeAngle,local,marker-end,marker-mid,marker-start,markerHeight,markerUnits,markerWidth,mask,maskContentUnits,maskUnits,mathematical,max,media,method,min,mode,name,numOctaves,offset,opacity,operator,order,orient,orientation,origin,overflow,overline-position,overline-thickness,panose-1,paint-order,path,pathLength,patternContentUnits,patternTransform,patternUnits,ping,pointer-events,points,pointsAtX,pointsAtY,pointsAtZ,preserveAlpha,preserveAspectRatio,primitiveUnits,r,radius,referrerPolicy,refX,refY,rel,rendering-intent,repeatCount,repeatDur,requiredExtensions,requiredFeatures,restart,result,rotate,rx,ry,scale,seed,shape-rendering,slope,spacing,specularConstant,specularExponent,speed,spreadMethod,startOffset,stdDeviation,stemh,stemv,stitchTiles,stop-color,stop-opacity,strikethrough-position,strikethrough-thickness,string,stroke,stroke-dasharray,stroke-dashoffset,stroke-linecap,stroke-linejoin,stroke-miterlimit,stroke-opacity,stroke-width,style,surfaceScale,systemLanguage,tabindex,tableValues,target,targetX,targetY,text-anchor,text-decoration,text-rendering,textLength,to,transform,transform-origin,type,u1,u2,underline-position,underline-thickness,unicode,unicode-bidi,unicode-range,units-per-em,v-alphabetic,v-hanging,v-ideographic,v-mathematical,values,vector-effect,version,vert-adv-y,vert-origin-x,vert-origin-y,viewBox,viewTarget,visibility,width,widths,word-spacing,writing-mode,x,x-height,x1,x2,xChannelSelector,xlink:actuate,xlink:arcrole,xlink:href,xlink:role,xlink:show,xlink:title,xlink:type,xmlns:xlink,xml:base,xml:lang,xml:space,y,y1,y2,yChannelSelector,z,zoomAndPan`\n);\nvar isKnownMathMLAttr = makeMap(\n `accent,accentunder,actiontype,align,alignmentscope,altimg,altimg-height,altimg-valign,altimg-width,alttext,bevelled,close,columnsalign,columnlines,columnspan,denomalign,depth,dir,display,displaystyle,encoding,equalcolumns,equalrows,fence,fontstyle,fontweight,form,frame,framespacing,groupalign,height,href,id,indentalign,indentalignfirst,indentalignlast,indentshift,indentshiftfirst,indentshiftlast,indextype,justify,largetop,largeop,lquote,lspace,mathbackground,mathcolor,mathsize,mathvariant,maxsize,minlabelspacing,mode,other,overflow,position,rowalign,rowlines,rowspan,rquote,rspace,scriptlevel,scriptminsize,scriptsizemultiplier,selection,separator,separators,shift,side,src,stackalign,stretchy,subscriptshift,superscriptshift,symmetric,voffset,width,widths,xlink:href,xlink:show,xlink:type,xmlns`\n);\nfunction isRenderableAttrValue(value) {\n if (value == null) {\n return false;\n }\n const type = typeof value;\n return type === \"string\" || type === \"number\" || type === \"boolean\";\n}\nvar cssVarNameEscapeSymbolsRE = /[ !\"#$%&'()*+,./:;<=>?@[\\\\\\]^`{|}~]/g;\nfunction getEscapedCssVarName(key, doubleEscape) {\n return key.replace(\n cssVarNameEscapeSymbolsRE,\n (s) => doubleEscape ? s === '\"' ? '\\\\\\\\\\\\\"' : `\\\\\\\\${s}` : `\\\\${s}`\n );\n}\nfunction looseCompareArrays(a, b) {\n if (a.length !== b.length) return false;\n let equal = true;\n for (let i = 0; equal && i < a.length; i++) {\n equal = looseEqual(a[i], b[i]);\n }\n return equal;\n}\nfunction looseEqual(a, b) {\n if (a === b) return true;\n let aValidType = isDate(a);\n let bValidType = isDate(b);\n if (aValidType || bValidType) {\n return aValidType && bValidType ? a.getTime() === b.getTime() : false;\n }\n aValidType = isSymbol(a);\n bValidType = isSymbol(b);\n if (aValidType || bValidType) {\n return a === b;\n }\n aValidType = isArray(a);\n bValidType = isArray(b);\n if (aValidType || bValidType) {\n return aValidType && bValidType ? looseCompareArrays(a, b) : false;\n }\n aValidType = isObject(a);\n bValidType = isObject(b);\n if (aValidType || bValidType) {\n if (!aValidType || !bValidType) {\n return false;\n }\n const aKeysCount = Object.keys(a).length;\n const bKeysCount = Object.keys(b).length;\n if (aKeysCount !== bKeysCount) {\n return false;\n }\n for (const key in a) {\n const aHasKey = a.hasOwnProperty(key);\n const bHasKey = b.hasOwnProperty(key);\n if (aHasKey && !bHasKey || !aHasKey && bHasKey || !looseEqual(a[key], b[key])) {\n return false;\n }\n }\n }\n return String(a) === String(b);\n}\nfunction looseIndexOf(arr, val) {\n return arr.findIndex((item) => looseEqual(item, val));\n}\nvar isRef = (val) => {\n return !!(val && val[\"__v_isRef\"] === true);\n};\nvar toDisplayString = (val) => {\n return isString(val) ? val : val == null ? \"\" : isArray(val) || isObject(val) && (val.toString === objectToString || !isFunction(val.toString)) ? isRef(val) ? toDisplayString(val.value) : JSON.stringify(val, replacer, 2) : String(val);\n};\nvar replacer = (_key, val) => {\n if (isRef(val)) {\n return replacer(_key, val.value);\n } else if (isMap(val)) {\n return {\n [`Map(${val.size})`]: [...val.entries()].reduce(\n (entries, [key, val2], i) => {\n entries[stringifySymbol(key, i) + \" =>\"] = val2;\n return entries;\n },\n {}\n )\n };\n } else if (isSet(val)) {\n return {\n [`Set(${val.size})`]: [...val.values()].map((v) => stringifySymbol(v))\n };\n } else if (isSymbol(val)) {\n return stringifySymbol(val);\n } else if (isObject(val) && !isArray(val) && !isPlainObject(val)) {\n return String(val);\n }\n return val;\n};\nvar stringifySymbol = (v, i = \"\") => {\n var _a;\n return (\n // Symbol.description in es2019+ so we need to cast here to pass\n // the lib: es2016 check\n isSymbol(v) ? `Symbol(${(_a = v.description) != null ? _a : i})` : v\n );\n};\n\n// node_modules/.pnpm/@vue+reactivity@3.5.13/node_modules/@vue/reactivity/dist/reactivity.esm-bundler.js\nfunction warn(msg, ...args) {\n console.warn(`[Vue warn] ${msg}`, ...args);\n}\nvar activeEffectScope;\nvar EffectScope = class {\n constructor(detached = false) {\n this.detached = detached;\n this._active = true;\n this.effects = [];\n this.cleanups = [];\n this._isPaused = false;\n this.parent = activeEffectScope;\n if (!detached && activeEffectScope) {\n this.index = (activeEffectScope.scopes || (activeEffectScope.scopes = [])).push(\n this\n ) - 1;\n }\n }\n get active() {\n return this._active;\n }\n pause() {\n if (this._active) {\n this._isPaused = true;\n let i, l;\n if (this.scopes) {\n for (i = 0, l = this.scopes.length; i < l; i++) {\n this.scopes[i].pause();\n }\n }\n for (i = 0, l = this.effects.length; i < l; i++) {\n this.effects[i].pause();\n }\n }\n }\n /**\n * Resumes the effect scope, including all child scopes and effects.\n */\n resume() {\n if (this._active) {\n if (this._isPaused) {\n this._isPaused = false;\n let i, l;\n if (this.scopes) {\n for (i = 0, l = this.scopes.length; i < l; i++) {\n this.scopes[i].resume();\n }\n }\n for (i = 0, l = this.effects.length; i < l; i++) {\n this.effects[i].resume();\n }\n }\n }\n }\n run(fn) {\n if (this._active) {\n const currentEffectScope = activeEffectScope;\n try {\n activeEffectScope = this;\n return fn();\n } finally {\n activeEffectScope = currentEffectScope;\n }\n } else if (true) {\n warn(`cannot run an inactive effect scope.`);\n }\n }\n /**\n * This should only be called on non-detached scopes\n * @internal\n */\n on() {\n activeEffectScope = this;\n }\n /**\n * This should only be called on non-detached scopes\n * @internal\n */\n off() {\n activeEffectScope = this.parent;\n }\n stop(fromParent) {\n if (this._active) {\n this._active = false;\n let i, l;\n for (i = 0, l = this.effects.length; i < l; i++) {\n this.effects[i].stop();\n }\n this.effects.length = 0;\n for (i = 0, l = this.cleanups.length; i < l; i++) {\n this.cleanups[i]();\n }\n this.cleanups.length = 0;\n if (this.scopes) {\n for (i = 0, l = this.scopes.length; i < l; i++) {\n this.scopes[i].stop(true);\n }\n this.scopes.length = 0;\n }\n if (!this.detached && this.parent && !fromParent) {\n const last = this.parent.scopes.pop();\n if (last && last !== this) {\n this.parent.scopes[this.index] = last;\n last.index = this.index;\n }\n }\n this.parent = void 0;\n }\n }\n};\nfunction effectScope(detached) {\n return new EffectScope(detached);\n}\nfunction getCurrentScope() {\n return activeEffectScope;\n}\nfunction onScopeDispose(fn, failSilently = false) {\n if (activeEffectScope) {\n activeEffectScope.cleanups.push(fn);\n } else if (!failSilently) {\n warn(\n `onScopeDispose() is called when there is no active effect scope to be associated with.`\n );\n }\n}\nvar activeSub;\nvar pausedQueueEffects = /* @__PURE__ */ new WeakSet();\nvar ReactiveEffect = class {\n constructor(fn) {\n this.fn = fn;\n this.deps = void 0;\n this.depsTail = void 0;\n this.flags = 1 | 4;\n this.next = void 0;\n this.cleanup = void 0;\n this.scheduler = void 0;\n if (activeEffectScope && activeEffectScope.active) {\n activeEffectScope.effects.push(this);\n }\n }\n pause() {\n this.flags |= 64;\n }\n resume() {\n if (this.flags & 64) {\n this.flags &= ~64;\n if (pausedQueueEffects.has(this)) {\n pausedQueueEffects.delete(this);\n this.trigger();\n }\n }\n }\n /**\n * @internal\n */\n notify() {\n if (this.flags & 2 && !(this.flags & 32)) {\n return;\n }\n if (!(this.flags & 8)) {\n batch(this);\n }\n }\n run() {\n if (!(this.flags & 1)) {\n return this.fn();\n }\n this.flags |= 2;\n cleanupEffect(this);\n prepareDeps(this);\n const prevEffect = activeSub;\n const prevShouldTrack = shouldTrack;\n activeSub = this;\n shouldTrack = true;\n try {\n return this.fn();\n } finally {\n if (activeSub !== this) {\n warn(\n \"Active effect was not restored correctly - this is likely a Vue internal bug.\"\n );\n }\n cleanupDeps(this);\n activeSub = prevEffect;\n shouldTrack = prevShouldTrack;\n this.flags &= ~2;\n }\n }\n stop() {\n if (this.flags & 1) {\n for (let link = this.deps; link; link = link.nextDep) {\n removeSub(link);\n }\n this.deps = this.depsTail = void 0;\n cleanupEffect(this);\n this.onStop && this.onStop();\n this.flags &= ~1;\n }\n }\n trigger() {\n if (this.flags & 64) {\n pausedQueueEffects.add(this);\n } else if (this.scheduler) {\n this.scheduler();\n } else {\n this.runIfDirty();\n }\n }\n /**\n * @internal\n */\n runIfDirty() {\n if (isDirty(this)) {\n this.run();\n }\n }\n get dirty() {\n return isDirty(this);\n }\n};\nvar batchDepth = 0;\nvar batchedSub;\nvar batchedComputed;\nfunction batch(sub, isComputed = false) {\n sub.flags |= 8;\n if (isComputed) {\n sub.next = batchedComputed;\n batchedComputed = sub;\n return;\n }\n sub.next = batchedSub;\n batchedSub = sub;\n}\nfunction startBatch() {\n batchDepth++;\n}\nfunction endBatch() {\n if (--batchDepth > 0) {\n return;\n }\n if (batchedComputed) {\n let e = batchedComputed;\n batchedComputed = void 0;\n while (e) {\n const next = e.next;\n e.next = void 0;\n e.flags &= ~8;\n e = next;\n }\n }\n let error;\n while (batchedSub) {\n let e = batchedSub;\n batchedSub = void 0;\n while (e) {\n const next = e.next;\n e.next = void 0;\n e.flags &= ~8;\n if (e.flags & 1) {\n try {\n ;\n e.trigger();\n } catch (err) {\n if (!error) error = err;\n }\n }\n e = next;\n }\n }\n if (error) throw error;\n}\nfunction prepareDeps(sub) {\n for (let link = sub.deps; link; link = link.nextDep) {\n link.version = -1;\n link.prevActiveLink = link.dep.activeLink;\n link.dep.activeLink = link;\n }\n}\nfunction cleanupDeps(sub) {\n let head;\n let tail = sub.depsTail;\n let link = tail;\n while (link) {\n const prev = link.prevDep;\n if (link.version === -1) {\n if (link === tail) tail = prev;\n removeSub(link);\n removeDep(link);\n } else {\n head = link;\n }\n link.dep.activeLink = link.prevActiveLink;\n link.prevActiveLink = void 0;\n link = prev;\n }\n sub.deps = head;\n sub.depsTail = tail;\n}\nfunction isDirty(sub) {\n for (let link = sub.deps; link; link = link.nextDep) {\n if (link.dep.version !== link.version || link.dep.computed && (refreshComputed(link.dep.computed) || link.dep.version !== link.version)) {\n return true;\n }\n }\n if (sub._dirty) {\n return true;\n }\n return false;\n}\nfunction refreshComputed(computed3) {\n if (computed3.flags & 4 && !(computed3.flags & 16)) {\n return;\n }\n computed3.flags &= ~16;\n if (computed3.globalVersion === globalVersion) {\n return;\n }\n computed3.globalVersion = globalVersion;\n const dep = computed3.dep;\n computed3.flags |= 2;\n if (dep.version > 0 && !computed3.isSSR && computed3.deps && !isDirty(computed3)) {\n computed3.flags &= ~2;\n return;\n }\n const prevSub = activeSub;\n const prevShouldTrack = shouldTrack;\n activeSub = computed3;\n shouldTrack = true;\n try {\n prepareDeps(computed3);\n const value = computed3.fn(computed3._value);\n if (dep.version === 0 || hasChanged(value, computed3._value)) {\n computed3._value = value;\n dep.version++;\n }\n } catch (err) {\n dep.version++;\n throw err;\n } finally {\n activeSub = prevSub;\n shouldTrack = prevShouldTrack;\n cleanupDeps(computed3);\n computed3.flags &= ~2;\n }\n}\nfunction removeSub(link, soft = false) {\n const { dep, prevSub, nextSub } = link;\n if (prevSub) {\n prevSub.nextSub = nextSub;\n link.prevSub = void 0;\n }\n if (nextSub) {\n nextSub.prevSub = prevSub;\n link.nextSub = void 0;\n }\n if (dep.subsHead === link) {\n dep.subsHead = nextSub;\n }\n if (dep.subs === link) {\n dep.subs = prevSub;\n if (!prevSub && dep.computed) {\n dep.computed.flags &= ~4;\n for (let l = dep.computed.deps; l; l = l.nextDep) {\n removeSub(l, true);\n }\n }\n }\n if (!soft && !--dep.sc && dep.map) {\n dep.map.delete(dep.key);\n }\n}\nfunction removeDep(link) {\n const { prevDep, nextDep } = link;\n if (prevDep) {\n prevDep.nextDep = nextDep;\n link.prevDep = void 0;\n }\n if (nextDep) {\n nextDep.prevDep = prevDep;\n link.nextDep = void 0;\n }\n}\nfunction effect(fn, options) {\n if (fn.effect instanceof ReactiveEffect) {\n fn = fn.effect.fn;\n }\n const e = new ReactiveEffect(fn);\n if (options) {\n extend(e, options);\n }\n try {\n e.run();\n } catch (err) {\n e.stop();\n throw err;\n }\n const runner = e.run.bind(e);\n runner.effect = e;\n return runner;\n}\nfunction stop(runner) {\n runner.effect.stop();\n}\nvar shouldTrack = true;\nvar trackStack = [];\nfunction pauseTracking() {\n trackStack.push(shouldTrack);\n shouldTrack = false;\n}\nfunction resetTracking() {\n const last = trackStack.pop();\n shouldTrack = last === void 0 ? true : last;\n}\nfunction cleanupEffect(e) {\n const { cleanup } = e;\n e.cleanup = void 0;\n if (cleanup) {\n const prevSub = activeSub;\n activeSub = void 0;\n try {\n cleanup();\n } finally {\n activeSub = prevSub;\n }\n }\n}\nvar globalVersion = 0;\nvar Link = class {\n constructor(sub, dep) {\n this.sub = sub;\n this.dep = dep;\n this.version = dep.version;\n this.nextDep = this.prevDep = this.nextSub = this.prevSub = this.prevActiveLink = void 0;\n }\n};\nvar Dep = class {\n constructor(computed3) {\n this.computed = computed3;\n this.version = 0;\n this.activeLink = void 0;\n this.subs = void 0;\n this.map = void 0;\n this.key = void 0;\n this.sc = 0;\n if (true) {\n this.subsHead = void 0;\n }\n }\n track(debugInfo) {\n if (!activeSub || !shouldTrack || activeSub === this.computed) {\n return;\n }\n let link = this.activeLink;\n if (link === void 0 || link.sub !== activeSub) {\n link = this.activeLink = new Link(activeSub, this);\n if (!activeSub.deps) {\n activeSub.deps = activeSub.depsTail = link;\n } else {\n link.prevDep = activeSub.depsTail;\n activeSub.depsTail.nextDep = link;\n activeSub.depsTail = link;\n }\n addSub(link);\n } else if (link.version === -1) {\n link.version = this.version;\n if (link.nextDep) {\n const next = link.nextDep;\n next.prevDep = link.prevDep;\n if (link.prevDep) {\n link.prevDep.nextDep = next;\n }\n link.prevDep = activeSub.depsTail;\n link.nextDep = void 0;\n activeSub.depsTail.nextDep = link;\n activeSub.depsTail = link;\n if (activeSub.deps === link) {\n activeSub.deps = next;\n }\n }\n }\n if (activeSub.onTrack) {\n activeSub.onTrack(\n extend(\n {\n effect: activeSub\n },\n debugInfo\n )\n );\n }\n return link;\n }\n trigger(debugInfo) {\n this.version++;\n globalVersion++;\n this.notify(debugInfo);\n }\n notify(debugInfo) {\n startBatch();\n try {\n if (true) {\n for (let head = this.subsHead; head; head = head.nextSub) {\n if (head.sub.onTrigger && !(head.sub.flags & 8)) {\n head.sub.onTrigger(\n extend(\n {\n effect: head.sub\n },\n debugInfo\n )\n );\n }\n }\n }\n for (let link = this.subs; link; link = link.prevSub) {\n if (link.sub.notify()) {\n ;\n link.sub.dep.notify();\n }\n }\n } finally {\n endBatch();\n }\n }\n};\nfunction addSub(link) {\n link.dep.sc++;\n if (link.sub.flags & 4) {\n const computed3 = link.dep.computed;\n if (computed3 && !link.dep.subs) {\n computed3.flags |= 4 | 16;\n for (let l = computed3.deps; l; l = l.nextDep) {\n addSub(l);\n }\n }\n const currentTail = link.dep.subs;\n if (currentTail !== link) {\n link.prevSub = currentTail;\n if (currentTail) currentTail.nextSub = link;\n }\n if (link.dep.subsHead === void 0) {\n link.dep.subsHead = link;\n }\n link.dep.subs = link;\n }\n}\nvar targetMap = /* @__PURE__ */ new WeakMap();\nvar ITERATE_KEY = Symbol(\n true ? \"Object iterate\" : \"\"\n);\nvar MAP_KEY_ITERATE_KEY = Symbol(\n true ? \"Map keys iterate\" : \"\"\n);\nvar ARRAY_ITERATE_KEY = Symbol(\n true ? \"Array iterate\" : \"\"\n);\nfunction track(target, type, key) {\n if (shouldTrack && activeSub) {\n let depsMap = targetMap.get(target);\n if (!depsMap) {\n targetMap.set(target, depsMap = /* @__PURE__ */ new Map());\n }\n let dep = depsMap.get(key);\n if (!dep) {\n depsMap.set(key, dep = new Dep());\n dep.map = depsMap;\n dep.key = key;\n }\n if (true) {\n dep.track({\n target,\n type,\n key\n });\n } else {\n dep.track();\n }\n }\n}\nfunction trigger(target, type, key, newValue, oldValue, oldTarget) {\n const depsMap = targetMap.get(target);\n if (!depsMap) {\n globalVersion++;\n return;\n }\n const run = (dep) => {\n if (dep) {\n if (true) {\n dep.trigger({\n target,\n type,\n key,\n newValue,\n oldValue,\n oldTarget\n });\n } else {\n dep.trigger();\n }\n }\n };\n startBatch();\n if (type === \"clear\") {\n depsMap.forEach(run);\n } else {\n const targetIsArray = isArray(target);\n const isArrayIndex = targetIsArray && isIntegerKey(key);\n if (targetIsArray && key === \"length\") {\n const newLength = Number(newValue);\n depsMap.forEach((dep, key2) => {\n if (key2 === \"length\" || key2 === ARRAY_ITERATE_KEY || !isSymbol(key2) && key2 >= newLength) {\n run(dep);\n }\n });\n } else {\n if (key !== void 0 || depsMap.has(void 0)) {\n run(depsMap.get(key));\n }\n if (isArrayIndex) {\n run(depsMap.get(ARRAY_ITERATE_KEY));\n }\n switch (type) {\n case \"add\":\n if (!targetIsArray) {\n run(depsMap.get(ITERATE_KEY));\n if (isMap(target)) {\n run(depsMap.get(MAP_KEY_ITERATE_KEY));\n }\n } else if (isArrayIndex) {\n run(depsMap.get(\"length\"));\n }\n break;\n case \"delete\":\n if (!targetIsArray) {\n run(depsMap.get(ITERATE_KEY));\n if (isMap(target)) {\n run(depsMap.get(MAP_KEY_ITERATE_KEY));\n }\n }\n break;\n case \"set\":\n if (isMap(target)) {\n run(depsMap.get(ITERATE_KEY));\n }\n break;\n }\n }\n }\n endBatch();\n}\nfunction getDepFromReactive(object, key) {\n const depMap = targetMap.get(object);\n return depMap && depMap.get(key);\n}\nfunction reactiveReadArray(array) {\n const raw = toRaw(array);\n if (raw === array) return raw;\n track(raw, \"iterate\", ARRAY_ITERATE_KEY);\n return isShallow(array) ? raw : raw.map(toReactive);\n}\nfunction shallowReadArray(arr) {\n track(arr = toRaw(arr), \"iterate\", ARRAY_ITERATE_KEY);\n return arr;\n}\nvar arrayInstrumentations = {\n __proto__: null,\n [Symbol.iterator]() {\n return iterator(this, Symbol.iterator, toReactive);\n },\n concat(...args) {\n return reactiveReadArray(this).concat(\n ...args.map((x) => isArray(x) ? reactiveReadArray(x) : x)\n );\n },\n entries() {\n return iterator(this, \"entries\", (value) => {\n value[1] = toReactive(value[1]);\n return value;\n });\n },\n every(fn, thisArg) {\n return apply(this, \"every\", fn, thisArg, void 0, arguments);\n },\n filter(fn, thisArg) {\n return apply(this, \"filter\", fn, thisArg, (v) => v.map(toReactive), arguments);\n },\n find(fn, thisArg) {\n return apply(this, \"find\", fn, thisArg, toReactive, arguments);\n },\n findIndex(fn, thisArg) {\n return apply(this, \"findIndex\", fn, thisArg, void 0, arguments);\n },\n findLast(fn, thisArg) {\n return apply(this, \"findLast\", fn, thisArg, toReactive, arguments);\n },\n findLastIndex(fn, thisArg) {\n return apply(this, \"findLastIndex\", fn, thisArg, void 0, arguments);\n },\n // flat, flatMap could benefit from ARRAY_ITERATE but are not straight-forward to implement\n forEach(fn, thisArg) {\n return apply(this, \"forEach\", fn, thisArg, void 0, arguments);\n },\n includes(...args) {\n return searchProxy(this, \"includes\", args);\n },\n indexOf(...args) {\n return searchProxy(this, \"indexOf\", args);\n },\n join(separator) {\n return reactiveReadArray(this).join(separator);\n },\n // keys() iterator only reads `length`, no optimisation required\n lastIndexOf(...args) {\n return searchProxy(this, \"lastIndexOf\", args);\n },\n map(fn, thisArg) {\n return apply(this, \"map\", fn, thisArg, void 0, arguments);\n },\n pop() {\n return noTracking(this, \"pop\");\n },\n push(...args) {\n return noTracking(this, \"push\", args);\n },\n reduce(fn, ...args) {\n return reduce(this, \"reduce\", fn, args);\n },\n reduceRight(fn, ...args) {\n return reduce(this, \"reduceRight\", fn, args);\n },\n shift() {\n return noTracking(this, \"shift\");\n },\n // slice could use ARRAY_ITERATE but also seems to beg for range tracking\n some(fn, thisArg) {\n return apply(this, \"some\", fn, thisArg, void 0, arguments);\n },\n splice(...args) {\n return noTracking(this, \"splice\", args);\n },\n toReversed() {\n return reactiveReadArray(this).toReversed();\n },\n toSorted(comparer) {\n return reactiveReadArray(this).toSorted(comparer);\n },\n toSpliced(...args) {\n return reactiveReadArray(this).toSpliced(...args);\n },\n unshift(...args) {\n return noTracking(this, \"unshift\", args);\n },\n values() {\n return iterator(this, \"values\", toReactive);\n }\n};\nfunction iterator(self2, method, wrapValue) {\n const arr = shallowReadArray(self2);\n const iter = arr[method]();\n if (arr !== self2 && !isShallow(self2)) {\n iter._next = iter.next;\n iter.next = () => {\n const result = iter._next();\n if (result.value) {\n result.value = wrapValue(result.value);\n }\n return result;\n };\n }\n return iter;\n}\nvar arrayProto = Array.prototype;\nfunction apply(self2, method, fn, thisArg, wrappedRetFn, args) {\n const arr = shallowReadArray(self2);\n const needsWrap = arr !== self2 && !isShallow(self2);\n const methodFn = arr[method];\n if (methodFn !== arrayProto[method]) {\n const result2 = methodFn.apply(self2, args);\n return needsWrap ? toReactive(result2) : result2;\n }\n let wrappedFn = fn;\n if (arr !== self2) {\n if (needsWrap) {\n wrappedFn = function(item, index) {\n return fn.call(this, toReactive(item), index, self2);\n };\n } else if (fn.length > 2) {\n wrappedFn = function(item, index) {\n return fn.call(this, item, index, self2);\n };\n }\n }\n const result = methodFn.call(arr, wrappedFn, thisArg);\n return needsWrap && wrappedRetFn ? wrappedRetFn(result) : result;\n}\nfunction reduce(self2, method, fn, args) {\n const arr = shallowReadArray(self2);\n let wrappedFn = fn;\n if (arr !== self2) {\n if (!isShallow(self2)) {\n wrappedFn = function(acc, item, index) {\n return fn.call(this, acc, toReactive(item), index, self2);\n };\n } else if (fn.length > 3) {\n wrappedFn = function(acc, item, index) {\n return fn.call(this, acc, item, index, self2);\n };\n }\n }\n return arr[method](wrappedFn, ...args);\n}\nfunction searchProxy(self2, method, args) {\n const arr = toRaw(self2);\n track(arr, \"iterate\", ARRAY_ITERATE_KEY);\n const res = arr[method](...args);\n if ((res === -1 || res === false) && isProxy(args[0])) {\n args[0] = toRaw(args[0]);\n return arr[method](...args);\n }\n return res;\n}\nfunction noTracking(self2, method, args = []) {\n pauseTracking();\n startBatch();\n const res = toRaw(self2)[method].apply(self2, args);\n endBatch();\n resetTracking();\n return res;\n}\nvar isNonTrackableKeys = makeMap(`__proto__,__v_isRef,__isVue`);\nvar builtInSymbols = new Set(\n Object.getOwnPropertyNames(Symbol).filter((key) => key !== \"arguments\" && key !== \"caller\").map((key) => Symbol[key]).filter(isSymbol)\n);\nfunction hasOwnProperty2(key) {\n if (!isSymbol(key)) key = String(key);\n const obj = toRaw(this);\n track(obj, \"has\", key);\n return obj.hasOwnProperty(key);\n}\nvar BaseReactiveHandler = class {\n constructor(_isReadonly = false, _isShallow = false) {\n this._isReadonly = _isReadonly;\n this._isShallow = _isShallow;\n }\n get(target, key, receiver) {\n if (key === \"__v_skip\") return target[\"__v_skip\"];\n const isReadonly2 = this._isReadonly, isShallow2 = this._isShallow;\n if (key === \"__v_isReactive\") {\n return !isReadonly2;\n } else if (key === \"__v_isReadonly\") {\n return isReadonly2;\n } else if (key === \"__v_isShallow\") {\n return isShallow2;\n } else if (key === \"__v_raw\") {\n if (receiver === (isReadonly2 ? isShallow2 ? shallowReadonlyMap : readonlyMap : isShallow2 ? shallowReactiveMap : reactiveMap).get(target) || // receiver is not the reactive proxy, but has the same prototype\n // this means the receiver is a user proxy of the reactive proxy\n Object.getPrototypeOf(target) === Object.getPrototypeOf(receiver)) {\n return target;\n }\n return;\n }\n const targetIsArray = isArray(target);\n if (!isReadonly2) {\n let fn;\n if (targetIsArray && (fn = arrayInstrumentations[key])) {\n return fn;\n }\n if (key === \"hasOwnProperty\") {\n return hasOwnProperty2;\n }\n }\n const res = Reflect.get(\n target,\n key,\n // if this is a proxy wrapping a ref, return methods using the raw ref\n // as receiver so that we don't have to call `toRaw` on the ref in all\n // its class methods\n isRef2(target) ? target : receiver\n );\n if (isSymbol(key) ? builtInSymbols.has(key) : isNonTrackableKeys(key)) {\n return res;\n }\n if (!isReadonly2) {\n track(target, \"get\", key);\n }\n if (isShallow2) {\n return res;\n }\n if (isRef2(res)) {\n return targetIsArray && isIntegerKey(key) ? res : res.value;\n }\n if (isObject(res)) {\n return isReadonly2 ? readonly(res) : reactive(res);\n }\n return res;\n }\n};\nvar MutableReactiveHandler = class extends BaseReactiveHandler {\n constructor(isShallow2 = false) {\n super(false, isShallow2);\n }\n set(target, key, value, receiver) {\n let oldValue = target[key];\n if (!this._isShallow) {\n const isOldValueReadonly = isReadonly(oldValue);\n if (!isShallow(value) && !isReadonly(value)) {\n oldValue = toRaw(oldValue);\n value = toRaw(value);\n }\n if (!isArray(target) && isRef2(oldValue) && !isRef2(value)) {\n if (isOldValueReadonly) {\n return false;\n } else {\n oldValue.value = value;\n return true;\n }\n }\n }\n const hadKey = isArray(target) && isIntegerKey(key) ? Number(key) < target.length : hasOwn(target, key);\n const result = Reflect.set(\n target,\n key,\n value,\n isRef2(target) ? target : receiver\n );\n if (target === toRaw(receiver)) {\n if (!hadKey) {\n trigger(target, \"add\", key, value);\n } else if (hasChanged(value, oldValue)) {\n trigger(target, \"set\", key, value, oldValue);\n }\n }\n return result;\n }\n deleteProperty(target, key) {\n const hadKey = hasOwn(target, key);\n const oldValue = target[key];\n const result = Reflect.deleteProperty(target, key);\n if (result && hadKey) {\n trigger(target, \"delete\", key, void 0, oldValue);\n }\n return result;\n }\n has(target, key) {\n const result = Reflect.has(target, key);\n if (!isSymbol(key) || !builtInSymbols.has(key)) {\n track(target, \"has\", key);\n }\n return result;\n }\n ownKeys(target) {\n track(\n target,\n \"iterate\",\n isArray(target) ? \"length\" : ITERATE_KEY\n );\n return Reflect.ownKeys(target);\n }\n};\nvar ReadonlyReactiveHandler = class extends BaseReactiveHandler {\n constructor(isShallow2 = false) {\n super(true, isShallow2);\n }\n set(target, key) {\n if (true) {\n warn(\n `Set operation on key \"${String(key)}\" failed: target is readonly.`,\n target\n );\n }\n return true;\n }\n deleteProperty(target, key) {\n if (true) {\n warn(\n `Delete operation on key \"${String(key)}\" failed: target is readonly.`,\n target\n );\n }\n return true;\n }\n};\nvar mutableHandlers = new MutableReactiveHandler();\nvar readonlyHandlers = new ReadonlyReactiveHandler();\nvar shallowReactiveHandlers = new MutableReactiveHandler(true);\nvar shallowReadonlyHandlers = new ReadonlyReactiveHandler(true);\nvar toShallow = (value) => value;\nvar getProto = (v) => Reflect.getPrototypeOf(v);\nfunction createIterableMethod(method, isReadonly2, isShallow2) {\n return function(...args) {\n const target = this[\"__v_raw\"];\n const rawTarget = toRaw(target);\n const targetIsMap = isMap(rawTarget);\n const isPair = method === \"entries\" || method === Symbol.iterator && targetIsMap;\n const isKeyOnly = method === \"keys\" && targetIsMap;\n const innerIterator = target[method](...args);\n const wrap = isShallow2 ? toShallow : isReadonly2 ? toReadonly : toReactive;\n !isReadonly2 && track(\n rawTarget,\n \"iterate\",\n isKeyOnly ? MAP_KEY_ITERATE_KEY : ITERATE_KEY\n );\n return {\n // iterator protocol\n next() {\n const { value, done } = innerIterator.next();\n return done ? { value, done } : {\n value: isPair ? [wrap(value[0]), wrap(value[1])] : wrap(value),\n done\n };\n },\n // iterable protocol\n [Symbol.iterator]() {\n return this;\n }\n };\n };\n}\nfunction createReadonlyMethod(type) {\n return function(...args) {\n if (true) {\n const key = args[0] ? `on key \"${args[0]}\" ` : ``;\n warn(\n `${capitalize(type)} operation ${key}failed: target is readonly.`,\n toRaw(this)\n );\n }\n return type === \"delete\" ? false : type === \"clear\" ? void 0 : this;\n };\n}\nfunction createInstrumentations(readonly2, shallow) {\n const instrumentations = {\n get(key) {\n const target = this[\"__v_raw\"];\n const rawTarget = toRaw(target);\n const rawKey = toRaw(key);\n if (!readonly2) {\n if (hasChanged(key, rawKey)) {\n track(rawTarget, \"get\", key);\n }\n track(rawTarget, \"get\", rawKey);\n }\n const { has } = getProto(rawTarget);\n const wrap = shallow ? toShallow : readonly2 ? toReadonly : toReactive;\n if (has.call(rawTarget, key)) {\n return wrap(target.get(key));\n } else if (has.call(rawTarget, rawKey)) {\n return wrap(target.get(rawKey));\n } else if (target !== rawTarget) {\n target.get(key);\n }\n },\n get size() {\n const target = this[\"__v_raw\"];\n !readonly2 && track(toRaw(target), \"iterate\", ITERATE_KEY);\n return Reflect.get(target, \"size\", target);\n },\n has(key) {\n const target = this[\"__v_raw\"];\n const rawTarget = toRaw(target);\n const rawKey = toRaw(key);\n if (!readonly2) {\n if (hasChanged(key, rawKey)) {\n track(rawTarget, \"has\", key);\n }\n track(rawTarget, \"has\", rawKey);\n }\n return key === rawKey ? target.has(key) : target.has(key) || target.has(rawKey);\n },\n forEach(callback, thisArg) {\n const observed = this;\n const target = observed[\"__v_raw\"];\n const rawTarget = toRaw(target);\n const wrap = shallow ? toShallow : readonly2 ? toReadonly : toReactive;\n !readonly2 && track(rawTarget, \"iterate\", ITERATE_KEY);\n return target.forEach((value, key) => {\n return callback.call(thisArg, wrap(value), wrap(key), observed);\n });\n }\n };\n extend(\n instrumentations,\n readonly2 ? {\n add: createReadonlyMethod(\"add\"),\n set: createReadonlyMethod(\"set\"),\n delete: createReadonlyMethod(\"delete\"),\n clear: createReadonlyMethod(\"clear\")\n } : {\n add(value) {\n if (!shallow && !isShallow(value) && !isReadonly(value)) {\n value = toRaw(value);\n }\n const target = toRaw(this);\n const proto = getProto(target);\n const hadKey = proto.has.call(target, value);\n if (!hadKey) {\n target.add(value);\n trigger(target, \"add\", value, value);\n }\n return this;\n },\n set(key, value) {\n if (!shallow && !isShallow(value) && !isReadonly(value)) {\n value = toRaw(value);\n }\n const target = toRaw(this);\n const { has, get } = getProto(target);\n let hadKey = has.call(target, key);\n if (!hadKey) {\n key = toRaw(key);\n hadKey = has.call(target, key);\n } else if (true) {\n checkIdentityKeys(target, has, key);\n }\n const oldValue = get.call(target, key);\n target.set(key, value);\n if (!hadKey) {\n trigger(target, \"add\", key, value);\n } else if (hasChanged(value, oldValue)) {\n trigger(target, \"set\", key, value, oldValue);\n }\n return this;\n },\n delete(key) {\n const target = toRaw(this);\n const { has, get } = getProto(target);\n let hadKey = has.call(target, key);\n if (!hadKey) {\n key = toRaw(key);\n hadKey = has.call(target, key);\n } else if (true) {\n checkIdentityKeys(target, has, key);\n }\n const oldValue = get ? get.call(target, key) : void 0;\n const result = target.delete(key);\n if (hadKey) {\n trigger(target, \"delete\", key, void 0, oldValue);\n }\n return result;\n },\n clear() {\n const target = toRaw(this);\n const hadItems = target.size !== 0;\n const oldTarget = true ? isMap(target) ? new Map(target) : new Set(target) : void 0;\n const result = target.clear();\n if (hadItems) {\n trigger(\n target,\n \"clear\",\n void 0,\n void 0,\n oldTarget\n );\n }\n return result;\n }\n }\n );\n const iteratorMethods = [\n \"keys\",\n \"values\",\n \"entries\",\n Symbol.iterator\n ];\n iteratorMethods.forEach((method) => {\n instrumentations[method] = createIterableMethod(method, readonly2, shallow);\n });\n return instrumentations;\n}\nfunction createInstrumentationGetter(isReadonly2, shallow) {\n const instrumentations = createInstrumentations(isReadonly2, shallow);\n return (target, key, receiver) => {\n if (key === \"__v_isReactive\") {\n return !isReadonly2;\n } else if (key === \"__v_isReadonly\") {\n return isReadonly2;\n } else if (key === \"__v_raw\") {\n return target;\n }\n return Reflect.get(\n hasOwn(instrumentations, key) && key in target ? instrumentations : target,\n key,\n receiver\n );\n };\n}\nvar mutableCollectionHandlers = {\n get: createInstrumentationGetter(false, false)\n};\nvar shallowCollectionHandlers = {\n get: createInstrumentationGetter(false, true)\n};\nvar readonlyCollectionHandlers = {\n get: createInstrumentationGetter(true, false)\n};\nvar shallowReadonlyCollectionHandlers = {\n get: createInstrumentationGetter(true, true)\n};\nfunction checkIdentityKeys(target, has, key) {\n const rawKey = toRaw(key);\n if (rawKey !== key && has.call(target, rawKey)) {\n const type = toRawType(target);\n warn(\n `Reactive ${type} contains both the raw and reactive versions of the same object${type === `Map` ? ` as keys` : ``}, which can lead to inconsistencies. Avoid differentiating between the raw and reactive versions of an object and only use the reactive version if possible.`\n );\n }\n}\nvar reactiveMap = /* @__PURE__ */ new WeakMap();\nvar shallowReactiveMap = /* @__PURE__ */ new WeakMap();\nvar readonlyMap = /* @__PURE__ */ new WeakMap();\nvar shallowReadonlyMap = /* @__PURE__ */ new WeakMap();\nfunction targetTypeMap(rawType) {\n switch (rawType) {\n case \"Object\":\n case \"Array\":\n return 1;\n case \"Map\":\n case \"Set\":\n case \"WeakMap\":\n case \"WeakSet\":\n return 2;\n default:\n return 0;\n }\n}\nfunction getTargetType(value) {\n return value[\"__v_skip\"] || !Object.isExtensible(value) ? 0 : targetTypeMap(toRawType(value));\n}\nfunction reactive(target) {\n if (isReadonly(target)) {\n return target;\n }\n return createReactiveObject(\n target,\n false,\n mutableHandlers,\n mutableCollectionHandlers,\n reactiveMap\n );\n}\nfunction shallowReactive(target) {\n return createReactiveObject(\n target,\n false,\n shallowReactiveHandlers,\n shallowCollectionHandlers,\n shallowReactiveMap\n );\n}\nfunction readonly(target) {\n return createReactiveObject(\n target,\n true,\n readonlyHandlers,\n readonlyCollectionHandlers,\n readonlyMap\n );\n}\nfunction shallowReadonly(target) {\n return createReactiveObject(\n target,\n true,\n shallowReadonlyHandlers,\n shallowReadonlyCollectionHandlers,\n shallowReadonlyMap\n );\n}\nfunction createReactiveObject(target, isReadonly2, baseHandlers, collectionHandlers, proxyMap) {\n if (!isObject(target)) {\n if (true) {\n warn(\n `value cannot be made ${isReadonly2 ? \"readonly\" : \"reactive\"}: ${String(\n target\n )}`\n );\n }\n return target;\n }\n if (target[\"__v_raw\"] && !(isReadonly2 && target[\"__v_isReactive\"])) {\n return target;\n }\n const existingProxy = proxyMap.get(target);\n if (existingProxy) {\n return existingProxy;\n }\n const targetType = getTargetType(target);\n if (targetType === 0) {\n return target;\n }\n const proxy = new Proxy(\n target,\n targetType === 2 ? collectionHandlers : baseHandlers\n );\n proxyMap.set(target, proxy);\n return proxy;\n}\nfunction isReactive(value) {\n if (isReadonly(value)) {\n return isReactive(value[\"__v_raw\"]);\n }\n return !!(value && value[\"__v_isReactive\"]);\n}\nfunction isReadonly(value) {\n return !!(value && value[\"__v_isReadonly\"]);\n}\nfunction isShallow(value) {\n return !!(value && value[\"__v_isShallow\"]);\n}\nfunction isProxy(value) {\n return value ? !!value[\"__v_raw\"] : false;\n}\nfunction toRaw(observed) {\n const raw = observed && observed[\"__v_raw\"];\n return raw ? toRaw(raw) : observed;\n}\nfunction markRaw(value) {\n if (!hasOwn(value, \"__v_skip\") && Object.isExtensible(value)) {\n def(value, \"__v_skip\", true);\n }\n return value;\n}\nvar toReactive = (value) => isObject(value) ? reactive(value) : value;\nvar toReadonly = (value) => isObject(value) ? readonly(value) : value;\nfunction isRef2(r) {\n return r ? r[\"__v_isRef\"] === true : false;\n}\nfunction ref(value) {\n return createRef(value, false);\n}\nfunction shallowRef(value) {\n return createRef(value, true);\n}\nfunction createRef(rawValue, shallow) {\n if (isRef2(rawValue)) {\n return rawValue;\n }\n return new RefImpl(rawValue, shallow);\n}\nvar RefImpl = class {\n constructor(value, isShallow2) {\n this.dep = new Dep();\n this[\"__v_isRef\"] = true;\n this[\"__v_isShallow\"] = false;\n this._rawValue = isShallow2 ? value : toRaw(value);\n this._value = isShallow2 ? value : toReactive(value);\n this[\"__v_isShallow\"] = isShallow2;\n }\n get value() {\n if (true) {\n this.dep.track({\n target: this,\n type: \"get\",\n key: \"value\"\n });\n } else {\n this.dep.track();\n }\n return this._value;\n }\n set value(newValue) {\n const oldValue = this._rawValue;\n const useDirectValue = this[\"__v_isShallow\"] || isShallow(newValue) || isReadonly(newValue);\n newValue = useDirectValue ? newValue : toRaw(newValue);\n if (hasChanged(newValue, oldValue)) {\n this._rawValue = newValue;\n this._value = useDirectValue ? newValue : toReactive(newValue);\n if (true) {\n this.dep.trigger({\n target: this,\n type: \"set\",\n key: \"value\",\n newValue,\n oldValue\n });\n } else {\n this.dep.trigger();\n }\n }\n }\n};\nfunction triggerRef(ref2) {\n if (ref2.dep) {\n if (true) {\n ref2.dep.trigger({\n target: ref2,\n type: \"set\",\n key: \"value\",\n newValue: ref2._value\n });\n } else {\n ref2.dep.trigger();\n }\n }\n}\nfunction unref(ref2) {\n return isRef2(ref2) ? ref2.value : ref2;\n}\nfunction toValue(source) {\n return isFunction(source) ? source() : unref(source);\n}\nvar shallowUnwrapHandlers = {\n get: (target, key, receiver) => key === \"__v_raw\" ? target : unref(Reflect.get(target, key, receiver)),\n set: (target, key, value, receiver) => {\n const oldValue = target[key];\n if (isRef2(oldValue) && !isRef2(value)) {\n oldValue.value = value;\n return true;\n } else {\n return Reflect.set(target, key, value, receiver);\n }\n }\n};\nfunction proxyRefs(objectWithRefs) {\n return isReactive(objectWithRefs) ? objectWithRefs : new Proxy(objectWithRefs, shallowUnwrapHandlers);\n}\nvar CustomRefImpl = class {\n constructor(factory) {\n this[\"__v_isRef\"] = true;\n this._value = void 0;\n const dep = this.dep = new Dep();\n const { get, set } = factory(dep.track.bind(dep), dep.trigger.bind(dep));\n this._get = get;\n this._set = set;\n }\n get value() {\n return this._value = this._get();\n }\n set value(newVal) {\n this._set(newVal);\n }\n};\nfunction customRef(factory) {\n return new CustomRefImpl(factory);\n}\nfunction toRefs(object) {\n if (!isProxy(object)) {\n warn(`toRefs() expects a reactive object but received a plain one.`);\n }\n const ret = isArray(object) ? new Array(object.length) : {};\n for (const key in object) {\n ret[key] = propertyToRef(object, key);\n }\n return ret;\n}\nvar ObjectRefImpl = class {\n constructor(_object, _key, _defaultValue) {\n this._object = _object;\n this._key = _key;\n this._defaultValue = _defaultValue;\n this[\"__v_isRef\"] = true;\n this._value = void 0;\n }\n get value() {\n const val = this._object[this._key];\n return this._value = val === void 0 ? this._defaultValue : val;\n }\n set value(newVal) {\n this._object[this._key] = newVal;\n }\n get dep() {\n return getDepFromReactive(toRaw(this._object), this._key);\n }\n};\nvar GetterRefImpl = class {\n constructor(_getter) {\n this._getter = _getter;\n this[\"__v_isRef\"] = true;\n this[\"__v_isReadonly\"] = true;\n this._value = void 0;\n }\n get value() {\n return this._value = this._getter();\n }\n};\nfunction toRef(source, key, defaultValue) {\n if (isRef2(source)) {\n return source;\n } else if (isFunction(source)) {\n return new GetterRefImpl(source);\n } else if (isObject(source) && arguments.length > 1) {\n return propertyToRef(source, key, defaultValue);\n } else {\n return ref(source);\n }\n}\nfunction propertyToRef(source, key, defaultValue) {\n const val = source[key];\n return isRef2(val) ? val : new ObjectRefImpl(source, key, defaultValue);\n}\nvar ComputedRefImpl = class {\n constructor(fn, setter, isSSR) {\n this.fn = fn;\n this.setter = setter;\n this._value = void 0;\n this.dep = new Dep(this);\n this.__v_isRef = true;\n this.deps = void 0;\n this.depsTail = void 0;\n this.flags = 16;\n this.globalVersion = globalVersion - 1;\n this.next = void 0;\n this.effect = this;\n this[\"__v_isReadonly\"] = !setter;\n this.isSSR = isSSR;\n }\n /**\n * @internal\n */\n notify() {\n this.flags |= 16;\n if (!(this.flags & 8) && // avoid infinite self recursion\n activeSub !== this) {\n batch(this, true);\n return true;\n } else if (true) ;\n }\n get value() {\n const link = true ? this.dep.track({\n target: this,\n type: \"get\",\n key: \"value\"\n }) : this.dep.track();\n refreshComputed(this);\n if (link) {\n link.version = this.dep.version;\n }\n return this._value;\n }\n set value(newValue) {\n if (this.setter) {\n this.setter(newValue);\n } else if (true) {\n warn(\"Write operation failed: computed value is readonly\");\n }\n }\n};\nfunction computed(getterOrOptions, debugOptions, isSSR = false) {\n let getter;\n let setter;\n if (isFunction(getterOrOptions)) {\n getter = getterOrOptions;\n } else {\n getter = getterOrOptions.get;\n setter = getterOrOptions.set;\n }\n const cRef = new ComputedRefImpl(getter, setter, isSSR);\n if (debugOptions && !isSSR) {\n cRef.onTrack = debugOptions.onTrack;\n cRef.onTrigger = debugOptions.onTrigger;\n }\n return cRef;\n}\nvar TrackOpTypes = {\n \"GET\": \"get\",\n \"HAS\": \"has\",\n \"ITERATE\": \"iterate\"\n};\nvar TriggerOpTypes = {\n \"SET\": \"set\",\n \"ADD\": \"add\",\n \"DELETE\": \"delete\",\n \"CLEAR\": \"clear\"\n};\nvar INITIAL_WATCHER_VALUE = {};\nvar cleanupMap = /* @__PURE__ */ new WeakMap();\nvar activeWatcher = void 0;\nfunction getCurrentWatcher() {\n return activeWatcher;\n}\nfunction onWatcherCleanup(cleanupFn, failSilently = false, owner = activeWatcher) {\n if (owner) {\n let cleanups = cleanupMap.get(owner);\n if (!cleanups) cleanupMap.set(owner, cleanups = []);\n cleanups.push(cleanupFn);\n } else if (!failSilently) {\n warn(\n `onWatcherCleanup() was called when there was no active watcher to associate with.`\n );\n }\n}\nfunction watch(source, cb, options = EMPTY_OBJ) {\n const { immediate, deep, once, scheduler, augmentJob, call } = options;\n const warnInvalidSource = (s) => {\n (options.onWarn || warn)(\n `Invalid watch source: `,\n s,\n `A watch source can only be a getter/effect function, a ref, a reactive object, or an array of these types.`\n );\n };\n const reactiveGetter = (source2) => {\n if (deep) return source2;\n if (isShallow(source2) || deep === false || deep === 0)\n return traverse(source2, 1);\n return traverse(source2);\n };\n let effect2;\n let getter;\n let cleanup;\n let boundCleanup;\n let forceTrigger = false;\n let isMultiSource = false;\n if (isRef2(source)) {\n getter = () => source.value;\n forceTrigger = isShallow(source);\n } else if (isReactive(source)) {\n getter = () => reactiveGetter(source);\n forceTrigger = true;\n } else if (isArray(source)) {\n isMultiSource = true;\n forceTrigger = source.some((s) => isReactive(s) || isShallow(s));\n getter = () => source.map((s) => {\n if (isRef2(s)) {\n return s.value;\n } else if (isReactive(s)) {\n return reactiveGetter(s);\n } else if (isFunction(s)) {\n return call ? call(s, 2) : s();\n } else {\n warnInvalidSource(s);\n }\n });\n } else if (isFunction(source)) {\n if (cb) {\n getter = call ? () => call(source, 2) : source;\n } else {\n getter = () => {\n if (cleanup) {\n pauseTracking();\n try {\n cleanup();\n } finally {\n resetTracking();\n }\n }\n const currentEffect = activeWatcher;\n activeWatcher = effect2;\n try {\n return call ? call(source, 3, [boundCleanup]) : source(boundCleanup);\n } finally {\n activeWatcher = currentEffect;\n }\n };\n }\n } else {\n getter = NOOP;\n warnInvalidSource(source);\n }\n if (cb && deep) {\n const baseGetter = getter;\n const depth = deep === true ? Infinity : deep;\n getter = () => traverse(baseGetter(), depth);\n }\n const scope = getCurrentScope();\n const watchHandle = () => {\n effect2.stop();\n if (scope && scope.active) {\n remove(scope.effects, effect2);\n }\n };\n if (once && cb) {\n const _cb = cb;\n cb = (...args) => {\n _cb(...args);\n watchHandle();\n };\n }\n let oldValue = isMultiSource ? new Array(source.length).fill(INITIAL_WATCHER_VALUE) : INITIAL_WATCHER_VALUE;\n const job = (immediateFirstRun) => {\n if (!(effect2.flags & 1) || !effect2.dirty && !immediateFirstRun) {\n return;\n }\n if (cb) {\n const newValue = effect2.run();\n if (deep || forceTrigger || (isMultiSource ? newValue.some((v, i) => hasChanged(v, oldValue[i])) : hasChanged(newValue, oldValue))) {\n if (cleanup) {\n cleanup();\n }\n const currentWatcher = activeWatcher;\n activeWatcher = effect2;\n try {\n const args = [\n newValue,\n // pass undefined as the old value when it's changed for the first time\n oldValue === INITIAL_WATCHER_VALUE ? void 0 : isMultiSource && oldValue[0] === INITIAL_WATCHER_VALUE ? [] : oldValue,\n boundCleanup\n ];\n call ? call(cb, 3, args) : (\n // @ts-expect-error\n cb(...args)\n );\n oldValue = newValue;\n } finally {\n activeWatcher = currentWatcher;\n }\n }\n } else {\n effect2.run();\n }\n };\n if (augmentJob) {\n augmentJob(job);\n }\n effect2 = new ReactiveEffect(getter);\n effect2.scheduler = scheduler ? () => scheduler(job, false) : job;\n boundCleanup = (fn) => onWatcherCleanup(fn, false, effect2);\n cleanup = effect2.onStop = () => {\n const cleanups = cleanupMap.get(effect2);\n if (cleanups) {\n if (call) {\n call(cleanups, 4);\n } else {\n for (const cleanup2 of cleanups) cleanup2();\n }\n cleanupMap.delete(effect2);\n }\n };\n if (true) {\n effect2.onTrack = options.onTrack;\n effect2.onTrigger = options.onTrigger;\n }\n if (cb) {\n if (immediate) {\n job(true);\n } else {\n oldValue = effect2.run();\n }\n } else if (scheduler) {\n scheduler(job.bind(null, true), true);\n } else {\n effect2.run();\n }\n watchHandle.pause = effect2.pause.bind(effect2);\n watchHandle.resume = effect2.resume.bind(effect2);\n watchHandle.stop = watchHandle;\n return watchHandle;\n}\nfunction traverse(value, depth = Infinity, seen) {\n if (depth <= 0 || !isObject(value) || value[\"__v_skip\"]) {\n return value;\n }\n seen = seen || /* @__PURE__ */ new Set();\n if (seen.has(value)) {\n return value;\n }\n seen.add(value);\n depth--;\n if (isRef2(value)) {\n traverse(value.value, depth, seen);\n } else if (isArray(value)) {\n for (let i = 0; i < value.length; i++) {\n traverse(value[i], depth, seen);\n }\n } else if (isSet(value) || isMap(value)) {\n value.forEach((v) => {\n traverse(v, depth, seen);\n });\n } else if (isPlainObject(value)) {\n for (const key in value) {\n traverse(value[key], depth, seen);\n }\n for (const key of Object.getOwnPropertySymbols(value)) {\n if (Object.prototype.propertyIsEnumerable.call(value, key)) {\n traverse(value[key], depth, seen);\n }\n }\n }\n return value;\n}\n\n// node_modules/.pnpm/@vue+runtime-core@3.5.13/node_modules/@vue/runtime-core/dist/runtime-core.esm-bundler.js\nvar stack = [];\nfunction pushWarningContext(vnode) {\n stack.push(vnode);\n}\nfunction popWarningContext() {\n stack.pop();\n}\nvar isWarning = false;\nfunction warn$1(msg, ...args) {\n if (isWarning) return;\n isWarning = true;\n pauseTracking();\n const instance = stack.length ? stack[stack.length - 1].component : null;\n const appWarnHandler = instance && instance.appContext.config.warnHandler;\n const trace = getComponentTrace();\n if (appWarnHandler) {\n callWithErrorHandling(\n appWarnHandler,\n instance,\n 11,\n [\n // eslint-disable-next-line no-restricted-syntax\n msg + args.map((a) => {\n var _a, _b;\n return (_b = (_a = a.toString) == null ? void 0 : _a.call(a)) != null ? _b : JSON.stringify(a);\n }).join(\"\"),\n instance && instance.proxy,\n trace.map(\n ({ vnode }) => `at <${formatComponentName(instance, vnode.type)}>`\n ).join(\"\\n\"),\n trace\n ]\n );\n } else {\n const warnArgs = [`[Vue warn]: ${msg}`, ...args];\n if (trace.length && // avoid spamming console during tests\n true) {\n warnArgs.push(`\n`, ...formatTrace(trace));\n }\n console.warn(...warnArgs);\n }\n resetTracking();\n isWarning = false;\n}\nfunction getComponentTrace() {\n let currentVNode = stack[stack.length - 1];\n if (!currentVNode) {\n return [];\n }\n const normalizedStack = [];\n while (currentVNode) {\n const last = normalizedStack[0];\n if (last && last.vnode === currentVNode) {\n last.recurseCount++;\n } else {\n normalizedStack.push({\n vnode: currentVNode,\n recurseCount: 0\n });\n }\n const parentInstance = currentVNode.component && currentVNode.component.parent;\n currentVNode = parentInstance && parentInstance.vnode;\n }\n return normalizedStack;\n}\nfunction formatTrace(trace) {\n const logs = [];\n trace.forEach((entry, i) => {\n logs.push(...i === 0 ? [] : [`\n`], ...formatTraceEntry(entry));\n });\n return logs;\n}\nfunction formatTraceEntry({ vnode, recurseCount }) {\n const postfix = recurseCount > 0 ? `... (${recurseCount} recursive calls)` : ``;\n const isRoot = vnode.component ? vnode.component.parent == null : false;\n const open = ` at <${formatComponentName(\n vnode.component,\n vnode.type,\n isRoot\n )}`;\n const close = `>` + postfix;\n return vnode.props ? [open, ...formatProps(vnode.props), close] : [open + close];\n}\nfunction formatProps(props) {\n const res = [];\n const keys = Object.keys(props);\n keys.slice(0, 3).forEach((key) => {\n res.push(...formatProp(key, props[key]));\n });\n if (keys.length > 3) {\n res.push(` ...`);\n }\n return res;\n}\nfunction formatProp(key, value, raw) {\n if (isString(value)) {\n value = JSON.stringify(value);\n return raw ? value : [`${key}=${value}`];\n } else if (typeof value === \"number\" || typeof value === \"boolean\" || value == null) {\n return raw ? value : [`${key}=${value}`];\n } else if (isRef2(value)) {\n value = formatProp(key, toRaw(value.value), true);\n return raw ? value : [`${key}=Ref<`, value, `>`];\n } else if (isFunction(value)) {\n return [`${key}=fn${value.name ? `<${value.name}>` : ``}`];\n } else {\n value = toRaw(value);\n return raw ? value : [`${key}=`, value];\n }\n}\nfunction assertNumber(val, type) {\n if (false) return;\n if (val === void 0) {\n return;\n } else if (typeof val !== \"number\") {\n warn$1(`${type} is not a valid number - got ${JSON.stringify(val)}.`);\n } else if (isNaN(val)) {\n warn$1(`${type} is NaN - the duration expression might be incorrect.`);\n }\n}\nvar ErrorCodes = {\n \"SETUP_FUNCTION\": 0,\n \"0\": \"SETUP_FUNCTION\",\n \"RENDER_FUNCTION\": 1,\n \"1\": \"RENDER_FUNCTION\",\n \"NATIVE_EVENT_HANDLER\": 5,\n \"5\": \"NATIVE_EVENT_HANDLER\",\n \"COMPONENT_EVENT_HANDLER\": 6,\n \"6\": \"COMPONENT_EVENT_HANDLER\",\n \"VNODE_HOOK\": 7,\n \"7\": \"VNODE_HOOK\",\n \"DIRECTIVE_HOOK\": 8,\n \"8\": \"DIRECTIVE_HOOK\",\n \"TRANSITION_HOOK\": 9,\n \"9\": \"TRANSITION_HOOK\",\n \"APP_ERROR_HANDLER\": 10,\n \"10\": \"APP_ERROR_HANDLER\",\n \"APP_WARN_HANDLER\": 11,\n \"11\": \"APP_WARN_HANDLER\",\n \"FUNCTION_REF\": 12,\n \"12\": \"FUNCTION_REF\",\n \"ASYNC_COMPONENT_LOADER\": 13,\n \"13\": \"ASYNC_COMPONENT_LOADER\",\n \"SCHEDULER\": 14,\n \"14\": \"SCHEDULER\",\n \"COMPONENT_UPDATE\": 15,\n \"15\": \"COMPONENT_UPDATE\",\n \"APP_UNMOUNT_CLEANUP\": 16,\n \"16\": \"APP_UNMOUNT_CLEANUP\"\n};\nvar ErrorTypeStrings$1 = {\n [\"sp\"]: \"serverPrefetch hook\",\n [\"bc\"]: \"beforeCreate hook\",\n [\"c\"]: \"created hook\",\n [\"bm\"]: \"beforeMount hook\",\n [\"m\"]: \"mounted hook\",\n [\"bu\"]: \"beforeUpdate hook\",\n [\"u\"]: \"updated\",\n [\"bum\"]: \"beforeUnmount hook\",\n [\"um\"]: \"unmounted hook\",\n [\"a\"]: \"activated hook\",\n [\"da\"]: \"deactivated hook\",\n [\"ec\"]: \"errorCaptured hook\",\n [\"rtc\"]: \"renderTracked hook\",\n [\"rtg\"]: \"renderTriggered hook\",\n [0]: \"setup function\",\n [1]: \"render function\",\n [2]: \"watcher getter\",\n [3]: \"watcher callback\",\n [4]: \"watcher cleanup function\",\n [5]: \"native event handler\",\n [6]: \"component event handler\",\n [7]: \"vnode hook\",\n [8]: \"directive hook\",\n [9]: \"transition hook\",\n [10]: \"app errorHandler\",\n [11]: \"app warnHandler\",\n [12]: \"ref function\",\n [13]: \"async component loader\",\n [14]: \"scheduler flush\",\n [15]: \"component update\",\n [16]: \"app unmount cleanup function\"\n};\nfunction callWithErrorHandling(fn, instance, type, args) {\n try {\n return args ? fn(...args) : fn();\n } catch (err) {\n handleError(err, instance, type);\n }\n}\nfunction callWithAsyncErrorHandling(fn, instance, type, args) {\n if (isFunction(fn)) {\n const res = callWithErrorHandling(fn, instance, type, args);\n if (res && isPromise(res)) {\n res.catch((err) => {\n handleError(err, instance, type);\n });\n }\n return res;\n }\n if (isArray(fn)) {\n const values = [];\n for (let i = 0; i < fn.length; i++) {\n values.push(callWithAsyncErrorHandling(fn[i], instance, type, args));\n }\n return values;\n } else if (true) {\n warn$1(\n `Invalid value type passed to callWithAsyncErrorHandling(): ${typeof fn}`\n );\n }\n}\nfunction handleError(err, instance, type, throwInDev = true) {\n const contextVNode = instance ? instance.vnode : null;\n const { errorHandler, throwUnhandledErrorInProduction } = instance && instance.appContext.config || EMPTY_OBJ;\n if (instance) {\n let cur = instance.parent;\n const exposedInstance = instance.proxy;\n const errorInfo = true ? ErrorTypeStrings$1[type] : `https://vuejs.org/error-reference/#runtime-${type}`;\n while (cur) {\n const errorCapturedHooks = cur.ec;\n if (errorCapturedHooks) {\n for (let i = 0; i < errorCapturedHooks.length; i++) {\n if (errorCapturedHooks[i](err, exposedInstance, errorInfo) === false) {\n return;\n }\n }\n }\n cur = cur.parent;\n }\n if (errorHandler) {\n pauseTracking();\n callWithErrorHandling(errorHandler, null, 10, [\n err,\n exposedInstance,\n errorInfo\n ]);\n resetTracking();\n return;\n }\n }\n logError(err, type, contextVNode, throwInDev, throwUnhandledErrorInProduction);\n}\nfunction logError(err, type, contextVNode, throwInDev = true, throwInProd = false) {\n if (true) {\n const info = ErrorTypeStrings$1[type];\n if (contextVNode) {\n pushWarningContext(contextVNode);\n }\n warn$1(`Unhandled error${info ? ` during execution of ${info}` : ``}`);\n if (contextVNode) {\n popWarningContext();\n }\n if (throwInDev) {\n throw err;\n } else {\n console.error(err);\n }\n } else if (throwInProd) {\n throw err;\n } else {\n console.error(err);\n }\n}\nvar queue = [];\nvar flushIndex = -1;\nvar pendingPostFlushCbs = [];\nvar activePostFlushCbs = null;\nvar postFlushIndex = 0;\nvar resolvedPromise = Promise.resolve();\nvar currentFlushPromise = null;\nvar RECURSION_LIMIT = 100;\nfunction nextTick(fn) {\n const p2 = currentFlushPromise || resolvedPromise;\n return fn ? p2.then(this ? fn.bind(this) : fn) : p2;\n}\nfunction findInsertionIndex(id) {\n let start = flushIndex + 1;\n let end = queue.length;\n while (start < end) {\n const middle = start + end >>> 1;\n const middleJob = queue[middle];\n const middleJobId = getId(middleJob);\n if (middleJobId < id || middleJobId === id && middleJob.flags & 2) {\n start = middle + 1;\n } else {\n end = middle;\n }\n }\n return start;\n}\nfunction queueJob(job) {\n if (!(job.flags & 1)) {\n const jobId = getId(job);\n const lastJob = queue[queue.length - 1];\n if (!lastJob || // fast path when the job id is larger than the tail\n !(job.flags & 2) && jobId >= getId(lastJob)) {\n queue.push(job);\n } else {\n queue.splice(findInsertionIndex(jobId), 0, job);\n }\n job.flags |= 1;\n queueFlush();\n }\n}\nfunction queueFlush() {\n if (!currentFlushPromise) {\n currentFlushPromise = resolvedPromise.then(flushJobs);\n }\n}\nfunction queuePostFlushCb(cb) {\n if (!isArray(cb)) {\n if (activePostFlushCbs && cb.id === -1) {\n activePostFlushCbs.splice(postFlushIndex + 1, 0, cb);\n } else if (!(cb.flags & 1)) {\n pendingPostFlushCbs.push(cb);\n cb.flags |= 1;\n }\n } else {\n pendingPostFlushCbs.push(...cb);\n }\n queueFlush();\n}\nfunction flushPreFlushCbs(instance, seen, i = flushIndex + 1) {\n if (true) {\n seen = seen || /* @__PURE__ */ new Map();\n }\n for (; i < queue.length; i++) {\n const cb = queue[i];\n if (cb && cb.flags & 2) {\n if (instance && cb.id !== instance.uid) {\n continue;\n }\n if (checkRecursiveUpdates(seen, cb)) {\n continue;\n }\n queue.splice(i, 1);\n i--;\n if (cb.flags & 4) {\n cb.flags &= ~1;\n }\n cb();\n if (!(cb.flags & 4)) {\n cb.flags &= ~1;\n }\n }\n }\n}\nfunction flushPostFlushCbs(seen) {\n if (pendingPostFlushCbs.length) {\n const deduped = [...new Set(pendingPostFlushCbs)].sort(\n (a, b) => getId(a) - getId(b)\n );\n pendingPostFlushCbs.length = 0;\n if (activePostFlushCbs) {\n activePostFlushCbs.push(...deduped);\n return;\n }\n activePostFlushCbs = deduped;\n if (true) {\n seen = seen || /* @__PURE__ */ new Map();\n }\n for (postFlushIndex = 0; postFlushIndex < activePostFlushCbs.length; postFlushIndex++) {\n const cb = activePostFlushCbs[postFlushIndex];\n if (checkRecursiveUpdates(seen, cb)) {\n continue;\n }\n if (cb.flags & 4) {\n cb.flags &= ~1;\n }\n if (!(cb.flags & 8)) cb();\n cb.flags &= ~1;\n }\n activePostFlushCbs = null;\n postFlushIndex = 0;\n }\n}\nvar getId = (job) => job.id == null ? job.flags & 2 ? -1 : Infinity : job.id;\nfunction flushJobs(seen) {\n if (true) {\n seen = seen || /* @__PURE__ */ new Map();\n }\n const check = true ? (job) => checkRecursiveUpdates(seen, job) : NOOP;\n try {\n for (flushIndex = 0; flushIndex < queue.length; flushIndex++) {\n const job = queue[flushIndex];\n if (job && !(job.flags & 8)) {\n if (check(job)) {\n continue;\n }\n if (job.flags & 4) {\n job.flags &= ~1;\n }\n callWithErrorHandling(\n job,\n job.i,\n job.i ? 15 : 14\n );\n if (!(job.flags & 4)) {\n job.flags &= ~1;\n }\n }\n }\n } finally {\n for (; flushIndex < queue.length; flushIndex++) {\n const job = queue[flushIndex];\n if (job) {\n job.flags &= ~1;\n }\n }\n flushIndex = -1;\n queue.length = 0;\n flushPostFlushCbs(seen);\n currentFlushPromise = null;\n if (queue.length || pendingPostFlushCbs.length) {\n flushJobs(seen);\n }\n }\n}\nfunction checkRecursiveUpdates(seen, fn) {\n const count = seen.get(fn) || 0;\n if (count > RECURSION_LIMIT) {\n const instance = fn.i;\n const componentName = instance && getComponentName(instance.type);\n handleError(\n `Maximum recursive updates exceeded${componentName ? ` in component <${componentName}>` : ``}. This means you have a reactive effect that is mutating its own dependencies and thus recursively triggering itself. Possible sources include component template, render function, updated hook or watcher source function.`,\n null,\n 10\n );\n return true;\n }\n seen.set(fn, count + 1);\n return false;\n}\nvar isHmrUpdating = false;\nvar hmrDirtyComponents = /* @__PURE__ */ new Map();\nif (true) {\n getGlobalThis().__VUE_HMR_RUNTIME__ = {\n createRecord: tryWrap(createRecord),\n rerender: tryWrap(rerender),\n reload: tryWrap(reload)\n };\n}\nvar map = /* @__PURE__ */ new Map();\nfunction registerHMR(instance) {\n const id = instance.type.__hmrId;\n let record = map.get(id);\n if (!record) {\n createRecord(id, instance.type);\n record = map.get(id);\n }\n record.instances.add(instance);\n}\nfunction unregisterHMR(instance) {\n map.get(instance.type.__hmrId).instances.delete(instance);\n}\nfunction createRecord(id, initialDef) {\n if (map.has(id)) {\n return false;\n }\n map.set(id, {\n initialDef: normalizeClassComponent(initialDef),\n instances: /* @__PURE__ */ new Set()\n });\n return true;\n}\nfunction normalizeClassComponent(component) {\n return isClassComponent(component) ? component.__vccOpts : component;\n}\nfunction rerender(id, newRender) {\n const record = map.get(id);\n if (!record) {\n return;\n }\n record.initialDef.render = newRender;\n [...record.instances].forEach((instance) => {\n if (newRender) {\n instance.render = newRender;\n normalizeClassComponent(instance.type).render = newRender;\n }\n instance.renderCache = [];\n isHmrUpdating = true;\n instance.update();\n isHmrUpdating = false;\n });\n}\nfunction reload(id, newComp) {\n const record = map.get(id);\n if (!record) return;\n newComp = normalizeClassComponent(newComp);\n updateComponentDef(record.initialDef, newComp);\n const instances = [...record.instances];\n for (let i = 0; i < instances.length; i++) {\n const instance = instances[i];\n const oldComp = normalizeClassComponent(instance.type);\n let dirtyInstances = hmrDirtyComponents.get(oldComp);\n if (!dirtyInstances) {\n if (oldComp !== record.initialDef) {\n updateComponentDef(oldComp, newComp);\n }\n hmrDirtyComponents.set(oldComp, dirtyInstances = /* @__PURE__ */ new Set());\n }\n dirtyInstances.add(instance);\n instance.appContext.propsCache.delete(instance.type);\n instance.appContext.emitsCache.delete(instance.type);\n instance.appContext.optionsCache.delete(instance.type);\n if (instance.ceReload) {\n dirtyInstances.add(instance);\n instance.ceReload(newComp.styles);\n dirtyInstances.delete(instance);\n } else if (instance.parent) {\n queueJob(() => {\n isHmrUpdating = true;\n instance.parent.update();\n isHmrUpdating = false;\n dirtyInstances.delete(instance);\n });\n } else if (instance.appContext.reload) {\n instance.appContext.reload();\n } else if (typeof window !== \"undefined\") {\n window.location.reload();\n } else {\n console.warn(\n \"[HMR] Root or manually mounted instance modified. Full reload required.\"\n );\n }\n if (instance.root.ce && instance !== instance.root) {\n instance.root.ce._removeChildStyle(oldComp);\n }\n }\n queuePostFlushCb(() => {\n hmrDirtyComponents.clear();\n });\n}\nfunction updateComponentDef(oldComp, newComp) {\n extend(oldComp, newComp);\n for (const key in oldComp) {\n if (key !== \"__file\" && !(key in newComp)) {\n delete oldComp[key];\n }\n }\n}\nfunction tryWrap(fn) {\n return (id, arg) => {\n try {\n return fn(id, arg);\n } catch (e) {\n console.error(e);\n console.warn(\n `[HMR] Something went wrong during Vue component hot-reload. Full reload required.`\n );\n }\n };\n}\nvar devtools$1;\nvar buffer = [];\nvar devtoolsNotInstalled = false;\nfunction emit$1(event, ...args) {\n if (devtools$1) {\n devtools$1.emit(event, ...args);\n } else if (!devtoolsNotInstalled) {\n buffer.push({ event, args });\n }\n}\nfunction setDevtoolsHook$1(hook, target) {\n var _a, _b;\n devtools$1 = hook;\n if (devtools$1) {\n devtools$1.enabled = true;\n buffer.forEach(({ event, args }) => devtools$1.emit(event, ...args));\n buffer = [];\n } else if (\n // handle late devtools injection - only do this if we are in an actual\n // browser environment to avoid the timer handle stalling test runner exit\n // (#4815)\n typeof window !== \"undefined\" && // some envs mock window but not fully\n window.HTMLElement && // also exclude jsdom\n // eslint-disable-next-line no-restricted-syntax\n !((_b = (_a = window.navigator) == null ? void 0 : _a.userAgent) == null ? void 0 : _b.includes(\"jsdom\"))\n ) {\n const replay = target.__VUE_DEVTOOLS_HOOK_REPLAY__ = target.__VUE_DEVTOOLS_HOOK_REPLAY__ || [];\n replay.push((newHook) => {\n setDevtoolsHook$1(newHook, target);\n });\n setTimeout(() => {\n if (!devtools$1) {\n target.__VUE_DEVTOOLS_HOOK_REPLAY__ = null;\n devtoolsNotInstalled = true;\n buffer = [];\n }\n }, 3e3);\n } else {\n devtoolsNotInstalled = true;\n buffer = [];\n }\n}\nfunction devtoolsInitApp(app, version2) {\n emit$1(\"app:init\", app, version2, {\n Fragment,\n Text,\n Comment,\n Static\n });\n}\nfunction devtoolsUnmountApp(app) {\n emit$1(\"app:unmount\", app);\n}\nvar devtoolsComponentAdded = createDevtoolsComponentHook(\n \"component:added\"\n /* COMPONENT_ADDED */\n);\nvar devtoolsComponentUpdated = createDevtoolsComponentHook(\n \"component:updated\"\n /* COMPONENT_UPDATED */\n);\nvar _devtoolsComponentRemoved = createDevtoolsComponentHook(\n \"component:removed\"\n /* COMPONENT_REMOVED */\n);\nvar devtoolsComponentRemoved = (component) => {\n if (devtools$1 && typeof devtools$1.cleanupBuffer === \"function\" && // remove the component if it wasn't buffered\n !devtools$1.cleanupBuffer(component)) {\n _devtoolsComponentRemoved(component);\n }\n};\nfunction createDevtoolsComponentHook(hook) {\n return (component) => {\n emit$1(\n hook,\n component.appContext.app,\n component.uid,\n component.parent ? component.parent.uid : void 0,\n component\n );\n };\n}\nvar devtoolsPerfStart = createDevtoolsPerformanceHook(\n \"perf:start\"\n /* PERFORMANCE_START */\n);\nvar devtoolsPerfEnd = createDevtoolsPerformanceHook(\n \"perf:end\"\n /* PERFORMANCE_END */\n);\nfunction createDevtoolsPerformanceHook(hook) {\n return (component, type, time) => {\n emit$1(hook, component.appContext.app, component.uid, component, type, time);\n };\n}\nfunction devtoolsComponentEmit(component, event, params) {\n emit$1(\n \"component:emit\",\n component.appContext.app,\n component,\n event,\n params\n );\n}\nvar currentRenderingInstance = null;\nvar currentScopeId = null;\nfunction setCurrentRenderingInstance(instance) {\n const prev = currentRenderingInstance;\n currentRenderingInstance = instance;\n currentScopeId = instance && instance.type.__scopeId || null;\n return prev;\n}\nfunction pushScopeId(id) {\n currentScopeId = id;\n}\nfunction popScopeId() {\n currentScopeId = null;\n}\nvar withScopeId = (_id) => withCtx;\nfunction withCtx(fn, ctx = currentRenderingInstance, isNonScopedSlot) {\n if (!ctx) return fn;\n if (fn._n) {\n return fn;\n }\n const renderFnWithContext = (...args) => {\n if (renderFnWithContext._d) {\n setBlockTracking(-1);\n }\n const prevInstance = setCurrentRenderingInstance(ctx);\n let res;\n try {\n res = fn(...args);\n } finally {\n setCurrentRenderingInstance(prevInstance);\n if (renderFnWithContext._d) {\n setBlockTracking(1);\n }\n }\n if (true) {\n devtoolsComponentUpdated(ctx);\n }\n return res;\n };\n renderFnWithContext._n = true;\n renderFnWithContext._c = true;\n renderFnWithContext._d = true;\n return renderFnWithContext;\n}\nfunction validateDirectiveName(name) {\n if (isBuiltInDirective(name)) {\n warn$1(\"Do not use built-in directive ids as custom directive id: \" + name);\n }\n}\nfunction withDirectives(vnode, directives) {\n if (currentRenderingInstance === null) {\n warn$1(`withDirectives can only be used inside render functions.`);\n return vnode;\n }\n const instance = getComponentPublicInstance(currentRenderingInstance);\n const bindings = vnode.dirs || (vnode.dirs = []);\n for (let i = 0; i < directives.length; i++) {\n let [dir, value, arg, modifiers = EMPTY_OBJ] = directives[i];\n if (dir) {\n if (isFunction(dir)) {\n dir = {\n mounted: dir,\n updated: dir\n };\n }\n if (dir.deep) {\n traverse(value);\n }\n bindings.push({\n dir,\n instance,\n value,\n oldValue: void 0,\n arg,\n modifiers\n });\n }\n }\n return vnode;\n}\nfunction invokeDirectiveHook(vnode, prevVNode, instance, name) {\n const bindings = vnode.dirs;\n const oldBindings = prevVNode && prevVNode.dirs;\n for (let i = 0; i < bindings.length; i++) {\n const binding = bindings[i];\n if (oldBindings) {\n binding.oldValue = oldBindings[i].value;\n }\n let hook = binding.dir[name];\n if (hook) {\n pauseTracking();\n callWithAsyncErrorHandling(hook, instance, 8, [\n vnode.el,\n binding,\n vnode,\n prevVNode\n ]);\n resetTracking();\n }\n }\n}\nvar TeleportEndKey = Symbol(\"_vte\");\nvar isTeleport = (type) => type.__isTeleport;\nvar isTeleportDisabled = (props) => props && (props.disabled || props.disabled === \"\");\nvar isTeleportDeferred = (props) => props && (props.defer || props.defer === \"\");\nvar isTargetSVG = (target) => typeof SVGElement !== \"undefined\" && target instanceof SVGElement;\nvar isTargetMathML = (target) => typeof MathMLElement === \"function\" && target instanceof MathMLElement;\nvar resolveTarget = (props, select) => {\n const targetSelector = props && props.to;\n if (isString(targetSelector)) {\n if (!select) {\n warn$1(\n `Current renderer does not support string target for Teleports. (missing querySelector renderer option)`\n );\n return null;\n } else {\n const target = select(targetSelector);\n if (!target && !isTeleportDisabled(props)) {\n warn$1(\n `Failed to locate Teleport target with selector \"${targetSelector}\". Note the target element must exist before the component is mounted - i.e. the target cannot be rendered by the component itself, and ideally should be outside of the entire Vue component tree.`\n );\n }\n return target;\n }\n } else {\n if (!targetSelector && !isTeleportDisabled(props)) {\n warn$1(`Invalid Teleport target: ${targetSelector}`);\n }\n return targetSelector;\n }\n};\nvar TeleportImpl = {\n name: \"Teleport\",\n __isTeleport: true,\n process(n1, n2, container, anchor, parentComponent, parentSuspense, namespace, slotScopeIds, optimized, internals) {\n const {\n mc: mountChildren,\n pc: patchChildren,\n pbc: patchBlockChildren,\n o: { insert, querySelector, createText, createComment }\n } = internals;\n const disabled = isTeleportDisabled(n2.props);\n let { shapeFlag, children, dynamicChildren } = n2;\n if (isHmrUpdating) {\n optimized = false;\n dynamicChildren = null;\n }\n if (n1 == null) {\n const placeholder = n2.el = true ? createComment(\"teleport start\") : createText(\"\");\n const mainAnchor = n2.anchor = true ? createComment(\"teleport end\") : createText(\"\");\n insert(placeholder, container, anchor);\n insert(mainAnchor, container, anchor);\n const mount = (container2, anchor2) => {\n if (shapeFlag & 16) {\n if (parentComponent && parentComponent.isCE) {\n parentComponent.ce._teleportTarget = container2;\n }\n mountChildren(\n children,\n container2,\n anchor2,\n parentComponent,\n parentSuspense,\n namespace,\n slotScopeIds,\n optimized\n );\n }\n };\n const mountToTarget = () => {\n const target = n2.target = resolveTarget(n2.props, querySelector);\n const targetAnchor = prepareAnchor(target, n2, createText, insert);\n if (target) {\n if (namespace !== \"svg\" && isTargetSVG(target)) {\n namespace = \"svg\";\n } else if (namespace !== \"mathml\" && isTargetMathML(target)) {\n namespace = \"mathml\";\n }\n if (!disabled) {\n mount(target, targetAnchor);\n updateCssVars(n2, false);\n }\n } else if (!disabled) {\n warn$1(\n \"Invalid Teleport target on mount:\",\n target,\n `(${typeof target})`\n );\n }\n };\n if (disabled) {\n mount(container, mainAnchor);\n updateCssVars(n2, true);\n }\n if (isTeleportDeferred(n2.props)) {\n queuePostRenderEffect(() => {\n mountToTarget();\n n2.el.__isMounted = true;\n }, parentSuspense);\n } else {\n mountToTarget();\n }\n } else {\n if (isTeleportDeferred(n2.props) && !n1.el.__isMounted) {\n queuePostRenderEffect(() => {\n TeleportImpl.process(\n n1,\n n2,\n container,\n anchor,\n parentComponent,\n parentSuspense,\n namespace,\n slotScopeIds,\n optimized,\n internals\n );\n delete n1.el.__isMounted;\n }, parentSuspense);\n return;\n }\n n2.el = n1.el;\n n2.targetStart = n1.targetStart;\n const mainAnchor = n2.anchor = n1.anchor;\n const target = n2.target = n1.target;\n const targetAnchor = n2.targetAnchor = n1.targetAnchor;\n const wasDisabled = isTeleportDisabled(n1.props);\n const currentContainer = wasDisabled ? container : target;\n const currentAnchor = wasDisabled ? mainAnchor : targetAnchor;\n if (namespace === \"svg\" || isTargetSVG(target)) {\n namespace = \"svg\";\n } else if (namespace === \"mathml\" || isTargetMathML(target)) {\n namespace = \"mathml\";\n }\n if (dynamicChildren) {\n patchBlockChildren(\n n1.dynamicChildren,\n dynamicChildren,\n currentContainer,\n parentComponent,\n parentSuspense,\n namespace,\n slotScopeIds\n );\n traverseStaticChildren(n1, n2, true);\n } else if (!optimized) {\n patchChildren(\n n1,\n n2,\n currentContainer,\n currentAnchor,\n parentComponent,\n parentSuspense,\n namespace,\n slotScopeIds,\n false\n );\n }\n if (disabled) {\n if (!wasDisabled) {\n moveTeleport(\n n2,\n container,\n mainAnchor,\n internals,\n 1\n );\n } else {\n if (n2.props && n1.props && n2.props.to !== n1.props.to) {\n n2.props.to = n1.props.to;\n }\n }\n } else {\n if ((n2.props && n2.props.to) !== (n1.props && n1.props.to)) {\n const nextTarget = n2.target = resolveTarget(\n n2.props,\n querySelector\n );\n if (nextTarget) {\n moveTeleport(\n n2,\n nextTarget,\n null,\n internals,\n 0\n );\n } else if (true) {\n warn$1(\n \"Invalid Teleport target on update:\",\n target,\n `(${typeof target})`\n );\n }\n } else if (wasDisabled) {\n moveTeleport(\n n2,\n target,\n targetAnchor,\n internals,\n 1\n );\n }\n }\n updateCssVars(n2, disabled);\n }\n },\n remove(vnode, parentComponent, parentSuspense, { um: unmount, o: { remove: hostRemove } }, doRemove) {\n const {\n shapeFlag,\n children,\n anchor,\n targetStart,\n targetAnchor,\n target,\n props\n } = vnode;\n if (target) {\n hostRemove(targetStart);\n hostRemove(targetAnchor);\n }\n doRemove && hostRemove(anchor);\n if (shapeFlag & 16) {\n const shouldRemove = doRemove || !isTeleportDisabled(props);\n for (let i = 0; i < children.length; i++) {\n const child = children[i];\n unmount(\n child,\n parentComponent,\n parentSuspense,\n shouldRemove,\n !!child.dynamicChildren\n );\n }\n }\n },\n move: moveTeleport,\n hydrate: hydrateTeleport\n};\nfunction moveTeleport(vnode, container, parentAnchor, { o: { insert }, m: move }, moveType = 2) {\n if (moveType === 0) {\n insert(vnode.targetAnchor, container, parentAnchor);\n }\n const { el, anchor, shapeFlag, children, props } = vnode;\n const isReorder = moveType === 2;\n if (isReorder) {\n insert(el, container, parentAnchor);\n }\n if (!isReorder || isTeleportDisabled(props)) {\n if (shapeFlag & 16) {\n for (let i = 0; i < children.length; i++) {\n move(\n children[i],\n container,\n parentAnchor,\n 2\n );\n }\n }\n }\n if (isReorder) {\n insert(anchor, container, parentAnchor);\n }\n}\nfunction hydrateTeleport(node, vnode, parentComponent, parentSuspense, slotScopeIds, optimized, {\n o: { nextSibling, parentNode, querySelector, insert, createText }\n}, hydrateChildren) {\n const target = vnode.target = resolveTarget(\n vnode.props,\n querySelector\n );\n if (target) {\n const disabled = isTeleportDisabled(vnode.props);\n const targetNode = target._lpa || target.firstChild;\n if (vnode.shapeFlag & 16) {\n if (disabled) {\n vnode.anchor = hydrateChildren(\n nextSibling(node),\n vnode,\n parentNode(node),\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n vnode.targetStart = targetNode;\n vnode.targetAnchor = targetNode && nextSibling(targetNode);\n } else {\n vnode.anchor = nextSibling(node);\n let targetAnchor = targetNode;\n while (targetAnchor) {\n if (targetAnchor && targetAnchor.nodeType === 8) {\n if (targetAnchor.data === \"teleport start anchor\") {\n vnode.targetStart = targetAnchor;\n } else if (targetAnchor.data === \"teleport anchor\") {\n vnode.targetAnchor = targetAnchor;\n target._lpa = vnode.targetAnchor && nextSibling(vnode.targetAnchor);\n break;\n }\n }\n targetAnchor = nextSibling(targetAnchor);\n }\n if (!vnode.targetAnchor) {\n prepareAnchor(target, vnode, createText, insert);\n }\n hydrateChildren(\n targetNode && nextSibling(targetNode),\n vnode,\n target,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n }\n }\n updateCssVars(vnode, disabled);\n }\n return vnode.anchor && nextSibling(vnode.anchor);\n}\nvar Teleport = TeleportImpl;\nfunction updateCssVars(vnode, isDisabled) {\n const ctx = vnode.ctx;\n if (ctx && ctx.ut) {\n let node, anchor;\n if (isDisabled) {\n node = vnode.el;\n anchor = vnode.anchor;\n } else {\n node = vnode.targetStart;\n anchor = vnode.targetAnchor;\n }\n while (node && node !== anchor) {\n if (node.nodeType === 1) node.setAttribute(\"data-v-owner\", ctx.uid);\n node = node.nextSibling;\n }\n ctx.ut();\n }\n}\nfunction prepareAnchor(target, vnode, createText, insert) {\n const targetStart = vnode.targetStart = createText(\"\");\n const targetAnchor = vnode.targetAnchor = createText(\"\");\n targetStart[TeleportEndKey] = targetAnchor;\n if (target) {\n insert(targetStart, target);\n insert(targetAnchor, target);\n }\n return targetAnchor;\n}\nvar leaveCbKey = Symbol(\"_leaveCb\");\nvar enterCbKey = Symbol(\"_enterCb\");\nfunction useTransitionState() {\n const state = {\n isMounted: false,\n isLeaving: false,\n isUnmounting: false,\n leavingVNodes: /* @__PURE__ */ new Map()\n };\n onMounted(() => {\n state.isMounted = true;\n });\n onBeforeUnmount(() => {\n state.isUnmounting = true;\n });\n return state;\n}\nvar TransitionHookValidator = [Function, Array];\nvar BaseTransitionPropsValidators = {\n mode: String,\n appear: Boolean,\n persisted: Boolean,\n // enter\n onBeforeEnter: TransitionHookValidator,\n onEnter: TransitionHookValidator,\n onAfterEnter: TransitionHookValidator,\n onEnterCancelled: TransitionHookValidator,\n // leave\n onBeforeLeave: TransitionHookValidator,\n onLeave: TransitionHookValidator,\n onAfterLeave: TransitionHookValidator,\n onLeaveCancelled: TransitionHookValidator,\n // appear\n onBeforeAppear: TransitionHookValidator,\n onAppear: TransitionHookValidator,\n onAfterAppear: TransitionHookValidator,\n onAppearCancelled: TransitionHookValidator\n};\nvar recursiveGetSubtree = (instance) => {\n const subTree = instance.subTree;\n return subTree.component ? recursiveGetSubtree(subTree.component) : subTree;\n};\nvar BaseTransitionImpl = {\n name: `BaseTransition`,\n props: BaseTransitionPropsValidators,\n setup(props, { slots }) {\n const instance = getCurrentInstance();\n const state = useTransitionState();\n return () => {\n const children = slots.default && getTransitionRawChildren(slots.default(), true);\n if (!children || !children.length) {\n return;\n }\n const child = findNonCommentChild(children);\n const rawProps = toRaw(props);\n const { mode } = rawProps;\n if (mode && mode !== \"in-out\" && mode !== \"out-in\" && mode !== \"default\") {\n warn$1(`invalid mode: ${mode}`);\n }\n if (state.isLeaving) {\n return emptyPlaceholder(child);\n }\n const innerChild = getInnerChild$1(child);\n if (!innerChild) {\n return emptyPlaceholder(child);\n }\n let enterHooks = resolveTransitionHooks(\n innerChild,\n rawProps,\n state,\n instance,\n // #11061, ensure enterHooks is fresh after clone\n (hooks) => enterHooks = hooks\n );\n if (innerChild.type !== Comment) {\n setTransitionHooks(innerChild, enterHooks);\n }\n let oldInnerChild = instance.subTree && getInnerChild$1(instance.subTree);\n if (oldInnerChild && oldInnerChild.type !== Comment && !isSameVNodeType(innerChild, oldInnerChild) && recursiveGetSubtree(instance).type !== Comment) {\n let leavingHooks = resolveTransitionHooks(\n oldInnerChild,\n rawProps,\n state,\n instance\n );\n setTransitionHooks(oldInnerChild, leavingHooks);\n if (mode === \"out-in\" && innerChild.type !== Comment) {\n state.isLeaving = true;\n leavingHooks.afterLeave = () => {\n state.isLeaving = false;\n if (!(instance.job.flags & 8)) {\n instance.update();\n }\n delete leavingHooks.afterLeave;\n oldInnerChild = void 0;\n };\n return emptyPlaceholder(child);\n } else if (mode === \"in-out\" && innerChild.type !== Comment) {\n leavingHooks.delayLeave = (el, earlyRemove, delayedLeave) => {\n const leavingVNodesCache = getLeavingNodesForType(\n state,\n oldInnerChild\n );\n leavingVNodesCache[String(oldInnerChild.key)] = oldInnerChild;\n el[leaveCbKey] = () => {\n earlyRemove();\n el[leaveCbKey] = void 0;\n delete enterHooks.delayedLeave;\n oldInnerChild = void 0;\n };\n enterHooks.delayedLeave = () => {\n delayedLeave();\n delete enterHooks.delayedLeave;\n oldInnerChild = void 0;\n };\n };\n } else {\n oldInnerChild = void 0;\n }\n } else if (oldInnerChild) {\n oldInnerChild = void 0;\n }\n return child;\n };\n }\n};\nfunction findNonCommentChild(children) {\n let child = children[0];\n if (children.length > 1) {\n let hasFound = false;\n for (const c of children) {\n if (c.type !== Comment) {\n if (hasFound) {\n warn$1(\n \" can only be used on a single element or component. Use for lists.\"\n );\n break;\n }\n child = c;\n hasFound = true;\n if (false) break;\n }\n }\n }\n return child;\n}\nvar BaseTransition = BaseTransitionImpl;\nfunction getLeavingNodesForType(state, vnode) {\n const { leavingVNodes } = state;\n let leavingVNodesCache = leavingVNodes.get(vnode.type);\n if (!leavingVNodesCache) {\n leavingVNodesCache = /* @__PURE__ */ Object.create(null);\n leavingVNodes.set(vnode.type, leavingVNodesCache);\n }\n return leavingVNodesCache;\n}\nfunction resolveTransitionHooks(vnode, props, state, instance, postClone) {\n const {\n appear,\n mode,\n persisted = false,\n onBeforeEnter,\n onEnter,\n onAfterEnter,\n onEnterCancelled,\n onBeforeLeave,\n onLeave,\n onAfterLeave,\n onLeaveCancelled,\n onBeforeAppear,\n onAppear,\n onAfterAppear,\n onAppearCancelled\n } = props;\n const key = String(vnode.key);\n const leavingVNodesCache = getLeavingNodesForType(state, vnode);\n const callHook3 = (hook, args) => {\n hook && callWithAsyncErrorHandling(\n hook,\n instance,\n 9,\n args\n );\n };\n const callAsyncHook = (hook, args) => {\n const done = args[1];\n callHook3(hook, args);\n if (isArray(hook)) {\n if (hook.every((hook2) => hook2.length <= 1)) done();\n } else if (hook.length <= 1) {\n done();\n }\n };\n const hooks = {\n mode,\n persisted,\n beforeEnter(el) {\n let hook = onBeforeEnter;\n if (!state.isMounted) {\n if (appear) {\n hook = onBeforeAppear || onBeforeEnter;\n } else {\n return;\n }\n }\n if (el[leaveCbKey]) {\n el[leaveCbKey](\n true\n /* cancelled */\n );\n }\n const leavingVNode = leavingVNodesCache[key];\n if (leavingVNode && isSameVNodeType(vnode, leavingVNode) && leavingVNode.el[leaveCbKey]) {\n leavingVNode.el[leaveCbKey]();\n }\n callHook3(hook, [el]);\n },\n enter(el) {\n let hook = onEnter;\n let afterHook = onAfterEnter;\n let cancelHook = onEnterCancelled;\n if (!state.isMounted) {\n if (appear) {\n hook = onAppear || onEnter;\n afterHook = onAfterAppear || onAfterEnter;\n cancelHook = onAppearCancelled || onEnterCancelled;\n } else {\n return;\n }\n }\n let called = false;\n const done = el[enterCbKey] = (cancelled) => {\n if (called) return;\n called = true;\n if (cancelled) {\n callHook3(cancelHook, [el]);\n } else {\n callHook3(afterHook, [el]);\n }\n if (hooks.delayedLeave) {\n hooks.delayedLeave();\n }\n el[enterCbKey] = void 0;\n };\n if (hook) {\n callAsyncHook(hook, [el, done]);\n } else {\n done();\n }\n },\n leave(el, remove2) {\n const key2 = String(vnode.key);\n if (el[enterCbKey]) {\n el[enterCbKey](\n true\n /* cancelled */\n );\n }\n if (state.isUnmounting) {\n return remove2();\n }\n callHook3(onBeforeLeave, [el]);\n let called = false;\n const done = el[leaveCbKey] = (cancelled) => {\n if (called) return;\n called = true;\n remove2();\n if (cancelled) {\n callHook3(onLeaveCancelled, [el]);\n } else {\n callHook3(onAfterLeave, [el]);\n }\n el[leaveCbKey] = void 0;\n if (leavingVNodesCache[key2] === vnode) {\n delete leavingVNodesCache[key2];\n }\n };\n leavingVNodesCache[key2] = vnode;\n if (onLeave) {\n callAsyncHook(onLeave, [el, done]);\n } else {\n done();\n }\n },\n clone(vnode2) {\n const hooks2 = resolveTransitionHooks(\n vnode2,\n props,\n state,\n instance,\n postClone\n );\n if (postClone) postClone(hooks2);\n return hooks2;\n }\n };\n return hooks;\n}\nfunction emptyPlaceholder(vnode) {\n if (isKeepAlive(vnode)) {\n vnode = cloneVNode(vnode);\n vnode.children = null;\n return vnode;\n }\n}\nfunction getInnerChild$1(vnode) {\n if (!isKeepAlive(vnode)) {\n if (isTeleport(vnode.type) && vnode.children) {\n return findNonCommentChild(vnode.children);\n }\n return vnode;\n }\n if (vnode.component) {\n return vnode.component.subTree;\n }\n const { shapeFlag, children } = vnode;\n if (children) {\n if (shapeFlag & 16) {\n return children[0];\n }\n if (shapeFlag & 32 && isFunction(children.default)) {\n return children.default();\n }\n }\n}\nfunction setTransitionHooks(vnode, hooks) {\n if (vnode.shapeFlag & 6 && vnode.component) {\n vnode.transition = hooks;\n setTransitionHooks(vnode.component.subTree, hooks);\n } else if (vnode.shapeFlag & 128) {\n vnode.ssContent.transition = hooks.clone(vnode.ssContent);\n vnode.ssFallback.transition = hooks.clone(vnode.ssFallback);\n } else {\n vnode.transition = hooks;\n }\n}\nfunction getTransitionRawChildren(children, keepComment = false, parentKey) {\n let ret = [];\n let keyedFragmentCount = 0;\n for (let i = 0; i < children.length; i++) {\n let child = children[i];\n const key = parentKey == null ? child.key : String(parentKey) + String(child.key != null ? child.key : i);\n if (child.type === Fragment) {\n if (child.patchFlag & 128) keyedFragmentCount++;\n ret = ret.concat(\n getTransitionRawChildren(child.children, keepComment, key)\n );\n } else if (keepComment || child.type !== Comment) {\n ret.push(key != null ? cloneVNode(child, { key }) : child);\n }\n }\n if (keyedFragmentCount > 1) {\n for (let i = 0; i < ret.length; i++) {\n ret[i].patchFlag = -2;\n }\n }\n return ret;\n}\nfunction defineComponent(options, extraOptions) {\n return isFunction(options) ? (\n // #8236: extend call and options.name access are considered side-effects\n // by Rollup, so we have to wrap it in a pure-annotated IIFE.\n (() => extend({ name: options.name }, extraOptions, { setup: options }))()\n ) : options;\n}\nfunction useId() {\n const i = getCurrentInstance();\n if (i) {\n return (i.appContext.config.idPrefix || \"v\") + \"-\" + i.ids[0] + i.ids[1]++;\n } else if (true) {\n warn$1(\n `useId() is called when there is no active component instance to be associated with.`\n );\n }\n return \"\";\n}\nfunction markAsyncBoundary(instance) {\n instance.ids = [instance.ids[0] + instance.ids[2]++ + \"-\", 0, 0];\n}\nvar knownTemplateRefs = /* @__PURE__ */ new WeakSet();\nfunction useTemplateRef(key) {\n const i = getCurrentInstance();\n const r = shallowRef(null);\n if (i) {\n const refs = i.refs === EMPTY_OBJ ? i.refs = {} : i.refs;\n let desc;\n if ((desc = Object.getOwnPropertyDescriptor(refs, key)) && !desc.configurable) {\n warn$1(`useTemplateRef('${key}') already exists.`);\n } else {\n Object.defineProperty(refs, key, {\n enumerable: true,\n get: () => r.value,\n set: (val) => r.value = val\n });\n }\n } else if (true) {\n warn$1(\n `useTemplateRef() is called when there is no active component instance to be associated with.`\n );\n }\n const ret = true ? readonly(r) : r;\n if (true) {\n knownTemplateRefs.add(ret);\n }\n return ret;\n}\nfunction setRef(rawRef, oldRawRef, parentSuspense, vnode, isUnmount = false) {\n if (isArray(rawRef)) {\n rawRef.forEach(\n (r, i) => setRef(\n r,\n oldRawRef && (isArray(oldRawRef) ? oldRawRef[i] : oldRawRef),\n parentSuspense,\n vnode,\n isUnmount\n )\n );\n return;\n }\n if (isAsyncWrapper(vnode) && !isUnmount) {\n if (vnode.shapeFlag & 512 && vnode.type.__asyncResolved && vnode.component.subTree.component) {\n setRef(rawRef, oldRawRef, parentSuspense, vnode.component.subTree);\n }\n return;\n }\n const refValue = vnode.shapeFlag & 4 ? getComponentPublicInstance(vnode.component) : vnode.el;\n const value = isUnmount ? null : refValue;\n const { i: owner, r: ref2 } = rawRef;\n if (!owner) {\n warn$1(\n `Missing ref owner context. ref cannot be used on hoisted vnodes. A vnode with ref must be created inside the render function.`\n );\n return;\n }\n const oldRef = oldRawRef && oldRawRef.r;\n const refs = owner.refs === EMPTY_OBJ ? owner.refs = {} : owner.refs;\n const setupState = owner.setupState;\n const rawSetupState = toRaw(setupState);\n const canSetSetupRef = setupState === EMPTY_OBJ ? () => false : (key) => {\n if (true) {\n if (hasOwn(rawSetupState, key) && !isRef2(rawSetupState[key])) {\n warn$1(\n `Template ref \"${key}\" used on a non-ref value. It will not work in the production build.`\n );\n }\n if (knownTemplateRefs.has(rawSetupState[key])) {\n return false;\n }\n }\n return hasOwn(rawSetupState, key);\n };\n if (oldRef != null && oldRef !== ref2) {\n if (isString(oldRef)) {\n refs[oldRef] = null;\n if (canSetSetupRef(oldRef)) {\n setupState[oldRef] = null;\n }\n } else if (isRef2(oldRef)) {\n oldRef.value = null;\n }\n }\n if (isFunction(ref2)) {\n callWithErrorHandling(ref2, owner, 12, [value, refs]);\n } else {\n const _isString = isString(ref2);\n const _isRef = isRef2(ref2);\n if (_isString || _isRef) {\n const doSet = () => {\n if (rawRef.f) {\n const existing = _isString ? canSetSetupRef(ref2) ? setupState[ref2] : refs[ref2] : ref2.value;\n if (isUnmount) {\n isArray(existing) && remove(existing, refValue);\n } else {\n if (!isArray(existing)) {\n if (_isString) {\n refs[ref2] = [refValue];\n if (canSetSetupRef(ref2)) {\n setupState[ref2] = refs[ref2];\n }\n } else {\n ref2.value = [refValue];\n if (rawRef.k) refs[rawRef.k] = ref2.value;\n }\n } else if (!existing.includes(refValue)) {\n existing.push(refValue);\n }\n }\n } else if (_isString) {\n refs[ref2] = value;\n if (canSetSetupRef(ref2)) {\n setupState[ref2] = value;\n }\n } else if (_isRef) {\n ref2.value = value;\n if (rawRef.k) refs[rawRef.k] = value;\n } else if (true) {\n warn$1(\"Invalid template ref type:\", ref2, `(${typeof ref2})`);\n }\n };\n if (value) {\n doSet.id = -1;\n queuePostRenderEffect(doSet, parentSuspense);\n } else {\n doSet();\n }\n } else if (true) {\n warn$1(\"Invalid template ref type:\", ref2, `(${typeof ref2})`);\n }\n }\n}\nvar hasLoggedMismatchError = false;\nvar logMismatchError = () => {\n if (hasLoggedMismatchError) {\n return;\n }\n console.error(\"Hydration completed but contains mismatches.\");\n hasLoggedMismatchError = true;\n};\nvar isSVGContainer = (container) => container.namespaceURI.includes(\"svg\") && container.tagName !== \"foreignObject\";\nvar isMathMLContainer = (container) => container.namespaceURI.includes(\"MathML\");\nvar getContainerType = (container) => {\n if (container.nodeType !== 1) return void 0;\n if (isSVGContainer(container)) return \"svg\";\n if (isMathMLContainer(container)) return \"mathml\";\n return void 0;\n};\nvar isComment = (node) => node.nodeType === 8;\nfunction createHydrationFunctions(rendererInternals) {\n const {\n mt: mountComponent,\n p: patch,\n o: {\n patchProp: patchProp2,\n createText,\n nextSibling,\n parentNode,\n remove: remove2,\n insert,\n createComment\n }\n } = rendererInternals;\n const hydrate2 = (vnode, container) => {\n if (!container.hasChildNodes()) {\n warn$1(\n `Attempting to hydrate existing markup but container is empty. Performing full mount instead.`\n );\n patch(null, vnode, container);\n flushPostFlushCbs();\n container._vnode = vnode;\n return;\n }\n hydrateNode(container.firstChild, vnode, null, null, null);\n flushPostFlushCbs();\n container._vnode = vnode;\n };\n const hydrateNode = (node, vnode, parentComponent, parentSuspense, slotScopeIds, optimized = false) => {\n optimized = optimized || !!vnode.dynamicChildren;\n const isFragmentStart = isComment(node) && node.data === \"[\";\n const onMismatch = () => handleMismatch(\n node,\n vnode,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n isFragmentStart\n );\n const { type, ref: ref2, shapeFlag, patchFlag } = vnode;\n let domType = node.nodeType;\n vnode.el = node;\n if (true) {\n def(node, \"__vnode\", vnode, true);\n def(node, \"__vueParentComponent\", parentComponent, true);\n }\n if (patchFlag === -2) {\n optimized = false;\n vnode.dynamicChildren = null;\n }\n let nextNode = null;\n switch (type) {\n case Text:\n if (domType !== 3) {\n if (vnode.children === \"\") {\n insert(vnode.el = createText(\"\"), parentNode(node), node);\n nextNode = node;\n } else {\n nextNode = onMismatch();\n }\n } else {\n if (node.data !== vnode.children) {\n warn$1(\n `Hydration text mismatch in`,\n node.parentNode,\n `\n - rendered on server: ${JSON.stringify(\n node.data\n )}\n - expected on client: ${JSON.stringify(vnode.children)}`\n );\n logMismatchError();\n node.data = vnode.children;\n }\n nextNode = nextSibling(node);\n }\n break;\n case Comment:\n if (isTemplateNode(node)) {\n nextNode = nextSibling(node);\n replaceNode(\n vnode.el = node.content.firstChild,\n node,\n parentComponent\n );\n } else if (domType !== 8 || isFragmentStart) {\n nextNode = onMismatch();\n } else {\n nextNode = nextSibling(node);\n }\n break;\n case Static:\n if (isFragmentStart) {\n node = nextSibling(node);\n domType = node.nodeType;\n }\n if (domType === 1 || domType === 3) {\n nextNode = node;\n const needToAdoptContent = !vnode.children.length;\n for (let i = 0; i < vnode.staticCount; i++) {\n if (needToAdoptContent)\n vnode.children += nextNode.nodeType === 1 ? nextNode.outerHTML : nextNode.data;\n if (i === vnode.staticCount - 1) {\n vnode.anchor = nextNode;\n }\n nextNode = nextSibling(nextNode);\n }\n return isFragmentStart ? nextSibling(nextNode) : nextNode;\n } else {\n onMismatch();\n }\n break;\n case Fragment:\n if (!isFragmentStart) {\n nextNode = onMismatch();\n } else {\n nextNode = hydrateFragment(\n node,\n vnode,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n }\n break;\n default:\n if (shapeFlag & 1) {\n if ((domType !== 1 || vnode.type.toLowerCase() !== node.tagName.toLowerCase()) && !isTemplateNode(node)) {\n nextNode = onMismatch();\n } else {\n nextNode = hydrateElement(\n node,\n vnode,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n }\n } else if (shapeFlag & 6) {\n vnode.slotScopeIds = slotScopeIds;\n const container = parentNode(node);\n if (isFragmentStart) {\n nextNode = locateClosingAnchor(node);\n } else if (isComment(node) && node.data === \"teleport start\") {\n nextNode = locateClosingAnchor(node, node.data, \"teleport end\");\n } else {\n nextNode = nextSibling(node);\n }\n mountComponent(\n vnode,\n container,\n null,\n parentComponent,\n parentSuspense,\n getContainerType(container),\n optimized\n );\n if (isAsyncWrapper(vnode) && !vnode.type.__asyncResolved) {\n let subTree;\n if (isFragmentStart) {\n subTree = createVNode(Fragment);\n subTree.anchor = nextNode ? nextNode.previousSibling : container.lastChild;\n } else {\n subTree = node.nodeType === 3 ? createTextVNode(\"\") : createVNode(\"div\");\n }\n subTree.el = node;\n vnode.component.subTree = subTree;\n }\n } else if (shapeFlag & 64) {\n if (domType !== 8) {\n nextNode = onMismatch();\n } else {\n nextNode = vnode.type.hydrate(\n node,\n vnode,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized,\n rendererInternals,\n hydrateChildren\n );\n }\n } else if (shapeFlag & 128) {\n nextNode = vnode.type.hydrate(\n node,\n vnode,\n parentComponent,\n parentSuspense,\n getContainerType(parentNode(node)),\n slotScopeIds,\n optimized,\n rendererInternals,\n hydrateNode\n );\n } else if (true) {\n warn$1(\"Invalid HostVNode type:\", type, `(${typeof type})`);\n }\n }\n if (ref2 != null) {\n setRef(ref2, null, parentSuspense, vnode);\n }\n return nextNode;\n };\n const hydrateElement = (el, vnode, parentComponent, parentSuspense, slotScopeIds, optimized) => {\n optimized = optimized || !!vnode.dynamicChildren;\n const { type, props, patchFlag, shapeFlag, dirs, transition } = vnode;\n const forcePatch = type === \"input\" || type === \"option\";\n if (true) {\n if (dirs) {\n invokeDirectiveHook(vnode, null, parentComponent, \"created\");\n }\n let needCallTransitionHooks = false;\n if (isTemplateNode(el)) {\n needCallTransitionHooks = needTransition(\n null,\n // no need check parentSuspense in hydration\n transition\n ) && parentComponent && parentComponent.vnode.props && parentComponent.vnode.props.appear;\n const content = el.content.firstChild;\n if (needCallTransitionHooks) {\n transition.beforeEnter(content);\n }\n replaceNode(content, el, parentComponent);\n vnode.el = el = content;\n }\n if (shapeFlag & 16 && // skip if element has innerHTML / textContent\n !(props && (props.innerHTML || props.textContent))) {\n let next = hydrateChildren(\n el.firstChild,\n vnode,\n el,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n let hasWarned2 = false;\n while (next) {\n if (!isMismatchAllowed(\n el,\n 1\n /* CHILDREN */\n )) {\n if (!hasWarned2) {\n warn$1(\n `Hydration children mismatch on`,\n el,\n `\nServer rendered element contains more child nodes than client vdom.`\n );\n hasWarned2 = true;\n }\n logMismatchError();\n }\n const cur = next;\n next = next.nextSibling;\n remove2(cur);\n }\n } else if (shapeFlag & 8) {\n let clientText = vnode.children;\n if (clientText[0] === \"\\n\" && (el.tagName === \"PRE\" || el.tagName === \"TEXTAREA\")) {\n clientText = clientText.slice(1);\n }\n if (el.textContent !== clientText) {\n if (!isMismatchAllowed(\n el,\n 0\n /* TEXT */\n )) {\n warn$1(\n `Hydration text content mismatch on`,\n el,\n `\n - rendered on server: ${el.textContent}\n - expected on client: ${vnode.children}`\n );\n logMismatchError();\n }\n el.textContent = vnode.children;\n }\n }\n if (props) {\n if (true) {\n const isCustomElement = el.tagName.includes(\"-\");\n for (const key in props) {\n if (// #11189 skip if this node has directives that have created hooks\n // as it could have mutated the DOM in any possible way\n !(dirs && dirs.some((d) => d.dir.created)) && propHasMismatch(el, key, props[key], vnode, parentComponent)) {\n logMismatchError();\n }\n if (forcePatch && (key.endsWith(\"value\") || key === \"indeterminate\") || isOn(key) && !isReservedProp(key) || // force hydrate v-bind with .prop modifiers\n key[0] === \".\" || isCustomElement) {\n patchProp2(el, key, null, props[key], void 0, parentComponent);\n }\n }\n } else if (props.onClick) {\n patchProp2(\n el,\n \"onClick\",\n null,\n props.onClick,\n void 0,\n parentComponent\n );\n } else if (patchFlag & 4 && isReactive(props.style)) {\n for (const key in props.style) props.style[key];\n }\n }\n let vnodeHooks;\n if (vnodeHooks = props && props.onVnodeBeforeMount) {\n invokeVNodeHook(vnodeHooks, parentComponent, vnode);\n }\n if (dirs) {\n invokeDirectiveHook(vnode, null, parentComponent, \"beforeMount\");\n }\n if ((vnodeHooks = props && props.onVnodeMounted) || dirs || needCallTransitionHooks) {\n queueEffectWithSuspense(() => {\n vnodeHooks && invokeVNodeHook(vnodeHooks, parentComponent, vnode);\n needCallTransitionHooks && transition.enter(el);\n dirs && invokeDirectiveHook(vnode, null, parentComponent, \"mounted\");\n }, parentSuspense);\n }\n }\n return el.nextSibling;\n };\n const hydrateChildren = (node, parentVNode, container, parentComponent, parentSuspense, slotScopeIds, optimized) => {\n optimized = optimized || !!parentVNode.dynamicChildren;\n const children = parentVNode.children;\n const l = children.length;\n let hasWarned2 = false;\n for (let i = 0; i < l; i++) {\n const vnode = optimized ? children[i] : children[i] = normalizeVNode(children[i]);\n const isText = vnode.type === Text;\n if (node) {\n if (isText && !optimized) {\n if (i + 1 < l && normalizeVNode(children[i + 1]).type === Text) {\n insert(\n createText(\n node.data.slice(vnode.children.length)\n ),\n container,\n nextSibling(node)\n );\n node.data = vnode.children;\n }\n }\n node = hydrateNode(\n node,\n vnode,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n } else if (isText && !vnode.children) {\n insert(vnode.el = createText(\"\"), container);\n } else {\n if (!isMismatchAllowed(\n container,\n 1\n /* CHILDREN */\n )) {\n if (!hasWarned2) {\n warn$1(\n `Hydration children mismatch on`,\n container,\n `\nServer rendered element contains fewer child nodes than client vdom.`\n );\n hasWarned2 = true;\n }\n logMismatchError();\n }\n patch(\n null,\n vnode,\n container,\n null,\n parentComponent,\n parentSuspense,\n getContainerType(container),\n slotScopeIds\n );\n }\n }\n return node;\n };\n const hydrateFragment = (node, vnode, parentComponent, parentSuspense, slotScopeIds, optimized) => {\n const { slotScopeIds: fragmentSlotScopeIds } = vnode;\n if (fragmentSlotScopeIds) {\n slotScopeIds = slotScopeIds ? slotScopeIds.concat(fragmentSlotScopeIds) : fragmentSlotScopeIds;\n }\n const container = parentNode(node);\n const next = hydrateChildren(\n nextSibling(node),\n vnode,\n container,\n parentComponent,\n parentSuspense,\n slotScopeIds,\n optimized\n );\n if (next && isComment(next) && next.data === \"]\") {\n return nextSibling(vnode.anchor = next);\n } else {\n logMismatchError();\n insert(vnode.anchor = createComment(`]`), container, next);\n return next;\n }\n };\n const handleMismatch = (node, vnode, parentComponent, parentSuspense, slotScopeIds, isFragment) => {\n if (!isMismatchAllowed(\n node.parentElement,\n 1\n /* CHILDREN */\n )) {\n warn$1(\n `Hydration node mismatch:\n- rendered on server:`,\n node,\n node.nodeType === 3 ? `(text)` : isComment(node) && node.data === \"[\" ? `(start of fragment)` : ``,\n `\n- expected on client:`,\n vnode.type\n );\n logMismatchError();\n }\n vnode.el = null;\n if (isFragment) {\n const end = locateClosingAnchor(node);\n while (true) {\n const next2 = nextSibling(node);\n if (next2 && next2 !== end) {\n remove2(next2);\n } else {\n break;\n }\n }\n }\n const next = nextSibling(node);\n const container = parentNode(node);\n remove2(node);\n patch(\n null,\n vnode,\n container,\n next,\n parentComponent,\n parentSuspense,\n getContainerType(container),\n slotScopeIds\n );\n if (parentComponent) {\n parentComponent.vnode.el = vnode.el;\n updateHOCHostEl(parentComponent, vnode.el);\n }\n return next;\n };\n const locateClosingAnchor = (node, open = \"[\", close = \"]\") => {\n let match = 0;\n while (node) {\n node = nextSibling(node);\n if (node && isComment(node)) {\n if (node.data === open) match++;\n if (node.data === close) {\n if (match === 0) {\n return nextSibling(node);\n } else {\n match--;\n }\n }\n }\n }\n return node;\n };\n const replaceNode = (newNode, oldNode, parentComponent) => {\n const parentNode2 = oldNode.parentNode;\n if (parentNode2) {\n parentNode2.replaceChild(newNode, oldNode);\n }\n let parent = parentComponent;\n while (parent) {\n if (parent.vnode.el === oldNode) {\n parent.vnode.el = parent.subTree.el = newNode;\n }\n parent = parent.parent;\n }\n };\n const isTemplateNode = (node) => {\n return node.nodeType === 1 && node.tagName === \"TEMPLATE\";\n };\n return [hydrate2, hydrateNode];\n}\nfunction propHasMismatch(el, key, clientValue, vnode, instance) {\n let mismatchType;\n let mismatchKey;\n let actual;\n let expected;\n if (key === \"class\") {\n actual = el.getAttribute(\"class\");\n expected = normalizeClass(clientValue);\n if (!isSetEqual(toClassSet(actual || \"\"), toClassSet(expected))) {\n mismatchType = 2;\n mismatchKey = `class`;\n }\n } else if (key === \"style\") {\n actual = el.getAttribute(\"style\") || \"\";\n expected = isString(clientValue) ? clientValue : stringifyStyle(normalizeStyle(clientValue));\n const actualMap = toStyleMap(actual);\n const expectedMap = toStyleMap(expected);\n if (vnode.dirs) {\n for (const { dir, value } of vnode.dirs) {\n if (dir.name === \"show\" && !value) {\n expectedMap.set(\"display\", \"none\");\n }\n }\n }\n if (instance) {\n resolveCssVars(instance, vnode, expectedMap);\n }\n if (!isMapEqual(actualMap, expectedMap)) {\n mismatchType = 3;\n mismatchKey = \"style\";\n }\n } else if (el instanceof SVGElement && isKnownSvgAttr(key) || el instanceof HTMLElement && (isBooleanAttr(key) || isKnownHtmlAttr(key))) {\n if (isBooleanAttr(key)) {\n actual = el.hasAttribute(key);\n expected = includeBooleanAttr(clientValue);\n } else if (clientValue == null) {\n actual = el.hasAttribute(key);\n expected = false;\n } else {\n if (el.hasAttribute(key)) {\n actual = el.getAttribute(key);\n } else if (key === \"value\" && el.tagName === \"TEXTAREA\") {\n actual = el.value;\n } else {\n actual = false;\n }\n expected = isRenderableAttrValue(clientValue) ? String(clientValue) : false;\n }\n if (actual !== expected) {\n mismatchType = 4;\n mismatchKey = key;\n }\n }\n if (mismatchType != null && !isMismatchAllowed(el, mismatchType)) {\n const format = (v) => v === false ? `(not rendered)` : `${mismatchKey}=\"${v}\"`;\n const preSegment = `Hydration ${MismatchTypeString[mismatchType]} mismatch on`;\n const postSegment = `\n - rendered on server: ${format(actual)}\n - expected on client: ${format(expected)}\n Note: this mismatch is check-only. The DOM will not be rectified in production due to performance overhead.\n You should fix the source of the mismatch.`;\n {\n warn$1(preSegment, el, postSegment);\n }\n return true;\n }\n return false;\n}\nfunction toClassSet(str) {\n return new Set(str.trim().split(/\\s+/));\n}\nfunction isSetEqual(a, b) {\n if (a.size !== b.size) {\n return false;\n }\n for (const s of a) {\n if (!b.has(s)) {\n return false;\n }\n }\n return true;\n}\nfunction toStyleMap(str) {\n const styleMap = /* @__PURE__ */ new Map();\n for (const item of str.split(\";\")) {\n let [key, value] = item.split(\":\");\n key = key.trim();\n value = value && value.trim();\n if (key && value) {\n styleMap.set(key, value);\n }\n }\n return styleMap;\n}\nfunction isMapEqual(a, b) {\n if (a.size !== b.size) {\n return false;\n }\n for (const [key, value] of a) {\n if (value !== b.get(key)) {\n return false;\n }\n }\n return true;\n}\nfunction resolveCssVars(instance, vnode, expectedMap) {\n const root = instance.subTree;\n if (instance.getCssVars && (vnode === root || root && root.type === Fragment && root.children.includes(vnode))) {\n const cssVars = instance.getCssVars();\n for (const key in cssVars) {\n expectedMap.set(\n `--${getEscapedCssVarName(key, false)}`,\n String(cssVars[key])\n );\n }\n }\n if (vnode === root && instance.parent) {\n resolveCssVars(instance.parent, instance.vnode, expectedMap);\n }\n}\nvar allowMismatchAttr = \"data-allow-mismatch\";\nvar MismatchTypeString = {\n [\n 0\n /* TEXT */\n ]: \"text\",\n [\n 1\n /* CHILDREN */\n ]: \"children\",\n [\n 2\n /* CLASS */\n ]: \"class\",\n [\n 3\n /* STYLE */\n ]: \"style\",\n [\n 4\n /* ATTRIBUTE */\n ]: \"attribute\"\n};\nfunction isMismatchAllowed(el, allowedType) {\n if (allowedType === 0 || allowedType === 1) {\n while (el && !el.hasAttribute(allowMismatchAttr)) {\n el = el.parentElement;\n }\n }\n const allowedAttr = el && el.getAttribute(allowMismatchAttr);\n if (allowedAttr == null) {\n return false;\n } else if (allowedAttr === \"\") {\n return true;\n } else {\n const list = allowedAttr.split(\",\");\n if (allowedType === 0 && list.includes(\"children\")) {\n return true;\n }\n return allowedAttr.split(\",\").includes(MismatchTypeString[allowedType]);\n }\n}\nvar requestIdleCallback = getGlobalThis().requestIdleCallback || ((cb) => setTimeout(cb, 1));\nvar cancelIdleCallback = getGlobalThis().cancelIdleCallback || ((id) => clearTimeout(id));\nvar hydrateOnIdle = (timeout = 1e4) => (hydrate2) => {\n const id = requestIdleCallback(hydrate2, { timeout });\n return () => cancelIdleCallback(id);\n};\nfunction elementIsVisibleInViewport(el) {\n const { top, left, bottom, right } = el.getBoundingClientRect();\n const { innerHeight, innerWidth } = window;\n return (top > 0 && top < innerHeight || bottom > 0 && bottom < innerHeight) && (left > 0 && left < innerWidth || right > 0 && right < innerWidth);\n}\nvar hydrateOnVisible = (opts) => (hydrate2, forEach) => {\n const ob = new IntersectionObserver((entries) => {\n for (const e of entries) {\n if (!e.isIntersecting) continue;\n ob.disconnect();\n hydrate2();\n break;\n }\n }, opts);\n forEach((el) => {\n if (!(el instanceof Element)) return;\n if (elementIsVisibleInViewport(el)) {\n hydrate2();\n ob.disconnect();\n return false;\n }\n ob.observe(el);\n });\n return () => ob.disconnect();\n};\nvar hydrateOnMediaQuery = (query) => (hydrate2) => {\n if (query) {\n const mql = matchMedia(query);\n if (mql.matches) {\n hydrate2();\n } else {\n mql.addEventListener(\"change\", hydrate2, { once: true });\n return () => mql.removeEventListener(\"change\", hydrate2);\n }\n }\n};\nvar hydrateOnInteraction = (interactions = []) => (hydrate2, forEach) => {\n if (isString(interactions)) interactions = [interactions];\n let hasHydrated = false;\n const doHydrate = (e) => {\n if (!hasHydrated) {\n hasHydrated = true;\n teardown();\n hydrate2();\n e.target.dispatchEvent(new e.constructor(e.type, e));\n }\n };\n const teardown = () => {\n forEach((el) => {\n for (const i of interactions) {\n el.removeEventListener(i, doHydrate);\n }\n });\n };\n forEach((el) => {\n for (const i of interactions) {\n el.addEventListener(i, doHydrate, { once: true });\n }\n });\n return teardown;\n};\nfunction forEachElement(node, cb) {\n if (isComment(node) && node.data === \"[\") {\n let depth = 1;\n let next = node.nextSibling;\n while (next) {\n if (next.nodeType === 1) {\n const result = cb(next);\n if (result === false) {\n break;\n }\n } else if (isComment(next)) {\n if (next.data === \"]\") {\n if (--depth === 0) break;\n } else if (next.data === \"[\") {\n depth++;\n }\n }\n next = next.nextSibling;\n }\n } else {\n cb(node);\n }\n}\nvar isAsyncWrapper = (i) => !!i.type.__asyncLoader;\nfunction defineAsyncComponent(source) {\n if (isFunction(source)) {\n source = { loader: source };\n }\n const {\n loader,\n loadingComponent,\n errorComponent,\n delay = 200,\n hydrate: hydrateStrategy,\n timeout,\n // undefined = never times out\n suspensible = true,\n onError: userOnError\n } = source;\n let pendingRequest = null;\n let resolvedComp;\n let retries = 0;\n const retry = () => {\n retries++;\n pendingRequest = null;\n return load();\n };\n const load = () => {\n let thisRequest;\n return pendingRequest || (thisRequest = pendingRequest = loader().catch((err) => {\n err = err instanceof Error ? err : new Error(String(err));\n if (userOnError) {\n return new Promise((resolve2, reject) => {\n const userRetry = () => resolve2(retry());\n const userFail = () => reject(err);\n userOnError(err, userRetry, userFail, retries + 1);\n });\n } else {\n throw err;\n }\n }).then((comp) => {\n if (thisRequest !== pendingRequest && pendingRequest) {\n return pendingRequest;\n }\n if (!comp) {\n warn$1(\n `Async component loader resolved to undefined. If you are using retry(), make sure to return its return value.`\n );\n }\n if (comp && (comp.__esModule || comp[Symbol.toStringTag] === \"Module\")) {\n comp = comp.default;\n }\n if (comp && !isObject(comp) && !isFunction(comp)) {\n throw new Error(`Invalid async component load result: ${comp}`);\n }\n resolvedComp = comp;\n return comp;\n }));\n };\n return defineComponent({\n name: \"AsyncComponentWrapper\",\n __asyncLoader: load,\n __asyncHydrate(el, instance, hydrate2) {\n const doHydrate = hydrateStrategy ? () => {\n const teardown = hydrateStrategy(\n hydrate2,\n (cb) => forEachElement(el, cb)\n );\n if (teardown) {\n (instance.bum || (instance.bum = [])).push(teardown);\n }\n } : hydrate2;\n if (resolvedComp) {\n doHydrate();\n } else {\n load().then(() => !instance.isUnmounted && doHydrate());\n }\n },\n get __asyncResolved() {\n return resolvedComp;\n },\n setup() {\n const instance = currentInstance;\n markAsyncBoundary(instance);\n if (resolvedComp) {\n return () => createInnerComp(resolvedComp, instance);\n }\n const onError = (err) => {\n pendingRequest = null;\n handleError(\n err,\n instance,\n 13,\n !errorComponent\n );\n };\n if (suspensible && instance.suspense || isInSSRComponentSetup) {\n return load().then((comp) => {\n return () => createInnerComp(comp, instance);\n }).catch((err) => {\n onError(err);\n return () => errorComponent ? createVNode(errorComponent, {\n error: err\n }) : null;\n });\n }\n const loaded = ref(false);\n const error = ref();\n const delayed = ref(!!delay);\n if (delay) {\n setTimeout(() => {\n delayed.value = false;\n }, delay);\n }\n if (timeout != null) {\n setTimeout(() => {\n if (!loaded.value && !error.value) {\n const err = new Error(\n `Async component timed out after ${timeout}ms.`\n );\n onError(err);\n error.value = err;\n }\n }, timeout);\n }\n load().then(() => {\n loaded.value = true;\n if (instance.parent && isKeepAlive(instance.parent.vnode)) {\n instance.parent.update();\n }\n }).catch((err) => {\n onError(err);\n error.value = err;\n });\n return () => {\n if (loaded.value && resolvedComp) {\n return createInnerComp(resolvedComp, instance);\n } else if (error.value && errorComponent) {\n return createVNode(errorComponent, {\n error: error.value\n });\n } else if (loadingComponent && !delayed.value) {\n return createVNode(loadingComponent);\n }\n };\n }\n });\n}\nfunction createInnerComp(comp, parent) {\n const { ref: ref2, props, children, ce } = parent.vnode;\n const vnode = createVNode(comp, props, children);\n vnode.ref = ref2;\n vnode.ce = ce;\n delete parent.vnode.ce;\n return vnode;\n}\nvar isKeepAlive = (vnode) => vnode.type.__isKeepAlive;\nvar KeepAliveImpl = {\n name: `KeepAlive`,\n // Marker for special handling inside the renderer. We are not using a ===\n // check directly on KeepAlive in the renderer, because importing it directly\n // would prevent it from being tree-shaken.\n __isKeepAlive: true,\n props: {\n include: [String, RegExp, Array],\n exclude: [String, RegExp, Array],\n max: [String, Number]\n },\n setup(props, { slots }) {\n const instance = getCurrentInstance();\n const sharedContext = instance.ctx;\n if (!sharedContext.renderer) {\n return () => {\n const children = slots.default && slots.default();\n return children && children.length === 1 ? children[0] : children;\n };\n }\n const cache = /* @__PURE__ */ new Map();\n const keys = /* @__PURE__ */ new Set();\n let current = null;\n if (true) {\n instance.__v_cache = cache;\n }\n const parentSuspense = instance.suspense;\n const {\n renderer: {\n p: patch,\n m: move,\n um: _unmount,\n o: { createElement }\n }\n } = sharedContext;\n const storageContainer = createElement(\"div\");\n sharedContext.activate = (vnode, container, anchor, namespace, optimized) => {\n const instance2 = vnode.component;\n move(vnode, container, anchor, 0, parentSuspense);\n patch(\n instance2.vnode,\n vnode,\n container,\n anchor,\n instance2,\n parentSuspense,\n namespace,\n vnode.slotScopeIds,\n optimized\n );\n queuePostRenderEffect(() => {\n instance2.isDeactivated = false;\n if (instance2.a) {\n invokeArrayFns(instance2.a);\n }\n const vnodeHook = vnode.props && vnode.props.onVnodeMounted;\n if (vnodeHook) {\n invokeVNodeHook(vnodeHook, instance2.parent, vnode);\n }\n }, parentSuspense);\n if (true) {\n devtoolsComponentAdded(instance2);\n }\n };\n sharedContext.deactivate = (vnode) => {\n const instance2 = vnode.component;\n invalidateMount(instance2.m);\n invalidateMount(instance2.a);\n move(vnode, storageContainer, null, 1, parentSuspense);\n queuePostRenderEffect(() => {\n if (instance2.da) {\n invokeArrayFns(instance2.da);\n }\n const vnodeHook = vnode.props && vnode.props.onVnodeUnmounted;\n if (vnodeHook) {\n invokeVNodeHook(vnodeHook, instance2.parent, vnode);\n }\n instance2.isDeactivated = true;\n }, parentSuspense);\n if (true) {\n devtoolsComponentAdded(instance2);\n }\n };\n function unmount(vnode) {\n resetShapeFlag(vnode);\n _unmount(vnode, instance, parentSuspense, true);\n }\n function pruneCache(filter) {\n cache.forEach((vnode, key) => {\n const name = getComponentName(vnode.type);\n if (name && !filter(name)) {\n pruneCacheEntry(key);\n }\n });\n }\n function pruneCacheEntry(key) {\n const cached = cache.get(key);\n if (cached && (!current || !isSameVNodeType(cached, current))) {\n unmount(cached);\n } else if (current) {\n resetShapeFlag(current);\n }\n cache.delete(key);\n keys.delete(key);\n }\n watch2(\n () => [props.include, props.exclude],\n ([include, exclude]) => {\n include && pruneCache((name) => matches(include, name));\n exclude && pruneCache((name) => !matches(exclude, name));\n },\n // prune post-render after `current` has been updated\n { flush: \"post\", deep: true }\n );\n let pendingCacheKey = null;\n const cacheSubtree = () => {\n if (pendingCacheKey != null) {\n if (isSuspense(instance.subTree.type)) {\n queuePostRenderEffect(() => {\n cache.set(pendingCacheKey, getInnerChild(instance.subTree));\n }, instance.subTree.suspense);\n } else {\n cache.set(pendingCacheKey, getInnerChild(instance.subTree));\n }\n }\n };\n onMounted(cacheSubtree);\n onUpdated(cacheSubtree);\n onBeforeUnmount(() => {\n cache.forEach((cached) => {\n const { subTree, suspense } = instance;\n const vnode = getInnerChild(subTree);\n if (cached.type === vnode.type && cached.key === vnode.key) {\n resetShapeFlag(vnode);\n const da = vnode.component.da;\n da && queuePostRenderEffect(da, suspense);\n return;\n }\n unmount(cached);\n });\n });\n return () => {\n pendingCacheKey = null;\n if (!slots.default) {\n return current = null;\n }\n const children = slots.default();\n const rawVNode = children[0];\n if (children.length > 1) {\n if (true) {\n warn$1(`KeepAlive should contain exactly one component child.`);\n }\n current = null;\n return children;\n } else if (!isVNode(rawVNode) || !(rawVNode.shapeFlag & 4) && !(rawVNode.shapeFlag & 128)) {\n current = null;\n return rawVNode;\n }\n let vnode = getInnerChild(rawVNode);\n if (vnode.type === Comment) {\n current = null;\n return vnode;\n }\n const comp = vnode.type;\n const name = getComponentName(\n isAsyncWrapper(vnode) ? vnode.type.__asyncResolved || {} : comp\n );\n const { include, exclude, max } = props;\n if (include && (!name || !matches(include, name)) || exclude && name && matches(exclude, name)) {\n vnode.shapeFlag &= ~256;\n current = vnode;\n return rawVNode;\n }\n const key = vnode.key == null ? comp : vnode.key;\n const cachedVNode = cache.get(key);\n if (vnode.el) {\n vnode = cloneVNode(vnode);\n if (rawVNode.shapeFlag & 128) {\n rawVNode.ssContent = vnode;\n }\n }\n pendingCacheKey = key;\n if (cachedVNode) {\n vnode.el = cachedVNode.el;\n vnode.component = cachedVNode.component;\n if (vnode.transition) {\n setTransitionHooks(vnode, vnode.transition);\n }\n vnode.shapeFlag |= 512;\n keys.delete(key);\n keys.add(key);\n } else {\n keys.add(key);\n if (max && keys.size > parseInt(max, 10)) {\n pruneCacheEntry(keys.values().next().value);\n }\n }\n vnode.shapeFlag |= 256;\n current = vnode;\n return isSuspense(rawVNode.type) ? rawVNode : vnode;\n };\n }\n};\nvar KeepAlive = KeepAliveImpl;\nfunction matches(pattern, name) {\n if (isArray(pattern)) {\n return pattern.some((p2) => matches(p2, name));\n } else if (isString(pattern)) {\n return pattern.split(\",\").includes(name);\n } else if (isRegExp(pattern)) {\n pattern.lastIndex = 0;\n return pattern.test(name);\n }\n return false;\n}\nfunction onActivated(hook, target) {\n registerKeepAliveHook(hook, \"a\", target);\n}\nfunction onDeactivated(hook, target) {\n registerKeepAliveHook(hook, \"da\", target);\n}\nfunction registerKeepAliveHook(hook, type, target = currentInstance) {\n const wrappedHook = hook.__wdc || (hook.__wdc = () => {\n let current = target;\n while (current) {\n if (current.isDeactivated) {\n return;\n }\n current = current.parent;\n }\n return hook();\n });\n injectHook(type, wrappedHook, target);\n if (target) {\n let current = target.parent;\n while (current && current.parent) {\n if (isKeepAlive(current.parent.vnode)) {\n injectToKeepAliveRoot(wrappedHook, type, target, current);\n }\n current = current.parent;\n }\n }\n}\nfunction injectToKeepAliveRoot(hook, type, target, keepAliveRoot) {\n const injected = injectHook(\n type,\n hook,\n keepAliveRoot,\n true\n /* prepend */\n );\n onUnmounted(() => {\n remove(keepAliveRoot[type], injected);\n }, target);\n}\nfunction resetShapeFlag(vnode) {\n vnode.shapeFlag &= ~256;\n vnode.shapeFlag &= ~512;\n}\nfunction getInnerChild(vnode) {\n return vnode.shapeFlag & 128 ? vnode.ssContent : vnode;\n}\nfunction injectHook(type, hook, target = currentInstance, prepend = false) {\n if (target) {\n const hooks = target[type] || (target[type] = []);\n const wrappedHook = hook.__weh || (hook.__weh = (...args) => {\n pauseTracking();\n const reset = setCurrentInstance(target);\n const res = callWithAsyncErrorHandling(hook, target, type, args);\n reset();\n resetTracking();\n return res;\n });\n if (prepend) {\n hooks.unshift(wrappedHook);\n } else {\n hooks.push(wrappedHook);\n }\n return wrappedHook;\n } else if (true) {\n const apiName = toHandlerKey(ErrorTypeStrings$1[type].replace(/ hook$/, \"\"));\n warn$1(\n `${apiName} is called when there is no active component instance to be associated with. Lifecycle injection APIs can only be used during execution of setup(). If you are using async setup(), make sure to register lifecycle hooks before the first await statement.`\n );\n }\n}\nvar createHook = (lifecycle) => (hook, target = currentInstance) => {\n if (!isInSSRComponentSetup || lifecycle === \"sp\") {\n injectHook(lifecycle, (...args) => hook(...args), target);\n }\n};\nvar onBeforeMount = createHook(\"bm\");\nvar onMounted = createHook(\"m\");\nvar onBeforeUpdate = createHook(\n \"bu\"\n);\nvar onUpdated = createHook(\"u\");\nvar onBeforeUnmount = createHook(\n \"bum\"\n);\nvar onUnmounted = createHook(\"um\");\nvar onServerPrefetch = createHook(\n \"sp\"\n);\nvar onRenderTriggered = createHook(\"rtg\");\nvar onRenderTracked = createHook(\"rtc\");\nfunction onErrorCaptured(hook, target = currentInstance) {\n injectHook(\"ec\", hook, target);\n}\nvar COMPONENTS = \"components\";\nvar DIRECTIVES = \"directives\";\nfunction resolveComponent(name, maybeSelfReference) {\n return resolveAsset(COMPONENTS, name, true, maybeSelfReference) || name;\n}\nvar NULL_DYNAMIC_COMPONENT = Symbol.for(\"v-ndc\");\nfunction resolveDynamicComponent(component) {\n if (isString(component)) {\n return resolveAsset(COMPONENTS, component, false) || component;\n } else {\n return component || NULL_DYNAMIC_COMPONENT;\n }\n}\nfunction resolveDirective(name) {\n return resolveAsset(DIRECTIVES, name);\n}\nfunction resolveAsset(type, name, warnMissing = true, maybeSelfReference = false) {\n const instance = currentRenderingInstance || currentInstance;\n if (instance) {\n const Component = instance.type;\n if (type === COMPONENTS) {\n const selfName = getComponentName(\n Component,\n false\n );\n if (selfName && (selfName === name || selfName === camelize(name) || selfName === capitalize(camelize(name)))) {\n return Component;\n }\n }\n const res = (\n // local registration\n // check instance[type] first which is resolved for options API\n resolve(instance[type] || Component[type], name) || // global registration\n resolve(instance.appContext[type], name)\n );\n if (!res && maybeSelfReference) {\n return Component;\n }\n if (warnMissing && !res) {\n const extra = type === COMPONENTS ? `\nIf this is a native custom element, make sure to exclude it from component resolution via compilerOptions.isCustomElement.` : ``;\n warn$1(`Failed to resolve ${type.slice(0, -1)}: ${name}${extra}`);\n }\n return res;\n } else if (true) {\n warn$1(\n `resolve${capitalize(type.slice(0, -1))} can only be used in render() or setup().`\n );\n }\n}\nfunction resolve(registry, name) {\n return registry && (registry[name] || registry[camelize(name)] || registry[capitalize(camelize(name))]);\n}\nfunction renderList(source, renderItem, cache, index) {\n let ret;\n const cached = cache && cache[index];\n const sourceIsArray = isArray(source);\n if (sourceIsArray || isString(source)) {\n const sourceIsReactiveArray = sourceIsArray && isReactive(source);\n let needsWrap = false;\n if (sourceIsReactiveArray) {\n needsWrap = !isShallow(source);\n source = shallowReadArray(source);\n }\n ret = new Array(source.length);\n for (let i = 0, l = source.length; i < l; i++) {\n ret[i] = renderItem(\n needsWrap ? toReactive(source[i]) : source[i],\n i,\n void 0,\n cached && cached[i]\n );\n }\n } else if (typeof source === \"number\") {\n if (!Number.isInteger(source)) {\n warn$1(`The v-for range expect an integer value but got ${source}.`);\n }\n ret = new Array(source);\n for (let i = 0; i < source; i++) {\n ret[i] = renderItem(i + 1, i, void 0, cached && cached[i]);\n }\n } else if (isObject(source)) {\n if (source[Symbol.iterator]) {\n ret = Array.from(\n source,\n (item, i) => renderItem(item, i, void 0, cached && cached[i])\n );\n } else {\n const keys = Object.keys(source);\n ret = new Array(keys.length);\n for (let i = 0, l = keys.length; i < l; i++) {\n const key = keys[i];\n ret[i] = renderItem(source[key], key, i, cached && cached[i]);\n }\n }\n } else {\n ret = [];\n }\n if (cache) {\n cache[index] = ret;\n }\n return ret;\n}\nfunction createSlots(slots, dynamicSlots) {\n for (let i = 0; i < dynamicSlots.length; i++) {\n const slot = dynamicSlots[i];\n if (isArray(slot)) {\n for (let j = 0; j < slot.length; j++) {\n slots[slot[j].name] = slot[j].fn;\n }\n } else if (slot) {\n slots[slot.name] = slot.key ? (...args) => {\n const res = slot.fn(...args);\n if (res) res.key = slot.key;\n return res;\n } : slot.fn;\n }\n }\n return slots;\n}\nfunction renderSlot(slots, name, props = {}, fallback, noSlotted) {\n if (currentRenderingInstance.ce || currentRenderingInstance.parent && isAsyncWrapper(currentRenderingInstance.parent) && currentRenderingInstance.parent.ce) {\n if (name !== \"default\") props.name = name;\n return openBlock(), createBlock(\n Fragment,\n null,\n [createVNode(\"slot\", props, fallback && fallback())],\n 64\n );\n }\n let slot = slots[name];\n if (slot && slot.length > 1) {\n warn$1(\n `SSR-optimized slot function detected in a non-SSR-optimized render function. You need to mark this component with $dynamic-slots in the parent template.`\n );\n slot = () => [];\n }\n if (slot && slot._c) {\n slot._d = false;\n }\n openBlock();\n const validSlotContent = slot && ensureValidVNode(slot(props));\n const slotKey = props.key || // slot content array of a dynamic conditional slot may have a branch\n // key attached in the `createSlots` helper, respect that\n validSlotContent && validSlotContent.key;\n const rendered = createBlock(\n Fragment,\n {\n key: (slotKey && !isSymbol(slotKey) ? slotKey : `_${name}`) + // #7256 force differentiate fallback content from actual content\n (!validSlotContent && fallback ? \"_fb\" : \"\")\n },\n validSlotContent || (fallback ? fallback() : []),\n validSlotContent && slots._ === 1 ? 64 : -2\n );\n if (!noSlotted && rendered.scopeId) {\n rendered.slotScopeIds = [rendered.scopeId + \"-s\"];\n }\n if (slot && slot._c) {\n slot._d = true;\n }\n return rendered;\n}\nfunction ensureValidVNode(vnodes) {\n return vnodes.some((child) => {\n if (!isVNode(child)) return true;\n if (child.type === Comment) return false;\n if (child.type === Fragment && !ensureValidVNode(child.children))\n return false;\n return true;\n }) ? vnodes : null;\n}\nfunction toHandlers(obj, preserveCaseIfNecessary) {\n const ret = {};\n if (!isObject(obj)) {\n warn$1(`v-on with no argument expects an object value.`);\n return ret;\n }\n for (const key in obj) {\n ret[preserveCaseIfNecessary && /[A-Z]/.test(key) ? `on:${key}` : toHandlerKey(key)] = obj[key];\n }\n return ret;\n}\nvar getPublicInstance = (i) => {\n if (!i) return null;\n if (isStatefulComponent(i)) return getComponentPublicInstance(i);\n return getPublicInstance(i.parent);\n};\nvar publicPropertiesMap = (\n // Move PURE marker to new line to workaround compiler discarding it\n // due to type annotation\n extend(/* @__PURE__ */ Object.create(null), {\n $: (i) => i,\n $el: (i) => i.vnode.el,\n $data: (i) => i.data,\n $props: (i) => true ? shallowReadonly(i.props) : i.props,\n $attrs: (i) => true ? shallowReadonly(i.attrs) : i.attrs,\n $slots: (i) => true ? shallowReadonly(i.slots) : i.slots,\n $refs: (i) => true ? shallowReadonly(i.refs) : i.refs,\n $parent: (i) => getPublicInstance(i.parent),\n $root: (i) => getPublicInstance(i.root),\n $host: (i) => i.ce,\n $emit: (i) => i.emit,\n $options: (i) => __VUE_OPTIONS_API__ ? resolveMergedOptions(i) : i.type,\n $forceUpdate: (i) => i.f || (i.f = () => {\n queueJob(i.update);\n }),\n $nextTick: (i) => i.n || (i.n = nextTick.bind(i.proxy)),\n $watch: (i) => __VUE_OPTIONS_API__ ? instanceWatch.bind(i) : NOOP\n })\n);\nvar isReservedPrefix = (key) => key === \"_\" || key === \"$\";\nvar hasSetupBinding = (state, key) => state !== EMPTY_OBJ && !state.__isScriptSetup && hasOwn(state, key);\nvar PublicInstanceProxyHandlers = {\n get({ _: instance }, key) {\n if (key === \"__v_skip\") {\n return true;\n }\n const { ctx, setupState, data, props, accessCache, type, appContext } = instance;\n if (key === \"__isVue\") {\n return true;\n }\n let normalizedProps;\n if (key[0] !== \"$\") {\n const n = accessCache[key];\n if (n !== void 0) {\n switch (n) {\n case 1:\n return setupState[key];\n case 2:\n return data[key];\n case 4:\n return ctx[key];\n case 3:\n return props[key];\n }\n } else if (hasSetupBinding(setupState, key)) {\n accessCache[key] = 1;\n return setupState[key];\n } else if (data !== EMPTY_OBJ && hasOwn(data, key)) {\n accessCache[key] = 2;\n return data[key];\n } else if (\n // only cache other properties when instance has declared (thus stable)\n // props\n (normalizedProps = instance.propsOptions[0]) && hasOwn(normalizedProps, key)\n ) {\n accessCache[key] = 3;\n return props[key];\n } else if (ctx !== EMPTY_OBJ && hasOwn(ctx, key)) {\n accessCache[key] = 4;\n return ctx[key];\n } else if (!__VUE_OPTIONS_API__ || shouldCacheAccess) {\n accessCache[key] = 0;\n }\n }\n const publicGetter = publicPropertiesMap[key];\n let cssModule, globalProperties;\n if (publicGetter) {\n if (key === \"$attrs\") {\n track(instance.attrs, \"get\", \"\");\n markAttrsAccessed();\n } else if (key === \"$slots\") {\n track(instance, \"get\", key);\n }\n return publicGetter(instance);\n } else if (\n // css module (injected by vue-loader)\n (cssModule = type.__cssModules) && (cssModule = cssModule[key])\n ) {\n return cssModule;\n } else if (ctx !== EMPTY_OBJ && hasOwn(ctx, key)) {\n accessCache[key] = 4;\n return ctx[key];\n } else if (\n // global properties\n globalProperties = appContext.config.globalProperties, hasOwn(globalProperties, key)\n ) {\n {\n return globalProperties[key];\n }\n } else if (currentRenderingInstance && (!isString(key) || // #1091 avoid internal isRef/isVNode checks on component instance leading\n // to infinite warning loop\n key.indexOf(\"__v\") !== 0)) {\n if (data !== EMPTY_OBJ && isReservedPrefix(key[0]) && hasOwn(data, key)) {\n warn$1(\n `Property ${JSON.stringify(\n key\n )} must be accessed via $data because it starts with a reserved character (\"$\" or \"_\") and is not proxied on the render context.`\n );\n } else if (instance === currentRenderingInstance) {\n warn$1(\n `Property ${JSON.stringify(key)} was accessed during render but is not defined on instance.`\n );\n }\n }\n },\n set({ _: instance }, key, value) {\n const { data, setupState, ctx } = instance;\n if (hasSetupBinding(setupState, key)) {\n setupState[key] = value;\n return true;\n } else if (setupState.__isScriptSetup && hasOwn(setupState, key)) {\n warn$1(`Cannot mutate \n```\n\n---\n\n## 注意事项\n\n1. **会话有效期**: 上传会话默认 15 分钟后过期，请在有效期内完成上传\n2. **文件大小限制**: 受系统配置 `uploadSize` 限制\n3. **过期类型**: 支持 `day`、`hour`、`minute`、`forever`、`count`\n4. **CORS**: 直传模式下，S3 需要配置正确的 CORS 策略\n5. **重试机制**: 建议实现上传失败重试逻辑\n" }, { "path": "docs/changelog.md", "content": "" }, { "path": "docs/contributing.md", "content": "" }, { "path": "docs/en/api/index.md", "content": "# FileCodeBox API Documentation\n\n## API Version: 2.1.0\n\n## Table of Contents\n- [Authentication](#authentication)\n- [Share API](#share-api)\n- [Admin API](#admin-api)\n\n## Authentication\n\nSome APIs require `Authorization` header for authentication:\n\n```\nAuthorization: Bearer \n```\n\n### Get Token\n\nWhen guest upload is disabled in admin panel (`openUpload=0`), you need to login first:\n\n```bash\ncurl -X POST \"http://localhost:12345/admin/login\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"password\": \"FileCodeBox2023\"}'\n```\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"token\": \"xxx.xxx.xxx\",\n \"token_type\": \"Bearer\"\n }\n}\n```\n\n## Share API\n\n### Share Text\n\n**POST** `/share/text/`\n\nShare text content and get a share code.\n\n**Parameters:**\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| text | string | Yes | - | Text content to share |\n| expire_value | integer | No | 1 | Expiration time value |\n| expire_style | string | No | \"day\" | Expiration time unit(day/hour/minute/count/forever) |\n\n**cURL Example:**\n\n```bash\n# Guest upload (when openUpload=1)\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -F \"text=This is the text content to share\" \\\n -F \"expire_value=1\" \\\n -F \"expire_style=day\"\n\n# When authentication required (openUpload=0)\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -H \"Authorization: Bearer xxx.xxx.xxx\" \\\n -F \"text=This is the text content to share\"\n```\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"code\": \"abc123\"\n }\n}\n```\n\n### Share File\n\n**POST** `/share/file/`\n\nUpload and share a file, get a share code.\n\n**Parameters:**\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| file | file | Yes | - | File to upload |\n| expire_value | integer | No | 1 | Expiration time value |\n| expire_style | string | No | \"day\" | Expiration time unit(day/hour/minute/count/forever) |\n\n**cURL Example:**\n\n```bash\n# Upload file (default 1 day expiration)\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\"\n\n# Upload file (7 days expiration)\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\" \\\n -F \"expire_value=7\" \\\n -F \"expire_style=day\"\n\n# Upload file (10 downloads limit)\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\" \\\n -F \"expire_value=10\" \\\n -F \"expire_style=count\"\n\n# When authentication required\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -H \"Authorization: Bearer xxx.xxx.xxx\" \\\n -F \"file=@/path/to/file.txt\"\n```\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"code\": \"abc123\",\n \"name\": \"example.txt\"\n }\n}\n```\n\n### Get File Info\n\n**GET** `/share/select/`\n\nGet file information by share code (direct file download).\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| code | string | Yes | File share code |\n\n**cURL Example:**\n\n```bash\n# Download file by extraction code\ncurl -L \"http://localhost:12345/share/select/?code=abc123\" -o downloaded_file\n```\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"code\": \"abc123\",\n \"name\": \"example.txt\",\n \"size\": 1024,\n \"text\": \"File content or download link\"\n }\n}\n```\n\n### Select File\n\n**POST** `/share/select/`\n\nSelect file by share code.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| code | string | Yes | File share code |\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"code\": \"abc123\",\n \"name\": \"example.txt\",\n \"size\": 1024,\n \"text\": \"File content or download link\"\n }\n}\n```\n\n### Download File\n\n**GET** `/share/download`\n\nDownload shared file.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| key | string | Yes | Download key |\n| code | string | Yes | File share code |\n\n## Admin API\n\n### Admin Login\n\n**POST** `/admin/login`\n\nAdmin login to get token.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| password | string | Yes | Admin password |\n\n### Dashboard Data\n\n**GET** `/admin/dashboard`\n\nGet system dashboard data.\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"totalFiles\": 100,\n \"storageUsed\": \"1.5GB\",\n \"sysUptime\": \"10 days\",\n \"yesterdayCount\": 50,\n \"yesterdaySize\": \"500MB\",\n \"todayCount\": 30,\n \"todaySize\": \"300MB\"\n }\n}\n```\n\n### File List\n\n**GET** `/admin/file/list`\n\nGet system file list.\n\n**Parameters:**\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| page | integer | No | 1 | Current page |\n| size | integer | No | 10 | Page size |\n| keyword | string | No | \"\" | Search keyword |\n\n**Response Example:**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"page\": 1,\n \"size\": 10,\n \"total\": 100,\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"example.txt\",\n \"size\": 1024,\n \"created_at\": \"2024-01-01 12:00:00\"\n }\n ]\n }\n}\n```\n\n### Delete File\n\n**DELETE** `/admin/file/delete`\n\nDelete file from system.\n\n**Parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| id | integer | Yes | File ID |\n\n### Get Config\n\n**GET** `/admin/config/get`\n\nGet system configuration.\n\n### Update Config\n\n**PATCH** `/admin/config/update`\n\nUpdate system configuration.\n\n## Error Response\n\nWhen an error occurs, the API will return corresponding error message:\n\n```json\n{\n \"code\": 422,\n \"detail\": [\n {\n \"loc\": [\"body\", \"password\"],\n \"msg\": \"Password cannot be empty\",\n \"type\": \"value_error\"\n }\n ]\n}\n```\n\n## Status Codes\n\n- 200: Success\n- 401: Unauthorized\n- 403: Forbidden\n- 404: Not Found\n- 422: Validation Error\n- 500: Internal Server Error " }, { "path": "docs/en/changelog.md", "content": "" }, { "path": "docs/en/contributing.md", "content": "" }, { "path": "docs/en/guide/configuration.md", "content": "# Configuration Guide\n\nFileCodeBox provides rich configuration options that can be customized through the admin panel or by directly modifying the configuration. This document details all available configuration options.\n\n## Configuration Methods\n\nFileCodeBox supports two configuration methods:\n\n1. **Admin Panel Configuration** (Recommended): Access `/admin` to enter the admin panel and modify settings on the settings page\n2. **Database Configuration**: Configuration is stored in the `data/filecodebox.db` database\n\n::: tip Note\nOn first startup, the system uses default configuration from `core/settings.py`. Modified configurations are saved to the database.\n:::\n\n## Basic Settings\n\n### Site Information\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `name` | string | `文件快递柜 - FileCodeBox` | Site name, displayed in page title and navigation bar |\n| `description` | string | `开箱即用的文件快传系统` | Site description, used for SEO |\n| `keywords` | string | `FileCodeBox, 文件快递柜...` | Site keywords, used for SEO |\n| `port` | int | `12345` | Service listening port |\n\n### Notification Settings\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `notify_title` | string | `系统通知` | Notification title |\n| `notify_content` | string | Welcome message | Notification content, supports HTML |\n| `page_explain` | string | Legal disclaimer | Footer explanation text |\n| `robotsText` | string | `User-agent: *\\nDisallow: /` | robots.txt content |\n\n## Upload Settings\n\n### File Upload Limits\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `openUpload` | int | `1` | Enable upload functionality (1=enabled, 0=disabled) |\n| `uploadSize` | int | `10485760` | Maximum single file upload size (bytes), default 10MB |\n| `enableChunk` | int | `0` | Enable chunked upload (1=enabled, 0=disabled) |\n\n::: warning Note\n`uploadSize` is in bytes. 10MB = 10 * 1024 * 1024 = 10485760 bytes\n:::\n\n### Upload Rate Limiting\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `uploadMinute` | int | `1` | Upload limit time window (minutes) |\n| `uploadCount` | int | `10` | Maximum uploads allowed within the time window |\n\nExample: Default configuration allows up to 10 uploads per minute.\n\n\n### File Expiration Settings\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `expireStyle` | list | `[\"day\",\"hour\",\"minute\",\"forever\",\"count\"]` | Available expiration methods |\n| `max_save_seconds` | int | `0` | Maximum file retention time (seconds), 0 means no limit |\n\nExpiration methods explained:\n- `day` - Expire by days\n- `hour` - Expire by hours\n- `minute` - Expire by minutes\n- `forever` - Never expire\n- `count` - Expire by download count\n\n## Theme Settings\n\n### Theme Selection\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `themesSelect` | string | `themes/2024` | Currently active theme |\n| `themesChoices` | list | See below | Available themes list |\n\nDefault available themes:\n```json\n[\n {\n \"name\": \"2023\",\n \"key\": \"themes/2023\",\n \"author\": \"Lan\",\n \"version\": \"1.0\"\n },\n {\n \"name\": \"2024\",\n \"key\": \"themes/2024\",\n \"author\": \"Lan\",\n \"version\": \"1.0\"\n }\n]\n```\n\n### Interface Style\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `opacity` | float | `0.9` | Interface opacity (0-1) |\n| `background` | string | `\"\"` | Custom background image URL, empty uses default background |\n\n## Admin Settings\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `admin_token` | string | `FileCodeBox2023` | Admin login password |\n| `showAdminAddr` | int | `0` | Show admin panel entry on homepage (1=show, 0=hide) |\n\n::: danger Security Warning\nAlways change the default `admin_token` in production environments! Using the default password poses serious security risks.\n:::\n\n## Security Settings\n\n### Error Rate Limiting\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `errorMinute` | int | `1` | Error limit time window (minutes) |\n| `errorCount` | int | `1` | Maximum errors allowed within the time window |\n\nThis setting prevents brute-force attacks on extraction codes.\n\n## Storage Settings\n\n### Storage Type\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `file_storage` | string | `local` | Storage backend type |\n| `storage_path` | string | `\"\"` | Custom storage path |\n\nSupported storage types:\n- `local` - Local storage\n- `s3` - S3-compatible storage (AWS S3, Aliyun OSS, MinIO, etc.)\n- `onedrive` - OneDrive storage\n- `webdav` - WebDAV storage\n- `opendal` - OpenDAL storage\n\nFor detailed storage configuration, see [Storage Configuration](/en/guide/storage).\n\n## Configuration Examples\n\n### Example 1: Small Personal Use\n\nSuitable for personal or small team use with relaxed limits:\n\n```python\n{\n \"name\": \"My File Share\",\n \"uploadSize\": 52428800, # 50MB\n \"uploadMinute\": 5, # 5 minutes\n \"uploadCount\": 20, # Max 20 uploads\n \"expireStyle\": [\"day\", \"hour\", \"forever\"],\n \"admin_token\": \"your-secure-password\",\n \"showAdminAddr\": 1\n}\n```\n\n### Example 2: Public Service\n\nSuitable for public services requiring stricter limits:\n\n```python\n{\n \"name\": \"Public File Box\",\n \"uploadSize\": 10485760, # 10MB\n \"uploadMinute\": 1, # 1 minute\n \"uploadCount\": 5, # Max 5 uploads\n \"errorMinute\": 5, # 5 minutes\n \"errorCount\": 3, # Max 3 errors\n \"expireStyle\": [\"hour\", \"minute\", \"count\"],\n \"max_save_seconds\": 86400, # Max retention 1 day\n \"admin_token\": \"very-secure-password-123\",\n \"showAdminAddr\": 0\n}\n```\n\n### Example 3: Enterprise Internal Use\n\nSuitable for enterprise internal use with large file and chunked upload support:\n\n```python\n{\n \"name\": \"Enterprise File Transfer\",\n \"uploadSize\": 1073741824, # 1GB\n \"enableChunk\": 1, # Enable chunked upload\n \"uploadMinute\": 10, # 10 minutes\n \"uploadCount\": 100, # Max 100 uploads\n \"expireStyle\": [\"day\", \"forever\"],\n \"file_storage\": \"s3\", # Use S3 storage\n \"admin_token\": \"enterprise-secure-token\",\n \"showAdminAddr\": 1\n}\n```\n\n## Next Steps\n\n- [Storage Configuration](/en/guide/storage) - Learn how to configure different storage backends\n- [Security Settings](/en/guide/security) - Learn how to enhance system security\n- [File Sharing](/en/guide/share) - Learn about file sharing features\n" }, { "path": "docs/en/guide/getting-started.md", "content": "# Getting Started\n\n## Introduction\n\nFileCodeBox is a simple and efficient file sharing tool that supports temporary file transfer, sharing, and management. This guide will help you quickly deploy and use FileCodeBox.\n\n## Features\n\n- 🚀 Quick Deployment: Support Docker one-click deployment\n- 🔒 Secure & Reliable: File access requires extraction code\n- ⏱️ Time Control: Support setting file expiration time\n- 📊 Download Limit: Can limit file download times\n- 🖼️ File Preview: Support preview of images, videos, audio, and other formats\n- 📱 Responsive Design: Perfect adaptation for mobile and desktop\n\n## Deployment Methods\n\n### Docker Deployment\n\n```bash\ndocker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta\n```\n\n### Manual Deployment\n\n1. Clone the repository\n```bash\ngit clone https://github.com/vastsa/FileCodeBox.git\n```\n\n2. Install dependencies\n```bash\ncd FileCodeBox\npip install -r requirements.txt\n```\n\n3. Start the service\n```bash\npython main.py\n```\n\n## Usage\n\n1. Access the System\n Open browser and visit `http://localhost:12345`\n\n2. Upload Files\n - Click upload button or drag files to upload area\n - Set file expiration time and download limit\n - Get share link and extraction code\n\n3. Download Files\n - Visit share link\n - Enter extraction code\n - Download file\n\n4. Admin Panel\n - Visit `http://localhost:12345/#/admin`\n - Enter admin password: `FileCodeBox2023`\n - Enter admin panel\n - View system information, file list, user management, etc.\n\n## Next Steps\n\n- [Storage Configuration](/en/guide/storage) - Learn how to configure different storage methods\n- [Security Settings](/en/guide/security) - Learn how to enhance system security\n- [API Documentation](/en/api/) - Learn how to integrate through API " }, { "path": "docs/en/guide/introduction.md", "content": "
\n\n\"FileCodeBox\n\n

Share text and files anonymously with a passcode, like picking up a package

\n\n[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/network)\n[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/issues)\n[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)\n[![QQ Group](https://img.shields.io/badge/QQ%20Group-739673698-blue.svg)](https://qm.qq.com/q/PemPzhdEIM)\n[![Python Version](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-green.svg)](https://fastapi.tiangolo.com)\n[![Vue Version](https://img.shields.io/badge/Vue.js-3.x-brightgreen.svg)](https://v3.vuejs.org)\n\n
\n\n## 📝 Introduction\n\nFileCodeBox is a lightweight file sharing tool developed with FastAPI + Vue3. It allows users to share text and files easily, where recipients only need a passcode to retrieve the files, just like picking up a package from a delivery locker.\n\n## 🖼️ Preview\n\n
\n

\n\n\"Frontend\n\n   \n\n\"Demo\n\n

\n
\n\n\n## 🎯 Use Cases\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

📁 Temporary File Sharing

\nQuick file sharing without registration\n		\n

📝 Quick Text Sharing

\nShare code snippets and text content\n		\n

🕶️ Anonymous Transfer

\nPrivacy-protected file transfer\n
\n

💾 Temporary Storage

\nFile storage with expiration time\n		\n

🔄 Cross-platform Transfer

\nQuick file transfer between devices\n		\n

🌐 Private Share Service

\nBuild your own file sharing service\n
\n\n## ✨ Core Features\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

🚀 Lightweight

\nBased on FastAPI + SQLite3 + Vue3 + ElementUI\n		\n

📤 Easy Upload

\nSupport copy-paste and drag-drop\n		\n

📦 Multiple Types

\nSupport text and various file types\n
\n

🔒 Security

\n\n- IP upload limits\n- Error attempt limits\n- File expiration\n		\n

🎫 Passcode Sharing

\nRandom codes with customizable limits\n		\n

🌍 Multi-language

\nSupport for Simplified Chinese, Traditional Chinese, and English\n
\n

🎭 Anonymous

\nNo registration required\n		\n

🛠 Admin Panel

\nFile and system management\n		\n

🐳 Docker

\nOne-click deployment\n
\n

💾 Storage Options

\nLocal, S3, OneDrive support\n		\n

📱 Responsive

\nMobile-friendly design\n		\n

💻 CLI Support

\nCommand-line download\n
\n\n## 🚀 Quick Start\n\n### Docker Deployment\n\n```bash\ndocker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta\n```\n\n### Manual Deployment\n\n1. Clone the repository\n```bash\ngit clone https://github.com/vastsa/FileCodeBox.git\n```\n\n2. Install dependencies\n```bash\ncd FileCodeBox\npip install -r requirements.txt\n```\n\n3. Start the service\n```bash\npython main.py\n```\n\n## 📖 Usage Guide\n\n### Share Files\n1. Open the website, click \"Share File\"\n2. Select or drag files\n3. Set expiration time and count\n4. Get the passcode\n\n### Retrieve Files\n1. Open the website, enter passcode\n2. Click retrieve\n3. Download file or view text\n\n### Admin Panel\n1. Visit `/admin`\n2. Enter admin password\n3. Manage files and settings\n\n## 🛠 Development Guide\n\n### Project Structure\n```\nFileCodeBox/\n├── apps/ # Application code\n│ ├── admin/ # Admin backend\n│ └── base/ # Base functions\n├── core/ # Core functions\n├── data/ # Data directory\n└── fcb-fronted/ # Frontend code\n```\n\n### Development Environment\n- Python 3.8+\n- Node.js 14+\n- Vue 3\n- FastAPI\n\n### Local Development\n1. Backend development\n```bash\npython main.py\n```\n\n2. Frontend development\n```bash\ncd fcb-fronted\nnpm install\nnpm run dev\n```\n\n## 🤝 Contributing\n\n1. Fork the project\n2. Create your feature branch `git checkout -b feature/xxx`\n3. Commit your changes `git commit -m 'Add xxx'`\n4. Push to the branch `git push origin feature/xxx`\n5. Open a Pull Request\n\n## ❓ FAQ\n\n### Q: How to modify upload size limit?\nA: Change `uploadSize` in admin panel\n\n### Q: How to configure storage engine?\nA: Select storage engine and configure parameters in admin panel\n\n### Q: How to backup data?\nA: Backup the `data` directory\n\nFor more questions, visit [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题)\n\n## 😀 Project Statistics and Analytics\n\n
\n\"Featured｜HelloGitHub\"\n\n![Repobeats](https://repobeats.axiom.co/api/embed/7a6c92f1d96ee57e6fb67f0df371528397b0c9ac.svg)\n\n[![Star History](https://api.star-history.com/svg?repos=vastsa/FileCodeBox&type=Date)](https://star-history.com/#vastsa/FileCodeBox&Date)\n
\n\n## 📜 Disclaimer\n\nThis project is open-source for learning purposes only. It should not be used for any illegal purposes. The author is not responsible for any consequences. Please retain the project address and copyright information when using it." }, { "path": "docs/en/guide/management.md", "content": "# Admin Panel\n\nFileCodeBox provides a fully-featured admin panel that allows administrators to conveniently manage files, view system status, and modify configurations. This document introduces the various features and usage of the admin panel.\n\n## Accessing the Admin Panel\n\n### Login Method\n\nThe admin panel is located at the `/admin` path. Access method:\n\n1. Visit `http://your-domain.com/admin` in your browser\n2. Enter the admin password (the value of the `admin_token` configuration)\n3. Click the login button\n\n::: tip Tip\nThe default admin password is `FileCodeBox2023`. Be sure to change this password in production environments. See [Security Settings](/en/guide/security) for details.\n:::\n\n### Show Admin Entry\n\nBy default, the admin panel entry is not shown on the homepage. You can control whether to show it via configuration:\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `showAdminAddr` | int | `0` | Show admin entry on homepage (1=show, 0=hide) |\n\n::: warning Security Recommendation\nFor public services, it's recommended to keep `showAdminAddr` at `0` and access the admin panel directly via the `/admin` path to reduce the risk of malicious scanning.\n:::\n\n### Authentication Mechanism\n\nThe admin panel uses JWT (JSON Web Token) for authentication:\n\n1. After successful login, the server returns a Token containing admin identity\n2. Subsequent requests carry the Token via `Authorization: Bearer ` header\n3. Token is used to verify admin identity, ensuring only authorized users can access admin functions\n\n## Dashboard\n\nAfter logging in, you first see the dashboard page, which displays the overall system status.\n\n### Statistics\n\nThe dashboard displays the following key metrics:\n\n| Metric | Description |\n|--------|-------------|\n| **Total Files** (`totalFiles`) | Total number of files stored in the system |\n| **Storage Used** (`storageUsed`) | Total storage space occupied by all files (bytes) |\n| **System Uptime** (`sysUptime`) | Time when the system was first started |\n| **Yesterday's Uploads** (`yesterdayCount`) | Number of files uploaded yesterday |\n| **Yesterday's Upload Size** (`yesterdaySize`) | Total size of files uploaded yesterday (bytes) |\n| **Today's Uploads** (`todayCount`) | Number of files uploaded today so far |\n| **Today's Upload Size** (`todaySize`) | Total size of files uploaded today (bytes) |\n\n### Metric Notes\n\n- **Total Files**: Includes all unexpired files and text shares\n- **Storage Used**: Shows actual storage space occupied by files, excluding database and other system files\n- **Yesterday/Today Statistics**: Calculated based on file creation time, useful for understanding system usage trends\n\n::: tip Tip\nStorage usage is displayed in bytes. For example, `10485760` represents approximately 10MB.\n:::\n\n## File Management\n\n### File List\n\nThe file management page displays all shared files in the system, supporting pagination and search.\n\n**List information includes:**\n- File ID\n- Extraction code (code)\n- Filename prefix (prefix)\n- File extension (suffix)\n- File size\n- Creation time\n- Expiration time\n- Remaining download count\n\n### Search Files\n\nUse the search function to quickly find specific files:\n\n1. Enter keywords in the search box\n2. System performs fuzzy matching based on filename prefix (prefix)\n3. Search results update in real-time\n\n**Search examples:**\n- Enter `report` to find all files with \"report\" in the filename\n- Enter `.pdf` to find all PDF files (if the filename contains this string)\n\n### Pagination\n\nThe file list supports paginated display:\n\n| Parameter | Default | Description |\n|-----------|---------|-------------|\n| `page` | `1` | Current page number |\n| `size` | `10` | Items per page |\n\n\n### Delete Files\n\nAdministrators can delete any file:\n\n1. Find the file to delete in the file list\n2. Click the delete button\n3. Confirm the delete operation\n\n::: danger Warning\nDelete operations are irreversible! Files will be permanently deleted from the storage backend, and database records will also be removed.\n:::\n\n**Delete process:**\n1. System first deletes the actual file from the storage backend (local/S3/OneDrive, etc.)\n2. Then deletes the file record from the database\n3. After deletion, the corresponding extraction code becomes invalid\n\n### Download Files\n\nAdministrators can directly download any file:\n\n1. Find the target file in the file list\n2. Click the download button\n3. File will be downloaded via browser\n\nFor text shares, the system returns text content directly instead of downloading a file.\n\n### Modify File Information\n\nAdministrators can modify some information of shared files:\n\n| Modifiable Field | Description |\n|------------------|-------------|\n| `code` | Extraction code (must be unique, cannot duplicate other files) |\n| `prefix` | Filename prefix |\n| `suffix` | File extension |\n| `expired_at` | Expiration time |\n| `expired_count` | Remaining download count |\n\n**Modify extraction code:**\n```\nOriginal code: abc123\nNew code: myfile2024\n```\n\n::: warning Note\nWhen modifying extraction codes, the system checks if the new code is already in use. If an identical extraction code exists, the modification will fail.\n:::\n\n## Local File Management\n\nIn addition to managing shared files, the admin panel also provides local file management functionality for managing files in the `data/local` directory.\n\n### View Local Files\n\nThe local file list displays all files in the `data/local` directory:\n\n| Information | Description |\n|-------------|-------------|\n| Filename | Complete filename |\n| Creation Time | File creation time |\n| File Size | File size (bytes) |\n\n### Share Local Files\n\nYou can quickly share local files:\n\n1. Select the file to share in the local file list\n2. Set expiration method and value\n3. Click the share button\n4. System generates extraction code\n\n**Share parameters:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `filename` | Filename to share |\n| `expire_style` | Expiration method (day/hour/minute/forever/count) |\n| `expire_value` | Expiration value (days/hours/minutes/download count) |\n\n### Delete Local Files\n\nYou can delete files in the `data/local` directory:\n\n1. Find the file to delete in the local file list\n2. Click the delete button\n3. Confirm deletion\n\n::: tip Use Cases\nLocal file management is useful for:\n- Sharing files after batch uploading to the server\n- Managing files uploaded to the server through other means\n- Cleaning up unnecessary local files\n:::\n\n## System Settings\n\n### View Configuration\n\nOn the system settings page, you can view the current values of all configuration items. Configuration items are grouped by category:\n\n- Basic settings (site name, description, etc.)\n- Upload settings (file size limits, rate limits, etc.)\n- Storage settings (storage type, path, etc.)\n- Theme settings (theme selection, opacity, etc.)\n- Security settings (admin password, error limits, etc.)\n\n### Modify Configuration\n\nAdministrators can modify most configurations through the admin panel:\n\n1. Go to the system settings page\n2. Find the configuration item to modify\n3. Enter the new value\n4. Click the save button\n\n**Modifiable configuration items:**\n\n| Category | Example Settings |\n|----------|------------------|\n| Basic Settings | `name`, `description`, `keywords`, `notify_title`, `notify_content` |\n| Upload Settings | `uploadSize`, `uploadMinute`, `uploadCount`, `openUpload`, `enableChunk` |\n| Expiration Settings | `expireStyle`, `max_save_seconds` |\n| Theme Settings | `themesSelect`, `opacity`, `background` |\n| Security Settings | `admin_token`, `showAdminAddr`, `errorMinute`, `errorCount` |\n| Storage Settings | `file_storage`, `storage_path` and storage backend-specific configurations |\n\n::: warning Note\n- `admin_token` (admin password) cannot be set to empty\n- `themesChoices` (theme list) cannot be modified through the admin panel\n- After modifying storage settings, existing files will not be automatically migrated\n:::\n\n### Configuration Effect\n\nConfiguration changes take effect immediately without restarting the service. Configurations are saved in the database and persist after restart.\n\n**Configuration storage location:**\n- Database: `data/filecodebox.db`\n- Table name: `keyvalue`\n- Key name: `settings`\n\n## API Endpoints\n\nAll admin panel functions are implemented through REST APIs. Here are the main endpoints:\n\n### Authentication Endpoint\n\n**Login**\n```\nPOST /admin/login\nContent-Type: application/json\n\n{\n \"password\": \"your-admin-password\"\n}\n```\n\nResponse:\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIs...\",\n \"token_type\": \"Bearer\"\n }\n}\n```\n\n### Dashboard Endpoint\n\n**Get Statistics**\n```\nGET /admin/dashboard\nAuthorization: Bearer \n```\n\n### File Management Endpoints\n\n**Get File List**\n```\nGET /admin/file/list?page=1&size=10&keyword=\nAuthorization: Bearer \n```\n\n**Delete File**\n```\nDELETE /admin/file/delete\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"id\": 123\n}\n```\n\n**Download File**\n```\nGET /admin/file/download?id=123\nAuthorization: Bearer \n```\n\n**Modify File Information**\n```\nPATCH /admin/file/update\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"id\": 123,\n \"code\": \"newcode\",\n \"expired_at\": \"2024-12-31T23:59:59\"\n}\n```\n\n### Local File Endpoints\n\n**Get Local File List**\n```\nGET /admin/local/lists\nAuthorization: Bearer \n```\n\n**Delete Local File**\n```\nDELETE /admin/local/delete\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"filename\": \"example.txt\"\n}\n```\n\n**Share Local File**\n```\nPOST /admin/local/share\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"filename\": \"example.txt\",\n \"expire_style\": \"day\",\n \"expire_value\": 7\n}\n```\n\n### Configuration Endpoints\n\n**Get Configuration**\n```\nGET /admin/config/get\nAuthorization: Bearer \n```\n\n**Update Configuration**\n```\nPATCH /admin/config/update\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"admin_token\": \"new-password\",\n \"uploadSize\": 52428800\n}\n```\n\n## Common Issues\n\n### Forgot Admin Password\n\nIf you forgot the admin password, you can reset it through the following methods:\n\n1. Stop the FileCodeBox service\n2. Open `data/filecodebox.db` using an SQLite tool\n3. Query the record with `key='settings'` in the `keyvalue` table\n4. Modify the `admin_token` value in the JSON\n5. Restart the service\n\n```sql\n-- View current configuration\nSELECT * FROM keyvalue WHERE key = 'settings';\n\n-- Or delete configuration to restore default password\nDELETE FROM keyvalue WHERE key = 'settings';\n```\n\n### File Deletion Failed\n\nIf an error occurs when deleting files, possible reasons:\n\n1. **Storage backend connection failed**: Check if storage configuration is correct\n2. **File no longer exists**: File may have been manually deleted\n3. **Insufficient permissions**: Check write permissions for storage directory\n\n### Configuration Changes Not Taking Effect\n\nIf configuration changes don't take effect:\n\n1. Check if you clicked the save button\n2. Refresh the page to see if configuration was saved\n3. Check browser console for error messages\n4. Confirm configuration value format is correct (e.g., don't enter strings for numeric types)\n\n## Next Steps\n\n- [Configuration Guide](/en/guide/configuration) - Learn detailed descriptions of all configuration options\n- [Security Settings](/en/guide/security) - Learn how to enhance system security\n- [Storage Configuration](/en/guide/storage) - Configure different storage backends\n" }, { "path": "docs/en/guide/security.md", "content": "# Security Settings\n\nFileCodeBox provides multiple layers of security mechanisms to protect your file sharing service. This document explains how to properly configure security options to ensure secure system operation.\n\n## Admin Password\n\n### Change Default Password\n\n::: danger Important Security Warning\nFileCodeBox's default admin password is `FileCodeBox2023`. **You must change this password immediately in production environments!** Using the default password allows anyone to access your admin panel.\n:::\n\nThere are two ways to change the admin password:\n\n**Method 1: Via Admin Panel (Recommended)**\n\n1. Access `/admin` to enter the admin panel\n2. Log in with the current password\n3. Go to the \"System Settings\" page\n4. Find the `admin_token` configuration item\n5. Enter a new secure password and save\n\n**Method 2: Via Database**\n\nConfiguration is stored in the `keyvalue` table of the `data/filecodebox.db` database. You can directly modify the `admin_token` value.\n\n### Password Security Recommendations\n\n- Use a strong password with at least 16 characters\n- Include uppercase and lowercase letters, numbers, and special characters\n- Avoid common words or personal information\n- Change password regularly\n\n```python\n# Recommended password format example\n\"admin_token\": \"Xk9#mP2$vL5@nQ8&wR3\"\n```\n\n### Hide Admin Entry\n\nBy default, the admin panel entry is hidden. You can control whether to show the admin entry on the homepage via the `showAdminAddr` configuration:\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `showAdminAddr` | int | `0` | Show admin entry (1=show, 0=hide) |\n\n::: tip Recommendation\nFor public services, it's recommended to keep `showAdminAddr` at `0` and access the admin panel directly via the `/admin` path.\n:::\n\n## IP Rate Limiting\n\nFileCodeBox has built-in IP-based rate limiting mechanisms to effectively prevent abuse and attacks.\n\n### Upload Rate Limiting\n\nLimit the number of uploads from a single IP within a specified time:\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `uploadMinute` | int | `1` | Upload limit time window (minutes) |\n| `uploadCount` | int | `10` | Maximum uploads allowed within the time window |\n\n**How it works:**\n- System records upload requests from each IP\n- When an IP's upload count reaches `uploadCount` within `uploadMinute` minutes\n- Subsequent upload requests from that IP will be rejected with HTTP 423 error\n- Counter resets after the time window expires\n\n**Configuration examples:**\n\n```python\n# Relaxed configuration: Max 20 uploads in 5 minutes\n{\n \"uploadMinute\": 5,\n \"uploadCount\": 20\n}\n\n# Strict configuration: Max 3 uploads in 1 minute\n{\n \"uploadMinute\": 1,\n \"uploadCount\": 3\n}\n```\n\n\n### Error Rate Limiting\n\nLimit the number of error attempts from a single IP to prevent brute-force attacks on extraction codes:\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `errorMinute` | int | `1` | Error limit time window (minutes) |\n| `errorCount` | int | `1` | Maximum errors allowed within the time window |\n\n**How it works:**\n- When a user enters an incorrect extraction code, the system records the error count for that IP\n- When error count reaches `errorCount`, that IP will be temporarily locked\n- Lock duration is `errorMinute` minutes\n- During lockout, all extraction requests from that IP will be rejected\n\n**Configuration example:**\n\n```python\n# Anti-brute-force configuration: Max 3 errors in 5 minutes\n{\n \"errorMinute\": 5,\n \"errorCount\": 3\n}\n```\n\n::: warning Note\nThe default configuration `errorMinute=1, errorCount=1` is very strict, meaning you need to wait 1 minute after entering one incorrect extraction code before retrying. Adjust this configuration based on actual needs.\n:::\n\n## Upload Restrictions\n\n### File Size Limit\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `uploadSize` | int | `10485760` | Maximum single file upload size (bytes), default 10MB |\n| `openUpload` | int | `1` | Enable upload functionality (1=enabled, 0=disabled) |\n\n**Common size conversions:**\n- 10MB = 10 * 1024 * 1024 = `10485760`\n- 50MB = 50 * 1024 * 1024 = `52428800`\n- 100MB = 100 * 1024 * 1024 = `104857600`\n- 1GB = 1024 * 1024 * 1024 = `1073741824`\n\n### File Expiration Settings\n\nThrough file expiration mechanisms, you can automatically clean up expired files, reducing storage usage and security risks:\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `expireStyle` | list | `[\"day\",\"hour\",\"minute\",\"forever\",\"count\"]` | Available expiration methods |\n| `max_save_seconds` | int | `0` | Maximum file retention time (seconds), 0 means no limit |\n\n**Expiration methods explained:**\n- `day` - Expire by days\n- `hour` - Expire by hours\n- `minute` - Expire by minutes\n- `forever` - Never expire (requires alphanumeric extraction code)\n- `count` - Expire by download count\n\n**Security recommendations:**\n\nFor public services, it's recommended to:\n1. Remove the `forever` option to avoid permanent file storage\n2. Set `max_save_seconds` to limit maximum retention time\n3. Prefer using `count` method for automatic deletion after download\n\n```python\n# Recommended configuration for public services\n{\n \"expireStyle\": [\"hour\", \"minute\", \"count\"],\n \"max_save_seconds\": 86400 # Max retention 1 day\n}\n```\n\n### Disable Upload Functionality\n\nIn some cases, you may need to temporarily disable upload functionality:\n\n```python\n{\n \"openUpload\": 0 # Disable upload functionality\n}\n```\n\n## Reverse Proxy Security Configuration\n\nIn production environments, Nginx or other reverse proxy servers are typically used. Here are security configuration recommendations:\n\n### Nginx Configuration Example\n\n```nginx\nserver {\n listen 80;\n server_name your-domain.com;\n \n # Force HTTPS redirect\n return 301 https://$server_name$request_uri;\n}\n\nserver {\n listen 443 ssl http2;\n server_name your-domain.com;\n \n # SSL certificate configuration\n ssl_certificate /path/to/cert.pem;\n ssl_certificate_key /path/to/key.pem;\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;\n ssl_prefer_server_ciphers on;\n \n # Security headers\n add_header X-Frame-Options \"SAMEORIGIN\" always;\n add_header X-Content-Type-Options \"nosniff\" always;\n add_header X-XSS-Protection \"1; mode=block\" always;\n add_header Strict-Transport-Security \"max-age=31536000; includeSubDomains\" always;\n \n # Limit request body size (match uploadSize configuration)\n client_max_body_size 100M;\n \n # Pass real IP\n location / {\n proxy_pass http://127.0.0.1:12345;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n \n # Static resource caching\n location /assets {\n proxy_pass http://127.0.0.1:12345;\n proxy_cache_valid 200 7d;\n add_header Cache-Control \"public, max-age=604800\";\n }\n}\n```\n\n### Key Security Configuration Notes\n\n**1. Pass Real IP**\n\nFileCodeBox's IP limiting functionality depends on obtaining the client's real IP. The system obtains IP in the following order:\n1. `X-Real-IP` request header\n2. `X-Forwarded-For` request header\n3. Direct client connection IP\n\nEnsure the reverse proxy correctly sets these headers:\n\n```nginx\nproxy_set_header X-Real-IP $remote_addr;\nproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n```\n\n**2. Request Body Size Limit**\n\nNginx's `client_max_body_size` should match or be slightly larger than FileCodeBox's `uploadSize` configuration:\n\n```nginx\nclient_max_body_size 100M; # Allow max 100MB uploads\n```\n\n**3. HTTPS Encryption**\n\nIt's strongly recommended to enable HTTPS in production environments:\n- Protect uploaded file content\n- Protect admin login credentials\n- Prevent man-in-the-middle attacks\n\n### Caddy Configuration Example\n\n```nginx\nyour-domain.com {\n reverse_proxy localhost:12345\n \n header {\n X-Frame-Options \"SAMEORIGIN\"\n X-Content-Type-Options \"nosniff\"\n X-XSS-Protection \"1; mode=block\"\n Strict-Transport-Security \"max-age=31536000; includeSubDomains\"\n }\n}\n```\n\n## Security Checklist\n\nBefore deploying FileCodeBox, confirm the following security configurations:\n\n- [ ] Changed default admin password `admin_token`\n- [ ] Hidden admin entry `showAdminAddr: 0`\n- [ ] Configured appropriate upload rate limiting\n- [ ] Configured error rate limiting to prevent brute-force attacks\n- [ ] Set reasonable file size limits\n- [ ] Configured file expiration policy\n- [ ] Enabled HTTPS encryption\n- [ ] Reverse proxy correctly passes real IP\n- [ ] Set security response headers\n\n## Recommended Security Configurations\n\n### Public Service Configuration\n\n```python\n{\n \"admin_token\": \"your-very-secure-password\",\n \"showAdminAddr\": 0,\n \"uploadSize\": 10485760, # 10MB\n \"uploadMinute\": 1,\n \"uploadCount\": 5,\n \"errorMinute\": 5,\n \"errorCount\": 3,\n \"expireStyle\": [\"hour\", \"minute\", \"count\"],\n \"max_save_seconds\": 86400, # Max 1 day\n \"openUpload\": 1\n}\n```\n\n### Internal Service Configuration\n\n```python\n{\n \"admin_token\": \"internal-secure-password\",\n \"showAdminAddr\": 1,\n \"uploadSize\": 104857600, # 100MB\n \"uploadMinute\": 5,\n \"uploadCount\": 50,\n \"errorMinute\": 1,\n \"errorCount\": 5,\n \"expireStyle\": [\"day\", \"hour\", \"forever\"],\n \"max_save_seconds\": 0, # No limit\n \"openUpload\": 1\n}\n```\n\n## Next Steps\n\n- [Configuration Guide](/en/guide/configuration) - Learn about all configuration options\n- [Storage Configuration](/en/guide/storage) - Configure secure storage backends\n- [File Sharing](/en/guide/share) - Learn about file sharing features\n" }, { "path": "docs/en/guide/share.md", "content": "# File Sharing\n\nFileCodeBox provides simple and easy-to-use file and text sharing functionality. Users can securely share and retrieve files using extraction codes.\n\n## Sharing Methods\n\nFileCodeBox supports two sharing methods:\n\n1. **Text Sharing** - Share text content directly, suitable for code snippets, configuration files, etc.\n2. **File Sharing** - Upload files for sharing, supports various file formats\n\n## Text Sharing\n\n### How to Use\n\n1. Select the \"Text Share\" tab on the homepage\n2. Enter or paste the content to share in the text box\n3. Select expiration method and time\n4. Click the \"Share\" button\n5. Get the extraction code\n\n### Text Size Limit\n\n::: warning Note\nThe maximum content size for text sharing is **222KB** (227,328 bytes). If content exceeds this limit, it's recommended to use file sharing instead.\n:::\n\nText content size is calculated using UTF-8 encoding. Chinese characters typically occupy 3 bytes.\n\n### API Endpoint\n\n**POST** `/share/text/`\n\nRequest parameters:\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `text` | string | Yes | Text content to share |\n| `expire_value` | int | No | Expiration value, default 1 |\n| `expire_style` | string | No | Expiration method, default `day` |\n\nResponse example:\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"123456\"\n }\n}\n```\n\n## File Sharing\n\n### How to Use\n\n1. Select the \"File Share\" tab on the homepage\n2. Click the upload area or drag files to the upload area\n3. Select expiration method and time\n4. Click the \"Upload\" button\n5. Get the extraction code\n\n### File Size Limit\n\nThe default maximum single file upload size is **10MB**. Administrators can modify this limit via the `uploadSize` configuration.\n\n::: tip Tip\nIf you need to upload large files, contact the administrator to enable chunked upload functionality or adjust the `uploadSize` configuration.\n:::\n\n### Supported Upload Methods\n\n- **Click Upload** - Click the upload area to select files\n- **Drag Upload** - Drag files to the upload area\n- **Paste Upload** - Paste images from clipboard (supported by some themes)\n\n### API Endpoint\n\n**POST** `/share/file/`\n\nRequest parameters (multipart/form-data):\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `file` | file | Yes | File to upload |\n| `expire_value` | int | No | Expiration value, default 1 |\n| `expire_style` | string | No | Expiration method, default `day` |\n\nResponse example:\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"654321\",\n \"name\": \"example.pdf\"\n }\n}\n```\n\n\n## Expiration Settings\n\nFileCodeBox supports multiple flexible expiration methods:\n\n| Expiration Method | Parameter Value | Description |\n|-------------------|-----------------|-------------|\n| By Days | `day` | File expires after specified days |\n| By Hours | `hour` | File expires after specified hours |\n| By Minutes | `minute` | File expires after specified minutes |\n| Never Expire | `forever` | File is permanently valid |\n| By Count | `count` | File expires after specified download count |\n\n::: info Note\n- Administrators can control available expiration methods via the `expireStyle` configuration\n- Administrators can limit maximum file retention time via the `max_save_seconds` configuration\n:::\n\n### Expiration Method Examples\n\n```bash\n# File expires after 3 days\nexpire_value=3, expire_style=day\n\n# File expires after 12 hours\nexpire_value=12, expire_style=hour\n\n# File expires after 30 minutes\nexpire_value=30, expire_style=minute\n\n# File never expires\nexpire_value=1, expire_style=forever\n\n# File expires after 5 downloads\nexpire_value=5, expire_style=count\n```\n\n## Retrieving Files\n\n### How to Use\n\n1. Enter the extraction code in the \"Retrieve File\" area on the homepage\n2. Click the \"Retrieve\" button\n3. System displays file information (filename, size, etc.)\n4. Click the \"Download\" button to download the file, or view text content directly\n\n### Extraction Code Notes\n\n- Extraction codes are typically **6-digit numbers**\n- Files that never expire use **alphanumeric** extraction codes\n- Extraction codes are case-sensitive (for alphanumeric codes)\n\n### API Endpoints\n\n**Query File Information**\n\n**POST** `/share/select/`\n\nRequest parameters:\n\n```json\n{\n \"code\": \"123456\"\n}\n```\n\nResponse example (file):\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"123456\",\n \"name\": \"example.pdf\",\n \"size\": 1048576,\n \"text\": \"https://example.com/download/...\"\n }\n}\n```\n\nResponse example (text):\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"123456\",\n \"name\": \"Text\",\n \"size\": 1024,\n \"text\": \"This is the shared text content...\"\n }\n}\n```\n\n**Direct File Download**\n\n**GET** `/share/select/?code=123456`\n\nThis endpoint returns file content directly, suitable for direct browser access.\n\n## Chunked Upload (Large Files)\n\nFor large file uploads, FileCodeBox supports chunked upload functionality. This feature requires administrator enablement (`enableChunk=1`).\n\n### Chunked Upload Flow\n\n```mermaid\nsequenceDiagram\n participant C as Client\n participant S as Server\n \n C->>S: 1. Initialize upload (POST /chunk/upload/init/)\n S-->>C: Return upload_id and chunk info\n \n loop Each chunk\n C->>S: 2. Upload chunk (POST /chunk/upload/chunk/{upload_id}/{chunk_index})\n S-->>C: Return chunk hash\n end\n \n C->>S: 3. Complete upload (POST /chunk/upload/complete/{upload_id})\n S-->>C: Return extraction code\n```\n\n### 1. Initialize Upload\n\n**POST** `/chunk/upload/init/`\n\nRequest parameters:\n\n```json\n{\n \"file_name\": \"large_file.zip\",\n \"file_size\": 104857600,\n \"chunk_size\": 5242880,\n \"file_hash\": \"sha256_hash_of_file\"\n}\n```\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `file_name` | string | Yes | Filename |\n| `file_size` | int | Yes | Total file size (bytes) |\n| `chunk_size` | int | No | Chunk size, default 5MB |\n| `file_hash` | string | Yes | SHA256 hash of the file |\n\nResponse example:\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"existed\": false,\n \"upload_id\": \"abc123def456\",\n \"chunk_size\": 5242880,\n \"total_chunks\": 20,\n \"uploaded_chunks\": []\n }\n}\n```\n\n### 2. Upload Chunk\n\n**POST** `/chunk/upload/chunk/{upload_id}/{chunk_index}`\n\n- `upload_id` - Upload session ID returned during initialization\n- `chunk_index` - Chunk index, starting from 0\n\nRequest body: Chunk file data (multipart/form-data)\n\nResponse example:\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"chunk_hash\": \"sha256_hash_of_chunk\"\n }\n}\n```\n\n### 3. Complete Upload\n\n**POST** `/chunk/upload/complete/{upload_id}`\n\nRequest parameters:\n\n```json\n{\n \"expire_value\": 1,\n \"expire_style\": \"day\"\n}\n```\n\nResponse example:\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"789012\",\n \"name\": \"large_file.zip\"\n }\n}\n```\n\n### Resume Upload\n\nChunked upload supports resume functionality. If upload is interrupted:\n\n1. Call the initialization endpoint again with the same `file_hash`\n2. Server returns `uploaded_chunks` list containing already uploaded chunk indices\n3. Client only needs to upload chunks not in the list\n\n## Error Handling\n\n### Common Error Codes\n\n| Error Code | Description | Solution |\n|------------|-------------|----------|\n| 403 | File size exceeds limit | Reduce file size or contact administrator to adjust limit |\n| 403 | Content too large | Text exceeds 222KB, use file sharing instead |\n| 403 | Upload rate limit | Wait a while before retrying |\n| 404 | File not found | Check if extraction code is correct |\n| 404 | File expired | File has expired or download count exhausted |\n\n### Rate Limiting\n\nTo prevent abuse, the system has rate limits on upload and retrieval operations:\n\n- **Upload limit**: Default max 10 uploads per minute\n- **Error limit**: Default max 1 error attempt per minute\n\n::: tip Tip\nIf you encounter rate limiting, wait for the limit time window to pass before retrying.\n:::\n\n## Next Steps\n\n- [Configuration Guide](/en/guide/configuration) - Learn how to configure sharing-related settings\n- [Storage Configuration](/en/guide/storage) - Learn about file storage methods\n- [Security Settings](/en/guide/security) - Learn about security-related configurations\n- [Admin Panel](/en/guide/management) - Learn how to manage shared files\n" }, { "path": "docs/en/guide/storage.md", "content": "# Storage Configuration\n\nFileCodeBox supports multiple storage backends. You can choose the appropriate storage method based on your needs. This document details the configuration methods for various storage backends.\n\n## Storage Types Overview\n\n| Storage Type | Config Value | Description |\n|--------------|--------------|-------------|\n| Local Storage | `local` | Default storage method, files saved on local server |\n| S3-Compatible Storage | `s3` | Supports AWS S3, Aliyun OSS, MinIO, etc. |\n| OneDrive | `onedrive` | Microsoft OneDrive cloud storage (work/school accounts only) |\n| WebDAV | `webdav` | Storage services supporting WebDAV protocol |\n| OpenDAL | `opendal` | Integrate more storage services via OpenDAL |\n\n## Local Storage\n\nLocal storage is the default storage method. Files are saved in the server's `data/` directory.\n\n### Configuration Parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `file_storage` | string | `local` | Storage type |\n| `storage_path` | string | `\"\"` | Custom storage path (optional) |\n\n### Configuration Example\n\n```bash\nfile_storage=local\nstorage_path=\n```\n\n### Notes\n\n- Files are stored by default in `data/share/data/` directory\n- Subdirectories are automatically created by date: `year/month/day/fileID/`\n- In production, it's recommended to mount the `data/` directory to persistent storage\n\n## S3-Compatible Storage\n\nSupports all S3-compatible object storage services, including AWS S3, Aliyun OSS, MinIO, Tencent Cloud COS, etc.\n\n### Configuration Parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `file_storage` | string | - | Set to `s3` |\n| `s3_access_key_id` | string | `\"\"` | Access Key ID |\n| `s3_secret_access_key` | string | `\"\"` | Secret Access Key |\n| `s3_bucket_name` | string | `\"\"` | Bucket name |\n| `s3_endpoint_url` | string | `\"\"` | S3 endpoint URL |\n| `s3_region_name` | string | `auto` | Region name |\n| `s3_signature_version` | string | `s3v2` | Signature version (`s3v2` or `s3v4`) |\n| `s3_hostname` | string | `\"\"` | S3 hostname (alternative) |\n| `s3_proxy` | int | `0` | Download through server proxy (1=yes, 0=no) |\n| `aws_session_token` | string | `\"\"` | AWS session token (optional) |\n\n\n### AWS S3 Configuration Example\n\n```bash\nfile_storage=s3\ns3_access_key_id=AKIAIOSFODNN7EXAMPLE\ns3_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\ns3_bucket_name=my-filecodebox-bucket\ns3_endpoint_url=https://s3.amazonaws.com\ns3_region_name=us-east-1\ns3_signature_version=s3v4\n```\n\n### Aliyun OSS Configuration Example\n\n```bash\nfile_storage=s3\ns3_access_key_id=YourAccessKeyId\ns3_secret_access_key=YourSecretAccessKey\ns3_bucket_name=bucket-name\ns3_endpoint_url=https://bucket-name.oss-cn-hangzhou.aliyuncs.com\ns3_region_name=oss-cn-hangzhou\ns3_signature_version=s3v4\n```\n\n::: tip Aliyun OSS Endpoint Format\nEndpoint URL format: `https://..aliyuncs.com`\n\nCommon regions:\n- Hangzhou: `oss-cn-hangzhou`\n- Shanghai: `oss-cn-shanghai`\n- Beijing: `oss-cn-beijing`\n- Shenzhen: `oss-cn-shenzhen`\n:::\n\n### MinIO Configuration Example\n\n```bash\nfile_storage=s3\ns3_access_key_id=minioadmin\ns3_secret_access_key=minioadmin\ns3_bucket_name=filecodebox\ns3_endpoint_url=http://localhost:9000\ns3_region_name=us-east-1\ns3_signature_version=s3v4\n```\n\n::: warning MinIO Notes\n- `s3_endpoint_url` should be the MinIO API interface address\n- `s3_region_name` should match the `Server Location` in MinIO configuration\n- Ensure the bucket is created and has correct access permissions\n:::\n\n### Tencent Cloud COS Configuration Example\n\n```bash\nfile_storage=s3\ns3_access_key_id=YourSecretId\ns3_secret_access_key=YourSecretKey\ns3_bucket_name=bucket-name-1250000000\ns3_endpoint_url=https://cos.ap-guangzhou.myqcloud.com\ns3_region_name=ap-guangzhou\ns3_signature_version=s3v4\n```\n\n### Proxy Download\n\nWhen `s3_proxy=1`, file downloads are proxied through the server instead of directly from S3. This is useful when:\n\n- S3 bucket doesn't allow public access\n- Need to hide the actual storage address\n- Network environment restricts direct S3 access\n\n## OneDrive Storage\n\nOneDrive storage supports saving files to Microsoft OneDrive cloud storage.\n\n::: warning Important Limitation\nOneDrive storage **only supports work or school accounts** and requires admin permissions to authorize the API. Personal accounts cannot use this feature.\n:::\n\n### Configuration Parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `file_storage` | string | - | Set to `onedrive` |\n| `onedrive_domain` | string | `\"\"` | Azure AD domain |\n| `onedrive_client_id` | string | `\"\"` | Application (client) ID |\n| `onedrive_username` | string | `\"\"` | Account email |\n| `onedrive_password` | string | `\"\"` | Account password |\n| `onedrive_root_path` | string | `filebox_storage` | Storage root directory in OneDrive |\n| `onedrive_proxy` | int | `0` | Download through server proxy |\n\n### Configuration Example\n\n```bash\nfile_storage=onedrive\nonedrive_domain=contoso.onmicrosoft.com\nonedrive_client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\nonedrive_username=user@contoso.onmicrosoft.com\nonedrive_password=your_password\nonedrive_root_path=filebox_storage\n```\n\n### Azure App Registration Steps\n\nTo use OneDrive storage, you need to register an application in the Azure portal:\n\n#### 1. Get Domain\n\nLog in to [Azure Portal](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade), hover over your account in the top right corner, and the **Domain** shown in the popup is the `onedrive_domain` value.\n\n#### 2. Register Application\n\n1. Click **+ New registration** in the top left\n2. Enter application name (e.g., FileCodeBox)\n3. **Supported account types**: Select \"Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts\"\n4. **Redirect URI**: Select `Web`, enter `http://localhost`\n5. Click **Register**\n\n#### 3. Get Client ID\n\nAfter registration, find the **Application (client) ID** in the **Essentials** section on the app overview page. This is the `onedrive_client_id` value.\n\n#### 4. Configure Authentication\n\n1. Select **Authentication** in the left menu\n2. Find **Allow public client flows**, select **Yes**\n3. Click **Save**\n\n#### 5. Configure API Permissions\n\n1. Select **API permissions** in the left menu\n2. Click **+ Add a permission**\n3. Select **Microsoft Graph** → **Delegated permissions**\n4. Check the following permissions:\n - `openid`\n - `Files.Read`\n - `Files.Read.All`\n - `Files.ReadWrite`\n - `Files.ReadWrite.All`\n - `User.Read`\n5. Click **Add permissions**\n6. Click **Grant admin consent for xxx**\n7. After confirmation, permission status should show **Granted**\n\n### Install Dependencies\n\nUsing OneDrive storage requires additional Python dependencies:\n\n```bash\npip install msal Office365-REST-Python-Client\n```\n\n### Verify Configuration\n\nYou can use the following code to test if the configuration is correct:\n\n```python\nimport msal\nfrom office365.graph_client import GraphClient\n\ndomain = 'your_domain'\nclient_id = 'your_client_id'\nusername = 'your_username'\npassword = 'your_password'\n\ndef acquire_token_pwd():\n authority_url = f'https://login.microsoftonline.com/{domain}'\n app = msal.PublicClientApplication(\n authority=authority_url,\n client_id=client_id\n )\n result = app.acquire_token_by_username_password(\n username=username,\n password=password,\n scopes=['https://graph.microsoft.com/.default']\n )\n return result\n\n# Test connection\nclient = GraphClient(acquire_token_pwd)\nme = client.me.get().execute_query()\nprint(f\"Login successful: {me.user_principal_name}\")\n```\n\n\n## WebDAV Storage\n\nWebDAV storage supports saving files to any service that supports the WebDAV protocol, such as Nextcloud, ownCloud, Nutstore, etc.\n\n### Configuration Parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `file_storage` | string | - | Set to `webdav` |\n| `webdav_url` | string | `\"\"` | WebDAV server URL |\n| `webdav_username` | string | `\"\"` | WebDAV username |\n| `webdav_password` | string | `\"\"` | WebDAV password |\n| `webdav_root_path` | string | `filebox_storage` | Storage root directory in WebDAV |\n| `webdav_proxy` | int | `0` | Download through server proxy |\n\n### Configuration Example\n\n```bash\nfile_storage=webdav\nwebdav_url=https://dav.example.com/remote.php/dav/files/username/\nwebdav_username=your_username\nwebdav_password=your_password\nwebdav_root_path=filebox_storage\n```\n\n### Nextcloud Configuration Example\n\n```bash\nfile_storage=webdav\nwebdav_url=https://your-nextcloud.com/remote.php/dav/files/username/\nwebdav_username=your_username\nwebdav_password=your_app_password\nwebdav_root_path=FileCodeBox\n```\n\n::: tip Nextcloud App Password\nIt's recommended to create an app password in Nextcloud instead of using your main password:\n1. Log in to Nextcloud\n2. Go to **Settings** → **Security**\n3. Create a new app password in **Devices & sessions**\n:::\n\n### Nutstore Configuration Example\n\n```bash\nfile_storage=webdav\nwebdav_url=https://dav.jianguoyun.com/dav/\nwebdav_username=your_email@example.com\nwebdav_password=your_app_password\nwebdav_root_path=FileCodeBox\n```\n\n::: tip Nutstore App Password\nNutstore requires an app password:\n1. Log in to Nutstore web version\n2. Go to **Account Info** → **Security Options**\n3. Add an app password\n:::\n\n## OpenDAL Storage\n\nOpenDAL is a unified data access layer that supports multiple storage services. Through OpenDAL, you can use Google Cloud Storage, Azure Blob Storage, and more.\n\n### Configuration Parameters\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `file_storage` | string | Set to `opendal` |\n| `opendal_scheme` | string | Storage service type (e.g., `gcs`, `azblob`) |\n| `opendal__` | string | Service-specific configuration parameters |\n\n### Install Dependencies\n\n```bash\npip install opendal\n```\n\n### Google Cloud Storage Configuration Example\n\n```bash\nfile_storage=opendal\nopendal_scheme=gcs\nopendal_gcs_root=/filecodebox\nopendal_gcs_bucket=your-bucket-name\nopendal_gcs_credential=base64_encoded_credential\n```\n\n### Azure Blob Storage Configuration Example\n\n```bash\nfile_storage=opendal\nopendal_scheme=azblob\nopendal_azblob_root=/filecodebox\nopendal_azblob_container=your-container\nopendal_azblob_account_name=your_account\nopendal_azblob_account_key=your_key\n```\n\n### Supported Services\n\nOpenDAL supports numerous storage services. For the complete list, see the [OpenDAL Official Documentation](https://opendal.apache.org/docs/rust/opendal/services/index.html).\n\nCommon services include:\n- `gcs` - Google Cloud Storage\n- `azblob` - Azure Blob Storage\n- `obs` - Huawei Cloud OBS\n- `oss` - Aliyun OSS (via OpenDAL)\n- `cos` - Tencent Cloud COS (via OpenDAL)\n- `hdfs` - Hadoop HDFS\n- `ftp` - FTP server\n- `sftp` - SFTP server\n\n::: warning OpenDAL Notes\n1. Services integrated via OpenDAL download through server proxy, consuming both storage service and server bandwidth\n2. Compared to native S3/OneDrive support, OpenDAL may lack some debugging information\n3. OpenDAL is written in Rust with good performance\n:::\n\n## Storage Selection Recommendations\n\n| Scenario | Recommended Storage | Reason |\n|----------|---------------------|--------|\n| Personal/Small deployment | Local storage | Simple and easy, no extra configuration needed |\n| Enterprise intranet | MinIO + S3 | Self-hosted object storage, data control |\n| Public cloud deployment | Corresponding cloud provider S3 | Fast same-region access, low cost |\n| Existing OneDrive | OneDrive | Utilize existing resources |\n| Existing WebDAV | WebDAV | Good compatibility |\n| Special storage needs | OpenDAL | Supports more storage services |\n\n## Common Issues\n\n### S3 Upload Failure\n\n1. Check if Access Key and Secret Key are correct\n2. Confirm bucket name and region configuration are correct\n3. Check bucket access permission settings\n4. Confirm signature version (`s3v2` or `s3v4`) matches service provider requirements\n\n### OneDrive Authentication Failure\n\n1. Confirm using a work/school account, not a personal account\n2. Check if Azure app has been granted admin consent\n3. Confirm API permissions are fully configured\n4. Verify username and password are correct\n\n### WebDAV Connection Failure\n\n1. Check if WebDAV URL format is correct\n2. Confirm username and password (or app password) are correct\n3. Check if server supports WebDAV protocol\n4. Confirm network connection is normal\n" }, { "path": "docs/en/guide/upload.md", "content": "# File Upload\n\nFileCodeBox provides multiple flexible file upload methods, supporting both regular upload and chunked upload to meet different scenario requirements.\n\n## Upload Methods\n\nFileCodeBox supports the following upload methods:\n\n### Drag and Drop Upload\n\nDrag files directly to the upload area to start uploading. This is the most convenient upload method.\n\n1. Open the FileCodeBox homepage\n2. Drag files from your file manager to the upload area\n3. Release the mouse, file upload begins\n4. Get the extraction code after upload completes\n\n::: tip Tip\nDrag and drop upload supports dragging multiple files simultaneously (depending on theme support).\n:::\n\n### Click Upload\n\nClick the upload area to select files through the system file picker.\n\n1. Click the \"Select File\" button in the upload area\n2. Select the file to upload in the popup file picker\n3. File upload begins after confirming selection\n4. Get the extraction code after upload completes\n\n### Paste Upload\n\nSupports pasting images directly from clipboard for upload (supported by some themes).\n\n1. Copy an image to clipboard (screenshot or copy image)\n2. Use `Ctrl+V` (Windows/Linux) or `Cmd+V` (macOS) to paste in the upload area\n3. Image upload starts automatically\n4. Get the extraction code after upload completes\n\n::: warning Note\nPaste upload only supports image formats, not other file types. Specific support depends on the theme being used.\n:::\n\n## File Size Limits\n\n### Default Limits\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `uploadSize` | 10MB | Maximum single file upload size |\n\n### Modify Upload Limits\n\nAdministrators can modify upload size limits through the admin panel or configuration file:\n\n```python\n# Set maximum upload size to 100MB\nuploadSize = 104857600 # 100 * 1024 * 1024\n```\n\n::: info Note\n`uploadSize` is in bytes. Common conversions:\n- 10MB = 10485760\n- 50MB = 52428800\n- 100MB = 104857600\n- 500MB = 524288000\n- 1GB = 1073741824\n:::\n\n### Exceeding Limit Handling\n\nWhen an uploaded file exceeds the size limit, the system returns a 403 error:\n\n```json\n{\n \"detail\": \"Size exceeds limit, maximum is 10.00 MB\"\n}\n```\n\n## Regular Upload API\n\n### File Upload Endpoint\n\n**POST** `/share/file/`\n\nContent-Type: `multipart/form-data`\n\n**Request parameters:**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `file` | file | Yes | File to upload |\n| `expire_value` | int | No | Expiration value, default 1 |\n| `expire_style` | string | No | Expiration method, default `day` |\n\n**Expiration method options:**\n\n| Value | Description |\n|-------|-------------|\n| `day` | Expire by days |\n| `hour` | Expire by hours |\n| `minute` | Expire by minutes |\n| `forever` | Never expire |\n| `count` | Expire by download count |\n\n**Response example:**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"654321\",\n \"name\": \"example.pdf\"\n }\n}\n```\n\n**cURL example:**\n\n```bash\n# Upload file (default 1 day expiration)\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.pdf\"\n\n# Upload file with 7 days expiration\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.pdf\" \\\n -F \"expire_value=7\" \\\n -F \"expire_style=day\"\n\n# Upload file with 10 downloads limit\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.pdf\" \\\n -F \"expire_value=10\" \\\n -F \"expire_style=count\"\n\n# Share text\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -F \"text=This is the text content to share\"\n\n# Download file by extraction code\ncurl -L \"http://localhost:12345/share/select/?code=YOUR_CODE\" -o downloaded_file\n```\n\n::: tip When Authentication Required\nIf guest upload is disabled in admin panel (`openUpload=0`), you need to login first:\n\n```bash\n# 1. Login to get token\ncurl -X POST \"http://localhost:12345/admin/login\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"password\": \"FileCodeBox2023\"}'\n\n# Returns: {\"code\":200,\"msg\":\"success\",\"detail\":{\"token\":\"xxx.xxx.xxx\",\"token_type\":\"Bearer\"}}\n\n# 2. Upload file with token\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -H \"Authorization: Bearer xxx.xxx.xxx\" \\\n -F \"file=@/path/to/file.pdf\"\n\n# 3. Share text with token\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -H \"Authorization: Bearer xxx.xxx.xxx\" \\\n -F \"text=This is the text content to share\"\n```\n:::\n\n\n## Chunked Upload API\n\nFor large files, FileCodeBox supports chunked upload functionality. Chunked upload splits large files into multiple small chunks for separate uploading, supporting resume capability.\n\n::: warning Prerequisite\nChunked upload functionality requires administrator enablement: `enableChunk=1`\n:::\n\n### Chunked Upload Flow\n\n```\n┌─────────────┐ ┌─────────────┐ ┌─────────────┐\n│ Initialize │ ──▶ │Upload Chunks│ ──▶ │ Complete │\n│ /init/ │ │ /chunk/ │ │ /complete/ │\n└─────────────┘ └─────────────┘ └─────────────┘\n │\n ▼\n ┌───────────┐\n │ Loop │\n │each chunk │\n └───────────┘\n```\n\n### 1. Initialize Upload\n\n**POST** `/chunk/upload/init/`\n\n**Request parameters:**\n\n```json\n{\n \"file_name\": \"large_file.zip\",\n \"file_size\": 104857600,\n \"chunk_size\": 5242880,\n \"file_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\"\n}\n```\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| `file_name` | string | Yes | - | Filename |\n| `file_size` | int | Yes | - | Total file size (bytes) |\n| `chunk_size` | int | No | 5MB | Chunk size (bytes) |\n| `file_hash` | string | Yes | - | SHA256 hash of the file |\n\n**Response example:**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"existed\": false,\n \"upload_id\": \"abc123def456789\",\n \"chunk_size\": 5242880,\n \"total_chunks\": 20,\n \"uploaded_chunks\": []\n }\n}\n```\n\n| Field | Description |\n|-------|-------------|\n| `existed` | Whether file already exists (instant upload) |\n| `upload_id` | Upload session ID |\n| `chunk_size` | Chunk size |\n| `total_chunks` | Total number of chunks |\n| `uploaded_chunks` | List of already uploaded chunk indices |\n\n### 2. Upload Chunk\n\n**POST** `/chunk/upload/chunk/{upload_id}/{chunk_index}`\n\n**Path parameters:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `upload_id` | Upload session ID returned during initialization |\n| `chunk_index` | Chunk index, starting from 0 |\n\n**Request body:**\n\nContent-Type: `multipart/form-data`\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `chunk` | file | Chunk data |\n\n**Response example:**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"chunk_hash\": \"a1b2c3d4e5f6...\"\n }\n}\n```\n\n**cURL example:**\n\n```bash\n# Upload first chunk (index 0)\ncurl -X POST \"http://localhost:12345/chunk/upload/chunk/abc123def456789/0\" \\\n -F \"chunk=@/path/to/chunk_0\"\n```\n\n### 3. Complete Upload\n\n**POST** `/chunk/upload/complete/{upload_id}`\n\n**Path parameters:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `upload_id` | Upload session ID |\n\n**Request parameters:**\n\n```json\n{\n \"expire_value\": 7,\n \"expire_style\": \"day\"\n}\n```\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `expire_value` | int | Yes | Expiration value |\n| `expire_style` | string | Yes | Expiration method |\n\n**Response example:**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"789012\",\n \"name\": \"large_file.zip\"\n }\n}\n```\n\n### Resume Upload\n\nChunked upload supports resume functionality. When upload is interrupted:\n\n1. Call the initialization endpoint again with the same `file_hash`\n2. Server returns `uploaded_chunks` list containing already uploaded chunk indices\n3. Client only needs to upload chunks not in the list\n4. Call the complete endpoint after all chunks are uploaded\n\n**Example flow:**\n\n```javascript\n// 1. Initialize upload\nconst initResponse = await fetch('/chunk/upload/init/', {\n method: 'POST',\n body: JSON.stringify({\n file_name: 'large_file.zip',\n file_size: fileSize,\n chunk_size: 5 * 1024 * 1024,\n file_hash: fileHash\n })\n});\nconst { upload_id, uploaded_chunks, total_chunks } = await initResponse.json();\n\n// 2. Upload incomplete chunks\nfor (let i = 0; i < total_chunks; i++) {\n if (!uploaded_chunks.includes(i)) {\n const chunk = file.slice(i * chunkSize, (i + 1) * chunkSize);\n await fetch(`/chunk/upload/chunk/${upload_id}/${i}`, {\n method: 'POST',\n body: chunk\n });\n }\n}\n\n// 3. Complete upload\nawait fetch(`/chunk/upload/complete/${upload_id}`, {\n method: 'POST',\n body: JSON.stringify({\n expire_value: 7,\n expire_style: 'day'\n })\n});\n```\n\n## Error Handling\n\n### Common Errors\n\n| HTTP Status | Error Message | Cause | Solution |\n|-------------|---------------|-------|----------|\n| 403 | Size exceeds limit | File exceeds `uploadSize` limit | Reduce file size or contact administrator to adjust limit |\n| 403 | Upload rate limit | Exceeded IP upload rate limit | Wait for limit time window before retrying |\n| 400 | Invalid expiration type | `expire_style` value not in allowed list | Use a valid expiration method |\n| 404 | Upload session not found | `upload_id` invalid or expired | Re-initialize upload |\n| 400 | Invalid chunk index | `chunk_index` out of range | Check if chunk index is correct |\n| 400 | Incomplete chunks | Chunk count insufficient when completing upload | Ensure all chunks are uploaded |\n\n### Rate Limiting\n\nThe system has rate limits on upload operations to prevent abuse:\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `uploadMinute` | 1 | Limit time window (minutes) |\n| `uploadCount` | 10 | Maximum uploads within time window |\n\nWhen rate limit is exceeded, you need to wait for the time window to pass before continuing uploads.\n\n### Error Response Format\n\n```json\n{\n \"detail\": \"Error message description\"\n}\n```\n\n## Upload Configuration\n\n### Related Settings\n\n| Setting | Type | Default | Description |\n|---------|------|---------|-------------|\n| `openUpload` | int | 1 | Enable upload (1=enabled, 0=disabled) |\n| `uploadSize` | int | 10485760 | Maximum upload size (bytes) |\n| `enableChunk` | int | 0 | Enable chunked upload (1=enabled, 0=disabled) |\n| `uploadMinute` | int | 1 | Upload rate limit time window (minutes) |\n| `uploadCount` | int | 10 | Maximum uploads within time window |\n| `expireStyle` | list | [\"day\",\"hour\",\"minute\",\"forever\",\"count\"] | Allowed expiration methods |\n\n### Configuration Example\n\n```python\n# Allow 100MB file uploads, enable chunked upload\nuploadSize = 104857600\nenableChunk = 1\n\n# Relax upload rate limit: max 50 uploads per 5 minutes\nuploadMinute = 5\nuploadCount = 50\n\n# Only allow expiration by days and count\nexpireStyle = [\"day\", \"count\"]\n```\n\n## Next Steps\n\n- [File Sharing](/en/guide/share) - Learn the complete sharing process\n- [Configuration Guide](/en/guide/configuration) - Learn about all configuration options\n- [Storage Configuration](/en/guide/storage) - Learn about file storage methods\n- [Security Settings](/en/guide/security) - Learn about security-related configurations\n" }, { "path": "docs/en/index.md", "content": "---\nlayout: home\n\nhero:\n name: \"FileCodeBox\"\n text: \"File Express Box\"\n tagline: Share text and files anonymously with access codes, just like picking up a package\n image:\n src: /logo_small.png\n alt: FileCodeBox\n actions:\n - theme: brand\n text: Get Started\n link: /en/guide/getting-started\n - theme: alt\n text: Live Demo\n link: https://share.lanol.cn\n - theme: alt\n text: View on GitHub\n link: https://github.com/vastsa/FileCodeBox\n\nfeatures:\n - icon: 🚀\n title: Quick Deployment\n details: Supports one-click Docker deployment, simple and fast, no complex configuration needed\n - icon: 🔒\n title: Secure & Reliable\n details: File access requires an access code, supports expiration time and download limit settings\n - icon: 💻\n title: Clean Interface\n details: Clean user interface with drag-and-drop upload support for excellent user experience\n - icon: 🛠️\n title: Feature Rich\n details: Supports file preview, online playback, image processing, and many other features\n - icon: 📦\n title: Storage Extensions\n details: Supports various storage methods including local storage and object storage\n - icon: 🔌\n title: API Support\n details: Provides complete REST API for easy integration with other systems\n--- " }, { "path": "docs/en/showcase.md", "content": "# Showcase\n\nHere are some excellent sites built with FileCodeBox. If you've deployed FileCodeBox, feel free to submit a PR to add your site here!\n\n## Official Demo\n\n
\n\n
\n\n### 🌟 FileCodeBox Demo\n\n- **URL**: [share.lanol.cn](https://share.lanol.cn)\n- **Description**: Official demo site with the latest features\n- **Highlights**: Stable, full-featured\n\n
\n\n
\n\n## Community Sites\n\n::: tip Submit Your Site\nIf you've built your own file sharing service using FileCodeBox, you can submit it through:\n\n1. Submit a PR on [GitHub](https://github.com/vastsa/FileCodeBox) to edit this page\n2. Open an [Issue](https://github.com/vastsa/FileCodeBox/issues) with your site info\n3. Join QQ Group 739673698 to contact the admin\n:::\n\n\n\n
\n\n
\n\n### QuWenJian\n\n- **URL**: [www.quwenjian.cn/fby.html](https://www.quwenjian.cn/fby.html)\n- **Description**: QuWenJian - Unlimited storage, portable and limitless\n- **Highlights**: Free file transfer station\n- **Operator**: QuWenJian\n\n
\n\n
\n\n### Pandora Box\n\n- **URL**: [pan.duo.la](https://pan.duo.la)\n- **Description**: Pandora Box\n- **Highlights**: Classic v1.6 version\n- **Operator**: WuXingQueXinYan\n\n
\n\n
\n\n## Submission Requirements\n\nTo ensure quality, please make sure your site meets the following criteria:\n\n1. **Stable**: Your site should be stable and accessible\n2. **Legal**: Content must be legal and compliant\n3. **Attribution**: We recommend keeping FileCodeBox attribution\n4. **HTTPS**: We recommend enabling HTTPS\n\n## Submission Template\n\nIf you want to submit your site, please use the following format:\n\n```markdown\n### Site Name\n\n- **URL**: [domain](https://domain)\n- **Description**: One-line description of your site\n- **Highlights**: Special features or highlights\n- **Operator**: Optional, your name or organization\n```\n\n\n" }, { "path": "docs/guide/configuration.md", "content": "# 配置说明\n\nFileCodeBox 提供了丰富的配置选项，可以通过管理面板或直接修改配置来自定义系统行为。本文档详细介绍所有可用的配置项。\n\n## 配置方式\n\nFileCodeBox 支持两种配置方式：\n\n1. **管理面板配置**（推荐）：访问 `/admin` 进入管理面板，在设置页面修改配置\n2. **数据库配置**：配置存储在 `data/filecodebox.db` 数据库中\n\n::: tip 提示\n首次启动时，系统会使用 `core/settings.py` 中的默认配置。修改后的配置会保存到数据库中。\n:::\n\n## 基础设置\n\n### 站点信息\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `name` | string | `文件快递柜 - FileCodeBox` | 站点名称，显示在页面标题和导航栏 |\n| `description` | string | `开箱即用的文件快传系统` | 站点描述，用于 SEO |\n| `keywords` | string | `FileCodeBox, 文件快递柜...` | 站点关键词，用于 SEO |\n| `port` | int | `12345` | 服务监听端口 |\n\n### 通知设置\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `notify_title` | string | `系统通知` | 通知标题 |\n| `notify_content` | string | 欢迎信息 | 通知内容，支持 HTML |\n| `page_explain` | string | 法律声明 | 页面底部说明文字 |\n| `robotsText` | string | `User-agent: *\\nDisallow: /` | robots.txt 内容 |\n\n## 上传设置\n\n### 文件上传限制\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `openUpload` | int | `1` | 是否开启上传功能（1=开启，0=关闭） |\n| `uploadSize` | int | `10485760` | 单文件最大上传大小（字节），默认 10MB |\n| `enableChunk` | int | `0` | 是否启用分片上传（1=启用，0=禁用） |\n\n::: warning 注意\n`uploadSize` 的单位是字节。10MB = 10 * 1024 * 1024 = 10485760 字节\n:::\n\n### 上传频率限制\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `uploadMinute` | int | `1` | 上传限制的时间窗口（分钟） |\n| `uploadCount` | int | `10` | 在时间窗口内允许的最大上传次数 |\n\n例如：默认配置表示每 1 分钟内最多允许上传 10 次。\n\n### 文件过期设置\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `expireStyle` | list | `[\"day\",\"hour\",\"minute\",\"forever\",\"count\"]` | 可选的过期方式 |\n| `max_save_seconds` | int | `0` | 文件最大保存时间（秒），0 表示不限制 |\n\n过期方式说明：\n- `day` - 按天过期\n- `hour` - 按小时过期\n- `minute` - 按分钟过期\n- `forever` - 永不过期\n- `count` - 按下载次数过期\n\n## 主题设置\n\n### 主题选择\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `themesSelect` | string | `themes/2024` | 当前使用的主题 |\n| `themesChoices` | list | 见下方 | 可用主题列表 |\n\n默认可用主题：\n```json\n[\n {\n \"name\": \"2023\",\n \"key\": \"themes/2023\",\n \"author\": \"Lan\",\n \"version\": \"1.0\"\n },\n {\n \"name\": \"2024\",\n \"key\": \"themes/2024\",\n \"author\": \"Lan\",\n \"version\": \"1.0\"\n }\n]\n```\n\n### 界面样式\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `opacity` | float | `0.9` | 界面透明度（0-1） |\n| `background` | string | `\"\"` | 自定义背景图片 URL，为空则使用默认背景 |\n\n## 管理员设置\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `admin_token` | string | `FileCodeBox2023` | 管理员登录密码 |\n| `showAdminAddr` | int | `0` | 是否在首页显示管理入口（1=显示，0=隐藏） |\n\n::: danger 安全警告\n请务必在生产环境中修改默认的 `admin_token`！使用默认密码会导致严重的安全风险。\n:::\n\n## 安全设置\n\n### 错误次数限制\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `errorMinute` | int | `1` | 错误限制的时间窗口（分钟） |\n| `errorCount` | int | `1` | 在时间窗口内允许的最大错误次数 |\n\n此设置用于防止暴力破解提取码。\n\n## 存储设置\n\n### 存储类型\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `file_storage` | string | `local` | 存储后端类型 |\n| `storage_path` | string | `\"\"` | 自定义存储路径 |\n\n支持的存储类型：\n- `local` - 本地存储\n- `s3` - S3 兼容存储（AWS S3、阿里云 OSS、MinIO 等）\n- `onedrive` - OneDrive 存储\n- `webdav` - WebDAV 存储\n- `opendal` - OpenDAL 存储\n\n详细的存储配置请参考 [存储配置](/guide/storage)。\n\n## 配置示例\n\n### 示例 1：小型个人使用\n\n适合个人或小团队使用，限制较宽松：\n\n```python\n{\n \"name\": \"我的文件分享\",\n \"uploadSize\": 52428800, # 50MB\n \"uploadMinute\": 5, # 5分钟\n \"uploadCount\": 20, # 最多20次\n \"expireStyle\": [\"day\", \"hour\", \"forever\"],\n \"admin_token\": \"your-secure-password\",\n \"showAdminAddr\": 1\n}\n```\n\n### 示例 2：公开服务\n\n适合公开服务，需要更严格的限制：\n\n```python\n{\n \"name\": \"公共文件快递柜\",\n \"uploadSize\": 10485760, # 10MB\n \"uploadMinute\": 1, # 1分钟\n \"uploadCount\": 5, # 最多5次\n \"errorMinute\": 5, # 5分钟\n \"errorCount\": 3, # 最多3次错误\n \"expireStyle\": [\"hour\", \"minute\", \"count\"],\n \"max_save_seconds\": 86400, # 最长保存1天\n \"admin_token\": \"very-secure-password-123\",\n \"showAdminAddr\": 0\n}\n```\n\n### 示例 3：企业内部使用\n\n适合企业内部使用，支持大文件和分片上传：\n\n```python\n{\n \"name\": \"企业文件中转站\",\n \"uploadSize\": 1073741824, # 1GB\n \"enableChunk\": 1, # 启用分片上传\n \"uploadMinute\": 10, # 10分钟\n \"uploadCount\": 100, # 最多100次\n \"expireStyle\": [\"day\", \"forever\"],\n \"file_storage\": \"s3\", # 使用S3存储\n \"admin_token\": \"enterprise-secure-token\",\n \"showAdminAddr\": 1\n}\n```\n\n## 下一步\n\n- [存储配置](/guide/storage) - 了解如何配置不同的存储后端\n- [安全设置](/guide/security) - 了解如何增强系统安全性\n- [文件分享](/guide/share) - 了解文件分享功能\n" }, { "path": "docs/guide/getting-started.md", "content": "# 快速开始\n\n## 简介\n\nFileCodeBox 是一个简单高效的文件分享工具，支持文件临时中转、分享和管理。本指南将帮助您快速部署和使用 FileCodeBox。\n\n## 特性\n\n- 🚀 快速部署：支持 Docker 一键部署\n- 🔒 安全可靠：文件访问需要提取码\n- ⏱️ 时效控制：支持设置文件有效期\n- 📊 下载限制：可限制文件下载次数\n- 🖼️ 文件预览：支持图片、视频、音频等多种格式预览\n- 📱 响应式设计：完美适配移动端和桌面端\n\n## 部署方式\n\n### Docker 部署（推荐）\n\n#### 快速启动\n\n```bash\ndocker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:latest\n```\n\n#### Docker Compose\n\n```yml\nversion: \"3\"\nservices:\n file-code-box:\n image: lanol/filecodebox:latest\n volumes:\n - fcb-data:/app/data:rw\n restart: unless-stopped\n ports:\n - \"12345:12345\"\n environment:\n - WORKERS=4\n - LOG_LEVEL=info\nvolumes:\n fcb-data:\n external: false\n```\n\n#### 环境变量\n\n| 变量 | 默认值 | 说明 |\n|------|--------|------|\n| `HOST` | `::` | 监听地址，支持 IPv4/IPv6 双栈 |\n| `PORT` | `12345` | 服务端口 |\n| `WORKERS` | `4` | 工作进程数，建议设置为 CPU 核心数 |\n| `LOG_LEVEL` | `info` | 日志级别：debug/info/warning/error |\n\n#### 自定义配置示例\n\n```bash\ndocker run -d --restart=always \\\n -p 12345:12345 \\\n -v /opt/FileCodeBox/:/app/data \\\n -e WORKERS=8 \\\n -e LOG_LEVEL=warning \\\n --name filecodebox \\\n lanol/filecodebox:latest\n```\n\n### 配置反向代理（Nginx）\n\n```nginx\nlocation / {\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_pass http://localhost:12345;\n}\n```\n\n### 手动部署\n\n1. 克隆项目\n```bash\ngit clone https://github.com/vastsa/FileCodeBox.git\n```\n\n2. 安装依赖\n```bash\ncd FileCodeBox\npip install -r requirements.txt\n```\n\n3. 启动服务\n```bash\npython main.py\n```\n\n\n## 使用方法\n\n1. 访问系统\n 打开浏览器访问 `http://localhost:12345`\n\n2. 上传文件\n - 点击上传按钮或拖拽文件到上传区域\n - 设置文件有效期和下载次数限制\n - 获取分享链接和提取码\n\n3. 下载文件\n - 访问分享链接\n - 输入提取码\n - 下载文件\n\n4. 后台管理\n - 访问 `http://localhost:12345/#/admin`\n - 输入管理员密码：`FileCodeBox2023`\n - 进入后台管理页面\n - 查看系统信息、文件列表、用户管理等\n\n## 下一步\n\n- [存储配置](/guide/storage) - 了解如何配置不同的存储方式\n- [安全设置](/guide/security) - 了解如何增强系统安全性\n- [API 文档](/api/) - 了解如何通过 API 集成 " }, { "path": "docs/guide/introduction.md", "content": "
\n\n\"FileCodeBox\n\n

匿名口令分享文本和文件，像拿快递一样取文件

\n\n[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/network)\n[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/issues)\n[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)\n[![QQ Group](https://img.shields.io/badge/QQ%20Group-739673698-blue.svg)](https://qm.qq.com/q/PemPzhdEIM)\n[![Python Version](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-green.svg)](https://fastapi.tiangolo.com)\n[![Vue Version](https://img.shields.io/badge/Vue.js-3.x-brightgreen.svg)](https://v3.vuejs.org)\n
\n\n\n## 🚀 更新计划\n- [ ] 切片上传，同文件秒传，断点续传\n- [ ] 用户登录重构\n- [x] webdav存储\n- [x] 存储支持自定义路径\n- [x] s3优化，不修改昵称为uuid，新建目录\n\n## 📝 项目简介\n\nFileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具。它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。\n\n## 🎯 应用场景\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

📁 临时文件分享

\n快速分享单个文件，无需注册登录\n		\n

📝 文本快速分享

\n分享代码片段、文本内容等\n		\n

🕶️ 匿名文件传输

\n保护隐私的文件传输方式\n
\n

💾 临时文件存储

\n支持设置过期时间的文件存储\n		\n

🔄 跨平台传输

\n在不同设备间快速传输文件\n		\n

🌐 小型分享服务

\n搭建私有的文件分享服务\n
\n\n## ✨ 核心特性\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

🚀 轻量简洁

\n基于 FastAPI + SQLite3 + Vue3 + ElementUI，部署简单，性能出色\n		\n

📤 便捷上传

\n支持复制粘贴、拖拽上传，操作简单直观\n		\n

📦 多种类型

\n支持文本和各类文件的分享\n
\n

🔒 安全机制

\n\n- IP 限制上传次数\n- 错误次数限制\n- 文件过期机制\n		\n

🎫 提取码分享

\n随机提取码，可自定义次数及有效期\n		\n

🌍 多语言支持

\n支持中文简体、繁体及英文\n
\n

🎭 匿名分享

\n无需注册登录，保护隐私\n		\n

🛠 管理面板

\n文件管理和系统配置\n		\n

🐳 容器部署

\n支持 Docker 一键部署\n
\n

💾 存储扩展

\n支持本地存储、S3 协议、OneDrive 等\n		\n

📱 响应式设计

\n支持移动端访问\n		\n

💻 终端支持

\n支持命令行下载\n
\n\n## 🚀 快速开始\n\n### Docker 部署\n\n```bash\ndocker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta\n```\n\n### 手动部署\n\n1. 克隆项目\n```bash\ngit clone https://github.com/vastsa/FileCodeBox.git\n```\n\n2. 安装依赖\n```bash\ncd FileCodeBox\npip install -r requirements.txt\n```\n\n3. 启动服务\n```bash\npython main.py\n```\n\n## 📖 使用说明\n\n### 分享文件\n1. 打开网页，点击\"分享文件\"\n2. 选择或拖拽文件\n3. 设置过期时间和次数\n4. 获取提取码\n\n### 获取文件\n1. 打开网页，输入提取码\n2. 点击获取\n3. 下载文件或查看文本\n\n### 管理面板\n1. 访问 `/admin`\n2. 输入管理员密码\n3. 管理文件和配置\n\n## 🛠 开发指南\n\n### 项目结构\n```\nFileCodeBox/\n├── apps/ # 应用代码\n│ ├── admin/ # 管理后台\n│ └── base/ # 基础功能\n├── core/ # 核心功能\n├── data/ # 数据目录\n└── fcb-fronted/ # 前端代码\n```\n\n### 开发环境\n- Python 3.8+\n- Node.js 14+\n- Vue 3\n- FastAPI\n\n### 本地开发\n1. 后端开发\n```bash\npython main.py\n```\n\n2. 前端开发\n```bash\ncd fcb-fronted\nnpm install\nnpm run dev\n```\n\n## 🤝 贡献指南\n\n1. Fork 本项目\n2. 创建新分支 `git checkout -b feature/xxx`\n3. 提交更改 `git commit -m 'Add xxx'`\n4. 推送到分支 `git push origin feature/xxx`\n5. 提交 Pull Request\n\n## ❓ 常见问题\n\n### Q: 如何修改上传大小限制？\nA: 在管理面板中修改配置项 `uploadSize`\n\n### Q: 如何配置存储引擎？\nA: 在管理面板中选择存储引擎并配置相应参数\n\n### Q: 如何备份数据？\nA: 备份 `data` 目录即可\n\n更多问题请访问 [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题)\n\n## 📊 项目统计\n\n
\n\"Featured｜HelloGitHub\"\n\n![Repobeats](https://repobeats.axiom.co/api/embed/7a6c92f1d96ee57e6fb67f0df371528397b0c9ac.svg)\n\n[![Star History](https://api.star-history.com/svg?repos=vastsa/FileCodeBox&type=Date)](https://star-history.com/#vastsa/FileCodeBox&Date)\n
\n\n## 📜 免责声明\n\n本项目开源仅供学习使用，不得用于任何违法用途，否则后果自负，与作者无关。使用时请保留项目地址和版权信息。\n" }, { "path": "docs/guide/management.md", "content": "# 管理面板\n\nFileCodeBox 提供了功能完善的管理面板，让管理员可以方便地管理文件、查看系统状态和修改配置。本文档介绍管理面板的各项功能和使用方法。\n\n## 访问管理面板\n\n### 登录方式\n\n管理面板位于 `/admin` 路径。访问方式：\n\n1. 在浏览器中访问 `http://your-domain.com/admin`\n2. 输入管理员密码（`admin_token` 配置项的值）\n3. 点击登录按钮\n\n::: tip 提示\n默认管理员密码是 `FileCodeBox2023`。请务必在生产环境中修改此密码，详见 [安全设置](/guide/security)。\n:::\n\n### 显示管理入口\n\n默认情况下，首页不显示管理面板入口。您可以通过配置控制是否显示：\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `showAdminAddr` | int | `0` | 是否在首页显示管理入口（1=显示，0=隐藏） |\n\n::: warning 安全建议\n在公开服务中，建议保持 `showAdminAddr` 为 `0`，通过直接访问 `/admin` 路径进入管理面板，减少被恶意扫描的风险。\n:::\n\n### 认证机制\n\n管理面板使用 JWT（JSON Web Token）进行身份认证：\n\n1. 登录成功后，服务器返回一个包含管理员身份的 Token\n2. 后续请求通过 `Authorization: Bearer ` 头部携带 Token\n3. Token 用于验证管理员身份，确保只有授权用户可以访问管理功能\n\n## 仪表盘\n\n登录后首先看到的是仪表盘页面，展示系统的整体运行状态。\n\n### 统计指标\n\n仪表盘显示以下关键指标：\n\n| 指标 | 说明 |\n|------|------|\n| **文件总数** (`totalFiles`) | 系统中存储的文件总数量 |\n| **存储使用量** (`storageUsed`) | 所有文件占用的总存储空间（字节） |\n| **系统运行时间** (`sysUptime`) | 系统首次启动的时间 |\n| **昨日上传数** (`yesterdayCount`) | 昨天一整天上传的文件数量 |\n| **昨日上传量** (`yesterdaySize`) | 昨天上传文件的总大小（字节） |\n| **今日上传数** (`todayCount`) | 今天到目前为止上传的文件数量 |\n| **今日上传量** (`todaySize`) | 今天上传文件的总大小（字节） |\n\n### 指标说明\n\n- **文件总数**：包括所有未过期的文件和文本分享\n- **存储使用量**：显示实际文件占用的存储空间，不包括数据库等系统文件\n- **昨日/今日统计**：基于文件创建时间计算，用于了解系统使用趋势\n\n::: tip 提示\n存储使用量显示的是字节数。例如 `10485760` 表示约 10MB。\n:::\n\n## 文件管理\n\n### 文件列表\n\n文件管理页面展示系统中所有已分享的文件，支持分页浏览和搜索。\n\n**列表信息包括：**\n- 文件 ID\n- 提取码（code）\n- 文件名前缀（prefix）\n- 文件后缀（suffix）\n- 文件大小\n- 创建时间\n- 过期时间\n- 剩余下载次数\n\n### 搜索文件\n\n使用搜索功能可以快速找到特定文件：\n\n1. 在搜索框中输入关键词\n2. 系统会根据文件名前缀（prefix）进行模糊匹配\n3. 搜索结果实时更新\n\n**搜索示例：**\n- 输入 `report` 可以找到所有文件名包含 \"report\" 的文件\n- 输入 `.pdf` 可以找到所有 PDF 文件（如果文件名包含此字符串）\n\n### 分页浏览\n\n文件列表支持分页显示：\n\n| 参数 | 默认值 | 说明 |\n|------|--------|------|\n| `page` | `1` | 当前页码 |\n| `size` | `10` | 每页显示数量 |\n\n### 删除文件\n\n管理员可以删除任意文件：\n\n1. 在文件列表中找到要删除的文件\n2. 点击删除按钮\n3. 确认删除操作\n\n::: danger 警告\n删除操作不可恢复！文件将从存储后端永久删除，同时删除数据库中的记录。\n:::\n\n**删除流程：**\n1. 系统首先从存储后端（本地/S3/OneDrive 等）删除实际文件\n2. 然后从数据库中删除文件记录\n3. 删除后，对应的提取码将失效\n\n### 下载文件\n\n管理员可以直接下载任意文件：\n\n1. 在文件列表中找到目标文件\n2. 点击下载按钮\n3. 文件将通过浏览器下载\n\n对于文本分享，系统会直接返回文本内容而不是下载文件。\n\n### 修改文件信息\n\n管理员可以修改已分享文件的部分信息：\n\n| 可修改字段 | 说明 |\n|------------|------|\n| `code` | 提取码（必须唯一，不能与其他文件重复） |\n| `prefix` | 文件名前缀 |\n| `suffix` | 文件后缀名 |\n| `expired_at` | 过期时间 |\n| `expired_count` | 剩余下载次数 |\n\n**修改提取码：**\n```\n原提取码：abc123\n新提取码：myfile2024\n```\n\n::: warning 注意\n修改提取码时，系统会检查新提取码是否已被使用。如果已存在相同的提取码，修改将失败。\n:::\n\n## 本地文件管理\n\n除了管理已分享的文件，管理面板还提供了本地文件管理功能，用于管理 `data/local` 目录中的文件。\n\n### 查看本地文件\n\n本地文件列表显示 `data/local` 目录中的所有文件：\n\n| 信息 | 说明 |\n|------|------|\n| 文件名 | 文件的完整名称 |\n| 创建时间 | 文件的创建时间 |\n| 文件大小 | 文件大小（字节） |\n\n### 分享本地文件\n\n可以将本地文件快速分享：\n\n1. 在本地文件列表中选择要分享的文件\n2. 设置过期方式和过期值\n3. 点击分享按钮\n4. 系统生成提取码\n\n**分享参数：**\n\n| 参数 | 说明 |\n|------|------|\n| `filename` | 要分享的文件名 |\n| `expire_style` | 过期方式（day/hour/minute/forever/count） |\n| `expire_value` | 过期值（天数/小时数/分钟数/下载次数） |\n\n### 删除本地文件\n\n可以删除 `data/local` 目录中的文件：\n\n1. 在本地文件列表中找到要删除的文件\n2. 点击删除按钮\n3. 确认删除\n\n::: tip 使用场景\n本地文件管理功能适用于：\n- 批量上传文件到服务器后进行分享\n- 管理通过其他方式上传到服务器的文件\n- 清理不需要的本地文件\n:::\n\n## 系统设置\n\n### 查看配置\n\n在系统设置页面可以查看当前所有配置项的值。配置项按类别分组显示：\n\n- 基础设置（站点名称、描述等）\n- 上传设置（文件大小限制、频率限制等）\n- 存储设置（存储类型、路径等）\n- 主题设置（主题选择、透明度等）\n- 安全设置（管理员密码、错误限制等）\n\n### 修改配置\n\n管理员可以通过管理面板修改大部分配置：\n\n1. 进入系统设置页面\n2. 找到要修改的配置项\n3. 输入新的值\n4. 点击保存按钮\n\n**可修改的配置项：**\n\n| 类别 | 配置项示例 |\n|------|------------|\n| 基础设置 | `name`, `description`, `keywords`, `notify_title`, `notify_content` |\n| 上传设置 | `uploadSize`, `uploadMinute`, `uploadCount`, `openUpload`, `enableChunk` |\n| 过期设置 | `expireStyle`, `max_save_seconds` |\n| 主题设置 | `themesSelect`, `opacity`, `background` |\n| 安全设置 | `admin_token`, `showAdminAddr`, `errorMinute`, `errorCount` |\n| 存储设置 | `file_storage`, `storage_path` 及各存储后端的配置 |\n\n::: warning 注意\n- `admin_token`（管理员密码）不能设置为空\n- `themesChoices`（主题列表）不可通过管理面板修改\n- 修改存储设置后，已有文件不会自动迁移\n:::\n\n### 配置生效\n\n配置修改后立即生效，无需重启服务。配置保存在数据库中，重启后仍然有效。\n\n**配置存储位置：**\n- 数据库：`data/filecodebox.db`\n- 表名：`keyvalue`\n- 键名：`settings`\n\n## API 接口\n\n管理面板的所有功能都通过 REST API 实现，以下是主要接口：\n\n### 认证接口\n\n**登录**\n```\nPOST /admin/login\nContent-Type: application/json\n\n{\n \"password\": \"your-admin-password\"\n}\n```\n\n响应：\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIs...\",\n \"token_type\": \"Bearer\"\n }\n}\n```\n\n### 仪表盘接口\n\n**获取统计数据**\n```\nGET /admin/dashboard\nAuthorization: Bearer \n```\n\n### 文件管理接口\n\n**获取文件列表**\n```\nGET /admin/file/list?page=1&size=10&keyword=\nAuthorization: Bearer \n```\n\n**删除文件**\n```\nDELETE /admin/file/delete\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"id\": 123\n}\n```\n\n**下载文件**\n```\nGET /admin/file/download?id=123\nAuthorization: Bearer \n```\n\n**修改文件信息**\n```\nPATCH /admin/file/update\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"id\": 123,\n \"code\": \"newcode\",\n \"expired_at\": \"2024-12-31T23:59:59\"\n}\n```\n\n### 本地文件接口\n\n**获取本地文件列表**\n```\nGET /admin/local/lists\nAuthorization: Bearer \n```\n\n**删除本地文件**\n```\nDELETE /admin/local/delete\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"filename\": \"example.txt\"\n}\n```\n\n**分享本地文件**\n```\nPOST /admin/local/share\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"filename\": \"example.txt\",\n \"expire_style\": \"day\",\n \"expire_value\": 7\n}\n```\n\n### 配置接口\n\n**获取配置**\n```\nGET /admin/config/get\nAuthorization: Bearer \n```\n\n**更新配置**\n```\nPATCH /admin/config/update\nAuthorization: Bearer \nContent-Type: application/json\n\n{\n \"admin_token\": \"new-password\",\n \"uploadSize\": 52428800\n}\n```\n\n## 常见问题\n\n### 忘记管理员密码\n\n如果忘记了管理员密码，可以通过以下方式重置：\n\n1. 停止 FileCodeBox 服务\n2. 使用 SQLite 工具打开 `data/filecodebox.db`\n3. 查询 `keyvalue` 表中 `key='settings'` 的记录\n4. 修改 JSON 中的 `admin_token` 值\n5. 重启服务\n\n```sql\n-- 查看当前配置\nSELECT * FROM keyvalue WHERE key = 'settings';\n\n-- 或者删除配置，恢复默认密码\nDELETE FROM keyvalue WHERE key = 'settings';\n```\n\n### 文件删除失败\n\n如果删除文件时出现错误，可能的原因：\n\n1. **存储后端连接失败**：检查存储配置是否正确\n2. **文件已不存在**：文件可能已被手动删除\n3. **权限不足**：检查存储目录的写入权限\n\n### 配置修改不生效\n\n如果修改配置后没有生效：\n\n1. 检查是否点击了保存按钮\n2. 刷新页面查看配置是否已保存\n3. 检查浏览器控制台是否有错误信息\n4. 确认配置值的格式是否正确（如数字类型不要输入字符串）\n\n## 下一步\n\n- [配置说明](/guide/configuration) - 了解所有配置选项的详细说明\n- [安全设置](/guide/security) - 了解如何增强系统安全性\n- [存储配置](/guide/storage) - 配置不同的存储后端\n" }, { "path": "docs/guide/security.md", "content": "# 安全设置\n\nFileCodeBox 提供了多层安全机制来保护您的文件分享服务。本文档介绍如何正确配置安全选项，确保系统安全运行。\n\n## 管理员密码\n\n### 修改默认密码\n\n::: danger 重要安全警告\nFileCodeBox 的默认管理员密码是 `FileCodeBox2023`。**在生产环境中必须立即修改此密码！**使用默认密码会导致任何人都可以访问您的管理面板。\n:::\n\n修改管理员密码有两种方式：\n\n**方式一：通过管理面板修改（推荐）**\n\n1. 访问 `/admin` 进入管理面板\n2. 使用当前密码登录\n3. 进入「系统设置」页面\n4. 找到 `admin_token` 配置项\n5. 输入新的安全密码并保存\n\n**方式二：通过数据库修改**\n\n配置存储在 `data/filecodebox.db` 数据库的 `keyvalue` 表中，可以直接修改 `admin_token` 的值。\n\n### 密码安全建议\n\n- 使用至少 16 个字符的强密码\n- 包含大小写字母、数字和特殊字符\n- 避免使用常见词汇或个人信息\n- 定期更换密码\n\n```python\n# 推荐的密码格式示例\n\"admin_token\": \"Xk9#mP2$vL5@nQ8&wR3\"\n```\n\n### 隐藏管理入口\n\n默认情况下，管理面板入口是隐藏的。您可以通过 `showAdminAddr` 配置控制是否在首页显示管理入口：\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `showAdminAddr` | int | `0` | 是否显示管理入口（1=显示，0=隐藏） |\n\n::: tip 建议\n在公开服务中，建议保持 `showAdminAddr` 为 `0`，通过直接访问 `/admin` 路径进入管理面板。\n:::\n\n## IP 速率限制\n\nFileCodeBox 内置了基于 IP 的速率限制机制，可以有效防止滥用和攻击。\n\n### 上传频率限制\n\n限制单个 IP 在指定时间内的上传次数：\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `uploadMinute` | int | `1` | 上传限制的时间窗口（分钟） |\n| `uploadCount` | int | `10` | 在时间窗口内允许的最大上传次数 |\n\n**工作原理：**\n- 系统记录每个 IP 的上传请求\n- 当某 IP 在 `uploadMinute` 分钟内的上传次数达到 `uploadCount` 时\n- 该 IP 的后续上传请求将被拒绝，返回 HTTP 423 错误\n- 等待时间窗口过期后，计数器重置\n\n**配置示例：**\n\n```python\n# 宽松配置：5分钟内最多上传20次\n{\n \"uploadMinute\": 5,\n \"uploadCount\": 20\n}\n\n# 严格配置：1分钟内最多上传3次\n{\n \"uploadMinute\": 1,\n \"uploadCount\": 3\n}\n```\n\n### 错误次数限制\n\n限制单个 IP 的错误尝试次数，防止暴力破解提取码：\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `errorMinute` | int | `1` | 错误限制的时间窗口（分钟） |\n| `errorCount` | int | `1` | 在时间窗口内允许的最大错误次数 |\n\n**工作原理：**\n- 当用户输入错误的提取码时，系统记录该 IP 的错误次数\n- 当错误次数达到 `errorCount` 时，该 IP 将被暂时锁定\n- 锁定时间为 `errorMinute` 分钟\n- 锁定期间，该 IP 的所有提取请求都将被拒绝\n\n**配置示例：**\n\n```python\n# 防暴力破解配置：5分钟内最多允许3次错误\n{\n \"errorMinute\": 5,\n \"errorCount\": 3\n}\n```\n\n::: warning 注意\n默认配置 `errorMinute=1, errorCount=1` 非常严格，意味着输入一次错误的提取码后需要等待1分钟才能重试。根据实际需求调整此配置。\n:::\n\n## 上传限制\n\n### 文件大小限制\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `uploadSize` | int | `10485760` | 单文件最大上传大小（字节），默认 10MB |\n| `openUpload` | int | `1` | 是否开启上传功能（1=开启，0=关闭） |\n\n**常用大小换算：**\n- 10MB = 10 * 1024 * 1024 = `10485760`\n- 50MB = 50 * 1024 * 1024 = `52428800`\n- 100MB = 100 * 1024 * 1024 = `104857600`\n- 1GB = 1024 * 1024 * 1024 = `1073741824`\n\n### 文件过期设置\n\n通过文件过期机制，可以自动清理过期文件，减少存储占用和安全风险：\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `expireStyle` | list | `[\"day\",\"hour\",\"minute\",\"forever\",\"count\"]` | 可选的过期方式 |\n| `max_save_seconds` | int | `0` | 文件最大保存时间（秒），0 表示不限制 |\n\n**过期方式说明：**\n- `day` - 按天数过期\n- `hour` - 按小时过期\n- `minute` - 按分钟过期\n- `forever` - 永不过期（需要字符串提取码）\n- `count` - 按下载次数过期\n\n**安全建议：**\n\n对于公开服务，建议：\n1. 移除 `forever` 选项，避免文件永久存储\n2. 设置 `max_save_seconds` 限制最长保存时间\n3. 优先使用 `count` 方式，下载后自动删除\n\n```python\n# 公开服务推荐配置\n{\n \"expireStyle\": [\"hour\", \"minute\", \"count\"],\n \"max_save_seconds\": 86400 # 最长保存1天\n}\n```\n\n### 关闭上传功能\n\n在某些情况下，您可能需要临时关闭上传功能：\n\n```python\n{\n \"openUpload\": 0 # 关闭上传功能\n}\n```\n\n## 反向代理安全配置\n\n在生产环境中，通常会使用 Nginx 或其他反向代理服务器。以下是安全配置建议：\n\n### Nginx 配置示例\n\n```nginx\nserver {\n listen 80;\n server_name your-domain.com;\n \n # 强制 HTTPS 重定向\n return 301 https://$server_name$request_uri;\n}\n\nserver {\n listen 443 ssl http2;\n server_name your-domain.com;\n \n # SSL 证书配置\n ssl_certificate /path/to/cert.pem;\n ssl_certificate_key /path/to/key.pem;\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;\n ssl_prefer_server_ciphers on;\n \n # 安全头部\n add_header X-Frame-Options \"SAMEORIGIN\" always;\n add_header X-Content-Type-Options \"nosniff\" always;\n add_header X-XSS-Protection \"1; mode=block\" always;\n add_header Strict-Transport-Security \"max-age=31536000; includeSubDomains\" always;\n \n # 限制请求体大小（与 uploadSize 配置一致）\n client_max_body_size 100M;\n \n # 传递真实 IP\n location / {\n proxy_pass http://127.0.0.1:12345;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n \n # 静态资源缓存\n location /assets {\n proxy_pass http://127.0.0.1:12345;\n proxy_cache_valid 200 7d;\n add_header Cache-Control \"public, max-age=604800\";\n }\n}\n```\n\n### 关键安全配置说明\n\n**1. 传递真实 IP**\n\nFileCodeBox 的 IP 限制功能依赖于获取客户端真实 IP。系统会按以下顺序获取 IP：\n1. `X-Real-IP` 请求头\n2. `X-Forwarded-For` 请求头\n3. 直接连接的客户端 IP\n\n确保反向代理正确设置这些头部：\n\n```nginx\nproxy_set_header X-Real-IP $remote_addr;\nproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n```\n\n**2. 请求体大小限制**\n\nNginx 的 `client_max_body_size` 应该与 FileCodeBox 的 `uploadSize` 配置一致或略大：\n\n```nginx\nclient_max_body_size 100M; # 允许上传最大 100MB\n```\n\n**3. HTTPS 加密**\n\n强烈建议在生产环境中启用 HTTPS：\n- 保护用户上传的文件内容\n- 保护管理员登录凭据\n- 防止中间人攻击\n\n### Caddy 配置示例\n\n```nginx\nyour-domain.com {\n reverse_proxy localhost:12345\n \n header {\n X-Frame-Options \"SAMEORIGIN\"\n X-Content-Type-Options \"nosniff\"\n X-XSS-Protection \"1; mode=block\"\n Strict-Transport-Security \"max-age=31536000; includeSubDomains\"\n }\n}\n```\n\n## 安全检查清单\n\n部署 FileCodeBox 前，请确认以下安全配置：\n\n- [ ] 已修改默认管理员密码 `admin_token`\n- [ ] 已隐藏管理入口 `showAdminAddr: 0`\n- [ ] 已配置合适的上传频率限制\n- [ ] 已配置错误次数限制防止暴力破解\n- [ ] 已设置合理的文件大小限制\n- [ ] 已配置文件过期策略\n- [ ] 已启用 HTTPS 加密\n- [ ] 反向代理已正确传递真实 IP\n- [ ] 已设置安全响应头部\n\n## 推荐安全配置\n\n### 公开服务配置\n\n```python\n{\n \"admin_token\": \"your-very-secure-password\",\n \"showAdminAddr\": 0,\n \"uploadSize\": 10485760, # 10MB\n \"uploadMinute\": 1,\n \"uploadCount\": 5,\n \"errorMinute\": 5,\n \"errorCount\": 3,\n \"expireStyle\": [\"hour\", \"minute\", \"count\"],\n \"max_save_seconds\": 86400, # 最长1天\n \"openUpload\": 1\n}\n```\n\n### 内部服务配置\n\n```python\n{\n \"admin_token\": \"internal-secure-password\",\n \"showAdminAddr\": 1,\n \"uploadSize\": 104857600, # 100MB\n \"uploadMinute\": 5,\n \"uploadCount\": 50,\n \"errorMinute\": 1,\n \"errorCount\": 5,\n \"expireStyle\": [\"day\", \"hour\", \"forever\"],\n \"max_save_seconds\": 0, # 不限制\n \"openUpload\": 1\n}\n```\n\n## 下一步\n\n- [配置说明](/guide/configuration) - 了解所有配置选项\n- [存储配置](/guide/storage) - 配置安全的存储后端\n- [文件分享](/guide/share) - 了解文件分享功能\n" }, { "path": "docs/guide/share.md", "content": "# 文件分享\n\nFileCodeBox 提供了简单易用的文件和文本分享功能。用户可以通过提取码安全地分享和获取文件。\n\n## 分享方式\n\nFileCodeBox 支持两种分享方式：\n\n1. **文本分享** - 直接分享文本内容，适合代码片段、配置文件等\n2. **文件分享** - 上传文件进行分享，支持各种文件格式\n\n## 文本分享\n\n### 使用方法\n\n1. 在首页选择「文本分享」标签\n2. 在文本框中输入或粘贴要分享的内容\n3. 选择过期方式和时间\n4. 点击「分享」按钮\n5. 获取提取码\n\n### 文本大小限制\n\n::: warning 注意\n文本分享的最大内容大小为 **222KB**（227,328 字节）。如果内容超过此限制，建议使用文件分享方式。\n:::\n\n文本内容大小按 UTF-8 编码计算，中文字符通常占用 3 个字节。\n\n### API 接口\n\n**POST** `/share/text/`\n\n请求参数：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `text` | string | 是 | 要分享的文本内容 |\n| `expire_value` | int | 否 | 过期数值，默认 1 |\n| `expire_style` | string | 否 | 过期方式，默认 `day` |\n\n响应示例：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"123456\"\n }\n}\n```\n\n## 文件分享\n\n### 使用方法\n\n1. 在首页选择「文件分享」标签\n2. 点击上传区域或拖拽文件到上传区域\n3. 选择过期方式和时间\n4. 点击「上传」按钮\n5. 获取提取码\n\n### 文件大小限制\n\n默认单文件最大上传大小为 **10MB**。管理员可以通过 `uploadSize` 配置项修改此限制。\n\n::: tip 提示\n如果需要上传大文件，请联系管理员启用分片上传功能，或调整 `uploadSize` 配置。\n:::\n\n### 支持的上传方式\n\n- **点击上传** - 点击上传区域选择文件\n- **拖拽上传** - 将文件拖拽到上传区域\n- **粘贴上传** - 从剪贴板粘贴图片（部分主题支持）\n\n### API 接口\n\n**POST** `/share/file/`\n\n请求参数（multipart/form-data）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `file` | file | 是 | 要上传的文件 |\n| `expire_value` | int | 否 | 过期数值，默认 1 |\n| `expire_style` | string | 否 | 过期方式，默认 `day` |\n\n响应示例：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"654321\",\n \"name\": \"example.pdf\"\n }\n}\n```\n\n## 过期设置\n\nFileCodeBox 支持多种灵活的过期方式：\n\n| 过期方式 | 参数值 | 说明 |\n|----------|--------|------|\n| 按天过期 | `day` | 文件在指定天数后过期 |\n| 按小时过期 | `hour` | 文件在指定小时后过期 |\n| 按分钟过期 | `minute` | 文件在指定分钟后过期 |\n| 永不过期 | `forever` | 文件永久有效 |\n| 按次数过期 | `count` | 文件在被下载指定次数后过期 |\n\n::: info 说明\n- 管理员可以通过 `expireStyle` 配置项控制用户可选的过期方式\n- 管理员可以通过 `max_save_seconds` 配置项限制文件的最长保存时间\n:::\n\n### 过期方式示例\n\n```bash\n# 文件 3 天后过期\nexpire_value=3, expire_style=day\n\n# 文件 12 小时后过期\nexpire_value=12, expire_style=hour\n\n# 文件 30 分钟后过期\nexpire_value=30, expire_style=minute\n\n# 文件永不过期\nexpire_value=1, expire_style=forever\n\n# 文件被下载 5 次后过期\nexpire_value=5, expire_style=count\n```\n\n## 提取文件\n\n### 使用方法\n\n1. 在首页的「提取文件」区域输入提取码\n2. 点击「提取」按钮\n3. 系统会显示文件信息（文件名、大小等）\n4. 点击「下载」按钮下载文件，或直接查看文本内容\n\n### 提取码说明\n\n- 提取码通常为 **6 位数字**\n- 永不过期的文件使用 **字母数字混合** 的提取码\n- 提取码区分大小写（针对字母数字混合的情况）\n\n### API 接口\n\n**查询文件信息**\n\n**POST** `/share/select/`\n\n请求参数：\n\n```json\n{\n \"code\": \"123456\"\n}\n```\n\n响应示例（文件）：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"123456\",\n \"name\": \"example.pdf\",\n \"size\": 1048576,\n \"text\": \"https://example.com/download/...\"\n }\n}\n```\n\n响应示例（文本）：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"123456\",\n \"name\": \"Text\",\n \"size\": 1024,\n \"text\": \"这是分享的文本内容...\"\n }\n}\n```\n\n**直接下载文件**\n\n**GET** `/share/select/?code=123456`\n\n此接口会直接返回文件内容，适合在浏览器中直接访问。\n\n## 分片上传（大文件）\n\n对于大文件上传，FileCodeBox 支持分片上传功能。此功能需要管理员启用（`enableChunk=1`）。\n\n### 分片上传流程\n\n```mermaid\nsequenceDiagram\n participant C as 客户端\n participant S as 服务器\n \n C->>S: 1. 初始化上传 (POST /chunk/upload/init/)\n S-->>C: 返回 upload_id 和分片信息\n \n loop 每个分片\n C->>S: 2. 上传分片 (POST /chunk/upload/chunk/{upload_id}/{chunk_index})\n S-->>C: 返回分片哈希\n end\n \n C->>S: 3. 完成上传 (POST /chunk/upload/complete/{upload_id})\n S-->>C: 返回提取码\n```\n\n### 1. 初始化上传\n\n**POST** `/chunk/upload/init/`\n\n请求参数：\n\n```json\n{\n \"file_name\": \"large_file.zip\",\n \"file_size\": 104857600,\n \"chunk_size\": 5242880,\n \"file_hash\": \"sha256_hash_of_file\"\n}\n```\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `file_name` | string | 是 | 文件名 |\n| `file_size` | int | 是 | 文件总大小（字节） |\n| `chunk_size` | int | 否 | 分片大小，默认 5MB |\n| `file_hash` | string | 是 | 文件的 SHA256 哈希值 |\n\n响应示例：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"existed\": false,\n \"upload_id\": \"abc123def456\",\n \"chunk_size\": 5242880,\n \"total_chunks\": 20,\n \"uploaded_chunks\": []\n }\n}\n```\n\n### 2. 上传分片\n\n**POST** `/chunk/upload/chunk/{upload_id}/{chunk_index}`\n\n- `upload_id` - 初始化时返回的上传会话 ID\n- `chunk_index` - 分片索引，从 0 开始\n\n请求体：分片文件数据（multipart/form-data）\n\n响应示例：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"chunk_hash\": \"sha256_hash_of_chunk\"\n }\n}\n```\n\n### 3. 完成上传\n\n**POST** `/chunk/upload/complete/{upload_id}`\n\n请求参数：\n\n```json\n{\n \"expire_value\": 1,\n \"expire_style\": \"day\"\n}\n```\n\n响应示例：\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"789012\",\n \"name\": \"large_file.zip\"\n }\n}\n```\n\n### 断点续传\n\n分片上传支持断点续传。如果上传中断，可以：\n\n1. 重新调用初始化接口，使用相同的 `file_hash`\n2. 服务器会返回已上传的分片列表 `uploaded_chunks`\n3. 客户端只需上传未完成的分片\n\n## 错误处理\n\n### 常见错误码\n\n| 错误码 | 说明 | 解决方案 |\n|--------|------|----------|\n| 403 | 文件大小超过限制 | 减小文件大小或联系管理员调整限制 |\n| 403 | 内容过多 | 文本超过 222KB，请使用文件分享 |\n| 403 | 上传频率限制 | 等待一段时间后重试 |\n| 404 | 文件不存在 | 检查提取码是否正确 |\n| 404 | 文件已过期 | 文件已过期或下载次数已用完 |\n\n### 频率限制\n\n为防止滥用，系统对上传和提取操作有频率限制：\n\n- **上传限制**：默认每分钟最多 10 次上传\n- **错误限制**：默认每分钟最多 1 次错误尝试\n\n::: tip 提示\n如果遇到频率限制，请等待限制时间窗口过后再重试。\n:::\n\n## 下一步\n\n- [配置说明](/guide/configuration) - 了解如何配置分享相关设置\n- [存储配置](/guide/storage) - 了解文件存储方式\n- [安全设置](/guide/security) - 了解安全相关配置\n- [管理面板](/guide/management) - 了解如何管理分享的文件\n" }, { "path": "docs/guide/storage-onedrive.md", "content": "# OneDrive作为存储的配置方法\n\n**仅支持工作或学校账户，并且需要有管理员权限以授权API**\n\n## 1. 需要配置的参数\n\n```\nfile_storage=onedrive\nonedrive_domain=XXXXXX\nonedrive_client_id=XXXXXX-XXXXXX-XXXXXX-XXXXXX\nonedrive_username=XXXXXX@XXXXXX\nonedrive_password=XXXXXX\n```\n\n`onedrive_username`和`onedrive_password`是你的账户名（邮箱）和密码，另外两个参数需要在[微软Azure门户](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)中注册应用后获取。\n\n## 2. 应用注册\n\n1. 登录[https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)，鼠标置于右上角账号处，浮窗将显示的`域`即为`onedrive_domain`的值。\n![onedrive_domain](https://api.onedrive.com/v1.0/shares/s!Au-BDzXcM6_VmGCiErO85doq9Tcu/root/content)\n\n2. 点击左上角的`+新注册`，输入名称，\n * 受支持的帐户类型：选择任何组织目录(任何 Azure AD 目录 - 多租户)中的帐户和个人 Microsoft 帐户(例如，Skype、Xbox)\n * 重定向 URI (可选)：选择`Web`，并输入`http://localhost`\n\n3. 完成注册后进入概述页面，在概要中找到`应用程序(客户端)ID`，即为`onedrive_client_id`的值。\n![onedrive_client_id](https://api.onedrive.com/v1.0/shares/s!Au-BDzXcM6_VmGHD4CNyJxm_QBb8/root/content)\n\n4. 此时还需要配置允许公共客户端流和API权限\n * 在左侧选择`身份验证`，找到`允许的客户端流`，选择`是`，并**点击`保存`**。\n ![允许的客户端流](https://api.onedrive.com/v1.0/shares/s!Au-BDzXcM6_VmGJQMOlOCb2-L0Lh/root/content)\n * 在左侧选择`API权限`，点击`+添加权限`，选择`Microsoft Graph`->`委托的权限`，并勾选下述权限：openid、Files中所有权限、User.Read，如下图所示。最后**点击下方的`添加权限`**。\n ![添加权限](https://api.onedrive.com/v1.0/shares/s!Au-BDzXcM6_VmGOZzz7sIrdXkD4w/root/content)\n * 最后点击`授予管理员同意`，并**点击`是`**，最终状态变为`已授予`。\n ![授予管理员同意](https://api.onedrive.com/v1.0/shares/s!Au-BDzXcM6_VmGSOAnjnHUlbirbU/root/content)\n\n## 3. 使用下述代码测试是否配置成功\n\n安装依赖：`pip install Office365-REST-Python-Client`\n\n```python\n# common.py\nimport msal\ndomain = 'XXXXXX'\nclient_id = 'XXXXXX'\nusername = 'XXXXXX'\npassword = 'XXXXXX'\n\ndef acquire_token_pwd():\n authority_url = f'https://login.microsoftonline.com/{domain}'\n app = msal.PublicClientApplication(\n authority=authority_url,\n client_id=client_id\n )\n result = app.acquire_token_by_username_password(\n username=username,\n password=password,\n scopes=['https://graph.microsoft.com/.default']\n )\n return result\n```\n\n测试登录，如果成功打印出账户名，说明配置成功。\n\n```python\nfrom common import acquire_token_pwd\n\nfrom office365.graph_client import GraphClient\ntry:\n client = GraphClient(acquire_token_pwd)\n me = client.me.get().execute_query()\n print(me.user_principal_name)\nexcept Exception as e:\n print(e)\n```\n\n测试文件上传\n\n```python\nimport os\nfrom office365.graph_client import GraphClient\nfrom common import acquire_token_pwd\n\nremote_path = 'tmp'\nlocal_path = '.tmp/1689843925000.png'\n\ndef convert_link_to_download_link(link):\n import re\n p1 = re.search(r'https:\\/\\/(.+)\\.sharepoint\\.com', link).group(1)\n p2 = re.search(r'personal\\/(.+)\\/', link).group(1)\n p3 = re.search(rf'{p2}\\/(.+)', link).group(1)\n return f'https://{p1}.sharepoint.com/personal/{p2}/_layouts/52/download.aspx?share={p3}'\n\nclient = GraphClient(acquire_token_pwd)\nfolder = client.me.drive.root.get_by_path(remote_path)\n# 1. upload\nfile = folder.upload_file(local_path).execute_query()\nprint(f'File {file.web_url} has been uploaded')\n# 2. create sharing link\nremote_file = folder.get_by_path(os.path.basename(local_path))\npermission = remote_file.create_link(\"view\", \"anonymous\").execute_query()\nprint(f\"sharing link: {convert_link_to_download_link(permission.link.webUrl)}\")\n```\n\n测试文件下载\n\n```python\nimport os\nfrom office365.graph_client import GraphClient\nfrom common import acquire_token_pwd\n\nremote_path = 'tmp/1689843925000.png'\nlocal_path = '.tmp'\nif not os.path.exists(local_path):\n os.makedirs(local_path)\n\nclient = GraphClient(acquire_token_pwd)\nremote_file = client.me.drive.root.get_by_path(remote_path).get().execute_query()\nwith open(os.path.join(local_path, os.path.basename(remote_path)), 'wb') as local_file:\n remote_file.download(local_file).execute_query()\n print(f'{remote_file.name} has been downloaded into {local_file.name}')\n```\n\n测试删除文件\n\n```python\nfrom office365.graph_client import GraphClient\nfrom common import acquire_token_pwd\n\nremote_path = 'tmp/1689843925000.png'\n\nclient = GraphClient(acquire_token_pwd)\nfile = client.me.drive.root.get_by_path(remote_path)\nfile.delete_object().execute_query()\n```\n" }, { "path": "docs/guide/storage-opendal.md", "content": "# 通过 OpenDAL 集成存储的配置方法\n\n## 需要配置的参数\n\n```dotenv\nfile_storage=opendal\nopendal_scheme=\nopendal__=...\n```\n\n以 Gcs 为例，需要配置的参数如下：\n```dotenv\nfile_storage=opendal\nopendal_scheme=gcs\nopendal_gcs_root=\nopendal_gcs_bucket=\nopendal_gcs_credential=\n```\n\n所有支持的服务可以在[此处](https://opendal.apache.org/docs/rust/opendal/services/index.html)查看。\n具体服务的配置参数与 OpenDAL 文档一致。\n\n## 补充说明\n\n通过 OpenDAL 集成的服务均通过服务器中转下载。因此，每次下载既消耗存储服务的流量，也消耗服务器的流量。\n\nOpenDAL 和该项目本身都支持本地存储、`s3`、`onedrive`。不同之处有以下几点:\n1. 项目的支持通过预签名实现，不消耗服务器流量。而 OpenDAL 通过服务器中转下载，消耗服务器流量。（本地存储除外）\n2. 项目的支持对于异常情况可能会有更多的调试信息，方便排查问题。\n3. OpenDAL 项目本身采用 Rust 编写，性能更好。" }, { "path": "docs/guide/storage.md", "content": "# 存储配置\n\nFileCodeBox 支持多种存储后端，您可以根据需求选择合适的存储方式。本文档将详细介绍各种存储后端的配置方法。\n\n## 存储类型概览\n\n| 存储类型 | 配置值 | 说明 |\n|---------|--------|------|\n| 本地存储 | `local` | 默认存储方式，文件保存在服务器本地 |\n| S3 兼容存储 | `s3` | 支持 AWS S3、阿里云 OSS、MinIO 等 |\n| OneDrive | `onedrive` | 微软 OneDrive 云存储（仅支持工作/学校账户） |\n| WebDAV | `webdav` | 支持 WebDAV 协议的存储服务 |\n| OpenDAL | `opendal` | 通过 OpenDAL 集成更多存储服务 |\n\n## 本地存储\n\n本地存储是默认的存储方式，文件将保存在服务器的 `data/` 目录下。\n\n### 配置参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `file_storage` | string | `local` | 存储类型 |\n| `storage_path` | string | `\"\"` | 自定义存储路径（可选） |\n\n### 配置示例\n\n```bash\nfile_storage=local\nstorage_path=\n```\n\n### 说明\n\n- 文件默认存储在 `data/share/data/` 目录下\n- 按日期自动创建子目录：`年/月/日/文件ID/`\n- 建议在生产环境中将 `data/` 目录挂载到持久化存储\n\n## S3 兼容存储\n\n支持所有 S3 兼容的对象存储服务，包括 AWS S3、阿里云 OSS、MinIO、腾讯云 COS 等。\n\n### 配置参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `file_storage` | string | - | 设置为 `s3` |\n| `s3_access_key_id` | string | `\"\"` | Access Key ID |\n| `s3_secret_access_key` | string | `\"\"` | Secret Access Key |\n| `s3_bucket_name` | string | `\"\"` | 存储桶名称 |\n| `s3_endpoint_url` | string | `\"\"` | S3 端点 URL |\n| `s3_region_name` | string | `auto` | 区域名称 |\n| `s3_signature_version` | string | `s3v2` | 签名版本（`s3v2` 或 `s3v4`） |\n| `s3_hostname` | string | `\"\"` | S3 主机名（备用） |\n| `s3_proxy` | int | `0` | 是否通过服务器代理下载（1=是，0=否） |\n| `aws_session_token` | string | `\"\"` | AWS 会话令牌（可选） |\n\n### AWS S3 配置示例\n\n```bash\nfile_storage=s3\ns3_access_key_id=AKIAIOSFODNN7EXAMPLE\ns3_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\ns3_bucket_name=my-filecodebox-bucket\ns3_endpoint_url=https://s3.amazonaws.com\ns3_region_name=us-east-1\ns3_signature_version=s3v4\n```\n\n### 阿里云 OSS 配置示例\n\n```bash\nfile_storage=s3\ns3_access_key_id=您的AccessKeyId\ns3_secret_access_key=您的SecretAccessKey\ns3_bucket_name=bucket-name\ns3_endpoint_url=https://bucket-name.oss-cn-hangzhou.aliyuncs.com\ns3_region_name=oss-cn-hangzhou\ns3_signature_version=s3v4\n```\n\n::: tip 阿里云 OSS 端点格式\n端点 URL 格式为：`https://..aliyuncs.com`\n\n常用区域：\n- 杭州：`oss-cn-hangzhou`\n- 上海：`oss-cn-shanghai`\n- 北京：`oss-cn-beijing`\n- 深圳：`oss-cn-shenzhen`\n:::\n\n### MinIO 配置示例\n\n```bash\nfile_storage=s3\ns3_access_key_id=minioadmin\ns3_secret_access_key=minioadmin\ns3_bucket_name=filecodebox\ns3_endpoint_url=http://localhost:9000\ns3_region_name=us-east-1\ns3_signature_version=s3v4\n```\n\n::: warning MinIO 注意事项\n- `s3_endpoint_url` 填写 MinIO 的 API 接口地址\n- `s3_region_name` 根据 MinIO 配置中的 `Server Location` 设置\n- 确保存储桶已创建且有正确的访问权限\n:::\n\n### 腾讯云 COS 配置示例\n\n```bash\nfile_storage=s3\ns3_access_key_id=您的SecretId\ns3_secret_access_key=您的SecretKey\ns3_bucket_name=bucket-name-1250000000\ns3_endpoint_url=https://cos.ap-guangzhou.myqcloud.com\ns3_region_name=ap-guangzhou\ns3_signature_version=s3v4\n```\n\n### 代理下载\n\n当 `s3_proxy=1` 时，文件下载将通过服务器中转，而不是直接从 S3 下载。这在以下情况下有用：\n\n- S3 存储桶不允许公开访问\n- 需要隐藏实际的存储地址\n- 网络环境限制直接访问 S3\n\n\n\n## OneDrive 存储\n\nOneDrive 存储支持将文件保存到微软 OneDrive 云存储。\n\n::: warning 重要限制\nOneDrive 存储**仅支持工作或学校账户**，并且需要有管理员权限以授权 API。个人账户无法使用此功能。\n:::\n\n### 配置参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `file_storage` | string | - | 设置为 `onedrive` |\n| `onedrive_domain` | string | `\"\"` | Azure AD 域名 |\n| `onedrive_client_id` | string | `\"\"` | 应用程序（客户端）ID |\n| `onedrive_username` | string | `\"\"` | 账户邮箱 |\n| `onedrive_password` | string | `\"\"` | 账户密码 |\n| `onedrive_root_path` | string | `filebox_storage` | OneDrive 中的存储根目录 |\n| `onedrive_proxy` | int | `0` | 是否通过服务器代理下载 |\n\n### 配置示例\n\n```bash\nfile_storage=onedrive\nonedrive_domain=contoso.onmicrosoft.com\nonedrive_client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\nonedrive_username=user@contoso.onmicrosoft.com\nonedrive_password=your_password\nonedrive_root_path=filebox_storage\n```\n\n### Azure 应用注册步骤\n\n要使用 OneDrive 存储，您需要在 Azure 门户中注册应用程序：\n\n#### 1. 获取域名\n\n登录 [Azure 门户](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)，将鼠标置于右上角账号处，浮窗显示的**域**即为 `onedrive_domain` 的值。\n\n#### 2. 注册应用\n\n1. 点击左上角的 **+ 新注册**\n2. 输入应用名称（如：FileCodeBox）\n3. **受支持的帐户类型**：选择\"任何组织目录(任何 Azure AD 目录 - 多租户)中的帐户和个人 Microsoft 帐户\"\n4. **重定向 URI**：选择 `Web`，输入 `http://localhost`\n5. 点击**注册**\n\n#### 3. 获取客户端 ID\n\n注册完成后，在应用概述页面的**概要**中找到**应用程序(客户端)ID**，即为 `onedrive_client_id` 的值。\n\n#### 4. 配置身份验证\n\n1. 在左侧菜单选择**身份验证**\n2. 找到**允许公共客户端流**，选择**是**\n3. 点击**保存**\n\n#### 5. 配置 API 权限\n\n1. 在左侧菜单选择 **API 权限**\n2. 点击 **+ 添加权限**\n3. 选择 **Microsoft Graph** → **委托的权限**\n4. 勾选以下权限：\n - `openid`\n - `Files.Read`\n - `Files.Read.All`\n - `Files.ReadWrite`\n - `Files.ReadWrite.All`\n - `User.Read`\n5. 点击**添加权限**\n6. 点击**代表 xxx 授予管理员同意**\n7. 确认后，权限状态应显示为**已授予**\n\n### 安装依赖\n\n使用 OneDrive 存储需要安装额外的 Python 依赖：\n\n```bash\npip install msal Office365-REST-Python-Client\n```\n\n### 验证配置\n\n您可以使用以下代码测试配置是否正确：\n\n```python\nimport msal\nfrom office365.graph_client import GraphClient\n\ndomain = 'your_domain'\nclient_id = 'your_client_id'\nusername = 'your_username'\npassword = 'your_password'\n\ndef acquire_token_pwd():\n authority_url = f'https://login.microsoftonline.com/{domain}'\n app = msal.PublicClientApplication(\n authority=authority_url,\n client_id=client_id\n )\n result = app.acquire_token_by_username_password(\n username=username,\n password=password,\n scopes=['https://graph.microsoft.com/.default']\n )\n return result\n\n# 测试连接\nclient = GraphClient(acquire_token_pwd)\nme = client.me.get().execute_query()\nprint(f\"登录成功：{me.user_principal_name}\")\n```\n\n## WebDAV 存储\n\nWebDAV 存储支持将文件保存到任何支持 WebDAV 协议的服务，如 Nextcloud、ownCloud、坚果云等。\n\n### 配置参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `file_storage` | string | - | 设置为 `webdav` |\n| `webdav_url` | string | `\"\"` | WebDAV 服务器 URL |\n| `webdav_username` | string | `\"\"` | WebDAV 用户名 |\n| `webdav_password` | string | `\"\"` | WebDAV 密码 |\n| `webdav_root_path` | string | `filebox_storage` | WebDAV 中的存储根目录 |\n| `webdav_proxy` | int | `0` | 是否通过服务器代理下载 |\n\n### 配置示例\n\n```bash\nfile_storage=webdav\nwebdav_url=https://dav.example.com/remote.php/dav/files/username/\nwebdav_username=your_username\nwebdav_password=your_password\nwebdav_root_path=filebox_storage\n```\n\n### Nextcloud 配置示例\n\n```bash\nfile_storage=webdav\nwebdav_url=https://your-nextcloud.com/remote.php/dav/files/username/\nwebdav_username=your_username\nwebdav_password=your_app_password\nwebdav_root_path=FileCodeBox\n```\n\n::: tip Nextcloud 应用密码\n建议在 Nextcloud 中创建应用密码，而不是使用主密码：\n1. 登录 Nextcloud\n2. 进入**设置** → **安全**\n3. 在**设备与会话**中创建新的应用密码\n:::\n\n### 坚果云配置示例\n\n```bash\nfile_storage=webdav\nwebdav_url=https://dav.jianguoyun.com/dav/\nwebdav_username=your_email@example.com\nwebdav_password=your_app_password\nwebdav_root_path=FileCodeBox\n```\n\n::: tip 坚果云应用密码\n坚果云需要使用应用密码：\n1. 登录坚果云网页版\n2. 进入**账户信息** → **安全选项**\n3. 添加应用密码\n:::\n\n## OpenDAL 存储\n\nOpenDAL 是一个统一的数据访问层，支持多种存储服务。通过 OpenDAL，您可以使用 Google Cloud Storage、Azure Blob Storage 等更多存储服务。\n\n### 配置参数\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `file_storage` | string | 设置为 `opendal` |\n| `opendal_scheme` | string | 存储服务类型（如 `gcs`、`azblob`） |\n| `opendal__` | string | 服务特定的配置参数 |\n\n### 安装依赖\n\n```bash\npip install opendal\n```\n\n### Google Cloud Storage 配置示例\n\n```bash\nfile_storage=opendal\nopendal_scheme=gcs\nopendal_gcs_root=/filecodebox\nopendal_gcs_bucket=your-bucket-name\nopendal_gcs_credential=base64_encoded_credential\n```\n\n### Azure Blob Storage 配置示例\n\n```bash\nfile_storage=opendal\nopendal_scheme=azblob\nopendal_azblob_root=/filecodebox\nopendal_azblob_container=your-container\nopendal_azblob_account_name=your_account\nopendal_azblob_account_key=your_key\n```\n\n### 支持的服务\n\nOpenDAL 支持众多存储服务，完整列表请参考 [OpenDAL 官方文档](https://opendal.apache.org/docs/rust/opendal/services/index.html)。\n\n常用服务包括：\n- `gcs` - Google Cloud Storage\n- `azblob` - Azure Blob Storage\n- `obs` - 华为云 OBS\n- `oss` - 阿里云 OSS（通过 OpenDAL）\n- `cos` - 腾讯云 COS（通过 OpenDAL）\n- `hdfs` - Hadoop HDFS\n- `ftp` - FTP 服务器\n- `sftp` - SFTP 服务器\n\n::: warning OpenDAL 注意事项\n1. 通过 OpenDAL 集成的服务均通过服务器中转下载，会同时消耗存储服务和服务器的流量\n2. 相比原生 S3/OneDrive 支持，OpenDAL 方式可能缺少一些调试信息\n3. OpenDAL 采用 Rust 编写，性能较好\n:::\n\n## 存储选择建议\n\n| 场景 | 推荐存储 | 原因 |\n|------|----------|------|\n| 个人/小型部署 | 本地存储 | 简单易用，无需额外配置 |\n| 企业内网 | MinIO + S3 | 自建对象存储，数据可控 |\n| 公有云部署 | 对应云厂商 S3 | 同区域访问快，成本低 |\n| 已有 OneDrive | OneDrive | 利用现有资源 |\n| 已有 WebDAV | WebDAV | 兼容性好 |\n| 特殊存储需求 | OpenDAL | 支持更多存储服务 |\n\n## 常见问题\n\n### S3 上传失败\n\n1. 检查 Access Key 和 Secret Key 是否正确\n2. 确认存储桶名称和区域配置正确\n3. 检查存储桶的访问权限设置\n4. 确认签名版本（`s3v2` 或 `s3v4`）与服务商要求一致\n\n### OneDrive 认证失败\n\n1. 确认使用的是工作/学校账户，而非个人账户\n2. 检查 Azure 应用是否已授予管理员同意\n3. 确认 API 权限配置完整\n4. 验证用户名和密码是否正确\n\n### WebDAV 连接失败\n\n1. 检查 WebDAV URL 格式是否正确\n2. 确认用户名和密码（或应用密码）正确\n3. 检查服务器是否支持 WebDAV 协议\n4. 确认网络连接正常\n" }, { "path": "docs/guide/upload.md", "content": "# 文件上传\n\nFileCodeBox 提供了多种灵活的文件上传方式，支持普通上传和分片上传，满足不同场景的需求。\n\n## 上传方式\n\nFileCodeBox 支持以下几种上传方式：\n\n### 拖拽上传\n\n将文件直接拖拽到上传区域即可开始上传。这是最便捷的上传方式。\n\n1. 打开 FileCodeBox 首页\n2. 将文件从文件管理器拖拽到上传区域\n3. 松开鼠标，文件开始上传\n4. 上传完成后获取提取码\n\n::: tip 提示\n拖拽上传支持同时拖拽多个文件（取决于主题支持）。\n:::\n\n### 点击上传\n\n点击上传区域，通过系统文件选择器选择文件。\n\n1. 点击上传区域的「选择文件」按钮\n2. 在弹出的文件选择器中选择要上传的文件\n3. 确认选择后文件开始上传\n4. 上传完成后获取提取码\n\n### 粘贴上传\n\n支持从剪贴板直接粘贴图片进行上传（部分主题支持）。\n\n1. 复制图片到剪贴板（截图或复制图片）\n2. 在上传区域使用 `Ctrl+V`（Windows/Linux）或 `Cmd+V`（macOS）粘贴\n3. 图片自动开始上传\n4. 上传完成后获取提取码\n\n::: warning 注意\n粘贴上传仅支持图片格式，不支持其他文件类型。具体支持情况取决于所使用的主题。\n:::\n\n## 文件大小限制\n\n### 默认限制\n\n| 配置项 | 默认值 | 说明 |\n|--------|--------|------|\n| `uploadSize` | 10MB | 单文件最大上传大小 |\n\n### 修改上传限制\n\n管理员可以通过管理面板或配置文件修改上传大小限制：\n\n```python\n# 设置最大上传大小为 100MB\nuploadSize = 104857600 # 100 * 1024 * 1024\n```\n\n::: info 说明\n`uploadSize` 的单位是字节。常用换算：\n- 10MB = 10485760\n- 50MB = 52428800\n- 100MB = 104857600\n- 500MB = 524288000\n- 1GB = 1073741824\n:::\n\n### 超出限制的处理\n\n当上传文件超过大小限制时，系统会返回 403 错误：\n\n```json\n{\n \"detail\": \"大小超过限制,最大为10.00 MB\"\n}\n```\n\n## 普通上传 API\n\n### 文件上传接口\n\n**POST** `/share/file/`\n\nContent-Type: `multipart/form-data`\n\n**请求参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `file` | file | 是 | 要上传的文件 |\n| `expire_value` | int | 否 | 过期数值，默认 1 |\n| `expire_style` | string | 否 | 过期方式，默认 `day` |\n\n**过期方式选项：**\n\n| 值 | 说明 |\n|----|------|\n| `day` | 按天过期 |\n| `hour` | 按小时过期 |\n| `minute` | 按分钟过期 |\n| `forever` | 永不过期 |\n| `count` | 按下载次数过期 |\n\n**响应示例：**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"654321\",\n \"name\": \"example.pdf\"\n }\n}\n```\n\n**cURL 示例：**\n\n```bash\n# 上传文件（默认1天有效期）\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.pdf\"\n\n# 上传文件并指定有效期（7天）\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.pdf\" \\\n -F \"expire_value=7\" \\\n -F \"expire_style=day\"\n\n# 上传文件并指定有效期（可下载10次）\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.pdf\" \\\n -F \"expire_value=10\" \\\n -F \"expire_style=count\"\n\n# 分享文本\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -F \"text=这是要分享的文本内容\"\n\n# 通过取件码下载文件\ncurl -L \"http://localhost:12345/share/select/?code=取件码\" -o downloaded_file\n```\n\n::: tip 需要认证时\n如果管理面板关闭了游客上传（`openUpload=0`），需要先登录获取 token：\n\n```bash\n# 1. 登录获取 token\ncurl -X POST \"http://localhost:12345/admin/login\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"password\": \"FileCodeBox2023\"}'\n\n# 返回: {\"code\":200,\"msg\":\"success\",\"detail\":{\"token\":\"xxx.xxx.xxx\",\"token_type\":\"Bearer\"}}\n\n# 2. 使用 token 上传文件\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -H \"Authorization: Bearer xxx.xxx.xxx\" \\\n -F \"file=@/path/to/file.pdf\"\n\n# 3. 使用 token 分享文本\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -H \"Authorization: Bearer xxx.xxx.xxx\" \\\n -F \"text=这是要分享的文本内容\"\n```\n:::\n\n## 分片上传 API\n\n对于大文件，FileCodeBox 支持分片上传功能。分片上传将大文件分割成多个小块分别上传，支持断点续传。\n\n::: warning 前提条件\n分片上传功能需要管理员启用：`enableChunk=1`\n:::\n\n### 分片上传流程\n\n```\n┌─────────────┐ ┌─────────────┐ ┌─────────────┐\n│ 初始化上传 │ ──▶ │ 上传分片 │ ──▶ │ 完成上传 │\n│ /init/ │ │ /chunk/ │ │ /complete/ │\n└─────────────┘ └─────────────┘ └─────────────┘\n │\n ▼\n ┌───────────┐\n │ 循环上传 │\n │ 每个分片 │\n └───────────┘\n```\n\n### 1. 初始化上传\n\n**POST** `/chunk/upload/init/`\n\n**请求参数：**\n\n```json\n{\n \"file_name\": \"large_file.zip\",\n \"file_size\": 104857600,\n \"chunk_size\": 5242880,\n \"file_hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\"\n}\n```\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `file_name` | string | 是 | - | 文件名 |\n| `file_size` | int | 是 | - | 文件总大小（字节） |\n| `chunk_size` | int | 否 | 5MB | 分片大小（字节） |\n| `file_hash` | string | 是 | - | 文件的 SHA256 哈希值 |\n\n**响应示例：**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"existed\": false,\n \"upload_id\": \"abc123def456789\",\n \"chunk_size\": 5242880,\n \"total_chunks\": 20,\n \"uploaded_chunks\": []\n }\n}\n```\n\n| 字段 | 说明 |\n|------|------|\n| `existed` | 文件是否已存在（秒传） |\n| `upload_id` | 上传会话 ID |\n| `chunk_size` | 分片大小 |\n| `total_chunks` | 总分片数 |\n| `uploaded_chunks` | 已上传的分片索引列表 |\n\n### 2. 上传分片\n\n**POST** `/chunk/upload/chunk/{upload_id}/{chunk_index}`\n\n**路径参数：**\n\n| 参数 | 说明 |\n|------|------|\n| `upload_id` | 初始化时返回的上传会话 ID |\n| `chunk_index` | 分片索引，从 0 开始 |\n\n**请求体：**\n\nContent-Type: `multipart/form-data`\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `chunk` | file | 分片数据 |\n\n**响应示例：**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"chunk_hash\": \"a1b2c3d4e5f6...\"\n }\n}\n```\n\n**cURL 示例：**\n\n```bash\n# 上传第一个分片（索引为 0）\ncurl -X POST \"http://localhost:12345/chunk/upload/chunk/abc123def456789/0\" \\\n -F \"chunk=@/path/to/chunk_0\"\n```\n\n### 3. 完成上传\n\n**POST** `/chunk/upload/complete/{upload_id}`\n\n**路径参数：**\n\n| 参数 | 说明 |\n|------|------|\n| `upload_id` | 上传会话 ID |\n\n**请求参数：**\n\n```json\n{\n \"expire_value\": 7,\n \"expire_style\": \"day\"\n}\n```\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `expire_value` | int | 是 | 过期数值 |\n| `expire_style` | string | 是 | 过期方式 |\n\n**响应示例：**\n\n```json\n{\n \"code\": 200,\n \"detail\": {\n \"code\": \"789012\",\n \"name\": \"large_file.zip\"\n }\n}\n```\n\n### 断点续传\n\n分片上传支持断点续传。当上传中断后：\n\n1. 使用相同的 `file_hash` 重新调用初始化接口\n2. 服务器返回 `uploaded_chunks` 列表，包含已上传的分片索引\n3. 客户端只需上传不在列表中的分片\n4. 所有分片上传完成后调用完成接口\n\n**示例流程：**\n\n```javascript\n// 1. 初始化上传\nconst initResponse = await fetch('/chunk/upload/init/', {\n method: 'POST',\n body: JSON.stringify({\n file_name: 'large_file.zip',\n file_size: fileSize,\n chunk_size: 5 * 1024 * 1024,\n file_hash: fileHash\n })\n});\nconst { upload_id, uploaded_chunks, total_chunks } = await initResponse.json();\n\n// 2. 上传未完成的分片\nfor (let i = 0; i < total_chunks; i++) {\n if (!uploaded_chunks.includes(i)) {\n const chunk = file.slice(i * chunkSize, (i + 1) * chunkSize);\n await fetch(`/chunk/upload/chunk/${upload_id}/${i}`, {\n method: 'POST',\n body: chunk\n });\n }\n}\n\n// 3. 完成上传\nawait fetch(`/chunk/upload/complete/${upload_id}`, {\n method: 'POST',\n body: JSON.stringify({\n expire_value: 7,\n expire_style: 'day'\n })\n});\n```\n\n## 错误处理\n\n### 常见错误\n\n| HTTP 状态码 | 错误信息 | 原因 | 解决方案 |\n|-------------|----------|------|----------|\n| 403 | 大小超过限制 | 文件超过 `uploadSize` 限制 | 减小文件大小或联系管理员调整限制 |\n| 403 | 上传频率限制 | 超过 IP 上传频率限制 | 等待限制时间窗口后重试 |\n| 400 | 过期时间类型错误 | `expire_style` 值不在允许列表中 | 使用有效的过期方式 |\n| 404 | 上传会话不存在 | `upload_id` 无效或已过期 | 重新初始化上传 |\n| 400 | 无效的分片索引 | `chunk_index` 超出范围 | 检查分片索引是否正确 |\n| 400 | 分片不完整 | 完成上传时分片数量不足 | 确保所有分片都已上传 |\n\n### 频率限制\n\n系统对上传操作有频率限制，防止滥用：\n\n| 配置项 | 默认值 | 说明 |\n|--------|--------|------|\n| `uploadMinute` | 1 | 限制时间窗口（分钟） |\n| `uploadCount` | 10 | 时间窗口内最大上传次数 |\n\n当超过频率限制时，需要等待时间窗口过后才能继续上传。\n\n### 错误响应格式\n\n```json\n{\n \"detail\": \"错误信息描述\"\n}\n```\n\n## 上传配置\n\n### 相关配置项\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `openUpload` | int | 1 | 是否开放上传（1=开放，0=关闭） |\n| `uploadSize` | int | 10485760 | 最大上传大小（字节） |\n| `enableChunk` | int | 0 | 是否启用分片上传（1=启用，0=禁用） |\n| `uploadMinute` | int | 1 | 上传频率限制时间窗口（分钟） |\n| `uploadCount` | int | 10 | 时间窗口内最大上传次数 |\n| `expireStyle` | list | [\"day\",\"hour\",\"minute\",\"forever\",\"count\"] | 允许的过期方式 |\n\n### 配置示例\n\n```python\n# 允许上传 100MB 文件，启用分片上传\nuploadSize = 104857600\nenableChunk = 1\n\n# 放宽上传频率限制：每 5 分钟最多 50 次\nuploadMinute = 5\nuploadCount = 50\n\n# 只允许按天和按次数过期\nexpireStyle = [\"day\", \"count\"]\n```\n\n## 下一步\n\n- [文件分享](/guide/share) - 了解完整的分享流程\n- [配置说明](/guide/configuration) - 了解所有配置选项\n- [存储配置](/guide/storage) - 了解文件存储方式\n- [安全设置](/guide/security) - 了解安全相关配置\n" }, { "path": "docs/index.md", "content": "---\nlayout: home\n\nhero:\n name: \"FileCodeBox\"\n text: \"文件快递柜\"\n tagline: 匿名口令分享文本，文件，像拿快递一样取文件\n image:\n src: /logo_small.png\n alt: FileCodeBox\n actions:\n - theme: brand\n text: 快速开始\n link: /guide/getting-started\n - theme: alt\n text: 在线体验\n link: https://share.lanol.cn\n - theme: alt\n text: 在 GitHub 上查看\n link: https://github.com/vastsa/FileCodeBox\n\nfeatures:\n - icon: 🚀\n title: 快速部署\n details: 支持 Docker 一键部署，简单快捷，无需复杂配置\n - icon: 🔒\n title: 安全可靠\n details: 文件访问需要提取码，支持设置有效期和下载次数限制\n - icon: 💻\n title: 简洁界面\n details: 清爽的用户界面，支持拖拽上传，使用体验极佳\n - icon: 🛠️\n title: 功能丰富\n details: 支持文件预览、在线播放、图片处理等多种功能\n - icon: 📦\n title: 存储扩展\n details: 支持本地存储、对象存储等多种存储方式\n - icon: 🔌\n title: API 支持\n details: 提供完整的 REST API，方便与其他系统集成\n---\n\n" }, { "path": "docs/package.json", "content": "{\n \"devDependencies\": {\n \"vitepress\": \"^1.6.3\"\n },\n \"scripts\": {\n \"docs:dev\": \"vitepress dev\",\n \"docs:build\": \"vitepress build\",\n \"docs:preview\": \"vitepress preview\"\n }\n}" }, { "path": "docs/showcase.md", "content": "# 优秀案例\n\n这里收录了一些使用 FileCodeBox 搭建的优秀站点。如果你也部署了 FileCodeBox，欢迎提交 PR 将你的站点添加到这里！\n\n## 官方演示站\n\n
\n\n
\n\n### 🌟 FileCodeBox Demo\n\n- **网址**：[share.lanol.cn](https://share.lanol.cn)\n- **简介**：官方演示站点，体验最新功能\n- **特点**：稳定运行，功能完整\n\n
\n\n
\n\n## 社区站点\n\n::: tip 提交你的站点\n如果你使用 FileCodeBox 搭建了自己的文件分享服务，欢迎通过以下方式提交：\n\n1. 在 [GitHub](https://github.com/vastsa/FileCodeBox) 提交 PR，编辑此页面\n2. 在 [Issues](https://github.com/vastsa/FileCodeBox/issues) 中提交你的站点信息\n3. 加入 QQ 群 739673698 联系管理员\n:::\n\n\n\n
\n\n
\n\n### 取文件\n\n- **网址**：[www.quwenjian.cn/fby.html](https://www.quwenjian.cn/fby.html)\n- **简介**：取文件 - 存储无界，便携无限\n- **特点**：永久免费的文件中转站\n- **运营者**：取文件&取文件网盘\n\n
\n\n
\n\n### 潘多拉盒子\n\n- **网址**：[pan.duo.la](https://pan.duo.la)\n- **简介**：潘多拉盒子\n- **特点**：经典1.6版本\n- **运营者**：五行缺心眼\n\n
\n\n
\n\n## 提交要求\n\n为了保证收录站点的质量，请确保你的站点满足以下条件：\n\n1. **稳定运行**：站点需要稳定运行，能够正常访问\n2. **合法合规**：站点内容需要合法合规，不得包含违法违规内容\n3. **保留版权**：建议保留 FileCodeBox 的版权信息\n4. **HTTPS 支持**：建议启用 HTTPS 加密访问\n\n## 案例展示模板\n\n如果你想提交站点，请按照以下格式：\n\n```markdown\n### 站点名称\n\n- **网址**：[域名](https://域名)\n- **简介**：一句话描述站点用途\n- **特点**：站点的特色功能或亮点\n- **运营者**：可选，你的名字或组织\n```\n\n\n" }, { "path": "main.py", "content": "# @Time : 2023/8/9 23:23\n# @Author : Lan\n# @File : main.py\n# @Software: PyCharm\nimport asyncio\nimport time\nfrom contextlib import asynccontextmanager\n\nfrom fastapi import FastAPI\nfrom fastapi.middleware.cors import CORSMiddleware\nfrom fastapi.responses import HTMLResponse\nfrom fastapi.staticfiles import StaticFiles\nfrom tortoise import Tortoise\nfrom tortoise.contrib.fastapi import register_tortoise\n\nfrom apps.admin.views import admin_api\nfrom apps.base.models import KeyValue\nfrom apps.base.utils import ip_limit\nfrom apps.base.views import share_api, chunk_api, presign_api\nfrom core.config import ensure_settings_row, refresh_settings\nfrom core.database import db_startup_lock, get_db_config, init_db\nfrom core.logger import logger\nfrom core.response import APIResponse\nfrom core.settings import settings, BASE_DIR, DEFAULT_CONFIG\nfrom core.tasks import delete_expire_files, clean_incomplete_uploads\nfrom core.utils import hash_password, is_password_hashed\n\n\n@asynccontextmanager\nasync def lifespan(app: FastAPI):\n logger.info(\"正在初始化应用...\")\n # 初始化数据库\n await init_db()\n\n # 加载配置（多进程下串行化启动写操作）\n async with db_startup_lock():\n await load_config()\n app.mount(\n \"/assets\",\n StaticFiles(directory=f\"./{settings.themesSelect}/assets\"),\n name=\"assets\",\n )\n\n # 启动后台任务\n task = asyncio.create_task(delete_expire_files())\n chunk_cleanup_task = asyncio.create_task(clean_incomplete_uploads())\n logger.info(\"应用初始化完成\")\n\n try:\n yield\n finally:\n # 清理操作\n logger.info(\"正在关闭应用...\")\n task.cancel()\n chunk_cleanup_task.cancel()\n await asyncio.gather(task, chunk_cleanup_task, return_exceptions=True)\n await Tortoise.close_connections()\n logger.info(\"应用已关闭\")\n\n\nasync def load_config():\n await ensure_settings_row()\n await KeyValue.update_or_create(\n key=\"sys_start\", defaults={\"value\": int(time.time() * 1000)}\n )\n await refresh_settings()\n\n await migrate_password_to_hash()\n\n ip_limit[\"error\"].minutes = settings.errorMinute\n ip_limit[\"error\"].count = settings.errorCount\n ip_limit[\"upload\"].minutes = settings.uploadMinute\n ip_limit[\"upload\"].count = settings.uploadCount\n\n\nasync def migrate_password_to_hash():\n if not is_password_hashed(settings.admin_token):\n hashed = hash_password(settings.admin_token)\n settings.admin_token = hashed\n config_record = await KeyValue.filter(key=\"settings\").first()\n if config_record and config_record.value:\n config_record.value[\"admin_token\"] = hashed\n await config_record.save()\n logger.info(\"已将管理员密码迁移为哈希存储\")\n\n\napp = FastAPI(lifespan=lifespan)\n\n@app.middleware(\"http\")\nasync def refresh_settings_middleware(request, call_next):\n await refresh_settings()\n return await call_next(request)\n\napp.add_middleware(\n CORSMiddleware,\n allow_origins=[\"*\"],\n allow_credentials=True,\n allow_methods=[\"*\"],\n allow_headers=[\"*\"],\n)\n\n# 使用 register_tortoise 来添加异常处理器\nregister_tortoise(\n app,\n config=get_db_config(),\n generate_schemas=False,\n add_exception_handlers=True,\n)\n\napp.include_router(share_api)\napp.include_router(chunk_api)\napp.include_router(presign_api)\napp.include_router(admin_api)\n\n\n@app.exception_handler(404)\n@app.get(\"/\")\nasync def index(request=None, exc=None):\n return HTMLResponse(\n content=open(\n BASE_DIR / f\"{settings.themesSelect}/index.html\", \"r\", encoding=\"utf-8\"\n )\n .read()\n .replace(\"{{title}}\", str(settings.name))\n .replace(\"{{description}}\", str(settings.description))\n .replace(\"{{keywords}}\", str(settings.keywords))\n .replace(\"{{opacity}}\", str(settings.opacity))\n .replace('\"/assets/', '\"assets/')\n .replace(\"{{background}}\", str(settings.background)),\n media_type=\"text/html\",\n headers={\"Cache-Control\": \"no-cache\"},\n )\n\n\n@app.get(\"/robots.txt\")\nasync def robots():\n return HTMLResponse(content=settings.robotsText, media_type=\"text/plain\")\n\n\n@app.post(\"/\")\nasync def get_config():\n return APIResponse(\n detail={\n \"name\": settings.name,\n \"description\": settings.description,\n \"explain\": settings.page_explain,\n \"uploadSize\": settings.uploadSize,\n \"expireStyle\": settings.expireStyle,\n \"enableChunk\": settings.enableChunk,\n \"openUpload\": settings.openUpload,\n \"notify_title\": settings.notify_title,\n \"notify_content\": settings.notify_content,\n \"show_admin_address\": settings.showAdminAddr,\n \"max_save_seconds\": settings.max_save_seconds,\n }\n )\n\n\nif __name__ == \"__main__\":\n import uvicorn\n\n uvicorn.run(\n app=\"main:app\",\n host=settings.serverHost,\n port=settings.serverPort,\n reload=False,\n workers=settings.serverWorkers,\n )\n" }, { "path": "readme.md", "content": "
\n\n# FileCodeBox\n\n### 文件快递柜 - 匿名口令分享文本和文件\n\n\"FileCodeBox\n\n像拿快递一样取文件，无需注册，输入口令即可获取\n\n[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/network)\n[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/issues)\n[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox?style=flat-square)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)\n[![Docker Pulls](https://img.shields.io/docker/pulls/lanol/filecodebox?style=flat-square&logo=docker)](https://hub.docker.com/r/lanol/filecodebox)\n\n[![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-009688?style=flat-square&logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com)\n[![Vue.js](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white)](https://vuejs.org)\n\n[English](./readme_en.md) | [在线演示](https://share.lanol.cn) | [部署教程](https://github.com/vastsa/FileCodeBox/wiki/部署教程) | [常见问题](https://github.com/vastsa/FileCodeBox/wiki/常见问题) | [QQ群: 739673698](https://qm.qq.com/q/PemPzhdEIM)\n\n```bash\n# 🚀 一键部署\ndocker run -d -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest\n# 国内镜像（如果上面拉取缓慢）: docker.cnb.cool/aixk/filecodebox\n```\n\n
\n\n---\n\n## 目录\n\n- [项目简介](#-项目简介)\n- [功能特性](#-功能特性)\n- [界面预览](#-界面预览)\n- [快速开始](#-快速开始)\n- [使用指南](#-使用指南)\n- [开发指南](#-开发指南)\n- [常见问题](#-常见问题)\n- [贡献指南](#-贡献指南)\n- [项目统计](#-项目统计)\n- [免责声明](#-免责声明)\n\n---\n\n## 📝 项目简介\n\nFileCodeBox 是一个轻量级的文件分享工具，基于 **FastAPI + Vue3** 开发。用户可以通过简单的方式匿名分享文本和文件，接收者只需输入提取码即可获取内容——就像从快递柜取出快递一样简单。\n\n### 应用场景\n\n| 场景 | 描述 |\n|------|------|\n| 📁 **临时文件分享** | 快速分享文件，无需注册登录 |\n| 📝 **代码片段分享** | 分享代码、配置文件等文本内容 |\n| 🕶️ **匿名文件传输** | 保护隐私的点对点传输 |\n| 🔄 **跨设备传输** | 在不同设备间快速同步文件 |\n| 💾 **临时存储** | 支持自定义过期时间的云存储 |\n| 🌐 **私有服务** | 搭建企业或个人专属分享服务 |\n\n---\n\n## ✨ 功能特性\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\n### 🚀 轻量高效\n- FastAPI + SQLite3 后端\n- Vue3 + Element Plus 前端\n- Docker 一键部署\n- 资源占用极低\n\n\n\n### 🔒 安全可靠\n- IP 上传频率限制\n- 提取码错误次数限制\n- 文件自动过期清理\n- 支持管理员认证\n\n\n\n### 📤 便捷上传\n- 拖拽上传\n- 复制粘贴上传\n- 命令行 curl 上传\n- 批量文件上传\n\n
\n\n### 🎫 灵活分享\n- 随机/自定义提取码\n- 可设置有效期（时间/次数）\n- 支持永久有效\n- 文本和文件统一管理\n\n\n\n### 💾 多存储支持\n- 本地文件系统\n- S3 兼容存储\n- [OneDrive](./docs/guide/storage-onedrive.md)\n- [OpenDAL](./docs/guide/storage-opendal.md)\n\n\n\n### 🌍 国际化\n- 简体中文\n- 繁体中文\n- English\n- 响应式设计 / 深色模式\n\n
\n\n---\n\n## 🖼️ 界面预览\n\n> 前端源码仓库：[2024主题](https://github.com/vastsa/FileCodeBoxFronted) | [2023主题](https://github.com/vastsa/FileCodeBoxFronted2023)\n\n
\n🎨 新版界面 (2024)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\"文件上传\"\"文本分享\"
\"文件管理\"\"系统设置\"
\"移动端\"\"深色模式\"
\n
\n
\n\n
\n📦 经典界面 (2023)\n
\n
\n\n\n\n\n\n\n\n\n\n
\"首页\"\"上传\"
\"管理\"\"设置\"
\n
\n
\n\n---\n\n## 🚀 快速开始\n\n### Docker 部署（推荐）\n\n**方式一：Docker CLI**\n\n```bash\n# Docker Hub（推荐）\ndocker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest\n\n# 国内镜像（如果 Docker Hub 拉取缓慢）\ndocker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox docker.cnb.cool/aixk/filecodebox\n```\n\n**方式二：Docker Compose**\n\n```yaml\nservices:\n filecodebox:\n image: lanol/filecodebox:latest\n container_name: filecodebox\n restart: unless-stopped\n ports:\n - \"12345:12345\"\n volumes:\n - ./data:/app/data\n environment:\n - WORKERS=4\n - LOG_LEVEL=info\n```\n\n```bash\ndocker compose up -d\n```\n\n**环境变量说明**\n\n| 变量 | 默认值 | 说明 |\n|------|--------|------|\n| `HOST` | `::` | 监听地址（支持 IPv4/IPv6 双栈） |\n| `PORT` | `12345` | 服务端口 |\n| `WORKERS` | `4` | 工作进程数（建议设为 CPU 核心数） |\n| `LOG_LEVEL` | `info` | 日志级别：`debug` / `info` / `warning` / `error` |\n\n### 反向代理配置\n\n使用 Nginx 时，请添加以下配置以正确获取客户端 IP：\n\n```nginx\nlocation / {\n proxy_pass http://127.0.0.1:12345;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n client_max_body_size 100m; # 根据需要调整上传大小限制\n}\n```\n\n### 手动部署\n\n```bash\n# 1. 克隆项目\ngit clone https://github.com/vastsa/FileCodeBox.git\ncd FileCodeBox\n\n# 2. 安装依赖\npip install -r requirements.txt\n\n# 3. 启动服务\npython main.py\n```\n\n---\n\n## 📖 使用指南\n\n### 基础操作\n\n| 操作 | 步骤 |\n|------|------|\n| **分享文件** | 打开网页 → 选择/拖拽文件 → 设置有效期 → 获取提取码 |\n| **获取文件** | 打开网页 → 输入提取码 → 下载文件或查看文本 |\n| **管理后台** | 访问 `/#/admin` → 输入密码 `FileCodeBox2023` |\n\n### 命令行使用（curl）\n\n
\n点击展开 curl 使用示例\n\n**上传文件**\n\n```bash\n# 基础上传（默认 1 天有效期）\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\"\n\n# 指定 1 小时有效期\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\" \\\n -F \"expire_value=1\" \\\n -F \"expire_style=hour\"\n\n# 指定下载 10 次后过期\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\" \\\n -F \"expire_value=10\" \\\n -F \"expire_style=count\"\n```\n\n**分享文本**\n\n```bash\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -F \"text=要分享的文本内容\"\n```\n\n**下载文件**\n\n```bash\ncurl -L \"http://localhost:12345/share/select/?code=提取码\" -o filename\n```\n\n**有效期参数**\n\n| `expire_style` | 说明 |\n|----------------|------|\n| `day` | 天数 |\n| `hour` | 小时 |\n| `minute` | 分钟 |\n| `count` | 下载次数 |\n| `forever` | 永久有效 |\n\n**返回示例**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"code\": \"abcd1234\",\n \"name\": \"file.txt\"\n }\n}\n```\n\n**需要认证时**（管理员关闭游客上传后）\n\n```bash\n# 1. 获取 token\ncurl -X POST \"http://localhost:12345/admin/login\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"password\": \"FileCodeBox2023\"}'\n\n# 2. 携带 token 上传\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -H \"Authorization: Bearer \" \\\n -F \"file=@/path/to/file.txt\"\n```\n\n
\n\n---\n\n## 🛠 开发指南\n\n### 项目结构\n\n```\nFileCodeBox/\n├── apps/ # 应用模块\n│ ├── admin/ # 管理后台\n│ └── base/ # 基础功能\n├── core/ # 核心模块\n├── data/ # 数据目录（运行时生成）\n├── docs/ # 文档\n└── main.py # 入口文件\n```\n\n### 本地开发\n\n**后端**\n\n```bash\npip install -r requirements.txt\npython main.py\n```\n\n**前端**\n\n```bash\n# 前端仓库: https://github.com/vastsa/FileCodeBoxFronted\ncd fcb-fronted\nnpm install\nnpm run dev\n```\n\n### 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| **后端框架** | FastAPI 0.128+ / Uvicorn |\n| **数据库** | SQLite + Tortoise ORM |\n| **数据验证** | Pydantic 2.x |\n| **异步支持** | aiofiles / aiohttp / aioboto3 |\n| **对象存储** | S3 协议 / OneDrive / OpenDAL |\n| **前端框架** | Vue 3 + Element Plus + Vite |\n| **运行环境** | Python 3.8+ / Node.js 18+ |\n| **容器化** | Docker / Docker Compose |\n\n---\n\n## ❓ 常见问题\n\n
\n如何修改上传大小限制？\n\n在管理面板中修改 `uploadSize` 配置项。如果使用 Nginx 反向代理，还需修改 `client_max_body_size`。\n
\n\n
\n如何配置存储引擎？\n\n在管理面板中选择存储引擎类型并配置相应参数。支持本地存储、S3、OneDrive、OpenDAL 等。\n
\n\n
\n如何备份数据？\n\n备份 `data` 目录即可，包含数据库和上传的文件。\n
\n\n
\n如何修改管理员密码？\n\n登录管理面板后，在系统设置中修改 `adminPassword` 配置项。\n
\n\n更多问题请访问 [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题) 或加入 [QQ群: 739673698](https://qm.qq.com/q/PemPzhdEIM)\n\n---\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n```bash\n# 1. Fork 并克隆\ngit clone https://github.com/your-username/FileCodeBox.git\n\n# 2. 创建分支\ngit checkout -b feature/your-feature\n\n# 3. 提交更改\ngit commit -m \"feat: add your feature\"\n\n# 4. 推送并创建 PR\ngit push origin feature/your-feature\n```\n\n---\n\n## 📊 项目统计\n\n
\n\n\n \"HelloGitHub\"\n\n\n![Repobeats](https://repobeats.axiom.co/api/embed/7a6c92f1d96ee57e6fb67f0df371528397b0c9ac.svg)\n\n[![Star History](https://api.star-history.com/svg?repos=vastsa/FileCodeBox&type=Date)](https://star-history.com/#vastsa/FileCodeBox&Date)\n\n
\n\n---\n\n## 🗓 更新计划\n\n- [ ] 2025 年新皮肤\n- [ ] 文件收集功能\n\n---\n\n## 📜 免责声明\n\n本项目开源仅供学习交流使用，不得用于任何违法用途，否则后果自负，与作者无关。使用本项目时请保留项目地址和版权信息。\n\n---\n\n
\n\n**如果觉得项目不错，欢迎 ⭐ Star 支持！**\n\nMade with ❤️ by [vastsa](https://github.com/vastsa)\n\n
\n" }, { "path": "readme_en.md", "content": "
\n\n# FileCodeBox\n\n### Anonymous File & Text Sharing with Passcode\n\n\"FileCodeBox\n\nShare files like picking up a package — no registration required, just enter the passcode\n\n[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/network)\n[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/issues)\n[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox?style=flat-square)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)\n[![Docker Pulls](https://img.shields.io/docker/pulls/lanol/filecodebox?style=flat-square&logo=docker)](https://hub.docker.com/r/lanol/filecodebox)\n\n[![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.128+-009688?style=flat-square&logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com)\n[![Vue.js](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white)](https://vuejs.org)\n\n[简体中文](./README.md) | [Live Demo](https://share.lanol.cn) | [Documentation](https://github.com/vastsa/FileCodeBox/wiki/Deployment-Guide) | [FAQ](https://github.com/vastsa/FileCodeBox/wiki/FAQ)\n\n```bash\n# 🚀 Quick Deploy\ndocker run -d -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest\n# China Mirror (if slow): docker.cnb.cool/aixk/filecodebox\n```\n\n
\n\n---\n\n## Table of Contents\n\n- [Introduction](#-introduction)\n- [Features](#-features)\n- [Screenshots](#-screenshots)\n- [Quick Start](#-quick-start)\n- [Usage Guide](#-usage-guide)\n- [Development](#-development)\n- [FAQ](#-faq)\n- [Contributing](#-contributing)\n- [Statistics](#-statistics)\n- [Disclaimer](#-disclaimer)\n\n---\n\n## 📝 Introduction\n\nFileCodeBox is a lightweight file sharing tool built with **FastAPI + Vue3**. Users can anonymously share text and files, and recipients only need to enter a passcode to retrieve the content — just like picking up a package from a locker.\n\n### Use Cases\n\n| Scenario | Description |\n|----------|-------------|\n| 📁 **Temporary File Sharing** | Quick file sharing without registration |\n| 📝 **Code Snippet Sharing** | Share code, config files, and text content |\n| 🕶️ **Anonymous Transfer** | Privacy-protected peer-to-peer transfer |\n| 🔄 **Cross-Device Transfer** | Quickly sync files between devices |\n| 💾 **Temporary Storage** | Cloud storage with custom expiration |\n| 🌐 **Private Service** | Build your own enterprise or personal sharing service |\n\n---\n\n## ✨ Features\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\n### 🚀 Lightweight & Fast\n- FastAPI + SQLite3 backend\n- Vue3 + Element Plus frontend\n- One-click Docker deployment\n- Minimal resource usage\n\n\n\n### 🔒 Secure & Reliable\n- IP upload rate limiting\n- Passcode attempt limiting\n- Auto file expiration cleanup\n- Admin authentication support\n\n\n\n### 📤 Easy Upload\n- Drag & drop upload\n- Copy & paste upload\n- Command line curl upload\n- Batch file upload\n\n
\n\n### 🎫 Flexible Sharing\n- Random / custom passcodes\n- Set expiration (time/count)\n- Permanent validity support\n- Unified text & file management\n\n\n\n### 💾 Multiple Storage\n- Local file system\n- S3-compatible storage\n- [OneDrive](./docs/guide/storage-onedrive.md)\n- [OpenDAL](./docs/guide/storage-opendal.md)\n\n\n\n### 🌍 Internationalization\n- Simplified Chinese\n- Traditional Chinese\n- English\n- Responsive design / Dark mode\n\n
\n\n---\n\n## 🖼️ Screenshots\n\n> Frontend repositories: [2024 Theme](https://github.com/vastsa/FileCodeBoxFronted) | [2023 Theme](https://github.com/vastsa/FileCodeBoxFronted2023)\n\n
\n🎨 New Interface (2024)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\"File\"Text
\"File\"System
\"Mobile\"Dark
\n
\n
\n\n
\n📦 Classic Interface (2023)\n
\n
\n\n\n\n\n\n\n\n\n\n
\"Home\"\"Upload\"
\"Management\"\"Settings\"
\n
\n
\n\n---\n\n## 🚀 Quick Start\n\n### Docker Deployment (Recommended)\n\n**Option 1: Docker CLI**\n\n```bash\n# Docker Hub (Recommended)\ndocker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest\n\n# China Mirror (if Docker Hub is slow)\ndocker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox docker.cnb.cool/aixk/filecodebox\n```\n\n**Option 2: Docker Compose**\n\n```yaml\nservices:\n filecodebox:\n image: lanol/filecodebox:latest\n container_name: filecodebox\n restart: unless-stopped\n ports:\n - \"12345:12345\"\n volumes:\n - ./data:/app/data\n environment:\n - WORKERS=4\n - LOG_LEVEL=info\n```\n\n```bash\ndocker compose up -d\n```\n\n**Environment Variables**\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `HOST` | `::` | Listen address (supports IPv4/IPv6 dual-stack) |\n| `PORT` | `12345` | Service port |\n| `WORKERS` | `4` | Worker processes (recommended: CPU cores) |\n| `LOG_LEVEL` | `info` | Log level: `debug` / `info` / `warning` / `error` |\n\n### Reverse Proxy Configuration\n\nWhen using Nginx, add the following configuration to properly obtain client IP:\n\n```nginx\nlocation / {\n proxy_pass http://127.0.0.1:12345;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n client_max_body_size 100m; # Adjust upload size limit as needed\n}\n```\n\n### Manual Deployment\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/vastsa/FileCodeBox.git\ncd FileCodeBox\n\n# 2. Install dependencies\npip install -r requirements.txt\n\n# 3. Start the service\npython main.py\n```\n\n---\n\n## 📖 Usage Guide\n\n### Basic Operations\n\n| Operation | Steps |\n|-----------|-------|\n| **Share File** | Open website → Select/drag files → Set expiration → Get passcode |\n| **Retrieve File** | Open website → Enter passcode → Download file or view text |\n| **Admin Panel** | Visit `/#/admin` → Enter password `FileCodeBox2023` |\n\n### Command Line Usage (curl)\n\n
\nClick to expand curl examples\n\n**Upload File**\n\n```bash\n# Basic upload (default 1 day expiration)\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\"\n\n# Set 1 hour expiration\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\" \\\n -F \"expire_value=1\" \\\n -F \"expire_style=hour\"\n\n# Set expiration after 10 downloads\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -F \"file=@/path/to/file.txt\" \\\n -F \"expire_value=10\" \\\n -F \"expire_style=count\"\n```\n\n**Share Text**\n\n```bash\ncurl -X POST \"http://localhost:12345/share/text/\" \\\n -F \"text=Text content to share\"\n```\n\n**Download File**\n\n```bash\ncurl -L \"http://localhost:12345/share/select/?code=PASSCODE\" -o filename\n```\n\n**Expiration Parameters**\n\n| `expire_style` | Description |\n|----------------|-------------|\n| `day` | Days |\n| `hour` | Hours |\n| `minute` | Minutes |\n| `count` | Download count |\n| `forever` | Never expire |\n\n**Response Example**\n\n```json\n{\n \"code\": 200,\n \"msg\": \"success\",\n \"detail\": {\n \"code\": \"abcd1234\",\n \"name\": \"file.txt\"\n }\n}\n```\n\n**When Authentication Required** (after admin disables guest upload)\n\n```bash\n# 1. Get token\ncurl -X POST \"http://localhost:12345/admin/login\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"password\": \"FileCodeBox2023\"}'\n\n# 2. Upload with token\ncurl -X POST \"http://localhost:12345/share/file/\" \\\n -H \"Authorization: Bearer \" \\\n -F \"file=@/path/to/file.txt\"\n```\n\n
\n\n---\n\n## 🛠 Development\n\n### Project Structure\n\n```\nFileCodeBox/\n├── apps/ # Application modules\n│ ├── admin/ # Admin backend\n│ └── base/ # Base functionality\n├── core/ # Core modules\n├── data/ # Data directory (generated at runtime)\n├── docs/ # Documentation\n└── main.py # Entry point\n```\n\n### Local Development\n\n**Backend**\n\n```bash\npip install -r requirements.txt\npython main.py\n```\n\n**Frontend**\n\n```bash\n# Frontend repo: https://github.com/vastsa/FileCodeBoxFronted\ncd fcb-fronted\nnpm install\nnpm run dev\n```\n\n### Tech Stack\n\n| Category | Technology |\n|----------|------------|\n| **Backend Framework** | FastAPI 0.128+ / Uvicorn |\n| **Database** | SQLite + Tortoise ORM |\n| **Data Validation** | Pydantic 2.x |\n| **Async Support** | aiofiles / aiohttp / aioboto3 |\n| **Object Storage** | S3 Protocol / OneDrive / OpenDAL |\n| **Frontend Framework** | Vue 3 + Element Plus + Vite |\n| **Runtime** | Python 3.8+ / Node.js 18+ |\n| **Containerization** | Docker / Docker Compose |\n\n---\n\n## ❓ FAQ\n\n
\nHow to modify upload size limit?\n\nModify the `uploadSize` configuration in the admin panel. If using Nginx reverse proxy, also modify `client_max_body_size`.\n
\n\n
\nHow to configure storage engine?\n\nSelect the storage engine type and configure parameters in the admin panel. Supports local storage, S3, OneDrive, OpenDAL, etc.\n
\n\n
\nHow to backup data?\n\nBackup the `data` directory, which contains the database and uploaded files.\n
\n\n
\nHow to change admin password?\n\nAfter logging into the admin panel, modify the `adminPassword` configuration in system settings.\n
\n\nFor more questions, visit [Wiki](https://github.com/vastsa/FileCodeBox/wiki/FAQ)\n\n---\n\n## 🤝 Contributing\n\nIssues and Pull Requests are welcome!\n\n```bash\n# 1. Fork and clone\ngit clone https://github.com/your-username/FileCodeBox.git\n\n# 2. Create branch\ngit checkout -b feature/your-feature\n\n# 3. Commit changes\ngit commit -m \"feat: add your feature\"\n\n# 4. Push and create PR\ngit push origin feature/your-feature\n```\n\n---\n\n## 📊 Statistics\n\n
\n\n\n \"HelloGitHub\"\n\n\n![Repobeats](https://repobeats.axiom.co/api/embed/7a6c92f1d96ee57e6fb67f0df371528397b0c9ac.svg)\n\n[![Star History](https://api.star-history.com/svg?repos=vastsa/FileCodeBox&type=Date)](https://star-history.com/#vastsa/FileCodeBox&Date)\n\n
\n\n---\n\n## 🗓 Roadmap\n\n- [ ] 2025 New Theme\n- [ ] File Collection Feature\n\n---\n\n## 📜 Disclaimer\n\nThis project is open-source for learning and communication purposes only. It should not be used for any illegal purposes. The author is not responsible for any consequences. Please retain the project address and copyright information when using it.\n\n---\n\n
\n\n**If you find this project helpful, please give it a ⭐ Star!**\n\nMade with ❤️ by [vastsa](https://github.com/vastsa)\n\n
\n" }, { "path": "requirements.txt", "content": "aioboto3==15.5.0\naiohttp==3.13.3\naiofiles==25.1.0\nfastapi==0.128.0\npydantic==2.12.5\nuvicorn==0.40.0\ntortoise-orm==0.25.3\npython-multipart==0.0.21\n" } ]