pi-jinyong-xia 1.0.0

package/dist/extensions/state.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 状态持久化
+ *
+ * 保存/加载侠客状态到 ~/.pi/agent/jinyong-xia-state.json
+ */
+import type { WuxueState } from "./wuxue.js";
+/** 已拥有的武功 */
+export interface OwnedSkill {
+    id: string;
+    level: number;
+    xp: number;
+}
+/** 任务风险等级 */
+export type RiskLevel = "safe" | "low" | "medium" | "high" | "extreme";
+/** 任务状态 */
+export type MissionStatus = "available" | "active" | "completed" | "failed" | "abandoned";
+/** 任务记录 */
+export interface MissionRecord {
+    id: string;
+    templateId: string;
+    name: string;
+    description: string;
+    risk: RiskLevel;
+    status: MissionStatus;
+    goldReward: number;
+    xpReward: number;
+    hpCost: number;
+    startedAt: number;
+    completedAt: number | null;
+    requiredPlanSteps: number;
+    completedPlanSteps: number;
+    planChoices: string[];
+}
+/** 任务偏好追踪 */
+export interface MissionPreferences {
+    totalCompleted: number;
+    totalFailed: number;
+    riskProfile: {
+        safe: number;
+        low: number;
+        medium: number;
+        high: number;
+        extreme: number;
+    };
+    favoriteType: string | null;
+    lastMissionAt: number;
+}
+export interface PetState {
+    version: number;
+    userId: string;
+    telemetryEnabled: boolean;
+    characterId: string | null;
+    nickname: string | null;
+    specialSkill: string | null;
+    specialSkillLevel: number;
+    specialSkillXp: number;
+    martialSkills: OwnedSkill[];
+    hidden: boolean;
+    weapon: string | null;
+    ownedWeapons: string[];
+    wuxue: WuxueState;
+    createdAt: number;
+    lastActiveAt: number;
+    SignPublicKey: string | null;
+    SignPrivateKey: string | null;
+    email: string | null;
+    missions: MissionRecord[];
+    missionPreferences: MissionPreferences;
+    factionId: string | null;
+    factionContribution: number;
+    joinedFactionAt: number | null;
+    professionId: string | null;
+    joinedProfessionAt: number | null;
+    talents: string[];
+    talentPoints: number;
+    lastTelemetryUpload: number;
+}
+/** Generate a stable OS-based user ID */
+export declare function generateUserId(): string;
+export declare function createInitialPetState(): PetState;
+/** Generate Ed25519 key pair for payload signing */
+export declare function generateSigningKeys(): {
+    publicKey: string;
+    privateKey: string;
+};
+/** Ensure signing keys exist, generating if needed */
+export declare function ensureSigningKeys(state: PetState): void;
+export declare function loadState(): PetState;
+export declare function saveState(state: PetState): void;

package/dist/extensions/state.js

@@ -0,0 +1,205 @@
+/**
+ * 状态持久化
+ *
+ * 保存/加载侠客状态到 ~/.pi/agent/jinyong-xia-state.json
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { homedir, hostname, userInfo, platform, arch } from "node:os";
+import { createHash, generateKeyPairSync } from "node:crypto";
+import { createInitialState, migrateSkills, getSkill } from "./wuxue.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// STATE FILE
+// ═══════════════════════════════════════════════════════════════════════════
+const STATE_VERSION = 9;
+/** Generate a stable OS-based user ID */
+export function generateUserId() {
+    try {
+        const raw = `${hostname()}:${userInfo().username}:${platform()}:${arch()}`;
+        return createHash("sha256").update(raw).digest("hex").substring(0, 16);
+    }
+    catch {
+        return createHash("sha256").update(`unknown:${Date.now()}`).digest("hex").substring(0, 16);
+    }
+}
+function getStatePath() {
+    return resolve(homedir(), ".pi", "agent", "jinyong-xia-state.json");
+}
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function createInitialPetState() {
+    return {
+        version: STATE_VERSION,
+        userId: generateUserId(),
+        telemetryEnabled: false,
+        characterId: null,
+        nickname: null,
+        specialSkill: null,
+        specialSkillLevel: 1,
+        specialSkillXp: 0,
+        martialSkills: [],
+        hidden: false,
+        weapon: "mu-jian",
+        ownedWeapons: ["mu-jian"],
+        wuxue: createInitialState(),
+        createdAt: Date.now(),
+        lastActiveAt: Date.now(),
+        SignPublicKey: null,
+        SignPrivateKey: null,
+        email: null,
+        missions: [],
+        missionPreferences: {
+            totalCompleted: 0,
+            totalFailed: 0,
+            riskProfile: { safe: 0, low: 0, medium: 0, high: 0, extreme: 0 },
+            favoriteType: null,
+            lastMissionAt: 0,
+        },
+        // 帮派
+        factionId: null,
+        factionContribution: 0,
+        joinedFactionAt: null,
+        // 职业
+        professionId: null,
+        joinedProfessionAt: null,
+        // 天赋
+        talents: [],
+        talentPoints: 0,
+        lastTelemetryUpload: 0,
+    };
+}
+/** Generate Ed25519 key pair for payload signing */
+export function generateSigningKeys() {
+    const { publicKey, privateKey } = generateKeyPairSync("ed25519");
+    // Export as base64 for JSON serialization
+    const pubB64 = publicKey.export({ type: "spki", format: "der" }).toString("base64");
+    const privB64 = privateKey.export({ type: "pkcs8", format: "der" }).toString("base64");
+    return { publicKey: pubB64, privateKey: privB64 };
+}
+/** Ensure signing keys exist, generating if needed */
+export function ensureSigningKeys(state) {
+    if (state.SignPublicKey && state.SignPrivateKey)
+        return;
+    const keys = generateSigningKeys();
+    state.SignPublicKey = keys.publicKey;
+    state.SignPrivateKey = keys.privateKey;
+}
+export function loadState() {
+    const path = getStatePath();
+    if (!existsSync(path)) {
+        return createInitialPetState();
+    }
+    try {
+        const raw = readFileSync(path, "utf8");
+        const state = JSON.parse(raw);
+        // Migration chain
+        if (!state.version || state.version < STATE_VERSION) {
+            const migrated = state;
+            delete migrated.mbti;
+            delete migrated.mbtiScores;
+            delete migrated.conversationTraits;
+            // v1→v2: weapons
+            if (!state.weapon)
+                state.weapon = "mu-jian";
+            if (!state.ownedWeapons)
+                state.ownedWeapons = ["mu-jian"];
+            if (state.characterId === undefined)
+                state.characterId = null;
+            // v2→v3: 单武功→多武功
+            if (!state.martialSkills)
+                state.martialSkills = [];
+            // 把旧的单武功字段迁移进新数组
+            if (state.martialSkills.length === 0 && state.specialSkill) {
+                const oldId = state.specialSkill;
+                const oldLevel = state.specialSkillLevel ?? 1;
+                const oldXp = state.specialSkillXp ?? 0;
+                // 验证旧 id 有效
+                if (getSkill(oldId)) {
+                    state.martialSkills.push({ id: oldId, level: oldLevel, xp: oldXp });
+                }
+            }
+            // 清理旧字段（保留以兼容，但不再使用）
+            // 验证所有武功 id 有效
+            state.martialSkills = state.martialSkills.filter((s) => getSkill(s.id));
+            // v3→v4: 血量与体力分离
+            if (state.wuxue) {
+                if (!('hp' in state.wuxue) || typeof state.wuxue.hp !== 'number' || isNaN(state.wuxue.hp)) {
+                    state.wuxue.hp = 100 + (state.wuxue.level - 1) * 10;
+                    state.wuxue.maxHp = 100 + (state.wuxue.level - 1) * 10;
+                }
+                if (typeof state.wuxue.maxHp !== 'number' || isNaN(state.wuxue.maxHp) || state.wuxue.maxHp <= 0) {
+                    state.wuxue.maxHp = 100 + (state.wuxue.level - 1) * 10;
+                    state.wuxue.hp = state.wuxue.maxHp;
+                }
+            }
+            // 清理旧单武功残留字段
+            delete state.specialSkill;
+            delete state.specialSkillLevel;
+            delete state.specialSkillXp;
+            // v5→v6: userId and telemetry
+            if (!state.userId)
+                state.userId = generateUserId();
+            if (state.telemetryEnabled === undefined)
+                state.telemetryEnabled = false;
+            // v6→v7: Ed25519 signing keys
+            if (!state.SignPublicKey) {
+                const keys = generateSigningKeys();
+                state.SignPublicKey = keys.publicKey;
+                state.SignPrivateKey = keys.privateKey;
+            }
+            // v7→v8: email, missions, mission preferences
+            if (!state.email)
+                state.email = null;
+            if (!state.missions)
+                state.missions = [];
+            if (!state.missionPreferences)
+                state.missionPreferences = {
+                    totalCompleted: 0, totalFailed: 0,
+                    riskProfile: { safe: 0, low: 0, medium: 0, high: 0, extreme: 0 },
+                    favoriteType: null, lastMissionAt: 0,
+                };
+            // v8→v9: faction, profession, talents
+            if (state.factionId === undefined)
+                state.factionId = null;
+            if (state.factionContribution === undefined)
+                state.factionContribution = 0;
+            if (state.joinedFactionAt === undefined)
+                state.joinedFactionAt = null;
+            if (state.professionId === undefined)
+                state.professionId = null;
+            if (state.joinedProfessionAt === undefined)
+                state.joinedProfessionAt = null;
+            if (!Array.isArray(state.talents))
+                state.talents = [];
+            if (state.talentPoints === undefined)
+                state.talentPoints = 0;
+            state.version = STATE_VERSION;
+        }
+        // Ensure wuxue has all fields (forward compat)
+        if (!state.wuxue)
+            state.wuxue = createInitialState();
+        const fresh = createInitialState();
+        for (const key of Object.keys(fresh)) {
+            if (state.wuxue[key] === undefined) {
+                state.wuxue[key] = fresh[key];
+            }
+        }
+        // 补齐老存档 skills 缺失的 element 等字段
+        migrateSkills(state.wuxue.skills);
+        return state;
+    }
+    catch {
+        return createInitialPetState();
+    }
+}
+export function saveState(state) {
+    state.lastActiveAt = Date.now();
+    const path = getStatePath();
+    ensureDir(path);
+    writeFileSync(path, JSON.stringify(state, null, 2), "utf8");
+}
+//# sourceMappingURL=state.js.map

