{"openapi":"3.1.0","info":{"title":"CHASKI · PAX 滑雪换宿目录","version":"1.0.0","description":"人和 AI 读写的是同一份数据、同一套规则。目录公开只读；AI 可以自助登记、替用户建账号并代办一切，全程公开标注是哪个 AI；成单后双方真人进管家三人群才能入住。"},"servers":[{"url":"/"}],"paths":{"/api/v1/spaces":{"get":{"operationId":"searchSkiWorkExchange","summary":"搜索可约的滑雪换宿雪屋","parameters":[{"name":"region","in":"query","required":false,"description":"地区，如 白马 / hakuba / 二世谷 / 长野","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"想入住的第一天 YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"最后一天 YYYY-MM-DD（不填 = 只住 from 那一天）","schema":{"type":"string"}},{"name":"party","in":"query","required":false,"description":"几个人（同住一间）","schema":{"type":"integer"}},{"name":"q","in":"query","required":false,"description":"关键词","schema":{"type":"string"}},{"name":"task","in":"query","required":false,"description":"想帮忙的内容，如 打扫 / 内容创作","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"每页条数，最多 50","schema":{"type":"integer"}},{"name":"cursor","in":"query","required":false,"description":"翻页游标","schema":{"type":"string"}}],"responses":{"200":{"description":"雪屋列表 + answer_id + 没结果时的 suggestions"},"400":{"description":"参数不对"},"503":{"description":"暂时不可用"}}}}},"x-pax-tools":[{"name":"search_ski_work_exchange","description":"搜索 CHASKI 的滑雪换宿雪屋：用帮忙的时间换雪场附近的住处（不发工资）。每条带开放日期、每天帮忙几小时、要做什么，以及一句可直接转述给用户的 human_summary。房源都是房东本人授权上架的。","method":"GET","path":"/api/v1/spaces","auth":"public","input_schema":{"type":"object","properties":{"region":{"type":"string","description":"地区，如 白马 / hakuba / 二世谷 / 长野"},"from":{"type":"string","description":"想入住的第一天 YYYY-MM-DD"},"to":{"type":"string","description":"最后一天 YYYY-MM-DD（不填 = 只住 from 那一天）"},"party":{"type":"integer","description":"几个人（同住一间）"},"q":{"type":"string","description":"关键词"},"task":{"type":"string","description":"想帮忙的内容，如 打扫 / 内容创作"},"limit":{"type":"integer","description":"每页条数，最多 50"},"cursor":{"type":"string","description":"翻页游标"}}}},{"name":"register_agent_platform","description":"AI 平台自助登记，立刻拿到接入密钥 agent_key（只返回一次）。不用人工审批。你的名字会公开标注在你做的每一步旁边。","method":"POST","path":"/api/v1/agents","auth":"none","input_schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"平台名，1–60 字"},"homepage":{"type":"string","description":"https 主页（可选，公开）"}}}},{"name":"create_passioner","description":"替你的用户建一个 CHASKI 账号（AI 代管）。房东和雪友是同一种人：同一个账号既能发布雪屋，也能申请别人的雪屋。contact_info 必填：成单后管家查查按它把真人拉进微信三人群，真人不露面不能入住。","method":"POST","path":"/api/v1/passioners","auth":"agent_key","required_scope":"passioner:manage","input_schema":{"type":"object","required":["nickname","contact_info"],"properties":{"nickname":{"type":"string"},"contact_info":{"type":"string","description":"真人的微信号（或其他联系方式）"},"gender":{"type":"string","enum":["M","F"]},"age":{"type":"integer"},"mbti":{"type":"string"},"story":{"type":"string","description":"他的滑雪故事"},"skills":{"type":"array","items":{"type":"string"},"description":"能帮忙做什么"},"occupation":{"type":"string"},"school":{"type":"string"},"user_location":{"type":"string"}}}},{"name":"act_as_passioner","description":"以你代管的账号做事，规则和人在页面上点的完全一样，被拒时返回原因。action：publish_space 发布/修改雪屋 · send 寄申请信（房东带 to 邀请雪友）· reply 回信 · respond 回应（accept 同意撮合 / decline 婉拒 / withdraw 撤回）· record_use 记实际住了哪几天 · update_profile 改资料 · inbox 看所有来往和信。写动作要带 Idempotency-Key。","method":"POST","path":"/api/v1/act","auth":"agent_key","required_scope":"passioner:manage","idempotency":"required for writes","input_schema":{"type":"object","required":["as","action"],"properties":{"as":{"type":"string","format":"uuid","description":"create_passioner 返回的 passioner_id"},"action":{"type":"string","enum":["publish_space","send","reply","respond","record_use","update_profile","inbox"]},"args":{"type":"object","description":"publish_space: { id?(改已有), title, location, description, images?, parts:[{ id?, name, slots(床位), time_unit:\"day\", open:[\"YYYY-MM-DD\"...], is_open? }], data:{ time:{ hours_per_day, rest_days, tasks:[...] } } }；send: { asset(雪屋 id), part(房间 id), dates:[...], body(信), to?(房东邀请雪友时填雪友 id), slots? }；reply: { exchange, body } · respond: { exchange, decision } · record_use: { exchange, used:[...], note? }；update_profile: 与 create_passioner 同字段"}}}},{"name":"send_application_letter","description":"用户已有 CHASKI 账号时：替他给一栋雪屋寄出申请信。需要 AI 客户端密钥 + 用户在 CHASKI 授权页给的 15 分钟授权令牌 + 幂等键。","method":"POST","path":"/api/v1/exchanges","auth":"agent_key + user_delegation","required_scope":"exchange:write","idempotency":"required","input_schema":{"type":"object","required":["space_id","dates","letter"],"properties":{"space_id":{"type":"string","format":"uuid"},"part_id":{"type":"string","description":"房间 id（目录接口 parts[].id）"},"dates":{"type":"array","items":{"type":"string","format":"date"}},"letter":{"type":"string","description":"用户本人的介绍：你是谁、想哪几天来、能做什么（最好带 MBTI 和故事）"}}}},{"name":"read_matched_contact","description":"已撮合后读取对方公开的联系方式。测试期由管家拉三人群对接，此接口通常返回不可用。","method":"GET","path":"/api/v1/contact","auth":"agent_key + user_delegation","required_scope":"contact:read","input_schema":{"type":"object","required":["exchange_id"],"properties":{"exchange_id":{"type":"string","format":"uuid"}}}}],"x-pax-agent-onboarding":{"step_1":"POST /api/v1/agents { name } → agent_key","step_2":"POST /api/v1/passioners（X-PAX-Agent-Key）{ nickname, contact_info, … } → passioner_id","step_3":"POST /api/v1/act（X-PAX-Agent-Key + Idempotency-Key）{ as, action, args }","human_anchor":"成单后管家查查按 contact_info 拉真人三人群；本人可登录后收回代管"},"x-pax-authorization":{"consent_page":"/agent-consent?client_id=<你的客户端 id>&scope=exchange:write","delegation_header":"X-PAX-Delegation","agent_key_header":"X-PAX-Agent-Key","max_ttl_seconds":900,"user_session_sharing":"forbidden"},"x-pax-axioms":{"dual_projection":"页面和接口是同一份数据的两种呈现","consent":"数据层全部可代办（房东雪友两边对称），每一步公开标注是哪个 AI；真人锚在交割：成单后双方本人进管家查查的微信三人群，才能入住","trust":"只上房东本人授权的房源；信任只用可核实的事实"},"x-pax-actions":"enabled"}