dsh-rss 0.3.2 → 0.4.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 stardustlc
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 stardustlc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -4,11 +4,11 @@
 
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
-DSH (DeepSeek Harness) plugin for RSS/Atom subscriptions: manage feeds, fetch and parse RSS 0.9x / 1.0 / 2.0 and Atom, with OPML bulk import/export, exposing seven model-facing tools.
+DSH (DeepSeek Harness) plugin for RSS/Atom subscriptions: manage feeds, fetch and parse RSS 0.9x / 1.0 / 2.0 and Atom, with OPML bulk import/export, exposing nine model-facing tools.
 
 ## Compatibility
 
-Verified with official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: all 18 components load alongside Modlens, with passing tool-schema, skill-registration and offline read-only invocation checks. Uses the `cordis.patch.yml` + `dsh.bundle.patch` bundle model. Node requirements match this Harness release: 22.19 or later within 22.x, or 24 or later. Live external-service workflows require separate configuration and validation.
+Version 0.4.0 supports official-source Harness **0.1.7-alpha.2** (2026-09-23, with a local `Symbol.for` tool-scheduler fix). All 18 plugins load together; tool contracts, subscription updates and restart persistence pass in isolation. Live feeds require working network access. Requires Node 22.19 or later within 22.x, or 24 or later.
 
 Fetches honor the Harness cancellation signal through DNS, response streaming, and cross-feed searches. Hostname preflight checks reject loopback, private, and link-local addresses by default, including redirect destinations. Set `allowPrivateNetwork: true` for trusted internal feeds.
 
@@ -20,7 +20,7 @@ Fetches honor the Harness cancellation signal through DNS, response streaming, a
 dsh plugin --profile web add dsh-rss
 ```
 
-Restart the web service after installing.
+Restart the web service after installing. Ask your assistant to subscribe to an RSS URL or list your subscriptions; ordinary subscription management needs no configuration-file editing.
 
 ## Uninstall
 
@@ -61,6 +61,9 @@ Override the plugin row in your profile's `cordis.patch.yml` (the plugin also lo
 | `rss_opml_export` | Export subscriptions as OPML 2.0 text (optionally write a file) | `path` optional |
 | `rss_opml_import` | Bulk-import subscriptions from OPML 2.0 text | `opml` required |
 
+| `rss_search` | Search across feeds | `query` required; optional feed, date and limit filters |
+| `rss_health` | Check configuration, feeds and cursors offline | none |
+
 ### Examples
 
 ```text
@@ -73,7 +76,7 @@ rss_opml_import { opml: "<?xml version=\"1.0\"?>..." }
 
 ## Subscriptions
 
-Subscriptions live in the settings namespace `dsh-rss` (the `feedsYaml` field): `rss_add` / `rss_remove` read and write it automatically and changes persist across restarts. You can also pre-seed subscriptions via the `feedsYaml` config field. Use `url` to distinguish feeds that share a name.
+On Harness 0.1.7, subscriptions and read cursors are stored in the current profile’s `rss` entry. Changes apply immediately and survive restart. Default installations automatically import the retired `dsh-rss` section from `settings.yaml` or `settings.yaml.imported` once, preserving the original file and existing profile values. Older hosts retain their original settings storage. Use a URL to distinguish feeds with identical names.
 
 ## Proxy
 

package/README.md

@@ -13,7 +13,7 @@ DSH（DeepSeek Harness）的 RSS/Atom 订阅工具插件：管理订阅源，抓
 
 ## 兼容性
 
-已在官方 `@deepseek-ai/dsh@0.1.5-rc.1`、Node `24.16.0` 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 `cordis.patch.yml` + `dsh.bundle.patch` 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
+0.4.0 适配官方源码构建的 Harness **0.1.7-alpha.2**（2026-09-23，含本地工具调度器 `Symbol.for` 修复）。18 个插件同载、工具契约、订阅读写与重启持久化通过隔离验证；真实外部订阅源需要正常网络连接。Node 要求为 22.19 及以上的 22.x，或 24 及以上。
 
 抓取接收 Harness 的取消信号，取消 DNS、网络读取或跨源搜索时保留原始取消原因。默认预检域名解析结果并拒绝回环、私网和链路本地地址；每次重定向都重新校验。可信内网源可显式配置 `allowPrivateNetwork: true`。
 
