@zaimokuza/dsh-plugin-hub 0.1.2 → 0.2.0

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 (29) hide show
  1. package/README.md +33 -7
  2. package/THIRD_PARTY_NOTICES.md +3 -3
  3. package/lib/client.js +470 -407
  4. package/package.json +17 -24
  5. package/src/dsh.js +26 -48
  6. package/src/experiments.js +48 -0
  7. package/src/identity.js +1 -20
  8. package/src/index.js +39 -74
  9. package/src/mcp-config.js +65 -0
  10. package/src/profile-files.js +44 -0
  11. package/src/resources.js +346 -0
  12. package/src/catalog.js +0 -108
  13. package/src/client/api.js +0 -22
  14. package/src/client/index.jsx +0 -201
  15. package/src/client/locale.js +0 -104
  16. package/src/client/market.css +0 -113
  17. package/src/client/scope.js +0 -9
  18. package/src/declarations.js +0 -19
  19. package/src/host-peers.js +0 -33
  20. package/src/npm-identity.js +0 -15
  21. package/src/provider-api.d.ts +0 -36
  22. package/src/provider-api.js +0 -7
  23. package/src/providers.js +0 -85
  24. package/src/registry-config.js +0 -27
  25. package/src/registry.js +0 -15
  26. package/src/release-age.js +0 -34
  27. package/src/service.js +0 -193
  28. package/src/source-plugin.js +0 -9
  29. package/src/source.js +0 -85
package/README.md CHANGED
@@ -1,13 +1,39 @@
1
- # @zaimokuza/dsh-plugin-hub
1
+ # DSH Plugin Hub
2
2
 
3
- DSH 市场插件。原生中英文页面、多来源标签页、声明兼容检查、安装与卸载。
3
+ DSH 原生资源面板，当前版本 **0.2.0**。支持 Web 与 Desktop、中英文界面；从侧边栏打开，保留当前会话。
4
4
 
5
- DSH marketplace with native bilingual UI, source tabs, declared compatibility checks, installation and removal.
5
+ - **Skill**：搜索、按工作区筛选、启停、打开目录，使用 DSH 原生 Markdown 组件预览正文。
6
+ - **MCP**：JSON/YAML 配置编辑与格式化、环境变量引用、字段帮助、启停、重连、独立连接测试和删除。
7
+ - **Plugin**：查看当前 profile 的非官方原生插件，展示版本与来源；桌面端提供原生管理窗口入口说明。
8
+ - **实验性功能**：管理 Agent Teams；Web 支持安装与启停，Desktop 通过原生管理窗口操作。
6
9
 
7
- 说明与示例 / Guide: https://github.com/zaimokuza-yoshiteru/dsh-plugin-hub#readme
10
+ ## 安装
8
11
 
9
- 目录中的第三方插件不等于经过运行验证。 / Catalog inclusion does not mean third-party plugins were runtime-tested.
12
+ ```sh
13
+ dsh plugin --profile <当前-profile> add @zaimokuza/dsh-plugin-hub
14
+ ```
10
15
 
11
- 默认不按 DSH 版本号拦截（包括预发行版），依赖必要宿主接口；已实测版本见 package.json 的 `dshPluginHub.testedDshVersions`。
16
+ 重启 DSH 后打开 Plugin Hub。Desktop 从自身的 **Desktop Plugins** 窗口安装。
12
17
 
