@zwbigi/ink-xy 0.1.2 → 0.1.4

package/inkos/packages/core/src/utils/writing-methodology.ts

@@ -0,0 +1,164 @@
+/**
+ * Full writing methodology for style_guide.md injection.
+ * This is the complete reference material (with examples) that the
+ * compact "craft card" in the system prompt summarizes.
+ *
+ * Injected once during initBook/generateStyleGuide, then read by
+ * writer on every chapter as part of the style_guide context.
+ */
+export function buildWritingMethodologySection(language: "zh" | "en"): string {
+  if (language === "en") {
+    return buildEnglishMethodology();
+  }
+  return buildChineseMethodology();
+}
+
+function buildChineseMethodology(): string {
+  return `---
+
+# 写作方法论参考（完整版）
+
+以下方法论是写作质量的完整参考。写作时应内化这些原则。
+
+## 一、去AI味：正反例对照
+
+### 情绪描写
+| 反例（AI味） | 正例（人味） | 要点 |
+|---|---|---|
+| 他感到非常愤怒。 | 他捏碎了手中的茶杯，滚烫的茶水流过指缝，但他像没感觉一样。 | 用动作外化情绪 |
+| 她心里很悲伤，眼泪流了下来。 | 她攥紧手机，指节发白，屏幕上的聊天记录模糊成一片。 | 用身体细节替代直白标签 |
+| 他感到一阵恐惧。 | 他后背的汗毛竖了起来，脚底像踩在了冰上。 | 五感传递恐惧 |
+
+### 转折与衔接
+| 反例 | 正例 | 要点 |
+|---|---|---|
+| 虽然他很强，但是他还是输了。 | 他确实强，可对面那个老东西更脏。 | 口语化转折 |
+| 然而，事情并没有那么简单。 | 哪有那么便宜的事。 | 角色内心吐槽替代"然而" |
+| 因此，他决定采取行动。 | 他站起来，把凳子踢到一边。 | 删掉因果连词，直接写动作 |
+
+### "了"字控制
+| 反例 | 正例 |
+|---|---|
+| 他走了过去，拿了杯子，喝了一口水。 | 他走过去，端起杯子，灌了一口。 |
+| 她笑了笑，转身离开了房间。 | 她嘴角一扬，转身出门。 |
+
+## 二、六步走人物心理分析
+
+每个重要角色在关键场景中的行为，必须经过以下六步推导：
+
+1. **当前处境**：角色此刻面临什么局面？手上有什么牌？
+2. **核心动机**：角色最想要什么？最害怕什么？
+3. **信息边界**：角色知道什么？不知道什么？对局势有什么误判？
+4. **性格过滤**：同样的局面，这个角色的性格会怎么反应？
+5. **行为选择**：基于以上四点，角色会做出什么选择？
+6. **情绪外化**：这个选择伴随什么情绪？用什么身体语言、表情、语气表达？
+
+禁止跳过步骤直接写行为。
+
+## 三、配角设计方法论
+
+- 配角必须有反击，有自己的算盘。主角的强大在于压服聪明人，而不是碾压傻子。
+- 每个配角的行为动机必须与主线产生关联。
+- 核心标签 + 反差细节 = 活人（表面冷硬的角色偷偷照顾流浪动物）。
+- 通过事件立人设，禁止通过外貌和形容词堆砌。
+- 不同角色的说话方式必须有辨识度。
+- 群戏中不写"众人齐声惊呼"，挑1-2个角色写具体反应。
+
+## 四、代入感六大支柱
+
+1. **基础信息交代**：一句话能交代身份、性格、地位——"小爷我乃镇南府世子林峰"
+2. **具体化/可视化**：描写具体到读者脑海能浮现——"搪瓷缸白汽直冒""冰镇汽水嘶嘶响"
+3. **熟悉感**：接地气的场景自带代入感——"高考后小树林的分手""医院走廊的消毒水味"
+4. **共鸣**：主角的困境必须有普遍性——被欺压、不公待遇、被低估
+5. **欲望驱动**：
+   - 基础欲望（被动）：不劳而获、高人一等、扬眉吐气
+   - 主动欲望（期待感）：作者刻意制造的情绪缺口→读者期待释放→释放超过预期
+6. **五感描写**：视觉、听觉、嗅觉、触觉、味觉——"潮湿的短袖黏在后背上"
+
+## 五、强情绪升级法（避免流水账）
+
+流水账的修法不是删掉日常，而是给日常加"料"：
+
+1. **加入前因后果**：下班回家→加上"催债电话刚打来"→日常有了紧迫感
+2. **情绪递进**：坏事叠坏事——被骂→赶不上公交→手机掉了→直播课结束了→包子噎住了。每层比上一层过分
+3. **日常必须为主线服务**：万物皆为"饵"。日常段要么埋伏笔，要么推关系，要么建立反差
+
+## 六、写前自检清单
+
+1. 本章对应卷纲中的哪个节点？是否推进了该节点？
+2. 主角此刻利益最大化的选择是什么？
+3. 冲突是谁先动手，为什么非做不可？
+4. 配角/反派是否有明确诉求和反制？
+5. 反派当前掌握了哪些信息？有无信息越界？
+6. 章尾是否留了钩子？
+7. 有没有流水账？如有，加前因后果或强情绪
+8. 本章是否推进了主线目标？`;
+}
+
+function buildEnglishMethodology(): string {
+  return `---
+
+# Writing Methodology Reference (Full Version)
+
+Complete reference material for writing quality. Internalize these principles.
+
+## 1. Anti-AI Pattern Guide
+
+### Emotion
+| Bad (AI-like) | Good (Human) | Key |
+|---|---|---|
+| He felt very angry. | He crushed the teacup in his hand. Scalding water ran through his fingers, but he didn't flinch. | Externalize through action |
+| She was very sad and tears fell. | She gripped her phone until her knuckles went white. The chat log blurred. | Body detail replaces label |
+
+### Transitions
+| Bad | Good | Key |
+|---|---|---|
+| Although he was strong, he still lost. | He was strong, sure. But the old bastard across from him fought dirtier. | Colloquial voice |
+| However, things were not so simple. | No such luck. | Character thought replaces "however" |
+| Therefore, he decided to take action. | He stood up and kicked the chair aside. | Cut causal connectors, show action |
+
+## 2. Six-Step Character Psychology
+
+For every important character action:
+1. **Situation**: What's the character facing? What cards do they hold?
+2. **Core motivation**: What do they want most? Fear most?
+3. **Information boundary**: What do they know? Not know? Misjudge?
+4. **Personality filter**: Given the same situation, how would THIS character react?
+5. **Behavioral choice**: Based on 1-4, what do they choose?
+6. **Emotional expression**: What emotion accompanies this? Body language, expression, tone?
+
+## 3. Supporting Character Design
+
+- Every side character has their own agenda. Protagonist wins by outsmarting smart people.
+- Core tag + contrast detail = alive (cold-exterior character secretly feeds strays).
+- Establish character through events, not description dumps.
+- Different characters speak differently — vocabulary, length, verbal tics.
+- In group scenes: never "everyone gasped" — pick 1-2 specific reactions.
+
+## 4. Immersion Pillars
+
+1. **Info delivery**: One line of dialogue can establish identity, status, personality
+2. **Concrete/visual**: "The back seat of a taxi stuck in traffic for forty minutes" not "a big city"
+3. **Familiarity**: Scenes readers have lived through carry natural immersion
+4. **Resonance**: Protagonist's struggle must feel universal — injustice, being underestimated
+5. **Desire engine**: Create emotional gap → reader anticipates release → release exceeds expectation
+6. **Five senses**: Wet shirt on the back, hospital disinfectant, rain puddles at the bus stop
+
+## 5. Emotional Escalation (Anti-Flowchart)
+
+Fix boring daily scenes by adding fuel:
+1. **Add causality**: Coming home → add "debt collector just called" → instant urgency
+2. **Progressive escalation**: Stack bad things — scolded → missed bus → phone fell in drain → livestream ended → choked on stale bread. Each layer worse.
+3. **Daily serves mainline**: Every quiet scene must plant a hook, advance a relationship, or build contrast.
+
+## 6. Pre-Write Checklist
+
+1. Which outline node does this chapter correspond to?
+2. What's the protagonist's optimal move right now?
+3. Who starts the conflict and why must they?
+4. Do antagonists have clear motives and countermoves?
+5. What information does each character have? Any boundary violations?
+6. Does the chapter end with a hook?
+7. Any flowchart passages? If so, add causality or strong emotion.
+8. Does this chapter advance the main plotline?`;
+}

