@ts-org/keynth-macos 0.0.1

package/Keynth-0.0.1.app.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTUmZLN1JwRlN3K3pReEdqVExscDF2MUFNKzEzVjJqUlBmc2pmeWF3NnlQL3lsRytFV3cwampzOXBQQVVSYWlhU3VTZGFMV3BwdHZsUnM2bWZSa0VwSHYxZFlHaGJXM2d3PQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MTMwMzU5CWZpbGU66ZSu5qyh5pa5LmFwcC50YXIuZ3oKTFpqQW12STc3RkF6dWRIeUJPdTZRVUN6cGUvcnBZUnhFVW0wYXZONmNORDQ3cXdtVmUxamRudG9XR21YVTdGbUN0WGNwbHk5WTVNSWZqbnFRNGo2Qmc9PQo=

package/README.md

@@ -0,0 +1,182 @@
+# 键次方（macOS）
+
+热键唤起的桌面效率套件，以菜单栏方式常驻。
+
+新安装提供 7 天试用；试用与授权均到期后，启动器与剪贴板历史记录会暂停。
+
+## 功能
+
+### 剪贴板历史
+- 自动记录复制的文本、链接、图片与文件列表（只记路径，粘贴回 Finder 仍是文件）
+- 显示来源应用名称与图标
+- 支持模糊搜索
+- 默认 `Option+C` 唤醒
+- 键盘操作：上下键或 `Ctrl+P` / `Ctrl+N` 选择，`Enter` 粘贴，`Cmd+1`…`Cmd+9` 快贴；文本 / 链接可用 `Cmd+S` 另存为快捷短语
+- 右侧可预览图片、颜色、文本与文件路径；搜索时关键字高亮
+- 相同内容再次复制会提到最前，不重复堆多条
+- 右键可**钉选**常驻条目（置顶显示，不受保留时长清理影响）；再次右键可取消
+- 可开启**合并复制**（默认关）：先普通复制一段，再选中另一段，按住 `⌘` 在约一秒内连按两次 `C`，把新内容追到上一段后面；成功可闻提示音（首次开启可能需授权输入监控与辅助功能）
+- 可设置**忽略名单**（进程名片段）；默认已填入钥匙串、1Password 等常见敏感来源，命中后不入库
+- 文本 / 图片 / 文件列表可分别启停，并各自设定保留时长（24 小时 / 7 天 / 1 个月 / 3 个月 / 自定义）
+- 可暂停记录、一键清空
+- 可导出 / 导入历史备份包；备份含钉选状态
+
+### 应用启动器
+- 默认 `Option+Space` 唤醒，搜索并启动应用、打开文件夹
+- 自动收录系统应用索引；默认可搜桌面、下载、文档，以及 iCloud 云盘与系统设置项（一级，不递归）
+- 默认搜索只匹配应用与文件夹；搜具体文件输入「打开文件」关键词（默认 `o`）再跟空格；「在文件夹中显示」关键词（默认 `f`）可在 Finder 中选中文件
+- **文件夹下钻**：选中文件夹按 `Tab` 进入目录；列表含 `..`；`Esc` 返回上级或退出浏览；`Enter` 用 Finder 打开
+- 支持中英文模糊搜索（含首字母缩写，如 `gc` 找 Google Chrome）
+- 常用项会靠前；同一精确搜索会记住你上次的选择
+- 可搜系统动作；关机 / 重启等会二次确认
+- 可直接输入四则运算，回车复制结果；算式前加 `=` 可做高级运算
+- 输入前缀（默认 `>`）后跟命令，回车用系统默认终端运行
+- 输入像网址的内容，列表优先出现「打开网址」；用过的网址可记入历史并在启动器中搜到
+- 输入 `快捷键` 或 `shortcuts` 列出当前热键；回车执行对应功能，`Tab` 打开相关设置
+- 输入短语关键字（默认 `snip`）加空格后可搜索快捷短语并粘贴
+
+### 结果动作
+- 选中结果后按 `Tab` 打开动作列表；可打字筛选；`Esc` 分层退回
+- 常见动作：打开、显示位置、复制路径 / URL、粘贴短语、复制计算结果、复制命令
+
+### 搜索路径
+- 决定启动器还会扫哪些用户目录；每个目录只看一层，不递归
+- 默认：桌面、下载、文档，以及 iCloud 云盘与系统设置项；默认不含图片库（需要时可自行添加）
+- 可在「搜索路径」中添加、移除或重置为默认
+
+### 网页便签（浏览器书签）
+- 在启动器里搜索并打开浏览器书签
+- 默认读取 Safari、Chrome；也可勾选 Firefox / Edge；读取 Safari 书签可能需要「完全磁盘访问权限」
+- 可与普通结果混排，或设成特定关键词（默认 `bm`）后再搜
+
+### 网页搜索
+- 自定义关键词与 URL 模板；内置多项常用搜索（可关、可改、可删）
+- 启动器输入「关键词 + 空格 + 内容」打开对应搜索（如 `g hello`）
+- 列表最下方会用第一个已启用引擎搜索当前输入
+- 可开启识别网址与历史记录
+
+### 快捷短语
+- 输入触发词即可展开为预设文本（如 `#wx` → `[微笑]`）
+- 支持日期 / 时间、随机值、嵌入其它短语、粘贴后的光标位置等动态替换
+- 默认 `Option+S` 打开选择器；启动器输入短语关键字（默认 `snip`）也可搜索
+- 合集可限定仅在所选应用中扩展
+- 可按合集导入 / 导出合集包（`.alfredsnippets`）、重置默认
+- 需授予辅助功能 / 输入监控权限；设置「快捷短语」中提供检查与跳转入口
+
+### 系统动作
+- 锁定、睡眠、关机、重启、注销、屏保、静音、蓝牙、阻止睡眠、打开 / 清空废纸篓（需自动化权限）、取色、屏幕标尺、划区取字、窗口裁剪、刷新应用列表等
+- **应用动作**：用关键词操作正在运行的应用，例如 `hide chrome`、`quit 微信`、`quitall`（全部退出）
+
+### 划区取字
+- 默认 `Cmd+Shift+O` 唤起；也可在启动器中搜索「划区取字」
+- 框选屏幕区域后识别文字；认出后自行划选复制，关掉结果框不会悄悄拷走全文
+- 首次使用须在「系统设置 → 隐私与安全性 → 屏幕录制」中允许本应用，允许后请完全退出再打开
+
+### 取色器
+- 默认 `Cmd+Shift+C` 唤醒；光标旁显示预览与色值，画面保持实时
+- 滚轮或键盘 `+` / `-` 改变取样范围；左键 / 中键复制并关闭；右键或 `Esc` 取消
+- 需屏幕录制权限
+- 默认复制为 HEX（`#RRGGBB`），可在设置中改为 RGB / HSL
+
+### 屏幕标尺
+- 默认 `Cmd+Shift+R` 唤醒，用边缘检测测量屏幕像素间距
+- 几何对齐光标所在屏；需屏幕录制权限
+- 也可在启动器中搜索「屏幕标尺」
+
+### 录制动图
+- 默认 `Cmd+Shift+G` 唤起；也可在启动器中搜索「录制动图」
+- 半透明蒙层上拖出矩形对准区域；可拖移、缩放，或吸附到某个窗口
+- 点红点立刻开始录制；录制中可点到后面的窗口；点停止键、Esc 或再按快捷键结束
+- 结束后选择保存位置，写成 GIF；成功后在 Finder 中选中文件
+- 可调整帧率（24～60，默认 24），以及是否把鼠标指针画进动图
+- 首次使用须在「系统设置 → 隐私与安全性 → 屏幕录制」中允许本应用，允许后请完全退出再打开
+
+### 窗口裁剪
+- 默认 `Cmd+Shift+T`：框选前台窗口区域，生成始终置顶的实时镜像窗（缩略图）
+- 原窗留在原地；镜像只供查看，不接收点击与滚动
+- 首次使用须在「系统设置 → 隐私与安全性 → 屏幕录制」中允许本应用
+
+### 任意拖窗
+- 按住 `Cmd+Shift`，在窗口内任意位置左键拖动即可移动，无需瞄准标题栏；右键拖动从离按下点最近的边或角缩放（可关）
+- 需「辅助功能」权限；可按进程名 / Bundle ID 排除应用；部分系统面板与全屏 Space 可能无法拖移
+
+### 阻止睡眠
+- 菜单栏或启动器搜索「阻止睡眠」一键开关；也可在设置中选择一直阻止或定时（分钟），并可同时保持屏幕常亮
+- 只拦住空闲睡眠；合盖或苹果菜单「睡眠」仍会睡
+- 锁屏或注销后会失效；退出本应用也会恢复正常睡眠策略
+- 启动时不会自动接上上次的阻止状态
+
+### 拷贝路径
+- Finder 右键「拷贝路径」，复制 POSIX 绝对路径
+- 菜单图标跟随系统浅色 / 深色；若系统尚未启用扩展，设置页会提供入口
+- 可在设置「通用」中开关（默认开启）
+
+### 授权
+- 新安装提供 7 天试用；试用与授权均到期后，启动器与剪贴板历史记录会暂停
+- 可在「通用 → 授权」粘贴授权码续期
+
+### 配置迁移
+- 在「通用」中导出 / 导入用户配置 JSON
+- 含快捷键、主题、短语合集、启动器习惯等，可带到另一台电脑
+- 导入前自动备份并清洗，完成后展示结果清单，确认后再重启
+
+### 历史迁移
+- 在「剪贴板」中导出 / 导入历史备份包
+- 导出可勾选文本、文件列表（默认）与图片（可选，包更大）
+- 导入按内容指纹合并，冲突时保留时间更新的记录，钉选状态会合并保留
+
+### 外观与菜单栏
+- 主题：浅色 / 深色 / 跟随系统
+- 成套配色预设（浅色与深色一并切换）：海蓝（默认）、薄荷、藤紫、朱砂、琥珀、霁青、墨灰、桃夭、松针、暮橙
+- 窗口带毛玻璃效果
+- **强制输入法**（「通用」）：打开启动器时切到所选输入法，关闭后还原
+- **动作修饰键**（「通用」）：默认 `⌘` + 数字直选当前可见条目；与其它应用冲突时可改为 `Ctrl`
+- 关闭窗口不会退出；菜单栏可阻止睡眠、打开设置
+- 可选开机自启
+
+## 常用快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Option+C` | 打开剪贴板历史 |
+| `Option+Space` | 打开应用启动器 |
+| `Tab` | 启动器：文件夹下钻；其它结果打开结果动作 |
+| `Option+S` | 打开快捷短语选择器 |
+| `Cmd+Shift+O` | 划区取字 |
+| `Cmd+Shift+C` | 打开取色器 |
+| `Cmd+Shift+R` | 打开屏幕标尺 |
+| `Cmd+Shift+G` | 录制动图 |
+| `Cmd+Shift+T` | 窗口裁剪（缩略图镜像） |
+| `Cmd+Shift` + 左键拖 | 任意拖窗：移动 |
+| `Cmd+Shift` + 右键拖 | 任意拖窗：从最近边/角缩放 |
+| `↑` `↓` / `Ctrl+P` `Ctrl+N` | 上下选择 |
+| `Enter` | 粘贴 / 启动选中项 |
+| `Cmd+1`…`Cmd+9` | 快贴列表中对应项 |
+| `Escape` | 启动器：动作 → 浏览/搜索 → 关窗；其它窗口：关闭 |
+
+更多选项请在菜单栏打开**设置**。配置保存在本机用户目录下。
+
+## 系统要求
+
+- **macOS 11.0** 及以上（当前安装包适用于**搭载苹果芯片**的 Mac）
+
+## 安装
+
+没有苹果付费开发者账号时，安装包**无法送交苹果公证**。
+
+1. 双击磁盘映像（`.dmg`），把「键次方」拖到「应用程序」
+2. 若提示无法打开：在「应用程序」中**按住 Control 点按**「键次方」，选「打开」，再确认
+3. 仍被拦时：打开「系统设置 → 隐私与安全性」，滚到页面下方，点「仍要打开」
+
+安装后可在「通用」中设置开机自启。
+
+## 许可证
+
+MIT License
+
+## 下载
+
+当前版本：**0.0.1**
+
+- [macOS 安装包](https://unpkg.com/@ts-org/keynth-macos@0.0.1/Keynth-0.0.1.dmg)
+- 包名：`@ts-org/keynth-macos@0.0.1`

package/latest.json

@@ -0,0 +1,15 @@
+{
+  "version": "0.0.1",
+  "notes": "键次方 0.0.1",
+  "pub_date": "2026-08-19T09:06:54.967Z",
+  "platforms": {
+    "darwin-aarch64": {
+      "signature": "dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTUmZLN1JwRlN3K3pReEdqVExscDF2MUFNKzEzVjJqUlBmc2pmeWF3NnlQL3lsRytFV3cwampzOXBQQVVSYWlhU3VTZGFMV3BwdHZsUnM2bWZSa0VwSHYxZFlHaGJXM2d3PQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MTMwMzU5CWZpbGU66ZSu5qyh5pa5LmFwcC50YXIuZ3oKTFpqQW12STc3RkF6dWRIeUJPdTZRVUN6cGUvcnBZUnhFVW0wYXZONmNORDQ3cXdtVmUxamRudG9XR21YVTdGbUN0WGNwbHk5WTVNSWZqbnFRNGo2Qmc9PQo=",
+      "url": "https://unpkg.com/@ts-org/keynth-macos@0.0.1/Keynth-0.0.1.app.tar.gz"
+    },
+    "darwin-x86_64": {
+      "signature": "dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTUmZLN1JwRlN3K3pReEdqVExscDF2MUFNKzEzVjJqUlBmc2pmeWF3NnlQL3lsRytFV3cwampzOXBQQVVSYWlhU3VTZGFMV3BwdHZsUnM2bWZSa0VwSHYxZFlHaGJXM2d3PQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MTMwMzU5CWZpbGU66ZSu5qyh5pa5LmFwcC50YXIuZ3oKTFpqQW12STc3RkF6dWRIeUJPdTZRVUN6cGUvcnBZUnhFVW0wYXZONmNORDQ3cXdtVmUxamRudG9XR21YVTdGbUN0WGNwbHk5WTVNSWZqbnFRNGo2Qmc9PQo=",
+      "url": "https://unpkg.com/@ts-org/keynth-macos@0.0.1/Keynth-0.0.1.app.tar.gz"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@ts-org/keynth-macos",
+  "version": "0.0.1",
+  "description": "键次方 — macOS 桌面效率套件（安装包与自动更新清单）",
+  "type": "module",
+  "author": "Lynn <zmzchn@gmail.com>",
+  "license": "MIT",
+  "keywords": [
+    "desktop",
+    "launcher",
+    "clipboard",
+    "productivity",
+    "updater",
+    "macos"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/u-mac/clipboard-history-app.git"
+  },
+  "homepage": "https://gitee.com/u-mac/clipboard-history-app",
+  "files": [
+    "latest.json",
+    "README.md",
+    "Keynth-0.0.1.app.tar.gz",
+    "Keynth-0.0.1.app.tar.gz.sig",
+    "Keynth-0.0.1.dmg"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}