yee88

本项目 fork 自 takopi，在其基础上扩展了多模态图文、项目级配置、回复追踪、定时任务增强等功能。

Telegram 桥接工具，连接 Codex、Claude Code、OpenCode、Pi 等 AI 编程引擎。

快速开始

# 安装
uv tool install -U yee88

# 首次运行 - 跟随设置向导完成配置
yee88

# 安装 yee88 skill（为 AI 引擎提供 yee88 CLI 能力）
npx skills add yee94/yee88

# 在任意 git 仓库中 - 创建话题并启动
cd ~/your-project
yee88 topic init
yee88

功能特性

多模态图文：AI 回复中的图片自动发送为 Telegram 照片；用户发送图片/文件自动上传给 AI 处理
回复追踪：回复 Telegram 历史消息自动恢复对应 session 上下文
项目级配置：每个项目可独立配置模型、session 模式、skill 和 Agent 行为
状态栏美化：精简 emoji 状态指示、模型名称智能美化、上下文路径可视化
话题分叉：/fork 命令将当前话题分叉到新 topic，支持多线程探索
项目与工作树：同时在多个仓库/分支上工作，分支基于 git worktree
无状态恢复：在聊天中继续对话，或复制恢复命令在终端中接续
进度流式输出：实时显示命令、工具调用、文件变更、耗时
并行运行：跨 agent 会话并行执行，每个会话独立队列
Telegram 特性：支持语音消息、定时消息、智能问候等 Telegram 原生功能
文件传输：向仓库发送文件，或从仓库获取文件/目录
发送文件/图片：通过 yee88 send-file 命令发送文件到 Telegram（自动识别图片类型）
群组与话题：将群组话题映射到仓库/分支上下文
定时任务：通过 yee88 cron 管理定时提醒和自动化任务，支持一次性延迟和独立引擎配置
兼容现有订阅：支持 Anthropic 和 OpenAI 现有订阅

环境要求

uv 包管理器（curl -LsSf https://astral.sh/uv/install.sh | sh）
Python 3.14+（uv python install 3.14）
至少一个引擎在 PATH 中：codex、claude、opencode 或 pi
Node.js（用于安装 skill：npx skills add yee94/yee88）

使用方法

cd ~/dev/happy-gadgets
yee88

向你的 bot 发送消息。使用 /codex、/claude、/opencode 或 /pi 前缀选择引擎。回复消息可继续对话。

项目管理

# 注册项目
yee88 init happy-gadgets

# 从任意位置向项目发送指令
/happy-gadgets 重构用户认证模块

# 指定分支，在独立工作树中运行
/happy-gadgets @feat/memory-box 冻结所有构件

配置管理

yee88 config list          # 列出所有配置
yee88 config get <key>     # 获取配置项
yee88 config set <key> <value>  # 设置配置项

定时任务

yee88 cron add reminder "+30m" "该休息了" -o    # 30分钟后一次性提醒
yee88 cron add standup "0 9 * * 1-5" "站会时间"  # 工作日每天9点
yee88 cron list                                   # 查看所有任务
yee88 cron remove <id> --force                    # 删除任务

发送文件

yee88 send-file /path/to/image.png                # 发送图片（聊天中直接显示）
yee88 send-file /path/to/report.pdf --caption "日报"  # 发送文件附件

Skill 安装

yee88 提供 AI 引擎 skill，让 OpenCode、Claude Code 等引擎能够直接调用 yee88 CLI 命令（如定时提醒、发送文件等）。

# 通过 npx 安装（推荐）
npx skills add yee94/yee88

# 或在首次运行时通过 --onboard 向导安装
yee88 --onboard

插件

yee88 支持基于 entrypoint 的插件系统，可扩展引擎、传输层和命令。

详见 docs/how-to/write-a-plugin.md 和 docs/reference/plugin-api.md。

开发

详见 docs/reference/specification.md 和 docs/developing.md。

Release files for yee88 0.11.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yee88 0.11.6
File	Size	Uploaded
yee88-0.11.6.tar.gz	939.0 kB	Jul 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for yee88 0.11.6
File	Interpreter	ABI	Platform	Reset
yee88-0.11.6-py3-none-any.whl 227.8 kB Jul 9, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / yee88-0.11.6.tar.gz

Download URL	yee88-0.11.6.tar.gz
Size	939.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`cac60386e7ef79c43727541cdcc1fd8b089fea07acbac0ff46b251dd4239b1dd`
BLAKE2b-256 checksum How to use checksums	`81d4a0d6ce3f609998d9fa84ac7faba42add8090912abe0bfe7c5160c5eabebe`
Upload date	Jul 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / yee88-0.11.6-py3-none-any.whl

Download URL	yee88-0.11.6-py3-none-any.whl
Size	227.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`92f8b35eea8bcbf4f56196b7d0d63b4fc1a6114b5d564ba9d2a82e48edc4069a`
BLAKE2b-256 checksum How to use checksums	`5d9416e0ccd5f3b5297342f9e8d0ccc72c777c831c0182ad2c18e170ade6d9a2`
Upload date	Jul 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`