@@ -25,7 +25,7 @@ DSH（DeepSeek Harness）的 RSS/Atom 订阅工具插件：管理订阅源，抓
 dsh plugin --profile web add dsh-rss
 ```
 
-安装后重启 Web 服务即可。
+安装后重启 Web 服务即可。直接对助手说「订阅这个 RSS 地址，命名为技术资讯」或「列出我的订阅」即可使用，日常增删订阅不需要编辑配置文件。
 
 ## 卸载
 
@@ -80,7 +80,7 @@ rss_opml_import { opml: "<?xml version=\"1.0\"?>..." }
 
 ## 订阅存储
 
-订阅列表保存在 settings 的 `dsh-rss` 命名空间（`feedsYaml` 字段）里：`rss_add` / `rss_remove` 会自动读写并持久化，重启后仍在；也可以在配置里用 `feedsYaml` 预置初始订阅。同名订阅请用 `url` 区分。
+Harness 0.1.7 把订阅列表和读取游标保存在当前 profile 的 `rss` 配置行；增删后立即生效，重启仍保留。默认安装会自动导入旧 `settings.yaml` 或 `settings.yaml.imported` 的 `dsh-rss` 数据一次，保留原文件，且不覆盖已有 profile 值。旧版宿主继续使用原 settings 存储。同名订阅请用 URL 区分。
 
 ## 特殊代理（梯子）
 

package/cordis.patch.yml

@@ -1,20 +1,20 @@
-# dsh-rss 组合包补丁：把 RSS 订阅工具插件行插入 profile。
-# 本补丁按 id 覆盖；用户应在自己 profile 的 cordis.patch.yml 里覆盖本行的整个
-# config（见 README 的配置示例）。配置缺失时插件仍会加载，但每个工具在调用时
-# 会抛出带中文指引的错误，提示补全配置后重启。
-#
-# 示例（用户 profile 的 cordis.patch.yml）：
-#   - id: rss
-#     name: 'dsh-rss'
-#     config:
-#       # proxyUrl: http://127.0.0.1:7890   # 部分订阅源需要特殊代理（梯子）时启用
-#       timeoutMs: 15000                     # 抓取超时（毫秒）
-#       # feedsYaml: |                        # 可选：预置订阅列表（也可用 rss_add 工具添加）
-#       #   - url: https://example.com/feed.xml
-#       #     name: 示例订阅
-#
-- insert:
-    - id: rss
-      name: 'dsh-rss'
-      config:
-        timeoutMs: 15000
+# dsh-rss 组合包补丁：把 RSS 订阅工具插件行插入 profile。
+# 本补丁按 id 覆盖；用户应在自己 profile 的 cordis.patch.yml 里覆盖本行的整个
+# config（见 README 的配置示例）。配置缺失时插件仍会加载，但每个工具在调用时
+# 会抛出带中文指引的错误，提示补全配置后重启。
+#
+# 示例（用户 profile 的 cordis.patch.yml）：
+#   - id: rss
+#     name: 'dsh-rss'
+#     config:
+#       # proxyUrl: http://127.0.0.1:7890   # 部分订阅源需要特殊代理（梯子）时启用
+#       timeoutMs: 15000                     # 抓取超时（毫秒）
+#       # feedsYaml: |                        # 可选：预置订阅列表（也可用 rss_add 工具添加）
+#       #   - url: https://example.com/feed.xml
+#       #     name: 示例订阅
+#
+- insert:
+    - id: rss
+      name: 'dsh-rss'
+      config:
+        timeoutMs: 15000

package/lib/config.d.ts

@@ -11,6 +11,7 @@ export interface RssConfig {
     maxBodyBytes?: number;
     userAgent?: string;
     feedsYaml?: string;
+    cursorsJson?: string;
     allowPrivateNetwork?: boolean;
     opmlWriteApproval?: boolean;
 }

package/lib/index.d.ts

@@ -28,10 +28,18 @@ type RssPreExecuteListener = (exec: RssPendingToolExecution, next: () => Promise
 /** 插件所需的最小 ctx 面（社区插件不依赖宿主内部类型）。 */
 export interface RssPluginContext {
     settings: {
-        register(ns: string, schema: unknown, options?: {
+        register?(ns: string, schema: unknown, options?: {
             base?: Record<string, unknown>;
             applies?: string;
         }): RssSettingsScope;
+        update?(ns: string, patch: Record<string, unknown>): Promise<void>;
+    };
+    fiber?: {
+        entry?: {
+            options: {
+                id: string;
+            };
+        };
     };
     tools: {
         register(definition: RssToolDefinition): () => void;

package/lib/index.js

@@ -7,8 +7,9 @@
  * @module dsh-rss
  */
 import { resolveConfig } from './config.js';
-import { RSS_SETTINGS_NAMESPACE, RssSettingsSchema } from './settings.js';
+import { RSS_SETTINGS_NAMESPACE, RssSettingsSchema, liveConfig } from './settings.js';
 import { buildRssTools } from './tools.js';
+import { installLegacySettingsImport } from './legacy-settings.js';
 /** cordis 服务注入：apply 里要用 ctx.settings 与 ctx.tools，必须显式声明，否则宿主会抛 cannot get property without inject。 */
 export const name = 'rss';
 export const inject = ['settings', 'tools'];
@@ -18,11 +19,20 @@ export const inject = ['settings', 'tools'];
  * @param config - 插件配置（可缺省）。
  */
 export function apply(ctx, config) {
+    config = liveConfig(config ?? {});
     const cfg = resolveConfig(config);
-    const settingsScope = ctx.settings.register(RSS_SETTINGS_NAMESPACE, RssSettingsSchema, {
+    installLegacySettingsImport(ctx, config, RSS_SETTINGS_NAMESPACE, 'rss', ['feedsYaml', 'cursorsJson']);
+    const settingsScope = typeof ctx.settings.register === 'function' ? ctx.settings.register(RSS_SETTINGS_NAMESPACE, RssSettingsSchema, {
         base: { feedsYaml: cfg.feedsYaml },
         applies: 'live',
-    });
+    }) : {
+        get: () => ({ feedsYaml: config?.feedsYaml ?? '', cursorsJson: config?.cursorsJson ?? '' }),
+        update: async (patch) => {
+            if (!ctx.settings.update)
+                throw new Error('当前宿主不支持保存 RSS 配置');
+            await ctx.settings.update(ctx.fiber?.entry?.options.id ?? 'rss', patch);
+        },
+    };
     const disposers = [];
     for (const definition of buildRssTools(cfg, settingsScope)) {
         disposers.push(ctx.tools.register(definition));

package/lib/legacy-settings.d.ts

@@ -0,0 +1,4 @@
+/** No backup is edited or deleted; the completion marker lives beside imported values. */
+export declare function importLegacySettings(ctx: any, config: Record<string, any>, namespace: string, entryId: string, fields: readonly string[], home?: string): Promise<boolean>;
+/** Defer persistence until the entry and settings provider are active. */
+export declare function installLegacySettingsImport(ctx: any, config: Record<string, any>, namespace: string, entryId: string, fields: readonly string[]): void;

package/lib/legacy-settings.js

@@ -0,0 +1,64 @@
+/** Import only this plugin's retired settings section, preserving profile overrides. */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { parse } from 'yaml';
+function plain(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function missing(legacy, current) {
+    const patch = {};
+    for (const [key, value] of Object.entries(legacy)) {
+        if (current[key] === undefined)
+            patch[key] = value;
+        else if (plain(value) && plain(current[key])) {
+            const nested = missing(value, current[key]);
+            if (Object.keys(nested).length)
+                patch[key] = nested;
+        }
+    }
+    return patch;
+}
+/** No backup is edited or deleted; the completion marker lives beside imported values. */
+export async function importLegacySettings(ctx, config, namespace, entryId, fields, home) {
+    if (typeof ctx.settings.register === 'function' || config.legacySettingsImported === true)
+        return false;
+    // Old namespaces were global. Do not copy credentials into unrelated custom instances.
+    if (ctx.fiber?.entry?.options.id !== entryId)
+        return false;
+    let base = home ?? (process.env.DSH_HOME?.trim() || join(homedir(), '.dsh'));
+    if (base === '~')
+        base = homedir();
+    else if (base.startsWith('~/') || base.startsWith('~\\'))
+        base = join(homedir(), base.slice(2));
+    let document;
+    for (const file of ['settings.yaml.imported', 'settings.yaml']) {
+        try {
+            document = parse(readFileSync(resolve(base, file), 'utf8'));
+            break;
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw new Error('Cannot read legacy settings; original file preserved');
+        }
+    }
+    if (!plain(document) || !plain(document[namespace]))
+        return false;
+    const section = Object.fromEntries(fields.filter(key => Object.hasOwn(document[namespace], key)).map(key => [key, document[namespace][key]]));
+    if (Object.keys(section).length === 0)
+        return false;
+    await ctx.settings.update(entryId, { ...missing(section, { ...config }), legacySettingsImported: true });
+    return true;
+}
+/** Defer persistence until the entry and settings provider are active. */
+export function installLegacySettingsImport(ctx, config, namespace, entryId, fields) {
+    if (typeof ctx.settings.register === 'function' || typeof ctx.inject !== 'function')
+        return;
+    ctx.inject(['appReady'], (readyCtx) => {
+        readyCtx.effect(() => readyCtx.appReady.onReady(() => {
+            void importLegacySettings(ctx, config, namespace, entryId, fields).catch(() => {
+                ctx.logger?.warn?.(namespace + ': legacy settings could not be imported; the original settings file is preserved.');
+            });
+        }));
+    });
+}

package/lib/settings.d.ts

@@ -1,19 +1,36 @@
-/**
- * settings 命名空间：订阅列表（feedsYaml）存在这里，供设置页与工具共同读写。
- *
- * @module dsh-rss/settings
- */
-import z from 'schemastery';
+import modern from '@deepseek-ai/schemastery';
+export declare const Config: modern<Schemastery.ObjectS<NoInfer<{
+    feedsYaml: modern<string, string, "volatile">;
+    cursorsJson: modern<string, string, "volatile">;
+    proxyUrl: modern<string, string, "plain">;
+    timeoutMs: modern<number, number, "plain">;
+    maxBodyBytes: modern<number, number, "plain">;
+    userAgent: modern<string, string, "plain">;
+    allowPrivateNetwork: modern<boolean, boolean, "plain">;
+    opmlWriteApproval: modern<boolean, boolean, "plain">;
+    legacySettingsImported: modern<boolean, boolean, "volatile">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    feedsYaml: modern<string, string, "volatile">;
+    cursorsJson: modern<string, string, "volatile">;
+    proxyUrl: modern<string, string, "plain">;
+    timeoutMs: modern<number, number, "plain">;
+    maxBodyBytes: modern<number, number, "plain">;
+    userAgent: modern<string, string, "plain">;
+    allowPrivateNetwork: modern<boolean, boolean, "plain">;
+    opmlWriteApproval: modern<boolean, boolean, "plain">;
+    legacySettingsImported: modern<boolean, boolean, "volatile">;
+}>>, "plain">;
+export declare function liveConfig<T extends object>(config: T): T;
 /** 本插件拥有的 settings 文档命名空间。 */
 export declare const RSS_SETTINGS_NAMESPACE = "dsh-rss";
 /** settings 页形状：目前只有订阅列表（YAML 文本）。 */
-export declare const RssSettingsSchema: z<Schemastery.ObjectS<{
-    feedsYaml: z<string, string>;
-    cursorsJson: z<string, string>;
-}>, Schemastery.ObjectT<{
-    feedsYaml: z<string, string>;
-    cursorsJson: z<string, string>;
-}>>;
+export declare const RssSettingsSchema: modern<Schemastery.ObjectS<NoInfer<{
+    feedsYaml: modern<string, string, Mode extends "volatile-defined" | "volatile" ? "volatile-defined" : "defined">;
+    cursorsJson: modern<string, string, Mode extends "volatile-defined" | "volatile" ? "volatile-defined" : "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    feedsYaml: modern<string, string, Mode extends "volatile-defined" | "volatile" ? "volatile-defined" : "defined">;
+    cursorsJson: modern<string, string, Mode extends "volatile-defined" | "volatile" ? "volatile-defined" : "defined">;
+}>>, "plain">;
 /** settings 解析后的值。 */
 export interface RssSettingsValue {
     feedsYaml: string;

package/lib/settings.js

@@ -4,6 +4,19 @@
  * @module dsh-rss/settings
  */
 import z from 'schemastery';
+import modern from '@deepseek-ai/schemastery';
+export const Config = modern.object({
+    feedsYaml: modern.string().volatile(), cursorsJson: modern.string().volatile(),
+    proxyUrl: modern.string(), timeoutMs: modern.number(), maxBodyBytes: modern.number(),
+    userAgent: modern.string(), allowPrivateNetwork: modern.boolean(), opmlWriteApproval: modern.boolean(),
+    legacySettingsImported: modern.boolean().volatile(),
+});
+export function liveConfig(config) {
+    return new Proxy(config, { get(target, key, receiver) {
+            const value = Reflect.get(target, key, receiver);
+            return value !== null && typeof value === 'object' && typeof value.get === 'function' ? value.get() : value;
+        } });
+}
 /** 本插件拥有的 settings 文档命名空间。 */
 export const RSS_SETTINGS_NAMESPACE = 'dsh-rss';
 /** settings 页形状：目前只有订阅列表（YAML 文本）。 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-rss",
-  "version": "0.3.2",
-  "description": "DSH RSS 订阅工具插件：管理订阅源、OPML 导入导出、抓取解析 RSS/Atom 并保留正文（rss_list / rss_add / rss_remove / rss_fetch / rss_check / rss_opml_export / rss_opml_import）",
+  "version": "0.4.0",
+  "description": "DSH RSS 插件：订阅源管理、OPML 导入导出、抓取解析 RSS/Atom 并保留正文。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -46,7 +46,8 @@
     "fast-xml-parser": "^5.0.0",
     "schemastery": "^3.18.0",
     "undici": "^8.10.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.0",
+    "@deepseek-ai/schemastery": "^3.18.3"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",