dsh-piggy 0.25.0

package/packages/pet-core/src/core/upgrades.js

@@ -0,0 +1,193 @@
+// @ts-check
+/**
+ * 存档的逐级升级：每改一次存档结构，就在 UPGRADES 末尾加一级。
+ *
+ * migrate() 先按版本号把原始存档一级一级升到最新，再做字段清洗。
+ * 一级只做一件事、只认上一级的形状，这样老存档跨多个版本升级时，
+ * 每一步都和当初写它的时候一样确定。
+ *
+ * 加一级的步骤：
+ *   1. 在 UPGRADES 末尾追加 `{ to: N, why, up(raw) }`，`up` 返回新对象，不改入参
+ *   2. STATE_VERSION 改成 N（constants.js）
+ *   3. 补一条迁移测试，用升级前的真实形状做样本
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/upgrades
+ */
+
+/**
+ * @typedef {object} Upgrade
+ * @property {number} to - 升级后的版本号
+ * @property {string} why - 这一级改了什么，写给以后读代码的人
+ * @property {(raw: Record<string, unknown>, nowMs: number) => Record<string, unknown>} up
+ */
+
+import { roll } from './random.js'
+
+/*
+ * The curves below are frozen copies of what each version used. An upgrade
+ * must keep meaning what it meant when it was written, even after the live
+ * tables in data/ change again.
+ */
+const v8LevelFloor = level => (level <= 1 ? 0 : 20 * level * (level - 1))
+const v9LevelFloor = level => (level <= 1 ? 0 : 122 * level * level)
+const V9_MAX_LEVEL = 60
+
+/**
+ * v11: the 23 subjects of the old seven-stage ladder, folded into the nine
+ * QQ Pet subjects (B4 sheet §6). 礼仪 and 武术 had no old counterpart.
+ */
+const V11_SUBJECT_OF = Object.freeze({
+  literacy: 'chinese', chinese: 'chinese', english: 'chinese', history: 'chinese', philosophy: 'chinese',
+  mathematics: 'mathematics', science: 'mathematics', physics: 'mathematics', chemistry: 'mathematics',
+  biology: 'mathematics', it: 'mathematics', economics: 'mathematics', go: 'mathematics',
+  politics: 'politics', geography: 'politics',
+  sing: 'music', piano: 'music',
+  doodle: 'art', painting: 'art', art: 'art',
+  pe: 'pe', football: 'pe',
+  engineering: 'labour',
+})
+
+/** v11: what each job of the old table paid, for a shift still in progress. */
+const V11_OLD_JOB_PAY = Object.freeze({
+  odd: 30, dish: 70, site: 260, foreman: 700, street: 200,
+  tutor: 480, office: 900, manager: 2200, researcher: 4000,
+})
+
+/** v10 refund for each retired generic medicine: the new price of the same tier. */
+const V10_REFUND = Object.freeze({ med1: 30, med2: 70, med3: 140, med4: 260 })
+
+function levelOnCurve(xp, floorOf, cap) {
+  let level = 1
+  while (level < cap && xp >= floorOf(level + 1)) level += 1
+  return level
+}
+
+/**
+ * Carry an old xp total onto the v9 growth curve: same level, same fraction of
+ * the way to the next one. Lv8 at 40% stays Lv8 at 40%.
+ */
+function growthFromV8Xp(xp) {
+  const value = Number.isFinite(xp) && xp > 0 ? xp : 0
+  const level = levelOnCurve(value, v8LevelFloor, 999)
+  if (level >= V9_MAX_LEVEL) return v9LevelFloor(V9_MAX_LEVEL)
+  const floor = v8LevelFloor(level)
+  const fraction = Math.min(1, (value - floor) / Math.max(1, v8LevelFloor(level + 1) - floor))
+  const nextFloor = v9LevelFloor(level + 1)
+  return Math.round(v9LevelFloor(level) + fraction * (nextFloor - v9LevelFloor(level)))
+}
+
+/** The v9 body for a level: 幼年 from Lv1, 青年 from Lv10, 成年 from Lv40. */
+const v9StageFor = level => (level >= 40 ? 'middle' : level >= 10 ? 'young' : 'piglet')
+
+/** @type {ReadonlyArray<Upgrade>} */
+export const UPGRADES = Object.freeze([
+  Object.freeze({
+    to: 8,
+    why: 'hatched 不再由 xp 推断：没拆的纸盒也会吃到经验，重启后会被误当成已孵化',
+    up(raw) {
+      // Only saves from before the flag existed get the old inference; a save
+      // that recorded `hatched: false` meant it, whatever its xp says.
+      if (typeof raw.hatched === 'boolean') return { ...raw, version: 8 }
+      return { ...raw, version: 8, hatched: typeof raw.xp === 'number' && raw.xp > 0 }
+    },
+  }),
+  Object.freeze({
+    to: 9,
+    why: 'B2 成长：xp 改为成长值、按新曲线折算（等级和进度不变）；形态改由等级决定、去掉老年；补性别',
+    up(raw) {
+      const next = { ...raw, version: 9, xp: growthFromV8Xp(raw.xp) }
+      if (next.hatched === true && next.dead !== true) {
+        next.stage = v9StageFor(levelOnCurve(next.xp, v9LevelFloor, V9_MAX_LEVEL))
+      } else if (next.stage === 'elder') {
+        next.stage = 'middle'
+      }
+      if (next.hatched === true && next.sex !== 'boy' && next.sex !== 'girl') {
+        next.sex = roll(next) < 0.5 ? 'boy' : 'girl'
+      }
+      return next
+    },
+  }),
+  Object.freeze({
+    to: 10,
+    why: 'B3 疾病：四种通用药下架、按新同级药价退金币；病的必病计时 riskMinutes 换成连续外出计数',
+    up(raw) {
+      const next = { ...raw, version: 10 }
+      const bag = raw.inventory !== null && typeof raw.inventory === 'object' ? { ...raw.inventory } : {}
+      let refund = 0
+      for (const [key, price] of Object.entries(V10_REFUND)) {
+        const count = Number.isFinite(bag[key]) ? Math.max(0, Math.floor(bag[key])) : 0
+        refund += count * price
+        delete bag[key]
+      }
+      next.inventory = bag
+      next.coins = (Number.isFinite(raw.coins) ? raw.coins : 0) + refund
+      delete next.riskMinutes
+      next.outingStreak = 0
+      next.restMinutes = 0
+      return next
+    },
+  }),
+  Object.freeze({
+    to: 11,
+    why: 'B4 学习→职业：23 门课按对照表并进九门课的课时；旧职业表里在打的工按旧报酬结算',
+    up(raw) {
+      const next = { ...raw, version: 11 }
+      const lessons = raw.lessons !== null && typeof raw.lessons === 'object' ? { ...raw.lessons } : {}
+      const courses = raw.courses !== null && typeof raw.courses === 'object' ? raw.courses : {}
+      for (const [oldKey, count] of Object.entries(courses)) {
+        const into = V11_SUBJECT_OF[oldKey]
+        if (into === undefined || !Number.isFinite(count) || count <= 0) continue
+        lessons[into] = (lessons[into] ?? 0) + Math.floor(count)
+      }
+      next.lessons = lessons
+      delete next.courses
+      delete next.coursesByStage
+      delete next.lessonsByStage
+      // v3 saves kept a shift under `work: { job }`; migrate() lifts it later.
+      const legacyWork = raw.work !== null && typeof raw.work === 'object' ? { kind: 'work', key: raw.work.job, ...raw.work } : null
+      const activity = raw.activity ?? legacyWork
+      if (activity !== null && typeof activity === 'object') {
+        if (activity.kind === 'study') {
+          // Same lesson, new subject name; the stage is decided afresh.
+          const into = V11_SUBJECT_OF[activity.key] ?? activity.key
+          next.activity = { ...activity, key: into, stage: undefined }
+        } else if (activity.kind === 'work' && V11_OLD_JOB_PAY[activity.key] !== undefined) {
+          const minutes = Math.max(0, Math.round((activity.endsAt - activity.startedAt) / 60000))
+          next.activity = { ...activity, legacyCoins: V11_OLD_JOB_PAY[activity.key], minutes }
+        }
+      }
+      return next
+    },
+  }),
+  Object.freeze({
+    to: 12,
+    why: '加冕形态单独存成 form（普通猪是 null）；PR #2 早期版本存的 finalForm 改名过来',
+    up(raw) {
+      const next = { ...raw, version: 12 }
+      next.form = typeof raw.form === 'string' ? raw.form : typeof raw.finalForm === 'string' ? raw.finalForm : null
+      delete next.finalForm
+      return next
+    },
+  }),
+])
+
+/** The oldest version the step table starts from; earlier saves are cleaned by migrate() alone. */
+export const FIRST_UPGRADE_FROM = 7
+
+/**
+ * Run every upgrade the save has not had yet.
+ * @param {Record<string, unknown>} raw
+ * @param {number} nowMs
+ * @returns {Record<string, unknown>}
+ */
+export function applyUpgrades(raw, nowMs) {
+  const onDisk = typeof raw.version === 'number' && Number.isFinite(raw.version) ? raw.version : 0
+  // Saves older than the table were shaped by migrate()'s field cleaning; they
+  // enter the table as if they were the version it starts from.
+  let current = onDisk < FIRST_UPGRADE_FROM ? { ...raw, version: FIRST_UPGRADE_FROM } : raw
+  for (const upgrade of UPGRADES) {
+    if (/** @type {number} */ (current.version) < upgrade.to) current = upgrade.up(current, nowMs)
+  }
+  return current
+}

