읽기 라이브러리
비밀 정보를 저장하지 않는 검색 기록 카드 만들기
인증 정보, 제출 조건, 응답 관찰과 독자의 해석 메모를 분리해 유용한 양자화 검색 기록을 남깁니다.
다시 사용할 수 있는 공개 입력을 나열하세요
기록 카드 구조는 API 필터 계약을 정확히 따라야 합니다. LocalLLaMA 노트 예시에서는 사용한 q, subreddit, author, kind, from, to, min_score, limit, page를 기록하세요. 짧은 예는 q=quantization, subreddit=LocalLLaMA, limit=3, page=1입니다. 날짜는 실제로 제출한 YYYY-MM-DD UTC 값으로 저장합니다. 이는 요청 조건을 설명할 뿐 특정 토론이 반환됐다는 증거가 아니며, 재사용해도 나중에 같은 응답이 보장되지는 않습니다.
공개 입력은 인증 필드가 아니라는 뜻이지 자동으로 무해하다는 뜻이 아닙니다. 쿼리에 비공개 프로젝트명이, 메모에 공개하려 하지 않은 사람의 정보가 들어갈 수 있습니다. 요청 객체 전체를 복사하지 말고 무엇을 저장하거나 내보낼지 결정하세요. 인증 헤더는 기록에서 제외합니다. 응답을 로컬로 보관한다면 요청과 별도임을 표시하고 받은 시각을 적으세요. 그렇지 않으면 재검색 링크를 원래 결과의 보관 사본으로 오해할 수 있습니다.
비밀 저장을 분리하세요
X-API-Key 또는 Authorization: Bearer를 보내려면 호출자 백엔드가 보관한 API 키에 접근할 수 있어야 합니다. 단방향 해시만으로는 발신 인증 정보를 공급할 수 없습니다. 사용 가능한 키는 브라우저 배포 코드, 쿼리 문자열, 기록 내보내기, 진단 로그 밖의 적절한 백엔드 비밀 저장소에 두세요. 서비스가 인증용으로 저장하는 키 해시와 접두어는 다른 역할입니다. 전체 키는 가입이나 재생성 시 한 번 표시되며 재생성은 이전 키를 즉시 무효화합니다. 기록이 우연한 키 백업이 되어서는 안 됩니다.
독자의 앱 계정, 서비스 운영자의 세션, 조회에 쓰는 서비스 API 키라는 세 관계를 구분하세요. 키와 잔액은 테넌트별이며 호스트를 바꿔도 다른 테넌트 키가 유효해지지 않습니다. 기록에서 인증 정보를 빼면 노출 경로 하나는 줄지만 저장 쿼리나 메모가 모든 브라우저 문제와 접근 제어 문제에서 안전해지는 것은 아닙니다. 앱의 저장·공유 선택을 검토하세요. 이 카드 제안을 검증된 보안 경계나 아카이브 API 제공 기록 기능으로 홍보하지 마세요.
해석 메모를 저장하세요
관찰과 결론을 분리하세요. 카드에는 세 레코드를 표시했고 하나는 쓸 만한 본문이 없으며 실험의 메모리 조건이 여전히 필요하다고 적을 수 있습니다. 이는 예시 주석이지 실제 관찰한 아카이브 결과가 아닙니다. pagination.total을 저장하면 pagination.relation과 설명에 필요한 진행·경계 표시도 함께 보관합니다. 하한은 정확한 개수가 아닙니다. 어느 필드도 레코드의 관련성이나 해당 문제의 흔함을 측정하지 않습니다.
독자가 참조를 남긴 이유를 짧게 적게 하세요. 독자의 메모라고 표시하고, 사용 가능한 출처 식별자를 보존하며 인용한 원문에 섞지 마세요. 선택 필드는 없을 수 있고 상위 참조는 완전한 토론을 주지 않습니다. 저장된 응답을 여는 데 API 호출은 필요하지 않을 수 있지만, 명시적인 새로 고침은 새 조회입니다. 새 조회가 성공하면 빈 결과도 1크레딧입니다. 실패하거나 불확실한 새로 고침은 별도 결과로 보존하고 이전 관찰을 설명 없는 빈 카드로 덮지 마세요.
보관 범위를 검토하세요
지속적인 기록을 제공하기 전에 이 앱의 삭제, 내보내기, 만료 동작을 정하세요. 로컬 카드 삭제는 구현이 저장하기로 한 데이터를 지웁니다. 아카이브 레코드를 삭제하거나 서비스 계정을 닫거나 그 결제 기록을 바꾸지는 않습니다. 브라우저 정리, 기기 분실, 저장 제한으로 로컬 기록이 사라질 수 있습니다. 동기화나 백업을 제공한다면 별도 앱 기능으로 설명하고 시험하세요. 둘 다 아카이브 엔드포인트가 아니며 이 글은 구현되었다는 증거가 아닙니다.
여기서 서비스의 계정 정보 보관 기간은 고정되어 있지 않습니다. 그렇다고 아카이브 콘텐츠에 영구 접근을 약속하는 것은 아닙니다. 과거 관찰과 새로운 조회를 구분하는 카드라면 출처를 나중에 볼 수 없게 되어도 저장한 쿼리의 뜻은 남습니다. 내보낼 자료의 비밀과 민감한 메모를 확인한 뒤 독자가 무엇을 보관할지 결정하게 하세요. 유용한 결과는 검색 판단을 추적할 수 있는 기록이지 데이터와 해석, 링크가 무기한 유효하다는 보장이 아닙니다.
