Skills Manager — OpenCode 安装与使用指南

关注

原创最新推荐文章于 2026-11-03 10:58:34 发布 2k 阅读 AI 写同款· GEO 优化 ›

Skills Manager：开源AI技能管理工具，让AI助手告别重复Prompt输入还在为每次使用 AI 助手时，重复输入那些冗长的“角色设定”和“技能指令”而烦恼吗？你是否也收藏了一堆 ChatGPT、Claude 或 DeepSeek 的“神级 Prompt”，但每次切换对话或新建会话时，都得手动复制粘贴，效率低下且容易出错？如果你是一名开发者，尤其是前端开发者，可能还想过：“能不能让 AI 自己来创建和管理这些技能？” 这个想法现在已经成为现实。今天要介绍的 Skills Manager ，正是解决这一痛点的明星开源项目。它在 GitHub 上已收获超过 2.4K 星，核心功能就是阅读详情

Skills Manager — OpenCode 安装与使用指南

Skills Manager 是一个桌面应用，用于统一管理所有 AI 编码工具（包括 OpenCode）的 Skills。
最新版 v1.11.1（2026-03-28），基于 Tauri 2 + React 19 + Rust 构建。

项目简介
功能特性
系统要求
安装方式
- 4.1 下载预编译版本（推荐）
- [4.2 WSL/Linux 无 sudo 权限安装（AppImage 便携版）](#42-wsllinux-无-sudo-权限安装 appimage-便携版)
- 4.3 从源码构建
OpenCode Skills 目录说明
配置 OpenCode 支持
使用指南
常见问题
版本历史速览
完整安装验证清单
快速参考卡片
[附录 A：完整安装脚本（WSL2 无 sudo）](#附录 a 完整安装脚本 wsl2-无-sudo)
[附录 B：故障排查](#附录 b 故障排查)

1. 项目简介

Skills Manager 将分散在各 AI 编码工具中的 Skills 统一收纳到 ~/.skills-manager 中央库，支持一键同步到 OpenCode、Cursor、Claude Code 等 15+ 工具。

信息	详情
仓库	xingkongliang/skills-manager
最新版本	v1.11.1
许可证	MIT
Stars	522+
支持工具	Cursor · Claude Code · Codex · OpenCode · Amp · Kilo Code · Roo Code · Goose · Gemini CLI · GitHub Copilot · Windsurf · TRAE IDE · Antigravity · Clawdbot · Droid

2. 功能特性

功能	说明
统一技能库	从 Git 仓库、本地目录、`.zip` / `.skill` 文件或 skills.sh 市场安装，统一存放在 `~/.skills-manager`
多工具同步	一键同步到 OpenCode 等 15+ 工具，支持软链接和复制两种模式
项目 Skills	管理任意项目的 `.claude/skills/` 目录，支持与中央库双向同步
场景管理	将技能分组为场景（Scenario），按场景配置 Agent 开关
批量操作	多选后批量启用/禁用、导出或删除
技能标签	为技能添加标签并按标签筛选
更新检查	Git 类技能检查远端更新；本地技能支持重新导入
文档预览	应用内直接查看 `SKILL.md` / `README.md`
自定义工具	添加自定义 Agent 并指定 Skills 目录
Git 备份	版本控制 + 多机同步，自动快照标签

3. 系统要求

平台	要求
macOS	macOS 10.15+
Linux	主流发行版（Ubuntu/Debian/Fedora/Arch 等）
Windows	Windows 10+

从源码构建需要：

Node.js 18+
Rust 工具链
Tauri 2 前置依赖

4. 安装方式

4.1 下载预编译版本（推荐）

前往 GitHub Releases 下载对应平台的安装包：

平台	文件	大小
Linux (Debian/Ubuntu)	`skills-manager_1.11.1_amd64.deb`	~13 MB
Linux (Fedora/RHEL)	`skills-manager-1.11.1-1.x86_64.rpm`	~13 MB
Linux (通用)	`skills-manager_1.11.1_amd64.AppImage`	~86 MB
macOS (Apple Silicon)	`skills-manager_1.11.1_aarch64.dmg`	~13 MB
Windows	`skills-manager_1.11.1_x64-setup.exe`	~6.4 MB

4.2 WSL/Linux 无 sudo 权限安装（AppImage 便携版）

适用场景： WSL2、无 root 权限、Docker 容器等环境

步骤 1：下载 AppImage

# 下载 AppImage（约 86MB）
curl -L -o ~/tools/skills-manager_1.11.1_amd64.AppImage \
  https://github.com/xingkongliang/skills-manager/releases/download/v1.11.1/skills-manager_1.11.1_amd64.AppImage

# 或使用 wget
wget -O ~/tools/skills-manager_1.11.1_amd64.AppImage \
  https://github.com/xingkongliang/skills-manager/releases/download/v1.11.1/skills-manager_1.11.1_amd64.AppImage

步骤 2：赋予执行权限

chmod +x ~/tools/skills-manager_1.11.1_amd64.AppImage

步骤 3：启动应用

# 有图形界面时
/tmp/skills-manager_1.11.1_amd64.AppImage

# 无图形界面时（WSL2 默认），应用会创建目录结构后退出
# 目录已创建在 ~/.skills-manager/
/tmp/skills-manager_1.11.1_amd64.AppImage 2>&1 | head -5

预期输出：

libEGL warning: DRI3 error: Could not get DRI3 device
...

这是正常的，表示应用在 WSL 中无法启动 GUI，但目录结构已创建。

步骤 4：手动配置 OpenCode 同步

# 检查中央库目录是否创建
ls -la ~/.skills-manager/

# 创建 OpenCode skills 目录的软链接
rm -rf ~/.config/opencode/skills
ln -s ~/.skills-manager/skills ~/.config/opencode/skills

# 验证链接
ls -la ~/.config/opencode/skills

步骤 5：验证安装

# 创建测试技能
mkdir -p ~/.skills-manager/skills/test-skill
echo "# Test Skill" > ~/.skills-manager/skills/test-skill/SKILL.md

# 验证 OpenCode 可访问
cat ~/.config/opencode/skills/test-skill/SKILL.md

# 清理测试
rm -rf ~/.skills-manager/skills/test-skill

验证成功标志：

~/.skills-manager/ 目录存在
~/.skills-manager/skills-manager.db 数据库文件存在
~/.config/opencode/skills 是指向 ~/.skills-manager/skills 的软链接
在 ~/.skills-manager/skills/ 创建的技能可通过 ~/.config/opencode/skills/ 访问

4.3 从源码构建

# 1. 克隆仓库
git clone https://github.com/xingkongliang/skills-manager.git
cd skills-manager

# 2. 安装依赖
npm install

# 3. 开发模式（热重载）
npm run tauri:dev

# 4. 生产构建
npm run tauri:build

构建产物位于 src-tauri/target/release/bundle/ 目录下。

5. OpenCode Skills 目录说明

OpenCode 读取 Skills 的目录结构如下：

# 全局 Skills（所有项目可用）
~/.config/opencode/skills/
├── skill-name-1/
│   └── SKILL.md
├── skill-name-2/
│   └── SKILL.md
└── ...

# 项目级 Skills（仅当前项目可用）
<project-root>/.opencode/skills/
├── project-skill/
│   └── SKILL.md
└── ...

# 或兼容 Claude 格式
<project-root>/.claude/skills/
├── project-skill/
│   └── SKILL.md
└── ...

Skills Manager 的中央库路径：

~/.skills-manager/
├── skills/          # 所有已安装的 Skills
│   ├── skill-a/
│   │   └── SKILL.md
│   └── skill-b/
│       └── SKILL.md
├── skills-manager.db  # SQLite 元数据（不纳入 Git）
└── .git/             # 可选 Git 备份

6. 配置 OpenCode 支持

Skills Manager 原生支持 OpenCode，无需额外插件。

6.1 基本配置

打开 Skills Manager 应用
进入 设置（Settings）
在工具列表中找到 OpenCode
确认 OpenCode 的 Skills 目录路径为 ~/.config/opencode/skills/
如需自定义路径，点击路径进行编辑或使用文件夹选择器

6.2 自定义 Skills 目录

如果需要将 OpenCode 的 Skills 放在非默认位置：

设置 → 找到 OpenCode
点击路径字段进行内联编辑
或使用原生文件夹选择器指定新路径
保存后，同步操作将指向新目录

6.3 同步模式选择

Skills Manager 提供两种同步模式：

模式	说明	适用场景
软链接（Symlink）	在目标目录创建指向 `~/.skills-manager` 的符号链接	多工具共享同一份 Skill 文件，节省磁盘空间
复制（Copy）	将 Skill 文件完整复制到目标目录	需要离线使用或目标工具不支持软链接

推荐： 优先使用软链接模式，便于集中管理。

7. 使用指南

7.1 安装 Skills

Skills Manager 支持多种 Skill 来源：

从市场安装

打开 Skills Manager → Marketplace
搜索所需 Skill
点击 Install 安装到中央库
安装后自动出现在 My Skills 列表

从 Git 仓库安装

打开 My Skills → Install
选择 Git Repository
输入仓库 URL（如 https://github.com/owner/skill-name.git）
点击安装，支持安装预览

从本地目录安装

选择 Local Folder
选择包含 SKILL.md 的目录
支持批量导入：选择一个包含多个 Skill 子目录的文件夹

从文件安装

支持 .zip 和 .skill 格式
拖拽文件到应用窗口或点击导入

7.2 同步 Skills 到 OpenCode

安装 Skill 后，需要将其同步到 OpenCode：

打开 My Skills
选择需要同步的 Skill（可多选）
点击 Sync 按钮
选择目标工具为 OpenCode
选择同步模式（软链接 / 复制）
同步完成后，Skill 文件将出现在 ~/.config/opencode/skills/

一键全量同步

在设置中启用 OpenCode 后，点击全局同步按钮即可将所有已启用的 Skill 同步到 OpenCode。

7.3 项目 Skills 管理

项目级 Skill 仅对特定项目生效：

打开 Skills Manager → Projects
添加项目目录路径
查看项目内 .claude/skills/ 或 .opencode/skills/ 中的 Skills
支持从中央库导入 Skill 到项目
支持将项目 Skill 导出到中央库
支持拖拽排序项目 Skill 加载顺序

7.4 场景管理

场景（Scenario）用于在不同工作模式下快速切换 Skill 集合：

打开 Scenarios 面板
创建新场景（如 “Backend Dev”、“Code Review”、“Debugging”）
为每个场景勾选需要启用的 Skills
配置场景内的 Agent 开关（细粒度控制哪些 Skill 对哪些 Agent 可见）
通过侧边栏或系统托盘菜单快速切换场景

默认场景： 当没有任何场景时，系统自动创建 Default 场景。

7.5 批量操作

在 My Skills 或 Project Skills 中进入多选模式
勾选需要操作的 Skills
支持批量操作：
- 启用/禁用 — 控制 Skill 是否参与同步
- 导出 — 导出为 .zip 文件
- 删除 — 从中央库移除
- 同步 — 一键同步到所有已配置工具

7.6 Git 备份与多机同步

将 Skill 库纳入 Git 版本控制：

快速配置

创建一个 私有 Git 仓库（推荐 GitHub/GitLab）
打开 设置 → Git 同步配置，保存远程仓库地址
打开 My Skills 页面
选择以下一种方式：
- 已有远程仓库： 点击 开始备份，从配置的远程克隆
- 首次本地初始化： 点击 开始备份 初始化本地仓库，再使用 同步到 Git
点击顶部工具栏的 同步到 Git

同步行为

自动处理 pull → commit → push 流程
每次成功同步自动创建快照版本标签
可在 版本历史 中查看并恢复任意快照

认证方式

类型	配置
SSH (`git@github.com:...`)	需在本机配置 SSH Key 并添加到 GitHub
HTTPS (`https://github.com/...`)	推送通常需要 Personal Access Token (PAT)

注意： SQLite 数据库（skills-manager.db）不纳入 Git 管理，其元数据可通过扫描技能文件重建。

7.7 自定义 Agent 配置

如果需要管理 Skills Manager 未内置的工具：

打开设置
滚动到 自定义 Agent 部分
点击 添加自定义 Agent
填写：
- Agent 名称（如 “My Custom Tool”）
- Skills 目录路径
保存后即可像内置工具一样同步 Skills

也可以为任何内置 Agent 覆盖默认的 Skills 目录路径。

7.8 无 GUI 使用方式（命令行）

在 WSL2、服务器或无图形界面环境中，可以通过命令行直接管理 skills：

目录结构

~/.skills-manager/
├── skills/              # 技能文件目录（所有技能存放在此）
│   ├── skill-name-1/
│   │   └── SKILL.md
│   └── skill-name-2/
│       └── SKILL.md
├── scenarios/           # 场景配置（JSON 文件）
├── cache/               # 缓存文件
├── logs/                # 日志文件
└── skills-manager.db    # SQLite 数据库（元数据）

命令行操作

# ===== 技能管理 =====

# 从 Git 仓库安装
cd ~/.skills-manager/skills
git clone https://github.com/owner/skill-name.git

# 手动创建技能
mkdir -p ~/.skills-manager/skills/my-skill
cat > ~/.skills-manager/skills/my-skill/SKILL.md << 'EOF'
# My Skill Name

## Description
Brief description of what this skill does.

## When to Use
- Scenario 1
- Scenario 2

## Instructions
Step-by-step instructions...
EOF

# 查看已安装的技能
ls -1 ~/.skills-manager/skills/

# 查看技能内容
cat ~/.skills-manager/skills/skill-name/SKILL.md

# 删除技能
rm -rf ~/.skills-manager/skills/skill-name

# 更新 Git 技能
cd ~/.skills-manager/skills/skill-name
git pull origin main

# ===== 场景管理 =====

# 查看场景配置
ls -la ~/.skills-manager/scenarios/

# 创建场景配置
cat > ~/.skills-manager/scenarios/my-scenario.json << 'EOF'
{
  "name": "My Scenario",
  "enabled_skills": ["skill-1", "skill-2"],
  "disabled_skills": []
}
EOF

# ===== 同步验证 =====

# 验证 OpenCode 可访问技能
ls -la ~/.config/opencode/skills/

# 创建测试技能验证同步
mkdir -p ~/.skills-manager/skills/test-sync
echo "# Test" > ~/.skills-manager/skills/test-sync/SKILL.md
test -f ~/.config/opencode/skills/test-sync/SKILL.md && echo "同步正常" || echo "同步失败"
rm -rf ~/.skills-manager/skills/test-sync

8. 常见问题

Q: OpenCode 无法识别同步后的 Skill？

确认 Skill 目录中包含 SKILL.md 文件
确认目录路径正确：~/.config/opencode/skills/<skill-name>/SKILL.md
重启 OpenCode 使其重新加载 Skills
检查同步模式：软链接模式下确保链接未断裂

Q: 软链接和复制选哪个？

软链接：推荐。所有工具共享同一份文件，修改一处全局生效。
复制：适合需要独立维护各工具 Skill 副本的场景。

Q: 如何更新已安装的 Git Skill？

在 My Skills 中找到对应 Skill，点击 Check Update。如有更新，点击 Update 即可。

Q: 多机同步会冲突吗？

使用 Git 备份时，每次同步前先 pull 远程变更，冲突时按 Git 标准流程解决。推荐每台机器使用独立的 Skills Manager 实例 + 共享的 Git 远程仓库。

Q: macOS 提示"应用已损坏"？

xattr -cr /Applications/skills-manager.app

Q: 支持代理吗？

支持。在设置中配置代理后，Git clone 和网络请求将通过代理进行。

Q: WSL2 中如何安装和使用？

WSL2 默认无图形界面，但可以使用 AppImage 便携版：

下载 AppImage（无需 sudo）
运行一次 创建目录结构
手动创建软链接 同步到 OpenCode
通过命令行管理 skills（见下方"无 GUI 使用方式"）

如需完整 GUI 体验，需要安装 WSLg 或 XServer。

Q: 如何验证安装是否成功？

运行以下验证脚本：

#!/bin/bash
# 验证 skills-manager 安装

echo "=== 验证 skills-manager 安装 ==="

# 1. 检查中央库目录
if [ -d ~/.skills-manager ]; then
  echo "✓ 中央库目录存在：~/.skills-manager/"
else
  echo "✗ 中央库目录不存在"
  exit 1
fi

# 2. 检查数据库文件
if [ -f ~/.skills-manager/skills-manager.db ]; then
  echo "✓ 数据库文件存在"
else
  echo "✗ 数据库文件不存在"
  exit 1
fi

# 3. 检查 OpenCode 软链接
if [ -L ~/.config/opencode/skills ]; then
  target=$(readlink -f ~/.config/opencode/skills)
  if [ "$target" = "$HOME/.skills-manager/skills" ]; then
    echo "✓ 软链接配置正确"
  else
    echo "✗ 软链接指向错误目标：$target"
    exit 1
  fi
else
  echo "✗ 软链接不存在"
  exit 1
fi

# 4. 测试技能同步
mkdir -p ~/.skills-manager/skills/verify-test
echo "# Verify" > ~/.skills-manager/skills/verify-test/SKILL.md
if [ -f ~/.config/opencode/skills/verify-test/SKILL.md ]; then
  echo "✓ 技能同步测试通过"
else
  echo "✗ 技能同步测试失败"
  exit 1
fi
rm -rf ~/.skills-manager/skills/verify-test

echo ""
echo "=== 所有验证通过！安装成功 ==="

Q: 没有图形界面如何使用？

无 GUI 使用方式（命令行管理 skills）：

# 1. 从 Git 仓库安装 skill
cd ~/.skills-manager/skills
git clone https://github.com/owner/skill-name.git

# 2. 手动创建 skill
mkdir -p ~/.skills-manager/skills/my-skill
cat > ~/.skills-manager/skills/my-skill/SKILL.md << 'EOF'
# My Skill Name

## Description
Skill description here.

## Instructions
Usage instructions here.
EOF

# 3. 查看已安装的 skills
ls -la ~/.skills-manager/skills/

# 4. 删除 skill
rm -rf ~/.skills-manager/skills/skill-name

# 5. 更新 Git skill
cd ~/.skills-manager/skills/skill-name
git pull

10. 完整安装验证清单

安装后验证步骤

# 步骤 1: 检查 AppImage 文件
ls -lh /tmp/skills-manager_1.11.1_amd64.AppImage
# 预期：86MB, 可执行文件

# 步骤 2: 检查中央库目录
ls -la ~/.skills-manager/
# 预期：包含 skills/, scenarios/, cache/, logs/, skills-manager.db

# 步骤 3: 检查软链接
readlink -f ~/.config/opencode/skills
# 预期：/home/<user>/.skills-manager/skills

# 步骤 4: 创建测试技能
mkdir -p ~/.skills-manager/skills/test-verification
echo -e "# Test\nVerification test" > ~/.skills-manager/skills/test-verification/SKILL.md

# 步骤 5: 验证 OpenCode 可访问
cat ~/.config/opencode/skills/test-verification/SKILL.md
# 预期：显示技能内容

# 步骤 6: 清理测试
rm -rf ~/.skills-manager/skills/test-verification

验证成功标准

检查项	预期结果
AppImage 文件	86MB, ELF 可执行文件
中央库目录	`~/.skills-manager/` 包含 5 个子目录 + db 文件
数据库文件	`skills-manager.db` 存在（约 4KB）
软链接	`~/.config/opencode/skills` → `~/.skills-manager/skills`
技能同步	在中央库创建的 skill 立即可在 OpenCode 目录访问

快速参考卡片

# 中央库路径
~/.skills-manager/skills/

# OpenCode 全局 Skills 路径
~/.config/opencode/skills/

# OpenCode 项目 Skills 路径
<project>/.opencode/skills/
<project>/.claude/skills/

# 常用操作
1. 安装 Skill → My Skills → Install
2. 同步到 OpenCode → 勾选 Skill → Sync → 选择 OpenCode
3. 切换场景 → 侧边栏/托盘菜单 → 选择场景
4. Git 备份 → My Skills → 同步到 Git
5. 检查更新 → My Skills → 启动时自动检查

# 命令行操作（无 GUI）
6. 从 Git 安装 → cd ~/.skills-manager/skills && git clone <url>
7. 手动创建 → mkdir -p ~/.skills-manager/skills/<name> && 创建 SKILL.md
8. 查看已安装 → ls ~/.skills-manager/skills/
9. 删除技能 → rm -rf ~/.skills-manager/skills/<name>
10. 更新 Git 技能 → cd <skill-dir> && git pull

更多信息请访问 skills-manager GitHub 仓库和 skills.sh 市场。

9. 版本历史速览

版本	日期	重要更新
v1.11.1	2026-03-28	当前最新版本，Tauri 2 + React 19
v1.10.x	2026-02	添加场景管理功能
v1.9.x	2026-01	支持 OpenCode 原生同步
v1.8.x	2025-12	添加 Git 备份功能

附录 A：完整安装脚本（WSL2 无 sudo）

#!/bin/bash
# skills-manager 安装脚本 - WSL2 无 sudo 版本
# 用法：bash install-skills-manager.sh

set -e

echo "=== Skills Manager 安装脚本 (WSL2 无 sudo) ==="

# 1. 下载 AppImage
echo "[1/5] 下载 AppImage..."
curl -L -o /tmp/skills-manager.AppImage \
  https://github.com/xingkongliang/skills-manager/releases/download/v1.11.1/skills-manager_1.11.1_amd64.AppImage

# 2. 赋予执行权限
echo "[2/5] 设置执行权限..."
chmod +x /tmp/skills-manager.AppImage

# 3. 运行一次创建目录结构
echo "[3/5] 初始化目录结构..."
/tmp/skills-manager.AppImage 2>&1 | head -3 || true

# 4. 验证目录创建
echo "[4/5] 验证目录结构..."
if [ ! -d ~/.skills-manager ]; then
  echo "错误：目录创建失败"
  exit 1
fi

# 5. 配置 OpenCode 软链接
echo "[5/5] 配置 OpenCode 软链接..."
mkdir -p ~/.config/opencode
rm -rf ~/.config/opencode/skills
ln -s ~/.skills-manager/skills ~/.config/opencode/skills

# 验证
echo ""
echo "=== 安装完成 ==="
echo ""
echo "目录结构:"
ls -la ~/.skills-manager/ | head -10
echo ""
echo "软链接:"
ls -la ~/.config/opencode/skills
echo ""
echo "使用方法:"
echo "  GUI 启动：/tmp/skills-manager.AppImage"
echo "  命令行：cd ~/.skills-manager/skills && git clone <skill-repo>"

附录 B：故障排查

问题 1：AppImage 无法启动

# 检查文件完整性
file /tmp/skills-manager.AppImage
# 预期：ELF 64-bit LSB pie executable, x86-64

# 检查执行权限
ls -l /tmp/skills-manager.AppImage
# 预期：-rwxr-xr-x

# 尝试重新下载
rm /tmp/skills-manager.AppImage
curl -L -o /tmp/skills-manager.AppImage <url>

问题 2：软链接创建失败

# 检查目标目录是否存在
ls -la ~/.skills-manager/skills/

# 检查 OpenCode 目录
ls -la ~/.config/opencode/

# 重新创建软链接
rm -rf ~/.config/opencode/skills
ln -s ~/.skills-manager/skills ~/.config/opencode/skills

# 验证
readlink -f ~/.config/opencode/skills

问题 3：技能不同步

# 检查软链接是否断裂
ls -la ~/.config/opencode/skills/

# 如果显示红色或"找不到文件"，重新创建链接
rm -rf ~/.config/opencode/skills
ln -s ~/.skills-manager/skills ~/.config/opencode/skills

# 验证技能文件
cat ~/.skills-manager/skills/<skill>/SKILL.md
cat ~/.config/opencode/skills/<skill>/SKILL.md

问题 4：数据库锁定

# 关闭所有运行的 skills-manager 进程
pkill -f skills-manager

# 删除数据库锁文件
rm -f ~/.skills-manager/skills-manager.db-shm
rm -f ~/.skills-manager/skills-manager.db-wal

# 重启应用
/tmp/skills-manager.AppImage

问题 5：AppImage 启动时报错 “libGLESv2.so.2: cannot open shared object file”

症状：

libEGL warning: DRI3 error: Could not get DRI3 device
libEGL warning: Ensure your X server supports DRI3 to get accelerated rendering
Couldn't open libGLESv2.so.2: libGLESv2.so.2: cannot open shared object file: No such file or directory

原因： WSL2 缺少 OpenGL ES 2.0 图形库支持。

解决方案（需要 sudo 权限）：

# 更新包索引
sudo apt-get update

# 安装 GLES2 图形库
sudo apt-get install -y libgles2 libegl-mesa0 libglx-mesa0 libgbm1

# 验证安装
ldconfig -p | grep libGLES

如果没有 sudo 权限：

可以跳过 GUI，直接使用命令行方式管理 skills（见 7.8 节）
目录结构仍会正常创建在 ~/.skills-manager/

问题 6：GUI 界面中文显示乱码/方框

症状： 应用界面能打开，但中文文字显示为方框或乱码。

原因： WSL2 未安装中文字体。

解决方案：

# 安装 Noto CJK 和文泉驿字体
sudo apt-get update
sudo apt-get install -y fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei

# 刷新字体缓存
fc-cache -fv

# 验证中文字体已安装
fc-list :lang=zh | wc -l
# 预期：显示已安装的中文字体数量（应 > 0）

安装完成后：

完全关闭 skills-manager（包括后台进程）
重新启动应用
中文应正常显示

验证字体安装：

# 查看已安装的中文字体
fc-list :lang=zh

# 示例输出：
# /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc: WenQuanYi Zen Hei:style=Regular
# /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc: Noto Sans CJK SC:style=Regular

问题 7：WSL2 完整 GUI 环境配置

如果需要在 WSL2 中获得完整的 GUI 体验，需要：

Windows 端要求：
- Windows 10 版本 19044+ 或 Windows 11
- 安装 WSLg（WSL 图形支持）
检查 WSLg 是否可用：

# 检查 DISPLAY 环境变量
echo $DISPLAY
# 预期：:0 或类似值

# 检查 WAYLAND_DISPLAY
echo $WAYLAND_DISPLAY
# 预期：wayland-0 或类似值

如果环境变量为空：
- 升级 WSL：wsl --update（在 Windows PowerShell 中运行）
- 重启 WSL：wsl --shutdown 然后重新进入
- 或考虑使用 XServer 方案（如 VcXsrv、Xming）

收录于

人工智能

标签

#AI工具

Skills Manager：开源AI技能管理工具，告别手动复制粘贴Prompt 还在为每次使用 AI 助手时，重复输入冗长的“角色设定”和“技能指令”而烦恼吗？你是否也收藏了一堆来自 GitHub、Reddit 或技术社区的“神级 Prompt”，却苦于无法高效管理和调用？今天要介绍的这款开源神器—— Skills Manager ，正是为了解决这一痛点而生。它在 GitHub 上已收获超过 2.4K 星，核心功能就是让你像管理代码库一样，管理你的 AI 技能（Skills），实现一键调用，彻底告别手动复制粘贴的繁琐。无论是前端开发、数据分析，还是创意写作，你都可以将成熟的 Prom 阅读详情

Skills Manager — OpenCode 安装与使用指南

Skills Manager — OpenCode 安装与使用指南

目录

1. 项目简介

2. 功能特性

3. 系统要求

4. 安装方式

4.1 下载预编译版本（推荐）

4.2 WSL/Linux 无 sudo 权限安装（AppImage 便携版）

步骤 1：下载 AppImage

步骤 2：赋予执行权限

步骤 3：启动应用

步骤 4：手动配置 OpenCode 同步

步骤 5：验证安装

4.3 从源码构建

5. OpenCode Skills 目录说明

6. 配置 OpenCode 支持

6.1 基本配置

6.2 自定义 Skills 目录

6.3 同步模式选择

7. 使用指南

7.1 安装 Skills

从市场安装

从 Git 仓库安装

从本地目录安装

从文件安装

7.2 同步 Skills 到 OpenCode

一键全量同步

7.3 项目 Skills 管理

7.4 场景管理

7.5 批量操作

7.6 Git 备份与多机同步

快速配置

同步行为

认证方式

7.7 自定义 Agent 配置

7.8 无 GUI 使用方式（命令行）

目录结构

命令行操作

8. 常见问题

Q: OpenCode 无法识别同步后的 Skill？

Q: 软链接和复制选哪个？

Q: 如何更新已安装的 Git Skill？

Q: 多机同步会冲突吗？

Q: macOS 提示"应用已损坏"？

Q: 支持代理吗？

Q: WSL2 中如何安装和使用？

Q: 如何验证安装是否成功？

Q: 没有图形界面如何使用？

10. 完整安装验证清单

安装后验证步骤

验证成功标准

快速参考卡片

9. 版本历史速览

附录 A：完整安装脚本（WSL2 无 sudo）

附录 B：故障排查

问题 1：AppImage 无法启动

问题 2：软链接创建失败

问题 3：技能不同步

问题 4：数据库锁定

问题 5：AppImage 启动时报错 “libGLESv2.so.2: cannot open shared object file”

问题 6：GUI 界面中文显示乱码/方框

问题 7：WSL2 完整 GUI 环境配置

相关推荐