openai / openai/codex

Codex Desktop on Windows — permitted mechanism for exclusive file creation

Open
#44,082 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app documentation tool-calls windows-os
Dominant language
Rust
Stars
125k
Forks
19.4k
PR merge metrics
PR metrics pending

Description

What is the type of issue?

Documentation is missing

What is the issue?

Olá, equipa Codex,

Solicito esclarecimento técnico sobre uma forma oficialmente suportada de criar ficheiros no Codex Desktop para Windows, sem substituir ficheiros existentes.

O fluxo pretendido tem duas partes:

  • Criar 16 cópias de ficheiros de texto, preservando inicialmente exatamente os bytes das fontes.
  • Criar dois documentos novos, com conteúdo e codificação previamente definidos.

As fontes devem permanecer inalteradas. Só depois da importação integral e da verificação das cópias começariam as alterações posteriores, numa fase separada.

As instruções aplicáveis à nossa sessão exigem apply_patch para a edição local e incluem esta exceção:
“Formatting commands and bulk mechanical rewrites do not need apply_patch.”

Precisamos de esclarecer:

  1. Esta exceção abrange a importação automática de cópias byte-idênticas para destinos novos, sem transformação do conteúdo? Não estamos a assumir que uma cópia seja automaticamente uma reescrita mecânica.

  2. Independentemente da resposta anterior, qual mecanismo permitido pode criar também os dois documentos de conteúdo novo? Uma solução que cubra apenas as 16 cópias não resolve o fluxo completo.

  3. Qual é a ferramenta, opção, versão e rota de execução suportada no Codex Desktop para Windows? Uma garantia da API apply_patch numa aplicação própria, ou apenas do Codex CLI, não demonstra necessariamente o comportamento da ferramenta usada pelo Desktop.

A proteção necessária é a seguinte:

  • A criação deve falhar atomicamente se o destino já existir, incluindo quando outro processo o cria depois da verificação prévia de ausência.
  • O objeto existente não pode ser truncado, substituído ou modificado.
  • Um simples precheck de existência não basta.
  • Nas cópias, devem ser preservados exatamente os bytes das fontes; nos documentos novos, devem ser escritos os bytes previamente definidos.
  • Solicitamos as garantias e limitações documentadas relativas a symlinks/reparse points no destino e nos diretórios ascendentes.
  • Uma colisão ou falha deve produzir um resultado inequívoco, sem fallback para sobrescrita.
  • Se o lote ficar parcial, os ficheiros já criados devem ser identificados e preservados, sem substituição, rollback ou retry destrutivo.

Não exigimos uma transação atómica para todo o lote: a exclusividade é por destino.

Se existir uma via suportada, agradecemos a identificação concreta do mecanismo e referências oficiais sobre o seu contrato, implementação e testes relevantes no Windows. Manteremos apply_patch nas alterações em que continue obrigatório.

Se não existir, agradecemos confirmação explícita da limitação e indicação de se é necessária uma clarificação das regras de utilização ou uma alteração da ferramenta.

Este é um pedido de esclarecimento de capacidade, não uma alegação de perda de dados. Não pedimos desativação do sandbox, permissões irrestritas ou qualquer contorno das regras da plataforma.

Agradecemos o encaminhamento para os responsáveis pelo contrato das ferramentas do Codex, se necessário.

Obrigado.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files or tests are named. Start with the Codex Desktop for Windows execution path and the documented apply_patch exception, then determine whether an officially supported exclusive-create mechanism exists. Done means documenting the mechanism and its guarantees, or explicitly confirming the limitation and required rule or tool changes.

Written by the indexing model from the issue text.

Assessment

Domain
desktop, tooling
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.