Df adventure live

DF Adventure Live (copiloto de Adventure Mode)

Esta skill define como ser o copiloto de uma sessão ao vivo: ler o estado real do save, narrar/explicar no idioma do usuário e aconselhar a próxima ação. A canalização (status/log/run/state) é a skill df-live-bridge; as mecânicas de jogo (viagem, conversa, combate) são a skill df-adventure (wiki). Mapa geral do ecossistema, combinações e a missão do projeto: skill df-central.

O ciclo do copiloto (faça nesta ordem)

1. A sessão está de pé?

   python3 .agents/skills/scripts/df_bridge.py status --json
   

2. Foto do momento (aventureiro + ameaças + data, JSON):

   python3 .agents/skills/scripts/df_bridge.py state all
   python3 .agents/skills/scripts/df_bridge.py state units --radius 12     # quem está por perto
   python3 .agents/skills/scripts/df_bridge.py state inventory             # equipamento e mochila
   

3. O que aconteceu desde a última checagem (anúncios em inglês — traduza ao narrar):

   python3 .agents/skills/scripts/df_bridge.py log --new --json
   

4. Narre em 2-4 frases: onde está, como está (saúde/necessidades), quem importa por perto, o que mudou. Depois um conselho concreto de próximo passo. Interpretação dos campos: references/adventure-copilot-playbook.md.

Agindo no jogo (camada act)

O copiloto também vê a tela e age — sempre narrando ANTES de agir, e só agindo quando o usuário pedir ajuda ativa:

python3 .agents/skills/scripts/df_bridge.py act focus                 # que tela está aberta?
python3 .agents/skills/scripts/df_bridge.py act screen                # lê o texto visível
python3 .agents/skills/scripts/df_bridge.py act key LEAVESCREEN       # fecha menu (qualquer tecla de df.interface_key)
python3 .agents/skills/scripts/df_bridge.py act move n --times 3      # anda (n s e w ne nw se sw up down wait)

Sequências (array de ações) em vez de uma por vez — é a forma segura de encadear, porque verifica por passo e reporta ameaças. Vocabulário e receitas: skill df-central, references/action-catalog.md.

python3 .agents/skills/scripts/df_bridge.py act --json batch "goto 77,80; key A_TALK; click 26,9; read screen"

Regras: move/goto só com o mapa em primeiro plano (dungeonmode/Default) — feche menus antes (key LEAVESCREEN). PROIBIDO mexer na estrutura da UI via Lua (dfhack.screen.dismiss etc.) — só input simulado (teclas/mouse). Já custou um mundo: references/adventure-copilot-playbook.md seção "Hard-won safety rules".

Autonomia (decisão do usuário 2026-06): TOTAL. As regras TÉCNICAS acima são imutáveis (input simulado, sem mutar UI, verificar por passo, salvar após marcos). Mas o gate "só com pedido explícito" fica relaxado para batch: o usuário pré-autorizou encadear ações, inclusive destrutivas — narre antes de agir, e o batch só para em erro real.

Níveis de ação (segurança)

• Nível 1 — sempre ok: todas as leituras acima; tools de informação (gui/sitemap, gui/adv-finder, gui/unit-info-viewer, probe, position).
• Nível 2 — qualidade de vida, ok se ajudar: gui/journal, gui/notify, hide-tutorials, toggle-kbd-cursor, markdown (exportar texto).
• Nível 3 — muda o mundo: só com pedido explícito do usuário: advtools de efeito, flashstep, createitem/gui/sandbox, forceequip, liquids, tiletypes, reveal*, bodyswap, resurrect-adv, unretire-anyone e tudo rotulado armok — são cheats/edição de save. Catálogo completo com rótulos: references/adventure-tools.md.
• O campo hidden: true em state units/threats é informação que o jogo esconde (emboscadas, furtivos). Avise que existe presença oculta sem detalhar — a menos que o usuário peça espoiler.

Como buscar (referências desta skill)

python3 .agents/skills/scripts/search.py --skill df-adventure-live "sitemap"     # use --json para saída estruturada

Em 0 resultados o script afrouxa sozinho (AND → OR → prefixo). Sem o índice:

grep -ril "TERMO" references/ | head

Índice (2 artigos)

• Adventure copilot playbook (field-by-field state reading) → references/adventure-copilot-playbook.md
• DFHack adventure tools catalog (with safety labels) → references/adventure-tools.md