欢迎光临
我们一直在努力

【Claude Code】我给 Claude Code 做了个桌面启动器 —— 内置道家呼吸引导的悬浮路径工具

我给 Claude Code 做了个桌面启动器 | 内置道家呼吸引导的悬浮路径工具

作者:Sebastilan & Claude(AI 协作)


问题背景

用 Claude Code 的人应该都有这个体验:

想对一个项目用 claude → 打开资源管理器 → 翻到项目文件夹 → 复制路径 → 打开终端 → cd 过去 → 敲 claude

项目一多,这套流程每天重复几十次。每次都不难,但每次都打断你的思路。

我受不了了,就写了个小工具解决这个问题。

思路

问题的本质是:高频操作的路径太长。从「想用 claude」到「claude 跑起来」中间隔了 5 个手动步骤。

解决思路很简单——把常用项目路径缓存在一个随时可达的地方,点一下就完成全部步骤。具体来说,做一个常驻桌面的悬浮小控件,存着你的项目列表,点击即启动。

实现

QuickPaths:两次点击,启动 claude

QuickPaths 界面展示

QuickPaths 是一个常驻桌面的悬浮小圆点。把你常用的项目路径存进去,需要的时候:

  • 点一下圆点,展开路径列表
  • 点一下项目名
  • 终端自动打开,目录自动切好,claude 自动启动。完事。

    关掉 Claude 模式就是普通的路径复制工具——点一下,路径就在剪贴板里了。

    呼吸引导:不只是个启动器

    做这个工具的时候,我想到一个问题:开发者桌面上常驻的东西,要么是任务栏图标,要么是系统托盘里的小图标。都是冷冰冰的、死的。

    所以我给这个小圆点加了一条呼吸波形。

    呼吸动画

    这条波形的节奏来自道家吐纳术:

    • 吸 4 秒 → 闭 4 秒 → 呼 8 秒 → 静 2 秒
    • 18 秒一个完整周期

    《庄子·刻意》云:「吹呴呼吸,吐故纳新」。核心要诀是呼长于吸——延长的呼气会激活迷走神经,把身体从交感兴奋(战或逃)切换到副交感主导(休息与恢复)。这不是玄学,现代神经科学对此有明确的机制解释。

    写代码累了、debug 焦躁了、等 CI 跑的时候,看一眼桌面上这个安静呼吸的小圆点,跟着它的节奏深呼吸几轮。不需要打开冥想 App,不需要离开工位,几个呼吸周期就能把心率降下来。

    一个开发工具,顺便照顾一下你的精神状态。

    技术选型与关键设计

    整个项目用 PowerShell 5.1 + WPF 写成,零外部依赖。为什么选 PowerShell?因为目标用户是 Windows 上的 Claude Code 用户,PowerShell 是他们 100% 有的运行时。

    几个关键设计点:

    设计实现方式
    WPF 悬浮窗 Topmost + WindowStyle.None + AllowsTransparency
    呼吸动画 DispatcherTimer 50ms 刷新,360 点 Polyline 滚动
    多显示器 VirtualScreen 属性处理负坐标
    数据安全 先写 .tmp 再 Remove + Move,防崩溃丢数据
    自恢复 Task Scheduler 每 3 分钟检查 Mutex,自动重启

    踩过的坑

    • PS 5.1 中文乱码:.ps1 文件必须 UTF-8 BOM 编码,否则中文全乱。用 [char]0xHHHH 可以规避
    • JSON 不能有 BOM:ConvertFrom-Json 遇到 BOM 会把数组当单对象,读取时需要 TrimStart([char]0xFEFF)
    • File.Replace + $null 崩溃:PS 5.1 下 [System.IO.File]::Replace($src, $dst, $null) 报「路径形式不合法」,改用 Remove + Move 模式
    • 对话框夺焦:文件选择对话框会触发 Deactivated 事件导致面板收起,用 $dialogOpen 标记保护

    总结 / 项目地址

    QuickPaths 解决了 Claude Code 用户在多项目间切换的高频痛点,同时用道家吐纳呼吸引导给桌面注入了一点生命感。

    三种安装方式,选最顺手的:

    方式一:一行命令(推荐)

    irm https://raw.githubusercontent.com/Sebastilan/QuickPaths/master/setup.ps1 | iex

    方式二:从 GitHub Releases 下载 QuickPathsSetup.exe 双击运行

    方式三:git clone https://github.com/Sebastilan/QuickPaths.git 后双击 Install.cmd

    项目已开源,MIT 协议:github.com/Sebastilan/QuickPaths

    系统要求:Windows 10/11 + PowerShell 5.1(自带)。Claude 模式需已安装 Claude Code CLI。无需管理员权限。


    一起交流

    如果你觉得有帮助,欢迎:

    • 📌 订阅本专栏,跟进后续更新
    • 💬 评论区留言,交流你的想法
    • ⭐ 点赞收藏,让更多朋友看到

    — Sebastilan & Claude

    赞(0)
    未经允许不得转载:171主机测评 » 【Claude Code】我给 Claude Code 做了个桌面启动器 —— 内置道家呼吸引导的悬浮路径工具
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址