openclaw-config/workspace-tab/skills/tab/SKILL.md

name, description

name	description
tab	管理 tab 项目数据库（本地 MySQL tab 库）。新增/去重 engine 引擎、website 站点、website_type 站点类型数据，以及启用/禁用（status 切换）。

Tab — 项目数据库管理

管理本地 MySQL tab 数据库中的三张表：engine（引擎）、website（站点）、website_type（站点类型）。初版职责：新增（含去重）+ 启用/禁用。查询/修改/删除后续扩展。

数据库连接

连接库名「tab」：

python3 /home/yangxuan/.openclaw/workspace/skills/db-query/scripts/db_query.py --database "tab" --query "<SQL>"

• 本地 Docker MySQL（127.0.0.1:3306），user=root，密码已配置
• 凭据不直连，统一走 db-query 脚本
• 注意：order 是保留字，涉及时必须用反引号 `order`

表结构（三张）

engine — 引擎

字段	类型	说明
id	varchar(32) PK	唯一 id，UUID()
status	tinyint	0有效 1无效（禁用改此字段）
title	varchar(500) NOT NULL	标题（必填）
description	varchar(200)	描述（必填）
icon	varchar(500) NOT NULL	图标（自动取 favicon）
url	varchar(500) NOT NULL	链接（必填）
click	int default 0	点击
deleted	bit default 0	是否删除
create_time / update_time	datetime	审计，NOW() 自动
creator / updater	varchar(64)	审计，自动填
tenant_id	bigint default 0	自动填 0

website — 站点

字段	类型	说明
id	varchar(32) PK	UUID()
status	tinyint	0有效 1无效（禁用改此）
type_id	int	站点类型 id（必填，关联 website_type.id）
title	varchar(500) NOT NULL	标题（必填）
description	varchar(200)	描述（必填）
`order`	int default 0	排序（反引号！）
icon	varchar(500) NOT NULL	图标（自动取 favicon）
url	varchar(500) NOT NULL	链接（必填）
click	int default 0	点击
deleted	bit default 0	是否删除
create_time / update_time	datetime(6)	审计，NOW(6) 自动
creator / updater	varchar(64)	审计，自动填
tenant_id	bigint default 0	自动填 0

website_type — 站点类型

字段	类型	说明
id	int auto_increment PK	自增
status	tinyint	0有效 1无效（禁用改此）
title	varchar(200) NOT NULL	类型名（必填，去重依据）
icon	varchar(200) NOT NULL	图标
description	varchar(200)	描述（必填）
`order`	int default 0	排序（反引号！）
deleted	bit default 0	是否删除
create_time / update_time	datetime(6)	审计，NOW(6) 自动
creator / updater	varchar(64)	审计，自动填
tenant_id	bigint default 0	自动填 0

通用规范

• 审计字段自动生成：id（UUID() 32位无横线）、create_time/update_time（NOW()/NOW(6)）、creator/updater（填 system）、tenant_id（0）、click（默认 0）、deleted（默认 0）。用户无需提供。
• 必填（用户提供）：title、url、description（三表 title 必填；engine/website 的 url+description 必填；website_type 的 title+description 必填）。
• type_id（website 表）：必填，且必须是 website_type 表中**已存在且有效（status=0,deleted=0）**的 id。新增站点前须先校验。
• 全程中文交互。
• 所有写入通过 db-query 脚本执行。

favicon 获取（icon 自动）

新增 engine/website 时，icon 字段由 agent 根据用户提供的 url 自动获取 favicon：

1. 先尝试直接访问：https://<域名>/favicon.ico
   • 域名 = URL 的主机部分（去协议、去路径，如 https://www.doubao.com/chat → www.doubao.com）
2. 失败则用 icon.horse：https://icon.horse/icon/<域名>
   • 直接访问返回非图片（content-type 非 image/*）或超时/失败时用此兜底

实现示例（python 判优先级）：

import urllib.request, re
from urllib.parse import urlparse

def get_favicon(url):
    host = urlparse(url).netloc  # 如 www.doubao.com
    candidates = [
        f"https://{host}/favicon.ico",
        f"https://icon.horse/icon/{host}",
    ]
    for c in candidates:
        try:
            req = urllib.request.Request(c, method="HEAD", headers={"User-Agent":"Mozilla/5.0"})
            with urllib.request.urlopen(req, timeout=8) as r:
                ct = r.headers.get("Content-Type","")
                if "image" in ct or c.endswith(".ico"):
                    return c
        except Exception:
            continue
    return candidates[-1]  # 兜底 icon.horse

若网络受限无法访问，直接返回 https://icon.horse/icon/<域名> 并告知用户。 用户已显式提供 icon 时，优先用用户提供的值。

操作规范

1. 新增引擎（engine）

去重：先查 SELECT id,url FROM engine WHERE deleted=0 AND url='<url>'，已存在则告知用户并停止，不重复插入。

INSERT INTO engine
(id, status, title, description, icon, url, click, deleted, create_time, update_time, creator, updater, tenant_id)
VALUES
(UUID(), 0, '<title>', '<desc>', '<icon>', '<url>', 0, b'0', NOW(), NOW(), 'system', 'system', 0);

2. 新增站点（website）

• 先去重：SELECT id,url FROM website WHERE deleted=0 AND url='<url>'，存在则停止。
• 先校验 type_id：SELECT id FROM website_type WHERE id=<type_id> AND status=0 AND deleted=0，不存在则报错，让用户提供有效类型。

INSERT INTO website
(id, status, type_id, title, click, description, `order`, icon, url,
 create_time, update_time, creator, updater, deleted, tenant_id)
VALUES
(UUID(), 0, <type_id>, '<title>', 0, '<desc>', 0, '<icon>', '<url>',
 NOW(6), NOW(6), 'system', 'system', b'0', 0);

3. 新增站点类型（website_type）

去重：SELECT id,title FROM website_type WHERE deleted=0 AND title='<title>'，存在则停止。

INSERT INTO website_type
(id, status, title, icon, description, `order`, create_time, update_time, creator, updater, deleted, tenant_id)
VALUES
(NULL, 0, '<title>', '<icon>', '<desc>', 0, NOW(6), NOW(6), 'system', 'system', b'0', 0);

id 为自增，传 NULL 即可。icon 可让用户提供，或用默认图标。

4. 启用 / 禁用（三表通用）

语义：只改 status 字段，不动 deleted。

• 禁用 = status=1
• 启用 = status=0

按唯一标识定位（engine/website 用 id，website_type 可用 id 或 title）：

-- 禁用示例（engine）
UPDATE engine SET status=1, update_time=NOW(), updater='system' WHERE id='<id>';
-- 启用
UPDATE engine SET status=0, update_time=NOW(), updater='system' WHERE id='<id>';

操作前先 SELECT 确认目标存在并展示给用户确认；禁用后告知用户当前状态。

红线

• 去重：任何新增前先查重，命中即停止并告知。
• type_id 必填且有效：站点新增必须有合法 type_id。
• 写入前先 SELECT 确认，避免误操作。
• 任何批量/删除类操作前，向杨轩展示精确清单并确认。
• 审计字段自动生成，不依赖用户输入。