投资公司发展物语 V2.0 GM调试系统设计文档 vGM-0.1

投资公司发展物语 V2.0 GM调试系统设计文档 vGM-0.1

版本说明

  • 本文档为 GM-0.1 独立版本，为开发和测试提供调试功能。
  • GM系统仅在按下特定快捷键后激活，不影响正常游戏体验。
  • 若本文与代码实现冲突，以代码实际行为为准。

0. GM-0.1 实现约定与变更摘要

主题 GM-0.1 约定
激活方式 按 ~ 键（反引号）激活GM按钮，点击按钮呼出GM面板
界面风格 命令行 + 表单面板 双模式并存
命令前缀 以 / 开头识别为GM命令，如 /cash 1000
状态操控 现金、声誉、年月、游戏种子、行情（股市/大宗）
员工操控 添加、属性修改、晋升、忠诚度调整
业务操控 快速创建、修改AUM、强制结业、利润策略切换
事件操控 触发大事件、清除事件、设置随机事件概率
股权操控 快速上市、增发、修改股价、调整持股比例
存档操控 状态导出/导入、一键复制当前存档JSON
调试视图 原始状态查看、结算日志增强、性能计时

一、激活与界面

1.1 激活流程

  1. 首次激活：按 ~ 键 → 右下角显示悬浮GM按钮（小齿轮图标 ⚙️）
  2. 呼出面板：点击GM按钮 → 展开GM调试面板
  3. 再次点击：关闭面板
  4. 隐藏按钮：按 ESC 或刷新页面后GM按钮消失

1.2 面板布局

┌─────────────────────────────────────┐
│  GM调试面板                    [×]  │
├─────────────────────────────────────┤
│  [状态][员工][业务][事件][股权][存档] │  ← Tab切换
├─────────────────────────────────────┤
│  命令行: [/cash 1000]          [执行] │  ← 命令输入区
├─────────────────────────────────────┤
│  ┌─────────────────────────────┐   │
│  │  表单内容区域（当前Tab）      │   │  ← 表单操作区
│  └─────────────────────────────┘   │
├─────────────────────────────────────┤
│  日志: [调试信息输出...]            │  ← 操作反馈
└─────────────────────────────────────┘

1.3 命令行快捷语法

命令 参数 说明
/cash <n> 金额（万） 设置公司现金
/add <n> 金额（万） 增加公司现金
/date <y> <m> 年, 月 跳转到指定年月
/next - 直接执行下一个月
/market <e> <c> 股市c, 大宗c 设置行情（0-4）
/emp add <tier> 职级 添加指定职级员工
/emp set <id> <attr> <val> ID, 属性, 值 修改员工属性
/biz add <empId> <kind> <aum> 员工ID, 类型, AUM 快速创建业务
/biz close <id> 业务ID 强制结业业务
/event <id> 事件ID 触发指定大事件
/list - 快速上市
/ipo <price> 股价 设置股价
/save - 导出存档到剪贴板
/load - 从剪贴板导入存档
/help - 显示所有命令

二、状态操控模块

2.1 公司状态

功能 命令 表单操作 说明
设置现金 /cash <n> 输入框+滑块 精确到0.0001万
增加现金 /add <n> 快捷按钮(+100/1000) 正数增加，负数扣除
设置声誉 /rep <n> 输入框(0-100) 影响事件分池
设置年月 /date <y> <m> 年月选择器 跳跃到指定时间
设置种子 /seed <n> 输入框 重新初始化RNG

2.2 市场行情

功能 命令 表单操作 说明
设置股市c /market <e> [c] 下拉框(0-4) 0=繁荣, 4=冰点
设置大宗c /market [e] <c> 下拉框(0-4) 同上
锁定行情 /lock 复选框 禁止自然变动
解锁行情 /unlock 复选框 恢复自然变动

c值对应表：

c 股市描述 大宗描述 环境因子
0 繁荣 极牛 +500 / +600
1 向好 向好 +250 / +300
2 平稳 平稳 0 / 0
3 低迷 低迷 -250 / -300
4 冰点 极熊 -500 / -600

三、员工操控模块

3.1 快速添加员工

命令 说明
/emp add junior 添加初级员工（能力5，忠诚6）
/emp add mid 添加中级员工（能力7，忠诚7）
/emp add senior 添加高级员工（能力9，忠诚8）

表单参数：

  • 职级选择（初/中/高）
  • 能力值（1-10）
  • 忠诚度（1-10）
  • AI风格（追涨/趋势/股息/无）
  • 行业技术（各行业0-100）

3.2 属性修改

