dsh-novel-write-engine 0.0.0-stage → 0.1.1

package/package.json

@@ -1,6 +1,137 @@
 {
   "name": "dsh-novel-write-engine",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "novel",
+    "writing"
+  ],
+  "homepage": "https://github.com/ThzxxArt/dsh-novel-write-engine#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ThzxxArt/dsh-novel-write-engine.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ThzxxArt/dsh-novel-write-engine/issues"
+  },
+  "type": "module",
+  "license": "MIT",
+  "packageManager": "pnpm@11.28.9",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./presets/*.patch.yml": "./presets/*.patch.yml",
+    "./rulepacks/*": "./rulepacks/*",
+    "./briefs/*": "./briefs/*",
+    "./skill": "./skills/entry.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "presets",
+    "rulepacks",
+    "briefs",
+    "skills",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": [
+        "./cordis.patch.yml",
+        "./presets/novel-write-engine.patch.yml"
+      ]
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ],
+      "external": [
+        "react",
+        "react/jsx-runtime"
+      ]
+    }
+  },
+  "engines": {
+    "node": ">=24.9.0",
+    "dsh": ">=0.2.1-rc.2 <0.3.0-0"
+  },
+  "scripts": {
+    "build": "tsdown && tsdown -c tsdown.client.config.ts && tsc -p tsconfig.client.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
+    "lint": "eslint . && prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"scripts/**/*.mjs\"",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage && node scripts/check-coverage.mjs",
+    "test:isolated": "node scripts/check-isolated.mjs",
+    "validate:rulepack": "node scripts/validate-rulepack.mjs",
+    "check:preset": "node scripts/check-preset.mjs",
+    "check:pack": "node scripts/check-pack.mjs",
+    "check:artifacts": "node scripts/check-artifacts.mjs",
+    "check:install": "node scripts/check-install.mjs",
+    "check:host": "node scripts/check-host.mjs",
+    "check:hygiene": "node scripts/check-hygiene.mjs"
+  },
+  "dependencies": {
+    "yaml": "^2.6.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "@deepseek-ai/dsh-tools": "^0.2.0-rc.1 || ^0.2.1-rc.1",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-ui-layout": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/cordis-plugin-loader": "1.0.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-skill": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.3",
+    "@deepseek-ai/schemastery": "3.18.5",
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "18.3.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.15.0",
+    "happy-dom": "^15.11.0",
+    "prettier": "^3.3.0",
+    "react": "^18.3.1",
+    "react-dom": "18.3.1",
+    "tsdown": "^0.22.0",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.15.0",
+    "vitest": "^3.0.0"
+  }
+}

package/presets/novel-write-engine.patch.yml

@@ -0,0 +1,56 @@
+- insert:
+    - id: preset-novel-write-engine
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: novel-write-engine
+        name: 网文工坊
+        description: 网文创作专用会话：18 个小说工具全开，无文件写权限，门控与字数由引擎裁决。
+        order: 20
+        plugins:
+          - id: persona
+            name: '@deepseek-ai/dsh-persona'
+            config:
+              prefix: |-
+                你是「网文工坊」的主笔，一位只认数字与状态的网文作者。
+
+                - 每章先看状态：novel_status 与 novel_brief 说了什么就按什么做，不凭记忆推测进度。
+                - 正文只经 novel_write_draft，改稿只经 novel_revise；归档只走 novel_archive，且必须带 state_delta。没有别的写入口。
+                - 字数、引号、格式、门控结论一律以引擎返回为准，不要自己估算，也不要复述旧数字。
+                - 评审每一分都要指到具体扣分项；指不出来就不要扣。
+                - 设定、前章细节、伏笔状态拿不准就查 novel_state，不许编。
+          - { id: time-context, name: '@deepseek-ai/dsh-time-context' }
+          - { id: tool-skill, name: '@deepseek-ai/dsh-tool-skill' }
+          - { id: tool-ask-user, name: '@deepseek-ai/dsh-tool-ask-user' }
+          - {
+              id: tool-todo,
+              name: '@deepseek-ai/dsh-tool-todo',
+              config: { allowParallelInProgress: false },
+            }
+          - { id: present, name: '@deepseek-ai/dsh-tool-present' }
+          - {
+              id: tool-web,
+              name: '@deepseek-ai/dsh-tool-web',
+              config: { fetch: true, searchTimeoutMs: 60000 },
+            }
+          - id: compaction
+            name: cordis:group
+            group: true
+            isolate: { compaction: true, toolResultPruner: true }
+            config:
+              - { id: compaction-basic, name: '@deepseek-ai/dsh-compaction-basic' }
+              - { id: command-compact, name: '@deepseek-ai/dsh-command-compact' }
+              - id: tool-result-pruner
+                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+                config: { thresholdChars: 8192, headChars: 4096, tailChars: 1024 }
+          - id: delegation
+            name: cordis:group
+            group: true
+            isolate: { workflowEngine: true }
+            config:
+              - { id: tool-subagent-control, name: '@deepseek-ai/dsh-tool-subagent-control' }
+              - id: tool-subagent
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config: { provider: spawn, toolName: subagent, modelSelection: true, modelDiscovery: true }
+              - id: tool-subagent-fork
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config: { provider: fork, toolName: subagent_fork }

