用途
本技能用于 CometChat 的数据治理与合规工作，适用于隐私/安全/合规审查、数据主体请求（删除或导出）、选择数据存放区域，以及规划消息保留与审计。所有操作都在服务端完成，无需编写客户端代码。
主要能力
1. 数据驻留（Data residency）
CometChat 将每个应用托管在单一区域：us、eu 或 in（见 {DOCS_BASE}/rest-api/chat-apis → Data Center Hosting；引用给客户前应重新获取，区域可能新增）。区域与应用绑定，并体现在每个 API/SDK 端点中（https://{APP_ID}.api-{REGION}.cometchat.io/v3，以及 SDK 初始化区域）。若要让欧盟数据留在欧盟（GDPR）或满足驻留条款，应在创建应用时选择该区域——应用区域事后无法静默迁移；迁移区域意味着新建应用加数据迁移（cometchat-migrate-from-* 机制 / CometChat 支持）。若需完全数据主权（自有基础设施），参见 cometchat-self-host。
2. 删除权（GDPR 第 17 条 / CCPA 删除）
调用 REST 删除用户端点（DELETE https://{APP_ID}.api-{REGION}.cometchat.io/v3/users/{uid}；文档见 {DOCS_BASE}/rest-api/users），使用 REST API Key：
- 默认（无请求体）→ 停用用户（可恢复；保留数据）。
- { "permanent": true } → 永久删除用户及其所有消息、会话和相关数据。不可逆。
DELETE https://{APP_ID}.api-{REGION}.cometchat.io/v3/users/{uid}
apikey: {REST_API_KEY}
content-type: application/json
{ "permanent": true }
将此接入你的账户删除流程，使“删除我的账户”请求同时在 CometChat 中清除该用户。同时清除其认证令牌（cometchat-security），避免会话残留。
3. 访问权 / 可携带权（数据导出）
为响应数据主体的访问请求，通过 REST 在服务端导出用户数据，并以可携带格式交付：
- 其消息——Messages REST 集合（{DOCS_BASE}/rest-api/messages，按用户过滤）；
- 其会话——{DOCS_BASE}/rest-api/conversations；
- 其资料——Users API。
在服务端任务中使用 REST API Key 运行；切勿将这些暴露给客户端。编写导出器前，先从文档获取确切的过滤参数。
4. 保留与清理
CometChat 会保留消息直到被删除。需了解的行为（/articles/properties-and-constraints）：软删除的消息会被保留；通过 API 永久删除的消息不会。要执行保留窗口：
- 运行计划服务端任务，通过 REST API（delete-message / delete-conversation / 用户永久删除）删除超过策略期限的消息/会话；
- 托管/自动保留策略（N 天后自动清理）属于仪表盘/套餐能力——应向 CometChat 确认可用性并配置，而非假设存在 API。不要虚构保留端点。
- 本地部署（on-prem）让你完全控制存储生命周期与备份（cometchat-self-host）。
5. 审计与 eDiscovery
- 审核审计轨迹：仪表盘的 Moderation → Reviewed Messages 记录审核员活动与决定，用于合规（{DOCS_BASE}/moderation/reviewed-messages）；可配合 cometchat-moderation。
- eDiscovery / 法律保留：通过上述 REST 集合（按用户、群组或时间范围）导出相关会话与消息——这是生成聊天记录的支持方式；不存在单独的“eDiscovery API”。若需法律保留，应在任何保留清理运行前导出。
- Webhooks（{DOCS_BASE}/rest-api/management-apis/webhooks/overview）可将消息/用户事件实时流式传输到你自己的不可变审计存储，以便在 CometChat 之外保留防篡改日志。
6. 认证与协议（业务，非代码）
SOC 2、ISO 27001、HIPAA（含 BAA）、GDPR/CCPA 态势及渗透测试报告通过 CometChat 的信任/合规流程处理，而非 API。应引导审查者查看当前信任页面并以书面形式获取协议；传输加密（TLS）是标准配置，静态/端到端加密选项及密钥管理因套餐/部署而异——需针对客户套餐确认具体细节。
使用方式
本技能为服务端操作指南，涉及 REST 调用、仪表盘设置与业务确认。REST 接口形态以实时文档为准（DOCS_BASE = https://www.cometchat.com/docs，追加 .md）。当某项控制属于仪表盘设置或销售/套餐项（如托管保留策略、签署的 BAA、认证）时，技能会明确说明，而非虚构 API。认证状态（SOC 2、ISO 27001、HIPAA）是业务事实——应在 {DOCS_BASE} 的信任页面确认当前范围，不要据此断言。
适用场景
- 隐私/安全/合规审查；
- 数据主体请求（删除/导出）；
- 选择数据存放区域；
- 规划保留与审计。
限制与常见陷阱
- 区域被意外选择——默认是 us；欧盟客户需从第一天起在 eu 创建应用。
- 仅停用的“删除”——省略 permanent: true 会保留数据；删除请求需要该标志。
- 删除用户但留下活跃会话——还需清除认证令牌（cometchat-security）。
- 假设存在自动保留策略——通过 REST/本地部署实现清理，或确认托管设置；不要虚构。
- 凭记忆断言认证——与 CometChat 核实当前 SOC 2 / HIPAA / ISO 范围。
验证方式
测试用户被永久删除后返回成功，且其消息/会话消失 · 访问请求导出生成用户资料 + 消息 + 会话 · 应用区域符合客户驻留要求 · 保留任务（或已确认的托管策略）移除超过窗口的数据 · 审核决定出现在 Reviewed Messages · Webhooks（若使用）将审计事件落入你的存储。