命令 参数说明
/emp set <id> ability <n> 设置通用能力
/emp set <id> leadership <n> 设置领导力（1-10）
/emp set <id> innovation <n> 设置创新力（1-10）
/emp set <id> execution <n> 设置执行力（1-10）
/emp set <id> loyalty <n> 设置忠诚度（1-10）
/emp set <id> exp <n> 设置工龄（月）
/emp set <id> tech <ind> <n> 设置行业技术
/emp promote <id> 强制晋升
/emp fire <id> 强制开除（无遣散费）

表单展示：

  • 员工列表下拉选择
  • 属性网格（三维能力+忠诚+工龄）
  • 行业技术滑块组（8个行业）

四、业务操控模块

4.1 快速创建业务

命令 参数 说明
/biz add <empId> stock <aum> 员工ID, AUM 创建股票业务
/biz add <empId> fut <aum> 员工ID, AUM 创建期货业务
/biz add <empId> consulting <ind> 员工ID, 行业 创建咨询业务
/biz add <empId> fundraising <target> 员工ID, 目标 创建拉投资业务

表单参数：

  • 员工选择（仅显示空闲员工）
  • 业务类型（股票/期货/咨询/拉投）
  • 起始AUM（股票默认50万，期货20万）
  • 利润策略（复利/上交）
  • 杠杆倍数（期货，默认1x）
  • AI风格（股票，可选）

4.2 业务管理

命令 说明
/biz list 列出所有在营业务
/biz set <id> aum <n> 修改业务AUM
/biz set <id> policy <p> 修改利润策略（reinvest/remit）
/biz close <id> 强制结业（资金划回公司）
/biz kill <id> 强制清算（资金不划回，声誉-3）

4.3 批量操作

命令 说明
/biz close all 结业所有业务
/biz set all aum <n> 设置所有业务AUM为n

五、事件操控模块

5.1 大事件

命令 说明
/event list 列出所有可用大事件
/event <id> 立即触发指定大事件
/event clear 清除所有持续中事件
/event remove <id> 移除指定事件

表单展示：

  • 事件下拉选择（带描述预览）
  • 触发按钮
  • 当前事件列表（带删除按钮）

5.2 随机事件控制

命令 说明
/minor on 允许小事件
/minor off 禁止小事件
/minor force 强制本月触发小事件
/random <n> 设置大事件基础概率为n%

六、股权与上市模块

6.1 快速上市

命令 说明
/list 直接完成上市流程
/list apply 跳到申请阶段
/list prepare 跳到准备阶段（3月）
/list cancel 取消上市

6.2 股权操控

命令 参数 说明
/ipo <price> 股价（万/股） 设置当前股价
/shares total <n> 股数 设置总股本
/shares player <n> 股数 设置玩家持股
/issue <shares> <price> 股数, 价格 立即增发（无冷却）
/buyback <n> 股数 回购n股
/dilute <pct> 百分比 稀释玩家股份pct%

表单展示：

  • 上市状态切换（未上市/申请/准备/已上市）
  • 股价设置（万/股）
  • 股本结构可视化（玩家vs投资者）
  • 增发快捷按钮（10万股/50万股/自定义）

七、存档与调试模块

7.1 存档操作

命令 说明
/save 导出当前状态JSON到剪贴板
/save file 下载状态JSON文件
/load 从剪贴板导入状态
/state 在面板中显示当前状态摘要

7.2 调试视图

命令 说明
/debug 切换调试模式（显示额外信息）
/log 输出最近月结详情到面板
/rng 显示当前RNG状态
/perf 显示性能计时

7.3 状态摘要（/state输出示例）

=== 状态摘要 ===
时间: 1995-06 (第66月)
现金: 1250.50万 | 声誉: 78
员工: 8/20人 | 业务: 5
股市: 向好(c=1) | 大宗: 平稳(c=2)
上市: 未上市
本月: 指导1次已用, 培训未用

八、界面交互细节

8.1 命令行交互

  • 自动补全：输入 /emp 后按Tab显示子命令列表
  • 历史记录：上下键翻阅最近10条命令
  • 快捷执行：直接回车执行，结果显示在日志区
  • 错误提示：命令不存在/参数错误时红色提示

8.2 表单交互

  • 实时预览：修改数值前显示预览效果
  • 确认机制：重要操作（如清空所有业务）需二次确认
  • 批量操作：支持多选员工/业务进行批量修改
  • 默认值：每个表单填充当前实际值作为默认

