SiYuan: software de gestão de conhecimento pessoal com foco em privacidade e auto-hospedagem

💡 Introdução

• SiYuan é um sistema de gestão de conhecimento pessoal que prioriza a privacidade, com suporte a referências granulares em nível de bloco e Markdown WYSIWYG.
• Mais informações podem ser encontradas no fórum de discussão em inglês do SiYuan.

🔮 Recursos

• A maioria dos recursos é oferecida gratuitamente e também pode ser usada para fins comerciais.
• Blocos de conteúdo: suporte a referências em nível de bloco e links bidirecionais, atributos personalizados, incorporação de consultas SQL e protocolo siyuan://.
• Editor: suporte a estilos de bloco, Markdown WYSIWYG, visão geral de listas, zoom em blocos, edição de documentos grandes, fórmulas matemáticas, gráficos, captura da web, links para anotações em PDF e mais.
• Exportação: permite exportar com referências e incorporações de blocos, para Markdown padrão, PDF, Word, HTML e outros formatos.
• Banco de dados: suporte a visualização em tabela, repetição espaçada de flashcards, escrita com IA e chat de perguntas e respostas via OpenAI API, Tesseract OCR e mais.
• Outros: oferece múltiplas abas, arrastar e soltar, snippets de template, snippets de JavaScript/CSS, apps para Android/iOS/HarmonyOS, implantação com Docker, API, marketplace da comunidade e mais.

🏗️ Arquitetura e ecossistema

• Projeto: composto por vários projetos que oferecem suporte a diversas plataformas e recursos.
• Exemplos: motor do editor, extensão para Chrome/Edge, marketplace da comunidade, repositório de dados, API de plugins e mais.

🌟 Histórico de estrelas

🗺️ Roadmap

• Inclui o plano de desenvolvimento do SiYuan, andamento e changelog.

🚀 Configuração de download

• Recomenda-se instalar pelos marketplaces de apps no desktop e no mobile.
• Marketplaces de apps: suporte para mobile (App Store, Google Play, F-Droid) e desktop (Microsoft Store).
• Pacotes de instalação: disponíveis via B3log e GitHub.
• Hospedagem com Docker: permite implantação simples em servidor usando Docker.

Hospedagem com Docker

• Explica como implantar o SiYuan em um servidor usando uma imagem Docker.
• Inclui estrutura de arquivos, entrypoint, configuração de permissões de usuário e mais.

Hospedagem com Unraid

• Explica como fazer a implantação via Unraid.

Insider Preview

• Lançamentos Insider Preview antes das principais atualizações.

🏘️ Comunidade

• Oferece fórum de discussão em inglês, resumo da comunidade de usuários, Awesome SiYuan e mais.

🛠️ Guia de desenvolvimento

• Consulte o guia de desenvolvimento.

❓ FAQ

Como o SiYuan armazena os dados?

• Os dados são armazenados na pasta do workspace, e diferentes pastas guardam recursos, emojis, snippets de código, condições de consulta, layouts, flashcards e mais.

Há suporte para sincronização de dados por meio de discos de sincronização de terceiros?

• A sincronização de dados por meio de discos de sincronização de terceiros não é suportada. Em vez disso, pode-se considerar exportar e importar os dados manualmente.

O SiYuan é open source?

• O SiYuan é totalmente open source, e contribuições são bem-vindas.

Como atualizar para uma nova versão?

• Se foi instalado por uma app store, é possível atualizar pela própria app store.

O que fazer se não for possível encontrar o ícone de alguns blocos?

• O primeiro subbloco de um item de lista omite o ícone do bloco.

O que fazer se a chave do repositório de dados for perdida?

• Se a inicialização correta tiver sido feita em vários dispositivos, a mesma chave poderá ser usada.

Tem custo?

• A maioria dos recursos é oferecida gratuitamente, mas as permissões de assinatura são pagas.

🙏 Agradecimentos

• O nascimento do SiYuan só foi possível graças a muitos projetos open source e contribuidores, e ele pôde crescer graças ao feedback e à divulgação dos usuários.

[GN⁺]

Comentários do Hacker News

• Se você já tem familiaridade com computadores e Unix, é importante aproveitar estrutura de diretórios, nomes de arquivos, arquivos de texto, listas e Markdown

  • Recomendam uma abordagem "file-first" e o uso de ferramentas Unix
  • Organizar com conceitos universais: lugares, coisas, pessoas, eventos, métricas, métodos etc.
  • Recomendam usar comandos Unix, make/justfiles, (rip)grep, git, fzf etc.
  • Sugerem não tentar resolver tudo pela web, mas focar em problemas básicos de gestão do conhecimento e produtividade
  • O problema de smartphone/tela sensível ao toque pode ser resolvido com um gerenciador de arquivos ou usando fzf no termux
  • Há interesse no recurso de "backlinks" e procuram uma ferramenta Unix que escaneie referências a outros arquivos em arquivos de texto

• Usa há alguns anos uma versão open source do Obsidian em um servidor doméstico

  • Falta documentação e é um pouco instável, mas a maior vantagem é poder usar de qualquer lugar no navegador
  • Foi desenvolvido por uma empresa chinesa, mas há poucas informações

• Gosta das tabelas com funcionalidades parecidas com as do Notion

  • Muita gente acha que precisa de um app um nível acima do Excel, mas na prática muitos apps não levam isso em conta

• Está profundamente investido no Logseq, e uma nova versão com banco de dados deve ser lançada em breve

  • Se não houver uma ferramenta para converter notas entre apps populares, só usuários novos ou com poucas notas vão adotar

• Recomenda o Trilium Notes e diz usá-lo com satisfação há alguns anos

  • Está em "modo de manutenção", o que é visto como vantagem por não adicionar recursos desnecessários
  • Permite self-hosting, tem ótimo webapp, cliente nativo opcional e funciona offline

• Usa uma abordagem simples para gestão do conhecimento

  • Guarda tudo no git e expande a estrutura de diretórios naturalmente com o tempo
  • No mobile, faz push para uma instância do gitea e pede recomendações de como ler notas no celular

• A licença é um pouco estranha

  • A sincronização self-hosted é um recurso pago, e o código inclui verificação de licença
  • Está sob licença AGPL, e a verificação de licença pode ser corrigida via patch

• Migrou do Joplin e está fazendo self-hosting há 3 meses, com boa experiência

  • Perdeu o acesso offline, mas considera mais expressivo e satisfatório
  • Não depende de outros containers Docker, e usa Authelia para autenticação
  • A interface web é adequada para uso no mobile

• Hospeda com Docker há 2 anos, e é estável

  • Há alguns bugs no Firefox, mas falta tempo para manutenção

• Falta o recurso de "herança de banco de dados" nesses apps, incluindo o Notion

  • Gostaria de criar um super banco de dados com propriedades básicas de tarefas, e bancos de dados filhos com propriedades adicionais por projeto
  • Gostaria de criar uma visualização única para ver todas as tarefas do dia em um só lugar