法务文档

本页汇总拼好歌（phgmusic）的正式法务文本。各平台客户端与服务端管理后台统一适用同一份文本，客户端内、后台内展示内容均以本页为准。

文档清单

文档	版本	生效日期	地址
用户协议	1.1.0	2026-10-22	`/legal/terms`
隐私政策	1.1.0	2026-10-22	`/legal/privacy`

两份文档共同构成完整约定，应一并阅读、一并同意。

签署方式：一次勾选，两份文档

用户协议与隐私政策是两份独立文档（隐私政策需要独立的可访问地址，便于监管与应用商店审核），但签署只做一次：

☐ 我已阅读并同意《用户协议》与《隐私政策》，理解并自愿承担使用本软件的相应责任与风险。

一个弹窗、一个勾选框，两个书名号是链接，点开分别查看全文；
不弹两个窗口，也不需要签两次；
同意记录绑定 agreementVersion（两份文档版本的组合），任一文档版本变化后重新要求同意。

客户端建议逻辑

启动时请求 /legal/agreement.json，读取 agreementVersion 与两份文档的 version；
本地保存用户已同意的 agreementVersion；
版本不一致时弹出签署弹窗（单勾选框 + 两个链接），勾选后写入新的 agreementVersion；
请求失败时使用本地内置文本，不阻塞启动；
弹窗内提供「查看全文」入口，保证协议随时可查阅。

服务端管理后台建议逻辑

与客户端一致，区别在于同意记录落在服务端：

管理员账号首次登录时，服务端返回 428（密码正确、但该账号尚未同意当前版本），不签发会话令牌；
前端弹出协议门，无关闭入口，倒计时结束后才可勾选；
同意接口在服务端校验阅读时长与版本，通过后写入「账号 × agreementVersion × 同意时间 × 阅读时长」，作为已履行告知义务的凭证；
协议版本变更后，该账号重新进入未同意状态。

供客户端读取的机器可读版本

1. 聚合入口（推荐）

文档	JSON 地址
协议聚合	`/legal/agreement.json`

json

{
  "agreementVersion": "2026.10.22",
  "consentMode": "single-checkbox",
  "consentText": "我已阅读并同意《用户协议》与《隐私政策》…",
  "reconsentTrigger": "any-document-version-change",
  "documents": [
    { "key": "terms", "name": "用户协议", "version": "1.1.0", "effectiveDate": "2026-10-22", "url": "…/legal/terms", "json": "…/legal/terms.json" },
    { "key": "privacy", "name": "隐私政策", "version": "1.1.0", "effectiveDate": "2026-10-22", "url": "…/legal/privacy", "json": "…/legal/privacy.json" }
  ],
  "contactUrl": "…/contact"
}

读一个文件即可拿到两份文档的版本与地址，agreementVersion 直接作为本地保存的同意凭据。

2. 单文档（兼容旧逻辑）

文档	JSON 地址
用户协议	`/legal/terms.json`
隐私政策	`/legal/privacy.json`

json

{
  "document": "用户协议",
  "version": "1.1.0",
  "effectiveDate": "2026-10-22",
  "url": "https://<你的域名>/legal/terms",
  "language": "zh-CN"
}

修订流程

修改对应页面正文；
更新页面顶部的版本号与生效日期；
同步更新 terms.json / privacy.json / agreement.json 三处版本号；
在更新日志记录变更。

版本号采用 主版本.次版本.修订号。涉及权利义务实质变化的，递增主版本；仅文字修订的，递增修订号。

法务文档 ​

文档清单 ​

签署方式：一次勾选，两份文档 ​

客户端建议逻辑 ​

服务端管理后台建议逻辑 ​

供客户端读取的机器可读版本 ​

1. 聚合入口（推荐） ​

2. 单文档（兼容旧逻辑） ​

修订流程 ​

相关页面 ​