LinkGo v3 Remote Management

Manage service cards, page configuration, icons, and system settings on a LinkGo v3 navigation page via its HTTP API.

Execution Rule

Run the user's requested command directly without pre-checking dependencies, environment variables, or configuration. If something is wrong, the script will fail with a clear error — check and fix only then.

Environment Variables

Variable	Required	Purpose
`LINKGO_HOST`	✅	Instance address, e.g. `http://192.168.1.100:80`
`LINKGO_PASSWORD`	✅	Admin password

The script loads these from ~/.wmyskills/.env (shared across skills) automatically; a scripts/.env in the script directory takes priority if present. Use scripts/.env.example as the template — add the variables to ~/.wmyskills/.env, never overwriting an existing file.

Requirements

No external dependencies (stdlib only).

Usage

Script: scripts/linkgo.py

Connectivity

python scripts/linkgo.py ping

Query Cards

# List enabled cards (default)
python scripts/linkgo.py list

# List all cards (including disabled)
python scripts/linkgo.py list --all

# Query a specific card by id
python scripts/linkgo.py list --id my-service

Card Management

# Add a card (JSON string)
python scripts/linkgo.py add '{"id":"my-service","title":"My Service","href":"http://example.com","icon":"static/icon/link.svg","displayAddress":"example.com","description":"Service description","status":1}'

# Edit a card (merge fields by id)
python scripts/linkgo.py edit my-service '{"title":"New Title","href":"http://new.example.com"}'

# Delete a card
python scripts/linkgo.py delete my-service

# Enable / disable
python scripts/linkgo.py enable my-service
python scripts/linkgo.py disable my-service

Page Settings

python scripts/linkgo.py page '{"title":"New Title","searchEnabled":0}'

Icons

# Upload one or more icons (multi-file supported)
python scripts/linkgo.py upload-icon /path/to/icon.svg /path/to/another.png

# List available icons
python scripts/linkgo.py icons

Config Export / Import

# Export config to file
python scripts/linkgo.py export -o backup.json

# Export to stdout
python scripts/linkgo.py export

# Import config (overwrites all data)
python scripts/linkgo.py import backup.json

# Reset to default config
python scripts/linkgo.py reset

Password & Debug

# Change admin password
python scripts/linkgo.py change-password <old_password> <new_password>

# Reset password to a random 8-char one (server-local only, 127.0.0.1)
python scripts/linkgo.py reset-password

# Debug info
python scripts/linkgo.py debug

Service Card Fields

Field	Required	Type	Description
`id`	✅	string	Unique identifier, alphanumeric only, immutable after creation
`title`	✅	string	Display title, supports variable substitution
`href`	✅	string	Click target URL, supports `javascript:` protocol
`icon`	❌	string	Icon path (e.g. `static/icon/home.svg`), available after upload
`displayAddress`	❌	string	Address text shown on the card
`description`	❌	string	Description text, supports variable substitution and HTML
`status`	❌	int	`1`=enabled (default), `0`=disabled

Parameterized Syntax (description only)

Syntax	Description	Example
`{link:URL,text}`	Plain link	`{link:https://example.com,Example}`
`{sublink:URL,text}`	Blue bold link	`{sublink:https://example.com,Details}`
`{modallink:URL,title,text}`	Iframe modal link	`{modallink:http://x:8080,Service,View}`
`{tip:content}`	Search keyword hint (invisible)	`{tip:keyword1 keyword2}`
`{page_info}`	Page info placeholder (selectable text)	`{page_info}`

Static Variables

Variable	Replaced with	Example
`{project_name}`	Project name	`LinkGo`
`{project_version}`	Project version	`v3_20250823`
`{addr_prefit}`	`地址：` label	`{addr_prefit}` → `地址：`
`{space}`	Three spaces	`Line 1{space}Line 2`
`{icon_path}`	Icon directory	`{icon_path}myicon.svg` → `/static/icon/myicon.svg`
`{api_path}`	API directory	`{api_path}` → `/api/`
`{static_path}`	Static directory	`{static_path}` → `/static/`
`{pages_path}`	Pages directory	`{pages_path}` → `/pages/`

Dynamic Variables (auto-replaced by frontend per page)

Variable	Description	Example
`{host}`	Hostname + port	`localhost:8080`
`{hostname}`	Hostname only	`localhost`
`{port}`	Port	`8080`
`{protocol}`	Protocol (`http`/`https`)	`http`
`{pathname}`	Current URL path	`/index.html`
`{href}`	Full URL	`http://localhost:8080/index.html`
`%s`	Alias of `{host}`	`localhost:8080`

Important Notes

Edit is incremental — only pass the fields you want to change; others stay as-is
Backup before import/reset — both operations overwrite all data and are irreversible
Icon upload limit: 1MB per file; supported formats: SVG/PNG/JPG/JPEG/GIF/WEBP/ICO
reset clears all custom cards
reset-password only works on the server host itself (the API accepts 127.0.0.1 only); LINKGO_HOST must point at http://127.0.0.1 for it
Password change auto-updates the server's config.php
After change-password / reset-password, guide the user to update LINKGO_PASSWORD in ~/.wmyskills/.env (and scripts/.env if present — it takes priority); the stored password becomes invalid and further commands will fail with 401

Reference

For the full LinkGo v3 API reference, variable substitution system, frontend modules, and deployment config, read references/api_doc.md.

linkgo

Installation

Also in this package

Agent compatibility

Repository health

Skill metadata

Package contents

History

SKILL.md