13
- No DSH version gate, including prereleases; required host APIs must remain available. Tested versions are recorded in package.json under `dshPluginHub.testedDshVersions`.
18
+ 要求 Node.js `^22.19.0 || >=24.0.0`；已验证 DSH `0.1.5-rc.1` 与 `0.1.5-rc.2`。
19
+
20
+ ## 使用说明
21
+
22
+ 所有管理操作绑定当前实例的 profile。Skill 启停不会修改共享文件；MCP 删除会移除 Hub 创建的配置或当前 profile 中独立的 YAML 定义，共享文件或安装包中的定义需在来源处删除。
23
+
24
+ MCP 的描述、版本和图标来自服务初始化信息。宿主未公开持续连接状态时显示“未知”，独立连接测试单独显示结果。建议在启动 DSH 时设置凭据环境变量，在 YAML 中通过 `!!js process.env.MCP_TOKEN` 引用；JSON 等价写法为 `{ "__jsExpr": "process.env.MCP_TOKEN" }`。
25
+
26
+ 目录操作作用于运行 DSH 的电脑。Desktop 原生管理窗口使用 macOS `Cmd+,`、Windows `Ctrl+,` 或系统菜单 **Desktop Plugins**。更多实现边界见 [原生资源说明](https://github.com/zaimokuza-yoshiteru/dsh-plugin-hub/blob/main/docs/native-resources.md)。
27
+
28
+ ## 开发与发布
29
+
30
+ ```sh
31
+ npm ci
32
+ npm run check
33
+ # 可选：对已安装的原生 DSH 运行隔离 profile 集成检查
34
+ DSH_TEST_ROOT=/absolute/path/to/dsh-runtime npm run verify:native
35
+ ```
36
+
37
+ 单包结构：`src/` 为源码，`tests/` 为测试，`scripts/` 为构建与发布工具。`npm run check` 执行测试、构建、打包及离线安装验证；CI 覆盖 Linux、macOS 与 Windows。
38
+
39
+ 本地预览、测试记录、调研资料、缓存和发布产物统一放在被 Git 忽略的 `.local/`；`lib/` 是构建结果，不提交。npm 仅包含运行时代码、浏览器构建及必要元数据。发布从 GitHub Actions 的 **Publish npm** 工作流触发，开启 `publish` 后发布到 npm。
package/THIRD_PARTY_NOTICES.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # 第三方声明 / Third-party notices
2
2
 
3
- 本项目的 DSH 页面注册、客户端包装与 profile 集成参考了下述 MIT 项目。原始版权与许可文本保留；目录中的外部项目仅提供链接与元数据，不包含其代码。宿主 UI 组件由 DSH 提供。
3
+ 本项目的 DSH 页面注册、客户端包装与 profile 集成参考了下述 MIT 项目。原始版权与许可文本保留；资源列表仅展示外部项目的元数据，不包含其代码。宿主 UI 组件由 DSH 提供。
4
4
 
5
- The DSH settings-section registration in `src/client/index.jsx`, client module-loader wrapper in `scripts/build.mjs`, and profile CLI integration approach were adapted from or informed by dsh-market/dsh-market, commit `1f7b502c0f3a62acfbf2190052e97c16eb798267`. This is an independent catalog implementation; it does not include the full upstream marketplace UI, installer recovery system, or hot-loading implementation.
5
+ The DSH page registration in `src/client/index.jsx`, client module-loader wrapper in `scripts/build.mjs`, and profile CLI integration approach were adapted from or informed by dsh-market/dsh-market, commit `1f7b502c0f3a62acfbf2190052e97c16eb798267`. The current resource hub retains the applicable attribution for that integration code.
6
6
 
7
7
  Upstream: https://github.com/dsh-market/dsh-market
8
8
 
@@ -16,6 +16,6 @@ The above copyright notice and this permission notice shall be included in all c
16
16
 
17
17
  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
18
 
19
- Runtime dependencies semver, tar, and undici, and build dependencies esbuild and React retain their own licenses. Their precise versions are recorded in package-lock.json.
19
+ Runtime dependencies @modelcontextprotocol/sdk and yaml, and build dependencies esbuild and React retain their own licenses. Their precise versions are recorded in package-lock.json.
20
20
 
21
21
  The UI consumes the host-provided `@deepseek-ai/dsh-client-ui-primitives` (Input, Button, Menu and Modal). These components and their styles are resolved from the DSH module table, not copied or bundled into this plugin.