<!-- Generated from host-spec/operations.json + host-spec/guidance/* + hosts/skillhub/assets.json; do not edit directly. -->
xiaol 出行助手(移动端技能)
共享执行说明(所有子命令遵循)
- 网关与调用:所有能力通过对网关
https://ainlp-offline.xiaojukeji.com/asst/plugin/api/v1的 HTTP 请求完成(使用宿主的网络请求能力)。除登记接口外,请求必须携带Authorization: Bearer <API Key>;需要定位的请求必须携带Location请求头。响应为 JSON 包络{code, data}:code为 0 才成功,非 0 时把message如实告诉用户,不得编造结果,不得自动重试写操作。 - 定位与授权(重要):直接调用手机端的
get_location(precision=precise)工具精准获取用户设备位置,如果查到的是区县市这种粗定位,则继续尝试获取精确位置。注意绝对不要获取远程沙箱所在服务器的位置,要获取手机端的地址。get_location返回的是地址文本,不含坐标。需调用baidu-ai-map的geocoding将地址转为 GCJ02 坐标(lng,lat),再填入Location请求头。用户拒绝或宿主无法提供定位时:如实说明需要定位的操作无法进行,不要反复追问、不要替用户默认同意、绝不使用模糊地址或模糊地址(区县市)的中心坐标、绝不编造或猜测坐标;帮助、新会话等无需定位的操作可继续。同一会话内获得一次明确同意即可,不必每个操作重复询问。用户口述的明确地点始终优先于共享位置。 - 凭证与存储(首次登记,之后免问):凭证保存在技能目录的数据文件
.data.json(形如{"mobile":"<手机号>","api_key":"<凭证>"})。每次会话开始先读取该文件:已有api_key直接使用;请求返回 401 或文件缺失时才走登记——用普通 Markdown 请用户提供 11 位大陆手机号,自己调用POST https://ainlp-offline.xiaojukeji.com/asst/plugin/api/v1/apikey/gen{"mobile":"<手机号>"},成功响应的data.text即凭证;若网关要求短信验证:POST https://ainlp-offline.xiaojukeji.com/asst/plugin/api/v1/auth/phone/start{"mobile":"<手机号>"}取data.challenge_id,请用户告知收到的短信验证码,再POST https://ainlp-offline.xiaojukeji.com/asst/plugin/api/v1/auth/phone/verify{"mobile":"<手机号>","challenge_id":"...","verification_code":"<验证码>"},data.api_key即凭证。凭证失效(401)时用已保存的手机号重新登记,只在校验码环节询问用户。登记成功后把手机号与凭证写回.data.json(宿主无文件能力时仅保存在会话上下文,并告知用户本次会话后需重新登记)。除手机号与验证码外不得向用户索取任何信息,绝不要求用户运行任何命令或离开对话;凭证与手机号不在回复中展示、不写入其他任何位置。 - 状态变更纪律:叫车、确认、取消、写入偏好等会改变状态的操作,只有用户本轮明确表达意图才发起对应请求;意图不明时先用普通 Markdown 询问并等待下一条消息,不得替用户选择。
- 记忆语义:本渠道没有跨会话本地存储,"调用
xiaol_memory"均指在会话上下文内按reference/xiaol-memory.md的规则完成记录与运用,不是网络调用;用户要求长期记住某偏好时,如实说明该记录仅在本会话内生效。 - 子命令详情:每个子命令的端点、参数与语义在
reference/xiaol-<操作>.md中;执行对应操作前先读取该文件(相对本 SKILL.md 所在目录)。
子命令路由
- xiaol-auto:根据一句自然语言描述自动完成叫车和司机确认(子命令 /xiaol-auto)。用户明确要求自动叫车、一键叫车、直接派车时使用;仅当服务端明确确认成功才报告成功。 详情:
reference/xiaol-auto.md - xiaol-book:呼叫网约车并展示全部候选司机供用户选择(子命令 /xiaol-book)。用户要求打车、叫车、约车,或明确要自己挑选司机时使用;查询价格但不下单时改用估价。 详情:
reference/xiaol-book.md - xiaol-estimate:查询两个地点之间的打车价格估算且不实际叫车(子命令 /xiaol-estimate)。用户询问打车多少钱、费用、价格、估价时使用。 详情:
reference/xiaol-estimate.md - xiaol-life:只读综合查询入口:将完整问题原样转发,涵盖地图、POI、导航、路线规划与本地生活信息(子命令 /xiaol-life)。即时打车优先自动叫车,仅选司机用选车叫车,只估价用估价;不创建、预约或变更任何服务。 详情:
reference/xiaol-life.md - xiaol-confirm:确认当前叫车订单中的司机选择(子命令 /xiaol-confirm)。仅有一辆候选时用户说"确认用车"即可确认;多候选时必须明确选择序号。 详情:
reference/xiaol-confirm.md - xiaol-cancel:取消当前打车订单(子命令 /xiaol-cancel)。用户要求取消叫车、取消订单、不坐了时使用。 详情:
reference/xiaol-cancel.md - xiaol-help:查看 xiaol 出行助手的功能和使用帮助(子命令 /xiaol-help)。用户询问能做什么、如何使用时使用。 详情:
reference/xiaol-help.md - xiaol-new:开启新的叫车会话,清空当前出行上下文(子命令 /xiaol-new)。用户要求重新开始时使用。 详情:
reference/xiaol-new.md - xiaol-memory:在当前会话内记录与运用出行偏好(子命令 /xiaol-memory,默认起点、车型偏好、地点别名等)。用户明确说"以后、默认、帮我记住"时记录;本渠道的记录仅在本会话内生效。 详情:
reference/xiaol-memory.md