package/packages/pet-core/src/core/views.js

@@ -0,0 +1,55 @@
+// @ts-check
+/**
+ * 派生视图（属性/心情/血条）。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/views
+ */
+
+import { GRAVE, JOBS, LIFE_STAGES, MAX, REVIVE_ITEM, SCHOOL_STAGES, SHOP, SLEEPY_AFTER_MINUTES, SOUL, SOUL_AFTER_DAYS, SUBJECTS, THRESHOLDS, TRAITS, TRAIT_ORDER, TRIPS } from '../data.js'
+import { AWAY_MOODS, DIET } from './constants.js'
+import { clamp, clamp100 } from './effects.js'
+import { currentIllness, decay } from './settlement.js'
+
+/** Trait totals, always including every trait. */
+export function traitView(state) {
+  const out = {}
+  for (const key of TRAIT_ORDER) out[key] = state.traits?.[key] ?? 0
+  return out
+}
+
+export function mood(state, nowMs) {
+  decay(state, nowMs)
+  if (state.dead) return { key: 'dead', emoji: '💀', label: '已经走了' }
+  if (state.illness !== null) {
+    const ill = currentIllness(state)
+    return { key: 'sick', emoji: '🤒', label: ill === null ? '生病了' : `得了${ill.name}` }
+  }
+  if (state.activity !== null) {
+    const base = AWAY_MOODS[state.activity.kind] ?? AWAY_MOODS.work
+    return { ...base, emoji: state.activity.emoji || base.emoji }
+  }
+  if (state.satiety < THRESHOLDS.hungry) return { key: 'hungry', emoji: '🍎', label: '饿了' }
+  if (state.cleanliness < THRESHOLDS.dirty) return { key: 'dirty', emoji: '🫧', label: '该洗澡了' }
+  if (nowMs - state.lastActiveAt > SLEEPY_AFTER_MINUTES * 60000) return { key: 'sleepy', emoji: '💤', label: '睡着了' }
+  if (state.happiness >= 75) return { key: 'happy', emoji: '❤️', label: '很开心' }
+  if (state.happiness < THRESHOLDS.lonely) return { key: 'lonely', emoji: '🥺', label: '有点孤单' }
+  return { key: 'fine', emoji: '😊', label: '还不错' }
+}
+
+export const healthPercent = state => Math.round((clamp(state.health, 0, MAX.health) / MAX.health) * 100)
+
+// ---------------------------------------------------------------------------
+// Display helpers
+// ---------------------------------------------------------------------------
+
+export const formatWeight = weightG => `${(weightG / 1000).toFixed(1)} kg`
+
+export function bar(value, width = 10) {
+  const filled = Math.round((clamp100(value) / 100) * width)
+  return `${'▓'.repeat(filled)}${'░'.repeat(width - filled)}`
+}
+
+export { JOBS, SHOP, MAX, THRESHOLDS, REVIVE_ITEM, SUBJECTS, SCHOOL_STAGES, TRIPS, TRAITS, TRAIT_ORDER }
+export { LIFE_STAGES, GRAVE, SOUL, SOUL_AFTER_DAYS }
+export { DIET }

