momolulu

给 DeepSeek Harness（DSH）的一点温柔陪伴：照片背景、专注计时、休息提醒、天气，以及跨会话的「会话雷达」。

中文 | English

功能

• 照片陪伴：右下角照片卡片，轻微浮动与缓慢呼吸动效；可收成带进度环和倒计时的小头像。
• 专注计时：15 / 25 / 45 / 60 分钟可选，暂停、继续、重置；开始专注时请求全屏，按 Esc 只退出全屏、不打断计时。
• 休息提醒：默认每 20 分钟提示喝水 / 站立，到点轻晃并高亮提醒行，可「收到」或「10 分钟后提醒」；提供 8 秒测试预览。
• 会话雷达：列出运行中、刚结束待查看、等待输入、请求权限的普通会话，点击整行直接跳转；不会自动切换、不会代答或授予权限。
• 天气：默认南京，经 Open-Meteo 查询；只有你主动点击「使用当前位置」时才请求定位。
• 阅读保护：默认减弱聊天区域的背景干扰，右侧保留景色；背景亮度与浓度可调。
• 中英文界面文案，支持系统「减少动态效果」。

安装

面向 DSH 0.2.2-rc.1，其他版本尚未验证。

在 DSH 的插件安装入口中，使用 GitHub Release 说明里提供的、固定到 commit 的 Git 安装地址。也可以克隆本仓库，把目录的绝对路径交给 DSH 插件管理器作为 bundle 安装。不需要另外启动 Web 服务。

已经在用旧本地包的用户：启用 momolulu 前，请先停用或卸载 @local/lumululu-mei，两者会同时渲染同一个陪伴组件。浏览器本地存储键 llm.companion.v2 保持不变，同一页面源下偏好与计时数据可以延续；需要回滚时请先备份。

加入 Discover 插件源

如果你的 DSH 配置启用了可选的插件市场 Discover，可添加这个自建索引地址：

https://raw.githubusercontent.com/YinniCoding/momolulu/main/market.json

这是维护者自建的索引，不代表已进入某个中心化或官方市场。索引固定到发布 commit，尚未发布到 npm。

使用

• 点击照片展开专注面板；倒计时旁的按钮可直接开始 / 暂停，不必展开面板。
• 点 − 收成小头像，点小头像恢复照片。
• 展开「提醒设置 → 测试提醒（8 秒）」，可预览晃动与高亮，不影响真实提醒时间。
• 点雷达摘要或小头像角标查看其他会话；点整行进入对应对话。
• 展开「外观设置」可切换场景、动效、阅读保护，调整背景亮度与浓度。
• 暂停、计时结束或插件卸载都不会强制退出全屏；只有 Esc 或「退出全屏」会退出。

隐私

见 PRIVACY.md。插件没有开发者后台，也没有插件统计；天气是第三方请求，偏好与计时保存在浏览器本地，定位可选。

已知限制

• 雷达只列普通会话，不含子代理会话。「刚结束」不代表执行成功；待查看状态仅在当前页面保留，刷新后可能丢失。
• 多个窗口之间不共享专注计时状态。
• 浏览器或 Electron 可能拒绝全屏或定位，这类失败不会阻止计时。
• 计时与提醒不是系统级闹钟：关闭 DSH 或设备休眠时不会准时触发，恢复后会按截止时间追赶。
• 天气默认南京；通过定位取得的坐标保留两位小数，且只存在内存中。
• 自动化测试覆盖计时逻辑、雷达分类与提醒判定、全屏控制（注入测试端口）。跨平台视觉布局、真实全屏、会话跳转与权限事件仍需手动验证。
• 未内置自动更新；升级请按 DSH 插件管理器支持的方式卸载后重装。

开发

本地检查需要 Node.js 20 及以上；无需构建步骤，也没有安装脚本。

npm run check
npm test
npm pack --dry-run

开源许可

• 代码：MIT。
• 图片素材（三张场景图、图标与截图）：CC BY 4.0，署名「momolulu artwork © 2026 YinniCoding，CC BY 4.0」。

天气数据来自 Open-Meteo（CC BY 4.0）。与 DeepSeek 及角色权利方无隶属关系，详见 NOTICE.md。