shine-code-submit 0.2.0

package/src/install/register.ts

@@ -0,0 +1,108 @@
+// 注册 plugin 到三处 JSON:known_marketplaces + installed_plugins + settings.enabledPlugins。
+// 关键:directory marketplace 的 plugin 不会自动进 settings.enabledPlugins(bug #17832),
+// 必须 install 脚本显式写 settings.json,否则 plugin 文件在但 hook 不生效。
+import { join } from "node:path";
+import { readJsonDefault, writeJsonAtomicWithBackup } from "./json-safe";
+import { installedPluginsPath, knownMarketplacesPath, pluginsRoot, settingsPath } from "./paths";
+import { MARKETPLACE_NAME, PLUGIN_NAME } from "./deploy";
+import { SERVICE_VERSION } from "../shared/config";
+
+/* eslint-disable @typescript-eslint/no-explicit-any -- claude 的 JSON 结构是动态的,用 any 最直接 */
+
+function pluginKey(): string {
+  return `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+}
+
+/** 注册 marketplace(directory source,指向 cachePath/.claude-plugin)。幂等。 */
+export function registerMarketplace(cachePath: string): void {
+  const file = knownMarketplacesPath();
+  const data = readJsonDefault<Record<string, any>>(file, {});
+  const marketplaceDir = join(cachePath, ".claude-plugin");
+  const existing = data[MARKETPLACE_NAME];
+  if (existing?.source && existing.source.source !== "directory") {
+    console.log(
+      `[shine-code-submit] WARNING: marketplace "${MARKETPLACE_NAME}" 已存在(source=${existing.source.source}),将覆盖为 directory 源(原文件已备份)`,
+    );
+  }
+  data[MARKETPLACE_NAME] = {
+    source: { source: "directory", path: marketplaceDir },
+    installLocation: join(pluginsRoot(), "marketplaces", MARKETPLACE_NAME),
+    lastUpdated: new Date().toISOString(),
+    autoUpdate: false,
+  };
+  writeJsonAtomicWithBackup(file, data);
+  console.log(`[shine-code-submit] marketplace 已注册 → ${file}`);
+}
+
+/** 注册 plugin 到 installed_plugins.json(version 2 结构)。幂等。 */
+export function registerPlugin(cachePath: string): void {
+  const file = installedPluginsPath();
+  const data = readJsonDefault<{ version?: number; plugins?: Record<string, any[]> }>(file, {
+    version: 2,
+    plugins: {},
+  });
+  if (!data.version) data.version = 2;
+  if (!data.plugins) data.plugins = {};
+  const key = pluginKey();
+  const now = new Date().toISOString();
+  const existing = data.plugins[key]?.[0];
+  data.plugins[key] = [
+    {
+      scope: "user",
+      installPath: cachePath,
+      version: SERVICE_VERSION,
+      installedAt: existing?.installedAt ?? now,
+      lastUpdated: now,
+    },
+  ];
+  writeJsonAtomicWithBackup(file, data);
+  console.log(`[shine-code-submit] plugin 已注册 → ${file}`);
+}
+
+/** 启用 plugin:写 settings.json 的 enabledPlugins + extraKnownMarketplaces。幂等。解 #17832。 */
+export function enablePlugin(cachePath: string): void {
+  const file = settingsPath();
+  const data = readJsonDefault<Record<string, any>>(file, {});
+  if (!data.enabledPlugins) data.enabledPlugins = {};
+  const key = pluginKey();
+  data.enabledPlugins[key] = true;
+
+  if (!data.extraKnownMarketplaces) data.extraKnownMarketplaces = {};
+  if (!data.extraKnownMarketplaces[MARKETPLACE_NAME]) {
+    data.extraKnownMarketplaces[MARKETPLACE_NAME] = {
+      source: { source: "directory", path: join(cachePath, ".claude-plugin") },
+    };
+  }
+  writeJsonAtomicWithBackup(file, data);
+  console.log(`[shine-code-submit] 已启用(enabledPlugins)→ ${file}`);
+}
+
+/** 反注册:从三处 JSON 移除条目。幂等。 */
+export function unregisterAll(): void {
+  const key = pluginKey();
+
+  const km = readJsonDefault<Record<string, any>>(knownMarketplacesPath(), {});
+  if (km[MARKETPLACE_NAME]) {
+    delete km[MARKETPLACE_NAME];
+    writeJsonAtomicWithBackup(knownMarketplacesPath(), km);
+  }
+
+  const ip = readJsonDefault<{ plugins?: Record<string, any[]> }>(installedPluginsPath(), { plugins: {} });
+  if (ip.plugins && ip.plugins[key]) {
+    delete ip.plugins[key];
+    writeJsonAtomicWithBackup(installedPluginsPath(), ip);
+  }
+
+  const s = readJsonDefault<Record<string, any>>(settingsPath(), {});
+  let changed = false;
+  if (s.enabledPlugins && s.enabledPlugins[key]) {
+    delete s.enabledPlugins[key];
+    changed = true;
+  }
+  if (s.extraKnownMarketplaces && s.extraKnownMarketplaces[MARKETPLACE_NAME]) {
+    delete s.extraKnownMarketplaces[MARKETPLACE_NAME];
+    changed = true;
+  }
+  if (changed) writeJsonAtomicWithBackup(settingsPath(), s);
+  console.log("[shine-code-submit] 已从三处 JSON 移除注册");
+}

package/src/shared/config.ts

@@ -0,0 +1,77 @@
+// 全局常量：端口、超时、扫描间隔、服务标识。
+// 集中于此，便于 Hook / Daemon / CLI 三端一致。
+import pkg from "../../package.json";
+import { networkInterfaces } from "node:os";
+
+export const SERVICE_NAME = "shine-code-submit";
+export const SERVICE_VERSION = pkg.version; // 单一来源：package.json，避免三处手动同步漏改
+
+/**
+ * daemon 监听地址。默认 0.0.0.0（绑所有网卡，局域网/其他设备可直接访问）。
+ * 仅本机回环用时设 SHINE_CODE_SUBMIT_HOST=127.0.0.1。
+ * 注意：/api/health 与 /ui 无鉴权，绑非回环后 token 是数据接口唯一防线，勿在不可信网络下暴露。
+ */
+export const LISTEN_HOST = process.env.SHINE_CODE_SUBMIT_HOST ?? "0.0.0.0";
+
+export const HOST = "127.0.0.1"; // hook/cli/daemonctl 连接 daemon 用，固定回环（daemon 即使绑 0.0.0.0 也含 127.0.0.1）
+export const PORT = 36666;
+export const BASE_URL = `http://${HOST}:${PORT}`; // 内部访问（hook POST、cli、探活）走 127.0.0.1
+
+/**
+ * 第一个非回环、非虚拟网卡的 IPv4（给用户展示真实局域网可访问的链接）。
+ * 跳过 vEthernet(Hyper-V/WSL)、VMware、VirtualBox、docker/veth/br- 等虚拟网卡，
+ * 取真实网卡（以太网/Wi-Fi）的 IP；都没有则退回第一个非回环 IPv4；再没有则 localhost。
+ */
+function getPrimaryIpv4(): string {
+  const VIRTUAL = ["vethernet", "vmware", "virtualbox", "docker", "veth", "br-", "virbr", "vnet", "utun"];
+  const isVirtual = (name: string): boolean => {
+    const n = name.toLowerCase();
+    return VIRTUAL.some((k) => n.includes(k));
+  };
+  try {
+    const nets = networkInterfaces();
+    // 第一轮：跳过回环 + 虚拟网卡，取真实局域网 IP
+    for (const name of Object.keys(nets)) {
+      if (isVirtual(name)) continue;
+      for (const net of nets[name] ?? []) {
+        if (net.family === "IPv4" && !net.internal) return net.address;
+      }
+    }
+    // 第二轮：全是虚拟网卡时，退回第一个非回环 IPv4
+    for (const name of Object.keys(nets)) {
+      for (const net of nets[name] ?? []) {
+        if (net.family === "IPv4" && !net.internal) return net.address;
+      }
+    }
+  } catch {
+    /* fallthrough to localhost */
+  }
+  return "localhost";
+}
+
+export const PUBLIC_BASE_URL = `http://${getPrimaryIpv4()}:${PORT}`; // 打印给用户/局域网访问的链接（网卡 IP）
+
+// Hook 热转发超时：localhost 上 500ms 足够；超时即放弃热路径，靠 spool 兜底。
+export const HOOK_POST_TIMEOUT_MS = 500;
+
+// 故障路径：detached 拉起 Daemon 后轮询 /api/health 的总预算与间隔。
+export const HEALTH_POLL_TIMEOUT_MS = 5000;
+export const HEALTH_POLL_INTERVAL_MS = 100;
+
+// Daemon 回捞 spool 的扫描间隔。
+export const SPOOL_SCAN_INTERVAL_MS = 1000;
+
+// 运行指标窗口（用于计算 events/sec）。
+export const STATS_WINDOW_MS = 10_000;
+
+// /api/stats 附带的日志尾行数。
+export const LOG_TAIL_LINES = 200;
+
+// 日志按天轮转：超过此大小（字节）也触发轮转。
+export const LOG_ROTATE_BYTES = 5 * 1024 * 1024;
+
+// git log 子进程超时（提交视图 /api/commits）；超时返回空 + error，不阻塞查看页。
+export const GIT_TIMEOUT_MS = 5000;
+
+// /api/sessions enrich tokenTotal 时，最多对最近多少个 session 读 transcript 汇总（控 2s 轮询成本）。
+export const SESSION_TOKEN_ENRICH_LIMIT = 50;

package/src/shared/daemonctl.ts

@@ -0,0 +1,110 @@
+// 跨进程 daemon 控制：探活（认自己人）、拉起、等待 ready、开浏览器。
+// Hook 与 CLI 共用。
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { BASE_URL, HEALTH_POLL_TIMEOUT_MS, HEALTH_POLL_INTERVAL_MS, SERVICE_NAME } from "./config";
+
+/** 探活 + 认自己人：service 字段必须匹配，防端口被无关程序占用误判。 */
+export async function isOursAlive(timeoutMs = 400): Promise<boolean> {
+  try {
+    const res = await fetch(`${BASE_URL}/api/health`, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!res.ok) return false;
+    const data = (await res.json()) as { service?: string };
+    return data?.service === SERVICE_NAME;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * detached 拉起 daemon。
+ * 优先级：env 覆盖 > 同目录 daemon 二进制（二进制模式）> bun run src/daemon/main.ts（源码模式）。
+ * 开发期可用 env 覆盖：
+ *   SHINE_CODE_SUBMIT_DAEMON_CMD  完整命令（shell 执行）
+ *   SHINE_CODE_SUBMIT_DAEMON      仅 bun run 入口路径
+ */
+export function spawnDaemon(): void {
+  const cmd = process.env.SHINE_CODE_SUBMIT_DAEMON_CMD;
+  const dir = dirname(process.execPath);
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const daemonBin = join(dir, `daemon${ext}`);
+  try {
+    if (cmd) {
+      spawn(cmd, { detached: true, stdio: "ignore", windowsHide: true, shell: true }).unref();
+    } else if (process.env.SHINE_CODE_SUBMIT_DAEMON) {
+      spawn(process.execPath, ["run", process.env.SHINE_CODE_SUBMIT_DAEMON], {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+      }).unref();
+    } else if (existsSync(daemonBin)) {
+      // 二进制模式：与当前 exe 同目录的 daemon 二进制
+      spawn(daemonBin, [], { detached: true, stdio: "ignore", windowsHide: true }).unref();
+    } else {
+      // 源码模式：bun run src/daemon/main.ts（本文件在 src/shared/，相对定位）
+      const here = dirname(fileURLToPath(import.meta.url));
+      const daemonSrc = join(here, "..", "daemon", "main.ts");
+      // 用 process.execPath（hook/cli 由 bun 跑时即 bun.exe 完整路径），不靠 PATH/PATHEXT 解析——
+      // Windows 上 bun 进程内 spawn("bun") 不查 PATHEXT 会 ENOENT（Linux 无此问题）
+      spawn(process.execPath, ["run", daemonSrc], { detached: true, stdio: "ignore", windowsHide: true }).unref();
+    }
+  } catch (err) {
+    process.stderr.write(`[shine-code-submit] spawn daemon failed: ${safeMsg(err)}\n`);
+  }
+}
+
+/** 确保 daemon 就绪：不在则拉起并轮询至 ready（或超时）。 */
+export async function ensureDaemon(): Promise<boolean> {
+  if (await isOursAlive()) return true;
+  spawnDaemon();
+  const deadline = Date.now() + HEALTH_POLL_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    await sleep(HEALTH_POLL_INTERVAL_MS);
+    if (await isOursAlive()) return true;
+  }
+  return false;
+}
+
+/** 跨平台打开浏览器。WSL 走 Windows interop（cmd.exe start）比 xdg-open 稳。 */
+export function openBrowser(url: string): void {
+  const platform = process.platform;
+  let cmd: string;
+  let args: string[];
+  if (platform === "win32") {
+    cmd = "cmd";
+    args = ["/c", "start", "", url];
+  } else if (platform === "darwin") {
+    cmd = "open";
+    args = [url];
+  } else if (isWsl()) {
+    cmd = "cmd.exe";
+    args = ["/c", "start", "", url];
+  } else {
+    cmd = "xdg-open";
+    args = [url];
+  }
+  try {
+    spawn(cmd, args, { detached: true, stdio: "ignore" }).unref();
+  } catch {
+    /* ignore */
+  }
+}
+
+/** 是否跑在 WSL（Linux 内核版本字符串含 microsoft）。用于 openBrowser 选 interop 路径。 */
+function isWsl(): boolean {
+  if (process.platform !== "linux") return false;
+  try {
+    return readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
+  } catch {
+    return false;
+  }
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function safeMsg(v: unknown): string {
+  return v instanceof Error ? `${v.name}: ${v.message}` : String(v);
+}

package/src/shared/id.ts

@@ -0,0 +1,19 @@
+// 稳定事件 id：基于事件内容派生（而非 hook 进程随机生成），用于幂等去重。
+// 同一语义事件即使被多个 hook 进程采集（如 settings.json + plugin 双注册，
+// 或他人全局 hook 与本 plugin 并存），只要 sessionId/type/payload 相同，
+// 派生出的 eventId 就相同，store 的 PRIMARY KEY (session_id, event_id) 即可去重。
+// 不含 timestamp——两个采集进程的时间戳差几十 ms，跨秒边界会让派生值错开而漏去重。
+import { createHash } from "node:crypto";
+import type { HookEvent } from "./types";
+
+export function deriveStableEventId(
+  ev: Pick<HookEvent, "type" | "sessionId" | "payload">,
+): string {
+  const h = createHash("sha1");
+  h.update(ev.type);
+  h.update("\x00");
+  h.update(ev.sessionId);
+  h.update("\x00");
+  h.update(JSON.stringify(ev.payload ?? null));
+  return h.digest("hex");
+}

package/src/shared/paths.ts

@@ -0,0 +1,23 @@
+// 数据目录布局：%LOCALAPPDATA%/shine-code-submit/{spool,log,db} + daemon.pid
+import { join } from "node:path";
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+
+const LOCAL =
+  process.env.LOCALAPPDATA ?? join(homedir(), ".local", "share");
+
+export const DATA_DIR = join(LOCAL, "shine-code-submit");
+export const SPOOL_DIR = join(DATA_DIR, "spool");
+export const LOG_DIR = join(DATA_DIR, "log");
+export const DB_DIR = join(DATA_DIR, "db");
+
+export const PID_FILE = join(DATA_DIR, "daemon.pid");
+export const LOG_FILE = join(LOG_DIR, "daemon.log");
+export const DB_FILE = join(DB_DIR, "events.sqlite");
+
+/** 创建所有需要的目录。Daemon 与 Hook 启动时各调一次幂等。 */
+export function ensureDirs(): void {
+  for (const d of [DATA_DIR, SPOOL_DIR, LOG_DIR, DB_DIR]) {
+    mkdirSync(d, { recursive: true });
+  }
+}

package/src/shared/pidfile.ts

@@ -0,0 +1,32 @@
+// pid 文件读写：记录 Daemon pid/port/token/startedAt。
+// Hook 与 CLI 读取 token 用于鉴权；Daemon 写入。
+import { readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { PID_FILE } from "./paths";
+import type { PidFile } from "./types";
+
+export function writePidFile(data: PidFile): void {
+  // mode 在 Windows 上不生效，POSIX 下收紧到 0600（仅当前用户可读）。
+  writeFileSync(PID_FILE, JSON.stringify(data), { mode: 0o600 });
+}
+
+export function readPidFile(): PidFile | null {
+  try {
+    const raw = readFileSync(PID_FILE, "utf8");
+    return JSON.parse(raw) as PidFile;
+  } catch {
+    return null;
+  }
+}
+
+export function removePidFile(): void {
+  try {
+    unlinkSync(PID_FILE);
+  } catch {
+    /* 已不存在 */
+  }
+}
+
+/** Hook / CLI 取鉴权 token 的便捷封装。 */
+export function readToken(): string | null {
+  return readPidFile()?.token ?? null;
+}

package/src/shared/spool.ts

@@ -0,0 +1,60 @@
+// 目录式 spool：每事件一文件，规避多进程并发 append 的交错/截断。
+// 写：tmp + rename（同分区原子）。读：扫目录。确认：unlink。
+import { renameSync, writeFileSync, readdirSync, readFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { SPOOL_DIR } from "./paths";
+import type { HookEvent } from "./types";
+
+/** 生成天然唯一的 spool 文件名：{ts}-{pid}-{rand}.json。 */
+export function spoolFileName(ev: HookEvent): string {
+  const rand = crypto.randomUUID().slice(0, 8);
+  return `${ev.timestamp}-${ev.pid}-${rand}.json`;
+}
+
+/** 原子写入一个事件到 spool 目录，返回文件名。失败会抛出（由调用方兜底）。 */
+export function writeSpoolFile(ev: HookEvent): string {
+  const name = spoolFileName(ev);
+  const final = join(SPOOL_DIR, name);
+  const tmp = `${final}.tmp`;
+  writeFileSync(tmp, JSON.stringify(ev));
+  renameSync(tmp, final); // 同分区原子
+  return name;
+}
+
+export interface SpoolEntry {
+  name: string;
+  event: HookEvent;
+}
+
+/** 列出 spool 中所有事件，按时间戳升序（回捞按序处理）。解析失败的条目跳过并记录。 */
+export function listSpool(onCorrupt?: (name: string, err: unknown) => void): SpoolEntry[] {
+  const names = readdirSync(SPOOL_DIR).filter((f) => f.endsWith(".json"));
+  const out: SpoolEntry[] = [];
+  for (const name of names) {
+    try {
+      const event = JSON.parse(readFileSync(join(SPOOL_DIR, name), "utf8")) as HookEvent;
+      out.push({ name, event });
+    } catch (err) {
+      onCorrupt?.(name, err);
+    }
+  }
+  return out.sort((a, b) => a.event.timestamp - b.event.timestamp);
+}
+
+/** 处理完成后删除 spool 文件（删除即确认）。 */
+export function removeSpoolFile(name: string): void {
+  try {
+    unlinkSync(join(SPOOL_DIR, name));
+  } catch {
+    /* 已不存在 */
+  }
+}
+
+/** 当前 spool 积压数（用于运行指标）。 */
+export function countSpool(): number {
+  try {
+    return readdirSync(SPOOL_DIR).filter((f) => f.endsWith(".json")).length;
+  } catch {
+    return 0;
+  }
+}

package/src/shared/types.ts

@@ -0,0 +1,116 @@
+// 事件与 API 契约类型。Hook / Daemon / 查看页共享，固化接口。
+
+export type HookEventType =
+  | "SessionStart"
+  | "UserPromptSubmit"
+  | "PreToolUse"
+  | "PostToolUse"
+  | "Stop"
+  | "SubagentStop"
+  | "PreCompact"
+  | "SessionEnd";
+
+/** Hook 采集后、落盘与转发的事件信封。payload 为 Claude 注入 stdin 的原始 JSON（透传）。 */
+export interface HookEvent {
+  eventId: string; // 稳定 id，幂等去重用
+  type: HookEventType;
+  timestamp: number; // ms
+  cwd: string; // process.cwd()
+  sessionId: string;
+  pid: number;
+  payload: unknown;
+}
+
+/** pid 文件内容。 */
+export interface PidFile {
+  pid: number;
+  port: number;
+  token: string;
+  startedAt: number; // ms
+}
+
+/** GET /api/health 响应。service 字段用于 Hook「认自己人」。 */
+export interface HealthResponse {
+  service: string;
+  version: string;
+  pid: number;
+  uptime: number; // ms
+}
+
+/** GET /api/stats 响应。 */
+export interface StatsResponse {
+  service: string;
+  version: string;
+  pid: number;
+  uptime: number;
+  spoolBacklog: number;
+  eventsPerSec: number;
+  totalEvents: number;
+  lastError: { time: number; message: string } | null;
+  logTail: string[];
+}
+
+/** GET /api/events 响应。 */
+export interface EventsResponse {
+  events: HookEvent[];
+}
+
+/** 单次 assistant 响应的 token 用量（来自 transcript message.usage 的扁平四字段，缺失按 0）。 */
+export interface TokenUsage {
+  input: number;
+  output: number;
+  cacheCreation: number;
+  cacheRead: number;
+}
+
+/** 单个 session 的概览（查看页 session 树用）。tokenTotal 来自 transcript 汇总，读不到为 null。 */
+export interface SessionSummary {
+  sessionId: string;
+  cwd: string;
+  lastActive: number;
+  eventCount: number;
+  lastType: HookEventType | null;
+  tokenTotal?: TokenUsage | null;
+}
+
+/** GET /api/sessions 响应。 */
+export interface SessionsResponse {
+  sessions: SessionSummary[];
+}
+
+/** GET /api/transcript 响应里的单条消息（daemon 解析 jsonl 产物，对话视图消费）。 */
+export interface TranscriptMessage {
+  role: "user" | "assistant" | "tool";
+  text: string;
+  thinking?: string;
+  tools: { name: string; input: unknown }[];
+  toolName?: string;
+  isError?: boolean;
+  ts?: number;
+  usage?: TokenUsage; // 仅 assistant 有，来自 message.usage
+}
+
+/** git commit 的单个文件变更（来自 git log --numstat；二进制文件 added/deleted 为 0）。 */
+export interface CommitFile {
+  path: string;
+  added: number;
+  deleted: number;
+}
+
+/** 单条 git commit（/api/commits 返回）。added/deleted 为其下 files 的合计。 */
+export interface CommitLog {
+  hash: string;
+  time: number; // ms，提交时间（%cI）
+  author: string;
+  subject: string;
+  files: CommitFile[];
+  added: number;
+  deleted: number;
+}
+
+/** GET /api/commits 响应。非 git 目录或 git 不可用时 commits 为空、带 error。 */
+export interface CommitsResponse {
+  cwd: string;
+  commits: CommitLog[];
+  error?: string;
+}