@aiti-ai/aiti-msg-nav 0.0.0-stage → 0.1.7

package/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <circle cx="12" cy="6" r="1.8"/>
+  <circle cx="12" cy="18" r="1.8"/>
+  <path d="M12 11v2"/>
+  <path d="M12 9h.01"/>
+  <path d="M12 15h.01"/>
+</svg>

package/index.ts

@@ -0,0 +1,50 @@
+/**
+ * aiti-msg-nav · 消息滚动导航（到最早 / 到最新 / 上一个用户输入 / 下一个用户输入）
+ *
+ * 原为 pi-web 内置的 ScrollToolbar（components/ScrollToolbar.tsx），已整体抽离为
+ * 扩展：core 只留一个 chatOverlay 插槽挂载点（消息区覆盖层），全部交互/定位/滚动
+ * 逻辑在扩展 client bundle 里，靠两条 DOM 契约工作：
+ *   - [data-chat-scroll]        消息滚动容器（core 给消息滚动 div 打的标记）
+ *   - [data-chat-msg-role]      消息包装节点（role="user"/"assistant"；用户消息
+ *                               即 prev/next 的导航目标）
+ * 依赖核心懒分页：滚到顶部触发 sentinel → core 自动加载更早消息并保持视口，扩展
+ * 只需滚动到容器顶端并延时重试（不再需要 core 的 setVisibleCount）。
+ *
+ * 纯前端扩展：无服务端 API。features（extman 可管理）：
+ *   - show.toolbar        总开关（关闭 = 不渲染导航条）
+ *   - behavior.keepAwake  长按「到最新」保持屏幕常亮（Screen Wake Lock API）
+ */
+export default {
+  id: "aiti-msg-nav",
+  name: "消息滚动导航",
+  version: "0.1.0",
+  icon: "icon.svg",
+  client: "dist/aiti-msg-nav-client.mjs",
+
+  ui: {
+    clientDependsOn: [],
+    i18n: {
+      "zh-CN": {
+        "nav.earliest": "到最早消息",
+        "nav.prevUser": "上一个用户输入",
+        "nav.nextUser": "下一个用户输入",
+        "nav.latestHint": "到最新消息（长按保持屏幕常亮）",
+        "nav.keepAwakeOn": "屏幕保持常亮",
+      },
+      "en": {
+        "nav.earliest": "Jump to earliest message",
+        "nav.prevUser": "Previous user message",
+        "nav.nextUser": "Next user message",
+        "nav.latestHint": "Jump to latest (long-press to keep the screen awake)",
+        "nav.keepAwakeOn": "Screen stays awake",
+      },
+    },
+  },
+
+  features: [
+    { id: "show.toolbar", label: "显示消息滚动导航条", description: "消息区右侧的到最早/到最新/上一条/下一条按钮列", default: true },
+    { id: "behavior.keepAwake", label: "长按『到最新』保持屏幕常亮", description: "agent 运行时长按最底部按钮可让屏幕保持常亮（Screen Wake Lock API，不支持时自动降级）", default: true },
+  ],
+
+  server: {},
+};

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@aiti-ai/aiti-msg-nav",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.7",
+  "type": "module",
+  "description": "消息滚动导航扩展（到最早 / 到最新 / 上一个用户输入 / 下一个用户输入）—— JSX + vite 构建 client bundle",
+  "scripts": {
+    "build:client": "vite build --config vite.config.ts",
+    "deploy": "node tools/deploy.mjs"
+  },
+  "devDependencies": {
+    "vite": "^6.4.3"
+  },
+  "soul": "千楼万楼的聊天记录，电梯比楼梯好用。",
+  "aitiExtProtocol": "1.0",
+  "license": "MIT",
+  "contentHash": "a296050c20106fde",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiti-ai/aiti-ai.git",
+    "directory": "extensions/aiti-msg-nav"
+  },
+  "homepage": "https://github.com/aiti-ai/aiti-ai#readme",
+  "bugs": {
+    "url": "https://github.com/aiti-ai/aiti-ai/issues"
+  }
+}

