系统 · 命令参考
qzx terminal
作用
启动用于 QZX 命令的交互式终端。
命令成熟度：Alpha
可用于真实使用和反馈，但其接口与行为仍可能继续演进。 这是当前开发 checkout 的评估。未来每个不可变发布标签都会保留该版本中包含的准确评估。 可在 PyPI 0.2.2.0.9 使用。文档对应 alpha checkout 0.2.2.0.9。
行为与内置保护
实际模式会应用你请求的更改
此操作直接执行
无需调用原生程序即可运行
无需网络即可运行
设计为无需提权即可运行
以交互方式执行 QZX 命令。除非明确选择历史文件，否则持久历史保持禁用。
此安全分类由 OpenAI GPT-5.6 Pro 于 2026-08-25 对照实现摘要 sha256:4fa27596d738d0ee2e0dd1d1d4d7e3ceb1f01830abcc6df65fb7d04fc2bb67da 审阅。
准确语法
qzx terminal [prompt] [history_file] [show_path] --json参数
滑动或使用横向滚动条查看所有列。
| 名称 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| prompt | str | 否 | "QZX> " | 终端自定义提示符（默认："QZX> "） |
| history_file | str | 否 | 未声明 | 可选的持久历史文件路径（默认禁用） |
| show_path | bool | 否 | true | 在提示符中显示路径（默认：true） |
输入示例
qzx terminal使用默认配置启动 QZX 交互式终端
qzx terminal "Agent> "使用代理提示符启动 QZX 交互式终端
qzx terminal "MyQZX> "使用自定义提示符启动 QZX 终端
qzx terminal "QZX> " --history_file ~/.qzx_history --show_path false启用持久历史并隐藏路径
要获得完整结构化载荷，请添加 --json： qzx terminal [prompt] [history_file] [show_path] --json
代表性输出示例
此示意 JSON 源自当前实现所支持的结果契约。它展示命令可能返回的内容，并不声称这是录制的实际执行；具体值会随输入、设备、权限和可选工具而变化。
示例命令： qzx terminal --json
{
"success": true,
"message": "Launches an interactive terminal/shell for QZX commands. In this illustrative example, the command completed successfully.",
"meta": {
"command": "terminal",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"details": {
"prompt": "Example value",
"history_enabled": true,
"history_file": "C:\\project\\example.txt",
"show_path": "C:\\project\\example.txt"
}
}查看 JSON 结果契约
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"details": {
"oneOf": [
{
"type": "object",
"properties": {
"prompt": [],
"history_enabled": {
"type": "boolean"
},
"history_file": [],
"show_path": []
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"history_enabled": {
"type": "boolean"
},
"show_path": []
},
"additionalProperties": true
}
]
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"additionalProperties": true
}错误与限制
公开契约要求失败时返回 success=false 和具有描述性的 message。此目录尚未为每个命令声明专门的错误分类；请检查结果，不要推断不存在的错误码。
QZX 仍处于 alpha 阶段。可选依赖、权限和主机能力可能影响结果。
证据流程：需要隔离的可丢弃目标。
证据与来源
- 文档渠道
- 开发文档 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- 可用性
- 0.2.2.0.9 或更早
继续探索
相关命令
这些命令同样属于 系统 类别。对比它们，选择最适合解决任务的操作。