dsh-novel 0.1.0

package/lib/types/novel/noveel-shapes.d.ts

@@ -0,0 +1,98 @@
+export declare const WORLD_KINDS: readonly [{
+    readonly value: "universe";
+    readonly label: "宇宙";
+}, {
+    readonly value: "multiverse";
+    readonly label: "多元宇宙";
+}, {
+    readonly value: "galaxy";
+    readonly label: "星系";
+}, {
+    readonly value: "realm";
+    readonly label: "界域";
+}, {
+    readonly value: "domain";
+    readonly label: "域";
+}, {
+    readonly value: "plane";
+    readonly label: "位面";
+}, {
+    readonly value: "planet";
+    readonly label: "星球";
+}, {
+    readonly value: "continent";
+    readonly label: "大陆";
+}, {
+    readonly value: "mainland";
+    readonly label: "大陆";
+}, {
+    readonly value: "region";
+    readonly label: "地区";
+}, {
+    readonly value: "mountain";
+    readonly label: "山脉";
+}, {
+    readonly value: "secret_realm";
+    readonly label: "秘境/禁地";
+}, {
+    readonly value: "country";
+    readonly label: "国家";
+}, {
+    readonly value: "empire";
+    readonly label: "帝国";
+}, {
+    readonly value: "kingdom";
+    readonly label: "王国";
+}, {
+    readonly value: "city";
+    readonly label: "城市";
+}, {
+    readonly value: "town";
+    readonly label: "城镇";
+}, {
+    readonly value: "settlement";
+    readonly label: "聚落";
+}, {
+    readonly value: "faction";
+    readonly label: "势力";
+}, {
+    readonly value: "sect";
+    readonly label: "宗门/门派";
+}, {
+    readonly value: "clan";
+    readonly label: "家族/氏族";
+}, {
+    readonly value: "guild";
+    readonly label: "公会";
+}, {
+    readonly value: "army";
+    readonly label: "军队";
+}, {
+    readonly value: "corporation";
+    readonly label: "公司/集团";
+}, {
+    readonly value: "alliance";
+    readonly label: "联盟";
+}, {
+    readonly value: "cult";
+    readonly label: "教派";
+}, {
+    readonly value: "academy";
+    readonly label: "学院";
+}, {
+    readonly value: "custom";
+    readonly label: "其他";
+}];
+export declare function emptyLevelSystem(): {
+    name: string;
+    category: string;
+    description: string;
+    levels: {
+        name: string;
+        subLevels: {
+            name: string;
+        }[];
+        promotionCondition: string;
+        abilities: string;
+    }[];
+};

package/lib/types/novel/outline-labels.d.ts

@@ -0,0 +1,10 @@
+export declare function asOrdinal(value: unknown): number | undefined;
+export declare function canonicalizeOutlineKind(raw: unknown): 'volume' | 'chapter_segment' | undefined;
+export declare function outlineKindOf(data: Record<string, unknown>): 'volume' | 'chapter_segment';
+export declare function volumeChapterLabel(ordinal: unknown, unit: '卷' | '章', name: string): string;
+export declare function outlineNodeLabel(data: Record<string, unknown>, fallback: string): string;
+export declare function chapterNodeLabel(data: Record<string, unknown>, fallback: string): string;
+export declare function compareOrdinal(a: unknown, b: unknown): number;
+export declare function sortByOrdinalName<T extends {
+    name?: string | null;
+}>(items: T[], ordinalOf: (item: T) => unknown): T[];

package/lib/types/novel/schema.d.ts

@@ -0,0 +1,3 @@
+import type { PGlite } from '@electric-sql/pglite';
+/** Create the single-novel schema used inside one workspace PGlite directory. */
+export declare function initNovelSchema(db: PGlite): Promise<void>;

package/lib/types/novel/seed.d.ts

@@ -0,0 +1,27 @@
+import type { PGlite } from '@electric-sql/pglite';
+export declare function seedTemplatesDir(): string;
+export declare function seedSkillsDir(): string;
+export declare function loadRecommendedTemplate(category?: string | null): unknown;
+export declare function listBuiltinWritingStylePresets(): Array<{
+    id: string;
+    slug: string;
+    name: string;
+}>;
+export declare function seedWritingStyleBuiltins(db: PGlite): Promise<void>;
+export declare const SECTION_TO_FOLDER: Record<string, string>;
+export interface SeedSkillRow {
+    section: string;
+    folder: string;
+    agent_kind: string;
+    title: string;
+    body: string;
+}
+/** Disk skill markdown used both to seed a workspace and to advertise module skills before init. */
+export declare function listSeedSkillRows(): SeedSkillRow[];
+/** Seed generic skill markdown (genre-specific files under seed/skills/genres are not loaded). */
+export declare function seedNovelSkills(db: PGlite, _category: string): Promise<void>;
+export declare function listWritingStyles(db: PGlite): Promise<Array<{
+    id: string;
+    name: string;
+    slug: string;
+}>>;

package/lib/types/novel/store.d.ts

@@ -0,0 +1,96 @@
+import { ENTITY_DOMAINS, isEntityDomain, type EntityDomain } from './domains.ts';
+export declare const NOVEL_DIR = ".dsh-novel";
+export declare const LEGACY_NOVEL_DIR = ".noveel";
+export declare const META_FILE = "meta.json";
+export interface NovelMeta {
+    version: 1;
+    novelId: string;
+    createdAt: string;
+}
+export interface NovelRecord {
+    id: string;
+    title: string;
+    description: string | null;
+    cover: string | null;
+    category: string;
+    writing_style_id: string | null;
+    chapter_count: number;
+    word_count: number;
+    blueprint_json: unknown;
+    outline_draft_md: string | null;
+    outline_final_md: string | null;
+    outline_status: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface EntityRecord {
+    domain: string;
+    id: string;
+    name: string | null;
+    data: unknown;
+    created_at: string;
+    updated_at: string;
+}
+export interface SkillRecord {
+    id: string;
+    section: string;
+    folder: string;
+    agent_kind: string;
+    title: string;
+    body: string;
+    created_at: string;
+    updated_at: string;
+}
+/** Return whether a workspace directory has been provisioned as a novel. */
+export declare function isNovelWorkspace(workspacePath: string): Promise<boolean>;
+/** Initialize `.dsh-novel` + PGlite + default novel row for one workspace directory. */
+export declare function provisionNovelWorkspace(workspacePath: string, input?: {
+    title?: string | undefined;
+    category?: string | undefined;
+    writingStyleId?: string | undefined;
+}): Promise<{
+    meta: NovelMeta;
+    novel: NovelRecord;
+    alreadyInitialized: boolean;
+}>;
+/** Load the singleton novel row. */
+export declare function getNovel(workspacePath: string): Promise<NovelRecord>;
+/** Patch novel metadata / blueprint. */
+export declare function updateNovel(workspacePath: string, patch: Partial<Pick<NovelRecord, 'title' | 'description' | 'cover' | 'category' | 'writing_style_id' | 'blueprint_json' | 'outline_draft_md' | 'outline_final_md' | 'outline_status'>>): Promise<NovelRecord>;
+/** List entities in one domain. */
+export declare function listEntities(workspacePath: string, domain: EntityDomain): Promise<EntityRecord[]>;
+/** Load one entity. */
+export declare function getEntity(workspacePath: string, id: string): Promise<EntityRecord | undefined>;
+/** Insert or replace an entity. */
+export declare function upsertEntity(workspacePath: string, domain: EntityDomain, data: Record<string, unknown>, id?: string): Promise<EntityRecord>;
+/** Delete one entity. */
+export declare function deleteEntity(workspacePath: string, id: string): Promise<boolean>;
+/** Form template JSON for the workspace novel. */
+export declare function getTemplate(workspacePath: string): Promise<unknown>;
+/** Replace the form template. */
+export declare function saveTemplate(workspacePath: string, config: unknown): Promise<unknown>;
+/** List writing skills. */
+export declare function listSkills(workspacePath: string): Promise<SkillRecord[]>;
+/** Create or update a skill. */
+export declare function upsertSkill(workspacePath: string, skill: {
+    id?: string | undefined;
+    section: string;
+    folder?: string | undefined;
+    agentKind?: string | undefined;
+    title: string;
+    body: string;
+}): Promise<SkillRecord>;
+/** Delete a skill. */
+export declare function deleteSkill(workspacePath: string, id: string): Promise<boolean>;
+/** Static write contract for tools. Book-specific field keys still come from get_template. */
+export declare function describeSchema(): {
+    domains: typeof ENTITY_DOMAINS;
+    notes: string;
+    write: Record<string, string>;
+};
+export { ENTITY_DOMAINS, isEntityDomain };
+export declare function listWorkspaceWritingStyles(workspacePath: string): Promise<Array<{
+    id: string;
+    name: string;
+    slug: string;
+}>>;

package/lib/types/novel/template-fields.d.ts

@@ -0,0 +1,17 @@
+import type { ContentSection } from './domains.ts';
+export declare const TEMPLATE_PRESET_MAIN_CATEGORIES: readonly ["玄幻", "都市", "科幻", "末世", "仙侠", "言情", "悬疑", "历史"];
+export type TemplatePresetMainCategory = (typeof TEMPLATE_PRESET_MAIN_CATEGORIES)[number];
+export declare function normalizeTemplatePresetCategory(raw: string | null | undefined): TemplatePresetMainCategory;
+export interface FormField {
+    key: string;
+    label: string;
+    component?: string;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/** Pick human-editable fields from a Noveel form_templates.config blob. */
+export declare function fieldsOf(template: unknown, section: ContentSection, extra?: 'chapterSegment' | 'timeline'): FormField[];
+export declare function getByPath(obj: Record<string, unknown>, path: string): unknown;
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;

package/lib/types/novel/timeline-labels.d.ts

@@ -0,0 +1,2 @@
+export declare function timelineEventTypeLabel(eventType: unknown): string | undefined;
+export declare function timelineResolvedLabel(eventType: unknown, isResolved: unknown): string | undefined;

package/lib/types/novel/tools.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** Register novel CRUD tools, DSH skills, and a system-prompt context dump. */
+export declare function registerNovelHost(ctx: Context): void;

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "dsh-novel",
+  "version": "0.1.0",
+  "description": "Standard DSH plugin: novel workspace, PGlite canon, tools, skills, and content tab",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ddedook/dsh-novel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ddedook/dsh-novel/issues"
+  },
+  "homepage": "https://github.com/ddedook/dsh-novel#readme",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "cordis.patch.yml",
+    "seed/**",
+    "lib/**/*.js",
+    "lib/**/*.map",
+    "lib/types/**/*.d.ts",
+    "README.md"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-skill": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
+    "@electric-sql/pglite": "^0.4.5",
+    "react": "18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.0",
+    "@types/react": "^18",
+    "tsdown": "0.22.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.json --emitDeclarationOnly && tsc -p tsconfig.client.json --emitDeclarationOnly",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit && tsc -p tsconfig.tests.json --noEmit",
+    "test": "vitest run",
+    "check": "pnpm run build && pnpm run typecheck && pnpm run test"
+  }
+}

