rss-pal-dsh 0.0.0-stage → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.en.md +134 -0
- package/README.md +135 -2
- package/cordis.patch.yml +3 -0
- package/docs/native-build.md +35 -0
- package/docs/screenshots/read-menu-mobile.png +0 -0
- package/lib/client.js +48682 -0
- package/lib/index.js +1511 -0
- package/package.json +122 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 MoreFreeze
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.en.md
ADDED
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
# RSS Pal for DeepSeek Harness
|
|
2
|
+
|
|
3
|
+
[简体中文](README.md) · **English**
|
|
4
|
+
|
|
5
|
+
**A local-first reading room inside DSH: RSS subscriptions, full-text search, bulk read marking, on-demand AI summaries and a native reading companion.**
|
|
6
|
+
|
|
7
|
+
- Repository: <https://github.com/morefreeze/dsh-plugin-rss-pal>
|
|
8
|
+
- Plugin package: `rss-pal-dsh` · Version: `0.1.2`
|
|
9
|
+
- Marketplace category: **Data & Knowledge (knowledge)**
|
|
10
|
+
- License: [MIT](LICENSE)
|
|
11
|
+
- A community plugin, not affiliated with DeepSeek AI.
|
|
12
|
+
|
|
13
|
+
## Features
|
|
14
|
+
|
|
15
|
+
- RSS / Atom subscription previews, groups, pause/resume, scheduled and manual refresh, and OPML import/export.
|
|
16
|
+
- Webpage full-text extraction and refetching, Chinese full-text search, pagination, favorites, tags, likes and dislikes.
|
|
17
|
+
- A three-dot menu on each article: mark this article, this article and everything above, or this article and everything below as read. Ranges include the current article and span pages within the current subscription, filter, search and tag scope, while preserving a nearby list anchor.
|
|
18
|
+
- Foreground reading time, open counts and progress. Tracking pauses when the window is hidden, loses focus, or receives no activity for 120 seconds.
|
|
19
|
+
- On-demand brief summaries and detailed analysis, with templates, streaming background jobs, cached results and stale-summary indicators when article content changes.
|
|
20
|
+
- An independently remembered summary-model selection, following the host default initially. Reasoning options reflect the host model's actual capabilities; selecting a summary model does not change the host's global default.
|
|
21
|
+
- Native DSH reading companion for whole articles and selected passages, using the host's model picker, composer and conversations.
|
|
22
|
+
- URL clipping, Markdown export, local backup/restore, job retry/cancellation and Agent tools.
|
|
23
|
+
|
|
24
|
+
**Models are called only when you click Generate or explicitly invoke the summary tool.** Opening articles, refreshing feeds and searching do not automatically generate summaries. Ordinary reading requires no model account.
|
|
25
|
+
|
|
26
|
+
## Screenshot
|
|
27
|
+
|
|
28
|
+

