AstrBot 專屬陪伴外掛 – 「我會永遠陪著你」

簡介 – 這是一個為開源聊天機器人框架 AstrBot 設計的插件，添加了一個長期的、由個性驅動的「陪伴」層。該插件保持持續的生活方式上下文（狀態、日程、關係、夢想、健康等），並利用該上下文在私聊、群聊或透過可選的獨立 Web UI 生成反應式回覆和主動訊息（問候、提醒、圖片發布、語音訊息等）。

---

核心理念

AstrBot 已經提供了一個基礎的「人格」來回答傳入的訊息。這個插件不替換該人格；它透過一個角色的活生生模擬來增強它，該角色：

• 維護每日狀態、日程、位置、天氣、健康、飢餓感和可選的週期性情緒。
• 追蹤與主要使用者（「主陪伴」）和次要使用者的關係，儲存親密度等級、互動階段和最近的話題。
• 基於模擬的生活事件、時間窗口、代幣限制和權限檢查生成主動行為（文字、圖片、語音、戳一戳、螢幕截圖等）。
• 記錄每個決定（訊息發送或被阻止的原因、代幣使用情況、審計追蹤）以便除錯和透明化。
• 可以透過可選模組擴展，用於圖像生成、內容創作、ComfyUI、現實世界裝置互動等。

---

主要功能

領域	插件功能
生活連續性	每日狀態（能量、情緒、睡眠、健康、飢餓感）、詳細日程、位置、天氣、農曆、可選的週期性模擬。
私聊陪伴	個人化問候、未完成話題的記憶、輕量級使用者檔案、速率限制的主動聯繫、可配置的使用者語氣。
主動行為	發送文字、圖片、語音、戳一戳、螢幕截圖、外部工具呼叫、分段訊息、引用觸發器。
群聊理解	觀察允許的群組，建構群組氛圍，追蹤成員、俚語、話題線程、短期記憶、關係圖，並在適當時插入評論。
多模態	處理私聊圖片、GIF 幀提取、圖片引用、合併轉發、生成圖片（透過關聯的圖片插件）、TTS、撤回訊息的短期回憶。
內容生活	新聞、AI 日報、主動網路搜尋、B 站高光、夢境日誌、日記條目、筆記；如果適配器存在，可以與 QQ 空間同步。
成長與記憶	技能進度、個人非創造性目標、自我時間線、關係觀察、記憶助手整合。
管理與診斷	視覺化「陪伴面板」、模型路由、代幣和餘額概覽、設定遷移、主動行為審計、內建 FAQ。

---

可選擴展（單獨安裝）

• astrbot_plugin_image_companion – 圖像生成（文生圖）及相關命令。
• astrbot_plugin_content_companion – 創意寫作、故事/專輯管理。
• astrbot_plugin_comfyui – 用於圖像生成的本地 ComfyUI 工作流。
• astrbot_plugin_reality_companion – 攝影機/音訊裝置互動（現實世界的「我會陪著你」）。
• 額外的「記憶」、「一起」、「螢幕」、「直播」陪伴，每個都添加一組專注的能力。

---

安裝

方法	步驟
插件市場 (AstrBot WebUI)	搜尋 astrbot_plugin_private_companion，安裝，重啟 AstrBot。
Git 安裝	在 AstrBot 的插件管理器中，選擇從 Git 安裝並輸入 https://github.com/menglimi/astrbot_plugin_private_companion。
ZIP 上傳	使用 python scripts/build_plugin_package.py 構建包（產生 dist/astrbot_plugin_private_companion‑vX.Y.Z.zip）並透過 WebUI 上傳。
手動複製	將倉庫複製到 <AstrBot data>/plugins/astrbot_plugin_private_companion。
獨立 WebUI (可選)	在設定中啟用 enable_standalone_webui，設定存取權杖，然後存取 http://127.0.0.1:6190/。

---

快速開始檢查清單（約 10 分鐘）

1. 開啟陪伴面板 → 確認插件無錯誤載入。
2. 設定世界知識 – 指向主要的 AstrBot 人格並添加任何額外的角色或世界描述。
3. 模型頁面 – 為低延遲任務選擇一個快速模型，為日程/關係推理選擇一個複雜模型，以及（如果你有圖像插件）一個視覺模型。
4. 填寫基本設定 – 機器人名稱、時區、免打擾時間和主要使用者 ID。
5. 在私聊分頁中，將主要使用者標記為主使用者。
6. 在私聊中發送 陪伴 状态；你應該看到機器人的目前狀態、日程和下一個主動候選項。
7. (可選) 啟用群聊觀察，白名單一個群組，並用 陪伴群 状态 測試。
8. 根據需要逐步開啟額外能力（圖像、語音、螢幕截圖、新聞等）。

---

運作原理（高層流程）

• 被動回覆 – 當訊息到達時，插件建構一個分層上下文（人格 → 時間 → 關係 → 內容 → 發送前檢查），並在將其交給 LLM 供應商之前添加自己的提示詞。
• 主動候選項 – 生活事件、日程項目、提醒、天氣變化、新聞等產生候選行為。每個候選項通過：
  1. 時間窗口和價值評分
  2. 使用者/關係/免打擾檢查
  3. 人格層級決策
  4. 文字生成 / 外部工具執行
  5. 最終審計（重複偵測、隱私保護、代幣預算）
  6. 發送 → 日誌 → 更新記憶
• 狀態與日程 – 儲存在 JSON（預設）或 SQLite（可選）中。插件在每次互動後更新狀態，並可以透過面板匯出/匯入。
• 關係引擎 – 八個親密度階段 + 主要使用者的「專屬紐帶」；七個互動強度等級；自動衰減、上限和可配置的「道歉」修復邏輯。
• 多人格模式 (預設關閉) – 每個人格都有自己的獨立狀態、日程、日記和代幣核算。

---

設定亮點

• 代幣限制 – 硬限制停止所有新的 LLM 任務；軟限制節流低優先序背景任務（新聞、圖像生成等）。
• 模型路由 – 快速/複雜/創意/視覺模型可以按任務分配；如果模型缺失，則回退到 AstrBot 預設值。
• 圖像生成 – 每日穿搭、使用者請求生成、編輯或自動「生活事件」圖片；支援多個後端（線上 API、ComfyUI、SDGen）並自動回退。
• TTS – 文字轉語音可以與回覆一起發送或作為單獨的語音訊息發送；支援 Fish-Audio 模型和可選的 MiMo 語音複製整合。
• 隱私與安全 – 插件從不儲存或轉發成人內容；基於關係的權限防止隱私或裝置存取的升級。

---

獲取幫助

• Wiki – https://vue.syuan.org (安裝、設定、FAQ)
• Issues – 倉庫的 GitHub Issues 頁面
• QQ 群 – 1097283005
• 贊助 – 透過提供的愛發電連結進行可選支援（無功能影響）。

---

總結

astrbot_plugin_private_companion 是一個功能齊全、可擴展的 AstrBot 陪伴層，賦予聊天機器人持久的「生活」、關係記憶和主動行為，同時保持所有可審計和可配置。透過 AstrBot 的插件市場安裝，設定主使用者和模型，機器人將開始問候你、記住過去的談話、發布每日狀態更新，並（如果你啟用額外模組）生成圖像、語音訊息，甚至與現實世界裝置互動。所有行為都由 JSON/SQLite 狀態檔案驅動，並可以透過內建的 Web 面板進行檢查或調整。