package/inkos/packages/core/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}

package/inkos/packages/core/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["src/__tests__/**/*.test.ts"],
+  },
+});

package/inkos/packages/studio/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-nova",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/index.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/inkos/packages/studio/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>📜</text></svg>">
+    <title>InkOS Studio</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/inkos/packages/studio/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@actalk/inkos-studio",
+  "version": "1.4.1",
+  "description": "InkOS Studio — Web workbench for novel writing",
+  "type": "module",
+  "main": "dist/api/index.js",
+  "types": "dist/api/index.d.ts",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*"
+  ],
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Narcooo/inkos.git",
+    "directory": "packages/studio"
+  },
+  "scripts": {
+    "prepack": "npm run build && node ../../scripts/prepare-package-for-publish.mjs",
+    "postpack": "node ../../scripts/restore-package-json.mjs",
+    "prepublishOnly": "node ../../scripts/verify-no-workspace-protocol.mjs .",
+    "dev": "INKOS_STUDIO_PORT=4569 INKOS_PROJECT_ROOT=../.. tsx watch --clear-screen=false src/api/index.ts & vite --host --port 4567 ; kill %1 2>/dev/null",
+    "dev:client": "vite --host --port 4567",
+    "dev:server": "INKOS_STUDIO_PORT=4569 INKOS_PROJECT_ROOT=../.. tsx watch src/api/index.ts",
+    "build": "npm run build:client && npm run build:server",
+    "build:client": "vite build",
+    "build:server": "tsc -p tsconfig.server.json",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.server.json --noEmit"
+  },
+  "dependencies": {
+    "@actalk/inkos-core": "workspace:*",
+    "@base-ui/react": "^1.3.0",
+    "@fontsource-variable/geist": "^5.2.8",
+    "@hono/node-server": "^1.13.0",
+    "@radix-ui/react-use-controllable-state": "^1.2.2",
+    "@streamdown/cjk": "^1.0.3",
+    "@streamdown/code": "^1.1.1",
+    "@streamdown/math": "^1.0.2",
+    "@streamdown/mermaid": "^1.0.2",
+    "ai": "^6.0.159",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "hono": "^4.7.0",
+    "lucide-react": "^0.577.0",
+    "motion": "^12.38.0",
+    "nanoid": "^5.1.7",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "shadcn": "^4.2.0",
+    "shiki": "^4.0.2",
+    "streamdown": "^2.5.0",
+    "tailwind-merge": "^3.5.0",
+    "tw-animate-css": "^1.4.0",
+    "zustand": "^5.0.12"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.0.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.4.0",
+    "autoprefixer": "^10.4.0",
+    "tailwindcss": "^4.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.8.0",
+    "vite": "^6.0.0",
+    "vitest": "^3.0.0"
+  }
+}