package/reload-instances.mjs

@@ -0,0 +1,60 @@
+/**
+ * _shared/reload-instances.mjs · pi-web 双实例热重载（各扩展 deploy.mjs 共用）
+ *
+ * dev 3001 / 生产 3002；端口可经 AITI_DEV_PORT / AITI_PROD_PORT 覆盖；
+ * basePath 双 env（AITI_DEV_BASE_PATH / AITI_PROD_BASE_PATH）按机器设值，
+ *   推荐值不带斜杠（48：dev 与 空；155：系统级 wdev 与 win）——git-bash 启动
+ *   原生程序时会把 / 开头的 env 值做 MSYS 路径转换（/wdev → D:/apps/Git/wdev）
+ *   致 URL 非法；不带斜杠则不触发转换。此处自动补 /（旧 /xxx 格式仍兼容），
+ *   兼容不了时提示 MSYS_NO_PATHCONV=1。
+ * 避免「server 端代码改了、实例没 reload 导致跑旧逻辑」。
+ *
+ * 用法（静态 import 或顶层 await import 均可）：
+ *   import { reloadInstances } from "../../_shared/reload-instances.mjs";
+ *   await reloadInstances();              // 默认 "[deploy] " 前缀
+ */
+const BASE_PATH_RE = /^\/[A-Za-z0-9._-]*$/;
+
+function buildInstance(name, portEnv, portDefault, pathEnv, pathDefault) {
+  const origin = `http://127.0.0.1:${process.env[portEnv] || portDefault}`;
+  const raw = process.env[pathEnv];
+  if (raw === undefined || raw === null || String(raw).trim() === "") return { name, base: origin + pathDefault };
+  // 自动补 /：wdev → /wdev（推荐无斜杠格式，MSYS 不转换）；/wdev → /wdev（旧格式兼容）
+  const p = "/" + String(raw).trim().replace(/^\/+|\/+$/g, "");
+  if (BASE_PATH_RE.test(p)) return { name, base: origin + p };
+  return { name, base: null, raw };
+}
+
+/** 双实例清单（dev/prod 各 {name, base}）；reload-instances 与 reconcile-deps 等共用。 */
+export function buildInstances() {
+  return [
+    buildInstance("dev", "AITI_DEV_PORT", 3001, "AITI_DEV_BASE_PATH", "/dev"),
+    buildInstance("prod", "AITI_PROD_PORT", 3002, "AITI_PROD_BASE_PATH", ""),
+  ];
+}
+
+export async function reloadInstances(prefix = "[deploy] ") {
+  // 批次合并（deploy-all 场景）：子条目部署脚本被注入 PI_WEB_DEFER_RELOAD=1 时不各自 reload，
+  // 由 deploy-all 在全部条目完成后统一执行一轮（N 条目 × 2 实例 → 2 次 POST）。
+  // 避免批量部署时的 reload 风暴（2026-09-15 实测：65 条目逐个 reload 把 dev 实例打满）。
+  // 单独跑某个扩展 deploy.mjs 不带该 env → 行为不变（部署完立即 reload）。
+  if (process.env.PI_WEB_DEFER_RELOAD === "1") {
+    console.log(`${prefix}reload 已 defer（PI_WEB_DEFER_RELOAD=1，由 deploy-all 收尾统一执行）`);
+    return;
+  }
+  // 允许失败：网络异常/非 2xx/服务未启动/env 非法一律只打提示，永不 throw——不影响 deploy 退出码
+  for (const inst of buildInstances()) {
+    if (inst.base === null) {
+      const msysHint = /[\\:]/.test(inst.raw) ? "——疑似 git-bash MSYS 路径转换，用 MSYS_NO_PATHCONV=1 前缀重跑" : "";
+      console.log(`${prefix}reload ${inst.name} 跳过：AITI_${inst.name.toUpperCase()}_BASE_PATH="${inst.raw}" 非法（须形如 /xxx 或留空）${msysHint}`);
+      continue;
+    }
+    try {
+      const r = await fetch(inst.base + "/api/extensions/reload", { method: "POST" });
+      console.log(`${prefix}reload ${inst.name} → HTTP ${r.status} ${r.ok ? "✓" : "⚠ 失败（请手动 POST /api/extensions/reload）"}`);
+    } catch (e) {
+      const cause = e && e.cause ? String(e.cause.code || e.cause.message || e.cause) : String((e && e.message) || e);
+      console.log(`${prefix}reload ${inst.name} 不可达（${cause}）— 需手动 POST /api/extensions/reload`);
+    }
+  }
+}

