🚀 v1.4 — Discord Bot · Browser Sense · MVU Variables · Desktop Shortcut

[beilusaiying]

Your AI companion now lives on Discord, sees your browser, understands game variables, and launches from your desktop.
你的 AI 伴侣登陆 Discord，感知浏览器页面，理解游戏变量，桌面一键启动。

---

🤖 Discord Bot (NEW — Major Feature)

Deploy your AI companion to Discord — chat with it anytime, anywhere.

将你的 AI 伴侣部署到 Discord 频道，随时随地通过 Discord 对话。

• Full memory access: Bot shares your local memory system — AI remembers everything on Discord too
• Visual config panel: Bot Token, Owner, message depth — form-based settings, no JSON editing
• Real-time message log: live view of user messages / AI replies / error logs
• Multi-channel support: Bot works across multiple Discord channels simultaneously
• One-click context clear: reset Bot's channel chat memory at any time
• beilu-chat integration: Bot panel embedded in chat interface, synced with standalone page

🌐 Browser Page Sense (NEW)

AI can now perceive what you're browsing — passive monitoring + on-demand snapshots.

AI 现在能感知你正在浏览的网页——被动监听 + 按需快照。

• Tampermonkey userscript: MutationObserver watches DOM changes, throttled reporting
• Structured snapshots: title / URL / main text / links / forms / meta — not raw HTML
• Passive + on-demand architecture: background monitoring with explicit request capability
• Zero browser extension: works through userscript injection, no extension installation needed

🎮 SillyTavern Script Compatibility (NEW)

Full MVU variable system + EJS template rendering — game cards with variables now work.

完整的 MVU 变量系统 + EJS 模板渲染——带变量的游戏卡现在能正常运行。

Character card with status bar:
  → beilu-mvu: tracks variables (HP, relationship, inventory...)
  → beilu-ejs: renders EJS templates (<%...%>) in prompts
  → Frontend: status bar iframe with live variable injection
  → AI: reads/updates variables via _.set() / JSONPatch / UpdateVariable

• beilu-mvu plugin: GetPrompt variable accumulation + TweakPrompt YAML injection + ReplyHandler command parsing
• beilu-ejs plugin: TweakPrompt EJS template rendering across entire prompt structure
• Script sandbox: iframe-based ST script runner with full event system
• Variable manager UI: floor-based display, track latest, range filter, independent view modes
• Plugin manager: MVU/EJS toggle switches in dedicated management tab

🖥️ Desktop Shortcut & Icon (NEW)

Portable launcher now creates a desktop shortcut with the beilu icon on first install.

便携启动器首次安装后自动在桌面创建带 beilu 图标的快捷方式。

• Auto icon generation: build process converts icon.jpg → multi-size icon.ico (256/128/64/48/32/16px)
• Embedded exe icon: compiled exe displays the beilu infinity symbol icon in File Explorer
• Desktop shortcut: WScript.Shell creates .lnk on first launch, with .shortcut_created marker to prevent duplicates
• One-click launch: click the desktop icon to start — no more navigating to folders

---

English

What's New

🤖 Discord Bot

• Complete Bot deployment with visual configuration panel
• Real-time message log (user/AI/error) with full content expansion
• Multi-channel support + one-click context clear
• <content> tag stripping in AI replies sent to Discord
• beilu-chat embedded Bot panel synced with standalone page

🌐 Browser Page Sense

• Tampermonkey userscript with MutationObserver DOM monitoring
• Structured page snapshots (title/URL/text/links/forms/meta)
• Passive + on-demand dual-mode architecture
• ReplyHandler reads snapshots from shared injection state

🎮 SillyTavern Script Compatibility (MVU + EJS + ST Runtime)

• beilu-mvu: variable accumulation from chatLog + world book InitVar YAML + ReplyHandler parsing (_.set/JSONPatch/UpdateVariable)
• beilu-ejs: EJS template rendering with full context (getvar/setvar/incvar/decvar/variables)
• ST script runtime: iframe sandbox + event system + SillyTavern global compatibility
• Variable manager: floor-based display + track latest + range filter + search
• Plugin manager: MVU/EJS toggle switches + status indicators
• Mixed content rendering: markdown + embedded HTML document split rendering
• Status bar auto-injection: latest char message auto-appends StatusPlaceHolder
• jQuery CDN injection: Layer 1 jQuery 3.7.1 for card compatibility

🖥️ Desktop Shortcut & Icon

• Build process: Python+Pillow converts icon.jpg → multi-size icon.ico
• ps12exe compilation with -iconFile embeds icon into exe
• First-launch desktop shortcut creation via WScript.Shell COM
• .shortcut_created marker prevents duplicate shortcuts

