Deskulpt：用 Web 技术打造属于你的桌面小组件 #

Deskulpt 是什么？ #

Deskulpt 是一款开源的跨平台桌面自定义工具，它允许用户使用 HTML、CSS、TypeScript（React）等前端技术编写桌面小组件（Widgets），并把这些组件直接渲染到桌面上，让原本静态、只能放图标的桌面变成一块可以自由编程的画布。

它的核心价值在于「用你熟悉的 Web 技术解决桌面个性化需求」：不需要学习 C++、Swift 或 Windows API，只要会写网页，就能做出时钟、待办清单、天气卡片、系统监控面板等桌面组件。Deskulpt 基于 Tauri 构建，安装包体积小、运行相对轻量，同时支持 Windows、macOS 与 Linux 三大桌面平台，适合前端开发者、桌面折腾爱好者以及希望提升桌面信息密度的效率用户。项目托管于 GitHub，属于社区驱动的开源软件。

Deskulpt 有哪些亮点特色？ #

• 用 Web 技术写桌面组件：直接使用 HTML、CSS、TypeScript/React 开发小组件，前端开发者几乎零学习成本，可复用已有的 npm 生态与构建工具链。

• 桌面即画布：组件以透明窗口的形式渲染在桌面层，可自由摆放位置与调整尺寸，让桌面同时承担信息展示与快捷操作的角色，而不是只放图标和壁纸。

• 跨平台一致体验：官方同时提供 Windows、macOS（Intel 与 Apple 芯片）和 Linux 安装包，一套组件代码可在三大桌面系统上运行，切换设备无需重新适应。

• 基于 Tauri，体积轻巧：从官方发布包来看，Windows 安装程序约 3.9 MB、macOS 安装包约 5.7～6.2 MB，相比动辄上百 MB 的 Electron 应用更节省磁盘与内存资源。

• 开源可审计、可扩展：项目源码在 GitHub 公开，任何人都可以查看实现细节、提交 Issue 或 Pull Request，也可以基于源码自行构建符合个人需求的版本。

• 组件工程化开发：支持使用标准的项目结构与依赖管理方式来组织组件代码，便于把个人组件做成可维护、可分享的工程，而不是一次性的脚本片段。

• 社区组件生态：官方组织下设有独立的小组件仓库（Deskulpt Apps），提供可直接使用或作为参考的示例组件，降低上手门槛（具体组件清单以官方仓库为准）。

• 可自定义外观与行为：组件的样式、透明度、刷新逻辑均由开发者自行控制，能够与各种壁纸风格和桌面布局相匹配。

免费下载 Deskulpt #

以下为官方提供的各平台安装包，点击链接即可下载。请根据自己的操作系统与芯片架构选择对应文件；若不确定架构，可先确认设备信息（macOS 可在「关于本机」中查看，Windows 通常选择 x64 版本）。

说明：以上文件版本为 0.3.0。官方是否还提供 .deb、.rpm、.msi、Homebrew 等其他分发形式，官网未说明；如需最新版本，建议优先访问 GitHub Releases 页面核对。

Deskulpt 如何使用？ #

Deskulpt 的使用可以拆成「装好应用 → 准备组件 → 加载到桌面」三步。下面是最小可用流程（具体命令与目录名以官方文档为准）：

1. 启动应用：安装并打开 Deskulpt。首次运行时，应用通常会初始化一个用于存放组件配置与构建产物的本地目录，并按需申请桌面渲染相关权限，按提示允许即可。

2. 了解组件目录结构：Deskulpt 通过本地目录管理组件。一般每个组件是一个独立文件夹，包含源码、依赖描述文件和构建输出。建议先查看官方示例组件，理解目录约定后再动手写自己的。

3. 创建第一个组件：参考官方示例，新建一个组件项目，用 HTML/CSS/TS 编写界面与逻辑。最简单的方式是从官方模板或示例仓库复制一份，改掉样式和文案，确认能跑通后再逐步增加功能。

4. 构建组件：使用项目自带的构建流程（例如基于 npm/pnpm 脚本）把源码打包成 Deskulpt 可识别的产物。构建成功后，产物会被放到应用约定的输出目录中。

5. 在桌面上加载与调整：回到 Deskulpt 界面，选择或刷新组件列表，把组件「添加」到桌面。然后拖动调整位置、修改尺寸，确认它不遮挡常用图标即可。

6. 迭代与分享：由于组件本质上是 Web 项目，你可以随时修改代码、热更新或重新构建。做得满意的组件可以打包分享给其他 Deskulpt 用户，或提交到官方组件仓库。

Deskulpt 的常见问题？ #

Deskulpt 是免费的吗？ Deskulpt 是开源项目，源码公开在 GitHub，可免费下载使用。官方是否提供付费版本或增值服务，官网未说明；从项目定位看，它更接近社区免费开源工具。

