# PointJump

**Repository Path**: masonzhao/point_jump

## Basic Information

- **Project Name**: PointJump
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-29
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# point_jump

从手机（**企业微信** 或 钉钉）给本机 AI Agent 下指令：打开项目、修 bug、打包并把产物路径回传。

支持 **Windows** 与 **Ubuntu**。一期以 Cursor SDK local 为主；Codex / VS Code 为适配器预留。

> 个人微信没有官方机器人长连接。若要用微信聊天：先接 **企业微信智能机器人**，再在企微后台开通「微信插件」，个人微信也能发。

## 架构

```
企业微信 / 钉钉 手机端
        ↓ 长连接（无需公网回调）
  本机守护进程 point_jump
        ↓
  Cursor SDK / Codex / VS Code
        ↓
  本机项目目录 → 进度/产物回传手机
```

## 环境要求

| 项目 | 说明 |
|------|------|
| Node.js | >= 22.13（Cursor SDK 要求） |
| OS | Windows 10+ 或 Ubuntu 22.04+ |
| 通道 | `CHANNEL=wecom`（推荐）或 `CHANNEL=dingtalk` |
| Cursor | 本机配置 `CURSOR_API_KEY` |

### 快速开始

```bash
cp .env.example .env
cp config.example.yaml config.yaml
# 编辑 .env：CHANNEL + 对应凭证 + CURSOR_API_KEY
# 编辑 config.yaml：allowedRoots、allowSenderStaffIds、projects
npm install
npm start
```

## 企业微信配置（推荐）

钉钉若无法发布，用这条。

1. 登录 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame)
2. **应用管理 → 智能机器人 → 创建**
3. API 模式选 **长连接（WebSocket）**，保存后立刻复制 **BotID**、**Secret**（Secret 只显示一次）
4. `.env` 填写：
   ```env
   CHANNEL=wecom
   WECOM_BOT_ID=...
   WECOM_BOT_SECRET=...
   CURSOR_API_KEY=...
   ```
5. `npm start`，日志出现 `WeCom subscribed`
6. 企业微信里找到该智能机器人，发 `帮助`
7. 把回复/日志里的 `userid` 写入 `config.yaml` 的 `allowSenderStaffIds`

可选：后台 **我的企业 → 微信插件**，扫码后个人微信也能聊同一应用。

文档：https://developer.work.weixin.qq.com/document/path/101463

## 钉钉配置（备选）

1. [钉钉开放平台](https://open-dev.dingtalk.com/) → 企业内部应用
2. 机器人能力选 **Stream**，并完成发布、可见范围包含自己
3. `.env`：
   ```env
   CHANNEL=dingtalk
   DINGTALK_CLIENT_ID=...
   DINGTALK_CLIENT_SECRET=...
   ```

## 常用指令

| 指令 | 作用 |
|------|------|
| `打开 point_jump` / `use foo` | 绑定项目别名或路径 |
| `修一下登录白屏` | 在当前工作区跑 Agent |
| `用 cursor` | 切换引擎 |
| `打包并发我` | 执行预配置 build 并回报产物 |
| `状态` / `取消` | 查看或取消当前任务 |
| `帮助` | 指令说明 |

## 脚本

```bash
npm start
npm run dev
npm run build
npm run typecheck
```

## systemd（Ubuntu）

见 [deploy/point-jump.service](deploy/point-jump.service)。

## 安全

- 白名单为空或仍是 `REPLACE_...` 时拒绝所有人
- 工作区必须在 `allowedRoots` 内
- 禁止任意 shell；仅 Agent + 配置的 build/test
- `.env` / `config.yaml` 勿提交仓库