@zwbigi/ink-xy 0.1.2 → 0.1.4

package/inkos/packages/studio/src/api/v13-hotfix-round4.test.ts

@@ -0,0 +1,226 @@
+/**
+ * v13 hotfix round 4 — Studio server tests for Issue 1:
+ *   Old book (no outline/story_frame.md): GET/PUT/list treat story_bible.md
+ *   and book_rules.md as normal editable files (no legacy tag).
+ *   New book (has outline/story_frame.md): GET returns legacy:true, PUT returns 400.
+ */
+
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { access } from "node:fs/promises";
+
+// ---------------------------------------------------------------------------
+// Mock — we need isNewLayoutBook to actually work (it stats the filesystem),
+// so we re-export the real implementation while mocking the rest of core.
+// ---------------------------------------------------------------------------
+
+const loadProjectConfigMock = vi.fn();
+const logger = {
+  child: () => logger,
+  info: vi.fn(),
+  warn: vi.fn(),
+  error: vi.fn(),
+};
+
+vi.mock("@actalk/inkos-core", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@actalk/inkos-core")>();
+
+  class MockStateManager {
+    constructor(private readonly root: string) {}
+    async listBooks(): Promise<string[]> { return []; }
+    async loadBookConfig(): Promise<never> { throw new Error("not implemented"); }
+    async loadChapterIndex(): Promise<[]> { return []; }
+    async getNextChapterNumber(): Promise<number> { return 1; }
+    bookDir(id: string): string { return join(this.root, "books", id); }
+  }
+  class MockPipelineRunner {
+    constructor(_config: unknown) {}
+    initBook = vi.fn();
+    runRadar = vi.fn();
+  }
+  class MockScheduler {
+    constructor(_config: unknown) {}
+    async start(): Promise<void> {}
+    stop(): void {}
+    get isRunning(): boolean { return false; }
+  }
+
+  // Real isNewLayoutBook — needs filesystem access
+  async function isNewLayoutBook(bookDir: string): Promise<boolean> {
+    const { access: accessFs } = await import("node:fs/promises");
+    const { join: joinPath } = await import("node:path");
+    try {
+      await accessFs(joinPath(bookDir, "story", "outline", "story_frame.md"));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  return {
+    StateManager: MockStateManager,
+    PipelineRunner: MockPipelineRunner,
+    Scheduler: MockScheduler,
+    isNewLayoutBook,
+    createLLMClient: vi.fn(() => ({})),
+    createLogger: vi.fn(() => logger),
+    computeAnalytics: vi.fn(() => ({})),
+    isSafeBookId: actual.isSafeBookId,
+    chatCompletion: vi.fn(),
+    loadProjectConfig: loadProjectConfigMock,
+    GLOBAL_ENV_PATH: join(tmpdir(), "inkos-global.env"),
+  };
+});
+
+const projectConfig = {
+  name: "studio-v13-hf4",
+  version: "0.1.0",
+  language: "zh" as const,
+  llm: {
+    provider: "openai",
+    baseUrl: "https://api.example.com/v1",
+    apiKey: "sk-test",
+    model: "gpt-5.4",
+    temperature: 0.7,
+    maxTokens: 4096,
+    stream: false,
+  },
+  daemon: {
+    schedule: { radarCron: "0 */6 * * *", writeCron: "*/15 * * * *" },
+    maxConcurrentBooks: 1,
+    chaptersPerCycle: 1,
+    retryDelayMs: 30000,
+    cooldownAfterChapterMs: 0,
+    maxChaptersPerDay: 50,
+  },
+  modelOverrides: {},
+  notify: [],
+};
+
+function cloneProjectConfig(): typeof projectConfig {
+  return structuredClone(projectConfig);
+}
+
+// ---------------------------------------------------------------------------
+// Old book (no outline/story_frame.md)
+// ---------------------------------------------------------------------------
+
+describe("Issue 1 — Studio: old book (no outline/story_frame.md)", () => {
+  let root: string;
+  let storyDir: string;
+
+  beforeEach(async () => {
+    root = await mkdtemp(join(tmpdir(), "studio-old-book-"));
+    await writeFile(join(root, "inkos.json"), JSON.stringify(projectConfig, null, 2), "utf-8");
+    storyDir = join(root, "books", "old-book", "story");
+    await mkdir(storyDir, { recursive: true });
+    await writeFile(join(storyDir, "story_bible.md"), "# Old Bible\nAuthoritative content", "utf-8");
+    await writeFile(join(storyDir, "book_rules.md"), "# Old Rules\nAuthoritative rules", "utf-8");
+    loadProjectConfigMock.mockReset();
+    loadProjectConfigMock.mockResolvedValue(cloneProjectConfig());
+  });
+
+  afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+  });
+
+  it("GET story_bible.md has no legacy flag", async () => {
+    const { createStudioServer } = await import("./server.js");
+    const app = createStudioServer(cloneProjectConfig() as never, root);
+
+    const res = await app.request("http://localhost/api/v1/books/old-book/truth/story_bible.md");
+    expect(res.status).toBe(200);
+    const body = await res.json() as { file: string; content: string; legacy?: boolean };
+    expect(body.content).toContain("Authoritative content");
+    expect(body.legacy).toBeUndefined();
+  });
+
+  it("PUT story_bible.md succeeds", async () => {
+    const { createStudioServer } = await import("./server.js");
+    const app = createStudioServer(cloneProjectConfig() as never, root);
+
+    const res = await app.request("http://localhost/api/v1/books/old-book/truth/story_bible.md", {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ content: "# Updated Bible" }),
+    });
+    expect(res.status).toBe(200);
+    const saved = await readFile(join(storyDir, "story_bible.md"), "utf-8");
+    expect(saved).toBe("# Updated Bible");
+  });
+
+  it("list endpoint shows story_bible.md without legacy tag", async () => {
+    const { createStudioServer } = await import("./server.js");
+    const app = createStudioServer(cloneProjectConfig() as never, root);
+
+    const res = await app.request("http://localhost/api/v1/books/old-book/truth");
+    expect(res.status).toBe(200);
+    const body = await res.json() as { files: ReadonlyArray<{ name: string; legacy?: true }> };
+    const bibleEntry = body.files.find((f) => f.name === "story_bible.md");
+    expect(bibleEntry).toBeDefined();
+    expect(bibleEntry!.legacy).toBeUndefined();
+  });
+});
+
+// ---------------------------------------------------------------------------
+// New book (has outline/story_frame.md)
+// ---------------------------------------------------------------------------
+
+describe("Issue 1 — Studio: new book (has outline/story_frame.md)", () => {
+  let root: string;
+  let storyDir: string;
+
+  beforeEach(async () => {
+    root = await mkdtemp(join(tmpdir(), "studio-new-book-"));
+    await writeFile(join(root, "inkos.json"), JSON.stringify(projectConfig, null, 2), "utf-8");
+    storyDir = join(root, "books", "new-book", "story");
+    await mkdir(join(storyDir, "outline"), { recursive: true });
+    await writeFile(join(storyDir, "outline", "story_frame.md"), "# Frame", "utf-8");
+    await writeFile(join(storyDir, "story_bible.md"), "# Shim bible", "utf-8");
+    await writeFile(join(storyDir, "book_rules.md"), "# Shim rules", "utf-8");
+    loadProjectConfigMock.mockReset();
+    loadProjectConfigMock.mockResolvedValue(cloneProjectConfig());
+  });
+
+  afterEach(async () => {
+    await rm(root, { recursive: true, force: true });
+  });
+
+  it("GET story_bible.md has legacy:true", async () => {
+    const { createStudioServer } = await import("./server.js");
+    const app = createStudioServer(cloneProjectConfig() as never, root);
+
+    const res = await app.request("http://localhost/api/v1/books/new-book/truth/story_bible.md");
+    expect(res.status).toBe(200);
+    const body = await res.json() as { legacy?: boolean };
+    expect(body.legacy).toBe(true);
+  });
+
+  it("PUT story_bible.md returns 400", async () => {
+    const { createStudioServer } = await import("./server.js");
+    const app = createStudioServer(cloneProjectConfig() as never, root);
+
+    const res = await app.request("http://localhost/api/v1/books/new-book/truth/story_bible.md", {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ content: "# Attempt" }),
+    });
+    expect(res.status).toBe(400);
+    const body = await res.json() as { error: string };
+    expect(body.error).toMatch(/Legacy compat shim/);
+  });
+
+  it("list endpoint shows story_bible.md with legacy tag", async () => {
+    const { createStudioServer } = await import("./server.js");
+    const app = createStudioServer(cloneProjectConfig() as never, root);
+
+    const res = await app.request("http://localhost/api/v1/books/new-book/truth");
+    expect(res.status).toBe(200);
+    const body = await res.json() as { files: ReadonlyArray<{ name: string; legacy?: true }> };
+    const bibleEntry = body.files.find((f) => f.name === "story_bible.md");
+    expect(bibleEntry).toBeDefined();
+    expect(bibleEntry!.legacy).toBe(true);
+  });
+});

package/inkos/packages/studio/src/app-state.test.ts

@@ -0,0 +1,8 @@
+import { describe, expect, it } from "vitest";
+import { DEFAULT_CHAT_OPEN } from "./app-state";
+
+describe("app shell state", () => {
+  it("opens the chat panel by default", () => {
+    expect(DEFAULT_CHAT_OPEN).toBe(true);
+  });
+});

package/inkos/packages/studio/src/app-state.ts

@@ -0,0 +1 @@
+export const DEFAULT_CHAT_OPEN = true;

package/inkos/packages/studio/src/components/ConfirmDialog.tsx

@@ -0,0 +1,95 @@
+import { useEffect, useRef } from "react";
+import { createPortal } from "react-dom";
+import { AlertTriangle, X } from "lucide-react";
+
+interface ConfirmDialogProps {
+  readonly open: boolean;
+  readonly title: string;
+  readonly message: string;
+  readonly confirmLabel: string;
+  readonly cancelLabel: string;
+  readonly variant?: "danger" | "default";
+  readonly onConfirm: () => void;
+  readonly onCancel: () => void;
+}
+
+export function ConfirmDialog({
+  open,
+  title,
+  message,
+  confirmLabel,
+  cancelLabel,
+  variant = "default",
+  onConfirm,
+  onCancel,
+}: ConfirmDialogProps) {
+  const overlayRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    const handleKey = (e: KeyboardEvent) => {
+      if (e.key === "Escape") onCancel();
+    };
+    document.addEventListener("keydown", handleKey);
+    return () => document.removeEventListener("keydown", handleKey);
+  }, [open, onCancel]);
+
+  if (!open) return null;
+  if (typeof document === "undefined") return null;
+
+  const isDanger = variant === "danger";
+
+  return createPortal(
+    <div
+      ref={overlayRef}
+      className="fixed inset-0 z-[100] flex items-center justify-center bg-black/40 backdrop-blur-sm fade-in"
+      onClick={(e) => { if (e.target === overlayRef.current) onCancel(); }}
+    >
+      <div className="bg-card border border-border rounded-2xl shadow-2xl shadow-primary/10 w-full max-w-md mx-4 overflow-hidden chat-msg-assistant">
+        {/* Header */}
+        <div className="flex items-center justify-between px-6 pt-6 pb-2">
+          <div className="flex items-center gap-3">
+            {isDanger && (
+              <div className="w-10 h-10 rounded-xl bg-destructive/10 flex items-center justify-center">
+                <AlertTriangle size={20} className="text-destructive" />
+              </div>
+            )}
+            <h3 className="text-lg font-semibold">{title}</h3>
+          </div>
+          <button
+            onClick={onCancel}
+            className="p-1.5 rounded-lg text-muted-foreground hover:text-foreground hover:bg-secondary transition-colors"
+          >
+            <X size={16} />
+          </button>
+        </div>
+
+        {/* Body */}
+        <div className="px-6 py-4">
+          <p className="text-sm text-muted-foreground leading-relaxed">{message}</p>
+        </div>
+
+        {/* Footer */}
+        <div className="flex justify-end gap-3 px-6 pb-6">
+          <button
+            onClick={onCancel}
+            className="px-4 py-2.5 text-sm font-medium rounded-xl bg-secondary text-foreground hover:bg-secondary/80 transition-all border border-border/50"
+          >
+            {cancelLabel}
+          </button>
+          <button
+            onClick={onConfirm}
+            className={`px-4 py-2.5 text-sm font-bold rounded-xl transition-all hover:scale-105 active:scale-95 shadow-sm ${
+              isDanger
+                ? "bg-destructive text-white hover:shadow-destructive/20"
+                : "bg-primary text-primary-foreground hover:shadow-primary/20"
+            }`}
+          >
+            {confirmLabel}
+          </button>
+        </div>
+      </div>
+    </div>,
+    document.body,
+  );
+}

