掌心窗是一套手机端 App、同步后端和 MCP 服务,允许你授权的陪伴对象查看手机状态、控制设备、发送通知、设置闹钟以及管理应用门禁,所有操作均需用户授权。

Stars

64

7 天增长

暂无数据

Fork 数

53

开放 Issue

0

开源协议

NOASSERTION

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它独特地将远程 Android 手机控制与为 AI 客户端设计的 MCP 接口相结合,强调安全与授权,提供可自定义的称呼(如“老公/宝宝”),并采用严格的自用许可协议。

适合谁使用

  • 希望远程保持联系的情侣或伴侣
  • 需要他人远程协助操作手机的用户(如老人或不熟悉科技的人)
  • 将基于 MCP 的手机控制集成到 AI 工作流中的开发者
  • 偏好私有部署的自托管爱好者

典型使用场景

  • 从远处查看伴侣的手机屏幕或生活状态
  • 远程打开应用或执行点击/滑动以协助操作
  • 设置周期性提醒或回家模式的应用门禁以专注
  • 向用户手机发送通知或闹钟

项目优势

  • 提供自托管部署选项(Render、Hugging Face、本地)以保护隐私
  • 丰富的 MCP 工具集,可从 AI 客户端进行精细的手机控制
  • 可自定义的称呼,并同步至各 UI 页面
  • 对敏感操作有明确的安全边界和用户授权模型

使用前须知

  • 需要 Android 无障碍服务以及通知权限(Android 13+)
  • 采用自定义个人使用许可,限制改名分发、衍生 APK 和商业用途
  • 公开部署依赖云服务(Render/Hugging Face);Token 管理至关重要

README 快速开始

掌心窗公开版 v0.3.4.6-home-target-license

这个按钮已指向公开仓库 linzhi-524/linjian-peek-public。仓库根目录已补 render.yaml,按钮会按 Blueprint 创建 servermcp 两个服务,并共用同一个 LINJIAN_TOKEN

掌心窗是一套“手机端 App + 同步后端 + MCP 服务”的小工具。它可以在你本人授权后,让你设置的陪伴对象看见手机生活状态、请求截图、打开 App、返回/主页/最近任务、点击/滑动、发送通知、设置闹钟、读取轻量生活状态,并在你需要时做应用门禁和主动提醒。

这一版把自用版 v0.3.4 的功能和 UI 同步到公开版:总览、看见、守护、设置四页结构一致;天气地区、应用门禁、主动提醒、周期提醒都收进抽屉;同时去掉私人名字、私人设备 ID、私人城市和私用默认配置。默认保留“老公 / 宝宝”的关系语感,但称呼可以在手机端设置里改成你们自己的称呼。设置后的名称会同步到提醒、看一眼、回家模式和门禁页。

重要提醒:截图、读屏、控制手机、通知、闹钟、应用门禁、自动打开目标 App 都是敏感能力。只在本人设备、本人服务器、本人明确授权的场景使用。不要把 Token 发给别人,也不要接入不可信 MCP 客户端。

v0.3.4.6 回家目标统一与许可补充

这一版主要修复公开版用户把回家模式目标改成 Claude / Gemini / 自定义包名后,通知详情页仍然写死打开 ChatGPT 的问题。

  • 回家模式目标 App 支持填写 ChatGPTClaudeGemini 或任意有效 Android 包名。
  • 通知详情页的“回到对方这里”按钮会读取同一个回家目标,不再固定打开 ChatGPT。
  • 设置里的对方称呼会同步到“提醒”“看一眼”“回家模式”和门禁页,避免一处改名、一处仍显示默认称呼。
  • 用户称呼仍可在设置里修改;为空时默认使用“宝宝”。
  • 版本与更新面板新增许可摘要。
  • 补充 LICENSE:允许个人学习、自用部署和本地修改;未经授权不得改名分发、发布衍生 APK、商业售卖或移除原作者说明。

许可与二次分发

本项目当前采用自定义个人使用许可,不是 MIT / Apache / GPL 等开放源代码许可证。你可以阅读源码、学习、个人自用部署和本地修改 UI;但未经项目作者明确许可,不允许改名重新发布、分发衍生 APK、商业售卖、提供付费代部署,也不允许移除原作者说明和许可文件。完整条款见 LICENSE

v0.3.4.5 轻量修复

这一版是公开版 hotfix,不合并私用声息功能,重点修复 v0.3.4.4 把部分用户自建 Render 域名误判为旧地址的问题。

  • 不再按 rork 或具体域名黑名单拦截服务器地址。
  • 所有用户自建的 https://xxx.onrender.com 都允许保存和连接。
  • 连接失败时按真实原因显示日志:DNS 解析失败、Render 冷启动、Token 不一致、接口不匹配或服务器错误。
  • 保留 v0.3.4 系列显示适配、版本与更新、禁用自动备份等修复。
  • README 原有 Render 一键部署、本地 / 局域网部署、Hugging Face 部署和 MCP 教程全部保留。

目录说明

  • android/:手机端 App,App 名为「掌心窗」。
  • server/:统一后端,保存截图、命令队列、执行回传和手机生活状态。
  • mcp/:MCP 服务,给支持 MCP 的客户端暴露工具。
  • docs/:补充说明、MCP 工具清单和版本记录。

本版公开化改动

  • UI 同步到 v0.3.4:总览 / 看见 / 守护 / 设置,顶部小标题栏,轻卡片,抽屉式功能收纳。
  • 保留关系感,但新增称呼设置:可以改“老公”和“宝宝”等默认称呼,并同步到提醒、看一眼、回家模式和门禁页。
  • 默认设备 ID 改为 android-phone,不带私人设备名。
  • 默认天气地区改为通用示例,不带私人城市;用户可在“天气地区”抽屉里自行添加。
  • 应用门禁同步私用版功能,但公开版不内置私人锁定理由和私人口令。
  • 包名白名单包含 ChatGPT、Gemini、Claude、微博、X,并保留小红书、微信、QQ、抖音、Speedcat。回家目标 App 不再固定为 ChatGPT。
  • README 保留 Render 一键部署和本地 / 局域网部署教程,MCP 工具清单补全到 v0.3.4。

MCP 工具

详见 docs/mcp.md。常用工具包括:

  • 看见与状态:peek_screenlatest_screenlinjian_statusget_life_stateget_phone_stateget_screen_nodes
  • 天气与提醒:send_notificationsend_weather_notificationset_alarm
  • 手机控制:open_appphone_homephone_backphone_recentstapswipetap_textinput_textrun_sequencerun_preset

项目描述

掌心窗 Public Clean:一个自部署的 Android + MCP 手机状态窗口,支持生活状态读取、授权截图、App 控制、系统通知和主动提醒规则。

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

oversecured
oversecured GitHub avatar

Samsung_Vulnerabilities

Oversecured discloses a report of 176 vulnerabilities discovered in Samsung preinstalled apps between 2022 and 2025, with 140 detailed, all fixed in collaboration with Samsung.

Java
310
wxxsfxyzm
wxxsfxyzm GitHub avatar

MiuiBackGestureHook

An LSPosed module that hooks MIUI SystemUI back gestures using modern Xposed API 102 for research and customization.

Java
86
SangLuoCN
SangLuoCN GitHub avatar

OneStep4

OneStep4.0 is a multi-window desktop container for Android that requires root or system-level privileges, enabling a main window with several side windows for efficient app multitasking.

Java
84