> For the complete documentation index, see [llms.txt](https://doc.qrspace.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.qrspace.dev/he-xin-kong-jian-jia-gou/dynamic-island.md).

# 頂部動態島

{% hint style="warning" %}
**開發中**：動態島目前只在[線上試用頁](https://qrspace.dev/browser/prototype/)看得到，0.2.0-preview\.26 的瀏覽器裡還沒有。下載進度目前顯示在網址列右邊的下載圓圈。
{% endhint %}

頂部動態島（Dynamic Island）是口袋瀏覽器的輕量狀態通知中心，位於網址列下方中央。

***

## 核心設計理念

傳統瀏覽器的提示對話框（Notification / Alert）通常具有強侵入性，容易打斷使用者的閱讀節奏；若以靜態圖示常駐於狀態列，又會浪費介面空間。

動態島採用「事件觸發」機制：

* 平常處於完全收合或微小圓角標記狀態，不佔用任何主要視窗空間。
* 當有系統事件或使用者動作發生時，平滑展開為膠囊狀面板，顯示簡明反饋。
* 顯示完畢後自動縮回，不需手動點擊關閉。

***

## 觸發情境與展示狀態

### 1. 定時動作倒數與通知

當設定了定時關閉、重新整理或鬧鐘腳本時，動態島會在即將執行前顯示倒數時間與網址名稱。

### 2. 檔案下載進度

觸發檔案下載時，動態島即時顯示：

* 檔案名稱與下載速率
* 圓形或線性進度條
* 下載完成後的快速開啟按鈕

### 3. 剪貼簿與收集提示

當執行截圖、文字摘錄或將檔案丟入「集合」容器時，動態島顯示簡短入庫反饋（例如「已儲存至集合」），確認資料已安全寫入。

### 4. 同步與安全狀態

當產生 Session 復原 QR Code、或金庫完成密碼填入時，動態島同步提供狀態認證。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.qrspace.dev/he-xin-kong-jian-jia-gou/dynamic-island.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
