跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonNode.jsAI

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

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

云间运维发布于 2026/4/6更新于 2026/5/2218 浏览
天工 Skywork 桌面版完整部署与实战指南

前置准备

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
"your-gemini-api-key"

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

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

核心功能实战

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

触发指令
整理 D:\办公文件 文件夹，按「文档/图片/视频/表格」分类，重命名格式为「日期 - 原文件名」，生成整理清单并保存到桌面
核心效果
  • 自动扫描指定目录，支持 PDF/Word/Excel/PNG/MP4 等 20 + 格式
  • 智能分类创建子文件夹，自动去重重复文件
  • 生成 Markdown 格式整理清单，包含文件路径、大小、修改时间

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

触发指令 1（生成 Excel 数据报表）
基于桌面「销售数据.csv」文件，生成 Excel 可视化报表，包含月度销售额柱状图 + 地区占比饼图，保存为「2026 年 Q1 销售报表.xlsx」
触发指令 2（生成 PPT 演示文稿）
以「AI 代理工具发展趋势」为主题，生成 10 页 PPT，风格为科技简约，包含封面/核心功能/应用场景/未来展望，保存到桌面
触发指令 3（生成 Word 工作报告）
汇总本周桌面「工作记录.txt」中的所有任务，按「已完成/进行中/待分配」分类，生成标准格式工作报告，自动添加页眉页脚和页码

场景 3：多模态内容创作

触发指令 1（生成高清图片）
生成一张「AI 办公场景」高清图片，要求：蓝色科技风、办公人士与 AI 交互、细节丰富，分辨率 1920×1080，保存为 PNG 格式
触发指令 2（生成短视频）
基于桌面「产品介绍.md」文件内容，生成 30 秒产品宣传短视频，背景为科技感动态特效，自动配字幕和背景音乐，保存为 MP4 格式

场景 4：Obsidian 笔记同步

配置命令
# 绑定 Obsidian 库路径
python scripts/set_obsidian_path.py --path "D:\Obsidian\我的知识库"
触发指令
搜集近 7 天「AI 代理」相关热点资讯（中文），提取核心要点，生成 Obsidian 笔记，自动添加标签#AI 工具 #热点资讯，同步到知识库

100+ Skills 生态使用

步骤 1：安装热门 Skills

# 安装飞书/钉钉集成 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

步骤 2：使用已安装 Skill

通过 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

常见问题排查

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

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

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

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

模型调用报错'API key invalid'

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

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

# 配置 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 备份"

自定义 Skills 开发

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

版本规划

  • 计划支持微信/企业微信集成、本地大模型部署（无需 API-Key）、更多行业专属 Skills（教育/医疗/电商）

目录

  1. 前置准备
  2. 1.1 硬件要求
  3. 1.2 软件要求
  4. 1.3 国内镜像源配置
  5. 1. 配置 Python 清华源（管理员 PowerShell 执行）
  6. 2. 配置 Git 国内加速（拉取源码用）
  7. 3. 安装核心工具（一键安装 Git+Node.js）
  8. 核心部署
  9. 步骤 1：拉取开源源码
  10. 克隆天工 Skywork 桌面版中文开源仓库
  11. 步骤 2：安装依赖 + 初始化配置
  12. 安装 Python 依赖
  13. 安装前端依赖（Skills 生态核心）
  14. 初始化配置文件（自动生成 config.json，无需手动修改）
  15. 步骤 3：配置模型密钥
  16. 方式 1：配置 Claude API（推荐，办公场景适配更佳）
  17. 方式 2：配置 Gemini 3 Pro API
  18. 步骤 4：启动天工 Skywork 桌面版
  19. 启动主服务（后台运行，无黑窗口）
  20. 验证启动成功：浏览器访问 http://localhost:8088
  21. 出现登录界面，默认账号 admin，密码 skywork2026
  22. 核心功能实战
  23. 场景 1：本地文件全自动整理
  24. 触发指令
  25. 核心效果
  26. 场景 2：Office 三件套一键生成
  27. 触发指令 1（生成 Excel 数据报表）
  28. 触发指令 2（生成 PPT 演示文稿）
  29. 触发指令 3（生成 Word 工作报告）
  30. 场景 3：多模态内容创作
  31. 触发指令 1（生成高清图片）
  32. 触发指令 2（生成短视频）
  33. 场景 4：Obsidian 笔记同步
  34. 配置命令
  35. 绑定 Obsidian 库路径
  36. 触发指令
  37. 100+ Skills 生态使用
  38. 步骤 1：安装热门 Skills
  39. 安装飞书/钉钉集成 Skill（办公消息同步）
  40. 安装 GitHub Trending 抓取 Skill（技术资讯同步）
  41. 安装 Remotion 视频生成 Skill（长视频创作）
  42. 安装 Slack/Notion 集成 Skill（跨平台协作）
  43. 步骤 2：使用已安装 Skill
  44. 多模型切换与性能优化
  45. 实时切换模型
  46. 性能优化配置
  47. 降低显存占用（适合 8G 内存电脑）
  48. 提升启动速度（禁用非必要插件）
  49. 调整推理并发数（默认 5，根据 CPU 核心数修改）
  50. 常见问题排查
  51. 启动失败，提示“端口 8088 被占用”
  52. 查找占用进程并终止
  53. 重启服务
  54. 无法访问本地文件，提示“权限不足”
  55. 以管理员身份运行 PowerShell，重新执行启动命令
  56. 模型调用报错“API key invalid”
  57. 重新配置 API-Key（替换为有效密钥）
  58. Skills 安装失败，提示“网络超时”
  59. 配置 npm 国内镜像
  60. 重新安装 Skill
  61. 进阶优化
  62. 开机自启配置
  63. 添加到 Windows 开机自启
  64. 数据备份与恢复
  65. 备份配置和技能数据
  66. 恢复数据（更换电脑/重装系统后）
  67. 自定义 Skills 开发
  68. 创建自定义 Skill 模板（PowerShell 执行）
  69. 编辑技能逻辑：修改 skills/my-custom-skill/index.js
  70. 安装并测试
  71. 版本规划
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • OpenCode、OpenClaw 与 Ollama 安装配置指南
  • Spring Boot 定时任务与调度系统
  • 基于Python+Requests+Allure搭建接口自动化框架
  • Java 哈希数据结构与经典用法
  • Ubuntu 24.04.3 LTS 与 RTX 5090 显卡驱动安装指南
  • 论文解读：Attention Is All You Need 与 Transformer 架构详解
  • AI 大模型学习路线：从理论基础到工程实践指南
  • 绿联 NAS 配置 WebDAV 公网访问并使用 RaiDrive 挂载本地
  • 网页抓取（Web Scraping）技术指南：从原理到实战
  • AI 大模型的本质：基于大数据的拟合
  • Python 常用集成开发环境（IDE）功能对比与选择指南
  • RISC-V 处理器 FPGA 实现：高性能开源核心硬件部署实践
  • FPGA 高云 PLL 锁相环 IP 核配置与多时钟域设计
  • 机器学习：数据清洗与预处理（Python）
  • 《大模型导论》出版介绍及技术内容概览
  • Qwen3Guard-Gen-WEB 企业级部署与权限控制指南
  • 使用 DeepSeek 辅助开发高性能贪吃蛇游戏
  • 前端图片加载失败与裂图原因深度解析
  • AM32 无人机电调源码架构与工作原理解析
  • 利用 Kiro 和 AIClient-2-API 免费调用 Claude 大模型指南

相关免费在线工具

  • 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