はじめに
OneLineは、ユーザーchengtx809によって開発されたGitHub上でホストされているオープンソースのホットなイベントタイムライン生成ツールです。ユーザーが入力したキーワードを使用して、イベントのタイムラインを素早く生成し、イベントの時間、タイトル、説明、関連する人々を表示します。AI分析機能は、イベントの背景、プロセス、影響について詳細な解釈を提供します。このプロジェクトはNext.jsとReactで構築され、Dockerデプロイメントをサポートしており、ニュースや歴史、ホットな出来事に興味のあるユーザーに適しています。
機能一覧
- キーワード生成:ユーザーが入力したキーワードに基づいて、関連するイベントのタイムラインを生成します。
- イベントの詳細:イベントの時間、タイトル、説明、関係者が表示されます。
- 時間フィルタリング:時間範囲によるイベントのフィルタリングをサポートし、特定の期間に焦点を当てることを容易にします。
- AI分析:出来事の背景、経過、影響を詳細に分析する。
- ソースタギング:コンテンツの信頼性を確保するために、事件に関する情報の出典を表示すること。
- フロントエンドの設定:ユーザーがAI APIエンドポイント、モデル、キーを設定するためのサポート。
- パスワード保護:APIコンフィギュレーションの悪用を防ぐため、オプションでアクセスパスワードを設定できる。
ヘルプの使用
OneLineはウェブベースのツールで、ソースコードとデプロイ方法はGitHubリポジトリから入手できます。以下は、ユーザーがすぐに使い始められるよう、詳細な使用方法とデプロイメント・ガイドです。
デモサイトへ
OneLineは、ユーザーが機能を体験できるオンライン・デモサイトを提供している:
- ブラウザを開き、次のサイトにアクセスする。
https://oneline.chengtx.me/
. - ページ入力ボックスにキーワード(例:「発生」や「技術的ブレークスルー」)を入力する。
- 生成ボタンをクリックすると、イベントの時間、タイトル、説明を含むTimelineが表示されます。
- 時間フィルター機能を使って、特定の年や月を選択し、イベントを絞り込むことができます。
- AI分析」ボタンをクリックすると、イベントの背景、プロセス、影響の解釈を得ることができます。
- 情報の信憑性を確認するため、事件の情報源をチェックする。
ローカル・デプロイメント・ワンライン
OneLineをローカルまたはサーバー上で実行したい場合は、ソースコードを入手し、GitHubリポジトリ経由でデプロイすることができます。詳しい手順は以下の通り:
1.ソースコードへのアクセス
- インタビュー
https://github.com/chengtx809/OneLine
. - 緑色の
Code
を選択します。Download ZIP
ソースコードをダウンロードするか、リポジトリのアドレスをコピーしてください:git clone https://github.com/chengtx809/OneLine.git
- ファイルを解凍するか、クローンしたフォルダに移動し、環境を設定する準備をする。
2.構成環境
OneLineは外部のAI API(Google GeminiやOpenAIなど)に対応している必要がある。設定はフロントエンドの設定と環境変数の設定に分かれる。
フロントエンドの設定:
- OneLineを起動後、ウェブページを開き、右上の「API設定」ボタンをクリックします。
- 以下の情報を入力してください:
- APIエンドポイントとして
https://api.example.com/v1/chat/completions
. - モデル名として
gemini-2.0-pro-exp-search
. - APIキーAPIプロバイダーから取得します。
- APIエンドポイントとして
- アクセスパスワードが設定されている場合は、正しいパスワードを入力して設定を変更します。
- 設定を保存し、機能をテストする。
環境変数の設定(デプロイ時に推奨):
- プロジェクトのルート・ディレクトリで
.env.example
ファイルをコピーし、名前を変更する。.env.local
. - コンパイラ
.env.local
次のように記入する:NEXT_PUBLIC_API_ENDPOINT=https://api.example.com/v1/chat/completions NEXT_PUBLIC_API_MODEL=gemini-2.0-pro-exp-search NEXT_PUBLIC_API_KEY=your_api_key_here NEXT_PUBLIC_ALLOW_USER_CONFIG=true NEXT_PUBLIC_ACCESS_PASSWORD=your_access_password_here
- コンフィギュレーション・ノート
NEXT_PUBLIC_API_ENDPOINT
AI API のアドレス。NEXT_PUBLIC_API_MODEL
使用したAIモデル名NEXT_PUBLIC_API_KEY
APIキーNEXT_PUBLIC_ALLOW_USER_CONFIG
に設定する。false
設定変更はフロントエンドで無効にできる。NEXT_PUBLIC_ACCESS_PASSWORD
API 設定を保護するためのオプションのパスワード。
- 機密情報が漏れないようにファイルを保存する。
3.Dockerによるデプロイメント
OneLineはDockerデプロイをサポートしています。イメージを提供してくれたコントリビューターのjustincnn氏に感謝します。手順
- Dockerがインストールされていることを確認する。
https://docs.docker.com/get-docker/
). - 以下のコマンドを実行して画像を取り出します:
docker pull justincnn/oneline
- コンテナを実行し、ポートをマップする(デフォルトは 3000):
docker run -p 3000:3000 justincnn/oneline
- ブラウザを開き、次のサイトにアクセスする。
http://localhost:3000
OneLineチームのメンバーであれば、OneLineのページにアクセスしてください。 - 永続的なコンフィギュレーションが必要な場合は
.env.local
ファイルがコンテナにマウントされる:docker run -p 3000:3000 -v /path/to/.env.local:/app/.env.local justincnn/oneline
4.手動配備(Docker以外)
- Node.jsがインストールされていることを確認する(v16以上を推奨)。
- プロジェクト・ディレクトリに移動し、依存関係をインストールする:
npm install
- 開発サーバーを起動します:
npm run dev
- インタビュー
http://localhost:3000
APIを設定して使用することができる。
主要機能の使用
OneLineのコア機能の操作方法をご紹介します:
タイムラインの作成
- ホームページで「人工知能開発」などのキーワードを入力。
- Generate "ボタンをクリックし、数秒待つとタイムラインが表示されます。
- タイムラインは年代順に並び、イベントのタイトル、日付、説明、関係者が表示される。
- イベントにカーソルを合わせると詳細が表示されます。
タイム・スクリーニング
- タイムラインの上部にあるフィルターバーを見つけ、年(例:2020-2025)または月を選択します。
- 適用 "ボタンをクリックすると、タイムラインはフィルターされた範囲のイベントで更新されます。
- リセットが必要な場合は、"Clear Filter "をクリックしてください。
AIアナリティクス
- タイムラインでイベントを選択し、「AI分析」ボタンをクリックする。
- システムは設定されたAI APIを呼び出し、イベントのコンテキスト、プロセス、影響分析を生成する。
- 分析結果は事象の下に表示され、原因、影響、傾向を説明する文章が含まれる。
ソースの検査
- 各イベントの横にソースタグがあり、クリックすると元のリンクやソースが表示される。
- ソースが信頼できない場合は、GitHubにIssueを提出して改善を提案してください。
地域貢献への参加
OneLineはオープンソースのプロジェクトであり、ユーザーによる貢献を歓迎する:
- GitHubリポジトリにアクセスするには
Issues
課題を見る、または新しい課題を提出する。 - 例えば、タイムラインのUIを最適化したり、新しい言語のサポートを追加したりするために、リポジトリをフォークし、コードを変更し、Pull Requestを提出してください。
- コミットする前にテストを実行する:
npm run test
- プルリクエストに変更点を記述し、レビューを待つ。
よくある質問
- API設定の失敗APIのエンドポイント、モデル、キーが正しいか、ネットワーク接続を確認してください。
- タイムラインが表示されないキーワードは具体的なものにし(例:「2023年科学技術イベント」)、過度に広範にならないようにする。
- Dockerの起動エラーDockerが起動しているか、ポートが占有されているかを確認する。
- AIが不正確なコンテンツを分析AIモデルをより強力なものに置き換えるか、GitHubで問題をフィードバックしてください。
これらのステップを踏むことで、ユーザーはOneLineを簡単に導入・使用し、ホットイベントのタイムラインを素早く作成し、AI分析を得ることができる。
アプリケーションシナリオ
- プレスリリース照合
ジャーナリストはOneLineを使ってイベントのキーワードを入力し、タイムラインを作成することで、ニュースを素早く整理し、記事作成を支援する。 - 歴史研究
学生や研究者が歴史上の出来事を入力すると、年表やAI分析が表示され、出来事の背景や影響を理解することができる。 - ホットトラッキング
一般の人々は、現在のホットなトピックを入力し、イベントの展開を表示し、重要な時点をフィルタリングし、最新の動向を把握します。 - 教育と学習
教師はOneLineを使って年表を作成し、生徒が複雑な出来事を理解できるように、授業の教材として使用します。
品質保証
- OneLineはどのようなAI APIをサポートしていますか?
ユーザーが設定したエンドポイントやモデルに応じて、Google Gemini、OpenAIなどをサポート。 - プログラミングの経験が必要ですか?
いいえ、デモサイトを使用するにはキーワードの入力が必要なだけで、デプロイには基本的なコマンドラインの知識が必要です。 - タイムラインデータの出所は?
データは、キーワードに基づいて公開されている情報からAIによって生成され、イベントの横にソースが表示される。 - オフラインで使用できますか?
AI APIを呼び出すにはネットワークが必要で、一部の機能はローカル展開後にオフラインにできるが、AI分析はネットワークに依存している。 - APIキーを保護するにはどうすればよいですか?
フロントエンドでキーが公開されないようにするために環境変数設定を使用し、さらに保護するためにアクセスパスワードを設定する。