文链（手机端）
官方 iOS 客户端，连接你的 Docs 托管服务，上传大文件并生成分享链接。App Store 名称、主屏幕图标下方显示名称均为 文链（手机端）（勿单独使用「文链」）。macOS 对应客户端 App Store 名称为 DocLinks。本应用免费、无内购、无订阅。
命名规范
| 字段 | iOS 本应用 | macOS 客户端 |
|---|---|---|
| App Store 名称 | 文链（手机端） | DocLinks |
| Bundle ID | com.chengyusheng.docsshare.upload | com.chengyusheng.doclinks-mac |
| 当前版本 | 1.0.2 | 1.0.1（Mac 已上架 App Store） |
| 说明文档 | 本页 | mac-app-guide.html |
应用概述
- 平台：iOS 17+，iPhone / iPad
- 后端：与 Web 版
/files（文链）共用同一套 API - 鉴权：用户注册/登录，或 Admin Token；凭据存于系统钥匙串
- 上传：自动选择对象存储直传或服务端代理分片模式
- 界面：上传、分享列表、设置三个标签页
使用条件
- 已部署 Docs 托管服务（参见 使用文档）
- 服务端已执行数据库迁移（含
0009–0012） - 拥有成员账号（可自助注册）或 Admin Token
- 大文件直传建议已配置对象存储 API 密钥（可选，未配置时走服务端代理）
登录
- 打开应用，输入服务器地址（默认
https://docs.cn.page） - 选择「用户登录」「注册」或「管理员」
- 成员：输入用户名与密码；管理员：输入 Admin Token
- 点击对应登录按钮
上传文件
- 在「上传」标签页点击「选择文件」
- 通过系统文档选择器选取一个或多个文件
- 填写分享备注、访问密码（可选，可随机生成）、有效期
- 点击「开始上传」，等待进度完成
- 成功后可复制分享链接或通过系统分享面板发送
限制：单次最多 500 个文件，总大小 50 GB（与服务端一致）。超大文件建议保持应用在前台；应用在前台运行时会自动关闭系统锁屏，避免上传中断。
管理分享
「分享」标签页可查看分享组。每条分享下方为 2×2 图标操作区：
- 复制链接 — 写入剪贴板
- 分享 — 系统分享面板
- 上线 / 下线 — 切换分享可见性
- 删除 — 确认后永久删除（亦可左滑删除）
若本机上传时设置过访问密码，密码显示在操作区上方独立条目中，可一键复制。还支持下拉刷新列表。
成员仅能看到自己的分享；管理员可查看全部分享。
界面与显示
- 浅色模式：应用固定为浅色界面，不跟随系统深色模式（
UIUserInterfaceStyle = Light） - 前台常亮：App 处于前台时自动禁用自动锁屏，进入后台后恢复系统默认，便于大文件上传不被中断
- 键盘：输入框键盘工具栏提供「关闭」按钮
设置
- 服务器：修改并保存服务地址
- 我的资料（成员）：编辑姓名、电话、邮箱
- 账户：登录状态、角色、存储配额与进度条
- 操作：刷新账户信息、退出登录、删除账户（成员永久注销）
- 文档链接：隐私政策、使用说明、完整文档（基于当前服务器地址打开）
删除账户
- 打开「设置」标签
- 在「操作」区域点击「删除账户」
- 确认「永久删除」
将删除服务端账户、全部分享及本机钥匙串凭据，不可撤销。对应 API：DELETE /api/auth/account。
存储配额
- 新注册成员默认 50 MB 存储空间
- 配额按在线分享文件总大小计算，可在设置页查看已用/总量
- 上传超出剩余空间时服务端返回错误
- 提升配额请联系服务运营者或由管理员在 Web 后台调整
常见问题
上传失败？ 检查网络、账号/Token 是否有效、服务端是否在线、是否超出配额。直传模式需服务端对象存储密钥与 CORS 正确配置。
无法选择文件夹？ iOS 文档选择器仅支持多文件扁平选择，暂不支持保留文件夹层级。
与 Web / Mac 版区别？ 功能对齐核心上传与分享管理；Web 版支持文件夹拖拽、管理员用户管理等桌面特性；macOS 版为菜单栏应用 DocLinks，详见 Mac 使用说明。
上传时屏幕还是会锁？ 请确认 App 在前台；切到后台或锁屏后系统会恢复自动锁屏。上传大文件请保持 App 打开。
为什么不能用深色模式？ 当前版本固定浅色界面，与 Web / Mac 视觉保持一致性；后续版本可能开放跟随系统。
如何删除账户？ 见 删除账户；需服务端已部署 DELETE /api/auth/account。
隐私政策链接打不开？ 确认服务端已完成 npm run deploy，且 docs/ 已随 Worker 发布。
商业模式
本应用是连接用户自行部署 Docs 服务的免费客户端：
- 不提供、不销售任何订阅或 In-App Purchase
- 不向应用开发者上传文件；数据直连用户配置的服务器
- 存储配额由服务端运营者管理，与应用内购无关
开发者：App Store 资源
| 字段 | 建议值 |
|---|---|
| 名称 | 文链（手机端） |
| 副标题 | DocLinks 文档链接分享 |
| 支持 URL | /ios-app-guide.html |
| 隐私政策 | /privacy-policy.html |
| 仓库元数据 | ios/ShareUpload/AppStore/ |
以下页面已随服务一同部署（示例域名 docs.cn.page）：
- 隐私政策（必填）：/privacy-policy.html
- iOS 使用说明（支持 URL）：/ios-app-guide.html
- 文档中心：/index.html
- Mac 使用说明：/mac-app-guide.html
- 完整手册：/user-guide.html
商店元数据模板、审核备注与截图指南位于仓库 ios/ShareUpload/AppStore/ 目录。应用内文档链接格式为 {服务器}/{路径}，与上述路径一致。