Skip to content

[RFC] PI v2.6+ 后续支持计划与优先级 #1

Description

@Craun718

当前状态

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 等图形化渠道。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions