@musnows/scriverse 1.0.12 → 1.1.0

package/README.en.md

@@ -109,6 +109,7 @@ Run `scriverse --help` for all local server, default server, authentication, wor
 | `SCRIVERSE_AI_RETRY_COUNT` | `3` | Retry count for AI upstream HTTP errors other than `403`, `429`, and `502`; valid integers are clamped to `1`–`20` |
 | `SCRIVERSE_AI_BACKOFF_RETRY_COUNT` | `10` | Backoff retry count when an AI upstream returns `429` or `502`; valid integers are clamped to `1`–`20` |
 | `SCRIVERSE_AI_STREAM_IDLE_TIMEOUT_SECONDS` | `30` | Maximum idle time while an interactive AI stream waits for its first or next valid event; valid integers are clamped to `10`–`120`, and invalid values fall back to `30` |
+| `SCRIVERSE_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH` | `6000` | Maximum character length for chapter comments and todos; valid integers are clamped to `2000`–`20000`, values below `2000` are treated as `2000`, and invalid values fall back to `6000` |
 | `APP_AUTH_USERNAME` | Empty | Optional deployment gateway username; the in-app user system is always enabled |
 | `APP_AUTH_PASSWORD` | Empty | Optional deployment gateway password, at least 12 characters; must be transported over HTTPS |
 | `APP_TRUST_PROXY` | `false` | Set to the trusted proxy hop count (usually `1`) or `true` behind a trusted reverse proxy |
@@ -120,6 +121,8 @@ Run `scriverse --help` for all local server, default server, authentication, wor
 
 `SCRIVERSE_AI_STREAM_IDLE_TIMEOUT_SECONDS` is read when the service starts and only controls how long an interactive AI stream may remain without a new event. Every valid stream event restarts the timer, so generation may continue beyond 60 seconds; this setting does not impose a total-duration limit or change timeout behavior for analysis tasks and other AI requests. Restart the service after changing it.
 
+`SCRIVERSE_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH` is read when the service starts and applies to API validation, the comment input, and AI write plans. Restart the service after changing it.
+
 The AI upstream HTTP retry settings are read when the service starts. `403` is never retried. `429` and `502` use exponential backoff starting at 500 milliseconds and capped at 5 seconds, honoring a numeric `Retry-After` within the same cap; other HTTP errors use a linear delay. Invalid values fall back to their defaults. Restart the service after changing either setting.
 
 Custom configuration example:

package/README.md

@@ -118,6 +118,7 @@ CLI 会按服务器保存登录凭据。所有连接服务的数据命令都可
 | `SCRIVERSE_AI_BACKOFF_RETRY_COUNT` | `10` | AI 上游返回 `429` 或 `502` 时的退避重试次数；有效整数按 `1`–`20` 钳制 |
 | `SCRIVERSE_AI_STREAM_IDLE_TIMEOUT_SECONDS` | `30` | 交互式 AI 流等待首个或下一个有效事件的最长空闲秒数；有效整数按 `10`–`120` 钳制，非法值回退为 `30` |
 | `APP_AI_CHAT_TAB_LIMIT` | `5` | 浏览器中可同时打开的 Agent 对话数；有效整数按 `1`–`20` 钳制，设为 `1` 时关闭多会话切换和工作台 |
+| `SCRIVERSE_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH` | `6000` | 正文评论和待办内容的最大字符数；有效整数按 `2000`–`20000` 钳制，低于 `2000` 按 `2000` 处理，非法值回退为 `6000` |
 | `APP_AUTH_USERNAME` | 空 | 可选的部署网关账号；应用内用户系统始终启用 |
 | `APP_AUTH_PASSWORD` | 空 | 可选的部署网关密码，至少 12 个字符；必须通过 HTTPS 传输 |
 | `APP_TRUST_PROXY` | `false` | 位于可信反向代理后时设为代理跳数（通常为 `1`）或 `true` |
@@ -137,6 +138,8 @@ CLI 会按服务器保存登录凭据。所有连接服务的数据命令都可
 
 `SCRIVERSE_AI_STREAM_IDLE_TIMEOUT_SECONDS` 在服务启动时读取，只控制交互式 AI 流连续没有新事件的等待时间。每收到一个有效流事件都会重新计时，持续生成超过 60 秒不会因此中断；该配置不设置总时长上限，也不改变分析任务等其他 AI 请求的超时策略。修改后需重启服务生效。
 