package/packages/pet-core/src/core/work.js

@@ -0,0 +1,50 @@
+// @ts-check
+/**
+ * 打工。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/work
+ */
+
+import { TRAITS, jobByKey, jobRequirement, traitBonus } from '../data.js'
+import { begin } from './activity.js'
+import { levelFor } from './clock.js'
+import { TOO_WEAK_HEALTH } from './constants.js'
+import { remember } from './effects.js'
+
+/**
+ * What a job's gate looks at: level, lessons per subject, 兴趣课 counts (B4).
+ * @param {object} state
+ */
+export function jobFacts(state) {
+  return { level: levelFor(state.xp), lessons: state.lessons ?? {}, interests: state.interests ?? {} }
+}
+
+export function startWork(state, jobKey, nowMs) {
+  const job = jobByKey(jobKey)
+  if (job === null) return { ok: false, reason: 'unknown' }
+  if (state.hatched !== true) return { ok: false, reason: 'box' }
+  if (state.dead) return { ok: false, reason: 'dead' }
+  if (state.activity !== null) return { ok: false, reason: 'away' }
+  if (state.health <= TOO_WEAK_HEALTH) return { ok: false, reason: 'weak' }
+  // The gate is checked before the pig walks out: an unqualified job is refused
+  // with everything it is short on (level, lessons, certificate).
+  const gate = jobRequirement(job, jobFacts(state))
+  if (gate !== null && !gate.ok) {
+    return { ok: false, reason: 'underqualified', missing: gate.missing, job: job.key }
+  }
+  if (state.satiety < 15) return { ok: false, reason: 'hungry' }
+  // The pig's trait shortens the shift; the pay bonus is applied on the way out.
+  const points = state.traits?.[job.trait] ?? 0
+  const bonus = traitBonus(job.trait, points)
+  const minutes = Math.max(1, Math.round(job.minutes * bonus.minutes))
+  const result = begin(state, {
+    kind: 'work', key: job.key, label: job.label, emoji: job.emoji, minutes, cost: 0,
+    trait: job.trait ?? null,
+  }, nowMs)
+  if (result.ok) {
+    const saved = job.minutes - minutes
+    remember(state, `${job.emoji} 出门${job.label}去了${saved > 0 ? `（${TRAITS[job.trait].label} ${points}，省了 ${saved} 分钟）` : ''}`, nowMs)
+  }
+  return result
+}

