Discord の通話チャンネルに「誰が・どれくらい」いたかを自動で記録して、ランキングにする bot です。 もくもく会・勉強サーバー・VRChat 集会・ゲームギルドの「参加の見える化」に。 🏆 先週の通話ランキング 合計 42時間18分（のべ 11人） 1位　あおい　　12時間45分 2位　みなと　　　9時間02分 3位　ひなた　　　7時間30分 ■ できること ・通話チャンネルの入退室を自動記録（音声は一切記録しません） ・/ktime-me で自分の今日・今週・今月の通話時間を確認（自分だけに表示） ・/ktime-rank で通話時間ランキング（今日／今週／先週／今月／先月／全期間） ・毎週月曜・毎月 1 日に、先週・先月のランキングを自動投稿 ・/ktime-export で月別の合計時間・在室日数を CSV 出力（Excel でそのまま開けます） ・「先月 ○時間以上」の人に活動ロールを自動付与（基準を下回れば自動で外す） ・ミュート中の時間を除外／1 人きりの時間を除外、といった公平オプション ・記録するチャンネルを限定できる（AFK チャンネルは常に除外） 設定はすべて Discord 上のスラッシュコマンドで完結します。設定ファイルを触るのは、トークンを貼る 1 回だけです。 ■ 記録しないこと（安心してお使いいただくために） 会話の内容、音声、画面共有、テキストチャンネルのメッセージは一切記録しません。 記録するのは「誰が・どのチャンネルに・いつ入って、いつ出たか」だけです。 記録はあなたのパソコンの中にだけ保存され、外部のサービスには送信されません。 ■ 無料の bot との違い ・日本語の UI と、日本語の導入手順書 ・記録は自分の PC の中だけ。外部サービスを経由しません ・月次 CSV があるので、助成金報告・活動報告にそのまま使えます ・月額なし・サーバー数の制限なし ━━━━━━━━━━━━━━━━━━━━ ⚠️ 購入前に必ずご確認ください ━━━━━━━━━━━━━━━━━━━━ この商品は「bot のプログラム（Python のソースコード）と導入手順書」です。 以下に当てはまらない方は、購入後に動かせない可能性があります。 【パソコン】Windows / Mac / Linux。Python 3.10 以上をインストールできること（手順書に案内あり・無料） 【動かし続ける環境】bot は Discord と常時つながっている必要があります。パソコンを閉じている間は記録されません。24 時間記録したい場合は、つけっぱなしの PC か VPS（月数百円〜）が必要です 【Discord の権限】導入するサーバーの「サーバー管理」権限。SERVER MEMBERS INTENT を ON にします（手順書に画面つきで記載） 【bot アカウント】ご自身で Discord Developer Portal から作成します（無料・5 分。手順書あり） 【プライバシーポリシー】Discord の開発者規約により、bot を運用する方はプライバシーポリシーを用意して Developer Portal に登録する必要があります。雛形を同梱しているので、名前を書き換えるだけで使えます ■ 「動いているつもりで止まっていた」を防ぐ仕組み 自宅のパソコンで bot を動かしていると、Windows の更新や省電力設定で、いつの間にかプロセスが消えていることがあります。画面を出さずに動かすので、落ちてもエラーは見えません。気づくのはたいてい「あれ、記録されてない」と思ったときです。 ・同梱の Karinoya Watchdog が 1 分ごとに生死を確認し、3 分以上止まっていれば自動で起動し直して Discord に知らせます ・毎朝決まった時刻に「稼働中」を 1 行だけ投稿することもできます（任意）。投稿が来ないこと自体が、止まったことのしるしになります ・run.bat をうっかり 2 回押しても、2 つ目は自分で終了します（同じ bot が 2 つ動くと、1 回の出来事に 2 回反応してしまうため） ・設定を変えたあとに止めて起動し直す restart.bat を同梱しています 🐕 見張り役の「Karinoya Watchdog」を同梱しています。別の zip です。追加のライブラリは要りません。 ■ こんな方には向いていません ・「招待リンクを押すだけで使いたい」方（この商品はホスティングサービスではありません） ・導入前の通話履歴を遡って取りたい方（Discord の仕様上、どの bot でも不可能です） ・会話の内容を記録したい方（記録しない設計です） ■ 導入の流れ（約 10 分） 1. Discord Developer Portal で bot アカウントを作成し、サーバーに招待（手順書あり） 2. zip を展開し、config.txt にトークンを貼る 3. Windows: setup.bat → run.bat をダブルクリック（Mac/Linux: sh run.sh） 4. Discord 上で /ktime-setup channel:#レポートを投稿したいチャンネル を実行 → 完了 ■ 同梱物 ・karinoya_time.py（本体） ・README.md（導入手順・FAQ） ・PRIVACY_POLICY_TEMPLATE.md（Developer Portal に登録するプライバシーポリシーの雛形） ・参加者への案内_雛形.md（サーバーに貼る、参加者向けの説明） ・LICENSE.txt（利用許諾） ・setup.bat / run.bat / run_console.bat / restart.bat / install_startup.bat / uninstall_startup.bat（Windows 用） ・run.sh（Mac・Linux 用） ・config.txt.example / requirements.txt ・karinoya-watchdog-v1.0.0.zip（Karinoya Watchdog 一式） ■ コマンド一覧 /ktime-setup（管理者）記録を開始・設定変更 /ktime-unsetup（管理者）記録を停止し、そのサーバーの設定と記録を削除 /ktime-track（管理者）記録するチャンネルを限定 /ktime-me（全員）自分の通話時間（自分だけに表示） /ktime-rank（全員）通話時間ランキング /ktime-export（管理者）月別の集計を CSV で出力 /ktime-status（全員）現在の設定 /ktime-about（全員）この bot について ■ Karinoya Log との違い Karinoya Log はチャンネルに「誰かがいた時間」を記録します（サーバー全体の活動量の把握向け）。 Karinoya Time はメンバーごとの滞在時間を記録します（個人の参加実績・ランキング・ロール付与向け）。 両方を同じサーバーに入れても問題ありません。 ■ 利用条件・サポート ・ライセンス：購入者ご自身が管理するサーバーなら数に制限なく利用可。自分用の改変も可。第三者への再配布・販売は不可（詳細は同梱の LICENSE.txt） ・返金：ダウンロード商品のため、購入者都合（誤購入・動作環境の不足など）による返金はできません。ファイルの破損など当方の不備は、購入から 30 日以内にご連絡いただければ再提供または返金します ・サポート：個別の導入サポートは行っていません。不具合のご報告は BOOTH のメッセージからどうぞ（対応をお約束するものではありません） ・アップデート：提供する場合は BOOTH の購入履歴から再ダウンロードできます ■ 販売者 一般社団法人 仮の宿（KARINOYA） 外出できない人・言葉が違う人がひとりにならないための、オンラインの居場所と多言語の学習教材をつくっている非営利団体です。この bot は、自分たちの Discord の活動量を把握するために作ったものです。売上は活動に使います。 https://karinoya.com/tools/ ✅ 購入前に「必要なもの」を確認しました ✅ パソコンを動かし続ける必要があることを理解しました ✅ 導入前の履歴は取得できないことを理解しました