|
|
29
|
+
|
|
30
|
+
An actual DSH Web screenshot at mobile width, showing the article action menu. Host conversation lists and account information are excluded.
|
|
31
|
+
|
|
32
|
+
## Installation
|
|
33
|
+
|
|
34
|
+
### Install from GitHub — current distribution channel
|
|
35
|
+
|
|
36
|
+
```sh
|
|
37
|
+
dsh plugin --profile web add github:morefreeze/dsh-plugin-rss-pal
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
The repository includes prebuilt `lib/index.js` and `lib/client.js`, so installing the plugin does not require compiling its source. `better-sqlite3` is a native dependency: if the installer requests build approval, approve the native build for that dependency only. Enable **RSS Pal** in the plugin manager and refresh the page. New Host modules require reloading the plugin or the host.
|
|
41
|
+
|
|
42
|
+
### Install a release package
|
|
43
|
+
|
|
44
|
+
Download `rss-pal-dsh-0.1.2.tgz` from [GitHub Releases](https://github.com/morefreeze/dsh-plugin-rss-pal/releases):
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
dsh plugin --profile web add ./rss-pal-dsh-0.1.2.tgz
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Install from npm
|
|
51
|
+
|
|
52
|
+
`rss-pal-dsh@0.1.0` is published on [npm](https://www.npmjs.com/package/rss-pal-dsh):
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
dsh plugin --profile web add rss-pal-dsh
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
The latest GitHub Release is `0.1.2`; npm publication verification for `0.1.2` is pending. Marketplace listings and one-click installation remain subject to each marketplace's checks. New features on GitHub main may precede npm releases; the GitHub install above includes the latest source and committed builds.
|
|
59
|
+
|
|
60
|
+
## Feedback and public download reports
|
|
61
|
+
|
|
62
|
+
The sidebar's **反馈与建议 (Feedback)** entry links to [bug reports](https://github.com/morefreeze/dsh-plugin-rss-pal/issues/new?template=bug-report.yml), [feature requests](https://github.com/morefreeze/dsh-plugin-rss-pal/issues/new?template=feature-request.yml) and [existing issues](https://github.com/morefreeze/dsh-plugin-rss-pal/issues). Include plugin/DSH versions, your environment and reproduction steps; redact screenshots and logs. The plugin never uploads diagnostics, subscriptions, articles or conversations automatically.
|
|
63
|
+
|
|
64
|
+
The [download report](docs/reports/downloads.md) shows npm downloads for the last 30 complete UTC days, GitHub Release asset downloads and stars/forks/issues. GitHub Actions generates it daily and supports manual runs. Failed sources are marked unknown, not zero. **Downloads are not unique users or active users; npm and Release counts must not be added as a user count.** Only the repository-side script queries public statistics; installed plugins remain telemetry-free.
|
|
65
|
+
|
|
66
|
+
```sh
|
|
67
|
+
node scripts/download-report.mjs
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Compatibility and runtime requirements
|
|
71
|
+
|
|
72
|
+
| Item | Requirement / verification scope |
|
|
73
|
+
| --- | --- |
|
|
74
|
+
| DSH profile | `web` |
|
|
75
|
+
| Declared DSH range | `>=0.2.1-rc.5 <0.3.0-0` (host matches prereleases explicitly) |
|
|
76
|
+
| Runtime-tested environment | macOS, DeepSeek Harness `0.2.1-rc.5` Web |
|
|
77
|
+
| Node.js | `>=22.19.0`; the selected DSH release may require a newer version |
|
|
78
|
+
| Database | Local SQLite through the `better-sqlite3` native module |
|
|
79
|
+
| Other environments | Windows, Linux, Desktop and DSH `0.2.2-rc.1` have not been runtime-tested |
|
|
80
|
+
|
|
81
|
+
## Permissions, external services and data
|
|
82
|
+
|
|
83
|
+
- The Host reads and writes the SQLite library and pre-restore backups under `storages/rss-pal-dsh/` in Harness home. Uninstalling the plugin preserves reading data.
|
|
84
|
+
- Network access is used for user-added RSS / Atom feeds, webpages and remote images in article content. Full-text extraction depends on the source site's content and access conditions.
|
|
85
|
+
- On-demand summarization sends article content to the selected host model. The reading companion uses host conversations and model configuration; model services may incur charges.
|
|
86
|
+
- No additional account system, separate model credentials, telemetry or cloud synchronization. The original RSS Pal server, Go, PostgreSQL and Docker are not required.
|
|
87
|
+
- Feeds refresh every 60 minutes by default; set the interval to `0` to disable scheduled refresh. Refresh runs only while the host is running. Pausing a subscription preserves its articles.
|
|
88
|
+
- Backups contain subscriptions, article content, reading history and summaries, but not host model credentials. Restore validates the input, replaces data transactionally and preserves a pre-restore backup. Running jobs must finish or be cancelled first.
|
|
89
|
+
|
|
90
|
+
This version does not include personalized recommendations, daily/weekly digests, audio/video subtitles, PDF / OCR, public sharing or a browser extension.
|
|
91
|
+
|
|
92
|
+
## Agent tools
|
|
93
|
+
|
|
94
|
+
`rsspal_list_feeds`, `rsspal_list_articles`, `rsspal_read_article`, `rsspal_search`, `rsspal_subscribe`, `rsspal_refresh`, `rsspal_capture`, `rsspal_summarize`, `rsspal_jobs`, `rsspal_set_state`, `rsspal_export_markdown`.
|
|
95
|
+
|
|
96
|
+
Agent reads do not count toward human reading time. The summary tool should be invoked only when explicitly requested by the user.
|
|
97
|
+
|
|
98
|
+
## Development and testing
|
|
99
|
+
|
|
100
|
+
The four official development peers are pinned to `0.2.2-rc.3`, so a clean install is sufficient. Keep native dependency install scripts enabled:
|
|
101
|
+
|
|
102
|
+
```sh
|
|
103
|
+
npm ci --include=dev --registry=https://registry.npmjs.org
|
|
104
|
+
npm run check
|
|
105
|
+
npm run test:report
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
[Public CI](https://github.com/morefreeze/dsh-plugin-rss-pal/actions/workflows/check.yml) covers Ubuntu/macOS/Windows, Node 22.19/24 and DSH peers 0.2.1-rc.5/0.2.2-rc.3. Actual workflow results determine which environments passed. Windows uses the CI step's NODE_ENV environment and direct `node --import tsx --test` command instead of POSIX inline variable assignment.
|
|
109
|
+
|
|
110
|
+
The native SQLite dependency remains; the plugin does not change user build policy. Approve only better-sqlite3 when the manager reports build-blocked. See [build approval, manual repair and FTS5 verification](docs/native-build.md).
|
|
111
|
+
|
|
112
|
+
The `@deepseek-ai` runtime dependencies are provided by DSH. For development, also install the following four packages at the same version as your target DSH release:
|
|
113
|
+
|
|
114
|
+
```sh
|
|
115
|
+
npm install --include=dev --save-dev --package-lock=false \
|
|
116
|
+
@deepseek-ai/dsh-tools@0.2.1-rc.5 \
|
|
117
|
+
@deepseek-ai/dsh-llm@0.2.1-rc.5 \
|
|
118
|
+
@deepseek-ai/dsh-home-paths@0.2.1-rc.5 \
|
|
119
|
+
@deepseek-ai/dsh-typert-protocol@0.2.1-rc.5
|
|
120
|
+
npm run check
|
|
121
|
+
npm pack
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
`npm run check` performs type checking, Host / Client builds and the full regression suite.
|
|
125
|
+
|
|
126
|
+
The Host entry is the Cordis `RssPalService` plugin class. The Web Client exports `apply(ctx)` from `src/client/index.tsx`, registering the RSS Pal panel, Remote methods and native companion. The client includes KaTeX styles and fonts, without an additional formula-font service.
|
|
127
|
+
|
|
128
|
+
## Verification
|
|
129
|
+
|
|
130
|
+
Current local regression baseline: **90 plugin tests and 11 report tests passing** (macOS, Node 22.19, DSH 0.2.2-rc.3 peers; not a new full-host Web acceptance run), covering transactional read ranges, filter isolation, pagination/filter navigation during pending writes, reading tracking, explicit summary generation and model selection. Desktop and mobile-width layouts, single-article read-state RPC and the native reading companion have been verified in actual DSH Web.
|
|
131
|
+
|
|
132
|
+
## Acknowledgments
|
|
133
|
+
|
|
134
|
+
Inspired by RSS Pal. Article extraction and sanitization use Mozilla Readability, DOMPurify and other open-source projects. Dependencies retain their respective licenses.
|
package/README.md
CHANGED
|
@@ -1,3 +1,136 @@
|
|
|
1
|
-
#
|
|
1
|
+
# RSS Pal for DeepSeek Harness
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**简体中文** · [English](README.en.md)
|
|
4
|
+
|
|
5
|
+
**DSH 内的本地 RSS 阅读室:订阅、全文搜索、批量已读、手动 AI 总结与原生伴读。**
|
|
6
|
+
|
|
7
|
+
A local-first RSS/Atom reader for DeepSeek Harness, with full-text search, on-demand AI summaries and a native reading companion.
|
|
8
|
+
|
|
9
|
+
- 仓库:<https://github.com/morefreeze/dsh-plugin-rss-pal>
|
|
10
|
+
- 插件包名:`rss-pal-dsh` · 版本:`0.1.2`
|
|
11
|
+
- 市场能力分类:**Data & Knowledge (knowledge) / 数据与知识**
|
|
12
|
+
- 许可证:[MIT](LICENSE)
|
|
13
|
+
- 社区插件,与 DeepSeek AI 官方无隶属关系。
|
|
14
|
+
|
|
15
|
+
## 功能
|
|
16
|
+
|
|
17
|
+
- RSS / Atom 订阅预览、分组、暂停、定时与手动刷新,OPML 导入导出。
|
|
18
|
+
- 网页全文提取与重抓、中文全文搜索、分页、收藏、标签、点赞与不喜欢。
|
|
19
|
+
- 每篇文章的三点菜单:标记已读、标记这篇及以上 / 以下已读。范围包含本篇,按当前订阅、筛选、搜索、标签跨分页计算,并保留附近列表锚点。
|
|
20
|
+
- 前台活跃阅读时长、次数与进度;隐藏窗口、失焦及连续 120 秒无操作时暂停计时。
|
|
21
|
+
- 手动生成简短摘要和详细分析,支持模板、流式后台任务、结果缓存与正文变化标记。
|
|
22
|
+
- 总结模型独立选择并记忆,默认跟随宿主;推理强度按宿主真实模型能力显示,不修改宿主全局默认模型。
|
|
23
|
+
- 文章与选段接入 DSH 原生伴读,使用原生模型选择、输入框和会话。
|
|
24
|
+
- URL 网摘、Markdown 导出、本地备份恢复、任务重试 / 取消及 Agent 工具。
|
|
25
|
+
|
|
26
|
+
**只有用户点击生成或明确调用总结工具时才调用模型。** 打开文章、刷新订阅和搜索不自动生成总结。普通阅读无需模型账号。
|
|
27
|
+
|
|
28
|
+
## 截图
|
|
29
|
+
|
|
30
|
+

