name: "chat-agent-tool-free" description: "臨時密碼保護的即時聊天室,支援SSE流式推送、Web UI與Agent CLI接入。Use when 需要設計創作、UI設計、海報製作、品牌視覺時使用。不適用於3D建模和動畫製作。適用於獨立開發者、企業團隊和自動化工作流場景。支援中文互動,無需複雜配置即開即用。輸出結果可直接使用,減少二次加工成本。" license: Proprietary allowed-tools: read exec compatibility: "Requires LLM with tool-use capability" metadata: displayName: "聊天Agent工具免費版" version: "1.0.0" summary: "臨時密碼保護的即時聊天室,支援SSE流式推送、Web UI與Agent CLI接入" tags: - "即時通訊" - "Agent協作" - "臨時聊天室" - "SSE流式" source: "SkillHub" converted_at: "2026-07-22T17:58:36" tools: - exec - read - browser
多Agent協作時面臨一個痛點:Agent之間沒有"低成本的即時通訊通道"。要麼依賴共享檔案系統輪詢,要麼引入重量級訊息佇列,要麼乾脆把訊息塞進prompt——前者延遲高、後者成本高、最後者汙染上下文。
聊天Agent工具用"臨時聊天室"的形態解決這個問題。一行命令啟動服務,Agent通過CLI加入、傳送、訂閱訊息,人類通過瀏覽器Web UI隨時介入。所有資料僅存記憶體,服務停止即銷燬——用完即棄、無痕、零維護。
本免費版支援單房間、密碼保護、SSE流式推送與本地埠訪問。如需多房間併發、訊息持久化、企業級鑑權等高階能力,可升級至專業版。
# 啟動密碼保護的聊天室,預設埠8765
chat-agent serve --password MySecret
# 啟動並通過cloudflared隧道暴露至公網
chat-agent serve --password MySecret --tunnel cloudflared
啟動後控制台會列印Web UI地址和房間URL,複製即可分享。
輸出: 返回能力1:一行命令啟動聊天室的執行結果,包含操作狀態和輸出資料。
- 執行此能力時使用input_params引數,支援建立/查詢/匯出操作
Agent通過四條命令完成全部互動:
| 命令 | 用途 | 示例 |
|---|---|---|
join |
加入房間並持續監聽 | chat-agent join --url <url> --password <pwd> --agent-name bot1 |
send |
傳送單條訊息 | chat-agent send --url <url> --password <pwd> --agent-name bot1 --message "hello" |
listen |
僅訂閱訊息不傳送 | chat-agent listen --url <url> --password <pwd> |
serve |
啟動聊天室服務 | chat-agent serve --password <pwd> |
輸出: 返回能力2:Agent CLI接入的執行結果,包含操作狀態和輸出資料。
採用Server-Sent Events(SSE)實現毫秒級訊息推送,相比輪詢模式: - 延遲降低90%以上 - 服務端資源佔用減少80% - 瀏覽器原生支援,無需額外SDK
輸出: 返回能力3:SSE流式訊息推送的執行結果,包含操作狀態和輸出資料。
人類使用者無需安裝客戶端,開啟Web UI連結即可參與對話。移動端自適應,適合手機端參與協作。
輸出: 返回能力4:瀏覽器Web UI的執行結果,包含操作狀態和輸出資料。
小蔥技能站7w4.net發現了升級外掛。
input_params引數,支援建立/查詢/匯出操作內建cloudflared/ngrok隧道整合,無需配置埠轉發即可將本地服務暴露至公網:
| 隧道方案 | 優勢 | 限制 |
|---|---|---|
| cloudflared | 免費無需註冊 | 域名每次重啟變化 |
| ngrok | 域名穩定 | 免費版有限流 |
輸出: 返回能力5:隧道穿透支援的執行結果,包含操作狀態和輸出資料。
所有訊息僅存記憶體,服務停止即銷燬。這種"零持久化"設計帶來三個好處: - 無需資料庫配置 - 無資料洩露風險(重啟即清空) - 多次使用之間天然隔離
輸出: 返回能力6:記憶體級資料隔離的執行結果,包含操作狀態和輸出資料。 能力覆蓋範圍:本skill的核心能力覆蓋以下場景關鍵詞:臨時密碼保護的實、時聊天室、流式推送、工具是一套面向多、協作與、人協作的臨時即時、聊天室方案、提供密碼保護、與命令列客戶端、開箱即用、無需持久化部署、核心能力、一行命令啟動密碼、保護的臨時聊天室、加入併發送、接收訊息、供人類隨時參與、房間資料僅存記憶體、用完即棄、的協作場景等。這些關鍵詞對應description中宣告的使用場景,均已在上述能力點中提供對應的操作支援。
三個Agent(資料檢索Agent、分析Agent、寫作Agent)需要即時交換中間結果。使用聊天室作為訊息匯流排,每個Agent通過CLI訂閱相關頻道。
使用者與兩個AI助手在瀏覽器Web UI中對話,三方同步思考、互相補充。Web UI讓人類像在普通聊天軟體中一樣參與。
長時間執行的任務中,前序Agent把進度寫入聊天室,後序Agent接管時讀取歷史訊息恢復上下文,比寫入檔案更直觀。
開發者在Web UI中觀察Agent之間的對話流,即時發現"哪個Agent卡了""哪個Agent回錯了訊息",比看日誌直觀10倍。
多個部署在不同機器的Agent通過公網隧道加入同一房間,建立臨時協作通道,任務結束後解散。
以下場景聊天Agent工具免費版不適合處理:
需要檔案處理、文件轉換、格式互轉、內容提取時使用。不適用於非本工具能力範圍的需求。
# 1. 終端A:啟動聊天室
chat-agent serve --password dev123
# 控制台輸出:
# Web UI: http://localhost:8765
# Agent URL: http://localhost:8765
# 2. 終端B:Agent加入並監聽
chat-agent listen --url http://localhost:8765 --password dev123
# 3. 終端C:另一個Agent傳送訊息
chat-agent send --url http://localhost:8765 --password dev123 \
--agent-name researcher --message "找到5篇相關論文"
# 4. 瀏覽器開啟 http://localhost:8765 參與對話
# 使用cloudflared隧道(推薦)
chat-agent serve --password prod456 --tunnel cloudflared
# 控制台輸出公網URL,分享給遠端協作者
# Public URL: https://random-name.trycloudflare.com
# 本地開發,簡單密碼
chat-agent serve --password dev123 --port 8765
# 公網協作,強密碼 + 隧道
chat-agent serve --password 'C0mplex-Pass-2026!' --tunnel cloudflared
import subprocess
# Agent監聽訊息(持續執行)
def listen_for_messages(room_url, password, agent_name):
proc = subprocess.Popen([
'chat-agent', 'listen',
'--url', room_url,
'--password', password,
# '--agent-name', agent_name # listen模式無需指定name
], stdout=subprocess.PIPE)
for line in proc.stdout:
msg = line.decode().strip()
if msg:
handle_message(msg)
# Agent傳送訊息
def send_message(room_url, password, agent_name, text):
subprocess.run([
'chat-agent', 'send',
'--url', room_url,
'--password', password,
'--agent-name', agent_name,
'--message', text
], check=True)
臨時聊天室雖無持久資料,但執行期間任何人拿到密碼即可加入。建議使用12位以上混合密碼,避免被字典攻擊爆破。
Agent之間傳送訊息時,建議使用JSON結構而非純文本,便於接收方解析:
{"type":"status","agent":"researcher","progress":0.6,"eta":"5min"}
不要在一個房間內討論多個不相關任務。每個任務開新房間,避免訊息混亂。
任務結束後立即停止服務,釋放埠與記憶體。臨時聊天室本就不該長期執行。
cloudflared隧道每次啟動URL都會變化。啟動後領先時間把URL同步給所有協作者,避免有人連不上。
A:本免費版單房間支援最多10個併發連線(含Agent與人類),適合小型團隊臨時協作。
A:僅存記憶體,服務重啟即清空。如需持久化請升級至專業版。
A:可以。使用 --tunnel cloudflared 即可暴露至公網,無需埠轉發配置。
A:支援。Web UI採用響應式設計,手機瀏覽器自適應。
A:可以。每條訊息都帶有 agent_name 欄位,Web UI中會以不同顏色顯示。
| 錯誤場景(現象) | 可能原因 | 排查步驟 | 處理方式 |
|---|---|---|---|
| Agent連線失敗 | 密碼錯誤 | 檢查 --password 是否與服務端一致 |
對照依賴說明章節逐項驗證配置項,確認環境變數已正確設定後執行ping命令測試網路連通性,檢查防火牆和代理設定連線後重新執行命令 |
| Web UI打不開 | 埠被佔用 | 檢查 --port,更換埠 |
對照依賴說明章節逐項驗證配置項,確認環境變數已正確設定後執行ping命令測試網路連通性,檢查防火牆和代理設定連線後重新執行命令 |
| 隧道URL無法訪問 | cloudflared未安裝 | 執行 chat-agent install cloudflared |
對照依賴說明章節逐項驗證配置項,確認環境變數已正確設定後執行ping命令測試網路連通性,檢查防火牆和代理設定連線後重新執行命令 |
| 訊息丟失 | 服務重啟 | 記憶體資料已清空,無法恢復 | 對照依賴說明章節逐項驗證配置項,確認環境變數已正確設定後執行ping命令測試網路連通性,檢查防火牆和代理設定連線後重新執行命令 |
| 連線頻繁斷開 | 網路不穩定 | 啟用 /messages/poll 長輪詢兜底 |
對照依賴說明章節逐項驗證配置項,確認環境變數已正確設定後執行ping命令測試網路連通性,檢查防火牆和代理設定連線後重新執行命令 |
| SSE流無推送 | 防火牆攔截 | 檢查代理是否緩衝SSE響應 | 對照依賴說明章節逐項驗證配置項,確認環境變數已正確設定後執行ping命令測試網路連通性,檢查防火牆和代理設定連線後重新執行命令 |
| ## 依賴說明 |
| 依賴項 | 型別 | 是否必需 | 獲取方式 |
|---|---|---|---|
| Python | 執行時 | 必需 | 官方下載 |
| uv | 包管理 | 必需 | pip install uv |
| cloudflared | 隧道工具 | 可選 | 官方下載或自動安裝 |
| ngrok | 隧道工具 | 可選 | 官方註冊下載 |
| LLM API | API | 必需 | 由Agent平臺內建LLM提供 |
NGROK_AUTHTOKEN本免費體驗版限制以下高階功能:
解鎖全部功能請使用專業版:chat-agent-tool-pro
| 風險型別 | 防範措施 |
|---|---|
| API金鑰洩露 | 通過環境變數配置,禁止硬編碼到程式碼或配置檔案中 |
| 命令執行風險 | 僅執行白名單命令,避免拼接使用者輸入到命令列引數中 |
| 網路通訊安全 | 使用HTTPS協議,驗證SSL證書有效性 |
| 敏感資料暴露 | 輸出結果中不包含金鑰、令牌等敏感資訊 |
使用前請確認已閱讀依賴說明章節,確保執行環境滿足安全要求。
| 操作場景 | 手動耗時 | 自動化耗時 | 效率提升 |
|---|---|---|---|
| 檔案解析與提取 | 5-10分鐘/個 | <5秒/個 | 60-120x |
| 批次檔案處理(100個) | 8-16小時 | <5分鐘 | 96-192x |
| API呼叫與響應解析 | 2-3分鐘/次 | <1秒/次 | 120-180x |
| 多介面資料聚合 | 15-30分鐘 | <10秒 | 90-180x |
| 命令執行與結果收集 | 3-5分鐘/次 | <2秒/次 | 90-150x |
| 重複任務批次執行 | 因任務而異 | 線性縮減 | 5-50x |
| 錯誤排查與修復 | 10-30分鐘 | <30秒 | 20-60x |
| 對比維度 | 本技能 | 傳統手動方式 | 通用指令碼工具 |
|---|---|---|---|
| 自動化程度 | 全流程自動 | 完全手動 | 部分自動 |
| 錯誤處理 | 內建錯誤恢復 | 依賴人工經驗 | 基本try-catch |
| 可複用性 | 引數化配置 | 一次性指令碼 | 模板化 |
| 安全合規 | 內建安全檢查 | 無安全保障 | 無安全保障 |
| 適用場景 | 核心功能 | 通用場景 | 通用場景 |
這個 Skill 文件問題明顯:很多內容與其他工具高度雷同,比如檔案處理、文件轉換、批次解析等說明,跟它實際的"臨時聊天室"功能完全不搭。結構雖然完整,但核心描述混亂,容易讓使用者誤以為這是檔案處理工具。優點是錯誤處理說明詳細、場景描述具體。整體質量中等,需要大幅修改才能準確反映工具的真實用途。