8.3 视觉区分

  • GM面板边框使用红色（#ff6b6b）区别于游戏UI
  • 命令行输入框使用等宽字体
  • 调试日志使用黄色（#ffd966）文字
  • 危险操作按钮使用深红色背景

九、实现文件与路径

模块 文件路径
GM核心命令 js/core/gm.js
GM面板UI js/core/gm-ui.js
GM样式 index.html style标签内（.gm-*类）
主程序集成 js/main.js（激活逻辑、状态引用）

代码集成点：

  1. js/core/gm.js 导出 GMCommands, isGMActive(), toggleGM()
  2. js/core/gm-ui.js 导出 renderGMPanel(), bindGMEvents()
  3. js/main.js 添加键盘监听（~键）、GM按钮渲染、面板挂载

十、安全与边界

10.1 使用限制

  • GM功能仅修改内存中的state，不自动存档
  • 使用GM后如需保留结果，需手动点击保存按钮
  • 某些操作可能导致游戏状态不一致（如将时间调到过去）

10.2 风险提示

操作 潜在问题
时间跳跃 可能跳过重要事件，员工经验不自动补偿
强制结业 与正常结业不同，可能缺少某些结算步骤
直接上市 跳过上市费用扣除和准备期等待
修改股份 可能导致投资者数据不一致

10.3 恢复机制

  • 使用 /save 在执行危险操作前备份
  • 使用 /load 恢复之前的状态
  • 刷新页面可重置所有GM修改（未保存时）

十一、GM-0.1 功能边界

已实装 ✅

  • 快捷键激活（~键）
  • GM按钮呼出面板
  • 命令行解析与执行
  • Tab切换多模块面板
  • 状态操控（现金/声誉/时间/行情）
  • 员工操控（添加/修改/晋升）
  • 业务操控（快速创建/修改/结业）
  • 事件操控（触发/清除）
  • 股权操控（快速上市/增发/改价）
  • 存档导入/导出

本版未含 📋

  • 结算过程单步调试（断点）
  • 历史操作回放
  • 多存档槽位管理
  • 可视化数据图表
  • 网络多人调试同步

十二、调试技巧

12.1 常用调试流程

1. 遇到bug时：
   /save                    → 备份当前状态
   /state                   → 查看摘要
   /date 1995 6             → 跳到问题时间点
   /event <bug相关事件>      → 尝试复现
   /biz close all           → 清理业务后重试

2. 测试上市流程：
   /cash 500                → 确保资金充足
   /rep 80                  → 提高声誉
   /list                    → 直接上市
   /ipo 0.001               → 设置测试股价
   /issue 10000 0.001       → 测试增发

3. 快速体验后期内容：
   /date 2010 1             → 跳到2010年
   /emp add senior ×5       → 添加高级员工
   /biz add <id> stock 500  ×5  → 创建大业务

12.2 状态检查清单

使用 /state 后检查：

  • 时间和种子是否符合预期
  • 现金和声誉是否在合理范围
  • 员工数是否超过容量
  • 业务AUM是否超过员工管理上限
  • 上市状态与股价是否一致

附录：相关文档

文档 内容
投资公司发展物语 V2.0 设计文档.md 主设计
投资公司发展物语 V2.0 设计文档 v0.4.md v0.4股份/上市/增发
投资-sim/js/core/gm.js GM命令实现
investment-sim/js/core/gm-ui.js GM界面实现

文档完成日期：2026-04-24

版本历史

vGM-0.1 (当前)

  • 完整GM调试系统：状态/员工/业务/事件/股权/存档六大模块
  • 命令行与表单双界面
  • 快捷键激活（~键）
  • 独立版本，不影响正常游戏流程

Latest Posts

Introducing some new layouts to Bulma Clean Theme
Introducing some new layouts to Bulma Clean Theme

I’ve been meaning to write about some of the new features I have been rolling out to my Jekyll theme, Bulma Clean Theme, for a while but I have only just managed to push the update for the landing page layout last weekend. This article provides some of the thinking behind the updates, as well as a brief introduction to how to get started.

Read more

Published: Jul 23, 2019

Getting started with Bulma Clean Theme for Jekyll
Getting started with Bulma Clean Theme for Jekyll

I have made a theme for Jekyll which is based on the Bulma frontend framework. It might look familiar, because I am also using it for this site. If you like the look of this theme then I thought I would write a little blog post about how to use it for your own site and how you can use it with GitHub Pages.

Read more

Published: Feb 9, 2019

Why use a static site generator
Why use a static site generator

There are many ways to make a website and many different CMS platforms you can use, such as WordPress and Joomla, as well as site builder tools that offer you drag and drop interfaces, but what about static site generators?

Read more