一、前置准备（零门槛，Windows 专属，命令直接复制）
1.1 硬件要求（普通办公电脑可跑）
- CPU：≥4 核（Intel i3/i5、AMD Ryzen 3/5 及以上）
- 内存：≥8G（推荐 16G，多任务无卡顿）
- 存储：SSD 剩余≥20G（含模型缓存 + 工具依赖）
- 网络：可正常联网（国内网络即可，已适配国内镜像）
1.2 软件要求（固定版本，避免兼容问题）
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
二、核心部署（Windows 原生部署，3 分钟完成，命令直接复制）
步骤 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：配置模型密钥（二选一，支持 Claude/Gemini）
# 方式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
三、核心功能实战（4 个高频场景，指令直接复制，零代码）
场景 1：本地文件全自动整理（解放双手）
触发指令（APP 内输入框直接粘贴）
整理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 笔记同步（知识管理）
配置命令（PowerShell 执行）
# 绑定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数，同步到飞书工作群
五、多模型切换与性能优化（按需配置）
1. 实时切换模型（APP 内输入指令）
切换模型为Gemini 3 Pro，优先使用该模型处理后续多模态任务
2. 性能优化配置（PowerShell 执行）
# 降低显存占用（适合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
六、常见问题排查（高频报错，直接解决）
1. 启动失败，提示 “端口 8088 被占用”
# 查找占用进程并终止 netstat -ano | findstr 8088 taskkill /f /pid 对应PID（替换查询到的PID） # 重启服务 python app.py
2. 无法访问本地文件，提示 “权限不足”
# 以管理员身份运行PowerShell，重新执行启动命令 python app.py --admin
3. 模型调用报错 “API key invalid”
# 重新配置API-Key（替换为有效密钥） python scripts/set_api_key.py --model claude --key "new-valid-api-key"
4. Skills 安装失败，提示 “网络超时”
# 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 重新安装Skill npm run skill install 目标Skill名称
七、进阶优化（可选，提升体验）
1. 开机自启配置
# 添加到Windows开机自启 python scripts/set_autostart.py --enable true
2. 数据备份与恢复
# 备份配置和技能数据 python scripts/backup_data.py --path "D:\Skywork备份" # 恢复数据（更换电脑/重装系统后） python scripts/restore_data.py --path "D:\Skywork备份"
3. 自定义 Skills 开发（简单示例）
# 创建自定义Skill模板（PowerShell执行） npm run skill create my-custom-skill # 编辑技能逻辑：修改 skills/my-custom-skill/index.js # 安装并测试 npm run skill install ./skills/my-custom-skill
八、核心补充
- 核心优势：Windows 原生支持（无需 WSL2）、开源免费（无封号风险）、中文生态适配（飞书 / 钉钉集成）、多模型兼容（Claude/Gemini）；
- 适用人群：办公人士、知识管理者、自媒体创作者、非技术用户（零代码操作）；
- 后续更新：计划支持微信 / 企业微信集成、本地大模型部署（无需 API-Key）、更多行业专属 Skills（教育 / 医疗 / 电商）；
