Update model card with corrected TB2-lite evaluation

README.md

@@ -1,59 +1,143 @@
 ---
-base_model: Qwen/Qwen3.5-2B
+language:
+- en
+- ko
 library_name: transformers
-model_name: Qwen__Qwen3.5-2B__terminal_sft_2epoch_fullft_samecount
+pipeline_tag: text-generation
 tags:
-- generated_from_trainer
-- unsloth
-- trl
+- terminal
 - sft
-licence: license
+- vllm
+- tb2-lite
+base_model: Qwen/Qwen3.5-2B
 ---
 
-# Model Card for Qwen__Qwen3.5-2B__terminal_sft_2epoch_fullft_samecount
+# LLM-OS-Models/Qwen3.5-2B-Terminal-SFT-2Epoch-FullFT-SameCount
+
+터미널 작업 자동화를 위한 Terminal SFT 모델입니다. 입력된 작업/이전 터미널 상태를 보고 다음에 실행할 명령을 JSON 형태로 생성하는 용도로 학습했습니다.
 
-This model is a fine-tuned version of [Qwen/Qwen3.5-2B](https://huggingface.co/Qwen/Qwen3.5-2B).
-It has been trained using [TRL](https://github.com/huggingface/trl).
+## 모델 요약
 
-## Quick start
+- Base model: `Qwen/Qwen3.5-2B`
+- Training setup: `2 epochs, full fine-tuning, same-count data setting`
+- Evaluation snapshot: `2026-05-07 22:36:47 UTC`
+- Evaluation result id: `qwen35_2b_sft_samecount_e2`
+
+## 사용 방법
+
+Transformers 예시:
 
 ```python
-from transformers import pipeline
+from transformers import AutoModelForCausalLM, AutoTokenizer
+import torch
+
+model_id = "LLM-OS-Models/Qwen3.5-2B-Terminal-SFT-2Epoch-FullFT-SameCount"
+tokenizer = AutoTokenizer.from_pretrained(model_id, trust_remote_code=True)
+model = AutoModelForCausalLM.from_pretrained(
+    model_id,
+    torch_dtype=torch.bfloat16,
+    device_map="auto",
+    trust_remote_code=True,
+)
 
-question = "If you had a time machine, but could only go to the past or the future once and never return, which would you choose and why?"
-generator = pipeline("text-generation", model="None", device="cuda")
-output = generator([{"role": "user", "content": question}], max_new_tokens=128, return_full_text=False)[0]
-print(output["generated_text"])
+messages = [
+    {"role": "system", "content": "You are a terminal automation assistant. Return JSON only."},
+    {"role": "user", "content": "List the current directory and identify Python files."},
+]
+prompt = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
+inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
+outputs = model.generate(**inputs, max_new_tokens=512, do_sample=False)
+print(tokenizer.decode(outputs[0][inputs.input_ids.shape[-1]:], skip_special_tokens=False))
 ```
 
-## Training procedure
+vLLM 예시:
 
- 
+```python
+from vllm import LLM, SamplingParams
+from transformers import AutoTokenizer
 
+model_id = "LLM-OS-Models/Qwen3.5-2B-Terminal-SFT-2Epoch-FullFT-SameCount"
+tokenizer = AutoTokenizer.from_pretrained(model_id, trust_remote_code=True)
+llm = LLM(model=model_id, dtype="bfloat16", trust_remote_code=True)
+messages = [{"role": "user", "content": "Show disk usage for the current folder."}]
+prompt = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
+result = llm.generate([prompt], SamplingParams(temperature=0.0, max_tokens=512))
+print(result[0].outputs[0].text)
+```
 
-This model was trained with SFT.
+권장 출력 형식:
 
-### Framework versions
+```json
+{
+  "analysis": "brief reasoning about the next terminal action",
+  "plan": "short execution plan",
+  "commands": [
+    {"keystrokes": "ls -la\n", "duration": 0.1}
+  ],
+  "task_complete": false
+}
+```
 
-- TRL: 0.24.0
-- Transformers: 5.5.0
-- Pytorch: 2.10.0
-- Datasets: 4.3.0
-- Tokenizers: 0.22.2
+## 평가 결과
 
-## Citations
+평가는 corrected TB2-lite replay set에서 vLLM으로 수행했습니다. 순위 점수는 `100 * avg_command_f1`만 사용하고, `first_cmd_exact_pct`는 보조 지표로만 봅니다.
 
+- Rank: `1 / 41`
+- Score: `39.52`
+- Command F1: `0.3952`
+- Command precision: `0.5082`
+- Command recall: `0.4101`
+- First command exact: `33.0%`
+- Valid JSON: `82.2%`
+- Steps / tasks: `303 / 50`
+- Template status: `chat_template`
+- Rank eligible: `True`
+- Eval timestamp: `2026-05-07T22:06:25.457045`
+- 현재 집계된 평가 결과 수: `41`
 
+재현 명령 예시:
 
-Cite TRL as:
-    
-```bibtex
-@misc{vonwerra2022trl,
-	title        = {{TRL: Transformer Reinforcement Learning}},
-	author       = {Leandro von Werra and Younes Belkada and Lewis Tunstall and Edward Beeching and Tristan Thrush and Nathan Lambert and Shengyi Huang and Kashif Rasul and Quentin Gallou{\'e}dec},
-	year         = 2020,
-	journal      = {GitHub repository},
-	publisher    = {GitHub},
-	howpublished = {\url{https://github.com/huggingface/trl}}
+```bash
+python tb2_lite/scripts/replay_eval.py \
+  --model LLM-OS-Models/Qwen3.5-2B-Terminal-SFT-2Epoch-FullFT-SameCount \
+  --model-short qwen35_2b_sft_samecount_e2 \
+  --eval-path tb2_lite/data/replay_full.jsonl \
+  --output-dir /home/work/.data/tb2_lite_eval/corrected_readme_models_vllm \
+  --dtype bfloat16 \
+  --max-model-len 49152 \
+  --max-tokens 1024 \
+  --temperature 0.0 \
+  --top-p 1.0 \
+  --gpu-memory-utilization 0.94 \
+  --language-model-only
+```
+
+Prompt/template audit:
+
+```json
+{
+  "template_status": "chat_template",
+  "rank_eligible": true,
+  "steps": 303,
+  "tasks": 50
 }
-```
+```
+
+## 장점
+
+- 현재 corrected TB2-lite 기준 상위권 점수이며, 터미널 명령 재현 안정성이 높습니다.
+- 잘못된 명령을 많이 내기보다 보수적으로 맞는 명령을 내는 경향이 있습니다.
+- Qwen 계열은 이번 평가에서 명령 JSON 안정성과 command F1이 전반적으로 강했습니다.
+
+## 한계와 주의사항
+
+- recall이 상대적으로 낮아 필요한 명령 일부를 빠뜨릴 수 있습니다.
+- JSON 형식 실패가 있어 실행 전에 파싱 검증/재시도가 필요합니다.
+- 이 모델은 자동 터미널 조작 보조용 SFT 모델이며, 일반 대화/범용 추론 성능을 보장하지 않습니다.
+- 생성 명령은 실제 실행 전에 sandbox, allowlist, human review 같은 안전장치를 거쳐야 합니다.
+
+## 해석 메모
+
+TB2-lite 점수는 일반 지능 벤치마크가 아니라 터미널 next-action JSON 재현 능력을 측정합니다. 따라서 모델 크기, chat template 일치, assistant-only masking, tokenizer, 학습 데이터 holdout 여부가 모두 점수에 영향을 줍니다.
+
+README.md와 MODEL_EVALUATION_REPORT.md의 값이 더 최신이면 해당 값을 우선 확인하세요. 이 모델카드는 완료된 평가 JSON을 기준으로 개별 저장소에 빠르게 반영한 스냅샷입니다.