@unifan/pi-unifan-zh 1.0.0

package/extensions/sessions/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@unifan/pi-sessions-zh",
+  "version": "1.0.0",
+  "description": "Pi 历史会话管理器（双栏可视化 TUI 预览与恢复，中文增强版）",
+  "type": "module",
+  "main": "./index.ts",
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "keywords": [
+    "pi-extension",
+    "pi-sessions",
+    "chinese",
+    "tui"
+  ],
+  "author": "unifan",
+  "license": "MIT"
+}
+

package/extensions/sessions/sessions.ts

@@ -0,0 +1,264 @@
+export interface SessionInfoLike {
+  id: string;
+  name?: string;
+  cwd: string;
+  modified: Date;
+  created?: Date;
+  firstMessage: string;
+  path: string;
+  messageCount?: number;
+}
+
+export type PreviewContent =
+  | string
+  | Array<
+      | { type: "text"; text: string }
+      | { type: "image"; mimeType?: string }
+      | { type: "toolCall"; name: string; arguments?: Record<string, unknown> }
+      | { type: "thinking"; thinking?: string; redacted?: boolean }
+    >;
+
+export interface PreviewMessageLike {
+  role: string;
+  content?: PreviewContent;
+  toolName?: string;
+  isError?: boolean;
+  command?: string;
+  output?: string;
+  summary?: string;
+}
+
+export type PreviewBlock =
+  | { kind: "notice"; text: string }
+  | { kind: "user"; text: string }
+  | { kind: "assistant"; text: string }
+  | { kind: "thinking"; text: string; redacted?: boolean }
+  | { kind: "toolCall"; name: string; args?: string }
+  | { kind: "toolResult"; name?: string; text: string; isError?: boolean }
+  | { kind: "bash"; command: string; output?: string; isError?: boolean }
+  | { kind: "summary"; label: string; text: string }
+  | { kind: "custom"; label: string; text: string };
+
+export interface SessionPreview {
+  title: string;
+  subtitle: string;
+  blocks: PreviewBlock[];
+  error?: string;
+}
+
+export interface SessionPaneLayout {
+  mode: "single" | "split";
+  listWidth: number;
+  previewWidth: number;
+}
+
+export function parseLimit(args: string | undefined, defaultLimit = 5): number {
+  if (!args) return defaultLimit;
+  const parsed = Number.parseInt(args.trim(), 10);
+  if (!Number.isFinite(parsed) || parsed < 1) return defaultLimit;
+  return parsed;
+}
+
+const pad = (value: number): string => value.toString().padStart(2, "0");
+
+export function formatTimestamp(date: Date): string {
+  const year = date.getFullYear();
+  const month = pad(date.getMonth() + 1);
+  const day = pad(date.getDate());
+  const hours = pad(date.getHours());
+  const minutes = pad(date.getMinutes());
+  return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+
+export function formatRelativeTime(date: Date): string {
+  const now = new Date();
+  const diffMs = now.getTime() - date.getTime();
+  const diffSec = Math.floor(diffMs / 1000);
+  const diffMin = Math.floor(diffSec / 60);
+  const diffHour = Math.floor(diffMin / 60);
+  const diffDay = Math.floor(diffHour / 24);
+
+  if (diffSec < 60) return "刚刚";
+  if (diffMin < 60) return `${diffMin}分钟前`;
+  if (diffHour < 24) return `${diffHour}小时前`;
+  if (diffDay === 1) return "昨天";
+  return `${diffDay}天前`;
+}
+
+export function buildSessionLabel(session: SessionInfoLike): string {
+  const trimmedName = session.name?.trim();
+  if (trimmedName) return trimmedName;
+  return session.id.length > 8 ? session.id.slice(0, 8) : session.id;
+}
+
+const normalizeSnippet = (text: string, maxLength: number): string => {
+  const cleaned = text.replace(/\s+/g, " ").trim();
+  const fallback = cleaned.length > 0 ? cleaned : "无消息记录";
+  if (maxLength < 1) return "";
+  if (fallback.length <= maxLength) return fallback;
+  if (maxLength === 1) return "…";
+  return `${fallback.slice(0, maxLength - 1)}…`;
+};
+
+export function buildSessionDescription(session: SessionInfoLike, snippetMax = 60): string {
+  const snippet = normalizeSnippet(session.firstMessage ?? "", snippetMax);
+  return `${formatTimestamp(session.modified)} • ${snippet} — ${session.cwd}`;
+}
+
+export interface SessionSearchEntry {
+  session: SessionInfoLike;
+  searchText: string;
+}
+
+export const buildSearchText = (session: SessionInfoLike): string =>
+  [session.name?.trim() ?? "", session.id, session.cwd, session.firstMessage ?? ""]
+    .join(" ")
+    .toLowerCase();
+
+export function buildSessionSearchEntries(sessions: SessionInfoLike[]): SessionSearchEntry[] {
+  return sessions.map((session) => ({ session, searchText: buildSearchText(session) }));
+}
+
+export function filterSessionEntries(entries: SessionSearchEntry[], filter: string): SessionSearchEntry[] {
+  const normalized = filter.trim().toLowerCase();
+  if (!normalized) return entries;
+
+  const tokens = normalized.split(/\s+/).filter(Boolean);
+  if (tokens.length === 0) return entries;
+
+  return entries.filter((entry) => tokens.every((token) => entry.searchText.includes(token)));
+}
+
+export function filterSessionInfos(sessions: SessionInfoLike[], filter: string): SessionInfoLike[] {
+  return filterSessionEntries(buildSessionSearchEntries(sessions), filter).map((entry) => entry.session);
+}
+
+export function getSessionPaneLayout(width: number): SessionPaneLayout {
+  if (width < 80) {
+    return { mode: "single", listWidth: width, previewWidth: 0 };
+  }
+
+  const dividerWidth = 3;
+  const available = Math.max(0, width - dividerWidth);
+  let listRatio = 0.36;
+  if (width < 110) {
+    listRatio = 0.42;
+  } else if (width >= 180) {
+    listRatio = 0.32;
+  }
+
+  const listWidth = Math.max(34, Math.min(58, Math.floor(available * listRatio)));
+  return {
+    mode: "split",
+    listWidth,
+    previewWidth: Math.max(0, available - listWidth),
+  };
+}
+
+const cleanPreviewText = (text: string): string => text.replace(/\s+$/g, "");
+
+function textBlocksFromContent(content: PreviewContent | undefined): PreviewBlock[] {
+  if (!content) return [];
+  if (typeof content === "string") return content.trim() ? [{ kind: "assistant", text: cleanPreviewText(content) }] : [];
+
+  const blocks: PreviewBlock[] = [];
+  for (const part of content) {
+    if (part.type === "text" && part.text.trim()) {
+      blocks.push({ kind: "assistant", text: cleanPreviewText(part.text) });
+    } else if (part.type === "image") {
+      blocks.push({ kind: "notice", text: `[图片${part.mimeType ? `: ${part.mimeType}` : ""}]` });
+    } else if (part.type === "toolCall") {
+      const args = part.arguments && Object.keys(part.arguments).length > 0 ? JSON.stringify(part.arguments) : undefined;
+      blocks.push({ kind: "toolCall", name: part.name, args });
+    } else if (part.type === "thinking") {
+      blocks.push({
+        kind: "thinking",
+        text: part.redacted ? "[思考过程已脱敏]" : cleanPreviewText(part.thinking ?? "[思考过程]"),
+        redacted: part.redacted,
+      });
+    }
+  }
+  return blocks;
+}
+
+function contentToPlainText(content: PreviewContent | undefined): string {
+  if (!content) return "";
+  if (typeof content === "string") return content;
+  return content
+    .map((part) => {
+      if (part.type === "text") return part.text;
+      if (part.type === "image") return `[图片${part.mimeType ? `: ${part.mimeType}` : ""}]`;
+      if (part.type === "toolCall") return `[工具调用: ${part.name}]`;
+      if (part.type === "thinking") return part.redacted ? "[思考过程已脱敏]" : (part.thinking ?? "[思考过程]");
+      return "";
+    })
+    .filter(Boolean)
+    .join("\n");
+}
+
+function messageToBlocks(message: PreviewMessageLike): PreviewBlock[] {
+  if (message.role === "user") {
+    const text = cleanPreviewText(contentToPlainText(message.content));
+    return text ? [{ kind: "user", text }] : [];
+  }
+
+  if (message.role === "assistant") {
+    return textBlocksFromContent(message.content);
+  }
+
+  if (message.role === "toolResult" || message.role === "tool") {
+    const text = cleanPreviewText(contentToPlainText(message.content));
+    return text ? [{ kind: "toolResult", name: message.toolName, text, isError: message.isError }] : [];
+  }
+
+  if (message.role === "bashExecution") {
+    const command = message.command ?? "";
+    return command || message.output
+      ? [{ kind: "bash", command, output: cleanPreviewText(message.output ?? ""), isError: message.isError }]
+      : [];
+  }
+
+  if (message.role === "compactionSummary" || message.role === "branchSummary") {
+    const text = cleanPreviewText(message.summary ?? contentToPlainText(message.content));
+    return text ? [{ kind: "summary", label: message.role === "branchSummary" ? "分支摘要" : "对话压缩摘要", text }] : [];
+  }
+
+  const text = cleanPreviewText(message.summary ?? contentToPlainText(message.content));
+  return text ? [{ kind: "custom", label: message.role || "消息", text }] : [];
+}
+
+export function buildSessionPreview(
+  session: SessionInfoLike,
+  messages: PreviewMessageLike[],
+  options: { maxMessages?: number } = {},
+): SessionPreview {
+  const maxMessages = options.maxMessages ?? 80;
+  const blocks: PreviewBlock[] = [];
+  const omitted = Math.max(0, messages.length - maxMessages);
+  const visibleMessages = omitted > 0 ? messages.slice(-maxMessages) : messages;
+
+  if (omitted > 0) {
+    blocks.push({ kind: "notice", text: `… 已省略前 ${omitted} 条历史消息` });
+  }
+
+  for (const message of visibleMessages) {
+    blocks.push(...messageToBlocks(message));
+  }
+
+  const messageCount = session.messageCount ?? messages.length;
+  return {
+    title: buildSessionLabel(session),
+    subtitle: `${formatTimestamp(session.modified)} · 共 ${messageCount} 条消息 · ${session.cwd}`,
+    blocks: blocks.length > 0 ? blocks : [{ kind: "notice", text: "暂无可预览的消息内容。" }],
+  };
+}
+
+export function buildPreviewError(session: SessionInfoLike, error: unknown): SessionPreview {
+  const message = error instanceof Error ? error.message : String(error);
+  return {
+    title: buildSessionLabel(session),
+    subtitle: `${formatTimestamp(session.modified)} · 预览暂不可用`,
+    blocks: [{ kind: "notice", text: `加载会话预览失败: ${message}` }],
+    error: message,
+  };
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@unifan/pi-unifan-zh",
+  "version": "1.0.0",
+  "description": "Pi Coding Agent 中文扩展全家桶与独立插件集",
+  "type": "module",
+  "main": "extensions/sessions/index.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/821869798/pi-unifan-zh.git"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/sessions/index.ts",
+      "./extensions/review/index.ts"
+    ],
+    "subagents": {
+      "agents": [
+        "./extensions/review/agents"
+      ]
+    },
+    "skills": [
+      "./skills"
+    ]
+  },
+  "keywords": [
+    "pi-extension",
+    "pi-coding-agent",
+    "chinese",
+    "sessions",
+    "review",
+    "tui"
+  ],
+  "author": "unifan",
+  "license": "MIT"
+}
+

package/skills/README.md

@@ -0,0 +1,29 @@
+# 🎯 Pi Skills 目录 (自定义技能库)
+
+此目录用于存放你自定义的 Pi Agent Skills。
+
+---
+
+## 🛠️ 如何添加一个新 Skill？
+
+每个 Skill 是一个单独的文件夹，包含一个核心的 `SKILL.md`：
+
+```text
+skills/
+└── my-unity-helper/
+    └── SKILL.md
+```
+
+### `SKILL.md` 格式规范：
+```markdown
+---
+name: my-unity-helper
+description: 专门用于处理 Unity C# 业务逻辑与性能优化的自定义技能
+---
+
+# 指令与规则
+1. 异步编程一律使用 UniTask。
+2. 避免在 Update 中进行任何 GC 堆内存分配。
+```
+
+当安装本仓库后，Pi 会自动发现并加载此目录下的所有 Skill。

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist"
+  },
+  "include": ["extensions/**/*", "src/**/*"]
+}
+