WEIFENG2333/phistory

Phistory – 코딩 에이전트 CLI용 프롬프트 기록 추적기

기능

• 인기 있는 AI 코딩 어시스턴트 명령줄 도구(Claude Code, Codex, DeepSeek Harness 등)를 설치합니다.
• 각 도구를 미리 정의된 "스냅샷"으로 실행하고, 시스템 프롬프트를 포함한 정확한 HTTP 요청을 모델 제공자에게 보내지 않고 캡처합니다(헬퍼 claude-tap 사용).
• 캡처된 프롬프트, 추적 로그, 메타데이터를 버전 관리된 디렉터리 구조에 저장합니다.
• 정적 웹사이트(phistory.cc)가 프롬프트를 나란히 시각화하고, 릴리스 간 변경 사항(새 도구, 권한 검사, 모델 기본값, 사용자 확인 규칙 등)을 강조합니다.
• 프롬프트 차이의 중국어 번역을 지원하며, 과거 릴리스 백필, 캡처된 산문 번역, 사이트 재구축을 위한 스크립트를 제공합니다.

중요성

• 시스템 프롬프트는 코딩 에이전트의 숨겨진 "두뇌"로, 모델이 어떻게 동작하는지, 어떤 도구를 호출할 수 있는지, 어떤 안전 정책이 적용되는지를 결정합니다.
• 모든 프롬프트 버전을 아카이브함으로써 Phistory는 연구자, 감사자, 개발자가 에이전트가 어떻게 진화하는지 정확히 보고, 안정적인 스냅샷을 인용하며, 회귀 또는 정책 변경을 발견할 수 있게 합니다.
• 시간별 GitHub Actions 워크플로가 아카이브를 자동으로 최신 상태로 유지합니다.

사용 방법

1. 탐색 – 호스팅된 뷰어(https://phistory.cc)를 방문하여 에이전트 및 버전 간 프롬프트를 비교합니다.
2. 로컬 실행 – uv sync --all-groups로 잠긴 Python 환경을 설치합니다.
3. 새 릴리스 캡처: uv run phistory capture --latest --agents <list>.
4. 이전 버전 백필: uv run phistory backfill <agent> --from <ver> --to latest.
5. 캡처된 프롬프트 번역(외부 자격 증명 필요): uv run phistory translate --all-captured.
6. uv run phistory render-index 및 uv run phistory build-site로 인덱스와 정적 사이트를 다시 생성합니다.

지원되는 에이전트(2026년 10월 기준)는 Claude Code, Codex CLI, DeepSeek Harness, Antigravity CLI, Grok Build, MiniMax Code, Kimi Code, MiMo Code, OpenClaw, Hermes Agent, Kimi CLI, opencode, Pi, Oh My Pi를 포함합니다.

현재 범위 – README에는 각 에이전트의 최신 캡처 버전, 추적된 릴리스 수, 저장된 총 스냅샷 수(예: Claude Code 2.1.296, 758스냅샷)가 나열됩니다.

기술 스택 – uv로 관리되는 Python 프로젝트로, 사용자 정의 claude-tap 도구를 사용하여 프롬프트를 가로채고, 데이터를 markdown, JSONL, JSON으로 저장하며, 탐색용 정적 사이트를 구축합니다.

---

모든 세부 사항은 리포지토리의 README에서 직접 가져온 것입니다.