Medipath-K Installation Operation Manual

Document Version: 1.3
Last Updated: 2026-06-27
Script: Medipath_K.sh
Target Platform: Debian / Ubuntu and derivatives (x86_64)

---

1. About This Manual

This manual explains how to install Medipath-K and optional companion components on a Linux workstation.

Official install command:

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

Components covered:

#	Component	Description
1	Medipath-K	Primary desktop kidney pathology analysis application, installed as a .deb package
2	Focus extension	GNOME Shell extension (Steal My Focus), recommended
3	Extension Manager	GNOME Shell Extension Manager, recommended

Medipath-K is the core application. The Focus extension and Extension Manager are optional companion components, but strongly recommended:

• Focus extension: Fixes a known Ubuntu GNOME issue where the system file picker dialog fails to stay on top and receive focus when selecting files multiple times within an application.
• Extension Manager: Provides a graphical UI to view, enable/disable, and maintain GNOME extensions such as Focus.

Installer prompts and logs are in English.

For full Palgo deployment: bash <(curl -fSL https://static.medipath.com.cn/dp/palgo.sh) — see PALGO_OPERATION_MANUAL.en.md.

---

2. Before You Begin

2.1 Requirements

• OS: Debian or Ubuntu (with apt and dpkg)
• Architecture: x86_64 (amd64)
• Privileges: root or a user with sudo
• Network: Outbound HTTPS (Medipath static hosts and related storage services)
• Desktop (Focus only): GNOME graphical session with the target user logged in

2.2 Recommended Dependencies

Run in a terminal:

sudo apt-get update
sudo apt-get install -y curl python3 gnome-shell gnome-shell-extension-prefs

Tool	Purpose
curl or wget	Download packages and configuration files
python3	Parse Medipath-K remote configuration
dpkg / apt-get	Install .deb packages and resolve dependencies
gnome-extensions	Install and enable the Focus extension

2.3 Installation Methods

Recommended: remote one-liner (no manual download):

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

This fetches the latest installer from Medipath static resources and runs it immediately. The remote filename is Medipath_K.sh (underscore) — same as the local repository copy.

For Focus extension setup, run from a local graphical desktop terminal.

Alternative: local script file

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

2.4 Pre-Installation Checklist

• [ ] https://static.medipath.com.cn is reachable (for remote one-liner)
• [ ] curl is installed (required for remote one-liner)
• [ ] You can use sudo, or you are running as root
• [ ] Network connectivity is working
• [ ] For Focus: open a terminal on the local desktop (not SSH-only without a display)
• [ ] You know which components you need (Medipath-K only, or with companion components)

---

3. Run the Installer

Execute in a terminal (recommended remote one-liner):

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

Recommended: Run from a graphical desktop terminal on the target machine for correct Focus extension installation.

On startup you will see:

[timestamp] Medipath-K installer started

The script then presents three installation options in order (see Section 4).

---

4. Step-by-Step Installation

The script asks about each component in a fixed order. Press Enter to accept the default N (skip). Type y or yes to install.

4.1 Medipath-K (Primary Application)

Prompt:

Install Medipath-K? (y/N):

Action: Type y and press Enter to install.

What happens:

1. Downloads the remote Medipath-K configuration file (current_local.json)
2. Parses the Linux package URL from the config
3. Downloads and installs the .deb package
4. If dependencies are missing, runs apt-get install -f and retries automatically

Typical success output:

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

To skip: Press Enter. Log shows Skipping Medipath-K installation.

---

4.2 Focus Extension (Recommended)

Purpose:

The Focus extension (Steal My Focus) addresses an Ubuntu GNOME desktop bug: when an application opens the system file picker multiple times, the dialog may not rise to the top of the window stack or receive focus, leaving it obscured or difficult to use. Installing and enabling this extension significantly improves that behavior.

Recommendation: Install the Focus extension on Ubuntu workstations running Medipath-K.

Prompt:

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):

Action: Type y and press Enter (recommended); press Enter alone to skip.

Important notes:

• Must run under an active GNOME graphical session
• When using sudo ./Medipath_K.sh, the extension is installed for $SUDO_USER (the user who invoked sudo)
• Extension UUID: steal-my-focus@kagesenshi.org

What happens:

1. Downloads the Focus extension ZIP
2. Runs gnome-extensions install --force as the target user
3. Enables the extension automatically

Typical success output:

Focus extension will be installed for user <username> 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.

If the extension does not take effect immediately:

1. Press Alt+F2, type r, press Enter (restarts GNOME Shell), or
2. Log out and log back in

To skip: Press Enter. Log shows Skipping Focus extension installation.

---

4.3 Extension Manager (Recommended)

Purpose:

