IDE 集成¶

WeiLink 可以集成到 AI 编程助手中，让你在编程会话中直接收发微信消息。weilink setup 命令自动完成 hooks、MCP 服务器配置和 slash 命令的安装。

pip install weilink[mcp]

支持的助手¶

Claude Code¶

weilink setup claude-code

在 ~/.claude/plugins/weilink/ 创建软链接，指向内置的集成资源目录。安装后重启 Claude Code 即可激活。

安装内容¶

自动轮询原理¶

sequenceDiagram
    participant U as 用户
    participant CC as Claude Code
    participant H as poll_inject.py
    participant DB as messages.db

    U->>CC: 提交 prompt
    CC->>H: UserPromptSubmit hook
    H->>DB: 查询上次检查以来的新消息
    DB-->>H: 新消息（如有）
    H-->>CC: {"additionalContext": "== New WeChat Messages ==\n..."}
    CC->>U: 响应（包含消息上下文）

每次提交 prompt 时，UserPromptSubmit hook 运行 weilink hook-poll 检查本地 SQLite 消息存储中自上次检查以来收到的新消息。如果有新消息，会以 additionalContext 的形式注入到 Claude 的上下文中。这是一个纯本地操作（无网络调用），通常在 100ms 内完成。

选项¶

Codex (OpenAI)¶

weilink setup codex

安装 hook 脚本，将 hook 注册合并到 ~/.codex/hooks.json，并复制 /weilink slash 命令。

安装内容¶

MCP 注册¶

安装后需手动注册 MCP 服务器：

codex mcp add weilink -- weilink mcp

选项¶

OpenCode¶

weilink setup opencode

将 WeiLink MCP 服务器添加到 ~/.config/opencode/opencode.json，并安装 /weilink slash 命令。

安装内容¶

选项¶

手动配置¶

对于其他工具（Cursor、VS Code、Claude Desktop 等），请手动配置 MCP 服务器。参见 MCP 服务器 — 客户端配置 中的示例。

如果你的工具支持 UserPromptSubmit hook，可以创建一个 hook 运行：

weilink hook-poll

该命令输出 JSON：

{"has_messages": true, "count": 3, "context": "== New WeChat Messages ==\n..."}

将 context 值包装为 {"additionalContext": "<context>"} 输出到 hook 的 stdout 即可。

weilink hook-poll¶

Hook 脚本使用的内部命令。从本地 SQLite 消息存储中读取上次检查以来收到的消息。

weilink hook-poll                # 轮询新消息
weilink hook-poll --limit 50     # 最多返回 50 条消息
weilink hook-poll --reset        # 清除轮询状态并退出

状态记录在 ~/.weilink/.hook_state.json 中。首次运行（或 --reset 后）回溯 5 分钟。