更改项目名为NebulaShell

store/@{NebulaShell}/auto-dependency/README.md

@@ -0,0 +1,117 @@
+# 依赖自动安装插件 (auto-dependency)
+
+## 概述
+
+依赖自动安装插件是一个核心系统插件，用于扫描所有插件的声明文件，检查并自动安装系统依赖。
+
+## 功能特性
+
+1. **扫描插件声明** - 自动扫描所有插件目录下的 `manifest.json` 文件
+2. **系统依赖检测** - 读取每个插件声明的系统依赖 (`system_dependencies` 字段)
+3. **安装状态检查** - 检查这些系统依赖是否已在系统中安装
+4. **自动安装** - 对于未安装的依赖，使用系统包管理器自动安装
+5. **PL 注入接口** - 通过 PL 注入机制向插件加载器注册功能接口
+
+## 使用方法
+
+### 在 manifest.json 中声明系统依赖
+
+其他插件可以在自己的 `manifest.json` 中声明所需的系统依赖：
+
+```json
+{
+  "metadata": {
+    "name": "my-plugin",
+    "version": "1.0.0",
+    "author": "MyName",
+    "description": "我的插件"
+  },
+  "config": {
+    "enabled": true,
+    "args": {}
+  },
+  "dependencies": ["plugin-loader"],
+  "system_dependencies": ["curl", "git", "wget"],
+  "permissions": []
+}
+```
+
+### 通过 PL 注入接口调用
+
+插件加载器加载此插件后，可以通过以下 PL 注入接口进行操作：
+
+| 接口名称 | 说明 | 参数 | 返回值 |
+|---------|------|------|--------|
+| `auto-dependency:scan` | 扫描所有插件的声明文件 | `scan_dir` (可选，默认 "store") | 插件信息列表 |
+| `auto-dependency:check` | 检查系统依赖安装状态 | `scan_dir` (可选，默认 "store") | 检查结果字典 |
+| `auto-dependency:install` | 安装缺失的系统依赖 | `scan_dir` (可选，默认 "store") | 安装结果字典 |
+| `auto-dependency:info` | 获取插件系统信息 | 无 | 系统信息字典 |
+
+### 示例代码
+
+```python
+# 获取插件加载器中的 auto-dependency 功能
+injector = get_pl_injector()  # 从插件加载器获取
+
+# 扫描所有插件的系统依赖声明
+plugins = injector.get_injected_functions("auto-dependency:scan")[0]()
+print(f"找到 {len(plugins)} 个插件")
+
+# 检查依赖安装状态
+result = injector.get_injected_functions("auto-dependency:check")[0]()
+print(f"已安装：{result['installed_count']}, 缺失：{result['missing_count']}")
+
+# 安装缺失的依赖
+install_result = injector.get_injected_functions("auto-dependency:install")[0]()
+print(f"成功安装：{install_result['success_count']}, 失败：{install_result['failed_count']}")
+```
+
+## 支持的包管理器
+
+插件自动检测系统使用的包管理器，支持：
+
+- **Debian/Ubuntu**: apt-get, apt
+- **RHEL/CentOS**: yum, dnf
+- **Arch Linux**: pacman
+- **macOS**: brew
+- **Alpine Linux**: apk
+
+## 配置选项
+
+在 `manifest.json` 的 `config.args` 中可以配置：
+
+```json
+{
+  "config": {
+    "enabled": true,
+    "args": {
+      "scan_dirs": ["store"],
+      "package_manager": "auto",
+      "auto_install": true
+    }
+  }
+}
+```
+
+| 配置项 | 说明 | 默认值 |
+|-------|------|--------|
+| `scan_dirs` | 要扫描的目录列表 | `["store"]` |
+| `package_manager` | 包管理器（auto 为自动检测） | `"auto"` |
+| `auto_install` | 是否自动安装缺失的依赖 | `true` |
+
+## 安全说明
+
+- 插件需要 `*` 权限才能执行系统命令安装包
+- 包安装操作有超时限制（300 秒）
+- 所有安装操作都会记录日志
+
+## 文件结构
+
+```
+store/@{NebulaShell}/auto-dependency/
+├── manifest.json      # 插件清单
+├── main.py            # 主逻辑实现
+├── PL/
+│   └── main.py        # PL 注入入口
+└── README.md          # 本文档
+```