package/inkos/packages/studio/src/components/ServiceConfigSourceCard.tsx

@@ -0,0 +1,139 @@
+import { useEffect, useState } from "react";
+import { fetchJson } from "../hooks/use-api";
+
+type ConfigSource = "env" | "studio";
+type EnvScope = "project" | "global" | null;
+
+interface EnvConfigSummary {
+  detected: boolean;
+  provider: string | null;
+  baseUrl: string | null;
+  model: string | null;
+  hasApiKey: boolean;
+}
+
+interface ServiceConfigPayload {
+  services: Array<Record<string, unknown>>;
+  defaultModel: string | null;
+  configSource: ConfigSource;
+  storedConfigSource?: ConfigSource;
+  envConfig: {
+    project: EnvConfigSummary;
+    global: EnvConfigSummary;
+    effectiveSource: EnvScope;
+    runtimeUsesEnv: boolean;
+  };
+}
+
+export function ServiceConfigSourceCard({ onChange }: { onChange?: () => void }) {
+  const [data, setData] = useState<ServiceConfigPayload | null>(null);
+  const [saving, setSaving] = useState<ConfigSource | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const load = async () => {
+    try {
+      const payload = await fetchJson<ServiceConfigPayload>("/services/config");
+      setData(payload);
+      setError(null);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : "读取配置来源失败");
+    }
+  };
+
+  useEffect(() => {
+    void load();
+  }, []);
+
+  const switchSource = async (configSource: ConfigSource) => {
+    setSaving(configSource);
+    try {
+      await fetchJson("/services/config", {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ configSource }),
+      });
+      await load();
+      onChange?.();
+    } catch (e) {
+      setError(e instanceof Error ? e.message : "切换配置来源失败");
+    } finally {
+      setSaving(null);
+    }
+  };
+
+  if (!data && !error) {
+    return (
+      <div className="rounded-xl border border-border/40 bg-card/70 p-4 text-sm text-muted-foreground/70">
+        正在读取配置来源…
+      </div>
+    );
+  }
+
+  if (!data) {
+    return (
+      <div className="rounded-xl border border-amber-500/30 bg-amber-500/[0.04] p-4 text-sm text-amber-600">
+        {error ?? "读取配置来源失败"}
+      </div>
+    );
+  }
+
+  const { configSource, envConfig } = data;
+  const storedConfigSource = data.storedConfigSource ?? configSource;
+  const activeEnvSummary = envConfig.effectiveSource === "project" ? envConfig.project : envConfig.global;
+  const envLabel = envConfig.effectiveSource === "project" ? "项目 .env" : envConfig.effectiveSource === "global" ? "全局 ~/.inkos/.env" : null;
+  const envDetected = envConfig.project.detected || envConfig.global.detected;
+
+  return (
+    <div className="rounded-xl border border-border/40 bg-card/70 p-4 space-y-3">
+      <div className="flex items-center justify-between gap-3">
+        <div>
+          <div className="text-sm font-medium">LLM 配置来源</div>
+          <div className="text-xs text-muted-foreground/70 mt-1">
+            Studio 运行时：
+            <span className="text-foreground"> 使用服务页配置和 Studio 密钥</span>
+          </div>
+        </div>
+        <div className="flex items-center gap-2">
+          <button
+            type="button"
+            onClick={() => void switchSource("studio")}
+            disabled={saving !== null || configSource === "studio"}
+            className="rounded-lg border border-border/50 px-3 py-1.5 text-xs hover:bg-secondary/50 disabled:opacity-50"
+          >
+            {saving === "studio" ? "切换中…" : "使用 Studio 配置"}
+          </button>
+        </div>
+      </div>
+
+      {storedConfigSource === "env" ? (
+        <div className="rounded-lg border border-amber-500/25 bg-amber-500/[0.04] p-3 text-xs text-muted-foreground/80">
+          检测到旧配置标记为 `.env` 优先。Studio 运行时不会使用它；CLI、daemon 和部署环境仍可按 env 覆盖层使用。
+        </div>
+      ) : null}
+
+      {envDetected ? (
+        <div className="rounded-lg border border-amber-500/25 bg-amber-500/[0.04] p-3 text-xs text-muted-foreground/80 space-y-1.5">
+          <div className="text-foreground">
+            检测到 LLM 环境变量覆盖：
+            <span className="font-medium"> {envLabel ?? "已检测到但未定位来源"}</span>
+          </div>
+          {activeEnvSummary.baseUrl ? <div>Base URL: <span className="font-mono text-foreground">{activeEnvSummary.baseUrl}</span></div> : null}
+          {activeEnvSummary.model ? <div>Model: <span className="font-mono text-foreground">{activeEnvSummary.model}</span></div> : null}
+          {activeEnvSummary.provider ? <div>Provider: <span className="font-mono text-foreground">{activeEnvSummary.provider}</span></div> : null}
+          <div>API Key: <span className="text-foreground">{activeEnvSummary.hasApiKey ? "已设置" : "未设置"}</span></div>
+          <div className="text-muted-foreground/70 pt-1">
+            当前虽然检测到 .env，但 Studio 和 Agent 请求会忽略这套 LLM 覆盖；CLI、daemon 和部署环境可以使用它。
+          </div>
+        </div>
+      ) : (
+        <div className="rounded-lg border border-border/30 bg-secondary/20 p-3 text-xs text-muted-foreground/75">
+          未检测到目录或全局 `.env` 里的 LLM 覆盖变量。当前会直接使用项目配置和 Studio 服务配置。
+        </div>
+      )}
+
+      {error ? (
+        <div className="text-xs text-rose-500">{error}</div>
+      ) : null}
+    </div>
+  );
+}