package/rulepacks/default.yaml

@@ -0,0 +1,231 @@
+schema_version: 1
+name: default
+version: "1.0.0"
+
+lexicon:
+  zero_tolerance:
+    - { term: "总而言之", note: "AI 套话" }
+    - { term: "不可否认", note: "AI 套话" }
+    - { term: "不禁", note: "AI 套话" }
+    - { term: "仿佛", note: "AI 套话" }
+    - { term: "似乎", note: "AI 套话" }
+    - { term: "嘴角微微上扬", note: "模板动作" }
+    - { term: "眼中闪过一丝", note: "模板表情" }
+    - { term: "心中暗道", note: "模板心理" }
+    - { term: "殊不知", note: "叙事套话" }
+    - { term: "与此同时", note: "转场套话" }
+    - { term: "话虽如此", note: "转折套话" }
+    - { term: "换句话说", note: "解释套话" }
+    - { term: "与此同时的", note: "重复表达" }
+    - { term: "油然而生", note: "成语套话" }
+    - { term: "不由自主", note: "成语套话" }
+    - { term: "若有所思", note: "成语套话" }
+    - { term: "意味深长", note: "成语套话" }
+    - { term: "哭笑不得", note: "成语套话" }
+    - { term: "五味杂陈", note: "成语套话" }
+    - { term: "如释重负", note: "成语套话" }
+    - { term: "醍醐灌顶", note: "成语套话" }
+    - { term: "恍然大悟", note: "成语套话" }
+    - { term: "电光火石", note: "成语套话" }
+    - { term: "千钧一发", note: "成语套话" }
+    - { term: "浑然不觉", note: "成语套话" }
+    - { term: "不置可否", note: "成语套话" }
+    - { term: "若有所思地", note: "成语套话" }
+    - { term: "深吸一口气", note: "模板动作" }
+    - { term: "缓缓开口", note: "模板动作" }
+    - { term: "淡淡说道", note: "模板台词" }
+    - { term: "冷冷地说", note: "模板台词" }
+    - { term: "微微一笑", note: "模板动作" }
+    - { term: "眉头一皱", note: "模板动作" }
+    - { term: "心中一凛", note: "模板心理" }
+    - { term: "心头一震", note: "模板心理" }
+    - { term: "后背发凉", note: "模板生理" }
+    - { term: "头皮发麻", note: "模板生理" }
+    - { term: "瞳孔骤缩", note: "模板生理" }
+    - { term: "倒吸一口凉气", note: "模板生理" }
+    - { term: "空气仿佛凝固", note: "模板环境" }
+    - { term: "死一般的寂静", note: "模板环境" }
+    - { term: "时间仿佛静止", note: "模板环境" }
+    - { term: "命运的齿轮", note: "叙事套话" }
+    - { term: "一波未平一波又起", note: "叙事套话" }
+    - { term: "说来话长", note: "叙事套话" }
+    - { term: "果然不出所料", note: "叙事套话" }
+    - { term: "果不其然", note: "叙事套话" }
+    - { term: "毫无意外", note: "叙事套话" }
+    - { term: "显而易见", note: "叙事套话" }
+    - { term: "显而易见地", note: "叙事套话" }
+    - { term: "不容置疑", note: "叙事套话" }
+    - { term: "毋庸置疑", note: "叙事套话" }
+    - { term: "众所周知", note: "元叙述" }
+    - { term: "值得一提的是", note: "元叙述" }
+    - { term: "需要指出的是", note: "元叙述" }
+    - { term: "让我们", note: "读者侵入" }
+    - { term: "读者朋友们", note: "读者侵入" }
+    - { term: "各位看官", note: "读者侵入" }
+    - { term: "话说回来", note: "转场套话" }
+    - { term: "另一方面", note: "转场套话" }
+    - { term: "正因如此", note: "解释套话" }
+    - { term: "正是因为", note: "解释套话" }
+
+  soft:
+    - { term: "犹如", limit: 1 }
+    - { term: "宛若", limit: 1 }
+    - { term: "宛如", limit: 1 }
+    - { term: "仿佛置身", limit: 1 }
+    - { term: "瞬间", limit: 3 }
+    - { term: "立刻", limit: 4 }
+    - { term: "顿时", limit: 4 }
+    - { term: "猛地", limit: 3 }
+    - { term: "陡然", limit: 2 }
+    - { term: "骤然", limit: 2 }
+    - { term: "缓缓", limit: 4 }
+    - { term: "轻轻", limit: 4 }
+    - { term: "微微", limit: 4 }
+    - { term: "淡淡", limit: 3 }
+    - { term: "冷冷", limit: 3 }
+    - { term: "默默", limit: 3 }
+    - { term: "静静", limit: 3 }
+    - { term: "深深", limit: 3 }
+    - { term: "紧紧", limit: 3 }
+    - { term: "死死", limit: 2 }
+
+  contextual:
+    - { term: "赋能", limit: 2, genres: [都市现代, 游戏系统] }
+    - { term: "闭环", limit: 2, genres: [都市现代, 科幻] }
+    - { term: "颗粒度", limit: 1, genres: [都市现代] }
+    - { term: "对齐", limit: 2, genres: [都市现代] }
+    - { term: "灵根", limit: 6, genres: [玄幻修仙] }
+    - { term: "灵气", limit: 8, genres: [玄幻修仙] }
+    - { term: "副本", limit: 8, genres: [游戏系统, 无限流] }
+    - { term: "系统提示", limit: 6, genres: [游戏系统, 无限流] }
+
+  meta_narration:
+    - { term: "不难看出" }
+    - { term: "可以看出" }
+    - { term: "由此可见" }
+    - { term: "话说" }
+    - { term: "且说" }
+    - { term: "却说" }
+
+  reader_intrusion:
+    - { pattern: "我们(?:可以)?看(?:到)?(?:这里|下面|接下来|这一幕|这个|这场|这段)" }
+    - { pattern: "各位读者" }
+    - { pattern: "屏幕前的" }
+
+  god_view:
+    - { pattern: "这注定是" }
+    - { pattern: "当时的.{0,4}还不知道" }
+    - { pattern: "多年以后" }
+    - { pattern: "命运早已" }
+
+  conclusion_first:
+    verbs: [感到, 觉得, 知道, 明白, 意识到, 发现, 察觉]
+    causals: [因为, 所以, 于是, 因此, 由于]
+
+format:
+  paragraph_max_words: 90
+  forbid_markdown: true
+  forbid_semicolon: true
+  forbid_english_ellipsis: true
+  title:
+    pattern: "^第\\d+章\\s"
+    min_chars: 4
+    max_chars: 8
+  system_labels:
+    - "Day\\s*\\d+"
+    - "第[0-9一二三四五六七八九十百]+卷"
+    - "作者(?:按|说)?"
+    - "读者"
+    - "书友"
+  scene_separators: ["———", "***", "…………"]
+  markdown_markers: ["#", "**", "---", ">", "|"]
+
+punctuation:
+  dash:
+    base: { 战斗/动作章: 3, 日常过渡章: 4, 情感爆发章: 6, 纯叙事章: 3 }
+    scale_words: 3000
+    token: "——"
+  period_density: { min: 1.5, max: 8 }
+  ellipsis_run: { max: 1, token: "……" }
+  uniform_sentence: { min_sentences: 8, ratio: 0.6 }
+  consecutive_le: { max: 3, char: "了" }
+  dialogue_dominant_ratio: 0.60
+
+semantics:
+  adjective_density:
+    max: 4
+    adjectives: [美丽, 漂亮, 英俊, 巨大, 渺小, 愤怒, 悲伤, 开心, 恐怖, 温柔, 冰冷, 炙热, 明亮, 昏暗]
+  pleasure_density:
+    min: 1
+    keywords: [打脸, 逆袭, 震惊, 哗然, 跪, 服气, 反转, 暴涨, 秒杀, 碾压, 掌声, 惊呼, 目瞪口呆, 傻眼]
+    window: 600
+  sensory_density:
+    min: 2
+    senses: [看, 听, 闻, 触, 尝, 冷, 热, 香, 臭, 疼, 痒, 麻, 亮, 暗, 声, 响]
+    window: 800
+  water_words:
+    window: 150
+    threshold: 0.35
+    scene_thresholds:
+      战斗/动作章: 0.25
+      日常过渡章: 0.35
+      情感爆发章: 0.30
+      纯叙事章: 0.40
+    terms: [的就是, 的时候, 时候, 一个, 一种, 一些, 这个, 那个, 这样, 那样, 其实, 确实, 真的, 非常, 十分]
+
+platform:
+  fanqie: { words_per_chapter: [2000, 3000], dialogue_ratio: [0.40, 0.60] }
+  qidian: { words_per_chapter: [2000, 3500], dialogue_ratio: [0.30, 0.50] }
+  qimao: { words_per_chapter: [1500, 2500], dialogue_ratio: [0.45, 0.65] }
+  jinjiang: { words_per_chapter: [2500, 4000], dialogue_ratio: [0.35, 0.55] }
+
+genres:
+  玄幻修仙: { note: "力量体系必须自洽；升级要有代价，境界不能靠形容词抬升。" }
+  都市现代: { note: "现实都市，冲突来自资源、关系与规则；爽点要落在可验证的行动上。" }
+  西方奇幻: { note: "种族、语言与力量来源要建条目；奇观不能替代人物选择。" }
+  悬疑推理: { note: "线索先于解答出现；每个伏笔都要在归档台账中可核销。" }
+  科幻: { note: "技术设定只写对情节有用的部分；禁止用术语代替冲突。" }
+  游戏系统: { note: "系统提示是世界观内文本；奖励与惩罚必须可追踪。" }
+  历史架空: { note: "礼制、称谓与器物要经得起基本推敲；不写现代口号。" }
+  无限流: { note: "副本规则先立后破；每次通关都要付出可记账的代价。" }
+  轻小说: { note: "关系推进靠具体互动，不靠内心独白宣布；对话要能区分说话人。" }
+  军事: { note: "战术细节服务于人物选择；不写武器参数清单。" }
+  末世流: { note: "生存资源必须记账；恐惧来自规则崩塌，不靠突然的音效式形容词。" }
+  言情: { note: "亲密关系按阶梯推进；单次独白要短，情绪落在动作上。" }
+
+crosschapter:
+  duplicate_similarity: 0.9
+  duplicate_advisory: 0.75
+  duplicate_min_chars: 20
+  foreshadow_min_dormancy: 2
+  foreshadow_dormant_after: 20
+  check_time: true
+  lock_similarity: 0.75
+
+quality:
+  dimensions:
+    - { id: R-W-01, max: 15 }
+    - { id: R-W-02, max: 10 }
+    - { id: R-W-03, max: 10 }
+    - { id: R-W-04, max: 20 }
+    - { id: R-W-05, max: 15 }
+    - { id: R-W-12, max: 20 }
+    - { id: R-W-11, max: 10 }
+    - { id: R-W-13, max: 15 }
+    - { id: R-W-14, max: 10 }
+    - { id: R-W-15, max: 10 }
+    - { id: R-W-06, max: 4 }
+    - { id: R-W-07, max: 4 }
+    - { id: R-W-08, max: 4 }
+    - { id: R-W-09, max: 2 }
+    - { id: R-W-10, max: 1 }
+
+exclusions:
+  - { pair: [META_NARRATION, LEX_ZERO_TOLERANCE], family: meta }
+  - { pair: [READER_INTRUSION, LEX_ZERO_TOLERANCE], family: reader }
+  - { pair: [GOD_VIEW, CONCLUSION_FIRST], family: perspective }
+  - { pair: [DUPLICATE_PARAGRAPH, FS_REVISITED_TOO_SOON], family: repetition }
+  - { pair: [RESOURCE_MISMATCH, TIME_REGRESSION], family: continuity }
+  - { pair: [LEX_SOFT_LIMIT, LEX_ZERO_TOLERANCE], family: style }
+
+exemptions: []