package/inkos/packages/studio/postcss.config.js

@@ -0,0 +1,3 @@
+export default {
+  plugins: {}
+};

package/inkos/packages/studio/src/App.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+import { deriveActiveBookId, isBookCreateChatRoute } from "./App";
+
+describe("deriveActiveBookId", () => {
+  it("returns the current book across book-centered routes", () => {
+    expect(deriveActiveBookId({ page: "book", bookId: "alpha" })).toBe("alpha");
+    expect(deriveActiveBookId({ page: "chapter", bookId: "beta", chapterNumber: 3 })).toBe("beta");
+    expect(deriveActiveBookId({ page: "truth", bookId: "gamma" })).toBe("gamma");
+    expect(deriveActiveBookId({ page: "analytics", bookId: "delta" })).toBe("delta");
+    expect(deriveActiveBookId({ page: "book-settings", bookId: "epsilon" })).toBe("epsilon");
+  });
+
+  it("returns undefined for non-book routes", () => {
+    expect(deriveActiveBookId({ page: "dashboard" })).toBeUndefined();
+    expect(deriveActiveBookId({ page: "services" })).toBeUndefined();
+    expect(deriveActiveBookId({ page: "style" })).toBeUndefined();
+  });
+});
+
+describe("isBookCreateChatRoute", () => {
+  it("routes new-book creation through chat instead of the standalone form page", () => {
+    expect(isBookCreateChatRoute({ page: "book-create" })).toBe(true);
+    expect(isBookCreateChatRoute({ page: "book", bookId: "alpha" })).toBe(false);
+  });
+});

package/inkos/packages/studio/src/App.tsx

@@ -0,0 +1,280 @@
+import { useState, useEffect } from "react";
+import { useHashRoute } from "./hooks/use-hash-route";
+import type { HashRoute } from "./hooks/use-hash-route";
+import { Sidebar } from "./components/Sidebar";
+import { Dashboard } from "./pages/Dashboard";
+import { ChatPage } from "./pages/ChatPage";
+import { BookDetail } from "./pages/BookDetail";
+import { ChapterReader } from "./pages/ChapterReader";
+import { Analytics } from "./pages/Analytics";
+import { ServiceListPage } from "./pages/ServiceListPage";
+import { ServiceDetailPage } from "./pages/ServiceDetailPage";
+import { TruthFiles } from "./pages/TruthFiles";
+import { DaemonControl } from "./pages/DaemonControl";
+import { LogViewer } from "./pages/LogViewer";
+import { GenreManager } from "./pages/GenreManager";
+import { StyleManager } from "./pages/StyleManager";
+import { ImportManager } from "./pages/ImportManager";
+import { RadarView } from "./pages/RadarView";
+import { DoctorView } from "./pages/DoctorView";
+import { LanguageSelector } from "./pages/LanguageSelector";
+import { BookSidebar, BookSidebarToggle } from "./components/chat/BookSidebar";
+import { useSSE } from "./hooks/use-sse";
+import { useSessionEvents } from "./hooks/use-session-events";
+import { useTheme } from "./hooks/use-theme";
+import { useI18n } from "./hooks/use-i18n";
+import { postApi, putApi, useApi } from "./hooks/use-api";
+import { Sun, Moon } from "lucide-react";
+import { House } from "lucide-react";
+
+export type { HashRoute as Route } from "./hooks/use-hash-route";
+
+export function deriveActiveBookId(route: HashRoute): string | undefined {
+  if ("bookId" in route) return route.bookId;
+  return undefined;
+}
+
+export function isBookCreateChatRoute(route: HashRoute): boolean {
+  return route.page === "book-create";
+}
+
+export function App() {
+  const { route, setRoute } = useHashRoute();
+  const sse = useSSE();
+  const { theme, setTheme } = useTheme();
+  const { t, lang: currentLang } = useI18n();
+  const { data: project, refetch: refetchProject } = useApi<{ language: string; languageExplicit: boolean }>("/project");
+  const [showLanguageSelector, setShowLanguageSelector] = useState(false);
+  const [ready, setReady] = useState(false);
+
+  const isDark = theme === "dark";
+
+  useEffect(() => {
+    document.documentElement.classList.toggle("dark", isDark);
+  }, [isDark]);
+
+  useEffect(() => {
+    if (project) {
+      if (!project.languageExplicit) {
+        setShowLanguageSelector(true);
+      }
+      setReady(true);
+    }
+  }, [project]);
+
+  useSessionEvents(sse, route, setRoute);
+
+  const nav = {
+    toDashboard: () => setRoute({ page: "dashboard" }),
+    toChat: () => setRoute({ page: "chat" }),
+    toBook: (bookId: string) => setRoute({ page: "book", bookId }),
+    toBookSettings: (bookId: string) => setRoute({ page: "book-settings", bookId }),
+    toBookCreate: () => setRoute({ page: "book-create" }),
+    toChapter: (bookId: string, chapterNumber: number) =>
+      setRoute({ page: "chapter", bookId, chapterNumber }),
+    toAnalytics: (bookId: string) => setRoute({ page: "analytics", bookId }),
+    toServices: () => setRoute({ page: "services" }),
+    toServiceDetail: (id: string) => setRoute({ page: "service-detail", serviceId: id }),
+    toTruth: (bookId: string) => setRoute({ page: "truth", bookId }),
+    toDaemon: () => setRoute({ page: "daemon" }),
+    toLogs: () => setRoute({ page: "logs" }),
+    toGenres: () => setRoute({ page: "genres" }),
+    toStyle: () => setRoute({ page: "style" }),
+    toImport: () => setRoute({ page: "import" }),
+    toRadar: () => setRoute({ page: "radar" }),
+    toDoctor: () => setRoute({ page: "doctor" }),
+  };
+
+  const activeBookId = deriveActiveBookId(route);
+  const activePage =
+    activeBookId
+      ? `book:${activeBookId}`
+      : route.page === "service-detail"
+        ? "services"
+        : route.page;
+
+  if (!ready) {
+    return (
+      <div className="min-h-screen bg-background flex items-center justify-center">
+        <div className="w-12 h-12 border-4 border-primary/20 border-t-primary rounded-full animate-spin" />
+      </div>
+    );
+  }
+
+  if (showLanguageSelector) {
+    return (
+      <LanguageSelector
+        onSelect={async (lang) => {
+          await postApi("/project/language", { language: lang });
+          setShowLanguageSelector(false);
+          refetchProject();
+        }}
+      />
+    );
+  }
+
+  return (
+    <div className="h-screen bg-background text-foreground flex overflow-hidden font-sans">
+      {/* Left Sidebar */}
+      <Sidebar nav={nav} activePage={activePage} sse={sse} t={t} />
+
+      {/* Center Content */}
+      <div className="flex-1 flex flex-col min-w-0 bg-background/30 backdrop-blur-sm">
+        {/* Header Strip */}
+        <header className="h-14 shrink-0 flex items-center justify-between px-8 border-b border-border/40">
+          <div className="flex items-center gap-2">
+             <button
+               onClick={nav.toDashboard}
+               className="inline-flex items-center gap-2 rounded-lg border border-border/50 bg-card/70 px-3 py-1.5 text-sm font-semibold text-foreground hover:bg-secondary/50 transition-colors"
+             >
+               <House size={14} />
+               <span>首页</span>
+               <span className="text-muted-foreground/70">/</span>
+               <span className="font-serif">InkOS Studio</span>
+             </button>
+          </div>
+
+          <div className="flex items-center gap-3">
+            <div className="flex gap-0.5 bg-muted/50 rounded-md p-0.5">
+              <button
+                onClick={async () => {
+                  await putApi("/project", { language: "zh" });
+                  refetchProject();
+                }}
+                className={`text-xs px-2 py-0.5 rounded ${currentLang === "zh" ? "bg-primary text-primary-foreground" : "text-muted-foreground"}`}
+              >
+                中
+              </button>
+              <button
+                onClick={async () => {
+                  await putApi("/project", { language: "en" });
+                  refetchProject();
+                }}
+                className={`text-xs px-2 py-0.5 rounded ${currentLang === "en" ? "bg-primary text-primary-foreground" : "text-muted-foreground"}`}
+              >
+                EN
+              </button>
+            </div>
+
+            <button
+              onClick={() => setTheme(isDark ? "light" : "dark")}
+              className="text-muted-foreground hover:text-foreground transition-colors"
+            >
+              {isDark ? <Sun size={14} /> : <Moon size={14} />}
+            </button>
+          </div>
+        </header>
+
+        {/* Main Content Area */}
+        <main className="flex-1 relative overflow-y-auto scroll-smooth">
+          {route.page === "dashboard" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <Dashboard nav={nav} sse={sse} theme={theme} t={t} />
+            </div>
+          )}
+          {isBookCreateChatRoute(route) && (
+            <div className="absolute inset-0 flex min-w-0">
+              <ChatPage
+                mode="book-create"
+                nav={nav}
+                theme={theme}
+                t={t}
+                sse={sse}
+              />
+            </div>
+          )}
+          {route.page === "chat" && (
+            <div className="absolute inset-0 flex min-w-0">
+              <ChatPage
+                mode="project-chat"
+                nav={nav}
+                theme={theme}
+                t={t}
+                sse={sse}
+              />
+            </div>
+          )}
+          {route.page === "book" && (
+            <div className="absolute inset-0 flex min-w-0">
+              <ChatPage
+                activeBookId={route.bookId}
+                mode="book"
+                nav={nav}
+                theme={theme}
+                t={t}
+                sse={sse}
+              />
+              <BookSidebar bookId={route.bookId} theme={theme} t={t} sse={sse} />
+              <BookSidebarToggle bookId={route.bookId} theme={theme} t={t} sse={sse} />
+            </div>
+          )}
+          {route.page === "book-settings" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <BookDetail bookId={route.bookId} nav={nav} theme={theme} t={t} sse={sse} />
+            </div>
+          )}
+          {route.page === "chapter" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <ChapterReader bookId={route.bookId} chapterNumber={route.chapterNumber} nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "analytics" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <Analytics bookId={route.bookId} nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "services" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <ServiceListPage nav={nav} />
+            </div>
+          )}
+          {route.page === "service-detail" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <ServiceDetailPage serviceId={route.serviceId} nav={nav} />
+            </div>
+          )}
+          {route.page === "truth" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <TruthFiles bookId={route.bookId} nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "daemon" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <DaemonControl nav={nav} theme={theme} t={t} sse={sse} />
+            </div>
+          )}
+          {route.page === "logs" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <LogViewer nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "genres" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <GenreManager nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "style" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <StyleManager nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "import" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <ImportManager nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "radar" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <RadarView nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+          {route.page === "doctor" && (
+            <div className="max-w-4xl mx-auto px-6 py-12 md:px-12 lg:py-16 fade-in">
+              <DoctorView nav={nav} theme={theme} t={t} />
+            </div>
+          )}
+        </main>
+      </div>
+    </div>
+  );
+}

