Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# 変更履歴

## 0.3.6 — 親の実行順に揃えたJevを使う

- Jevの依存を `1606fc7` へ更新した。操作の選択と実行は親のループに揃え、フォークで追加していた初回BLOCKEDの待機を外した。UTF-8、選択欄の名前、原因コード、クリック位置、入れ子のスクロールとチェック状態の修正は引き続き使う。
- Browser Harnessのライブラリも、同じ整理済みのソース `9efaa61` へ固定した。

## 0.3.5 — モデルAPIの失敗の原因を示し、入口が無い時は呼び出したAIに続きを任せる

- 依存するjev-ultrafastのフォークを `1b39904` に上げた。モデルAPIが失敗した時、`BrowserUseError` が `HTTP 400` だけでなく `max_tokens_exceeded` や `authentication_error` などの短い原因コードを含む。通信失敗では `ReadTimeout` などの例外の種類を含む。応答本文と認証値は出さない。
Expand Down
2 changes: 2 additions & 0 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ jev-bookmarks run 'Show the Example Domain page'

The command first checks `<git-root>/jev-bookmark/bookmarks.json`, then asks the Chrome extension for history candidates if needed. Jev selects an existing URL, `jev-ultrafast` operates Chrome, and Jev judges the page observed after the operation. Only a useful page is saved. The result is JSON; the parent agent does not need to choose or approve intermediate steps.

Version 0.3.6 pins Jev to the maintained source that follows the upstream execution sequence. Jev Bookmarks continues to own the separate usefulness judgment for address-book entries.

## Install (macOS, Windows, Linux)

You need Python 3.12, `uv`, Git, Google Chrome, a TypeSafe API key, and a working `jev-ultrafast` model configuration.
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,8 @@ flowchart LR
| 通常のブックマーク | 利用者が登録する | 利用者が判断する | 残る |
| Jev Bookmarks | 目的文からJevが選ぶ | Jevがページを判定する | 役立ったURLだけプロジェクトに残る |

0.3.6は、親の実行順に揃えたJevの版を使います。操作の選択と実行はそのループが担当し、電話帳へ残すページの有用性判定は従来どおりJev Bookmarksが行います。

## 導入

Python 3.12、`uv`、Git、Google Chrome、[TypeSafe](https://docs.typesafe.ai/)のAPIキー、[jev-ultrafast](https://github.com/browser-use/jev-ultrafast)が使うモデル設定が必要です。jev-ultrafastは、上流に修正が入るまで[フォーク](https://github.com/quolu/jev-ultrafast)の版を使います(`uv sync` で自動的に入ります)。手順はmacOS・Windows・Linuxで同じです(Windowsは PowerShell で実行します)。
Expand Down
2 changes: 1 addition & 1 deletion docs/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ sequenceDiagram
| Native Messaging host | Chrome拡張とローカルコマンドを接続する。ブラウザの内部DBを読まない。 |
| Jev Bookmarksのローカルコマンド | `run` の全工程、Jevへの問合せ、操作後の有用性判定、電話帳の永続化を所有する。別に一覧と削除を提供する。 |
| TypeSafe Jev | 有限個のURL候補から選び、操作後のページが目的に役立つかを判定する。 |
| 上流 `jev-ultrafast` | 開始URLと目的を受け取り、Browser Harness経由でChromeを観測・操作する。各操作の選択は上流ループが所有する。上流 browser-use/jev-ultrafast に私たちの修正が入るまでは、フォーク quolu/jev-ultrafast の確認済みの版をコミットで固定して使う。上流に入ったら上流へ戻す。 |
| 上流 `jev-ultrafast` | 開始URLと目的を受け取り、Browser Harness経由でChromeを観測・操作する。各操作の選択は上流ループが所有する。上流 browser-use/jev-ultrafast に私たちの修正が入るまでは、フォーク quolu/jev-ultrafast の確認済みの版をコミットで固定して使う。上流に入ったら上流へ戻す。0.3.6は親の実行ループに揃えた `1606fc7` を使う。 |

Chrome拡張からホストへは `connectNative` を使う。拡張が起動したホストは同じユーザーだけが接続できるローカルIPCを開き、コマンドからの履歴要求を拡張へ渡す。macOSとLinuxは所有者だけが入れる一時ディレクトリのUnixソケット、Windowsは起動ごとの鍵で相互認証する名前付きパイプを使う。WindowsのChromeはレジストリ(HKCU)に登録したマニフェストを読む。hostは専用拡張のoriginから起動された時だけ待ち受け、待受先と鍵ファイルは0.2系(普段のChromeへ読み込んでいた旧拡張)のものと分ける。普段のChromeに旧拡張が残っていても、専用Chromeの接続を横取りしない。`install` は0.2系が普段のChrome向けに置いたマニフェストを消す。拡張は要求時に履歴を検索して結果を返す。

Expand Down
4 changes: 2 additions & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
[project]
name = "jev-bookmarks"
version = "0.3.5"
version = "0.3.6"
description = "Chrome履歴から役立つページを選び、Jevで操作してプロジェクトごとに記録する"
license = "MIT"
requires-python = ">=3.12"
dependencies = [
"filelock>=3.32.7,<4",
"httpx[http2]>=0.28,<1",
# 上流 browser-use/jev-ultrafast に私たちの修正(UTF-8での読み込みなど)が入るまで、フォークの確認済みの版を使う。
"jev-ultrafast @ git+https://github.com/quolu/jev-ultrafast.git@1b399041e0920834b1bd0cd2c375db10f2a0dfa8",
"jev-ultrafast @ git+https://github.com/quolu/jev-ultrafast.git@1606fc7319352a08f4d8752eedad87b860d95250",
"websockets>=15,<16",
]

Expand Down
12 changes: 4 additions & 8 deletions uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading