pi-session-peek 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0
+
+- The preview renders messages with pi's own Markdown renderer: headings, bold, inline code, syntax-highlighted code blocks, tables with borders and cell wrapping, lists, quotes and links now look the same as in the main transcript.
+- Keyword highlighting is applied on top of the rendered lines, so it no longer breaks links or code blocks. A keyword that is split across a wrapped line is not highlighted at that spot; hit counting and Ctrl+N / Ctrl+P are unaffected.
+
 ## 0.1.0
 
 First release.
@@ -10,3 +15,4 @@ First release.
 - Enter resumes, Ctrl+O forks, Ctrl+R renames, Ctrl+D deletes (moves to trash when the `trash` CLI is available).
 - Tab toggles between the current directory tree and all projects.
 - `/peek [keyword]` command, `--rp` and `--peek=<keyword>` startup flags.
+- Chinese and English interface, following the system locale. Override with `PI_SESSION_PEEK_LANG=zh|en`.

package/README.md

@@ -11,6 +11,7 @@ Search your [pi](https://pi.dev) session history by what was actually said, read
 ## ✨ Features
 
 - Opens a two-pane picker with `/peek` or `/peek <keyword>`: sessions on the left, the full conversation on the right.
+- Renders the conversation with pi's own Markdown renderer, so headings, code blocks with syntax highlighting, tables and lists look the same as in the main transcript.
 - Filters as you type across conversation text, session name and working directory. Tool call arguments and results are excluded, so a keyword only matches sessions that actually discussed it.
 - Requires every space-separated keyword to match, and shows a snippet around the first hit in the list.
 - Limits results to recently active sessions with `@7d`, `@24h`, `@2w` or `@1m`.
@@ -82,10 +83,22 @@ The filter is case-insensitive and matches anywhere in the text.
 
 The search index holds user and assistant messages, the session name and the working directory. It does not hold tool call arguments or tool results.
 
+## 🌐 Language
+
+The interface follows your system language: Chinese on `zh-*` locales, English everywhere else. Detection order is `PI_SESSION_PEEK_LANG`, then `LC_ALL` / `LC_MESSAGES` / `LANG`, then the OS locale.
+
+Force a language:
+
+```bash
+PI_SESSION_PEEK_LANG=en pi
+PI_SESSION_PEEK_LANG=zh pi
+```
+
+On Windows PowerShell: `$env:PI_SESSION_PEEK_LANG = "en"` before starting pi. The language is read once when the extension loads, so change it before starting pi or run `/reload`.
+
 ## 🚧 Limitations
 
 - TUI mode only.
-- The interface text is Chinese.
 - No mouse support. Pi only enables mouse input in its experimental fullscreen mode, and this picker does not handle it yet.
 - The preview shows the last 500 messages of very long sessions. Hits in earlier messages are still counted and announced.
 - `pi --peek` without a value is rejected by pi at startup. Use `pi --rp` to open without a keyword.
@@ -100,6 +113,7 @@ pi-session-peek/
 │   ├── peek-component.ts    # The two-pane TUI component
 │   ├── sessions.ts          # Scans and parses session JSONL, rename / delete helpers
 │   ├── query.ts             # Query parsing, highlighting, hit snippets
+│   ├── i18n.ts              # Chinese / English UI strings and locale detection
 │   └── text.ts              # Path, time and width helpers
 ├── scripts/screenshot.mjs   # Optional: renders a synthetic screenshot from component output
 └── test/                    # node:test suites

package/README.zh-CN.md

@@ -11,6 +11,7 @@
 ## ✨ 功能
 
 - `/peek` 或 `/peek 关键词` 打开左右分栏的选择器：左边是会话列表，右边是完整对话。
+- 右栏用 pi 自己的 Markdown 渲染器画，标题、带语法高亮的代码块、表格、列表和主界面里的对话一个样子。
 - 边打字边过滤，搜的是对话正文、会话名和工作目录。工具调用的参数和结果不进索引，所以只会命中真正讨论过这个词的会话。
 - 空格分隔多个关键词，全部命中才显示；列表里直接显示第一个命中处的片段。
 - `@7d`、`@24h`、`@2w`、`@1m` 只看最近活动过的会话。
@@ -82,6 +83,19 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 
 索引里有用户和助手的消息、会话名、工作目录。没有工具调用的参数和结果。
 
+## 🌐 界面语言
+
+跟随系统语言：区域是 `zh-*` 显示中文，其他显示英文。判断顺序是 `PI_SESSION_PEEK_LANG`，然后 `LC_ALL` / `LC_MESSAGES` / `LANG`，最后是操作系统的区域设置。
+
+强制指定：
+
+```bash
+PI_SESSION_PEEK_LANG=en pi
+PI_SESSION_PEEK_LANG=zh pi
+```
+
+Windows PowerShell 里先执行 `$env:PI_SESSION_PEEK_LANG = "en"` 再启动 pi。语言在扩展加载时读一次，改了之后要重启 pi 或 `/reload`。
+
 ## 🚧 限制
 
 - 只支持 TUI 模式。
@@ -99,6 +113,7 @@ pi-session-peek/
 │   ├── peek-component.ts    # 双栏 TUI 组件
 │   ├── sessions.ts          # 扫描解析会话 JSONL，重命名 / 删除
 │   ├── query.ts             # 查询解析、高亮、命中片段
+│   ├── i18n.ts              # 中英文界面文案和语言检测
 │   └── text.ts              # 路径、时间、宽度工具
 ├── scripts/screenshot.mjs   # 可选：用组件渲染输出生成一张合成截图
 └── test/                    # node:test 测试

package/index.ts

@@ -1,5 +1,6 @@
-import { SessionManager, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { getMarkdownTheme, SessionManager, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { basename } from "node:path";
+import { msg } from "./src/i18n.ts";
 import { PeekComponent } from "./src/peek-component.ts";
 import { deleteSession, renameSession, scanSessions, type PeekSession } from "./src/sessions.ts";
 
@@ -10,11 +11,11 @@ let lastQuery = ""; // 进程内记住上次搜索词
 export default function (pi: ExtensionAPI) {
   // pi 会把 boolean flag 的值一律强转成 true，所以带关键词的形式只能是 string 类型
   pi.registerFlag("peek", {
-    description: "启动时打开会话搜索预览并预填关键词（--peek=关键词）",
+    description: msg("flagPeek"),
     type: "string",
   });
   pi.registerFlag("rp", {
-    description: "启动时打开会话搜索预览（不带关键词）",
+    description: msg("flagRp"),
     type: "boolean",
   });
 
@@ -44,10 +45,10 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.registerCommand("peek", {
-    description: "搜索历史会话：左右分栏预览、关键词高亮，Enter 进入对话",
+    description: msg("cmdDesc"),
     handler: async (args, ctx) => {
       if (ctx.mode !== "tui") {
-        ctx.ui.notify("/peek 需要在交互模式（TUI）下使用", "error");
+        ctx.ui.notify(msg("needTui"), "error");
         return;
       }
 
@@ -55,14 +56,14 @@ export default function (pi: ExtensionAPI) {
       const currentFile = ctx.sessionManager.getSessionFile();
       const all = scanSessions().filter((s) => s.path !== currentFile);
       if (!all.length) {
-        ctx.ui.notify("没有找到历史会话", "info");
+        ctx.ui.notify(msg("noSessions"), "info");
         return;
       }
 
       const initial = ((args ?? "").trim() || lastQuery) ?? "";
       type Picked = { s: PeekSession; action: "resume" | "fork" } | null;
       const picked = await ctx.ui.custom<Picked>((tui, theme, _kb, done) => {
-        const comp = new PeekComponent(all, ctx.cwd, theme, process.stdout.rows || 24, initial);
+        const comp = new PeekComponent(all, ctx.cwd, theme, getMarkdownTheme(), process.stdout.rows || 24, initial);
         comp.requestRender = () => tui.requestRender();
         comp.onResume = (s) => {
           lastQuery = comp.getQuery();
@@ -78,7 +79,7 @@ export default function (pi: ExtensionAPI) {
         };
         comp.onDelete = async (s) => {
           const ok = await deleteSession(s.path, (cmd, a) => pi.exec(cmd, a, { timeout: 4000 }));
-          ctx.ui.notify(ok ? `已删除会话 ${basename(s.path)}` : "删除会话失败", ok ? "info" : "error");
+          ctx.ui.notify(ok ? msg("deleted", { file: basename(s.path) }) : msg("deleteFailed"), ok ? "info" : "error");
           return ok;
         };
         comp.onRename = async (s, name) => {
@@ -88,7 +89,7 @@ export default function (pi: ExtensionAPI) {
           } catch {
             ok = false;
           }
-          ctx.ui.notify(ok ? `已重命名为「${name}」` : "重命名失败", ok ? "info" : "error");
+          ctx.ui.notify(ok ? msg("renamed", { name }) : msg("renameFailed"), ok ? "info" : "error");
           return ok;
         };
         return comp;
@@ -102,16 +103,16 @@ export default function (pi: ExtensionAPI) {
         try {
           const forked = SessionManager.forkFrom(picked.s.path, ctx.cwd);
           target = forked.getSessionFile() ?? target;
-          ctx.ui.notify(`已分叉为新会话 ${basename(target)}`, "info");
+          ctx.ui.notify(msg("forked", { file: basename(target) }), "info");
         } catch (e) {
-          ctx.ui.notify(`分叉失败：${e instanceof Error ? e.message : String(e)}`, "error");
+          ctx.ui.notify(msg("forkFailed", { error: e instanceof Error ? e.message : String(e) }), "error");
           return;
         }
       }
 
       const result = await ctx.switchSession(target);
       if (result?.cancelled) {
-        ctx.ui.notify("切换会话已取消", "info");
+        ctx.ui.notify(msg("switchCancelled"), "info");
       }
     },
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-session-peek",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Pi extension: search session history in a two-pane picker with full conversation preview, then resume or fork.",
   "type": "module",
   "license": "MIT",
@@ -16,7 +16,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Jeffropz/pi-session-peek.git"
+    "url": "git+https://github.com/Jeffropz/pi-session-peek.git"
   },
   "homepage": "https://github.com/Jeffropz/pi-session-peek#readme",
   "bugs": "https://github.com/Jeffropz/pi-session-peek/issues",
@@ -32,7 +32,8 @@
   "pi": {
     "extensions": [
       "./index.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/Jeffropz/pi-session-peek/main/docs/screenshot.png"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/i18n.ts

@@ -0,0 +1,124 @@
+export type Lang = "zh" | "en";
+
+const zh = {
+  flagPeek: "启动时打开会话搜索预览并预填关键词（--peek=关键词）",
+  flagRp: "启动时打开会话搜索预览（不带关键词）",
+  cmdDesc: "搜索历史会话：左右分栏预览、关键词高亮，Enter 进入对话",
+  needTui: "/peek 需要在交互模式（TUI）下使用",
+  noSessions: "没有找到历史会话",
+  deleted: "已删除会话 {file}",
+  deleteFailed: "删除会话失败",
+  renamed: "已重命名为「{name}」",
+  renameFailed: "重命名失败",
+  forked: "已分叉为新会话 {file}",
+  forkFailed: "分叉失败：{error}",
+  switchCancelled: "切换会话已取消",
+  searchPlaceholder: "关键词过滤（空格分隔=同时命中；@7d 限定近 7 天）",
+  renamePlaceholder: "新会话名（Enter 确认 / Esc 取消，留空取消）",
+  title: "🔍 会话搜索预览",
+  scopeLabel: "  范围[Tab]: ",
+  scopeAll: "全局",
+  scopeCurrent: "当前目录树",
+  timeLabel: "  时间: ",
+  matchCount: "  匹配 {n}/{total}",
+  noMatch: "没有匹配的会话",
+  msgCount: "{n} 条消息",
+  truncated: "（会话过长，仅显示最后 {n} 条）",
+  hitInTruncated: "关键词命中在未显示的更早消息中",
+  hitOnlyMeta: "关键词仅命中会话名或目录，对话正文无匹配",
+  you: "👤 你",
+  ai: "🤖 AI",
+  renamePrefix: "✏ 重命名: ",
+  confirmDelete: "⚠ 删除会话 [{desc}]？按 y / Enter 确认，任意其他键取消",
+  footer: "↑↓ 选择  PgUp/Dn·^U/^F·⇧↑↓ 滚动  ^N/^P 命中  Tab 范围  ^D 删除  ^R 改名  ^O 分叉  Enter 进入  Esc/^C 关闭",
+  since: "近{n}{unit}",
+  unitH: "小时",
+  unitD: "天",
+  unitW: "周",
+  unitM: "个月",
+};
+
+const en: Record<keyof typeof zh, string> = {
+  flagPeek: "Open the session picker at startup with a keyword (--peek=<keyword>)",
+  flagRp: "Open the session picker at startup",
+  cmdDesc: "Search session history: two-pane preview with keyword highlighting, Enter to resume",
+  needTui: "/peek only works in interactive (TUI) mode",
+  noSessions: "No sessions found",
+  deleted: "Deleted session {file}",
+  deleteFailed: "Failed to delete session",
+  renamed: "Renamed to “{name}”",
+  renameFailed: "Rename failed",
+  forked: "Forked into new session {file}",
+  forkFailed: "Fork failed: {error}",
+  switchCancelled: "Session switch cancelled",
+  searchPlaceholder: "Filter (space = all words must match; @7d = last 7 days)",
+  renamePlaceholder: "New session name (Enter to confirm, Esc to cancel, empty = cancel)",
+  title: "🔍 Session search",
+  scopeLabel: "  Scope[Tab]: ",
+  scopeAll: "all projects",
+  scopeCurrent: "current dir tree",
+  timeLabel: "  Time: ",
+  matchCount: "  {n}/{total} matched",
+  noMatch: "No matching sessions",
+  msgCount: "{n} messages",
+  truncated: "(long session, showing the last {n} messages)",
+  hitInTruncated: "Keyword hits are in earlier messages not shown here",
+  hitOnlyMeta: "Keyword matched only the session name or directory, not the conversation",
+  you: "👤 You",
+  ai: "🤖 AI",
+  renamePrefix: "✏ Rename: ",
+  confirmDelete: "⚠ Delete session [{desc}]? y / Enter to confirm, any other key to cancel",
+  footer: "↑↓ select  PgUp/Dn·^U/^F·⇧↑↓ scroll  ^N/^P hits  Tab scope  ^D del  ^R rename  ^O fork  Enter open  Esc close",
+  since: "last {n}{unit}",
+  unitH: "h",
+  unitD: "d",
+  unitW: "w",
+  unitM: "mo",
+};
+
+export const messages = { zh, en };
+export type MsgKey = keyof typeof zh;
+
+function classify(v: string | undefined): Lang | undefined {
+  const s = v?.trim().toLowerCase();
+  if (!s || s === "c" || s === "posix") return undefined;
+  if (s.startsWith("zh")) return "zh";
+  if (s.startsWith("en")) return "en";
+  return undefined;
+}
+
+// PI_SESSION_PEEK_LANG > LC_ALL / LC_MESSAGES / LANG > 系统区域；都认不出来就用英文
+export function detectLang(
+  env: Record<string, string | undefined> = process.env,
+  systemLocale: () => string = () => Intl.DateTimeFormat().resolvedOptions().locale,
+): Lang {
+  const forced = classify(env.PI_SESSION_PEEK_LANG);
+  if (forced) return forced;
+  for (const v of [env.LC_ALL, env.LC_MESSAGES, env.LANG]) {
+    const l = classify(v);
+    if (l) return l;
+    if (v && v.trim() && !["c", "posix"].includes(v.trim().toLowerCase())) return "en";
+  }
+  let loc = "";
+  try {
+    loc = systemLocale();
+  } catch {
+  }
+  return loc.toLowerCase().startsWith("zh") ? "zh" : "en";
+}
+
+let current: Lang = detectLang();
+
+export function getLang(): Lang {
+  return current;
+}
+
+export function setLang(lang: Lang): void {
+  current = lang;
+}
+
+export function msg(key: MsgKey, vars?: Record<string, string | number>): string {
+  let s: string = messages[current][key];
+  if (vars) for (const [k, v] of Object.entries(vars)) s = s.split(`{${k}}`).join(String(v));
+  return s;
+}