chore(寄件): 清理个人品牌标识与开发过程文档

Author: dawnstamp

apps/delivery/static/admin.html

@@ -8,7 +8,7 @@
   <script type="module" src="/delivery-assets/admin.js"></script>
 </head>
 <body>
-  <header class="shell header"><a class="brand" href="/">文件驿站 <span>FileRelay</span></a><nav><a href="/delivery">访客投递页</a><a href="/#/admin">原管理后台</a><button id="logout" class="quiet" hidden>退出登录</button></nav></header>
+  <header class="shell header"><a class="brand" href="/">文件快递柜 <span>FileCodeBox</span></a><nav><a href="/delivery">访客投递页</a><a href="/#/admin">原管理后台</a><button id="logout" class="quiet" hidden>退出登录</button></nav></header>
   <main class="shell">
     <p class="eyebrow">管理员工作台</p><h1>寄件管理</h1><p class="intro">用一枚口令，收齐一份资料。控制有效期、投递次数与收件目录。</p>
     <section id="login-panel" class="card login">

apps/delivery/static/admin.js

@@ -1,7 +1,8 @@
 import {$, api, bytes, date, cell, emptyRow, errorText, message} from './common.js';
 
 // 管理凭证只存在当前标签页会话中；不与访客寄件凭证混用。
-const tokenKey = 'filerelay_delivery_admin_token';
+// 使用项目统一的会话键名，旧版独立页面用户需要重新登录。
+const tokenKey = 'filecodebox_delivery_admin_token';
 let token = sessionStorage.getItem(tokenKey) || '';
 let page = 1, filePage = 1, selected = null, listSequence = 0, fileSequence = 0;
 const stateNames = {active:'可投递', disabled:'已禁用', expired:'已过期', exhausted:'次数耗尽', deleted:'已删除', pending:'上传中', stored:'已收到', cleanup:'等待清理'};

apps/delivery/static/delivery.html

@@ -8,7 +8,7 @@
   <script type="module" src="/delivery-assets/delivery.js"></script>
 </head>
 <body>
-  <header class="shell header"><a class="brand" href="/">文件驿站 <span>FileRelay</span></a><a href="/">返回取件首页</a></header>
+  <header class="shell header"><a class="brand" href="/">文件快递柜 <span>FileCodeBox</span></a><a href="/">返回取件首页</a></header>
   <main class="shell visitor">
     <p class="eyebrow">文件投递</p><h1>把文件，安心交给对方。</h1>
     <p class="intro">输入对方给你的寄件码，即可上传资料。无需注册，收到的文件仅由管理员管理。</p>

apps/delivery/static/entry.css

