Medipath

简体中文

English

简体中文

English

Appearance

Medipath-K 安装操作手册 ​

文档版本： 1.3
更新日期： 2026-06-27
适用脚本： Medipath_K.sh
适用系统： Debian / Ubuntu 及衍生发行版（x86_64）

一、手册说明 ​

本手册介绍如何在 Linux 工作站上安装 Medipath-K 及相关可选组件。

官方安装命令：

bash
bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh)

安装内容如下：

序号组件说明
1Medipath-K病理肾脏分析桌面应用（主程序），以 .deb 包形式安装
2Focus 插件GNOME 桌面扩展（Steal My Focus），建议安装
3插件管理器GNOME Shell Extension Manager，建议安装

Medipath-K 为核心安装项。Focus 插件与插件管理器为可选配套组件，但强烈建议一并安装：

  • Focus 插件：修复 Ubuntu GNOME 下的已知问题——多次打开文件选择框时，对话框无法始终置顶并获得焦点，导致选文件体验异常。
  • 插件管理器：提供图形界面，便于查看、启用/禁用及维护 Focus 等 GNOME 扩展。

脚本界面与日志为英文，本手册提供中文对照说明。

完整部署（Palgo Web、上传客户端、Chrome 等）请使用：bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh)，详见 PALGO_OPERATION_MANUAL.zh-CN.md。

二、安装前准备 ​

2.1 环境要求 ​

  • 操作系统：Debian 或 Ubuntu（需支持 apt / dpkg）
  • 处理器架构：x86_64（amd64）
  • 权限：root 或具备 sudo 的普通用户
  • 网络：可访问外网 HTTPS（Medipath 静态资源及相关存储服务）
  • 桌面环境（安装 Focus 插件时）：GNOME 图形会话，用户已登录桌面

2.2 建议提前安装的依赖 ​

在终端执行：

bash
sudo apt-get update
sudo apt-get install -y curl python3 gnome-shell gnome-shell-extension-prefs
工具用途
curl 或 wget下载安装包与配置文件
python3解析 Medipath-K 远程配置
dpkg / apt-get安装 .deb 包及依赖
gnome-extensions安装、启用 Focus 插件

2.3 安装方式 ​

推荐：远程一键安装（无需手动下载脚本）：

bash
bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh)

脚本会自动通过 curl 拉取最新版安装脚本并执行。远程文件名为 Medipath_K.sh（下划线），与本地仓库副本文件名一致。

需要安装 Focus 扩展时，请在本机图形桌面终端中运行上述命令。

备选：本地脚本文件

bash
chmod +x Medipath_K.sh
sudo ./Medipath_K.sh

2.4 安装前检查清单 ​

  • [ ] 可访问 https://static.medipath.com.cn（远程一键安装）
  • [ ] 已安装 curl（远程一键安装必需）
  • [ ] 当前用户可使用 sudo，或可直接以 root 运行
  • [ ] 网络连接正常
  • [ ] 若需安装 Focus 插件：在本机桌面打开终端（勿仅通过 SSH 无图形环境操作）
  • [ ] 已确认需要安装的组件（可只安装 Medipath-K，或一并安装配套组件）

三、运行安装程序 ​

在终端执行（推荐远程一键安装）：

bash
bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh)

推荐： 在目标机器的图形桌面中打开终端运行，以便正确安装 Focus 扩展。

启动后终端将显示：

[时间戳] Medipath-K installer started

随后依次出现三个安装选项（见第四节）。

四、分步安装说明 ​

脚本会按固定顺序询问三项组件。直接按 Enter 表示选择默认项 N（不安装）；输入 y 或 yes 表示确认安装。

4.1 Medipath-K（主程序） ​

英文提示：

Install Medipath-K? (y/N):

操作： 需要安装时输入 y 并回车。