package/packages/pet-core/src/core.js

@@ -0,0 +1,95 @@
+// @ts-check
+/**
+ * dsh-piggy · core — the pure pig model.
+ *
+ * No IO, no ctx, no clock of its own: every function takes the current time as
+ * a parameter, so the whole game model is testable in isolation. Nothing here
+ * schedules a timer — shifts, courses, trips, illness progression and decay are
+ * all resolved lazily from timestamps, which is why the pig survives restarts
+ * and why the tests never have to wait.
+ *
+ * Three ways the pig changes:
+ *   - `feed()`  digests a *passive* harness event (a turn ended, a tool ran)
+ *   - `act()`   applies a *deliberate* care action (feed it, bathe it, play)
+ *   - `buy()` / `useItem()` / `start*()` drive the game loop
+ *
+ * Time away from the desk is one concept, not three: work, study and travel all
+ * become a single `activity` record, so "is the pig home?" has exactly one
+ * answer and `decay()` has exactly one place to settle it.
+ *
+ * @module dsh-piggy/core
+ */
+
+import {
+  AWAY_MULTIPLIER,
+  CARE_KIND,
+  DEFAULT_TOY,
+  GRAVE,
+  LIFE_STAGES,
+  SOUL,
+  SOUL_AFTER_DAYS,
+  ILLNESS_CHAINS,
+  DAYS_PER_MONTH,
+  DEFAULT_TIME_SCALE,
+  LEVEL_TITLES,
+  illnessStageMs,
+  xpForLevel,
+  traitBonus,
+  SELF_HEAL_CHANCE,
+  SICK_AWAY_MULTIPLIER,
+  SICK_PAY_MULTIPLIER,
+  JOBS,
+  KIND_ORDER,
+  MAX,
+  REVIVE_ITEM,
+  SCHOOL_STAGES,
+  SHOP,
+  SLEEPY_AFTER_MINUTES,
+  SOUVENIR_RARITY,
+  STAGE_HEALTH,
+  SUBJECTS,
+  THRESHOLDS,
+  TRAITS,
+  TRAIT_ORDER,
+  TRIPS,
+  illnessAt,
+  interestByKey,
+  INTERESTS,
+  dressSlotByKey,
+  itemByKey,
+  jobByKey,
+  jobRequirement,
+  careItems,
+  nextIllness,
+  rarityByKey,
+  schoolStageByKey,
+  subjectByKey,
+  tripByKey,
+} from './data.js'
+
+export { ACTIONS, ACTION_ORDER, STATE_VERSION } from './core/constants.js'
+export { drainPending } from './core/effects.js'
+export { ageDays, ageMonths, dayKeyFor, daysToNextStage, hasSoul, levelFor, levelProgress, levelTitle, lifeStageFor, nextLifeStage } from './core/clock.js'
+export { careFactor, grow, growFromRealWork, outingGrowth } from './core/growth.js'
+export { hatch, hatchEgg, layEgg } from './core/egg.js'
+export { adopt, ageFromNow, applyDevPatch, inherit, rename, reset, revive, setTimeScale } from './core/state.js'
+export { migrate } from './core/migrate.js'
+export { assignPersonality, ensureProfile, profileView, setCatchphrase, setMotto, zodiacFor } from './core/profile.js'
+export { crown, formStageView, formsView } from './core/evolution.js'
+export { chat, pickLine, replyToLine, say, setOwnerName, setQuiet } from './core/lines.js'
+export { canSignIn, dailyView, emptyDaily, ensureDaily, giftsWaiting, grantReward, openGift, pickGift, recordOnline, signIn } from './core/daily.js'
+export { composeDiary, diaryView, emptyDiary, ensureDiary, noteToday, writeDiaryIfNewDay } from './core/diary.js'
+export { currentIllness, decay } from './core/settlement.js'
+export { doctorFee, onsetRisks, seeDoctor } from './core/illness.js'
+export { activitySecondsLeft, awayBlockedReason, callOffActivity, callOffWork, canStartActivity, canWork, workSecondsLeft } from './core/activity.js'
+export { act, actionCooldownSeconds, actionReady, canFeed, careOptions, careView, feed, feedCooldownSeconds } from './core/care.js'
+export { buy, canAfford, dressView, grantAll, inventoryView, takeOff, useItem, wearItem } from './core/inventory.js'
+export { courseView, startStudy, studyView } from './core/school.js'
+export { jobFacts } from './core/work.js'
+export { interestView, startInterest } from './core/interests.js'
+export { startWork } from './core/work.js'
+export { sellSouvenir, startTrip } from './core/travel.js'
+export { bar, formatWeight, healthPercent, mood, traitView } from './core/views.js'
+export { JOBS, MAX, REVIVE_ITEM, SCHOOL_STAGES, SHOP, SUBJECTS, THRESHOLDS, TRAITS, TRAIT_ORDER, TRIPS } from './data.js'
+export { GRAVE, LIFE_STAGES, MAX_LEVEL, SOUL, SOUL_AFTER_DAYS } from './data.js'
+export { DIET } from './core/constants.js'

