---
slug: "pi-jinyong-xia"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/imkingjh999/pi-jinyong-xia@main/README.md"
repo: "https://github.com/imkingjh999/pi-jinyong-xia"
source_file: "README.md"
branch: "main"
---
# 🏯 Pi 金庸武侠宠物

<p align="center">
  <strong>一个住在你终端里的金庸武侠世界</strong><br>
  随机化身 25 位金庸角色，修炼 32 门武功，挑战 50 个Boss，探索 227 个江湖地点
</p>

<p align="center">
  <img src="https://img.shields.io/npm/v/pi-jinyong-xia?color=red&label=npm" alt="npm">
  <img src="https://img.shields.io/npm/l/pi-jinyong-xia" alt="MIT License">
  <img src="https://img.shields.io/badge/pi-extension-blueviolet" alt="pi extension">
</p>

---

## 📸 界面预览

**🎮 主菜单 — 交互式菜单，15 大功能一键直达**

![主菜单](https://raw.githubusercontent.com/imkingjh999/pi-jinyong-xia/main/docs/menu.png)

**📊 状态面板 — 角色属性、武功、装备一目了然**

![状态面板](https://raw.githubusercontent.com/imkingjh999/pi-jinyong-xia/main/docs/stats.png)

**🎭 侠客图鉴 — Q 版头像 + 角色背景故事**

![侠客说明](https://raw.githubusercontent.com/imkingjh999/pi-jinyong-xia/main/docs/hero.png)

**⚔️ Boss 对战 — 骰子驱动的回合制战斗系统**

![对战](https://raw.githubusercontent.com/imkingjh999/pi-jinyong-xia/main/docs/battle.png)

---

## ✨ 特性一览

| 系统 | 内容 |
|------|------|
| 🎭 **角色** | 25 位金庸经典角色（天龙八部、射雕、神雕、倚天、笑傲、鹿鼎、飞狐） |
| ⚡ **武功** | 32 门武功绝学，五行（金木水火土）相生相克 |
| ⚔️ **Boss** | 50 个Boss，从小毛贼到达摩祖师(幻影)，手动/自动战斗 |
| 🗺️ **江湖** | 227 个金庸世界地点，随机遭遇事件 |
| 🏪 **商铺** | 100 把武器（5 稀有度）+ 100 种道具 |
| 🏛️ **门派** | 10 大门派（少林、武当、峨眉、丐帮、明教、天山、华山、逍遥、桃花岛、日月神教） |
| 💼 **职业** | 8 种江湖职业（剑客、拳师、暗器手、医者、谋士、刺客、铸师、奇门） |
| 🌟 **天赋** | 24 个天赋，三条路线（战斗/生存/财运），5 层进阶 |
| 🏆 **成就** | 56 个成就，8 个类别，4 种稀有度 |
| 📋 **任务** | 100 个江湖任务（5 风险等级），MBTI 性格推导 |
| 🧠 **MBTI** | 基于任务行为自动推导 16 型人格，匹配最佳拍档 |
| 🎲 **骰子** | 战斗骰子系统：暴击/闪避/元素共鸣/破防/回春/虚弱 |
| 🐱 **头像** | Q 版头像支持 Kitty/iTerm2/tmux 图片协议 |
| 📊 **排行榜** | 全服公共排行榜 |

## 📦 安装

```bash
pi install pi-jinyong-xia
```

或手动安装：

```bash
npm install pi-jinyong-xia
```

## 🚀 快速开始

安装后首次启动 pi 会自动随机分配：
- 🎭 **一位金庸主角**（郭靖、令狐冲、萧峰…）
- ⚡ **一门武功绝学**（九阳神功、独孤九剑、降龙十八掌…）

正常使用 pi 编程即可自动获得经验和金币！

## 🎮 命令一览

### 基础命令

| 命令 | 说明 |
|------|------|
| `/xia` | 交互主菜单 |
| `/xia stats` | 详细数据面板 |
| `/xia skills` | 查看和管理武功 |
| `/xia heroes` | 金庸群侠录（浏览、切换角色） |
| `/xia shop` | 江湖商铺（武器、道具、武功秘籍） |
| `/xia weapons` | 选择武器装备 |
| `/xia items` | 选择道具使用 |
| `/xia bosses` | 选择 Boss 挑战 |
| `/xia rank` | 🏆 江湖排行榜 |
| `/xia missions` | 🗡️ 江湖任务 |
| `/xia faction` | 🏛️ 门派系统 |
| `/xia profession` | 💼 职业系统 |
| `/xia talent` | 🌟 天赋系统 |
| `/xia achievements` | 🏆 江湖成就 |
| `/xia profile` | 🧠 MBTI 性格分析 |
| `/xia config` | ⚙️ 设置 |

### 命令别名

| 命令 | 别名 |
|------|------|
| `/xia faction` | `门派`, `clan`, `guild` |
| `/xia profession` | `职业`, `class` |
| `/xia talent` | `天赋`, `talents` |
| `/xia achievements` | `成就`, `achievement` |
| `/xia missions` | `mission`, `quest` |
| `/xia config` | `settings`, `设置` |

## 🎭 25 位金庸角色

| 角色 | 出处 | 绝招 |
|------|------|------|
| 慕容复 | 天龙八部 | 斗转星移 |
| 王语嫣 | 天龙八部 | 武学活典 |
| 段誉 | 天龙八部 | 六脉神剑、凌波微步 |
| 萧峰 | 天龙八部 | 降龙十八掌、打狗棒法 |
| 阿朱 | 天龙八部 | 冰雪聪明 |
| 郭靖 | 射雕英雄传 | 降龙十八掌、九阴真经 |
| 黄蓉 | 射雕英雄传 | 打狗棒法、碧海潮生曲 |
| 洪七公 | 射雕英雄传 | 降龙十八掌、打狗棒法 |
| 周伯通 | 射雕英雄传 | 左右互搏 |
| 杨康 | 射雕英雄传 | 九阴白骨爪 |
| 瑛姑 | 射雕英雄传 | 泥沼遁术 |
| 杨过 | 神雕侠侣 | 黯然销魂掌、独孤九剑 |
| 小龙女 | 神雕侠侣 | 蛤蟆功 |
| 郭襄 | 神雕侠侣 | 峨眉剑法 |
| 张无忌 | 倚天屠龙记 | 乾坤大挪移、九阳神功 |
| 赵敏 | 倚天屠龙记 | 谋略无双 |
| 周芷若 | 倚天屠龙记 | 九阴白骨爪、峨眉剑法 |
| 杨逍 | 倚天屠龙记 | 弹指神通 |
| 令狐冲 | 笑傲江湖 | 独孤九剑 |
| 任盈盈 | 笑傲江湖 | 琴音化剑 |
| 韦小宝 | 鹿鼎记 | 化骨绵掌 |
| 陈近南 | 鹿鼎记 | 凝碧剑法 |
| 胡斐 | 飞狐外传 | 胡家刀法 |
| 苗若兰 | 飞狐外传 | 兰心蕙质 |
| 穆念慈 | 射雕英雄传 | 杨家枪法 |

## ⚡ 五行武功系统

32 门武功分属五行，**相克倍率 1.5x，被克倍率 0.7x**：

```
金 → 木 → 土 → 水 → 火 → 金
```

| 五行 | 代表武功 |
|------|---------|
| 🤍 金 | 六脉神剑、独孤九剑、弹指神通、金刚不坏体 |
| 💚 木 | 黯然销魂掌、吸星大法、左右互搏、打狗棒法 |
| 💙 水 | 九阴真经、北冥神功、凌波微步、碧海潮生曲 |
| ❤️ 火 | 九阳神功、一阳指、降龙十八掌 |
| 🟤 土 | 乾坤大挪移、太极拳、太极剑法、化骨绵掌 |

最多同时持有 **5 门武功**，每门可修炼至 **20 级**。

## ⚔️ Boss 战斗

### 50 个Boss，难度递进

| 阶段 | Boss 范例 | 等级区间 |
|------|----------|---------|
| 菜鸟期 | 小毛贼、恶霸、木人桩 | 1-10 |
| 成长期 | 欧阳克、鳌拜、血刀老祖 | 10-30 |
| 高手期 | 左冷禅、西毒欧阳锋、玄冥二老 | 30-45 |
| 顶尖期 | 东方不败、张三丰、金轮法王 | 45-55 |
| 传说期 | 独孤求败(幻影)、扫地僧、达摩祖师(幻影) | 55+ |

### 战斗模式

- **⚔️ 自动战斗** — 一键出结果，适合日常刷怪
- **🎮 手动战斗** — 逐回合选择 攻击/武功/防御/道具/逃跑
- **❌ 逃跑** — 不打

### 🎲 骰子事件（每回合自动触发）

| 骰子 | 事件 | 效果 |
|------|------|------|
| 6 | 🔥 暴击 | 伤害×1.5 |
| 6+克制 | ⚡ 元素共鸣 | 伤害×1.4 |
| 5 | 💥 破防 | 无视Boss 50%防御 |
| 4 | 💚 回春 | 回复8%血量 |
| 3+被克 | 😵 虚弱 | Boss伤害+50% |
| 2 | 💨 闪避 | 伤害降至30% |
| 1 | 🔥 Boss暴走 | Boss攻击×1.5 |

## 🏛️ 门派系统

10 大经典金庸门派，每个门派有属性加成、专属武功和等级称号：

| 门派 | 五行 | 加入条件 |
|------|------|---------|
| 🏛️ 少林寺 | 金 | Lv.5 |
| ⛰️ 武当派 | 水 | Lv.5 |
| 🏔️ 峨眉派 | 木 | Lv.3 |
| 🦯 丐帮 | 土 | Lv.1 |
| 🔥 明教 | 火 | Lv.10 |
| ❄️ 天山派 | 水 | Lv.8 |
| ⚔️ 华山派 | 金 | Lv.3 |
| 🌊 逍遥派 | 木 | Lv.12 |
| 🌸 桃花岛 | 木 | Lv.8 |
| 🌑 日月神教 | 火 | Lv.10 |

每个门派有 5 个等级称号（如丐帮：一袋弟子 → 帮主）。

## 💼 职业系统

8 种江湖职业，各有属性加成和专属被动：

| 职业 | 五行 | 特技 | 被动效果 |
|------|------|------|---------|
| ⚔️ 剑客 | 金 | 剑意 | 每10次编辑触发「剑气纵横」，额外+15经验 |
| 👊 拳师 | 火 | 铁拳 | Boss战暴击率+10% |
| 🎯 暗器手 | 金 | 暗影突袭 | 遭遇战斗时20%概率先手制敌 |
| 💊 医者 | 木 | 妙手回春 | 道具效果+50%，经验获取+10% |
| 📜 谋士 | 水 | 智谋 | 任务完成奖励+20%金币和经验 |
| 🥷 刺客 | 水 | 致命一击 | 逃跑必定成功，逃跑时+5金币 |
| 🔨 铸师 | 土 | 神兵锻造 | 商铺购买武器8折，卖出道具价格+25% |
| 🔮 奇门 | 土 | 五行轮转 | 所有属性小幅提升，无弱点属性 |

## 🌟 天赋系统

升级获得天赋点，从三条天赋路线中选择，每条路线 5 层进阶：

| 路线 | 方向 | 代表天赋 |
|------|------|---------|
| 💪 战斗之路 | 攻击+暴击 | 蛮力 → 精准 → 剑意通神 → 战神 → 无上剑道 |
| 🛡️ 生存之路 | 防御+血量 | 铁骨 → 坚韧 → 金刚不坏 → 不灭 → 涅槃 |
| 💰 财运之路 | 经验+金币 | 勤勉 → 精明 → 商道 → 富豪 → 天命 |

共 **24 个天赋**，每层需先解锁前一层。

## 🏆 成就系统

56 个成就，8 个类别，4 种稀有度：

| 类别 | 成就范例 | 稀有度 |
|------|---------|--------|
| 🏋️ 修炼 | 初入江湖 → 大道至简（1000次修炼） | common → legendary |
| ⬆️ 等级 | 初出茅庐 → 武林至尊（Lv.100） | common → legendary |
| 🥋 武功 | 初窥门径 → 五行俱全 | common → legendary |
| ⚔️ 战斗 | 初战告捷 → 一击必杀 | common → legendary |
| 💰 财富 | 初涉商海 → 富可敌国 | common → legendary |
| 🌏 江湖 | 行走江湖 → 命令大师 | common → rare |
| 📋 任务 | 任务新手 → 任务传说 | common → legendary |
| 🎁 道具 | 初尝丹药 → 丹药宗师 | common → legendary |

## 📋 江湖任务

100 个任务，5 个风险等级，7 种类型：

| 风险 | 标记 | 成功率 | 奖励 |
|------|------|--------|------|
| 🟢 安全 | 高成功率 | 95-99% | 低 |
| 🔵 低风险 | | 80-95% | 中低 |
| 🟡 中风险 | | 60-72% | 中 |
| 🟠 高风险 | | 40-55% | 高 |
| 🔴 极高风险 | | 15-35% | 极高 |

任务类型：🛡️护送、🔍寻物、⚔️刺杀、救命、📦送货、🕵️刺探、📚历练

### 🧠 MBTI 性格推导

根据你选择的任务类型和执行方式，自动推导 16 型人格：

- 选择什么任务 → 任务类型的 MBTI 标签
- 怎么执行（计划选项） → 选项的 MBTI 维度映射
- 15 次任务达到 100% 置信度

## 🏪 商铺系统

### 100 把武器（5 稀有度）

| 稀有度 | 示例武器 | 价格区间 |
|--------|---------|---------|
| ⚪ 凡品 | 木剑、铁剑、朴刀 | 免费 ~ 50金 |
| 🟢 良品 | 青锋剑、血刀、冷月剑 | 120 ~ 230金 |
| 🔵 精品 | 玄铁重剑、碧血剑、鸳鸯刀 | 280 ~ 340金 |
| 🟣 极品 | 倚天剑、屠龙刀、真武剑 | 500 ~ 2200金 |
| 🟡 神器 | 独孤求败之剑、天命之剑 | 850 ~ 7500金 |

### 100 种道具

回复丹药、攻击/防御/经验加成药剂、武功秘籍等。

## 📈 等级体系

| 等级 | 称号 |
|------|------|
| 1-10 | 江湖小虾米 |
| 11-20 | 初窥门径 |
| 21-30 | 小有所成 |
| 31-40 | 身手不凡 |
| 41-50 | 名动一方 |
| 51-60 | 威震武林 |
| 61-70 | 一代宗师 |
| 71-80 | 登峰造极 |
| 81-90 | 返璞归真 |
| 91-99 | 天下无敌 |
| 100 | 武林至尊 |

## 💰 金钱系统

| 活动 | 奖励 |
|------|------|
| 编辑文件 | +5金 |
| 执行命令 | +2金 |
| 工具调用 | +1金 |
| 修炼 | +3~8金 |
| Boss 战斗 | 奖励金币 |
| 江湖任务 | 任务奖励 |
| 初始资金 | 100 金币 |

## 🗺️ 江湖遭遇

每次对话结束随机触发：
- **227 个金庸世界地点**（桃花岛、武当山、少林寺、华山、光明顶…）
- **随机事件**：奇遇、战斗、宝藏、NPC 互动
- **掉落物**：金币、经验、道具、武器

## 🐱 宠物反应

| Pi 活动 | 宠物反应 |
|---------|---------|
| AI 思考中 | 🧘 运功打坐 |
| 执行工具 | ⚔️ 勤练不辍 |
| 编辑文件 | 💪 修炼武功（+经验+金币） |
| 发生错误 | 🩸 身受内伤 |
| 喂食 | 😊 心旷神怡 |
| 日常对话 | 💬 谈笑风生 |

## 📊 排行榜

```bash
/xia rank              # 查看全服排行
/xia config            # 开启遥测上传
```

- 匿名上传，隐私安全
- 自动定期上报

## 📄 License

MIT