dsh-news

中文 · English

> ⏳ Still staring at the progress bar? > > Long-running DSH tasks — crawling, training, batch processing — can take minutes or more. Instead of waiting idly, turn that waiting time into reading time: > > Open "News" in the sidebar and catch up on world news · AI-model updates · science explainers · history facts — all in one modal. Articles are readable right inside the GUI (no external jumps), with one-click Chinese ⇄ English translation of titles and full text, plus support for custom RSS sources — all without leaving your workflow. > > When your task finishes, you've already caught up with the world. 🌍

A news plugin for the DSH Web GUI: a sidebar entry opens a modal that aggregates world news, science, history and AI-model news from public RSS feeds, with in-place reading (no external jumps).

!DSH Web GUI !License !npm

Preview


---

Table of Contents

• [Features](#features)
• [Installation](#installation)
• [Usage](#usage)
• [Custom RSS Sources](#custom-rss-sources)
• [Built-in Sources](#built-in-sources)
• [Architecture](#architecture)
• [Development](#development)
• [Disclaimer](#disclaimer)
• [License](#license)

Features

Installation

Option 1: npm (Recommended)

npm i @wilond/dsh-news
dsh plugin --profile web add @wilond/dsh-news

Restart dsh web after installing (Ctrl+C, then dsh web again) and refresh the browser — the "News" entry appears in the sidebar.

Option 2: From a local checkout

git clone https://github.com/SongChengMing1/dsh-news.git
cd dsh-news
pnpm install
pnpm build
dsh plugin --profile web add link:$PWD

> When developing locally, every code change requires a re-run of pnpm build (Host half) and a dsh web restart (Client half).

Uninstall

dsh plugin --profile web remove @wilond/dsh-news

Usage

1. Click the "News" entry in the sidebar to open the modal. 2. Switch categories in the top bar (All / World / AI / Science / History); use "↻" to force-refresh (bypasses the cache). 3. Toggle "Translate list" at the top of the list: cards in view are auto-translated as you scroll (title + summary; failed cards show "Retry"; toggle off to restore the original). With the toggle on, opening an article also auto-translates its title + full text (use "Show original" to switch back; when the toggle is off, click "Translate" manually). The "Open original" link at the bottom opens the source site in a new tab. 4. Click "⚙" for settings: enable/disable built-in sources, add custom sources, adjust the refresh interval (minutes), image proxy, summary-only mode, and RSSHub instance.

Settings are stored in browser localStorage (key dsh.news.config.v1) and shared across tabs.

Custom RSS Sources

Beyond the built-in feeds, any public RSS / Atom URL can be added. Here's an example with Hacker News:

1. Open the news modal and click "⚙" in the top-right corner to enter Settings. 2. In the Custom sources section, fill in:

3. Click "Add source", then "Save" — back in the list you'll see the new source's content. In-place reading and translation work on it just the same.

More ready-to-use example feeds:

> Tips: > > - The URL must start with http:// or https://; duplicate URLs are rejected. > - For sites without a native RSS feed, generate one with a self-hosted RSSHub instance and add that feed URL. > - Custom sources and all settings live in browser localStorage (key dsh.news.config.v1), shared across tabs.

Built-in Sources

> Note: all sources below are public RSS/Atom feeds; individual feeds may be temporarily unavailable due to site redesigns, anti-bot measures or network conditions — the UI shows a per-source degradation notice. Disable them in settings, or replace them via custom sources / RSSHub routes.

🌍 World News (5)

🔬 Science (4)

🏛️ History (2)

🤖 AI-Model News (6)

Architecture

┌─ Browser (Client) ───────────────────────┐   ┌─ DSH Host process ──────────────────┐
│ Sidebar entry: DOM injection + observer  │   │ /news/feed    batch fetch + parse   │
│ Modal (React): list / reading / settings │──▶│ /news/article extract + sanitize    │
│ localStorage: dsh.news.config.v1         │   │ /news/img     image proxy (hotlink) │
│ i18n: en/zh (dsh-client-locale)          │   │ Cache: memory LRU + disk            │
└──────────────────────────────────────────┘   │ systemPrompt section (toggleable)   │
                                                  └─────────────────────────────────────┘

• The Host keeps no business state: configuration lives in the Client (localStorage) and the source list is submitted with each fetch request; cache keys are source URLs, so multiple tabs stay consistent naturally.
• All Client fetching goes through Host routes (bypassing browser CORS and source-site hotlink protection).
• Host routes share the /news/* prefix; SSRF protection + proxy awareness (respects HTTPS_PROXY / NO_PROXY environment variables).

Development

pnpm typecheck   # tsc --noEmit
pnpm test        # vitest run (68 tests: guard/cache/rss/article/routes/config/feed-state/reading)
pnpm build       # tsdown → lib/ (host ESM + client ModuleLoader bundle)
node scripts/smoke-host.mjs      # real-network acceptance (3 routes + SSRF + cache)
node scripts/verify-articles.mjs # read-through verification on major sources

Disclaimer

• Lists are mainly "title + summary + source link"; article bodies are only a temporary reading cache (24h expiry) — no permanent archiving, no redistribution / export.
• Please respect each source's robots protocol and terms of use; if heavy usage triggers source-side risk control, disable the corresponding source in settings.
• This plugin is not affiliated with any content source; all content copyright belongs to the original authors / sites.
• The public RSSHub instance (rsshub.app) is rate-limited; this plugin does not depend on public instances — configure a self-hosted instance if needed.

License

BSD-3-Clause. See [LICENSE](LICENSE).