安装过程：

  1. 从远程下载 Medipath-K 配置文件（current_local.json）
  2. 自动解析其中的 Linux 安装包地址
  3. 下载 .deb 并执行安装
  4. 若依赖缺失，脚本会自动执行 apt-get install -f 修复后重试

典型成功日志：

Downloading Medipath-K configuration...
Resolved Medipath-K download URL: <地址>
Medipath-K installed successfully

跳过安装： 直接回车，日志显示 Skipping Medipath-K installation。

4.2 Focus 插件（建议安装） ​

用途说明：

Focus 插件（Steal My Focus）主要用于修复 Ubuntu GNOME 桌面下的文件选择框焦点问题：在应用内多次选择文件时，系统文件选择对话框有时不会自动置顶到最上层，导致对话框被遮挡或无法操作。安装并启用该扩展可显著改善此问题。

建议： 在 Ubuntu 工作站上部署 Medipath-K 时，建议安装 Focus 插件。

英文提示：

Recommended: Focus extension fixes an Ubuntu GNOME bug where the file picker
  dialog fails to stay on top when selecting files multiple times.
Install Focus extension? (recommended, y/N):

操作： 建议输入 y 并回车；若确认不需要可回车跳过。

重要说明：

  • 必须在 GNOME 图形桌面 下运行，且目标用户已登录
  • 使用 sudo ./Medipath_K.sh 时，插件会安装到 $SUDO_USER（即发起 sudo 的桌面用户）的账户下
  • 扩展标识：steal-my-focus@kagesenshi.org

安装过程：

  1. 下载 Focus 扩展 ZIP 包
  2. 以目标用户执行 gnome-extensions install --force
  3. 自动启用扩展

典型成功日志：

Focus extension will be installed for user <用户名> in the GNOME session.
Focus extension installed and enabled. If changes do not apply, press Alt+F2, type 'r', or log out and back in.

扩展未立即生效时：

  1. 按 Alt + F2，输入 r 后回车（重启 GNOME Shell），或
  2. 注销后重新登录

跳过安装： 直接回车，日志显示 Skipping Focus extension installation。

4.3 插件管理器（Extension Manager，建议安装） ​

用途说明：

插件管理器是 GNOME 官方的扩展管理图形工具，用于浏览、安装、启用/禁用和更新 GNOME Shell 扩展。安装后可方便地确认 Focus 插件是否已启用，并在后续维护中管理扩展状态。

建议： 与 Focus 插件配套使用，建议安装。

英文提示：

Recommended: Extension Manager provides a graphical UI to manage GNOME extensions.
Install Extension Manager? (recommended, y/N):

操作： 建议输入 y 并回车；若确认不需要可回车跳过。

安装过程：

  1. 更新 apt 软件源缓存
  2. 安装软件包 gnome-shell-extension-manager

典型成功日志：

Extension Manager installed successfully

安装后使用： 在应用菜单中搜索 Extension Manager 或 扩展管理器 即可打开。

跳过安装： 直接回车，日志显示 Skipping Extension Manager installation。

4.4 安装完成 ​

全部选项处理完毕后，终端显示：

All operations completed

脚本退出时会自动清理临时下载文件。

五、安装结果验证 ​

5.1 Medipath-K ​

bash
dpkg -l | grep -i medipath
# 或根据 .deb 包名查询：dpkg -l | grep -i kidney

在应用菜单中启动 Medipath-K，确认可正常打开。

5.2 Focus 插件 ​

bash
gnome-extensions list --enabled | grep steal-my-focus

应看到：

steal-my-focus@kagesenshi.org

也可打开 Extension Manager，确认 Steal My Focus 处于启用状态。

5.3 插件管理器 ​

bash
dpkg -l | grep gnome-shell-extension-manager

从应用菜单启动 Extension Manager，确认界面可正常打开。

六、安装后日常使用 ​

6.1 Medipath-K ​

  • 从系统应用菜单启动
  • 首次使用请按软件内说明配置工作目录与数据源
  • 升级：重新运行 Medipath_K.sh 并选择安装 Medipath-K，脚本会拉取配置中的最新 .deb 地址