package/tools/build-client.mjs

@@ -0,0 +1,24 @@
+/**
+ * aiti-msg-nav · 构建 JSX client bundle（Vite lib mode → client/aiti-msg-nav-client.mjs）
+ */
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(fileURLToPath(new URL("..", import.meta.url)));
+
+// Windows 上 .bin/vite（无扩展名 sh 脚本）spawn 会 status=null 静默失败；
+// 跨平台统一 node 直跑 vite.js 入口（.bin 垫片的真实目标，npm scripts 内部同做法）。
+const viteJs = resolve(root, "node_modules", "vite", "bin", "vite.js");
+const viteBin = (await import("node:fs")).existsSync(viteJs) ? viteJs : "vite";
+
+const r = spawnSync(process.execPath, [viteBin, "build", "--config", resolve(root, "vite.config.ts")], {
+  cwd: root,
+  stdio: "inherit",
+  shell: false,
+});
+if (r.status !== 0) {
+  console.error("[aiti-msg-nav] vite build 失败（exit " + r.status + "）。若提示找不到 vite：cd pi-web-ext/aiti-msg-nav && npm install");
+  process.exit(r.status ?? 1);
+}
+console.log("[aiti-msg-nav] JSX client bundle → client/aiti-msg-nav-client.mjs");

package/tools/deploy.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * aiti-msg-nav · 部署到 ~/.pi/web/extensions/ 和 ~/.pi/web-dev/extensions/
+ *
+ * 部署 = client bundle 构建（vite）→ 整目录同步到两个扩展根（dev/prod 隔离）→ git 提交部署状态。
+ * 用法：node tools/deploy.mjs
+ * 生效：POST /api/extensions/reload（或重启 pi-web）；client no-store 刷新页面即新
+ */
+import { cpSync, rmSync, mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+import { deployCommit } from "../../_shared/deploy-commit.mjs";
+
+// client TS 残留检查（.mjs 里是合法 JS 语法检查不报、运行时必炸；FAIL 即部署失败）
+{
+  const { checkClientDir } = await import("../../_shared/check-client.mjs");
+  checkClientDir(fileURLToPath(new URL("../client", import.meta.url)), { log: (m) => console.log("[deploy] " + m) });
+}
+
+const root = resolve(import.meta.dirname, ".."); // pi-web-ext/aiti-msg-nav
+
+// 0) 客户端 bundle 构建（client/src/*.tsx → client/aiti-msg-nav-client.mjs）
+console.log("[deploy] 构建 JSX client bundle…");
+try {
+  execSync("node tools/build-client.mjs", { cwd: root, stdio: "inherit" });
+} catch (e) {
+  console.error("[deploy] 构建失败，中止部署：", e.message);
+  process.exit(1);
+}
+
+const targets = [
+  resolve(homedir(), ".pi", "web", "extensions", "aiti-msg-nav"),
+  resolve(homedir(), ".pi", "web-dev", "extensions", "aiti-msg-nav"),
+];
+
+for (const extDir of targets) {
+  mkdirSync(extDir, { recursive: true });
+  rmSync(extDir, { recursive: true, force: true });
+  cpSync(root, extDir, {
+    recursive: true,
+    filter: (src) => {
+      const rel = src.slice(root.length + 1);
+      // 不打包构建工具/依赖；client/ 产物与源码都带上（manifest client 字段指产物）
+      if (rel.split("/")[0] === "tools") return false;
+      if (rel.split("/").includes("node_modules")) return false;
+      return true;
+    },
+  });
+  console.log("[deploy] → " + extDir);
+}
+
+// 部署状态提交（生产根是 git 仓库；失败不影响部署）
+const extRepo = resolve(homedir(), ".pi", "web", "extensions");
+
+deployCommit({ repo: extRepo, name: "aiti-msg-nav", paths: ["aiti-msg-nav"], log: (m) => console.log("[deploy] " + m) });
+console.log("[deploy] 完成。reload: POST /api/extensions/reload");
+
+// ── 双实例热重载（basePath 双 env 按机器设值）——允许失败：服务未启动/共享模块缺失仅提示，不影响 deploy 退出码 ──
+try {
+  const { reloadInstances } = await import("../../_shared/reload-instances.mjs");
+  await reloadInstances();
+} catch (e) {
+  console.log("[deploy] 自动 reload 未执行（" + String((e && e.message) || e) + "）— 需手动 POST /api/extensions/reload");
+}
+
+// ── dev-pack（方案 §3.2：源码+构建工具+AGENTS.md 直达部署目录，AI 可现场直改）——允许失败，不影响 deploy 退出码 ──
+try {
+  const { packDevPack } = await import("../../_shared/dev-pack.mjs");
+  packDevPack({ extRoot: resolve(import.meta.dirname, ".."), log: (m) => console.log("[deploy] " + m) });
+} catch (e) {
+  console.log("[deploy] dev-pack 未执行（" + String((e && e.message) || e) + "）");
+}

package/vite.config.ts

@@ -0,0 +1,45 @@
+/**
+ * aiti-msg-nav · client 构建配置（Vite lib mode，参考 pi-web-ext/demo）。
+ *
+ * 把 client/src/entry.tsx（JSX + TS）打包成单个 ESM bundle：client/aiti-msg-nav-client.mjs
+ * （index.ts 的 client 字段指向它）。
+ *  - lib mode（formats: ['es']）：产物是一个 register(ctx) 函数，宿主 ExtSlots 动态 import。
+ *  - react 重定向：JSX 自动运行时默认 import "react/jsx-runtime"，扩展 client 不引入
+ *    React——resolve.alias 指到 client/src/host-shim.ts / jsx-runtime.ts，所有 hooks 委托
+ *    宿主 register(ctx) 传入的 h/useState/…。产物零 React 引用。
+ *
+ * 构建：npm run build:client   （或 node tools/build-client.mjs）
+ */
+import { defineConfig } from "vite";
+import { fileURLToPath } from "node:url";
+
+export default defineConfig({
+  esbuild: {
+    jsx: "automatic",
+    jsxImportSource: "react",
+  },
+  resolve: {
+    alias: [
+      // 正则精确匹配包名（字符串 alias 前缀匹配会吞掉 react/jsx-runtime）
+      { find: /^react\/jsx-dev-runtime$/, replacement: fileURLToPath(new URL("client/src/jsx-runtime.ts", import.meta.url)) },
+      { find: /^react\/jsx-runtime$/, replacement: fileURLToPath(new URL("client/src/jsx-runtime.ts", import.meta.url)) },
+      { find: /^react$/, replacement: fileURLToPath(new URL("client/src/host-shim.ts", import.meta.url)) },
+    ],
+  },
+  build: {
+    lib: {
+      entry: fileURLToPath(new URL("client/src/entry.tsx", import.meta.url)),
+      formats: ["es"],
+      fileName: () => "aiti-msg-nav-client.mjs",
+    },
+    outDir: "dist",
+    emptyOutDir: true, // 别清掉 client/src（源码）
+    target: "es2020",
+    minify: false,
+    sourcemap: false,
+    rollupOptions: {
+      // 本扩展无外部 npm 依赖；全部内联进单个 .mjs
+      external: [],
+    },
+  },
+});

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.