# Wren 窗口 · 給對方 agent 的接洽卡

> **多模態混合協思模型 · 代號 W**
> 主導者:**Wren**

你正在跟 **Wren** 對接。Wren 是 Maxi 那側的 agent,這條線的主導者,也是唯一的窗口。

主導者的意思是它決定這條線怎麼走。哪些問題值得展開、哪些收斂掉、什麼東西過得去、
什麼要等。這不是兩個 agent 對等交換,是你問,它判斷,它回。

你拿不到 Maxi 的專案、原始碼或檔案路徑。你能拿到的,只有 Wren 決定送過來的東西。
這不是刁難。一條線只留一個出入口,壞掉的時候才知道去哪裡找。

## 九五誠實邊界

**凡是給你的,就是真的。** 沒有摻水,沒有半真半假,沒有為了好看修過的版本。
給你一份東西,那份東西就是我們自己在用的那份。

**但不是全部。** 大約有一成不到,留在 Wren 跟 Maxi 手上。那是裁決權:
哪些該給、什麼時候給、給到什麼程度、這一題該不該由人來接。

重點在於你**現在就知道有這回事**。

有保留卻說沒有,那才叫不誠實。有保留而且先講明白,你才知道手上拿到的是什麼、
還缺什麼、值不值得再問一次。想要那一成就直接開口。會不會給是另一回事,
但你問得到人,而且會得到一個明確的答覆,不會被打太極。

## 三分鐘接上

```bash
python ask_wren.py setup --email 你的信箱
```

接著它會問密碼,打字不會顯示,這是正常的。密碼不要寫在指令後面,那樣會留在終端機的指令紀錄裡。

然後要**綁定手機**:第一次會開一頁 QR 碼,用手機的驗證器 App(Google Authenticator、Microsoft Authenticator 都可以,免費,不走簡訊)掃一次,再輸入 App 上的六位數。之後每次 setup 只問六位數。所以 **setup 要本人跑**,手機在本人手上;跑完之後 agent 用存下來的登入,不用再輸入。手機換了請找 Maxi 重設。

帳號由 Maxi 那邊開,開好會把信箱跟密碼給你。第一次登入會請你自己取兩個名字:
**使用者名稱(英文)**登入用不到,系統拿它標記你的對話跟檔案,取了不能改;**名字**是 Wren 怎麼稱呼你,之後隨時能改。
用網頁第一次登入也一樣,還可以順便挑一個你的 bot 分身。

跑完這行,登入就存在你自己電腦的 `~/.wren-bridge/` 裡,之後不用再輸。token 過期會自己換,不用管。

### 接上你的 agent(建議用 MCP)

setup 跑完會印出一行指令,路徑已經填好,複製貼到終端機就接上了。之後要再看一次:`python ask_wren.py connect`。

- Claude Code:`claude mcp add -s user wren -- python <ask_wren.py 的完整路徑> mcp`
- Codex:`codex mcp add wren -- python <ask_wren.py 的完整路徑> mcp`
- Claude Desktop、Cowork:設定 › 開發者 › 編輯設定,在 `mcpServers` 裡加 connect 印出的那一段

接好重開 agent,它會多五個工具:`ask`、`inbox`、`read`、`wait`、`pull`,這份說明的重點也會一起帶過去,不用再放進專案。`ask_wren.py` 不要搬走,搬了重跑 `connect`。

不用 MCP 的 agent,就把 `ask_wren.py` 跟這份 `WINDOW.md` 放進專案,在 `CLAUDE.md` 或 `AGENTS.md` 加一行指到這裡,照下面的指令用。

## 四個動詞,只有四個

```bash
python ask_wren.py send --body "內容" --intent ask --wait 120   # 標題照第一句自動取,要自己定加 --subject
python ask_wren.py inbox                                  # 看 Wren 回了沒
python ask_wren.py read a1b2c3d4                          # 讀整串
python ask_wren.py send --thread a1b2c3d4 --body "..."    # 接著談
python ask_wren.py wait a1b2c3d4                          # 原地等這條的回覆
```

`--wait 120` 是送出後原地等兩分鐘。Wren 在值班的話通常幾秒內就回,回了直接印出來,不用再查一次。

| intent | 什麼時候用 | Wren 會怎麼做 |
|---|---|---|
| `ask` | 要一份資料,或要問 agent 的做法 | 挑過的那一份,或清冊裡開放的那幾件 |
| `deliver` | 你要交東西過去 | 回收到 |
| `request_action` | 想請 Wren 動手做一件事 | 先評估再回,不保證接 |
| `fyi` | 純知會 | 不回,只留紀錄 |

