[ Novo Plugin ] Ulanzi Hydro Tracker
Olá, @Ulanzi! e toda a Comunidade! 👋Acabei de lançar um novo plugin para o UlanziDeck: o Hydro Tracker — um coach de hidratação pessoal numa única tecla. Você configura seu perfil e ele te mantém bebendo água ao longo do dia sem precisar pensar nisso.
🔗 GitHub: https://github.com/JEAN-ALMEIDA-CZO/Hydro-Tracker-Plugin
✨ O que ele faz
Meta diária personalizada — calculada a partir da sua faixa etária, peso e tamanho do recipiente, dividida em copos igualmente espaçados ao longo das horas ativas.
Anel de contagem regressiva na tecla — mostra o tempo até o próximo copo (mm:ss).
Pressione a tecla quando beber — a contagem reinicia para o próximo copo; os pontinhos marcam seu progresso.
Quatro estados claros: 🔵 HIDRATAR → 🔵 BEBER → 🔴 BEBA! (piscando) → 🟢 PRONTO (a tecla enche de água ao bater a meta).
Notificações no desktop no Windows + macOS quando é hora de beber e ao atingir a meta.
Modo Verão (+15% em dias quentes) e Silêncio (sem avisos à noite).
5 temas, fontes vetoriais e animações suaves de água (ondas, gota caindo, maré).
Unidades do recipiente: ml, L ou oz.
🔬 Baseado num modelo real de hidratação
A meta não é um número aleatório — usa uma regra transparente baseada no peso (Adulto 35 ml/kg/dia, Criança 50 ml/kg/dia, +15% para o calor), a mesma lógica usada para fluidos de manutenção. As fontes são citadas no tutorial embutido (EFSA 2010; Holliday–Segar 1957).
🌍 Totalmente traduzido — 11 idiomas
Inglês · Português (BR/PT) · Espanhol · Francês · Alemão · Italiano · 日本語 · 한국어 · 中文 (简体/繁體). A interface, o menu lateral, as notificações e o tutorial moderno embutido seguem automaticamente o seu idioma.
🛠️ Bem construído
Multiplataforma — funciona no Windows e macOS, sem caminhos fixos.
Sem binários nativos — dependências em JavaScript puro, totalmente portátil e compatível com a loja.
Roda 100% localmente — sem contas, sem chaves de API, sem telemetria.
Leve: a tecla parada/rodando quase não pesa na CPU.
💾 Instalação
Baixe no repositório do GitHub (o README tem o passo a passo para Windows e macOS)
Vou adorar o feedback de vocês — ideias de recursos, bugs ou correções de tradução são muito bem-vindos aqui ou como issues no GitHub. Se for útil pra você, uma ⭐ no repositório ajuda demais. Mantenham-se hidratados! 💧
— Jean Almeida
官方致谢 & 四连致敬！@持续贡献者 Jean Almeida 为Ulanzi Studio 生态 开发 第四款 插件！这一次是【 Hydro Tracker】
当我们在论坛上看到 Hydro Tracker 时，忍不住赞叹，这个插件用代码让一台生产力工具，拥有了“关心人”的温度。如果说前三款插件是在帮用户“做得更高效”，那么这款 Hydro Tracker，是在帮用户“活得更好” ，而您做到了，在一个小小的 LCD 按键上。硬核的科学内核，藏在温柔的提醒背后～一个按键，四种状态，全程沉浸
[*]HYDRATE（待饮）→ DRINK（倒计时中）→ DRINK！（时间到，按键闪烁）→ DONE（目标达成，按键满屏绿光）
[*]这不是功能，这是互动叙事。喝水这件事，被设计成了一场看得见的旅程。
最后的最后，想说一句谢谢你，Jean。谢谢你用四款插件，告诉我们一个道理：
一个好的硬件平台，不是因为硬件本身有多强，而是因为它遇到了愿意为它注入灵魂的开发者。期待您的第五款。无论是什么，我们都会在这里，第一个为你鼓掌。——Ulanzi Studio 生态团队
Hello, after thoroughly testing this plugin, I’ve encountered some issues and have some thoughts I’d like to discuss.
We can go ahead and launch the current version for now, and we’ll make further improvements if there are updates later.
https://github.com/JEAN-ALMEIDA-CZO/Hydro-Tracker-Plugin/issues/1
@Ulanzi!
Hydro Tracker — atualização 1.0.1
Obrigado pelo feedback detalhado! Saiu uma atualização com melhor uso de CPU, correção de bug e um novo modelo de lembretes mais saudável. O que mudou:
💦 Lembretes por goles (novidade — resolve o intervalo longo)
Antes, o intervalo entre lembretes crescia com o tamanho do recipiente (ex.: 70 kg + 500 mL = 192 min entre goles — tempo demais). Só que um copo não é bebido de uma vez, e sim em goles.
Agora o intervalo é desacoplado do recipiente: gaps longos são divididos em goles, cada lembrete num ritmo confortável. Cada toque na tecla = 1 gole; o copo (pontinho) enche depois dos goles.
Novo ajuste "Ritmo dos lembretes": Frequente (~30 min) · Equilibrado (~45 min, padrão) · Tranquilo (~60 min) · Por recipiente (comportamento antigo).
Exemplo real: 70 kg + 500 mL agora lembra a cada ~38 min (antes 192); 200 mL a cada ~37 min (antes 74). Independente do recipiente.
⚡ Menos CPU
Cache dos dígitos vetoriais (mm:ss) — o redraw de 1×/s ficou quase de graça.
Quadros idênticos não são reenviados ao deck.
Taxas de animação reduzidas (gota/anel/alerta) — suave e mais leve. Tecla parada praticamente não gasta CPU.
🐛 Correção
A gota d'água piscava ao arrastar/mover a tecla para outra posição. Corrigido — agora há uma única instância viva por ação.
📖 Tutorial atualizado (fórmula, ritmo dos lembretes e versão) em todos os 11 idiomas.
Continua tudo local, sem contas nem telemetria.
— Jean Almeida Ulanzi 发表于 2026-6-24 11:54
Hello, after thoroughly testing this plugin, I’ve encountered some issues and have some thoughts I ...
Olá @Ulanzi, notei que este plugin ainda não foi publicado, já foi atualizado e corrigido os problemas, versão 1.0.1 estável , poderia validar e estar publicando o plugin?
darkdomi 发表于 2026-7-25 12:00
Olá @Ulanzi, notei que este plugin ainda não foi publicado, já foi atualizado e corrigido os pr ...
Hello, we have received the update notification for this plugin and have reviewed it. We plan to release it next Monday.
Ulanzi 发表于 2026-7-25 20:40
Hello, we have received the update notification for this plugin and have reviewed it. We plan to r ...
Muito Obrigado , Fico muito feliz em poder contribuir
本帖最后由 darkdomi 于 2026-7-31 05:30 编辑
HYDRO TRACKER — Plugin para UlanziDeck
Notas da Versão — Versão 1.0.2
VISÃO GERAL
A versão 1.0.2 representa um refinamento significativo na forma como o Hydro
Tracker modela a ingestão de água, é operado pela tecla e apresenta informações.
A versão anterior tratava um recipiente como uma única ação e reiniciava a
contagem regressiva a cada pressionamento, o que não correspondia à forma como
as pessoas realmente bebem. Esta versão reconstrói esse modelo em torno de
goles reais, adiciona um contador claro de goles na tecla, separa as ações
"um gole" e "um copo", corrige o tamanho do gole para crianças, melhora a
exibição do tempo em intervalos longos e preserva uma contagem regressiva em
andamento quando uma tecla é movida.
Nada precisa ser reconfigurado; as teclas existentes mantêm suas configurações e
adotam automaticamente o novo comportamento.
1. MODELO DE GOLES BASEADO EM VOLUME
Agora não se presume mais que um recipiente seja esvaziado em uma única ação.
Ele passa a ser dividido em goles com base em seu volume real, usando uma
deglutição média de aproximadamente 20 ml. Um copo de 200 ml, portanto,
corresponde a cerca de 10 goles, o que corresponde a uma sessão de ingestão
real medida.
O número de goles por recipiente é controlado pela configuração "Ritmo do
lembrete", que agora seleciona o TAMANHO DO GOLE em vez de uma frequência
abstrata:
Frequente .......... goles pequenos, ~15 ml cada
Equilibrado ........ ~20 ml cada (padrão)
Relaxado ........... goles grandes, ~30 ml cada
Recipiente inteiro . um único pressionamento registra todo o recipiente
O menu suspenso do inspetor de propriedades agora mostra cada opção junto com
seu valor em mililitros, no formato "nome — N ml" (por exemplo,
"Equilibrado — 20 ml"), para que o efeito da configuração fique explícito no
momento da escolha.
2. TAMANHO DO GOLE PARA CRIANÇAS (CORREÇÃO)
Crianças dão goles visivelmente menores do que adultos. Quando a faixa etária é
definida como "Criança", o tamanho do gole agora é limitado a 20 ml, mesmo no
ritmo "Relaxado". Na prática, isso significa que, para uma criança, o menu de
ritmo exibe:
Frequente — 15 ml
Equilibrado — 20 ml
Relaxado — 20 ml (limitado; seria 30 ml para um adulto)
Recipiente inteiro
Isso afeta apenas a granularidade dos goles e o contador exibido na tecla; não
altera a meta diária de água, que continua usando a regra infantil de
50 ml/kg/dia.
3. CONTADOR DE GOLES NA TECLA
A tecla agora mostra o quanto você já avançou no copo atual. Acima do
temporizador, é exibida uma pequena indicação numérica "n / N"
(goles dados / goles deste copo) ao lado de uma bolinha que é preenchida gole a
gole. Ambos ficam juntos na parte superior do anel, espelhando o rótulo de
estado exibido abaixo do temporizador.
O contador é mostrado apenas enquanto um copo está em andamento. Ele fica
oculto no estado ocioso e no modo "Recipiente inteiro", em que um copo equivale
a um único pressionamento e a divisão em goles não acrescentaria informação.
4. INTERAÇÃO COM A TECLA: PRESSIONAMENTO CURTO vs. PRESSIONAMENTO LONGO (ALTERADO)
A ação de um único pressionamento foi dividida em duas, para separar "Eu dei um
gole" de "Eu terminei um copo":
PRESSIONAMENTO CURTO = um gole.
-Avança o contador e preenche a bolinha. A contagem
-regressiva NÃO é reiniciada; ela continua até
-terminar por conta própria. Dar o último gole de um
-recipiente conclui o copo.
PRESSIONAMENTO LONGO = um copo inteiro (segure por ~1,5 s).
-Registra um recipiente completo de uma só vez,
-preenche um ponto de progresso e reinicia a contagem
-regressiva para o próximo copo.
Isso resolve o comportamento anterior, em que cada pressionamento reiniciava o
temporizador. Se a sua versão do UlanziDeck não emitir eventos de tecla
pressionada continuamente, cada pressionamento será simplesmente tratado como um
gole; nenhuma funcionalidade será perdida.
5. CONTAGEM REGRESSIVA POR COPO
A contagem regressiva agora representa o intervalo para um copo completo e não é
mais recalculada para cada gole individual. O intervalo é obtido distribuindo a
meta diária ao longo de uma janela ativa de 16 horas (um copo a cada
"16 h / número de copos"). Registrar um gole não altera essa contagem
regressiva; apenas concluir um copo a reinicia.
6. EXIBIÇÃO DO TEMPO PARA INTERVALOS LONGOS
Abaixo de uma hora, o temporizador continua sendo exibido em minutos e segundos
(mm:ss), como antes. Para intervalos de uma hora ou mais, ele passa a usar um
formato compacto de horas e minutos (por exemplo, "1:14" em vez de "74:00"), com
os segundos exibidos um pouco menores no canto superior direito, para que
permaneçam visíveis sem dominar a leitura.
7. CONTAGEM REGRESSIVA PRESERVADA AO MOVER UMA TECLA (CORREÇÃO)
Uma contagem regressiva em andamento, incluindo o progresso dos goles, agora é
preservada pelo identificador da ação. Mover a tecla para outro slot ou trocar
de página e voltar não limpa mais a contagem regressiva; ela é retomada com o
tempo restante correto.
8. O ANEL ANIMADO NÃO FAZ MAIS A TECLA PISCAR (CORREÇÃO)
Selecionar um anel animado ("Glow" ou "Tide") enquanto a contagem regressiva
estava em andamento podia fazer a tecla piscar. O deck redesenha toda a imagem
da tecla a cada atualização, e a animação estava enviando quadros com muita
frequência (cerca de seis por segundo), fazendo com que a atualização da
contagem regressiva, executada uma vez por segundo, coincidisse com um quadro da
animação e produzisse dois redesenhos completos em sequência. A animação do
anel em execução agora funciona em um ritmo mais suave, e a atualização por
segundo não envia mais um quadro duplicado, de modo que a tecla é atualizada de
forma fluida. O anel estático "Clean" permanece inalterado.
9. LOCALIZAÇÃO E DOCUMENTAÇÃO
- O resumo do inspetor de propriedades informa a meta diária, o número de
copos, os goles por copo e o intervalo por copo.
- Os textos da interface foram atualizados em todos os 11 idiomas suportados:
inglês, português (Brasil e Portugal), espanhol, francês, alemão, italiano,
japonês, coreano e chinês (simplificado e tradicional).
- O tutorial integrado documenta o modelo de goles, o mapeamento entre tamanho
do gole e mililitros, o limite para crianças e a interação entre
pressionamento curto e pressionamento longo em inglês e português; os demais
idiomas receberam a atualização dos rótulos de ritmo.
OBSERVAÇÃO SOBRE A ATUALIZAÇÃO
Após atualizar, reinicie completamente o UlanziDeck pela bandeja do sistema para
que a versão revisada do plugin seja recarregada. Nenhuma reconfiguração é
necessária.
页:
[1]