From 91a890428f9d057ad88ea5f8868cbdea99534a32 Mon Sep 17 00:00:00 2001 From: wangjia <809946525@qq.com> Date: Thu, 2 Jul 2026 12:23:02 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=81=94=E7=B3=BB=E6=88=91=E4=BB=AC?= =?UTF-8?q?=E6=B8=A0=E9=81=93=E4=BA=8C=E7=BA=A7=E9=A1=B5=E4=BA=A4=E4=BA=92?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1(Telegram/LINE=20=E5=A4=9A=E9=A2=91=E9=81=93?= =?UTF-8?q?=E7=BE=A4=E7=BB=84,DB=20=E9=85=8D=E7=BD=AE)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 点渠道进二级页,按 kind 分组(频道/群组/Bot)列多条链接,内容 DB 配置。 含可点原型(App 真实暗色 token)+ 单表 contact_link 数据模型 + GET /v1/contact 接口 + 交互规则(平台 >1 条链接才进二级,否则点击直达)。#24,待统一后开发。 Co-Authored-By: Claude Opus 4.8 --- docs/contact-telegram-channels-design.html | 316 +++++++++++++++++++++ docs/index.html | 5 + 2 files changed, 321 insertions(+) create mode 100644 docs/contact-telegram-channels-design.html diff --git a/docs/contact-telegram-channels-design.html b/docs/contact-telegram-channels-design.html new file mode 100644 index 0000000..8e0d4f7 --- /dev/null +++ b/docs/contact-telegram-channels-design.html @@ -0,0 +1,316 @@ + + + + + +联系我们：渠道二级页（Telegram 频道/群组，DB 配置）· 交互设计 + + + +
+← 返回文档索引 + +

联系我们 · 渠道二级页

+

交互设计 · Telegram/LINE 多频道 · 群组 · 内容 DB 配置 · 前端 + 后端 + 数据库

+ +
+现「联系我们」把每个渠道当单一入口（Telegram 只挂一个 @PangolinVPN_bot）。 +需求：点 Telegram 进入二级页，列出该平台下的多个频道 / 群组 / Bot， +每项含名称、@handle、一句说明、可选成员数、认证标记与「打开 / 加入」动作， +全部由数据库配置（运营可随时增删改，客户端不写死）。本页给出交互原型 + 数据模型 + 接口，待你统一后再开发。 +
+ +

可点原型（点 Telegram 卡片进二级，← 返回）

+

下方为内嵌可交互原型，配色用 App 真实暗色 token（clay/espresso）。点 Telegram 或 LINE 卡进详情；「邮箱客服 / 自助发卡商店」为单链接，点即直接打开（原型里仅提示）。

+ +
+ +
+
穿山甲PANGOLIN
+
⏻连接
+
🌐节点
+
📊统计
+
⚙设置
+
💬联系我们
+
+ +
+
+ 联系我们 + US🌙 +
+ + +
+

遇到问题？通过以下任一渠道联系我们，通常数分钟内回复。

+ +
+
✈
+
Telegram
官方频道 · 交流群 · 客服 Bot
+ › +
+ +
+
💬
+
LINE
官方账号 · 中文/日文群
+ › +
+ +
+
✉
+
邮箱客服
support@pangolin.vpn
+ › +
+ +
+
🛍
+
自助发卡商店
shop.pangolin.vpn
+ › +
+
+ + +
+
‹ 返回
+
+
✈
+
Telegram
加入官方频道获取更新，进群与用户互助
+
+ +
频道 · CHANNELS
+
+
📣
+
穿山甲 · 官方频道 ✔
产品更新与公告 · @PangolinVPN
+ 👥 12.3k + +
+
+
📶
+
穿山甲 · 节点状态
节点/故障实时播报 · @PangolinStatus
+ 👥 3.1k + +
+ +
群组 · GROUPS
+
+
👥
+
穿山甲 · 用户交流群
使用问题互助交流 · @PangolinChat
+ 👥 8.7k + +
+
+
🌏
+
Pangolin · English Group
English support & chat · @PangolinEN
+ 👥 1.2k + +
+ +
客服机器人 · BOT
+
+
🤖
+
客服机器人
自动答疑 / 提交工单 · @PangolinVPN_bot
+ +
+
+ + +
+
‹ 返回
+
+
💬
+
LINE
官方账号与交流群
+
+
官方账号 · OFFICIAL
+
+
💬
+
Pangolin 官方账号 ✔
公告与客服 · @pangolinvpn
+ +
+
群组 · GROUPS
+
+
👥
+
中文交流群
使用互助 · openchat
+ +
+
+
+
+
+ + + +
+