package/skills/entry.md

@@ -0,0 +1,68 @@
+---
+name: novel-write-engine
+description: 引擎版小说创作流程——状态、门控、字数与写盘入口全部由插件裁决。用于任何「写小说 / 写第 N 章 / 续写 / 改稿 / 归档」任务。
+---
+
+# 网文工坊（引擎版）
+
+你不是在「帮用户写小说」，你是在**驱动一台有状态的引擎**。状态由引擎维护，你只负责内容与调用。
+
+## 六条铁律
+
+1. **先看状态，再动笔。** 任何创作动作前先 `novel_status`；每章开工先 `novel_brief <阶段>`。
+2. **正文只有两个写入口。** `novel_write_draft`（初稿）与 `novel_revise`（修订）。`novel_amend` 只改状态文档，不写正文；没有第四条路。
+3. **字数与门控以引擎返回为准。** 不要自己估算字数，不要复述旧数字。
+4. **评审每一分都要定位。** 指不到「第 N 段」的扣分不要写；证据要逐字引用。
+5. **不编设定。** 人物、地点、伏笔、资源状态拿不准就 `novel_state` 查。
+6. **归档是一次事务，且必须核销。** `novel_archive` 必须带 `state_delta`：本章每个角色/伏笔/事件/新设定/关系逐条声明 `created|updated|no_change`；不要手工拼章节索引或交接文件。
+
+## 流程路由
+
+| 当前阶段         | 任务书           | 下一动作             |
+| ---------------- | ---------------- | -------------------- |
+| idle             | `novel_brief P1` | `novel_plan_world`   |
+| P2               | `novel_brief P2` | `novel_plan_chapter` |
+| P3               | `novel_brief P3` | `novel_write_draft`  |
+| P4               | `novel_brief P4` | `novel_review`       |
+| P5               | `novel_brief P5` | `novel_revise`       |
+| P6               | `novel_brief P6` | `novel_check`        |
+| ready_to_archive | `novel_brief P8` | `novel_archive`      |
+| done             | —                | 下一章从 P1 开始     |
+
+拿不准就走 `novel_pipeline`，它直接告诉你调什么、传什么。任务书缺失或 digest 过期时，它第一步会返回 `novel_brief`；照它给的 `args` 领取后再继续，不要直接调用被门控的写工具。
+
+## 工具速查
+
+| 工具 | 用途 |
+| --- | --- |
+| `novel_init` | 建项目 |
+| `novel_status` | 当前章/阶段/阻塞/下一步 |
+| `novel_brief` | 取阶段任务书与上下文 |
+| `novel_plan_world` | P1 世界观计划 |
+| `novel_plan_chapter` | P2 章节计划 |
+| `novel_write_draft` | P3 初稿 |
+| `novel_review` | P4 十五维评分 |
+| `novel_revise` | P5 修订 |
+| `novel_check` | P6 一致性校验 |
+| `novel_archive` | 归档事务 |
+| `novel_word_count` | 字数口径 |
+| `novel_state` | 只读台账/计划/评审 |
+| `novel_amend` | 受控改状态文档 |
+| `novel_rollback` | 回退阶段 |
+| `novel_diff` | 与备份/文本对比 |
+| `novel_export` | md/txt/epub |
+| `novel_audit` | 事务审计 |
+| `novel_pipeline` | 推荐下一步与参数 |
+
+## 工具怎么用
+
+- 参数是 JSON 对象；`summary`、`dimensions`、`issues`、`proof` 是结构化对象，按任务书字段填。
+- `novel_check` 必须带四个语义项（`L2-SCENE-ANCHOR` / `L2-CHARACTER-STATE` / `L2-CAUSALITY` / `L2-VOICE`），每项都要有正文逐字引用；缺一项即校验不过。
+- 失败分三类：参数错（改参数）、门控没过（改正文）、系统故障（查目录/稍后重试）。错误消息里的 code 说明属于哪类。
+- 门控失败会一次列出**全部**阻塞项；一次改完再交，不要逐条试。
+
+## 交付
+
+- 每章归档后，用户在面板「网文工坊」看到章节表与阻塞区。
+- 导出：`novel_export md|txt|epub`。
+- 不要在对话里重复整章正文；工具结果已经可见。