Skip to content
learningdog1Public

About

Anode — 面向 NodeSeek 社区的原生 Jetpack Compose / Material 3 Expressive Android 客户端,内置脉搏雷达监控、VPS 剩余价值折算器与 Seek 邮箱客户端

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Anode Logo

Anode

Cool Mist Light & Slate Steel Telemetry
面向 NodeSeek 主机与开发者社区的原生 Jetpack Compose / Material 3 Expressive Android 客户端

Release Platform Kotlin Compose License

📥 下载安装 · 🎨 三态视觉主题 · ✨ 全页面功能图鉴 · 🏗️ 工程架构 · 🛠️ 构建与测试


📥 下载与安装 · Download & Install

Tip

前往 GitHub Releases (v2.0.0) 下载已签名正式版 APK(Anode-v2.0.0-release.apk),下载后可直接在 Android 设备安装(后续亦可在应用内检查与升级)。

项目 说明
应用名称 / 包名 Anode(com.nodeseek.app)
当前版本 v2.0.0(versionCode = 5)
系统要求 Android 8.0 及以上(minSdk = 26 · targetSdk = 35)
核心模块一览 极简脉冲首页与全版块文字频道栏 · 独立全站统一搜索 · 杂志级帖子阅读器(ANSI / 多标签页 / 表情贴纸) · Markdown 发帖与 NodeImage 上传 · 13 币种 VPS 估值折算器 · 底部主栏直达隔离式 Seek 邮箱 (seek.li) 与页内密钥管理 · 个人中心与一行签到/分组入口 · 统一信息流卡片的收藏、足迹与个人空间 · 聚合收件箱与实时私信 · 本地脉搏雷达监控 · 分组卡片式设置与 GitHub Releases 应用内更新

🎨 三态视觉主题同屏对比 · Themes & Design Philosophy

Anode 将日间技术杂志的舒朗通透感与夜间机房遥测面板的锐利对比融于同一套 Material 3 Expressive 自适应色彩引擎:

  • 清雾冰蓝浅色 (Cool Mist Light):清透冰蓝雾白画布(#F7FAFF)搭配纯白底板(#FFFFFF)、细密边框(#C0C7CD)与沉稳青钢蓝主色(#2D637E / 容器 #CDE7FB),清爽护眼、层次分明。
  • 深岩钢蓝深色 (Slate Steel Dark):低辉度岩灰暗色画布(#101417)与板岩容器(#1C2024),配合澄澈天青蓝(#9ACAEC / 容器 #114B66)高对比点缀。
  • 纯净极黑省电 (Pure Pitch AMOLED):支持纯黑 #000000 画布与低功耗深碳容器(#14181B),专为 OLED 屏幕优化夜间阅读对比度。
  • Material You 壁纸动态取色与默认 90% 紧凑排版:默认关闭动态取色以呈现标志性的清雾浅色 / 深岩深色主题(支持在设置中一键开启 Android 12+ Material You 壁纸动态取色);全局默认字号与排版缩放调优为 90%(支持 85%–130% 自由调节)。开启壁纸动态取色时,毛玻璃顶栏、卡片描边、发帖 悬浮按钮、顶部光晕与底栏指示器同步随壁纸色板联动;内置 15 套版块语义色系、Lv.0–Lv.6 宝石/金属等级光环(精确按 coins >= 100 × Lv² 换算)与 Drumstick Amber (🍗) 鸡腿激励体系。
☀️ 清雾浅色 · Cool Mist Light 🌙 深岩深色 · Slate Steel Dark 🖤 纯黑省电 · Pure Pitch AMOLED
Explore Paper Light Explore Obsidian Dark Explore Pure Pitch AMOLED
🌿 绿色壁纸 · 动态取色浅色 🌺 红色壁纸 · 动态取色深色 🍀 个人中心 · 动态取色联动
Material You Dynamic Green Explore Light Material You Dynamic Red Explore Dark Material You Dynamic Green Hub Light

✨ 核心功能与全页面图鉴 · Feature & Screen Walkthrough

1. 脉冲首页与悬浮药丸导航 (Explore & Navigation Shell)

  • 极简毛玻璃顶栏与全版块轨道:左上角保留 Anode 品牌徽标,右侧收敛为搜索图标按钮与极简排序选择器(新评论 ▾ / 新帖子 / 热门 / 推荐阅读);第二行为无框极简文字频道条(全部 + 技术 / 测评 / 情报 / 交易 / 日常 / Dev 及全站所有非管理员版块),与下方 HorizontalPager 1:1 丝滑联动。
  • 高密度通透信息流:
    • CollapsiblePinnedTicker:轻量化透明线框置顶公告条,默认折叠,一键展开查看全站置顶。
    • PulseTopicCard:剔除厚重卡片底色与左侧竖条,采用通透圆角线框卡片并优化垂直排布密度(单屏可完整浏览 5+ 篇主题);版块标识以无底色语义小圆点 + 文字置于卡片右下角,已读/未读通过字重与墨色清晰区分,并支持 读至 #N 楼 续读标签、热帖火焰徽章与一键收藏。
    • RSS 快速降级通道:未登录或触发临时安全校验时自动切换 RSS 快速预览,保证随时可读。
  • 单手拇指区交互:悬浮毛玻璃药丸底栏改为 首页 / 邮箱 / 我的,配以弹性渐隐 Squircle 发帖 FAB。

2. 全站统一搜索与离线收藏足迹 (Unified Search & Offline Collections)

🔍 帖子 / 成员统一搜索与 Google 兜底 🔖 离线收藏快照与楼层续读足迹
Unified Search Collections and Read History
  • 全站统一搜索 (SearchRoute):点击首页右上角搜索图标直达独立全站搜索页,支持按 找帖子(含分类/排序筛选与分页加载)与 找用户(@username)检索,自动持久化最近搜索标签,并在底部提供 1 键 Google site:www.nodeseek.com 站外搜索 卡片。
  • 离线收藏与阅读足迹 (HubCollectionScreen):从“我的”页面直达独立的「收藏与足迹」二级页,与首页统一采用 PulseTopicCard 通透线框帖子卡片设计;集中管理云端与 Room 本地离线快照收藏(支持无网离线阅读与一键取消收藏),并在浏览历史中完整保留版块分类标签与 读至 #N 楼 续读标签,支持一键续读、收藏与清空记录。

3. 杂志级帖子阅读器与表情回复工作台 (Topic Reader & Reply Composer)

📖 杂志级排版 · ANSI 跑分 · 多标签卡 💬 引用回复 · 实时预览 · 社区贴纸库
Topic Detail Reader Reply Composer and Stickers
  • 原生 Compose MarkdownRenderer:
    • ANSI SGR 终端彩色代码块:原生解析 \u001B[...m 控制符,高保真渲染 YABS、NextTrace、Geekbench 等 VPS 测速脚本输出,支持一键复制源码。
    • 交互式多标签页 (:::: tabs / ::: tab-item):长篇评测内的「YABS 跑分 / 三网回程 / 流媒体解锁」可在卡片内直接切换。
    • 完整 GFM 与社区语法:支持横向滚动表格、Electric Cobalt 引用块、任务列表、可点击 @用户 / #楼层 跳转芯片、/jump?to= 外链安全解包、双指缩放灯箱看图(Coil 3 + Referer 策略),以及官方 :ac01: / :yct001: / :xhj001: 动态与静态贴纸集。
  • 阅读与互动人体工学:支持 只看楼主、倒序浏览、长按自由划词复制、楼层 🍗 加鸡腿 / 👍 点赞 / 👎 踩(含消耗确认弹窗与实时余额同步)、右侧可拖拽震动楼层滑块 (RightEdgeFloorScrubber) 与跳楼弹窗。
  • 回复工作台 (ReplyComposerBottomSheet):支持引用任意楼层 @user #N、本地草稿自动保存、编辑 / 预览 双栏切换、官方贴纸面板、NodeImage 图床直传以及一键调用 VPS 估值器插入回复。

4. Markdown 发帖编辑器与 VPS 剩余价值估值器 (Topic Composer & VPS Valuation)

✍️ 全功能 Markdown 发帖与编辑 🧮 13 币种 VPS 剩余价值与交易折算
Topic Composer VPS Valuation Bottom Sheet
  • 发帖 / 改帖编辑器 (TopicComposerScreen):
    • 版块选择器(自动过滤管理员版块并明确提示 inside 消耗 5 🍗),阅读权限分级选择器(Lv.0 公开 ~ Lv.6+ 及 Lv.255 私有帖)。
    • 快捷工具栏覆盖标题、粗斜体、代码块、引用、表格、:::: tabs 测评模板、贴纸面板、相册/文件图片上传(api.nodeimage.com)与草稿恢复。
  • VPS 剩余价值折算器 (VpsValuationBottomSheet):
    • 高精度 BigDecimal 算力引擎:支持 13 种主流货币(CNY / USD / EUR / GBP / HKD / JPY / CAD / AUD / SGD / CHF / KRW / TRY / BRL),自动同步 Frankfurter 实时汇率(24 小时本地缓存 + 离线兜底 + 单币种手动覆写)。
    • 自然周期与闰年感知:支持固定天数(月/季/半年/年/自定义)与自然日历周期(精确识别 365 / 366 闰年天数及 Asia/Shanghai 精确到时分计算)。
    • 二手交易与费用分摊:支持出让挂牌价溢价/折价实时遥测标签、Push 过户费及中介费分摊(买家/卖家/各半平摊),一键生成精简摘要卡或三栏核算表 Markdown 直接插入发帖或回帖光标处。

5. 个人中心与每日签到手气榜 (Personal Hub & Check-In Leaderboard)

👤 个人中心 · 一行签到 · 设置式分组 🏆 每日签到手气榜与领奖台
Personal Hub Check-In Leaderboard
  • 个人中心 (PulseHubScreen):
    • 个人信息 Hero 卡:保留主题渐变光效与等级经验进度条,精简展示等级 / UID / TG 绑定状态与底部 4 列数据统计(鸡腿 / 星尘 / 主题 / 评论);未登录时支持官方 WebView 安全登录或原生凭据登录。
    • 一行紧凑签到条 (CompactCheckInCard):单行展示今日签到名次、鸡腿收益及发帖/回帖/加腿额度进度,未签到时支持原地切换 固定 +5 / 试试手气 并一键签到,已签到直接查看「签到榜」。
    • 设置式分组列表:清晰划分为 「消息」(通知 / 私信 / 关键词提醒,各自独立角标计数)与 「内容」(我的收藏 / 浏览记录 / 我的帖子),点按即可直达独立二级页面。
  • 签到榜 (CheckInBoardScreen):可视化前三甲领奖台、全站签到排名与自己的当日名次及手气收益。

6. 聚合收件箱、站内私信与用户空间 (Inbox · Direct Messages · User Profile)

🔔 聚合收件箱 (回复 / @我 / 私信) 💭 站内私信实时对话 👤 用户空间与 README 档案
Inbox Notifications Direct Messages User Profile
  • 3 分栏收件箱 (InboxScreen):集成 回复我、@我、私信 三个实时分栏,支持一键全部已读、精准跳转原帖对应楼层,并内置通往 脉搏雷达 与 Seek 邮箱 的状态快链。
  • 站内私信对话 (DirectMessageScreen):支持 Markdown 渲染、系统通知识别、自动保存私信草稿与前台静默轮询刷新。
  • 用户空间 (UserProfileScreen):展示会员等级徽章、鸡腿/星尘数据、个人签名与 Markdown README,支持关注/取关、发私信、加入/移出屏蔽名单,查看 TA 发布的主题(同步统一为首页同款 PulseTopicCard 通透线框帖子卡片形式)与历史回复;浏览本人空间时可直接编辑个人资料。

7. 脉搏雷达:本地关键词/正则监控与帖子追更 (Pulse Radar)

📡 命中警报流与系统通知诊断 ⚙️ 多版块关键词与正则表达式规则
Pulse Radar Alerts Pulse Radar Rules
  • 本地规则引擎 (PulseRadarScreen):
    • 支持新增「包含关键词」或「正则表达式 (REGEX)」监控规则,可按指定版块(如 trade / info)过滤并配置英文逗号分隔的排除词(如过滤 求购,收),避免求购贴误报。
    • 任意帖子阅读页顶栏可一键开启「追更」,新楼层产生时记录提醒并直达目标楼层。
  • 可调巡检与免打扰策略:内置环境诊断横幅(通知权限、电池优化白名单、系统勿扰检测),可分别配置前台轮询(1–30 分钟)、后台轮询(3–60 分钟)、仅 Wi-Fi 后台巡检及夜间免打扰时段(默认 23:00–07:00),无论是否登录均可依赖 RSS + Web 双通道工作。

8. Seek 邮箱:独立安全 seek.li 客户端 (Seek Mail)

📬 多别名收件箱与 OTP 验证码自动提取 🛡️ 隐私隔离阅读器与安全遥测
Seek Mail Inbox Seek Mail Reader
  • 底部主栏直达、页内密钥闭环与会话隔离 (SeekMailApiClient):Seek 邮箱作为底部导航栏中间主标签(首页 / 邮箱 / 我的),点按即刻进入收件箱(打开邮件详情时自动收起底栏以获得全屏阅读体验);顶栏内置独立的 API Key 密钥管理弹窗(支持连通性验证、保存与断开密钥),闭环管理无需跳转设置。网络层基于 https://seek.li/openapi/v1 构建,强制启用 CookieJar.NO_COOKIES、禁用跨站重定向、严格校验请求 Origin,与 NodeSeek 主站会话彻底隔离——即使不登录社区也能独立使用邮箱。
  • 多邮箱与别名管理:支持全部收件箱与各独立别名(如 @seek.li / @nodeseek.org)切换、一键复制地址、检查可用性并创建新别名、标签过滤、关键字搜索与联系人目录。
  • 智能验证码提取 (VerificationCodeExtractor):自动识别中英文验证码邮件并在列表与详情页高亮显示验证码徽章,一键复制即可填入登录验证。
  • 零追踪隐私阅读器 (SeekMailWebView):经 Jsoup 白名单消毒的邮件渲染器,严格禁用 JavaScript、文件访问与第三方 Cookie,默认拦截远程追踪图片(支持按封手动放行),自动适配 Paper Light / Obsidian Dark / Pure Pitch AMOLED 与字体缩放,支持切换 HTML 视图 / 纯文本 / 原始源码 (.eml),并提供 SPF · DKIM · DMARC 验证遥测与附件 SAF 导出下载。

9. 个性化设置与设计系统 (Settings & Design System)

⚙️ 分组卡片式设置中心 🎨 设计系统组件与遥测图鉴
Settings Screen Design System Components
  • 设置中心 (SettingsScreen):重构为与「我的」个人中心协调一致的圆角分组列表卡片与 30.dp 图标视觉规范,支持切换 跟随系统 / 清雾浅色 / 深岩深色、Pure Pitch #000000 AMOLED、Material You 动态取色、全局字号与排版缩放(默认 90%,支持 85% / 90% / 100% / 115% 快捷档位与连续调节)、保底 +5 / 手气随机 签到偏好、NodeImage 图床 API Key 模态配置与连通性测试、脉搏雷达轮询与免打扰设置、屏蔽用户管理、图片/浏览记录缓存清理,以及基于 GitHub Releases 的应用内版本检查、预发布通道开关与在线升级(剔除与邮箱页重复的 Seek Mail 配置项)。

🏗️ 工程架构 · Architecture

Anode 采用清晰的单向多层架构(ui → domain ← data),通过轻量级构造器依赖注入(AppContainer / DefaultAppContainer)连接全部领域仓库与本地控制器:

flowchart TD
    UI["UI Layer (Jetpack Compose + ViewModels)<br/>theme · components · explore · boards · topic · composer · hub · mail · radar · valuation · update"]
    NAV["Navigation Shell<br/>MainActivity · NavHost · UrlRouter · AppDestination"]
    DOMAIN["Domain Layer (Pure Kotlin Contracts & Models)<br/>Forum · Session · CheckIn · Inbox · User · Bookmark · Settings · Draft · ImageHost · SeekMail · Radar · Valuation · Update"]
    DATA["Data Layer<br/>Repositories · NodeSeekApiClient & SeekMailApiClient & GitHubReleaseClient (OkHttp) · Jsoup/RSS Parsers · Room DB · DataStore · Disk Cache"]

    NAV --> UI
    UI --> DOMAIN
    DATA --> DOMAIN
Loading

Package Layout

app/src/main/java/com/nodeseek/app/
├── MainActivity.kt                  # Edge-to-edge 宿主与 nodeseek.com 深度链接解析
├── di/                              # 领域仓库 CompositionLocal 契约与依赖图装配
├── navigation/                      # Kotlinx Serialization 类型安全导航、深度链接与外链路由
├── notifications/                   # 通知渠道、Android 13+ 权限诊断与点击意图路由
├── domain/
│   ├── mail/                        # SeekMail 模型、仓库接口与 VerificationCodeExtractor
│   ├── model/                       # 社区帖子、账户、社交与设置不可变模型
│   ├── radar/                       # Pulse Radar 规则、提醒记录与定位解析器
│   ├── repository/                  # 纯 Kotlin 领域仓库接口
│   ├── update/                      # GitHub Releases 更新模型、SemVer 比较器与管理器接口
│   └── valuation/                   # BigDecimal VPS 剩余价值与过户交易估值引擎
├── data/
│   ├── local/                       # Room 数据库(离线收藏快照、阅读进度、雷达规则、版块)与 DataStore
│   ├── mail/                        # 会话隔离 SeekMailApiClient、Jsoup HTML 消毒器与磁盘缓存
│   ├── network/                     # OkHttp 客户端、CSRF 存储、WebView Cookie 桥接与 Coil 工厂
│   ├── parser/                      # Jsoup window.__config__ 注水解析、RSS XML 与 HTML→Markdown
│   ├── radar/                       # PulseRadarMonitor 前后台轮询与关键词/正则匹配引擎
│   ├── repository/                  # 各仓库实现与 DTO 映射层
│   ├── update/                      # Cookie 隔离 GitHubReleaseClient、APK 安装器与更新调度实现
│   └── valuation/                   # Frankfurter 汇率仓库(含 24h 本地缓存与手动校准)
└── ui/
    ├── theme/                       # 清雾浅色/深岩深色/Pitch 色板、15 版块规范、Lv.0–6 等级光环与默认 90% 排版缩放
    ├── components/                  # PulseTopicCard、FloatingPillDock、MarkdownRenderer、ANSI/贴纸支持
    ├── explore/                     # 脉冲首页流 Screen & ViewModel
    ├── boards/                      # 独立全站统一搜索与版块过滤 Screen & ViewModel
    ├── topic/                       # 杂志级帖子阅读器、楼层滑块与快捷回复工作台
    ├── composer/                    # Markdown 发帖/改帖编辑器与 NodeImage 上传
    ├── hub/                         # 个人中心(一行签到/设置式分组)、收藏与足迹、签到榜、收件箱、私信、用户空间与分组设置页
    ├── mail/                        # SeekMailScreen(含页内 API Key 弹窗)、SeekMailViewModel 与隔离式 SeekMailWebView
    ├── radar/                       # PulseRadarScreen & ViewModel(规则管理、提醒流与追更追踪)
    ├── update/                      # AppUpdateDialog(更新提醒弹窗、日志渲染与下载安装进度)
    ├── valuation/                   # VpsValuationBottomSheet(实时遥测、汇率同步与 Markdown 导出)
    └── preview/                     # Compose @Preview 组件设计图库

更多工程与协议细节请参阅 docs/design-spec.md 与 docs/nodeseek-protocol.md。


🧰 技术栈 · Tech Stack

领域 技术选型
语言与构建工具链 Kotlin 2.1.10 · Java 17 · Android Gradle Plugin 8.8.2 · Gradle 8.11.1 · KSP 2.1.10-1.0.31
Android SDK minSdk = 26(Android 8.0) · targetSdk = 35 · compileSdk = 35
UI 与设计系统 Jetpack Compose(BOM 2025.02.00) · Material 3 Expressive · Edge-to-Edge WindowInsets
导航与生命周期 Navigation Compose 2.8.9(Type-safe Kotlinx Serialization 路由) · Lifecycle 2.8.7
网络与解析 OkHttp 4.12.0 · Jsoup 1.19.1 · Kotlinx Serialization JSON 1.8.0 · AndroidX WebKit 1.13.0
本地持久化 Room 2.7.0(离线帖子快照、阅读楼层与雷达数据) · Preferences DataStore 1.1.3
图片加载 Coil 3.1.0(coil-compose + coil-network-okhttp + GIF / SVG 解码与 Referer 策略)
单元测试 JUnit 4.13.2 · Kotlinx Coroutines Test 1.10.1 · OkHttp MockWebServer 4.12.0

🛠️ 本地构建与测试 · Build & Verification

环境要求

  • JDK 17(Gradle 构建与 Compose Preview 渲染需运行在 Java 17 上)
  • Android SDK Platform 35(在项目根目录配置 local.properties 或环境变量 ANDROID_HOME)

构建 APK

# 构建 Debug APK
./gradlew assembleDebug

# 构建 Release APK(若配置了本地签名则自动签名)
./gradlew assembleRelease

产物输出目录:

  • Release:app/build/outputs/apk/release/(配置签名后生成 Anode-v2.0.0-release.apk)
  • Debug:app/build/outputs/apk/debug/Anode-v2.0.0-debug.apk

如需对 Release 进行本地签名,可在项目根目录创建未纳入版本控制的 key.properties(配置 storeFile、storePassword、keyAlias、keyPassword),或在 CI 环境中设置 KEYSTORE_FILE、KEYSTORE_PASSWORD、KEY_ALIAS 与 KEY_PASSWORD。

运行单元测试与 Lint 检查

./gradlew testDebugUnitTest
./gradlew lintDebug

🔒 隐私安全与免责声明 · Privacy & Disclaimer

  • 第三方开源客户端:Anode 为面向 NodeSeek 社区的第三方开源 Android 客户端,与 NodeSeek 官方无从属或背书关系。
  • 本地凭据安全:论坛登录会话 Cookie、阅读记录、脉搏雷达规则及可选的 NodeImage / Seek Mail API Key 均仅保存在用户本机沙盒存储中,绝不上传至任何第三方统计或中转服务器;外站图床与邮件接口均采用严格的 Cookie 隔离策略。
  • 合规安全验证:当触发登录、两步验证(2FA)或站点安全检查时,应用通过内置官方网页视图由用户本人手动完成,不采用任何自动化脚本规避站点校验机制。
  • 开源协议:本项目基于 MIT License 开源。

About

Anode — 面向 NodeSeek 社区的原生 Jetpack Compose / Material 3 Expressive Android 客户端,内置脉搏雷达监控、VPS 剩余价值折算器与 Seek 邮箱客户端

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages