Skip to content

P1:screen-time screen-understanding 设置与 API 契约 #23

Description

@CubePlus1

背景

为 screen-time 插件增加可运行时读取/更新、带版本控制的 screen-understanding 设置,为后续截图理解能力提供明确的配置边界。

本 Issue 范围

  • 增加持久化的单例 settings 记录和幂等迁移。
  • 提供 canonical GET/PUT /api/plugins/screen-time/understanding/settings
  • PUT 使用完整对象 payload、字段范围校验和 expectedVersion 乐观并发控制。
  • 保持 screen-time 插件隔离;设置本身不触发截图或模型调用。

非目标

本 Issue/PR 不实现截图采集、图片存储、模型调用、队列/重试 worker 或任何后续理解子任务。

交付与追踪

验收标准

  • 迁移可重复执行,默认设置可读取,更新后服务重载仍保留版本和值。
  • GET 返回完整 settings 对象;PUT 要求完整字段,拒绝未知字段和越界值。
  • expectedVersion 匹配时原子递增版本并返回新对象;不匹配返回 409 及 currentVersion
  • API 文档记录请求、响应、字段范围、400 和 409 契约。
  • 单元、类型、构建及适用集成验证通过。
  • 截图、模型调用及后续理解子任务仍未实现。

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

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions