@dayinxisheng/novel-tools 0.1.0

package/dist/services/init.service.js

@@ -0,0 +1,250 @@
+import { FileUtils } from '../core/file.js';
+import { YamlUtils } from '../core/yaml.js';
+import { STANDARD_DIRS, NOVEL_TYPES } from '../core/constants.js';
+import * as path from 'path';
+/**
+ * 项目初始化服务类
+ */
+export class InitService {
+    /**
+     * 初始化新项目
+     */
+    async initProject(options, basePath) {
+        const { novelName, novelType, targetWords = 100000 } = options;
+        const projectPath = path.join(basePath, novelName);
+        // 检查目录是否已存在
+        if (FileUtils.exists(projectPath)) {
+            throw new Error(`目录已存在: ${projectPath}`);
+        }
+        // 创建项目目录结构
+        await this.createDirectoryStructure(projectPath);
+        // 创建项目配置
+        await this.createProjectConfig(projectPath, novelName, novelType, targetWords);
+        // 创建静态设定模板
+        await this.createStaticSettingTemplates(projectPath, novelType);
+        // 创建主大纲模板
+        await this.createMainOutlineTemplate(projectPath, novelName);
+        // 创建弧列表模板
+        await this.createArcListTemplate(projectPath);
+        // 创建事件记录文件
+        await this.createEventsFile(projectPath);
+        // 创建 README
+        await this.createProjectReadme(projectPath, novelName);
+        return projectPath;
+    }
+    /**
+     * 创建目录结构
+     */
+    async createDirectoryStructure(projectPath) {
+        for (const dir of STANDARD_DIRS) {
+            const dirPath = path.join(projectPath, dir);
+            await FileUtils.ensureDir(dirPath);
+        }
+        // 创建事件归档目录（第一卷）
+        const vol1EventsPath = path.join(projectPath, 'settings', 'events', 'vol1');
+        await FileUtils.ensureDir(vol1EventsPath);
+    }
+    /**
+     * 创建项目配置文件
+     */
+    async createProjectConfig(projectPath, novelName, novelType, targetWords) {
+        const config = {
+            novel_name: novelName,
+            novel_type: novelType,
+            created_at: new Date().toISOString(),
+            target_words: targetWords,
+            current_words: 0,
+            current_volume: 1,
+            current_chapter: 1
+        };
+        const configPath = path.join(projectPath, 'project.json');
+        await FileUtils.writeJson(configPath, config);
+    }
+    /**
+     * 创建静态设定模板
+     */
+    async createStaticSettingTemplates(projectPath, novelType) {
+        const typeConfig = NOVEL_TYPES[novelType];
+        const staticDir = path.join(projectPath, 'settings', 'static');
+        // 创建世界觿定模板
+        await this.createWorldTemplate(staticDir);
+        // 根据类型创建额外设定
+        if (typeConfig.staticFiles.includes('power_system.yaml')) {
+            await this.createPowerSystemTemplate(staticDir);
+        }
+        if (typeConfig.staticFiles.includes('era_background.yaml')) {
+            await this.createEraBackgroundTemplate(staticDir);
+        }
+    }
+    /**
+     * 创建世界觿定模板
+     */
+    async createWorldTemplate(staticDir) {
+        const worldTemplate = {
+            name: '世界观名称',
+            description: '简要描述世界背景',
+            geography: {
+                continents: [],
+                important_locations: []
+            },
+            factions: [],
+            timeline: []
+        };
+        await YamlUtils.writeFile(path.join(staticDir, 'world.yaml'), worldTemplate);
+    }
+    /**
+     * 创建力量体系模板
+     */
+    async createPowerSystemTemplate(staticDir) {
+        const powerTemplate = {
+            name: '力量体系名称',
+            description: '描述力量体系的基本原理',
+            levels: [
+                { name: '第一境界', description: '境界描述' },
+                { name: '第二境界', description: '境界描述' }
+            ],
+            cultivation_methods: [],
+            special_abilities: []
+        };
+        await YamlUtils.writeFile(path.join(staticDir, 'power_system.yaml'), powerTemplate);
+    }
+    /**
+     * 创建时代背景模板
+     */
+    async createEraBackgroundTemplate(staticDir) {
+        const eraTemplate = {
+            era: '时代名称',
+            time_period: '具体时间段',
+            political_system: '政治体制',
+            economic_system: '经济体制',
+            social_structure: '社会阶层结构',
+            cultural_features: '文化特色',
+            major_events: []
+        };
+        await YamlUtils.writeFile(path.join(staticDir, 'era_background.yaml'), eraTemplate);
+    }
+    /**
+     * 创建主大纲模板
+     */
+    async createMainOutlineTemplate(projectPath, novelName) {
+        const outlineContent = `# ${novelName} 大纲
+
+## 核心概述
+
+**一句话简介**：
+
+**核心主题**：
+
+**故事类型**：
+
+## 主要人物
+
+### 主角
+
+**姓名**：
+**性格特点**：
+**成长轨迹**：
+**核心动机**：
+
+### 重要配角
+
+## 世界观设定
+
+（详见 settings/static/ 目录）
+
+## 剧情结构
+
+### 第一卷
+
+**主题**：
+
+**核心冲突**：
+
+**主要剧情弧**：
+
+### 第二卷
+
+（待规划）
+
+## 创作笔记
+
+`;
+        await FileUtils.writeText(path.join(projectPath, 'outline', 'main_outline.md'), outlineContent);
+    }
+    /**
+     * 创建弧列表模板
+     */
+    async createArcListTemplate(projectPath) {
+        const arcListTemplate = {
+            arcs: [
+                {
+                    name: '开篇',
+                    startChapter: 1,
+                    endChapter: 10,
+                    theme: '引入主角，建立世界观',
+                    status: 'planning'
+                }
+            ]
+        };
+        await YamlUtils.writeFile(path.join(projectPath, 'outline', 'arc_list.yaml'), arcListTemplate);
+    }
+    /**
+     * 创建事件记录文件
+     */
+    async createEventsFile(projectPath) {
+        const eventsTemplate = {
+            description: '章节事件记录文件',
+            events: []
+        };
+        const eventsPath = path.join(projectPath, 'settings', 'events', 'current', 'events.json');
+        await FileUtils.writeJson(eventsPath, eventsTemplate);
+    }
+    /**
+     * 创建项目 README
+     */
+    async createProjectReadme(projectPath, novelName) {
+        const readmeContent = `# ${novelName}
+
+## 项目信息
+
+- **创建时间**：${new Date().toLocaleDateString('zh-CN')}
+- **目标字数**：100,000 字
+- **当前进度**：第 1 卷，第 1 章
+
+## 目录结构
+
+\`\`\`
+my-novel/
+├── characters/           # 人物相关
+│   ├── cards/           # 人物卡片
+│   ├── samples/         # 人物样本
+│   └── growth/          # 人物成长轨迹
+├── settings/            # 设定相关
+│   ├── static/          # 静态设定
+│   ├── state/           # 状态快照
+│   └── events/          # 事件记录
+├── outline/             # 大纲
+├── chapter_plans/       # 章节规划
+├── drafts/              # 草稿
+└── references/          # 参考资料
+\`\`\`
+
+## 使用工具
+
+\`\`\`bash
+# 查询设定
+novel-tools query world
+novel-tools query character <姓名>
+
+# 一致性检查
+novel-tools check outline
+novel-tools check chapter <章节数>
+
+# 生成快照
+novel-tools snapshot --volume 1
+\`\`\`
+`;
+        await FileUtils.writeText(path.join(projectPath, 'README.md'), readmeContent);
+    }
+}
+//# sourceMappingURL=init.service.js.map

package/dist/services/init.service.js.map

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

package/dist/services/query.service.d.ts

@@ -0,0 +1,43 @@
+import { ProjectConfig, CharacterState, CharacterCardInfo, StateQueryResult, Relationship, Foreshadow } from '../core/types.js';
+/**
+ * 查询服务类
+ */
+export declare class QueryService {
+    /**
+     * 查询静态设定
+     */
+    queryStaticSetting(projectPath: string, settingType: string): Promise<any>;
+    /**
+     * 查询人物信息
+     */
+    queryCharacter(projectPath: string, characterName: string): Promise<CharacterCardInfo>;
+    /**
+     * 查询指定卷结束时的状态
+     */
+    queryStateAtVolume(projectPath: string, volume: number): Promise<StateQueryResult>;
+    /**
+     * 查询当前状态
+     */
+    queryCurrentState(projectPath: string): Promise<StateQueryResult>;
+    /**
+     * 查询人物关系
+     */
+    queryRelationships(projectPath: string, characterName?: string): Promise<Relationship[]>;
+    /**
+     * 查询伏笔
+     */
+    queryForeshadows(projectPath: string, status?: string): Promise<Foreshadow[]>;
+    /**
+     * 查询人物当前状态
+     */
+    queryCharacterState(projectPath: string, characterName: string): Promise<CharacterState | null>;
+    /**
+     * 获取项目配置
+     */
+    getProjectConfig(projectPath: string): Promise<ProjectConfig | null>;
+    /**
+     * 验证项目路径
+     */
+    validateProjectPath(projectPath: string): Promise<boolean>;
+}
+//# sourceMappingURL=query.service.d.ts.map

package/dist/services/query.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.service.d.ts","sourceRoot":"","sources":["../../src/services/query.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACX,MAAM,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAUhF;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4B5F;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAexF;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBvE;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB9F;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,SAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUzF;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAWrG;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK1E;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIjE"}

package/dist/services/query.service.js

@@ -0,0 +1,129 @@
+import { FileUtils } from '../core/file.js';
+import { YamlUtils } from '../core/yaml.js';
+import { CHARACTER_SUBDIRS, SETTING_FILE_MAP, ERROR_MESSAGES } from '../core/constants.js';
+import * as path from 'path';
+/**
+ * 查询服务类
+ */
+export class QueryService {
+    /**
+     * 查询静态设定
+     */
+    async queryStaticSetting(projectPath, settingType) {
+        const staticDir = path.join(projectPath, 'settings', 'static');
+        const filename = SETTING_FILE_MAP[settingType] || `${settingType}.yaml`;
+        const filePath = path.join(staticDir, filename);
+        const result = await YamlUtils.parseFile(filePath);
+        return result || {};
+    }
+    /**
+     * 查询人物信息
+     */
+    async queryCharacter(projectPath, characterName) {
+        const cardsDir = path.join(projectPath, 'characters', 'cards');
+        // 搜索各类型人物目录
+        for (const subdir of CHARACTER_SUBDIRS) {
+            const cardPath = path.join(cardsDir, subdir, `${characterName}.md`);
+            if (FileUtils.exists(cardPath)) {
+                return {
+                    found: true,
+                    card_path: cardPath,
+                    identity: subdir
+                };
+            }
+        }
+        // 搜索待处理人物
+        const tempPath = path.join(projectPath, 'temp_settings', 'pending_characters', `${characterName}.md`);
+        if (FileUtils.exists(tempPath)) {
+            return {
+                found: true,
+                card_path: tempPath,
+                identity: 'pending'
+            };
+        }
+        return { found: false, message: ERROR_MESSAGES.CHARACTER_NOT_FOUND(characterName) };
+    }
+    /**
+     * 查询指定卷结束时的状态
+     */
+    async queryStateAtVolume(projectPath, volume) {
+        const stateDir = path.join(projectPath, 'settings', 'state');
+        const snapshotPath = path.join(stateDir, `vol${volume}_snapshot.yaml`);
+        const snapshot = await YamlUtils.parseFile(snapshotPath);
+        if (snapshot) {
+            return {
+                found: true,
+                ...snapshot
+            };
+        }
+        return { found: false, message: ERROR_MESSAGES.SNAPSHOT_NOT_FOUND(volume) };
+    }
+    /**
+     * 查询当前状态
+     */
+    async queryCurrentState(projectPath) {
+        const stateDir = path.join(projectPath, 'settings', 'state');
+        const files = await FileUtils.globFiles(stateDir, 'vol*_snapshot.yaml');
+        if (files.length > 0) {
+            const latest = files[files.length - 1];
+            const snapshot = await YamlUtils.parseFile(latest);
+            if (snapshot) {
+                return {
+                    found: true,
+                    ...snapshot
+                };
+            }
+        }
+        return { found: false, message: ERROR_MESSAGES.SNAPSHOT_NOT_FOUND() };
+    }
+    /**
+     * 查询人物关系
+     */
+    async queryRelationships(projectPath, characterName) {
+        const state = await this.queryCurrentState(projectPath);
+        if (!state.found || !state.relationships) {
+            return [];
+        }
+        const relationships = state.relationships;
+        if (characterName) {
+            return relationships.filter(r => r.from === characterName || r.to === characterName);
+        }
+        return relationships;
+    }
+    /**
+     * 查询伏笔
+     */
+    async queryForeshadows(projectPath, status = 'unresolved') {
+        const state = await this.queryCurrentState(projectPath);
+        if (!state.found || !state.foreshadows) {
+            return [];
+        }
+        return state.foreshadows[status] || [];
+    }
+    /**
+     * 查询人物当前状态
+     */
+    async queryCharacterState(projectPath, characterName) {
+        const state = await this.queryCurrentState(projectPath);
+        if (!state.found || !state.characters) {
+            return null;
+        }
+        const characters = state.characters;
+        return characters.find(c => c.name === characterName) || null;
+    }
+    /**
+     * 获取项目配置
+     */
+    async getProjectConfig(projectPath) {
+        const configPath = path.join(projectPath, 'project.json');
+        return await FileUtils.readJson(configPath);
+    }
+    /**
+     * 验证项目路径
+     */
+    async validateProjectPath(projectPath) {
+        const configPath = path.join(projectPath, 'project.json');
+        return FileUtils.exists(configPath);
+    }
+}
+//# sourceMappingURL=query.service.js.map

package/dist/services/query.service.js.map

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

package/dist/services/snapshot.service.d.ts

@@ -0,0 +1,42 @@
+import { Snapshot } from '../core/types.js';
+/**
+ * 快照生成服务类
+ */
+export declare class SnapshotService {
+    /**
+     * 收集所有人物及其初始状态
+     */
+    private collectCharacters;
+    /**
+     * 更新人物状态
+     */
+    private updateCharacterStates;
+    /**
+     * 收集伏笔状态
+     */
+    private collectForeshadows;
+    /**
+     * 收集人物关系
+     */
+    private collectRelationships;
+    /**
+     * 生成快照
+     */
+    generateSnapshot(projectPath: string, volume?: number, arc?: string): Promise<Snapshot>;
+    /**
+     * 保存快照
+     */
+    saveSnapshot(projectPath: string, snapshot: Snapshot, volume?: number, arc?: string): Promise<string>;
+    /**
+     * 加载快照
+     */
+    loadSnapshot(projectPath: string, volume?: number, arc?: string): Promise<Snapshot | null>;
+    /**
+     * 列出所有快照
+     */
+    listSnapshots(projectPath: string): Promise<Array<{
+        name: string;
+        path: string;
+    }>>;
+}
+//# sourceMappingURL=snapshot.service.d.ts.map

package/dist/services/snapshot.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.service.d.ts","sourceRoot":"","sources":["../../src/services/snapshot.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAA6D,MAAM,kBAAkB,CAAC;AAGvG;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyD7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC;IAiCpB;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC;IAqBlB;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAsBhG;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CASzF"}