linkgo

LinkGo v3 远程管理

通过 HTTP API 管理 LinkGo v3 导航页上的服务卡片、页面配置、图标和系统设置。

执行规则

直接运行用户请求的命令，不要预先检查依赖项、环境变量或配置。如果有问题，脚本会报出明确错误——仅在出现错误后检查并修复。

环境变量

变量	必填	用途
LINKGO_HOST	✅	实例地址，例如 http://192.168.1.100:80
LINKGO_PASSWORD	✅	管理员密码

脚本会自动从 ~/.wmyskills/.env（所有技能共享）加载这些变量；如果脚本目录中存在 scripts/.env，则优先使用该文件。以 scripts/.env.example 为模板——将变量添加到 ~/.wmyskills/.env，切勿覆盖已有文件。

要求

无外部依赖（仅使用标准库）。

用法

脚本：scripts/linkgo.py

连通性

python scripts/linkgo.py ping

查询卡片

# 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

卡片管理

# 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

页面设置

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

图标

# 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

配置导出 / 导入

# 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

密码与调试

# 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

服务卡片字段

字段	必填	类型	说明
id	✅	字符串	唯一标识符，只能包含字母和数字，创建后不可更改
title	✅	字符串	显示标题，支持变量替换
href	✅	字符串	点击目标 URL，支持 javascript: 协议
icon	❌	字符串	图标路径（例如 static/icon/home.svg），上传后可用
displayAddress	❌	字符串	卡片上显示的地址文本
description	❌	字符串	描述文本，支持变量替换和 HTML
status	❌	整数	1=启用（默认），0=禁用

参数化语法（仅限 description）

语法	说明	示例
{link:URL,text}	普通链接	{link:https://example.com,Example}
{sublink:URL,text}	蓝色粗体链接	{sublink:https://example.com,Details}
{modallink:URL,title,text}	Iframe 模态框链接	{modallink:http://x:8080,Service,View}
{tip:content}	搜索关键词提示（不可见）	{tip:keyword1 keyword2}
{page_info}	页面信息占位符（可选择的文本）	{page_info}

静态变量

变量	替换为	示例
{project_name}	项目名称	LinkGo
{project_version}	项目版本	v3_20250823
{addr_prefit}	地址： 标签	{addr_prefit} → 地址：
{space}	三个空格	Line 1{space}Line 2
{icon_path}	图标目录	{icon_path}myicon.svg → /static/icon/myicon.svg
{api_path}	API 目录	{api_path} → /api/
{static_path}	静态目录	{static_path} → /static/
{pages_path}	页面目录	{pages_path} → /pages/

动态变量（前端会根据每个页面自动替换）

变量	说明	示例
{host}	主机名 + 端口	localhost:8080
{hostname}	仅主机名	localhost
{port}	端口	8080
{protocol}	协议（http/https）	http
{pathname}	当前 URL 路径	/index.html
{href}	完整 URL	http://localhost:8080/index.html
%s	{host} 的别名	localhost:8080

重要提示

• Edit 是增量操作 — 只需传入要更改的字段；其他字段保持不变
• 导入/重置前请先备份 — 这两项操作都会覆盖所有数据，且不可撤销
• 图标上传限制：每个文件 1 MB；支持的格式：SVG/PNG/JPG/JPEG/GIF/WEBP/ICO
• reset 会清除所有自定义卡片
• reset-password 只能在服务器主机本身上使用（API 仅接受 127.0.0.1）；使用该命令时，LINKGO_HOST 必须指向 http://127.0.0.1
• 更改密码后会自动更新服务器的 config.php
• 执行 change-password / reset-password 后，请引导用户更新 ~/.wmyskills/.env 中的 LINKGO_PASSWORD（如果存在 scripts/.env，也要更新其中的值；该文件的优先级更高）；已存储的密码将失效，后续命令会因 401 错误而失败

参考

如需查看完整的 LinkGo v3 API 参考、变量替换系统、前端模块和部署配置，请阅读 references/api_doc.md。