teng-lin/weread-omni

解決する問題

weread-omni は、微信讀書（微信读书）のための包括的な非公式SDKおよびコマンドラインインターフェース（CLI）を提供し、公式のAgent Skillをはるかに超えるプラットフォームの機能を拡張します。公式スキルは6つの読み取り専用操作に限定されていますが、このプロジェクトは40以上の読み書き操作をサポートし、ユーザーが読書ワークフローを自動化し、ライブラリを管理し、微信讀書データをAIエージェントに統合できるようにします。

仕組み

このプロジェクトは、微信讀書のE-inkスクリーンデバイスが使用するAPIに基づいて構築されています。サービスと対話するための3つの主要な方法を提供します：

1. CLI：他のスクリプトとの統合を容易にするためにJSONを出力できるコマンドラインツール。
2. TypeScript SDK：開発者がアプリケーションを構築するための完全に型付けされたライブラリ。
3. Agent Skill：AIエージェント（CodexやClaude Codeなど）がログイン状態を確認し、読み書き操作を実行し、ページネーションを処理できるようにする事前設定されたスキル。

ユーザーは、微信讀書アカウントを使用してQRコードスキャンで認証します。このツールはまた、ローカルコンテンツライブラリ（SQLite WALを使用）を維持し、書籍情報、章、公式アカウント記事をキャッシュして、冗長なネットワークリクエストを削減します。

対象読者

• 開発者：微信讀書データを中心にアプリや自動化を構築したい人。
• AIエージェントユーザー：AIアシスタントに書籍、ノート、ハイライトを操作させたい人。
• パワーユーザー：公式アカウントフィードをエクスポートしたり、個人の書籍（EPUB、PDFなど）をインポートしたり、ターミナルで読書リストを管理したい人。

ハイライト

• 拡張機能：公式スキルでは不可能な、ハイライトとレビューの追加、変更、削除をサポート。
• コンテンツインポート：EPUB、PDF、MOBI、TXT、AZW3形式の個人ファイルをインポート可能。
• 公式アカウント統合：記事の閲覧、アカウントの購読、RSS、Atom、JSON形式でのフィードエクスポートが可能。
• AI統合：「微信讀書 AI」に直接アクセスして、特定の書籍について質問できます。
• ローカルキャッシュ：コンテンツを保存し、繰り返しのダウンロードを避けるための組み込みローカルライブラリ。