Skip to content

model profile 저장소 위치와 XGENY_CONFIG_HOME을 문서에 명시 - #61

Merged
Createyouracccount merged 1 commit into
mainfrom
feat/config-home-docs-20260907
Sep 6, 2026
Merged

model profile 저장소 위치와 XGENY_CONFIG_HOME을 문서에 명시#61
Createyouracccount merged 1 commit into
mainfrom
feat/config-home-docs-20260907

Conversation

@Createyouracccount

Copy link
Copy Markdown
Member

배경

격리된 측정(2026-09-07 vLLM dry run)에서 XGENY_STATE_HOME만 설정하고 model setup을 실행하자 사용자의 실제 프로필 저장소(~/Library/Application Support/XGENy/model-profiles.json)에 vllm 프로필이 생기고 active가 바뀌었다. 프로필 저장소는 state root가 아니라 XGENY_CONFIG_HOME이 정하는 config root를 쓴다(model_profile.rs::discover_config_root). 이 변수는 코드와 통합 테스트(model_profiles.rs, environment_onboarding.rs, interactive_repl.rs)에만 있고 사용자·개발 문서 어디에도 없었다.

변경 사항

  • docs/getting-started.md 삭제 절: profile 파일의 platform 경로(Linux $XDG_CONFIG_HOME/xgeny·$HOME/.config/xgeny, macOS $HOME/Library/Application Support/XGENy, Windows %APPDATA%\XGENy), XGENY_STATE_HOME은 profile 위치를 바꾸지 않는다는 사실, credential까지 지우려면 model remove를 먼저 실행하라는 안내.
  • docs/development/model-onboarding.md Profile 관리 절: XGENY_CONFIG_HOME과 검증 규칙(절대경로, home/config base directory와 ./.. 거부, Unix 0700), 격리 실험에서 저장소를 건드리지 않는 두 방법(XGENY_CONFIG_HOME 병행 설정 또는 --base-url/--model/--tokenizer 명시).
  • docs/development/public-local-run-resume.md 실행 절: 두 변수가 독립이라는 한 문장.

코드 변경 없음.

실제로 동작하게 된 것

문서만 바뀌었다. 사용자가 격리 test나 measurement를 만들 때 실제 프로필 저장소를 오염시키지 않는 방법을 문서에서 찾을 수 있다.

데이터 경계

변화 없음. 저장소 경로와 권한 검증은 ADR-0032 그대로다.

검증

  • XGENY_CONFIG_HOME에 0700 빈 directory를 주고 model listNo model profiles configured, 실제 저장소(default, qwen38 active)는 그대로.
  • 0755 directory → FAIL reason=profile_store_unavailable (exit 69). 문서의 0700 규칙 문장과 일치.
  • sh scripts/check-rc3-public-docs.sh PASS.
  • Rust 소스 변경이 없어 cargo gate는 실행하지 않았다.

범위 밖

  • 프로필 저장소를 state root 아래로 옮기거나 XGENY_STATE_HOME을 따르게 하는 코드 변경(ADR-0032 경계 변경이라 별도 ADR 필요).
  • --help 문구에 config 경로를 넣는 것.

격리된 측정에서 XGENY_STATE_HOME만 설정하고 model setup을 실행하자 사용자의 실제
프로필 저장소에 profile이 생기고 active가 바뀌었다. 프로필 저장소는 state root가
아니라 XGENY_CONFIG_HOME이 정하는 config root를 쓰는데, 이 변수는 코드와 테스트에만
있고 사용자·개발 문서 어디에도 없었다.

getting-started의 삭제 절에 profile 파일의 platform 경로와 XGENY_STATE_HOME이
profile 위치를 바꾸지 않는다는 사실을, model-onboarding에 XGENY_CONFIG_HOME과
그 검증 규칙(절대경로, base directory 거부, Unix 0700)을, public-local-run-resume의
격리 안내에 두 변수가 독립이라는 문장을 넣었다.

실측: 0700 빈 directory를 XGENY_CONFIG_HOME으로 주면 model list가 빈 목록을
보이고 실제 저장소는 그대로다. 0755 directory는 profile_store_unavailable로 거부된다.
scripts/check-rc3-public-docs.sh PASS. 코드 변경 없음.
@Createyouracccount
Createyouracccount merged commit 8a28653 into main Sep 6, 2026
6 checks passed
@Createyouracccount
Createyouracccount deleted the feat/config-home-docs-20260907 branch September 6, 2026 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant