dsh-novel-write-engine 0.2.10 → 0.2.12

package/lib/index.d.ts

@@ -2813,7 +2813,7 @@ declare const PANEL_ROUTE = "/api/novel-write-engine/panel";
 declare const SKILL_NAME = "novel-write-engine";
 declare const REMOTE_VERSION = 6;
 /** User-visible panel/tutorial version; keep in sync with package.json. */
-declare const PANEL_VERSION = "0.2.10";
+declare const PANEL_VERSION = "0.2.12";
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 declare const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */

package/lib/index.js

@@ -16,7 +16,7 @@ const PANEL_ROUTE = "/api/novel-write-engine/panel";
 const SKILL_NAME = "novel-write-engine";
 const REMOTE_VERSION = 6;
 /** User-visible panel/tutorial version; keep in sync with package.json. */
-const PANEL_VERSION = "0.2.10";
+const PANEL_VERSION = "0.2.12";
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */
@@ -17815,6 +17815,254 @@ const NEXT_DETAILS = {
 	novel_diff: "对比当前正文与上一版或给定文本。",
 	novel_word_count: "按引擎字数口径核对正文长度。"
 };
+[
+	{
+		title: "状态与内容",
+		hint: "只读查询，随时可跑",
+		items: [
+			{
+				form: "/novel status",
+				summary: "进度、项目选择、轮次、字数、门控与下一步。"
+			},
+			{
+				form: "/novel next",
+				summary: "下一步该调哪个工具、为什么；卡住时先看它。"
+			},
+			{
+				form: "/novel stats",
+				summary: "章节数、总字数（归档 + 草稿）、均分、伏笔、覆盖率与规则包。"
+			},
+			{
+				form: "/novel outline",
+				summary: "蓝图、大纲覆盖率、当前章卡与世界观计数。"
+			},
+			{
+				form: "/novel guide",
+				summary: "六态引导与下一步；新项目、写作中、完结都能用。"
+			},
+			{
+				form: "/novel report",
+				summary: "全书报告：进度、质量、伏笔、节奏与警告。"
+			},
+			{
+				form: "/novel doctor",
+				summary: "项目体检：锁、备份、状态文档、正文与大纲漂移。"
+			},
+			{
+				form: "/novel search <关键词>",
+				summary: "搜索正文、摘要、大纲、世界观与台账；空关键词会报用法。"
+			}
+		]
+	},
+	{
+		title: "项目与会话",
+		hint: "只改查看对象或登记，不动正文",
+		items: [
+			{
+				form: "/novel projects",
+				summary: "列出登记项目；* 当前会话，P 面板默认，! 缺失/待修复。"
+			},
+			{
+				form: "/novel projects --prune",
+				summary: "只预览失效登记（missing / not-project / unreadable），不写盘。"
+			},
+			{
+				form: "/novel projects --prune --yes",
+				summary: "删除失效登记行，不删项目目录；--yes 不能单独使用。"
+			},
+			{
+				form: "/novel current",
+				summary: "当前会话绑定、选择来源和失效状态。"
+			},
+			{
+				form: "/novel use <路径|书名|.>",
+				summary: "切换当前会话；不改变 active；点号按 cwd 规则选唯一项目。"
+			},
+			{
+				form: "/novel unbind",
+				summary: "只清当前会话绑定；项目、登记和正文都不动。"
+			},
+			{
+				form: "/novel scan",
+				summary: "只读扫描 cwd、cwd/novel 和直接子目录；不递归、不跟随符号链接。"
+			},
+			{
+				form: "/novel scan --register",
+				summary: "只登记健康项目；不选择、不改 active、不绑会话。"
+			}
+		]
+	},
+	{
+		title: "续写与导出",
+		hint: "resume 只读；export 写入 exports/",
+		items: [
+			{
+				form: "/novel resume",
+				summary: "输出可粘贴的续写指令；只读，与面板“复制续写指令”同源。"
+			},
+			{
+				form: "/novel export md",
+				summary: "正文 Markdown。"
+			},
+			{
+				form: "/novel export txt",
+				summary: "正文纯文本。"
+			},
+			{
+				form: "/novel export epub",
+				summary: "正文 EPUB 3。"
+			},
+			{
+				form: "/novel export outline",
+				summary: "大纲计划。"
+			},
+			{
+				form: "/novel export worldbook",
+				summary: "世界观设定集。"
+			},
+			{
+				form: "/novel export proposal",
+				summary: "书级提案。"
+			}
+		]
+	},
+	{
+		title: "隐藏与运维",
+		hint: "JSON 必须是对象",
+		items: [{
+			form: "/novel admin",
+			summary: "列出全部 25 个隐藏/运维操作与示例。"
+		}, {
+			form: "/novel admin <op> <json>",
+			summary: "执行一个操作；参数同对应工具，JSON 外层的双引号要保留。"
+		}]
+	}
+].reduce((total, group) => total + group.items.length, 0);
+const ADMIN_OPERATION_NAMES = [
+	{
+		title: "写作、状态与恢复",
+		hint: "参数与同名工具一致",
+		items: [
+			{
+				name: "novel_plan_world",
+				summary: "提交 P1 世界计划"
+			},
+			{
+				name: "novel_plan_chapter",
+				summary: "提交 P2 章节计划"
+			},
+			{
+				name: "novel_word_count",
+				summary: "统计纯文本或项目字数"
+			},
+			{
+				name: "novel_amend",
+				summary: "修复状态文档"
+			},
+			{
+				name: "novel_rollback",
+				summary: "回退阶段"
+			},
+			{
+				name: "novel_diff",
+				summary: "对比文本或章稿"
+			},
+			{
+				name: "novel_audit",
+				summary: "审计 journal"
+			},
+			{
+				name: "novel_pipeline",
+				summary: "下一步建议"
+			},
+			{
+				name: "novel_state",
+				summary: "读取原始状态、历史与备份"
+			},
+			{
+				name: "novel_reopen",
+				summary: "重开已归档章"
+			},
+			{
+				name: "novel_restore",
+				summary: "从备份事务恢复"
+			}
+		]
+	},
+	{
+		title: "规划、检索与诊断",
+		hint: "书级写操作也在这里",
+		items: [
+			{
+				name: "novel_blueprint",
+				summary: "写书级蓝图与卷"
+			},
+			{
+				name: "novel_outline",
+				summary: "章卡与卷 upsert"
+			},
+			{
+				name: "novel_outline_import",
+				summary: "导入 Markdown / YAML / JSON 大纲"
+			},
+			{
+				name: "novel_worldbook",
+				summary: "按段更新世界观"
+			},
+			{
+				name: "novel_search",
+				summary: "搜索正文、大纲与台账"
+			},
+			{
+				name: "novel_doctor",
+				summary: "项目体检"
+			},
+			{
+				name: "novel_report",
+				summary: "全书报告"
+			},
+			{
+				name: "novel_guide",
+				summary: "引导与下一步"
+			}
+		]
+	},
+	{
+		title: "导出",
+		hint: "六种 kind 同一入口",
+		items: [{
+			name: "novel_export",
+			summary: "导出正文、大纲、世界观或提案"
+		}]
+	},
+	{
+		title: "登记与设定包",
+		hint: "只走命令入口，不注册工具",
+		items: [
+			{
+				name: "novel_registry_list",
+				summary: "列出登记项目"
+			},
+			{
+				name: "novel_registry_register",
+				summary: "登记一个项目，传 root"
+			},
+			{
+				name: "novel_registry_activate",
+				summary: "改面板默认 active，传 root"
+			},
+			{
+				name: "novel_registry_forget",
+				summary: "删登记行，传 root"
+			},
+			{
+				name: "novel_import",
+				summary: "导入设定包"
+			}
+		]
+	}
+].flatMap((group) => group.items.map((operation) => operation.name));
+ADMIN_OPERATION_NAMES.length;
 // src/commands/admin.ts
 /** Registry commands need an explicit root; do not pass undefined into path.resolve. */
 const rootArg = (args) => {
@@ -17870,7 +18118,7 @@ const OPERATIONS$1 = {
 	novel_registry_forget: (engine, args) => engine.forgetProject({ root: rootArg(args) }),
 	novel_import: (engine, args) => engine.importPack(args)
 };
-const ADMIN_OPERATION_NAMES = Object.keys(OPERATIONS$1);
+Object.keys(OPERATIONS$1);
 const adminHelp = () => [
 	"隐藏操作/运维操作（tools.mode=core 时经本命令可达；registry/import 仅命令入口）：",
 	...ADMIN_OPERATION_NAMES.map((name) => `  ${name}`),

package/lib/types/command-reference.d.ts

@@ -0,0 +1,45 @@
+/**
+ * User-facing command reference shared by the panel tutorial and command help.
+ * Keep this file free of Node-only imports: it is bundled into the browser half.
+ */
+export interface CommandSpec {
+    readonly form: string;
+    readonly summary: string;
+}
+export interface CommandGroup {
+    readonly title: string;
+    readonly hint: string;
+    readonly items: readonly CommandSpec[];
+}
+/** The five registered command entry points, including the umbrella command. */
+export declare const COMMAND_ENTRY: readonly CommandSpec[];
+/**
+ * Every named `/novel` form. The bare `/novel` default is listed in COMMAND_ENTRY,
+ * so the total here is 25 rather than 26.
+ */
+export declare const COMMAND_GROUPS: readonly CommandGroup[];
+/** Number of named `/novel` forms (the bare `/novel` default is separate). */
+export declare const COMMAND_FORM_COUNT: number;
+export interface AdminOperationSpec {
+    readonly name: string;
+    readonly summary: string;
+}
+export interface AdminOperationGroup {
+    readonly title: string;
+    readonly hint: string;
+    readonly items: readonly AdminOperationSpec[];
+}
+/**
+ * Operations reachable through `/novel admin <op> <json>`. This list must stay
+ * byte-for-byte aligned with `src/commands/admin.ts`; tests enforce that.
+ */
+export declare const ADMIN_OPERATION_GROUPS: readonly AdminOperationGroup[];
+export declare const ADMIN_OPERATION_NAMES: readonly string[];
+export declare const ADMIN_OPERATION_COUNT: number;
+export interface CommandCombination {
+    readonly title: string;
+    readonly steps: readonly string[];
+    readonly note: string;
+}
+/** Copyable workflows; no hidden state changes beyond the listed commands. */
+export declare const COMMAND_COMBINATIONS: readonly CommandCombination[];

package/lib/types/constants.d.ts

@@ -6,7 +6,7 @@ export declare const PANEL_ROUTE = "/api/novel-write-engine/panel";
 export declare const SKILL_NAME = "novel-write-engine";
 export declare const REMOTE_VERSION = 6;
 /** User-visible panel/tutorial version; keep in sync with package.json. */
-export declare const PANEL_VERSION = "0.2.10";
+export declare const PANEL_VERSION = "0.2.12";
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 export declare const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-write-engine",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
   "keywords": [
     "dsh-plugin",