jerlin-weread-skill

WeRead — WeChat 読書アシスタント

すべてのインターフェースは scripts/weread.sh を通じて呼び出します。スクリプトが認証とパラメーターのフラット化を処理します。サブコマンドの一覧を確認するには、weread.sh -h を実行してください。サブコマンドのパラメーターとレスポンスフィールドを確認するには、weread.sh <subcmd> -h を実行してください。

機能の振り分け

ユーザーの意図	サブコマンド	ドメイン知識
本を検索／探す	search	references/search.md
書籍の詳細／章／進捗	book-info chapters progress	references/book.md
本棚	shelf	references/shelf.md
読書統計／時間／好み	readdata	references/readdata.md
ノート／ハイライト／感想	notebooks bookmarks my-reviews	references/notes.md
人気のハイライト／ハイライトへの感想	best-bookmarks read-reviews underlines review-detail	references/notes.md
公開レビュー	reviews	references/review.md
おすすめの本	recommend similar	references/discover.md
ユーザーの読書概要	(組み合わせ)	references/profile.md
読書プロフィール	(組み合わせ + AskUser)	references/reading-profile.md

重要：インターフェースを呼び出す前に、必ず対応する reference を読み、フィールドの意味、カウント方法、ワークフローを確認してください。レスポンスのフィールド名と直感的な意味が一致しない場合は、reference の説明に従ってください。

認証

• 環境変数 $WEREAD_API_KEY。形式は wrk-xxxxxxxx
• 未設定の場合は、ユーザーに export WEREAD_API_KEY=<你的apikey> と案内してください
• API Key はユーザー ID（vid）に紐付いているため、手動で渡す必要はありません

共通ルール

1. errcode が 0 以外の場合はエラーです。中国語で案内してください。レスポンスに upgrade_info が含まれている場合は、その message の指示に従ってアップグレードを完了してから再試行してください。
2. ユーザーが書名を入力した場合は、まず weread.sh search を呼び出して bookId を取得してから、後続の操作を実行してください。
3. 会話中に取得済みの bookId を記憶し、後続の操作でユーザーに再入力を求めないでください。
4. 選びやすいよう、リストには番号を付けて表示してください。レスポンス情報を表示する際、フィールド名を直接翻訳してはいけません。reference の説明を参照してください。
5. タイムスタンプは YYYY-MM-DD 形式で表示し、元の数値をそのまま表示してはいけません。
6. 読書時間の単位は秒です。表示する際は「X 時間 Y 分」に変換してください。

ディープリンク

書籍、章、ハイライトなどの内容を表示する際、レスポンスのフィールドからリンクを構築できる場合は、アプリで開けるようリンクを付けてください。

場面	URL Schema
書籍を開く	weread://reading?bId={bookId}
章に移動	weread://reading?bId={bookId}&chapterUid={chapterUid}
ハイライトの位置に移動	weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid}

range の解析：ハイライトインターフェースが返す range の形式は 開始-終了（例：900-2004）です。分割して、それぞれ rangeStart と rangeEnd に設定してください。

ハイライト位置リンクの生成条件：レスポンスに chapterUid と range の両方が含まれていること。書籍全体へのレビュー、または位置を特定できないレビューには、このリンクを生成しないでください。userVid はコンテキストから取得するか、省略してください。