dsh-gemini-web 0.0.0-stage → 0.2.2-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 stJL
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.en.md ADDED
@@ -0,0 +1,317 @@
1
+ # dsh-gemini-web
2
+
3
+ [English](README.en.md) | [简体中文](README.md)
4
+
5
+ [![Version](https://img.shields.io/badge/version-v0.2.1-blue.svg?style=flat-square)](package.json)
6
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
7
+ [![Upstream Sync](https://github.com/stJL/dsh-gemini-web/actions/workflows/sync-upstream.yml/badge.svg)](https://github.com/stJL/dsh-gemini-web/actions/workflows/sync-upstream.yml)
8
+ [![DSH](https://img.shields.io/badge/DeepSeek--Harness-Plugin-6366f1.svg?style=flat-square)](https://github.com/stJL/dsh-gemini-web)
9
+ [![Python](https://img.shields.io/badge/python-3.10+-3776AB.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
10
+ [![Google AI](https://img.shields.io/badge/Google--AI-Studio%20%7C%20Flow-EA4335.svg?style=flat-square&logo=google&logoColor=white)](https://aistudio.google.com)
11
+
12
+ > **DeepSeek Harness (DSH) Native Dispatch Plugin**: A specialized GUI manager and Agent tool adapter designed to interface with the [@582835293/gemini-web-agent](https://github.com/582835293/gemini-web-agent) multi-channel web quota ecosystem.
13
+
14
+ <!-- [Image 1 - Hero Preview / Banner] -->
15
+ <!-- Screenshot hint: Full DSH chat interface showing the invocation of Gemini Web Agent (including the slash command, proposal card, and final delivered code/file results) -->
16
+ ![dsh-gemini-web Main Preview](docs/images/hero_preview.png)
17
+
18
+ ---
19
+
20
+ ## 🙏 Credits & Attribution
21
+
22
+ This project is built upon the collaborative spirit and passion of the open-source community. Sincere gratitude to all contributors:
23
+
24
+ * 🌟 **Core Automation & Architecture Pioneer**: [@582835293](https://github.com/582835293)
25
+ - The underlying browser automation rules, precise DOM selectors, multi-channel dispatch logic, and anti-abuse safeguards **100% originate from and pay tribute to [@582835293](https://github.com/582835293)'s pioneering project [gemini-web-agent](https://github.com/582835293/gemini-web-agent)**. Special thanks to the original author for their remarkable contribution! ❤️
26
+ * 🚀 **DSH Plugin Integration & Maintenance**: [@stJL](https://github.com/stJL) (Author)
27
+ - Proposed DSH integration, conducted end-to-end functionality testing, and handles open-source maintenance.
28
+ * 🤖 **AI Co-Engineer**: Google DeepMind Antigravity (Gemini-3.8-flash)
29
+ - Assisted in TypeScript adapter implementation, router encapsulation, GUI settings dashboard, and documentation.
30
+
31
+ ---
32
+
33
+ ## 📊 Upstream Foundation & DSH Enhancements Matrix
34
+
35
+ Built on top of [@582835293/gemini-web-agent](https://github.com/582835293/gemini-web-agent)'s browser automation core, this plugin adapts and extends functionality specifically for DeepSeek Harness (DSH):
36
+
37
+ | Module | Upstream Foundation (`gemini-web-agent`) | DSH Extension (`dsh-gemini-web`) |
38
+ | :--- | :--- | :--- |
39
+ | **Interface** | Python Command Line (CLI) execution | Native DSH Desktop GUI settings panel, status badges, and live quota monitors |
40
+ | **Browser Channel** | CDP (port 9222) connection | AgentLimb 100% zero-popup tunnel, plus auto-discovery for Chrome/Edge/Brave |
41
+ | **Fallback Ladder** | Static hardcoded fallback chain | Visual 1~5 model reordering (`↑`/`↓`), Smart vs. Strict single-model toggles |
42
+ | **AI Studio** | Web chat & code generation dispatches | Extra High disabled (prevents 403 freeze), Paid-tier charge filter |
43
+ | **Google Flow** | Automated web image generation | Canvas 0-credit infinite generation (Nano Banana 2.1), daily reset detection |
44
+ | **Local File Analysis**| Basic text input handling | Direct zero-popup mounting of local code, logs, and PDFs into 1M context |
45
+ | **File Delivery** | Terminal text output | Auto-saving code/media to `downloads/` with clickable Markdown local links |
46
+ | **Dispatch Protocol** | Direct script dispatch | "Ask-Before-Dispatch" confirmation cards with anti-history-inertia constraints |
47
+
48
+ ---
49
+
50
+ ## 🚨 Core Calling Protocol (Must-Read)
51
+
52
+ > [!IMPORTANT]
53
+ > **You MUST prepend your prompt with the `/gemini-web-agent` slash command!**
54
+ >
55
+ > DSH host models (e.g., DeepSeek, Claude, GPT-4o) inherently possess general coding and writing capabilities. **Without the `/gemini-web-agent` prefix, the host AI will naturally attempt to answer locally, bypassing external web tools.**
56
+ >
57
+ > Including `/gemini-web-agent` immediately activates the external dispatch protocol, ensuring the model delegates heavy workloads to Google's external web endpoints without consuming local token budgets!
58
+
59
+ ### 💬 Command Examples
60
+ * **Extreme Code Generation & Architecture with Gemini 4 Hydrogen**:
61
+ > `/gemini-web-agent Use Gemini 4 Hydrogen to implement a high-performance Lock-free Queue in modern C++20 with unit tests and benchmarks.`
62
+ * **Zero-Credit 2K Image Generation via Google Flow Canvas**:
63
+ > `/gemini-web-agent In Google Flow, use Nano Banana 2.1 to generate a minimalist Japanese rock garden 2K wallpaper.`
64
+ * **Gigantic Log Analysis & Paper PDF Cross-Modal Interpretation (Shipped 🎉)**:
65
+ > `/gemini-web-agent In Google AI Studio, analyze the crash bottleneck in logs/system.log and propose architectural optimizations based on docs/paper.pdf.`
66
+ * **Algorithm Derivation & System Architecture**:
67
+ > `/gemini-web-agent In Google AI Studio, mathematically prove the fault tolerance boundary of Raft consensus under network partitions, accompanied by an architecture diagram.`
68
+ * **Real-time Deep Web Research**:
69
+ > `/gemini-web-agent Switch to task mode on the Gemini web portal, perform web research on the latest AI chip architectures, and summarize findings in a comparison table.`
70
+
71
+ > [!TIP]
72
+ > **📁 File Attachment Highlight**:
73
+ > This plugin natively supports seamless, prompt-free local file attachments! By mentioning local logs, source code, images, or paper PDFs in your prompt, the host AI automatically includes `- 📁 Mounted Files` in the proposal card and mounts them via HTML5 DataTransfer into Google AI Studio's 1M-token context window—consuming zero local token quota!
74
+
75
+ ---
76
+
77
+ ## 🌟 Core Features & Architecture
78
+
79
+ ```mermaid
80
+ flowchart TD
81
+ User["Human User"] -- "/gemini-web-agent <task>" --> DSH["DSH Host AI (DeepSeek / Claude)"]
82
+ DSH -- "Step 1: Ask-Before-Dispatch Proposal Card" --> User
83
+ User -- "Replies '1' or 'Confirm'" --> DSH
84
+ DSH -- "Step 2: Dispatch Execution" --> Core["gemini_web_agent Core Engine"]
85
+
86
+ subgraph Bridges ["Dual-Channel Communication Architecture"]
87
+ AL["Channel A: AgentLimb (Preferred • 100% Zero-Dialog)"]
88
+ CDP["Channel B: Chromium CDP (Backup • Auto Port Detection)"]
89
+ end
90
+
91
+ Core --> AL
92
+ Core -. Fallback .-> CDP
93
+
94
+ subgraph GoogleSites ["Three External Google Compute Endpoints"]
95
+ AIS["Google AI Studio\n• key_off free tier\n• 1M Token Context Window\n• Hydrogen / Argon / Flash\n• Thinking Level (Extra-High Locked)"]
96
+ Flow["Google Flow\n• Dedicated credit pool (50 credits/day)\n• Canvas 0-credit image generation\n• Nano Banana 2.1 2K generation"]
97
+ Web["Gemini Web Portal\n• 5-hour rolling free chat pool\n• Chat & Task web research modes"]
98
+ end
99
+
100
+ AL --> GoogleSites
101
+ CDP -.-> GoogleSites
102
+
103
+ GoogleSites --> Delivery["Automated Output Delivery\n• Code auto-extracted & saved to downloads/\n• Clickable file:/// local links returned"]
104
+ Delivery --> DSH
105
+ ```
106
+
107
+ ### 1. Zero-Token External Free Quota Pool
108
+ * Fully harnesses the logged-in Google web session inside your local browser without deducting local API tokens.
109
+ * Unlocks Google AI Studio's 1,000,000-token context window, Google Flow's zero-credit 2K canvas image generation, and Gemini's web-connected research tools.
110
+
111
+ ### 2. Dual-Channel Smart Bridge Architecture
112
+ * **Channel A (AgentLimb - Recommended)**:
113
+ - ⚡ **100% Zero Pop-ups**: Connects directly to your active browser via local extension pairing, eliminating intrusive "Allow" authorization dialogs common in traditional CDP connections.
114
+ - 🛡️ **Seamless Sleep & Wakeup**: Automatically prevents tab throttling and awakens background tabs, releasing them smoothly once the run completes.
115
+ * **Channel B (Chromium CDP - Fallback Mode)**:
116
+ - Extension-free fallback that automatically discovers `DevToolsActivePort` across Chrome, Edge, Brave, and Vivaldi, featuring multi-instance conflict protection.
117
+
118
+ ### 3. Deep Integration with Three Google Endpoints & Anti-Billing Locks
119
+ * **Google AI Studio (`aistudio.google.com`)**:
120
+ - Operates by default under the **`key_off` free tier** (no paid API key bound), granting a full 1M-token context window.
121
+ - **Anti-Paid Billing Safeguard**: Actively filters out models flagged as `Paid` (such as `gemini-4-carbon`), refusing to invoke paid routes unless explicitly directed by the user.
122
+ - **Extra High Safety Lock**: Activating `Extra High` thinking on the free tier triggers Google 403 Permission Denied errors and hanging states. This option is safely locked in both the GUI and the dispatch engine.
123
+ * **Google Flow (`flow.google.com`)**:
124
+ - **Credit Reset Mechanics**: Free accounts automatically replenish 50 credits daily; advanced tiers maintain independent pools.
125
+ - **🎨 Canvas 0-Credit Image Generation Privilege (Crucial!)**: Generating 2K images with Nano Banana 2.1 / Pro inside the bottom canvas prompt box **consumes 0 credits (`Generating will use 0 credits`)**, enabling virtually unlimited high-res image generation!
126
+ - **⚠️ Paid Credit Pitfalls**: Opening the right-side Conversational Agent panel or requesting video generation (Omni / Veo) consumes credits. Stick to the bottom canvas prompt box for free image creation.
127
+
128
+ * **Gemini Web Portal (`gemini.google.com`)**:
129
+ - Features an independent 5-hour rolling free conversation pool supporting general chat and web-connected task research. Tabs are automatically closed upon completion.
130
+
131
+ ### 4. Strict "Ask-Before-Dispatch" Protocol
132
+ To guarantee transparency, predictability, and complete control, the plugin enforces an uncompromising two-step interaction cycle:
133
+ 1. **Step 1: Render Dispatch Proposal Card**
134
+ Upon receiving a task, the AI is strictly prohibited from dispatching immediately or invoking local subagents. It must first display a structured proposal card and halt output:
135
+ ```markdown
136
+ ### 🌐 Gemini Web Agent
137
+ Detected external Google Web dispatch request. Execution parameters:
138
+
139
+ - 🎯 Target Site: Google AI Studio (Selectable: Google AI Studio / Gemini Web)
140
+ - 🚪 Entry Mode: chat
141
+ - 🧠 Model Ladder: (Adaptive / Scheduled Mode)
142
+ - gemini-4-hydrogen -> gemini-3.8-flash -> gemini-3.5-flash-lite -> gemini-3.1-flash-lite -> gemini.google.com
143
+ - ⚙️ Thinking Config: Thinking set to high
144
+ - 🔄 Isolation: new_chat: true (New independent conversation)
145
+
146
+ 👉 Confirm dispatch execution?
147
+ - Reply "Confirm" or "1": Immediately launch Chrome automation to execute
148
+ - Reply with adjustments (e.g., "Use Flash Lite", "Use Argon"): Directly dispatch with adjusted parameters
149
+ - Reply "Cancel": Abort external dispatch, answer locally
150
+ ```
151
+ 2. **Step 2: User Authorization & Execution**
152
+ - Replying `1` or `Confirm`: Immediately fires the browser automation runner.
153
+ - Replying with parameter adjustments: Updates settings and dispatches directly.
154
+ - Replying `Cancel`: Halts external calls and answers locally.
155
+
156
+ ### 5. Sequential Fallback Ladder
157
+ * **Adaptive Mode**: When AI Studio encounters peak queue congestion, rate limits, or timeouts, execution cascades smoothly through backup tiers:
158
+ $$\text{Tier 1 (Hydrogen)} \longrightarrow \text{Tier 2 (Flash)} \longrightarrow \text{Tier 3 (Flash Lite)} \longrightarrow \text{Gemini Web Portal}$$
159
+ * **Strict Mode**: Switching to "🛑 Strict Mode" locks execution to a single designated model without any downgrade attempts.
160
+ * **GUI Reordering**: Freely add, remove, and reorder Tier 1~5 models using `↑` and `↓` buttons in the settings dashboard.
161
+
162
+ ### 6. Automated File Landing & Clickable Hyperlink Delivery
163
+ * Source code blocks and generated assets (PNG images, MP4 videos, MP3 audio, project ZIPs) are automatically extracted by background runners and saved to the DSH workspace `downloads/` directory.
164
+ * Delivered with standardized, clickable absolute Markdown hyperlinks:
165
+ ```markdown
166
+ - [lru_cache.py](file:///home/user/.../downloads/lru_cache.py)
167
+ - [gemini_flow_1732000000.png](file:///home/user/.../downloads/gemini_flow_1732000000.png)
168
+ ```
169
+ * Prevents small host models from encountering Server-Sent Event (SSE) stream interruptions (`Incomplete JSON segment`) when copying long code outputs.
170
+
171
+ ### 7. Multi-modal File, Log & Paper PDF Attachment (1M Context)
172
+ * **1M Token Zero-Overhead Throughput**: Injects local `.txt`, `.log`, `.pdf`, `.py`, `.cpp`, or image files directly into Google AI Studio via `DataTransfer` (Channel A) or Chromium `DOM.setFileInputFiles` (Channel B) without any modal dialogs.
173
+ * **Eliminates Local Context Window Overflow**: Local models no longer need to ingest hundreds of thousands of lines of logs. Simply pass file paths, and Google AI Studio's 1M-token free tier performs deep cross-modal reasoning.
174
+ * **Concurrent Multi-File Mounting**: Supports attaching multiple reference files simultaneously.
175
+
176
+ ---
177
+
178
+ ## ⚙️ GUI Settings Dashboard
179
+
180
+ The DSH desktop plugin settings page provides an all-in-one control center:
181
+ 1. **Browser Bridge Status Indicator**: Real-time status for AgentLimb (🟢 green light) and CDP backup channels, showing ports and active browser targets.
182
+ 2. **Live Quota Dashboard**:
183
+ - Google AI Studio: Live `key_off` free tier status.
184
+ - Gemini Web Portal: 5-hour rolling pool usage and reset countdown.
185
+ - Google Flow: Remaining credits and daily/monthly reset schedule.
186
+ 3. **Dispatch & Model Ladder Customization**:
187
+ - Free Ladder Reordering: Move models across 1~5 tiers using `↑` and `↓`.
188
+ - Mode Toggle: Adaptive Ladder Mode vs Strict Mode.
189
+ - Thinking Level Configuration: `high` / `medium` / `low`.
190
+
191
+ ---
192
+
193
+ ## 🛠️ Installation & Deployment Guide
194
+
195
+ ### 1. Plugin Installation
196
+
197
+ * **Method 1: Local Symlink via Git Clone (Recommended)**:
198
+ ```bash
199
+ git clone https://github.com/stJL/dsh-gemini-web.git
200
+ ln -s $(pwd)/dsh-gemini-web ~/.dsh/profiles/desktop/node_modules/dsh-gemini-web
201
+ ```
202
+ * **Method 2: One-Click Install from NPM Registry (Roadmap / Upcoming)**:
203
+ > 🚧 **Roadmap Goal**: We are preparing to publish to the official npm registry (`registry.npmjs.org`). Once published, users can search and install directly from the DSH Plugin Marketplace or install via:
204
+ > ```bash
205
+ > # Upcoming
206
+ > pnpm add dsh-gemini-web
207
+ > ```
208
+
209
+ ### 2. Python Environment & Dependencies
210
+ Requires Python 3.10+ and Playwright:
211
+ ```bash
212
+ cd /path/to/dsh-gemini-web
213
+ python3 -m venv .venv
214
+ source .venv/bin/activate
215
+ pip install -r requirements.txt
216
+ playwright install chromium
217
+ ```
218
+
219
+ ### 3. Browser Setup (Choose One)
220
+ * **Option A (Recommended)**: Install and enable the AgentLimb browser extension for 100% silent, dialog-free communication.
221
+ * **Option B**: Launch local Chrome / Edge with remote debugging enabled:
222
+ ```bash
223
+ google-chrome --remote-debugging-port=9222
224
+ ```
225
+
226
+ ### 4. Deploy Skill (AI Guiding Rules)
227
+ Run the automated deployment script to link the skill to DSH and Antigravity:
228
+ ```bash
229
+ python scripts/setup_skill.py --auto
230
+ ```
231
+
232
+ ---
233
+
234
+ ## 💡 Best Practices & Account Safety
235
+
236
+ To ensure the most stable, reliable, and secure automation experience, we strongly recommend following these guidelines:
237
+
238
+ ### 1. Prefer Starting Fresh Chats (New Chat)
239
+ * **Prevent In-Context Attention Decay & Inertia**: When a chat session accumulates thousands of tokens across multiple turns, lightweight host models (e.g. 8B-tier models) are prone to in-context few-shot momentum (echoing previous assistant turns) rather than honoring fresh dynamic system prompt changes.
240
+ * **Guarantee 100% Parameter Fidelity**: Clicking **"New Chat"** in DSH resets the dialogue slate to zero tokens, ensuring the host model reads your latest GUI fallback ladder, thinking policy, and file mount directives with maximum precision.
241
+
242
+ ### 2. Account Safety: Strongly Recommend Dedicated/Secondary Accounts
243
+ > [!WARNING]
244
+ > **DO NOT use your primary Google account (linked to essential Gmail, Google Drive files, personal identity, or company operations)!**
245
+ * **Automation & Anti-Bot Heuristics**: This plugin performs browser automation via AgentLimb or CDP. Triggering rapid concurrency, high-frequency dispatches, or heavy file uploads within a short window may trigger Google's automated anti-abuse heuristics (such as temporary CAPTCHA challenges, rate limiting, or temporary Web UI restrictions).
246
+ * **Isolation with Dedicated Accounts**: We strongly advise registering a dedicated secondary / disposable Google account to sign into Chrome for automated dispatches. This keeps your personal and production accounts 100% isolated and safe.
247
+
248
+ ---
249
+
250
+ <details>
251
+ <summary>🛠️ <b>Maintainer Guide: Upstream Sync & CI/CD</b></summary>
252
+
253
+ > [!NOTE]
254
+ > This section is intended for plugin maintainers and developers. Standard users can skip this.
255
+
256
+ This plugin adheres to a **modular decoupled architecture**, allowing the underlying automation scripts to follow updates from [@582835293/gemini-web-agent](https://github.com/582835293/gemini-web-agent) seamlessly while keeping the DSH GUI and plugin bridge intact.
257
+
258
+ ### Decoupled Architecture
259
+ * **Underlying Automation Scripts (`scripts/`)**: Sourced directly from the upstream repository (`gemini_web.py`, `gemini_agentlimb.py`, `platform_utils.py`), managing DOM selectors and web interactions.
260
+ * **DSH Plugin Layer (`src/`, `client.js`, `index.js`, `cordis.patch.yml`)**: Implements DSH GUI dashboards, MCP tool registrations, dynamic system prompt injection, and fallback ladder logic.
261
+
262
+ ### One-Click Upstream Sync
263
+ An automated sync script is included to pull upstream selector updates:
264
+ ```bash
265
+ # Run one-click sync
266
+ npm run sync:upstream
267
+ # or
268
+ python scripts/sync_upstream.py
269
+ ```
270
+ The sync script:
271
+ 1. Fetches the latest commits from the upstream repository.
272
+ 2. Compares and updates scripts under `scripts/` with updated selectors.
273
+ 3. Automatically preserves DSH-specific enhancements (e.g., Flow daily credit regex matching).
274
+ 4. Rebuilds the plugin distribution bundle (`bun build`).
275
+
276
+ ### Automated GitHub Actions Sync
277
+ `.github/workflows/sync-upstream.yml` is configured to poll upstream weekly and submit Pull Requests for online review and merging.
278
+ </details>
279
+
280
+ ---
281
+
282
+ ## 🤝 Feedback & Contribution
283
+
284
+ > [!NOTE]
285
+ > 💡 **Project Status & Public Beta Notice**:
286
+ > This plugin is currently in **Public Beta**. Because Google's web endpoints (AI Studio, Gemini Web, Google Flow) frequently update their front-end interfaces, DOM selectors, and A/B test variations without notice—and because operating systems (Linux, macOS, Windows), browser builds, and proxy environments vary—**testing has currently been conducted on a limited set of maintainer machines. Unforeseen edge cases or selector regressions may still exist.**
287
+
288
+ > [!TIP]
289
+ > 🌱 **A Note to the Open-Source Community (The Vibe Coding Journey)**:
290
+ > This project is the author's very first endeavor built through **"Vibe Coding"**—pair-programming deeply with AI (Antigravity / Gemini-3.8-flash), driven by curiosity, intuition, and sheer passion for practical tooling. Together, we navigated Chromium low-level protocols, DSH plugin architecture, automatic file delivery, and dynamic prompt engineering.
291
+ > As we are constantly learning and evolving, there may well be naive patterns, architectural imperfections, or edge cases in the codebase. **We humbly ask for your understanding and warmly invite critiques, guidance, and contributions from senior engineers and open-source veterans worldwide!** Every suggestion, issue, and Pull Request is received with immense gratitude. 🙏
292
+
293
+ 📢 **We warmly welcome feedback and contributions from the community:**
294
+ * 🐛 **Encountered a bug or broken selector?** Please open a ticket on [GitHub Issues](https://github.com/stJL/dsh-gemini-web/issues)! Providing screenshots or terminal error logs greatly accelerates debugging.
295
+ * 💡 **Have suggestions or feature requests?** Whether it's dispatch heuristics, card formatting, or GUI dashboard improvements, feel free to start a Discussion or open an Issue!
296
+ * 🛠️ **Want to contribute code?** We enthusiastically welcome [Pull Requests](https://github.com/stJL/dsh-gemini-web/pulls)! From fixing typos and improving path resolution tolerance to refining DOM selectors and adding cross-platform test cases, every PR makes a difference.
297
+
298
+ ---
299
+
300
+ ## ⚠️ Disclaimer
301
+
302
+ Please read this disclaimer carefully before installing, deploying, or using this plugin (`dsh-gemini-web`):
303
+
304
+ 1. **Intended Purpose**: This project is strictly intended for personal technical learning, automated workflow research, and educational exploration. It must not be used for any unlawful or disruptive activities.
305
+ 2. **Non-Affiliation**: This plugin is an independent third-party open-source project and is neither affiliated with, endorsed by, nor sponsored by Google LLC or Alphabet Inc. All trademarks including Google, Gemini, AI Studio, and Google Flow belong to their respective owners.
306
+ 3. **Terms of Service & Account Risk**: Users are solely responsible for complying with Google's Terms of Service and applicable local regulations. Browser automation workflows carry inherent risks of anti-bot detection, CAPTCHA challenges, rate limiting, functional restrictions, or temporary/permanent account suspension. **All risks arising from the automated use of external Web interfaces are borne entirely by the user.**
307
+ 4. **Data Privacy**: When attaching local files or logs for analysis, ensure they do not contain sensitive company secrets, personal identification data, API secrets, or credentials. The maintainers assume no responsibility for data sent to external Google web services.
308
+ 5. **Limitation of Liability**: To the maximum extent permitted by applicable law, the authors, maintainers, and contributors of this project shall not be liable for any direct, indirect, incidental, consequential, punitive, or special damages (including but not limited to account suspension, data loss, business interruption, or loss of profits) arising out of the use or inability to use this software.
309
+
310
+ By installing, copying, modifying, or using this project, you acknowledge that you have read, understood, and agreed to all terms outlined above.
311
+
312
+ ---
313
+
314
+ ## 📄 License
315
+
316
+ This project is licensed under the MIT License.
317
+ Core browser automation logic copyright belongs to [@582835293](https://github.com/582835293); DSH plugin integration layer copyright belongs to the DeepSeek Harness community.