必须会写代码才能用吗？ 严格来说，Deskulpt 的核心玩法就是用 Web 技术写组件，因此具备 HTML/CSS/JavaScript 基础会顺畅很多。完全不懂代码的用户可以尝试官方或社区提供的现成组件，直接加载使用，但可定制度会受限。

支持哪些操作系统？ 官方发布包覆盖 Windows（64 位）、macOS（Intel 与 Apple 芯片）以及 Linux（amd64 AppImage）。是否支持 ARM 架构 Linux 或其他平台，官网未说明。

桌面上的组件会遮挡图标或导致误触吗？ 组件以独立窗口形式渲染在桌面层，位置和层级通常可以在应用内调整。建议把组件放在图标较少的区域，并避免把交互按钮放在影响系统操作的位置。

组件不显示或显示异常怎么办？ 先确认组件是否构建成功、是否已被 Deskulpt 正确加载；再检查组件代码中是否存在语法错误或未安装的依赖。如果问题出在应用本身，可查看应用日志或到 GitHub Issues 中检索同类问题。

会有明显的性能开销吗？ Deskulpt 基于 Tauri 构建，安装包仅数 MB，相比 Electron 类应用更轻量。但每个常驻组件仍会占用一定内存，组件数量多或包含大量动画时可能更明显，建议按需保留常用组件。

在哪里反馈问题或提需求？ 可以直接到 GitHub 仓库（deskulpt-apps/Deskulpt）提交 Issue 或 Pull Request，这是官方最主要的反馈渠道。

Deskulpt 如何安装？ #

Windows #

1. 下载 Deskulpt_0.3.0_x64-setup.exe。
2. 双击运行安装程序，若系统弹出 SmartScreen 提示，选择「更多信息」→「仍要运行」。
3. 按向导完成安装，安装路径可保持默认。
4. 从开始菜单或桌面快捷方式启动 Deskulpt。
5. 若企业环境需要静默安装，通常可使用安装器自带参数，具体参数官网未说明。

macOS #

1. 根据芯片类型下载对应的 .dmg：Apple 芯片选 aarch64 版本，Intel 芯片选 x64 版本。
2. 双击打开 .dmg，把 Deskulpt 图标拖入「应用程序」文件夹。
3. 首次打开若提示「无法验证开发者」，可在「系统设置 → 隐私与安全性」中点击「仍要打开」。
4. 从「启动台」或「应用程序」中启动 Deskulpt。
5. 应用可能需要辅助功能或屏幕录制等权限才能正确渲染桌面组件，按系统提示授权即可。

Linux #

1. 下载 Deskulpt_0.3.0_amd64.AppImage。
2. 为文件添加可执行权限：

   chmod +x Deskulpt_0.3.0_amd64.AppImage
   

3. 直接运行：

   ./Deskulpt_0.3.0_amd64.AppImage
   

4. 若提示缺少 FUSE，可安装 libfuse2（不同发行版包名略有差异），或使用 --appimage-extract 方式解包运行。
5. 如希望出现在应用菜单中，可使用 AppImageLauncher 等工具集成。官方是否提供 apt/dnf 仓库，官网未说明。

Deskulpt 如何卸载？ #

Windows #

1. 打开「设置 → 应用 → 已安装的应用」（或控制面板「程序和功能」）。
2. 找到 Deskulpt，点击「卸载」并确认。
3. 按提示完成卸载向导。
4. 如需彻底清理，检查用户目录下的 .deskulpt 配置文件夹以及 %APPDATA%、%LOCALAPPDATA% 中是否存在 Deskulpt 相关目录，确认无用后手动删除。

macOS #

1. 打开「应用程序」文件夹，将 Deskulpt 拖入废纸篓（或右键「移到废纸篓」）。
2. 清空废纸篓。
3. 如需彻底清理残留配置，可在访达中按 Command + Shift + G，依次前往 ~/.deskulpt 与 ~/Library/Application Support/ 下的 Deskulpt 相关目录并删除。
4. 若曾在系统设置中为 Deskulpt 授予过辅助功能等权限，建议在「隐私与安全性」中一并移除对应条目。

Linux #

1. 若使用 AppImage，直接删除 Deskulpt_0.3.0_amd64.AppImage 文件即可完成卸载。
2. 若通过 AppImageLauncher 集成到桌面菜单，需同时在集成目录中移除对应的 .desktop 文件。
3. 清理配置文件：删除 ~/.deskulpt 以及 ~/.config/ 下与 Deskulpt 相关的目录。
4. 若你通过发行版包管理器安装，请使用对应的 remove/uninstall 命令卸载。

提示：卸载前建议备份自己编写的组件源码，避免随配置目录一起被删除。不同版本的实际目录结构可能有所调整，若发现残留目录与上述不一致，以官方文档为准。