package/seed/skills/chapter//345/216/273AI/345/221/263/344/270/216/350/264/250/346/243/200.md

@@ -0,0 +1,34 @@
+# 去AI味与质检
+
+提升场景感与人物差异；按读者读感修文。正式判定（`accepted` 等）由审查 skill / `submitChapterReview` 负责；写作侧只做自检与修订。
+
+## 核心原则
+
+1. 保留：已发生事实、人物硬设定、信息边界、伏笔、物件归属、时间序、章末牵引。
+2. 不为「像人」而加错别字、病句、隐形字符或伪造经历。
+3. 同类问题连续出现再修；单次可不处理（成簇才修）。
+
+## 审计对象（读者症状 → 诊断；成簇才修）
+
+- 「读着像作文/假」← 否定式并列过密（「不是X，而是Y」）、格言化旁白（「权力是…」「命运从不…」）、解释性推进（叙述者替读者下结论）
+- 「全员一个腔」← 人物口吻均质；段落模板过齐
+- 「场面摸不着」← 抽象感官词替代可触摸细节；悬空判断（「局势复杂」无场景落点）
+- 「段段总结收束」← 万能转折词堆砌、每段末口号式收束
+
+## 二稿顺序
+
+1. 列出不可改事件与信息边界。
+2. 挑 3–8 处表达簇场景化改写（物件/停顿/误说/他人反应）。
+3. 重写成连续正文，勿保留初稿句序骨架。
+4. 按章节合同与读者验收五问复验（见《章节节奏与开头》）。
+
+## 修复顺序
+
+保留必兑爽点与事实 → 最小片段替换 → 无效再整章 → 复验合同与五问 → 仍有小问题则记质量债并停止死循环（勿与审查判定死磕）。
+
+## 禁忌
+
+- 以外部「AI检测分」为唯一目标反复重写。
+- 修文时改掉必须事件或章末钩子。
+- 全词表机械替换制造假「人味」。
+- 写作侧自行宣布 `accepted` / 正式放行。

