mvibe 0.1.0__tar.gz

mvibe-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yong Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mvibe-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: mvibe
+Version: 0.1.0
+Summary: Mirror a local Claude Code TUI to a remote chat (WeChat). Local stays identical; remote takes over I/O via a flag file.
+Project-URL: Homepage, https://github.com/wvalianty/mvibe
+Project-URL: Repository, https://github.com/wvalianty/mvibe
+Project-URL: Issues, https://github.com/wvalianty/mvibe/issues
+Author-email: Yong Wang <yong.wang@cobo.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude,claude-code,mirror,pty,remote,tui,wechat
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: pyte>=0.8.2
+Requires-Dist: segno>=1.6
+Description-Content-Type: text/markdown
+
+# mvibe
+
+把本地 **Claude Code** TUI 镜像到远程聊天（微信）。本地终端与直接运行 `claude`
+逐字节一致；两个开关（输入路由 `flag` + 输出/入站总闸 `gate`）决定远程接管程度。
+**全程只有一个 `claude` 进程**——切换只是 I/O 路由，不重启、不交接会话。
+
+## 工作原理
+
+```
+            ┌──────────── mvibe run（持 PTY master）────────────┐
+ 终端   ────┤ stdin → PTY     （local 路由；一敲键即夺回）       │
+        ←───┤ PTY  → stdout   （始终；远程驱动时也能围观）       │──► claude TUI
+            │ inject FIFO → PTY（remote 路由时）                │     （单进程）
+            └───────────────────────────────────────────────────┘        │ 写入
+                                                          .jsonl ◄─────────┘
+ 微信 ──long-poll 入站──► inject FIFO + flag=remote               │
+     ◄── 推送(iLink) ──── tail transcript .jsonl（assistant text）◄┘
+                       [mvibe bridge]（出站受 remote gate 控制，无网络监听）
+```
+
+- **本地保持真 TUI**（富渲染、slash 命令、plan mode）：PTY 透明透传，即
+  `script(1)` / `asciinema` 那套。
+- **远程输出 ≠ 裸 ANSI**：从会话 transcript（`~/.claude/projects/<cwd>/<id>.jsonl`）
+  读，而非镜像 PTY 字节——TUI 的 ANSI 流在聊天框里是乱码。
+- **远程输入**：当作键盘注入 PTY，驱动真 TUI。
+
+### 两个开关，别搞混
+
+- **`flag`（`~/.mvibe/active`，local|remote）= 输入路由**：谁的键盘进 claude。
+  入站消息置 `remote`；**本地敲任意键立即翻回 `local` 并夺回控制**（human 优先，
+  永不锁死）。这是输入端互斥，杜绝两人同敲。
+- **`gate`（remote on/off）= 输出镜像 + 入站总闸**：决定是否把 claude 回复推手机、
+  是否接受手机消息。`/mvibe-on` 开、`/mvibe-off` 关。
+- 二者解耦：所以你本地夺回打字（flag=local）时，回复仍会推手机（gate 仍 on）；
+  要彻底断开手机，`/mvibe-off`。
+
+## 安装
+
+```bash
+uv tool install --editable /path/to/mvibe    # 把 mvibe 装上全局 PATH
+cp /path/to/mvibe/commands/mvibe-*.md ~/.claude/commands/   # 装会话内 slash 开关
+mvibe login                                   # 一次性：扫码绑定微信 bot
+```
+
+依赖仅 `aiohttp` + `segno`（PyPI），**零 avibe 依赖**。
+
+## 用法（单终端，推荐）
+
+进到想用 claude 的目录，直接 `mvibe`——**裸 `mvibe` 等价于在当前目录 `mvibe up`**：
+同一终端前台跑 claude TUI，后台跑 bridge（镜像输出 + 微信入站轮询）。桥日志写
+`~/.mvibe/bridge.log`，不污染界面。
+
+```bash
+cd /path/to/project
+mvibe                 # = mvibe up，cwd 即当前目录
+```
+
+等价写法：`mvibe up`（同上）、`mvibe up --cwd /other/dir`（指定目录）。
+
+**传 claude 参数**：`--` 前是 mvibe 参数，后是 claude 参数（整条当命令运行）：
+
+```bash
+mvibe -- claude --resume 873fd8af-...      # 续接指定会话
+mvibe -- claude -c                          # 续接最近会话
+mvibe up --cwd /proj -- claude --model opus
+```
+
+`--` 后写程序名即可换后端（如 `mvibe -- codex ...`）。注意：显式 `-- <cmd>` 时
+mvibe 不再自动加 claude 默认参数（`--yolo` 等被忽略，全由你控制）。
+
+手机端：先给 bot 发一条消息建立会话，之后你发的内容驱动这个 Claude TUI，
+Claude 的回复以聊天消息返回。退出 claude（`/exit`）即整体结束。
+
+### 会话内开关（Claude slash 命令）
+
+把 `commands/mvibe-*.md` 拷到 `~/.claude/commands/`，即可在任意会话里：
+
+| 命令 | 作用 |
+|------|------|
+| `/mvibe-on`     | 开启远程接管（微信驱动会话） |
+| `/mvibe-off`    | 关闭远程接管（忽略微信，保持本地） |
+| `/mvibe-status` | 查看 remote 开关 / 路由 flag / transcript |
+
+`mvibe up` 默认 remote=on（`--no-remote` 可改）。
+
+**夺回控制**：远程接管时本地键盘被让出，但**只要你在本地敲任意键，立即夺回
+本地控制**（human 在场优先）——所以你永远不会被锁死，可随时打字。想彻底不让
+手机再抢，敲 `/mvibe-off`（关闭 gate）。下次手机消息会再次接管，除非 gate 关着。
+
+### 两终端模式（可选）
+
+```bash
+mvibe run --cwd .       # 终端1：claude TUI（必须先起）
+mvibe bridge --cwd .    # 终端2：镜像 + 入站
+```
+
+### 直接命令
+
+```bash
+mvibe remote on|off|status      # 远程接管开关
+mvibe flag remote|local         # 仅切路由
+mvibe send "继续"                # 注入一行到当前会话
+```
+
+无网络监听：微信入站是 long-poll（出站连接），本地控制全走 CLI + 文件。
+
+## 微信：独立 bot
+
+mvibe 端到端自持微信 bot——**零 avibe 依赖**、无需 service、无需公网 webhook：
+
+- **绑定**（`mvibe login`，`wechat_login.py`）：跑官方 iLink 扫码流程，把
+  `bot_token` / `base_url` / `user_id` 写入 `~/.mvibe/config.json`。
+- **入站**（`wechat_in.py`）：iLink `getUpdates` 长轮询，无需 webhook/公网。
+  每条消息产出 `(text, user_id)`，置 flag 为 `remote` 并把文本注入 PTY。同步游标
+  与每用户 `context_token` 持久化在 `~/.mvibe/state/`。
+- **出站**（`wechat_out.py`）：tailer 读到的 assistant 文本经 `send_message`
+  推手机，用记住的 `context_token` 寻址。**只在 remote gate 开启时推送**（跟 gate
+  走，不跟 flag），所以本地按键夺回输入不会吞掉回复。失败写 `~/.mvibe/bridge.log`
+  （如 `errcode -14` 会话过期，需手机再发条消息刷新）。
+
+iLink 协议代码 vendored 在 `mvibe/ilink/`（`wechat_api.py` / `wechat_auth.py`，
+源自 avibe，仅依赖 `aiohttp` + stdlib）。mvibe 不在运行时引用任何 avibe 安装。
+
+> 一个 bot_token 上不要同时跑两个 `getUpdates` 轮询（会争同步游标）。mvibe 有自己
+> 的登录/bot，与任何 avibe 实例互不干扰。
+
+## 安全
+
+远程聊天面拥有**完整 agent 权限**（Claude 可跑 bash/工具）。务必收紧入口：
+
+- **入站鉴权（默认安全）**：`mvibe login` 会写入 `wechat.user_id`，此后只有该
+  用户能驱动会话；其余被丢弃。多人放行用 `wechat.allowed_users: [...]`。若两者
+  皆空，则放行所有人并打印告警——别在这种状态下长期运行。
+- **无网络监听**：不开任何端口，没有可被本机其他进程访问的注入入口；入站只来自
+  已鉴权的微信 bot。
+- **凭证文件权限**：`~/.mvibe` 为 `0700`，`config.json` / `context_tokens` /
+  `sync_buf` 为 `0600`（仅本人可读）。
+- **注入消毒**：远程文本注入 PTY 前剥除 C0 控制符（含 ESC），防终端转义/控制键
+  注入；制表与换行保留。
+- **TLS**：若存在 `~/tmp/cacert.pem`，会经 `SSL_CERT_FILE` 启用该 CA bundle
+  （Cloudflare WARP 拦截环境所需）——这会扩大信任根，按需保留。
+
+## 交互确认转发（抓屏）
+
+claude 的确认框（「是否允许 Web Search？1/2/3」「(y/n)」）是 **TUI 界面元素**，不进
+transcript。mvibe 用**抓屏**把它转发到手机：
+
+- `mvibe up` 用 pyte 终端模拟器维护「渲染后的屏幕」，喂入 PTY 输出（`prompt_detect.py`）。
+- 屏幕稳定（停 ~300ms）且匹配「确认框形态」（编号选项 + 光标 ❯，或 `(y/n)`）时，
+  把框文本发手机：`⚠️ 需要确认：… 回复数字 或 yes/no`。
+- 手机回 `1`/`2`/`yes`/`no` → 映射成按键注入 TUI（`yes`→含 "Yes" 那项，`no`→"No"/取消）。
+- **remote gate 开启时就转发**（与出站镜像同规则，不看 flag）；手机或本地终端都能答。
+  久不回则框留着。不想被转发就 `/mvibe-off`。
+
+**后端无关**：机制（pyte 渲染 + 按键注入）跟谁是后端无关；只有「确认框形态」识别规则
+按后端配（现内置 claude 形态）。换 codex 等只需在 `prompt_detect.py` 加一条规则。
+
+限制 & 选项：
+
+- 仅 `mvibe up`（单进程）生效——PTY 字节只有 wrapper 进程有；两终端 `bridge` 看不到。
+- 完全不想要确认（自动跑）：`mvibe up --yolo`（给 claude 加 `--dangerously-skip-permissions`）。
+- 检测靠 UI 形态匹配，claude 改版可能要调 `prompt_detect.py` 的规则。
+- 远程能让 claude 跑任何工具——**靠入站 allowlist 限制是谁**（见安全）。
+
+## 注意事项
+
+- iLink 仅允许在手机最近一次给 bot 发消息后的窗口内推送（`context_token`）；
+  长时间空闲后推送可能报 errcode -14。
+- 键盘注入以 CR 提交；多行文本可能提前断行提交。
+- 两端必须用**相同 cwd**（transcript 目录按 cwd 编码）。
+
+## 项目结构
+
+```
+mvibe/
+  cli.py          命令行（argparse）：默认/up/run/bridge/login/remote/send/flag/status
+  wrapper.py      PTY mux 核心：本地透传 + flag 路由 + 本地按键夺回 + 注入消毒
+  bridge.py       后台：transcript→微信镜像 + 微信入站 poll（无网络监听）
+  tailer.py       follow transcript .jsonl，抽 assistant text
+  prompt_detect.py pyte 抓屏：检测确认框 → 回调（确认转发用）
+  wechat_in.py    iLink getUpdates 长轮询入站
+  wechat_out.py   iLink send_message 出站
+  wechat_login.py QR 扫码绑定
+  config.py       ~/.mvibe 凭证/tokens/sync_buf（0600）
+  paths.py        路径布局 + flag/gate + cwd→transcript 编码
+  _tls.py         可选 CA bundle
+  ilink/          vendored iLink 协议（wechat_api.py / wechat_auth.py，仅 aiohttp）
+commands/         Claude slash 命令模板（/mvibe-on /off /status）
+scripts/smoke.sh  本地自测（无微信、隔离 HOME）
+```
+
+## 自测
+
+```bash
+bash scripts/smoke.sh    # 9 项：注入/flag 互斥/消毒/HTTP/token/权限/tailer
+```
+
+不碰真 `~/.mvibe`（用隔离 `MVIBE_HOME`），无网络无微信，安全可随时跑。

mvibe-0.1.0/README.md

@@ -0,0 +1,198 @@
+# mvibe
+
+把本地 **Claude Code** TUI 镜像到远程聊天（微信）。本地终端与直接运行 `claude`
+逐字节一致；两个开关（输入路由 `flag` + 输出/入站总闸 `gate`）决定远程接管程度。
+**全程只有一个 `claude` 进程**——切换只是 I/O 路由，不重启、不交接会话。
+
+## 工作原理
+
+```
+            ┌──────────── mvibe run（持 PTY master）────────────┐
+ 终端   ────┤ stdin → PTY     （local 路由；一敲键即夺回）       │
+        ←───┤ PTY  → stdout   （始终；远程驱动时也能围观）       │──► claude TUI
+            │ inject FIFO → PTY（remote 路由时）                │     （单进程）
+            └───────────────────────────────────────────────────┘        │ 写入
+                                                          .jsonl ◄─────────┘
+ 微信 ──long-poll 入站──► inject FIFO + flag=remote               │
+     ◄── 推送(iLink) ──── tail transcript .jsonl（assistant text）◄┘
+                       [mvibe bridge]（出站受 remote gate 控制，无网络监听）
+```
+
+- **本地保持真 TUI**（富渲染、slash 命令、plan mode）：PTY 透明透传，即
+  `script(1)` / `asciinema` 那套。
+- **远程输出 ≠ 裸 ANSI**：从会话 transcript（`~/.claude/projects/<cwd>/<id>.jsonl`）
+  读，而非镜像 PTY 字节——TUI 的 ANSI 流在聊天框里是乱码。
+- **远程输入**：当作键盘注入 PTY，驱动真 TUI。
+
+### 两个开关，别搞混
+
+- **`flag`（`~/.mvibe/active`，local|remote）= 输入路由**：谁的键盘进 claude。
+  入站消息置 `remote`；**本地敲任意键立即翻回 `local` 并夺回控制**（human 优先，
+  永不锁死）。这是输入端互斥，杜绝两人同敲。
+- **`gate`（remote on/off）= 输出镜像 + 入站总闸**：决定是否把 claude 回复推手机、
+  是否接受手机消息。`/mvibe-on` 开、`/mvibe-off` 关。
+- 二者解耦：所以你本地夺回打字（flag=local）时，回复仍会推手机（gate 仍 on）；
+  要彻底断开手机，`/mvibe-off`。
+
+## 安装
+
+```bash
+uv tool install --editable /path/to/mvibe    # 把 mvibe 装上全局 PATH
+cp /path/to/mvibe/commands/mvibe-*.md ~/.claude/commands/   # 装会话内 slash 开关
+mvibe login                                   # 一次性：扫码绑定微信 bot
+```
+
+依赖仅 `aiohttp` + `segno`（PyPI），**零 avibe 依赖**。
+
+## 用法（单终端，推荐）
+
+进到想用 claude 的目录，直接 `mvibe`——**裸 `mvibe` 等价于在当前目录 `mvibe up`**：
+同一终端前台跑 claude TUI，后台跑 bridge（镜像输出 + 微信入站轮询）。桥日志写
+`~/.mvibe/bridge.log`，不污染界面。
+
+```bash
+cd /path/to/project
+mvibe                 # = mvibe up，cwd 即当前目录
+```
+
+等价写法：`mvibe up`（同上）、`mvibe up --cwd /other/dir`（指定目录）。
+
+**传 claude 参数**：`--` 前是 mvibe 参数，后是 claude 参数（整条当命令运行）：
+
+```bash
+mvibe -- claude --resume 873fd8af-...      # 续接指定会话
+mvibe -- claude -c                          # 续接最近会话
+mvibe up --cwd /proj -- claude --model opus
+```
+
+`--` 后写程序名即可换后端（如 `mvibe -- codex ...`）。注意：显式 `-- <cmd>` 时
+mvibe 不再自动加 claude 默认参数（`--yolo` 等被忽略，全由你控制）。
+
+手机端：先给 bot 发一条消息建立会话，之后你发的内容驱动这个 Claude TUI，
+Claude 的回复以聊天消息返回。退出 claude（`/exit`）即整体结束。
+
+### 会话内开关（Claude slash 命令）
+
+把 `commands/mvibe-*.md` 拷到 `~/.claude/commands/`，即可在任意会话里：
+
+| 命令 | 作用 |
+|------|------|
+| `/mvibe-on`     | 开启远程接管（微信驱动会话） |
+| `/mvibe-off`    | 关闭远程接管（忽略微信，保持本地） |
+| `/mvibe-status` | 查看 remote 开关 / 路由 flag / transcript |
+
+`mvibe up` 默认 remote=on（`--no-remote` 可改）。
+
+**夺回控制**：远程接管时本地键盘被让出，但**只要你在本地敲任意键，立即夺回
+本地控制**（human 在场优先）——所以你永远不会被锁死，可随时打字。想彻底不让
+手机再抢，敲 `/mvibe-off`（关闭 gate）。下次手机消息会再次接管，除非 gate 关着。
+
+### 两终端模式（可选）
+
+```bash
+mvibe run --cwd .       # 终端1：claude TUI（必须先起）
+mvibe bridge --cwd .    # 终端2：镜像 + 入站
+```
+
+### 直接命令
+
+```bash
+mvibe remote on|off|status      # 远程接管开关
+mvibe flag remote|local         # 仅切路由
+mvibe send "继续"                # 注入一行到当前会话
+```
+
+无网络监听：微信入站是 long-poll（出站连接），本地控制全走 CLI + 文件。
+
+## 微信：独立 bot
+
+mvibe 端到端自持微信 bot——**零 avibe 依赖**、无需 service、无需公网 webhook：
+
+- **绑定**（`mvibe login`，`wechat_login.py`）：跑官方 iLink 扫码流程，把
+  `bot_token` / `base_url` / `user_id` 写入 `~/.mvibe/config.json`。
+- **入站**（`wechat_in.py`）：iLink `getUpdates` 长轮询，无需 webhook/公网。
+  每条消息产出 `(text, user_id)`，置 flag 为 `remote` 并把文本注入 PTY。同步游标
+  与每用户 `context_token` 持久化在 `~/.mvibe/state/`。
+- **出站**（`wechat_out.py`）：tailer 读到的 assistant 文本经 `send_message`
+  推手机，用记住的 `context_token` 寻址。**只在 remote gate 开启时推送**（跟 gate
+  走，不跟 flag），所以本地按键夺回输入不会吞掉回复。失败写 `~/.mvibe/bridge.log`
+  （如 `errcode -14` 会话过期，需手机再发条消息刷新）。
+
+iLink 协议代码 vendored 在 `mvibe/ilink/`（`wechat_api.py` / `wechat_auth.py`，
+源自 avibe，仅依赖 `aiohttp` + stdlib）。mvibe 不在运行时引用任何 avibe 安装。
+
+> 一个 bot_token 上不要同时跑两个 `getUpdates` 轮询（会争同步游标）。mvibe 有自己
+> 的登录/bot，与任何 avibe 实例互不干扰。
+
+## 安全
+
+远程聊天面拥有**完整 agent 权限**（Claude 可跑 bash/工具）。务必收紧入口：
+
+- **入站鉴权（默认安全）**：`mvibe login` 会写入 `wechat.user_id`，此后只有该
+  用户能驱动会话；其余被丢弃。多人放行用 `wechat.allowed_users: [...]`。若两者
+  皆空，则放行所有人并打印告警——别在这种状态下长期运行。
+- **无网络监听**：不开任何端口，没有可被本机其他进程访问的注入入口；入站只来自
+  已鉴权的微信 bot。
+- **凭证文件权限**：`~/.mvibe` 为 `0700`，`config.json` / `context_tokens` /
+  `sync_buf` 为 `0600`（仅本人可读）。
+- **注入消毒**：远程文本注入 PTY 前剥除 C0 控制符（含 ESC），防终端转义/控制键
+  注入；制表与换行保留。
+- **TLS**：若存在 `~/tmp/cacert.pem`，会经 `SSL_CERT_FILE` 启用该 CA bundle
+  （Cloudflare WARP 拦截环境所需）——这会扩大信任根，按需保留。
+
+## 交互确认转发（抓屏）
+
+claude 的确认框（「是否允许 Web Search？1/2/3」「(y/n)」）是 **TUI 界面元素**，不进
+transcript。mvibe 用**抓屏**把它转发到手机：
+
+- `mvibe up` 用 pyte 终端模拟器维护「渲染后的屏幕」，喂入 PTY 输出（`prompt_detect.py`）。
+- 屏幕稳定（停 ~300ms）且匹配「确认框形态」（编号选项 + 光标 ❯，或 `(y/n)`）时，
+  把框文本发手机：`⚠️ 需要确认：… 回复数字 或 yes/no`。
+- 手机回 `1`/`2`/`yes`/`no` → 映射成按键注入 TUI（`yes`→含 "Yes" 那项，`no`→"No"/取消）。
+- **remote gate 开启时就转发**（与出站镜像同规则，不看 flag）；手机或本地终端都能答。
+  久不回则框留着。不想被转发就 `/mvibe-off`。
+
+**后端无关**：机制（pyte 渲染 + 按键注入）跟谁是后端无关；只有「确认框形态」识别规则
+按后端配（现内置 claude 形态）。换 codex 等只需在 `prompt_detect.py` 加一条规则。
+
+限制 & 选项：
+
+- 仅 `mvibe up`（单进程）生效——PTY 字节只有 wrapper 进程有；两终端 `bridge` 看不到。
+- 完全不想要确认（自动跑）：`mvibe up --yolo`（给 claude 加 `--dangerously-skip-permissions`）。
+- 检测靠 UI 形态匹配，claude 改版可能要调 `prompt_detect.py` 的规则。
+- 远程能让 claude 跑任何工具——**靠入站 allowlist 限制是谁**（见安全）。
+
+## 注意事项
+
+- iLink 仅允许在手机最近一次给 bot 发消息后的窗口内推送（`context_token`）；
+  长时间空闲后推送可能报 errcode -14。
+- 键盘注入以 CR 提交；多行文本可能提前断行提交。
+- 两端必须用**相同 cwd**（transcript 目录按 cwd 编码）。
+
+## 项目结构
+
+```
+mvibe/
+  cli.py          命令行（argparse）：默认/up/run/bridge/login/remote/send/flag/status
+  wrapper.py      PTY mux 核心：本地透传 + flag 路由 + 本地按键夺回 + 注入消毒
+  bridge.py       后台：transcript→微信镜像 + 微信入站 poll（无网络监听）
+  tailer.py       follow transcript .jsonl，抽 assistant text
+  prompt_detect.py pyte 抓屏：检测确认框 → 回调（确认转发用）
+  wechat_in.py    iLink getUpdates 长轮询入站
+  wechat_out.py   iLink send_message 出站
+  wechat_login.py QR 扫码绑定
+  config.py       ~/.mvibe 凭证/tokens/sync_buf（0600）
+  paths.py        路径布局 + flag/gate + cwd→transcript 编码
+  _tls.py         可选 CA bundle
+  ilink/          vendored iLink 协议（wechat_api.py / wechat_auth.py，仅 aiohttp）
+commands/         Claude slash 命令模板（/mvibe-on /off /status）
+scripts/smoke.sh  本地自测（无微信、隔离 HOME）
+```
+
+## 自测
+
+```bash
+bash scripts/smoke.sh    # 9 项：注入/flag 互斥/消毒/HTTP/token/权限/tailer
+```
+
+不碰真 `~/.mvibe`（用隔离 `MVIBE_HOME`），无网络无微信，安全可随时跑。

mvibe-0.1.0/commands/mvibe-off.md

@@ -0,0 +1,10 @@
+---
+description: Turn OFF mvibe remote takeover; keep control local
+disable-model-invocation: true
+allowed-tools: Bash(mvibe remote off)
+---
+
+!`mvibe remote off`
+
+mvibe remote takeover is now **OFF** — incoming WeChat messages are ignored; the
+terminal keeps control.

mvibe-0.1.0/commands/mvibe-on.md

@@ -0,0 +1,9 @@
+---
+description: Turn ON mvibe remote (WeChat) takeover for this session
+disable-model-invocation: true
+allowed-tools: Bash(mvibe remote on)
+---
+
+!`mvibe remote on`
+
+mvibe remote takeover is now **ON** — WeChat messages will drive this session.

mvibe-0.1.0/commands/mvibe-status.md

@@ -0,0 +1,7 @@
+---
+description: Show mvibe remote on/off + routing flag + active transcript
+disable-model-invocation: true
+allowed-tools: Bash(mvibe remote status), Bash(mvibe status)
+---
+
+!`mvibe remote status && mvibe status`

mvibe-0.1.0/mvibe/__init__.py

@@ -0,0 +1,8 @@
+"""mvibe — mirror a local Claude Code TUI to a remote chat surface.
+
+Single live `claude` process. A PTY wrapper keeps the local terminal identical
+to running `claude` directly, while a flag file toggles whether remote (WeChat)
+input is injected and remote output is mirrored. No process restart on switch.
+"""
+
+__version__ = "0.1.0"

mvibe-0.1.0/mvibe/_tls.py

@@ -0,0 +1,17 @@
+"""TLS CA setup for environments that intercept HTTPS (e.g. Cloudflare WARP).
+
+If ~/tmp/cacert.pem exists, point SSL at it. Optional; no-op otherwise.
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+_CA_BUNDLE = Path.home() / "tmp/cacert.pem"
+
+
+def setup_tls_ca() -> None:
+    if _CA_BUNDLE.is_file():
+        os.environ.setdefault("SSL_CERT_FILE", str(_CA_BUNDLE))
+        os.environ.setdefault("REQUESTS_CA_BUNDLE", str(_CA_BUNDLE))