爪爪 · Paw Work

利用者がエディタを選ぶ操作はない。ファイルの型がそのまま表示面を決める、という対応になっている。

取り込み時の分類

ファイルを開くときの振り分けは classifyOpenArtifact() 一箇所に集約されている。マジックバイトが優先され、ファイル名と MIME はヒント扱い。ZIP（PK）と PDF（%PDF）を UTF-8 として文字列化することはしない、と明記されている。

利用者のメッセージはすべて sendMessage を通る。ユーザーに見える「チャットモード / 実行モード」の切り替えは存在しない。

プロダクトの入口

エージェント作業のランタイム入口は 1 本に固定されている。

src/agent/vnext/runSession.product.js

エージェントが開いた作業タブは active: false で静かに開き、セッションごとに 1 つの Chrome タブグループへ入る。利用者が「打开」で開いたときはフォーカスする。書き込み中はそのセッションの作業タブがロックされる（ライブページ側はロックしない）。

ツールは段階的開示ではなく、常に tools[] に載っている。9 つ目は作らない、というのが明文の制約。

計算と適用を分ける

大量の行やスロットを扱うときは、run が計算して /scratch に JSON を置き、公式ツール側は path / from でそれを読む。モデルが結果を打ち直す経路を作らない、という分担になっている。ファイルが無ければ ENOENT、中身が空や不正なら BAD_INPUT で止まる。

run          # /scratch に計算結果の JSON を書く
sheet|deck|doc|web
             # path / from でその JSON を読み、公式コマンドで適用
             # 欠落 → ENOENT / 空・不正 → BAD_INPUT

fail-closed になっている境界

• 目印のない見栄えだけの HTML は Design ファイルとして着地できない（USE_CANVAS）。
• 対象のキャンバスが無い場合は NO_CANVAS。同種が 2 つあって対象指定が無ければ AMBIGUOUS_CANVAS / AMBIGUOUS_WORKBOOK。
• ピン留めしたノードなしのフィールド書き込みは NEED_SELECTION。ライブな Design タブなしの PNG / SVG / PDF 書き出しは NEED_TAB。
• QA が落ちたときは CANVAS_QA_FAILED と課題一覧が返り、同じ成果物を直す。新しいファイルへ逃げない。
• 空の公式書き込みは「成功 + 適用 0 件」ではなく BAD_INPUT として明言する。
• モデルは選択グループを書き換えられない（グループ書き込み API をツールに出していない）。

Chrome ウェブストアには未掲載。README は「使うだけならソースツリー全体をクローンしない」と強く注意しており、unpacked ブランチ（約 44 MB）だけを取得する手順を案内している。そのフォルダがそのまま拡張本体で、ルートに manifest.json がある。

git clone --depth 1 --single-branch --branch unpacked \
  https://github.com/Player-YN/PawWork_ZhuaZhua.git paw-work
realpath paw-work

1. 上のブロックを実行する。最後の行が取得先の絶対パスを出力する（Windows は PowerShell 版が README にある）。
2. Chrome で chrome://extensions を開く。
3. デベロッパーモードを有効にする。
4. パッケージ化されていない拡張機能を読み込むで、出力されたパスのフォルダを選ぶ。

git を使わない場合は GitHub 上でブランチを unpacked に切り替えて ZIP をダウンロードするか、リリースページの paw-work-unpacked.zip（同一バイト）を使う。Node も npm install も不要。

ソースからビルドする場合

前提は Node.js 20+、npm、Chrome 120+。

git clone https://github.com/Player-YN/PawWork_ZhuaZhua.git
cd PawWork_ZhuaZhua
npm install
npm run build:agent
npm run pack:extension

読み込むのは artifacts/unpacked/。npm install 後のリポジトリルートは node_modules を含んで数百 MB になるため、ルートを読み込んではいけないと明記されている。src を編集した日常の作業では npm run pack:dev（Univer / tldraw の再ビルドなし）のあとに拡張を再読み込みする。

• ウェブストア未掲載。unpacked ブランチかリリース zip からのサイドロードは暫定手段で、ストアが後の正面玄関という位置づけ。
• 拡張のみ。Chromium MV3。ホスティングされたサービスもアカウントも無い。
• BYOK 必須。チャット・画像・ウェブ取得それぞれに自分のキーが要る。
• tldraw の透かし。本番ライセンスが無ければ Design / Slides に公式の透かしが出る。CSS や DOM で隠すのはサポート外であり許容しない、と明記されている。
• キャプチャは真実の全部ではない。選択は意図であり、エージェントは必要に応じて調べ、成果物の型が本当に不明なときだけ一度だけ聞く。
• Excel / PowerPoint / ブラウザ RPA の完全な置き換えではない。ライブキャンバスが作業面であり、無人で巡回・決済・送信はしない。
• スイートの緑はそれ自体では成果ではない。テストが通ることを完成の証明としない、と設計文書側で明示されている。

• GitHub: Player-YN/PawWork_ZhuaZhua — 公開ソースツリー（MIT）
• unpacked ブランチ — 拡張本体のみ。使うだけならこちら
• 最新リリース — paw-work-unpacked.zip（同一バイト）
• Univer — 表計算とドキュメントのライブキャンバス
• tldraw — Design / Slides のキャンバス
• Vercel AI SDK — ToolLoopAgent のエージェントループ
• QuickJS — 生成コードを走らせる WASM VM

リポジトリ内でランタイム契約を読むなら docs/SESSION_WORKSPACE_RUNTIME.md（プロダクト憲章）、docs/PROMPT_RUNTIME.md（判断と拘束の分担）、docs/RUNTIME_STACK.md（スタックと自前ビルドの境界）、docs/CWS_CODE_RUNTIME.md（生成コードとストアの境界）。