DocLinks
官方 macOS 菜单栏客户端，已上架 App Store。App Store 名称与系统显示名称均为 DocLinks（名称中不含 “Mac”）。iOS 对应客户端 App Store 名称为 文链（手机端）。两平台共用同一套 API。本应用免费、无内购、无订阅。
命名规范
| 字段 | macOS 本应用 | iOS 客户端 |
|---|---|---|
| App Store 名称 | DocLinks | 文链（手机端） |
| Bundle ID | com.chengyusheng.doclinks-mac | com.chengyusheng.docsshare.upload |
| 当前版本 | 1.0.1（已上架） | 1.0.2 |
| 说明文档 | 本页 | ios-app-guide.html |
应用概述
- 平台：macOS 14.0+（macOS 26 Tahoe 上为 Liquid Glass 界面）
- Bundle ID：
com.chengyusheng.doclinks-mac - App Store 名称：DocLinks（名称中不含 “Mac”，符合审核要求）
- 形态：菜单栏应用（
LSUIElement），无 Dock 图标 - 后端：与 Web 版
/files及 iOS「文链（手机端）」客户端共用 API - 鉴权：用户注册/登录，或 Admin Token；凭据存于系统钥匙串
- 界面：弹出面板内切换「上传 / 已上传 / 设置」
使用条件
- 已部署 Docs 托管服务（参见 使用文档）
- 服务端已执行数据库迁移（含
0009–0012） - 拥有成员账号（可自助注册）或 Admin Token
- 大文件直传建议已配置对象存储 API 密钥（可选）
菜单栏使用
- 从「应用程序」或启动台打开「DocLinks」
- 在屏幕右上角菜单栏找到链接圆圈图标（
link.circle.fill） - 点击图标：打开上传面板
- 再次点击图标：关闭面板（点击面板外区域不会自动关闭）
- 面板工具栏提供「退出」以结束应用
登录
- 点击菜单栏图标打开面板
- 输入服务器地址（默认
https://docs.cn.page） - 选择「用户登录」「注册」或「管理员」
- 成员：输入用户名与密码；管理员：输入 Admin Token
- 登录成功后面板顶部出现「上传 / 已上传 / 设置」分段控件
上传文件
- 在「上传」标签点击「选择文件」
- 通过系统文件选择器选取一个或多个文件
- 填写分享备注、访问密码（可选，可随机生成）、有效期
- 点击「开始上传」，等待进度完成
- 成功后可复制分享链接；若设置了密码，密码会保存在本机钥匙串供「已上传」页复制
限制：单次最多 500 个文件，总大小 50 GB（与服务端一致）。超大文件建议保持面板打开直至完成。
已上传管理
「已上传」标签可查看分享组。每条分享下方为 2×2 图标操作区（与 iOS 共用界面）：复制链接、系统分享、上线/下线、删除。若本机上传时设置过密码，可在上方密码条目中复制。
另支持工具栏刷新、左滑/确认删除。成员仅能看到自己的分享；管理员可查看全部分享。
设置
- 服务器：修改并保存服务地址
- 我的资料（成员）：编辑姓名、电话、邮箱
- 账户：登录状态、角色、存储配额与进度条
- 操作：刷新账户信息、退出登录、删除账户
- 帮助与文档：隐私政策、使用说明、完整文档（基于当前服务器地址打开）
删除账户
成员账号可在应用内永久删除（App Store 要求）。管理员 Token 登录不支持此操作。
- 打开面板 →「设置」→「操作」
- 点击「删除账户」
- 在确认对话框中选择「永久删除」
删除后将：
- 清除服务端账户与会话（
DELETE /api/auth/account） - 删除该用户全部分享及对象存储中的文件
- 清除本机钥匙串中的登录凭据
存储配额
- 新注册成员默认 50 MB 存储空间（由服务端配置）
- 配额按在线分享文件总大小计算，可在设置页查看已用/总量
- 上传超出剩余空间时服务端返回错误
- 提升配额请联系服务运营者或管理员在 Web 管理台调整
常见问题
找不到菜单栏图标？ 确认应用已从启动台打开；检查菜单栏右侧或控制中心旁；重启应用后再试。
备注或密码无法输入？ 请先点击面板内输入框获取焦点；确保使用最新版本。
已上传页看不到密码？ 服务端仅存密码哈希；仅在本机上传时保存的密码可显示与复制，Web 端创建的加密分享无法还原明文。
与 iOS 版区别？ Mac 为菜单栏形态，App Store 名 DocLinks；iOS 为全屏三标签，App Store 名 文链（手机端）。核心 API 一致。
如何删除账户？ 见上文 删除账户。
隐私政策打不开？ 确认服务端已 npm run deploy，且 docs/ 已随 Worker 发布。
商业模式
DocLinks 是连接用户自行部署 Docs 服务的免费 macOS 客户端：
- 不提供、不销售任何订阅或 In-App Purchase
- 不向应用开发者上传文件；数据直连用户配置的服务器
- 存储配额由服务端运营者管理，与应用内购无关
开发者：App Store 资源
| 字段 | 建议值 |
|---|---|
| 名称 | DocLinks |
| 副标题 | DocLinks 文档链接分享 |
| 支持 URL | /mac-app-guide.html |
| 隐私政策 | /privacy-policy.html |
| 仓库元数据 | mac/DocLinksMac/AppStore/ |
以下页面已随服务一同部署（示例域名 docs.cn.page）：
- 隐私政策（必填）：/privacy-policy.html
- Mac 使用说明（支持 URL）：/mac-app-guide.html
- 文档中心：/index.html
- iOS 使用说明：/ios-app-guide.html
Mac 商店元数据、审核回复模板与截图指南位于仓库 mac/DocLinksMac/AppStore/。Bundle ID 保持 com.chengyusheng.doclinks-mac 不变。iOS 对应客户端 App Store 名称为 文链（手机端），详见 iOS 使用说明。