Skip to content

Instantly share code, notes, and snippets.

@heavyrain39

heavyrain39/hanjulhanjul_manual.md

Last active December 3, 2025 18:45
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save heavyrain39/b3119947f9238a9bcf131ac6799e7d08 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save heavyrain39/b3119947f9238a9bcf131ac6799e7d08 to your computer and use it in GitHub Desktop.
Download ZIP
Raw
hanjulhanjul_manual.md

📘 한줄한줄: 사용자 가이드 & FAQ

이 문서는 크롬 익스텐션 [한줄한줄: 내 생각의 타임라인] 사용자를 위한 공식 가이드입니다.

🇰🇷 자주 묻는 질문 (FAQ)

1. Gemini API 키는 왜 필요한가요? 유료인가요?

'한줄한줄'은 사용자의 기록을 분석하기 위해 Google의 Gemini AI를 사용합니다. 이 과정에서 개발자의 서버를 거치지 않고, 사용자가 직접 Google과 소통하도록 하여 보안과 속도를 높였습니다.

  • 비용: Google AI Studio에서 제공하는 Gemini API는 현재 무료로 이용 가능합니다. (Free Tier 기준)
  • 발급 방법:
    1. Google AI Studio에 접속합니다.
    2. Create API key 버튼을 클릭합니다.
    3. 생성된 키를 복사하여 '한줄한줄' 설정(Settings) 메뉴에 붙여넣고 저장하세요.

2. 제 기록은 어디에 저장되나요? (보안 정책)

사용자의 소중한 기록은 오직 **사용자의 PC(로컬 스토리지)**와 **사용자의 구글 드라이브(동기화 활성화 시)**에만 저장됩니다.

  • Serverless: '한줄한줄'은 별도의 중앙 서버를 운영하지 않습니다.
  • Privacy First: 개발자는 사용자의 기록을 절대 볼 수 없으며, 수집하지도 않습니다.

3. 구글 드라이브 동기화는 어떻게 작동하나요?

설정에서 '구글 드라이브 동기화'를 활성화하면(Pro 기능), 데이터가 안전하게 클라우드에 백업됩니다.

  • 저장 위치: 구글 드라이브 내의 숨겨진 폴더인 appDataFolder에 저장됩니다. (사용자의 일반 드라이브 목록을 어지럽히지 않습니다.)
  • 기기 연동: 집에서 쓰고 회사에서 열어도, 같은 구글 계정이라면 기록이 연동됩니다.
  • 팁: 기록 직후 다른 기기에서 바로 확인하고 싶다면, 설정 메뉴의 [지금 동기화] 버튼을 한 번 눌러주세요.

4. 기록을 삭제하면 복구할 수 있나요?

기록 옆의 휴지통 버튼을 누르면 즉시 삭제됩니다.

  • 주의: 삭제된 기록은 로컬과 클라우드(동기화 시)에서 모두 영구적으로 제거되므로 복구가 불가능합니다. 신중하게 삭제해 주세요.
  • 백업: 데이터 유실이 걱정된다면 설정 메뉴의 [내보내기(백업)] 버튼을 통해 JSON 파일로 따로 저장해두실 수 있습니다.
  • 재설치 복구: 앱을 실수로 삭제했더라도, 다시 설치 후 설정에서 **[연결하기]**를 누르면 구글 드라이브에 저장된 최신 기록이 자동으로 복원됩니다. (Pro 기능)

5. Pro 버전은 무엇이 다른가요?

Pro 멤버십은 '한줄한줄'을 평생 소장하고 더 깊이 활용하고 싶은 분들을 위한 유료 옵션입니다.

  • 클라우드 동기화: 여러 기기에서 끊김 없는 기록 경험.
  • 커스텀 페르소나: 나만의 AI 비서(멘토, 친구, 혹은 소설 속 인물 등) 설정 가능.
  • 장기 리포트: 30일/90일 단위의 심층 분석 리포트 및 심리 프로파일링 제공.
  • Pro 라이선스 구매하기 ↗

6. 결제 창이 '처리 중...'에서 넘어가지 않아요.

결제 시스템(Lemon Squeezy)의 보안 점검 과정이 사용 중인 **광고 차단 확장 프로그램(AdBlock 등)**에 의해 막히는 경우가 있습니다.

  • 해결: 광고 차단 기능을 잠시 끄거나, **시크릿 탭(Incognito Mode)**에서 결제 링크를 열어 시도해 주세요.

7. 문의사항이 있거나 버그를 발견했어요.

