qiaomu-rss-dsh

Readme

# 乔木 RSS · qiaomu-rss-dsh

**中文** · [English](#english)

**让订阅变成真正读进去的内容。** 在 Harness 里发现值得关注的作者，读原文或中文版本，再带着当前文章向 AI 追问。

[下载安装](https://github.com/joeseesun/qiaomu-rss-dsh/releases/latest) · [反馈问题](https://github.com/joeseesun/qiaomu-rss-dsh/issues)

![实际文章阅读：频道列表、阅读版本与正文](docs/screenshots/reading.png)

> 真实截图：独立 Harness Web profile，公开文章与服务已有的改写版本；没有合成 AI 回答。[截图说明](docs/SCREENSHOTS.md)

- **少切几个窗口：** 订阅列表、文章正文、原生 AI 对话在同一工作区。
- **外文文章也能顺畅读：** 在已有原文、译文和改写之间切换；缺失版本可交给已配置的模型生成。
- **从“看过”走向“看懂”：** 让伴读带着文章上下文继续解释、比较与追问。
- **订阅由你决定：** 发现博客与播客、添加 RSS/Atom 地址，用 OPML 迁移订阅。

Read RSS inside DeepSeek Harness and discuss the current article in its native AI conversation.

这是公开源码的社区插件，并非 DeepSeek 官方维护或背书。预构建安装包见 [GitHub Releases](https://github.com/joeseesun/qiaomu-rss-dsh/releases)；目前不发布 npm 包。已在 DeepSeek Harness 0.2.0-rc.2 的 Desktop 和隔离 Web profile 中验证。

## 能做什么

| 功能 | 使用方式 |
| --- | --- |
| 乔木精选与个人订阅 | 从左上角搜索并切换频道，自动加载该频道的新文章；在探索页添加 RSS/Atom 源，导入或导出 OPML |
| 阅读文章 | 切换原文、译文和乔木改写；支持未读、收藏、搜索与媒体内容 |
| AI 伴读 | 点击文章工具栏的魔法棒，或选中正文，右侧直接打开 Harness 原生对话；默认工作区自动连接当前文章，选文全文作为上下文，输入框只显示简短的可编辑引用预览 |
| 插件设置 | 调整阅读外观和乔木服务地址；用弹窗编辑订阅、重命名或取消分组，管理 OPML 与快捷提示词，并查看关于与打赏信息 |
| Agent 工具 | 提供频道、文章、搜索、订阅、刷新和阅读版本相关的八个 `rss_*` 工具 |

## 真实界面

<details>
<summary>查看已合并的桌面版 AI 伴读实拍</summary>

![真实 AI 伴读：文章与原生对话](docs/screenshots/ai-companion.jpg)

此前桌面构建实拍：打开 Planet Money 文章后，发送「概括要点」，右侧返回对应文章的概括。该截图由此前的 [PR #6](https://github.com/joeseesun/qiaomu-rss-dsh/pull/6) 合入；本轮隔离环境没有配置模型密钥，不据此声称重测了模型回答。

</details>

切换频道时先显示已缓存文章，再自动拉取该频道的新内容；刷新按钮仍可手动强制更新。切换文章时，阅读区用轻量骨架显示加载状态。默认阅读版本仅在当前文章有内容时生效，缺失时自动选择其他已有版本或原文；手动选择缺失版本仍可调用 Harness 生成。文章与伴读之间的分割线可拖动，也可用方向键微调、双击复位。打开伴读时文章列表保持可见，文章左上角也可打开频道列表。伴读输入框上方的快捷提示词可横向滚动点选并直接发送；末端的 + 可直达设置新增提示词。已有手写草稿时不会覆盖或误发。本机个人提示词保存在插件的浏览器存储中，可在设置中编辑。探索订阅包含来自原版乔木 RSS 目录的 73 个播客 RSS 源；订阅后可使用文章中的音频附件播放。插件不提供 Obsidian 式笔记、划线保存或日记写入。

## 找到下一篇想读的内容

![订阅发现：搜索作者、播客或 RSS 地址](docs/screenshots/discovery.png)

打开「探索订阅」，找到作者并订阅；也可以直接输入 RSS 地址。首次使用无需导入旧数据，乔木精选可直接阅读。AI 伴读与缺失版本生成需要宿主模型配置，普通阅读不需要模型密钥。

## 安装

需要 DeepSeek Harness 0.2.0-rc.2 的 `dsh` CLI。下载 [v0.5.2 Release](https://github.com/joeseesun/qiaomu-rss-dsh/releases/tag/v0.5.2) 中的 `.tgz` 和同名 `.sha256` 文件，在下载目录执行：

```bash
shasum -a 256 -c qiaomu-rss-dsh-0.5.2.tgz.sha256
dsh plugin --profile desktop add "$PWD/qiaomu-rss-dsh-0.5.2.tgz"
```

使用命令行 Web 界面时，把 `desktop` 换为 `web`。安装后重启对应的 Harness profile，在侧边栏打开「乔木 RSS」。[官方插件安装说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.md)介绍了 bundle 与 profile 的关系。插件依赖 Harness 已配置的模型与账号；默认无需再选工作区。

## 开发

需要 Node.js 22 或更高版本，以及已安装的 DeepSeek Harness。克隆后执行：

```bash
git clone https://github.com/joeseesun/qiaomu-rss-dsh.git
cd qiaomu-rss-dsh
npm ci
npm run check
npm pack
```

`src/` 是源码；`lib/` 是随 Git 仓库提交的宿主与客户端构建产物，供 DSH bundle 加载。修改源码后请重新构建，并一并提交更新后的 `lib/`。包名 `qiaomu-rss-dsh` 必须与 `cordis.patch.yml` 中的 `name` 保持一致。

此前版本已在本地 Desktop profile 验证读取、伴读和可调分割线，并通过隔离 Web profile 的安装、配置和启动检查；本轮独立 Web profile 已完成构建包安装、宿主启动、频道加载、文章打开、已有改写版本切换和订阅发现截图。未配置模型密钥，未重测 AI 生成回答。详见 [发布验证](docs/RELEASE-VALIDATION.md)。`private: true` 仅阻止误发 npm，不限制 GitHub 源码或 Release 下载。正式使用时请安装 Release 包；从 GitHub 源码构建适合参与开发。

升级时安装新版本包并重启同一 profile。暂时停用可在 Harness 插件管理中禁用 RSS；卸载前请通过 OPML 导出订阅，阅读状态需要另外备份。

## 数据与来源

- 订阅与阅读状态保存在 Harness home 的 `storages/qiaomu-rss/data.json`，不在本仓库。升级时不会清空旧数据。
- 乔木精选读取 [乔木 AI RSS](https://github.com/joeseesun/qiaomu-ai-rss) 的公开接口；个人订阅由插件抓取。
- 内置独立博客源清单来自 [chinese-independent-blogs](https://github.com/timqian/chinese-independent-blogs)，其 MIT 声明保留在 [`vendor/chinese-independent-blogs/LICENSE`](vendor/chinese-independent-blogs/LICENSE)。
- 播客 RSS 推荐地址来自 [乔木 AI RSS 的源目录](https://github.com/joeseesun/qiaomu-ai-rss/blob/main/src/data/tidings.json)；第三方源的可用性和全文/音频内容由各发布方决定。
- AI 伴读使用 DeepSeek Harness 当前可用的模型与原生会话；模型服务的配置与费用由 Harness 管理。

问题与改进建议请通过 [GitHub Issues](https://github.com/joeseesun/qiaomu-rss-dsh/issues) 提交。本项目采用 [GPL-3.0-only](LICENSE) 许可。

---

<a id="english"></a>

## English

The [live desktop screenshots](#真实界面) show a real feed, the rewritten reading view, subscription discovery, and an article-specific native AI response from a locally installed development build. [Download v0.5.2](https://github.com/joeseesun/qiaomu-rss-dsh/releases/tag/v0.5.2) or follow the install steps above.

Qiaomu RSS brings curated and personal RSS/Atom feeds into DeepSeek Harness. Read the original, translated, or rewritten article; manage unread items and favorites; import/export OPML; and open a native Harness AI conversation beside the article with its reading context attached. The companion opens directly in the default workspace. The article/chat divider is resizable.

This is an open-source community plugin, not maintained or endorsed by DeepSeek. A prebuilt tarball is available from [GitHub Releases](https://github.com/joeseesun/qiaomu-rss-dsh/releases); it is not published to npm. With the DeepSeek Harness 0.2.0-rc.2 CLI, download the `.tgz` and `.sha256` files, verify them with `shasum -a 256 -c qiaomu-rss-dsh-0.5.2.tgz.sha256`, then run `dsh plugin --profile desktop add /absolute/path/to/qiaomu-rss-dsh-0.5.2.tgz` and restart the profile. Use `web` instead of `desktop` for the Web profile. The previous package was installed and booted in an isolated Web profile, and its Desktop reading and AI-companion flow was checked in the installed app. This release workflow also verified an isolated package install, host boot, real article loading, switching to an existing rewritten version, and subscription discovery. AI generation was not retested with a model key. For development, use Node.js 22+ and run `npm ci`, `npm run build`, and `npm test`. The generated `lib/` files are committed because the DSH bundle loads them.

Reading data lives in the user's Harness home under `storages/qiaomu-rss/data.json`, outside this repository. The curated feed uses the public [Qiaomu AI RSS](https://github.com/joeseesun/qiaomu-ai-rss) API. AI conversations use the host's configured model and account. Obsidian note, highlight-saving, and daily-note features are intentionally absent. Source is licensed under [GPL-3.0-only](LICENSE); the bundled blog list retains its separate MIT notice.