shine-code-submit 0.2.0

package/src/daemon/ui.ts

@@ -0,0 +1,34 @@
+// 查看页静态资源：编译期嵌入二进制。
+// ui-assets.ts 由 scripts/build.ts 从 ui/* 生成为字符串常量，bun build --compile 时随 daemon 嵌入。
+// （不走 Bun import attribute：tsc 在 bundler 模式会把 .html/.css 当 bun-types 的 HTMLBundle/CSSBundle、
+//   把 app.js 当真实模块解析，类型与解析都报错；生成字符串模块最稳。）
+import { INDEX_HTML, APP_JS, STYLE_CSS } from "./ui-assets";
+
+const CONTENT_TYPES: Record<string, string> = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".svg": "image/svg+xml",
+};
+
+// 路径 → 嵌入内容（内存取，天然无路径穿越风险）
+const ASSETS: Record<string, { body: string; ext: string }> = {
+  "/": { body: INDEX_HTML, ext: ".html" },
+  "/ui": { body: INDEX_HTML, ext: ".html" },
+  "/ui/": { body: INDEX_HTML, ext: ".html" },
+  "/ui/index.html": { body: INDEX_HTML, ext: ".html" },
+  "/ui/app.js": { body: APP_JS, ext: ".js" },
+  "/ui/style.css": { body: STYLE_CSS, ext: ".css" },
+};
+
+export function serveUi(_req: Request, url: URL): Response {
+  const asset = ASSETS[url.pathname];
+  if (!asset) return new Response("not found", { status: 404 });
+  return new Response(asset.body, {
+    headers: {
+      "content-type": CONTENT_TYPES[asset.ext] ?? "application/octet-stream",
+      // 开发期 UI 常更新，URL 无 hash，禁止缓存避免改了不生效
+      "cache-control": "no-store, must-revalidate",
+    },
+  });
+}

package/src/daemon/ws.ts

@@ -0,0 +1,54 @@
+// WS 连接池：订阅 EventBus 广播新事件给查看页。鉴权在 server 升级前完成。
+import type { ServerWebSocket } from "bun";
+import type { EventBus } from "./bus";
+import type { Stats } from "./stats";
+import type { HookEvent } from "../shared/types";
+import { SERVICE_NAME, SERVICE_VERSION } from "../shared/config";
+
+export class WebSocketPool {
+  private sockets = new Set<ServerWebSocket<unknown>>();
+  private off?: () => void;
+
+  constructor(private bus: EventBus, private stats: Stats) {}
+
+  attach(): void {
+    this.off = this.bus.on((event) => this.broadcast(event));
+  }
+
+  add(ws: ServerWebSocket<unknown>): void {
+    this.sockets.add(ws);
+    // 连接即推送一次当前状态快照
+    ws.send(
+      JSON.stringify({
+        kind: "snapshot",
+        stats: {
+          service: SERVICE_NAME,
+          version: SERVICE_VERSION,
+          spoolBacklog: this.stats.backlog(),
+          eventsPerSec: this.stats.rate(),
+          totalEvents: this.stats.total,
+        },
+      }),
+    );
+  }
+
+  remove(ws: ServerWebSocket<unknown>): void {
+    this.sockets.delete(ws);
+  }
+
+  private broadcast(event: HookEvent): void {
+    const msg = JSON.stringify({ kind: "event", event });
+    for (const ws of this.sockets) {
+      try {
+        ws.send(msg);
+      } catch {
+        /* 连接已断，忽略 */
+      }
+    }
+  }
+
+  dispose(): void {
+    this.off?.();
+    this.sockets.clear();
+  }
+}

package/src/hook/main.ts

