# os 命令行与进程工具手册

## 模板（概述）

### 一句话定位

- <该工具集用途，一句话描述>

### 工具清单

- <列出核心工具，或指向工具章节>

### 30 秒上手

1. <调用 ...>
2. <观察 ...>
3. <下一步 ...>

### 导航

- principles / tools / scenarios / errors

### 与其他工具集的边界

- <何时用本工具集、何时用相邻工具集>

os 是 Dominds 的**命令行与进程工具集**，用于执行系统命令和管理进程：

- **Shell 执行**：执行系统命令
- **进程管理**：启动、停止、查看守护进程
- **环境变量**：读取、设置、删除环境变量

## 快速导航

| 主题                          | 描述                           |
| ----------------------------- | ------------------------------ |
| [principles](./principles.md) | 核心概念、安全原则、最佳实践   |
| [tools](./tools.md)           | 使用指导、边界说明与操作注意   |
| [scenarios](./scenarios.md)   | 常见使用场景与示例（复制即用） |
| [errors](./errors.md)         | 错误代码与解决方案             |

## 状态

- 状态：已实现
- 主要实现文件：
  - 工具实现：`dominds/main/tools/os.ts`
  - toolset 元信息：`dominds/main/tools/builtins.ts`、`dominds/main/tools/registry.ts`

## 安全注意事项

⚠️ Shell 命令执行需要谨慎操作：

- 避免执行破坏性命令（如 `rm -rf`）
- 使用明确路径避免路径注入；Windows 下优先用正斜杠路径
- 验证命令输出后再执行后续操作
