QSH 是通过 macOS 终端玩测验的交互式 shell。

它基于 SwiftQuiz 构建，SwiftQuiz 提供了在 Swift 中制作和玩测验的核心功能。QSH 提供了使用 macOS 终端访问所有这些功能的 UI。

在达到 1.0.0 版本之前，此软件包被认为是正在进行中的工作。

目录

• 快速入门
• 功能特性
  • 支持的功能特性
  • 即将推出的功能特性
• 安装
  • Homebrew
  • Mint
  • Swift Package Manager
• 用法
  • 打包测验
    • 加密/未加密的测验包
    • 图片轮次
  • 玩测验
  • 帮助
• 开发测验客户端
• 作者
• 附加软件
  • 框架
  • 工具

qsh --url https://github.com/rwbutler/QSH/raw/master/examples/example-playable-quiz.quiz --key A%D*F-JaNdRgUkXp2s5v8y/B?E(H+KbP

或

qsh --url https://github.com/rwbutler/QSH/raw/master/examples/example-playable-quiz2.quiz --key A%D*F-JaNdRgUkXp2s5v8y/B?E(H+KbP

注意：接受 HTTP 和文件 URL，文件 URL 必须以 file:// 开头，例如 qsh --url file:///Users/username/Documents/example-playable-quiz.quiz。

 qsh package-quiz --input "https://raw.githubusercontent.com/rwbutler/QSH/master/examples/example-quiz-input.json" --encrypt-package --key "A%D*F-JaNdRgUkXp2s5v8y/B?E(H+KbP" --output "file://<output path>"

注意：接受 HTTP 和文件 URL，文件 URL 必须以 file:// 开头，例如 qsh package-quiz --url file:///Users/username/Documents/quiz-input.json。

• 打包测验以进行分发
• 简答题、多选题和单选题
• 图片轮次
• 加密测验包，使其更难作弊。
• 通过 Web Hook URL 发送答案到 Slack 进行人工评分
• 自动评分

• 保持参与者同步，无需服务器

要通过 Homebrew 安装，请从终端运行以下命令

brew install rwbutler/tools/qsh

要使用 Mint 安装，请运行以下命令

mint install rwbutler/qsh 

使用 Swift Package Manager 构建，如下所示

swift build -c release --disable-sandbox 

然后使用以下命令运行

swift run qsh --help 

qsh package-quiz --input file://<path to quiz JSON> --encrypt-package --key <encryption key> --output file://<path to quiz package>

注意：要生成 AES-256 加密密钥，请使用类似 这样的网站。

QSH 允许加密测验，以便测验包中包含的答案不易被访问，从而防止作弊。 此功能是可选的，因为测验包可以是加密的或未加密的。 为了在打包期间加密测验，请使用 --key 参数提供使用类似 此处 的网站生成的 AES-256 密钥。 如果省略 --key 参数，则将生成未加密的测验包。

要将图片轮次包含在测验中，请在简答题、多选题或单选题中包含参数 image。 image 参数的值应该是图像文件的 URL（文件 URL 或 HTTP URL）。 打包测验时，图像数据将包含在测验包中，以便图像无需在运行时单独下载。

为了启用测验的自动评分，请将以下内容添加到您的测验 JSON 文件中

"marking-occurs": "at-end",

请点击此处查看示例。

或者，如果您想以传统方式通过交换答案进行评分，只需将 marking-occurs 属性设置为 never

"marking-occurs": "never",

qsh play-quiz --url <quiz package URL> --key <encryption key>  

注意：key 参数仅在加密包中是必需的。

qsh --help

或获取关于特定子命令的帮助

qsh package-quiz --help

qsh play-quiz --help

打包和玩测验的核心功能由 Swift Quiz 包实现，QSH 为 macOS 终端提供 UI。 如果您希望构建自己的客户端来玩测验，例如使用 Linux，理论上您可以使用 Swift Quiz 来做到这一点。

Ross Butler

• AnimatedGradientView - 为 iOS 简化强大的渐变动画。

AnimatedGradientView

• Cheats - 现代 iOS 应用程序的复古作弊码。
• Connectivity - 改进了 Reachability，用于确定您的 iOS 应用程序中的互联网连接。
• FeatureFlags - 允许开发人员配置功能标志，使用捆绑/远程托管的 JSON 配置文件运行多个 A/B 或 MVT 测试。
• FlexibleRowHeightGridLayout - 一个 UICollectionView 网格布局，旨在通过允许每行的高度调整以适应内容来支持动态类型。
• Hyperconnectivity - 用 Swift 编写的 Apple Reachability 的现代替代品，并使用 Combine 使其优雅。 Connectivity 框架的一个分支。
• Skylark - 完全 Swift BDD 测试框架，用于使用 Gherkin 语法编写 Cucumber 场景。
• TailorSwift - 有用的 Swift Core Library/Foundation 框架扩展的集合。
• TypographyKit - 在 iOS 上使用动态类型支持实现一致且可访问的视觉样式。
• Updates - 自动检测应用程序更新并温和地提示用户更新。

Cheats	Connectivity	FeatureFlags	Hyperconnectivity	Skylark	TypographyKit	Updates

• Clear DerivedData - 通过从终端键入 cdd 即可快速清除 DerivedData 目录的实用工具。
• Config Validator - Config Validator 验证并上传您的配置文件，并在您的 CI 过程中清除您的 CDN 缓存。
• IPA Uploader - 将您的应用程序上传到 TestFlight 和 App Store。
• Palette - 使您的 TypographyKit 调色板在 Xcode Interface Builder 中可用。

Config Validator	IPA Uploader	Palette