つ

# ヒトハコ セットアップ手順

LINE・Messenger・X・LinkedIn などのメッセージを1つの受信箱にまとめ、AIが返信の下書きまで用意します。送信は必ずご自身の操作です。

📄 このファイルが開けない場合は、Web版の手順をご覧ください → hitohako.vercel.app/setup.html

## セットアップ（初回のみ・10分ほど）

1
接続エンジンをインストール
接続エンジンは自動で入ります。「ヒトハコ（アプリ）」をダブルクリックすると、初回のみ接続エンジン（無料）を自動でダウンロード・セットアップします（約160MB・数分）。お客様の操作は不要です。
接続エンジンは「Beeper」という名前でDockに並びますが、触らなくて大丈夫です。Beeperの窓が開いても何も入力せず、ヒトハコの画面に戻ってください（使うのは手順3で「許可」を押す一瞬だけ）。接続エンジンのアカウントは、手順3でヒトハコの画面から作ります。
⏳ ヒトハコの起動画面に、いま何をしているかが表示されます。「ダウンロードしています… ○%」「接続エンジンを起動しています…」などの表示が出ている間は、そのままお待ちください（回線によっては5〜10分かかることがあります）。
🚫 Beeperの画面で登録・サインインを始めないでください。Beeperの窓に「Sign in」「Create account」などが出ても、何も入力せず閉じずにそのままにして、ヒトハコの画面に戻ってください。ログイン（メールアドレスと確認コードの入力）は、手順3でヒトハコの画面の中で行います。Beeper側で先に登録してしまうと二重アカウントになり、つまずきの原因になります。
2
「ヒトハコ（アプリ）」を右クリック →「開く」
初回だけ、ダブルクリックではなく右クリック（2本指クリック）→「開く」を選んでください（Macの安全確認です）。
黒い画面が出て、ブラウザが自動で開きます。この黒い画面は閉じないでください（閉じるとヒトハコが止まります）。
※「コマンドラインデベロッパツール」のインストール画面が出たら「インストール」を押し、完了後にもう一度起動してください。
🔑 「開けません」と出て先に進めない場合（macOS Sequoia／Tahoe以降）
新しいMacでは右クリックだけでは開けません。次の手順で許可してください。
① いったんダイアログを「完了」または「OK」で閉じる
② アップルメニュー →「システム設定」→「プライバシーとセキュリティ」を開く
③ 下のほうまでスクロールすると「"ヒトハコ"は開発元を確認できないため…」という行があるので、その右の「このまま開く」を押す
④ Macのパスワード（またはTouch ID）で確認 → もう一度ファイルを開くと起動します
3
「はじめる（登録・ログイン）」を押す
まずライセンスキー（KAKUKATAからお渡ししたもの）とお名前を入力します。
次にメールアドレス → 届いた確認コード（新規の方はさらにユーザー名）の順に入力します。すべてヒトハコの画面内で完結します。確認コードのメールはBeeper名義で届きます。届かないときは迷惑メールフォルダを確認のうえ、画面の「コードを再送する」を押してください。
登録が終わると、最後の1ステップとして接続エンジン（Beeper）の窓が前に出ます。「許可（Approve）」を押すだけです。押すと自動でヒトハコに戻り、SNS連携に進みます。
👀 ここだけ注意：「許可（Approve）」の画面はBeeperの窓に出ます（自動で前面に出します）。それ以外のBeeperの画面は使いません。押すのはApproveだけです。
⏱️ 「Approve」は約1分で時間切れになりますが、自動でもう一度出し直します（3回まで）。出なくなったときは、ヒトハコの画面の「もう一度許可を求める」か「ブラウザから許可する」を押してください。
4
「SNSを連携」でつなぎたいサービスを選ぶ
LINE・Messenger・Instagram・WhatsApp・X など。QRの読み取りやログインはご本人の操作です。連携できると「✅連携済み」に変わります。
💡 AI下書きはライセンスキーだけで使えます。APIキーの設定や追加のお支払い手続きは不要です。

## 使い方

- 左のリスト＝すべてのSNSのやり取りが1つに並びます（アイコンで媒体が分かります）
- 相手を選ぶと、そのやり取りが表示されます
- 下の「AI下書き」を押すと、文脈を読んだ返信案が入力欄に入ります
- 直したいところを直して、ご自身で送信（確認ダイアログが出ます）

🔒 AIが勝手に送信することはありません。下書きまでがAIの仕事で、送るかどうかは常にご自身の判断です。

## 2回目以降

「ヒトハコ（アプリ）」をダブルクリックするだけ（2回目からは右クリック不要です）。ブラウザで `http://localhost:8791` が開きます。
ログインは基本的に切れません。まれに「再連携が必要です」と出た場合は、画面の案内に沿ってアプリ側でもう一度「許可」を押せば復旧します。

## データの取り扱い

- チャットの一覧・本文・画像はすべてお使いのMacの中だけで表示され、外部に保存されません。
- 「AI下書き」を押したときだけ、その会話の直近のやり取りがKAKUKATAのAIサーバーに送られ、下書きの生成にのみ使われます（内容は保存しません）。

## うまくいかないとき

- 「開発元が未確認」「開けません」と出る：上の手順2の黄色い枠（システム設定 →「プライバシーとセキュリティ」→「このまま開く」）をご覧ください。
- 画面が真っ白 / つながらない：黒い画面が動いているか確認し、ブラウザを再読み込みしてください。
- メッセージが出てこない：手順1のアプリ（接続エンジン）が起動しているかご確認ください。
- 画面に「再連携が必要です」と出る：そのすぐ下の「もう一度許可する」を押してください。アプリ側に「許可しますか？」が出るので許可すれば復旧します（「はじめる（登録・ログイン）」は押さないでください）。
- 許可の画面が出ない：Dockの「Beeper」をクリックして前に出し、「許可（Approve）」を押してください。それでも出ないときは、ヒトハコの画面の「ブラウザから許可する」を押してください。
- Beeperのサイトやアプリで先にアカウントを作ってしまった：そのままで大丈夫です。Beeperにそのアカウントでサインインした状態で、ヒトハコの「既存の接続を使う」を押してください。
- 「ポートが別のアプリに使われています」と出る：他のアプリを終了してから、もう一度起動してください。
- ライセンスが無効と出る：キーの打ち間違いをご確認のうえ、下記までご連絡ください。ネット接続がない場合は「インターネット接続をご確認ください」と表示されます。

⚠️ すでに別のアカウントでサインイン済みの環境では、手順3の登録フローは使わないでください（既存のセッションに影響する場合があります）。その場合は「既存の接続を使う」を選んでください。

## アンインストール

①この「ヒトハコ」フォルダをゴミ箱に入れる ②「ターミナル」を開いて次の1行を実行（設定ファイルの削除）:
`rm -rf ~/.config/hitohako ~/.config/tsunagu`
接続エンジン（Beeper Desktop）が不要な場合は、アプリケーションフォルダから削除してください。

## お問い合わせ

株式会社KAKUKATA 林 英明
メール: hideaki.hayashi@kakukata.jp ／ 電話: 080-3649-4463

株式会社KAKUKATA ／ ヒトハコ