NGA Reader

NGA Reader 是一个 VS Code 扩展，用本机浏览器登录态读取 https://ngabbs.com/，并在 VS Code 面板内浏览板块、帖子和关注用户内容。

功能

• 登录并保存 NGA 登录态。
• 搜索板块，收藏常用板块。
• 在 VS Code 内查看板块帖子列表和帖子正文。
• 板块默认按新发布排序，也可以切换为按新回复排序。
• 查看关注的人。
• 加载关注的人发布的话题。
• 加载关注的人的所有回复。
• 支持帖子分页、页码跳转和下一页后台预加载。

界面设计

• 面板采用 VS Code 风格的低对比界面，弱化标题、人名和按钮的视觉权重。
• 内容使用接近代码、注释和日志的排版方式展示，避免明显的论坛页面样式。
• 板块、帖子和关注内容都在 VS Code 面板内查看，尽量减少跳转外部网页。
• 顶部操作区吸附在面板内，翻页、返回和加载操作保持在当前阅读上下文中完成。

安装

在 VS Code 扩展面板搜索 NGA Reader，点击安装即可。

运行要求

• VS Code 1.85.0 或更高版本。
• 本机需要可用的 Chromium、Chrome 或 Edge 浏览器。
• 扩展依赖 Playwright 启动浏览器。如果提示浏览器不存在，按扩展弹窗提示安装 Chromium，或先安装 Chrome/Edge 后重试。

首次使用

1. 打开命令面板：Ctrl+Shift+P。
2. 执行 NGA: Login。
3. 在弹出的浏览器窗口中手动登录 NGA。
4. 如果 NGA 要求验证，在浏览器中完成验证。
5. 回到 VS Code 弹窗，点击 Done 保存登录态。
6. 执行 NGA: Show Browser 打开阅读面板。
7. 点击面板右上角 Sync 拉取板块和关注数据。

使用方式

浏览板块

1. 点击 modules。
2. 在输入框输入板块名称，例如 网事杂谈、股市 技术分析。
3. 按回车，或点击 grep 搜索。
4. 点击 Pin 收藏常用板块。
5. 点击 Open 进入板块。
6. 板块内默认显示 created 排序，也就是新发布优先。
7. 点击 updated 可以切换为新回复优先。
8. 使用 Prev、Next 或 Go 翻页。
9. 点击帖子标题可在面板内查看正文。
10. 点击 Back 返回上一层。

查看帖子

• 帖子正文直接显示在 VS Code 面板内，不会跳转外部网页。
• 帖子按楼层展示。
• 顶部显示当前页和总页数。
• 可以使用 Prev、Next 或 Go 切换页码。

查看关注的人

1. 点击 watch。
2. 点击某个关注人的 Open。
3. 点击 Load Index 加载该用户发布的话题。
4. 点击 Load Trace 加载该用户的所有回复。
5. 点击 Fold 收起。
6. 话题可以继续点击 Open 在面板内查看正文。

命令

常见问题

面板显示 profile inactive

说明没有检测到有效登录态。重新执行 NGA: Login，在浏览器中登录后点击 Done。

Sync 后没有数据

常见原因是登录未完成、NGA 要求验证、网络超时或页面结构变化。先执行 NGA: Login，确认浏览器中能正常访问 NGA，再回到面板点击 Sync。

关注的人是 0

先确认 NGA 网页端能看到关注列表。如果网页端正常，重新执行 NGA: Login 后再点击 Sync。NGA 页面结构变化时，扩展可能需要更新选择器。

加载话题或回复失败

可以再次点击 Load Index 或 Load Trace 手动重试。扩展内部会尽量自动重试，但 NGA 验证、网络慢或接口返回异常仍可能导致失败。

打开帖子或翻页比较慢

扩展使用真实浏览器读取页面，速度会受 NGA 页面加载、验证、网络和本机浏览器启动影响。当前实现会复用浏览器上下文，并在有下一页时后台预加载下一页。

隐私说明

• 登录过程在本机浏览器中完成。
• 登录态保存在 VS Code 扩展的本地存储目录中。
• 扩展不会要求输入 NGA 密码，也不会把登录信息发送到第三方服务。

说明

• 本扩展读取的是 NGA 网页内容，NGA 页面结构变化可能影响抓取结果。
• 如果遇到验证页面，需要在弹出的浏览器中手动完成验证。
• 请遵守 NGA 的使用规则，避免高频刷新。