ConfigHub

ConfigHub 是一个 macOS 原生 SwiftUI 脚本控制台，用来统一发现、理解和执行本地脚本。产品目标是让用户不再记忆脚本路径、参数名称、参数顺序和文档位置。

核心能力

• 脚本库：扫描默认目录、手动目录和工作区脚本目录
• 搜索与分类：按名称、说明、路径、标签和分类筛选
• 收藏与最近运行：固定高频脚本，记录状态和退出码
• GUI 参数：文本、数字、开关、下拉、文件、目录和敏感文本控件
• 参数解释：展示必填、默认值、flag、位置参数和帮助说明
• 静态识别：自动发现常见长参数和部分 Python argparse 参数
• 一键执行：应用内直接运行并实时展示标准输出和错误输出
• 命令预览：执行前展示工作目录、解释器和最终参数
• 文档库：自动汇总 Markdown / 文本文档，并与脚本关联
• 参数清单：通过 <脚本名>.script.json 精确定义脚本元数据
• 运行前确认：为删除、发布、生产部署等操作增加二次确认

产品边界

ConfigHub 不再负责 Codex、Claude、OpenClaw 或其他 AI CLI 的：

• API Key / Token
• provider
• base URL
• 模型
• 代理
• 配置模板和备份恢复

这些工具可以作为普通脚本入口存在，但账号和密钥交由各自官方机制管理。

扫描路径

默认目录：

• ~/bin
• ~/.local/bin

工作区子目录：

• Scripts
• scripts
• Tools
• tools

也可以在应用中添加任意手动目录。

参数清单示例

脚本：

deploy.sh

清单：

deploy.script.json

{
  "title": "部署服务",
  "summary": "构建并部署指定服务。",
  "category": "部署",
  "tags": ["SIT", "后端"],
  "documentation": "README.md",
  "requiresConfirmation": true,
  "parameters": [
    {
      "name": "service",
      "label": "服务",
      "flag": "--service",
      "type": "choice",
      "required": true,
      "help": "选择目标服务。",
      "options": ["accounts", "leads"]
    },
    {
      "name": "dry_run",
      "label": "仅预览",
      "flag": "--dry-run",
      "type": "boolean",
      "required": false,
      "defaultValue": "true",
      "help": "不执行实际写入。"
    }
  ]
}

完整字段说明见应用内“使用说明”。

工程结构

• ConfigHub/App：应用状态和入口
• ConfigHub/Domain：脚本、参数、文档和运行记录模型
• ConfigHub/Services：扫描、元数据、文档、执行和持久化
• ConfigHub/Views：概览、脚本库、文档库、来源管理和帮助
• ConfigHubTests：核心扫描、参数解析和命令构建测试

构建

chmod +x Scripts/build_app.sh Scripts/install_app.sh
./Scripts/build_app.sh

或：

xcodebuild \
  -project ConfigHub.xcodeproj \
  -scheme ConfigHub \
  -destination 'platform=macOS' \
  build

测试

xcodebuild \
  -project ConfigHub.xcodeproj \
  -scheme ConfigHub \
  -destination 'platform=macOS' \
  test

2026-06 脚本工作台增强

脚本库现支持按来源筛选和来源名称搜索；来源可在应用内重命名。每个脚本可保存参数方案、恢复上次成功参数，并在详情的“历史”页查看命令、退出状态、输出摘要与恢复历史参数。详见 Docs/FEATURE_UPGRADE_2026-06.md。