前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。对于需要跟踪技术资讯、博客动态或社区更新的开发者来说，直接在 DSH 环境内完成订阅、阅读和整理是常见需求。dsh-rss-reader 是一个内嵌的 RSS / Atom 阅读器插件，它将订阅源管理、内容浏览、翻译整理等功能集成在 DSH 的 Web profile 界面中，无需跳转至外部应用。
界面与阅读体验¶
插件提供两种呈现形态，满足不同的布局需求。
中间主区域（三栏布局）
点击左侧栏的 RSS 图标，可在主区域打开三栏阅读界面：左侧为订阅源列表，中间为条目流，右侧为正文阅读区。
右侧边栏（单栏形态）
插件同时注册为一个原生右侧边栏 tab。入口位于左侧栏底部的“RSS 阅读器”按钮或右侧边栏的“+”面板选择器。该栏较窄，采用单栏形态：顶部为订阅源胶囊条（显示源名与未读数），下方为条目列表。点击条目后，详情页会替换列表位置，无需跳转新标签页。
阅读体验经过优化。详情页采用 position: sticky 的返回按钮，滚动时始终停留在顶部，无需手动滚回列表。插件会记忆上次读到的源、条目位置和滚动进度，再次打开时自动恢复。切换订阅源时，会自动回到列表视图。正文支持 Markdown 渲染，图片默认折叠在原位，支持一键翻译。
订阅源管理¶
订阅源管理支持自由排序和右键操作。在面板内可拖拽订阅源调整顺序，或在设置页使用 ↑ / ↓ 按钮精确调整。取消订阅需要通过右键菜单进入二次确认，防止误删。
订阅源栏在右侧边栏模式下支持收起，以腾出更多空间给内容。折叠状态是偏好设置，重启后仍然有效。
内容发现与处理¶
支持探索 RSSHub 路由表和粘贴网页发现订阅源。对于只提供近期内容的源，支持通过归档页抓取更早的文章。支持增量抓取（ETag/Last-Modified）和可选后台刷新。
正文支持一键翻译，复用 DSH 中配置的翻译模型。译文同样以 Markdown 渲染，支持在原文/译文/对照之间切换。
安装¶
插件以依赖的形式装进某个 profile。需要 DSH ≥ 0.2.0-rc.1，且 PATH 中需包含 pnpm（dsh plugin 是 pnpm 的转发器）。
安装命令如下：
dsh plugin --profile web add github:FYKANG/dsh-rss-reader
安装完成后，左侧栏会出现 RSS 入口，点击可在主区域打开三栏面板；左侧栏底部会出现“RSS 阅读器”按钮，点击可在右侧边栏打开单栏面板。
使用¶
- 添加订阅：点击面板中的“+”或直接粘贴网页地址（支持智能发现
rel=alternate），点“添加并获取”。 - 阅读：在中间三栏或右侧单栏中点击条目阅读。右上角有“译”按钮可一键翻译。
- 管理：在订阅源列表上右键可进行刷新、标记已读或取消订阅操作（需二次确认）。
注意事项¶
- 依赖：必须满足 DSH ≥ 0.2.0-rc.1 且 PATH 中有 pnpm。
- 数据存储：订阅数据存储在
$DSH_HOME/rss-reader/feeds.json。卸载插件不会删除此文件。 - 手动挂载：插件安装时会自动追加到
dsh.profile.bundles。如需手动挂载，需修改cordis.patch.yml，但两者二选一即可。 - 后台刷新：需在设置中开启
refreshMinutes才能生效。
