@noob-stupid/dsh-plugin-console 0.3.24-beta.2 → 0.3.25

package/README.md

@@ -6,26 +6,6 @@
 
 # DSH Plugin Hub (dsh-plugin-hub)
 
-> ## 🧪 v0.3.24-beta.1 — AI Empower open beta (2026-08-31)
->
-> A new **AI Empower** feature is ready for public testing:
-> give the Plugin Console a package name or GitHub repo, and the local AI reads its
-> docs, drafts a **deployment plan** (install/write config/start service/health check),
-> and — after your confirmation — executes it safely. Server-type components get an
-> automatic control card (start/stop/status/open + dropdown).
->
-> **Install the beta:**
-> ```bash
-> npm i -g @noob-stupid/dsh-plugin-console@beta
-> # or in DSH: dsh plugin --profile web add @noob-stupid/dsh-plugin-console@beta
-> ```
-> **Try it:** Plugin Console → **AI 赋能** button (below the AI fallback toggle) →
-> enter e.g. `OpenViking` → confirm the plan → watch it deploy.
->
-> Known limits: docs-driven only (README quality matters); interactive/docker/login-based
-> setups are not supported yet. Feedback: [GitHub Issues](https://github.com/Noob-stupid/dsh-plugin-hub/issues).
-
-
 [![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 [![GitHub stars](https://img.shields.io/github/stars/Noob-stupid/dsh-plugin-hub?style=flat-square&logo=github)](https://github.com/Noob-stupid/dsh-plugin-hub/stargazers)
@@ -38,6 +18,24 @@
 [![GitHub Release](https://img.shields.io/github/v/release/Noob-stupid/dsh-plugin-hub?style=flat-square)](https://github.com/Noob-stupid/dsh-plugin-hub/releases)[![dsh.so security](https://www.dsh.so/badge/dsh-plugin-hub.svg)](https://www.dsh.so/artifact/dsh-plugin-hub)
 [![dsh.so install](https://www.dsh.so/badge/install/dsh-plugin-hub.svg)](https://www.dsh.so/artifact/dsh-plugin-hub)
 
+
+
+> ## 🎉 v0.3.24 — AI Empower released (2026-08-31)
+>
+> Give the Plugin Console a package name or GitHub repo: the local AI reads its docs,
+> drafts a **deployment plan** (install / write config / start service / health check),
+> and — after your confirmation — executes it safely. Server-type components get an
+> automatic control card (start/stop/status/open + dropdown). An OpenViking template
+> deploys a local memory server in one flow.
+>
+> **Install:**
+> ```bash
+> npm i -g @noob-stupid/dsh-plugin-console
+> # or in DSH: dsh plugin --profile web add @noob-stupid/dsh-plugin-console
+> ```
+> **Try it:** Plugin Console → **AI 赋能** button → enter e.g. `OpenViking` → confirm the plan.
+>
+> Feedback: [GitHub Issues](https://github.com/Noob-stupid/dsh-plugin-hub/issues).
 A **plugin management panel** for the DeepSeek Harness (DSH) Web GUI: one-click
 enable/disable of installed plugins, a **multi-source plugin marketplace**
 (GitHub / Gitee / custom sources) with one-click install, an **auto-collected
@@ -83,13 +81,58 @@ auto-rollback).
 
 | | Benefit | Detail |
 |---|---|---|
+| 🤖 | **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 |
+| 🚀 | **Server component cards** | Left-side floating card auto-aligned to the main panel: start / stop / status / **open Web UI** buttons, multi-server dropdown, collapsible |
 | 🧩 | **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 |
 | 🤖 | **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 |
 | ⚡ | **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** |
-| 🔄 | **Version detection & one-click update** | Installed entries are matched against npm `dist-tags.latest` automatically; cards show **「更新 → vX」**; subpackage mismatch warnings prevent mixed-version breakage |
+| 🔄 | **Version detection & one-click update** | Semver-based; installed entries match npm `dist-tags.latest` / `beta`; subpackage mismatch warnings prevent mixed-version breakage |
 | 🔀 | **Multi-source** | GitHub / Gitee (direct-repo mode) / custom search sources (URL template + header auth + private http); `⊞` merges GitHub + all custom sources in parallel |
 | 🔒 | **Safe by default** | Loopback-only routes; AI fallback behind an explicit cost-consent modal; infrastructure rows are toggle-protected |
 
+<details>
+<summary><b>📑 目录 / Table of Contents</b></summary>
+
+- [Highlights](#highlights)
+- [AI 赋能与服务器组件控制](#ai-赋能与服务器组件控制)
+- [One-click install](#one-click-install)
+- [Usage](#usage)
+- [Features](#features)
+- [How it works](#how-it-works)
+- [Compatibility](#compatibility)
+- [Project layout](#project-layout)
+- [HTTP endpoints](#http-endpoints)
+- [Security](#security)
+- [Known limitations](#known-limitations)
+- [Help & Ecosystem](#help--ecosystem)
+- [Contributing](#contributing)
+- [Changelog](#changelog)
+- [License](#license)
+</details>
+
+---
+
+## AI 赋能与服务器组件控制
+
+> **AI Empower** — v0.3.24 正式版核心功能。
+
+在插件控制台输入 **npm 包名或 GitHub 仓库**（如 `OpenViking`、`@noob-stupid/dsh-plugin-console`）：
+
+1. **AI 读文档出计划**：子代理调研 README/docs，产出结构化计划（类型：纯插件 / 服务器组件 / 仅配置；步骤：安装 / 写配置 / 下载 / 启动服务 / 健康检查）；
+2. **你确认**（计划在弹窗里逐步骤勾选）——安全护栏：命令/路径白名单、破坏性命令拦截、日志脱敏；
+3. **安全执行**：实时回显日志、可中断、幂等（已装/已下载/服务健康则复用）；
+4. **自动生成组件卡片**：服务器类组件注册到组件清单，卡片出现在主面板左侧（启动/停止/状态/【打开】直达 Web UI；多服务器时 ▾ 下拉；打开详情时自动隐藏；可折叠并有状态记忆）。
+
+**内置 OpenViking 模板**：输入 `OpenViking` 秒出计划（pip 装 `openviking[local-embed]` → 下载中文嵌入模型 → 写 `ov.conf`（复用 DSH 的 DeepSeek 凭据，支持独立区块覆盖）→ 启动服务器 → 健康检查）。
+
+**模型配置**：默认跟随 DSH（`settings.yaml` + `.credentials.yaml`）；可建 `~/.dsh/plugin-console/ai-empower.json` 独立覆盖：
+
+```json
+{ "vlm": { "provider": "openai", "api_base": "https://api.deepseek.com", "model": "deepseek-v4-flash-vision-exp" }, "api_key": "sk-..." }
+```
+
+---
+
 > **For plugin authors**: add the `dsh-plugin` topic to your repo — the official
 > [topic list](https://github.com/topics/dsh-plugin) is how both the ecosystem and this
 > hub discover you. For skills, add `agent-skills` / `claude-skills` / `dsh-skill`.
@@ -472,6 +515,17 @@ If this panel saves you time or makes DSH more fun to use:
 
 ---
 
+## Contributing
+
+Contributions of all kinds are welcome — issues, PRs, docs, translations.
+
+- **Guidelines**: [CONTRIBUTING.md](CONTRIBUTING.md)
+- **Code of Conduct**: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+- **Security policy**: [SECURITY.md](SECURITY.md) (report vulnerabilities privately)
+- **Issue templates**: bug reports & feature requests via the [new issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues/new/choose) page
+
+---
+
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md).

package/README.zh.md

@@ -6,22 +6,20 @@
 
 # DSH 插件中心（dsh-plugin-hub）
 
-> ## 🧪 v0.3.24-beta.1 — AI 赋能开放测试（2026-08-31）
+> ## 🎉 v0.3.24 正式发布 — AI 赋能一键部署（2026-08-31）
 >
-> 全新 **AI 赋能** 功能开放测试：在插件控制台输入 npm 包名或 GitHub 仓库，
-> 本地 AI 读取文档生成**部署计划**（安装/写配置/启动服务/健康检查），
+> 在插件控制台输入 npm 包名或 GitHub 仓库，本地 AI 读取文档自动生成**部署计划**，
 > 你确认后安全执行；服务器类组件自动生成控制卡片（启动/停止/状态/打开 + 下拉）。
+> 内置 OpenViking 模板，一条指令部署本地记忆服务器。
 >
-> **安装测试版：**
+> **安装：**
 > ```bash
-> npm i -g @noob-stupid/dsh-plugin-console@beta
-> # 或在 DSH 中：dsh plugin --profile web add @noob-stupid/dsh-plugin-console@beta
+> npm i -g @noob-stupid/dsh-plugin-console
+> # 或在 DSH 中更新：dsh plugin --profile web add @noob-stupid/dsh-plugin-console
 > ```
-> **体验入口：** 插件控制台 → 右上角 **AI 赋能** 按钮（AI 兜底按钮正下方）→
-> 输入如 `OpenViking` → 确认计划 → 观看自动部署。
+> **体验入口：** 插件控制台 → 右上角 **AI 赋能** 按钮 → 输入如 `OpenViking` → 确认计划 → 自动部署。
 >
-> **已知限制：** 文档驱动（依赖 README 质量）；交互式安装 / docker / 需要登录授权的
-> 组件暂不支持。反馈：[GitHub Issues](https://github.com/Noob-stupid/dsh-plugin-hub/issues)。
+> 反馈：[GitHub Issues](https://github.com/Noob-stupid/dsh-plugin-hub/issues)。
 
 
 [![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)
@@ -76,12 +74,57 @@
 
 | | 优势 | 说明 |
 |---|---|---|
-| 🧩 | **插件 + 技能双市场** | 自动收录 `dsh-plugin` topic 仓库（按 star **500+**），另有**技能 tab**（`agent-skills` ∪ `claude-skills` ∪ `dsh-skill`，最多 300）——浏览、搜索、一键安装，零 GitHub API 调用 |
+| 🤖 | **AI 赋能（v0.3.24）** | 输入 npm 包名 / GitHub 仓库，本地 AI 读文档生成**部署计划**（安装/写配置/启动服务/健康检查），你确认后安全执行；服务器类组件自动生成控制卡片 |
+| 🚀 | **服务器组件卡片** | 左侧浮卡与主面板顶边对齐：启动 / 停止 / 状态 / 【打开】直达 Web UI，多服务器下拉、可折叠（状态记忆） |
+| 🧩 | **插件 + 技能双市场** | 自动收录 `dsh-plugin` topic 仓库（按 star **500+**），另有**技能 tab**（`agent-skills` ∪ `claude-skills` ∪ `dsh-skill`，最多 300）——浏览、搜索、一键安装，零 GitHub API 调用；插件自带技能（如 openviking-memory）只读展示 |
 | 🤖 | **自动收录 CI** | GitHub Actions 每 6 小时自动重跑 `build-index`（也支持手动触发）；作者只需给自己的仓库打 `dsh-plugin` / `agent-skills` / `claude-skills` / `dsh-skill` 标签，**无需申请、无需审核** |
 | ⚡ | **秒开、零限流** | 索引以静态 `marketplace/index.json` 提交仓库，经 jsDelivr CDN 分发（宿主 10 分钟缓存）——终端用户**零 GitHub API 调用、零限流** |
-| 🔄 | **版本检测与一键更新** | 已安装条目自动比对 npm `dist-tags.latest`，卡片出现「更新 → vX」；聚合包子包版本不配套时给出 depsOutdated 提示，避免版本混搭启动冲突 |
+| 🔄 | **版本检测与一键更新** | semver 比较 + beta/next 识别（本地已是测试版最新时不误报）；已安装条目自动比对 npm `dist-tags`，聚合包子包版本不配套时给出 depsOutdated 提示 |
 | 🔀 | **多源检索** | GitHub / Gitee（仓库直装模式）/ 自定义搜索源（URL 模板 + 请求头认证 + 私网 http）；「⊞」并行合并 GitHub + 全部自定义源 |
-| 🔒 | **安全默认** | 全部路由仅环回；AI 兜底置于明确费用授权弹窗之后；基础设施行禁止开关（受保护） |
+| 🔒 | **安全默认** | 全部路由仅环回；AI 兜底置于明确费用授权弹窗之后；AI 赋能执行器命令/路径白名单；基础设施行禁止开关（受保护） |
+
+<details>
+<summary><b>📑 目录</b></summary>
+
+- [核心优势](#核心优势)
+- [AI 赋能与服务器组件控制](#ai-赋能与服务器组件控制)
+- [一键部署](#一键部署)
+- [使用方法](#使用方法)
+- [功能](#功能)
+- [原理](#原理)
+- [兼容性策略](#兼容性策略)
+- [项目结构](#项目结构)
+- [HTTP 接口](#http-接口)
+- [安全说明](#安全说明)
+- [已知限制](#已知限制)
+- [帮助 / Help](#帮助--help)
+- [生态与收录](#生态与收录)
+- [参与贡献](#参与贡献)
+- [许可证](#许可证)
+</details>
+
+---
+
+## AI 赋能与服务器组件控制
+
+> **AI 赋能** — v0.3.24 正式版核心功能。
+
+在插件控制台输入 **npm 包名或 GitHub 仓库**（如 `OpenViking`、`@noob-stupid/dsh-plugin-console`）：
+
+1. **AI 读文档出计划**：子代理调研 README/docs，产出结构化计划（类型：纯插件 / 服务器组件 / 仅配置；步骤：安装 / 写配置 / 下载 / 启动服务 / 健康检查）；
+2. **你确认**（计划弹窗里逐步骤勾选）——安全护栏：命令/路径白名单、破坏性命令拦截、日志脱敏；
+3. **安全执行**：实时回显日志、可中断、幂等（已装 / 已下载 / 服务健康则复用）；
+4. **自动生成组件卡片**：服务器类组件注册到组件清单，卡片出现在主面板左侧（启动/停止/状态/【打开】直达 Web UI；多服务器时 ▾ 下拉；打开详情时自动隐藏；可折叠并有状态记忆）。
+
+**内置 OpenViking 模板**：输入 `OpenViking` 秒出计划（pip 装 `openviking[local-embed]` → 下载中文嵌入模型 → 写 `ov.conf`（复用 DSH 的 DeepSeek 凭据）→ 启动服务器 → 健康检查）。
+
+**模型配置**：默认跟随 DSH（`settings.yaml` + `.credentials.yaml`）；可建 `~/.dsh/plugin-console/ai-empower.json` 独立覆盖：
+
+```json
+{ "vlm": { "provider": "openai", "api_base": "https://api.deepseek.com", "model": "deepseek-v4-flash-vision-exp" }, "api_key": "sk-..." }
+```
+
+---
 
 > **给插件作者**：给仓库打上 `dsh-plugin` 标签即可被官方 [topic 列表](https://github.com/topics/dsh-plugin)
 > 与本中心自动收录；技能类仓库请打 `agent-skills` / `claude-skills` / `dsh-skill`。
@@ -425,6 +468,17 @@ node scripts/apply-framework-patch.cjs
 
 ---
 
+## 参与贡献
+
+欢迎各种形式的贡献——Issue、PR、文档、翻译：
+
+- **贡献指南**：[CONTRIBUTING.md](CONTRIBUTING.md)
+- **行为准则**：[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+- **安全政策**：[SECURITY.md](SECURITY.md)（漏洞私下报告）
+- **Issue 模板**：从 [新建 Issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues/new/choose) 页面选择 Bug / 功能建议
+
+---
+
 ## 更新日志
 
 版本记录见 [CHANGELOG.md](CHANGELOG.md)。