@hyzyn/dsh-plugin-kit 0.1.18 → 0.1.19
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/README.en.md +17 -17
- package/README.md +17 -17
- package/package.json +7 -7
package/README.en.md
CHANGED
|
@@ -31,9 +31,9 @@ Repo gates: `pnpm typecheck` / `pnpm build` / `pnpm aggregate`.
|
|
|
31
31
|
|
|
32
32
|
dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (DSH) Web GUI: MCP server configuration, Profile management, RSS / news aggregation, global search, Codegraph integration, a terminal panel, a Docker container panel (containers and images on the local or an SSH host, read-only by default), environment variable / secret management, and Prompt management, plus a one-command scaffolding tool for generating new plugins. Everything mounts into `dsh web` through the official profile mechanism, so no DSH source changes are needed. Install the plugins individually, or install everything at once with the aggregate package.
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
|
|
37
37
|
|
|
38
38
|
| Capability | Stock dsh web | dsh-plugin-kit family |
|
|
39
39
|
| --- | --- | --- |
|
|
@@ -58,7 +58,7 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
58
58
|
- **Where it is stored**: the managed block of `~/.dsh/cordis.patch.yml`.
|
|
59
59
|
- **Note**: **do not** manually append plugin lines to this file, otherwise DSH may fail to start with `duplicate loader entry id`.
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
|
|
62
62
|
|
|
63
63
|
### Profile Management (@hyzyn/dsh-profile)
|
|
64
64
|
|
|
@@ -68,9 +68,9 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
68
68
|
- **Where it is stored**: directly manages the `~/.dsh/profiles/<name>` directory.
|
|
69
69
|
- **Note**: deletion is recursive — confirm twice before operating; the built-in `web` default profile cannot be deleted, while `headless` can be deleted; after creating a new profile, dependencies are installed on demand when you first run `dsh plugin --profile <name> add ...`.
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
|
|
74
74
|
|
|
75
75
|
### RSS / News Aggregation (@hyzyn/dsh-rss)
|
|
76
76
|
|
|
@@ -84,11 +84,11 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
84
84
|
- **Where it is stored**: `~/.dsh/rss-digest/YYYY-MM-DD.md` (override with `DSH_RSS_DIGEST_DIR`).
|
|
85
85
|
- **Note**: the first startup will fetch feeds over the network; unreachable sources are listed in the digest’s “fetch failed” section and do not block the remaining sources.
|
|
86
86
|
|
|
87
|
-
|
|
87
|
+
|
|
88
88
|
|
|
89
|
-
|
|
89
|
+
|
|
90
90
|
|
|
91
|
-
|
|
91
|
+
|
|
92
92
|
|
|
93
93
|
### Global Search (@hyzyn/dsh-search)
|
|
94
94
|
|
|
@@ -98,9 +98,9 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
98
98
|
- **Where it is stored**: no separate config.
|
|
99
99
|
- **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. “New session” reuses the GUI’s own `uiWorkspace.startSession()`; “Open folder” is hidden when no directory-picker plugin is installed.
|
|
100
100
|
|
|
101
|
-
|
|
101
|
+
|
|
102
102
|
|
|
103
|
-
|
|
103
|
+
|
|
104
104
|
|
|
105
105
|
### Codegraph Integration (@hyzyn/dsh-codegraph)
|
|
106
106
|
|
|
@@ -111,7 +111,7 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
111
111
|
- **Where it is stored**: the index lives in the project’s `.codegraph/` directory (created by `codegraph index`); the plugin has no config file of its own.
|
|
112
112
|
- **Note**: the target project needs a Codegraph index first; unindexed projects return guidance to fall back to regular tools. Indexing / rebuilding are local CLI operations that consume real disk and CPU.
|
|
113
113
|
|
|
114
|
-
|
|
114
|
+
|
|
115
115
|
|
|
116
116
|
### Terminal Panel (@hyzyn/dsh-tty)
|
|
117
117
|
|
|
@@ -123,13 +123,13 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
123
123
|
- **Where it is stored**: no config file of its own; configuration lives in the “Settings → Plugins → Terminal Panel” card.
|
|
124
124
|
- **Note**: resize relies on DSH’s internal terminal-handle shape (known limitation); output is a UTF-8 text stream, so `cat`-ing binary files shows replacement characters. See `packages/tty/README.md` for details.
|
|
125
125
|
|
|
126
|
-
|
|
126
|
+
|
|
127
127
|
|
|
128
|
-
|
|
128
|
+
|
|
129
129
|
|
|
130
|
-
|
|
130
|
+
|
|
131
131
|
|
|
132
|
-
|
|
132
|
+
|
|
133
133
|
|
|
134
134
|
### Docker Container Panel (@hyzyn/dsh-docker)
|
|
135
135
|
|
|
@@ -151,7 +151,7 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
151
151
|
- **Where it is stored**: the managed block of `~/.dsh/env.yml` (auto-generated; do not edit by hand).
|
|
152
152
|
- **Note**: key names may only contain letters, digits, and underscores, and must not be duplicated.
|
|
153
153
|
|
|
154
|
-
|
|
154
|
+
|
|
155
155
|
|
|
156
156
|
### Prompt Management (@hyzyn/dsh-prompt)
|
|
157
157
|
|
|
@@ -161,7 +161,7 @@ dsh-plugin-kit is a general-purpose plugin collection for the DeepSeek Harness (
|
|
|
161
161
|
- **Where it is stored**: the managed block of `~/.dsh/prompts.yml`.
|
|
162
162
|
- **Note**: each Prompt must have at least one version, and a single version’s content must be ≤ 500KB.
|
|
163
163
|
|
|
164
|
-
|
|
164
|
+
|
|
165
165
|
|
|
166
166
|
## Quick Start
|
|
167
167
|
|
package/README.md
CHANGED
|
@@ -33,9 +33,9 @@
|
|
|
33
33
|
|
|
34
34
|
dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合：MCP 服务器配置、Profile 管理、RSS / 新闻聚合、全局搜索、Codegraph 集成、终端面板（本地 + SSH 终端、SFTP 文件传输）、Docker 容器面板（本机 / SSH 主机上的容器与镜像查看，默认只读）、环境变量 / 密钥管理、Prompt 管理，外加一条命令生成新插件的开发脚手架。所有插件都走官方 profile 机制挂载到 `dsh web`，不改 DSH 源码；可以逐个安装，也可以用聚合包一次装齐。
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
|
|
39
39
|
|
|
40
40
|
| 能力 | 原生 dsh web | dsh-plugin-kit 全家桶 |
|
|
41
41
|
| --- | --- | --- |
|
|
@@ -60,7 +60,7 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
60
60
|
- **存哪里**：`~/.dsh/cordis.patch.yml` 的托管区块。
|
|
61
61
|
- **注意**：**不要**手工往该文件里追加插件行，否则启动时报 `duplicate loader entry id` 直接退出。
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
|
|
64
64
|
|
|
65
65
|
### Profile 管理（@hyzyn/dsh-profile）
|
|
66
66
|
|
|
@@ -70,9 +70,9 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
70
70
|
- **存哪里**：直接管理 `~/.dsh/profiles/<name>` 目录。
|
|
71
71
|
- **注意**：删除为递归删除，操作前请二次确认；内置的 `web` 默认 profile 不允许删除，`headless` 可以删除；新建后首次使用 `dsh plugin --profile <name> add ...` 时按需安装依赖。
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
|
|
76
76
|
|
|
77
77
|
### RSS / 新闻聚合（@hyzyn/dsh-rss）
|
|
78
78
|
|
|
@@ -86,11 +86,11 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
86
86
|
- **存哪里**：`~/.dsh/rss-digest/YYYY-MM-DD.md`（可用 `DSH_RSS_DIGEST_DIR` 覆盖）。
|
|
87
87
|
- **注意**：首次安装启动时会联网抓取一次；某个源不可达时会在 digest 的「抓取失败」里列出，不影响其它源。
|
|
88
88
|
|
|
89
|
-
|
|
89
|
+
|
|
90
90
|
|
|
91
|
-
|
|
91
|
+
|
|
92
92
|
|
|
93
|
-
|
|
93
|
+
|
|
94
94
|
|
|
95
95
|
### 全局搜索（@hyzyn/dsh-search）
|
|
96
96
|
|
|
@@ -100,9 +100,9 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
100
100
|
- **存哪里**：无独立配置。
|
|
101
101
|
- **注意**：需要宿主已安装 `sessionQuery` 服务；缺失时会话搜索返回空列表。若 `session-query` 全文索引配置为 `openAt: "never"`，历史会话会自动降级为逐会话扫描；会话结果会过滤为当前可跳转的可见会话。「新会话」复用 GUI 自己的 `uiWorkspace.startSession()`；「打开文件夹」在未安装目录选择器插件时不出现。
|
|
102
102
|
|
|
103
|
-
|
|
103
|
+
|
|
104
104
|
|
|
105
|
-
|
|
105
|
+
|
|
106
106
|
|
|
107
107
|
### Codegraph 集成（@hyzyn/dsh-codegraph）
|
|
108
108
|
|
|
@@ -113,7 +113,7 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
113
113
|
- **存哪里**：索引在项目 `.codegraph/` 目录（由 `codegraph index` 生成）；默认项目路径持久化在 settings 命名空间 `codegraph`。
|
|
114
114
|
- **注意**：查询目标项目需要先有 Codegraph 索引；未索引项目会返回指引改用常规工具。索引 / 重建为本地 CLI 操作，消耗真实磁盘与 CPU。一台 codegraph MCP 服务器同一时刻只挂载一个默认项目，其它已索引项目可在工具调用里传 `projectPath` 查询。
|
|
115
115
|
|
|
116
|
-
|
|
116
|
+
|
|
117
117
|
|
|
118
118
|
### 终端面板（@hyzyn/dsh-tty）
|
|
119
119
|
|
|
@@ -125,13 +125,13 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
125
125
|
- **存哪里**：无独立配置文件；配置走「设置 → 插件 → 终端面板」卡片。
|
|
126
126
|
- **注意**：resize 依赖 DSH 内部 terminal handle 结构（已知限制）；输出为 utf8 文本流，`cat` 二进制文件会有替换字符。详细见 `packages/tty/README.md`。
|
|
127
127
|
|
|
128
|
-
|
|
128
|
+
|
|
129
129
|
|
|
130
|
-
|
|
130
|
+
|
|
131
131
|
|
|
132
|
-
|
|
132
|
+
|
|
133
133
|
|
|
134
|
-
|
|
134
|
+
|
|
135
135
|
|
|
136
136
|
### Docker 容器面板（@hyzyn/dsh-docker）
|
|
137
137
|
|
|
@@ -153,7 +153,7 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
153
153
|
- **存哪里**：`~/.dsh/env.yml` 的托管区块（自动生成，请勿手改）。
|
|
154
154
|
- **注意**：键名只允许字母 / 数字 / 下划线，且不能重复。
|
|
155
155
|
|
|
156
|
-
|
|
156
|
+
|
|
157
157
|
|
|
158
158
|
### Prompt 管理（@hyzyn/dsh-prompt）
|
|
159
159
|
|
|
@@ -163,7 +163,7 @@ dsh-plugin-kit 是给 DeepSeek Harness（DSH）Web GUI 用的通用插件集合
|
|
|
163
163
|
- **存哪里**：`~/.dsh/prompts.yml` 的托管区块。
|
|
164
164
|
- **注意**：每个 Prompt 至少一个版本，单版本内容 ≤ 500KB。
|
|
165
165
|
|
|
166
|
-
|
|
166
|
+
|
|
167
167
|
|
|
168
168
|
## 快速开始
|
|
169
169
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hyzyn/dsh-plugin-kit",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.19",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "通用 DSH 插件库（pnpm monorepo）：模板插件、插件开发工具包、一键聚合安装包。根包同时是全家桶 bundle（dsh.bundle.patch），DSH 与插件市场可直接识别安装。",
|
|
6
6
|
"main": "lib/index.js",
|
|
@@ -34,15 +34,15 @@
|
|
|
34
34
|
"access": "public"
|
|
35
35
|
},
|
|
36
36
|
"dependencies": {
|
|
37
|
-
"@hyzyn/dsh-codegraph": "0.1.
|
|
38
|
-
"@hyzyn/dsh-docker": "0.3.
|
|
39
|
-
"@hyzyn/dsh-env": "0.2.
|
|
40
|
-
"@hyzyn/dsh-mcp": "0.1.
|
|
37
|
+
"@hyzyn/dsh-codegraph": "0.1.10",
|
|
38
|
+
"@hyzyn/dsh-docker": "0.3.3",
|
|
39
|
+
"@hyzyn/dsh-env": "0.2.1",
|
|
40
|
+
"@hyzyn/dsh-mcp": "0.1.9",
|
|
41
41
|
"@hyzyn/dsh-profile": "0.1.7",
|
|
42
|
-
"@hyzyn/dsh-prompt": "0.1.
|
|
42
|
+
"@hyzyn/dsh-prompt": "0.1.7",
|
|
43
43
|
"@hyzyn/dsh-rss": "0.2.0",
|
|
44
44
|
"@hyzyn/dsh-search": "0.2.0",
|
|
45
|
-
"@hyzyn/dsh-tty": "0.16.
|
|
45
|
+
"@hyzyn/dsh-tty": "0.16.2"
|
|
46
46
|
},
|
|
47
47
|
"scripts": {
|
|
48
48
|
"build": "pnpm -r build",
|