Pular para o conteúdo principal

Configuração e Personalização

O AI Short é de código aberto — você pode modificar livremente o título do site, descrição, prompts e muito mais.

Título e descrição do site​

Edite docusaurus.config.js.

Documentação e guias​

Edite os arquivos correspondentes em docs/.

Prompts da página inicial​

Os dados de origem estão em src/data/prompt.json — um array onde cada objeto armazena todas as versões de idioma indexadas pelo código do idioma (zh / en / ja, etc.). O formato para adicionar um prompt:

{
  "zh": {
    "title": "custom prompt",
    "prompt": "custom prompt",
    "description": "custom description",
    "remark": "custom mark"
  },
  "en": {
    "title": "custom prompt",
    "prompt": "custom prompt",
    "description": "custom description",
    "remark": "custom mark"
  },
  "website": null,
  "tags": ["music"],
  "id": 500,
  "weight": 1
}

Após editar, execute python CodeUpdateHandler.py. O script divide o prompt.json em arquivos prompt_<locale>.json por idioma e atualiza a página inicial e as páginas de prompts em destaque de cada idioma.

Pipeline de dados: o prompt.json mestre é processado pelo python CodeUpdateHandler.py — dividido por idioma em arquivos de prompt por localidade, gerando o JSON do cartão de cada id, com conversão de Chinês Simplificado para Tradicional via OpenCC

Nota: recomenda-se definir o id como 500 ou superior, para evitar conflitos de ID com prompts existentes ou conteúdo da comunidade. Executar python CodeUpdateHandler.py gera automaticamente os dados do cartão de cada prompt (incluindo os novos), enquanto scripts/genPromptPages.mjs gera os esqueletos de página, sem criação manual; prompts personalizados, por padrão, apenas não têm meta descrição selecionada nem dados de comentários.

Backend personalizado​

Por padrão, o projeto se conecta a um backend compartilhado (login, favoritos, comunidade, comentários e sincronização entre dispositivos dependem dele), e src/api documenta o contrato completo da interface como referência. O serviço de backend em si não é de código aberto; para uma implantação totalmente auto-hospedada com backend próprio, consulte Escolha um Modelo de Implantação acima.

Estrutura do módulo de API:

src/api/
├── index.ts       # unified export entry
├── config.ts      # API URL configuration
├── client.ts      # Axios client (with auth interceptor)
├── auth.ts        # auth API (login/register/OAuth)
├── prompts.ts     # prompt CRUD + search + voting
├── favorites.ts   # favorites operations
├── myspace.ts     # My Space data (core data source)
├── comments.ts    # comment system
├── user.ts        # user info
├── homepage.ts    # dados dos cartões da página inicial (apenas JSON estático, sem backend)
└── sessionCache.ts # rastros locais a limpar no logout (3 caminhos compartilham)

Cache: os dados da API são armazenados em cache de forma inteligente via lscache combinado com ETag — quando o servidor retorna 304 Not Modified, o cache local é reutilizado para reduzir a transferência de dados.

Última atualizaçãoem