OhGithubLost 使用说明
面向使用者，介绍如何安装、登录与使用主要功能。
一、这是什么
OhGithubLost（简称 OGL）是一个 GitHub 仓库管理客户端，手机、平板与桌面可用。用它浏览与编辑仓库、处理 Issues 与 Pull Requests、查看 Releases 与 Actions、管理 Gist，不必打开浏览器。
二、适用平台
| 平台 |
状态 |
说明 |
| Android |
✅ 支持 |
当前主要目标；4 架构 APK + AAB |
| Windows |
✅ 支持 |
x64 / arm64；长路径建议开启 |
| Linux |
✅ 支持 |
x64 / arm64；deb / rpm / AppImage；glibc ≥ 2.35（Ubuntu 22.04 一代及以上） |
| macOS / iOS |
❌ 弃用 |
最后支持版本 v5.3.0 |
| macOS |
未测试 |
未签名构建，需自备证书或自行构建 |
| iOS |
未测试 |
未签名构建，需自备证书或自行构建 |
macOS 与 iOS 的构建产物为未签名包，设备上不能直接安装使用。
三、开始使用
3.1 登录
- 需要 GitHub 个人访问令牌（Personal Access Token）。创建时按需勾选作用域，建议勾选
repo（可操作私有仓库、Issues 等）。
- 登录页提供令牌向导：粘贴令牌、验证、保存、回读自检，每一步的进展与失败原因会逐项显示。
- 令牌只保存在本机系统密钥库；界面与日志中显示为脱敏形式；退出登录会移除本机令牌，远端数据不受影响。
- 也可选择「以游客身份浏览」，只读查看公开内容。
3.2 首次权限引导
首次启动会说明应用需要哪些能力、用于什么。应用会真正调起系统权限弹窗；仍拿不到权限时如实提示到系统设置开启，不会假称已授权。之后可在「设置 → 维护 → 权限与引导」重新查看。
四、界面总览
手机底部、平板与桌面侧边有四个入口：首页、搜索、我的、设置。
五、首页
- 在「我的仓库」与「星标仓库」之间切换。
- 下拉刷新列表。
- 右上角新建仓库（名称、描述、是否私有）。
六、搜索
- 在「仓库」与「代码」之间切换，回车执行。
- 仓库结果进入仓库页；代码结果直达该仓库中的对应文件。
七、仓库页
顶部：星标 / 取消星标、复刻仓库。以下八个标签：
- 代码：目录浏览（文件夹排在文件前），按类型显示图标。点文件查看内容；长按（手机）或右键（桌面）弹出菜单：下载、详情、删除；进入编辑可修改并提交。
- Issues：列表与筛选；详情含正文与评论；可新建议题、发表评论、关闭或重开。
- Pull Requests：列表与详情；展示变更文件与增删行统计；有补丁时可展开查看。
- Releases：列表与详情；查看说明、下载附件；新建、编辑（标签 / 标题 / 说明 / 草稿 / 预发布）、删除。
- 分支：列表；新建、重命名、删除。
- 提交：历史列表；详情展示该次变更文件与分色补丁。
- Actions：运行列表；详情展示作业与步骤、状态与耗时；可重新运行、取消；可手动触发支持手动触发的工作流（选择工作流、填写分支与参数）。
- 设置：编辑仓库名称与描述、配置自定义域名（CNAME）、启用 Pages、删除仓库（二次确认）。
八、代码编辑器
- 独立编辑页；撤销 / 重做；查找与替换；切换自动换行与字号；返回时若未保存会先确认。
- 保存带基线校验：若远端已被他人更新，不会直接覆盖，而是弹出冲突提示（显示你的基线、远端最新与远端内容），可选择取消或强制覆盖。
九、Gist 片段
入口在「我的」。支持列表、详情、新建、编辑与删除。
十、下载管理与草稿箱
下载管理（首页右上角下载图标）：
- 内置下载器：多线程分块下载，支持暂停、继续、取消、重试与移除；
- 进度与速率实时显示，任务列表可随时查看；
- 落盘位置：应用根目录
ogl/download/<分类>/（Release、仓库文件、Gist 分开存）；
- Release 附件下载可走你自备的加速通道（本应用不预置通道；不添加则始终直连）。
草稿箱（「我的」页）：
- 编辑器会自动把未提交的改动存为草稿；再次进入同一文件会自动恢复并提醒；
- 提交成功后草稿自动清除；
- 草稿箱可查看内容（可复制）与删除。
十一、通知中心
首页右上角铃铛图标进入。汇总运行事件（成功、告警、错误），可按「全部 / 告警 / 错误」筛选，单条可复制用于反馈。
十二、我的
- 多账号：切换当前账号、移除账号、添加新账号。
- Gist 片段入口。
- 退出登录（删除本机令牌）。
十三、设置
设置页为可折叠分组，默认收起：
- 外观：明暗模式、主题色、界面密度、文字缩放、动效档位（最小 / 当前 / 标准 / 增强）。
- 语言：6 种界面语言（简体中文 / 繁體中文 / English / Deutsch / Français / Русский）。
- 代码与文件：语法高亮开关、高亮主题（跟随主题 / 高对比 / 柔和 / 自定义逐项配色）、自动换行、代码字号、目录优先排序。
- 网络：自定义 DNS 解析、DNS 服务器、DoH（加密解析）。
- 账户：当前账号与退出。
- 维护：权限与引导、重置设置。
- 关于：独立页面，展示项目名称、主要开发者、版本、仓库地址、许可与启动诊断。
- 开源许可：本项目许可与第三方依赖清单。
- 日志：日志文件位置与复制入口。
- 捐赠一颗心：二次确认后，用当前登录账号为本项目加星；已 star 时不会重复操作。
十四、数据可靠性与隐私
使用者可以感知到的几点：
- 文件锁：保存与删除均带基线校验；远端有他人改动时会被拦下并提示，而不是直接覆盖。
- 操作反馈：加载中、无内容、出错、成功四类状态均会显示；危险操作会二次确认。
- 网络不稳：请求会自动重试；连接失败时会把更底层的原因写进日志，便于定位。
- 网络受限：可在设置中选择自定义 DNS 与 DoH。
- 令牌保管：令牌只存本机密钥库，日志与报错中脱敏，退出登录即删除。
- 出错可见：未捕获的错误会以弹窗或横幅提示；可随时在设置中复制日志用于反馈。
- 启动校验：启动时校验内置引导清单的签名与模块完整性；异常时进入安全模式，并在关于页说明。
十五、常见问题
- 安装新版提示「应用签名不一致」？ 早期版本的签名证书已更换。安装 v1.1.0 及之后版本前，先卸载旧版一次，之后即可正常覆盖升级。
- 提示冲突怎么办？ 说明远端在你打开文件后有新提交。可取消以保留远端，确认内容后再改；确认要放弃远端改动时选强制覆盖。
- 想反馈问题？ 在「设置 → 日志」复制日志内容，连同复现步骤一起提交 Issue。
- 令牌权限不足？ 到 GitHub 重新生成令牌，勾选所需作用域（如
repo），再在「我的」里添加账号。
十六、许可
本项目使用 Apache License 2.0（Apache-2.0），条款见仓库根目录 LICENSE，第三方组件声明见 NOTICE。