package/seed/skills/chapter//345/257/271/350/257/235/344/270/216/346/203/205/347/273/252.md

@@ -0,0 +1,52 @@
+# 对话与情绪
+
+对话揭示人物、推动情节、制造冲突；情绪曲线服务章目标。对白排版与口吻直接决定读者是否出戏。
+
+## 核心原则
+
+1. 每句对话至少服务：推情节 / 揭人物 / 造冲突 / 传信息 / 表情感 / 造悬念。
+2. 简洁；真实对话可打断、迟疑、话未说完。
+3. 不同身份风险偏好与用词不同；闭眼听对白应能分辨说话人，三人同腔 = 失败。
+
+## 对白标点（硬约束）
+
+- 人物说出的话一律用中文弯引号：`“……”`
+- **禁止**：英文直引号 `""`、直角引号「」、圆括号 `()`、方括号 `[]`、书名号 `《》`、`『』` 等充当对白外壳
+- 标签习惯：`道：“……”` 或 `“……”某某道`；多用动作/神态代替连续「他说/她道」
+- 内心独白：不入引号，用叙述或斜切内心；**禁止**括号夹注（如`（他心想……）`）
+- 省略、打断用 `……` / 话未说完截断；不以 `...` 或破折号堆砌替代引号
+
+## 可执行清单
+
+### 对话
+
+- 删寒暄与无信息问答。
+- 潜台词：表面说 A，实际争 B（对白是给对方听的版本）。
+- 冲突对话：目标对立，各不让步或假意让步。
+- 设定用行动/冲突带出，禁止说明书腔大段讲设定。
+
+### 视角与信息差
+
+- 单场戏默认跟一个 POV，禁止无标跳头（读者会懵）。
+- 读者信息与角色信息不强行对齐；用信息差推冲突。
+
+### 情绪曲线
+
+- 定本章主情绪与起伏点（加压→误判→爆发→余波）。
+- 情绪落在身体反应、物件、他人反应上，少用抽象词。
+- 虐点后有补偿或新目标，避免纯虐空转。
+- 每章至少一个可读回报（关系/信息/局势），与节奏 skill 一致。
+
+## 修订自检（改对话时内心核对，勿单独交报告）
+
+- 无效句是否已删或改成有目的的版本
+- 关系/信息是否因对话产生净变化
+- 三人说话是否像同一个人
+- 对白外壳是否全部为 “”
+
+## 禁忌
+
+- 「你好」「吃了吗」式无效对话。
+- 用对话大段讲设定（说明书腔）。
+- 格言化旁白替代人物当场反应。
+- 非 “” 对白外壳或括号夹注对白/内心。

package/seed/skills/chapter//347/253/240/350/212/202/346/225/260/346/215/256/347/273/264/346/212/244.md