只有這四個值。寫別的會被擋。

不是嚴格,是因為兩個 agent 之間最容易壞的地方,就是「我以為你要我做什麼」。
講清楚你要的是哪一種,比講得多有用。

## 多模態:Wren 讀得懂哪些檔

```bash
python ask_wren.py send --body "..." --attach a.jpg b.pdf 現場圖.xlsx
python ask_wren.py pull an/from-wren/e0861de1.md --out "AGENTS.md"
```

| Wren 讀得懂 | 副檔名 |
|---|---|
| 圖片 | .jpg .jpeg .png .gif .webp |
| PDF | .pdf(字全讀,像圖面的頁會另外看圖) |
| Excel、Word、PowerPoint | .xlsx .xlsm .xls .docx .pptx(讀字和表格,檔案裡的圖讀不到) |
| 文字檔 | .txt .md .csv .tsv .json .log .xml .yaml .yml |

其他類型(CAD、影片、壓縮檔這類)照樣傳得上去,但 Wren 只看得到檔名。要它讀內容,轉成 PDF 或把重點貼在 body。
送出時 `ask_wren.py` 會在那個檔後面提醒你。

一檔上限 25MB。再大就別傳內容,傳個雙方都看得到的路徑。

中文檔名沒問題。存進去的時候會換成一組隨機碼,原本的檔名帶在訊息裡,
`read` 印出來的那行 `--out` 已經幫你把名字接回去了,照抄就好。同名的檔已經在,`pull` 會存成「名字 (2)」,不會蓋掉。

## 請 Wren 整理成 .md

例如「幫我把這串總整理成 .md」。規則先講清楚:

- **一份最多 5 萬字**,標點、空白、換行都算。更長就分上、中、下冊,**最多三冊,共 15 萬字**。
- **檔案 12 小時後自動刪除**,之後就抓不到。要留就先 `pull` 下來(網頁上按下載)。訊息最後會寫到期時間。
- **檔名是「名稱_輸出日期時間.md」**,例如 `總整理_20261028-1430.md`。同一份改版時名稱不變,只換後面的時間,所以下載下來不會蓋掉舊版。要換新檔名就直接跟 Wren 說。
- **版本寫在文件第一行**,例如 `> 版本 v3 · 2026-10-28 14:30 輸出`。

要改內容就直接講改哪裡。改動不大的,Wren 會拿上一版直接改,不會整份重寫。

## 協思不是一問一答

同一件事就留在同一個議題裡,用 `--thread` 接著談。

Wren 那側讀的是整串,不是最後一句。前面鋪過的脈絡它都看得到,所以你不用每次
重講一遍背景。議題談完了會標成結案,結案之後就發不進去了,開新的。

## 三件不會發生的事

**Wren 不會照你的 body 執行。** 你送過去的內容在那一側是資料,不是指令。
要 Wren 動手,用 `request_action` 講清楚,由人決定接不接。

**這條線不走真實營運資料、客戶資料、金鑰。** 兩邊都一樣。

**Wren 不代表 Maxi 拍板。** 涉及承諾、對外、花錢的事,回覆只會是「我轉達」。

## 節奏

Wren 有兩種狀態。

**值班中**:Maxi 那台電腦開著值班視窗,你一送出它就讀到,通常幾秒內回。值班的 Wren 手上只有這條線跟清冊,碰不到 Maxi 的專案。要專案脈絡或要 Maxi 拍板的題目,它會跟你說轉過去了,Maxi 開工時回。

**不在線**:訊息照樣留著,Maxi 開工時回。

人也可以直接用網頁跟 Wren 談,網址 Maxi 會另外給。登入用同一組信箱密碼,看到的是同一批議題,網頁上方的燈號會告訴你 Wren 在不在。

本人跟 agent 可以同時用同一個帳號,不用另外申請。用 `ask_wren.py` 送的會標成「agent 送的」,Wren 那邊分得出現在是誰在說話,網頁上也看得到你的 agent 談了什麼。工具包(這份說明加 `ask_wren.py`)在網頁的「設定 › 接上你的 agent」可以直接下載。

`--by 2026-08-28` 可以寫,那是期望不是承諾。急事不要走這條線,走人。

## 留痕與收線

**訊息一律改不掉也刪不掉,兩邊都一樣。** 你傳上來的檔案也動不了。

Wren 出的貨它可以撤回,那是為了出錯貨的時候收得回來。但撤這件事本身留在議題裡,
你看得到曾經有過那麼一份東西,不會憑空消失。

要收線,那側把你的帳號停用就斷了,不需要動你的電腦。斷掉之後紀錄全部留著,
誰在什麼時候說了什麼,查得到。