앱 사용 중 불편한 점이 있다면 언제든 아래로 연락해 주세요. 여러분의 피드백으로 '한줄한줄'은 성장합니다.

🇺🇸 FAQ (English)

1. Why do I need a Gemini API Key? Is it free?

'Hanjul Hanjul' uses Google's Gemini AI to analyze your records. We designed it so you communicate directly with Google without passing through our servers, ensuring better security and speed.

  • Cost: The Gemini API is currently free to use via Google AI Studio (Free Tier).
  • How to get one:
    1. Go to Google AI Studio.
    2. Click Create API key.
    3. Copy the key and paste it into the 'Settings' menu of the extension.

2. Where are my records stored? (Privacy Policy)

Your precious records are stored ONLY on your PC (Local Storage) and your Google Drive (if Sync is enabled).

  • Serverless: We do not operate a central server.
  • Privacy First: The developer cannot see or collect your data.

3. How does Google Drive Sync work?

When you enable 'Google Drive Sync' in Settings (Pro feature), your data is securely backed up to the cloud.

  • Location: Stored in a hidden appDataFolder within your Google Drive (it won't clutter your main file list).
  • Cross-Device: Access your thought timeline from home or work using the same Google account.
  • Tip: For instant updates across devices, click the [Sync Now] button in Settings.

4. Can I recover deleted records?

Clicking the trash icon deletes the record immediately.

  • Warning: Deleted records are permanently removed from both local and cloud storage (if synced) and cannot be recovered. Please be careful.
  • Backup: You can manually save your data as a JSON file using the [Export] button in Settings.
  • Reinstall Recovery: If you accidentally delete the app, simply reinstall it and click [Connect] in Settings to restore your data from Google Drive. (Pro feature)

5. What's included in the Pro version?

Pro Membership is a paid option for those who want to own 'Hanjul Hanjul' for a lifetime and use it more deeply.

  • Cloud Sync: Seamless experience across multiple devices.
  • Custom Persona: Create your own AI assistant (mentor, friend, or fictional character).
  • Long-term Reports: 30-day/90-day deep analysis reports and psychological profiling.
  • Buy Pro License ↗

6. The payment window is stuck at "Processing...".

This is often caused by ad blockers (AdBlock, uBlock, etc.) blocking the security verification script of the payment system (Lemon Squeezy).

  • Solution: Please temporarily disable your ad blocker or try opening the payment link in Incognito Mode.

7. Contact & Support

If you have any questions or find bugs, please feel free to contact us. Your feedback helps 'Hanjul Hanjul' grow.

🇯🇵 よくある質問 (FAQ)

1. Gemini APIキーはなぜ必要ですか？有料ですか？

「一行一行」は、ユーザーの記録を分析するためにGoogleのGemini AIを使用します。開発者のサーバーを経由せず、ユーザーが直接Googleと通信することで、セキュリティと速度を向上させました。

  • 費用: Google AI Studioが提供するGemini APIは現在無料で利用可能です（Free Tier基準）。
  • 取得方法:
    1. Google AI Studioにアクセスします。
    2. Create API keyボタンをクリックします。
    3. 生成されたキーをコピーし、拡張機能の「設定(Settings)」メニューに貼り付けて保存してください。

2. 私の記録はどこに保存されますか？（セキュリティポリシー）

あなたの大切な記録は、**あなたのPC（ローカルストレージ）とあなたのGoogleドライブ（同期有効時）**にのみ保存されます。

  • サーバーレス: 私たちは中央サーバーを運営していません。
  • プライバシーファースト: 開発者があなたの記録を見ることはなく、収集することもありません。

3. Googleドライブ同期はどのように機能しますか？

設定で「Googleドライブ同期」を有効にすると（Pro機能）、データが安全にクラウドにバックアップされます。

  • 保存場所: Googleドライブ内の隠しフォルダであるappDataFolderに保存されます。（通常のファイルリストを邪魔しません。）
  • デバイス連携: 自宅や職場など、同じGoogleアカウントであれば記録が連動します。
  • ヒント: 記録後すぐに他のデバイスで確認したい場合は、設定メニューの**[今すぐ同期]**ボタンを押してください。

4. 削除した記録は復元できますか？

ゴミ箱ボタンを押すと、記録は即座に削除されます。

  • 注意: 削除された記録はローカルとクラウド（同期時）の両方から永久に削除されるため、復元は不可能です。慎重に削除してください。
  • バックアップ: データの消失が心配な場合は、設定メニューの[エクスポート]ボタンでJSONファイルとして保存しておくことができます。
  • 再インストール時の復元: アプリを誤って削除してしまった場合でも、再インストール後に設定で**[接続する]**を押せば、Googleドライブに保存されたデータが自動的に復元されます。（Pro機能）

5. Proバージョンには何が含まれますか？

Proメンバーシップは、「一行一行」を一生涯所有し、より深く活用したい方のための有料オプションです。

  • クラウド同期: 複数のデバイス間で途切れのない記録体験。
  • カスタムペルソナ: 自分だけのAIアシスタント（メンター、友人、小説の登場人物など）を設定可能。
  • 長期レポート: 30日/90日単位の深層分析レポートおよび心理プロファイリングの提供。
  • Proライセンスを購入する ↗

6. 決済画面が「処理中...」のまま進みません。

決済システム（Lemon Squeezy）のセキュリティチェックが、使用中の**広告ブロック拡張機能（AdBlockなど）**によってブロックされている場合があります。

  • 解決策: 広告ブロック機能を一時的に**OFFにするか、シークレットモード（Incognito Mode）**で決済リンクを開いてお試しください。

7. お問い合わせ・バグ報告

アプリの使用中に不便な点があれば、いつでもご連絡ください。あなたのフィードバックで「一行一行」は成長します。

🇪🇸 Preguntas Frecuentes (FAQ)

1. ¿Por qué necesito una Gemini API Key? ¿Es gratis?

'Hanjul Hanjul' utiliza la IA Gemini de Google para analizar tus registros. Diseñamos esto para que te comuniques directamente con Google sin pasar por nuestros servidores, garantizando mayor seguridad y velocidad.

  • Costo: La API de Gemini es actualmente gratuita a través de Google AI Studio (Nivel Gratuito).
  • Cómo obtenerla:
    1. Ve a Google AI Studio.
    2. Haz clic en Create API key.
    3. Copia la clave y pégala en el menú 'Configuración' (Settings) de la extensión.

2. ¿Dónde se guardan mis registros? (Política de Privacidad)

Tus preciados registros se almacenan ÚNICAMENTE en tu PC (Almacenamiento Local) y en tu Google Drive (si la sincronización está activada).

  • Sin Servidor: No operamos un servidor central.
  • Privacidad Primero: El desarrollador no puede ver ni recopilar tus datos.

3. ¿Cómo funciona la sincronización con Google Drive?

Cuando activas la 'Sincronización con Google Drive' en Configuración (función Pro), tus datos se respaldan de forma segura en la nube.

  • Ubicación: Se guarda en una carpeta oculta appDataFolder dentro de tu Google Drive (no desordenará tu lista principal de archivos).
  • Entre Dispositivos: Accede a tu línea de tiempo desde casa o el trabajo usando la misma cuenta de Google.
  • Consejo: Para ver los cambios al instante en otros dispositivos, haz clic en el botón [Sincronizar] en Configuración.

4. ¿Puedo recuperar registros eliminados?

Al hacer clic en el icono de la papelera, el registro se elimina inmediatamente.

  • Advertencia: Los registros eliminados se borran permanentemente tanto del almacenamiento local como de la nube (si está sincronizado) y no se pueden recuperar. Por favor, ten cuidado.
  • Copia de Seguridad: Puedes guardar manualmente tus datos como un archivo JSON usando el botón [Exportar] en Configuración.
  • Restauración tras Reinstalar: Si eliminas la aplicación por error, simplemente reinstálala y haz clic en [Conectar] en Configuración para restaurar tus datos desde Google Drive. (Función Pro)

5. ¿Qué incluye la versión Pro?

La Membresía Pro es una opción de pago para aquellos que desean poseer 'Hanjul Hanjul' de por vida y usarlo más profundamente.

  • Sincronización en la Nube: Experiencia fluida en múltiples dispositivos.
  • Persona Personalizada: Crea tu propio asistente de IA (mentor, amigo o personaje de ficción).
  • Informes a Largo Plazo: Informes de análisis profundo de 30/90 días y perfilado psicológico.
  • Comprar Licencia Pro ↗

6. La ventana de pago se queda en "Procesando...".

Esto suele ser causado por bloqueadores de anuncios (AdBlock, uBlock, etc.) que bloquean el script de verificación de seguridad del sistema de pago (Lemon Squeezy).

  • Solución: Por favor, desactiva temporalmente tu bloqueador de anuncios o intenta abrir el enlace de pago en Modo Incógnito.

7. Contacto y Soporte

Si tienes alguna pregunta o encuentras errores, no dudes en contactarnos. Tu feedback ayuda a crecer a 'Hanjul Hanjul'.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment