工程與Token效率設(shè)計(jì))
什么是AXI深入lavish-axi的Agent人機(jī)工程與Token效率設(shè)計(jì)【免費(fèi)下載鏈接】lavish-axiHTML is the new markdown. Lavish is the new editor for your HTML artifacts.項(xiàng)目地址: https://gitcode.com/gh_mirrors/la/lavish-axilavish-axi 是一款面向 AI 智能體Agent的AXI 工具它讓 Agent 把 HTML 產(chǎn)物打開(kāi)到本地瀏覽器中人可以直接圈選元素、批注文字、編輯圖表并把反饋通過(guò)一條長(zhǎng)輪詢long polling接口精準(zhǔn)送回給 Agent。它的核心設(shè)計(jì)只回答兩個(gè)問(wèn)題如何讓 Agent 用最少的心力操作它人機(jī)工程以及如何讓 Agent 花最少的 Token 用它Token 效率。什么是 AXI一條Agent 直接能跑的 CLIAXI可以理解為 Agent eXperiences 的接口約定一個(gè)足夠強(qiáng)的 Agent無(wú)需任何安裝和配置僅憑一條命令行就能把它跑起來(lái)并讀懂輸出。lavish-axi 完全符合這一定義零安裝可用npx -y lavish-axi html-file即可運(yùn)行CLI 按需自取CLI 即接口它不附帶 MCP Server也不依賴市場(chǎng)安裝CLI 本身就是 Agent 界面見(jiàn) AGENTS.md 中的 AXI integration 章節(jié)按需披露contextual disclosure技能文件只是一個(gè)極短的路標(biāo)真正的操作指南由lavish-axi design、lavish-axi playbook id等命令在需要時(shí)才給出。技能樁文件 skills/lavish/SKILL.md 只有幾十字節(jié)級(jí)的篇幅明確寫著當(dāng)前指引在 CLI 里別信舊拷貝——這是理解 lavish-axi Token 哲學(xué)的第一把鑰匙。Agent 人機(jī)工程三條Agent 友好設(shè)計(jì)1. 文件路徑即會(huì)話身份拒絕不透明 ID傳統(tǒng)方案里Agent 往往要記住一串session_id。lavish-axi 直接以規(guī)范化的 HTML 文件路徑作為會(huì)話鍵sha256前綴保存在~/.lavish-axi/state.json中。對(duì) Agent 來(lái)說(shuō)打開(kāi)哪個(gè)文件就等于哪個(gè)會(huì)話沒(méi)有任何需要記憶或轉(zhuǎn)述的不透明標(biāo)識(shí)。實(shí)現(xiàn)位于 src/session-store.js 的sessionKey。2. 長(zhǎng)輪詢等待而不是反復(fù)查詢Agent 打開(kāi)頁(yè)面后執(zhí)行l(wèi)avish-axi poll file.html然后掛起等待直到用戶點(diǎn)了Send to Agent才返回反饋。對(duì)比每 5 秒查一次有沒(méi)有新消息的輪詢方案維度反復(fù)短輪詢lavish-axi 長(zhǎng)輪詢無(wú)反饋時(shí)的請(qǐng)求次數(shù)N 次0 次Token 消耗每次響應(yīng)都計(jì)費(fèi)等待期零消耗響應(yīng)延遲最多一個(gè)輪詢周期用戶點(diǎn)發(fā)送即刻送達(dá)等待期間它還有一套防誤判設(shè)計(jì)無(wú)超時(shí)的 poll 會(huì)向 stderr 打印一次性橫幅證明沒(méi)掛死而 stdout永遠(yuǎn)只留給最終結(jié)果只有交互終端才會(huì)輸出周期性等待心跳管道環(huán)境Agent 框架則完全安靜——避免把 tick 噪音混入 Agent 的抓取內(nèi)容見(jiàn) src/cli.js。3. 被動(dòng)檢測(cè)永不驚擾 Agent布局審計(jì)發(fā)現(xiàn)溢出、遮擋等問(wèn)題時(shí)只會(huì)放進(jìn)瀏覽器的Layout issues收件箱絕不觸發(fā)poll返回、不喚醒 Agent。只有人主動(dòng)Queue selected fixes問(wèn)題才作為一條普通反饋進(jìn)入隊(duì)列。這一檢測(cè)永遠(yuǎn)被動(dòng)的原則寫在 VISION.md 的Nothing interrupts the human一節(jié)是人機(jī)協(xié)作不被機(jī)器打斷的底線。Token 效率設(shè)計(jì)每個(gè) Token 都花在刀刃上VISION.md 開(kāi)宗明義Every token is spent on purpose每個(gè) Token 都花得有目的。具體落到了四處1. TOON 緊湊輸出CLI 輸出采用 TOON 這種比 JSON 更緊湊的結(jié)構(gòu)化格式同樣的信息量字符數(shù)更少解析更省。2.--version的熱路徑快速通道Agent 框架通常在會(huì)話啟動(dòng)時(shí)探測(cè)每個(gè)工具版本。lavish-axi --version在進(jìn)入任何初始化邏輯之前就短路返回版本號(hào)不做狀態(tài)目錄創(chuàng)建、不發(fā)遙測(cè)請(qǐng)求——一個(gè)看似不起眼的優(yōu)化省掉了每次會(huì)話啟動(dòng)約一秒的固定開(kāi)銷守衛(wèi)測(cè)試見(jiàn) test/cli-version.test.js。3. 單一事實(shí)源杜絕重復(fù)話術(shù)設(shè)計(jì)優(yōu)先級(jí)規(guī)則DESIGN_PRIORITY_RULE全文只在 src/design-reference.js 定義一次design命令幫助與運(yùn)行時(shí)輸出全部引用它從不復(fù)述。技能樁不復(fù)述 CLI 指引playbook 列表如diagram、table、comparison等 8 種見(jiàn) src/playbooks.js只在匹配時(shí)才讓 Agent 打開(kāi)對(duì)應(yīng)篇目。每個(gè)表面都要為自己的 Token 成本在每次運(yùn)行中掙回票價(jià)。4. 反饋?zhàn)侄雾樞蚣雌跫spoll返回的反饋對(duì)象中prompts用戶原話與next_step繼續(xù)評(píng)審循環(huán)的指令永遠(yuǎn)排在體積無(wú)上限的dom_snapshot之前——這樣即使 Agent 截?cái)嗷蜻^(guò)濾響應(yīng)也永遠(yuǎn)不會(huì)丟掉用戶的話和流程指令。測(cè)試 test/cli-output.test.js 專門鎖死了這個(gè)字段順序。人機(jī)工程讓人指一下就能被精確理解Token 省給 Agent體驗(yàn)就還給人類。Lavish Editor 的瀏覽器界面左側(cè)產(chǎn)物、右側(cè)對(duì)話面板把指出問(wèn)題的成本降到最低精確批注點(diǎn)選元素、劃選文字甚至表格單元格反饋都會(huì)附帶 CSS 定位、行列名與引文Agent 收到的是哪一行哪一列而不是大概上面那個(gè)白板編輯當(dāng)產(chǎn)物中包含 Mermaid 圖表且你要求可編輯白板時(shí)圖表會(huì)渲染成 Excalidraw 白板點(diǎn)一下解鎖編輯全屏后可以直接在上面畫改編輯結(jié)果以有邊界的修改摘要 本地場(chǎng)景/PNG 路徑排隊(duì)發(fā)給 Agent由 Agent 回寫到 Mermaid 源碼——源碼始終是權(quán)威導(dǎo)出文件與瀏覽器里看到的完全一致。圖表主題自適應(yīng)Mermaid 圖表按頁(yè)面實(shí)際背景自動(dòng)選擇深淺渲染切換主題無(wú)需重新生成會(huì)話存在感知面板實(shí)時(shí)顯示 Agent 是否在監(jiān)聽(tīng)Agent 沒(méi)在聽(tīng)時(shí)反饋會(huì)排隊(duì)保留不會(huì)丟失。移動(dòng)端860px則折疊為底部對(duì)話抽屜手機(jī)上也能完成一輪評(píng)審??焖偕鲜忠粭l命令安裝 Lavish 技能npx skills add kunchenguid/lavish-axi --skill lavish這就是全部的安裝步驟無(wú)需 npm install。之后直接對(duì) Agent 說(shuō)/lavish 幫我把我們的方案畫成一個(gè)頁(yè)面討論一下或者零安裝直接說(shuō)用npx -y lavish-axi把我們討論的內(nèi)容寫成一份技術(shù)方案。 完整命令與參數(shù)參考見(jiàn) README.md 的 CLI Reference 與 CONTRIBUTING.md源碼構(gòu)建方式則是git clone https://gitcode.com/gh_mirrors/la/lavish-axi cd lavish-axi pnpm install --frozen-lockfile pnpm run build總結(jié)小而準(zhǔn)的人機(jī)協(xié)作中間件lavish-axi 的定位克制得近乎苛刻——只服務(wù)一個(gè)人 一個(gè) Agent 一個(gè)本地 HTML 文件的評(píng)審循環(huán)見(jiàn) VISION.md 的 Scope 章節(jié)。但正是這種克制讓它把人機(jī)協(xié)作中最貴的兩樣?xùn)|西——人的注意力和Agent 的 Token——都?jí)旱搅俗畹虯gent 側(cè)文件路徑做身份、長(zhǎng)輪詢零空轉(zhuǎn)、TOON 緊湊輸出、指引按需披露人類側(cè)圈選即批注、圖表即白板、檢測(cè)被動(dòng)不吵、手機(jī)端完整可用。如果你正為Agent 輸出越來(lái)越像一份長(zhǎng)文卻越來(lái)越難被指點(diǎn)和修改所困擾那么 lavish-axi 給出的答案是讓頁(yè)面本身成為對(duì)話的載體讓每一次指一下都能被精確送達(dá)?!久赓M(fèi)下載鏈接】lavish-axiHTML is the new markdown. Lavish is the new editor for your HTML artifacts.項(xiàng)目地址: https://gitcode.com/gh_mirrors/la/lavish-axi創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考