{"_rev":"5-b35e5d1f4ddaccb301ca737d01c86aed","time":{"created":"2026-03-16T13:05:52.444Z","modified":"2026-03-16T13:05:53.091Z","0.1.0":"2026-03-16T06:14:34.214Z","0.1.1":"2026-03-16T13:00:43.150Z","0.1.2":"2026-03-16T13:05:52.731Z"},"_id":"@daxiongmeizi/cursor-acp-miniapp","name":"@daxiongmeizi/cursor-acp-miniapp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.2":{"name":"@daxiongmeizi/cursor-acp-miniapp","version":"0.1.2","description":"Bridge between miniapp-server and Cursor Agent ACP (stdio), for Cursor-type bots in 小爪对话屋","type":"module","main":"dist/index.js","bin":{"cursor-acp-miniapp":"dist/cli.js"},"scripts":{"build":"node scripts/generate-default-bridge.cjs && tsc","build:dev":"BUILD_DEV=1 node scripts/generate-default-bridge.cjs && tsc","start":"node dist/cli.js","dev":"BUILD_DEV=1 node scripts/generate-default-bridge.cjs && tsc --watch"},"engines":{"node":">=18"},"dependencies":{"ws":"^8.18.0"},"devDependencies":{"@types/node":"^20.11.30","@types/ws":"^8.5.10","typescript":"^5.6.3"},"_id":"@daxiongmeizi/cursor-acp-miniapp@0.1.2","gitHead":"36825691a904b7757b4a99f5def48a91c79d5455","types":"./dist/index.d.ts","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-FvEvuy9+NvvkUcsQp7OMQkpvfRS5YL52hynY9IJ7RjUNs5vjyOXyzSoRayuCzOMue9VlMZOuAJVK65AqA/tnng==","shasum":"8cb1b9b060d4b6fcbe3419f55deb4b20a2580833","tarball":"https://registry.npmjs.org/@daxiongmeizi/cursor-acp-miniapp/-/cursor-acp-miniapp-0.1.2.tgz","fileCount":17,"unpackedSize":27639,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFt2fkNooyheboi1o6K4/xsIv2keWwGaHlXk81WuabAkAiB89YJB8rEgdu4Nrd3UiftSwHci86rl+GulAXMYWZIy8g=="}]},"_npmUser":{"name":"daxiongmeizi","email":"mister_jason@163.com"},"directories":{},"maintainers":[{"name":"daxiongmeizi","email":"mister_jason@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cursor-acp-miniapp_0.1.2_1773666352577_0.771693824531676"},"_hasShrinkwrap":false}},"maintainers":[{"name":"daxiongmeizi","email":"mister_jason@163.com"}],"description":"Bridge between miniapp-server and Cursor Agent ACP (stdio), for Cursor-type bots in 小爪对话屋","readme":"@daxiongmeizi/cursor-acp-miniapp\n\n小爪对话屋 **Cursor 机器人 miniapp 客户端**。  \n运行在用户本机，通过stdio与本地 Cursor 建立连接，为小爪对话屋小程序端提供与 Cursor 对话的能力。\n\n本包为 **独立 npm 包**，可单独安装和运行。\n\n## 前置条件\n\n## 获取 CURSOR_API_KEY\n\n1. 打开本地 Cursor 客户端；  \n2. 右上角进入 **Settings → Cloud Agents → Manage Settings**，点击 **Open**；  \n3. 浏览器会打开 `https://cursor.com/cn/dashboard/cloud-agents`（默认 Cloud Agents 页面）；  \n4. 在页面中找到 **User API Keys** 区域，点击 **New User API Key** 创建一个新的 key；  \n5. 将生成的 `crsr_xxx` 复制保存，稍后作为 `CURSOR_API_KEY` 使用。\n\n> 下文出现的 `crsr_xxx` 均指你在此处获得的 Cursor User API Key。\n\n- 已在本机安装 **Cursor 客户端**，并可正常登录使用；\n- 建议安装 **独立 Cursor CLI**，以便使用 `agent acp`：\n\n```bash\n# 安装独立 CLI（会安装可执行文件 agent）\ncurl https://cursor.com/install -fsS | bash\n```\n\n安装完成后，可在终端中验证：\n\n```bash\nagent --api-key YOUR_KEY acp\n```\n>YOUR_KEY 指上面获取的Cursor User API Key\n若能看到 JSON 行输出（或在等待 stdin 输入），说明 ACP 进程可用。\n\n\n\n## 安装与运行 cursor-acp-miniapp\n\n### 项目内安装 + npx（推荐）\n\n在 Cursor 编程客户端中新建一个终端，在其中执行：\n\n```bash\nnpm install @daxiongmeizi/cursor-acp-miniapp --save-dev\n\nCURSOR_API_KEY=crsr_xxx \\\nACP_COMMAND=\"$HOME/.local/bin/agent acp\" \\\nnpx cursor-acp-miniapp\n```\n\n或 cd 到你自定义的目录，执行：\n\n```bash\ncd your-project\nnpm install @daxiongmeizi/cursor-acp-miniapp --save-dev\n\nCURSOR_API_KEY=crsr_xxx \\\nACP_COMMAND=\"$HOME/.local/bin/agent acp\" \\\nnpx cursor-acp-miniapp\n```\n\n\n### 普通用户（全局安装）\n\n```bash\nnpm install -g @daxiongmeizi/cursor-acp-miniapp\n\nCURSOR_API_KEY=crsr_xxx \\\nACP_COMMAND=\"$HOME/.local/bin/agent acp\" \\\ncursor-acp-miniapp\n```\n\n\n## 配对与多窗口说明\n\n- **每个窗口 / 终端中运行的 bridge 实例都会生成自己的配对码**；  \n- 在小程序端配置机器人时，将配对码填入「窗口配对码」即可将该机器人与当前本机 Cursor 实例绑定；  \n- 通过为不同机器人设置不同配对码，可以实现：\n  - 「一个机器人对应一个本地 Cursor 实例」；\n  - 多窗口、多终端之间互不干扰。\n\n## 问题反馈\n\n如在使用过程中遇到问题或有功能建议，可在小程序中进入：  \n**「我的 → 意见反馈」** 提交，我们会尽量及时跟进和优化。  \n\n感谢你的使用，祝你编码顺利、体验愉快。\n\n","readmeFilename":"README.md"}