DeepSeek Delphi Launcher

Aplicativo desktop Windows em Delphi VCL para usar o deepseek-tui com tema similar ao Codex e terminal integrado dentro da própria GUI.

Este workspace começou como pacote de documentação e agora contém o skeleton Delphi VCL, o fallback CMD externo, a especificação ordenada e o spike funcional do terminal integrado.

Estado atual

• Documentação base concluída.
• Projeto Delphi VCL inicial criado.
• Janela principal criada com toolbar, painel esquerdo, splitter, área de log e statusbar.
• Painel esquerdo já possui botão de recolher/expandir.
• O terminal principal agora carrega em console real do Windows embutido em TPanel, com SetParent e envio de input por WriteConsoleInput.
• O terminal WebView2/xterm.js/node-pty foi removido no Sprint 10 depois do inventário e do build de regressão.
• Decisão de uso real: WebView2 serviu bem para MVP e testes, mas não é mais parte da arquitetura atual por custo de memória/cache/renderização.
• O deepseek-tui já renderizou dentro da janela Delphi em evidência visual tanto no servidor atual quanto em máquina Windows mais nova.
• O fallback CMD externo continua disponível pelo botão/preset CMD externo.
• Configuração local é persistida em %LOCALAPPDATA%\DexDeep\config.ini.
• Presets e comandos utilitários básicos já estão disponíveis.
• O log/status foi movido para janela separada para não interferir na renderização do terminal.
• Shift+Enter no composer cria nova linha sem enviar a mensagem.
• A sidebar possui ações diretas para /model deepseek-v4-pro, /model deepseek-v4-flash, /mode agent, /mode yolo, /mode plan e macros de thinking auto/off/high/max pelo seletor visual do TUI.
• A sidebar possui Configurar OpenRouter..., que busca modelos em https://openrouter.ai/api/v1/models, permite filtrar/selecionar um modelo e grava %USERPROFILE%\.deepseek\config.toml usando OpenRouter como endpoint OpenAI-compatible (provider = "openai").
• O terminal integrado tem botões ▲ e ▼ para rolar em ambientes onde o scroll do mouse não funciona bem.
• Console real do Windows embutido via SetParent foi promovido para caminho principal em 2026-05-13; detalhes e ressalvas estão em docs/13-EMBEDDED-CONSOLE-GUIDE.md.
• O trilho Sprint 10 para estabilizar input avançado, clipboard e Thinking do console real está em docs/14-REAL-CONSOLE-STABILIZATION-TRACK.md.
• Projetos são adicionados/removidos pelo menu de contexto da lista lateral com botão direito; remover projeto só tira da lista, não apaga arquivos.
• O botão de recolher/expandir usa ícones versionados em icon\ui, sem depender de pastas locais da máquina de desenvolvimento.
• No console real principal, Ctrl+V de imagem depende do comportamento nativo do deepseek-tui; quando aceito, o próprio TUI registra a imagem em .deepseek\clipboard-images\ no workspace atual.
• Limite já observado no fluxo com imagem: leitura visual/OCR depende do modelo/TUI; no teste com deepseek-v4-flash, o modelo declarou não conseguir ler imagens.
• O botão de recolher/expandir da sidebar usa ícone interno pequeno; os botões do topo permanecem textuais para preservar densidade e legibilidade.
• Nova documentação ordenada em docs/00-INDEX.md.

Decisão técnica atual

O objetivo principal atual é terminal integrado com console real do Windows:

Delphi VCL -> TPanel -> console real do Windows -> deepseek-tui

O CMD externo permanece como fallback funcional. O caminho WebView2/xterm.js/node-pty foi removido do produto para reduzir memória/cache, dependências Node nativas e problemas de renderização em sessões longas.

Caminho padrão

%APPDATA%\npm\deepseek-tui.cmd

O aplicativo resolve esse caminho dinamicamente pelo usuário atual do Windows. Se o arquivo não existir ali, ele tenta localizar deepseek-tui.cmd ou deepseek-tui.exe no PATH. O caminho ainda pode ser alterado nas configurações.

Comandos principais

