@noob-stupid/dsh-plugin-console 0.3.24 → 0.3.25
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.md +57 -1
- package/README.zh.md +59 -3
- package/lib/client.js +451 -67
- package/lib/index.js +744 -22
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -81,13 +81,58 @@ auto-rollback).
|
|
|
81
81
|
|
|
82
82
|
| | Benefit | Detail |
|
|
83
83
|
|---|---|---|
|
|
84
|
+
| 🤖 | **AI Empower (v0.3.24)** | Give the console a package name or GitHub repo — the local AI reads docs, drafts a **deployment plan** (install / write config / start service / health check) and executes it safely after your confirmation; server-type components get an automatic control card |
|
|
85
|
+
| 🚀 | **Server component cards** | Left-side floating card auto-aligned to the main panel: start / stop / status / **open Web UI** buttons, multi-server dropdown, collapsible |
|
|
84
86
|
| 🧩 | **Plugin & skill hub** | Auto-collected index of `dsh-plugin` topic repos (**500+** by stars) plus a **Skills tab** (`agent-skills` ∪ `claude-skills` ∪ `dsh-skill`, up to 300) — browse, search, one-click install, no GitHub API calls |
|
|
85
87
|
| 🤖 | **Auto-collection CI** | GitHub Actions reruns `build-index` every 6 hours (manual trigger available); authors just add the `dsh-plugin` / `agent-skills` / `claude-skills` / `dsh-skill` topic — no application needed |
|
|
86
88
|
| ⚡ | **Instant, rate-limit-free** | The index is served as a static `marketplace/index.json` via jsDelivr CDN (10-min host cache); terminal users make **zero GitHub API calls** |
|
|
87
|
-
| 🔄 | **Version detection & one-click update** |
|
|
89
|
+
| 🔄 | **Version detection & one-click update** | Semver-based; installed entries match npm `dist-tags.latest` / `beta`; subpackage mismatch warnings prevent mixed-version breakage |
|
|
88
90
|
| 🔀 | **Multi-source** | GitHub / Gitee (direct-repo mode) / custom search sources (URL template + header auth + private http); `⊞` merges GitHub + all custom sources in parallel |
|
|
89
91
|
| 🔒 | **Safe by default** | Loopback-only routes; AI fallback behind an explicit cost-consent modal; infrastructure rows are toggle-protected |
|
|
90
92
|
|
|
93
|
+
<details>
|
|
94
|
+
<summary><b>📑 目录 / Table of Contents</b></summary>
|
|
95
|
+
|
|
96
|
+
- [Highlights](#highlights)
|
|
97
|
+
- [AI 赋能与服务器组件控制](#ai-赋能与服务器组件控制)
|
|
98
|
+
- [One-click install](#one-click-install)
|
|
99
|
+
- [Usage](#usage)
|
|
100
|
+
- [Features](#features)
|
|
101
|
+
- [How it works](#how-it-works)
|
|
102
|
+
- [Compatibility](#compatibility)
|
|
103
|
+
- [Project layout](#project-layout)
|
|
104
|
+
- [HTTP endpoints](#http-endpoints)
|
|
105
|
+
- [Security](#security)
|
|
106
|
+
- [Known limitations](#known-limitations)
|
|
107
|
+
- [Help & Ecosystem](#help--ecosystem)
|
|
108
|
+
- [Contributing](#contributing)
|
|
109
|
+
- [Changelog](#changelog)
|
|
110
|
+
- [License](#license)
|
|
111
|
+
</details>
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## AI 赋能与服务器组件控制
|
|
116
|
+
|
|
117
|
+
> **AI Empower** — v0.3.24 正式版核心功能。
|
|
118
|
+
|
|
119
|
+
在插件控制台输入 **npm 包名或 GitHub 仓库**（如 `OpenViking`、`@noob-stupid/dsh-plugin-console`）：
|
|
120
|
+
|
|
121
|
+
1. **AI 读文档出计划**：子代理调研 README/docs，产出结构化计划（类型：纯插件 / 服务器组件 / 仅配置；步骤：安装 / 写配置 / 下载 / 启动服务 / 健康检查）；
|
|
122
|
+
2. **你确认**（计划在弹窗里逐步骤勾选）——安全护栏：命令/路径白名单、破坏性命令拦截、日志脱敏；
|
|
123
|
+
3. **安全执行**：实时回显日志、可中断、幂等（已装/已下载/服务健康则复用）；
|
|
124
|
+
4. **自动生成组件卡片**：服务器类组件注册到组件清单，卡片出现在主面板左侧（启动/停止/状态/【打开】直达 Web UI；多服务器时 ▾ 下拉；打开详情时自动隐藏；可折叠并有状态记忆）。
|
|
125
|
+
|
|
126
|
+
**内置 OpenViking 模板**：输入 `OpenViking` 秒出计划（pip 装 `openviking[local-embed]` → 下载中文嵌入模型 → 写 `ov.conf`（复用 DSH 的 DeepSeek 凭据，支持独立区块覆盖）→ 启动服务器 → 健康检查）。
|
|
127
|
+
|
|
128
|
+
**模型配置**：默认跟随 DSH（`settings.yaml` + `.credentials.yaml`）；可建 `~/.dsh/plugin-console/ai-empower.json` 独立覆盖：
|
|
129
|
+
|
|
130
|
+
```json
|
|
131
|
+
{ "vlm": { "provider": "openai", "api_base": "https://api.deepseek.com", "model": "deepseek-v4-flash-vision-exp" }, "api_key": "sk-..." }
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
91
136
|
> **For plugin authors**: add the `dsh-plugin` topic to your repo — the official
|
|
92
137
|
> [topic list](https://github.com/topics/dsh-plugin) is how both the ecosystem and this
|
|
93
138
|
> hub discover you. For skills, add `agent-skills` / `claude-skills` / `dsh-skill`.
|
|
@@ -470,6 +515,17 @@ If this panel saves you time or makes DSH more fun to use:
|
|
|
470
515
|
|
|
471
516
|
---
|
|
472
517
|
|
|
518
|
+
## Contributing
|
|
519
|
+
|
|
520
|
+
Contributions of all kinds are welcome — issues, PRs, docs, translations.
|
|
521
|
+
|
|
522
|
+
- **Guidelines**: [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
523
|
+
- **Code of Conduct**: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
|
|
524
|
+
- **Security policy**: [SECURITY.md](SECURITY.md) (report vulnerabilities privately)
|
|
525
|
+
- **Issue templates**: bug reports & feature requests via the [new issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues/new/choose) page
|
|
526
|
+
|
|
527
|
+
---
|
|
528
|
+
|
|
473
529
|
## Changelog
|
|
474
530
|
|
|
475
531
|
See [CHANGELOG.md](CHANGELOG.md).
|
package/README.zh.md
CHANGED
|
@@ -74,12 +74,57 @@
|
|
|
74
74
|
|
|
75
75
|
| | 优势 | 说明 |
|
|
76
76
|
|---|---|---|
|
|
77
|
-
|
|
|
77
|
+
| 🤖 | **AI 赋能（v0.3.24）** | 输入 npm 包名 / GitHub 仓库，本地 AI 读文档生成**部署计划**（安装/写配置/启动服务/健康检查），你确认后安全执行；服务器类组件自动生成控制卡片 |
|
|
78
|
+
| 🚀 | **服务器组件卡片** | 左侧浮卡与主面板顶边对齐：启动 / 停止 / 状态 / 【打开】直达 Web UI，多服务器下拉、可折叠（状态记忆） |
|
|
79
|
+
| 🧩 | **插件 + 技能双市场** | 自动收录 `dsh-plugin` topic 仓库（按 star **500+**），另有**技能 tab**（`agent-skills` ∪ `claude-skills` ∪ `dsh-skill`，最多 300）——浏览、搜索、一键安装，零 GitHub API 调用；插件自带技能（如 openviking-memory）只读展示 |
|
|
78
80
|
| 🤖 | **自动收录 CI** | GitHub Actions 每 6 小时自动重跑 `build-index`（也支持手动触发）；作者只需给自己的仓库打 `dsh-plugin` / `agent-skills` / `claude-skills` / `dsh-skill` 标签，**无需申请、无需审核** |
|
|
79
81
|
| ⚡ | **秒开、零限流** | 索引以静态 `marketplace/index.json` 提交仓库，经 jsDelivr CDN 分发（宿主 10 分钟缓存）——终端用户**零 GitHub API 调用、零限流** |
|
|
80
|
-
| 🔄 | **版本检测与一键更新** |
|
|
82
|
+
| 🔄 | **版本检测与一键更新** | semver 比较 + beta/next 识别（本地已是测试版最新时不误报）；已安装条目自动比对 npm `dist-tags`，聚合包子包版本不配套时给出 depsOutdated 提示 |
|
|
81
83
|
| 🔀 | **多源检索** | GitHub / Gitee（仓库直装模式）/ 自定义搜索源（URL 模板 + 请求头认证 + 私网 http）；「⊞」并行合并 GitHub + 全部自定义源 |
|
|
82
|
-
| 🔒 | **安全默认** | 全部路由仅环回；AI
|
|
84
|
+
| 🔒 | **安全默认** | 全部路由仅环回；AI 兜底置于明确费用授权弹窗之后；AI 赋能执行器命令/路径白名单；基础设施行禁止开关（受保护） |
|
|
85
|
+
|
|
86
|
+
<details>
|
|
87
|
+
<summary><b>📑 目录</b></summary>
|
|
88
|
+
|
|
89
|
+
- [核心优势](#核心优势)
|
|
90
|
+
- [AI 赋能与服务器组件控制](#ai-赋能与服务器组件控制)
|
|
91
|
+
- [一键部署](#一键部署)
|
|
92
|
+
- [使用方法](#使用方法)
|
|
93
|
+
- [功能](#功能)
|
|
94
|
+
- [原理](#原理)
|
|
95
|
+
- [兼容性策略](#兼容性策略)
|
|
96
|
+
- [项目结构](#项目结构)
|
|
97
|
+
- [HTTP 接口](#http-接口)
|
|
98
|
+
- [安全说明](#安全说明)
|
|
99
|
+
- [已知限制](#已知限制)
|
|
100
|
+
- [帮助 / Help](#帮助--help)
|
|
101
|
+
- [生态与收录](#生态与收录)
|
|
102
|
+
- [参与贡献](#参与贡献)
|
|
103
|
+
- [许可证](#许可证)
|
|
104
|
+
</details>
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## AI 赋能与服务器组件控制
|
|
109
|
+
|
|
110
|
+
> **AI 赋能** — v0.3.24 正式版核心功能。
|
|
111
|
+
|
|
112
|
+
在插件控制台输入 **npm 包名或 GitHub 仓库**（如 `OpenViking`、`@noob-stupid/dsh-plugin-console`）：
|
|
113
|
+
|
|
114
|
+
1. **AI 读文档出计划**：子代理调研 README/docs，产出结构化计划（类型：纯插件 / 服务器组件 / 仅配置；步骤：安装 / 写配置 / 下载 / 启动服务 / 健康检查）；
|
|
115
|
+
2. **你确认**（计划弹窗里逐步骤勾选）——安全护栏：命令/路径白名单、破坏性命令拦截、日志脱敏；
|
|
116
|
+
3. **安全执行**：实时回显日志、可中断、幂等（已装 / 已下载 / 服务健康则复用）；
|
|
117
|
+
4. **自动生成组件卡片**：服务器类组件注册到组件清单，卡片出现在主面板左侧（启动/停止/状态/【打开】直达 Web UI；多服务器时 ▾ 下拉；打开详情时自动隐藏；可折叠并有状态记忆）。
|
|
118
|
+
|
|
119
|
+
**内置 OpenViking 模板**：输入 `OpenViking` 秒出计划（pip 装 `openviking[local-embed]` → 下载中文嵌入模型 → 写 `ov.conf`（复用 DSH 的 DeepSeek 凭据）→ 启动服务器 → 健康检查）。
|
|
120
|
+
|
|
121
|
+
**模型配置**：默认跟随 DSH（`settings.yaml` + `.credentials.yaml`）；可建 `~/.dsh/plugin-console/ai-empower.json` 独立覆盖：
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{ "vlm": { "provider": "openai", "api_base": "https://api.deepseek.com", "model": "deepseek-v4-flash-vision-exp" }, "api_key": "sk-..." }
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
---
|
|
83
128
|
|
|
84
129
|
> **给插件作者**：给仓库打上 `dsh-plugin` 标签即可被官方 [topic 列表](https://github.com/topics/dsh-plugin)
|
|
85
130
|
> 与本中心自动收录；技能类仓库请打 `agent-skills` / `claude-skills` / `dsh-skill`。
|
|
@@ -423,6 +468,17 @@ node scripts/apply-framework-patch.cjs
|
|
|
423
468
|
|
|
424
469
|
---
|
|
425
470
|
|
|
471
|
+
## 参与贡献
|
|
472
|
+
|
|
473
|
+
欢迎各种形式的贡献——Issue、PR、文档、翻译：
|
|
474
|
+
|
|
475
|
+
- **贡献指南**：[CONTRIBUTING.md](CONTRIBUTING.md)
|
|
476
|
+
- **行为准则**：[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
|
|
477
|
+
- **安全政策**：[SECURITY.md](SECURITY.md)（漏洞私下报告）
|
|
478
|
+
- **Issue 模板**：从 [新建 Issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues/new/choose) 页面选择 Bug / 功能建议
|
|
479
|
+
|
|
480
|
+
---
|
|
481
|
+
|
|
426
482
|
## 更新日志
|
|
427
483
|
|
|
428
484
|
版本记录见 [CHANGELOG.md](CHANGELOG.md)。
|