novelws 5.2.0 → 5.3.0

package/dist/server/routes/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../src/server/routes/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAyBhE"}

package/dist/server/routes/relationships.js

@@ -0,0 +1,27 @@
+import { Router } from 'express';
+export function createRelationshipsRouter(ds) {
+    const router = Router({ mergeParams: true });
+    // GET /api/stories/:story/relationships?vol=X
+    router.get('/', async (req, res) => {
+        try {
+            const vol = req.query.vol ? parseInt(req.query.vol, 10) : undefined;
+            const graph = await ds.getRelationships(req.params.story, vol);
+            res.json(graph);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // GET /api/stories/:story/relationships/history
+    router.get('/history', async (req, res) => {
+        try {
+            const history = await ds.getRelationshipHistory(req.params.story);
+            res.json(history);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=relationships.js.map

package/dist/server/routes/relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../../src/server/routes/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAGpD,MAAM,UAAU,yBAAyB,CAAC,EAAc;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,8CAA8C;IAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAA+B,EAAE,GAAa,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAa,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9E,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,GAA+B,EAAE,GAAa,EAAE,EAAE;QAC9E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/routes/stats.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import type { DataSource } from '../types.js';
+export declare function createStatsRouter(ds: DataSource): Router;
+//# sourceMappingURL=stats.d.ts.map

package/dist/server/routes/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/server/routes/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAmBxD"}

package/dist/server/routes/stats.js

@@ -0,0 +1,21 @@
+import { Router } from 'express';
+export function createStatsRouter(ds) {
+    const router = Router();
+    // GET /api/stats/dashboard?story=X
+    router.get('/dashboard', async (req, res) => {
+        try {
+            const story = req.query.story;
+            if (!story) {
+                res.status(400).json({ error: '缺少 story 参数' });
+                return;
+            }
+            const stats = await ds.getDashboardStats(story);
+            res.json(stats);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=stats.js.map

package/dist/server/routes/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/server/routes/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,MAAM,UAAU,iBAAiB,CAAC,EAAc;IAC9C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,mCAAmC;IACnC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAe,CAAC;YACxC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;gBAC/C,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/routes/stories.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import type { DataSource } from '../types.js';
+export declare function createStoriesRouter(ds: DataSource): Router;
+//# sourceMappingURL=stories.d.ts.map

package/dist/server/routes/stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stories.d.ts","sourceRoot":"","sources":["../../../src/server/routes/stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CA8E1D"}

package/dist/server/routes/stories.js

@@ -0,0 +1,80 @@
+import { Router } from 'express';
+export function createStoriesRouter(ds) {
+    const router = Router();
+    // GET /api/stories
+    router.get('/', async (_req, res) => {
+        try {
+            const stories = await ds.getStories();
+            res.json(stories);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // GET /api/stories/:story/overview
+    router.get('/:story/overview', async (req, res) => {
+        try {
+            const overview = await ds.getOverview(req.params.story);
+            res.json(overview);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // GET /api/stories/:story/volumes
+    router.get('/:story/volumes', async (req, res) => {
+        try {
+            const volumes = await ds.getVolumes(req.params.story);
+            res.json(volumes);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // GET /api/stories/:story/volumes/:vol/stats
+    router.get('/:story/volumes/:vol/stats', async (req, res) => {
+        try {
+            const vol = parseInt(req.params.vol, 10);
+            const chapters = await ds.getChapters(req.params.story, vol);
+            const characters = await ds.getCharacters(req.params.story, vol);
+            res.json({
+                volume: vol,
+                chapters: chapters.length,
+                words: chapters.reduce((sum, c) => sum + c.words, 0),
+                characters: characters.length,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // GET /api/stories/:story/chapters?vol=X
+    router.get('/:story/chapters', async (req, res) => {
+        try {
+            const vol = req.query.vol ? parseInt(req.query.vol, 10) : undefined;
+            const chapters = await ds.getChapters(req.params.story, vol);
+            res.json(chapters);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // GET /api/stories/:story/chapters/:ch
+    router.get('/:story/chapters/:ch', async (req, res) => {
+        try {
+            const chNum = parseInt(req.params.ch, 10);
+            const chapters = await ds.getChapters(req.params.story);
+            const chapter = chapters.find(c => c.globalNumber === chNum);
+            if (!chapter) {
+                res.status(404).json({ error: '章节不存在' });
+                return;
+            }
+            res.json(chapter);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=stories.js.map

package/dist/server/routes/stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stories.js","sourceRoot":"","sources":["../../../src/server/routes/stories.ts"],"names":[],"mappings":"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"}

package/dist/server/routes/timeline.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import type { DataSource } from '../types.js';
+export declare function createTimelineRouter(ds: DataSource): Router;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/server/routes/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/server/routes/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAe3D"}

package/dist/server/routes/timeline.js

@@ -0,0 +1,17 @@
+import { Router } from 'express';
+export function createTimelineRouter(ds) {
+    const router = Router({ mergeParams: true });
+    // GET /api/stories/:story/timeline?vol=X
+    router.get('/', async (req, res) => {
+        try {
+            const vol = req.query.vol ? parseInt(req.query.vol, 10) : undefined;
+            const events = await ds.getTimeline(req.params.story, vol);
+            res.json(events);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=timeline.js.map

package/dist/server/routes/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/server/routes/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAGpD,MAAM,UAAU,oBAAoB,CAAC,EAAc;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,yCAAyC;IACzC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAA+B,EAAE,GAAa,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAa,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9E,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/types.d.ts

@@ -0,0 +1,199 @@
+/** 故事基础信息 */
+export interface Story {
+    name: string;
+    path: string;
+}
+/** 故事总览 */
+export interface StoryOverview {
+    name: string;
+    totalVolumes: number;
+    totalChapters: number;
+    totalWords: number;
+    currentVolume: number;
+}
+/** 卷信息 */
+export interface Volume {
+    number: number;
+    title: string;
+    chapters: number;
+    words: number;
+    progress: number;
+}
+/** 章节信息 */
+export interface Chapter {
+    globalNumber: number;
+    volumeNumber: number;
+    chapterInVolume: number;
+    title: string;
+    words: number;
+    pov: string;
+    participants: string[];
+    hasSynopsis: boolean;
+    hasContent: boolean;
+}
+/** 角色信息 */
+export interface Character {
+    name: string;
+    aliases: string[];
+    role: string;
+    firstVolume: number;
+    firstChapter: number;
+    cultivation: string;
+    faction: string;
+    status: string;
+}
+/** 角色状态快照（按卷） */
+export interface CharacterState {
+    volume: number;
+    cultivation: string;
+    location: string;
+    summary: string;
+    lastChapter: number;
+}
+/** 关系图节点 */
+export interface RelationshipNode {
+    id: string;
+    name: string;
+    faction: string;
+    role: string;
+    appearances: number;
+}
+/** 关系图边 */
+export interface RelationshipEdge {
+    source: string;
+    target: string;
+    type: string;
+    status: string;
+    lastChapter: number;
+}
+/** 关系网络图 */
+export interface RelationshipGraph {
+    nodes: RelationshipNode[];
+    edges: RelationshipEdge[];
+}
+/** 关系变迁事件 */
+export interface RelationshipEvent {
+    chapter: number;
+    source: string;
+    target: string;
+    type: string;
+    oldStatus: string;
+    newStatus: string;
+}
+/** 时间线事件 */
+export interface TimelineEvent {
+    id: number;
+    chapter: number;
+    storyTime: string;
+    location: string;
+    description: string;
+    tags: string[];
+}
+/** 情节线 */
+export interface PlotThread {
+    name: string;
+    type: string;
+    status: string;
+    description: string;
+    keyEvents: string[];
+}
+/** 伏笔 */
+export interface Foreshadow {
+    code: string;
+    description: string;
+    plantedChapter: number;
+    hintedChapters: number[];
+    resolvedChapter: number | null;
+    status: string;
+    importance: string;
+}
+/** 伏笔矩阵单元格 */
+export interface ForeshadowCell {
+    chapter: number;
+    action: 'plant' | 'hint' | 'resolve' | null;
+}
+/** 伏笔矩阵 */
+export interface ForeshadowMatrix {
+    chapters: number[];
+    rows: Array<{
+        code: string;
+        description: string;
+        cells: ForeshadowCell[];
+    }>;
+}
+/** 卷级统计 */
+export interface VolumeStat {
+    volume: number;
+    title: string;
+    words: number;
+    chapters: number;
+    progress: number;
+}
+/** 仪表盘聚合统计 */
+export interface DashboardStats {
+    totalWords: number;
+    totalChapters: number;
+    totalVolumes: number;
+    totalCharacters: number;
+    activePlotThreads: number;
+    unresolvedForeshadowing: number;
+    volumeStats: VolumeStat[];
+}
+/** 主角技能 */
+export interface ProtagonistSkill {
+    name: string;
+    category: string;
+    level: string;
+    description: string;
+    acquiredChapter: number;
+    useCount: number;
+    status: string;
+}
+/** 主角道具 */
+export interface ProtagonistItem {
+    name: string;
+    type: string;
+    quantity: number;
+    quality: string;
+    description: string;
+    acquiredChapter: number;
+    status: string;
+}
+/** 修炼进度节点 */
+export interface CultivationNode {
+    chapter: number;
+    level: string;
+    progressPct: number;
+    breakthroughType: string | null;
+    detail: string;
+}
+/** 主角总览 */
+export interface ProtagonistOverview {
+    currentLevel: string;
+    currentProgress: number;
+    totalSkills: number;
+    activeSkills: number;
+    totalItems: number;
+    heldItems: number;
+}
+/** 数据源抽象接口 */
+export interface DataSource {
+    getStories(): Promise<Story[]>;
+    getOverview(story: string): Promise<StoryOverview>;
+    getVolumes(story: string): Promise<Volume[]>;
+    getChapters(story: string, vol?: number): Promise<Chapter[]>;
+    getCharacters(story: string, vol?: number): Promise<Character[]>;
+    getCharacterArc(story: string, name: string): Promise<CharacterState[]>;
+    getRelationships(story: string, vol?: number): Promise<RelationshipGraph>;
+    getRelationshipHistory(story: string): Promise<RelationshipEvent[]>;
+    getTimeline(story: string, vol?: number): Promise<TimelineEvent[]>;
+    getPlotThreads(story: string): Promise<PlotThread[]>;
+    getForeshadowing(story: string): Promise<Foreshadow[]>;
+    getForeshadowingMatrix(story: string): Promise<ForeshadowMatrix>;
+    getDashboardStats(story: string): Promise<DashboardStats>;
+    getProtagonistOverview(story: string): Promise<ProtagonistOverview>;
+    getProtagonistSkills(story: string): Promise<ProtagonistSkill[]>;
+    getProtagonistInventory(story: string): Promise<ProtagonistItem[]>;
+    getCultivationCurve(story: string): Promise<CultivationNode[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}

package/dist/server/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novelws",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "type": "module",
   "description": "Claude Code 专用的 AI 小说创作工具 - 深度集成 Slash Commands 和 Agent Skills",
   "keywords": [
@@ -33,22 +33,29 @@
     "test:watch": "jest --config jest.config.cjs --watch",
     "test:coverage": "jest --config jest.config.cjs --coverage",
     "test:unit": "jest --config jest.config.cjs tests/unit",
-    "test:integration": "jest --config jest.config.cjs tests/integration"
+    "test:integration": "jest --config jest.config.cjs tests/integration",
+    "build:dashboard": "cd dashboard && npm run build",
+    "dashboard": "node dist/cli.js dashboard"
   },
   "dependencies": {
     "@commander-js/extra-typings": "^12.0.0",
     "chalk": "^5.3.0",
+    "express": "^5.2.1",
     "fs-extra": "^11.2.0",
     "inquirer": "^9.2.12",
     "js-yaml": "^4.1.0",
-    "ora": "^8.0.1"
+    "open": "^11.0.0",
+    "ora": "^8.0.1",
+    "pg": "^8.18.0"
   },
   "devDependencies": {
+    "@types/express": "^5.0.6",
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
+    "@types/pg": "^8.16.0",
     "jest": "^30.2.0",
     "ts-jest": "^29.4.6",
     "tsx": "^4.7.0",
@@ -71,5 +78,8 @@
   "homepage": "https://github.com/binlee1990/novel-writer-skills#readme",
   "bugs": {
     "url": "https://github.com/binlee1990/novel-writer-skills/issues"
+  },
+  "overrides": {
+    "yoctocolors-cjs": "2.1.2"
   }
 }

package/templates/commands/analyze.md

@@ -2,7 +2,7 @@
 description: 质量检查：对比概要与正文，检测一致性和AI味
 argument-hint: [章节号] [--range start-end]
 recommended-model: claude-sonnet-4-5-20250929
-allowed-tools: Read(//stories/**), Read(//resources/anti-ai.md), Bash(ls:*)
+allowed-tools: Read(//stories/**), Read(//resources/anti-ai.md), Bash(ls:*), Bash(python:scripts/*)
 ---
 
 用户输入：$ARGUMENTS
@@ -26,6 +26,14 @@ allowed-tools: Read(//stories/**), Read(//resources/anti-ai.md), Bash(ls:*)
 - 对应概要：`stories/<story>/volumes/vol-XXX/content/chapter-YYY-synopsis.md`
 - 卷级 tracking：`stories/<story>/volumes/vol-XXX/tracking/character-state.json`、`stories/<story>/volumes/vol-XXX/tracking/plot-tracker.json`
 
+**DB 增强模式**：如果 `resources/config.json` 中 `database.enabled = true`，可用 DB 上下文替代 tracking 文件读取：
+
+```
+python scripts/db_context.py --chapter <全局章节号> --mode analyze
+```
+
+输出包含本章伏笔检查清单、角色状态基准、时间线连续性和一致性警告。输出还包含主角能力基准（技能习得时间线 + 道具持有状态），用于检测正文中是否使用了尚未习得的技能或不持有的道具。
+
 ## 检查项（5项）
 
 ### 1. 概要符合度

package/templates/commands/expand.md

@@ -2,7 +2,7 @@
 description: 将章节概要扩写为 3000-5000 字正文
 argument-hint: [章节号] [--batch N]
 recommended-model: claude-opus-4-6
-allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//stories/**/tracking/**), Write(//stories/**/tracking/**), Read(//resources/style-reference.md), Read(//resources/anti-ai.md), Read(//resources/constitution.md), Bash(ls:*)
+allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//stories/**/tracking/**), Write(//stories/**/tracking/**), Read(//resources/style-reference.md), Read(//resources/anti-ai.md), Read(//resources/constitution.md), Bash(ls:*), Bash(python:scripts/*)
 ---
 
 用户输入：$ARGUMENTS
@@ -38,6 +38,14 @@ allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//storie
 
 所有资源必须从文件系统读取，不复用对话中的缓存。总上下文控制在 3500 字以内。
 
+**DB 增强模式**：如果 `resources/config.json` 中 `database.enabled = true`，可用 DB 上下文替代第 3 层的 tracking 文件读取：
+
+```
+python scripts/db_context.py --chapter <全局章节号> --mode expand
+```
+
+输出包含本章伏笔、活跃角色状态、角色关系、前序衔接，直接替代手动读取 tracking JSON。输出还包含主角当前修为、可用技能和道具清单，确保扩写中主角能力使用不超出已有设定。第 1、2 层仍从文件系统加载。
+
 ### 第 1 层 — 全局视角
 
 1. **specification.md 摘要**：读取 `stories/<story>/specification.md`，提取 100 字核心摘要（类型 + 主角 + 核心冲突）
@@ -100,13 +108,21 @@ allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//storie
 - 对话中透露的新信息 → 更新 `volumes/vol-XXX/tracking/` 中的 character-state 或 relationships
 - 新的场景细节 → 如有重要设定变化，更新相关 tracking
 
-### 5. 批量模式
+### 5. DB 同步（可选）
+
+如果 `resources/config.json` 中 `database.enabled = true`，在 tracking 更新完成后运行：
+
+```
+python scripts/db_sync.py --vol <当前卷号>
+```
+
+### 6. 批量模式
 
 如果指定了 `--batch N`，重复步骤 2-4 共 N 次。每章完成后输出进度和字数。
 
 **批量模式资源隔离**：每章都必须重新从文件系统加载所有资源。批量模式中每章视为独立的扩写任务。如果批量过程中跨卷，需要切换到下一卷的 tracking 和 content 目录。
 
-### 6. 后续建议
+### 7. 后续建议
 
 单章完成：「第X章扩写完成（XXXX字，vol-XXX）。继续 /expand [X+1] 或使用 /analyze X 检查质量。」
 

package/templates/commands/write.md

@@ -1,15 +1,15 @@
 ---
-description: 逐章生成剧情概要（200-500字），同步更新 tracking
+description: 逐章生成剧情概要（200-500字），严格控制字数，同步更新 tracking
 argument-hint: [章节号] [--batch N]
 recommended-model: claude-opus-4-6
-allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*)
+allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*), Bash(python:scripts/*)
 ---
 
 用户输入：$ARGUMENTS
 
 ## 目标
 
-为指定章节生成 200-500 字的纯剧情概要，同步生成 tracking 骨架数据。
+为指定章节生成 200-500 字的纯剧情概要（严格控制字数），同步生成 tracking 骨架数据。
 
 ## 参数解析
 
@@ -37,6 +37,12 @@ allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*
 
 当目标章节属于新卷时（上一卷已完成）：
 
+**路径 A — DB 模式**（`resources/config.json` 中 `database.enabled = true`）：
+
+运行 `python scripts/db_volume_switch.py --vol <新卷号>` 自动生成 volume-summary.md。输出还包含主角当前修炼进度、技能清单和道具状态，用于概要中主角能力描写的一致性。
+
+**路径 B — 文件模式**（默认）：
+
 1. 读取上一卷 `volumes/vol-NNN/tracking/` 的 4 个 JSON 文件
 2. 读取上一卷最后一章 synopsis 的章末钩子
 3. 读取 `creative-plan.md` 中下一卷的大纲段落
@@ -46,7 +52,7 @@ allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*
    - 活跃伏笔：从 plot-tracker.json 提取 status=planted/hinted 的条目
    - 关键关系：从 relationships.json 提取活跃角色间的关系
    - 待续悬念：上一卷末章的章末钩子
-5. volume-summary.md 控制在 500-1000 字
+5. volume-summary.md 控制在 500-2000 字（严格控制字数）
 
 ## 资源加载（卷级）
 
@@ -74,7 +80,7 @@ allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*
 
 ### 4. 生成概要
 
-为当前章节生成 200-500 字纯剧情概要，包含：
+为当前章节生成 200-500 字纯剧情概要（严格控制字数），包含：
 
 - **本章标题**：简短的章节标题
 - **核心事件**：本章发生的主要事件（1-3个）
@@ -105,11 +111,21 @@ allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*
 **timeline.json**：
 - 添加本章事件到 events（chapter, time, event）
 
-### 6. 批量模式
+### 6. DB 同步（可选）
+
+如果 `resources/config.json` 中 `database.enabled = true`，在 tracking 更新完成后运行：
+
+```
+python scripts/db_sync.py --vol <当前卷号>
+```
+
+将本卷 tracking 数据同步到 PostgreSQL。
+
+### 7. 批量模式
 
 如果指定了 `--batch N`，重复步骤 3-5 共 N 次。如果批量过程中跨卷，自动触发卷切换。
 
-### 7. 后续建议
+### 8. 后续建议
 
 单章完成：「第X章概要已生成（vol-XXX）。继续 /write [X+1] 或 /write --batch 20 批量生成。」
 

package/templates/dot-claude/CLAUDE.md

@@ -60,6 +60,33 @@ stories/<story>/
 - /write 完成后自动更新卷级 tracking 骨架
 - /expand 完成后补充卷级 tracking 细节
 
+## DB 增强（可选）
+
+项目支持 PostgreSQL 双轨并行模式：DB 可用时增强上下文精度，不可用时回退到纯文件系统流程。
+
+### 配置
+
+编辑 `resources/config.json` 中的 `database` 字段：
+- `enabled: true` 启用 DB 模式
+- 配置 host、port、dbname、user、password
+- schema 默认为 `novelws`
+
+### scripts/ 目录
+
+| 脚本 | 用途 |
+|------|------|
+| `phase_a_init_db.py` | 初始化数据库（建表 + 视图） |
+| `db_sync.py` | 文件系统 tracking → DB 同步（幂等） |
+| `db_context.py` | 从 DB 生成精确上下文（write/expand/analyze 模式） |
+| `db_volume_switch.py` | 从 DB 生成 volume-summary.md（卷切换） |
+
+### 双轨机制
+
+- /write、/expand、/analyze 命令会检测 `database.enabled`
+- DB 可用时：用 `db_context.py` 生成精确上下文，完成后用 `db_sync.py` 同步
+- DB 不可用或脚本执行失败时：自动回退到纯文件系统流程，不影响正常创作
+- 文件系统 tracking 始终是主数据源，DB 是增强层
+
 ## 会话级资源复用
 
 不同命令的资源复用策略不同：