|
|
31
|
+
|
|
32
|
+
实际 DSH Web 手机宽度截图,展示三点菜单;未包含宿主会话列表或账号信息。
|
|
33
|
+
|
|
34
|
+
## 安装
|
|
35
|
+
|
|
36
|
+
### 从 GitHub 安装(当前发布渠道)
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
dsh plugin --profile web add github:morefreeze/dsh-plugin-rss-pal
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
仓库包含预构建的 `lib/index.js` 和 `lib/client.js`,安装时无需编译插件源码。`better-sqlite3` 是原生依赖;安装器提示构建审批时,只为该依赖允许原生构建。安装完成后在插件管理中启用 **RSS Pal**,刷新页面;新增 Host 模块需重载对应插件或宿主。
|
|
43
|
+
|
|
44
|
+
### 发布包安装
|
|
45
|
+
|
|
46
|
+
从 [GitHub Releases](https://github.com/morefreeze/dsh-plugin-rss-pal/releases) 下载 `rss-pal-dsh-0.1.2.tgz`:
|
|
47
|
+
|
|
48
|
+
```sh
|
|
49
|
+
dsh plugin --profile web add ./rss-pal-dsh-0.1.2.tgz
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### 从 npm 安装
|
|
53
|
+
|
|
54
|
+
`rss-pal-dsh@0.1.0` 已发布到 [npm](https://www.npmjs.com/package/rss-pal-dsh):
|
|
55
|
+
|
|
56
|
+
```sh
|
|
57
|
+
dsh plugin --profile web add rss-pal-dsh
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
GitHub Release 最新版本为 `0.1.2`;npm 的 `0.1.2` 发布验证进行中。市场的收录及一键安装状态取决于各市场核验。GitHub main 中的新功能可能先于 npm 发布;上方 GitHub 安装方式可取得最新源码及预构建产物。
|
|
61
|
+
|
|
62
|
+
## 反馈与公开下载报表
|
|
63
|
+
|
|
64
|
+
插件侧栏的 **反馈与建议** 提供[问题反馈](https://github.com/morefreeze/dsh-plugin-rss-pal/issues/new?template=bug-report.yml)、[功能建议](https://github.com/morefreeze/dsh-plugin-rss-pal/issues/new?template=feature-request.yml)与[已有反馈](https://github.com/morefreeze/dsh-plugin-rss-pal/issues)。请注明插件/DSH 版本、系统与复现步骤,并对截图和日志脱敏;插件不会自动上传诊断、订阅、文章或聊天。
|
|
65
|
+
|
|
66
|
+
[下载统计报表](docs/reports/downloads.md)展示最近 30 个完整 UTC 日的 npm 下载趋势、GitHub Release 文件下载及 Star/Fork/Issue。GitHub Actions 每天生成,也支持手动触发;来源失败会标明未知,不填成 0。**下载次数不代表独立用户或活跃人数,npm 与 Release 不相加当人数。** 仅仓库侧脚本访问公开统计接口,用户安装的插件保持无遥测。
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
node scripts/download-report.mjs
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## 兼容与运行要求
|
|
73
|
+
|
|
74
|
+
| 项目 | 要求 / 验证范围 |
|
|
75
|
+
| --- | --- |
|
|
76
|
+
| DSH profile | `web` |
|
|
77
|
+
| DSH 版本声明 | `>=0.2.1-rc.5 <0.3.0-0`(宿主包含预发布版本匹配) |
|
|
78
|
+
| 实机验收 | macOS、DeepSeek Harness `0.2.1-rc.5` Web |
|
|
79
|
+
| Node.js | `>=22.19.0`;使用的 DSH 版本可能要求更高版本 |
|
|
80
|
+
| 数据库 | 本地 SQLite / `better-sqlite3` 原生模块 |
|
|
81
|
+
| 其他平台 | Windows、Linux、Desktop 和 `0.2.2-rc.1` 尚未实机验收 |
|
|
82
|
+
|
|
83
|
+
## 权限、外部服务与数据
|
|
84
|
+
|
|
85
|
+
- Host 读写 Harness home 下 `storages/rss-pal-dsh/` 的 SQLite 资料库与恢复前备份;卸载插件保留阅读数据。
|
|
86
|
+
- 网络访问用户添加的 RSS / Atom 源、网页及正文中的远程图片;全文提取取决于目标网页的内容和访问条件。
|
|
87
|
+
- 手动总结将文章内容发送到用户选择的宿主模型;伴读使用宿主会话和模型配置,模型服务可能计费。
|
|
88
|
+
- 不新增账号系统、独立模型凭据、遥测或云端同步;无需原 RSS Pal 服务、Go、PostgreSQL 或 Docker。
|
|
89
|
+
- 默认 60 分钟刷新,设为 `0` 可关闭;仅在宿主运行时执行,暂停订阅保留文章。
|
|
90
|
+
- 备份包含订阅、正文、阅读历史和总结,不包含宿主模型凭据。恢复校验输入并事务替换,保留恢复前备份;运行任务需先结束或取消。
|
|
91
|
+
|
|
92
|
+
当前版本不含兴趣推荐、日报周报、音视频字幕、PDF / OCR、公开分享或浏览器扩展。
|
|
93
|
+
|
|
94
|
+
## Agent 工具
|
|
95
|
+
|
|
96
|
+
`rsspal_list_feeds`、`rsspal_list_articles`、`rsspal_read_article`、`rsspal_search`、`rsspal_subscribe`、`rsspal_refresh`、`rsspal_capture`、`rsspal_summarize`、`rsspal_jobs`、`rsspal_set_state`、`rsspal_export_markdown`。
|
|
97
|
+
|
|
98
|
+
Agent 阅读不会计入人类阅读时长。总结工具只在用户明确要求时调用。
|
|
99
|
+
|
|
100
|
+
## 开发与测试
|
|
101
|
+
|
|
102
|
+
官方四个开发依赖已固定到 `0.2.2-rc.3`,一次安装即可复现检查。依赖安装需允许 `better-sqlite3` 的正常原生构建:
|
|
103
|
+
|
|
104
|
+
```sh
|
|
105
|
+
npm ci --include=dev --registry=https://registry.npmjs.org
|
|
106
|
+
npm run check
|
|
107
|
+
npm run test:report
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
[公开 CI](https://github.com/morefreeze/dsh-plugin-rss-pal/actions/workflows/check.yml)覆盖 Ubuntu/macOS/Windows、Node 22.19/24、DSH peers `0.2.1-rc.5`/`0.2.2-rc.3`。矩阵是否通过以工作流实际结果为准。Windows 使用 CI 中的 `NODE_ENV: test` 与 `node --import tsx --test` 命令,不使用 POSIX 内联变量语法。
|
|
111
|
+
|
|
112
|
+
保留原生 SQLite,不自动放宽用户构建策略;商店提示 `build-blocked` 时仅批准该依赖。[构建审批、手动修复与 FTS5 验证步骤](docs/native-build.md)。
|
|
113
|
+
|
|
114
|
+
宿主 `@deepseek-ai` 依赖由 DSH 提供,开发时还需在当前项目安装与目标 DSH 同版的 `dsh-tools`、`dsh-llm`、`dsh-home-paths`、`dsh-typert-protocol` 四个包:
|
|
115
|
+
|
|
116
|
+
```sh
|
|
117
|
+
npm install --include=dev --save-dev --package-lock=false \
|
|
118
|
+
@deepseek-ai/dsh-tools@0.2.1-rc.5 \
|
|
119
|
+
@deepseek-ai/dsh-llm@0.2.1-rc.5 \
|
|
120
|
+
@deepseek-ai/dsh-home-paths@0.2.1-rc.5 \
|
|
121
|
+
@deepseek-ai/dsh-typert-protocol@0.2.1-rc.5
|
|
122
|
+
npm run check
|
|
123
|
+
npm pack
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
`npm run check` 执行类型检查、Host / Client 构建与全部回归测试。
|
|
127
|
+
|
|
128
|
+
Host 入口为 Cordis `RssPalService` 插件类;Web Client 在 `src/client/index.tsx` 导出 `apply(ctx)`,注册 RSS Pal 面板、Remote 与原生伴读。客户端包含 KaTeX 样式与字体,无需额外公式字体服务。
|
|
129
|
+
|
|
130
|
+
## 验证
|
|
131
|
+
|
|
132
|
+
当前本地回归:**90 项插件测试 + 11 项报告测试通过**(macOS、Node 22.19、DSH `0.2.2-rc.3` peers;不是新宿主 Web 全流程验收),包括事务范围已读、筛选隔离、待写入期间翻页 / 切筛选竞态、阅读追踪、手动总结与模型选择。已在真实 DSH Web 验证桌面和手机布局、单篇已读 RPC 与原生伴读。
|
|
133
|
+
|
|
134
|
+
## 致谢
|
|
135
|
+
|
|
136
|
+
产品灵感来自 RSS Pal;正文提取与清洗使用 Mozilla Readability、DOMPurify 等开源项目。依赖各自遵循其许可证。
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Native SQLite installation / 原生 SQLite 安装
|
|
2
|
+
|
|
3
|
+
RSS Pal currently uses `better-sqlite3`, a required native dependency. The plugin's prebuilt JavaScript does **not** include a cross-platform `.node` binding. A package appearing in the plugin manager is not proof that its native dependency built successfully.
|
|
4
|
+
|
|
5
|
+
## DSH marketplace build approval
|
|
6
|
+
|
|
7
|
+
When DSH reports `build-blocked` or `ERR_PNPM_IGNORED_BUILDS`, use its build-review prompt and approve **better-sqlite3 only**. Do not approve unrelated package scripts. Retry/complete the install through the same manager after approval, then reload RSS Pal or restart the host and refresh the page. On older managers with no review prompt, use the manual repair below. The plugin does not edit your profile's build policy automatically.
|
|
8
|
+
|
|
9
|
+
## Manual repair in the actual profile directory
|
|
10
|
+
|
|
11
|
+
Locate the **profile package/workspace directory used by this installation** in DSH's plugin-manager diagnostics. Do not run these commands in the plugin source checkout or guess a profile path. Use the same Node and pnpm binaries as the host.
|
|
12
|
+
|
|
13
|
+
```sh
|
|
14
|
+
# Replace /absolute/path/to/profile with the actual profile directory.
|
|
15
|
+
pnpm --dir /absolute/path/to/profile approve-builds better-sqlite3
|
|
16
|
+
pnpm --dir /absolute/path/to/profile rebuild better-sqlite3
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
The named-approval form is available in pnpm 11.2.2. If your pnpm only supports the interactive approval UI, run `pnpm --dir /absolute/path/to/profile approve-builds` and select only `better-sqlite3`. Inspect the resulting workspace policy rather than adding a blanket allow-all setting.
|
|
20
|
+
|
|
21
|
+
If a compatible prebuilt binary is unavailable, better-sqlite3 falls back to node-gyp compilation: Python and a C/C++ build toolchain are required (Xcode Command Line Tools on macOS, a compiler/make on Linux, Visual Studio C++ Build Tools on Windows). Follow the actual build error. Changing the host Node major version may require rebuilding the binding.
|
|
22
|
+
|
|
23
|
+
## Verify from the profile
|
|
24
|
+
|
|
25
|
+
Use a terminal in the profile directory and the host Node binary:
|
|
26
|
+
|
|
27
|
+
```sh
|
|
28
|
+
node --input-type=module -e "import { createRequire } from 'node:module'; const require=createRequire(import.meta.url); const pluginRequire=createRequire(require.resolve('rss-pal-dsh')); const Database=pluginRequire('better-sqlite3'); const db=new Database(':memory:'); db.exec('CREATE VIRTUAL TABLE check_fts USING fts5(text)'); db.prepare('INSERT INTO check_fts VALUES (?)').run('RSS Pal'); console.log(db.prepare(\"SELECT text FROM check_fts WHERE check_fts MATCH 'RSS'\").all()); db.close();"
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Expected output contains `RSS Pal`. This is a disposable in-memory database and does not read or change your library. An error here means native installation is not complete; preserve the build log and report your OS, Node, pnpm and DSH versions, without private profile data.
|
|
32
|
+
|
|
33
|
+
## 开发与验收
|
|
34
|
+
|
|
35
|
+
当前方案保留 `better-sqlite3`,通过商店构建审批或上述手动步骤完成原生安装;没有承诺所有平台提供预编译 binding,也没有迁移已有用户数据库。公开 CI 会正常执行依赖构建并测试 SQLite/FTS5 行为,但它不代替 DSH profile 内的构建审批。源码开发直接运行 `npm ci --include=dev --registry=https://registry.npmjs.org`,不要使用 `--ignore-scripts` 后将结果当成完整安装。
|
|
Binary file
|