这是栗子从今年7月份开始接触AI，直到现在的学习实践成果，欢迎检验～

作品集

Aside

一个轻量的桌面闪念记录工具。正在做一件事时冒出另一个想法，按快捷键，写一句，按回车，回到手头的事。所有想法进同一个 Inbox，只把选出的几件置顶留在眼前；macOS 和 Windows 双平台原生，记录只存在本机。

  • 桌面应用
  • macOS · Windows
  • 开源
我的角色
个人项目：产品定义、交互设计、开发（与 AI 协作）、测试与发布
时间
2026.09.23 第一次提交 – 10.17 发布 1.1.4
迭代
19 次提交，8 个公开版本
技术
macOS：SwiftUI + AppKit；Windows：WPF + Win32；无第三方代码依赖；GPL-3.0 开源
下载 macOS 版（DMG）下载 Windows 版（EXE）在线试玩GitHub 源码

Mac 版尚未做 Apple 开发者签名，第一次打开需要手动允许一次，步骤见下载与使用。

30 秒看完

  • 只解决一件事：记下突然冒出的想法，同时不打断手头的工作。快捷键唤出输入条，回车保存后输入条立刻消失。
  • 一个 Inbox，不是便签墙：新记录默认不置顶；置顶数量有上限（默认 3 条，可调 1–20），满了要选一条替换，原事项仍留在 Inbox。
  • 不占桌面：完整列表、只看置顶、单行细条三种形态；可以贴边完全隐藏，鼠标移到屏幕边缘再唤回。
  • 快速迭代、细节较真：9 月 24 日到 10 月 17 日发布 8 个版本，反复打磨输入条出现的第一帧、Windows 与 Mac 的一致性、贴边收起的最后一帧。

01为什么做

正在处理一件事，另一个想法突然冒出来。切走去记，会打断当前任务；不记，又怕它转瞬即逝。常见的做法是打开备忘录或待办软件，找到页面、写下来、再切回来，这一来一回本身就是打断。

所以 Aside 把记录动作缩到最短：按快捷键 → 写一句 → 回到手头的事。记录和处理分开：记的时候只管记，等手头的事告一段落，再打开 Inbox 统一整理。

02定位与边界

做什么

  • 在任何应用里用快捷键唤出输入条，记一句就走
  • 所有想法进同一个 Inbox，挑几件置顶留在眼前
  • 窗口尽量不占地方：可收起、可贴边隐藏、透明度可调

不做什么

  • 不做多窗口便签墙：每条想法不单独开一个窗口
  • 不要账号、不做云同步、不接 AI 服务，记录只存在本机

03动手试试

下面是用网页模拟的 Aside，交互规则照源码实现（示例事项是演示文字）。第一次滚到这里会自动演示一遍，之后可以自己操作；电脑上鼠标离开便签时，它会淡到 40%，这是应用的默认值。