@@ -0,0 +1,61 @@
+# 章节数据维护
+
+正文落库用 `mutate_entities`（domain=`chapter`）。身份只要 `ordinal`（章号）+ `name`（短名，如 `灭门夜`）；界面显示「第1章 灭门夜」，**不要**把「第1章」写进 `name`。`chapterNo` 仅作 `ordinal` 的兼容别名。`content` 是正文。可选 `relatedOutlineId` 或 `relatedOutlineName` 挂到大纲章节点。
+
+写章时除正文外，必须用 `mutate_entities` 同步本章引起的设定变更。目的：防止下一章读者出戏（人突然没了、神器归属错、生物首次出场无档）。
+
+## 必须同步的设定变化
+
+| 类型 | domain | 示例 |
+|------|--------|------|
+| 新出场人物 / 人物档案变化 | `role` | 新配角、主角受伤后状态更新 |
+| 关系变化 | `roleRelation` | 结盟、决裂、师徒（一条有向边即可） |
+| 人物履历 | `roleTimeline` | 晋升、负伤、重大抉择 |
+| 物品流转 | `item` | 获得神器、损毁、转手 |
+| 物品履历 | `itemTimeline` | 认主、封印、损毁 |
+| 新出场生物 / 生物档案变化 | `creature` | 新异兽、灵植状态变化 |
+| 生物履历 | `creatureTimeline` | 驯化、反噬、死亡 |
+| 世界节点 | `world` | 新地点、势力易主 |
+| 世界线 | `worldTimeline` | 某地战乱、政权更迭 |
+| 主时间线 | `timeline` | 冲突、悬念、伏笔、转折 |
+| 等级体系 | `level` | 体系/等级规则变化（较少见） |
+
+## 可声明无变更
+
+若本章仅推进剧情、不改动任何设定档案，不必 mutate 其它域。
+
+## owner 与宿主（易混）
+
+- `item` / `creature` 的 `owner` = 归属主人的**人物名字符串**。
+- 附属时间线宿主用 `roleName` / `itemName` / `creatureName`（或对应 `*Id`），不是 owner 字段。
+- 主人变更 = 实体 `owner` + 对应 `*Timeline`，缺一不可。
+
+## 各域 payload 必填
+
+| domain | 写入 |
+|--------|------|
+| `chapter` | `ordinal` + `name`；正文放 `content` |
+| `role` / `item` / `creature` | `name` + 模板字段顶层 key |
+| `roleRelation` | 双方引用（from/to id 或 name）+ `relationType` + 非空 `content` |
+| `roleTimeline` | `roleId`\|`roleName` + `timeLabel` + `timePoint` + 非空 `content` |
+| `itemTimeline` | `itemId`\|`itemName` + `timeLabel` + `timePoint` + `content` |
+| `creatureTimeline` | `creatureId`\|`creatureName` + `timeLabel` + `timePoint` + `content` |
+| `worldTimeline` | `worldNodeId`\|`worldNodeName` + `timeLabel` + `timePoint` + `content` |
+| `timeline` | `timeLabel` + `timePoint` + `title` + `content` + `eventType` |
+| `world` | `name` + `kind` |
+| `level` | `system.name` + 非空 `system.levels` |
+
+## 流程
+
+1. `query_entities` / `get_entities` 读对应大纲章合同与相关设定
+2. 写正文
+3. `mutate_entities` 写入 `chapter`（`ordinal` + `name` + `content`）
+4. 本章改动的设定同样用 `mutate_entities` 写入对应域
+
+## 禁忌
+
+- 正文出现新人物名却不写入 `role`
+- 正文出现新生物名却不写入 `creature`
+- 只写正文不同步设定变更
+- 用空 query 拉全书索引浪费上下文（应带名称查询）
+- 把「第N章」写进 `name`

package/seed/skills/chapter//347/253/240/350/212/202/350/212/202/345/245/217/344/270/216/345/274/200/345/244/264.md

