Sjtu

上海交通大学·水源社区 ClaWHub Skill

水源社区（shuiyuan.sjtu.edu.cn）是上海交通大学基于 Discourse 搭建的校园论坛，
本 Skill 提供常用功能的渐进式操作指引。

---

🔰 Level 1 — 基础浏览（零门槛）

1.1 话题列表浏览

1.2 话题信息一览

每条话题显示以下关键信息：

• 标题 — 帖子主题，支持 Emoji
• 分类标签 — 彩色标签标识所属板块（如 🔴 读笑风生、🟢 游戏竞技、🔵 校园生活）
• 作者头像 — 发帖人及最近回复者头像
• 回复数 — 帖子回复总数
• 浏览量 — 帖子被浏览次数（支持 k 单位缩写，如 1.1k、17.8k）
• 最后活跃时间 — 距今多久有新回复（如 24 分钟、1 分钟、2 小时）

1.3 热门话题侧栏

页面右侧展示「热门话题」列表，快速了解社区当前最受关注的讨论：

• 显示话题标题 + 分类标签 + 活跃时间
• 涵盖校园服务、读笑风生、热点新闻、心情驿站等多个板块

---

🔧 Level 2 — 互动参与（需登录）

2.1 新建话题

点击右上角 「+ 新建话题」 按钮：

1. 选择分类板块
2. 添加标签（可选）
3. 编写标题和正文（支持 Markdown / 富文本）
4. 发布

2.2 回复与互动

• 回复帖子 — 在话题底部输入回复内容
• 点赞 — 对优质回复点赞
• 引用回复 — 选中文字后引用回复
• @提及 — 使用 @用户名 提及其他用户

2.3 个人中心

左侧导航栏提供：

2.4 未读与新帖追踪

• 未读 (126) — 显示未读话题数量，点击快速查看
• 新 (163) — 显示新发布的话题数量
• 顶部提示栏：「查看 3 个新的或更新的话题」，点击即可刷新

---

⚙️ Level 3 — 进阶功能

3.1 话题筛选与排序

支持多维度组合筛选：

类别 × 标签 × 排序方式（最新/热门/精品）

话题列表上方 Tab 栏：

• 话题 | 回复 | 浏览 | 活动 — 可按列排序

3.2 搜索功能

点击顶部 🔍 搜索图标：

• 支持全文搜索（标题 + 正文）
• 支持按分类、标签、作者、时间范围过滤
• 支持搜索语法（Discourse 高级搜索）

3.3 通知系统

顶部导航栏图标（右上角）：

• 🔔 通知 — 回复提醒、@提及、点赞通知
• ✉️ 私信 — 站内私信
• 🔖 书签 — 收藏的话题
• 👤 个人资料 — 账号设置

3.4 站务与活动

左侧导航特殊板块：

• 站务公告 — 社区官方公告、规则说明
• 水源活动 — 社区组织的线上/线下活动
• 所有类别 — 查看完整分类树
• 精品 — 社区精选内容
• 所有标签 — 查看所有可用标签

---

🔬 Level 4 — 高级 / 技术细节

4.1 技术栈

水源社区基于 Discourse 开源论坛平台：

• 版本: Discourse v2026.2.0-latest
• 前端框架: Ember v6.6.0
• 域名: shuiyuan.sjtu.edu.cn
• 协议: HTTPS

4.2 Cookie 与会话

4.3 浏览器 API 与后台服务

Storage 类型：

• Local storage / Session storage / IndexedDB / Cookies
• Cache storage / Storage buckets

Background services：

• Back/forward cache — 前进后退缓存
• Background fetch / Background sync — 后台数据同步
• Bounce tracking mitigations — 跳转追踪缓解
• Notifications — 推送通知
• Payment handler / Periodic background sync
• Push messaging — 推送消息
• Reporting API — 上报接口
• Device bound sessions — 设备绑定会话

4.4 Discourse API 常用端点

GET  /latest.json          — 获取最新话题列表
GET  /top.json             — 获取热门话题
GET  /categories.json      — 获取所有分类
GET  /t/{id}.json          — 获取单个话题详情
GET  /search.json?q=关键词  — 搜索
POST /posts.json           — 创建新帖子
GET  /notifications.json   — 获取通知
GET  /u/{username}.json    — 获取用户信息

---

📋 快速参考卡片

┌─────────────────────────────────────────────────┐
│          水源社区 · 快速操作速查                    │
├─────────────────────────────────────────────────┤
│  浏览话题    →  首页 / 最新 / 热门 / 精品          │
│  筛选话题    →  类别 Tab / 标签 Tab               │
│  发新帖      →  右上角「+ 新建话题」               │
│  搜索        →  顶部 🔍 图标                      │
│  查看通知    →  右上角铃铛图标                      │
│  个人中心    →  左侧「我的子」/「浏览记录」          │
│  未读消息    →  顶部「未读 (N)」Tab                │
│  站务公告    →  左侧导航「站务公告」                │
│  社区活动    →  左侧导航「水源活动」                │
└─────────────────────────────────────────────────┘

---

渐进式披露设计说明：

• Level 1（基础浏览）：无需登录即可使用，适合新用户快速上手
• Level 2（互动参与）：需要 jAccount 登录，解锁发帖、回复等社交功能
• Level 3（进阶功能）：面向活跃用户，掌握高效筛选、搜索和通知管理
• Level 4（技术细节）：面向开发者/高级用户，了解底层技术栈和 API 接口