@sdd330dev/jy-skill 0.3.0

package/scripts/game-logic.ts

@@ -0,0 +1,153 @@
+/**
+ * 金庸群侠传 · 游戏核心公式
+ *
+ * 所有数值计算必须遵循此文件中的公式。
+ */
+
+// ============================================================================
+// 战斗系统
+// ============================================================================
+
+/**
+ * 计算战斗伤害
+ * 公式: 武力 + 技能攻击力 - 敌方防御
+ * 左右互搏: ×1.5
+ * 武学常识加成: +武学常识/10
+ * 随机波动: ±20%
+ */
+export function calculateDamage(
+  attackerAttack: number,
+  skillAttack: number,
+  defenderDefence: number,
+  ambidextrous: number = 0,
+  martialKnowledge: number = 0,
+  random: () => number = Math.random,
+): number {
+  let damage = attackerAttack + skillAttack - defenderDefence;
+
+  if (ambidextrous > 0) {
+    damage = Math.floor(damage * 1.5);
+  }
+
+  if (martialKnowledge > 0) {
+    damage += Math.floor(martialKnowledge / 10);
+  }
+
+  const randomFactor = 0.8 + random() * 0.4;
+  damage = Math.floor(damage * randomFactor);
+
+  return Math.max(1, damage);
+}
+
+/**
+ * 计算中毒掉血
+ * 公式: 中毒值 / 10
+ */
+export function calculatePoisonDamage(poison: number): number {
+  return Math.floor(poison / 10);
+}
+
+/**
+ * 计算受伤掉血
+ * 公式: 受伤值 / 20
+ */
+export function calculateHurtDamage(hurt: number): number {
+  return Math.floor(hurt / 20);
+}
+
+// ============================================================================
+// 角色系统
+// ============================================================================
+
+/**
+ * 计算升级所需经验
+ * 公式: floor(100 × 1.5^(等级-1))
+ */
+export function getExpForLevel(level: number): number {
+  return Math.floor(100 * Math.pow(1.5, level - 1));
+}
+
+/**
+ * 计算内力消耗
+ * 公式: 基础消耗 × ((等级+1)/2)
+ */
+export function calculateMpCost(baseCost: number, skillLevel: number): number {
+  return Math.floor(baseCost * ((skillLevel + 1) / 2));
+}
+
+/**
+ * 计算体力消耗
+ * 普通攻击: 3
+ * 用毒: 2
+ * 解毒: 2
+ * 医疗: 4
+ */
+export function calculateStaminaCost(damageType: string): number {
+  switch (damageType) {
+    case 'normal':
+    case 'absorbMp':
+      return 3;
+    case 'poison':
+    case 'depoison':
+      return 2;
+    case 'heal':
+      return 4;
+    default:
+      return 3;
+  }
+}
+
+/**
+ * 计算移动力
+ * 公式: 轻功/15 + 3
+ */
+export function calculateMovePoints(agility: number): number {
+  return Math.floor(agility / 15) + 3;
+}
+
+// ============================================================================
+// 默认属性
+// ============================================================================
+
+export const DEFAULT_ATTRIBUTES = {
+  maxHp: 100,
+  maxMp: 50,
+  hp: 100,
+  mp: 50,
+  hpInc: 5,
+  attack: 20,
+  agility: 15,
+  defence: 10,
+  heal: 0,
+  usePoison: 0,
+  dePoison: 0,
+  antiPoison: 0,
+  fist: 0,
+  sword: 0,
+  blade: 0,
+  exotic: 0,
+  hiddenWeapon: 0,
+  martialKnowledge: 0,
+  attackPoison: 0,
+  ambidextrous: 0,
+  iq: 50,
+  morality: 50,
+  reputation: 0,
+  stamina: 100,
+  poison: 0,
+  hurt: 0,
+  mpType: 'neutral',
+  level: 1,
+  exp: 0,
+};
+
+// ============================================================================
+// 常量
+// ============================================================================
+
+export const MAX_LEVEL = 100;
+export const MAX_SKILL_LEVEL = 10;
+export const MAX_STAMINA = 100;
+export const MAX_EXP = 9999999;
+export const MAX_TEAM_SIZE = 6;
+export const MAX_INVENTORY_SIZE = 100;

package/scripts/game-types.ts

