jo32/dsh-nga-reader

dsh-nga-reader

DSH Plugin
DeepDeck App
License: MIT

一个持久化的 dsh-plugin Cordis Host/Client 捆绑包，用于浏览 NGA、阅读讨论，并在 AI 对话中使用选定的内容。

最好与 DeepDeck 配合使用。 DeepDeck
提供 Apps 启动器、独立阅读器窗口、应用作用域 Workspace、
设置以及 Explain 和 Summarize 所使用的规范对话。
本插件在挂载时依赖 DeepDeck 的 App 运行时服务。

截图

NGA Reader 支持访客浏览，并将身份验证保持为可选，直到需要执行个人或写入操作时才需要。提供二维码、账号/密码以及现有 token 登录方式。下方截图是从独立的 DeepDeck 桌面 App 窗口捕获的——而非浏览器标签页。它使用隔离的 访客会话 打开公开的 音乐影视 版块并阅读讨论，无需账号，因此截图中不包含任何账号标识或凭据。

NGA Reader 在 DeepDeck 中以访客身份浏览公开版块

使用 DeepDeck 安装（推荐）

1. 在 DeepDeck 中打开 Settings → Apps。
2. 将 https://github.com/jo32/dsh-nga-reader.git 粘贴到 Install an App
plugin 中。
3. 选择 Inspect source，查看检测到的包和构建命令，
然后选择 Confirm install。
4. 根据提示重启 DeepDeck。
5. 从侧边栏打开 Apps → NGA Reader。

对于本地开发，构建检出内容并将生成的本地
捆绑包安装到活动的 DeepDeck web 配置文件中：

git clone https://github.com/jo32/dsh-nga-reader.git
cd dsh-nga-reader
npm install
npm run typecheck && npm test
dsh plugin --profile web add "$PWD"

最后一条命令仅挂载 Cordis 捆绑包；请在 DeepDeck 管理的
配置文件中运行它，以确保所需的 App 运行时存在。

使用示例

- 打开一个版块，选择一个主题，并在聚焦的阅读器中阅读分页帖子。
- 选择文本或右键点击帖子，然后选择 Explain 或 Summarize，以
在 ~/DeepDeck/Apps/nga-reader 中打开一个规范 Session。
- 向 DeepDeck agent 提问：列出 NGA 当前热门主题，并按版面分组。
- 询问选定的主题：阅读这个帖子，提炼主要共识、争议点和有用链接。
- 仅当你需要收藏、通知、消息、
签到、投票或回复时，才连接账号。Agent 触发的发布仍然
需要审批。

功能

- NGA 版块发现与筛选
- 主题列表、主题搜索、分页、帖子阅读、图标、头像和图片
- 二维码扫码登录（NGA App 扫码授权）和账号密码登录
- 手动输入 access_uid/token 作为后备方案
- 持久化本地凭据存储；显式回复发布
- 用于版块发现、主题阅读和当前 UI 上下文的 Agent 工具
- 阅读器窗口：侧边栏启动器通过桌面外壳的 deepdeck:open-app-window IPC 请求，将 GET /nga-reader（一个自包含的阅读器文档）提升为真正的 Electron 次级应用窗口；如果没有桌面 IPC 父级，它保持关闭；客户端不包含嵌入式阅读器
- 文本选择 -> 右键单击 -> 在独立窗口中解释或总结；同源的 BroadcastChannel 启动一个规范的应用会话，并在主 DeepDeck 窗口中直接打开该对话

扩展的 NGA 支持

MNGA 功能对等（从 logic/service/src 契约移植）：

- 每日签到、通知（类型化：回复 / 提及 / 投票 / 私信）
- 短消息：对话、带分页的帖子阅读器、回复以及向一个或多个收件人发送新消息
- 收藏：论坛收藏（列出/添加/移除）、主题文件夹（列出/创建/重命名/设为默认/删除）、每个文件夹的收藏主题、收藏/取消收藏主题
- 按论坛的热门话题，支持日/周/月范围以及回复排序
- 按 uid 或名称查看用户资料（统计、签名、禁言/ip、关注状态、头像回退）、关注/取消关注、关注列表、关注动态流
- 每用户主题列表和每用户帖子搜索（searchpost）
- 帖子投票（主题推荐顶/踩）、回复草稿获取（引用/回复/修改的逐字内容，包括附件认证）、举报帖子、子论坛过滤屏蔽/显示
- 签名更新；通知已读状态在会话中由客户端跟踪
- 独立窗口 UI：用于通知 / 消息 / 收藏 / 用户卡片的抽屉面板、签到和热门话题按钮、帖子上的投票和收藏操作

为智能体访问添加的 Agent 工具：nga_clock_in、nga_notifications、nga_short_messages、nga_read_message、nga_send_message（需审批）、nga_favorite_forums、nga_hot_topics、nga_user、nga_user_topic_list、nga_user_post_list、nga_following_users、nga_following_activity 和 nga_vote_post。完整的操作集也暴露在 /api/nga-reader 上（clock-in、notis、msg-、fav-、user、follow-、vote、reply-draft、report、signature、subforum-filter）。

身份验证和凭据存储

登录实现说明：

- 二维码密钥来自 nuke.php?__act=qrlogin_gen；二维码编码官方的 qrlogin_ui URL，并且使用 qrkey/hiddenkey 的 __act=login 将授权交换为 uid/token（待处理状态：“license not found”）。
- 密码在提交前使用官方 Web 公钥进行 RSA（PKCS#1 v1.5）加密，与 passport 页面行为一致。
- 二维码图像使用 Node qrcode 包在本地生成；没有任何第三方二维码服务接收登录数据。

Host 仅将 NGA uid 和访问令牌作为插件拥有的 dsh-nga-reader-plugin/nga-account 授权持久化到 Harness 凭据文档 $DSH_HOME/.credentials.yaml（默认：~/.dsh/.credentials.yaml）中。账户密码从不存储。挂载的 credentials-local 服务拥有
原子写入、跨进程锁定、私有文件权限以及持久化重载。该插件在每次 NGA 操作时读取记录，而不是将令牌缓存为插件状态，其“退出登录”操作会删除该记录。

开发

npm install
npm run typecheck
npm test
npm run build

该插件、NGA HTTP 客户端、解析器、身份验证辅助工具以及二维码生成均在 src/ 下以严格 TypeScript/Node.js 实现，并编译为 lib/ 下的 ESM/运行时产物。无需 Python。生成的 lib/ 输出不会被提交。

许可证

MIT。运行时依赖的许可证由其各自的 npm 包记录。