@@ -0,0 +1,154 @@
+// Hook 入口（短命进程）：
+//   1. 采集 env + stdin，补 cwd/sessionId/pid/eventId/timestamp/type
+//   2. 原子落盘 spool（tmp+rename）—— 唯一必成功环节
+//   3. 热转发 POST；连接失败才走故障路径（ensureDaemon：探测→认自己人→拉起→轮询 ready）→ 重读 token → 重试
+//   全程失败静默，退出码恒为 0（绝不影响 Claude Code）。
+import { ensureDirs } from "../shared/paths";
+import { readToken } from "../shared/pidfile";
+import { writeSpoolFile } from "../shared/spool";
+import { BASE_URL, PUBLIC_BASE_URL, HOOK_POST_TIMEOUT_MS } from "../shared/config";
+import { ensureDaemon, openBrowser } from "../shared/daemonctl";
+import type { HookEvent, HookEventType } from "../shared/types";
+
+const VALID_TYPES: HookEventType[] = [
+  "SessionStart",
+  "UserPromptSubmit",
+  "PreToolUse",
+  "PostToolUse",
+  "Stop",
+  "SubagentStop",
+  "PreCompact",
+  "SessionEnd",
+];
+
+main().catch(() => process.exit(0));
+
+async function main(): Promise<void> {
+  const event = await collect();
+  if (!event) {
+    process.stderr.write("[shine-code-submit-hook] collect failed: missing cwd/sessionId\n");
+    return process.exit(0);
+  }
+
+  // 1. 落盘（必成功环节）。失败时写 stderr 告警（可被发现），仍退出码 0。
+  try {
+    ensureDirs();
+    writeSpoolFile(event);
+  } catch (err) {
+    process.stderr.write(
+      `[shine-code-submit-hook] spool write failed: ${safeMsg(err)}; event=${truncate(JSON.stringify(event))}\n`,
+    );
+    return process.exit(0);
+  }
+
+  // 2. 热转发 + 故障路径（永不抛出）
+  try {
+    await forward(event);
+  } catch (err) {
+    process.stderr.write(`[shine-code-submit-hook] forward failed: ${safeMsg(err)}\n`);
+  }
+
+  // 3. SessionStart（真·新开会话）时给用户打印 UI 入口：stdout 输出 JSON，
+  //    Claude Code 解析 systemMessage 字段直接显示给用户（裸 stdout 只注入
+  //    assistant 当 context，用户不可见）。仅 source=startup 打印，避免
+  //    resume/clear/compact 刷屏；daemon 未就绪读不到 token 则静默跳过。
+  if (event.type === "SessionStart") {
+    const source = (event.payload as Record<string, unknown> | null | undefined)?.source;
+    if (source === "startup") {
+      const token = readToken();
+      if (token) {
+        const url = `${PUBLIC_BASE_URL}/ui?t=${token}`; // 网卡 IP：显示与打开浏览器用同一地址，局域网通用
+        process.stdout.write(JSON.stringify({ systemMessage: `Shine Dashboard: ${url}` }));
+        openBrowser(url);
+      }
+    }
+  }
+  process.exit(0);
+}
+
+/** 采集：argv[1] 或 stdin.hook_event_name 作为 type；cwd=process.cwd()；sessionId 取 stdin.session_id。 */
+async function collect(): Promise<HookEvent | null> {
+  // 扫描 argv 找有效事件名：兼容「直接调 exe (argv[1])」与「bun run script.ts X (argv[2])」两种形式
+  const typeArg = process.argv.slice(1).find((a) => VALID_TYPES.includes(a as HookEventType)) as
+    | HookEventType
+    | undefined;
+  const payload = await readStdin();
+  const obj = payload && typeof payload === "object" ? (payload as Record<string, unknown>) : {};
+
+  const type: HookEventType =
+    typeArg && VALID_TYPES.includes(typeArg)
+      ? typeArg
+      : typeof obj.hook_event_name === "string" && VALID_TYPES.includes(obj.hook_event_name as HookEventType)
+        ? (obj.hook_event_name as HookEventType)
+        : "PostToolUse";
+
+  const sessionId =
+    (typeof obj.session_id === "string" && obj.session_id) ||
+    process.env.CLAUDE_SESSION_ID ||
+    "unknown";
+  const cwd = process.cwd();
+  if (!cwd) return null;
+
+  return {
+    eventId: crypto.randomUUID(),
+    type,
+    timestamp: Date.now(),
+    cwd,
+    sessionId,
+    pid: process.pid,
+    payload: obj,
+  };
+}
+
+/** 读 stdin（带超时兜底，防止无管道时阻塞）。解析失败则保留原始文本。 */
+async function readStdin(): Promise<unknown> {
+  if (process.stdin.isTTY) return null;
+  try {
+    const text = await Promise.race([
+      Bun.stdin.text(),
+      new Promise<string>((r) => setTimeout(() => r(""), 800)),
+    ]);
+    if (!text.trim()) return null;
+    try {
+      return JSON.parse(text);
+    } catch {
+      return { _raw: text };
+    }
+  } catch {
+    return null;
+  }
+}
+
+async function forward(event: HookEvent): Promise<void> {
+  const token = readToken();
+  const url = `${BASE_URL}/api/hook/${event.type}`;
+  if (await postOnce(url, event, token)) return;
+  // 热转发失败 → 故障路径
+  await ensureDaemon();
+  // 重读 token（拉起后 pid 文件已更新）
+  await postOnce(url, event, readToken() ?? token);
+}
+
+async function postOnce(url: string, event: HookEvent, token: string | null): Promise<boolean> {
+  try {
+    await fetch(url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...(token ? { authorization: `Bearer ${token}` } : {}),
+      },
+      body: JSON.stringify(event),
+      signal: AbortSignal.timeout(HOOK_POST_TIMEOUT_MS),
+    });
+    return true; // 到达 daemon 即视为成功（事件也已落盘，回捞兜底）
+  } catch {
+    return false;
+  }
+}
+
+function safeMsg(v: unknown): string {
+  return v instanceof Error ? `${v.name}: ${v.message}` : String(v);
+}
+function truncate(s: string): string {
+  return s.length > 500 ? `${s.slice(0, 500)}...` : s;
+}

