这是一个终端应用（TUI），目前还带点趣味性……在这个阶段也还有些实验性质！
 |
简介 | 一个用于浏览和发布 Discourse 论坛内容的终端 UI，支持主题列表、完整主题视图、回复、点赞、搜索以及内置的编辑器。 |
 |
仓库链接 | GitHub - merefield/termcourse: A terminal based client to access Discourse instances, supporting API keys, username/password (and with MFA token) · GitHub |
 |
安装指南 | 仓库中的 README.md（快速开始部分） |
 |
赞助 | 请考虑以适合您或您所在组织资源和需求的级别，持续赞助我的开源工作（https://github.com/sponsors/merefield），以确保该项目获得应有的维护，并能在未来继续为您的站点提供服务。 |
喜欢 termcourse？请在 GitHub 上给它一个 
吧
概述
termcourse 是一个基于终端的 Discourse 客户端，重构为单个 Go 可执行文件。它可以使用权重较轻的浏览器风格 Cookie 会话，通过用户名/电子邮件和密码进行登录，支持 TOTP 和备用代码 MFA。对于不适合交互式登录的站点，可以使用 API 密钥进行身份验证。
该界面使用当前的 Charm 技术栈，支持键盘和鼠标操作。其文件夹式导航、上下文过滤器、响应式面板、主题控件、Markdown 渲染和内联图像旨在让用户无需离开终端即可舒适地浏览论坛。
功能
- 浏览最新（Latest）、热门（Hot）、新帖（New）、未读（Unread）、热门（Top）和私信（Private Message）主题列表，支持切换 Top 的时间周期。
- 导航持久化的主题（Topics）、搜索（Search）、通知（Notifications）和撰写（Compose）文件夹，支持上下文二级过滤器。
- 全程使用键盘操作，或点击选项卡、主题行、底部控件和悬停高亮的按钮。
- 使用 Enter 键或数字键
1–0打开可见的主题。 - 阅读完整主题，支持帖子懒加载、紧凑摘要、展开选中的帖子以及响应式滚动。
- 点击主题的进度条可直接跳转到帖子流中的相应位置。
- 创建主题、选择分类、回复主题或单个帖子，以及对帖子进行点赞或取消点赞。
- 搜索帖子并直接跳转到其主题上下文中的匹配帖子。
- 浏览和过滤通知，包括未读和私信徽章。
- 撰写多行内容，支持光标移动、插入、换行、粘贴支持和实时验证。
- 渲染 GFM Markdown，包括链接、列表、引用、代码、任务列表和表格。
- 使用 Kitty 图形协议显示高质量的内联和全屏图像，并使用带颜色的
chafa符号或viu作为可移植的回退方案。 - 在使用 Cookie 会话时，接收主题列表、主题、通知和私信的实时更新。
- 从环境变量或
credentials.yml中获取每个站点的凭据，并提示输入缺失的登录字段。 - 从
default、slate、fairground、rust和hacker主题中选择，添加 YAML 主题，并在应用运行时切换主题。 - 使用真彩色、256 色或 16 色输出，并自动检测终端能力。
- 以英语、法语、德语或西班牙语运行界面。
- 自由调整终端大小：布局、颜色、主题列表和 Kitty 图像会根据可用空间做出响应。
- 当 Discourse 对操作进行速率限制时，查看服务器提供的重试时间，并可选择启用 HTTP、UI 和图像诊断。
安装和运行
在 Linux 或 macOS 上，推荐的安装程序会下载当前操作系统和架构的预构建版本，验证其 SHA-256 校验和和报告的版本，然后进行安装：
curl -fsSL https://raw.githubusercontent.com/merefield/termcourse/master/install-release.sh | sh
termcourse your.discourse.host
如果尚未配置凭据，Termcourse 会提示输入用户名和密码。密码输入将被隐藏。
使用 termcourse --version 显示已安装的语义化版本；相同的版本也会显示在宽终端的报头中。
对于不需要 sudo 的用户本地安装：
curl -fsSL https://raw.githubusercontent.com/merefield/termcourse/master/install-release.sh |
TERMCOURSE_BIN_DIR="$HOME/.local/bin" sh
每个 GitHub Release 都提供 SHA-256 校验和以及适用于 AMD64 和 ARM64 的 Linux、macOS 和 Windows 的预构建存档。Linux/macOS 使用 .tar.gz；Windows 使用 .zip。预构建版本不需要 Go。
在 Windows 上，下载并检查安装程序，然后在更改机器范围的执行策略之前运行它：
Invoke-WebRequest https://raw.githubusercontent.com/merefield/termcourse/master/install-release.ps1 -OutFile install-release.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install-release.ps1
默认情况下，它安装到 %LOCALAPPDATA%\Programs\termcourse\bin，并执行相同的校验和版本验证。安装程序也可以使用 --version 或 -Version 固定特定版本。只有从源代码安装时才需要 Go 1.26.6 或更高版本。
若要改为从检出构建本地可执行文件：
git clone https://github.com/merefield/termcourse.git
cd termcourse
make build
./termcourse your.discourse.host
为了重复使用，请将登录详细信息放在本地 .env 中，或使用 README 中描述的按主机配置的 credentials.yml。
用户名/密码登录（推荐）
用户名/密码登录支持实时更新：
DISCOURSE_USERNAME="you@example.com" \
DISCOURSE_PASSWORD="your_password" \
termcourse your.discourse.host
API 密钥回退
DISCOURSE_API_KEY="your_key" \
DISCOURSE_API_USERNAME="your_username" \
termcourse your.discourse.host
有关配置、主题、控件、图像后端和故障排除的最新信息，请参阅最新的 README。
身份验证说明
- 用户名/密码登录遵循 Discourse 的 CSRF 和 Cookie 流程，并支持实时 MessageBus 更新。
- 支持 TOTP 和备用代码 MFA。
- API 密钥身份验证保留 HTTP 功能，但不建立实时浏览器会话。
- 某些站点会禁用或限制脚本化的用户名/密码登录；API 凭据是这些站点的回退方案。
安全性
- Termcourse 不会将提示输入的凭据或会话 Cookie 写入磁盘；会话 Cookie 保留在内存中。
- 密码提示可防止密码出现在 shell 历史记录中。
- 持久化凭据是可选的，并保留在用户的环境变量或 YAML 文件中，由用户控制。
- 诊断日志记录是可选的，默认禁用，并且不会记录凭据或响应主体。
局限性
- 禁止远程登录流程的站点可能需要 API 密钥身份验证。
- 实时更新需要用户名/密码 Cookie 身份验证。
- 原生内联图像质量取决于终端支持情况；首选 Kitty，其他地方可使用符号渲染。
- 它存在于终端中。
致谢
部分灵感来自 Dumbcourse: old browser friendly UI at dumb/d-pad/small screens。
更新来了：
……但不同媒介之间当然存在一些显著差异，所以有些事情可能仍然不同。