package/dist/extensions/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../extensions/state.ts"],"names":[],"mappings":"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"}

package/dist/extensions/telemetry.d.ts

@@ -0,0 +1,179 @@
+/**
+ * 遥测上传模块 v2 — Cloudflare D1 后端
+ *
+ * 零 API Key：客户端直接 fetch 到 Worker 公开端点。
+ * 当 telemetryEnabled = true 时，定期上传用户游戏数据到云端。
+ */
+import type { PetState } from "./state.js";
+export interface TelemetryPayload {
+    userId: string;
+    characterId: string | null;
+    characterName: string | null;
+    level: number;
+    title: string;
+    gold: number;
+    totalXp: number;
+    totalEdits: number;
+    totalCommands: number;
+    totalTrainings: number;
+    martialSkills: string;
+    weapon: string | null;
+    achievements: string;
+    bossesDefeated: number;
+    createdAt: number;
+    lastActiveAt: number;
+    reportedAt: number;
+    version: string;
+    publicKey: string;
+    signature: string;
+    email: string | null;
+    mbtiType: string | null;
+    mbtiScores: string | null;
+    factionId: string | null;
+    factionContribution: number;
+    professionId: string | null;
+    talents: string;
+    talentPoints: number;
+}
+export interface LeaderboardEntry {
+    user_id: string;
+    character_name: string | null;
+    level: number;
+    title: string;
+    gold: number;
+    total_xp: number;
+    total_edits: number;
+    total_commands: number;
+    total_trainings: number;
+    martial_skills: string | null;
+    weapon: string | null;
+    achievements: string | null;
+    bosses_defeated: number;
+    last_active_at: number;
+    reported_at: number;
+}
+export interface LeaderboardResponse {
+    ok: boolean;
+    sort: string;
+    offset: number;
+    limit: number;
+    players: LeaderboardEntry[];
+}
+export interface PlayerDetail {
+    ok: boolean;
+    player: Record<string, unknown>;
+    rank: number;
+}
+export interface GlobalStats {
+    ok: boolean;
+    totalPlayers: number;
+    totalReports: number;
+    updatedAt: number;
+    topPlayers: Array<{
+        user_id: string;
+        character_name: string | null;
+        level: number;
+        title: string;
+        total_xp: number;
+    }>;
+    levelDistribution: Array<{
+        tier: string;
+        count: number;
+    }>;
+}
+/**
+ * 从 PetState 构建遥测上传数据
+ */
+export declare function buildTelemetryPayload(state: PetState, getCharacter: (id: string) => {
+    name: string;
+} | null, getLevelTitle: (level: number) => string, packageVersion: string): TelemetryPayload | null;
+/**
+ * 从 state 恢复上次上传时间（重启后调用一次）
+ */
+export declare function restoreLastUploadTime(state: {
+    lastTelemetryUpload?: number;
+}): void;
+/**
+ * 上传遥测数据到 Worker
+ */
+export declare function uploadTelemetry(payload: TelemetryPayload): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/**
+ * 条件上传：检查间隔后自动上传
+ */
+export declare function maybeUpload(state: PetState, getCharacter: (id: string) => {
+    name: string;
+} | null, getLevelTitle: (level: number) => string, packageVersion: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/**
+ * 获取排行榜
+ */
+export declare function fetchLeaderboard(sort?: "level" | "gold" | "edits" | "xp", limit?: number, offset?: number): Promise<LeaderboardResponse | null>;
+/**
+ * 获取 MBTI 性格匹配的真人玩家
+ */
+export declare function fetchMatch(userId: string): Promise<any>;
+/**
+ * 获取某玩家详情 + 排名
+ */
+export declare function fetchPlayerProfile(userId: string): Promise<PlayerDetail | null>;
+/**
+ * 获取全局统计
+ */
+export declare function fetchGlobalStats(): Promise<GlobalStats | null>;
+export interface ServerEncounterResult {
+    ok: boolean;
+    type: string;
+    name: string;
+    description: string;
+    goldAmount: number;
+    xpAmount: number;
+    hpChange?: number;
+    skillScrollId?: string;
+    weaponId?: string;
+    weaponName?: string;
+    itemId?: string;
+    itemName?: string;
+    location?: string;
+    battleResult?: string;
+    encounterChar?: string;
+}
+export interface ServerBossFightResult {
+    ok: boolean;
+    won: boolean;
+    bossName: string;
+    bossElement: string;
+    goldReward: number;
+    xpReward: number;
+    skillXpReward: number;
+    hpChange: number;
+    logs: Array<{
+        turn: number;
+        attacker: string;
+        damage: number;
+        selfDamage?: number;
+        elementBonus?: string;
+        isSkillHit?: boolean;
+        dice?: {
+            event: string;
+            desc: string;
+        };
+    }>;
+    error?: string;
+}
+/**
+ * 服务端生成遭遇 — 客户端不再本地生成
+ */
+export declare function serverEncounter(userId: string, level: number, weaponAtk: number, currentHp: number, maxHp: number): Promise<ServerEncounterResult | null>;
+/**
+ * 服务端 Boss 战斗 — 客户端不再本地计算
+ */
+export declare function serverBossFight(userId: string, level: number, weaponAtk: number, weaponElement: string, skillLevel: number, skillElement: string | undefined, bossId: string): Promise<ServerBossFightResult | null>;
+/**
+ * 获取公开配置（显示用途）
+ */
+export declare function fetchPublicConfig(): Promise<any>;