Extension Manager is the official graphical tool for browsing, installing, enabling/disabling, and updating GNOME Shell extensions. It makes it easy to confirm that the Focus extension is enabled and to manage extensions during ongoing maintenance.

Recommendation: Install alongside the Focus extension.

Prompt:

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

Action: Type y and press Enter (recommended); press Enter alone to skip.

What happens:

1. Updates the apt package index
2. Installs gnome-shell-extension-manager

Typical success output:

Extension Manager installed successfully

After installation: Search the application menu for Extension Manager or GNOME Shell Extension Manager.

To skip: Press Enter. Log shows Skipping Extension Manager installation.

---

4.4 Completion

When all prompts are handled, the script prints:

All operations completed

Temporary download files are removed automatically on exit.

---

5. Verify Installation

5.1 Medipath-K

dpkg -l | grep -i medipath
# or search by .deb package name: dpkg -l | grep -i kidney

Launch Medipath-K from the system menu and confirm it opens without errors.

5.2 Focus Extension

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

Expected line:

steal-my-focus@kagesenshi.org

You can also open Extension Manager and confirm Steal My Focus is enabled.

5.3 Extension Manager

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

Launch Extension Manager from the application menu and confirm the UI opens.

---

6. Daily Use After Installation

6.1 Medipath-K

• Launch from the system application menu
• Configure working directories and data sources per in-app guidance on first use
• Upgrade: Re-run Medipath_K.sh and choose to install Medipath-K again; the script fetches the latest .deb URL from the remote config

6.2 Focus Extension

• Takes effect automatically once installed and enabled; no separate launch required
• Primarily fixes the Ubuntu file picker focus/stacking issue when selecting files multiple times
• Manage via Extension Manager or the gnome-extensions CLI

6.3 Extension Manager

• Browse, install, enable, and disable GNOME extensions graphically
• Recommended to install together with the Focus extension for status checks and ongoing maintenance

---

7. Frequently Asked Questions

Q1: "Missing required commands"

Install the missing utilities:

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

Q2: Medipath-K — cannot parse download URL

• Verify network access to the configuration URL
• Confirm the JSON contains a download.linux field
• Check firewall or proxy rules blocking required storage services

Q3: .deb installation fails

Repair dependencies manually:

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

See /var/log/dpkg.log for details.

Q4: Focus — gnome-extensions not found

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

Q5: Focus fails over SSH

gnome-extensions requires a graphical session. Run Medipath_K.sh from a desktop terminal, or install manually:

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

Q6: Focus installed for the wrong user

With sudo, the extension targets $SUDO_USER. Ensure the desktop login user runs sudo ./Medipath_K.sh, or run the gnome-extensions commands as that user.

Q7: Extension Manager apt install fails

Run sudo apt-get update separately, fix mirror connectivity, then re-run the script.

---

8. Uninstallation

Component	Command
Medipath-K	sudo dpkg -r <package-name> (find name with dpkg -l)
Focus extension	gnome-extensions disable steal-my-focus@kagesenshi.org gnome-extensions uninstall steal-my-focus@kagesenshi.org
Extension Manager	sudo apt-get remove -y gnome-shell-extension-manager

Back up user data before removing Medipath-K if required by local policy.

---

9. Remote Resources

Component	URL / Identifier
Medipath-K config	https://static-1301025454.cos.ap-shanghai.myqcloud.com/pathexpert/updater/current_local.json
Focus extension ZIP	https://static.medipath.com.cn/app/extensions/Steal%20My%20Focus429.zip
Focus extension UUID	steal-my-focus@kagesenshi.org
Extension Manager	apt package: gnome-shell-extension-manager
Installer script (remote)	https://static.medipath.com.cn/dp/Medipath_K.sh

---

10. Quick Reference

# Remote one-liner Medipath-K install (recommended)
bash <(curl -fSL https://static.medipath.com.cn/dp/Medipath_K.sh)

# Verify Focus extension
gnome-extensions list --enabled | grep steal-my-focus

# Verify Extension Manager
dpkg -l gnome-shell-extension-manager

# Restart GNOME Shell (if Focus does not apply)
# Alt+F2 → type r → Enter

---

11. Related Documents

Document	Description
MEDIPATH_K_OPERATION_MANUAL.zh-CN.md	Chinese operation manual
MEDIPATH_K_INSTALL_SOP.md	English standard operating procedure (SOP)
Medipath_K.sh	Installer script source
palgo.sh	Full Palgo self-deployment script

---

Revision History

Version	Date	Changes
1.0	2026-06-27	Initial release (mini.sh)
1.1	2026-06-27	Renamed to Medipath_K.sh; branding updated to Medipath-K
1.2	2026-06-27	Added Focus and Extension Manager purpose notes and install recommendations
1.3	2026-06-27	Documented remote one-liner: bash <(curl -fSL ...)