dsh-rss 0.7.1 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 更新记录
 
+## 0.9.0 (2026-10-26)
+
+- Add this plugin’s own update controls and independent preferences. Automatic installation stays off until explicitly enabled.
+- Confirm manual installs, preserve local sources and disabled state, pause for tasks or unsaved changes, and use native DSH recovery without forced restarts.
+- Require the public DSH 0.2.1-rc.3 update APIs; Suite components remain managed through Suite.
+
+## 0.8.0（2026-10-25）
+
+- RSS 主工作台，订阅与目录分区、来源详情与分类清楚展示；保存的来源可主动预览最多五篇文章。
+- 提供 DSH 原生侧栏入口，保留设置页；统一中英、深浅色、窄屏、键盘焦点与真实空/失败状态。
+- 浏览器源码移至 templates/client.js、templates/panels/ 与共享组件，独立构建为 lib/client.js；移除重复的首次引导。
+- 官方 DSH 0.2.1-rc.3 Web 逐项实际操作验收，账户模拟和未验收范围见 [工作台说明](docs/WORKBENCH.md)。
+
 ## 0.7.1（2026-10-25）
 
 - 修复 #3：RSS / Atom 摘要、正文和订阅描述含大量不闭合的尖括号时，文本清理不再反复扫描剩余内容，避免阻塞 DSH 的其他请求。

package/README.en.md