package/src/install/bun.ts

@@ -0,0 +1,97 @@
+// bun 检测 + 自动安装。install CLI 由 node 跑,跑 install 时 bun 可能还没装。
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const MIN_BUN = [1, 1, 0];
+const INSTALL_TIMEOUT_MS = 5 * 60 * 1000;
+
+/** 检测 bun:先 PATH(which),再常见安装位置(不依赖 PATH 刚刷新)。 */
+export function getBunPath(): string | null {
+  const r = spawnSync("bun", ["--version"], { shell: process.platform === "win32", encoding: "utf8" });
+  if (r.status === 0 && (r.stdout ?? "").trim()) return "bun";
+  const home = homedir();
+  const candidates =
+    process.platform === "win32"
+      ? [join(home, ".bun", "bin", "bun.exe")]
+      : [join(home, ".bun", "bin", "bun"), "/usr/local/bin/bun", "/opt/homebrew/bin/bun"];
+  for (const c of candidates) {
+    if (existsSync(c)) return c;
+  }
+  return null;
+}
+
+function parseVersion(v: string): number[] {
+  return v.trim().split(".").map((x) => parseInt(x, 10) || 0);
+}
+
+function versionGte(v: string, min: number[]): boolean {
+  const parts = parseVersion(v);
+  for (let i = 0; i < min.length; i++) {
+    const p = parts[i] ?? 0;
+    const m = min[i] ?? 0;
+    if (p > m) return true;
+    if (p < m) return false;
+  }
+  return true;
+}
+
+/** 当前 npm registry 是否国内镜像(npmmirror/taobao)——是则优先 npm i -g bun 走镜像。 */
+function isCnRegistry(): boolean {
+  const reg = process.env.npm_config_registry ?? "";
+  return /npmmirror|taobao/i.test(reg);
+}
+
+function runShell(cmd: string): number {
+  return spawnSync(cmd, { shell: true, encoding: "utf8", timeout: INSTALL_TIMEOUT_MS, stdio: "inherit" }).status ?? 1;
+}
+
+/**
+ * 确保 bun 可用:已装且版本够返回路径;否则自动装。
+ * 返回 bun 可执行路径("bun" 或绝对路径)。
+ */
+export async function ensureBun(): Promise<string> {
+  const existing = getBunPath();
+  if (existing) {
+    const v =
+      spawnSync(existing, ["--version"], { shell: process.platform === "win32", encoding: "utf8" }).stdout?.trim() ?? "";
+    if (v && versionGte(v, MIN_BUN)) {
+      console.log(`[shine-code-submit] bun ${v} detected`);
+      return existing;
+    }
+  }
+
+  console.log("[shine-code-submit] bun 未找到或版本过低,开始自动安装...");
+
+  // 国内镜像优先:npm i -g bun(走 npmmirror,比官方脚本快且稳)
+  if (isCnRegistry()) {
+    console.log("[shine-code-submit] 检测到国内 npm 镜像,先尝试 npm install -g bun");
+    if (runShell("npm install -g bun") === 0) {
+      const p = getBunPath();
+      if (p) {
+        console.log("[shine-code-submit] ✓ bun 安装成功(via npm 镜像)");
+        return p;
+      }
+    }
+    console.log("[shine-code-submit] npm 镜像方式失败,回退官方脚本");
+  }
+
+  // 官方脚本
+  if (process.platform === "win32") {
+    runShell('powershell -c "irm bun.sh/install.ps1 | iex"');
+  } else {
+    runShell("curl -fsSL https://bun.sh/install | bash");
+  }
+
+  const p = getBunPath();
+  if (!p) {
+    console.error("[shine-code-submit] bun 自动安装失败。请手动安装后重试:");
+    console.error("  Windows: winget install Oven-sh.Bun   或   npm install -g bun");
+    console.error("  macOS:   brew install oven-sh/bun/bun");
+    console.error("  Linux:   curl -fsSL https://bun.sh/install | bash");
+    throw new Error("bun installation failed");
+  }
+  console.log("[shine-code-submit] ✓ bun 安装成功");
+  return p;
+}

