@idlekit / cli

idk 是空闲游戏设计评估的命令行界面。 使用它来验证场景、运行模拟、检查节奏、比较变量和调整策略。 官方支持v1: Bun >=1.4.2 只有。Node.js和浏览器运行时不是v1兼容性契约的一部分。

此注册表安装需要已发布的包。如果它返回 404，使用存储库 local-pack工作流，包括它对未发布的内部依赖项的覆盖，在单独的消费者项目中。

bun add -g @idlekit/cli

需要面包 >=1.4.2.

典型的流程:

idk init scenario --track personal --preset builder --out ./my-game-v1.json --name "Space Miner"
idk validate ./space-miner-v1.json
idk simulate ./space-miner-v1.json --format json
idk experience ./space-miner-v1.json --format json
idk evaluate ./space-miner-v1.json --format md

交互式脚手架和评审：

idk init scenario --wizard true --track personal --preset builder --out ./my-game-v1.json
idk review doctor
idk review evaluate ./space-miner-v1.json
idk review compare ./space-miner-v1.json ./space-miner-v1-compare-b.json
idk tune ./space-miner-v1.json --wizard true
idk experiment ./experiment-spec.json

Shell完成和运行状况检查：

source <(idk completions zsh)
idk doctor --format md
idk doctor --fix true --shell zsh
idk review doctor
idk setup plugin-trust --plugin ./custom-econ-plugin.ts --out ./.idk/plugin-trust.json

在这个仓库中工作的真实游戏示例：

bun run --cwd packages/cli dev -- experience ../../examples/tutorials/14-orbital-foundry-v1.json \
  --plugin ../../examples/plugins/custom-econ-plugin.ts \
  --allow-plugin true \
  --session-pattern twice-daily \
  --days 7 \
  --format json

巨额货币价值

compare， tune 和 balance 支持 --engine breakInfinity，旁边的 现有仿真命令。Number保持默认值； scenario.engine 不选择运行时。当场景数量超过时，使用显式标志 数字的范围，并使用引擎操作的自定义模型和目标。

使用所提供的构造插件数量 ctx.E。当改编一款游戏时 使用自己的Decimal库，通过使用 ctx.E.from(text) 在边界上，包括成本、回报和返回状态。 独立的游戏SDK和CLI包可以包含不同的Decimal构造器。

idk compare ./a.json ./b.json --engine breakInfinity --metric endNetWorth
idk tune ./a.json --tune ./tune.json --engine breakInfinity
idk balance ./workflow.json --engine breakInfinity --format md

Compare保留货币文本，同时调优目标，如 endNetWorthLog10 产生有限对数分数。重放构件保留了 选择引擎。Balance支持小数串货币目标和结果； CSV参数编辑，时间/计数指标和灵敏度旋钮仍然有限 数字。看到 平衡指南 用于目标语法和特定于引擎的新鲜度检查。breakEternity仍然是实验性的。

运行时

@idlekit/cli 是作为一个bunfirst CLI包来维护的。

• 自动化路径: evaluate， compare --format json， experience --format md|json
• 人工审核路径： review evaluate， review compare， review doctor
• 引导安装路径： init scenario --wizard， tune --wizard， doctor --fix， setup completions
• 推荐人体序列： init scenario --wizard -> review doctor -> review evaluate -> review compare -> tune --wizard

文档

• 存储库: github.com/imjlk/idlekit
• 产品路线图: 文档/ roadmap.md
• 从这里开始: 文档/ start-here-cli-designer.md
• 命令参考: 文档/ usage-guide.md
• 输入CSV平衡工作流： 文档/ balance-sheets.md