@@ -13,6 +13,8 @@ Feedback and contributions are welcome: report [issues](https://github.com/STARD
 
 See the [0.6.3 validation record](docs/validation-0.6.3.md) for DSH `0.2.1-alpha.5` checks and the narrow-window layout fix.
 
+Open the new native sidebar workbench after updating and restarting DSH. Settings remains available. See the [workbench guide and validation boundaries](docs/WORKBENCH.md).
+
 ## What it does
 
 - Add feeds, read articles and fetch updates.
@@ -43,10 +45,17 @@ Detailed configuration, tool arguments and troubleshooting are in the [usage gui
 ## Documentation
 
 - [Usage and troubleshooting](docs/USAGE.en.md)
+- [Suggest a feed and catalog criteria](docs/CATALOG.md)
 - [Changelog](CHANGELOG.md)
 - [Validation scope and history](docs/VALIDATION.md)
 - [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-rss/issues)
 
+## Plugin updates
+
+Requires DSH 0.2.1-rc.3 or newer. Each plugin provides its own check, release-note and confirmed-install controls on its page or in settings. Preferences are independent. Automatic checks are on by default; **automatic installation is off by default**. Explicitly enabled automatic updates only install compatible stable patches while idle with no unsaved changes. Disable, defer or ignore reminders per plugin. DSH is never restarted or upgraded automatically, and local-source installs are preserved. Suite components clearly direct updates through Suite.
+
+Older releases need one manual update in native plugin management to acquire these controls. Publishing to npm does not replace an existing user installation.
+
 ## License
 
 [MIT](LICENSE)

package/README.md

@@ -13,6 +13,8 @@
 
 本轮 DSH `0.2.1-alpha.5` 操作与窄窗口修复见 [0.6.3 验收记录](docs/validation-0.6.3.md)。
 
+更新并重启 DSH 后，可从原生侧栏打开新版工作台，原设置入口继续保留。详见[工作台说明与验收范围](docs/WORKBENCH.md)。
+
 ## 功能
 
 - 添加订阅、查看文章和抓取更新。
@@ -43,10 +45,17 @@ dsh plugin --profile desktop add dsh-rss
 ## 文档
 
 - [使用与排错](docs/USAGE.md)
+- [推荐订阅源与收录说明](docs/CATALOG.md)
 - [更新记录](CHANGELOG.md)
 - [验证范围与历史记录](docs/VALIDATION.md)
 - [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-rss/issues)
 
+## 插件更新
+
+需要 DSH 0.2.1-rc.3 或更新版本。每个插件在自己的页面或设置项提供检查、更新记录与确认安装入口，开关独立保存。自动检查默认开启；**自动安装默认关闭**，只有明确授权后，兼容的稳定补丁才会在空闲且没有未保存修改时安装。可单独关闭、推迟或忽略提醒；不会强制重启 DSH、升级 DSH 本体或替换本地源码安装。Suite 安装的组件会明确提示通过 Suite 整包更新。
+
+旧版用户先在官方插件管理中手动更新一次，之后才会获得此入口。发布到 npm 不会直接替换用户已经安装的版本。
+
 ## License
 
 [MIT](LICENSE)

package/docs/CATALOG.md

@@ -0,0 +1,15 @@
+# 订阅源推荐目录
+
+推荐目录提供订阅入口，让用户自己选择要添加的内容。已有分类包括科技、开发、研究、产品等；中文和英文来源都可以推荐，独立出版者也可以提交。
+
+建议在 issue 中提供：站点名称、官方主页、官方 RSS/Atom 地址、内容语言、一句话介绍和适合的分类。维护者会检查地址是否可用、是否确为该站点提供的订阅源，以及内容是否与目录分类相符。站点暂时没有订阅地址时，先保留建议，不推测或抓取非公开接口。
+
+目录只收录站点名称、简短介绍和官方链接。推荐项不收费、不排他，出版者可要求更正或移除；收录不代表取得文章、图片或付费内容的转载、翻译许可。用户添加订阅后的内容使用，应遵循原站点说明。
+
+请勿在 issue 中提供私人订阅令牌、付费专属链接或账号凭据。
+
+## English
+
+The optional discovery catalog accepts Chinese and English feeds, including independent publishers. Suggest the site name, official homepage, official RSS/Atom URL, language, a short description and a suitable category through an issue. We check the feed and its relationship to the publisher; we do not guess private endpoints when no feed is provided.
+
+Listings contain only site metadata and official links. They are free, nonexclusive and may be corrected or removed on request. Listing does not grant rights to reproduce or translate articles, images or paid content. Never submit private feed tokens or credentials.

package/docs/WORKBENCH.md

@@ -0,0 +1,29 @@
+# dsh-rss 工作台 / Workbench
+
+RSS 主工作台，订阅与目录分区、来源详情与分类清楚展示；保存的来源可主动预览最多五篇文章。
+
+RSS workbench with subscriptions, discovery, categories and source details; manually preview up to five articles from saved feeds.
+
+## 使用 / Use
+
+更新插件并重启 DSH，在原生左侧栏打开工作台；没有固定时可在“更多”中找到。原有“设置”入口继续可用。侧栏排序和固定由 DSH 管理。
+
+Update the plugin, restart DSH and open its native sidebar panel (or More if it is not pinned). The existing Settings entry remains available. DSH owns sidebar order and pinning.
+
+界面跟随宿主中英文和深浅色，保留用户内容原文。窄窗口中先显示列表，打开详情后可返回；编辑器按可用宽度分栏或顺序排列。危险操作需要明确确认，未保存内容不会因切页而静默丢失。
+
+The UI follows host language and theme without translating user content. Narrow master/detail views have a Back action; editors adapt their columns to available space. Destructive actions require confirmation and edits are protected.
+
+## 源码 / Source
+
+编辑 templates/client.js、templates/panels/*.js 与 templates/workbench-ui.js，运行 pnpm run build。lib/client.js 是确定性产物，请随源码提交。公共组件的规范源位于 dsh-suite/ui/workbench-ui.js，Suite 的同步脚本显式分发副本；单个仓库可独立构建和安装。
+
+Edit the template sources and run pnpm run build. Commit generated lib/client.js with source changes. The vendored UI has no Suite runtime dependency.
+
+## 验收范围 / Validation boundary
+
+2026-10-25：Windows、官方 DSH 0.2.1-rc.3 Web，后台 Chrome/Playwright 实际点击和输入；覆盖中英文、浅深色、1536px 与 390px、状态读回与控制台。Browser plugin 不可用，因此使用本地 Playwright。
+
+邮件使用受控 AgentMail HTTP 服务，日历使用受控 CalDAV 协议传输；插件处理器、存储、校验和原生宿主均实际运行。未使用真实邮箱、真实日历账号或付费模型。RSS 访问 Node.js 官方公开来源。PPT 实际生成并渲染 PPTX、下载 ZIP；两个视频插件实际运行官方引擎并播放 MP4。
+
+这些是 Web 共用界面的验收结果，不代表已验收 Electron 专属菜单、系统权限、真实账号、全部外部来源或所有可选模型/引擎。Docker、Slack、钉钉继续按用户约定搁置。