dsh-rss 0.6.2 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 更新记录
 
+## 0.7.0（2026-10-17）
+
+- 设置面板顶部新增「首次使用」分步引导：一次只讲一步，支持上一步/下一步/跳过，看完记在本机不再出现。
+- 引导内容与该插件的实际用法一致；可在开发者工具里清掉 `dsh-first-run:dsh-rss:v1` 重新查看。
+## 0.6.3 (2026-10-17)
+
+- 修复英文窄窗口中 RSS 标题截断；设置导航改为顶部换行排列，给订阅列表保留可读宽度。样式仅在 RSS 面板打开时生效。
+- 在官方 DSH 0.2.1-alpha.5 中检查来源目录、分类、OPML 预览导入与导出、编辑订阅和中英文布局。
+
 ## 0.6.2 (2026-10-15)
 
 - 加固直连、HTTP CONNECT 与 TLS 握手的套接字错误隔离，抓取结束会销毁本次请求仍持有的连接，避免错误在请求结束后逃逸。

package/README.en.md

@@ -10,6 +10,9 @@ Subscribe to and read RSS or Atom feeds, and manage updates from DSH.
 
 Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-rss/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-rss/pulls).
 
+
+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.
+
 ## What it does
 
 - Add feeds, read articles and fetch updates.

package/README.md

@@ -10,6 +10,9 @@
 
 欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-rss/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-rss/pulls)。
 
+
+本轮 DSH `0.2.1-alpha.5` 操作与窄窗口修复见 [0.6.3 验收记录](docs/validation-0.6.3.md)。
+
 ## 功能
 
 - 添加订阅、查看文章和抓取更新。

package/docs/VALIDATION.md

@@ -1,5 +1,7 @@
 # dsh-rss 验证记录
 
+[0.6.3 · DSH 0.2.1-alpha.5 与窄窗口验收](validation-0.6.3.md)。
+
 [0.6.0 推荐订阅源验收](validation-0.6.0.md)。
 
 [0.5.2 中英文界面验收](validation-language-2026-10-03.md)。

package/docs/validation-0.6.3.md

@@ -0,0 +1,10 @@
+# 0.6.3 · DSH alpha.5 网页验收
+
+宿主为公开 npm `@deepseek-ai/dsh@0.2.1-alpha.5`，Windows Node 24，系统 Chrome 无头浏览器，使用隔离 profile。
+
+- 119 项自动测试通过。
+- 实际打开推荐来源目录并搜索，预览嵌套 OPML 分类后明确导入；编辑名称和导出文件均读取同一份订阅配置。导入不会自动抓取全部来源。
+- 英文标题曾在 390px 窗口的双列设置布局中被截断；修复后 RSS 所在设置页改用顶部换行导航，正文占用完整可用列，标题、按钮和下拉框可读。关闭 RSS 面板后该导航样式不影响其他设置页。
+- 中文与英文 UI 操作通过，原始来源名称和用户分类保持原文；错误与空列表有明确提示。
+
+本轮不重测真实外部网站，也不声称没有 VPN 的网络验收通过；网络可用性仍由用户的实际连接决定。原生桌面窗口未操作。

package/lib/client.js

