# HP-Life-Simulator **Repository Path**: chaining/HP-Life-Simulator ## Basic Information - **Project Name**: HP-Life-Simulator - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-25 - **Last Updated**: 2026-08-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 霍格沃兹人生模拟器 v2.5 > **致尚未入学的年轻巫师：** 你的名字将铭刻于魔法世界之中。 猫头鹰送来的不只是一封入学通知，还有一段尚未被命运写下的人生。 《霍格沃兹人生模拟器》是一款本地运行、单人游玩的连续文字叙事游戏。你将创造自己的巫师，从收到来信、踏入对角巷或站上分院台的那一刻出发，在课程、友谊、秘密、声望与战争阴影中作出选择。 故事会记得你结识的人、许下的承诺、学会的魔法，以及那些被你悄然改变的历史。你不必成为救世主，也不必照着原著走完一条早已写好的道路——城堡的每一条岔路，都可以通往一段属于你的魔法人生。 > 本项目是免费、非商业的同人游戏，与 J.K. Rowling、Warner Bros. Entertainment 或 Wizarding World 官方无关。 ## 你的七年会怎样展开 当前开放的是 **子世代（1991—1998）**。你会与哈利、罗恩和赫敏生活在同一座城堡，却不必成为他们故事里的配角。 七个学年会真实流逝。九月意味着新的年级，三年级要选择选修课，六年级将决定 N.E.W.T. 方向，六月则会留下成绩与成长。课堂之外，你可以调查秘密、违反校规、帮助朋友、树立敌人、钻研黑魔法，甚至因为自己的选择离开霍格沃兹。 每个回合，你可以： - 从故事给出的行动中作出选择； - 选择“其他”，直接写下任何合理行动； - 查看角色、纪事、羁绊、声望、课程、信件与世界线； - 用【干涉命运】为下一幕指定方向； - 用【重塑命运】重新书写刚刚发生、但不符合期待的一幕。 翻阅档案不会推进时间，也不会消耗行动。你可以随时停下脚步，看看这段人生已经留下了怎样的墨迹。 ## v2.5：每个起点都有自己的来路 这一版本重新打磨了“你是谁、从哪里来，以及怎样踏进魔法世界”。角色档案不再只是开场问卷，而会在之后的叙事中持续留下影响。 ### 出身会改变你看见世界的方式 纯血、混血与麻瓜出身拥有不同的童年常识和入学背景。 - 来自纯血家族的孩子，可能早已习惯会动的照片、猫头鹰邮递与巫师礼仪，同时背负家族名声与偏见； - 混血家庭连接着两个世界，你或许熟悉魔法，却仍要在两套生活方式之间寻找位置； - 麻瓜出身的孩子，会把来信当作童年怪事第一次得到答案的时刻； - 自定义出身则会依照你写下的经历，形成独有的认知与反应。 出身会影响角色是否认识魔法、如何理解眼前的人与事，却不会替你决定学院、魔杖或未来立场。古老家族的孩子可以反对纯血至上，麻瓜出身的学生也可能主动追逐危险知识——来路是故事的土壤，不是命运的枷锁。 ### 起点由你选择，不由血统替你选择 无论出身如何，你都可以从四个时刻启程： 1. 收到霍格沃茨来信之前； 2. 第一次踏入对角巷； 3. 九又四分之三站台； 4. 分院时。 较晚的起点会略过此前旅程，但不会抹去你的童年与家庭背景。角色会带着这些往事走进第一幕，而不是被故事强行送往另一个开场。 ### 命运卷宗可以随时开启另一段人生 在存档管理界面点击【创建新存档】，即可从现有人生中抽身，重新展开一份角色档案。旧存档仍会安静地留在卷宗里，等待你下次归来。 这让你更容易同时保留不同尝试：一位谨慎的拉文克劳、一位野心勃勃的斯莱特林，或两个出身相同却走向完全不同世界线的人。 ### 档案里的地点更像真正的魔法世界 现在，故事中出现的任何地点，会以可读的中文名称出现在剧情和纪事里。多年后翻阅旧事时，你仍然可以看到那段记忆真正发生的地方。 生日输入与角色创建细节也经过整理。初始好友可以多选、自定义，也可以一个都不选，让角色独自走进故事。 ## 写下你的巫师档案 新人生会从一份角色档案开始。你将决定： - 姓名、性别、生日与外貌； - 家庭出身与童年经历； - 性格、价值观与补充设定； - 魔杖、魔法天赋、宠物与潜在守护神； - 初始好友、学院倾向与剧情起点。 不必急着写一个完美的人。一个害怕失败、渴望证明自己、对某类魔法抱有偏见，或只想平安毕业的角色，往往比全知全能的天才更值得记住。 补充设定会持续影响叙事，但不会让角色无视年龄、学籍与已经掌握的能力。潜在守护神也不会立刻回应召唤——你仍要在故事里真正学会【呼神护卫】。 ## 在城堡里生活 ### 上课、考试与成长 你的课程会随年级变化。学习、练习和真正使用魔法会积累经验；熟练度提升后，角色在相关场景中的表现也会变得更可靠。 选修课与 N.E.W.T. 方向不是装饰：它们决定今后还能接受哪些训练，也会影响毕业前留下的成绩。退掉一门课不会抹去已经学会的本领，但它也不会继续自然成长。 ### 羁绊需要共同经历 好感与信任会分别成长。一次友善招呼不会立刻换来生死之交，一场争执也未必足以摧毁多年友谊。只有真实发生过的对话、帮助、冲突、陪伴与共同冒险，才会让关系前进或后退。 关系可能从陌生走向朋友与挚友，也可能因背叛变得疏远甚至敌对。恋爱有独立的发展轨迹，并受双方年龄与真实互动约束；童年不会被过早写成爱情，条件不足时也不会凭空进入亲密阶段。 你不再只能和预设人物建立羁绊。图书馆里的陌生学生、禁林边缘的古怪巫师，或对角巷里怀揣秘密的学徒，都可能被故事真正记住，并在未来学年再次出现。 ### 声望会先于你抵达房间 帮助他人、违反规则、公开使用某些魔法，都会慢慢塑造别人眼中的你。 声望较高时，陌生人可能更愿意相信你的解释；恶名增长后，畏惧、猜疑和敌意也会随之而来。若在校期间彻底滑向黑巫师之名，霍格沃兹甚至可能将你开除——课程会结束，但人生不会。你仍能以另一种身份回到这片世界。 ### 原著历史是风暴，不是任务清单 魔法石、密室、逃犯、三强争霸赛与战争会在正确的年代逼近，却不会要求你逐项完成。 你可以参与、旁观、错过、误解，甚至改变某个历史节点。世界会根据日期、年级、地点、近期行动与已经改变的往事，判断哪些风声此刻应该传到你耳边。 世界线可以偏离，但每次偏离都会留下人物、声望与因果上的回声。你推开的不只是一扇门，还包括门后所有尚未写下的日子。 ### 记忆让漫长人生保持连续 重要承诺、秘密、未完成线索和人物关系会被写入长期记忆。多年后重逢时，一段旧事仍可能改变对话的语气。 纪事保存已经发生的剧情节点。旧节点只能阅读，不能让时间倒流；如果只是对最新一幕不满意，请使用【重塑命运】。 ## 握住命运的羽毛笔 游戏提供两种不同的叙事工具。 ### 干涉命运：告诉下一幕往哪里走 当你希望某件事在接下来的剧情中发生，可以写下目标事件。故事会尝试补足通往它的合理过程，而不是毫无铺垫地把结果扔到面前。 干涉命运不会让角色绕过年龄、课程、能力与世界规则。它改变的是故事方向，不是一张无条件成功的许可证。 ### 重塑命运：让这一幕重新落笔 如果当前最新剧情节奏太快、人物行为失真，或模型误解了你的意图，可以打开自由行动下方的【重塑命运】，告诉故事应当保留什么、改变什么。 ```text 这一幕揭露秘密太快了。 保留“我已经察觉异常”，但让真相继续隐藏， 先通过脚步声、熄灭的烛火和人物反应制造悬念。 ``` 原版本造成的物品、技能、声望与羁绊变化会先被撤回，新版本只会结算一次。纪事仍停留在同一个节点，不会凭空多出一段重复历史。 简单来说：【干涉命运】推动下一幕，【重塑命运】改写这一幕。一个把羽毛笔推向岔路，一个擦去尚未干透的墨迹。 ## 给第一次游玩的几条建议 - **把自由输入当成真正的行动。** 与其写“继续”，不如写清你观察谁、隐瞒什么、准备怎样的魔法。 - **给关系留下时间。** 多次共同经历比一次夸张表白更能建立可靠羁绊。 - **经常翻阅纪事和未完成线索。** 很多故事入口藏在你已经见过的细节里。 - **接受一部分失败。** 受伤、误会、失去信任和考试失利，往往会打开更独特的道路。 - **为不同念头建立不同存档。** 每份卷宗都可以拥有不同的出身、性格、学院与世界线。 ## 入学前：准备你的魔法书桌 ### 你需要 - Windows 10 或 Windows 11，可使用双击启动器； - macOS 或 Linux，可使用下方的手动方式； - Python 3.12 或更高版本； - Node.js LTS； - 一个支持 OpenAI-compatible Chat Completions 的模型服务； - 对应的 Base URL、API Key 和模型名称。 ### Windows：双击启程 1. 克隆仓库，或从 GitHub 下载并完整解压游戏。 2. 双击 **`start_hp_simulator.bat`**。 3. 第一次启动时，程序会准备独立运行环境并安装所需内容，请保持网络畅通并耐心等待。 4. 浏览器打开后，在页面右上角进入模型配置，填写 Base URL、API Key 和模型名称，然后进行连接测试。 之后通常只需再次双击启动器。若浏览器没有自动出现，请手动访问： ```text http://127.0.0.1:5173 ``` ### Base URL 应该怎么填 这里只填写模型服务的**根地址**，不要附加具体接口路径。 以 OpenAI 官方服务为例，应填写： ```text https://api.openai.com ``` 不要填写： ```text https://api.openai.com/v1 https://api.openai.com/v1/chat/completions ```
macOS、Linux 或启动器不可用时：展开手动启动说明 先在项目根目录创建本地配置。 Windows PowerShell： ```powershell Copy-Item config/settings.example.toml config/settings.local.toml ``` macOS 或 Linux： ```bash cp config/settings.example.toml config/settings.local.toml ``` 如果配置文件已经存在，请不要覆盖。然后在第一个终端启动后端。 Windows PowerShell： ```powershell py -3.12 -m venv .venv .\.venv\Scripts\python.exe -m pip install -e . .\.venv\Scripts\python.exe -m uvicorn backend.app.main:app --host 127.0.0.1 --port 8000 ``` macOS 或 Linux： ```bash python3 -m venv .venv source .venv/bin/activate python -m pip install -e . python -m uvicorn backend.app.main:app --host 127.0.0.1 --port 8000 ``` 再打开第二个终端启动前端： ```bash cd frontend npm ci npm run dev -- --strictPort ``` 保持两个终端窗口运行，并访问 `http://127.0.0.1:5173`。
## 存档、升级与隐私 所有人生记录保存在项目目录下的 `data/` 中。 - 存档彼此独立，可以重命名或删除； - 删除存档无法撤销； - 升级游戏前，建议关闭游戏并备份整个 `data/` 目录； - 恢复时，将备份目录放回项目根目录即可。 请永远不要公开或提交： - `config/settings.local.toml`； - `LLM API KEY.txt` 或任何 API Key； - `data/` 存档目录； - 你不希望交给他人的私密剧情内容。 游戏和存档保存在本机，但剧情生成需要把相关故事内容发送给你配置的模型服务。不同服务商的数据保留规则不同，请在开始长期存档前阅读对应的隐私政策。 ## 常见问题 ### 双击启动器后提示找不到 Python 安装 Python 3.12 或更高版本，并在安装时选择“添加到 PATH”。完成后重新双击启动器。 ### 提示找不到 npm 或 Node.js 安装 Node.js LTS，关闭已经打开的终端窗口，再重新运行启动器。 ### 模型连接测试失败 依次确认： - Base URL 是否只填写了服务根地址； - API Key 是否有效； - 模型名称是否与服务商提供的名称完全一致； - 账户是否有可用额度和该模型的访问权限； - 模型服务是否兼容 Chat Completions； - 当前网络是否能访问模型服务。 ### 剧情生成很慢，可以重复点击吗 不建议。复杂剧情或格式修复可能需要更长时间，请等待当前回合结束。连续点击可能制造重复请求，却不会让猫头鹰飞得更快。 ### 可以建立多个角色吗 可以。在命运卷宗中点击【创建新存档】，就能保留现有人生并开始另一段旅程。 ### 可以完全避开原著主线吗 可以。历史事件仍会作为时代背景发生，但你可以与核心人物保持距离，经营自己的校园生活。某些风暴可能依然波及城堡，却不要求你成为解决它的人。 ## 最后的叮嘱 这是一个仍在成长的魔法世界。模型可能偶尔误解意图或生成不理想的内容；你可以用更明确的行动修正方向，也可以用【重塑命运】重新书写最新一幕。 本项目为个人学习与非商业同人项目。魔法世界相关角色、地点和设定属于其原版权方；项目代码与原创内容仅用于非商业体验。 现在，收好车票，确认魔杖还在袖中。 **愿你的名字，被魔法世界长久铭记。**