chore: import upstream snapshot with attribution
This commit is contained in:
@@ -0,0 +1,139 @@
|
||||
---
|
||||
name: wechat-claude-code
|
||||
description: 微信消息桥接 - 在微信中与 Claude Code 聊天。支持文字对话、图片识别、实时进度推送、斜杠命令。
|
||||
---
|
||||
|
||||
# WeChat Claude Code Bridge
|
||||
|
||||
通过个人微信与本地 Claude Code 进行对话。
|
||||
|
||||
## 前置条件
|
||||
|
||||
- Node.js >= 18
|
||||
- macOS(daemon 使用 launchd 管理)
|
||||
- 个人微信账号(需扫码绑定)
|
||||
- 已安装 Claude Code(`@anthropic-ai/claude-agent-sdk`)
|
||||
|
||||
## 安装
|
||||
|
||||
**方式一:通过 skills CLI(推荐)**
|
||||
|
||||
```bash
|
||||
npx skills add Wechat-ggGitHub/wechat-claude-code
|
||||
```
|
||||
|
||||
首次触发时 skill 会自动克隆完整项目源码并安装依赖。
|
||||
|
||||
**方式二:手动克隆**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/Wechat-ggGitHub/wechat-claude-code.git ~/.claude/skills/wechat-claude-code
|
||||
cd ~/.claude/skills/wechat-claude-code && npm install
|
||||
```
|
||||
|
||||
## 触发场景
|
||||
|
||||
用户提到"微信桥接"、"微信聊天"、"wechat bridge"、"连接微信"、"微信状态"、"停止微信"等与微信桥接相关的话题时触发。
|
||||
|
||||
## 触发后的执行流程
|
||||
|
||||
**被触发时,不要直接执行任何操作,先探查当前状态再给出可用操作。**
|
||||
|
||||
按顺序检查以下状态:
|
||||
|
||||
### 第 1 步:检查项目是否完整安装
|
||||
|
||||
```bash
|
||||
test -f ~/.claude/skills/wechat-claude-code/package.json && echo "source_ok" || echo "source_missing"
|
||||
```
|
||||
|
||||
- 如果 `source_missing`:需要从 GitHub 克隆完整项目。执行:
|
||||
```bash
|
||||
git clone https://github.com/Wechat-ggGitHub/wechat-claude-code.git /tmp/wechat-claude-code-install && cp -r /tmp/wechat-claude-code-install/{src,scripts,*.ts,*.json,*.md,LICENSE} ~/.claude/skills/wechat-claude-code/ && rm -rf /tmp/wechat-claude-code-install
|
||||
```
|
||||
然后继续检查依赖。
|
||||
|
||||
- 如果 `source_ok`:继续检查依赖。
|
||||
|
||||
```bash
|
||||
cd ~/.claude/skills/wechat-claude-code && test -d node_modules && echo "deps_ok" || echo "deps_missing"
|
||||
```
|
||||
|
||||
- 如果 `deps_missing`:执行 `cd ~/.claude/skills/wechat-claude-code && npm install` 安装依赖,然后继续。
|
||||
- 如果 `deps_ok`:继续下一步。
|
||||
|
||||
### 第 2 步:检查是否已绑定微信账号
|
||||
|
||||
```bash
|
||||
ls ~/.wechat-claude-code/accounts/*.json 2>/dev/null | head -1
|
||||
```
|
||||
|
||||
- 如果没有账号文件:提示用户需要先执行 setup 扫码绑定,询问是否现在执行。
|
||||
- 如果有账号文件:继续下一步。
|
||||
|
||||
### 第 3 步:检查 daemon 运行状态
|
||||
|
||||
```bash
|
||||
cd ~/.claude/skills/wechat-claude-code && npm run daemon -- status
|
||||
```
|
||||
|
||||
### 第 4 步:根据状态展示信息
|
||||
|
||||
**如果 daemon 未运行:**
|
||||
|
||||
```
|
||||
微信桥接已绑定但未运行。
|
||||
|
||||
可用操作:
|
||||
setup 重新扫码绑定(换号或过期时使用)
|
||||
start 启动服务
|
||||
logs 查看上次运行的日志
|
||||
```
|
||||
|
||||
**如果 daemon 正在运行:**
|
||||
|
||||
```
|
||||
微信桥接正在运行(PID: xxx)。
|
||||
|
||||
可用操作:
|
||||
stop 停止服务
|
||||
restart 重启服务(代码更新后使用)
|
||||
logs 查看运行日志
|
||||
|
||||
微信端命令(直接在微信中发送):
|
||||
/help 显示帮助
|
||||
/clear 清除当前会话,开始新对话
|
||||
/status 查看当前会话状态
|
||||
/model 切换 Claude 模型
|
||||
/prompt 设置系统提示词
|
||||
/cwd 切换工作目录
|
||||
/skills 查看已安装的 skill
|
||||
```
|
||||
|
||||
如果用户明确指定了操作(如"启动微信"、"停止微信服务"、"看看日志"等),跳过状态展示直接执行对应命令。
|
||||
|
||||
## 子命令参考
|
||||
|
||||
所有命令的工作目录为 `~/.claude/skills/wechat-claude-code`。
|
||||
|
||||
| 命令 | 执行 | 说明 |
|
||||
|------|------|------|
|
||||
| setup | `npm run setup` | 首次安装向导:生成 QR 码 → 微信扫码 → 配置工作目录 |
|
||||
| start | `npm run daemon -- start` | 启动 launchd 守护进程(开机自启、自动重启) |
|
||||
| stop | `npm run daemon -- stop` | 停止守护进程 |
|
||||
| restart | `npm run daemon -- restart` | 重启守护进程 |
|
||||
| status | `npm run daemon -- status` | 查看运行状态 |
|
||||
| logs | `npm run daemon -- logs` | 查看最近日志(tail -100) |
|
||||
|
||||
## 数据目录
|
||||
|
||||
所有数据存储在 `~/.wechat-claude-code/`:
|
||||
|
||||
```
|
||||
~/.wechat-claude-code/
|
||||
├── accounts/ # 绑定的微信账号数据(每个账号一个 JSON)
|
||||
├── config.env # 全局配置(工作目录、模型、系统提示词)
|
||||
├── sessions/ # 会话数据(每个账号一个 JSON)
|
||||
├── get_updates_buf # 消息轮询同步缓冲
|
||||
└── logs/ # 运行日志(每日轮转,保留 30 天)
|
||||
```
|
||||
Reference in New Issue
Block a user