@hyzyn/dsh-plugin-kit 0.1.0 → 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.
Files changed (3) hide show
  1. package/README.en.md +13 -9
  2. package/README.md +13 -9
  3. package/package.json +15 -15
package/README.en.md CHANGED
@@ -40,7 +40,7 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
40
40
  | Prompt management | Manual config | Visual editing + versioning / A/B testing / export & sharing |
41
41
  | Profile management | CLI | Visual create / copy / rename / delete |
42
42
  | RSS aggregation | None | Multiple sources + daily “Today’s Worth Reading” digest |
43
- | Global search | Session titles/content only | Unified sidebar search over sessions, Prompts, and MCP tools |
43
+ | Global search | Session titles/content only | Unified sidebar full-text search over historical sessions |
44
44
  | Codegraph integration | None | Code-graph card: index status / symbol search / callers-callees-impact / one-click sync-index |
45
45
  | Plugin development | Hand-written boilerplate | `pnpm create-plugin` scaffolding + `@hyzyn/dsh-kit` type helpers |
46
46
 
@@ -90,20 +90,21 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
90
90
 
91
91
  ### Global Search (@hyzyn/dsh-search)
92
92
 
93
- - **What it does**: adds a “Global Search” entry to the Web GUI sidebar. Type a keyword and it searches historical sessions, managed Prompts, currently loaded MCP tools, and the official RSS / RSSHub routes curated by [awesome-rsshub-routes](https://jackyst0.github.io/awesome-rsshub-routes/) at once.
94
- - **How to use**: after installing, click or focus the global search box below “New Session” in the sidebar → type a keyword → click a session result to open it and try to locate the matching text; clicking a Prompt / MCP tool result tries to jump to the matching settings card, and falls back to copying the content / tool name if navigation is unavailable; clicking an RSS feed result copies its subscribe URL.
95
- - **Supports**: full-text session search via DSH’s built-in `sessionQuery`; Prompt name / description / version content; `mcp__`-prefixed MCP tools; RSS feed name / category / URL (name matches first); configurable per-category result limits; keyword highlighting in results.
96
- - **Where it is stored**: no separate config; Prompts are read from the managed block of `~/.dsh/prompts.yml`; RSS feeds ship as a bundled snapshot and silently refresh from the upstream OPML every 12 hours at runtime (falling back to the snapshot when offline).
97
- - **Note**: requires the host `sessionQuery` / `tools` services; if absent, that category returns an empty list without affecting the others. If the `session-query` full-text index is configured with `openAt: "never"`, session search automatically degrades to per-session scanning; session results are filtered to currently visible/jumpable sessions.
93
+ - **What it does**: adds a “Global Search” entry to the Web GUI sidebar. Type a keyword to run full-text search over historical sessions and settings panels.
94
+ - **How to use**: after installing, click or focus the global search box below “New Session” in the sidebar → type a keyword → click a session result to open it and try to locate the matching text; click a settings-panel result to jump straight to the corresponding settings card.
95
+ - **Supports**: full-text session search via DSH’s built-in `sessionQuery`; settings-panel search (official panels always searchable, plugin panels filtered dynamically by what is installed); configurable result limits; keyword highlighting in results.
96
+ - **Where it is stored**: no separate config.
97
+ - **Note**: requires the host `sessionQuery` service; if absent, session search returns an empty list. If the `session-query` full-text index is configured with `openAt: "never"`, session search automatically degrades to per-session scanning; session results are filtered to currently visible/jumpable sessions.
98
98
 
99
99
  ![Global search plugin](docs/dsh-plugin-kit-search.png)
100
100
 
101
101
  ### RSS / News Aggregation (@hyzyn/dsh-rss)
102
102
 
103
103
  - **What it does**: subscribe to multiple RSS / Atom sources and automatically compile a daily “Today’s Worth Reading” Markdown digest, injected into systemPrompt for the model to reference.
104
- - **How to use**: after installing, click “Today’s Worth Reading” in the sidebar below “New Session” to view news directly; you can also open Settings → Plugins → “RSS / News Aggregation” to toggle built-in channels, add custom channels (validated on save), and manage categories and aggregation settings. Saving refreshes the digest automatically.
104
+ - **How to use**: after installing, click “Today’s Worth Reading” in the sidebar below “New Session” to view news directly; you can also open Settings → Plugins → “RSS / News Aggregation” to toggle built-in channels, add custom channels (validated on save), search and one-click add feeds from the [awesome-rsshub-routes](https://jackyst0.github.io/awesome-rsshub-routes/) catalog, and manage categories and aggregation settings. Saving refreshes the digest automatically.
105
105
  - **Built-in channels**: Ruanyifeng, sspai, Solidot, Hacker News, Juejin, ITHome, 36Kr (36Kr’s official feed is blocked by anti-bot protection, so the built-in entry uses a third-party RSSHub mirror) — check to show, uncheck to stop fetching.
106
106
  - **Custom channels**: enter any RSS / Atom URL; it is validated with a real fetch on save — homepages, non-feed pages, and empty feeds are rejected with a clear error and not saved.
107
+ - **Source catalog**: ships the awesome-rsshub-routes curated catalog (official RSS and RSSHub routes, 98 feeds / 12 categories), searchable and filterable by category with one-click add to custom channels; bundled snapshot silently refreshes from the upstream OPML every 12 hours at runtime (falling back to the snapshot when offline).
107
108
  - **Categories**: a channel’s category is picked from the category list, and the digest (Markdown, systemPrompt, modal) is grouped by category; categories in use are merged into the list automatically on save.
108
109
  - **Supports**: RSS 2.0 / Atom parsing, deduplication, per-source item limits, daily scheduled generation, startup catch-up generation, custom output directory, and the built-in channel library.
109
110
  - **Where it is stored**: `~/.dsh/rss-digest/YYYY-MM-DD.md` (override with `DSH_RSS_DIGEST_DIR`).
@@ -113,6 +114,8 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
113
114
 
114
115
  ![Sidebar “Today’s Worth Reading” modal: grouped by category, each source links to its website](docs/dsh-plugin-kit-rss-view.png)
115
116
 
117
+ ![Query today’s news: ask the model for “Today’s Worth Reading” and it cites the daily digest](docs/dsh-plugin-kit-rss-query-news.png)
118
+
116
119
  ### Codegraph Integration (@hyzyn/dsh-codegraph)
117
120
 
118
121
  - **What it does**: code-graph integration — the “Codegraph” card under Settings → Plugins shows index status, symbol search, callers / callees / impact, and one-click sync / index. On install it automatically injects a CodeGraph usage guideline into systemPrompt so the model prefers `codegraph_explore` / `codegraph explore` over grep / read in indexed projects.
@@ -138,10 +141,11 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
138
141
 
139
142
  ### Install from npm (recommended)
140
143
 
141
- The plugins are published to npm (under the `@hyzyn` scope). Install everything with one command:
144
+ The plugins are published to npm (under the `@hyzyn` scope). Install everything with one command — either of these two equivalent options:
142
145
 
143
146
  ```sh
144
- dsh plugin --profile web add @hyzyn/dsh-all
147
+ dsh plugin --profile web add @hyzyn/dsh-all # aggregate package
148
+ dsh plugin --profile web add @hyzyn/dsh-plugin-kit # repo root bundle (mounts the whole family too)
145
149
  ```
146
150
 
147
151
  After installation, restart `dsh web` and open Settings → Plugins to see all the cards. If you only want one plugin, see “Install a Single Plugin” below.
package/README.md CHANGED
@@ -40,7 +40,7 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
40
40
  | Prompt 管理 | 手改配置 | 可视化编辑 + 版本管理 / A/B 测试 / 导出分享 |
41
41
  | Profile 管理 | 命令行 | 可视化创建 / 复制 / 重命名 / 删除 |
42
42
  | RSS 聚合 | 无 | 多源订阅 + 每日「今日值得读」自动摘要 |
43
- | 全局搜索 | 仅会话标题/内容 | 侧边栏统一搜索历史会话、Prompt、MCP 工具、RSS 订阅源 |
43
+ | 全局搜索 | 仅会话标题/内容 | 侧边栏统一全文搜索历史会话、Prompt、MCP 工具与设置面板 |
44
44
  | Codegraph 集成 | 无 | 代码图谱卡片：索引状态 / 符号搜索 / 调用链 / 影响面 / 一键 sync-index |
45
45
  | 插件开发 | 手写样板 | `pnpm create-plugin` 脚手架 + `@hyzyn/dsh-kit` 类型助手 |
46
46
 
@@ -90,11 +90,11 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
90
90
 
91
91
  ### 全局搜索（@hyzyn/dsh-search）
92
92
 
93
- - **做什么**：在 Web GUI 侧边栏加一个「全局搜索」入口，输入关键词后同时搜索历史会话、Prompt 管理里的提示词、当前已加载的 MCP 工具，以及 [awesome-rsshub-routes](https://jackyst0.github.io/awesome-rsshub-routes/) 收录的官方 RSS 与 RSSHub 路由（RSS 订阅源）。
94
- - **怎么用**：安装后在侧边栏「新建会话」下方点击 / 聚焦全局搜索框 → 输入关键词 → 点击会话会打开并尝试定位到匹配文字；点击 Prompt / MCP 工具会尝试跳转到对应设置卡片，跳转失败时自动复制内容 / 工具名；点击 RSS 订阅源会复制订阅地址。
95
- - **支持**：历史会话全文搜索（走 DSH 自带 sessionQuery 索引）；Prompt 名称 / 描述 / 版本内容；`mcp__` 前缀 MCP 工具；RSS 订阅源名称 / 分类 / URL（名称命中优先）；单类结果数量可配置；结果关键词高亮。
96
- - **存哪里**：无独立配置；Prompt 读取 `~/.dsh/prompts.yml` 的托管区块；RSS 订阅源内置快照，运行时每 12 小时从上游 OPML 静默刷新（离线自动回退快照）。
97
- - **注意**：需要宿主已安装 `sessionQuery` / `tools` 服务；缺失时对应类别返回空列表，不影响其它类别。若 `session-query` 全文索引配置为 `openAt: "never"`，历史会话会自动降级为逐会话扫描；会话结果会过滤为当前可跳转的可见会话。
93
+ - **做什么**：在 Web GUI 侧边栏加一个「全局搜索」入口，输入关键词即可全文搜索历史会话与设置面板。
94
+ - **怎么用**：安装后在侧边栏「新建会话」下方点击 / 聚焦全局搜索框 → 输入关键词 → 点击会话会打开并尝试定位到匹配文字；点击面板条目会直接跳转到对应设置卡片。
95
+ - **支持**：历史会话全文搜索（走 DSH 自带 sessionQuery 索引）；设置面板搜索（官方面板恒可搜，插件面板按已安装动态过滤）；结果数量可配置；结果关键词高亮。
96
+ - **存哪里**：无独立配置。
97
+ - **注意**：需要宿主已安装 `sessionQuery` 服务；缺失时会话搜索返回空列表。若 `session-query` 全文索引配置为 `openAt: "never"`，历史会话会自动降级为逐会话扫描；会话结果会过滤为当前可跳转的可见会话。
98
98
 
99
99
  ![全局搜索插件](docs/dsh-plugin-kit-search.png)
100
100
 
@@ -111,9 +111,10 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
111
111
  ### RSS / 新闻聚合（@hyzyn/dsh-rss）
112
112
 
113
113
  - **做什么**：订阅多个 RSS / Atom 源，每天自动汇总成一篇「今日值得读」Markdown，并注入 systemPrompt 供模型直接引用。
114
- - **怎么用**：安装后可在侧边栏「新建会话」下方点击「今日值得读」直接查看新闻；也可打开 设置 → 插件 →「RSS / 新闻聚合」勾选内置渠道、添加自定义渠道（保存时即时校验地址）、维护新闻分类与聚合设置，保存后自动刷新。
114
+ - **怎么用**：安装后可在侧边栏「新建会话」下方点击「今日值得读」直接查看新闻；也可打开 设置 → 插件 →「RSS / 新闻聚合」勾选内置渠道、添加自定义渠道（保存时即时校验地址）、从 [awesome-rsshub-routes](https://jackyst0.github.io/awesome-rsshub-routes/) 订阅源目录搜索并一键添加，维护新闻分类与聚合设置，保存后自动刷新。
115
115
  - **内置渠道**：阮一峰、少数派、Solidot、Hacker News、掘金、IT之家、36氪（36氪官方 feed 被反爬拦截，内置为第三方 RSSHub 镜像），勾选即展示、取消勾选即不抓取。
116
116
  - **自定义渠道**：填写任意 RSS / Atom 地址，保存时真实抓取校验——官网首页、非 feed、抓不到内容的地址会报错且不保存。
117
+ - **订阅源目录**：内置 awesome-rsshub-routes 精选目录（官方 RSS 与 RSSHub 路由，98 条 / 12 分类），可搜索 / 按分类筛选并一键加入自定义渠道；快照随插件内置，运行时每 12 小时从上游 OPML 静默刷新。
117
118
  - **新闻分类**：渠道的分类从「新闻分类」列表里选择；digest（Markdown、systemPrompt、弹窗）按分类分组展示，保存时自动把使用中的分类合并进列表。
118
119
  - **支持**：RSS 2.0 / Atom 解析、按来源去重、每源条数限制、每日定时生成、启动补生成、自定义输出目录、内置渠道库。
119
120
  - **存哪里**：`~/.dsh/rss-digest/YYYY-MM-DD.md`（可用 `DSH_RSS_DIGEST_DIR` 覆盖）。
@@ -123,6 +124,8 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
123
124
 
124
125
  ![侧边栏「今日值得读」弹窗：按分类分组，来源带「查看更多」直达官网](docs/dsh-plugin-kit-rss-view.png)
125
126
 
127
+ ![查询今日新闻：向模型提问「今日值得读」直接引用当天 digest](docs/dsh-plugin-kit-rss-query-news.png)
128
+
126
129
  ## 快速开始
127
130
 
128
131
  ### 系统要求
@@ -138,10 +141,11 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
138
141
 
139
142
  ### 从 npm 安装（推荐）
140
143
 
141
- 插件已发布到 npm（`@hyzyn` scope），一条命令装齐：
144
+ 插件已发布到 npm（`@hyzyn` scope），一条命令装齐——两种等价方式任选：
142
145
 
143
146
  ```sh
144
- dsh plugin --profile web add @hyzyn/dsh-all
147
+ dsh plugin --profile web add @hyzyn/dsh-all # 聚合安装包
148
+ dsh plugin --profile web add @hyzyn/dsh-plugin-kit # 仓库根 bundle（同样挂载全家桶）
145
149
  ```
146
150
 
147
151
  装完重启 `dsh web`，打开 设置 → 插件 即可看到全部卡片。只想用某一个插件，见下文「单独安装某个插件」。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hyzyn/dsh-plugin-kit",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "type": "module",
5
5
  "description": "通用 DSH 插件库（pnpm monorepo）：模板插件、插件开发工具包、一键聚合安装包。根包同时是全家桶 bundle（dsh.bundle.patch），DSH 与插件市场可直接识别安装。",
6
6
  "main": "lib/index.js",
@@ -13,12 +13,6 @@
13
13
  "patch": "./cordis.patch.yml"
14
14
  }
15
15
  },
16
- "scripts": {
17
- "build": "pnpm -r build",
18
- "typecheck": "pnpm -r typecheck",
19
- "create-plugin": "node scripts/create-plugin.mjs",
20
- "aggregate": "node scripts/aggregate.mjs"
21
- },
22
16
  "devDependencies": {
23
17
  "typescript": "~5.7.2"
24
18
  },
@@ -33,13 +27,19 @@
33
27
  "access": "public"
34
28
  },
35
29
  "dependencies": {
36
- "@hyzyn/dsh-codegraph": "0.1.0",
37
- "@hyzyn/dsh-env": "0.1.1",
30
+ "@hyzyn/dsh-codegraph": "0.1.3",
31
+ "@hyzyn/dsh-env": "0.1.3",
38
32
  "@hyzyn/dsh-hello": "0.1.0",
39
- "@hyzyn/dsh-mcp": "0.1.0",
40
- "@hyzyn/dsh-profile": "0.1.1",
41
- "@hyzyn/dsh-prompt": "0.1.0",
42
- "@hyzyn/dsh-rss": "0.1.1",
43
- "@hyzyn/dsh-search": "0.1.0"
33
+ "@hyzyn/dsh-mcp": "0.1.2",
34
+ "@hyzyn/dsh-profile": "0.1.3",
35
+ "@hyzyn/dsh-prompt": "0.1.2",
36
+ "@hyzyn/dsh-rss": "0.1.4",
37
+ "@hyzyn/dsh-search": "0.1.1"
38
+ },
39
+ "scripts": {
40
+ "build": "pnpm -r build",
41
+ "typecheck": "pnpm -r typecheck",
42
+ "create-plugin": "node scripts/create-plugin.mjs",
43
+ "aggregate": "node scripts/aggregate.mjs"
44
44
  }
45
- }
45
+ }