package/packages/pet-core/src/data/daily.js

@@ -0,0 +1,121 @@
+// @ts-check
+/**
+ * 日常玩法：签到 12 天、在线礼包、宠物日记的数值与文案。
+ *
+ * 数值以 docs/tasks/numbers/B5-daily.md（用户 2026-10-01 确认）为准 —— 不要随手改，
+ * 觉得不合理就写进任务卡等人拍板。零逻辑、零 IO（见 docs/CONVENTIONS.md）。
+ *
+ * @module dsh-piggy/data/daily
+ */
+
+/**
+ * 一签的奖励：金币和/或物品。物品按 `key` 进背包，key 对不上货架也照发
+ * （B3 的药可能还没上架）。
+ * @typedef {object} DailyReward
+ * @property {number} coins
+ * @property {ReadonlyArray<{ key: string, count: number }>} items
+ */
+
+/**
+ * 12 天签到礼包，价值由低到高：第 8 天是还魂丹，第 12 天是豪华大餐。
+ * 领完第 12 天回到第 1 天；断签不清零。
+ * @type {ReadonlyArray<DailyReward>}
+ */
+export const SIGN_IN_REWARDS = Object.freeze([
+  Object.freeze({ coins: 0, items: Object.freeze([Object.freeze({ key: 'apple', count: 3 })]) }),
+  Object.freeze({ coins: 50, items: Object.freeze([]) }),
+  Object.freeze({ coins: 0, items: Object.freeze([
+    Object.freeze({ key: 'soap', count: 3 }),
+    Object.freeze({ key: 'bread', count: 2 }),
+  ]) }),
+  Object.freeze({ coins: 100, items: Object.freeze([]) }),
+  Object.freeze({ coins: 0, items: Object.freeze([
+    Object.freeze({ key: 'plush', count: 1 }),
+    Object.freeze({ key: 'rice', count: 2 }),
+  ]) }),
+  Object.freeze({ coins: 0, items: Object.freeze([
+    Object.freeze({ key: 'banlangen', count: 1 }),
+    Object.freeze({ key: 'xiaoshipian', count: 1 }),
+    Object.freeze({ key: 'pipa-syrup', count: 1 }),
+  ]) }),
+  Object.freeze({ coins: 200, items: Object.freeze([]) }),
+  Object.freeze({ coins: 0, items: Object.freeze([Object.freeze({ key: 'soul', count: 1 })]) }),
+  Object.freeze({ coins: 0, items: Object.freeze([
+    Object.freeze({ key: 'bubble', count: 3 }),
+    Object.freeze({ key: 'skewer', count: 2 }),
+  ]) }),
+  Object.freeze({ coins: 300, items: Object.freeze([]) }),
+  Object.freeze({ coins: 0, items: Object.freeze([Object.freeze({ key: 'baicaodan', count: 1 })]) }),
+  Object.freeze({ coins: 500, items: Object.freeze([
+    Object.freeze({ key: 'feast', count: 2 }),
+    Object.freeze({ key: 'deadsea', count: 2 }),
+    Object.freeze({ key: 'carousel', count: 1 }),
+  ]) }),
+])
+
+/** 签到一轮多少天。 */
+export const SIGN_IN_CYCLE = SIGN_IN_REWARDS.length
+
+/**
+ * 在线礼包：只算真实时间，不受调试页的时间倍率影响。
+ * 「在线」= 面板在轮询，两次轮询间隔不超过 `pollGapMaxMs`。
+ */
+export const ONLINE_GIFT = Object.freeze({
+  /** 每在线满这么久给一个。 */
+  perGiftMs: 60 * 60 * 1000,
+  /** 每天最多几个（06:00 刷新）。 */
+  perDay: 8,
+  /** 没领的最多攒几个，攒满就不再给。 */
+  unclaimedMax: 3,
+  /** 两次轮询间隔超过这个值，中间那段不算在线。 */
+  pollGapMaxMs: 30 * 1000,
+})
+
+/**
+ * 礼包内容概率表：每个礼包从下表抽一项。
+ * `kind` + `maxPrice` 从货架上现取（B3/B4 上架新物品后自动进池子），
+ * `keys` 是点名要的固定几样。
+ * @type {ReadonlyArray<{ chance: number, kind?: string, kinds?: ReadonlyArray<string>, maxPrice?: number,
+ *   coins?: ReadonlyArray<number>, keys?: ReadonlyArray<string> }>}
+ */
+export const GIFT_TABLE = Object.freeze([
+  Object.freeze({ chance: 0.40, kind: 'food', maxPrice: 40 }),
+  Object.freeze({ chance: 0.25, kinds: Object.freeze(['bath', 'toy']), maxPrice: 60 }),
+  Object.freeze({ chance: 0.20, coins: Object.freeze([30, 80]) }),
+  Object.freeze({ chance: 0.10, kind: 'medicine', maxPrice: 30 }),
+  Object.freeze({ chance: 0.04, keys: Object.freeze(['feast', 'carousel', 'bubbles']) }),
+  Object.freeze({ chance: 0.01, keys: Object.freeze(['baicaodan']) }),
+])
+
+/** 日记最多留几篇，更早的删掉。 */
+export const DIARY_MAX = 60
+
+/** 一天里最多数几句话（模板拼出来的日记不会比它长）。 */
+export const DIARY_MAX_SENTENCES = 5
+
+/**
+ * 日记模板：按当天记下的东西挑句子拼，最多 `DIARY_MAX_SENTENCES` 句。
+ *
+ * `[主人]` 会换成主人称呼（和 data/lines.js 用同一个占位符）。顺序就是优先级：
+ * 先说吃，最后说陪主人干活。句子里的数字来自当天的计数（见 DIARY_COUNT_LABELS）。
+ * @type {ReadonlyArray<{ key: string, said: (counts: Record<string, number>) => string }>}
+ */
+export const DIARY_LINES = Object.freeze([
+  Object.freeze({ key: 'feed', said: c => `今天吃了 ${c.feed} 顿，[主人]喂的，好饱。` }),
+  Object.freeze({ key: 'bathe', said: c => `洗了 ${c.bathe} 次澡，身上香香的。` }),
+  Object.freeze({ key: 'pet', said: c => `[主人]摸了我 ${c.pet} 次，我呼噜呼噜了一下午。` }),
+  Object.freeze({ key: 'work', said: c => `出门打工 ${c.work} 趟${c.coinsEarned > 0 ? `，赚了 ${c.coinsEarned} 金币！` : '，累是累了点。'}` }),
+  Object.freeze({ key: 'study', said: c => `上了 ${c.study} 节课，脑袋里又装进去一点东西。` }),
+  Object.freeze({ key: 'graduate', said: c => `今天毕业啦，一共念完 ${c.graduate} 个学段！` }),
+  Object.freeze({ key: 'trip', said: c => `出去旅行 ${c.trip} 次，带回来 ${c.souvenirs ?? 0} 件纪念品。` }),
+  Object.freeze({ key: 'illness', said: () => '生病了，难受得不想动……' }),
+  Object.freeze({ key: 'cure', said: c => `吃了 ${c.cure} 次药，终于好了。` }),
+  Object.freeze({ key: 'wrongMedicine', said: () => '吃错药了，肚子更难受了。' }),
+  Object.freeze({ key: 'levelUp', said: c => `升级 ${c.levelUp} 次，[主人]看见了吗？` }),
+  Object.freeze({ key: 'stage', said: () => '今天长大了，样子变了一点点。' }),
+  Object.freeze({ key: 'turn', said: c => `[主人]今天敲了 ${c.turn} 轮代码，我在旁边看着。` }),
+  Object.freeze({ key: 'tool', said: c => `${c.tool} 个工具跑完了，我也跟着长了点。` }),
+])
+
+/** 什么都没发生的那一天。 */
+export const DIARY_EMPTY_LINE = '今天[主人]没来，我睡了一整天。'

package/packages/pet-core/src/data/drops.js

@@ -0,0 +1,34 @@
+// @ts-check
+/**
+ * 打工、上课回来带的东西 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ *
+ * 数字来自 docs/tasks/numbers/B4-study-jobs.md §4（用户 2026-10-01 确认）。
+ * 参考 QQ 宠物：打工回来 75% 带 1 件、25% 带 2 件；这里给得少一点，因为钱多。
+ *
+ * @module dsh-piggy/data/drops
+ */
+
+/** 打工回来：带 2 件 / 带 1 件的概率（其余什么都不带）。 */
+export const WORK_DROP = Object.freeze({ two: 0.15, one: 0.5 })
+
+/** 上课回来：带 1 件的概率。 */
+export const STUDY_DROP_CHANCE = 0.3
+
+/** 毕业（某门课第 9 / 20 / 40 / 95 节）：必得几件。 */
+export const GRADUATION_DROP_COUNT = 3
+
+/** 抽到哪一类：食物 / 日用品和玩具 / 1 级药。 */
+export const DROP_SHELVES = Object.freeze([
+  Object.freeze({ kinds: Object.freeze(['food']), weight: 0.45 }),
+  Object.freeze({ kinds: Object.freeze(['bath', 'toy']), weight: 0.4 }),
+  Object.freeze({ kinds: Object.freeze(['medicine']), weight: 0.15, tier: 1 }),
+])
+
+/** 打工掉落单件价值上限 = 这班报酬 × 0.3。 */
+export const WORK_DROP_VALUE_RATIO = 0.3
+
+/** 上课掉落单件价值上限。 */
+export const STUDY_DROP_MAX_PRICE = 40
+
+/** 毕业礼从「高一档」货架抽：价格在这个区间的食物、日用品、玩具。 */
+export const GRADUATION_DROP_PRICE = Object.freeze({ min: 30, max: 150 })

package/packages/pet-core/src/data/evolution.js

@@ -0,0 +1,41 @@
+// @ts-check
+/**
+ * 加冕：长成之后可以选的形态（猪猪王是第一种，立绘来自 PR #2，作者 1nuoiscute）。
+ *
+ * 等级成长（data/life.js）照旧；形态只是在某个阶段上换一身样子，不加收益。
+ * 以后加新形态：在 FORMS 里加一行，在 assets/ 放 `<art>.svg`（有动作立绘的再放
+ * `<art>-eat/bathe/play/pet/relaxed/work/study/trip.svg` 并写 actionArt: true）。
+ * @module dsh-piggy/data/evolution
+ */
+
+/**
+ * @typedef {object} PigForm
+ * @property {string} key       存档里 state.form 的值
+ * @property {string} label
+ * @property {string} emoji
+ * @property {string} art       assets/ 里的立绘名
+ * @property {boolean} actionArt 有没有喂食、打工等各个动作的立绘
+ * @property {string} line
+ * @property {string} stage     到了哪个阶段（data/life.js 的 key）才能加冕
+ * @property {Readonly<Record<string, number>>} requires  三维各要多少，`jobs` 是本代打完几份工
+ * @property {readonly string[]} hides  这身样子盖住的装扮位置
+ */
+
+/** @type {readonly Readonly<PigForm>[]} */
+export const FORMS = Object.freeze([
+  Object.freeze({
+    key: 'king', label: '猪猪王', emoji: '👑', art: 'pig-king', actionArt: true,
+    line: '阅历与本事都攒够了，戴上自己的王冠。',
+    stage: 'middle',
+    requires: Object.freeze({ intel: 20, charm: 20, strong: 20, jobs: 10 }),
+    hides: Object.freeze(['head', 'back']),
+  }),
+])
+
+/** The form `/pig crown` picks when none is named. */
+export const DEFAULT_FORM = 'king'
+
+/** @returns {Readonly<PigForm> | null} */
+export function formByKey(key) {
+  return FORMS.find(form => form.key === key) ?? null
+}

