天工 Skywork 桌面版完整部署与实战指南 | 极客日志

PythonNode.jsAI

天工 Skywork 桌面版完整部署与实战指南

介绍天工 Skywork 桌面版在 Windows 环境下的部署流程及功能实战。涵盖硬件软件要求、源码拉取、依赖安装、API 密钥配置及启动方法。演示了文件整理、Office 文档生成、多模态创作及 Obsidian 同步等场景，并提供了 Skills 生态扩展、多模型切换、性能优化及常见问题排查方案。

云间运维发布于 2026/4/6更新于 2026/9/1277 浏览

前置准备

1.1 硬件要求

CPU：≥4 核（Intel i3/i5、AMD Ryzen 3/5 及以上）
内存：≥8G（推荐 16G，多任务无卡顿）
存储：SSD 剩余≥20G（含模型缓存 + 工具依赖）
网络：可正常联网（国内网络即可，已适配国内镜像）

1.2 软件要求

操作系统：Windows 10 21H2+/Windows 11（64 位，原生支持，无需 WSL2）
核心工具：Git≥2.40、Python 3.10~3.12、Node.js 18.x
依赖包：pywin32≥306、requests≥2.31.0、pillow≥10.2.0
可选凭证：Claude API-Key（https://console.anthropic.com/ 注册）、Gemini API-Key（https://ai.google.dev/ 注册）

1.3 国内镜像源配置

# 1. 配置 Python 清华源（管理员 PowerShell 执行）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 2. 配置 Git 国内加速（拉取源码用）
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"
# 3. 安装核心工具（一键安装 Git+Node.js）
winget install --id Git.Git -e
winget install --id OpenJS.NodeJS -e --version 18.20.2

核心部署

步骤 1：拉取开源源码

# 克隆天工 Skywork 桌面版中文开源仓库
git clone https://ghproxy.com/https://github.com/skywork-ai/Skywork-Desktop.git
cd Skywork-Desktop

步骤 2：安装依赖 + 初始化配置

# 安装 Python 依赖
pip install -r requirements.txt
# 安装前端依赖（Skills 生态核心）
npm install
# 初始化配置文件（自动生成 config.json，无需手动修改）
python scripts/init_config.py

步骤 3：配置模型密钥

# 方式 1：配置 Claude API（推荐，办公场景适配更佳）
python scripts/set_api_key.py --model claude --key "sk-your-claude-api-key"
# 方式 2：配置 Gemini 3 Pro API
python scripts/set_api_key.py --model gemini --key

相关免费在线工具

RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。在线工具，Mermaid 预览与可视化编辑在线工具，online
随机西班牙地址生成器
随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。在线工具，随机西班牙地址生成器在线工具，online
curl 转代码
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。在线工具，curl 转代码在线工具，online
Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

# 启动主服务（后台运行，无黑窗口）
python app.py --start-minimized
# 验证启动成功：浏览器访问 http://localhost:8088
# 出现登录界面，默认账号 admin，密码 skywork2026

整理 D:\办公文件 文件夹，按「文档/图片/视频/表格」分类，重命名格式为「日期 - 原文件名」，生成整理清单并保存到桌面

基于桌面「销售数据.csv」文件，生成 Excel 可视化报表，包含月度销售额柱状图 + 地区占比饼图，保存为「2026 年 Q1 销售报表.xlsx」

以「AI 代理工具发展趋势」为主题，生成 10 页 PPT，风格为科技简约，包含封面/核心功能/应用场景/未来展望，保存到桌面

汇总本周桌面「工作记录.txt」中的所有任务，按「已完成/进行中/待分配」分类，生成标准格式工作报告，自动添加页眉页脚和页码

生成一张「AI 办公场景」高清图片，要求：蓝色科技风、办公人士与 AI 交互、细节丰富，分辨率 1920×1080，保存为 PNG 格式