Inbox

    试试：唤出输入条写一句，按 Enter；点图钉置顶，点文字修改，勾选完成。

    04核心设计

    1. 记录的路径要最短

    动图：按 Option + Space 唤出输入条，输入「周末试试这个点子」，回车后输入条消失，提示已存入 Inbox
    按快捷键唤出，写一句，回车保存，输入条随即消失
    • 快捷键在任何应用里都能唤出屏幕正中的输入条（Mac 默认 Option + Space，Windows 默认 Ctrl + Alt + Space，都可以改）；Enter 保存，Esc 取消。
    • 取消按钮只在鼠标移入时出现，平时输入条上只有输入框本身。
    • 新记录默认进普通 Inbox，不置顶：记的时候不用做任何决定。

    2. 一个 Inbox，置顶有上限

    动图：在设置里把置顶数量从 2 调到 5，右边 Inbox 里更多事项被置顶
    所有记录在同一个 Inbox，置顶数量可以自己定
    • 展开时看全部内容，收起时只看置顶；点击事项就能在原位置修改。
    • 置顶数量默认 3 条，可以调成 1 到 20 条。满了再置顶，会让用户选一条替换，被换下的事项仍留在 Inbox，不会丢。
    • 完成的事项可以恢复；「清空」只删除已完成的事项，第一次会确认，也可以选择以后不再提示。

    3. 不占满桌面

    动图：便签透明度从 94% 调到 40%，随后贴到屏幕右边缘隐藏，鼠标移到边缘时唤回
    透明度可调，贴到屏幕边缘可以完全隐藏
    • 完整列表、只看置顶、单行细条三种形态；窗口可以拖动、缩放、置顶。
    • 贴到屏幕左右边缘后完全隐藏、不留痕迹，鼠标移到原来的屏幕边缘就能唤回。
    • 背景色用系统调色盘选，可以保存常用颜色；闲置、交互和快速输入时的透明度分别可调（默认闲置 40%、交互时 95%）。

    4. 本地优先，升级不丢数据

    • 记录保存在本机的一个 JSON 文件里，不需要账号、云同步或 AI 服务。
    • 从 QuietPin 改名为 Aside 时，内部数据路径和稳定标识保留旧名，老用户升级后记录和设置都还在；README 里写明了两个平台各自的升级步骤。

    05迭代记录

    9 月 23 日第一次提交，到 10 月 17 日发布 1.1.4，一共 19 次提交、8 个公开版本。下面是每个版本的主要改动，依据 GitHub 上的 Release 说明和提交记录。

    1. v1.0.009.23 – 09.24首发

      首个公开预览版（当时叫 QuietPin）

      • 第一次提交就同时有 macOS 和 Windows 两个原生版本：全局快捷键唤出中央输入条，记录进本地 Inbox，最多三条置顶，贴边隐藏
      • 9 月 24 日一天里，围绕输入条怎么出现提交了 7 次（含 1.0.1）：参考 Spotlight 的输入条和贴边动效，加强、加快弹簧展开，改成整条宽度，从已有宽度的淡化长条展开，最后让它一出现就能看见

    2. v1.0.109.24

      快捷输入响应优化

      • 修正输入条的体感延迟：第一帧就有接近完整的宽度和清晰轮廓，再在很短时间内完成淡入和轻微扩展

    3. v1.0.209.25

      设置页加上项目主页

      • 设置页底部清楚显示「GitHub 项目主页 ↗」链接和图标，两个平台同步

    4. v1.1.009.28品牌

      更名 Aside

      • QuietPin 正式更名为 Aside，功能不变；README 重写，加上交互示意图
      • 为了不丢老用户的记录和设置，内部数据目录和稳定标识保留旧名；旧版 Release 全部保留

    5. v1.1.110.16功能

      原位编辑与置顶数量

      • 点击便签内容即可原位编辑，Enter 保存、Esc 取消
      • 置顶数量可调为 1–20 条（默认 3 条），调低上限不会删除已有置顶
      • 缩短贴边收回的延迟，展开途中移开鼠标也能及时收回

    6. v1.1.210.17跨平台

      Windows 界面与操作对齐 Mac

      • 任意空白处拖动窗口，四边四角调整大小；右键菜单可置顶、完成、删除；按钮、表头和空状态改成 Mac 的样式
      • 快速输入框在高分屏上正确居中、第一帧就弹出，动画曲线与 Mac 版一致；设置页改成卡片式
      • 首次启动在测试虚拟机里从约 33 秒缩短到约 2 秒

    7. v1.1.310.17体验

      贴边无痕与首次打开引导

      • 贴边隐藏后屏幕上不再留下细条，鼠标移到原来的屏幕边缘即可唤回
      • 上次贴过边的便签，启动时先正常显示，鼠标经过一次后才恢复自动隐藏，避免一打开屏幕上什么都没有
      • 第一次打开自动弹出设置页，告诉用户 Aside 在哪里，并引导设置快捷键；README 和 DMG 里写清 Mac 安装的每一步

    8. v1.1.410.17细节

      贴边收起无残影

      • 便签收起时完整滑出屏幕并同时淡出，最后一帧不再残留便签和文字（见下图）

    贴边隐藏：改了四次，才到「不留痕迹」

    • 1.0.0：贴边后留一条细条在屏幕边缘，鼠标碰到就展开。
    • 1.1.1：缩短收回的延迟，展开途中移开鼠标也能及时收回。
    • 1.1.3：细条也去掉，屏幕上什么都不留，靠屏幕边缘本身唤回；同时修了一个副作用：上次贴过边的便签启动后直接隐藏，屏幕看起来是空的，于是改成启动时先显示，鼠标经过一次后再恢复自动隐藏。
    • 1.1.4：细条去掉后，收起动画的最后几帧暴露出来：便签停在离边缘 8 pt 处，而 60 Hz 下 120 ms 的滑动只有约 7 帧，不管用哪种曲线，最后一帧都还能看清文字，然后一下消失。最后的做法是让便签连阴影一起完整滑出屏幕，同时按 (1 − t)^1.5 淡出，最后一帧几乎透明；唤回时先恢复透明度。两个平台一起改。

    修之前停在离边缘 8 pt 处，每一帧都不透明，最后一帧还能看清文字，然后突然消失

    1. 第 1 帧
    2. 第 2 帧
    3. 第 3 帧
    4. 第 4 帧
    5. 第 5 帧
    6. 第 6 帧
    7. 第 7 帧

    1.1.4 之后加速滑出屏幕（连阴影一起），同时按 (1 − t)^1.5 淡出，最后一帧几乎透明

    1. 第 1 帧 · 79%
    2. 第 2 帧 · 60%
    3. 第 3 帧 · 43%
    4. 第 4 帧 · 28%
    5. 第 5 帧 · 15%
    6. 第 6 帧 · 5%
    7. 第 7 帧 · 0%
    图　便签贴边收起的 7 帧（60 Hz 下 120 ms），右侧竖线是屏幕边缘；示意图，按比例画

    06测试与发布

    • macOS：数据模型、颜色收藏、窗口形态、贴边行为和快速输入有自动测试。
    • Windows：在 Mac 上交叉编译，跑数据模型测试，并在 Windows 11 虚拟机（ARM，x64 转译运行）里实测了界面、拖动与缩放、快速输入、全局快捷键和贴边。
    • 写清楚测到了哪里：README 和每个 Release 都注明还没在哪些环境验证过（见第 09 节），不把没测过的说成测过。
    • 降低安装门槛：安装包没有签名，Mac 第一次打开会被拦截。README 从 1.0 起就附上了 Apple 官方说明；1.1.3 又把分步骤的安装说明写进 README、Release 说明和 DMG，首次打开还会自动弹出设置页，引导用户设置快捷键。

    07开发方式

    Aside 的开发主要借助 AI 编程工具完成：我负责定义要做什么、判断效果对不对、决定发不发布。后期我为它在 Claude Code 里配置了一套分工明确的子代理：

    角色职责权限
    调度（orchestrator）把需求拆成可验收的子任务，按评测 → 执行 → 界面 → 审查的顺序派发，汇总后交付不改代码
    评测（evaluator）实际运行功能，覆盖主流程、边界和异常输入，输出问题清单只评测
    执行（executor）按子任务和评测结论改代码，改完自己验证；范围不清就停下可写
    界面（ui）只动界面层：布局、样式、深浅色、响应式可写界面
    审查（reviewer）逐条对照验收标准，实际运行验证，判断通过与否只审查

    每个子代理的报告都以「完成 / 失败 / 受阻」开头。出错时调度者不原样重派，而是重新拆解任务；同一个子任务连续回退两次仍失败，就停下来交给我决定。

    08下载与使用

    Aside 1.1.4

    macOS 13+（Apple Silicon / Intel 通用）· Windows 10/11 x64（单文件，免装 .NET）

    macOSWindows

    Mac 第一次打开（只需一次）

    1. 双击下载的 DMG，把 Aside 拖进「应用程序」。
    2. 在「应用程序」里双击 Aside。提示「无法验证 Aside 是否不含恶意软件」时，点「完成」，不要点「移到废纸篓」。
    3. 打开「系统设置」→「隐私与安全性」，向下滚动到「安全性」，点 Aside 旁边的「仍要打开」，确认后点「打开」。

    Windows：双击 Aside.exe 即可运行。如果提示「Windows 已保护你的电脑」，点「更多信息」→「仍要运行」。

    开始使用

    • 第一次打开会弹出设置页，引导你设置快速记录的快捷键。之后 Aside 常驻在 Mac 的菜单栏 / Windows 的系统托盘。
    • 在任何应用里按快捷键，写一句，按 Enter。想整理时，再打开 Inbox 看看。

    安装包只放在 GitHub Releases，请从那里下载；源码以 GPL-3.0 开源。

    09目前的不足

    • 安装包还没有做 Apple 开发者签名与公证，Windows 也没有代码签名，第一次打开都会看到系统拦截提示。
    • Windows 版只在 Windows 11 虚拟机里实测过，还没在 x64 实体机上验证多显示器和登录启动；Intel Mac、全屏应用和多个桌面也没有逐一实机验证。
    • 没有跨设备同步，Mac 和 Windows 的数据文件也不能直接互相覆盖。

    回到顶部