🔍 Smart Search System (BM25 + Regex Dual Engine)

• BM25 semantic search: TF-IDF based relevance ranking, pure JS, zero dependencies
• Regex precise search: pattern matching after BM25 pre-filtering
• P1 retrieval enhanced: search rounds optimized from 5 → max 3 (speed +40%, cost -40%)
• IDE integration: file search with BM25 + regex in the editor

🌍 beilu-chat Internationalization

• ~100 HTML elements with data-i18n translation markers
• 4 languages: zh-CN / en-UK / ja-JP / zh-TW
• Namespace chat.beiluChat.* to avoid key conflicts
• Coverage: top bar, side panels, settings, buttons, placeholders, dialogs, Bot panel

📊 Table Editor Enhancement

• Column editing: click header to rename, add/remove columns with data sync
• Rule editing: insert/update/delete rules inline editable
• Enable/disable toggle: per-table injection control, required tables (🚀 v1.4 — Discord Bot · Browser Sense · MVU Variables · Desktop Shortcut #4, #6) locked
• JSON view panel: inspect raw table data + copy to clipboard
• Dirty state management: unsaved changes warning + beforeunload confirmation
• Full save: name + columns + rules + enabled + rows sent as complete payload

🌍 World Book Enhancement

• Sorted group display: 📌 Before Character / 📎 After Character / 📍 @Depth
• 3 activation modes: Constant (always) / Regex (keyword match) / Dynamic (table data check)
• Dynamic prompt activation: check memory table column values (range/exact match)
• Data migration: auto-convert old constant: true → activationMode: 'constant'

🔬 Full-Stack Diagnostics

• Frontend + backend console interception (500-entry ring buffer)
• One-click log export: beiluDiag.pack() → JSON file with all context
• window.onerror + unhandledrejection auto-capture
• Backend ANSI color code filtering
• 8 diagnostic API endpoints + debug panel UI

🏗️ Architecture Optimization

• chat Shell simplified to bridge skeleton (6 files removed, only import + re-export)
• Global server logger middleware (console intercept → global_server.log)
• Persona avatar cache write-through on create/update

🐛 Bug Fixes

• Fixed regex import PLACEMENT_NUM_TO_STR mapping completely wrong since v1.0
• Fixed P1 thinking chain leaking into Chat AI injection content
• Fixed editMessage charname crash (null protection + optional chaining + 3-level fallback)
• Fixed fakeSend triggering P1 retrieval (isFakeSend parameter propagation)
• Fixed memory tag display: ReplyHandler now uses content_for_show separation
• Fixed persona description not showing (info path details.info.description)
• Fixed persona avatar not displaying (parts_details_cache write-through)
• Fixed beilu-files readFileContent path parameter error
• Fixed chat refresh blank page (3 async race conditions + onElementRemoved false trigger)
• Fixed duplicate chat creation on character card entry
• Fixed character card deletion leaving orphan folders (3-layer cleanup strategy)

---

中文

更新内容

🤖 Discord Bot（核心新功能）

• 完整的 Bot 部署，可视化配置面板（Bot Token / Owner / 消息深度）
• 实时消息日志（用户消息 / AI 回复 / 错误日志），支持完整内容展开
• 多频道支持 + 一键清除上下文
• AI 回复中 <content> 标签自动剥离
• beilu-chat 内嵌 Bot 面板，与独立页面功能对齐

🌐 浏览器页面感知（核心新功能）

• 油猴脚本 MutationObserver 监听 DOM 变化，节流上报
• 结构化页面快照（标题 / URL / 正文 / 链接 / 表单 / 元信息）
• 被动式 + 按需式双模架构
• ReplyHandler 从共享注入状态按需读取快照

🎮 酒馆助手脚本兼容（MVU + EJS + ST 运行时）

• beilu-mvu 插件：chatLog 变量累积 + 世界书 InitVar YAML 初始化 + ReplyHandler 命令解析（_.set / JSONPatch / UpdateVariable）
• beilu-ejs 插件：EJS 模板渲染，遍历整个 prompt 结构
• ST 脚本运行时：iframe 沙箱 + 事件系统 + SillyTavern 全局兼容
• 变量管理器：楼层分区显示 + 追踪最新 + 范围筛选 + 搜索
• 插件管理器：MVU / EJS 开关 + 状态指示
• 混合内容渲染：markdown + 嵌入 HTML 文档分段渲染
• 状态栏自动注入：最新角色消息自动追加 StatusPlaceHolder
• jQuery CDN 注入：Layer 1 jQuery 3.7.1 兼容角色卡

🖥️ 桌面快捷方式与图标（新功能）

• 构建流程：Python+Pillow 将 icon.jpg 转换为多尺寸 icon.ico
• ps12exe 编译时通过 -iconFile 嵌入图标到 exe
• 首次启动自动创建桌面快捷方式（WScript.Shell COM）
• .shortcut_created 标记文件防止重复创建

🔍 智能检索系统（BM25 + 正则搜索双引擎）

• BM25 语义检索：基于 TF-IDF 的相关性排序，纯 JS 实现，零依赖
• 正则精确搜索：BM25 预筛选后正则精确匹配
• P1 检索增强：检索轮次从 5 次优化至最多 3 次（速度 +40%、成本 -40%）
• IDE 集成：文件编辑器内 BM25 + 正则搜索

🌍 beilu-chat 国际化

• 约 100 处 HTML 元素添加 data-i18n 翻译标记
• 4 种语言：简体中文 / English / 日本語 / 繁體中文
• 命名空间 chat.beiluChat.*，避免与 beilu-home 的 key 冲突
• 覆盖：顶部栏、侧面板、设置、按钮、对话框、Bot 面板

📊 表格编辑器增强

• 列编辑：点击列头可修改列名，增删列数据自动同步
• 规则编辑：insert / update / delete 三个规则可点击编辑
• 启用/禁用开关：每张表格独立控制是否注入 AI，必需表格（🚀 v1.4 — Discord Bot · Browser Sense · MVU Variables · Desktop Shortcut #4、#6）不可禁用
• JSON 查看面板：查看原始表格数据 + 复制到剪贴板
• Dirty 状态管理：未保存修改提示 + 离开前确认
• 完整保存：name + columns + rules + enabled + rows 完整数据

🌍 世界书功能优化

• 排序分组显示：📌 角色之前 / 📎 角色之后 / 📍 @深度
• 3 种激活模式并存：常驻（绿色）/ 正则（蓝色）/ 动态（紫色）
• 动态提示词激活：检测记忆表格数据（范围检测 / 精确匹配）
• 数据迁移：旧 constant: true 自动迁移为 activationMode: 'constant'

🔬 全系统诊断框架

• 前端 + 后端 console 拦截（500 条环形缓冲区）
• 一键打包导出：beiluDiag.pack() → JSON 文件
• window.onerror + unhandledrejection 自动捕获
• 后端 ANSI 颜色码过滤
• 8 个诊断 API 端点 + 调试面板 UI

🏗️ 架构优化

• chat Shell 精简为桥接骨架（删除 6 个旧文件，仅保留 import + re-export）
• 全局服务器日志中间件（console 截获 → global_server.log）
• 人设头像缓存穿透写入（创建/更新后立即写入 parts_details_cache）

🐛 Bug 修复

• 修复正则导入 PLACEMENT_NUM_TO_STR 映射从 v1.0 起就完全错误的问题
• 修复 P1 思维链泄漏到聊天 AI 注入内容
• 修复编辑消息时 charname 崩溃（null 保护 + 可选链 + 三级回退）
• 修复伪发送（提示词查看器）触发 P1 检索（isFakeSend 参数传递）
• 修复编辑消息时显示记忆标签（ReplyHandler 改用 content_for_show 分离）
• 修复人设描述不显示（info 路径 details.info.description）
• 修复人设头像不显示（parts_details_cache 穿透写入）
• 修复 beilu-files readFileContent 路径参数错误
• 修复对话后刷新聊天区空白（3 处异步竞态 + onElementRemoved 误触发）
• 修复进入角色卡自动创建新对话（先查已有聊天）
• 修复角色卡删除后文件夹残留（三层聊天数据清理策略）

---

⬆️ Upgrade from v1.3 | 从 v1.3 升级

Portable launcher (exe) users | 便携启动器用户：

• Re-download the latest exe — now with embedded icon + auto desktop shortcut
• 重新下载最新版 exe——自带图标 + 自动创建桌面快捷方式

Manual installation users | 手动安装用户：

cd <install-directory>
git pull origin main
# Windows
.\run.bat
# Linux/macOS
./run.sh

---

💬 Community | 社区

---

This project was independently designed and developed by a university student, leveraging AI-assisted programming.
本项目由一名在校大学生独立完成全部设计与开发，借助 AI 辅助编程。

---

This discussion was created from the release 🚀 v1.4 — Discord Bot · Browser Sense · MVU Variables · Desktop Shortcut.