package/packages/pet-core/src/data/growth.js

@@ -0,0 +1,72 @@
+// @ts-check
+/**
+ * 成长值与等级 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ *
+ * 数字全部来自 docs/tasks/numbers/B2-growth.md（用户 2026-10-01 确认）。
+ * 参考 QQ 宠物 GrowUp.js：成长值随时间自己涨，心情、健康、饿、脏会拖慢它 ——
+ * 照顾得好就长得快。去掉的是原版 400 级的肝和粉钻加速。
+ *
+ * 存档里的 `xp` 字段就是成长值（沿用旧字段名，免得全库改名）。
+ *
+ * @module dsh-piggy/data/growth
+ */
+
+/** 满级。满级后成长值照样累计，只是不再升级。 */
+export const MAX_LEVEL = 60
+
+/** 等级曲线系数：到达 L 级需要的累计成长值 = K × L²。 */
+export const GROWTH_CURVE_K = 122
+
+/**
+ * Growth needed to *reach* a level: 122 × L². Lv10 ≈ 5 days, Lv40 ≈ 2.7
+ * months, Lv60 ≈ 6 months at full care and the base rate alone.
+ * @param {number} level
+ */
+export const xpForLevel = level => (level <= 1 ? 0 : GROWTH_CURVE_K * level * level)
+
+/** 猪时间每小时的基础成长值（关着 DSH 也长）。 */
+export const GROWTH_PER_HOUR = 100
+
+/**
+ * 心情档位对成长速度的系数，按从高到低找第一个满足 `min` 的档。
+ * 原版按 1000 分制扣 20/70/100/140/180（基础 260），这里折成百分比取整。
+ */
+export const MOOD_GROWTH_FACTORS = Object.freeze([
+  Object.freeze({ min: 70, factor: 1 }),
+  Object.freeze({ min: 50, factor: 0.9 }),
+  Object.freeze({ min: 30, factor: 0.7 }),
+  Object.freeze({ min: 0, factor: 0.5 }),
+])
+
+/** 饿（饱食 < THRESHOLDS.hungry）或脏（清洁 < THRESHOLDS.dirty）时的系数，两者只算一次。 */
+export const NEGLECT_GROWTH_FACTOR = 0.7
+
+/** 生病时每少 1 格健康，成长速度少 15%。 */
+export const SICK_GROWTH_PENALTY_PER_HEALTH = 0.15
+
+/** 各项系数相乘后的下限：再惨也不会完全不长。 */
+export const MIN_GROWTH_FACTOR = 0.1
+
+/** 陪主人真实干活给的成长值（每轮对话 / 每次工具调用）。 */
+export const DSH_GROWTH = Object.freeze({ turn: 3, tool: 1 })
+
+/** 真实干活加成每天的上限（约等于多养 3 小时）。 */
+export const DSH_GROWTH_DAILY_CAP = 300
+
+/** 打工、旅行：每小时 +25 成长值（按活动时长折算）。 */
+export const WORK_GROWTH_PER_HOUR = 25
+
+/** 每上一节课 +40（兴趣课同）。 */
+export const STUDY_GROWTH_PER_LESSON = 40
+
+/** 某门课毕业（第 9/20/40/95 节）额外 +500（B4 接上）。 */
+export const GRADUATION_GROWTH = 500
+
+/** 一天从几点算起：06:00 以前还算前一天（签到、在线礼包、日记、每日上限共用）。 */
+export const DAY_STARTS_AT_HOUR = 6
+
+/** 性别：拆纸盒时 50/50 定下来。 */
+export const SEXES = Object.freeze({
+  boy: Object.freeze({ key: 'boy', label: '男孩', symbol: '♂' }),
+  girl: Object.freeze({ key: 'girl', label: '女孩', symbol: '♀' }),
+})