如何整仓拉取Jingyun DSH与本地运行

适用于需要对 Jingyun DSH Client 客户端进行深度定制开发、二次功能开发，或者需要独立打包专属品牌桌面端（.exe）的开发者。

---

🛠️ 第一步：前置开发环境装配

在克隆代码之前，请确保你的本地操作系统（以 Windows 为主）已正确配置以下开发工具链：

1.1 安装前端开发环境

1. Node.js（版本建议 >= 18.16.0）：前往 Node.js 官网下载 LTS 版本。
2. pnpm（版本 >= 8.x）：本仓为 Monorepo（单体工作区）架构，强依赖 pnpm 进行多包依赖管理。安装命令：

npm install -g pnpm

1.2 安装 Rust 编译环境（仅 Tauri 桌面端打包需要）

1. 下载并运行 Rustup 安装器 (rustup.rs) 安装 Rust 工具链。
2. 安装过程中，必须勾选并安装 C++ 生成工具 (C++ Build Tools / MSVC)（可通过 Visual Studio Installer 勾选“使用 C++ 的桌面开发”工作负载进行安装）。

1.3 安装打包控制台运行环境

• Python 3.8+：用于拉起一键打包 GUI 控制台的本地 Web 服务。

---

📂 第二步：源码拉取与环境包装配

2.1 克隆代码仓库

打开你的终端（Git Bash 或 PowerShell），克隆本项目源码：

git clone <your-repo-url> jingyun_dsh
cd jingyun_dsh

2.2 准备 Vendor 内嵌运行时（关键步骤）

桌面客户端在打包发布后需要具备独立运行 AI 对话服务和底座的能力，因此需要内嵌 Node.js、Git、Python 的便携版环境包。

1. 获取环境包：联系井云官方或加入开发者社群获取 vendor.zip 运行时压缩包。
2. 解压装配：在项目根目录下，将压缩包解压至：
   📂 src-tauri/resources/vendor/
3. 确保解压后，该路径下包含 node/、git/、python/ 等相应的环境可执行目录。

---

🚀 第三步：依赖安装与本地构建

3.1 安装项目依赖

在项目根目录下执行以下命令，pnpm 会自动解析并安装 Monorepo 所有 workspace package 的依赖项：

pnpm install

3.2 首次本地编译构建

由于项目采用 workspace 模块化设计，主程序依赖了本地 packages 下的 @jingyun-ai/jingyun-dsh 模块。在首次开发运行前，必须先将本地插件模块编译出编译产物（生成 lib 目录）：

pnpm build

---

💻 第四步：本地调试运行

项目提供了两种调试方式：Web 模式预览和原生桌面壳模式调试。

方式 A：启动本地 Web 模式调试

如果你只想调试 AI 交互界面、前端样式或插件市场：

pnpm start

🔍 pnpm start 背后发生了什么？

1. 注入依赖：自动执行 node scripts/prepare_dev.js，该脚本会动态修改 node_modules/@deepseek-ai/dsh/package.json 的 dependencies，将本地正在开发的 @jingyun-ai/jingyun-dsh 以 workspace:^ 的形式注入进去，从而使 DSH 内置插件系统能成功加载它。
2. 启动服务：拉起 @deepseek-ai/dsh 核心 CLI，指定 --profile web 启动本地 Web 服务器。
3. 预览：在浏览器中打开 http://localhost:3080 即可开始调试。

方式 B：启动 Tauri 桌面客户端调试

如果你需要调试 Rust 主进程、系统托盘、无边框窗口控制等原生桌面特性：

pnpm tauri:dev

• 这会拉起一个基于 Tauri v2 的原生 Windows 桌面窗口，并开启前端热重载（HMR）以及前端控制台审查工具（DevTools）。

---

📦 第五步：生产打包与安装包提取

当你开发调试完毕，准备分发你定制的客户端时：

5.1 方式一：使用 GUI 交互式打包控制台（推荐）

1. 在项目根目录下双击运行：run_pack.bat。
2. 控制台会拉起一个 Python 网页服务器并在浏览器中打开 http://127.0.0.1:8089。
3. 在页面表单中填入你的专属品牌参数（应用名称、包名、自定义 Logo 图片、SaaS API 接口、租户 ID 等）。
4. 点击 “开始一键打包生成客户端”，等待终端显示打包成功。

5.2 方式二：通过命令行编译

你也可以直接通过控制台命令编译标准客户端（将自动读取本地配置文件）：

pnpm tauri:build

5.3 提取安装包

编译成功后，前往以下目录即可提取 100% 简体中文的客户端 NSIS 安装程序（.exe）：
👉 📂 src-tauri/target/release/bundle/nsis/