DesKit Plugin Docs

示例插件

从已有插件学习常见模式:计算器、时间戳转换、历史剪贴板。

示例插件

最好的插件文档永远比不上一个能跑的插件。以下是官方制作的插件,可以作为开发参考。

计算器

仓库:WiIIiamWei/deskit-plugin-calculator

适合学习:

  • 实时计算;
  • onSearchChange
  • 错误行渲染;
  • 复制结果;
  • 用关键词让命令更容易被搜到。

计算器插件还有一个值得借鉴的点:它没有使用 evalFunction,而是自己解析表达式。插件处理用户输入时,安全边界要尽量清楚。

时间戳转换

仓库:WiIIiamWei/deskit-plugin-timestamp

适合学习:

  • 把输入转换成多种候选结果;
  • 用列表展示多个格式;
  • 给每个结果提供复制动作;
  • 使用 lucide:clock 这类清晰图标。

历史剪贴板

仓库:WiIIiamWei/deskit-plugin-clipboard-history

适合学习:

  • 后台剪贴板事件;
  • 收藏、筛选、选中状态;
  • 插件快捷键;
  • 小心处理同步大小限制;
  • 避免把插件自己写入的内容重复加入历史。

这是一个更复杂的插件,建议在熟悉基础命令和视图之后再读。

选择自己的第一个插件

如果你想练手,推荐从这些方向开始:

  • 文本大小写转换;
  • URL 编码/解码;
  • JSON 格式化;
  • 正则测试;
  • 颜色格式转换;
  • 简单单位换算。

它们都能用一个 list view 做出完整体验,也很适合提交到 Marketplace。

本页目录