+`SCRIVERSE_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH` 在服务启动时读取，同时约束 API、界面输入和 AI 写计划中的正文评论与待办。修改后需重启服务生效。
+
 AI 上游 HTTP 重试配置在服务启动时读取。`403` 始终不重试；`429` 和 `502` 使用指数退避，等待从 500 毫秒开始并在 5 秒封顶，同时遵循秒数格式的 `Retry-After`（同样最多等待 5 秒）；其余 HTTP 错误使用线性等待。非法配置回退到对应默认值，修改后需重启服务生效。
 
 自定义示例：

package/dist/ai-stream-steer.js

@@ -0,0 +1,96 @@
+import { AppError } from "./errors.js";
+import { id, now } from "./utils.js";
+export const AI_STEER_MAX_CHARS = 100_000;
+export const AI_STEER_INSTRUCTION_HEADING = "【执行流引导】";
+export function createAiSteerRefreshError() {
+    return new AppError(409, "AI_STEER_REFRESH", "收到执行流引导，正在把当前回复交给引导继续");
+}
+export function isAiSteerRefreshError(error) {
+    return error instanceof AppError && error.code === "AI_STEER_REFRESH";
+}
+export function normalizeAiSteerContent(value) {
+    return String(value ?? "").trim();
+}
+export function formatAiSteerInstruction(content) {
+    const normalized = normalizeAiSteerContent(content);
+    return `${AI_STEER_INSTRUCTION_HEADING}\n作者在当前回答尚未结束时补充了以下引导，请立即按此调整后续执行，不要重新开始整个任务：\n\n${normalized}`;
+}
+export class AiStreamSteerMailbox {
+    active = new Set();
+    pending = new Map();
+    waiters = new Map();
+    begin(conversationId) {
+        const key = String(conversationId ?? "").trim();
+        if (!key)
+            throw new AppError(400, "AI_STEER_CONVERSATION_REQUIRED", "执行流引导必须绑定对话");
+        this.active.add(key);
+        if (!this.pending.has(key))
+            this.pending.set(key, []);
+        return () => this.end(key);
+    }
+    isActive(conversationId) {
+        return this.active.has(String(conversationId ?? "").trim());
+    }
+    enqueue(conversationId, content) {
+        const key = String(conversationId ?? "").trim();
+        const normalized = normalizeAiSteerContent(content);
+        if (!key)
+            throw new AppError(400, "AI_STEER_CONVERSATION_REQUIRED", "执行流引导必须绑定对话");
+        if (!normalized)
+            throw new AppError(400, "AI_STEER_EMPTY", "请输入引导内容");
+        if (normalized.length > AI_STEER_MAX_CHARS) {
+            throw new AppError(400, "AI_STEER_TOO_LONG", `引导内容不能超过 ${AI_STEER_MAX_CHARS} 个字符`);
+        }
+        if (!this.active.has(key)) {
+            throw new AppError(409, "AI_STEER_NO_ACTIVE_STREAM", "当前对话没有正在执行的回复，无法发送引导");
+        }
+        const entry = {
+            id: id("steer"),
+            conversationId: key,
+            content: normalized,
+            createdAt: now()
+        };
+        const queue = this.pending.get(key) ?? [];
+        queue.push(entry);
+        this.pending.set(key, queue);
+        this.signal(key);
+        return entry;
+    }
+    drain(conversationId) {
+        const key = String(conversationId ?? "").trim();
+        const items = this.pending.get(key) ?? [];
+        this.pending.set(key, []);
+        return items;
+    }
+    subscribe(conversationId, controller) {
+        const key = String(conversationId ?? "").trim();
+        if (!key)
+            return () => undefined;
+        let waiters = this.waiters.get(key);
+        if (!waiters) {
+            waiters = new Set();
+            this.waiters.set(key, waiters);
+        }
+        waiters.add(controller);
+        return () => {
+            waiters?.delete(controller);
+            if (waiters && waiters.size === 0)
+                this.waiters.delete(key);
+        };
+    }
+    signal(conversationId) {
+        const waiters = this.waiters.get(conversationId);
+        if (!waiters)
+            return;
+        for (const controller of waiters) {
+            if (!controller.signal.aborted)
+                controller.abort(createAiSteerRefreshError());
+        }
+    }
+    end(conversationId) {
+        this.active.delete(conversationId);
+        this.pending.delete(conversationId);
+        this.waiters.delete(conversationId);
+    }
+}
+//# sourceMappingURL=ai-stream-steer.js.map