基于桌面「产品介绍.md」文件内容，生成 30 秒产品宣传短视频，背景为科技感动态特效，自动配字幕和背景音乐，保存为 MP4 格式

# 绑定 Obsidian 库路径
python scripts/set_obsidian_path.py --path "D:\Obsidian\我的知识库"

搜集近 7 天「AI 代理」相关热点资讯（中文），提取核心要点，生成 Obsidian 笔记，自动添加标签#AI 工具 #热点资讯，同步到知识库

# 安装飞书/钉钉集成 Skill（办公消息同步）
npm run skill install feishu-dingtalk-integration
# 安装 GitHub Trending 抓取 Skill（技术资讯同步）
npm run skill install github-trending-crawler
# 安装 Remotion 视频生成 Skill（长视频创作）
npm run skill install remotion-video-generator
# 安装 Slack/Notion 集成 Skill（跨平台协作）
npm run skill install slack-notion-connector

通过 GitHub Trending 抓取今日 Python 领域热门项目，提取 Top5 项目的名称/描述/Stars 数，同步到飞书工作群

切换模型为 Gemini 3 Pro，优先使用该模型处理后续多模态任务

# 降低显存占用（适合 8G 内存电脑）
python scripts/optimize_config.py --memory-limit 8g
# 提升启动速度（禁用非必要插件）
python scripts/optimize_config.py --disable-plugins "cloud-sync,auto-update"
# 调整推理并发数（默认 5，根据 CPU 核心数修改）
python scripts/optimize_config.py --max-concurrent 3

# 查找占用进程并终止
netstat -ano | findstr 8088
taskkill /f /pid 对应 PID（替换查询到的 PID）
# 重启服务
python app.py

# 以管理员身份运行 PowerShell，重新执行启动命令
python app.py --admin

# 重新配置 API-Key（替换为有效密钥）
python scripts/set_api_key.py --model claude --key "new-valid-api-key"

# 配置 npm 国内镜像
npm config set registry https://registry.npmmirror.com
# 重新安装 Skill
npm run skill install 目标 Skill 名称

# 添加到 Windows 开机自启
python scripts/set_autostart.py --enable true

# 备份配置和技能数据
python scripts/backup_data.py --path "D:\Skywork 备份"
# 恢复数据（更换电脑/重装系统后）
python scripts/restore_data.py --path "D:\Skywork 备份"

# 创建自定义 Skill 模板（PowerShell 执行）
npm run skill create my-custom-skill
# 编辑技能逻辑：修改 skills/my-custom-skill/index.js
# 安装并测试
npm run skill install ./skills/my-custom-skill

天工 Skywork 桌面版完整部署与实战指南

前置准备

1.1 硬件要求

1.2 软件要求

1.3 国内镜像源配置

核心部署

步骤 1：拉取开源源码

步骤 2：安装依赖 + 初始化配置

步骤 3：配置模型密钥

更多推荐文章

相关免费在线工具

步骤 4：启动天工 Skywork 桌面版

核心功能实战

场景 1：本地文件全自动整理

触发指令

核心效果

场景 2：Office 三件套一键生成

触发指令 1（生成 Excel 数据报表）

触发指令 2（生成 PPT 演示文稿）

触发指令 3（生成 Word 工作报告）

场景 3：多模态内容创作

触发指令 1（生成高清图片）

触发指令 2（生成短视频）

场景 4：Obsidian 笔记同步

配置命令

触发指令

100+ Skills 生态使用

步骤 1：安装热门 Skills

步骤 2：使用已安装 Skill

多模型切换与性能优化

实时切换模型

性能优化配置

常见问题排查

启动失败，提示'端口 8088 被占用'

无法访问本地文件，提示'权限不足'

模型调用报错'API key invalid'

Skills 安装失败，提示'网络超时'

进阶优化

开机自启配置

数据备份与恢复

自定义 Skills 开发

版本规划

更多推荐文章

相关免费在线工具