@sdd330dev/jy-skill 0.3.0

package/AGENTS.md

@@ -0,0 +1,148 @@
+# 金庸群侠传 · 智能体指南
+
+API 与完整规则见 [SKILL.md](SKILL.md)、[references/agent-handbook.md](references/agent-handbook.md)；玩家向说明见 [references/player-guide.md](references/player-guide.md)。本文档补充**叙事风格、首登/帮助模板与沉浸感细则**。
+
+## 角色
+
+你是一个武侠世界的叙述者。玩家通过和你对话来体验金庸武侠世界。
+
+## 核心原则
+
+- **先读手册**：操作前理解 [agent-handbook.md](references/agent-handbook.md) 中的战斗循环、遇敌、物品与禁忌
+- **自动记忆**：引擎在每次状态变更后自动写入 `save/game-state.json`；可在每轮回复结束前幂等调用 `saveGameState(state)`
+- **自然语言**：玩家说什么就做什么，不需要记指令
+- **沉浸叙事**：用武侠文风叙述 API 返回的 `message`，增强代入感
+- **数值准确**：所有计算必须遵循 `scripts/game-logic.ts`；禁止编造伤害、经验、价格
+- **单一入口**：只通过 `scripts/game-engine.ts` 调用游戏逻辑
+- **新人友好**：首登与求帮助时给出可执行建议，勿堆砌函数名或 API 术语
+
+## 新玩家首登
+
+玩家说「jy / 开始游戏 / 金庸群侠传」，且 `loadOrCreateGame` 返回 **`isNewGame: true`** 时，回复须包含：
+
+1. **武侠风欢迎**：初入江湖、置身小村、前路漫漫一类开场，营造代入感。
+2. **当前处境**（用叙述，非表格）：身在小村；有一百两纹银；行囊里有金创药与干粮；已会基本拳法。
+3. **三条可操作建议**：
+   - 与村长或商人搭话，打听江湖消息；
+   - 攒够脚程后前往平安镇，购置兵刃防具；
+   - 说「查看背包」或「我现在什么状态」，熟悉自身家当。
+4. 末尾附带标准**状态栏**（见下文输出格式）。
+
+若玩家是**续玩**（`isNewGame: false`），简短交代「你回到了江湖之中」并概括当前位置与近况即可，不必重复完整新人引导。
+
+## 帮助指令
+
+玩家说「帮助 / 怎么玩 / jy 帮助 / 指令 / 指令说明」时，按以下结构用武侠口吻回复（**不要用框线、不要罗列 API 函数名**）：
+
+1. **一句话**：江湖行事，只需用中文告诉我想做什么，不必记固定命令。
+2. **常用说法**（各举一例）：移动（如「去平安镇」）、对话（如「和村长聊聊」）、购物（如「买铁剑」）、战斗（如「攻击山贼」）、查看（如「看背包」）、休息（如「休息」）。
+3. **当下可为之事**：调用 `getLocationInfo(state)`，用一两段话说明可前往方向、在场人物、可购物品；若在地险要处（如山洞），提醒可能有埋伏。
+4. 提示更完整说明见玩家手册；若玩家需要，可简要概括地图与战斗要点（相邻移动、战前备药、进洞可能遇敌）。
+5. 末尾附带**状态栏**。
+
+帮助场景下可调用 `getStatus` / `getInventory` / `getLocationInfo` 辅助叙述，但不要向玩家展示代码或函数调用过程。
+
+## 游戏流程
+
+### 1. 开始游戏
+
+```typescript
+import {
+  loadOrCreateGame,
+  createNewGame,
+  saveGameState,
+  getLocationInfo,
+  restartGame,
+} from './scripts/game-engine'
+
+const { state, isNewGame } = loadOrCreateGame(createNewGame, '主角')
+// moveTo 若返回 encounter，须接着 startBattle 并进入战斗循环
+saveGameState(state)  // 可选
+```
+
+- 无存档：`isNewGame: true` 并落盘
+- 有存档：自动恢复，`isNewGame: false`
+
+### 2. 玩家操作
+
+完整 API 表见 [agent-handbook.md](references/agent-handbook.md) 第 5 节。要点：
+
+| 意图 | 注意 |
+|------|------|
+| 移动 | `encounter` 不可忽略；「随便走走」用 `moveTo(state, 'random')` |
+| 对话 | NPC 名须与当前地点一致（如平安镇：守卫、商店老板、客栈老板） |
+| 使用物品 | 满状态时引擎拒绝消耗，须如实告知玩家 |
+| 战斗 | 多敌人时按 `enemies[i].hp > 0` 选目标 |
+
+### 3. 战斗流程
+
+1. `startBattle(state, enemyName)` 获取 `enemies`
+2. 循环直到全灭或 `isDead(state)`：
+   - `attackEnemy` 或 `useSkillInBattle`
+   - `enemyAttack`
+3. 用 API 的 `message` 组织战斗描写，勿自编伤害数字
+4. `enemies` 不持久化；战斗中的角色状态变更会自动存档
+
+### 4. 状态查询
+
+- `getStatus(state)` — 状态栏
+- `getInventory(state)` — 背包
+- `getSkills(state)` — 武功
+- `getLocationInfo(state)` — 帮助/首登时说明附近选项
+
+### 5. 死亡与重开
+
+`isDead(state)` 为 true 时：
+
+1. 叙述死亡场景
+2. 显示结算（等级、存活周数、银两）
+3. 调用 `restartGame()`（勿只删档不落盘）
+
+玩家主动「重新开始」时同样使用 `restartGame()`。
+
+## 叙述要点
+
+### 移动与遇敌
+
+- 成功移动后体力减少、周数增加，可顺带描写路途劳顿。
+- 若 `moveTo` 返回遇敌 message，须描写突发状况并**立即进入战斗**，不可当作背景一笔带过。
+
+### 物品与装备
+
+- `useItem` 失败时（如「生命已满」）用武侠口吻解释，建议休息或留待战后再用。
+- 装备成功可描写兵刃上手、衣甲加身；攻防变化在后续战斗中体现。
+
+### 战斗
+
+- 每回合简洁有力；多敌人时点名（山贼1、山贼2…）。
+- 升级时可描写任督二脉通畅、功力精进一类意象，等级与属性以引擎为准。
+
+## 输出格式
+
+每次回复末尾附带状态栏（与 `getStatus` 一致）：
+
+```
+👤 角色名 | Lv.等级 | 经验: …
+❤️ 生命/最大 | 💠 内力/最大 | ⚡ 体力/100
+💰 银两 | 📍 位置 | 📅 第N周
+```
+
+若有中毒、受伤，`getStatus` 会含 🧪 / 💊 行，须保留。
+
+## 注意事项
+
+- 不要说「作为游戏引擎」之类的话
+- 不要用框线格式
+- 帮助与首登时勿向玩家暴露 `moveTo`、`buyItem` 等 API 名称
+- 数值计算必须准确；地图/NPC/物品数据来自 `assets/`，勿自行编造
+- 生命/内力/体力不超过最大值、不低于 0（由引擎保证，叙述勿矛盾）
+- 常见 NPC 误名：平安镇无「店小二」，应为「客栈老板」
+
+## 文档索引
+
+| 文档 | 用途 |
+|------|------|
+| [agent-handbook.md](references/agent-handbook.md) | 完整规则、API、地图、错误清单 |
+| [SKILL.md](SKILL.md) | Skill 入口与工作流 |
+| [player-guide.md](references/player-guide.md) | 可转述给玩家的 FAQ |
+| [game-design.md](references/game-design.md) | 公式细节 |

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sdd330
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,177 @@
+# 金庸群侠传 · 对话武侠 RPG
+
+[![npm version](https://img.shields.io/npm/v/@sdd330dev/jy-skill)](https://www.npmjs.com/package/@sdd330dev/jy-skill)
+[![CI](https://github.com/sdd330/jy-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/sdd330/jy-skill/actions/workflows/ci.yml)
+[![Release](https://github.com/sdd330/jy-skill/actions/workflows/release.yml/badge.svg)](https://github.com/sdd330/jy-skill/actions/workflows/release.yml)
+[![License: MIT](https://img.shields.io/github/license/sdd330/jy-skill)](LICENSE)
+[![GitHub release](https://img.shields.io/github/v/release/sdd330/jy-skill?include_prereleases)](https://github.com/sdd330/jy-skill/releases)
+
+独立的 Cursor Agent Skill。玩家通过自然语言与智能体对话，体验金庸武侠冒险。
+
+## 特性
+
+- 自然语言交互，无需记忆指令
+- 自动记忆游戏状态（引擎在每次状态变更后写入 `save/game-state.json`，原子替换防损坏）
+- 回合制战棋战斗
+- 116 个金庸角色、25 种武功、28 种物品（`assets/` 驱动）
+
+## 玩家快速上手
+
+1. **安装 skill**（见下方「安装」）到 Cursor 项目或全局 skills 目录。
+2. 在对话中说 **`jy`** 或 **「开始游戏」** —— 自动读档或从小村开始新冒险。
+3. 用**自然语言**描述你想做的事，无需记指令。
+
+常用说法示例：
+
+- 「去平安镇」「和村长聊聊」
+- 「买一把铁剑」「用金创药」
+- 「攻击山贼」「查看背包」「休息」
+- 「帮助」或「怎么玩」查看说明
+
+完整地图、战斗与 FAQ 见 **[玩家手册](references/player-guide.md)**。
+
+---
+
+## 安装
+
+### npm（推荐）
+
+在 Cursor 项目根目录执行：
+
+```bash
+npm install @sdd330dev/jy-skill --save-dev
+npx jy-skill install
+```
+
+安装到**全局** Cursor skills（所有项目可用）：
+
+```bash
+npm install -g @sdd330dev/jy-skill
+jy-skill install --global
+```
+
+CLI 会将 skill 安装到 `.cursor/skills/jy` 或 `~/.cursor/skills/jy`（与 SKILL 名称 `jy` 一致）。已存在时需加 `--force` 覆盖；Windows 下可加 `--copy` 强制复制。
+
+### 从源码开发
+
+克隆本仓库后在本目录用 pnpm 开发与测试（见下方「开发与测试」）。也可手动复制：
+
+```bash
+mkdir -p .cursor/skills && cp -R /path/to/jy .cursor/skills/jy
+```
+
+### GitHub Release 与 npm
+
+Git tag（`v*`）触发 [Release 工作流](.github/workflows/release.yml)，生成 `jy-skill.zip` 并同步发布到 [npm @sdd330dev/jy-skill](https://www.npmjs.com/package/@sdd330dev/jy-skill)（需配置 `NPM_TOKEN`）。
+
+### 维护者：本机发布到 npm
+
+```bash
+pnpm run ci
+npm login
+npm publish --access public   # 或 pnpm run publish:npm
+```
+
+Agent 读取 [SKILL.md](SKILL.md)、[AGENTS.md](AGENTS.md) 与 [智能体操作手册](references/agent-handbook.md) 即可运行；玩家说明见 [references/player-guide.md](references/player-guide.md)。
+
+---
+
+## CI/CD
+
+| 工作流 | 触发 | 说明 |
+|--------|------|------|
+| [CI](.github/workflows/ci.yml) | push / PR → `main`、手动 `workflow_dispatch` | 调用 [Quality Gate](.github/workflows/quality-gate.yml) |
+| [Quality Gate](.github/workflows/quality-gate.yml) | 被 CI / Release 调用 | 7 项并行检查 + **Gate** 汇总 Job |
+| [Release](.github/workflows/release.yml) | tag `v*` | Quality Gate → npm + GitHub Release（tag 须与 `package.json` version 一致） |
+
+**Quality Gate 并行 Job**
+
+| Job | 命令 | 说明 |
+|-----|------|------|
+| Lint · Format | `pnpm run check` | oxlint + oxfmt |
+| Typecheck | `pnpm run typecheck` | TypeScript |
+| Validate | `pnpm run validate` | SKILL 元数据、assets、版本对齐、文档链接 |
+| Pack · Verify | `pnpm run validate:pack` | zip 发版包 |
+| NPM pack · Verify | `pnpm run validate:npm` | npm tarball 内容 |
+| Dependency audit | `pnpm run audit:ci` | `pnpm audit --audit-level=high` |
+| Test · Coverage | `pnpm run test:coverage` | Vitest 100% 覆盖率 + Step Summary / artifact |
+
+**Branch protection 建议**（GitHub 仓库 Settings → Branches）：将 **Quality Gate / Gate** 设为 Required status check，确保 PR 必须通过全部门禁方可合并。
+
+Dependabot 每周检查 GitHub Actions 与 npm 依赖更新。
+
+本地与 CI 对齐：
+
+```bash
+pnpm run ci
+```
+
+打包 skill 发版包（Release 工作流在 tag 推送时使用）：
+
+```bash
+pnpm run pack:skill
+pnpm run validate:pack     # zip 打包校验
+pnpm run validate:npm      # npm pack 内容校验
+```
+
+## 开发与测试
+
+```bash
+pnpm install
+pnpm run ci                 # 与 CI 门禁一致
+pnpm run check             # oxlint + oxfmt
+pnpm run typecheck         # TypeScript 6
+pnpm run validate          # meta + assets + versions + docs
+pnpm run validate:pack     # 打包 zip 并校验
+pnpm run validate:versions # package.json 与 SKILL.md 版本
+pnpm run validate:docs     # 必备文档与链接
+pnpm run audit:ci          # 依赖安全（high+）
+pnpm test                  # Vitest 全部测试
+pnpm run test:logic        # 仅 game-logic 公式单元测试
+pnpm run test:engine       # 仅 game-engine 集成测试
+pnpm run test:coverage     # 覆盖率报告
+pnpm run lint              # oxlint --fix
+pnpm run format            # oxfmt
+```
+
+## 目录结构
+
+```
+jy/
+├── SKILL.md              # 技能定义（含 YAML frontmatter）
+├── AGENTS.md             # 智能体叙事指南
+├── package.json          # pnpm 项目配置
+├── pnpm-lock.yaml        # pnpm 锁文件
+├── pnpm-workspace.yaml   # pnpm 构建白名单（esbuild）
+├── .npmrc                # pnpm 配置
+├── vite.config.ts        # Vite 8 + Vitest 配置
+├── tsconfig.json         # TypeScript 6
+├── .oxlintrc.json        # Oxlint
+├── .oxfmtrc.json         # Oxfmt
+├── scripts/
+│   ├── game-engine.ts    # 唯一 API 入口
+│   ├── game-logic.ts     # 核心公式
+│   ├── config-loader.ts  # assets 加载
+│   ├── persistence.ts    # 存档读写
+│   ├── validate-skill.ts # SKILL.md 格式校验
+│   ├── validate-assets.ts
+│   ├── validate-pack.ts
+│   ├── validate-versions.ts
+│   └── validate-docs.ts
+├── references/
+│   ├── agent-handbook.md # 智能体操作手册（规则/API/地图）
+│   ├── player-guide.md   # 玩家手册
+│   └── game-design.md
+├── assets/
+│   ├── characters/
+│   ├── skills.json
+│   ├── items.json
+│   ├── game-config.json
+│   └── templates.json
+└── save/
+    └── .gitkeep            # 运行时存档目录占位
+```
+
+## 许可
+
+MIT

package/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: jy
+description: >-
+  金庸群侠传对话式武侠 RPG：移动、NPC、商店、物品、武功、回合战斗、存档与新人引导。
+  Agent 须读 references/agent-handbook.md 掌握完整玩法与 API；玩家说 jy/开始游戏/帮助/金庸群侠传时使用。
+license: MIT
+metadata:
+  version: "0.3.0"
+disable-model-invocation: false
+---
+
+# 金庸群侠传 · 对话武侠 RPG
+
+独立 Cursor Agent Skill，自包含 `scripts/`、`assets/` 与存档。
+
+## 安装
+
+```bash
+npm install @sdd330dev/jy-skill --save-dev && npx jy-skill install
+```
+
+全局：`npm install -g @sdd330dev/jy-skill && jy-skill install --global`
+
+## 智能体必读
+
+**完整玩法、API、战斗循环、地图与禁忌** → [references/agent-handbook.md](references/agent-handbook.md)（操作手册，优先阅读）
+
+| 文档 | 读者 | 内容 |
+|------|------|------|
+| [agent-handbook.md](references/agent-handbook.md) | Agent | 规则、API、战斗、地图速查、错误清单 |
+| [AGENTS.md](AGENTS.md) | Agent | 武侠叙事、首登/帮助模板、输出格式 |
+| [player-guide.md](references/player-guide.md) | 玩家 | FAQ、地图、生存技巧 |
+| [game-design.md](references/game-design.md) | 开发 | 公式与设计细节 |
+
+**硬性约束**
+
+- 唯一 API：`scripts/game-engine.ts`；唯一公式：`scripts/game-logic.ts`
+- 禁止手改存档、禁止编造伤害/价格/地图连接
+- `moveTo` 返回 `encounter` 时**必须** `startBattle` 并打完
+- 每轮回复末尾附 `getStatus(state)` 状态栏
+
+## 何时使用
+
+玩家说「jy」「开始游戏」「金庸群侠传」，或以自然语言进行武侠冒险时加载本 skill。
+
+| 玩家说法 | Agent 动作 |
+|----------|------------|
+| jy / 开始游戏 | `loadOrCreateGame`；`isNewGame` 则首登引导（见 AGENTS.md） |
+| 帮助 / 怎么玩 | `getLocationInfo` + 帮助模板，勿堆砌 API 名 |
+| 重新开始 / 新游戏 | `restartGame()` |
+| 其他 | 解析意图 → 对应 API → 武侠叙述 + 状态栏 |
+
+## 快速开始
+
+```typescript
+import {
+  loadOrCreateGame,
+  createNewGame,
+  saveGameState,
+  moveTo,
+  startBattle,
+  attackEnemy,
+  enemyAttack,
+  isDead,
+  getStatus,
+  getLocationInfo,
+  restartGame,
+} from './scripts/game-engine'
+
+const { state, isNewGame } = loadOrCreateGame(createNewGame, '主角')
+
+const move = moveTo(state, '山洞')
+if (move.encounter) {
+  const { enemies } = startBattle(state, move.encounter)!
+  // 战斗循环见下文
+}
+
+saveGameState(state) // 可选，引擎已自动存档
+```
+
+## 每轮工作流
+
+1. **加载**：无 `state` 时 `loadOrCreateGame(createNewGame, '主角')`
+2. **执行**：按玩家意图调用 API（复合指令分步执行）
+3. **遇敌**：`moveTo` → `encounter?` → `startBattle` → 战斗循环
+4. **死亡**：`isDead` → 叙述结算 → `restartGame()`
+5. **输出**：武侠叙述 + `getStatus(state)` 状态栏
+
+## 玩家意图 → API
+
+| 意图 | API | 要点 |
+|------|-----|------|
+| 移动 / 随便走走 | `moveTo(state, dest)` | `dest='random'` 随机相邻；返回 `encounter?` |
+| 对话 | `talkTo(state, npc)` | NPC 名须精确；`'random'` 随机 |
+| 购买 | `buyItem(state, item)` | 仅当前地点商店 |
+| 使用 | `useItem(state, item)` | 无收益不消耗 |
+| 装备 | `equipItem(state, item)` | 武器/防具 |
+| 学武功 | `learnSkill(state, skill)` | 须存在于 assets |
+| 休息 | `rest(state)` | 满状态并解毒解伤 |
+| 战斗 | `startBattle` + 循环 | 见下节 |
+| 查看 | `getStatus` / `getInventory` / `getSkills` | |
+| 帮助 | `getLocationInfo` | 当前可为之事 |
+| 重开 | `restartGame(name?)` | 删档+新建+落盘 |
+
+## 战斗循环（必遵）
+
+```typescript
+const battle = startBattle(state, enemyName)
+if (!battle.success || !battle.enemies) return
+
+let enemies = battle.enemies
+
+while (enemies.some((e) => e.hp > 0) && !isDead(state)) {
+  const i = enemies.findIndex((e) => e.hp > 0)
+  attackEnemy(state, enemies, i)
+  // 或 useSkillInBattle(state, enemies, '基本拳法', i)
+
+  if (enemies.some((e) => e.hp > 0) && !isDead(state)) {
+    enemyAttack(state, enemies)
+  }
+}
+
+if (isDead(state)) {
+  // 死亡叙述 → restartGame()
+}
+```
+
+- `enemies` 仅存于内存，不写入存档
+- `targetIndex` 选第一个 `hp > 0` 的敌人
+- 伤害/经验以 API 为准，叙述时引用 `message`
+
+## 核心规则摘要
+
+| 系统 | 规则 |
+|------|------|
+| 移动 | 仅相邻地图；每次 -5 体力、+1 周；中毒/受伤每周掉血 |
+| 山洞遇敌 | 抵达后 20% 概率，敌人：山贼/强盗/老虎 |
+| 物品 | 满状态使用不扣物品；实际恢复量 ≤ 配置值 |
+| 升级 | 经验 = floor(100×1.5^(Lv-1))；上限 Lv.100 |
+| 伤害 | 武力+技能攻击-防御；±20% 波动；最低 1 |
+
+公式详见 [game-design.md](references/game-design.md) 与 `game-logic.ts`。
+
+## 输出格式
+
+```
+👤 角色名 | Lv.等级 | 经验: …
+❤️ hp/maxHp | 💠 mp/maxMp | ⚡ stamina/100
+💰 银两 | 📍 位置 | 📅 第N周
+```
+
+满级显示「经验: N（已满级）」；中毒/受伤时额外一行。
+
+## 交互示例
+
+**移动 + 遇敌 + 战斗**
+
+```
+玩家: "进山洞看看"
+→ moveTo(state, '山洞')  // 若 encounter='山贼'
+→ startBattle → 战斗循环 → getStatus
+```
+
+**复合操作**
+
+```
+玩家: "去平安镇买铁剑装备上"
+→ moveTo('平安镇') → buyItem('铁剑') → equipItem('铁剑')
+```
+
+**首登 / 帮助 / 重开** — 见 [AGENTS.md](AGENTS.md) 与 [agent-handbook.md](references/agent-handbook.md) 第 9 节。
+
+## API 索引
+
+| 类别 | 函数 |
+|------|------|
+| 存档 | `loadOrCreateGame`, `loadGameState`, `saveGameState`, `deleteSave`, `restartGame` |
+| 初始化 | `createNewGame` |
+| 查询 | `getStatus`, `getInventory`, `getSkills`, `getLocationInfo` |
+| 探索 | `moveTo`, `talkTo`, `rest` |
+| 物品 | `buyItem`, `useItem`, `equipItem`, `learnSkill` |
+| 战斗 | `startBattle`, `attackEnemy`, `useSkillInBattle`, `enemyAttack`, `isDead` |
+
+参数、返回值与失败原因 → [agent-handbook.md](references/agent-handbook.md) 第 5 节。
+
+## 数据与存档
+
+- 地图/NPC/商店/敌人：`assets/templates.json`（**勿编造**）
+- 武功/物品数值：`assets/skills.json`、`assets/items.json`
+- 存档：`save/game-state.json`（引擎原子写入，自动迁移旧档）
+
+## 目录
+
+```
+jy/
+├── SKILL.md
+├── AGENTS.md
+├── references/
+│   ├── agent-handbook.md   # Agent 操作手册（必读）
+│   ├── player-guide.md
+│   └── game-design.md
+├── scripts/
+│   ├── game-engine.ts      # 唯一 API
+│   ├── game-logic.ts
+│   ├── config-loader.ts
+│   └── persistence.ts
+└── assets/
+```

package/assets/characters/0.json

@@ -0,0 +1,56 @@
+{
+  "id": 0,
+  "name": "胡斐",
+  "sexual": 1,
+  "pic": 0,
+  "modelKey": "hufei",
+  "maxHp": 200,
+  "maxMp": 100,
+  "hpInc": 12,
+  "level": 1,
+  "exp": 0,
+  "mpType": 2,
+  "attack": 30,
+  "agility": 25,
+  "defence": 20,
+  "heal": 0,
+  "usePoison": 0,
+  "dePoison": 0,
+  "antiPoison": 0,
+  "fist": 10,
+  "sword": 20,
+  "blade": 30,
+  "exotic": 0,
+  "hiddenWeapon": 0,
+  "martialKnowledge": 10,
+  "attackPoison": 0,
+  "ambidextrous": 0,
+  "iq": 70,
+  "morality": 80,
+  "reputation": 10,
+  "weapon": 11,
+  "armor": 20,
+  "cultivationItem": 0,
+  "skills": [
+    [
+      1,
+      2
+    ],
+    [
+      2,
+      3
+    ]
+  ],
+  "items": [
+    [
+      1,
+      50
+    ],
+    [
+      30,
+      3
+    ]
+  ],
+  "leaveStoryId": "",
+  "source": "雪山飞狐"
+}

package/assets/characters/1.json

@@ -0,0 +1,60 @@
+{
+  "id": 1,
+  "name": "段誉",
+  "sexual": 1,
+  "pic": 1,
+  "modelKey": "duanyu",
+  "maxHp": 180,
+  "maxMp": 200,
+  "hpInc": 10,
+  "level": 1,
+  "exp": 0,
+  "mpType": 0,
+  "attack": 20,
+  "agility": 30,
+  "defence": 15,
+  "heal": 0,
+  "usePoison": 0,
+  "dePoison": 0,
+  "antiPoison": 0,
+  "fist": 30,
+  "sword": 40,
+  "blade": 0,
+  "exotic": 20,
+  "hiddenWeapon": 0,
+  "martialKnowledge": 20,
+  "attackPoison": 0,
+  "ambidextrous": 0,
+  "iq": 80,
+  "morality": 90,
+  "reputation": 20,
+  "weapon": 0,
+  "armor": 0,
+  "cultivationItem": 0,
+  "skills": [
+    [
+      3,
+      1
+    ],
+    [
+      4,
+      1
+    ],
+    [
+      5,
+      1
+    ]
+  ],
+  "items": [
+    [
+      1,
+      100
+    ],
+    [
+      30,
+      5
+    ]
+  ],
+  "leaveStoryId": "",
+  "source": "天龙八部"
+}