# CLI 命令

## 核心

| 命令 | 说明 |
| :--- | :--- |
| `mindos` | 显示帮助，或使用 `~/.mindos/config.json` 中保存的模式启动 |
| `mindos onboard` / `mindos init` | 交互式初始化（生成配置、选择模板） |
| `mindos onboard --install-daemon` | 初始化 + 安装并启动后台服务 |
| `mindos start` | 前台启动 Web + MCP 服务（生产模式） |
| `mindos start --daemon` | 安装并以后台 OS 服务方式启动（关闭终端仍运行，崩溃自动重启） |
| `mindos dev` | 启动 Web + MCP 服务（开发模式，使用 webpack 热更新） |
| `mindos open` | 在默认浏览器中打开 Web UI |
| `mindos stop` | 停止正在运行的 MindOS 进程 |
| `mindos restart` | 停止后重新启动 |
| `mindos build` | 手动构建生产版本 |
| `mindos status` | 查看服务状态概览（支持 `--json`） |

## 知识库

| 命令 | 说明 |
| :--- | :--- |
| `mindos file list` | 列出知识库中所有文件 |
| `mindos file read <path>` | 读取文件内容 |
| `mindos file create <path>` | 创建新文件 |
| `mindos file delete <path>` | 删除文件 |
| `mindos file search "<query>"` | 按文件名搜索 |
| `mindos space list` | 列出所有空间 |
| `mindos space create <name>` | 创建新空间 |
| `mindos space info <name>` | 查看空间详情 |
| `mindos search "<query>"` | 通过 API 搜索知识库 |
| `mindos ask "<question>"` | 基于知识库向 AI 提问 |
| `mindos agent list` | 列出已检测到的 AI Agent |
| `mindos agent info <name>` | 查看 Agent 详情和 MCP 配置 |
| `mindos api <METHOD> <path>` | API 透传（GET/POST/PUT/DELETE） |

> 所有知识库命令均支持 `--json` 供 AI Agent 调用。

## IM 渠道

| 命令 | 说明 |
| :--- | :--- |
| `mindos channel` | 管理 IM 平台配置 |
| `mindos feishu-ws` | 启动飞书/Lark 长连接客户端 |

## MCP

| 命令 | 说明 |
| :--- | :--- |
| `mindos mcp` | 仅启动 MCP 服务 |
| `mindos mcp install` | 自动将 MCP 配置写入 Agent（交互式） |
| `mindos mcp install -g -y` | 一键全局安装 |
| `mindos token` | 查看当前 Auth token 及 MCP 配置片段 |

MCP Server 的源码入口是 `packages/mindos/src/protocols/mcp-server`；npm/桌面运行时使用 MindOS runtime package 内预构建的 `dist/protocols/mcp-server/index.cjs`。

## 同步

| 命令 | 说明 |
| :--- | :--- |
| `mindos sync` | 查看同步状态（`sync status` 的别名） |
| `mindos sync init` | 交互式配置 Git 远程同步 |
| `mindos sync status` | 查看同步状态：最后同步时间、未推送提交、冲突 |
| `mindos sync now` | 手动触发完整同步（commit + push + pull） |
| `mindos sync on` | 启用自动同步 |
| `mindos sync off` | 禁用自动同步 |
| `mindos sync conflicts` | 列出未解决的冲突文件 |

## 后台服务（Gateway）

| 命令 | 说明 |
| :--- | :--- |
| `mindos gateway install` | 安装后台服务（Linux 用 systemd，macOS 用 LaunchAgent） |
| `mindos gateway uninstall` | 卸载后台服务 |
| `mindos gateway start` | 启动后台服务 |
| `mindos gateway stop` | 停止后台服务 |
| `mindos gateway status` | 查看后台服务状态 |
| `mindos gateway logs` | 实时查看服务日志 |

## 运维

| 命令 | 说明 |
| :--- | :--- |
| `mindos doctor` | 健康检查（配置、端口、构建、daemon 状态） |
| `mindos update` | 更新 MindOS 到最新版本 |
| `mindos uninstall` | 完整卸载 MindOS（停止进程、移除 daemon、npm 卸载） |
| `mindos logs` | 实时查看服务日志（`~/.mindos/mindos.log`） |
| `mindos config show` | 查看当前配置（API Key 脱敏显示） |
| `mindos config validate` | 验证配置文件 |
| `mindos config set <key> <val>` | 更新单个配置字段 |
