命令应用市场 / Command App Market
概述
命令应用市场是 CmdWise 的核心功能之一，为用户提供了一个集中的平台来浏览、搜索和安装各种预制的命令行工具。通过可视化界面，即使是初学者也能轻松管理复杂的命令行工具。
核心交互
| 操作 | 结果 | 备注 |
|---|---|---|
| 进入应用市场 | 点击侧栏云图标 | 自动加载适配应用 |
| 浏览应用卡片 | 查看图标、描述、下载量 | 响应式网格，自适应列 |
| 搜索关键词 | 实时过滤应用 | 支持名称、命令、功能 |
| 分页切换 | 浏览更多应用 | 每页 20 个应用 |
| 查看详情 | 单击应用卡片 | 跳转详情页 |
| 下载 / 更新 | 点击「下载应用」按钮 | 下载并添加到本地库 |
| 命令缺失引导 | 自动检测并提示 Homebrew | 一键安装或搜索包 |
浏览与搜索
快速入口
- 打开 CmdWise，点击侧栏 图标即可进入「命令应用市场」，系统会自动加载与当前系统匹配的应用列表。
应用卡片 & 网格布局
| 区块 | 详情 |
|---|---|
| 应用卡片信息 | • 应用图标与名称 • 功能描述 • 支持的操作系统 • 基础命令名称 • 下载次数统计 |
| 网格布局 | • 自适应列数，随屏幕大小变化 • 响应式设计，适配不同分辨率 |
搜索
| 搜索对象 | 关键词示例 | 说明 |
|---|---|---|
| 应用名称 | ffmpeg-gui | 输入完整或部分名称 |
| 命令关键词 | pdf, ffmpeg | 依据底层命令搜索 |
| 功能描述 | 图片格式, 音频提取 | 依据功能关键词搜索 |
| 清空搜索 | (空) | 删除输入后返回全部应用 |
输入关键词后，点击 🔍 或按 Enter 可立即触发搜索。
搜索状态
| 状态 | UI 表现 | 说明 |
|---|---|---|
| 加载中 | 旋转图标 | 搜索进行中 |
| 无结果 | “无匹配结果” 提示 | 未找到相关应用 |
| 错误 | 错误提示 + 重试按钮 | 网络异常或服务不可用 |
分页浏览
- 当应用数量超过 20 个时，系统会自动分页；使用底部分页控件可快速跳转任何页码。
一键安装 / 更新
查看应用详情
- 点击应用卡片：任意点击应用卡片区域
- 进入预览页面：系统会跳转到应用详情页面
- 详情页面内容：
- 应用的详细介绍
- 检测命令是否可用
- 可视化操作界面
安装应用
安装流程
- 在应用详情页面点击 "下载应用" 按钮
- 系统会自动：
- 下载应用文件
- 添加到本地应用库
Homebrew 引导安装
什么是 Homebrew
Homebrew 是 macOS 上最流行的包管理器，许多命令行工具都通过它来安装和管理。CmdWise 集成了智能的 Homebrew 支持，让安装过程更加简单。
未安装 Brew 时的自动提示
自动检测
| 检测步骤 | 说明 |
|---|---|
| 智能检测 | 自动检查是否已安装 Homebrew |
| 路径扫描 | 搜索常见安装路径 |
| 版本验证 | 确认 Homebrew 版本与可用性 |
安装引导界面
如果未检测到 Homebrew，系统会显示友好的引导界面：
- 点击 “一键安装 Homebrew”，弹出终端命令行执行脚本安装brew。
Brew 搜索 & 安装命令
智能包搜索
当检测到缺少某个命令时，系统会：
- 精确匹配：首先搜索与命令名完全匹配的包
- 模糊搜索：如果精确匹配失败，进行模糊搜索
错误处理
常见问题及解决方案：
- 网络连接问题
- 显示网络错误提示
- 提供重试按钮
- 建议检查网络连接
通过以上功能，CmdWise 命令应用市场为用户提供了一个安全、便捷、智能的命令行工具管理平台，让复杂的命令行操作变得简单易用。