# Multishell 模块增强版

## 概述

`multishell` 是 ComputerCraft 中用于支持多任务并发执行的核心模块。它通过在终端顶部显示标签页（tab bar）的方式，允许用户同时运行多个程序，并在它们之间自由切换。本增强版本在原版基础上新增了多项功能，显著提升了多进程管理的灵活性和可用性。

---

## 新增功能亮点

### 1. **高级进程启动接口：`newlaunch`**

新增 `multishell.newlaunch(options)` 函数，提供更灵活的进程启动方式：

- **支持直接运行函数**：除了传统的程序路径 (`path`)，现在可以直接传入一个 Lua 函数 (`func`) 来执行。
- **精细化控制选项**：
  - `hideTab`: 启动时隐藏该进程的标签页，适用于后台服务或辅助进程。
  - `autoClose`: 程序结束后自动关闭，无需用户按任意键确认，提升自动化脚本体验。
- **参数与环境隔离**：每个进程拥有独立的 `env` (环境) 和 `args` (参数) 表，确保沙箱安全。

```lua
-- 示例：启动一个隐藏的后台计时器
local id = multishell.newlaunch({
    func = function()
        for i = 10, 1, -1 do
            print("Countdown:" .. i)
            os.sleep(1)
        end
        print("Time's up!")
    end,
    hideTab = true,
    autoClose = true
})
```

### 2. **全面的进程信息查询**

新增两个强大的查询函数，让开发者能完全掌控所有运行中的进程：

- **`multishell.getProcessInfo(n)`**: 获取指定进程 ID 的详细信息，包括：
  - 进程类型 (`Path` 或 `Function`)
  - 程序路径或函数引用
  - 环境变量、启动参数
  - 标题、协程状态 (`running`, `suspended`, `dead`)
  - `hideTab` 和 `autoClose` 状态
- **`multishell.listProcesses()`**: 返回一个包含所有进程信息的列表，便于构建进程管理器或监控工具。

```lua
-- 示例：列出所有正在运行的进程及其状态
for _, info in ipairs(multishell.listProcesses()) do
    print(string.format("ID: %d, Title: %s, Status: %s", info.id, info.title, info.status))
end
```

### 3. **动态标签页管理：`setHideTab`**

新增 `multishell.setHideTab(n, hide)` 函数，允许在进程运行期间动态地隐藏或显示其标签页。这为实现复杂的 UI 逻辑（如最小化到托盘、创建无界面后台任务）提供了可能。

### 4. **进程终止机制：`stop`**

新增 `multishell.stop(n)` 函数
- 主动向目标进程发送 `"terminate"` 事件，给予其优雅退出的机会。
- 如果进程未响应，会强制跳过“Press any key to continue”提示并进行清理。
- 正确处理菜单可见性和重绘，避免界面残留。

---

## 兼容性与注意事项

- **API 非全局性**：与 `shell` 模块一样，`multishell` API 并非全局可用。它仅在由 `multishell` 启动的 shell 环境中被注入。因此，无法通过 `os.loadAPI` 在其他环境中加载此 API。
- **进程 ID 的不稳定性**：进程 ID 对应于其在标签列表中的位置。当其他进程被关闭时，后续进程的 ID 会发生变化。请勿长期保存 ID，而应在每次操作前重新获取。
- **版权与许可**：本代码基于 Daniel Ratcliffe 于 2017 年创作的原始 `multishell` 模块，并遵循 `LicenseRef-CCPL` 许可证。

---

## 使用示例

### 启动一个自动关闭的 Hello World 程序
```lua
id = multishell.newlaunch({
    path = "/rom/programs/fun/hello.lua",
    autoClose = true,
    args = {}
})
```

### 启动一个后台隐藏的音频播放器（speaker）
 
```lua
id = multishell.newlaunch({
    path = "/rom/programs/fun/speaker.lua",
    
    args = {"play","audio.dfpwm"}
    hideTab = true,
    autoClose = true,
})
```

这些新功能极大地扩展了 `multishell` 的应用场景，使其从一个简单的多任务切换工具，转变为一个功能完备的多进程管理系统。