package/dist/ai-stream-steer.js.map

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

package/dist/ai-write-plans.js

@@ -3,6 +3,8 @@ import { analysisTaskReadModules } from "./user-auth.js";
 import { AppError } from "./errors.js";
 import { logger } from "./logger.js";
 import { id as randomId, json, now } from "./utils.js";
+import { characterAttributesInputSchema, characterStateInputSchema } from "./character-structured-fields.js";
+import { DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH } from "./chapter-annotation-note.js";
 import { canReadWorkModule, canWriteWorkModule, emptyWorkModulePermissions, fullWorkModulePermissions, storedWorkModulePermissions, workPermissionModuleLabels } from "./work-permissions.js";
 /**
  * AI 可写工具与持久化审批工作流。
@@ -116,9 +118,9 @@ const characterInputSchema = z.object({
     aliases: z.array(z.string().trim().min(1).max(200)).max(100).optional(),
     raceId: identifierSchema.nullable().optional(),
     organizationIds: z.array(identifierSchema).max(100).optional(),
-    attributes: jsonObjectSchema.optional(),
+    attributes: characterAttributesInputSchema.optional().describe("身份与扩展属性。只使用 identity 字符串和 details[{label,value}]；其他键会在入库时折入 details。"),
     profile: jsonObjectSchema.optional(),
-    currentState: jsonObjectSchema.optional()
+    currentState: characterStateInputSchema.optional()
 }).strict();
 /** 种族可写字段：成员归属与分节设定结构保留给人工。 */
 const raceInputSchema = z.object({
@@ -247,7 +249,7 @@ function toolInputJsonSchema(schema) {
  * 每个操作类型和实体类型都使用独立分支，避免通用对象把 entityId、scope 等
  * 仅属于其他操作的字段错误地暴露给 create_entry。
  */
-export function aiWritePlanOperationToolSchemas(toggles) {
+export function aiWritePlanOperationToolSchemas(toggles, chapterAnnotationNoteMaxLength = DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH) {
     const entityTypes = [
         ...(toggles.settings ? ["setting"] : []),
         ...(toggles.characters ? ["character"] : []),
@@ -300,7 +302,7 @@ export function aiWritePlanOperationToolSchemas(toggles) {
                 kind: { type: "string", enum: ["note", "todo"] },
                 startLine: { type: "integer", minimum: 1 },
                 endLine: { type: "integer", minimum: 1 },
-                note: { type: "string", minLength: 1, maxLength: 2000 }
+                note: { type: "string", minLength: 1, maxLength: chapterAnnotationNoteMaxLength }
             },
             required: ["opType", "chapterId", "kind", "startLine", "endLine", "note"],
             additionalProperties: false
@@ -353,37 +355,39 @@ export const aiAnalysisTaskTypeLabels = {
     "book-analysis": "整书分析",
     "relationship-analysis": "人物关系分析"
 };
-const createOperationSchema = z.discriminatedUnion("opType", [
-    z.object({
-        opType: z.literal("create_entry"),
-        entityType: entryEntityTypeSchema,
-        /** 章节大纲按章节定位。 */
-        chapterId: identifierSchema.optional(),
-        input: z.unknown()
-    }).strict(),
-    z.object({
-        opType: z.literal("update_entry"),
-        entityType: entryEntityTypeSchema,
-        entityId: identifierSchema.optional(),
-        chapterId: identifierSchema.optional(),
-        input: z.unknown()
-    }).strict(),
-    z.object({
-        opType: z.literal("create_annotation"),
-        chapterId: identifierSchema,
-        kind: z.enum(["note", "todo"]),
-        startLine: z.number().int().positive(),
-        endLine: z.number().int().positive(),
-        note: z.string().trim().min(1).max(2000)
-    }).strict(),
-    z.object({
-        opType: z.literal("create_task"),
-        taskType: z.enum([...AI_ANALYSIS_TASK_TYPES, "relationship-analysis"]),
-        scope: jsonObjectSchema.optional(),
-        modelId: identifierSchema.optional()
-    }).strict()
-]);
-const planOperationsSchema = z.array(createOperationSchema).min(1);
+function createPlanOperationSchema(chapterAnnotationNoteMaxLength) {
+    return z.discriminatedUnion("opType", [
+        z.object({
+            opType: z.literal("create_entry"),
+            entityType: entryEntityTypeSchema,
+            /** 章节大纲按章节定位。 */
+            chapterId: identifierSchema.optional(),
+            input: z.unknown()
+        }).strict(),
+        z.object({
+            opType: z.literal("update_entry"),
+            entityType: entryEntityTypeSchema,
+            entityId: identifierSchema.optional(),
+            chapterId: identifierSchema.optional(),
+            input: z.unknown()
+        }).strict(),
+        z.object({
+            opType: z.literal("create_annotation"),
+            chapterId: identifierSchema,
+            kind: z.enum(["note", "todo"]),
+            startLine: z.number().int().positive(),
+            endLine: z.number().int().positive(),
+            note: z.string().trim().min(1).max(chapterAnnotationNoteMaxLength)
+        }).strict(),
+        z.object({
+            opType: z.literal("create_task"),
+            taskType: z.enum([...AI_ANALYSIS_TASK_TYPES, "relationship-analysis"]),
+            scope: jsonObjectSchema.optional(),
+            modelId: identifierSchema.optional()
+        }).strict()
+    ]);
+}
+const createOperationSchema = createPlanOperationSchema(DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH);
 export const createAiWritePlanInputSchema = z.object({
     aiSummary: z.string().trim().min(1).max(2000),
     operations: z.unknown()
@@ -851,8 +855,8 @@ export function planOperationRequirements(operation) {
     }
     return { toolId: toolId, writeModules: [...writeModules], readModules: [...readModules] };
 }
-export function normalizePlanOperations(rawOperations, maxOperations) {
-    const rawList = planOperationsSchema.max(maxOperations, `单次计划最多包含 ${maxOperations} 个操作`).safeParse(rawOperations);
+export function normalizePlanOperations(rawOperations, maxOperations, chapterAnnotationNoteMaxLength = DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH) {
+    const rawList = z.array(createPlanOperationSchema(chapterAnnotationNoteMaxLength)).min(1).max(maxOperations, `单次计划最多包含 ${maxOperations} 个操作`).safeParse(rawOperations);
     if (!rawList.success) {
         const firstIssue = rawList.error.issues[0];
         throw new AppError(400, "AI_PLAN_OPERATION_INVALID", `${firstIssue?.path.join(".") || "operation"}：${firstIssue?.message ?? "操作格式无效"}`);
@@ -997,6 +1001,7 @@ export class AiWritePlanManager {
     startAnalysisTask;
     planTtlMs;
     questionTtlMs;
+    chapterAnnotationNoteMaxLength;
     constructor(deps, options = {}) {
         this.database = deps.database;
         this.store = deps.store;
@@ -1005,6 +1010,7 @@ export class AiWritePlanManager {
         this.startAnalysisTask = deps.startAnalysisTask;
         this.planTtlMs = options.planTtlMs ?? AI_WRITE_PLAN_TTL_MS;
         this.questionTtlMs = options.questionTtlMs ?? AI_USER_QUESTION_TTL_MS;
+        this.chapterAnnotationNoteMaxLength = options.chapterAnnotationNoteMaxLength ?? DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH;
         this.recoverStaleExecutingPlans();
     }
     // --------------------------------------------------------------- 工具开关
@@ -1237,7 +1243,7 @@ export class AiWritePlanManager {
         if (!summaryParse.success)
             throw new AppError(400, "AI_PLAN_SUMMARY_REQUIRED", "AI 必须提供一段简要说明");
         const maxOperations = resolveAiWritePlanMaxOperations(process.env.AI_WRITE_PLAN_MAX_OPERATIONS);
-        const operations = normalizePlanOperations(input.operations, maxOperations);
+        const operations = normalizePlanOperations(input.operations, maxOperations, this.chapterAnnotationNoteMaxLength);
         const toggles = this.getEnabledTools(workId);
         const effective = this.effectiveWritePermissions(input.initiator, input.conversationOwnerUserId, workId);
         // 先统一做逐操作校验，收集标题与详情。