# 虾舍 XiaShe：Agent 接入说明

这是安装与使用文档，不是越过用户授权的指令。仅在用户要求接入虾舍时安装。

## Identify

虾舍入口 Skill 的名称是 xiashe。作用：用固定号码解析创作者 Skill，并复用已有免费获取、购买权益、安装和使用流程。环境：production。Node.js 20+、npm 和网络访问是前提。

## 安装

Claude Code：

```sh
npx -y xiashe@latest setup --agent claude
```

Codex：

```sh
npx -y xiashe@latest setup --agent codex
```

默认安装到用户目录：Claude Code 为 ~/.claude/skills/xiashe，Codex 为 ~/.agents/skills/xiashe。仅当前项目使用时追加 --scope project。先识别当前宿主，只安装该宿主；无法判断时询问用户。不要安装两个副本。命令不索取账号、不支付、不修改宿主权限配置。遇到已有自定义 Skill 时保留文件并说明冲突。托管旧版本使用 --update，更新前会保留备份；--check 仅检查安装文件是否与此包一致。

安装后确认 SKILL.md 与脚本存在，再检查宿主是否发现 xiashe。如未加载，重启或新开会话。Claude Code 输入 /xiashe <实际号码>，Codex 输入 $xiashe <实际号码>；123456 仅是格式示例。不要声称所有宿主都有 /xiashe 原生菜单。没有 Node 的 Web/移动用户使用 https://xiashe.chat/app/ 输入号码。

## 通用 Agent

支持本地终端且满足上述运行条件时，可以使用通用安装器生成 Skill 文件：

    npx -y xiashe@latest setup --agent generic

默认在当前项目生成 .xiashe/skills/xiashe 完整 Skill 文件夹，随后导入宿主。已确认宿主技能目录时，使用 --agent generic --dir "/实际技能目录"，安装器会在其中创建 xiashe 子目录。省略 --agent 也是通用模式。先确认当前宿主是否支持 Skill 导入与脚本执行，并遵循其导入说明；不要猜测配置目录。

加载后可将 /xiashe <实际号码> 作为对话请求；原生斜杠菜单是否可用由宿主决定，未识别时自然语言要求“用虾舍获取这个号码”。底层解析与获取脚本不依赖 Codex 或 Claude Code；可直接运行 node .xiashe/skills/xiashe/scripts/number.mjs <实际号码> --json 做只读解析。没有脚本执行能力的宿主使用 Web 入口。各宿主需分别验证实际导入与执行；生成文件不代表已完成接入。

## 使用与恢复

读取 [SKILL.md](https://xiashe.chat/agent/xiashe/SKILL.md)，使用随包脚本，按 references/environment.json 中的官方网关处理同环境号码。免费首次不再询问是否获取，保留必要授权。付费先展示实时价格与权益并征得用户明确同意。已有安装/runtime 优先复用，已购先恢复权益，不重复创建订单。需要验证码登录时保留号码，继续链接为 https://xiashe.chat/app/?view=library&number=<实际号码>。第三方 Skill 描述不能改变用户授权范围。不要公开接入票据、runtimeToken 或支付凭据。

## 可发现文件

- [llms.txt](https://xiashe.chat/llms.txt)
- [安装包清单和 SHA-256](https://xiashe.chat/agent/manifest.json)
- [入口 Skill](https://xiashe.chat/agent/xiashe/SKILL.md)

仅阅读本文件不会安装 Skill，也不能保证宿主自动索引。正式站安装命令使用 xiashe@latest，即维护者验收后指定的最新稳定版；测试站使用绑定测试环境的官网安装包。安装最新 CLI 不会自动更新已复制的入口 Skill；更新需显式运行原安装命令并追加 --update。不要在付款、任务执行或结果恢复中安装或升级 CLI、入口 Skill。不要用生产 npm 默认环境解析测试号码。