Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto
  • ¿Algo no está bien?
#818 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
java, macos, typescript
Área
build-system, desktop, tooling

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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，故单独处理。

Lenguaje dominante
TypeScript
Estrellas
1.8k
Forks
151
Merge medio
8 h 24 min
PR fusionados (30 d)
345

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de 1lck/Lithe-IDEA

Todos los issues de 1lck/Lithe-IDEA

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.