@@ -1,6 +1,77 @@
 // This is the browser source. tsc does not rebuild it; check with node --check.
 window.__ModuleLoader__.load({ id: 'dsh-rss', factory: require => {
   const React = require('react');
+var __FR_KEY = "dsh-first-run:dsh-rss:v1";
+var __FR_TITLE = "RSS 订阅 · 首次使用（3 步）";
+var __FR_STEPS = [{"title":"先加一个源","body":"粘贴 RSS/Atom 地址，插件会先抓一次验证可用，再存进列表。"},{"title":"增量比全量好用","body":"抓取时选「增量」，只返回上次之后的新条目，适合定时巡检。"},{"title":"跨源搜索","body":"在对话里直接问关键词最近有没有更新，比逐个源翻快得多。","tryIt":"搜一下最近一周提到 DeepSeek 的订阅条目"}];
+
+// ---- first-run guide (shared snippet; keep in sync across plugins) ----
+var __FR_STYLE_ID = 'dsh-first-run-css';
+var __FR_CSS = [
+  '.fr-card{border:1px solid var(--dsw-border,rgba(0,0,0,.10));border-radius:12px;padding:14px 16px;margin:0 0 14px;background:linear-gradient(180deg,rgba(59,130,246,.06),rgba(59,130,246,.02))}',
+  '.fr-head{display:flex;align-items:center;gap:8px;margin-bottom:6px}',
+  '.fr-dot{width:6px;height:6px;border-radius:50%;background:var(--dsw-accent,#3b82f6)}',
+  '.fr-title{font-weight:650;font-size:13.5px}',
+  '.fr-count{margin-left:auto;font-size:11px;color:var(--dsw-text-weak,#6b7280);font-variant-numeric:tabular-nums}',
+  '.fr-step{font-weight:600;font-size:13px;margin:2px 0 4px}',
+  '.fr-body{color:var(--dsw-text-weak,#4b5563);font-size:12.5px;line-height:1.65}',
+  '.fr-try{margin-top:8px;padding:7px 9px;border-radius:8px;background:rgba(59,130,246,.09);font-size:12px;display:flex;gap:8px}',
+  '.fr-try code{font-family:ui-monospace,monospace;white-space:pre-wrap;word-break:break-word}',
+  '.fr-bar{display:flex;gap:8px;align-items:center;margin-top:12px}',
+  '.fr-progress{display:flex;gap:4px;margin-right:auto}',
+  '.fr-seg{width:16px;height:3px;border-radius:2px;background:var(--dsw-border,rgba(0,0,0,.12))}',
+  '.fr-seg.on{background:var(--dsw-accent,#3b82f6)}',
+  '.fr-btn{border:1px solid var(--dsw-border,rgba(0,0,0,.14));background:transparent;color:inherit;border-radius:8px;padding:4px 10px;font-size:12px;cursor:pointer}',
+  '.fr-btn:hover{background:rgba(0,0,0,.04)}',
+  '.fr-btn.primary{background:var(--dsw-accent,#3b82f6);border-color:transparent;color:#fff}',
+  '.fr-btn.ghost{border-color:transparent;color:var(--dsw-text-weak,#6b7280)}',
+].join('\n');
+function __frEnsureCss() {
+  if (typeof document === 'undefined' || document.getElementById(__FR_STYLE_ID)) return;
+  var el = document.createElement('style');
+  el.id = __FR_STYLE_ID;
+  el.textContent = __FR_CSS;
+  document.head.appendChild(el);
+}
+function __frRead() { try { return localStorage.getItem(__FR_KEY) === 'done'; } catch (e) { return false; } }
+function __frWrite() { try { localStorage.setItem(__FR_KEY, 'done'); } catch (e) {} }
+function __FirstRunCard() {
+  var doneState = React.useState(__frRead);
+  var done = doneState[0], setDone = doneState[1];
+  var idxState = React.useState(0);
+  var index = idxState[0], setIndex = idxState[1];
+  React.useEffect(function () { __frEnsureCss(); }, []);
+  if (done) return null;
+  var step = __FR_STEPS[index];
+  var last = index >= __FR_STEPS.length - 1;
+  var close = function () { __frWrite(); setDone(true); };
+  var kids = [
+    React.createElement('div', { className: 'fr-head', key: 'h' },
+      React.createElement('span', { className: 'fr-dot' }),
+      React.createElement('span', { className: 'fr-title' }, __FR_TITLE),
+      React.createElement('span', { className: 'fr-count' }, (index + 1) + ' / ' + __FR_STEPS.length)),
+    React.createElement('div', { className: 'fr-step', key: 't' }, step.title),
+    React.createElement('div', { className: 'fr-body', key: 'b' }, step.body),
+  ];
+  if (step.tryIt) kids.push(React.createElement('div', { className: 'fr-try', key: 'y' },
+    React.createElement('span', null, '可以直接说'),
+    React.createElement('code', null, '「' + step.tryIt + '」')));
+  var buttons = [React.createElement('div', { className: 'fr-progress', key: 'p' }, __FR_STEPS.map(function (_, i) {
+    return React.createElement('span', { key: i, className: 'fr-seg' + (i <= index ? ' on' : '') });
+  }))];
+  buttons.push(React.createElement('button', { className: 'fr-btn ghost', type: 'button', onClick: close, key: 's' }, '跳过'));
+  if (index > 0) buttons.push(React.createElement('button', { className: 'fr-btn', type: 'button', key: 'prev', onClick: function () { setIndex(index - 1); } }, '上一步'));
+  buttons.push(React.createElement('button', { className: 'fr-btn primary', type: 'button', key: 'next', onClick: function () { if (last) close(); else setIndex(index + 1); } }, last ? '开始使用' : '下一步'));
+  kids.push(React.createElement('div', { className: 'fr-bar', key: 'bar' }, buttons));
+  return React.createElement('div', { className: 'fr-card' }, kids);
+}
+function __withFirstRun(Component) {
+  return function FirstRunWrapped(props) {
+    return React.createElement(React.Fragment, null, React.createElement(__FirstRunCard, null), React.createElement(Component, props));
+  };
+}
+// ---- end first-run guide ----
+
   const { useState, useEffect, useRef, useId } = React;
   const h = React.createElement;
   const ROUTE = '_dsh/dsh-rss/subscriptions';
@@ -50,14 +121,14 @@ window.__ModuleLoader__.load({ id: 'dsh-rss', factory: require => {
   }
 
   const CSS = `
-    .dshr{color:var(--dsw-alias-label-primary,#202737);font-size:14px;line-height:1.55;max-width:920px;min-width:0}
+    .dshr{color:var(--dsw-alias-label-primary,#202737);font-size:14px;line-height:1.55;max-width:920px;min-width:0;overflow-wrap:anywhere}
     .dshr *,.dshr-dialog *{box-sizing:border-box}.dshr h2{font-size:22px;margin:0 0 6px}.dshr p{margin:0 0 12px}
     .dshr-muted{color:var(--dsw-alias-label-tertiary,#657083);font-size:13px}.dshr-toolbar{display:flex;flex-wrap:wrap;gap:8px;margin:16px 0}
     .dshr button,.dshr-dialog button{font:inherit;min-height:38px;padding:7px 12px;border:1px solid var(--dsw-alias-border-l2,#d9dee7);border-radius:9px;color:inherit;background:var(--dsw-alias-bg-layer-1,#fff);cursor:pointer}
     .dshr button:disabled,.dshr-dialog button:disabled{opacity:.5;cursor:not-allowed}.dshr button:hover:not(:disabled),.dshr-dialog button:hover:not(:disabled){border-color:#5685d4}
     .dshr .primary,.dshr-dialog .primary{background:#366fd2;color:#fff;border-color:#366fd2}.dshr-dialog .danger{background:#b93838;border-color:#b93838;color:#fff}
     .dshr button:focus-visible,.dshr-dialog button:focus-visible,.dshr input:focus-visible,.dshr select:focus-visible,.dshr-dialog input:focus-visible,.dshr-dialog textarea:focus-visible{outline:2px solid #5685d4;outline-offset:2px}
-    .dshr-filters{display:flex;flex-wrap:wrap;gap:10px;margin-bottom:16px}.dshr-filters label:first-child{flex:1 1 220px}.dshr label,.dshr-dialog label{display:flex;flex-direction:column;gap:5px;font-size:13px}
+    .dshr-filters{display:flex;flex-wrap:wrap;gap:10px;margin-bottom:16px}.dshr-filters label:first-child{flex:1 1 220px}.dshr label,.dshr-dialog label{display:flex;flex-direction:column;gap:5px;font-size:13px;min-width:0;max-width:100%}
     .dshr input,.dshr select,.dshr-dialog input,.dshr-dialog textarea{font:inherit;font-size:16px;width:100%;min-width:0;min-height:40px;border:1px solid var(--dsw-alias-border-l2,#d9dee7);border-radius:8px;padding:8px 10px;background:var(--dsw-alias-bg-layer-1,#fff);color:inherit}
     .dshr-list{display:grid;gap:10px;margin:0;padding:0;list-style:none}.dshr-card{background:var(--dsw-alias-bg-layer-1,#fff);border:1px solid var(--dsw-alias-border-l2,#d9dee7);border-radius:12px;padding:14px;display:flex;flex-wrap:wrap;gap:12px}
     .dshr-info{flex:1 1 240px;min-width:0}.dshr-info h3{font-size:15px;margin:0 0 4px;overflow-wrap:anywhere}.dshr-url{font-size:12px;overflow-wrap:anywhere;color:var(--dsw-alias-label-tertiary,#657083)}
@@ -72,6 +143,13 @@ window.__ModuleLoader__.load({ id: 'dsh-rss', factory: require => {
     .dshr-catalog{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;list-style:none;padding:0;margin:14px 0}.dshr-source{border:1px solid var(--dsw-alias-border-l2,#d9dee7);border-radius:12px;padding:14px;min-width:0;align-self:start}.dshr-source h4{font-size:16px;margin:0 0 6px;overflow-wrap:anywhere}.dshr-source p{margin:8px 0}.dshr-source .dshr-actions{margin-top:12px}.dshr-source.is-selected{border-color:#5685d4}.dshr-source details{margin-top:8px;font-size:12px}.dshr-source summary{cursor:pointer}.dshr-source .dshr-preview{margin-top:12px;font-size:13px}
     @media(max-width:640px){.dshr-catalog{grid-template-columns:1fr}.dshr-dialog .dshr-filters label{flex-basis:100%}}
     @media(max-width:520px){.dshr-dialog{padding:16px}.dshr-actions{width:100%}.dshr-filters label{width:100%}.dshr-toolbar button{flex:1 1 auto}.dshr-card{padding:12px}}
+    @media(max-width:640px){
+      [role=dialog]:has(.dshr){width:100%!important;max-width:100%!important;flex-direction:column!important}
+      [role=dialog]:has(.dshr)>nav+div{min-width:0;width:100%}
+      [role=dialog]:has(.dshr)>nav+div>div:has(.dshr){padding:12px!important;min-width:0}
+      [role=dialog]:has(.dshr)>nav{width:100%!important;flex-basis:auto!important;border-right:0;max-height:170px;overflow:auto}
+      [role=dialog]:has(.dshr)>nav>div:has(>button){display:flex;flex-direction:row!important;flex-wrap:wrap;gap:4px}
+    }
   `;
   async function request(action, args, signal) {
     const response = await fetch(new URL(ROUTE, document.baseURI), action ? {
@@ -264,7 +342,7 @@ window.__ModuleLoader__.load({ id: 'dsh-rss', factory: require => {
       let lang = language;
       try { const service = ctx.get ? ctx.get('locale') : ctx.locale; if (service?.getSnapshot) lang = String(service.getSnapshot().active || '').startsWith('en') ? 'en' : 'zh'; } catch {}
       return words.title[lang === 'en' ? 1 : 0];
-    }, inject: () => ({}) }, Panel));
+    }, inject: () => ({}) }, __withFirstRun(Panel)));
   }
   return { apply, inject: ['slots', 'locale'] };
 } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rss",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "订阅和阅读 RSS / Atom，在 DSH 中查看与管理更新。",
   "type": "module",
   "main": "lib/index.js",