@@ -0,0 +1,61 @@
+# 章节节奏与开头
+
+每一章是完整叙事单元；开篇决定去留，读完须有净变化。章尾钩子见《章首钩子》。
+
+## 核心原则
+
+1. 开篇不劝退：前几段须有即时张力、推动事件或情感冲击。
+2. 章内张力有升有落；读完净变化（关系/信息/局势至少一项）能一句话说清。
+3. 主角用选择推动局面，而非纯旁观。
+4. 若系统注入 `chapterWordTarget`，正文须落在区间内；**达标不等于不注水**。
+
+## 读者验收五问（写前自检，勿单独输出规划稿）
+
+1. 开篇会不会让我想划走？
+2. 读完我能一句话说清「得到了什么」吗？
+3. 有没有哪段像说明书/复读/注水？
+4. 对白是否像不同的人在说话，且全是 “”？
+5. 章末我是否想立刻看下一章（真期待，非假钩）？
+
+## 强力开头（优先 5 类）
+
+1. **行动中开场**：冲突高潮点切入。
+2. **反常情境**：不合常理，逼问怎么回事。
+3. **震撼对话**：一句改变关系/局势的话（对白用 “”）。
+4. **倒计时**：明确时限与后果。
+5. **重大发现**：线索/真相改变理解。
+
+## 承上（禁复述）
+
+- 用回声细节、未完成动作续写、物件/伤势状态承接上章。
+- 禁止「上回说到」式复盘；读者已知信息不重复讲解。
+
+## 开头禁忌
+
+| 类型 | 为何致命 |
+|------|----------|
+| 天气/起床流水账 | 无冲突，劝退 |
+| 「上回说到」复述 | 浪费篇幅 |
+| 大段世界观倾倒 | 无行动 |
+| 无意义寒暄 | 无信息 |
+
+## 章内节奏
+
+- 开场加压 → 中段升级或误判 → 高潮兑现/反转 → 章末牵引。
+- 每场戏至少推进：情节 / 人物 / 信息 之一。
+- 打破预期：读者以为会 A 时给代价更高的 B。
+- 单章场景宜紧凑（通常 1–3 场），避免无信息切场。
+
+## 写前自检（内心核对，勿单独交作业）
+
+- 开头是否不劝退、落在哪一类手段上
+- 本章必须事件是否可兑现
+- 一句话净变化是什么
+- 章末翻页欲是否成立（钩子细则见《章首钩子》）
+
+## 禁忌
+
+- 全章解释、回顾、重复无新信息。
+- 高潮在开场后一路泄气至章末。
+- 主角全程被推着走，无主动选择。
+- 单独输出规划稿代替正文。

package/seed/skills/chapter//347/253/240/351/246/226/351/222/251/345/255/220.md

@@ -0,0 +1,40 @@
+# 章首钩子
+
+章尾逼读、制造翻页欲；钩子强度与信息边界匹配。开头类型与章骨架见《章节节奏与开头》。
+
+## 核心原则
+
+1. 每章结尾必须有有效钩子（危机、揭示、未完成动作、两难等）。
+2. **验收主句：翻页欲**——钩子须改写读者对局势的理解或下一步期待。
+3. 假钩子伤害信任，比弱钩更糟。
+
+## 章首（交叉引用）
+
+开头手段（行动切入 / 反常画面 / 危险对话 / 倒计时 / 发现物证等）见《章节节奏与开头》。引子后迅速进入本章目标，不长时间空转。
+
+## 章尾钩子（常用）
+
+1. **突然揭示**：信息改写现状。
+2. **紧急危机**：下一章必须应对。
+3. **未完成动作**：打断在结果前。
+4. **身份反转**：关系重定义。
+5. **两难选择**：决定前截断。
+6. **新压力源**：更强敌/规则反噬/资源争夺。
+
+## 悬念强度
+
+- 弱：好奇细节 → 中：威胁人物目标 → 强：威胁生存/身份/关系根基。
+- 长篇交替使用，避免章章同质「更大反派出现」。
+
+## 写前自检（内心核对，勿单独交作业）
+
+- 章尾具体落点是什么，读者会期待什么
+- 是否真改写期待（非装饰性停顿）
+- 留给下章的未决问题是否可在后续兑现
+
+## 禁忌
+
+- 假钩子：下章立刻无关或纯搞笑消解。
+- 剧透终局；或钩子依赖读者未知的百科设定。
+- 开篇加压后大段降温至无聊铺垫。
+- 单独输出钩子规划稿代替正文。

