Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[Feature] macOS 项目 JDK / Maven 只保留 local.json 一份存储，移除 UserDefaults 副本

Aperta
  • Qualcosa non va?
#818 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
java, macos, typescript
Ambito
build-system, desktop, tooling

Direzione di ricerca

Trace macOS toolchain reads through Core runConfig.inspect, ProjectRuntimeService.adoptProjectToolchain, ProjectRuntimeSettings, ProjectLoadState.hasLoadedDocuments, and MavenService. Review the migration cases and existing tests, then run ./scripts/test-macos.sh and ./scripts/verify-service-boundaries.sh; done requires one source of truth, migration coverage, updated architecture notes, and real Mac validation.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement review: high

问题

macOS 上项目 JDK、Maven、Maven JDK 仍然存了两份：

  1. .lithe/run/local.json 的 toolchain：运行配置实际使用，Windows 与 Core 也以它为准；
  2. UserDefaults lithe.project-runtime-settings.<项目路径> 里的 ProjectRuntimeSettings：设置页表单、Maven 进程环境、环境检查使用。

#809 定下了「local.json 为唯一真源，UserDefaults 只是副本」，靠一组同步规则维持一致：

  • 运行配置读完项目文档后，ProjectRuntimeService.adoptProjectToolchain 以 local.json 覆盖副本；
  • 本机层从未保存过默认值时，保留副本，下次保存时写入；
  • 服务编辑器保存写 savedProjectToolchain ?? 副本；
  • 设置表单准备完成前禁用，关闭时只在准备完成后保存；
  • 运行文档未读完时不写 local.json（ProjectLoadState.hasLoadedDocuments）。

#809 审查中修复的问题，多数出在这两份数据之间的同步时序上：加载中保存空值、旧副本反向覆盖、编辑器写入空默认值、准备期间的修改被还原。只要还有两份，这类问题就可能再出现。

期望

  • macOS 读取项目 JDK、Maven、Maven JDK 的地方（javaHomeURL、mavenJavaHomeURL、mavenExecutable、设置表单）直接读 local.json 的 toolchain（经 Core runConfig.inspect），UserDefaults 不再保存这三个字段。
  • 一次性迁移：local.json 没有 toolchain、而 UserDefaults 里有值时，把它写入 local.json，然后清除 UserDefaults 中的这三个字段。迁移只执行一次，失败时保留原值并报告。
  • 迁移完成后删除只为同步存在的代码：adoptProjectToolchain、savedProjectToolchain ?? 副本 的回退、mergeImportedSettings 中这三个字段的补齐逻辑等。
  • 同时梳理 ProjectRuntimeSettings 里的 Maven settings.xml 与本地仓库路径：它们和 MavenService 自己的本机配置也是两份，应明确由 Maven 本机配置持有。

风险

  • 涉及 macOS 启动、Maven 进程、环境检查的 JDK 来源，必须在 Mac 上实机验证：运行、Maven 目标、测试运行、切换项目、首次打开未生成配置的项目。
  • 迁移需要覆盖：只有 UserDefaults、只有 local.json、两边都有且不同、local.json 损坏。

验收

  • macOS 这三个字段只有 local.json 一个存储
  • 一次性迁移覆盖上述四种情况，并有测试
  • 删除同步用代码，Run / Maven / 环境检查读取同一来源
  • Maven settings.xml / 本地仓库路径只有一个持有方
  • ./scripts/test-macos.sh 与 ./scripts/verify-service-boundaries.sh 通过，实机验证通过
  • 更新 .agents/notes/implemented/architecture/2026-09-21-maven-settings-reach-the-language-server.md 中的真源规则

背景

来自 #809（关联 #749）合并前的评审，属于长期可维护性问题，范围大于 #809，故单独处理。

Lingua principale
TypeScript
Stelle
1.8k
Fork
151
Merge medio
11h 27m
PR unite (30g)
310

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di 1lck/Lithe-IDEA

Tutte le issue di 1lck/Lithe-IDEA

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.