package/inkos/packages/studio/src/api/__tests__/normalize-base-url.test.ts

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+
+// normalizeBaseUrl is not exported, so we test the behavior through the
+// server module's internal logic. We replicate the function here for unit testing.
+// If the implementation changes, this test will catch regressions.
+function normalizeBaseUrl(url: string): string {
+  const trimmed = url.replace(/\/+$/, "");
+  if (/\/v\d+$/.test(trimmed)) return trimmed;
+  return trimmed + "/v1";
+}
+
+describe("normalizeBaseUrl", () => {
+  it("appends /v1 when missing", () => {
+    expect(normalizeBaseUrl("https://timesniper.club")).toBe("https://timesniper.club/v1");
+  });
+
+  it("strips trailing slash then appends /v1", () => {
+    expect(normalizeBaseUrl("https://timesniper.club/")).toBe("https://timesniper.club/v1");
+  });
+
+  it("strips multiple trailing slashes", () => {
+    expect(normalizeBaseUrl("https://timesniper.club///")).toBe("https://timesniper.club/v1");
+  });
+
+  it("preserves existing /v1", () => {
+    expect(normalizeBaseUrl("https://timesniper.club/v1")).toBe("https://timesniper.club/v1");
+  });
+
+  it("preserves other version paths like /v2", () => {
+    expect(normalizeBaseUrl("https://api.example.com/v2")).toBe("https://api.example.com/v2");
+  });
+
+  it("all three forms are equivalent", () => {
+    const a = normalizeBaseUrl("https://timesniper.club/v1");
+    const b = normalizeBaseUrl("https://timesniper.club/");
+    const c = normalizeBaseUrl("https://timesniper.club");
+    expect(a).toBe(b);
+    expect(b).toBe(c);
+  });
+});