✦ 星笺 Starclip
简体中文 | English
本地剪贴板管理工具，让剪贴板不止记住上一次。 星笺使用 Rust 构建，帮你找回、整理和再次使用复制过的内容。
把随手复制的文字、链接和代码收进历史，整理成自己的星标与分组，再通过星绘坊做成代码卡片或手写纸笺。
组织主页 · 项目介绍 · GitHub 项目 · 反馈问题 / 提交 Issue
星笺由 StarDreamTech（星梦科技） 维护。软件主窗口右上角的 GitHub 图标可打开开源仓库；「偏好设置 → 帮助」提供组织主页、项目介绍、仓库与问题反馈入口。反馈时请写明软件版本、操作系统、复现步骤与预期结果；公开截图前请遮住私密剪贴内容。
| 功能名称 | 用途 |
|---|
| 星码集 | 收藏、编辑与管理代码片段 |
| 星绘坊 | 制作代码卡片与手写纸笺 |
| 星码卡 | 将代码排成可导出的分享图片 |
| 月光笺 | 将文字排成可导出的手写纸笺 |
| 流星栏 | 横向浏览剪贴记录，快速选择与复制 |
| 星尘整理 | 预览筛选范围后清理记录，可同时整理数据库文件 |
| 星伴 | 预览原创星芽的 32 种表情，按需开启桌面陪伴与成长记录，完成任务解锁装扮 |
文中界面截图均使用合成样例，不含真实剪贴记录。
语言与宣传素材
软件支持 跟随系统 / 简体中文 / English，在「偏好设置 → 使用习惯 → 界面语言」选择后点击「保存全部偏好」，界面立即切换并记住选择。桌面菜单与窗口标题同步切换；你的记录、分组和标签保持原文。
「偏好设置 → 分享」的文案和宣传图默认跟随界面，也可独立选择简体中文或 English。每种语言提供两套文案（简短推荐 / 产品介绍）和五张原创宣传图，预览、复制、保存和收藏使用所选语言。
每张图均为 1080 × 1440。文案与素材说明见 分享星笺；维护新功能时同步更新两份 README 和两种语言素材。
0.2.5 已加入严格图片去重、文字与多图共存的一条图集、分享素材星标收藏；数据结构 / JSON 为 5，旧版不能直接打开新版数据库。操作与限制见 图文组合。
安装与升级
Apple Silicon Mac（M 系列芯片，macOS 11+）推荐使用组织 Tap StarDreamTech/homebrew-tap。Cask 安装包来自本仓库的 GitHub Release：
brew install --cask stardreamtech/tap/starclip
已经从个人 Tap cpython666/homebrew-tap 安装的，可以继续用原来的命令，不必先卸载或改用组织 Tap：
brew install --cask cpython666/tap/starclip
Apple Silicon macOS 和 Windows x64 已可从 0.2.5 GitHub Release 下载。Homebrew 已同步至 0.2.5，远端 Cask 版本与公开 DMG 摘要已回读一致；先退出应用，再运行 brew update，然后按安装来源执行 brew upgrade --cask stardreamtech/tap/starclip 或 brew upgrade --cask cpython666/tap/starclip，无需先卸载。已有带更新器的版本可在「偏好设置 → 帮助」检查更新。源码已准备 0.2.6，尚未发布；公开安装包仍是 0.2.5。0.2.6 的应用内更新检查和组织仓库清单都使用 StarDreamTech/starclip。已安装的 0.2.5 仍从独立兼容仓库 cpython666/starclip 读取更新清单；发版后需要把同一份安装包镜像到该仓库，并只改写那份清单里的地址。
0.2.5 已于 2026-11-11 00:42:14（北京时间，UTC 2026-11-10 16:42:14） 正式发布为 latest，提供 Apple Silicon macOS 和 Windows x64 安装包与签名更新清单；签名发布流水线 8 项检查通过。真实公开 0.2.4 → 0.2.5 的 macOS 与 Windows 均通过自动重启、原创固定数据 / PNG / 偏好保留、结构 4 → 5 和旧自动快照清理；旧应用副本保留。原生升级使用一次性 runner 的临时受信任 HTTPS 服务；8 个匿名公开附件及稳定 latest 的字节另已核对，不扩大为公网 GitHub / CDN 原生更新验收。本机正式安装未替换。
如果 Homebrew 提示 Cask 未受信任，按安装来源执行 brew trust --cask stardreamtech/tap/starclip 或 brew trust --cask cpython666/tap/starclip 后重试，只授权星笺这一项。自有 Tap 不等于 Homebrew 官方主仓收录；更新包具备 Tauri 签名校验，但尚无 Apple Developer 公证或 Windows 发行者证书。安装、升级和分发边界见 发布说明。
已实现
内存与大历史边界：0.2.3 按 SQLite 每页 50 条读取历史，数据库和图片仍在同一个磁盘文件中，不按月份分库。2026-10-29 macOS 空库、暂停采集的诊断对照中，主控制页销毁后只留 100% idle 动画星伴，120 秒总物理足迹三轮中位数为 196.0 MiB；共享 SVG 路径实验同包仅少 1.5 MiB，未证明稳定收益，不合入生产。随后固定阴影实验在同一新诊断包的单轮 120 秒对照为基线 201.3 MiB、实验 199.6 MiB，仅差 1.7 MiB，同样未证明稳定收益、未合入。几十 MiB 动画目标仍未达到，空白与静态仅是诊断对照。这不代表生产前端、长期或大图库性能，也不能与此前 123 条文本的 242.6 MiB 样本计算降幅，详见 内存诊断与共享路径实验。2026-10-29 该轮未替换本机正式安装。
- 剪贴历史：记录系统剪贴板中的文本、图片与文件路径引用，去重、SQLite 持久化、搜索与分类筛选；图片支持缩略图、原图预览和复制回图片剪贴板，文件只保存路径、不读取文件内容。文件兼容更新已随 0.2.4 发布，原生平台读写验收边界见 验证记录。
- 自己的星系：星标收藏、永久保留、彩色分组、标题编辑、卡片 / 列表 / 流星栏；星夜、月白、素白、青苔、暮樱五套主题，以及跟随系统。另有四套可独立选择或关闭的原创贴纸。
- 自定义外观：主题强调色、纯色或双色渐变背景，0–359° 方向与配色预设；可导入一张透明 PNG 贴纸，自动压缩后在本机独立保存。见 外观说明。
- 流星启动画面：短暂的星空与流星动画，可跳过、关闭或从偏好设置重看。
- 启动与后台运行：0.2.3 在「使用习惯」提供登录后自动启动、启动时收起主窗口和菜单栏 / 托盘图标显隐；三项独立即时保存，默认关闭自启动与启动收起、显示图标，不改变记录的暂停状态。
- 初见星笺：四步认识记录、收藏、卡片与数据管理；新数据库首次使用自动展示，也可从「偏好设置 → 帮助」重看。
- 星伴 · 星芽：原创圆润星星角色，32 种表情，手动点选立即保存并同步已开启浮窗，分类与巡游仅预览；会观察、探头、舒展，也会随心情回应摸摸；可选 5 套预设色或自选 HEX。养成提供 20 级、三项日常任务、六成就、四槽十件装饰与六个主动动作。浮窗和成长记录均默认关闭、独立保存，不读取剪贴内容；功能与原生验证范围见 星伴说明 和 养成说明。
- 星码集（代码收藏）：代码编辑、13 种语言选择、语法高亮、行号、JSON 格式化、Markdown 与 PNG 卡片导出。
- 星绘坊（卡片制作）：星码卡与月光笺共用正文；星码卡的深空 / 晨光代码配色与外层背景独立选择，支持自适应或固定宽度、长行软换行，以及留白、阴影、窗头、行号和水印。预览与 PNG 使用同一张画布。
- Markdown 图片（0.2.5）：主界面直接打开编辑、主题与预览，提供素纸 / 星紫 / 深夜三款主题、宽度 / 字号调整和 2 倍 PNG 导出；与代码卡片、手写纸笺并列。支持范围、主题许可与原生验收边界见 Markdown 图片。
- 月光笺（手写纸笺）：0.2.3 改为内置本地手写引擎；先看字体预览，再下载选中的字体，离线制作纸笺并导出 PNG，无需另装手写应用。
- 界面语言：简体中文、English 或跟随系统；保存后立即切换界面，并同步菜单栏 / 托盘菜单和主窗口、星伴窗口标题。英文界面使用 Starcode、Stardraw、Moonlight Note、StarPet 等产品名，用户剪贴内容、分组名和标签保持原文。
- 随用随取：全局快捷键呼出、菜单栏 / 托盘、方向键浏览、Enter 或 ⌘/Ctrl + 1–9 复制；窗口内可用快捷键循环切换分类与分组，并可选择窗口置顶。
- 星迹统计：在本机统计每天 / 每周的采集次数、文本 / 链接 / 代码 / 色彩 / 图片占比、时段与星期分布、复制回次数，以及当前历史构成和常见来源域名。只存次数，不存内容，不上传；清理历史不影响计数，可单独清空。见 星迹统计。
- 本地管理：暂停 / 恢复记录、历史容量、历史保留时长、JSON 导入导出；通过「星尘整理」预览清理范围与占用，确认后删除并按需整理数据库；查看实际数据目录与受管数据占用、打开文件夹、迁移或采用已有数据目录。
桌面版首次打开为空且暂停记录。点击「开启记录」或恢复记录后，首次轮询会检查当前剪贴板内容，再收集后续变化，均遵循去重与隐私规则。浏览器预览有明确的演示标识，使用内存中的原创示例，不会监听剪贴板，也不持久保存历史正文。
0.2.3 将历史改为每页 50 条：SQLite 按搜索、分类、分组、标签、域名和隐私条件查询全库，主列表只保留当前页；侧栏数量与筛选选项仍来自全库。AI 授权选择有独立分页，可跨页选中记录，不受主列表当前页限制。这能减少同时载入的正文和图片，但不代表总运行内存已降到几十 MiB。
0.2.4 会在数据未变化时复用全库分类数量和筛选选项，减少连续搜索、翻页的重复聚合；记录和隐私 / AI 权限仍实时查询。原创数据对照方法及剩余成本见 查询性能。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
