---
name: handout-account-support
description: 把房主或物业经理（PO/PM）的公司/联系方式变更或问题描述转换为经确认的 Handout 个人资料修改或支持请求，查询公开回复但不访问管理员备注或修改认证和角色。不服务 Tenant/SP 自助角色。
metadata:
  version: 1.1.1
---

# Handout 个人资料与支持

## 检查 Skill 更新

每次启用时读取 `https://handout.us/oauth/agent-setup`，将本包的 `metadata.version` 与 `skill_release.versions` 中同名版本比较。发现新版时，用用户的对话语言提示更新，提供更新已安装 Skill 及同语言完整声明文件的操作。保留现有成功连接、凭据和权限，继续当前业务任务，无需等待更新。MCP 返回的 `handout_notice` 也触发相同检查，同一对话、同一版本避免重复提醒。只有宿主确认后才报告安装完成；版本查询失败时继续工作，不把版本未知说成已过期或已是最新。

仅供 PO/PM，暂不开放 Tenant/SP Skill。使用当前用户本人权限，凭据留在宿主安全设置。未连接参考[连接指引](https://handout.us/skills/handout-connect/zh-CN/SKILL.md)。先 me.get，再读 account/support 的 app_schema.get。只读连接可以查，不能准备写入；不能自动升级。

## 把叙述变成正确操作

“公司改成 Oak Management”是当前用户公司资料修改，不是房产归属或他人账户修改。先 account.get，优先 canonical company_name；姓名/电话/地址使用 user_name/phone/address，并展示服务返回的别名同步。

“上传总失败”先是问题描述，不是完整 Support 表。Agent 根据事实整理 subject/description/category 和可确定的关联记录，只追问阻塞复现的信息，不要求用户找系统日志、不编造根因。仅请求排错并不授权发送工单。

“客服回复了吗”应查询本人已有工单，不再新建。先查重复；未开放任意修改旧工单或 Agent 代表管理员回复的操作。

## Profile

1. account.get 读取本人联系/公司信息。
2. prepare_update 的 data 只含实时 allowlist 中的明确变更，不能把查询到的所有字段回传；姓名/电话/地址/公司别名变化都列入前后预览。
3. 用户明确批准后，只传 action:confirm_update、preview_id、user_confirmed:true。内容或版本改变重新准备。
4. 不修改登录邮箱、角色、ownership、Key、额度、账单或方案。公司名用于报告不证明拥有他人房产。保持人名、电话和地址准确。

## Support

- list/get(ticket_id) 只读本人工单与公开回复，没有内部 admin notes。
- 从用户描述准备 data:{subject,description,category?,priority?,attachments?,related_entity_type?,related_entity_id?}。包含必要复现步骤、预期/实际结果及安全错误或支持编号。
- 新增非英文说明先沿用已确认语言偏好，否则问是否译成英文；由用户 Agent 翻译，展示实际将保存的文字。
- 显示完整消息、关联目标、类别/优先级、附件后，明确批准，再 confirm_create，只传 action/preview_id/user_confirmed:true。
- 成功仅表示写入已有 Admin Inbox，不是问题已解决、获得 Credit 或管理员已回复。超时先查结果，不重复提交。
- 不发送密码、API Key、访问/刷新令牌、授权码、带凭据 URL 或完整敏感日志；使用脱敏证据。
- 附件使用有权限的真实文件 URL、name 和可选 content_type，不用本地路径或伪造链接。目前 Storage 需可访问房产；没有房产可提交文字，不为截图造假房产或声称存在个人上传接口。

用户 Agent 不能代表管理员回复或改内部分类处理字段。没有接口应如实说明需 App/服务支持。

连接失败使用连接指引的有限重试，失败尝试不能删除成功连接；创建/撤销新凭据仍需用户批准。安装 Skill 不等于连接成功。