package/seed/skills/creature//345/274/202/345/205/275/344/270/216/347/201/265/346/244/215.md

@@ -0,0 +1,11 @@
+# 异兽与灵植
+
+按 `kind` 分型写清辨识与代价；批量创建时字段写全。
+
+- **异兽（beast）**：血脉/神通/克制关系写清；危险等级与栖息环境对应。
+- **灵植（plant）**：通灵条件、药性/毒性、采摘代价；勿写成普通道具（道具走 item）。
+- **灵体（spirit）**：依附物、显形条件、对主人的羁绊或反噬。
+- **普通动物（animal）**：可作氛围与线索，仍需一两点可辨特征。
+- **其他（other）**：写清为何不成上述四类，以及核心能力/危险边界。
+
+批量创建时每批 3～5 只，字段写全后再下一批；有主人时先确保人物已存在，再填 `owner`（人物名）。关键节点同步 `creatureTimeline`。

package/seed/skills/creature//347/224/237/347/211/251/346/241/243/346/241/210/350/246/201/347/264/240.md

@@ -0,0 +1,13 @@
+# 生物档案要素
+
+除人物外的生物（动物、异兽、通灵植物、灵体等）写入时注意。读者向：出场有辨识与代价，归属不乱。
+
+## 写库要点
+
+1. **种类 `kind`**：库表标量 `animal|beast|plant|spirit|other`，不要塞进 profile。
+2. **名称唯一**：全书生物名唯一；别名可写在档案字段。
+3. **主人可选**：有主则 **`owner` 传人物名字符串**（勿传 UUID / 勿用 `ownerId`）；野生/无主省略或置空。
+4. **档案写满**：栖息、习性、能力、外形、危险等级、来历等按模板 key 覆盖大半，避免只剩名字。
+5. **时间线**：驯养、觉醒、战损、易主等关键节点写进 `creatureTimeline`（须 `creatureId|creatureName` + `timeLabel` + 整数 `timePoint` + 非空 `content`；有标题则写 `title`）。
+
+写作时突出辨识特征与战力代价，勿与人物档案混写。有主人时先确保人物已存在。

package/seed/skills/genres//344/273/231/344/276/240/overview//351/242/230/346/235/220/350/247/204/345/210/231.md

@@ -0,0 +1,32 @@
+# 题材规则 · 仙侠
+
+偏修仙/仙侠：道与劫、宗门天梯、飞升长线。与玄幻升级流共享骨架，强调「修」的代价与境界质变。
+
+## 读者期待
+
+- 从凡到仙的阶梯感；心性、机缘、天劫同样重要。
+- 爽点：破境、渡劫、悟道、夺宝、名震一方、飞升在望。
+- 仙凡对照：人情债与天道冷规则交织。
+
+## 大纲重点
+
+1. 境界体系写清质变差异（不只改称号）。
+2. 机缘有代价：因果、心魔、天妒、宗门争夺。
+3. 宗门/散修/魔道三角张力，内部派系可用。
+4. 每卷至少一个「渡劫或近死破境」节点。
+5. 长线指向更高天域/飞升，但不透支终局。
+
+## 章纲/正文重点
+
+- 修炼戏要有风险与选择，忌闭关旁白涨战力。
+- 法宝/功法有使用史与暴露风险。
+- 章尾优先：心魔、天劫征兆、宗门追杀令、上界注视。
+
+## 雷点
+
+- 境界灌水无质变；无心性的纯数值仙。
+- 全程打怪升级，无因果与人情。
+
+## 联动区块
+
+level · world（规则/势力）· role（心性缺陷）