package/src/install/deploy.ts

@@ -0,0 +1,78 @@
+// 部署 plugin 文件到 claude cache 目录,并跑 bun install 装运行时依赖(marked/react)。
+import { cpSync, existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import { pluginsRoot } from "./paths";
+import { SERVICE_VERSION } from "../shared/config";
+
+export const MARKETPLACE_NAME = "shine-code-submit";
+export const PLUGIN_NAME = "shine-code-submit";
+
+/** 部署目标版本目录:~/.claude/plugins/cache/shine-code-submit/shine-code-submit/<version>/ */
+export function cacheDir(version: string = SERVICE_VERSION): string {
+  return join(pluginsRoot(), "cache", MARKETPLACE_NAME, PLUGIN_NAME, version);
+}
+
+/** 找 npm 包根:从本文件(dist/install.cjs)上溯到含 package.json + .claude-plugin 的目录。 */
+function findPackageRoot(): string {
+  const here = dirname(fileURLToPath(import.meta.url));
+  let dir = here;
+  for (let i = 0; i < 10; i++) {
+    if (existsSync(join(dir, "package.json")) && existsSync(join(dir, ".claude-plugin"))) return dir;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return here;
+}
+
+/** 要部署的文件/目录白名单(plugin 运行必需;不含 dist/install.cjs——install CLI 本身不进 plugin)。 */
+const WHITELIST = [".claude-plugin", "hooks", "bin", "src", "ui", "package.json", "bun.lock", "README.md"];
+
+/**
+ * 部署 plugin:清同版本目录 → 拷白名单 → bun install 装依赖 → 写版本标记。
+ * 返回 cache 目录绝对路径。
+ */
+export function deployPlugin(bunPath: string): string {
+  const target = cacheDir();
+  if (existsSync(target)) rmSync(target, { recursive: true, force: true });
+  mkdirSync(target, { recursive: true });
+
+  const srcRoot = findPackageRoot();
+  console.log(`[shine-code-submit] 部署源:${srcRoot}`);
+  for (const item of WHITELIST) {
+    const from = join(srcRoot, item);
+    if (!existsSync(from)) continue; // 缺(如 bun.lock 未入库)跳过
+    cpSync(from, join(target, item), { recursive: true });
+  }
+
+  // bun install 装运行时依赖
+  console.log("[shine-code-submit] 安装运行时依赖(bun install)...");
+  let status = spawnSync(bunPath, ["install", "--frozen-lockfile"], {
+    cwd: target,
+    shell: process.platform === "win32",
+    encoding: "utf8",
+    stdio: "inherit",
+  }).status;
+  if (status !== 0) {
+    console.log("[shine-code-submit] --frozen-lockfile 失败,重试普通 bun install");
+    status = spawnSync(bunPath, ["install"], {
+      cwd: target,
+      shell: process.platform === "win32",
+      encoding: "utf8",
+      stdio: "inherit",
+    }).status;
+    if (status !== 0) {
+      throw new Error(`bun install 失败(exit ${status})。请手动在 ${target} 跑 bun install`);
+    }
+  }
+
+  writeFileSync(
+    join(target, ".install-version"),
+    JSON.stringify({ version: SERVICE_VERSION, installedAt: Date.now() }),
+    "utf8",
+  );
+  console.log(`[shine-code-submit] 已部署到 ${target}`);
+  return target;
+}

package/src/install/json-safe.ts

@@ -0,0 +1,43 @@
+// JSON 安全读写:读损坏时备份后用默认值(绝不覆盖);写时 tmp+rename 原子,首次写备份。
+// 改用户 ~/.claude 下的 JSON 全走这套,防止 install 脚本 bug 损坏 claude 配置。
+import { copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+/** 读 JSON;文件不存在/读失败返回默认;JSON 损坏则备份后返回默认(绝不覆盖原文件)。 */
+export function readJsonDefault<T>(file: string, def: T): T {
+  if (!existsSync(file)) return def;
+  let raw: string;
+  try {
+    raw = readFileSync(file, "utf8");
+  } catch {
+    return def;
+  }
+  try {
+    return JSON.parse(raw) as T;
+  } catch {
+    const bak = `${file}.bak-corrupt-${Date.now()}`;
+    try {
+      copyFileSync(file, bak);
+      console.error(`[shine-code-submit] WARNING: ${file} JSON 损坏,已备份到 ${bak},用默认值继续`);
+    } catch {
+      /* 备份失败也继续 */
+    }
+    return def;
+  }
+}
+
+/** 原子写 JSON:首次写时把原文件备份到 .bak-pre-install,写 .tmp 再 rename(同卷 rename 原子)。 */
+export function writeJsonAtomicWithBackup(file: string, data: unknown): void {
+  const bak = `${file}.bak-pre-install`;
+  if (existsSync(file) && !existsSync(bak)) {
+    try {
+      copyFileSync(file, bak);
+    } catch {
+      /* 备份失败不阻塞写 */
+    }
+  }
+  mkdirSync(dirname(file), { recursive: true });
+  const tmp = `${file}.tmp-${process.pid}`;
+  writeFileSync(tmp, JSON.stringify(data, null, 2), "utf8");
+  renameSync(tmp, file);
+}

package/src/install/main.ts

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+// install CLI 入口:install / uninstall / status。由 node 跑(编译成 dist/install.cjs)。
+// npx shine-code-submit install → 自动装 bun + 部署 plugin + 注册 + 启 daemon + 开 dashboard。
+import { existsSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+import { ensureBun } from "./bun";
+import { cacheDir, deployPlugin } from "./deploy";
+import { enablePlugin, registerMarketplace, registerPlugin, unregisterAll } from "./register";
+import { BASE_URL, PUBLIC_BASE_URL, SERVICE_VERSION } from "../shared/config";
+import { isOursAlive, openBrowser } from "../shared/daemonctl";
+import { ensureDirs } from "../shared/paths";
+import { readPidFile } from "../shared/pidfile";
+
+const [, , cmd] = process.argv;
+
+main().catch((err) => {
+  console.error(`[shine-code-submit] ${err instanceof Error ? err.message : String(err)}`);
+  process.exit(1);
+});
+
+async function main(): Promise<void> {
+  switch (cmd) {
+    case undefined:
+    case "install":
+      await runInstall();
+      break;
+    case "uninstall":
+      await runUninstall();
+      break;
+    case "status":
+      await runStatus();
+      break;
+    case "--version":
+    case "-v":
+      console.log(SERVICE_VERSION);
+      break;
+    default:
+      printHelp();
+  }
+}
+
+async function runInstall(): Promise<void> {
+  console.log(`=== shine-code-submit installer v${SERVICE_VERSION} ===`);
+  const bunPath = await ensureBun();
+  const cachePath = deployPlugin(bunPath);
+  registerMarketplace(cachePath);
+  registerPlugin(cachePath);
+  enablePlugin(cachePath);
+  ensureDirs();
+  await startDaemonWithBun(bunPath, cachePath);
+  openDashboard();
+  console.log("");
+  console.log("✓ 安装完成。");
+  console.log("  · 重启 Claude Code 后,/plugin 列表会显示 shine-code-submit(已启用)。");
+  console.log("  · 开新会话即触发 SessionStart hook,事件出现在 dashboard。");
+}
+
+async function runUninstall(): Promise<void> {
+  console.log("=== shine-code-submit uninstaller ===");
+  await stopDaemon();
+  unregisterAll();
+  const target = cacheDir();
+  if (existsSync(target)) {
+    rmSync(target, { recursive: true, force: true });
+    console.log(`[shine-code-submit] 已删除 ${target}`);
+  }
+  console.log("✓ 已卸载。重启 Claude Code 后 /plugin 不再显示。");
+}
+
+async function runStatus(): Promise<void> {
+  const alive = await isOursAlive();
+  const pid = readPidFile();
+  if (alive && pid) {
+    console.log(`daemon: running  pid=${pid.pid}  ${PUBLIC_BASE_URL}`);
+  } else {
+    console.log("daemon: not running");
+  }
+}
+
+/** 用显式 bunPath 拉 daemon。不调 daemonctl.spawnDaemon——它用 process.execPath,install 场景是 node 会出错。 */
+async function startDaemonWithBun(bunPath: string, cachePath: string): Promise<void> {
+  if (await isOursAlive()) {
+    console.log("[shine-code-submit] daemon 已在运行,跳过启动");
+    return;
+  }
+  const daemonSrc = join(cachePath, "src", "daemon", "main.ts");
+  console.log("[shine-code-submit] 启动 daemon...");
+  try {
+    const child = spawn(bunPath, ["run", daemonSrc], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true,
+      cwd: cachePath,
+      shell: process.platform === "win32",
+    });
+    child.unref();
+  } catch (err) {
+    console.error(`[shine-code-submit] 启动 daemon 失败:${err instanceof Error ? err.message : err}`);
+    console.error("  plugin 已注册,Claude Code 重启后 hook 会自动拉起 daemon");
+    return;
+  }
+  const deadline = Date.now() + 10_000;
+  while (Date.now() < deadline) {
+    await sleep(200);
+    if (await isOursAlive()) {
+      console.log("[shine-code-submit] daemon 已就绪");
+      return;
+    }
+  }
+  console.error(
+    "[shine-code-submit] daemon 启动超时(10s)。plugin 已注册,可稍后手动 `shine-code-submit start` 或重启 claude。",
+  );
+}
+
+async function stopDaemon(): Promise<void> {
+  const pid = readPidFile();
+  if (!pid) {
+    console.log("[shine-code-submit] daemon 未运行(无 pid 文件)");
+    return;
+  }
+  if (await isOursAlive()) {
+    try {
+      await fetch(`${BASE_URL}/api/shutdown`, {
+        method: "POST",
+        headers: { authorization: `Bearer ${pid.token}` },
+      });
+    } catch {
+      /* ignore */
+    }
+    await sleep(1000);
+    if (await isOursAlive()) {
+      try {
+        process.kill(pid.pid);
+      } catch {
+        /* ignore */
+      }
+    }
+  }
+  console.log("[shine-code-submit] daemon 已停止");
+}
+
+function openDashboard(): void {
+  const pid = readPidFile();
+  const url = pid ? `${PUBLIC_BASE_URL}/ui?t=${pid.token}` : `${PUBLIC_BASE_URL}/ui`;
+  console.log(`[shine-code-submit] Dashboard: ${url}`);
+  try {
+    openBrowser(url);
+  } catch {
+    /* 打开失败不阻塞 */
+  }
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function printHelp(): void {
+  console.log(`shine-code-submit <command>
+
+  install     安装插件(自动装 bun + 部署 + 注册 + 启 daemon + 开 dashboard)
+  uninstall   卸载(停 daemon + 反注册 + 删文件)
+  status      显示 daemon 状态
+
+通常通过 npx 跑:npx shine-code-submit install`);
+  process.exit(cmd ? 1 : 0);
+}

package/src/install/paths.ts

@@ -0,0 +1,28 @@
+// claude 配置根解析:CLAUDE_CONFIG_DIR 优先,回退 ~/.claude。与 claude-mem 一致。
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/** claude 配置根目录(~/.claude 或 $CLAUDE_CONFIG_DIR)。 */
+export function claudeRoot(): string {
+  return process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
+}
+
+/** plugin 根目录(~/.claude/plugins)。 */
+export function pluginsRoot(): string {
+  return join(claudeRoot(), "plugins");
+}
+
+/** 已知 marketplace 注册表路径。 */
+export function knownMarketplacesPath(): string {
+  return join(pluginsRoot(), "known_marketplaces.json");
+}
+
+/** 已安装 plugin 注册表路径。 */
+export function installedPluginsPath(): string {
+  return join(pluginsRoot(), "installed_plugins.json");
+}
+
+/** 用户 settings.json 路径(~/.claude/settings.json)。 */
+export function settingsPath(): string {
+  return join(claudeRoot(), "settings.json");
+}