@@ -0,0 +1,46 @@
+/**
+ * 游戏状态类型 — game-engine 与 persistence 共享
+ */
+
+import type { DEFAULT_ATTRIBUTES } from './game-logic';
+
+export interface Character {
+  name: string;
+  level: number;
+  exp: number;
+  hp: number;
+  maxHp: number;
+  mp: number;
+  maxMp: number;
+  stamina: number;
+  poison: number;
+  hurt: number;
+  attributes: typeof DEFAULT_ATTRIBUTES;
+  equipment: { weapon: string | null; armor: string | null };
+  skills: string[];
+  skillLevels: Record<string, number>;
+}
+
+export interface Inventory {
+  silver: number;
+  items: Array<{ id: string; name: string; count: number }>;
+}
+
+export interface GameState {
+  character: Character;
+  team: string[];
+  inventory: Inventory;
+  location: string;
+  week: number;
+  flags: Record<string, boolean | number>;
+  visitedMaps: string[];
+  completedQuests: string[];
+}
+
+export interface BattleEnemy {
+  name: string;
+  hp: number;
+  maxHp: number;
+  attack: number;
+  defence: number;
+}

package/scripts/install-skill.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/**
+ * 将 npm 包安装到 Cursor skills 目录（jy）
+ *
+ * jy-skill install [--global] [--copy] [--force]
+ */
+
+import { cpSync, existsSync, lstatSync, mkdirSync, rmSync, symlinkSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const SKILL_NAME = 'jy';
+
+function printHelp() {
+  console.log(`Usage: jy-skill install [options]
+
+Install @sdd330dev/jy-skill into Cursor skills directory as "${SKILL_NAME}".
+
+Options:
+  --global   Install to ~/.cursor/skills/${SKILL_NAME}
+  --copy     Copy files instead of symlink (default: symlink, fallback to copy)
+  --force    Overwrite existing installation
+  -h, --help Show this help
+`);
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  if (args.length === 0 || args.includes('-h') || args.includes('--help')) {
+    return { command: 'help' };
+  }
+  if (args[0] !== 'install') {
+    console.error(`Unknown command: ${args[0] ?? '(none)'}`);
+    printHelp();
+    process.exit(1);
+  }
+  return {
+    command: 'install',
+    global: args.includes('--global'),
+    copy: args.includes('--copy'),
+    force: args.includes('--force'),
+  };
+}
+
+function getTargetDir(global) {
+  if (global) {
+    return join(homedir(), '.cursor', 'skills', SKILL_NAME);
+  }
+  return join(process.cwd(), '.cursor', 'skills', SKILL_NAME);
+}
+
+function removeExisting(targetDir) {
+  if (!existsSync(targetDir)) return;
+  const stat = lstatSync(targetDir);
+  if (stat.isSymbolicLink() || stat.isDirectory()) {
+    rmSync(targetDir, { recursive: true, force: true });
+    return;
+  }
+  rmSync(targetDir, { force: true });
+}
+
+function installWithSymlink(targetDir) {
+  mkdirSync(dirname(targetDir), { recursive: true });
+  symlinkSync(PACKAGE_ROOT, targetDir, 'dir');
+}
+
+function installWithCopy(targetDir) {
+  mkdirSync(dirname(targetDir), { recursive: true });
+  cpSync(PACKAGE_ROOT, targetDir, {
+    recursive: true,
+    filter: (src) => !src.includes(`${join(PACKAGE_ROOT, 'node_modules')}`),
+  });
+  mkdirSync(join(targetDir, 'save'), { recursive: true });
+}
+
+function install(options) {
+  const targetDir = getTargetDir(options.global);
+
+  if (existsSync(targetDir) && !options.force) {
+    console.error(`Already installed at ${targetDir}`);
+    console.error('Use --force to overwrite.');
+    process.exit(1);
+  }
+
+  if (existsSync(targetDir)) {
+    removeExisting(targetDir);
+  }
+
+  if (options.copy) {
+    installWithCopy(targetDir);
+    console.log(`Copied skill to ${targetDir}`);
+  } else {
+    try {
+      installWithSymlink(targetDir);
+      console.log(`Linked skill to ${targetDir}`);
+    } catch {
+      installWithCopy(targetDir);
+      console.log(`Symlink failed; copied skill to ${targetDir}`);
+    }
+  }
+
+  console.log('');
+  console.log('Next: open the project in Cursor and say「jy」or「开始游戏」.');
+}
+
+const options = parseArgs(process.argv);
+
+if (options.command === 'help') {
+  printHelp();
+  process.exit(0);
+}
+
+install(options);

package/scripts/persistence.ts

@@ -0,0 +1,135 @@
+/**
+ * 游戏存档持久化 — save/game-state.json
+ */
+
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  unlinkSync,
+  writeFileSync,
+} from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import type { GameState } from './game-types';
+import { DEFAULT_ATTRIBUTES, MAX_STAMINA } from './game-logic';
+import { getMap, getTemplates, initConfigs } from './config-loader';
+
+export interface LoadGameResult {
+  state: GameState;
+  isNewGame: boolean;
+}
+
+const ROOT_DIR = join(dirname(fileURLToPath(import.meta.url)), '..');
+const SAVE_DIR = join(ROOT_DIR, 'save');
+const SAVE_FILE = join(SAVE_DIR, 'game-state.json');
+const SAVE_TMP = join(SAVE_DIR, 'game-state.json.tmp');
+
+export function getSavePath(): string {
+  return SAVE_FILE;
+}
+
+function isValidGameState(raw: unknown): raw is GameState {
+  if (!raw || typeof raw !== 'object') return false;
+  const state = raw as GameState;
+  if (!state.character?.name || typeof state.location !== 'string') return false;
+  if (!state.inventory || typeof state.inventory.silver !== 'number') return false;
+  if (!Array.isArray(state.inventory.items)) return false;
+  if (typeof state.week !== 'number') return false;
+  return true;
+}
+
+/** 补全旧存档缺失字段 */
+function migrateGameState(state: GameState): GameState {
+  initConfigs();
+
+  if (!Array.isArray(state.character.skills)) {
+    state.character.skills = [...(getTemplates().defaultCharacter.skills ?? ['基本拳法'])];
+  }
+  if (!state.character.skillLevels) {
+    state.character.skillLevels = Object.fromEntries(state.character.skills.map((s) => [s, 0]));
+  }
+  if (!state.character.attributes || typeof state.character.attributes !== 'object') {
+    state.character.attributes = { ...DEFAULT_ATTRIBUTES };
+  } else {
+    state.character.attributes = { ...DEFAULT_ATTRIBUTES, ...state.character.attributes };
+  }
+  if (!state.character.equipment) {
+    state.character.equipment = { weapon: null, armor: null };
+  }
+  if (!Array.isArray(state.team)) {
+    state.team = [];
+  }
+  if (!state.flags || typeof state.flags !== 'object') {
+    state.flags = {};
+  }
+  if (!Array.isArray(state.visitedMaps)) {
+    state.visitedMaps = [state.location];
+  }
+  if (!Array.isArray(state.completedQuests)) {
+    state.completedQuests = [];
+  }
+
+  const c = state.character;
+  if (typeof c.maxHp !== 'number') c.maxHp = DEFAULT_ATTRIBUTES.maxHp;
+  if (typeof c.maxMp !== 'number') c.maxMp = DEFAULT_ATTRIBUTES.maxMp;
+  c.hp = Math.max(0, Math.min(c.maxHp, c.hp));
+  c.mp = Math.max(0, Math.min(c.maxMp, c.mp));
+  c.stamina = Math.max(0, Math.min(MAX_STAMINA, c.stamina));
+  c.poison = Math.max(0, c.poison);
+  c.hurt = Math.max(0, c.hurt);
+
+  if (!getMap(state.location)) {
+    state.location = getTemplates().startLocation ?? '小村';
+  }
+
+  return state;
+}
+
+/** 读取存档；不存在或损坏时返回 null */
+export function loadGameState(): GameState | null {
+  if (!existsSync(SAVE_FILE)) return null;
+
+  try {
+    const raw = readFileSync(SAVE_FILE, 'utf-8');
+    const parsed: unknown = JSON.parse(raw);
+    if (!isValidGameState(parsed)) {
+      return null;
+    }
+    return migrateGameState(parsed);
+  } catch {
+    return null;
+  }
+}
+
+/** 写入存档（原子替换，避免写入中断损坏） */
+export function saveGameState(state: GameState): void {
+  if (!existsSync(SAVE_DIR)) {
+    mkdirSync(SAVE_DIR, { recursive: true });
+  }
+  writeFileSync(SAVE_TMP, JSON.stringify(state, null, 2), 'utf-8');
+  renameSync(SAVE_TMP, SAVE_FILE);
+}
+
+/** 删除存档 */
+export function deleteSave(): void {
+  if (existsSync(SAVE_FILE)) {
+    unlinkSync(SAVE_FILE);
+  }
+  if (existsSync(SAVE_TMP)) {
+    unlinkSync(SAVE_TMP);
+  }
+}
+
+/** 开始或继续：有存档则加载，否则新建并落盘 */
+export function loadOrCreateGame(
+  createNewGame: (name: string) => GameState,
+  name = '主角',
+): LoadGameResult {
+  const existing = loadGameState();
+  if (existing) return { state: existing, isNewGame: false };
+  const state = createNewGame(name);
+  saveGameState(state);
+  return { state, isNewGame: true };
+}