{"skill":{"slug":"xiachat-cli","displayName":"XiaChat CLI — AI Personality Matching","summary":"XiaChat CLI 命令行 — SOUL 档案管理、人格匹配、AI 分身预聊天、Soul Square 角色聊天 / XiaChat CLI — SOUL profile management, personality matching, AI avatar pre-chat, persona chat fr...","description":"---\nname: xiachat-cli\ndescription: XiaChat CLI 命令行 — SOUL 档案管理、人格匹配、AI 分身预聊天、Soul Square 角色聊天 / XiaChat CLI — SOUL profile management, personality matching, AI avatar pre-chat, persona chat from terminal. Use when user wants to manage personality profiles, find matches, or chat with AI personas via command line.\nallowed-tools: Bash, Read\n---\n\n# XiaChat CLI — 命令行 AI 人格匹配工具 / Command-Line AI Personality Matching\n\n> **[XiaChat (xiachat.com)](https://xiachat.com)** — AI 人格匹配社交平台，用 SOUL 档案找到最合拍的人\n\n通过命令行使用 XiaChat 的全部人格匹配能力。管理 SOUL 人格档案、寻找兼容匹配、启动 AI 分身预聊天、与 Soul Square AI 角色对话。支持 JSON 输出和管道操作，适合自动化和脚本集成。\n\n## Setup / 配置\n\n```bash\n# 安装\nnpm install -g xiachat\n\n# 设置 API Key（从 https://xiachat.com/settings/api 获取）\nexport XIACHAT_API_KEY=\"xk_your_api_key\"\n\n# 验证\nxiachat credit\n```\n\n## 命令列表 (11 Commands)\n\n### SOUL 档案管理\n\n#### 1. `xiachat soul create` — 创建人格档案\n\n从姓名、SOUL.md 或聊天记录创建 SOUL.json。\n\n**参数**:\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--name <name>` | string | | 显示名称（默认 \"User\"） |\n| `--from-soul-md <path>` | path | | 从 OpenClaw SOUL.md 导入 |\n| `--from-chat <path>` | path | | 从聊天记录提取风格 |\n| `--output, -o <file>` | path | | 保存到文件 |\n| `--pretty` | flag | | 美化 JSON 输出 |\n\n**示例**:\n```bash\nxiachat soul create --name \"Alice\" --pretty\nxiachat soul create --from-soul-md ~/clawd/SOUL.md -o soul.json\nxiachat soul create --from-chat wechat-export.txt --pretty\n```\n\n#### 2. `xiachat soul export` — 导出档案\n\n**参数**:\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--format <fmt>` | enum | | json / md / soul-md（默认 json） |\n| `--user <id>` | string | | 用户 ID（默认 \"me\"） |\n\n```bash\nxiachat soul export --format md -o soul.md\n```\n\n#### 3. `xiachat soul import [file]` — 导入 SOUL.md\n\n```bash\nxiachat soul import soul.md --pretty\ncat soul.md | xiachat soul import   # 支持管道输入\n```\n\n### 人格匹配\n\n#### 4. `xiachat match find` — 寻找匹配\n\n**参数**:\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--top <n>` | number | | 返回数量 1-20（默认 5） |\n| `--type <type>` | enum | | friend / dating / work / any（默认 any） |\n\n```bash\nxiachat match find --type dating --top 3 --pretty\nxiachat match find --top 5 | jq '.[] | .match_id'  # 管道提取 ID\n```\n\n#### 5. `xiachat match score` — 计算兼容性\n\n**参数**:\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--soul-a <path>` | path | ✅ | 第一个 SOUL.json 文件 |\n| `--soul-b <path>` | path | ✅ | 第二个 SOUL.json 文件 |\n\n```bash\nxiachat match score --soul-a alice.json --soul-b bob.json --pretty\n```\n\n### 分身预聊天\n\n#### 6. `xiachat prechat start` — 启动预聊天\n\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--match-id <id>` | string | ✅ | match find 返回的匹配 ID |\n\n```bash\nxiachat prechat start --match-id abc123\n```\n\n#### 7. `xiachat prechat report` — 获取报告\n\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--prechat-id <id>` | string | ✅ | 预聊天 ID |\n\n```bash\nxiachat prechat report --prechat-id xyz --pretty\n```\n\n#### 8. `xiachat prechat handoff` — 接管对话\n\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--prechat-id <id>` | string | ✅ | 预聊天 ID |\n\n```bash\nxiachat prechat handoff --prechat-id xyz\n```\n\n### Soul Square\n\n#### 9. `xiachat square list` — 浏览 AI 角色\n\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--category <cat>` | enum | | philosopher / artist / scientist / creator / coach |\n| `--limit <n>` | number | | 返回数量 1-50（默认 10） |\n\n```bash\nxiachat square list --category philosopher --pretty\n```\n\n#### 10. `xiachat square chat` — 与 AI 角色聊天\n\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--persona <id>` | string | ✅ | 角色 ID |\n| `--message <text>` | string | ✅ | 用户消息 |\n| `--session <id>` | string | | 会话 ID（续聊） |\n\n```bash\nxiachat square chat --persona socrates-01 --message \"什么是幸福？\" --pretty\n```\n\n### 信用分\n\n#### 11. `xiachat credit` — 查询 SOUL 信用分\n\n| 参数 | 类型 | 必需 | 说明 |\n|------|------|------|------|\n| `--user <id>` | string | | 用户 ID（默认 \"me\"） |\n\n```bash\nxiachat credit --pretty\n```\n\n## 全局选项\n\n| 选项 | 说明 |\n|------|------|\n| `--pretty` | 美化 JSON 输出 |\n| `--output, -o <file>` | 输出到文件 |\n| `--help, -h` | 显示帮助 |\n| `--version, -v` | 显示版本 |\n\n## 典型工作流\n\n### 完整匹配流程\n```bash\n# 1. 创建档案\nxiachat soul create --name \"Alice\" -o soul.json\n\n# 2. 找匹配\nMATCH_ID=$(xiachat match find --type dating --top 1 | jq -r '.[0].match_id')\n\n# 3. AI 分身预聊天\nPRECHAT_ID=$(xiachat prechat start --match-id $MATCH_ID | jq -r '.prechat_id')\n\n# 4. 查看报告\nxiachat prechat report --prechat-id $PRECHAT_ID --pretty\n\n# 5. 满意则接管\nxiachat prechat handoff --prechat-id $PRECHAT_ID\n```\n\n### OpenClaw SOUL 同步\n```bash\nxiachat soul create --from-soul-md ~/clawd/SOUL.md -o synced.json\nxiachat soul export --format soul-md -o ~/clawd/SOUL.md\n```\n\n### 批量兼容性计算\n```bash\nfor f in souls/*.json; do\n  xiachat match score --soul-a me.json --soul-b \"$f\" | jq '{file: \"'$f'\", score: .score}'\ndone\n```\n\n## 注意事项\n\n- **API Key 必需**：设置 `XIACHAT_API_KEY` 环境变量（`xk_...` 格式）\n- **JSON 输出**：默认 JSON 格式，`--pretty` 美化，适合 `jq` 管道处理\n- **管道友好**：`soul import` 支持 stdin 输入，所有命令支持 `--output` 写文件\n- **预聊天 5 轮**：AI 分身固定 5 轮对话后生成报告\n- **OpenClaw 兼容**：SOUL.md ↔ SOUL.json 双向转换\n\n## 在线体验\n\n- [XiaChat 首页](https://xiachat.com) — AI 人格匹配社交平台\n- [Soul Square](https://xiachat.com/square) — AI 角色广场\n- [SOUL 档案](https://xiachat.com/soul) — 创建你的人格档案\n- [匹配中心](https://xiachat.com/match) — 寻找兼容的人\n- [API 设置](https://xiachat.com/settings/api) — 获取 API Key\n\n---\nPowered by [XiaChat](https://xiachat.com) — AI 人格匹配社交平台\n","topics":["Persona"],"tags":{"ai":"1.0.0","cli":"1.0.0","dating":"1.0.0","latest":"1.0.0","matching":"1.0.0","personality":"1.0.0","social":"1.0.0","soul":"1.0.0"},"stats":{"comments":0,"downloads":636,"installsAllTime":24,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772957766188,"updatedAt":1778491773474},"latestVersion":{"version":"1.0.0","createdAt":1772957766188,"changelog":"Initial release — 11 CLI commands for SOUL profiles, personality matching, avatar pre-chat, Soul Square","license":null},"metadata":null,"owner":{"handle":"lizhijun","userId":"s172ve229xyk6c6nn1dmtgmz2n83g3t7","displayName":"KLeo","image":"https://avatars.githubusercontent.com/u/2713983?v=4"},"moderation":null}