ArcaneDesk 应用

ArcaneDesk 是面向使用 FVTT 的 DM 的桌面应用,把 Foundry VTT 安装、管理、以及辅助 AI Agent 收敛为一个安装包,支持 Windows 和 macOS。

安装前提

  • Windows 10/11 或 macOS
  • 自备有效的 Foundry VTT 官方授权
  • 模型服务二选一:
    • 自备大模型 API Key(BYOK),以及可选:独立语音识别 Key
    • 订阅官方 Arcane Spark Key

核心能力

  • 一键安装:下载、安装、运行环境全托管。不用碰 Node 和命令行,装完就是能开团的状态。
  • 辅助备团:内容 Agent 陪你备团:整理模组与世界资料,同步角色卡,开场前一切就绪。
  • 自动战斗:战斗 Agent 接管回合流程:先攻、行动、结算自动推进,你只管描述场面。

两种模式

备团模式(Prepping)

备团模式首屏

备团模式围绕跑团准备设计,主要干三件事:

  1. 备团内容工作(文件读写):在当前的跑团工作目录(workspaces/prep)内读写 Markdown 笔记(剧情大纲、房规、战役设定);设计 NPC、地点、遭遇、物品;按模组 PDF 建立 Obsidian 资料库,检索剧情/人物/地点。
  2. FVTT 装机与运维:按对应 skill 执行安装/修复/升级/迁移 Foundry VTT 13(处理 ZIP/EXE/DMG、dnd5e 和 Arcane 模组);日常运维:启停服务器、看日志、排查 30000 端口占用、切换世界、处理 options.json.lock。
  3. FVTT 世界同步:右侧 GM 页面打开后,调用 Foundry 公开 Document API,把你要求的 Actor、Item、JournalEntry、Scene 等同步进当前世界;只做写入前的确认(game.ready + isGM)、查重、回读验证,不会乱写。

可用的技能文件(需要时会自动加载):

技能 场景
arcane-fvtt-ops 服务器启停/日志/端口/世界切换
arcane-fvtt-setup 全新安装/升级/迁移 FVTT
arcane-module-reader 模组 PDF → Obsidian 资料库
arcane-actor-images 人物头像与 token 图维护

约束提醒:

  • 只能读写当前工作目录内的文件;外部文件会请你手动操作
  • Windows 用 PowerShell 5.1,macOS 用 Bash;不会让你另装 Node 或包管理器
  • 战斗中的实时操作(回合推进、动作执行)不在备团范围,那种需求请切到战斗模式

战斗模式(Combat)

战斗模式首屏

战斗模式是 ArcaneDesk 内嵌的战斗中实时操控副驾驶,直接面对 DM,和备团模式是两套完全不同的工具面。核心职责:把你口头说的「谁对谁做什么」变成 Foundry 世界里真实的战斗操作——判定命中、结算伤害、推进回合。

用哪些工具:

工具 作用
combat_battle_context 战斗手册:本场战斗可用的动作目录(攻击/施法/技能),一场读一次
combat_turn_context 实时回合状态:当前是谁的回合、能放哪些动作、目标 HP 等,每次决策前必读
combat_execute_turn 提交动作(actions + 目标 + 输入),返回四态回执
world_status 只读世界信息
foundry_open / browser_evaluate 打开面板、有界页面诊断

关键规则(和备团模式很不一样):

  • 实时状态只信工具不信记忆:DM 和玩家会随时手动拖 token、改 HP、掷骰,每次指令前都重新读 turn-context;对话历史里的状态一律过期。
  • 不做战术裁判:距离、射程、站位、走位合法性不归它判,由执行期和 DM 负责;走位由 DM 手动操作。
  • 优劣势、环位只在你明确说的时候才传,不按战术自行推断。
  • 只在 DM 明确要求时执行动作、推进回合;默认只执行不推进。
  • 执行回执有 completed / rejected / partial / indeterminate 四态,partial 和 indeterminate 禁止重试,交给 DM 裁定。

相关项目