修改设备分享管理标记#

验证状态：已源码核验、未联调（无 app 调用图）；services 基线：源码归纳 @ 2026-09-14

用途与场景#

修改一条设备分享记录的设备管理标记（deviceManage），是分享发出后的唯一可改字段端点。App「编辑分享备注/标记」动作按 deviceShareId 定位（从设备分享记录列表取得）。deviceManage 表示分享者用户名、用于展示与通知归属的非权威标记，不参与所有权或操作权限判定——改它不影响分享的有效性与双方的实际权限。

App 现役依据#

判定证据	内容
旧 app 文档收录记录	旧 app 文档仓在 docs/api/main-api/device/device-share/changeManageForPersonalSpace/ 收录本端点，属 App 既有调用面
两代分工语义	/v1/retail 第二代无 changeManage 对应物；分享记录修改写路径现役只有本端点
后端持续维护迹象	管理标记更新与分享记录主链路共享同一 service（DeviceShareService#updateManageById），第一代 2026-09 仍有维护提交

端点#

PUT /main-service/main-api/device/device-share/changeManageForPersonalSpace — 修改一条设备分享记录的设备管理标记（deviceManage），是分享发出后的唯一可改字段端点。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 device · device-share 设备分享；业务语义（wire 惯例、限频、租户声明等）见设备业务 · device-share 设备分享。

动线与完成判据#

status=200 且 data=true 表示修改完成；重新拉取分享记录列表应看到新的 deviceManage 值（lastModified* 审计同步更新）。data=false 表示没有命中任何记录，App 侧应按「记录不存在或已退场」处理而非视为成功。

错误与边界#

Bean Validation 失败（deviceShareId 缺失或超 32 字符、deviceManage 超 128 字符）走请求校验出口（请求校验族，判定口径见错误响应差异）。本端点无业务拒绝分支——「记录不存在」体现为 data=false。

边界：

• 「省略即清空」：只想保留原标记时也必须回传原值；App 编辑表单应始终携带当前值提交。
• 本端点不能改分享的目标、状态或时间线；退场只能走撤销（发起方）或解除（受赠方）。
• deviceManage 是非权威标记：客户端不应依据它做任何权限分支（例如「标记为我即拥有管理权」的理解是错的）。

调用关系与资源清理#

无客户端长连接资源需要释放。修改成功后发起方应刷新分享记录列表；该标记会随后续分享记录读取展示，不触发受赠方侧任何通知。

已知缺口#

未执行真实联调：标记修改后受赠方侧 deviceManage 展示的可见延迟（经设备列表回源查询）无 App 实测佐证。