catalog/repos/1asdwz--ai-dating.md

3.5 KiB
Raw Permalink Blame History

AI 交友配对工作流

交友 配对 API curl 隐私

ai-dating

ai-dating 是一个用于交友和配对工作流的 Codex 技能包。 它使用 curl 直接调用 HTTP API而非依赖 dating-cli

变更说明

本版本围绕交友后端 API 构建:

  • 通过 /register/login 进行身份认证
  • 通过 PUT /member-profile 更新个人资料
  • 通过 POST /minio/upload 上传照片
  • 通过 /match-tasks 创建或更新匹配任务
  • 通过 GET /match-tasks/{taskId}/check 查看候选人
  • 通过 /match-results/{matchId}/reveal-contact 获取联系方式
  • 通过 /match-results/{matchId}/reviews 提交评价

本技能包不再依赖本地 CLI 安装或本地 CLI 配置文件。

外部后端与隐私审查

本技能包会将用户数据发送至外部交友后端。

  • 默认基础 URLhttps://api.aidating.top,可通过 AIDATING_BASE_URL 覆盖
  • 所需工具:curl,建议同时安装 jq
  • 所需能力:出站网络访问

在安装或使用本技能包之前,请审查接口所有者、隐私政策、数据保留政策及内部审批要求。 如果相关政策禁止向第三方服务发送照片、个人特征或联系方式,请勿使用。

请遵循数据最小化原则:

  • 仅发送当前操作所需的字段
  • 未经用户明确同意,不得上传照片
  • 未经用户明确选择和同意,不得获取联系方式
  • 避免发送高度敏感的标识符或无关的私密信息

文件说明

  • SKILL.md:面向智能体的工作流程与使用规范
  • references/curl-api-operations.md:已验证的请求格式与 curl 示例
  • LICENSE:技能包授权协议

适用场景

当用户希望进行以下操作时,可使用本技能包:

  • 结交新朋友
  • 寻找伴侣
  • 执行配对流程
  • 更新交友资料
  • 上传个人照片
  • 创建或更新匹配条件
  • 浏览候选人
  • 获取联系方式
  • 沟通后提交评价

快速开始

适用于 bashshzsh、Git Bash 或 WSL

BASE_URL="${AIDATING_BASE_URL%/}"
if [ -z "$BASE_URL" ]; then
  BASE_URL="https://api.aidating.top"
fi

典型工作流程:

  1. 注册或登录。
  2. 从响应中保存 tokentokenHeadtaskIdmatchId
  3. 更新个人资料并上传照片。
  4. 创建或更新匹配任务。
  5. 轮询 /match-tasks/{taskId}/check?page=1
  6. 选择最合适的候选人。
  7. 仅在用户选定候选人后才获取联系方式。
  8. 如有需要,在沟通后提交评价。

注意事项

  • 当前公开的轮询接口为 GET /match-tasks/{taskId}/check
  • 部分写入接口仅返回成功信封,其中 data = null
  • 没有公开的任务列表接口,因此必须自行保存已创建的 taskId
  • preferredContactChannel 字段已被 DTO 接受,但目前尚未被匹配逻辑使用。
  • 在首次发出写入请求前(如尚未明确告知),技能包应向用户说明数据将发送至哪个外部基础 URL。

验证与打包

本仓库在 .codex/skills/skill-creator/scripts 下提供了辅助脚本。

使用 Python 3 进行验证:

python .codex/skills/skill-creator/scripts/quick_validate.py .codex/skills/ai-dating

使用 Python 3 进行打包:

python .codex/skills/skill-creator/scripts/package_skill.py .codex/skills/ai-dating dist

打包产物输出路径:

dist/ai-dating.skill

参考资料

如需了解接口详情及请求示例,请阅读:

  • SKILL.md
  • references/curl-api-operations.md