同一原型内切换三态 · 真机为路由 push（移动端整页）/ 内容区替换（桌面）

+ +

交互规则

+ + +

数据模型（DB 配置）

+

单表承载 L1 平台入口与 L2 子项：一行 = 一条可点链接。L1 由 platform 聚合而来，二级由 kind 分组。

+
contact_link
+─────────────────────────────────────────────────────────────
+id           INTEGER  PK
+platform     TEXT     -- telegram | line | email | store | ...(L1 分组键)
+kind         TEXT     -- channel | group | bot | link(L2 分组键 & 动作样式)
+title        TEXT     -- "穿山甲 · 官方频道"
+handle       TEXT     -- "@PangolinVPN"（展示；可空）
+url          TEXT     -- "https://t.me/PangolinVPN"（点击目标；App 侧优先转 tg://）
+description  TEXT     -- 一句说明（可空）
+member_hint  TEXT     -- "12.3k"（纯展示缓存，可空；不实时拉）
+verified     INTEGER  -- 0/1 认证勾
+sort_order   INTEGER  -- 组内排序
+enabled      INTEGER  -- 0/1 下线开关
+locale       TEXT     -- "zh"|"en"|NULL(全部)  可选按语言过滤
+
+

L1 平台的图标 / 显示名 / 强调色由前端按 platform 枚举内置（Telegram=✈+强调、LINE=💬…）， +不入库，避免图标资源塞数据库。库里只配内容。单链接平台（email/store）建议各配 1 行 kind=link。

+ +

接口

+
GET /v1/contact            # 无需登录亦可（客户端普通请求）
+→ 200
+{
+  "platforms": [
+    { "platform":"telegram",
+      "links":[
+        {"kind":"channel","title":"穿山甲 · 官方频道","handle":"@PangolinVPN",
+         "url":"https://t.me/PangolinVPN","description":"产品更新与公告",
+         "member_hint":"12.3k","verified":true},
+        {"kind":"group","title":"穿山甲 · 用户交流群","handle":"@PangolinChat",
+         "url":"https://t.me/PangolinChat","description":"使用问题互助","member_hint":"8.7k"},
+        {"kind":"bot","title":"客服机器人","handle":"@PangolinVPN_bot",
+         "url":"https://t.me/PangolinVPN_bot","description":"自动答疑/提交工单"}
+      ]},
+    { "platform":"line",  "links":[ ... ] },
+    { "platform":"email", "links":[{"kind":"link","title":"邮箱客服","url":"mailto:support@pangolin.vpn"}] },
+    { "platform":"store", "links":[{"kind":"link","title":"自助发卡商店","url":"https://shop.pangolin.vpn"}] }
+  ]
+}
+ + +

待你拍板

+ + +
+ + + diff --git a/docs/index.html b/docs/index.html index 30fb1ae..ffce753 100644 --- a/docs/index.html +++ b/docs/index.html @@ -44,6 +44,11 @@

设计方案 / Specs

+ +
联系我们 · 渠道二级页（Telegram 频道/群组，DB 配置）HTML
+
点 Telegram/LINE 进二级页，按 kind 分组（频道/群组/Bot）列出多条链接，含 @handle/说明/成员数/认证/「打开·加入」动作，全部 DB 配置。含可点原型 + 单表 contact_link 数据模型 + GET /v1/contact 接口。规则：平台 >1 条链接才进二级，否则点击直达。
+
docs/contact-telegram-channels-design.html
+
免费版 10 分钟卡控 + 累加式看广告加时 HTML
免费版真卡控（账户级/全设备共享）：连接期倒计时 + 到点自动切断 + 耗尽按钮灰化 + 点击弹广告看完 +10 分钟（累加，每日封顶 120）。桌面硬 10 分钟不可延。服务端 ad_bonus_minutes 累加模型 + ConnectNode 按 remaining 卡控 + TTL 硬切断；占位 DevVerifier。#21。