6.2 Focus 插件 ​

  • 安装并启用后自动生效，无需单独启动
  • 主要解决 Ubuntu 下多次选文件时，文件选择框无法置顶并获得焦点的问题
  • 管理扩展：通过 Extension Manager 或命令 gnome-extensions

6.3 插件管理器 ​

  • 用于浏览、安装、启用/禁用 GNOME 扩展
  • 建议与 Focus 插件一并安装，便于确认扩展状态及后续维护

七、常见问题 ​

Q1：提示 "Missing required commands" ​

缺少系统工具。执行：

bash
sudo apt-get update
sudo apt-get install -y curl python3 dpkg apt

Q2：Medipath-K 提示无法解析下载地址 ​

  • 检查网络是否能访问配置文件 URL
  • 确认 JSON 配置中包含 download.linux 字段
  • 排查防火墙或代理是否拦截所需存储服务

Q3：.deb 安装失败 ​

手动修复依赖：

bash
sudo apt-get update
sudo apt-get install -f -y

查看详细错误：/var/log/dpkg.log

Q4：Focus 插件提示找不到 gnome-extensions ​

bash
sudo apt-get install -y gnome-shell gnome-shell-extension-prefs

Q5：通过 SSH 安装 Focus 失败 ​

gnome-extensions 需要图形会话。请在本机桌面终端中运行 Medipath_K.sh，或手动安装：

bash
gnome-extensions install --force /path/to/focus-extension.zip
gnome-extensions enable steal-my-focus@kagesenshi.org

Q6：Focus 装到了错误的用户 ​

使用 sudo 时扩展会安装到 $SUDO_USER。请确保以桌面登录用户执行 sudo ./Medipath_K.sh，或以该用户身份手动运行 gnome-extensions 命令。

Q7：插件管理器 apt 安装失败 ​

先单独执行 sudo apt-get update，确认软件源可用后再重新运行脚本。

八、卸载说明 ​

组件卸载方法
Medipath-Ksudo dpkg -r <包名>（先用 dpkg -l 查询包名）
Focus 插件gnome-extensions disable steal-my-focus@kagesenshi.org
gnome-extensions uninstall steal-my-focus@kagesenshi.org
插件管理器sudo apt-get remove -y gnome-shell-extension-manager

卸载 Medipath-K 前，请按本地规范备份用户数据。

九、远程资源参考 ​

组件地址
Medipath-K 配置https://static-1301025454.cos.ap-shanghai.myqcloud.com/pathexpert/updater/current_local.json
Focus 扩展包https://static.medipath.com.cn/app/extensions/Steal%20My%20Focus429.zip
Focus 扩展 UUIDsteal-my-focus@kagesenshi.org
插件管理器系统 apt 源：gnome-shell-extension-manager
安装脚本（远程）https://static.medipath.com.cn/dp/Medipath_K.sh

十、快速参考 ​

bash
# 远程一键安装 Medipath-K（推荐）
bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh)

# 验证 Focus 插件
gnome-extensions list --enabled | grep steal-my-focus

# 验证插件管理器
dpkg -l gnome-shell-extension-manager

# 重启 GNOME Shell（Focus 未生效时）
# Alt+F2 → 输入 r → 回车

十一、相关文档 ​

文档说明
MEDIPATH_K_OPERATION_MANUAL.en.md英文版操作手册
MEDIPATH_K_INSTALL_SOP.md英文标准操作规程（SOP）
Medipath_K.sh安装脚本源码
palgo.sh完整 Palgo 自部署脚本

修订记录 ​

版本日期说明
1.02026-06-27初版（mini.sh）
1.12026-06-27重命名为 Medipath_K.sh，文案统一为 Medipath-K
1.22026-06-27补充 Focus 插件与插件管理器的用途说明及安装建议
1.32026-06-27明确远程一键安装命令 bash <(curl -fSL ...)