cursor-switch 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +161 -0
- package/SECURITY.md +38 -0
- package/bin/cswitch.js +35 -0
- package/dist/cli.d.ts +6 -0
- package/dist/cli.js +850 -0
- package/dist/core/account-store.d.ts +25 -0
- package/dist/core/account-store.js +182 -0
- package/dist/core/cdp-engine.d.ts +75 -0
- package/dist/core/cdp-engine.js +320 -0
- package/dist/core/config-store.d.ts +38 -0
- package/dist/core/config-store.js +100 -0
- package/dist/core/cursor-paths.d.ts +22 -0
- package/dist/core/cursor-paths.js +287 -0
- package/dist/core/dashboard-launcher.d.ts +34 -0
- package/dist/core/dashboard-launcher.js +210 -0
- package/dist/core/fingerprint.d.ts +7 -0
- package/dist/core/fingerprint.js +34 -0
- package/dist/core/oauth-receiver.d.ts +31 -0
- package/dist/core/oauth-receiver.js +849 -0
- package/dist/core/official-api.d.ts +29 -0
- package/dist/core/official-api.js +205 -0
- package/dist/core/outlook-launcher.d.ts +54 -0
- package/dist/core/outlook-launcher.js +671 -0
- package/dist/core/process-manager.d.ts +25 -0
- package/dist/core/process-manager.js +133 -0
- package/dist/core/pure-login-service.d.ts +67 -0
- package/dist/core/pure-login-service.js +550 -0
- package/dist/core/refund-client.d.ts +102 -0
- package/dist/core/refund-client.js +221 -0
- package/dist/core/refund-service.d.ts +39 -0
- package/dist/core/refund-service.js +384 -0
- package/dist/core/sqlite-bridge.d.ts +23 -0
- package/dist/core/sqlite-bridge.js +207 -0
- package/dist/core/storage-bridge.d.ts +18 -0
- package/dist/core/storage-bridge.js +99 -0
- package/dist/core/token-parser.d.ts +35 -0
- package/dist/core/token-parser.js +106 -0
- package/dist/core/update-checker.d.ts +62 -0
- package/dist/core/update-checker.js +231 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.js +17 -0
- package/dist/menu.d.ts +12 -0
- package/dist/menu.js +2201 -0
- package/dist/types.d.ts +60 -0
- package/dist/types.js +5 -0
- package/dist/utils/browser-utils.d.ts +31 -0
- package/dist/utils/browser-utils.js +283 -0
- package/dist/utils/clipboard.d.ts +5 -0
- package/dist/utils/clipboard.js +48 -0
- package/dist/utils/live-menu.d.ts +26 -0
- package/dist/utils/live-menu.js +169 -0
- package/dist/utils/plan-formatter.d.ts +30 -0
- package/dist/utils/plan-formatter.js +153 -0
- package/dist/utils/prompt-utils.d.ts +40 -0
- package/dist/utils/prompt-utils.js +105 -0
- package/dist/utils/security.d.ts +6 -0
- package/dist/utils/security.js +27 -0
- package/dist/utils/table-renderer.d.ts +7 -0
- package/dist/utils/table-renderer.js +88 -0
- package/dist/utils/time-formatter.d.ts +13 -0
- package/dist/utils/time-formatter.js +83 -0
- package/package.json +53 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 aozai
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# Cursor-Switch (一键换号助手) 🚀
|
|
2
|
+
|
|
3
|
+
> 专为 Cursor IDE 打造的**极速、安全、纯本地运行的多账号管理与防封虚拟硬件指纹切换纯命令行工具(Pure CLI)**。
|
|
4
|
+
>
|
|
5
|
+
> 零编译报错 • 零数据外联 • 账号专属指纹防封 • 订阅到期精确到秒 • 免密直开网页后台
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/cursor-switch)
|
|
8
|
+
[](./LICENSE)
|
|
9
|
+
[]()
|
|
10
|
+
[](./SECURITY.md)
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## ⚡ 为什么选择 Cursor-Switch?
|
|
15
|
+
|
|
16
|
+
Cursor 官方目前不支持多账号快速切换。社区常见换号脚本存在三大痛点:
|
|
17
|
+
1. **频繁封号**:虽然换了 Token,但电脑的 Machine ID 始终不变,被官方风控识别为同一设备多账号滥用;
|
|
18
|
+
2. **到期盲切**:不清楚各账号具体还剩多少次高速请求,更不知道何时到期;
|
|
19
|
+
3. **安全隐忧**:担心第三方闭源软件暗中上传凭据。
|
|
20
|
+
|
|
21
|
+
**Cursor-Switch 由此诞生**:
|
|
22
|
+
- **🛡️ 账号专属独立指纹**:每个账号自动分配并绑定一组专属的虚拟机器码。切到 A 号就用 A 机码,切到 B 号就用 B 机码。从官方视角看,始终是“一台独立电脑对应一个账号”,彻底规避连带封号风险!
|
|
23
|
+
- **⏱️ 精确到秒 + 1小时重订保护期预警**:毫秒级时间戳解析,动态秒表倒计时;到期后自动高亮提醒进入「1小时黄金重订保护期」,不错过重订机会!
|
|
24
|
+
- **🌐 免密直达后台**:自动注入会话 Cookie,无需输密码、无需做人机验证,一键打开官网 Dashboard 查账单/换绑卡。
|
|
25
|
+
- **🔒 100% 纯本地与零外泄**:拔掉网线照样可用!不设任何外部服务器,代码完全开源白盒可查。
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 🚀 快速开始
|
|
30
|
+
|
|
31
|
+
无需全局安装,终端直接一行运行体验:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
npx cursor-switch
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
或全局安装(推荐):
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npm install -g cursor-switch
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
安装后即可直接使用 `cswitch`、`cursor-switch` 或极短缩写 `cs`:
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
cswitch
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 📋 核心功能与使用指令
|
|
52
|
+
|
|
53
|
+
### 1. 🖥️ 交互式主菜单(推荐新手使用)
|
|
54
|
+
直接在终端敲 `cswitch`,上下方向键自选操作:
|
|
55
|
+
```bash
|
|
56
|
+
cswitch
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### 2. 👥 一键极速换号 (`cswitch use`)
|
|
60
|
+
0.3 秒完成关闭进程、安全快照、换绑独立指纹、原子写入并自动重启 IDE:
|
|
61
|
+
```bash
|
|
62
|
+
# 按邮箱切换
|
|
63
|
+
cswitch use personal@gmail.com
|
|
64
|
+
|
|
65
|
+
# 或按序号切换(第 2 个账号)
|
|
66
|
+
cswitch use 2
|
|
67
|
+
|
|
68
|
+
# 切完不自动唤醒 Cursor
|
|
69
|
+
cswitch use 2 --no-restart
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### 3. 📊 账号余量与到期看板 (`cswitch list`)
|
|
73
|
+
```bash
|
|
74
|
+
# 查看账号看板(默认展示前 20 条)
|
|
75
|
+
cswitch list
|
|
76
|
+
|
|
77
|
+
# 模糊搜索
|
|
78
|
+
cswitch list -s work
|
|
79
|
+
|
|
80
|
+
# 强制直连官方接口同步最新剩余额度
|
|
81
|
+
cswitch list --refresh
|
|
82
|
+
|
|
83
|
+
# 查看全部账号
|
|
84
|
+
cswitch list -l 0
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 4. ➕ 添加账号 (`cswitch add`)
|
|
88
|
+
支持以下录入方式:
|
|
89
|
+
```bash
|
|
90
|
+
# 方式 1: 直接粘贴 user_xxx::eyJ... 或 eyJ... Token
|
|
91
|
+
cswitch add "user_xxx::eyJhbGciOiJIUzI1NiIsInR5cCI6..."
|
|
92
|
+
cswitch add "eyJhbGciOiJIUzI1NiIsInR5cCI6..."
|
|
93
|
+
|
|
94
|
+
# 方式 2: 调起浏览器登录,CLI 自动截获凭据入库(免手动复制)
|
|
95
|
+
cswitch add --browser
|
|
96
|
+
|
|
97
|
+
# 方式 3: 批量导入文件(支持 JSON 账号列表)
|
|
98
|
+
cswitch import accounts.json
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### 5. ⚡ 一键收录本机在用账号 (`cswitch capture`)
|
|
102
|
+
一秒收录当前电脑 Cursor IDE 正在登录的有效账号,分配专属指纹并入库:
|
|
103
|
+
```bash
|
|
104
|
+
cswitch capture "我的主力号"
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### 6. 🌐 免密直达官网后台 (`cswitch dash`)
|
|
108
|
+
采用 100% 纯原生 CDP (Chrome DevTools Protocol),无需安装 Python 或 Playwright,独立环境隔离 Cookie 自动注入直达控制台:
|
|
109
|
+
```bash
|
|
110
|
+
# 打开当前正在用的账号后台
|
|
111
|
+
cswitch dash
|
|
112
|
+
|
|
113
|
+
# 打开指定账号的后台
|
|
114
|
+
cswitch dash personal@gmail.com
|
|
115
|
+
|
|
116
|
+
# 直接传入 Token 免入库临时打开后台
|
|
117
|
+
cswitch dash -t "user_xxx::eyJhbGciOi..."
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### 7. 📬 打开独立浏览器自动登录 Outlook 邮箱 (`cswitch mail`)
|
|
121
|
+
调起全新独立隔离浏览器实例并自动登录微软 Outlook 邮箱,密码优先自动化;支持与 Cursor 控制台**同窗口双开联动**:
|
|
122
|
+
```bash
|
|
123
|
+
# 打开当前在用账号的 Outlook 邮箱
|
|
124
|
+
cswitch mail
|
|
125
|
+
|
|
126
|
+
# 打开指定账号的邮箱
|
|
127
|
+
cswitch mail developer@outlook.com
|
|
128
|
+
|
|
129
|
+
# 联动双开:同时在浏览器新标签页中免密直达该账号的 Cursor Dashboard 控制台!
|
|
130
|
+
cswitch mail developer@outlook.com -d
|
|
131
|
+
|
|
132
|
+
# 临时多段式打开 (自动代填密码,不存入账号库)
|
|
133
|
+
cswitch mail "user@outlook.com----MyPassword123"
|
|
134
|
+
|
|
135
|
+
# 临时多段式打开 + 传入 Token 同步双开 Cursor 控制台
|
|
136
|
+
cswitch mail "user@outlook.com----MyPassword123" -d -t "user_xxx::eyJ..."
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### 8. 🛡️ 机器硬件指纹管理 (`cswitch id`)
|
|
140
|
+
```bash
|
|
141
|
+
# 查看当前硬件指纹
|
|
142
|
+
cswitch id status
|
|
143
|
+
|
|
144
|
+
# 一键备份并重置全套崭新的随机机器码(解除设备限制)
|
|
145
|
+
cswitch id reset
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## 🛡️ 安全与隐私规范
|
|
151
|
+
|
|
152
|
+
详见 [SECURITY.md](./SECURITY.md)。
|
|
153
|
+
- **绝不上传任何凭据**:所有账号数据保存在本地 `~/.cursor-switch/accounts.json`。
|
|
154
|
+
- **绝无第三方打点**:无 Google Analytics、无 PostHog、无自动后门 ping。
|
|
155
|
+
- **脱敏显示**:终端打印凭据时自动掩码(如 `eyJhbGci...[已脱敏]...d9tyac`)。
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## 📄 开源协议
|
|
160
|
+
|
|
161
|
+
本项目基于 [MIT License](./LICENSE) 开源。欢迎提交 PR 和 Issue!
|
package/SECURITY.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Security & Privacy Whitepaper (安全与隐私白皮书)
|
|
2
|
+
|
|
3
|
+
> **Cursor-Switch 是一项注重隐私安全的本地优先(Local-First)开发工具。**
|
|
4
|
+
> 本项目承诺对用户的隐私与账号凭据进行最高等级的物理隔离与保护。
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 🛡️ 核心安全原则
|
|
9
|
+
|
|
10
|
+
### 1. 本地优先与绝对零凭据外泄 (Zero-Exfiltration)
|
|
11
|
+
- 用户的账号、密码、Token、机器指纹信息**仅保存在用户本机的本地目录**(`~/.cursor-switch/accounts.json`)。
|
|
12
|
+
- **绝不收集、绝不上报任何私有凭据**到远程数据库。
|
|
13
|
+
- **核心换号与硬件指纹隔离功能支持完全离线运行**:即使断开网络,本地换号、指纹防封、配置备份均 100% 正常运行。
|
|
14
|
+
|
|
15
|
+
### 2. 绝对零隐式遥测 (Zero-Telemetry)
|
|
16
|
+
- 代码库内部**绝不包含任何暗中遥测分析或统计打点组件**(如 Google Analytics、PostHog、Mixpanel 等)。
|
|
17
|
+
- 绝无任何暗中回传设备 IP 或个人硬件码的后门逻辑。
|
|
18
|
+
|
|
19
|
+
### 3. 网络通信边界透明公开 (Transparent Network Boundary)
|
|
20
|
+
全项目所有的网络交互公开透明,仅包含以下场景:
|
|
21
|
+
1. **Cursor 官方用量查询**:用户主动查看余量或登录时,直接直连 Cursor 官方接口(`api2.cursor.sh` / `www.cursor.com`)。
|
|
22
|
+
2. **云端纯净代登与退款增值服务**:仅在用户在菜单中**显式主动选择**「纯净代登」或「奥仔退款」并输入卡密时,通过 HTTPS 访问经过 Cloudflare 保护的官方服务站(`getdoubao.com`)。
|
|
23
|
+
3. **版本更新检测**:仅在用户主动检查更新或启动时,向公共官方源(`registry.npmjs.org` / 国内镜像 `registry.npmmirror.com`)查询最新版本号,不携带任何个人或设备私有数据。
|
|
24
|
+
|
|
25
|
+
### 4. 代码完全白盒透明与可审计 (100% Auditable)
|
|
26
|
+
- 本工具为纯 TypeScript 编写,npm 发布的包为未经混淆、完全可读的代码。
|
|
27
|
+
- 任何开发者均可在 GitHub 源码仓库或解压 npm 包直接逐行审查。
|
|
28
|
+
|
|
29
|
+
### 5. 终端安全脱敏 (Terminal Masking)
|
|
30
|
+
- 在终端打印任何账号详情时,敏感 Token 自动经过掩码打码处理(例如 `user_xxx%3A%3A...[已脱敏]...d9tyac`),防止在录屏、直播或结对编程中泄露凭据。
|
|
31
|
+
|
|
32
|
+
### 6. 操作系统级安全权限隔离
|
|
33
|
+
- 在 Linux / macOS 环境下,账号存储目录及文件强制设置操作系统权限为 `chmod 700` 及 `chmod 600`,仅当前操作系统用户有权读写,防止本机其他不受信进程非法窥探。
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 漏洞与反馈
|
|
38
|
+
如果您在代码审查中发现任何安全疑虑,欢迎直接在 GitHub 提交 Issue 或联系官方交流群(1007446249),我们将第一时间公开透明地处理。
|
package/bin/cswitch.js
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Cursor-Switch CLI 可执行入口
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
// 注册全局中断信号监听:确保无论何时用户按下 Ctrl+C 都能以干净状态瞬间秒退回系统 Shell
|
|
8
|
+
process.on('SIGINT', () => {
|
|
9
|
+
process.stdout.write('\x1b[?25h\n');
|
|
10
|
+
process.exit(0);
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
process.on('SIGTERM', () => {
|
|
14
|
+
process.stdout.write('\x1b[?25h\n');
|
|
15
|
+
process.exit(0);
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
process.on('unhandledRejection', (reason) => {
|
|
19
|
+
if (reason && (reason.name === 'ExitPromptError' || reason.message?.includes?.('SIGINT'))) {
|
|
20
|
+
process.stdout.write('\x1b[?25h\n');
|
|
21
|
+
process.exit(0);
|
|
22
|
+
}
|
|
23
|
+
});
|
|
24
|
+
|
|
25
|
+
import { createCli } from '../dist/cli.js';
|
|
26
|
+
|
|
27
|
+
const cli = createCli();
|
|
28
|
+
cli.parseAsync(process.argv).catch((err) => {
|
|
29
|
+
if (err?.name === 'ExitPromptError') {
|
|
30
|
+
process.stdout.write('\x1b[?25h\n');
|
|
31
|
+
process.exit(0);
|
|
32
|
+
}
|
|
33
|
+
console.error('\n错误:', err?.message || err);
|
|
34
|
+
process.exit(1);
|
|
35
|
+
});
|