当前状态
MaaPiCli 当前实现至 PI v2.5.0。当前锁定的 MaaFramework v5.12.3 文档定义到 PI v2.9.0,上游 main 已定义到 PI v2.10.0。
分支 codex/import-support(46189ebf)已补齐 import 导入 group、pretask、global_option 与 setting 的解析合并;其中 pretask 与 setting 仅表示解析/合并,仍不会执行或渲染。
由于 interface_version 仍为 2,包含新字段的配置通常可以解析并加载既有功能,但 v2.6.0 之后新增的协议能力不会被 MaaPiCli 启用。
尚未支持 / 未完整支持的协议能力
| PI 版本 |
能力 |
当前状态与影响 |
| v2.3.0 |
focus.display |
部分支持。MaaPiCli 未注册和处理 focus 回调,因此 focus.display 声明目前无效 |
| v2.6.0 |
resource.hash |
未实现。当前忽略 hash,不做资源完整性校验 |
| v2.7.0 |
pretask |
未实现。Controller 启动前不会执行自定义程序,也不会传递 option 当前值 |
| v2.7.0 |
import 导入 pretask |
解析/合并已支持(codex/import-support)。Controller 启动前仍不会执行导入的 pretask |
| v2.8.0 |
setting |
未实现。不会渲染任务设置页 UI 声明 |
| v2.8.0 |
hotkey option |
未实现。终端环境下需要先定义降级交互或明确不支持 |
| v2.8.0 |
import 导入 global_option |
已支持(codex/import-support)。导入片段中的 global_option 会去重后合并到主文件 |
| v2.8.0 |
import 导入 setting |
解析/合并已支持(codex/import-support)。仍不会渲染任务设置页 UI 声明 |
| v2.8.1 |
pretask.controller/resource 适用范围过滤 |
未实现执行;字段已可在 codex/import-support 中解析 |
| v2.9.0 |
telemetry.sentry |
未实现。不读取配置,也不上报遥测 |
| v2.9.1 |
focus 模板对象的 trace 字段 |
未实现。当前也没有 focus 回调处理 |
| v2.9.2 |
telemetry.sentry.failure_attachments_sample_rate |
未实现 |
| v2.10.0 |
input.inputs[].password |
未实现。仍按普通输入处理,明文展示、明文保存,日志与遥测也未定义脱敏行为 |
讨论
telemetry
我倾向 MaaPiCli 保持最小实现,不集成 Sentry telemetry:继续容忍并忽略相关字段,在文档中明确 CLI 不上报遥测数据。
focus
我倾向 CLI 只注册 focus 回调并把消息降级为终端输出,不实现 toast / notification / dialog / modal 等图形化渠道。
当前状态
MaaPiCli 当前实现至 PI v2.5.0。当前锁定的 MaaFramework
v5.12.3文档定义到 PI v2.9.0,上游 main 已定义到 PI v2.10.0。分支
codex/import-support(46189ebf)已补齐import导入group、pretask、global_option与setting的解析合并;其中pretask与setting仅表示解析/合并,仍不会执行或渲染。由于
interface_version仍为2,包含新字段的配置通常可以解析并加载既有功能,但 v2.6.0 之后新增的协议能力不会被 MaaPiCli 启用。尚未支持 / 未完整支持的协议能力
focus.displayfocus.display声明目前无效resource.hashhash,不做资源完整性校验pretaskimport导入pretaskcodex/import-support)。Controller 启动前仍不会执行导入的pretasksettinghotkeyoptionimport导入global_optioncodex/import-support)。导入片段中的global_option会去重后合并到主文件import导入settingcodex/import-support)。仍不会渲染任务设置页 UI 声明pretask.controller/resource适用范围过滤codex/import-support中解析telemetry.sentryfocus模板对象的trace字段telemetry.sentry.failure_attachments_sample_rateinput.inputs[].password讨论
telemetry
我倾向 MaaPiCli 保持最小实现,不集成 Sentry telemetry:继续容忍并忽略相关字段,在文档中明确 CLI 不上报遥测数据。
focus
我倾向 CLI 只注册 focus 回调并把消息降级为终端输出,不实现
toast/notification/dialog/modal等图形化渠道。