Refactor Google Meet Transcripts Extension for Local Use

- Removed all cloud-related functionalities, including login prompts and token handling. - Disabled Laxis cloud features, ensuring no data is sent to external servers. - Updated manifest to reflect the new local-only functionality. - Added a new Python server to handle transcripts locally, including WebSocket support. - Implemented storage management for transcripts, including deduplication and file writing. - Created a smoke test for the WebSocket server to simulate transcript updates. - Updated README with setup instructions and usage details for the new local server.
2026-06-12 00:31:32 +03:30
parent 602dcb7430
commit 7bc34c79ed
35 changed files with 1069 additions and 840 deletions
@@ -0,0 +1,116 @@
+# Result — 002 Planning
+
+> اکشن مرتبط: [`action/002_action_planning.md`](../action/002_action_planning.md)
+> تاریخ اجرا: 2026-06-09
+
+---
+
+## هدف این جلسه
+
+خواندن پروژه، فهمیدن ساختار، و پیاده‌سازی گام اول MVP:
+اتصال افزونه‌ی Chrome به یک سرور پایتون بیرون مرورگر از طریق WebSocket.
+
+---
+
+## تصمیم‌های کلیدی که گرفته شد
+
+### معماری — چرا extension به‌عنوان WS client؟
+
+افزونه نمی‌تواند خودش سرور باشد (MV3 سرویس‌ورکر TCP port نمی‌تواند باز کند).
+پس **افزونه client است و پایتون server** — افزونه به `ws://127.0.0.1:8765` وصل می‌شود.
+
+همچنین WS باید از service worker باز شود، نه content script؛ چون content script
+تابع CSP صفحه‌ی گوگل میت است و `connect-src` اتصال را بلاک می‌کند.
+
+### نقطه‌ی hook در کد افزونه
+
+`setSpeaker()` در `storage.js` — هر پاراگراف caption نهایی از این تابع رد می‌شود.
+یک `chrome.runtime.sendMessage` کوچک به آن اضافه شد که background را خبر می‌کند.
+
+### venv برای پایتون
+
+تصمیم گرفته شد پایتون داخل `.venv` اجرا شود تا سیستم کثیف نشود.
+
+---
+
+## چه چیزی ساخته شد
+
+| فایل | نوع | کار |
+|------|-----|-----|
+| `bridge/server.py` | جدید | WebSocket server پایتون روی `127.0.0.1:8765` |
+| `bridge/requirements.txt` | جدید | فقط `websockets>=12.0` |
+| `bridge/.gitignore` | جدید | `.venv/` و `transcripts/` از git خارج |
+| `bridge/README.md` | جدید | راهنمای اجرا با venv |
+| `bridge/_smoke_test.py` | جدید | کلاینت تستی بدون Chrome |
+| `bridge/.venv/` | جدید | محیط ایزوله پایتون |
+| `google-meet-transcripts-extension/bridge.js` | جدید | WS client داخل service worker |
+| `login.js` | ویرایش | اضافه شدن `importScripts("bridge.js")` |
+| `storage.js` | ویرایش | `setSpeaker` حالا `TRANSCRIPT_UPDATE` می‌فرستد |
+| `manifest.json` | ویرایش | `ws://127.0.0.1:8765/*` به `host_permissions` اضافه شد |
+
+---
+
+## تست انجام شده
+
+سرور پایتون با `_smoke_test.py` end-to-end تست شد:
+- PING → PONG ✅
+- سه `TRANSCRIPT_UPDATE` → سه ACK ✅
+- فایل `transcripts/meeting-abc123.txt` با متن فارسی درست ذخیره شد ✅
+
+تست با Chrome واقعی هنوز انجام نشده (نیاز به Reload افزونه و یک جلسه‌ی Meet).
+
+---
+
+## وضعیت چک‌لیست اصلی (از action)
+
+- [x] حذف کدهای laxis — **انجام شد** (اجرای ۲۰۲۶-۰۶-۱۰، پایین را ببین)
+- [x] لوگوی اختصاصی — **انجام شد** (لوگوی جدید جایگزین شد)
+- [x] گرفتن caption از افزونه — گام ۱ (اتصال) انجام شد
+- [x] سرویس MCP روی پورت — **انجام شد** (روی همان `server.py`)
+- [ ] تست میدانی با Chrome واقعی — باقی‌مانده (نیاز به مرورگر و یک جلسه‌ی Meet)
+
+---
+
+## اجرای دوم — پاک‌سازی laxis + MCP + لوگو (۲۰۲۶-۰۶-۱۰)
+
+### پاک‌سازی laxis (هیچ داده‌ای دیگر بیرون نمی‌رود)
+
+- `analytics.js`: کاملاً خالی شد (از قبل کامنت‌شده و مرده بود؛ در manifest هم لود نمی‌شد).
+- `login.js` (service worker): بازنویسی شد — حذف `tabs.onRemoved` (که transcript را آپلود می‌کرد)،
+  حذف `onMessageExternal` (دریافت توکن) و `getTopics`. فقط import ها + نگه‌داشتن وضعیت لوکال ماند.
+- `runtime.js` (content script): حذف فراخوانی `addRemindLogin()` و کل listener دریافت توکن/fetch.
+- `meetingInfo.js`: `checkToken` و `renewToken` با `return;` در ابتدا خنثی شدند؛ آپلود پایان جلسه
+  (`Export2App` + باز کردن `domainUrl/transcript`) حذف شد.
+- `transcript.js`: `Export2App` بلافاصله reject می‌کند (آپلود ابری قطع)، `getTopics` خنثی شد،
+  `addRemindLogin` خالی شد، منوی دانلود از حالت پیش‌فرضِ «app/cloud» به دانلود محلی `txt` تغییر کرد.
+- `panel/main.js`: لینک لوگو → `domainUrl/login` در هر سه جا حذف شد؛ متن‌های برند «Laxis…» حذف شدند.
+- `manifest.json`: `update_url` فروشگاه حذف شد (که افزونه با ID لاکسیس آپدیت نشود)؛ name/description
+  به نسخه‌ی محلی و بدون cloud تغییر کرد.
+
+### MCP روی server.py
+
+سرور حالا در یک پراسس هم WebSocket (برای افزونه) و هم MCP stdio (برای Claude) را اجرا می‌کند و
+حافظه‌ی `sessions` را share می‌کنند. ابزارها: `list_sessions`، `get_transcript`،
+`get_latest_transcript` و resource با الگوی `transcript://{session_id}`. کانفیگ Claude Desktop در
+`bridge/README.md`.
+
+### درس‌آموخته‌ها
+
+- **stdout برای MCP رزرو است:** همه‌ی `print` ها به stderr منتقل شدند، وگرنه استریم JSON-RPC خراب می‌شود.
+  برای تست دستیِ WebSocket باید از `python server.py --ws-only` استفاده کرد.
+- **کد افزونه minified است:** برای فایل‌های فشرده (`meetingInfo.js`) به‌جای حذفِ بدنه‌ها، با `return;`
+  در ابتدای تابع خنثی‌سازی شد (کم‌ریسک‌تر). کدِ مرده باقی می‌ماند ولی هرگز اجرا نمی‌شود.
+- **یک رشته‌ی غیرفعال باقی‌ست:** متنِ «Autosave to Laxis cloud…» در `displayGoogleMeetQuota`
+  (`transcript.js`) داخل کدِ مرده مانده — هرگز نمایش داده نمی‌شود چون فراخوان‌هایش خنثی‌اند.
+
+### تأیید (validation)
+
+- syntax همه‌ی فایل‌های JS با `node --check` پاس شد.
+- منطق `server.py` با AST + یک smoke test واقعیِ WebSocket (PONG/ACK + ذخیره‌ی صحیح فارسی) تأیید شد.
+- ابزار/resource های MCP با `mcp` SDK ساخته و اجرا شدند (`get_latest_transcript` متن را درست برگرداند).
+
+### باقی‌مانده برای تو
+
+تست میدانی: venv را بساز/فعال کن، `python server.py --ws-only` را اجرا کن، افزونه را در
+`chrome://extensions` **Reload** کن، در یک Meet واقعی caption را روشن کن و خروجی را در
+`bridge/transcripts/` ببین. بعد کانفیگ MCP را به Claude Desktop اضافه کن.