Hydrogen

# Hydrogen

> ⚠️ **项目维护延缓**  
>
> 由于[相关原因](https://github.com/zhihulite/Hydrogen/issues/159)，Hydrogen 项目维护已延缓。  
>
> 推荐使用同类优秀项目：[Zhihu++](https://github.com/zly2006/zhihu-plus-plus)

**注意**：请勿在 Gitee 反馈问题或提交 PR，请前往 GitHub 提交。Gitee 仓库仅用于代码同步。

**重要**：发布更新前，必须修改 `core/app_info.lua` 中的 `version` 变量，否则应用无法检测到新版本。

[![License](https://img.shields.io/github/license/zhihulite/Hydrogen)](LICENSE)
[![Gitee 仓库](https://img.shields.io/badge/Gitee-仓库-C71D23?logo=gitee)](https://gitee.com/huajicloud/Hydrogen)
[![Github 仓库](https://img.shields.io/badge/Github-仓库-0969DA?logo=github)](https://github.com/zhihulite/Hydrogen)

## 目录

- [项目介绍](#项目介绍)
- [更新与反馈说明](#更新与反馈说明)
- [历史版本存档](#历史版本存档)
- [特别致谢](#特别致谢)
- [打包说明](#打包说明)
- [Aide Lua 调试指南](#aide-lua-调试指南)
- [贡献指南](#贡献指南)

## 项目介绍

Hydrogen 是一个基于 [LuaJVM](https://github.com/zhihulite/luajvm) 开发的项目。

> **Aide Lua 调试提示**：
> 你可以使用 [Aide Lua](https://gitee.com/AideLua/AideLua) 实现免打包快速调试 Lua 代码。
> **但在开始调试前，请务必阅读下方的 [配置指南](#aide-lua-调试指南)**，否则因环境配置缺失将导致运行失败。
> **不建议使用 Aide Lua 进行打包**。请务必通过 Gradle 打包 APK，详见下方 **[打包说明](#打包说明)**。

## 更新与反馈说明

- **更新策略**：默认情况下，仅在必要时才会推送版本更新。
- **反馈要求**：反馈问题时，请务必使用最新版本进行测试。
- **最新构建下载**：你可以从 [GitHub Actions](https://github.com/zhihulite/Hydrogen/actions) 获取最新的自动构建版本。

## 历史版本存档

- **Hydrogen Final 7 (2022 最终版)**：[查看源码存档](https://github.com/zhihulite/Hydrogen/releases/tag/archive-final7-original)

  > 此为 2022 年发布的 Final 7 原始代码存档，已停止维护。仅用于代码回溯与历史参考。

## 特别致谢

- [ZL114514](https://github.com/ZL114514)：目前负责仓库的维护工作
- [People 11](https://GitHub.com/People-11)：使用 Gemini 进行了不少修缮
- [orz12](https://gitee.com/orz12)：早期重新设计了部分布局
- [1582421598](https://github.com/1582421598)：提交 PR 修复 bug
- [NullCola](https://t.me/NullCola)：绘制矢量 Hydrogen 图标

## 打包说明

你可以通过以下方式打包：

- 使用 `app:assembleRelease` 打包（包含 lua 文件）

  > **重要提示**：请务必指定 `app` 模块（即使用 `app:assembleRelease`）。
  > **不要**直接使用根项目的 `assembleRelease`，这可能导致打包失败。

### 签名信息

> **安全提示**：为了方便开发者调试和二次打包，本项目公开了签名文件 (`hydrogen.jks`) 及密码。**请务必确认你下载的 APK 来自官方 GitHub Releases 页面、Actions 构建产物或本仓库可信来源**。任何第三方渠道分发的 APK 均可能被篡改，请注意甄别安全风险。

`hydrogen.jks` 是软件的签名文件，你可以使用 apksigner 或其他签名工具进行签名。签名信息如下：

- 别名：`hydrogen`
- 密钥库密码：`zhihu`
- 私钥密码：`android`

使用 apksigner 签名的示例命令：

```shell
apksigner sign --ks hydrogen.jks --ks-key-alias hydrogen --ks-pass pass:zhihu --key-pass pass:android --v1-signing-enabled true --v2-signing-enabled true --v3-signing-enabled true --v4-signing-enabled true -v --out 签名后apk 签名前apk
```

### Aide Lua 调试指南

> **调试前必读**：如果不按以下步骤操作，Aide Lua 将无法快速调试 Hydrogen。

如果你使用 **Aide Lua** 进行代码调试，请严格遵守以下操作流程：

1. **预安装正式版**：
   首先必须通过 Gradle 打包并安装正式版的 Hydrogen APK 到设备上（确保授权存储权限）。

2. **修改 Aide Lua 设置**：
   打开 Aide Lua，点击右上角的 **设置** 图标，找到并 **关闭** “比较完整的运行” 选项。
   *(注：开启此选项会导致调试所需时间增加)*

3. **开始调试**：
   完成上述两步后，即可在 Aide Lua 中加载项目进行调试。

## 贡献指南

### 架构概览

Hydrogen 采用分层架构，Lua 编写业务逻辑，桥接 Android 原生 API。

#### 技术栈

- 语言：Lua 5.5.1 + Java（仅桥接层）
- UI：Material Design Components（原生控件）
- 网络：HTTP + Cookie + ZSE96 加密
- 混合渲染：原生列表 + WebView（注入 JS）

#### 分层说明

| 层级           | 职责