Ação	Comando
Abrir DeepSeek	cmd.exe /K ""%APPDATA%\npm\deepseek-tui.cmd""
Instalar ou atualizar	npm install -g deepseek-tui
Ver Node.js	node --version
Ver npm	npm --version
Ver versão	deepseek --version
Diagnóstico	deepseek doctor
Localizar comando	where deepseek
Localizar TUI	where deepseek-tui
Listar modelos OpenRouter	GET https://openrouter.ai/api/v1/models

Fonte de instalação: DeepSeek TUI install docs.

Observação: o app executa utilitários via cmd.exe /d /c. Para npm, a implementação usa npm.cmd para evitar que o Node tente resolver scripts npm a partir do diretório do projeto.

OpenRouter

Para modelos da OpenRouter fora do catálogo nativo do deepseek-tui, como tencent/hy3-preview, use Configurar OpenRouter... na sidebar. O app grava:

provider = "openai"
default_text_model = "auto"

[providers.openai]
base_url = "https://openrouter.ai/api/v1"
model = "tencent/hy3-preview"

A troca passa a valer quando uma nova sessão do terminal é iniciada.

Mapa dos documentos

Documento	Para que serve
INSTALL.md	Instalação rápida, build local e execução
docs/00-INDEX.md	Guia ordenado dos specs e guides
docs/14-REAL-CONSOLE-STABILIZATION-TRACK.md	Trilho Sprint 10 para estabilizar o console real principal
docs/12-INSTALLATION-GUIDE.md	Instalação detalhada e publicação segura
SPEC.md	Especificação funcional e técnica do app Delphi
PLAN.md	Plano de implementação por fases
TASKS.md	Backlog executável em checklist
SPRINTS.md	Sprints planejados e Definition of Done
DOCS.md	Regras de manutenção da documentação
REFERENCE.md	Comandos, paths, links e decisões técnicas

Build local

Para instalar sem compilar, baixe o pacote pronto em:

https://github.com/dex-agent/dex-deep/releases/latest

Veja INSTALL.md para o passo a passo.

Compilação validada localmente com:

call "C:\Program Files (x86)\Embarcadero\Studio\37.0\bin\rsvars.bat"
msbuild DeepSeekTuiLauncher.dproj /t:Make /p:Config=Debug /p:Platform=Win32

O executável gerado é:

DeepSeekTuiLauncher.exe

Guia completo: INSTALL.md.

Execução atual do TUI integrado

O caminho principal atual inicia o deepseek-tui em um console real do Windows embutido no painel principal do app. WebView2/xterm.js/node-pty não é mais dependência do app.

O fallback CMD externo continua disponível. O comando equivalente é:

cmd.exe /K cd /d "C:\CodexProjetos\dex-deep" && "%APPDATA%\npm\deepseek-tui.cmd"

Configuração local

O app persiste configurações em:

%LOCALAPPDATA%\DexDeep\config.ini

Itens persistidos:

• path do deepseek-tui.cmd;
• diretório de trabalho;
• largura/estado do painel esquerdo;
• modo preferido: terminal integrado ou fallback CMD.

Resultado atual do produto

O app permite que uma pessoa técnica:

• use o deepseek-tui em terminal integrado dentro do app;
• mantenha fallback para abrir rapidamente o deepseek-tui em CMD externo;
• rode comandos úteis sem decorar sintaxe;
• remova projetos da lista lateral sem apagar os arquivos do workspace;
• reinicie rapidamente com deepseek-v4-pro, deepseek-v4-flash ou modo YOLO;
• instale ou atualize o pacote npm com confirmação;
• valide o ambiente com comandos de versão e diagnóstico;
• use um painel esquerdo redimensionável e recolhível;
• abra/oculte uma janela de status sem ocupar a área principal do terminal;
• mantenha presets e configurações persistidos localmente.

Fora do escopo atual

• Automatizar interações internas do TUI.
• Distribuir instalador Windows.
• Empacotar instalador/Node runtime.

Publicação

O repositório está público em:

https://github.com/dex-agent/dex-deep

Ele pode ser mantido público porque secrets, runtime local e artefatos regeneráveis ficam fora do Git via .gitignore, incluindo .env, .deepseek/, .agents/, node_modules/, *.exe, *.dcu, Win32/ e Win64/.