deepseekplugins

DeepSeek Harness plugin

dsh-ui-mobile-layout

DSH 移动端布局层：窄视口单栏布局 + 左侧抽屉 + 官方设置改造成手机原生两层导航（全屏条目列表→详情→返回），桌面不受影响。

Development & Runtime
Jump to install

Source facts

Repository
RyzeZhou/dsh-ui-mobile-layout
Latest update
Aug 19, 2026
Category
Development & Runtime
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/RyzeZhou/dsh-ui-mobile-layout
Plugin: dsh-ui-mobile-layout
Author: RyzeZhou

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

DSH Mobile UI Layout

![License: MIT](LICENSE) ![GitHub stars](https://github.com/RyzeZhou/dsh-ui-mobile-layout/stargazers)

English

让 DeepSeek Harness 在手机上真正能用：窄视口下把桌面三栏重排为单栏 + 左侧抽屉， 并把官方设置面板改造成手机原生两层导航——点设置进入全屏条目列表 → 点条目进入 该条目设置页 → 每级左上角左箭头返回。桌面宽屏完全不受影响。

[能做什么](#能做什么) · [准备](#准备) · [安装](#安装) · [使用](#使用) · [注意事项与插件冲突](#注意事项与插件冲突) · [更新与卸载](#更新与卸载) · [原理](#原理)

如果它帮到了你，欢迎在 GitHub 仓库右上角点一下 Star。

效果预览

<table> <tr> <td><img src="docs/assets/01-main-conversation.png" alt="手机主对话页" width="160"></td> <td><img src="docs/assets/02-settings-list.png" alt="全屏设置列表" width="160"></td> <td><img src="docs/assets/03-settings-detail.png" alt="条目详情页" width="160"></td> <td><img src="docs/assets/04-sidebar-file-manager.png" alt="侧边栏资源管理器" width="170"></td> </tr> <tr align="center"> <td>主对话页</td> <td>全屏设置列表</td> <td>条目详情页</td> <td>侧边栏在手机端正常可用</td> </tr> </table>

能做什么

  • 手机单栏布局：<768px 时导航栏收为左侧抽屉，对话区占满整屏，不用在三列间左右横跳；
  • 手机原生设置界面：设置面板全屏化，呈现"设置 → 条目列表 → 具体设置页"的二级导航，符合手机使用习惯
  • 大触控目标：顶部返回键、列表条目均为 ≥44px 触控区，适应手指操作；

准备

  • DeepSeek Harness 0.1.0-rc.6 / 0.1.0-rc.7（桌面版或官方 CLI 方式均可）；
  • 建议先在独立测试实例验证，再应用到日常实例。

> 本插件的真实运行形态是 client bundle 插件（责任在浏览器端），并不修改/替换 > 官方任何 slot 的占用者——它只在窄视口下对 frame 外壳做样式重排、并为官方设置面板 > 叠加一个自有的全屏 overlay。桌面端不注册任何行为。

安装

手动安装（Windows，PowerShell）

把插件目录（或 tgz 解压后目录）放到目标实例的 profile node_modules 下，然后在 profile 的 package.json 登记依赖与 bundle，最后重启该实例：

# dependencies 添加
#     "dsh-ui-mobile-layout": "file:./node_modules/dsh-ui-mobile-layout"
# dsh.profile.bundles 数组添加
#     "dsh-ui-mobile-layout"

交给 Agent 安装

把下面的说明直接发给 Agent：

安装 dsh-ui-mobile-layout 插件到 DSH web profile：
1. 将包复制到 <profile>/node_modules/dsh-ui-mobile-layout
2. 在 profile package.json 的 dependencies 添加 "dsh-ui-mobile-layout": "file:./node_modules/dsh-ui-mobile-layout"
3. 在 dsh.profile.bundles 数组添加 "dsh-ui-mobile-layout"
4. 重启该实例并验证 HTTP 200 与插件在 boot graph 中

使用

安装重启后即自动生效，无需任何开关：

1. 用手机（或 DevTools 窄视口）打开 DSH； 2. 左侧抽屉：从屏幕左缘滑出（或点左上菜单按钮）； 3. 点左上角设置入口 → 全屏设置列表； 4. 点任意条目 → 进入该条目具体设置页（标题 = 条目名）； 5. 左箭头返回：详情 → 回到列表；列表 → 关闭设置。

注意事项与插件冲突

> 重要 —— 本插件在"基本功能"层面可用，但 DSH 是 PC 优先的 React 应用， > 手机端适配存在边界。

  • 已验证的插件环境：本插件在自带官方基础插件（shell / ui-settings-general /

ui-layout 等）的环境实测可用；在该环境下抽屉、两层设置导航、详情交互全部通过。

  • 注意其他插件的冲突：由于实现方式是对全局 frame 与官方设置面板做样式/行为叠加，

若同时安装以下类型插件，可能冲突、需要逐个验证： - 也做移动端样式重排的插件（如社区 dsh-ui-mobile 类）——若它对 sidebar 施加 transform，会困住 fixed 弹窗，需二选一或核对覆盖顺序； - 也重写/替换官方设置面板或 role="dialog" 结构的插件； - 使用极高 z-index 全屏浮层的插件（本插件 overlay 用 z-index:2000，若对方的 弹层在其上方可能遮挡设置）。 - 遇到冲突时：先在独立实例（如 5070 测试台）加载本插件 + 冲突插件做对照，确认后再 应用到日常实例；本插件的抽屉用 left 位移而非 transform，这是避免 fixed 弹窗 被困的关键约定，请勿改回 transform。

  • 升级 DSH 需回归：官方 SettingsRoot 的 nav/content/close 结构若变化，可能需要

轻微适配（详情见仓库 MOBILE-SETTINGS-FINAL.md）。

更新与卸载

操作方式
更新用新版本替换 node_modules/dsh-ui-mobile-layout 目录后重启实例
卸载复制/移动整个包目录一份留档 → 从 package.json 移除依赖与 bundle 条目 → 重启

原理

手机设置两层导航的核心思路（完整设计文档见仓库 MOBILE-SETTINGS-FINAL.md）：

窄视口 (<768px)
├─ frame 三列 → 单列
├─ sidebar → 左侧抽屉 (left 位移, transform:none 避免困住 fixed 弹窗)
├─ 官方 dialog 全屏 → "详情页"（原生活内容, 按钮滑块全可交互）
└─ 我们自建的 body 级 overlay → "设置列表页"
    ├─ top 栏（返回键 + 标题）
    ├─ 条目列表（自建按钮, 直接 addEventListener —— 唯一可靠事件机制）
    └─ detail 态: overlay 透明 + pointer-events:none, 露出官方活内容

为什么这样设计？因为在本环境里：

  • document 级事件委托不可靠（点击到不了 document 层）；
  • reparent / 向 React 管理的 dialog 插 DOM 会断 React 合成事件与调和；
  • 克隆官方内容会得到无事件的静态快照。

所以：我们的列表用自建元素直接绑 click，详情直接露出官方 React 活内容—— 两条路都不碰 React 树。

结构

lib/index.js       host 半（最小实现；本插件逻辑都在 client）
lib/client.js      client 半：CSS 注入 + overlay / 两层导航 / 行为层（样式唯一事实源）
mobile.css         与 client.js 内嵌 CSS 镜像（发布/阅读用，改布局两处要同步）
cordis.patch.yml   插件装载 patch

> 注意：lib/client.js 内嵌的 CSS 是实际运行时生效的样式，mobile.css 是为发布/阅读 > 同步的镜像。改动布局请两处一起改。

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category