session-trail 0.2.1__tar.gz → 0.2.2__tar.gz

{session_trail-0.2.1/src/session_trail.egg-info → session_trail-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: session-trail
-Version: 0.2.1
+Version: 0.2.2
 Summary: Local cross-agent work timeline: discover, browse and resume coding-agent sessions on your machine
 Author: fwt11
 License-Expression: MIT
@@ -101,9 +101,11 @@ agent-trail serve --interval 30      # 轮询间隔（watch 健康时自动降
 ```bash
 agent-trail tray             # 启动托盘（自动拉起 agent-trail serve）
 agent-trail tray --show      # 启动同时打开控制台窗口
-agent-trail tray --install   # 写入应用菜单入口；--uninstall 反向清理
+agent-trail tray --install   # 手动写入应用菜单入口；--uninstall 反向清理
 ```
 
+pip 安装后首次运行 `agent-trail tray` 会自动把"Agent 足迹"注册进系统应用菜单（应用启动器可直接搜索到），之后升级换路径也会自动刷新；无桌面会话（SSH/服务器）不写入。
+
 托盘壳本身不依赖任何第三方 pip 包，但需要 GTK 的 GI 绑定（系统 Python 通常自带）。`agent-trail tray` 在当前解释器缺 GI 绑定时会自动改用带绑定的系统 Python 重执行（例如 pip 装在 venv 里、托盘跑在系统 Python），无需任何手动操作；实在找不到时按提示安装：
 
 ```bash

{session_trail-0.2.1 → session_trail-0.2.2}/README.en.md

@@ -74,9 +74,11 @@ Beyond `serve`, a tray application embeds the console in a native window and add
 ```bash
 agent-trail tray             # start the tray (spawns agent-trail serve)
 agent-trail tray --show      # also open the console window
-agent-trail tray --install   # add an applications-menu entry; --uninstall reverts
+agent-trail tray --install   # manually add an applications-menu entry; --uninstall reverts
 ```
 
+The first `agent-trail tray` run after pip install automatically registers "Agent Trail" in the desktop applications menu (searchable from your launcher) and refreshes it on upgrades; headless sessions (SSH/servers) write nothing.
+
 The tray needs GTK GI bindings (preinstalled on most distros as the system Python). If the interpreter running agent-trail lacks them — e.g. the package lives in a venv — `agent-trail tray` automatically re-executes itself with a system Python that has GI; no manual steps. If none is found, install:
 
 ```bash

{session_trail-0.2.1 → session_trail-0.2.2}/README.md

@@ -75,9 +75,11 @@ agent-trail serve --interval 30      # 轮询间隔（watch 健康时自动降
 ```bash
 agent-trail tray             # 启动托盘（自动拉起 agent-trail serve）
 agent-trail tray --show      # 启动同时打开控制台窗口
-agent-trail tray --install   # 写入应用菜单入口；--uninstall 反向清理
+agent-trail tray --install   # 手动写入应用菜单入口；--uninstall 反向清理
 ```
 
+pip 安装后首次运行 `agent-trail tray` 会自动把"Agent 足迹"注册进系统应用菜单（应用启动器可直接搜索到），之后升级换路径也会自动刷新；无桌面会话（SSH/服务器）不写入。
+
 托盘壳本身不依赖任何第三方 pip 包，但需要 GTK 的 GI 绑定（系统 Python 通常自带）。`agent-trail tray` 在当前解释器缺 GI 绑定时会自动改用带绑定的系统 Python 重执行（例如 pip 装在 venv 里、托盘跑在系统 Python），无需任何手动操作；实在找不到时按提示安装：
 
 ```bash

{session_trail-0.2.1 → session_trail-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "session-trail"
-version = "0.2.1"
+version = "0.2.2"
 description = "Local cross-agent work timeline: discover, browse and resume coding-agent sessions on your machine"
 readme = "README.md"
 license = "MIT"

{session_trail-0.2.1 → session_trail-0.2.2}/src/agent_trail/tray/app.py

@@ -305,6 +305,38 @@ class TrailCore:
 # -- 桌面入口文件 -----------------------------------------------------------
 
 
+def _desktop_session_present() -> bool:
+    return bool(
+        os.environ.get("DISPLAY")
+        or os.environ.get("WAYLAND_DISPLAY")
+        or os.environ.get("XDG_CURRENT_DESKTOP")
+    )
+
+
+def ensure_desktop_entry() -> None:
+    """首次运行 tray 时自动注册应用菜单入口，并在路径变化后自愈刷新。
+
+    pip 的 wheel 安装没有装后钩子，因此采用运行时自注册：仅在有桌面
+    会话的环境执行，内容与当前渲染一致时跳过写入。开机自启已开启时
+    同步刷新其 Exec 路径，避免包位置变化后自启失效。
+    """
+    if not _desktop_session_present():
+        return
+    executable = shutil.which("agent-trail") or sys.argv[0]
+    if not _looks_executable(executable):
+        return
+    entry = render_desktop_entry(executable, ICON_PATH)
+    try:
+        if not APP_MENU_PATH.exists() or APP_MENU_PATH.read_text(encoding="utf-8") != entry:
+            APP_MENU_PATH.parent.mkdir(parents=True, exist_ok=True)
+            APP_MENU_PATH.write_text(entry, encoding="utf-8")
+        if autostart_enabled():
+            if AUTOSTART_PATH.read_text(encoding="utf-8") != entry:
+                AUTOSTART_PATH.write_text(entry, encoding="utf-8")
+    except OSError:
+        pass  # 桌面注册失败不影响托盘本身；--install/--uninstall 仍可手动操作
+
+
 def render_desktop_entry(executable: str, icon: Path,
                          template: Path = DESKTOP_TEMPLATE) -> str:
     text = template.read_text(encoding="utf-8")
@@ -606,6 +638,7 @@ def main(argv: list[str] | None = None) -> int:
     if not ICON_PATH.is_file():
         print(tr("error.no_icon", path=ICON_PATH), file=sys.stderr)
         return 1
+    ensure_desktop_entry()
     # 锁在前台获取：重复启动时提示直接出现在用户终端；fd 由守护进程继承
     guard = SingleInstance()
     if not guard.acquire():

{session_trail-0.2.1 → session_trail-0.2.2/src/session_trail.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: session-trail
-Version: 0.2.1
+Version: 0.2.2
 Summary: Local cross-agent work timeline: discover, browse and resume coding-agent sessions on your machine
 Author: fwt11
 License-Expression: MIT
@@ -101,9 +101,11 @@ agent-trail serve --interval 30      # 轮询间隔（watch 健康时自动降
 ```bash
 agent-trail tray             # 启动托盘（自动拉起 agent-trail serve）
 agent-trail tray --show      # 启动同时打开控制台窗口
-agent-trail tray --install   # 写入应用菜单入口；--uninstall 反向清理
+agent-trail tray --install   # 手动写入应用菜单入口；--uninstall 反向清理
 ```
 
+pip 安装后首次运行 `agent-trail tray` 会自动把"Agent 足迹"注册进系统应用菜单（应用启动器可直接搜索到），之后升级换路径也会自动刷新；无桌面会话（SSH/服务器）不写入。
+
 托盘壳本身不依赖任何第三方 pip 包，但需要 GTK 的 GI 绑定（系统 Python 通常自带）。`agent-trail tray` 在当前解释器缺 GI 绑定时会自动改用带绑定的系统 Python 重执行（例如 pip 装在 venv 里、托盘跑在系统 Python），无需任何手动操作；实在找不到时按提示安装：
 
 ```bash