前言¶
在 DSH 里做「长期伴聊」类智能体时，常见做法是：只靠对话窗口堆人设，日程、记忆和场景展示要么外挂脚本，要么拆成多个小工具。这样聊天能跑，但「她有自己的一块屏、一部手机、一套作息」很难在同一个插件里闭环。
屏幕彼端（dsh-screen-beyond）由维护者 ljx200719 发布，归类为 DSH 客户端插件。它把人设卡、记忆与日记、生活作息、地图与 2D/3D 舞台、聊天界面收拢在一起；完整形态下还可接入虚拟 Linux 桌面与安卓模拟器，让角色在「屏幕另一端」有可见、可点的环境。纯聊天模式只需 Node.js 18+ 与 DeepSeek API Key，可在浏览器独立运行，不强制安装 DSH。
社区目录页：skillhub.cn/plugins/ljx200719/dsh-screen-beyond。源码与文档：github.com/ljx200719/dsh-screen-beyond。当前包版本 0.5.7，许可证 MIT（插件代码）。
这是什么¶
一句话：一个住在屏幕另一端的 AI 小伙伴插件——有虚拟屏幕与安卓手机（完整版）、记忆遗忘与生活作息、地图舞台与虚拟货币，并能纯聊天独立运行。
插件在检测到 VirtualBox 虚拟机、VNC、安卓 AVD 等环境时进入完整版；未检测到则自动降级为纯聊天版，不占虚拟机等额外资源。README 标明为早期版本，可能存在小 bug，问题可反馈到仓库 Issues。
两种形态¶
纯聊天版¶
包含人设、记忆、日记、生活作息、聊天界面，以及地图/舞台相关页面；不包含她的虚拟屏幕与手机环境。任意设备可用，聊天页顶部会显示「可独立运行」提示（README 原文为带拼图 emoji 的文案）。
完整版¶
角色拥有可查看/点击/输入的 Linux 桌面，以及可查看/点击/滑动/输入的安卓手机；另支持通过 pc 工具观察你的电脑屏幕（权限分档）。仅 Windows 上验证屏幕/手机/电脑相关工具；纯聊天跨平台。
核心功能（据 README）¶
下面按模块列举插件自述能力，安装前请自行对照源码与许可。
人设与多角色：名字、称呼、关系、性格滑块、头像、Live2D/3D 模型等；可多角色，各自独立记忆、日记与聊天记录。
记忆：重要事项自记，带遗忘（半衰期）、强化、置顶、归档；可手动增删改并调遗忘速度。
日记：每日一篇，可读给你听。
生活：作息表、活动池、心跳、安静时段；可按天气、体力、记忆等智能安排。
聊天：文字与图片（模型可读图）、逐字流式；可主动找你；顶部显示剩余 token / 今日用量。
地图与舞台：地点拖拽与导入、自绘道路、2D 底图、3D 模型（.glb/.gltf）；2D/3D 舞台切换。
出行与经济：按年龄、驾照、体力、天气、余额选交通；支持虚拟货币或 Token 实时代币（钱与剩余 token 挂钩，汇率可设）。
环境（完整版）：屏幕 / 手机 / 你的电脑三种工具；一键启停与内存提示；设置内「开始自检」检查依赖项。
桌宠（Windows）：设置 → 生活 → 桌宠；可自定义 pet.json 命中区与按钮行为。
开发者接口：例如 GET /api/stage、GET /api/stage/stream（SSE）；聊天 POST /api/chat、流式 GET /api/stream 等，详见 README「给开发者」与 runtime/server.mjs。
模型兼容性：README 明确只验证过 DeepSeek（默认 deepseek-flash）。其它 OpenAI 兼容模型可能导致工具循环或 reasoning_content 异常，作者不承诺适配。
安装与启用¶
依赖关系：完整版需 DSH 0.2.x（桌面或网页均可）。纯聊天不依赖 DSH。
纯聊天：独立运行¶
需要 Node.js 18+ 与 DeepSeek API Key（也可启动后在 设置 → 模型 填写）。
- 解压插件包到任意目录。
- Windows 双击
start-pure-chat.cmd；Linux/macOS 执行sh start-pure-chat.sh，或命令行node runtime/server.mjs。 - 浏览器访问
http://127.0.0.1:8900/。
此时可使用聊天、人设、记忆、日记、生活、地图/舞台等；虚拟屏幕与手机需按下文 DSH 安装与环境配置。
完整版：作为 DSH 插件¶
官方安装命令如下（勿自行拼接 github:owner/repo 形式）：
# 从 npm 安装（已发布 0.5.7）
dsh plugin --profile <profile> add dsh-screen-beyond
# 或从本地目录安装
dsh plugin --profile <profile> add link:<插件目录>
安装后重启 DSH，左侧栏出现「屏幕彼端」。首次打开为纯聊天版；屏幕与手机需在 设置 → 环境 按教程配置。
配置要点¶
插件通过 cordis.patch.yml 注入配置，例如：
- insert:
- id: dsh-screen-beyond
name: dsh-screen-beyond
config:
port: 8900 # 运行时端口（被占会自动 +1 找空闲）
autoStart: true # 是否自动拉起运行时
# dataRoot: 'D:\你的数据目录' # 可选；默认 %USERPROFILE%\.dsh-companion
# envDir: 'D:\dsh-env' # 可选；完整版辅助脚本所在目录
也可在本机放置 %USERPROFILE%\.dsh-companion.json 覆盖 dataRoot、envDir（优先级低于插件配置中的显式值）。默认数据目录为 %USERPROFILE%\.dsh-companion，升级/重装不覆盖该目录。
运行时默认地址：http://127.0.0.1:8900/。主要路径：/ 聊天、/map 地图、/stage 2D 舞台、/model 3D 舞台、/settings 设置、/screen 看屏幕；聊天页 Alt+S 可打开看屏幕。
完整版环境（可选）¶
仅 Windows。README 要求大致包括：
- VirtualBox + Debian 桌面虚拟机（建议 8G 内存 / 40G 磁盘），SSH 转发到本机
2222（默认用户dsh，密码可在插件配置修改）。 - 虚拟机内
x11vnc+websockify，宿主机 noVNC 端口6081。 - Android AVD：推荐 Android 16 / API 36、1080×1920（示例名
DSH_Phone），adb可用；真机未适配。
虚拟机与模拟器同时开启时内存占用较高（README 给出屏幕约 2–6 GB、手机约 2–4 GB 的量级）。环境变量 DSH_COMPANION_ENV、DSH_COMPANION_PY、DSH_COMPANION_ADB 等可覆盖本机路径。中文手机输入需通过设置 → 环境安装 ADBKeyboard。
详细步骤见插件内 设置 → 教程，或打开运行时默认端口页面。
典型用法¶
- 先验证纯聊天：按独立运行三步启动，在浏览器完成 API Key 配置，确认记忆、日记、聊天流式正常。
- 再装 DSH 插件：用上述
dsh plugin add命令装入 profile，重启后在 DSH 客户端打开「屏幕彼端」。 - 需要看屏/手机时：在 Windows 完成环境自检通过后，在设置中一键启动环境；权限建议从「仅鼠标键盘」起试，再视需求开放「代码控制」。
- 自定义桌宠：编辑数据目录下
pet.json，参考runtime/pet/pet.example.json调整gestures与buttons。 - 备份：设置 → 数据 → 立即备份，或使用
scripts/backup.ps1；恢复用scripts/restore.ps1 -BackupDir <备份目录>。
开发自测脚本位于 tests/（需运行时占用 8900 且会消耗 token），例如 python tests/full_test.py。
适用场景与注意¶
适合：希望在 DSH 客户端内做「伴聊 + 可视化舞台 + 可选虚拟桌面/模拟器」一体化实验；已持有 DeepSeek API Key；完整版用户接受 Windows 与 VirtualBox/AVD 运维成本。
不适合或需降级：非 Windows 上需要屏幕/手机/电脑自动化；依赖非 DeepSeek 模型做复杂工具链；不愿在本机跑虚拟机与模拟器。
安全与权限：插件以当前 DSH 进程权限运行，完整版可控制虚拟机、模拟器及（在授权下）你的电脑屏幕。安装前请阅读 仓库源码 与 MIT 许可；敏感操作有确认开关，但不应替代你自己的环境与密钥管理。
生态说明：DSH 主张「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
屏幕彼端把伴聊、记忆与生活模拟、地图舞台，以及可选的虚拟 Linux 桌面与安卓手机收进同一个 DSH 客户端插件；纯聊天又可脱离 DSH 快速试水。若你要在 Harness 生态里做「有屏有肉」的长线角色，可从 0.5.7 的 npm 安装或独立 node runtime/server.mjs 起步，再按 README 逐步打开完整环境。
- 目录页：https://www.skillhub.cn/plugins/ljx200719/dsh-screen-beyond
- GitHub：https://github.com/ljx200719/dsh-screen-beyond