package/inkos/packages/studio/src/components/ServiceQuickLinks.tsx

@@ -0,0 +1,65 @@
+import { ExternalLink } from "lucide-react";
+
+interface ServiceQuickLink {
+  readonly label: string;
+  readonly href: string;
+}
+
+const SERVICE_QUICK_LINKS: Record<string, ReadonlyArray<ServiceQuickLink>> = {
+  kkaiapi: [
+    { label: "官网", href: "https://kkaiapi.com/" },
+    { label: "API 文档", href: "https://kkaiapi.com/docs" },
+    { label: "模型/价格", href: "https://kkaiapi.com/models" },
+  ],
+  openrouter: [
+    { label: "API Keys", href: "https://openrouter.ai/keys" },
+    { label: "模型", href: "https://openrouter.ai/models" },
+    { label: "文档", href: "https://openrouter.ai/docs/api-reference/overview" },
+  ],
+};
+
+export function getServiceQuickLinks(serviceId: string): ReadonlyArray<ServiceQuickLink> {
+  return SERVICE_QUICK_LINKS[serviceId] ?? [];
+}
+
+export function ServiceQuickLinks({
+  serviceId,
+  variant = "detail",
+  className = "",
+}: {
+  readonly serviceId: string;
+  readonly variant?: "card" | "detail";
+  readonly className?: string;
+}) {
+  const links = getServiceQuickLinks(serviceId);
+  if (links.length === 0) return null;
+
+  const compact = variant === "card";
+  return (
+    <div
+      className={[
+        "flex flex-wrap items-center gap-1.5 text-muted-foreground/70",
+        compact ? "text-[11px]" : "text-xs",
+        className,
+      ].filter(Boolean).join(" ")}
+    >
+      {!compact && <span className="mr-0.5">配置入口</span>}
+      {links.map((link) => (
+        <a
+          key={link.href}
+          href={link.href}
+          target="_blank"
+          rel="noreferrer"
+          onClick={(event) => event.stopPropagation()}
+          className={[
+            "inline-flex items-center gap-1 rounded-md border border-border/40 bg-card/50 font-medium text-muted-foreground transition-colors hover:border-primary/30 hover:text-foreground",
+            compact ? "px-1.5 py-0.5" : "px-2 py-1",
+          ].join(" ")}
+        >
+          {link.label}
+          <ExternalLink size={compact ? 10 : 11} />
+        </a>
+      ))}
+    </div>
+  );
+}