@@ -1,7 +1,7 @@
 // 上游主题仍单独构建；使用小型入口桥接其 hash 路由，后台页面可直接进入寄件管理。
 (() => {
   const nav = document.createElement('nav');
-  nav.className = 'filerelay-entry'; nav.setAttribute('aria-label', '寄件功能');
+  nav.className = 'filecodebox-delivery-entry'; nav.setAttribute('aria-label', '寄件功能');
   const send = document.createElement('a'); send.href = '/delivery'; send.textContent = '凭码寄件'; nav.append(send);
   const manage = document.createElement('a'); manage.href = '/delivery/admin'; manage.textContent = '寄件管理'; nav.append(manage);
   const update = () => { manage.hidden = !window.location.hash.startsWith('#/admin'); };

apps/delivery/static/entry.js

@@ -28,7 +28,7 @@
 - 删除文件不恢复已经用过的上传次数。两个管理入口及自动过期任务使用相同的关联清理流程，失败残留持续计入容量，稍后自动重试。
 - 文件到期或领取次数耗尽后，沿用普通文件管理每 10 分钟运行的过期清理任务；实际文件清理成功后物理删除收件记录，失败时保留记录重试。历史已清理且大小归零的收件空记录由寄件清理任务分批移除。
 - 寄件码手动删除时物理删除记录；上传成功且额度耗尽、没有其他上传占用时自动清除寄件码。剩余额度仍可用的多次寄件码继续保留。已生成的普通取件码及文件不会随寄件码删除，仍按自己的期限或领取次数清理。旧撤销记录由清理任务分批回收，不再提供历史筛选入口。
-- 用户已确认：此前的私有收件保持私有，不自动生成取件码。旧客户端若未提交过期参数，也沿用旧私有投递语义；新 2024 页面始终显式提交分享过期策略。
+- 历史私有收件保持私有，不自动生成取件码。旧客户端若未提交过期参数，也沿用旧私有投递语义；新 2024 页面始终显式提交分享过期策略。
 - 文件大小和类型沿用站点设置；已收文件和清理中的残留文件计入全站容量限制。
 
 ## 存储配置
@@ -41,7 +41,7 @@ OneDrive 寄件使用精确文件对象路径，避免旧分享目录约定截
 
 存储凭据不复制到寄件记录；如果变更同一后端的账号、桶名、根目录或服务地址，需先迁移旧文件，否则旧记录可能无法下载。远端桶和目录应保持私有，应用中的管理员权限无法覆盖第三方自行开放的公开访问设置。
 
-本次没有新增账号体系。`owner_id` 固定为服务端的管理员身份，客户端不能指定；将来加入子用户时需要同时补充其认证、归属及目录隔离授权。
+寄件功能不引入新的账号体系。`owner_id` 固定为服务端的管理员身份，客户端不能指定；将来加入子用户时需要同时补充其认证、归属及目录隔离授权。
 
 ## API
 
@@ -82,7 +82,7 @@ python -m uvicorn main:app --host 127.0.0.1 --port 12345
 - `migrations_009.py` 为寄件码增加可空的 `code_value` 原文字段，保留旧摘要和已分发口令的有效性。数据库及备份包含寄件码原文，应继续使用原有权限保护。
 - `migrations_010.py` 增加 `deliveryfile.share_id` 关联普通分享。旧行保持 NULL；新分享容量由 FileCodes 计算，私有收件及清理残留另计，避免同一文件重复占用配额。
 - 2024 原生寄件页面在独立前端仓库，构建后更新 `themes/2024`。通过构建标记识别新页面，旧 `/delivery` 和 `/delivery/admin` 分别跳转到 `/#/delivery` 与 `/#/admin/delivery`。
-- `apps/delivery/static` 保留旧主题回退页面。2023 主题本次不开发、不重新构建；未包含原生寄件的主题继续使用该回退。
+- `apps/delivery/static` 保留旧主题回退页面。2023 版前端源码未修改；未包含原生寄件的主题继续使用该回退。
 - 原主题仍由原 Docker 构建流程生成。纯源码开发时，寄件页可独立使用；原取件页需提供 `themes/2024` 或 `themes/2023` 构建产物。
 - 新清理任务每分钟检查一次；心跳停止超过两小时的上传视为异常遗留，释放次数并清理文件。删除失败的记录保留为“等待清理”，继续计入容量并自动重试。
 - 已存文件的后台下载优先使用浏览器文件系统接口流式保存；不支持的浏览器回退为 Blob，大文件下载的内存占用较高。

docs/guide/delivery.md

@@ -23,13 +23,13 @@
 
 ## 寄件码
 
-本仓库在 FileCodeBox 基础上增加 [寄件码功能](./docs/guide/delivery.md)：管理员预先生成口令，临时访客凭码投递到指定目录；关闭游客自由上传后仍可收件。寄件码只授权上传，后台可管理有效期、次数和已收文件。
+使用 [寄件码功能](./docs/guide/delivery.md)：管理员预先生成口令，临时访客凭码投递到指定目录；关闭游客自由上传后仍可收件。寄件码只授权上传，后台可管理有效期、次数和已收文件。
 
 - 访客投递：`/delivery`
 - 寄件管理：`/delivery/admin`（使用本站管理员密码）
-- 后端在本仓库，2024 原生寄件页面在独立前端仓库；启动时自动执行迁移 008–010。旧主题保留独立页面回退。使用包含前后端改动的自建程序；下方上游预构建镜像不包含此扩展。
+- 原生寄件界面适用于 2024 主题，需配套更新前端；启动时自动执行迁移 008–012。2023 前端源码未修改，未包含原生寄件功能的主题使用后端提供的独立页面。
 
-## 上游镜像快速开始
+## 一条命令开始
 
 ```bash
 docker run -d --restart unless-stopped \