aio-01d4-stu/Last3Mon/75/tcost/Doc/IMP-PLAN.md

tcost IMP-PLAN

엔진 1단계 · 단가와 토큰 (R1 · R2 · R3 · R13)

• prices.load(): checked · source · models, --prices · $TCOST_PRICES · ~/.tcost/prices.json · 함께 든 파일
• Prices.cost(model, in, out): (in × input + out × output) / 1,000,000, 소수 8자리
• warning(): 30일 넘었거나 날짜가 없으면 알림
• tokens.count(): tiktoken o200k_base, 이 컴퓨터에서 (API를 부르지 않음)
• cli: tcost count <파일 · 폴더> [--out N] [--model M]
• tests: 1,000토큰 × 0.40 = $0.0004, --out 100 더하기, 날짜 경고
• 확인: uv run pytest -q, uv run tcost count <지시문 파일> --out 100

엔진 2단계 · 보고서 모으기 · 한 달 (R5 · R6)

• usage.collect(paths): runs/*.json에서 usage.by_step이 있는 결과만, 없는 것은 skipped
• 합 · 요청 수 · 호출 수, 모델별 · 사람별 · 시간대별(파일 이름의 시각)
• month(per_day, days): 평균 × 하루 요청 × 일하는 날
• cli: tcost usage <폴더> [--per-day 1000 --days 22]
• tests: 결과 3개 중 400 하나 skipped, 사람별 합, 한 달
• 확인: uv run tcost usage ~/aio-01d4-stu/Last3Mon/75/runs --per-day 1000

TUI 1단계 · 탭 셋 (R8)

• Prompts: 글 파일 · 워크플로우 LLM 단계마다 토큰, 모델별 1,000번 비용
• Usage: 보고서 합 · 모델별 · 사람별 표, 시간대별 막대
• Compare: 토큰이 많은 지시문 열 개를 모델별로 (출력 100 가정)
• 엔진은 고치지 않고 불러 쓰기만, [r] 다시 읽기
• tests: run_test로 세 탭이 채워짐
• 확인: uv run tcost ~/aio-01d4-stu/Last3Mon/75/reference ~/aio-01d4-stu/Last3Mon/75/runs

설치 (R14)

• [project.scripts] tcost = "tcost.cli:main", 단가 파일을 wheel에 함께
• uv tool install --editable ., /tmp에서 tcost --help

엔진 3단계 · 워크플로우 · 비교 · 모르는 모델 (R4 · R7 · R12)

• workflow.llm_steps(): HTTP chat/completions 노드의 jsonBody에서 모델 · system 글 · max_completion_tokens, AI Agent 노드도
• cli: tcost workflow <파일 · 폴더>, tcost compare <파일> --model a --model b
• 단가표에 없는 모델은 0원이 아니라 오류(알려진 목록)
• tests: baseline Answer 1,000토큰 넘음 · lean 200 아래, gpt-9 → 종료 코드 2

엔진 4단계 · 예산 · 다른 프로그램 · 폴더 (R9 · R10 · R11)

• cli: tcost budget <달러> <파일> 모델별 하루 몇 번
• --json, --max-usd: 넘으면 종료 코드 1, 오류 2
• scan(): .txt · .prompt 글 (.md 문서는 skipped), nodes · connections 워크플로우, results 보고서, 나머지 skipped
• tests: 테스트 파일은 skipped, 긴 글 --max-usd 0.0002 → 1