yee88 0.7.0__tar.gz → 0.7.1__tar.gz

{yee88-0.7.0 → yee88-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yee88
-Version: 0.7.0
+Version: 0.7.1
 Summary: Telegram bridge for Codex, Claude Code, and other agent CLIs.
 Project-URL: Homepage, https://github.com/banteg/yee88
 Project-URL: Documentation, https://yee88.dev/

{yee88-0.7.0 → yee88-0.7.1}/changelog.md

@@ -1,16 +1,38 @@
 # changelog
 
+## v0.7.0 (2026-02-01)
+
+### features
+
+- add `/handoff` command to transfer desktop session to mobile seamlessly
+
+### fixes
+
+- fix scheduled task trigger issues in cron scheduler
+
+## v0.6.3 (2026-02-01)
+
+### features
+
+- add `/model reset` subcommand to clear model overrides
+
 ## v0.6.2 (2026-01-31)
 
 ### changes
 
 - optimize system_prompt handling: only prepend on first run to save tokens
 
+## v0.6.1 (2026-01-31)
+
+### fixes
+
+- correct system_prompt syntax error in settings
+
 ## v0.6.0 (2026-01-31)
 
 ### features
 
-- add one-time task execution support in cron
+- add one-time task execution support in cron scheduler
 
 ### docs
 
@@ -20,11 +42,16 @@
 
 - update system prompt wording
 
-## v0.2.0 (2026-01-30)
+## v0.5.0 (2026-01-31)
 
 ### changes
 
-- rename startup message from "yee88 is ready" to "yee88 is ready"
+- fork baseline from upstream v0.21.4
+- minor fixes and improvements
+
+---
+
+## upstream changelog (v0.21.4 and earlier)
 
 ## v0.21.4 (2026-01-22)
 

{yee88-0.7.0 → yee88-0.7.1}/docs/user-guide-zh.md

@@ -2,6 +2,8 @@
 
 yee88 是一个 Telegram 桥接工具，让你可以通过 Telegram 聊天界面来运行 AI 编程助手（Codex、Claude Code、OpenCode、Pi）。
 
+**当前版本: v0.7.1**
+
 ⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
 
 ## 📦 一、安装与初始化（💻 电脑侧）
@@ -440,7 +442,77 @@ show_resume_line = true         # 始终显示恢复行
 
 ⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
 
-## 📝 十二、使用技巧
+## 📲 十二、会话接力（Handoff）
+
+将电脑端的 OpenCode 会话上下文发送到 Telegram，方便在手机上继续对话。
+
+### 使用方法（💻 电脑侧）
+
+```bash
+yee88 handoff
+```
+
+### 工作流程
+
+1. 自动列出当前项目的最近会话（带话题名称）
+2. 选择要接力的会话
+3. 自动创建新的 Telegram Topic
+4. 将会话上下文和最近消息发送到 Topic
+5. 在 Telegram 中直接继续对话
+
+### 选项
+
+| 选项 | 说明 |
+|------|------|
+| `--session, -s` | 指定会话 ID（默认交互选择） |
+| `--limit, -n` | 包含的消息数量（默认 3） |
+| `--project, -p` | 项目名称 |
+
+### 示例
+
+```bash
+# 交互式选择会话
+yee88 handoff
+
+# 指定会话和消息数量
+yee88 handoff -s ses_abc123 -n 5
+```
+
+### 前置条件
+
+- 需要启用 Topics 模式：`yee88 config set transports.telegram.topics.enabled true`
+- 需要配置 Telegram bot_token 和 chat_id
+
+⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
+
+## 🔀 十三、话题分叉（Fork）
+
+在 Telegram Topics 模式下，将当前话题的上下文和会话状态分叉到一个新话题。
+
+### 使用方法
+
+在任意话题中发送：
+
+```
+/fork
+```
+
+### 功能说明
+
+- 自动创建新话题，标题格式：`原话题 (fork #1)`
+- 支持多次分叉，自动递增编号：`原话题 (fork #2)`、`原话题 (fork #3)`...
+- 复制原话题的上下文和会话状态到新话题
+- 在新话题中继续对话，不影响原话题
+
+### 使用场景
+
+- 从当前对话中派生新的探索方向
+- 保存当前状态，尝试不同的解决方案
+- 多人协作时创建个人工作分支
+
+⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
+
+## 📝 十四、使用技巧
 
 ### 1. 快速切换上下文
 
@@ -479,3 +551,20 @@ codex resume <token>
 /claude 优化代码结构
 /opencode 添加测试
 ```
+
+⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
+
+## 📋 版本历史
+
+### v0.7.1 (2025-02-01)
+
+**新功能**
+- ✨ **话题分叉 (`/fork`)**: 在 Topics 模式下将当前话题上下文分叉到新话题，支持多次分叉自动编号
+- ✨ **会话接力 (`yee88 handoff`)**: 将电脑端 OpenCode 会话发送到 Telegram 继续对话
+
+**改进**
+- 优化 handoff 命令的输出提示信息
+
+### v0.7.0
+
+- 初始版本发布

{yee88-0.7.0 → yee88-0.7.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "yee88"
 authors = [{name = "yee.wang"}]
-version = "0.7.0"
+version = "0.7.1"
 description = "Telegram bridge for Codex, Claude Code, and other agent CLIs."
 readme = "README.md"
 license = { file = "LICENSE" }

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/cli/handoff.py

@@ -223,6 +223,8 @@ def send(
             typer.echo("❌ 未找到 OpenCode 会话", err=True)
             raise typer.Exit(1)
         
+        typer.echo("\n📲 会话接力 - 将电脑端会话发送到 Telegram 继续对话")
+        typer.echo("━" * 50)
         typer.echo("\n📋 最近的会话:\n")
         for i, s in enumerate(sessions[:10], 1):
             title_display = s.title[:40] if s.title else s.project_name

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/ids.py

@@ -7,7 +7,7 @@ _ID_RE = re.compile(ID_PATTERN)
 
 RESERVED_CLI_COMMANDS = frozenset({"config", "doctor", "init", "plugins"})
 RESERVED_CHAT_COMMANDS = frozenset(
-    {"cancel", "file", "new", "agent", "model", "reasoning", "trigger", "topic", "ctx"}
+    {"cancel", "file", "new", "fork", "agent", "model", "reasoning", "trigger", "topic", "ctx"}
 )
 RESERVED_ENGINE_IDS = RESERVED_CLI_COMMANDS | RESERVED_CHAT_COMMANDS
 RESERVED_COMMAND_IDS = RESERVED_CLI_COMMANDS | RESERVED_CHAT_COMMANDS

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/skills/yee88/SKILL.md

@@ -525,12 +525,38 @@ yee88 cron run <task-id>
    - 执行后自动从列表中删除
    - 无法对一次性任务使用 enable/disable（执行前自动删除）
 
+### 10. 会话接力（Handoff）
+
+将当前 OpenCode 会话上下文发送到 Telegram，方便在手机上继续对话。
+
+```bash
+yee88 handoff
+```
+
+功能：
+- 自动列出当前项目的最近会话（带话题名称）
+- 选择会话后，创建新的 Telegram Topic
+- 将会话上下文和最近消息发送到 Topic
+- 在 Telegram 中直接继续对话
+
+选项：
+- `--session, -s`: 指定会话 ID（默认交互选择）
+- `--limit, -n`: 包含的消息数量（默认 3）
+- `--project, -p`: 项目名称
+
+示例：
+```bash
+yee88 handoff
+yee88 handoff -s ses_abc123 -n 5
+```
+
 ## 完整命令速查表
 
 | 命令 | 说明 |
 |------|------|
 | `yee88` | 启动 yee88 |
 | `yee88 init <alias>` | 注册项目 |
+| `yee88 handoff` | 会话接力到 Telegram |
 | `yee88 config path` | 查看配置路径 |
 | `yee88 config list` | 列出配置 |
 | `yee88 config get <key>` | 获取配置项 |

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/telegram/commands/handlers.py

@@ -18,6 +18,7 @@ from .reasoning import _handle_reasoning_command as handle_reasoning_command
 from .topics import _handle_chat_new_command as handle_chat_new_command
 from .topics import _handle_chat_ctx_command as handle_chat_ctx_command
 from .topics import _handle_ctx_command as handle_ctx_command
+from .topics import _handle_fork_command as handle_fork_command
 from .topics import _handle_new_command as handle_new_command
 from .topics import _handle_topic_command as handle_topic_command
 from .trigger import _handle_trigger_command as handle_trigger_command
@@ -31,6 +32,7 @@ __all__ = [
     "handle_ctx_command",
     "handle_file_command",
     "handle_file_put_default",
+    "handle_fork_command",
     "handle_media_group",
     "handle_model_command",
     "handle_new_command",

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/telegram/commands/menu.py

@@ -83,7 +83,10 @@ def build_bot_commands(
         commands.append({"command": cmd, "description": description})
         seen.add(cmd)
     if include_topics:
-        for cmd, description in [("topic", "create or bind a topic")]:
+        for cmd, description in [
+            ("topic", "create or bind a topic"),
+            ("fork", "fork current topic to new topic"),
+        ]:
             if cmd in seen:
                 continue
             commands.append({"command": cmd, "description": description})

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/telegram/commands/topics.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import re as _re
 from typing import TYPE_CHECKING
 
 from ...context import RunContext
@@ -340,3 +341,84 @@ async def _handle_topic_command(
         message=RenderedMessage(text=rendered_text, extra={"entities": entities}),
         options=SendOptions(thread_id=thread_id),
     )
+
+
+_FORK_TITLE_PATTERN = _re.compile(r"^(.+) \(fork #(\d+)\)$")
+
+
+def _get_forked_title(title: str | None) -> str:
+    if title is None:
+        return "topic (fork #1)"
+    match = _FORK_TITLE_PATTERN.match(title)
+    if match:
+        base = match.group(1)
+        num = int(match.group(2))
+        return f"{base} (fork #{num + 1})"
+    return f"{title} (fork #1)"
+
+
+async def _handle_fork_command(
+    cfg: TelegramBridgeConfig,
+    msg: TelegramIncomingMessage,
+    store: TopicStateStore,
+    *,
+    resolved_scope: str | None = None,
+    scope_chat_ids: frozenset[int] | None = None,
+) -> None:
+    from ...model import ResumeToken
+
+    reply = make_reply(cfg, msg)
+    error = _topics_command_error(
+        cfg,
+        msg.chat_id,
+        resolved_scope=resolved_scope,
+        scope_chat_ids=scope_chat_ids,
+    )
+    if error is not None:
+        await reply(text=error)
+        return
+    tkey = _topic_key(msg, cfg, scope_chat_ids=scope_chat_ids)
+    if tkey is None:
+        await reply(text="this command only works inside a topic.")
+        return
+
+    snapshot = await store.get_thread(*tkey)
+    current_title = snapshot.topic_title if snapshot else None
+    forked_title = _get_forked_title(current_title)
+
+    created = await cfg.bot.create_forum_topic(msg.chat_id, forked_title)
+    if created is None:
+        await reply(text="failed to create forked topic.")
+        return
+
+    new_thread_id = created.message_thread_id
+
+    if snapshot and snapshot.context:
+        await store.set_context(
+            msg.chat_id,
+            new_thread_id,
+            snapshot.context,
+            topic_title=forked_title,
+        )
+
+    if snapshot and snapshot.sessions:
+        for engine, resume_value in snapshot.sessions.items():
+            token = ResumeToken(engine=engine, value=resume_value)
+            await store.set_session_resume(msg.chat_id, new_thread_id, token)
+
+    await reply(text=f"forked to new topic `{forked_title}`.")
+
+    context_label = _format_context(cfg.runtime, snapshot.context) if snapshot and snapshot.context else "none"
+    sessions_label = ", ".join(sorted(snapshot.sessions.keys())) if snapshot and snapshot.sessions else "none"
+    welcome_text = (
+        f"forked from previous topic\n\n"
+        f"context: `{context_label}`\n"
+        f"sessions: {sessions_label}\n\n"
+        "continue your conversation here!"
+    )
+    rendered_text, entities = prepare_telegram(MarkdownParts(header=welcome_text))
+    await cfg.exec_cfg.transport.send(
+        channel_id=msg.chat_id,
+        message=RenderedMessage(text=rendered_text, extra={"entities": entities}),
+        options=SendOptions(thread_id=new_thread_id),
+    )

{yee88-0.7.0 → yee88-0.7.1}/src/yee88/telegram/loop.py

@@ -44,6 +44,7 @@ from .commands.handlers import (
     handle_ctx_command,
     handle_file_command,
     handle_file_put_default,
+    handle_fork_command,
     handle_media_group,
     handle_model_command,
     handle_new_command,
@@ -224,6 +225,15 @@ def _dispatch_builtin_command(
                 resolved_scope=resolved_scope,
                 scope_chat_ids=scope_chat_ids,
             )
+        elif command_id == "fork":
+            handler = partial(
+                handle_fork_command,
+                cfg,
+                msg,
+                topic_store,
+                resolved_scope=resolved_scope,
+                scope_chat_ids=scope_chat_ids,
+            )
         elif command_id == "topic":
             handler = partial(
                 handle_topic_command,

{yee88-0.7.0 → yee88-0.7.1}/uv.lock

@@ -1125,7 +1125,7 @@ wheels = [
 
 [[package]]
 name = "yee88"
-version = "0.6.3"
+version = "0.7.0"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },