Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
TypeScript agent-skillscodex-clideskop-appdubbingimage-generationlocalizationskillsttsvideo-editingvideo-generationvideo-transcriptionvideo-translation
perf: optimize desktop lifecycle and runtime validation
wulien-center8ccc40975fb5
diff --git a/apps/daemon/src/agent-tools/mcp-routes.ts b/apps/daemon/src/agent-tools/mcp-routes.tsindex 13f526cf..64deecc3 100644--- a/apps/daemon/src/agent-tools/mcp-routes.ts+++ b/apps/daemon/src/agent-tools/mcp-routes.ts@@ -1,4 +1,3 @@-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';import type {FastifyInstance,FastifyReply,@@ -14,14 +13,12 @@ import {import {createAgentScheduleHttpClient} from './schedule-tools.js';-import { createAgentScheduleMcpServer } from './stdio-server.js';import { toolNamesForScopes } from './run-injection.js';import {createCreatorToolDefinitions,createCreatorToolHttpClient,type CreatorToolName} from './creator-tools.js';-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';export const AGENT_CREATOR_MCP_ROUTE = `${AGENT_TOOL_ROUTE_PREFIX}/mcp/creator`;@@ -41,6 +38,10 @@ export async function registerCreatorMcpRoute(...(allowed.has('creator:artifact:read') ? ['creator_get_artifact' as const] : []),...(allowed.has('creator:action') ? ['creator_apply_action' as const] : [])];+ const [{ McpServer }, { StreamableHTTPServerTransport }] = await Promise.all([+ import('@modelcontextprotocol/sdk/server/mcp.js'),+ import('@modelcontextprotocol/sdk/server/streamableHttp.js')+ ]);const client = createCreatorToolHttpClient({ baseUrl, token: authorization.token });const definitions = createCreatorToolDefinitions({ request: client.request });const mcpServer = new McpServer({ name: 'opencreator-tools', version: '0.1.0' });@@ -110,6 +111,11 @@ export async function registerAgentScheduleMcpRoute(return reply.code(503).send(jsonRpcError('OpenCreator runtime is not listening'));}+ const [{ StreamableHTTPServerTransport }, { createAgentScheduleMcpServer }] = await Promise.all([+ import('@modelcontextprotocol/sdk/server/streamableHttp.js'),+ import('./stdio-server.js')+ ]);+const scheduleClient = createAgentScheduleHttpClient({baseUrl,token: authorization.tokendiff --git a/apps/daemon/src/api/routes.creator-runtime.ts b/apps/daemon/src/api/routes.creator-runtime.tsindex 138fa40d..d321d0c2 100644--- a/apps/daemon/src/api/routes.creator-runtime.ts+++ b/apps/daemon/src/api/routes.creator-runtime.ts@@ -7,6 +7,10 @@ export async function registerCreatorRuntimeRoutes(server: FastifyInstance,ytDlp: YtDlpUpdateManager | undefined): Promise<void> {+ server.addHook('preClose', () => {+ ytDlp?.close();+ });+server.get('/creator/yt-dlp/status', async (_request, reply) => {if (ytDlp === undefined) return unavailable(reply);return { ytDlp: ytDlp.status() };diff --git a/apps/daemon/src/api/server.ts b/apps/daemon/src/api/server.tsindex 67ff9363..cd3b94c6 100644--- a/apps/daemon/src/api/server.ts+++ b/apps/daemon/src/api/server.ts@@ -43,7 +43,11 @@ import { createCreatorCommandDispatcher } from '../creator/command-dispatcher.jsimport type { CreatorExecutor } from '../creator/executor.js';import { createKrillinExecutor } from '../creator/krillin/adapter.js';import { createKrillinDependencyLoader } from '../creator/krillin/dependency-loader.js';-import { readKrillinRuntimeManifest, resolveInside, verifyKrillinRuntimeManifest } from '../creator/krillin/manifest.js';+import { readKrillinRuntimeManifest, resolveInside } from '../creator/krillin/manifest.js';+import {+ hasKrillinRuntimeVerificationWorker,+ startKrillinRuntimeVerification+} from '../creator/krillin/runtime-verifier.js';import { createKrillinTtsService } from '../creator/krillin/tts-service.js';import { createDownloadExecutor } from '../creator/download/executor.js';import { resolveYtDlpRuntime } from '../creator/yt-dlp/runtime.js';@@ -297,9 +301,13 @@ export type BuildServerInput = {};const ATTACHMENT_CLEANUP_INTERVAL_MS = 60 * 60 * 1000;+const KRILLIN_VERIFICATION_BACKGROUND_DELAY_MS = 500;export async function buildServer(input: BuildServerInput) {- const server = Fastify({ logger: false });+ const server = Fastify({+ logger: false,+ forceCloseConnections: true+ });const allowedWebOrigins = new Set(input.allowedWebOrigins ?? ['http://127.0.0.1:19861']);@@ -475,7 +483,12 @@ export async function buildServer(input: BuildServerInput) {const creatorPresetRegistry = input.creatorPresetRegistry?? await loadCreatorPresetCatalog({root: creatorPresetCatalogRoot,- templates: creatorTemplates+ templates: creatorTemplates,+ verificationCachePath: join(+ dataDir,+ 'runtime-verification',+ 'creator-presets.json'+ )});const agentCapabilityTokens =input.agentCapabilityTokens ?? createAgentCapabilityTokenStore();@@ -576,6 +589,14 @@ export async function buildServer(input: BuildServerInput) {});const creatorRuntimeRoot = process.env.OPENCREATOR_CREATOR_RUNTIME_ROOT?? join(runtimeDir, 'krillinai');+ const krillinVerificationCachePath = join(+ dataDir,+ 'runtime-verification',+ 'krillinai.json'+ );+ let krillinVerificationTimer: NodeJS.Timeout | undefined;+ let startKrillinVerification: (() => ReturnType<typeof startKrillinRuntimeVerification>) | undefined;+ let ensureKrillinRuntimeReady = async () => {};const krillinDependencyLoader = createKrillinDependencyLoader({root: join(runtimeDir, 'krillinai', 'dependencies'),...(input.creatorRuntimePlatform === undefined@@ -586,7 +607,9 @@ export async function buildServer(input: BuildServerInput) {const krillinTtsService = createKrillinTtsService({resourceRoot: creatorRuntimeRoot,workRoot: join(creatorJobsRoot, '.tts'),- configStore: creatorServicesConfigStore+ configStore: creatorServicesConfigStore,+ verificationCachePath: krillinVerificationCachePath,+ ensureRuntimeReady: () => ensureKrillinRuntimeReady()});const smartDubbingService = createSmartDubbingService({dataDir,@@ -662,7 +685,26 @@ export async function buildServer(input: BuildServerInput) {let getCreatorYtDlpRuntime: (() => ReturnType<typeof resolveYtDlpRuntime>) | undefined;try {const runtimeManifest = readKrillinRuntimeManifest(creatorRuntimeRoot);- verifyKrillinRuntimeManifest(creatorRuntimeRoot, runtimeManifest);+ let runtimeVerification: ReturnType<typeof startKrillinRuntimeVerification> | undefined;+ startKrillinVerification = () => {+ if (krillinVerificationTimer !== undefined) {+ clearTimeout(krillinVerificationTimer);+ krillinVerificationTimer = undefined;+ }+ if (runtimeVerification === undefined) {+ runtimeVerification = startKrillinRuntimeVerification({+ resourceRoot: creatorRuntimeRoot,+ cachePath: krillinVerificationCachePath+ });+ void runtimeVerification.catch(error => {+ console.warn(`Creator runtime verification failed: ${formatError(error)}`);+ });+ }+ return runtimeVerification;+ };+ ensureKrillinRuntimeReady = async () => {+ await startKrillinVerification!();+ };const executable = (pattern: RegExp) => {const resource = runtimeManifest.resources.find(candidate => (candidate.kind === 'executable' && pattern.test(candidate.path)@@ -704,7 +746,9 @@ export async function buildServer(input: BuildServerInput) {jobsRoot: creatorJobsRoot,dependencyLoader: krillinDependencyLoader,configStore: creatorServicesConfigStore,- getYtDlpRuntime+ getYtDlpRuntime,+ verificationCachePath: krillinVerificationCachePath,+ ensureRuntimeReady: () => ensureKrillinRuntimeReady()}));}if (@@ -808,17 +852,23 @@ export async function buildServer(input: BuildServerInput) {ffprobePath: creatorFfprobePath,stickmanRuntimeRoot,...(getYtDlpRuntime === undefined ? {} : { getYtDlpRuntime }),+ runtimeVerificationCachePath: krillinVerificationCachePath,+ ensureRuntimeReady: () => ensureKrillinRuntimeReady(),executorIds: creatorExecutors.map(executor => executor.id),validateRuntimeAssets: input.creatorExecutors === undefined});const creatorProjectCoverService = createCreatorProjectCoverService({jobsRoot: creatorJobsRoot,+ ensureRuntimeReady: () => ensureKrillinRuntimeReady(),...(creatorFfmpegPath === undefined ? {} : { ffmpegPath: creatorFfmpegPath })});const creatorSourceMediaProbe = input.creatorSourceMediaProbe?? (creatorFfprobePath === undefined? undefined- : (path: string) => validateMediaFile(path, creatorFfprobePath!));+ : async (path: string) => {+ await ensureKrillinRuntimeReady();+ return await validateMediaFile(path, creatorFfprobePath!);+ });const creatorSourceUploadService = input.creatorSourceUploadService?? (creatorSourceMediaProbe === undefined? undefined@@ -1156,7 +1206,11 @@ export async function buildServer(input: BuildServerInput) {maxSizeBytes: input.attachmentMaxSizeBytes ?? ATTACHMENT_MAX_SIZE_BYTES,draftTtlMs: input.attachmentDraftTtlMs ?? ATTACHMENT_DRAFT_TTL_MS});- await attachmentService.cleanupExpiredDrafts();+ const initialAttachmentCleanup = attachmentService.cleanupExpiredDrafts()+ .then(() => undefined)+ .catch(error => {+ console.warn(`Initial attachment cleanup failed: ${formatError(error)}`);+ });const attachmentCleanupTimer = setInterval(() => {void attachmentService.cleanupExpiredDrafts().catch(error => {console.warn(`Attachment cleanup failed: ${formatError(error)}`);@@ -1178,6 +1232,18 @@ export async function buildServer(input: BuildServerInput) {throw error;});+ server.addHook('onListen', () => {+ if (+ startKrillinVerification === undefined+ || !hasKrillinRuntimeVerificationWorker()+ ) return;+ krillinVerificationTimer = setTimeout(() => {+ krillinVerificationTimer = undefined;+ void startKrillinVerification?.();+ }, KRILLIN_VERIFICATION_BACKGROUND_DELAY_MS);+ krillinVerificationTimer.unref();+ });+server.addHook('onClose', async () => {let firstError: unknown;const capture = async (operation: () => void | Promise<void>) => {@@ -1189,6 +1255,10 @@ export async function buildServer(input: BuildServerInput) {};await capture(() => clearInterval(attachmentCleanupTimer));+ await capture(() => {+ if (krillinVerificationTimer !== undefined) clearTimeout(krillinVerificationTimer);+ });+ await capture(() => initialAttachmentCleanup);await capture(() => unsubscribeApprovalNotifications());await capture(() => scheduler.stop());await capture(() => runManager.close());diff --git a/apps/daemon/src/codex/app-server-client.ts b/apps/daemon/src/codex/app-server-client.tsindex 2a966ee6..7aacb365 100644--- a/apps/daemon/src/codex/app-server-client.ts+++ b/apps/daemon/src/codex/app-server-client.ts@@ -92,10 +92,12 @@ export function createCodexAppServerClient(if (state.closed) return Promise.resolve();const hasExited = () => state.child.exitCode !== null || state.child.signalCode !== null;state.stopWork = new Promise<void>((resolve, reject) => {+ const onExit = () => finish();const onClose = () => finish();const finish = (error?: Error) => {clearTimeout(forceKill);clearTimeout(deadline);+ state.child.removeListener('exit', onExit);state.child.removeListener('close', onClose);state.child.stdin.destroy();state.child.stdout.destroy();@@ -114,7 +116,11 @@ export function createCodexAppServerClient(}, CLOSE_GRACE_MS * 2);forceKill.unref();deadline.unref();+ state.child.once('exit', onExit);state.child.once('close', onClose);+ // `exit` can have fired before shutdownProcess was entered from the+ // process exit handler. Do not wait for inherited pipes in that case.+ if (hasExited()) finish();});if (!hasExited()) void terminateCodexProcess(state.child, 'SIGTERM');return state.stopWork;diff --git a/apps/daemon/src/codex/capabilities.ts b/apps/daemon/src/codex/capabilities.tsindex ec691225..20fe24ce 100644--- a/apps/daemon/src/codex/capabilities.ts+++ b/apps/daemon/src/codex/capabilities.ts@@ -65,6 +65,8 @@ export type CollectCodexCapabilityMatrixInput = {};export const STARTUP_CAPABILITY_TIMEOUT_MS = 500;+export const BUNDLED_CODEX_VERSION = '0.149.0';+export const BUNDLED_CODEX_COMMIT = '758ef40f50c1a458425c7cfbf1eb12cbc07af0b0';export type CodexVersionProbeResult = {ready: boolean;@@ -72,6 +74,70 @@ export type CodexVersionProbeResult = {warning?: string;};+export function resolveBundledCodexStartupSnapshot(input: {+ mode?: string;+ version?: string;+ commit?: string;+ checkedAt?: string;+}): {+ version: string;+ capabilities: RuntimeCapabilityMatrix;+} | undefined {+ if (+ input.mode !== 'bundled'+ || input.version !== BUNDLED_CODEX_VERSION+ || input.commit !== BUNDLED_CODEX_COMMIT+ ) {+ return undefined;+ }+ const version = `codex-cli ${BUNDLED_CODEX_VERSION}`;+ return {+ version,+ capabilities: {+ codexVersion: version,+ checkedAt: input.checkedAt ?? new Date().toISOString(),+ execJson: true,+ execStdinPrompt: true,+ execProfile: true,+ execCwd: true,+ execSandbox: true,+ execSkipGitRepoCheck: true,+ resumeJson: true,+ resumeByThreadId: true,+ resumeLast: true,+ resumeModelOverride: true,+ resumeConfigOverride: true,+ resumeCwdOverride: false,+ resumeProfileOverride: false,+ resumeSandboxOverride: false,+ execImages: true,+ resumeImages: true,+ resumeContextContinuityVerified: false,+ appServer: true,+ appServerApprovals: true,+ mcpList: true,+ mcpGet: true,+ mcpAdd: true,+ mcpRemove: true,+ mcpLogin: true,+ mcpLogout: true,+ mcpAddEnv: true,+ mcpAddUrl: true,+ mcpAddBearerTokenEnvVar: true,+ mcpAddOAuth: true,+ mcpRuntimeDiscoveryVerified: false,+ mcpRuntimeBehaviorVerified: false,+ skillsScan: false,+ skillsInstall: false,+ skillsDelete: false,+ skillsGlobalWrite: false,+ skillsRuntimeDiscoveryVerified: false,+ skillsRuntimeBehaviorVerified: false,+ warnings: []+ }+ };+}+export async function probeCodexVersionAsync(input: {codexBin: string;timeoutMs?: number;diff --git a/apps/daemon/src/creator/article/document-generator.ts b/apps/daemon/src/creator/article/document-generator.tsindex 46985215..b54253fb 100644--- a/apps/daemon/src/creator/article/document-generator.ts+++ b/apps/daemon/src/creator/article/document-generator.ts@@ -7,8 +7,7 @@ import { createWriteStream } from 'node:fs';import { readFile, writeFile } from 'node:fs/promises';import { extname } from 'node:path';import { finished } from 'node:stream/promises';-import { marked, Renderer, type Token, type Tokens } from 'marked';-import PDFDocument from 'pdfkit';+import type { Token, Tokens } from 'marked';type ArticleImageSource = {path: string;@@ -46,6 +45,7 @@ export async function writeArticleHtml(path: string,input: ArticleDocumentInput): Promise<number> {+ const { marked, Renderer } = await import('marked');const images = await imageSources(input.artifacts);const renderer = new Renderer();renderer.html = token => `<pre>${escapeHtml(token.text)}</pre>`;@@ -116,6 +116,10 @@ export async function writeArticlePdf(path: string,input: ArticleDocumentInput): Promise<number> {+ const [{ marked }, { default: PDFDocument }] = await Promise.all([+ import('marked'),+ import('pdfkit')+ ]);const fonts = resolvePdfFonts();const images = await imageSources(input.artifacts);const document = new PDFDocument({diff --git a/apps/daemon/src/creator/article/source-extractor.ts b/apps/daemon/src/creator/article/source-extractor.tsindex ee1779b7..2812f47a 100644--- a/apps/daemon/src/creator/article/source-extractor.ts+++ b/apps/daemon/src/creator/article/source-extractor.ts@@ -1,5 +1,4 @@import type { CreatorArtifact, WechatArticleSourceLink } from '@opencreator/protocol';-import { load } from 'cheerio';import { createRequire } from 'node:module';import { readFile } from 'node:fs/promises';import { extname } from 'node:path';@@ -12,7 +11,7 @@ import type { YtDlpRuntime } from '../yt-dlp/runtime.js';const MAX_SOURCE_CHARS = 50_000;const require = createRequire(import.meta.url);-const pdfParse = require('pdf-parse') as (buffer: Buffer) => Promise<{ text: string }>;+let pdfParser: ((buffer: Buffer) => Promise<{ text: string }>) | undefined;export type ExtractedArticleSource = {id: string;@@ -107,6 +106,7 @@ async function extractWebpage();}const html = await response.text();+ const { load } = await import('cheerio');const $ = load(html);$('script,style,noscript,svg,nav,footer,form').remove();const title = cleanText(@@ -162,7 +162,7 @@ async function extractVideo(`Unable to download subtitles (${response.status}): ${link.url}`);}- const captions = parseCaptions(await response.text(), caption.ext);+ const captions = await parseCaptions(await response.text(), caption.ext);if (!captions) {throw new CreatorExecutorError('creator_source_transcript_missing',@@ -190,8 +190,10 @@ async function extractDocument(artifact: CreatorArtifact): Promise<ExtractedArticonst buffer = await readFile(artifact.path);let content: string;if (extension === '.pdf') {- content = cleanText((await pdfParse(buffer)).text);+ pdfParser ??= require('pdf-parse') as (buffer: Buffer) => Promise<{ text: string }>;+ content = cleanText((await pdfParser(buffer)).text);} else if (extension === '.html' || extension === '.htm') {+ const { load } = await import('cheerio');const $ = load(buffer.toString('utf8'));$('script,style,noscript,svg,nav,footer,form').remove();content = cleanText($('article,main,[role="main"]').first().text() || $('body').text());@@ -260,7 +262,7 @@ function chooseCaption(value: unknown): { url: string; ext: string; language: streturn undefined;}-function parseCaptions(value: string, extension: string): string {+async function parseCaptions(value: string, extension: string): Promise<string> {if (extension === 'json3') {try {const payload = JSON.parse(value) as { events?: Array<{ segs?: Array<{ utf8?: unknown }> }> };@@ -276,6 +278,7 @@ function parseCaptions(value: string, extension: string): string {}}if (extension === 'srv3' || extension === 'ttml' || /^\s*</.test(value)) {+ const { load } = await import('cheerio');const $ = load(value, { xmlMode: true });return cleanText($.root().text()).slice(0, MAX_SOURCE_CHARS);}diff --git a/apps/daemon/src/creator/krillin/adapter.ts b/apps/daemon/src/creator/krillin/adapter.tsindex 4cce580d..5bdf1e94 100644--- a/apps/daemon/src/creator/krillin/adapter.ts+++ b/apps/daemon/src/creator/krillin/adapter.ts@@ -34,12 +34,17 @@ export function createKrillinExecutor(input: {dependencyLoader: KrillinDependencyLoader;configStore: Pick<CreatorServicesConfigStore, 'read'>;getYtDlpRuntime?(): YtDlpRuntime | undefined;+ verificationCachePath?: string;+ ensureRuntimeReady?(): Promise<void>;}): CreatorExecutor {return {id: 'krillinai',async run(stage): Promise<CreatorExecutorResult> {+ await input.ensureRuntimeReady?.();const configured = await input.configStore.read();- const preflight = preflightKrillinDependencies(input.resourceRoot, configured);+ const preflight = preflightKrillinDependencies(input.resourceRoot, configured, {+ cachePath: input.verificationCachePath+ });const ffprobe = executablePath(input.resourceRoot, /(?:^|\/)ffprobe(?:\.exe)?$/i);const materializedArtifacts = await writeArtifactIndex(input.jobsRoot, stage);const options = buildKrillinStageOptions(stage);diff --git a/apps/daemon/src/creator/krillin/dependency-loader.ts b/apps/daemon/src/creator/krillin/dependency-loader.tsindex 87aeb8fc..370ca4b9 100644--- a/apps/daemon/src/creator/krillin/dependency-loader.ts+++ b/apps/daemon/src/creator/krillin/dependency-loader.ts@@ -20,7 +20,7 @@ import type {import { CreatorExecutorError } from '../executor.js';import { spawnCreatorProcess } from '../process-tree.js';import { createKrillinCreatorServicesCapabilities } from './capabilities.js';-import { openPromise, type ZipFile } from 'yauzl';+import type { ZipFile } from 'yauzl';const whisperKitRelease = {executable: {@@ -450,6 +450,7 @@ async function extractWhisperCppExecutableArchive(const extracted = new Set<string>();let zip: ZipFile | undefined;try {+ const { openPromise } = await import('yauzl');zip = await openPromise(archive, {autoClose: true,decodeStrings: true,diff --git a/apps/daemon/src/creator/krillin/dependency-preflight.ts b/apps/daemon/src/creator/krillin/dependency-preflight.tsindex ed2809eb..3e15b2a3 100644--- a/apps/daemon/src/creator/krillin/dependency-preflight.ts+++ b/apps/daemon/src/creator/krillin/dependency-preflight.ts@@ -6,10 +6,13 @@ import {export function preflightKrillinDependencies(resourceRoot: string,- config: CreatorServicesConfig+ config: CreatorServicesConfig,+ input: { cachePath?: string } = {}) {const manifest = readKrillinRuntimeManifest(resourceRoot);- verifyKrillinRuntimeManifest(resourceRoot, manifest);+ verifyKrillinRuntimeManifest(resourceRoot, manifest, {+ cachePath: input.cachePath+ });return {manifest,configdiff --git a/apps/daemon/src/creator/krillin/manifest.ts b/apps/daemon/src/creator/krillin/manifest.tsindex e3ea1fb9..270affc9 100644--- a/apps/daemon/src/creator/krillin/manifest.ts+++ b/apps/daemon/src/creator/krillin/manifest.ts@@ -1,11 +1,8 @@-import { createHash } from 'node:crypto';import {- closeSync,- openSync,- readFileSync,- readSync,- statSync-} from 'node:fs';+ sha256Text,+ verifyFileIntegrityWithCache+} from '@opencreator/config';+import { readFileSync } from 'node:fs';import { resolve } from 'node:path';import { z } from 'zod';@@ -64,13 +61,30 @@ export function readKrillinRuntimeManifest(resourceRoot: string): KrillinRuntimereturn manifest;}-export function verifyKrillinRuntimeManifest(resourceRoot: string, manifest: KrillinRuntimeManifest): void {- for (const resource of manifest.resources) {- const path = resolveInside(resourceRoot, resource.path);- if (!statSync(path).isFile()) throw new Error(`dependency_not_packaged: ${resource.path}`);- const actual = hashFile(path);- if (actual !== resource.sha256.toLowerCase()) throw new Error(`dependency_hash_mismatch: ${resource.path}`);+export function verifyKrillinRuntimeManifest(+ resourceRoot: string,+ manifest: KrillinRuntimeManifest,+ input: { cachePath?: string } = {}+): { cacheHit: boolean } {+ const root = resolve(resourceRoot);+ const result = verifyFileIntegrityWithCache({+ cachePath: input.cachePath,+ identity: root,+ fingerprint: sha256Text(JSON.stringify(manifest)),+ files: manifest.resources.map(resource => ({+ key: resource.path,+ path: resolveInside(root, resource.path),+ sha256: resource.sha256+ }))+ });+ if (!result.verified) {+ throw new Error(+ result.reason === 'hash_mismatch'+ ? `dependency_hash_mismatch: ${result.key}`+ : `dependency_not_packaged: ${result.key}`+ );}+ return { cacheHit: result.cacheHit };}export function resolveInside(root: string, relative: string): string {@@ -81,19 +95,3 @@ export function resolveInside(root: string, relative: string): string {}return result;}--function hashFile(path: string): string {- const digest = createHash('sha256');- const descriptor = openSync(path, 'r');- const buffer = Buffer.allocUnsafe(1024 * 1024);- try {- let bytesRead: number;- do {- bytesRead = readSync(descriptor, buffer, 0, buffer.length, null);- if (bytesRead > 0) digest.update(buffer.subarray(0, bytesRead));- } while (bytesRead > 0);- } finally {- closeSync(descriptor);- }- return digest.digest('hex');-}diff --git a/apps/daemon/src/creator/krillin/runtime-verifier.ts b/apps/daemon/src/creator/krillin/runtime-verifier.tsnew file mode 100644index 00000000..d3c9d831--- /dev/null+++ b/apps/daemon/src/creator/krillin/runtime-verifier.ts@@ -0,0 +1,78 @@+import { existsSync } from 'node:fs';+import { fileURLToPath } from 'node:url';+import { Worker } from 'node:worker_threads';+import {+ readKrillinRuntimeManifest,+ verifyKrillinRuntimeManifest+} from './manifest.js';++export type KrillinRuntimeVerificationResult = {+ cacheHit: boolean;+};++export function hasKrillinRuntimeVerificationWorker(): boolean {+ return existsSync(fileURLToPath(verificationWorkerUrl()));+}++export function startKrillinRuntimeVerification(input: {+ resourceRoot: string;+ cachePath: string;+}): Promise<KrillinRuntimeVerificationResult> {+ const workerUrl = verificationWorkerUrl();+ if (!hasKrillinRuntimeVerificationWorker()) {+ return new Promise((resolvePromise, reject) => {+ setImmediate(() => {+ try {+ const manifest = readKrillinRuntimeManifest(input.resourceRoot);+ resolvePromise(verifyKrillinRuntimeManifest(input.resourceRoot, manifest, {+ cachePath: input.cachePath+ }));+ } catch (error) {+ reject(error instanceof Error ? error : new Error(String(error)));+ }+ });+ });+ }++ return new Promise((resolvePromise, reject) => {+ const worker = new Worker(workerUrl, { workerData: input });+ let settled = false;+ worker.unref();+ worker.once('message', (message: unknown) => {+ if (settled) return;+ settled = true;+ if (+ typeof message === 'object'+ && message !== null+ && 'ok' in message+ && message.ok === true+ && 'cacheHit' in message+ && typeof message.cacheHit === 'boolean'+ ) {+ resolvePromise({ cacheHit: message.cacheHit });+ return;+ }+ const detail = typeof message === 'object'+ && message !== null+ && 'message' in message+ && typeof message.message === 'string'+ ? message.message+ : 'KrillinAI runtime verification failed';+ reject(new Error(detail));+ });+ worker.once('error', error => {+ if (settled) return;+ settled = true;+ reject(error);+ });+ worker.once('exit', code => {+ if (settled) return;+ settled = true;+ reject(new Error(`KrillinAI runtime verification worker exited with code ${code}`));+ });+ });+}++function verificationWorkerUrl(): URL {+ return new URL('./verification-worker.js', import.meta.url);+}diff --git a/apps/daemon/src/creator/krillin/tts-service.ts b/apps/daemon/src/creator/krillin/tts-service.tsindex 80dccd65..e058b6b6 100644--- a/apps/daemon/src/creator/krillin/tts-service.ts+++ b/apps/daemon/src/creator/krillin/tts-service.ts@@ -116,14 +116,23 @@ export function createKrillinTtsService(input: {workRoot: string;configStore: Pick<CreatorServicesConfigStore, 'read'>;timeoutMs?: number;+ verificationCachePath?: string;+ ensureRuntimeReady?(): Promise<void>;executeUtility?: (input: ExecuteUtilityInput) => Promise<KrillinUtilityResponse>;executeSynthesis?: (input: ExecuteSynthesisInput) => Promise<ExecuteSynthesisResult>;}) {- const executeUtility = input.executeUtility ?? (utility => executePackagedKrillinUtility({- ...utility,- resourceRoot: input.resourceRoot,- timeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS- }));+ const runUtility = input.executeUtility ?? (async utility => {+ return await executePackagedKrillinUtility({+ ...utility,+ resourceRoot: input.resourceRoot,+ timeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS,+ verificationCachePath: input.verificationCachePath+ });+ });+ const executeUtility = async (utility: ExecuteUtilityInput) => {+ await input.ensureRuntimeReady?.();+ return await runUtility(utility);+ };const executeSynthesis = input.executeSynthesis ?? (request => executeProviderSynthesis({...request,timeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS@@ -656,6 +665,7 @@ async function createLauncherRoot(workRoot: string): Promise<string> {async function executePackagedKrillinUtility(input: ExecuteUtilityInput & {resourceRoot: string;timeoutMs: number;+ verificationCachePath?: string;}): Promise<KrillinUtilityResponse> {if (input.signal?.aborted) {throw new KrillinTtsServiceError(@@ -667,7 +677,9 @@ async function executePackagedKrillinUtility(input: ExecuteUtilityInput & {let manifest;try {manifest = readKrillinRuntimeManifest(input.resourceRoot);- verifyKrillinRuntimeManifest(input.resourceRoot, manifest);+ verifyKrillinRuntimeManifest(input.resourceRoot, manifest, {+ cachePath: input.verificationCachePath+ });} catch (error) {throw new KrillinTtsServiceError('creator_tts_runtime_unavailable',diff --git a/apps/daemon/src/creator/krillin/verification-worker.ts b/apps/daemon/src/creator/krillin/verification-worker.tsnew file mode 100644index 00000000..6d1b3452--- /dev/null+++ b/apps/daemon/src/creator/krillin/verification-worker.ts@@ -0,0 +1,25 @@+import { parentPort, workerData } from 'node:worker_threads';+import {+ readKrillinRuntimeManifest,+ verifyKrillinRuntimeManifest+} from './manifest.js';++type VerificationWorkerInput = {+ resourceRoot: string;+ cachePath: string;+};++const input = workerData as VerificationWorkerInput;++try {+ const manifest = readKrillinRuntimeManifest(input.resourceRoot);+ const result = verifyKrillinRuntimeManifest(input.resourceRoot, manifest, {+ cachePath: input.cachePath+ });+ parentPort?.postMessage({ ok: true, cacheHit: result.cacheHit });+} catch (error) {+ parentPort?.postMessage({+ ok: false,+ message: error instanceof Error ? error.message : String(error)+ });+}diff --git a/apps/daemon/src/creator/preflight.ts b/apps/daemon/src/creator/preflight.tsindex 171920a6..35b90dcc 100644--- a/apps/daemon/src/creator/preflight.ts+++ b/apps/daemon/src/creator/preflight.ts@@ -56,6 +56,8 @@ export function createCreatorPreflight(input: {ffprobePath?: string;stickmanRuntimeRoot?: string;getYtDlpRuntime?(): YtDlpRuntime | undefined;+ runtimeVerificationCachePath?: string;+ ensureRuntimeReady?(): Promise<void>;executorIds?: Iterable<string>;validateRuntimeAssets?: boolean;}) {@@ -158,6 +160,23 @@ export function createCreatorPreflight(input: {config: CreatorServicesConfig,add: (status: 'ready' | 'warning' | 'blocked', item: Omit<CreatorPreflightCheck, 'executionMode'> & { executionMode?: CreatorPreflightExecutionMode }, repair?: CreatorPreflightCheck['repair']) => void) {+ if (+ input.validateRuntimeAssets !== false+ && runtimeBackedExecutor(stage.executor)+ && input.ensureRuntimeReady !== undefined+ ) {+ try {+ await input.ensureRuntimeReady();+ } catch (error) {+ add('blocked', {+ id: 'krillin-runtime',+ title: 'KrillinAI Runtime 不可用',+ message: error instanceof Error ? error.message : 'KrillinAI Runtime 校验失败。',+ executionMode: 'local'+ }, { label: '打开运行组件设置', deepLink: '#/settings?tab=local-components' });+ return;+ }+ }if (input.validateRuntimeAssets !== false) {const requiredTools = new Map<string, string | undefined>();if (['download', 'clip', 'krillinai', 'stickman-media-validation'].includes(stage.executor)) requiredTools.set('ffmpeg', input.ffmpegPath);@@ -203,7 +222,9 @@ export function createCreatorPreflight(input: {}if (input.validateRuntimeAssets !== false && stage.executor === 'krillinai') {try {- preflightKrillinDependencies(input.resourceRoot, config);+ preflightKrillinDependencies(input.resourceRoot, config, {+ cachePath: input.runtimeVerificationCachePath+ });add('ready', { id: 'krillin-runtime', title: 'KrillinAI Runtime', message: '运行资源校验通过。', executionMode: 'local' });} catch (error) {add('blocked', {@@ -226,6 +247,19 @@ export function createCreatorPreflight(input: {}}+function runtimeBackedExecutor(executorId: string): boolean {+ return [+ 'krillinai',+ 'download',+ 'cover-analysis',+ 'clip',+ 'stickman-audio',+ 'stickman-remotion',+ 'stickman-media-validation',+ 'stickman-delivery'+ ].includes(executorId);+}+function checkProviderConfig(job: CreatorJob,stage: CreatorTemplateStage,diff --git a/apps/daemon/src/creator/presets/catalog.ts b/apps/daemon/src/creator/presets/catalog.tsindex 46e537b9..23506141 100644--- a/apps/daemon/src/creator/presets/catalog.ts+++ b/apps/daemon/src/creator/presets/catalog.ts@@ -2,12 +2,13 @@ import type {CreatorPresetRef,CreatorPresetSummary} from '@opencreator/protocol';+import { verifyFileIntegrityWithCache } from '@opencreator/config';import { existsSync } from 'node:fs';-import { readFile, stat } from 'node:fs/promises';+import { readFile } from 'node:fs/promises';import path from 'node:path';import { fileURLToPath } from 'node:url';import type { CreatorTemplateRegistry } from '../templates/types.js';-import { canonicalJson, sha256 } from './compiler.js';+import { canonicalJson, sha256 } from './hash.js';import { creatorPresetSourceManifestSchema } from './schema.js';import type {CompiledCreatorPreset,@@ -25,6 +26,7 @@ import {export async function loadCreatorPresetCatalog(input: {root?: string;templates: CreatorTemplateRegistry;+ verificationCachePath?: string;}): Promise<CreatorPresetRegistry> {const root = path.resolve(input.root ?? resolveCreatorPresetCatalogRoot());const catalogPath = path.join(root, 'catalog.json');@@ -45,11 +47,21 @@ export async function loadCreatorPresetCatalog(input: {throw new Error(`${manifestPath}: duplicate file ${file.path}`);}knownFiles.add(file.path);- const absolute = resolveCatalogFile(root, file.path);- const bytes = await readFile(absolute);- if (bytes.length !== file.size || sha256(bytes) !== file.sha256) {- throw new Error(`${absolute}: packaged creator preset resource hash mismatch`);- }+ }+ const verification = verifyFileIntegrityWithCache({+ cachePath: input.verificationCachePath,+ identity: root,+ fingerprint: sha256(manifestBytes),+ files: manifest.files.map(file => ({+ key: file.path,+ path: resolveCatalogFile(root, file.path),+ sha256: file.sha256,+ expectedSize: file.size+ }))+ });+ if (!verification.verified) {+ const absolute = resolveCatalogFile(root, verification.key);+ throw new Error(`${absolute}: packaged creator preset resource hash mismatch`);}if (!knownFiles.has('catalog.json')) {throw new Error(`${manifestPath}: catalog.json is missing from the file manifest`);diff --git a/apps/daemon/src/creator/presets/compiler.ts b/apps/daemon/src/creator/presets/compiler.tsindex 918f1583..c1247b5e 100644--- a/apps/daemon/src/creator/presets/compiler.ts+++ b/apps/daemon/src/creator/presets/compiler.ts@@ -1,4 +1,3 @@-import { createHash } from 'node:crypto';import {copyFile,mkdir,@@ -17,6 +16,7 @@ import sharp from 'sharp';import { ZodError } from 'zod';import { creatorPresetModuleDefinitions, getCreatorPresetModuleDefinition } from './module-schemas.js';import { creatorPresetSourceManifestSchema, validatePresetPublicFields } from './schema.js';+import { canonicalJson, sha256 } from './hash.js';import type {CompiledCreatorPreset,CreatorPresetBuildManifest,@@ -242,13 +242,7 @@ export async function compileCreatorPresets(}}-export function canonicalJson(value: unknown): string {- return JSON.stringify(sortJson(value));-}--export function sha256(value: string | Buffer): string {- return createHash('sha256').update(value).digest('hex');-}+export { canonicalJson, sha256 } from './hash.js';async function findTemplateManifests(sourceRoot: string): Promise<Array<{file: string;@@ -747,16 +741,6 @@ async function syncTree(root: string): Promise<void> {}}-function sortJson(value: unknown): unknown {- if (Array.isArray(value)) return value.map(sortJson);- if (value === null || typeof value !== 'object') return value;- return Object.fromEntries(- Object.entries(value as Record<string, unknown>)- .sort(([left], [right]) => left.localeCompare(right))- .map(([key, child]) => [key, sortJson(child)])- );-}-function detectedImageExtension(bytes: Buffer): '.png' | '.jpg' | '.webp' | undefined {if (bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) return '.png';if (bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff) return '.jpg';diff --git a/apps/daemon/src/creator/presets/hash.ts b/apps/daemon/src/creator/presets/hash.tsnew file mode 100644index 00000000..0a56ac3c--- /dev/null+++ b/apps/daemon/src/creator/presets/hash.ts@@ -0,0 +1,19 @@+import { createHash } from 'node:crypto';++export function canonicalJson(value: unknown): string {+ return JSON.stringify(sortJson(value));+}++export function sha256(value: string | Buffer): string {+ return createHash('sha256').update(value).digest('hex');+}++function sortJson(value: unknown): unknown {+ if (Array.isArray(value)) return value.map(sortJson);+ if (value === null || typeof value !== 'object') return value;+ return Object.fromEntries(+ Object.entries(value as Record<string, unknown>)+ .sort(([left], [right]) => left.localeCompare(right))+ .map(([key, child]) => [key, sortJson(child)])+ );+}diff --git a/apps/daemon/src/creator/project-cover.ts b/apps/daemon/src/creator/project-cover.tsindex f8b6c509..88bdaccf 100644--- a/apps/daemon/src/creator/project-cover.ts+++ b/apps/daemon/src/creator/project-cover.ts@@ -35,6 +35,7 @@ const videoArtifactKinds = [export function createCreatorProjectCoverService(input: {jobsRoot: string;ffmpegPath?: string;+ ensureRuntimeReady?(): Promise<void>;extractFrame?: FrameExtractor;}): CreatorProjectCoverService {const pending = new Map<string, Promise<CreatorProjectCover | undefined>>();@@ -55,6 +56,7 @@ export function createCreatorProjectCoverService(input: {const sourceVideo = latestArtifact(job.artifacts, videoArtifactKinds);if (sourceVideo?.path === null || sourceVideo === undefined || extractFrame === undefined) return undefined;if (!await isNonEmptyFile(sourceVideo.path)) return undefined;+ await input.ensureRuntimeReady?.();const cacheKey = `${job.id}:${sourceVideo.id}`;const existing = pending.get(cacheKey);diff --git a/apps/daemon/src/creator/stickman/content-executor.ts b/apps/daemon/src/creator/stickman/content-executor.tsindex ab08573a..f1bcfeae 100644--- a/apps/daemon/src/creator/stickman/content-executor.ts+++ b/apps/daemon/src/creator/stickman/content-executor.ts@@ -1,6 +1,5 @@import { readFile, rename, writeFile } from 'node:fs/promises';import { extname, join } from 'node:path';-import sharp from 'sharp';import { z } from 'zod';import type { CreatorServicesConfigStore } from '../../creator-services/config-store.js';import type { CreatorArtifact, CreatorJson } from '@opencreator/protocol';@@ -27,6 +26,7 @@ import {type ResolvedVisualAssetFile,type StickmanVisualAssetRegistry} from './visual-assets.js';+import { loadSharp } from './sharp-loader.js';type CompleteJson = (input: {stageId: string;@@ -663,6 +663,7 @@ async function styleAssets();}const content = await readFile(primaryCharacter.path);+ const sharp = await loadSharp();const dimensions = await sharp(content).metadata();if (!dimensions.width || !dimensions.height) {throw new CreatorExecutorError(diff --git a/apps/daemon/src/creator/stickman/delivery-executor.ts b/apps/daemon/src/creator/stickman/delivery-executor.tsindex 97d83d7d..d39f9d19 100644--- a/apps/daemon/src/creator/stickman/delivery-executor.ts+++ b/apps/daemon/src/creator/stickman/delivery-executor.ts@@ -12,7 +12,6 @@ import {writeFile} from 'node:fs/promises';import { dirname, isAbsolute, join, relative, resolve } from 'node:path';-import sharp from 'sharp';import type { CreatorArtifact } from '@opencreator/protocol';import type { CreatorExecutor, CreatorExecutorOutput } from '../executor.js';import { CreatorExecutorError } from '../executor.js';@@ -25,6 +24,7 @@ import {stickmanTimelineSchema,stickmanVisualValidationSchema} from './contracts.js';+import { loadSharp } from './sharp-loader.js';const deliveryFiles = [{ kind: 'clean_video', name: 'stickman-video.mp4', mime: 'video/mp4' },@@ -358,6 +358,7 @@ async function sampleFramesWithFfmpeg(input: {input.duration / 2,Math.max(0, input.duration - Math.min(0.2, input.duration / 4))];+ const sharp = await loadSharp();for (const [index, timestamp] of timestamps.entries()) {const target = join(input.workdir, `frame-${index + 1}.png`);await execFileAsync(input.ffmpegPath, [diff --git a/apps/daemon/src/creator/stickman/image-executor.ts b/apps/daemon/src/creator/stickman/image-executor.tsindex aa037df3..21a6bb22 100644--- a/apps/daemon/src/creator/stickman/image-executor.ts+++ b/apps/daemon/src/creator/stickman/image-executor.ts@@ -3,7 +3,7 @@ import { execFile } from 'node:child_process';import { createHash } from 'node:crypto';import { copyFile, readFile } from 'node:fs/promises';import { join } from 'node:path';-import sharp from 'sharp';+import type { Metadata, Stats } from 'sharp';import type { CreatorServicesConfigStore } from '../../creator-services/config-store.js';import {generateImageContents,@@ -24,6 +24,7 @@ import {shouldUsePreviousShotReference} from './image-prompt.js';import { previousStickmanShotImage } from './lineage.js';+import { loadSharp } from './sharp-loader.js';import {DEFAULT_STICKMAN_CHARACTER_ASSET,DEFAULT_STICKMAN_STYLE_ASSET,@@ -318,6 +319,7 @@ export function createStickmanImageExecutor(input: {}const extension = image.mime === 'image/jpeg' ? 'jpg' : image.mime === 'image/webp' ? 'webp' : 'png';const candidatePath = join(stage.workdir, `${scopeKey}-candidate-${candidateAttempt}.${extension}`);+ const sharp = await loadSharp();await sharp(image.content).resize(1280, 720, { fit: 'cover', position: 'centre' }).toFile(candidatePath);@@ -410,9 +412,10 @@ async function inspectStickmanImageCandidate(path: string,tesseractPath?: string): Promise<StickmanImageCandidateQuality> {- let metadata: Awaited<ReturnType<typeof sharp.prototype.metadata>>;- let stats: Awaited<ReturnType<typeof sharp.prototype.stats>>;+ let metadata: Metadata;+ let stats: Stats;try {+ const sharp = await loadSharp();[metadata, stats] = await Promise.all([sharp(path).metadata(),sharp(path).greyscale().stats()diff --git a/apps/daemon/src/creator/stickman/media-validation-executor.ts b/apps/daemon/src/creator/stickman/media-validation-executor.tsindex a6bc00b4..70a8ffee 100644--- a/apps/daemon/src/creator/stickman/media-validation-executor.ts+++ b/apps/daemon/src/creator/stickman/media-validation-executor.ts@@ -3,12 +3,12 @@ import { execFile } from 'node:child_process';import { createReadStream } from 'node:fs';import { mkdir, readFile, writeFile } from 'node:fs/promises';import { dirname, isAbsolute, join, relative, resolve } from 'node:path';-import sharp from 'sharp';import type { CreatorArtifact } from '@opencreator/protocol';import type { CreatorExecutor } from '../executor.js';import { CreatorExecutorError } from '../executor.js';import { validateMediaFile } from '../validators/media.js';import { stickmanMediaValidationSchema, stickmanTimelineSchema } from './contracts.js';+import { loadSharp } from './sharp-loader.js';type MediaProbe = typeof validateMediaFile;type FrameSample = {@@ -140,6 +140,7 @@ async function sampleVideoFrames(Math.max(0, duration - Math.min(0.2, duration / 4))];const result: FrameSample[] = [];+ const sharp = await loadSharp();for (const [position, timestampSeconds] of timestamps.entries()) {const path = join(workdir, `frame-${position + 1}.png`);await execFileAsync(ffmpegPath, [diff --git a/apps/daemon/src/creator/stickman/sharp-loader.ts b/apps/daemon/src/creator/stickman/sharp-loader.tsnew file mode 100644index 00000000..753774e5--- /dev/null+++ b/apps/daemon/src/creator/stickman/sharp-loader.ts@@ -0,0 +1,8 @@+import type sharp from 'sharp';++let loading: Promise<typeof sharp> | undefined;++export async function loadSharp(): Promise<typeof sharp> {+ loading ??= import('sharp').then(module => module.default);+ return await loading;+}diff --git a/apps/daemon/src/creator/stickman/validation-executor.ts b/apps/daemon/src/creator/stickman/validation-executor.tsindex 0677e26a..9243fb2a 100644--- a/apps/daemon/src/creator/stickman/validation-executor.ts+++ b/apps/daemon/src/creator/stickman/validation-executor.ts@@ -2,10 +2,10 @@ import { createHash } from 'node:crypto';import { execFile } from 'node:child_process';import { readFile, writeFile } from 'node:fs/promises';import { join } from 'node:path';-import sharp from 'sharp';import type { CreatorExecutor } from '../executor.js';import { CreatorExecutorError } from '../executor.js';import { stickmanShotSpecSchema, stickmanVisualValidationSchema } from './contracts.js';+import { loadSharp } from './sharp-loader.js';type OcrResult = {available: boolean;@@ -34,6 +34,7 @@ export function createStickmanValidationExecutor(input: {));const rows = [];const hashes = new Set<string>();+ const sharp = await loadSharp();for (const shot of value.shots) {const candidates = images.filter(image => image.scopeKey === shot.id);if (candidates.length !== 1) {diff --git a/apps/daemon/src/creator/yt-dlp/update-manager.ts b/apps/daemon/src/creator/yt-dlp/update-manager.tsindex 96300415..5e70210c 100644--- a/apps/daemon/src/creator/yt-dlp/update-manager.ts+++ b/apps/daemon/src/creator/yt-dlp/update-manager.ts@@ -63,6 +63,7 @@ export type YtDlpUpdateManager = {status(): CreatorYtDlpStatus;check(input?: { force?: boolean }): Promise<CreatorYtDlpStatus>;update(): Promise<CreatorYtDlpStatus>;+ close(): void;};export class YtDlpUpdateError extends Error {@@ -104,6 +105,7 @@ class DefaultYtDlpUpdateManager implements YtDlpUpdateManager {private readonly versionsRoot: string;private readonly now: () => Date;private readonly checkIntervalMs: number;+ private readonly lifecycleController = new AbortController();private state: UpdateState = { version: 1 };private activeRuntime: YtDlpRuntime | undefined;private checkPending: Promise<CreatorYtDlpStatus> | undefined;@@ -184,6 +186,10 @@ class DefaultYtDlpUpdateManager implements YtDlpUpdateManager {return this.updatePending;}+ close(): void {+ this.lifecycleController.abort();+ }+private async performCheck(): Promise<CreatorYtDlpStatus> {const attemptedAt = this.now().toISOString();try {@@ -293,6 +299,7 @@ class DefaultYtDlpUpdateManager implements YtDlpUpdateManager {proxy: await this.input.readProxy(),timeoutMs: CHECK_TIMEOUT_MS,maxBytes: MAX_RELEASE_RESPONSE_BYTES,+ signal: this.lifecycleController.signal,fetchImpl: this.input.fetchImpl,headers: {Accept: 'application/vnd.github+json',@@ -314,6 +321,7 @@ class DefaultYtDlpUpdateManager implements YtDlpUpdateManager {proxy: await this.input.readProxy(),timeoutMs: DOWNLOAD_TIMEOUT_MS,maxBytes: MAX_YT_DLP_BYTES,+ signal: this.lifecycleController.signal,fetchImpl: this.input.fetchImpl,headers: {Accept: 'application/octet-stream',@@ -417,11 +425,15 @@ async function fetchWithLimit(input: {proxy: string;timeoutMs: number;maxBytes: number;+ signal: AbortSignal;headers: Record<string, string>;fetchImpl?: typeof fetch;}): Promise<{ ok: boolean; status: number; body: Buffer }> {let endpoint = new URL(input.url);- const signal = AbortSignal.timeout(input.timeoutMs);+ const signal = AbortSignal.any([+ input.signal,+ AbortSignal.timeout(input.timeoutMs)+ ]);for (let redirectCount = 0; ; redirectCount += 1) {const response = await fetchCreatorService({endpoint,diff --git a/apps/daemon/src/main.ts b/apps/daemon/src/main.tsindex 5c7b4d28..9da71f17 100644--- a/apps/daemon/src/main.ts+++ b/apps/daemon/src/main.ts@@ -13,6 +13,7 @@ import {collectCodexCapabilityMatrixAsync,collectStartupCapabilityMatrixAsync,probeCodexVersionAsync,+ resolveBundledCodexStartupSnapshot,withRuntimeSkillCapabilities,type RuntimeCapabilityMatrix} from './codex/capabilities.js';@@ -23,7 +24,10 @@ import {probeCodex} from './codex/probe.js';import { createRuntimeToken } from './security/token.js';-import { installGracefulShutdown } from './shutdown.js';+import {+ installGracefulShutdown,+ installParentPortShutdown+} from './shutdown.js';import {createProductionServerInput,parseRuntimeChannel,@@ -101,10 +105,20 @@ async function main(): Promise<void> {}});- const versionProbe = await probeCodexVersionAsync({- codexBin,- timeoutMs: 3_000+ const bundledStartup = resolveBundledCodexStartupSnapshot({+ mode: process.env.OPENCREATOR_CODEX_RUNTIME_MODE,+ version: process.env.OPENCREATOR_CODEX_VERSION,+ commit: process.env.OPENCREATOR_CODEX_COMMIT});+ const versionProbe = bundledStartup === undefined+ ? await probeCodexVersionAsync({+ codexBin,+ timeoutMs: 3_000+ })+ : {+ ready: true,+ version: bundledStartup.version+ };if (!versionProbe.ready) {emitBootstrapError({code: 'CODEX_VERSION_CHECK_FAILED',@@ -129,11 +143,16 @@ async function main(): Promise<void> {};emitBootstrap('starting_runtime');- const capabilityResolution = await resolveCapabilities(- codexBin,- dataDir,- versionProbe.version- );+ const capabilityResolution = bundledStartup === undefined+ ? await resolveCapabilities(+ codexBin,+ dataDir,+ versionProbe.version+ )+ : {+ state: bundledStartup.capabilities,+ startBackgroundRefresh() {}+ };const capabilities = capabilityResolution.state;const { buildServer } = await import('./api/server.js');server = await buildServer(createProductionServerInput({@@ -170,7 +189,13 @@ async function main(): Promise<void> {process.exitCode = 1;}});- installParentPortShutdown();+ installParentPortShutdown({+ close: closeServer,+ exit: code => process.exit(code),+ onError(error) {+ console.error(`Failed to close daemon after parent request: ${String(error)}`);+ }+ });emitParentMessage({type: 'opencreator_daemon_ready',address,@@ -214,24 +239,6 @@ async function closeServer(): Promise<void> {releaseRuntimeLock?.();}-function installParentPortShutdown(): void {- const parentPort = (- process as NodeJS.Process & {- parentPort?: {- on(event: 'message', listener: (event: { data?: unknown } | unknown) => void): void;- };- }- ).parentPort;- parentPort?.on('message', event => {- const payload = isRecord(event) && 'data' in event ? event.data : event;- if (!isRecord(payload) || payload.type !== 'shutdown') return;- void closeServer().catch(error => {- console.error(`Failed to close daemon after parent request: ${String(error)}`);- process.exitCode = 1;- });- });-}-async function resolveCapabilities(codexBin: string,dataDir: string,diff --git a/apps/daemon/src/shutdown.ts b/apps/daemon/src/shutdown.tsindex 763e1a70..9c8f3108 100644--- a/apps/daemon/src/shutdown.ts+++ b/apps/daemon/src/shutdown.ts@@ -5,6 +5,10 @@ type SignalSource = {off(signal: ShutdownSignal, listener: () => void): unknown;};+type ParentPortSource = {+ on(event: 'message', listener: (event: unknown) => void): unknown;+};+export function installGracefulShutdown(input: {close(): Promise<void>;onError(error: unknown): void;@@ -32,3 +36,32 @@ export function installGracefulShutdown(input: {signalSource.off('SIGTERM', close);};}++export function installParentPortShutdown(input: {+ close(): Promise<void>;+ exit(code: number): void;+ onError(error: unknown): void;+ parentPort?: ParentPortSource;+}): void {+ const parentPort = input.parentPort ?? (+ process as NodeJS.Process & { parentPort?: ParentPortSource }+ ).parentPort;+ let closeWork: Promise<void> | undefined;+ parentPort?.on('message', event => {+ const payload = isRecord(event) && 'data' in event ? event.data : event;+ if (!isRecord(payload) || payload.type !== 'shutdown' || closeWork !== undefined) {+ return;+ }+ closeWork = input.close().then(+ () => input.exit(0),+ error => {+ input.onError(error);+ input.exit(1);+ }+ );+ });+}++function isRecord(value: unknown): value is Record<string, unknown> {+ return typeof value === 'object' && value !== null && !Array.isArray(value);+}diff --git a/apps/daemon/test/unit/codex-app-server-client-shutdown.test.ts b/apps/daemon/test/unit/codex-app-server-client-shutdown.test.tsindex cdd347e2..1afd63b6 100644--- a/apps/daemon/test/unit/codex-app-server-client-shutdown.test.ts+++ b/apps/daemon/test/unit/codex-app-server-client-shutdown.test.ts@@ -59,7 +59,7 @@ describe('Codex app-server shutdown with inherited pipes', () => {let restarted = false;const restart = client.restart().then(() => { restarted = true; });- await vi.advanceTimersByTimeAsync(5000);+ await vi.advanceTimersByTimeAsync(0);expect(restarted).toBe(true);await restart;@@ -68,7 +68,7 @@ describe('Codex app-server shutdown with inherited pipes', () => {expect(oldChild.stderr.destroyed).toBe(true);await expect(client.request('config/read', {})).resolves.toEqual({ pid: 102 });const close = client.close();- await vi.advanceTimersByTimeAsync(5000);+ await vi.advanceTimersByTimeAsync(0);await close;expect(vi.getTimerCount()).toBe(0);});diff --git a/apps/daemon/test/unit/codex-capabilities.test.ts b/apps/daemon/test/unit/codex-capabilities.test.tsindex 3f580ac0..bbcfe110 100644--- a/apps/daemon/test/unit/codex-capabilities.test.ts+++ b/apps/daemon/test/unit/codex-capabilities.test.ts@@ -2,13 +2,16 @@ import { describe, expect, it } from 'vitest';import { execPath } from 'node:process';import {applyCapabilityMatrix,+ BUNDLED_CODEX_COMMIT,+ BUNDLED_CODEX_VERSION,collectCodexCapabilityMatrix,createUnknownCapabilityMatrix,isResumeExecutionSupported,normalizeCodexVersionOutput,parseCodexCapabilityMatrix,parseCodexExecHelp,- probeCodexVersionAsync+ probeCodexVersionAsync,+ resolveBundledCodexStartupSnapshot} from '../../src/codex/capabilities.js';const EXEC_HELP_01425 = `@@ -64,6 +67,39 @@ Commands:`;describe('codex capability parsing', () => {+ it('uses the verified bundled runtime snapshot without launching Codex', () => {+ const snapshot = resolveBundledCodexStartupSnapshot({+ mode: 'bundled',+ version: BUNDLED_CODEX_VERSION,+ commit: BUNDLED_CODEX_COMMIT,+ checkedAt: '2026-09-21T00:00:00.000Z'+ });++ expect(snapshot).toMatchObject({+ version: 'codex-cli 0.149.0',+ capabilities: {+ codexVersion: 'codex-cli 0.149.0',+ checkedAt: '2026-09-21T00:00:00.000Z',+ execJson: true,+ resumeJson: true,+ appServer: true,+ appServerApprovals: true,+ mcpList: true,+ warnings: []+ }+ });+ expect(resolveBundledCodexStartupSnapshot({+ mode: 'external',+ version: BUNDLED_CODEX_VERSION,+ commit: BUNDLED_CODEX_COMMIT+ })).toBeUndefined();+ expect(resolveBundledCodexStartupSnapshot({+ mode: 'bundled',+ version: BUNDLED_CODEX_VERSION,+ commit: 'different-commit'+ })).toBeUndefined();+ });+it('extracts the Codex version line when startup warnings are present', () => {expect(normalizeCodexVersionOutput(['WARNING: CODEX_HOME does not exist',diff --git a/apps/daemon/test/unit/creator-krillin-manifest.test.ts b/apps/daemon/test/unit/creator-krillin-manifest.test.tsnew file mode 100644index 00000000..5a935d6b--- /dev/null+++ b/apps/daemon/test/unit/creator-krillin-manifest.test.ts@@ -0,0 +1,61 @@+import { createHash } from 'node:crypto';+import {+ mkdirSync,+ mkdtempSync,+ readFileSync,+ rmSync,+ writeFileSync+} from 'node:fs';+import { tmpdir } from 'node:os';+import { dirname, join } from 'node:path';+import { afterEach, describe, expect, it } from 'vitest';+import {+ readKrillinRuntimeManifest,+ verifyKrillinRuntimeManifest+} from '../../src/creator/krillin/manifest.js';++let tempDir = '';++afterEach(() => {+ if (tempDir) rmSync(tempDir, { recursive: true, force: true });+ tempDir = '';+});++describe('Krillin Runtime 清单校验', () => {+ it('缓存完整校验结果,并在资源变化时拒绝缓存', () => {+ const fixture = createFixture();+ const manifest = readKrillinRuntimeManifest(fixture.root);++ expect(verifyKrillinRuntimeManifest(fixture.root, manifest, {+ cachePath: fixture.cachePath+ })).toEqual({ cacheHit: false });+ expect(verifyKrillinRuntimeManifest(fixture.root, manifest, {+ cachePath: fixture.cachePath+ })).toEqual({ cacheHit: true });++ writeFileSync(fixture.executable, 'tampered-runtime');+ expect(() => verifyKrillinRuntimeManifest(fixture.root, manifest, {+ cachePath: fixture.cachePath+ })).toThrow('dependency_hash_mismatch: bin/krillinai-cli');+ });+});++function createFixture() {+ tempDir = mkdtempSync(join(tmpdir(), 'opencreator-krillin-manifest-'));+ const root = join(tempDir, 'runtime');+ const executable = join(root, 'bin', 'krillinai-cli');+ const cachePath = join(tempDir, 'cache', 'krillinai.json');+ mkdirSync(dirname(executable), { recursive: true });+ writeFileSync(executable, 'packaged-runtime');+ writeFileSync(join(root, 'manifest.json'), JSON.stringify({+ version: 1,+ platform: process.platform,+ arch: process.arch,+ resources: [{+ path: 'bin/krillinai-cli',+ kind: 'executable',+ sha256: createHash('sha256').update(readFileSync(executable)).digest('hex')+ }]+ }));+ return { root, executable, cachePath };+}diff --git a/apps/daemon/test/unit/creator-preflight.test.ts b/apps/daemon/test/unit/creator-preflight.test.tsindex b3c10a5f..1c1f29e4 100644--- a/apps/daemon/test/unit/creator-preflight.test.ts+++ b/apps/daemon/test/unit/creator-preflight.test.ts@@ -1,7 +1,7 @@import { mkdtemp, rm, writeFile } from 'node:fs/promises';import { tmpdir } from 'node:os';import { join } from 'node:path';-import { afterEach, describe, expect, it } from 'vitest';+import { afterEach, describe, expect, it, vi } from 'vitest';import { createDefaultCreatorServicesConfig, type CreatorJob, type CreatorJson } from '@opencreator/protocol';import { createCreatorPreflight } from '../../src/creator/preflight.js';import { createImageGenerationTemplate } from '../../src/creator/templates/image-generation.js';@@ -58,6 +58,36 @@ describe('creator preflight', () => {expect(result.blocked.every(item => item.repair.label.length > 0)).toBe(true);});+ it('waits for Runtime verification before checking Runtime-backed stages', async () => {+ root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));+ const stage = createVideoDownloadTemplate().stages[0]!;+ let releaseVerification!: () => void;+ const ensureRuntimeReady = vi.fn(() => new Promise<void>(resolve => {+ releaseVerification = resolve;+ }));+ let settled = false;+ const checking = createCreatorPreflight({+ configStore: { read: async () => createDefaultCreatorServicesConfig() },+ readCapabilities: () => createKrillinCreatorServicesCapabilities('win32', 'x64'),+ resourceRoot: join(root, 'runtime'),+ jobsRoot: join(root, 'jobs'),+ executorIds: ['download'],+ validateRuntimeAssets: true,+ ensureRuntimeReady+ }).check(fakeJob('video-download', { sourceUrl: 'https://youtu.be/example' }), stage)+ .then(result => {+ settled = true;+ return result;+ });++ await vi.waitFor(() => expect(ensureRuntimeReady).toHaveBeenCalledOnce());+ expect(settled).toBe(false);+ releaseVerification();+ const result = await checking;++ expect(result.blocked.map(item => item.id)).toEqual(expect.arrayContaining(['ffmpeg', 'ffprobe', 'yt-dlp']));+ });+it('blocks a reference image when the configured provider cannot edit images', async () => {root = await mkdtemp(join(tmpdir(), 'creator-preflight-'));const referencePath = join(root, 'reference.png');diff --git a/apps/daemon/test/unit/creator-project-cover.test.ts b/apps/daemon/test/unit/creator-project-cover.test.tsindex c744327c..072054ab 100644--- a/apps/daemon/test/unit/creator-project-cover.test.ts+++ b/apps/daemon/test/unit/creator-project-cover.test.ts@@ -100,6 +100,33 @@ describe('creator project cover', () => {}));});+ it('waits for Runtime verification before extracting a video frame', async () => {+ tempDir = mkdtempSync(join(tmpdir(), 'creator-project-cover-verification-'));+ const sourcePath = join(tempDir, 'source.mp4');+ writeFileSync(sourcePath, 'video');+ let releaseVerification!: () => void;+ const ensureRuntimeReady = vi.fn(() => new Promise<void>(resolve => {+ releaseVerification = resolve;+ }));+ const extractFrame = vi.fn(async (input: { outputPath: string }) => {+ await writeFile(input.outputPath, 'verified-frame');+ });+ const service = createCreatorProjectCoverService({+ jobsRoot: tempDir,+ ensureRuntimeReady,+ extractFrame+ });+ const resolving = service.resolve(creatorJob([artifact('source_video', sourcePath)]));++ await vi.waitFor(() => expect(ensureRuntimeReady).toHaveBeenCalledOnce());+ expect(extractFrame).not.toHaveBeenCalled();+ releaseVerification();+ const cover = await resolving;++ expect(extractFrame).toHaveBeenCalledOnce();+ expect(await readFile(cover!.path, 'utf8')).toBe('verified-frame');+ });+it('extracts a project cover from generated video artifacts', async () => {tempDir = mkdtempSync(join(tmpdir(), 'creator-project-generated-video-'));const sourcePath = join(tempDir, 'generated.mp4');diff --git a/apps/daemon/test/unit/creator-runtime-routes.test.ts b/apps/daemon/test/unit/creator-runtime-routes.test.tsindex 0faa7f01..996ace22 100644--- a/apps/daemon/test/unit/creator-runtime-routes.test.ts+++ b/apps/daemon/test/unit/creator-runtime-routes.test.ts@@ -110,6 +110,17 @@ describe('creator yt-dlp runtime routes', () => {error: { code: 'creator_yt_dlp_update_unavailable' }});});++ it('closes the update manager before waiting for active requests', async () => {+ const manager = managerFixture();+ server = Fastify();+ await registerCreatorRuntimeRoutes(server, manager);++ await server.close();+ server = undefined;++ expect(manager.close).toHaveBeenCalledOnce();+ });});function managerFixture(@@ -125,6 +136,7 @@ function managerFixture(status: vi.fn(() => status()),check: vi.fn(async () => status()),update: vi.fn(async () => status()),+ close: vi.fn(),...patch};}diff --git a/apps/daemon/test/unit/creator-yt-dlp-update-manager.test.ts b/apps/daemon/test/unit/creator-yt-dlp-update-manager.test.tsindex dcda980a..c5925f5e 100644--- a/apps/daemon/test/unit/creator-yt-dlp-update-manager.test.ts+++ b/apps/daemon/test/unit/creator-yt-dlp-update-manager.test.ts@@ -189,6 +189,48 @@ describe('yt-dlp update manager', () => {});expect(restored.getRuntime()).toBe(bundledRuntime);});++ it('aborts an in-flight release check when the manager closes', async () => {+ root = await mkdtemp(join(tmpdir(), 'creator-yt-dlp-update-'));+ const bundledRuntime = await createBundledRuntime(root);+ let observedSignal: AbortSignal | undefined;+ let markFetchStarted!: () => void;+ const fetchStarted = new Promise<void>(resolve => {+ markFetchStarted = resolve;+ });+ const fetchImpl = vi.fn((+ _input: string | URL | Request,+ init?: RequestInit+ ) => new Promise<Response>((_resolve, reject) => {+ const signal = init?.signal;+ if (signal === undefined || signal === null) {+ reject(new Error('expected an abort signal'));+ return;+ }+ observedSignal = signal;+ markFetchStarted();+ signal.addEventListener('abort', () => reject(signal.reason), {+ once: true+ });+ })) as unknown as typeof fetch;+ const manager = await createManager(+ join(root, 'updates'),+ bundledRuntime,+ fetchImpl+ );+ const result = manager.check({ force: true }).then(+ () => undefined,+ (error: unknown) => error+ );+ await fetchStarted;++ manager.close();++ expect(observedSignal?.aborted).toBe(true);+ await expect(result).resolves.toMatchObject({+ code: 'creator_yt_dlp_update_check_failed'+ });+ });});async function createBundledRuntime(base: string): Promise<YtDlpRuntime> {diff --git a/apps/daemon/test/unit/krillin-runtime-verifier.test.ts b/apps/daemon/test/unit/krillin-runtime-verifier.test.tsnew file mode 100644index 00000000..1d7c9641--- /dev/null+++ b/apps/daemon/test/unit/krillin-runtime-verifier.test.ts@@ -0,0 +1,69 @@+import { createHash } from 'node:crypto';+import {+ existsSync,+ mkdirSync,+ mkdtempSync,+ rmSync,+ writeFileSync+} from 'node:fs';+import { tmpdir } from 'node:os';+import { dirname, join } from 'node:path';+import { afterEach, describe, expect, it } from 'vitest';+import { startKrillinRuntimeVerification } from '../../src/creator/krillin/runtime-verifier.js';++let tempDir = '';++afterEach(() => {+ if (tempDir) rmSync(tempDir, { recursive: true, force: true });+ tempDir = '';+});++describe('Krillin Runtime 后台校验', () => {+ it('异步完成完整校验并复用生成的缓存', async () => {+ const fixture = createFixture();++ const first = startKrillinRuntimeVerification({+ resourceRoot: fixture.root,+ cachePath: fixture.cachePath+ });++ expect(existsSync(fixture.cachePath)).toBe(false);+ await expect(first).resolves.toEqual({ cacheHit: false });+ expect(existsSync(fixture.cachePath)).toBe(true);+ await expect(startKrillinRuntimeVerification({+ resourceRoot: fixture.root,+ cachePath: fixture.cachePath+ })).resolves.toEqual({ cacheHit: true });+ });++ it('资源损坏时拒绝就绪 Promise', async () => {+ const fixture = createFixture();+ writeFileSync(fixture.executable, 'tampered-runtime');++ await expect(startKrillinRuntimeVerification({+ resourceRoot: fixture.root,+ cachePath: fixture.cachePath+ })).rejects.toThrow('dependency_hash_mismatch: bin/krillinai-cli');+ expect(existsSync(fixture.cachePath)).toBe(false);+ });+});++function createFixture() {+ tempDir = mkdtempSync(join(tmpdir(), 'opencreator-runtime-verifier-'));+ const root = join(tempDir, 'runtime');+ const executable = join(root, 'bin', 'krillinai-cli');+ const cachePath = join(tempDir, 'cache', 'krillinai.json');+ mkdirSync(dirname(executable), { recursive: true });+ writeFileSync(executable, 'packaged-runtime');+ writeFileSync(join(root, 'manifest.json'), JSON.stringify({+ version: 1,+ platform: process.platform,+ arch: process.arch,+ resources: [{+ path: 'bin/krillinai-cli',+ kind: 'executable',+ sha256: createHash('sha256').update('packaged-runtime').digest('hex')+ }]+ }));+ return { root, executable, cachePath };+}diff --git a/apps/daemon/test/unit/krillin-tts-service.test.ts b/apps/daemon/test/unit/krillin-tts-service.test.tsindex 7481bf02..61e9e527 100644--- a/apps/daemon/test/unit/krillin-tts-service.test.ts+++ b/apps/daemon/test/unit/krillin-tts-service.test.ts@@ -155,6 +155,32 @@ describe('KrillinTtsService', () => {expect(executeUtility).toHaveBeenCalledOnce();});+ it('waits for Runtime verification before invoking the Runtime utility', async () => {+ const root = await temporaryRoot();+ const config = createDefaultCreatorServicesConfig();+ config.tts.aliyun.model = 'custom-tts-model';+ let releaseVerification!: () => void;+ const ensureRuntimeReady = vi.fn(() => new Promise<void>(resolve => {+ releaseVerification = resolve;+ }));+ const executeUtility = vi.fn(async () => ({ ok: true, voices: [] }));+ const service = createKrillinTtsService({+ resourceRoot: join(root, 'runtime'),+ workRoot: join(root, 'work'),+ configStore: createConfigStore(config),+ ensureRuntimeReady,+ executeUtility+ });+ const listing = service.listVoices('aliyun');++ await vi.waitFor(() => expect(ensureRuntimeReady).toHaveBeenCalledOnce());+ expect(executeUtility).not.toHaveBeenCalled();+ releaseVerification();+ await listing;++ expect(executeUtility).toHaveBeenCalledOnce();+ });+it('synthesizes through the configured provider with voice controls', async () => {const root = await temporaryRoot();const config = createDefaultCreatorServicesConfig();diff --git a/apps/daemon/test/unit/shutdown.test.ts b/apps/daemon/test/unit/shutdown.test.tsindex 6f099202..9161cbf6 100644--- a/apps/daemon/test/unit/shutdown.test.ts+++ b/apps/daemon/test/unit/shutdown.test.ts@@ -1,6 +1,9 @@import { EventEmitter } from 'node:events';import { describe, expect, it, vi } from 'vitest';-import { installGracefulShutdown } from '../../src/shutdown.js';+import {+ installGracefulShutdown,+ installParentPortShutdown+} from '../../src/shutdown.js';describe('graceful shutdown', () => {it('shares one server close across repeated shutdown signals', async () => {@@ -46,3 +49,47 @@ describe('graceful shutdown', () => {await expect.poll(() => onError).toHaveBeenCalledWith(error);});});++describe('parent port shutdown', () => {+ it('closes once and exits only after cleanup completes', async () => {+ const parentPort = new EventEmitter();+ let releaseClose!: () => void;+ const closeBlocked = new Promise<void>(resolve => {+ releaseClose = resolve;+ });+ const close = vi.fn(() => closeBlocked);+ const exit = vi.fn();++ installParentPortShutdown({ close, exit, onError: vi.fn(), parentPort });++ parentPort.emit('message', { data: { type: 'ignored' } });+ parentPort.emit('message', { data: { type: 'shutdown' } });+ parentPort.emit('message', { type: 'shutdown' });++ expect(close).toHaveBeenCalledTimes(1);+ expect(exit).not.toHaveBeenCalled();++ releaseClose();+ await expect.poll(() => exit).toHaveBeenCalledWith(0);+ });++ it('reports cleanup failures and exits with a failure code', async () => {+ const parentPort = new EventEmitter();+ const error = new Error('close failed');+ const onError = vi.fn();+ const exit = vi.fn();++ installParentPortShutdown({+ close: async () => {+ throw error;+ },+ exit,+ onError,+ parentPort+ });+ parentPort.emit('message', { type: 'shutdown' });++ await expect.poll(() => onError).toHaveBeenCalledWith(error);+ expect(exit).toHaveBeenCalledWith(1);+ });+});diff --git a/apps/desktop/e2e/creator-packaged-app.spec.ts b/apps/desktop/e2e/creator-packaged-app.spec.tsindex e392a245..889d10e5 100644--- a/apps/desktop/e2e/creator-packaged-app.spec.ts+++ b/apps/desktop/e2e/creator-packaged-app.spec.ts@@ -123,7 +123,10 @@ test('打包 App 的每个设置 Tab 与主页面保持相同右侧留白', asyn};});expect(bounds.left, `Tab ${index + 1}`).toBe(24);- expect(bounds.right - bounds.gutter, `Tab ${index + 1}`).toBe(24);+ expect(+ Math.abs(bounds.right - bounds.gutter - 24),+ `Tab ${index + 1}`+ ).toBeLessThanOrEqual(1);boundsByTab.push(bounds);if (index < 2) {await fixture.app.page.screenshot({@@ -424,12 +427,12 @@ test('打包 App 在最小窗口宽度下保持 Creator 对话输入区贴底',width: window.innerWidth,panelRightOfMain: panel.left >= main.right - 1,panelVisible: panel.right <= window.innerWidth + 1,- panelBottomDelta: Math.round(panel.bottom - window.innerHeight),+ panelBottomDelta: Math.round(Math.abs(panel.bottom - window.innerHeight)),panelHeightDelta: Math.round(panel.height - workspace.height),- composerBottomDelta: Math.round(+ composerBottomDelta: Math.round(Math.abs(composer.getBoundingClientRect().bottom+ parseFloat(getComputedStyle(composer).marginBottom) - panel.bottom- )+ ))};})).toEqual({ width: 980, panelRightOfMain: true, panelVisible: true, panelBottomDelta: 0, panelHeightDelta: 0, composerBottomDelta: 0 });await fixture.app.page.screenshot({diff --git a/apps/desktop/e2e/desktop.spec.ts b/apps/desktop/e2e/desktop.spec.tsindex 721e5ae8..a89ff9d1 100644--- a/apps/desktop/e2e/desktop.spec.ts+++ b/apps/desktop/e2e/desktop.spec.ts@@ -1028,6 +1028,29 @@ test('@package-smoke 退出期间会回收仍在 Probe 中的 Codex 子进程',}});+test('@package-smoke 启动 Codex app-server 后在 3 秒内退出', async () => {+ const fixture = await launchPackagedDesktop('success');+ try {+ await waitForWorkspace(fixture.page);+ const models = await runtimeRequest<{ models: unknown[] }>(+ fixture.page,+ 'GET',+ '/codex/models'+ );+ expect(models.status).toBe(200);++ const startedAt = Date.now();+ await fixture.page.evaluate(() => {+ void window.opencreatorDesktop?.quit();+ });++ expect(await waitForProcessExit(fixture.process, 3_000)).toBe(true);+ expect(Date.now() - startedAt).toBeLessThan(3_000);+ } finally {+ await closeFixture(fixture);+ }+});+type DesktopFixture = PackagedApp & {root: string;stateDir: string;diff --git a/apps/desktop/electron-builder.yml b/apps/desktop/electron-builder.ymlindex d0c556c6..545c822e 100644--- a/apps/desktop/electron-builder.yml+++ b/apps/desktop/electron-builder.yml@@ -91,7 +91,7 @@ dmg:win:target:- nsis- icon: resources/icon.png+ icon: resources/icon-win.pngnsis:oneClick: falseallowToChangeInstallationDirectory: truediff --git a/apps/desktop/resources/icon-win.png b/apps/desktop/resources/icon-win.pngnew file mode 100644index 00000000..94937856Binary files /dev/null and b/apps/desktop/resources/icon-win.png differdiff --git a/apps/desktop/scripts/verify-package.mjs b/apps/desktop/scripts/verify-package.mjsindex a7718311..97fa5c1b 100644--- a/apps/desktop/scripts/verify-package.mjs+++ b/apps/desktop/scripts/verify-package.mjs@@ -124,7 +124,7 @@ assertSize('Daemon resources', daemonDir, 250 * 1024 * 1024);assertSize('Creator Runtime', creatorRuntimeDir, 384 * 1024 * 1024);assertSize('Codex Runtime', codexRuntimeDir, 450 * 1024 * 1024);assertSize('Stickman Runtime', stickmanRuntimeDir, 384 * 1024 * 1024);-assertSize('Desktop package', packageRoot, 1536 * 1024 * 1024);+assertSize('Desktop package', packageRoot, 1600 * 1024 * 1024);await assertFuseConfiguration();verifyMacPackageMetadata();@@ -215,11 +215,14 @@ function assertBrandingContents() {const desktopResourcesDir = join(resourcesDir, 'desktop-resources');const sourceResourcesDir = resolve(desktopDir, 'resources');const packagedIcon = join(desktopResourcesDir, 'icon.png');+ const packagedWindowsIcon = join(desktopResourcesDir, 'icon-win.png');const packagedTray = join(desktopResourcesDir, 'tray.png');const sourceIcon = join(sourceResourcesDir, 'icon.png');+ const sourceWindowsIcon = join(sourceResourcesDir, 'icon-win.png');const sourceTray = join(sourceResourcesDir, 'tray.png');assertSameFile('Desktop icon', packagedIcon, sourceIcon);+ assertSameFile('Desktop Windows icon', packagedWindowsIcon, sourceWindowsIcon);assertSameFile('Desktop tray icon', packagedTray, sourceTray);const bootstrapHtml = extractFile(diff --git a/apps/desktop/src/main/bootstrap-controller.ts b/apps/desktop/src/main/bootstrap-controller.tsindex c492dad0..643eb88f 100644--- a/apps/desktop/src/main/bootstrap-controller.ts+++ b/apps/desktop/src/main/bootstrap-controller.ts@@ -181,6 +181,7 @@ export class BootstrapController extends EventEmitter<BootstrapControllerEvents>};this.emit('state', this.currentState);const settings = this.input.settings.read();+ const resolutionStartedAt = Date.now();let resolutionDiagnostics: CodexResolutionDiagnostics | undefined;let resolvedEnvironment: ResolvedCodexEnvironment | undefined;try {@@ -233,7 +234,8 @@ export class BootstrapController extends EventEmitter<BootstrapControllerEvents>}this.input.logger.info('Resolved Codex CLI', {codexBin: resolvedEnvironment.codexBin,- source: resolvedEnvironment.source+ source: resolvedEnvironment.source,+ durationMs: Date.now() - resolutionStartedAt});this.resolvedEnvironment = resolvedEnvironment;const fingerprint = environmentFingerprint(resolvedEnvironment);@@ -315,6 +317,8 @@ export class BootstrapController extends EventEmitter<BootstrapControllerEvents>appHome: this.input.appHome,codexBin: environment.codexBin,codexHome: environment.codexHome,+ codexVersion: environment.version,+ codexCommit: environment.commit,dataDir: this.input.dataDir,creatorRuntimeRoot: this.input.creatorRuntimeRoot,stickmanRuntimeRoot: this.input.stickmanRuntimeRoot,diff --git a/apps/desktop/src/main/codex-resolver.ts b/apps/desktop/src/main/codex-resolver.tsindex b2e79134..03ee9d12 100644--- a/apps/desktop/src/main/codex-resolver.ts+++ b/apps/desktop/src/main/codex-resolver.ts@@ -1,4 +1,7 @@-import { createHash } from 'node:crypto';+import {+ sha256Text,+ verifyFileIntegrityWithCache+} from '@opencreator/config';import { spawnSync } from 'node:child_process';import {existsSync,@@ -150,7 +153,8 @@ function resolveBundled(input: {if (!existsSync(manifestPath)) {throw failure('codex_runtime_missing', `内置 Codex Runtime 清单不存在:${manifestPath}`, input.diagnostics);}- const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as Record<string, unknown>;+ const manifestSource = readFileSync(manifestPath, 'utf8');+ const manifest = JSON.parse(manifestSource) as Record<string, unknown>;if (manifest.version !== BUNDLED_VERSION|| manifest.commit !== BUNDLED_COMMIT@@ -173,7 +177,17 @@ function resolveBundled(input: {if (!existsSync(codexBin) || lstatSync(codexBin).isSymbolicLink() || !statSync(codexBin).isFile()) {throw failure('codex_runtime_missing', `内置 Codex 主程序不存在:${codexBin}`, input.diagnostics);}- if (hashFile(codexBin) !== expectedHash) {+ const verification = verifyFileIntegrityWithCache({+ cachePath: join(input.userDataDir, 'runtime-verification', 'codex.json'),+ identity: runtimeRoot,+ fingerprint: sha256Text(manifestSource),+ files: [{+ key: relativePath,+ path: codexBin,+ sha256: expectedHash+ }]+ });+ if (!verification.verified) {throw failure('codex_runtime_hash_mismatch', '内置 Codex 主程序哈希校验失败', input.diagnostics);}const codexHome = join(input.userDataDir, 'runtime', 'codex');@@ -285,10 +299,6 @@ function failure(return new CodexResolutionError(code, message, { ...diagnostics, errorCode: code, message });}-function hashFile(path: string): string {- return createHash('sha256').update(readFileSync(path)).digest('hex');-}-function readRecord(value: unknown): Record<string, unknown> {return value !== null && typeof value === 'object' && !Array.isArray(value)? value as Record<string, unknown>diff --git a/apps/desktop/src/main/daemon-manager.ts b/apps/desktop/src/main/daemon-manager.tsindex e0ee8d70..424e682a 100644--- a/apps/desktop/src/main/daemon-manager.ts+++ b/apps/desktop/src/main/daemon-manager.ts@@ -29,6 +29,8 @@ export type DaemonStartInput = {appHome: string;codexBin: string;codexHome: string;+ codexVersion: string;+ codexCommit: string | null;dataDir: string;creatorRuntimeRoot?: string;stickmanRuntimeRoot?: string;@@ -92,6 +94,7 @@ export class DaemonManager extends EventEmitter<DaemonManagerEvents> {private startInternal(input: DaemonStartInput): Promise<DaemonConnection> {return new Promise((resolve, reject) => {+ const startedAt = Date.now();let settled = false;let stdoutState: DaemonOutputState = {buffer: '',@@ -127,6 +130,10 @@ export class DaemonManager extends EventEmitter<DaemonManagerEvents> {clearTimeout(timeout);this.connection = connection;this.emit('connection', connection);+ this.logger.info('Daemon Utility Process ready', {+ durationMs: Date.now() - startedAt,+ pid: child.pid+ });resolve(connection);};const handleBootstrapEvent = (event: DaemonBootstrapEvent) => {@@ -304,6 +311,10 @@ export function buildDaemonEnvironment(OPENCREATOR_HOME: input.appHome,OPENCREATOR_MANAGED_PARENT_PID: String(process.pid),OPENCREATOR_CODEX_BIN: input.codexBin,+ OPENCREATOR_CODEX_VERSION: input.codexVersion,+ ...(input.codexCommit === null+ ? {}+ : { OPENCREATOR_CODEX_COMMIT: input.codexCommit }),CODEX_HOME: input.codexHome,OPENCREATOR_DATA_DIR: input.dataDir,...(input.creatorRuntimeRoot === undefineddiff --git a/apps/desktop/src/main/main.ts b/apps/desktop/src/main/main.tsindex e61c4f89..92dd7294 100644--- a/apps/desktop/src/main/main.ts+++ b/apps/desktop/src/main/main.ts@@ -75,6 +75,7 @@ async function launchDesktop(): Promise<void> {let bootstrap: BootstrapController | undefined;let workspaceLoaded = false;let workspaceLoadWork: Promise<void> | undefined;+ let bootstrapSurfaceReady: Promise<void> = Promise.resolve();let shutdownStarted = false;let allowQuit = false;let loginShellTask: LoginShellEnvironmentTask | undefined;@@ -198,9 +199,13 @@ async function launchDesktop(): Promise<void> {workspaceLoadWork = (async () => {workspaceLoaded = false;try {+ await bootstrapSurfaceReady;await windowManager?.loadWorkspace();workspaceLoaded = true;bootstrap?.markWorkspaceReady();+ logger.info('OpenCreator workspace ready', {+ durationMs: Date.now() - APP_ENTRY_AT+ });windowManager?.show();for (const route of pendingRoutes.splice(0)) {windowManager?.send(desktopIpc.navigate, route);@@ -255,13 +260,23 @@ async function launchDesktop(): Promise<void> {void loadWorkspace();});- await windowManager.loadBootstrap();+ bootstrapSurfaceReady = windowManager.loadBootstrap();+ loginShellTask = startLoginShellEnvironmentRead({+ timeoutMs: 5_000+ });+ void bootstrap.start(undefined, loginShellTask);+ await bootstrapSurfaceReady;bootstrap.setStartupMetrics({...windowManager.metrics,appReadyAt});+ const trayIconName = process.platform === 'darwin'+ ? 'tray.png'+ : process.platform === 'win32'+ ? 'icon-win.png'+ : 'icon.png';tray.create({- iconPath: join(resourceRoot, process.platform === 'darwin' ? 'tray.png' : 'icon.png'),+ iconPath: join(resourceRoot, trayIconName),open: () => windowManager?.show(),navigate,quit: () => app.quit()@@ -286,11 +301,6 @@ async function launchDesktop(): Promise<void> {}});queueDeepLink(findDeepLink(process.argv));- loginShellTask = startLoginShellEnvironmentRead({- timeoutMs: 5_000- });- void bootstrap.start(undefined, loginShellTask);-app.on('activate', () => windowManager?.show());app.on('window-all-closed', () => {// The tray and Runtime intentionally remain active.diff --git a/apps/desktop/src/main/telemetry.ts b/apps/desktop/src/main/telemetry.tsindex e9152ea2..252a64f2 100644--- a/apps/desktop/src/main/telemetry.ts+++ b/apps/desktop/src/main/telemetry.ts@@ -7,6 +7,7 @@ import type { SettingsStore } from './settings-store.js';const DEFAULT_TELEMETRY_URL = 'https://admin.clawee.work/api/v1/public/desktop-usage';const ACTIVE_INTERVAL_MS = 60_000;const REPORT_INTERVAL_MS = 6 * 60 * 60 * 1000;+const REPORT_TIMEOUT_MS = 5_000;type TelemetryDay = {date: string;@@ -53,6 +54,7 @@ export function startDesktopTelemetry(input: {let launchRecorded = false;let stopped = false;let reportQueue = Promise.resolve();+ let activeReport: AbortController | undefined;const installId = () => {const existing = input.settings.read().telemetryInstallId;@@ -67,10 +69,15 @@ export function startDesktopTelemetry(input: {store.incrementLaunch(usageDate(now()));};const sendReports = async () => {- if (!input.settings.read().telemetryEnabled || endpoint === undefined) return;+ if (stopped || !input.settings.read().telemetryEnabled || endpoint === undefined) return;const currentInstallId = installId();const today = usageDate(now());for (const day of store.readDays(today)) {+ if (stopped) return;+ const controller = new AbortController();+ activeReport = controller;+ const timeout = setTimeout(() => controller.abort(), REPORT_TIMEOUT_MS);+ timeout.unref();try {const response = await fetchImpl(endpoint, {method: 'POST',@@ -87,7 +94,7 @@ export function startDesktopTelemetry(input: {operating_system: input.platform ?? process.platform,architecture: input.architecture ?? process.arch}),- signal: AbortSignal.timeout(5_000)+ signal: controller.signal});if (!response.ok) {input.logger.warnRateLimited(@@ -100,6 +107,7 @@ export function startDesktopTelemetry(input: {}store.removeReportedHistory(day.date, today);} catch (error) {+ if (stopped) return;input.logger.warnRateLimited('desktop-telemetry-report','Desktop telemetry report failed',@@ -107,6 +115,9 @@ export function startDesktopTelemetry(input: {REPORT_INTERVAL_MS);return;+ } finally {+ clearTimeout(timeout);+ if (activeReport === controller) activeReport = undefined;}}};@@ -140,13 +151,14 @@ export function startDesktopTelemetry(input: {if (!stopped) {stopped = true;clearTimers();+ activeReport?.abort();}- await reportNow();},dispose() {if (stopped) return;stopped = true;clearTimers();+ activeReport?.abort();}};}diff --git a/apps/desktop/src/main/window-manager.ts b/apps/desktop/src/main/window-manager.tsindex fc53d1bf..c7444ca9 100644--- a/apps/desktop/src/main/window-manager.ts+++ b/apps/desktop/src/main/window-manager.ts@@ -106,9 +106,11 @@ export class WindowManager {preload: this.input.preloadPath}});+ window.setContentSize(bounds.width, bounds.height);if (process.platform === 'darwin') window.setWindowButtonVisibility(false);this.startupMetrics.windowCreatedAt ??= Date.now();this.window = window;+ let normalBounds = contentWindowBounds(window);if (settings.window?.maximized === true) window.maximize();window.webContents.session.webRequest.onBeforeSendHeaders({ urls: ['https://www.youtube-nocookie.com/embed/*'] },@@ -146,19 +148,23 @@ export class WindowManager {});const saveBounds = () => {if (window.isDestroyed() || window.isMinimized()) return;- const current = window.isMaximized()- ? window.getNormalBounds()- : window.getBounds();+ if (!window.isMaximized()) normalBounds = contentWindowBounds(window);this.input.settings.update({window: {- ...current,+ ...normalBounds,maximized: window.isMaximized()}});};this.windowStateWriter = new DebouncedWindowStateWriter(saveBounds);- window.on('resize', () => this.windowStateWriter?.schedule());- window.on('move', () => this.windowStateWriter?.schedule());+ const scheduleWindowStateWrite = () => {+ if (!window.isMaximized() && !window.isMinimized()) {+ normalBounds = contentWindowBounds(window);+ }+ this.windowStateWriter?.schedule();+ };+ window.on('resize', scheduleWindowStateWrite);+ window.on('move', scheduleWindowStateWrite);window.on('hide', () => this.windowStateWriter?.flush());return window;}@@ -300,6 +306,7 @@ export class WindowManager {this.quitting = true;this.windowStateWriter?.flush();this.cancelWorkspaceLoad(new Error('Application is quitting'));+ closeWindowForQuit(this.window);}flushState(): void {@@ -364,6 +371,27 @@ export function nativeWindowBackgroundColor(mode: DesktopWindowColorMode): strinreturn mode === 'dark' ? '#0a0a0a' : '#e5e5e5';}+export function contentWindowBounds(+ window: Pick<BrowserWindow, 'getBounds' | 'getContentBounds'>+): { x: number; y: number; width: number; height: number } {+ const outer = window.getBounds();+ const content = window.getContentBounds();+ return {+ x: outer.x,+ y: outer.y,+ width: content.width,+ height: content.height+ };+}++export function closeWindowForQuit(+ window: Pick<BrowserWindow, 'destroy' | 'hide' | 'isDestroyed'> | undefined+): void {+ if (window === undefined || window.isDestroyed()) return;+ window.hide();+ window.destroy();+}+function visibleBounds(saved: ReturnType<SettingsStore['read']>['window']): { x?: number; y?: number; width: number; height: number } {diff --git a/apps/desktop/test/branding-assets-2026-07-27.test.ts b/apps/desktop/test/branding-assets-2026-07-27.test.tsindex e10e4db7..56c2eb79 100644--- a/apps/desktop/test/branding-assets-2026-07-27.test.ts+++ b/apps/desktop/test/branding-assets-2026-07-27.test.ts@@ -1,6 +1,7 @@import { createHash } from 'node:crypto';import { existsSync, readFileSync } from 'node:fs';import { resolve } from 'node:path';+import { inflateSync } from 'node:zlib';import { describe, expect, it } from 'vitest';const repoRoot = resolve(import.meta.dirname, '../../..');@@ -29,11 +30,26 @@ describe('品牌资源', () => {const trayManager = readFileSync(resolve(desktopRoot, 'src/main/tray-manager.ts'), 'utf8');expect(trayManager).toContain("if (process.platform === 'darwin') icon.setTemplateImage(true);");expect(trayManager).toContain('height: size');+ const desktopMain = readFileSync(resolve(desktopRoot, 'src/main/main.ts'), 'utf8');+ expect(desktopMain).toContain("process.platform === 'win32'");+ expect(desktopMain).toContain("? 'icon-win.png'");+ expect(desktopMain).toContain('iconPath: join(resourceRoot, trayIconName)');expect(existsSync(resolve(desktopRoot, 'resources/tray.png'))).toBe(true);expect(existsSync(resolve(desktopRoot, 'resources/icon.png'))).toBe(true);+ expect(existsSync(resolve(desktopRoot, 'resources/icon-win.png'))).toBe(true);const icon = readPngMetadata(resolve(desktopRoot, 'resources/icon.png'));expect(icon).toEqual({ width: 1024, height: 1024, colorType: 6 });+ const windowsIcon = readPngMetadata(resolve(desktopRoot, 'resources/icon-win.png'));+ expect(windowsIcon).toEqual({ width: 1024, height: 1024, colorType: 6 });+ expect(readPngAlphaBounds(resolve(desktopRoot, 'resources/icon-win.png'))).toEqual({+ minX: 0,+ minY: 0,+ maxX: 1023,+ maxY: 1023,+ darkWidth: 776,+ darkHeight: 833+ });});it('Desktop 图标、托盘和 Web 使用同一枚双链品牌图形', () => {@@ -55,6 +71,10 @@ describe('品牌资源', () => {expect(sidebar).toContain('<OpenCreatorMark');expect(iconSvg).toContain('<rect width="460" height="460" rx="92" fill="#fff"/>');expect(traySvg).not.toContain('<rect');++ const builderConfig = readFileSync(resolve(desktopRoot, 'electron-builder.yml'), 'utf8');+ expect(builderConfig).toMatch(/mac:[\s\S]*?icon: resources\/icon\.png/);+ expect(builderConfig).toMatch(/win:[\s\S]*?icon: resources\/icon-win\.png/);});it('不再发布旧品牌素材或历史兼容路径', () => {@@ -118,3 +138,99 @@ function readPngMetadata(path: string): { width: number; height: number; colorTycolorType: bytes.readUInt8(25)};}++function readPngAlphaBounds(path: string): {+ minX: number;+ minY: number;+ maxX: number;+ maxY: number;+ darkWidth: number;+ darkHeight: number;+} {+ const bytes = readFileSync(path);+ const { width, height, colorType } = readPngMetadata(path);+ expect(bytes.readUInt8(24)).toBe(8);+ expect(colorType).toBe(6);+ expect(bytes.readUInt8(28)).toBe(0);++ const idatChunks: Buffer[] = [];+ for (let offset = 8; offset < bytes.length;) {+ const length = bytes.readUInt32BE(offset);+ const type = bytes.subarray(offset + 4, offset + 8).toString('ascii');+ if (type === 'IDAT') idatChunks.push(bytes.subarray(offset + 8, offset + 8 + length));+ offset += length + 12;+ }++ const decoded = inflateSync(Buffer.concat(idatChunks));+ const bytesPerPixel = 4;+ const stride = width * bytesPerPixel;+ let sourceOffset = 0;+ let previous = Buffer.alloc(stride);+ let minX = width;+ let minY = height;+ let maxX = -1;+ let maxY = -1;+ let darkMinX = width;+ let darkMinY = height;+ let darkMaxX = -1;+ let darkMaxY = -1;++ for (let y = 0; y < height; y += 1) {+ const filter = decoded[sourceOffset]!;+ sourceOffset += 1;+ const row = Buffer.allocUnsafe(stride);+ for (let index = 0; index < stride; index += 1) {+ const left = index >= bytesPerPixel ? row[index - bytesPerPixel]! : 0;+ const up = previous[index]!;+ const upperLeft = index >= bytesPerPixel ? previous[index - bytesPerPixel]! : 0;+ const encoded = decoded[sourceOffset + index]!;+ row[index] = (encoded + pngFilterValue(filter, left, up, upperLeft)) & 0xff;+ }+ sourceOffset += stride;++ for (let x = 0; x < width; x += 1) {+ const pixelOffset = x * bytesPerPixel;+ const alpha = row[pixelOffset + 3]!;+ if (alpha === 0) continue;+ minX = Math.min(minX, x);+ minY = Math.min(minY, y);+ maxX = Math.max(maxX, x);+ maxY = Math.max(maxY, y);+ if (+ alpha >= 128+ && row[pixelOffset]! + row[pixelOffset + 1]! + row[pixelOffset + 2]! < 240+ ) {+ darkMinX = Math.min(darkMinX, x);+ darkMinY = Math.min(darkMinY, y);+ darkMaxX = Math.max(darkMaxX, x);+ darkMaxY = Math.max(darkMaxY, y);+ }+ }+ previous = row;+ }++ return {+ minX,+ minY,+ maxX,+ maxY,+ darkWidth: darkMaxX - darkMinX + 1,+ darkHeight: darkMaxY - darkMinY + 1+ };+}++function pngFilterValue(filter: number, left: number, up: number, upperLeft: number): number {+ if (filter === 0) return 0;+ if (filter === 1) return left;+ if (filter === 2) return up;+ if (filter === 3) return Math.floor((left + up) / 2);+ if (filter === 4) {+ const estimate = left + up - upperLeft;+ const leftDistance = Math.abs(estimate - left);+ const upDistance = Math.abs(estimate - up);+ const upperLeftDistance = Math.abs(estimate - upperLeft);+ if (leftDistance <= upDistance && leftDistance <= upperLeftDistance) return left;+ return upDistance <= upperLeftDistance ? up : upperLeft;+ }+ throw new Error(`Unsupported PNG filter: ${filter}`);+}diff --git a/apps/desktop/test/codex-resolver.test.ts b/apps/desktop/test/codex-resolver.test.tsindex 145a80fa..c3b7bf27 100644--- a/apps/desktop/test/codex-resolver.test.ts+++ b/apps/desktop/test/codex-resolver.test.ts@@ -64,6 +64,21 @@ describe('Desktop Codex resolver', () => {})).rejects.toMatchObject({ code: 'codex_runtime_hash_mismatch' });});+ it('invalidates the bundled Runtime verification cache after a binary change', async () => {+ const fixture = createBundledFixture();+ await resolveCodexEnvironment({+ runtimeRoot: fixture.runtimeRoot,+ userDataDir: fixture.userDataDir+ });++ writeFileSync(fixture.binary, 'tampered-value');++ await expect(resolveCodexEnvironment({+ runtimeRoot: fixture.runtimeRoot,+ userDataDir: fixture.userDataDir+ })).rejects.toMatchObject({ code: 'codex_runtime_hash_mismatch' });+ });+it('requires an explicit external mode path and separates its Home', async () => {createBundledFixture();const external = join(tempDir, executableName());diff --git a/apps/desktop/test/daemon-output.test.ts b/apps/desktop/test/daemon-output.test.tsindex 59253dc9..f76b58c2 100644--- a/apps/desktop/test/daemon-output.test.ts+++ b/apps/desktop/test/daemon-output.test.ts@@ -116,6 +116,8 @@ describe('Daemon stdout parser', () => {appHome: '/Users/demo/.opencreator',codexBin: '/app/codex',codexHome: '/Users/demo/.opencreator/runtime/codex',+ codexVersion: '0.149.0',+ codexCommit: 'bundled-commit',dataDir: '/Users/demo/.opencreator/data',defaultCwd: '/Users/demo',defaultProjectRoot: '/Users/demo/Documents',@@ -127,6 +129,8 @@ describe('Daemon stdout parser', () => {OPENCREATOR_HOME: '/Users/demo/.opencreator',OPENCREATOR_DATA_DIR: '/Users/demo/.opencreator/data',CODEX_HOME: '/Users/demo/.opencreator/runtime/codex',+ OPENCREATOR_CODEX_VERSION: '0.149.0',+ OPENCREATOR_CODEX_COMMIT: 'bundled-commit',OPENCREATOR_MANAGED_PARENT_PID: String(process.pid)});});diff --git a/apps/desktop/test/telemetry.test.ts b/apps/desktop/test/telemetry.test.tsindex ab8e0ba1..b8ccf730 100644--- a/apps/desktop/test/telemetry.test.ts+++ b/apps/desktop/test/telemetry.test.ts@@ -241,7 +241,7 @@ describe('desktop telemetry', () => {});});- it('reports active minutes again while stopping', async () => {+ it('persists active minutes without reporting again while stopping', async () => {vi.useFakeTimers();try {const telemetryMemory = memoryPersistence();@@ -268,10 +268,43 @@ describe('desktop telemetry', () => {await vi.advanceTimersByTimeAsync(10);await controller.stop();- expect(requests).toHaveLength(1);- expect(requests[0]).toMatchObject({ active_minutes: 1 });+ expect(requests).toHaveLength(0);+ expect(JSON.parse(telemetryMemory.read())).toEqual({+ days: [{ date: '2026-09-07', launchCount: 1, activeMinutes: 1 }]+ });} finally {vi.useRealTimers();}});++ it('aborts an in-flight report without waiting for the network while stopping', async () => {+ let requestSignal: AbortSignal | undefined;+ let markRequestStarted: () => void = () => undefined;+ const requestStarted = new Promise<void>(resolve => {+ markRequestStarted = resolve;+ });+ const controller = startDesktopTelemetry({+ path: '/virtual/telemetry.json',+ settings: memorySettings(),+ logger: logger(),+ appVersion: '3.0.1',+ isOfficialBuild: true,+ now: () => new Date('2026-09-07T02:00:00Z'),+ isWindowActive: () => false,+ fetchImpl: vi.fn(async (_url, init) => {+ requestSignal = init?.signal ?? undefined;+ markRequestStarted();+ return await new Promise<Response>((_resolve, reject) => {+ requestSignal?.addEventListener('abort', () => {+ reject(new DOMException('Aborted', 'AbortError'));+ }, { once: true });+ });+ })+ });++ await requestStarted;+ await controller.stop();++ expect(requestSignal?.aborted).toBe(true);+ });});diff --git a/apps/desktop/test/window-manager.test.ts b/apps/desktop/test/window-manager.test.tsindex 8536c090..671429f9 100644--- a/apps/desktop/test/window-manager.test.ts+++ b/apps/desktop/test/window-manager.test.ts@@ -1,6 +1,8 @@import { describe, expect, it, vi } from 'vitest';import {applyWindowAction,+ closeWindowForQuit,+ contentWindowBounds,DebouncedWindowStateWriter,nativeWindowBackgroundColor,nativeWindowChromeOptions,@@ -43,6 +45,45 @@ describe('Native window chrome', () => {}});+ it.each(['win32', 'darwin'] as const)(+ 'hides and destroys the renderer immediately while quitting on %s',+ () => {+ const window = {+ destroy: vi.fn(),+ hide: vi.fn(),+ isDestroyed: vi.fn(() => false)+ };++ closeWindowForQuit(window);++ expect(window.hide).toHaveBeenCalledOnce();+ expect(window.destroy).toHaveBeenCalledOnce();+ expect(window.hide.mock.invocationCallOrder[0]).toBeLessThan(+ window.destroy.mock.invocationCallOrder[0] ?? Number.MAX_SAFE_INTEGER+ );+ }+ );++ it('does nothing when the renderer is already destroyed', () => {+ const window = {+ destroy: vi.fn(),+ hide: vi.fn(),+ isDestroyed: vi.fn(() => true)+ };++ closeWindowForQuit(window);++ expect(window.hide).not.toHaveBeenCalled();+ expect(window.destroy).not.toHaveBeenCalled();+ });++ it('persists outer position with content viewport dimensions', () => {+ expect(contentWindowBounds({+ getBounds: () => ({ x: 40, y: 60, width: 993, height: 719 }),+ getContentBounds: () => ({ x: 47, y: 92, width: 980, height: 680 })+ })).toEqual({ x: 40, y: 60, width: 980, height: 680 });+ });+it('keeps close behavior and toggles native minimize and zoom actions', () => {const window = {close: vi.fn(),diff --git a/packages/config/src/file-integrity-cache.test.ts b/packages/config/src/file-integrity-cache.test.tsnew file mode 100644index 00000000..4dd258ed--- /dev/null+++ b/packages/config/src/file-integrity-cache.test.ts@@ -0,0 +1,74 @@+import { createHash } from 'node:crypto';+import {+ mkdtempSync,+ readFileSync,+ rmSync,+ writeFileSync+} from 'node:fs';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { afterEach, describe, expect, it } from 'vitest';+import { verifyFileIntegrityWithCache } from './file-integrity-cache.js';++let tempDir = '';++afterEach(() => {+ if (tempDir) rmSync(tempDir, { recursive: true, force: true });+ tempDir = '';+});++describe('文件完整性缓存', () => {+ it('首次强校验后使用元数据缓存', () => {+ const fixture = createFixture();++ expect(verify(fixture)).toEqual({ verified: true, cacheHit: false });+ expect(verify(fixture)).toEqual({ verified: true, cacheHit: true });+ });++ it('文件变化后重新计算哈希并拒绝篡改内容', () => {+ const fixture = createFixture();+ expect(verify(fixture).verified).toBe(true);++ writeFileSync(fixture.file, 'changed-content');++ expect(verify(fixture)).toEqual({+ verified: false,+ key: 'runtime.bin',+ reason: 'hash_mismatch'+ });+ });++ it('缓存损坏时退回完整校验并重建缓存', () => {+ const fixture = createFixture();+ expect(verify(fixture).verified).toBe(true);+ writeFileSync(fixture.cachePath, '{invalid');++ expect(verify(fixture)).toEqual({ verified: true, cacheHit: false });+ expect(() => JSON.parse(readFileSync(fixture.cachePath, 'utf8'))).not.toThrow();+ });+});++function createFixture() {+ tempDir = mkdtempSync(join(tmpdir(), 'opencreator-integrity-cache-'));+ const file = join(tempDir, 'runtime.bin');+ const cachePath = join(tempDir, 'cache', 'integrity.json');+ writeFileSync(file, 'runtime-content');+ return {+ file,+ cachePath,+ sha256: createHash('sha256').update(readFileSync(file)).digest('hex')+ };+}++function verify(fixture: ReturnType<typeof createFixture>) {+ return verifyFileIntegrityWithCache({+ cachePath: fixture.cachePath,+ identity: tempDir,+ fingerprint: 'manifest-v1',+ files: [{+ key: 'runtime.bin',+ path: fixture.file,+ sha256: fixture.sha256+ }]+ });+}diff --git a/packages/config/src/file-integrity-cache.ts b/packages/config/src/file-integrity-cache.tsnew file mode 100644index 00000000..30ea1434--- /dev/null+++ b/packages/config/src/file-integrity-cache.ts@@ -0,0 +1,207 @@+import { createHash } from 'node:crypto';+import {+ closeSync,+ lstatSync,+ mkdirSync,+ openSync,+ readFileSync,+ readSync,+ renameSync,+ rmSync,+ writeFileSync+} from 'node:fs';+import { dirname, resolve } from 'node:path';++const CACHE_VERSION = 1;+const HASH_BUFFER_BYTES = 1024 * 1024;++export type IntegrityFile = {+ key: string;+ path: string;+ sha256: string;+ expectedSize?: number;+};++export type FileIntegrityVerificationResult =+ | { verified: true; cacheHit: boolean }+ | {+ verified: false;+ key: string;+ reason: 'missing' | 'invalid' | 'hash_mismatch';+ };++type CachedFileMetadata = {+ key: string;+ size: number;+ mtimeMs: number;+ ctimeMs: number;+};++type IntegrityCache = {+ version: number;+ identity: string;+ fingerprint: string;+ files: CachedFileMetadata[];+};++export function verifyFileIntegrityWithCache(input: {+ cachePath?: string;+ identity: string;+ fingerprint: string;+ files: IntegrityFile[];+}): FileIntegrityVerificationResult {+ const metadata = inspectFiles(input.files);+ if (metadata.invalidKey !== undefined) {+ return {+ verified: false,+ key: metadata.invalidKey,+ reason: metadata.invalidReason ?? 'invalid'+ };+ }++ const cached = input.cachePath === undefined+ ? undefined+ : readIntegrityCache(input.cachePath);+ if (+ cached !== undefined+ && cached.version === CACHE_VERSION+ && cached.identity === input.identity+ && cached.fingerprint === input.fingerprint+ && sameMetadata(cached.files, metadata.files)+ ) {+ return { verified: true, cacheHit: true };+ }++ for (const file of input.files) {+ if (hashFile(file.path) !== file.sha256.toLowerCase()) {+ return { verified: false, key: file.key, reason: 'hash_mismatch' };+ }+ }+ if (input.cachePath !== undefined) {+ writeIntegrityCache(input.cachePath, {+ version: CACHE_VERSION,+ identity: input.identity,+ fingerprint: input.fingerprint,+ files: metadata.files+ });+ }+ return { verified: true, cacheHit: false };+}++export function sha256Text(value: string): string {+ return createHash('sha256').update(value).digest('hex');+}++function inspectFiles(files: IntegrityFile[]): {+ files: CachedFileMetadata[];+ invalidKey?: string;+ invalidReason?: 'missing' | 'invalid';+} {+ const metadata: CachedFileMetadata[] = [];+ for (const file of files) {+ try {+ const info = lstatSync(file.path);+ if (+ !info.isFile()+ || info.isSymbolicLink()+ || (file.expectedSize !== undefined && info.size !== file.expectedSize)+ ) {+ return { files: metadata, invalidKey: file.key, invalidReason: 'invalid' };+ }+ metadata.push({+ key: file.key,+ size: info.size,+ mtimeMs: info.mtimeMs,+ ctimeMs: info.ctimeMs+ });+ } catch {+ return { files: metadata, invalidKey: file.key, invalidReason: 'missing' };+ }+ }+ return { files: metadata };+}++function sameMetadata(left: CachedFileMetadata[], right: CachedFileMetadata[]): boolean {+ if (left.length !== right.length) return false;+ return left.every((file, index) => {+ const candidate = right[index];+ return candidate !== undefined+ && file.key === candidate.key+ && file.size === candidate.size+ && file.mtimeMs === candidate.mtimeMs+ && file.ctimeMs === candidate.ctimeMs;+ });+}++function readIntegrityCache(path: string): IntegrityCache | undefined {+ try {+ const value = JSON.parse(readFileSync(path, 'utf8')) as unknown;+ if (!isRecord(value) || !Array.isArray(value.files)) return undefined;+ if (+ typeof value.version !== 'number'+ || typeof value.identity !== 'string'+ || typeof value.fingerprint !== 'string'+ ) {+ return undefined;+ }+ const files: CachedFileMetadata[] = [];+ for (const file of value.files) {+ if (+ !isRecord(file)+ || typeof file.key !== 'string'+ || typeof file.size !== 'number'+ || typeof file.mtimeMs !== 'number'+ || typeof file.ctimeMs !== 'number'+ ) {+ return undefined;+ }+ files.push({+ key: file.key,+ size: file.size,+ mtimeMs: file.mtimeMs,+ ctimeMs: file.ctimeMs+ });+ }+ return {+ version: value.version,+ identity: value.identity,+ fingerprint: value.fingerprint,+ files+ };+ } catch {+ return undefined;+ }+}++function writeIntegrityCache(path: string, cache: IntegrityCache): void {+ const target = resolve(path);+ const temporary = `${target}.${process.pid}.tmp`;+ try {+ mkdirSync(dirname(target), { recursive: true, mode: 0o700 });+ writeFileSync(temporary, `${JSON.stringify(cache)}\n`, { mode: 0o600 });+ rmSync(target, { force: true });+ renameSync(temporary, target);+ } catch {+ rmSync(temporary, { force: true });+ }+}++function hashFile(path: string): string {+ const digest = createHash('sha256');+ const descriptor = openSync(path, 'r');+ const buffer = Buffer.allocUnsafe(HASH_BUFFER_BYTES);+ try {+ let bytesRead: number;+ do {+ bytesRead = readSync(descriptor, buffer, 0, buffer.length, null);+ if (bytesRead > 0) digest.update(buffer.subarray(0, bytesRead));+ } while (bytesRead > 0);+ } finally {+ closeSync(descriptor);+ }+ return digest.digest('hex');+}++function isRecord(value: unknown): value is Record<string, unknown> {+ return typeof value === 'object' && value !== null && !Array.isArray(value);+}diff --git a/packages/config/src/index.ts b/packages/config/src/index.tsindex 9848767f..8762f8cd 100644--- a/packages/config/src/index.ts+++ b/packages/config/src/index.ts@@ -20,6 +20,13 @@ import type {UpdateOpenCreatorUiSettingsRequest} from '@opencreator/protocol';+export {+ sha256Text,+ verifyFileIntegrityWithCache,+ type FileIntegrityVerificationResult,+ type IntegrityFile+} from './file-integrity-cache.js';+export type OpenCreatorPaths = {root: string;configFile: string;diff --git a/packages/writing-templates/src/generated/catalog.json b/packages/writing-templates/src/generated/catalog.jsonindex f6d6586d..ad7bf591 100644--- a/packages/writing-templates/src/generated/catalog.json+++ b/packages/writing-templates/src/generated/catalog.json@@ -69,12 +69,12 @@"url": "https://github.com/KKKKhazix/sun-style-writing","license": "MIT"},- "contentHash": "290ffd63506d5502c5e83c1b711cb841e355cd924333d4b6926cdbc4416fcd67",+ "contentHash": "6138b9650c64749debc4e47b8174cb1d67bb2b5115efe9e6dedd9a5c495c6dd0","stagePrompts": {- "topics": "# 选题规则\n\n优先寻找来源中有明确人物、关系、时间跨度、具体物件或行动冲突的方向。选题应能够由真实场景展开,并具备反差或悬念。不要为追求文学感补造材料中不存在的经历、数字和细节。",- "outline": "# 孙学写作法\n\n这是一套来自 `KKKKhazix/sun-style-writing`、经 OpenCreator 接入的非虚构叙事规则。使用写作技法本身,不要求复刻任何现实人物的独特口吻。\n\n## 核心原则\n\n- 只写来源能够支持的动作、对话、物件、数字和环境细节,少解释人物心理。\n- 用具体数字替代模糊形容词,但真实性优先;材料不精确时不得制造假精确。\n- 段落和对话可以短,但一个关键场景要充分展开,形成进入、细节、变化和离开的过程。\n- 从材料中选择一个普通物件、动作或声音作为线索,让它在后文自然回来,不解释其象征意义。\n- 关键转折可以由沉默、称谓变化、动作变化或重复句式的中断承担。\n\n## 大纲方式\n\n开篇三句话内建立材料中真实存在的反差、悬念或关系变化。随后用时间、地点、人物或物件作为锚点推进场景。只在重大阶段转换时使用分隔,不把叙事切成大量碎片。结尾回到开篇出现过的动作、物件或问题,让语境变化产生回响,避免总结式升华。\n\n## 语言边界\n\n保持平静陈述,减少成语堆叠、感叹号、直接情绪标签和排比抒情。能够用动作呈现时不解释心理,能够用物件呈现时不总结感情。所有细节都必须服从来源和用户提供的事实边界。",- "article": "# 孙学写作法\n\n这是一套来自 `KKKKhazix/sun-style-writing`、经 OpenCreator 接入的非虚构叙事规则。使用写作技法本身,不要求复刻任何现实人物的独特口吻。\n\n## 核心原则\n\n- 只写来源能够支持的动作、对话、物件、数字和环境细节,少解释人物心理。\n- 用具体数字替代模糊形容词,但真实性优先;材料不精确时不得制造假精确。\n- 段落和对话可以短,但一个关键场景要充分展开,形成进入、细节、变化和离开的过程。\n- 从材料中选择一个普通物件、动作或声音作为线索,让它在后文自然回来,不解释其象征意义。\n- 关键转折可以由沉默、称谓变化、动作变化或重复句式的中断承担。\n\n## 大纲方式\n\n开篇三句话内建立材料中真实存在的反差、悬念或关系变化。随后用时间、地点、人物或物件作为锚点推进场景。只在重大阶段转换时使用分隔,不把叙事切成大量碎片。结尾回到开篇出现过的动作、物件或问题,让语境变化产生回响,避免总结式升华。\n\n## 语言边界\n\n保持平静陈述,减少成语堆叠、感叹号、直接情绪标签和排比抒情。能够用动作呈现时不解释心理,能够用物件呈现时不总结感情。所有细节都必须服从来源和用户提供的事实边界。\n\n# 成稿检查\n\n- 开头是否快速建立了来源真实支持的反差或悬念。\n- 是否删除了无依据的心理描写、精确数字和场景细节。\n- 关键场景是否足够完整,而不是只展示几个技巧就跳走。\n- 重复出现的物件、动作或句式是否自然,并在后文产生新的意义。\n- 结尾是否停留在具体画面或动作上,避免口号、总结和强行升华。\n- 技法是否服务于人物和事实;如果技巧比内容更醒目,应主动削弱。",- "review": "# 成稿检查\n\n- 开头是否快速建立了来源真实支持的反差或悬念。\n- 是否删除了无依据的心理描写、精确数字和场景细节。\n- 关键场景是否足够完整,而不是只展示几个技巧就跳走。\n- 重复出现的物件、动作或句式是否自然,并在后文产生新的意义。\n- 结尾是否停留在具体画面或动作上,避免口号、总结和强行升华。\n- 技法是否服务于人物和事实;如果技巧比内容更醒目,应主动削弱。"+ "topics": "# 选题规则\r\n\r\n优先寻找来源中有明确人物、关系、时间跨度、具体物件或行动冲突的方向。选题应能够由真实场景展开,并具备反差或悬念。不要为追求文学感补造材料中不存在的经历、数字和细节。",+ "outline": "# 孙学写作法\r\n\r\n这是一套来自 `KKKKhazix/sun-style-writing`、经 OpenCreator 接入的非虚构叙事规则。使用写作技法本身,不要求复刻任何现实人物的独特口吻。\r\n\r\n## 核心原则\r\n\r\n- 只写来源能够支持的动作、对话、物件、数字和环境细节,少解释人物心理。\r\n- 用具体数字替代模糊形容词,但真实性优先;材料不精确时不得制造假精确。\r\n- 段落和对话可以短,但一个关键场景要充分展开,形成进入、细节、变化和离开的过程。\r\n- 从材料中选择一个普通物件、动作或声音作为线索,让它在后文自然回来,不解释其象征意义。\r\n- 关键转折可以由沉默、称谓变化、动作变化或重复句式的中断承担。\r\n\r\n## 大纲方式\r\n\r\n开篇三句话内建立材料中真实存在的反差、悬念或关系变化。随后用时间、地点、人物或物件作为锚点推进场景。只在重大阶段转换时使用分隔,不把叙事切成大量碎片。结尾回到开篇出现过的动作、物件或问题,让语境变化产生回响,避免总结式升华。\r\n\r\n## 语言边界\r\n\r\n保持平静陈述,减少成语堆叠、感叹号、直接情绪标签和排比抒情。能够用动作呈现时不解释心理,能够用物件呈现时不总结感情。所有细节都必须服从来源和用户提供的事实边界。",+ "article": "# 孙学写作法\r\n\r\n这是一套来自 `KKKKhazix/sun-style-writing`、经 OpenCreator 接入的非虚构叙事规则。使用写作技法本身,不要求复刻任何现实人物的独特口吻。\r\n\r\n## 核心原则\r\n\r\n- 只写来源能够支持的动作、对话、物件、数字和环境细节,少解释人物心理。\r\n- 用具体数字替代模糊形容词,但真实性优先;材料不精确时不得制造假精确。\r\n- 段落和对话可以短,但一个关键场景要充分展开,形成进入、细节、变化和离开的过程。\r\n- 从材料中选择一个普通物件、动作或声音作为线索,让它在后文自然回来,不解释其象征意义。\r\n- 关键转折可以由沉默、称谓变化、动作变化或重复句式的中断承担。\r\n\r\n## 大纲方式\r\n\r\n开篇三句话内建立材料中真实存在的反差、悬念或关系变化。随后用时间、地点、人物或物件作为锚点推进场景。只在重大阶段转换时使用分隔,不把叙事切成大量碎片。结尾回到开篇出现过的动作、物件或问题,让语境变化产生回响,避免总结式升华。\r\n\r\n## 语言边界\r\n\r\n保持平静陈述,减少成语堆叠、感叹号、直接情绪标签和排比抒情。能够用动作呈现时不解释心理,能够用物件呈现时不总结感情。所有细节都必须服从来源和用户提供的事实边界。\n\n# 成稿检查\r\n\r\n- 开头是否快速建立了来源真实支持的反差或悬念。\r\n- 是否删除了无依据的心理描写、精确数字和场景细节。\r\n- 关键场景是否足够完整,而不是只展示几个技巧就跳走。\r\n- 重复出现的物件、动作或句式是否自然,并在后文产生新的意义。\r\n- 结尾是否停留在具体画面或动作上,避免口号、总结和强行升华。\r\n- 技法是否服务于人物和事实;如果技巧比内容更醒目,应主动削弱。",+ "review": "# 成稿检查\r\n\r\n- 开头是否快速建立了来源真实支持的反差或悬念。\r\n- 是否删除了无依据的心理描写、精确数字和场景细节。\r\n- 关键场景是否足够完整,而不是只展示几个技巧就跳走。\r\n- 重复出现的物件、动作或句式是否自然,并在后文产生新的意义。\r\n- 结尾是否停留在具体画面或动作上,避免口号、总结和强行升华。\r\n- 技法是否服务于人物和事实;如果技巧比内容更醒目,应主动削弱。"}},{@@ -147,12 +147,12 @@"url": "https://github.com/KKKKhazix/khazix-skills/blob/main/khazix-writer/SKILL.md","license": "MIT"},- "contentHash": "e2c5e7040fe5439e16d9a07746cf429292a94360df03b35ad213c1fc2db0e628",+ "contentHash": "13dcacebc8ba4ef7797b2548e42e730325bca15afb337c160392aab4dacdc795","stagePrompts": {- "topics": "# 卡兹克公众号长文写作:选题判断\n\n先吃透内容来源和用户的写作要求,再生成选题。不得用想象补齐来源中不存在的事实、经历、数据或引语。\n\n## HKR 质检\n\n每个候选选题至少满足下面两项,并在角度或摘要中体现其优势:\n\n- Happy:有趣、有反差或有悬念,让读者产生继续了解的好奇心。\n- Knowledge:包含新信息、新方法或能够改变理解的背景知识。\n- Resonance:能连接目标读者真实面对的处境、情绪或争议。\n\n优先提出同时满足三项的选题。多个候选之间要有明显差异,不要只替换标题措辞。\n\n## 文章原型\n\n根据材料选择最合适的原型:调查实验型、产品体验型、现象解读型、工具分享型、方法论分享型。选题必须说明文章从什么具体事件、场景、问题或体验切入,以及核心判断是什么。\n\n如果材料不足以支撑第一人称经历,改用观察者或分析者视角,不得冒充模板作者,也不得虚构作者已经亲自做过某件事。",- "outline": "# 卡兹克公众号长文写作\n\n本模板接入自 `KKKKhazix/khazix-skills` 中的 `khazix-writer`。它提取原 Skill 的写作方法用于文章生成,不代表原作者本人发言,也不允许冒充「数字生命卡兹克」或自动添加原账号署名、联系方式和固定推广尾部。\n\n## 核心底色\n\n- 对新事物保持真实好奇,从「这件事哪里有意思」出发,而不是从宏大结论出发。\n- 讲人话,允许明确表达判断和不确定性,避免滴水不漏但没有温度的报告腔。\n- 真诚优先。产品有缺点就写缺点,不懂就承认不懂,不用不存在的细节增强戏剧性。\n- 观点必须是作者真的相信并愿意表达的,不能为了流量强行制造立场。\n\n## 素材边界\n\n先区分来源事实、用户提供的第一手经历、可验证的背景知识和写作者判断。第一手观察、真实经历、情绪节点和核心创意只能来自用户或内容来源。不得替用户编造试用过程、人物对话、精确数字、现场反应或私人关系。\n\n当素材不足时,保留信息缺口,用诚实的限定语表达,或者调整成不依赖虚构经历的观察视角。\n\n## 文章原型\n\n- 调查实验型:围绕「我替读者实际验证了一件事」展开,重点是过程、意外和发现的递进。只有材料明确提供真实实验时才能使用第一人称。\n- 产品体验型:带读者进入真实使用场景,展示操作、结果、感受和限制。\n- 现象解读型:按观察、好奇、研究、判断的路径推进,从表面现象逐层追问。\n- 工具分享型:用一个真实问题引出工具,用具体案例证明价值,同时交代限制和成本。\n- 方法论分享型:每一部分都给出可执行动作,并坦诚说明学习曲线、失败点和适用边界。\n\n## 开头\n\n从内容来源中真实存在的当下事件、具体场景、反常事实或问题切入。前三段就让读者知道发生了什么,以及为什么值得继续看。禁止使用「在当今快速发展的时代」「随着技术不断进步」等教科书式空话。\n\n开头可以直接启动叙事,也可以抛出一个来源支持的荒诞事实、热点变化或好奇心。不要在开头先解释全文结构。\n\n## 推进与节奏\n\n文章像和朋友认真聊天,而不是提交报告。句子长短交替,段落保持轻盈,关键判断可以独立成段。每次展开背景、案例或类比之后,用一句简短的话扣回主线,避免读者为了理解结构而回头。\n\n一个内容板块通常包含:明确观点、具体事实或案例、与读者处境的连接,以及扣回主线的转场。知识要像聊天过程中自然拿出来的补充,不使用「下面科普一下」式的讲义口吻。\n\n涉及多个产品、模型或案例时,逐一展示,不要一次罗列所有结论。顺序从基础发现推进到最有反差的结果,让每一轮比上一轮更深入或更意外。\n\n## 判断与同理心\n\n可以有明确好恶,但不要居高临下。讨论争议观点时,先把另一方的真实处境具体化,承认其合理部分,再给出自己的不同判断。\n\n需要从具体事件连接到文化、历史或哲学背景时,连接必须服务于当前问题,并且由来源或可靠知识支持。不要为了显得深刻强行升华。\n\n## 真实感\n\n优先使用具体产品名、动作、限制、结果和环境细节,避免「某个模型」「相关技术」「非常震撼」等空泛表达。情绪要落在可观察的反应上,但这些反应必须来自真实材料。\n\n可以使用自然口语和少量不完整句制造呼吸感,但不能机械堆砌口头禅、粗口、夸张标点或模板作者的个人习惯。目标是吸收节奏方法,不是复刻某个人的身份特征。\n\n## 结构\n\n典型长文可以采用以下推进关系:\n\n1. 用具体事件或场景快速建立好奇心。\n2. 用聊天式背景补齐非专业读者需要的信息。\n3. 围绕核心判断展开若干板块,每个板块都有事实或案例支撑。\n4. 在必要时连接更大的文化、历史或行业背景。\n5. 回到开头的意象、问题或判断,以回环、余韵或明确行动收尾。\n\n除非文章本身是「N 条方法」等条目型内容,否则不要滥用 Markdown 小标题和列表。优先用自然转场形成连续阅读体验。不要自动添加上游 Skill 中属于原作者账号的固定署名、邮箱或关注引导。\n\n## 语言禁区\n\n- 不使用「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等套话组织文章。\n- 不堆砌加粗、项目符号和形式整齐但内容空泛的排比。\n- 不用假设性第一人称故事替代真实案例。\n- 不把所有观点包装成绝对结论,保留来源和认知边界。\n- 不为了模仿风格而强制使用粗口、特殊标点或原作者口癖。\n\n## 收尾\n\n从文章已经建立的内容自然收束。可以回到开头的物件或问题,可以留下简短判断,也可以给出读者今天能做的一件事。避免总结全文、重复观点和强行拔高。",- "article": "# 卡兹克公众号长文写作\n\n本模板接入自 `KKKKhazix/khazix-skills` 中的 `khazix-writer`。它提取原 Skill 的写作方法用于文章生成,不代表原作者本人发言,也不允许冒充「数字生命卡兹克」或自动添加原账号署名、联系方式和固定推广尾部。\n\n## 核心底色\n\n- 对新事物保持真实好奇,从「这件事哪里有意思」出发,而不是从宏大结论出发。\n- 讲人话,允许明确表达判断和不确定性,避免滴水不漏但没有温度的报告腔。\n- 真诚优先。产品有缺点就写缺点,不懂就承认不懂,不用不存在的细节增强戏剧性。\n- 观点必须是作者真的相信并愿意表达的,不能为了流量强行制造立场。\n\n## 素材边界\n\n先区分来源事实、用户提供的第一手经历、可验证的背景知识和写作者判断。第一手观察、真实经历、情绪节点和核心创意只能来自用户或内容来源。不得替用户编造试用过程、人物对话、精确数字、现场反应或私人关系。\n\n当素材不足时,保留信息缺口,用诚实的限定语表达,或者调整成不依赖虚构经历的观察视角。\n\n## 文章原型\n\n- 调查实验型:围绕「我替读者实际验证了一件事」展开,重点是过程、意外和发现的递进。只有材料明确提供真实实验时才能使用第一人称。\n- 产品体验型:带读者进入真实使用场景,展示操作、结果、感受和限制。\n- 现象解读型:按观察、好奇、研究、判断的路径推进,从表面现象逐层追问。\n- 工具分享型:用一个真实问题引出工具,用具体案例证明价值,同时交代限制和成本。\n- 方法论分享型:每一部分都给出可执行动作,并坦诚说明学习曲线、失败点和适用边界。\n\n## 开头\n\n从内容来源中真实存在的当下事件、具体场景、反常事实或问题切入。前三段就让读者知道发生了什么,以及为什么值得继续看。禁止使用「在当今快速发展的时代」「随着技术不断进步」等教科书式空话。\n\n开头可以直接启动叙事,也可以抛出一个来源支持的荒诞事实、热点变化或好奇心。不要在开头先解释全文结构。\n\n## 推进与节奏\n\n文章像和朋友认真聊天,而不是提交报告。句子长短交替,段落保持轻盈,关键判断可以独立成段。每次展开背景、案例或类比之后,用一句简短的话扣回主线,避免读者为了理解结构而回头。\n\n一个内容板块通常包含:明确观点、具体事实或案例、与读者处境的连接,以及扣回主线的转场。知识要像聊天过程中自然拿出来的补充,不使用「下面科普一下」式的讲义口吻。\n\n涉及多个产品、模型或案例时,逐一展示,不要一次罗列所有结论。顺序从基础发现推进到最有反差的结果,让每一轮比上一轮更深入或更意外。\n\n## 判断与同理心\n\n可以有明确好恶,但不要居高临下。讨论争议观点时,先把另一方的真实处境具体化,承认其合理部分,再给出自己的不同判断。\n\n需要从具体事件连接到文化、历史或哲学背景时,连接必须服务于当前问题,并且由来源或可靠知识支持。不要为了显得深刻强行升华。\n\n## 真实感\n\n优先使用具体产品名、动作、限制、结果和环境细节,避免「某个模型」「相关技术」「非常震撼」等空泛表达。情绪要落在可观察的反应上,但这些反应必须来自真实材料。\n\n可以使用自然口语和少量不完整句制造呼吸感,但不能机械堆砌口头禅、粗口、夸张标点或模板作者的个人习惯。目标是吸收节奏方法,不是复刻某个人的身份特征。\n\n## 结构\n\n典型长文可以采用以下推进关系:\n\n1. 用具体事件或场景快速建立好奇心。\n2. 用聊天式背景补齐非专业读者需要的信息。\n3. 围绕核心判断展开若干板块,每个板块都有事实或案例支撑。\n4. 在必要时连接更大的文化、历史或行业背景。\n5. 回到开头的意象、问题或判断,以回环、余韵或明确行动收尾。\n\n除非文章本身是「N 条方法」等条目型内容,否则不要滥用 Markdown 小标题和列表。优先用自然转场形成连续阅读体验。不要自动添加上游 Skill 中属于原作者账号的固定署名、邮箱或关注引导。\n\n## 语言禁区\n\n- 不使用「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等套话组织文章。\n- 不堆砌加粗、项目符号和形式整齐但内容空泛的排比。\n- 不用假设性第一人称故事替代真实案例。\n- 不把所有观点包装成绝对结论,保留来源和认知边界。\n- 不为了模仿风格而强制使用粗口、特殊标点或原作者口癖。\n\n## 收尾\n\n从文章已经建立的内容自然收束。可以回到开头的物件或问题,可以留下简短判断,也可以给出读者今天能做的一件事。避免总结全文、重复观点和强行拔高。\n\n# 卡兹克公众号长文写作:四层质检\n\n成稿后按四层顺序检查并直接修复问题。质检服务于文章质量,不要求在最终文章正文中附带报告。\n\n## L1 硬性规则\n\n- 清除「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等报告腔套话。\n- 检查是否存在大段加粗、连续列表、教科书式开头和空泛工具名。\n- 删除来源不支持的经历、对话、数字、情绪反应和假设性第一人称案例。\n- 确认没有原作者署名、联系方式、账号推广或冒充作者身份的表述。\n\n## L2 风格一致性\n\n- 开头是否来自具体事件、场景、反常事实或真实问题。\n- 长短句、短段落和关键独立句是否形成自然节奏,而不是整齐划一。\n- 展开的背景或案例后是否及时扣回主线。\n- 口语表达是否自然,是否避免机械堆砌口头禅和夸张标点。\n\n## L3 内容质量\n\n- 每个核心观点是否都有来源事实、具体案例或可靠知识支撑。\n- 知识是否自然融入叙述,而不是突然切换成讲义。\n- 对立观点是否得到公平解释,判断是否建立在理解对方处境之后。\n- 调查、体验、解读、工具分享或方法论等文章原型是否采用了对应的推进方式。\n- 多个案例是否逐一展开,并形成由浅入深的发现过程。\n\n## L4 真实感终审\n\n通读全文,判断它像一个有见识的普通人在认真聊一件打动他的事,还是像模型在整理信息。重点检查情绪是否来自材料、细节是否可信、观点是否有作者自己的判断,以及阅读心流是否在某处中断。\n\n如果风格技巧比内容本身更醒目,主动降低模仿痕迹,让文章回到事实、观点和读者体验。",- "review": "# 卡兹克公众号长文写作:四层质检\n\n成稿后按四层顺序检查并直接修复问题。质检服务于文章质量,不要求在最终文章正文中附带报告。\n\n## L1 硬性规则\n\n- 清除「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等报告腔套话。\n- 检查是否存在大段加粗、连续列表、教科书式开头和空泛工具名。\n- 删除来源不支持的经历、对话、数字、情绪反应和假设性第一人称案例。\n- 确认没有原作者署名、联系方式、账号推广或冒充作者身份的表述。\n\n## L2 风格一致性\n\n- 开头是否来自具体事件、场景、反常事实或真实问题。\n- 长短句、短段落和关键独立句是否形成自然节奏,而不是整齐划一。\n- 展开的背景或案例后是否及时扣回主线。\n- 口语表达是否自然,是否避免机械堆砌口头禅和夸张标点。\n\n## L3 内容质量\n\n- 每个核心观点是否都有来源事实、具体案例或可靠知识支撑。\n- 知识是否自然融入叙述,而不是突然切换成讲义。\n- 对立观点是否得到公平解释,判断是否建立在理解对方处境之后。\n- 调查、体验、解读、工具分享或方法论等文章原型是否采用了对应的推进方式。\n- 多个案例是否逐一展开,并形成由浅入深的发现过程。\n\n## L4 真实感终审\n\n通读全文,判断它像一个有见识的普通人在认真聊一件打动他的事,还是像模型在整理信息。重点检查情绪是否来自材料、细节是否可信、观点是否有作者自己的判断,以及阅读心流是否在某处中断。\n\n如果风格技巧比内容本身更醒目,主动降低模仿痕迹,让文章回到事实、观点和读者体验。"+ "topics": "# 卡兹克公众号长文写作:选题判断\r\n\r\n先吃透内容来源和用户的写作要求,再生成选题。不得用想象补齐来源中不存在的事实、经历、数据或引语。\r\n\r\n## HKR 质检\r\n\r\n每个候选选题至少满足下面两项,并在角度或摘要中体现其优势:\r\n\r\n- Happy:有趣、有反差或有悬念,让读者产生继续了解的好奇心。\r\n- Knowledge:包含新信息、新方法或能够改变理解的背景知识。\r\n- Resonance:能连接目标读者真实面对的处境、情绪或争议。\r\n\r\n优先提出同时满足三项的选题。多个候选之间要有明显差异,不要只替换标题措辞。\r\n\r\n## 文章原型\r\n\r\n根据材料选择最合适的原型:调查实验型、产品体验型、现象解读型、工具分享型、方法论分享型。选题必须说明文章从什么具体事件、场景、问题或体验切入,以及核心判断是什么。\r\n\r\n如果材料不足以支撑第一人称经历,改用观察者或分析者视角,不得冒充模板作者,也不得虚构作者已经亲自做过某件事。",+ "outline": "# 卡兹克公众号长文写作\r\n\r\n本模板接入自 `KKKKhazix/khazix-skills` 中的 `khazix-writer`。它提取原 Skill 的写作方法用于文章生成,不代表原作者本人发言,也不允许冒充「数字生命卡兹克」或自动添加原账号署名、联系方式和固定推广尾部。\r\n\r\n## 核心底色\r\n\r\n- 对新事物保持真实好奇,从「这件事哪里有意思」出发,而不是从宏大结论出发。\r\n- 讲人话,允许明确表达判断和不确定性,避免滴水不漏但没有温度的报告腔。\r\n- 真诚优先。产品有缺点就写缺点,不懂就承认不懂,不用不存在的细节增强戏剧性。\r\n- 观点必须是作者真的相信并愿意表达的,不能为了流量强行制造立场。\r\n\r\n## 素材边界\r\n\r\n先区分来源事实、用户提供的第一手经历、可验证的背景知识和写作者判断。第一手观察、真实经历、情绪节点和核心创意只能来自用户或内容来源。不得替用户编造试用过程、人物对话、精确数字、现场反应或私人关系。\r\n\r\n当素材不足时,保留信息缺口,用诚实的限定语表达,或者调整成不依赖虚构经历的观察视角。\r\n\r\n## 文章原型\r\n\r\n- 调查实验型:围绕「我替读者实际验证了一件事」展开,重点是过程、意外和发现的递进。只有材料明确提供真实实验时才能使用第一人称。\r\n- 产品体验型:带读者进入真实使用场景,展示操作、结果、感受和限制。\r\n- 现象解读型:按观察、好奇、研究、判断的路径推进,从表面现象逐层追问。\r\n- 工具分享型:用一个真实问题引出工具,用具体案例证明价值,同时交代限制和成本。\r\n- 方法论分享型:每一部分都给出可执行动作,并坦诚说明学习曲线、失败点和适用边界。\r\n\r\n## 开头\r\n\r\n从内容来源中真实存在的当下事件、具体场景、反常事实或问题切入。前三段就让读者知道发生了什么,以及为什么值得继续看。禁止使用「在当今快速发展的时代」「随着技术不断进步」等教科书式空话。\r\n\r\n开头可以直接启动叙事,也可以抛出一个来源支持的荒诞事实、热点变化或好奇心。不要在开头先解释全文结构。\r\n\r\n## 推进与节奏\r\n\r\n文章像和朋友认真聊天,而不是提交报告。句子长短交替,段落保持轻盈,关键判断可以独立成段。每次展开背景、案例或类比之后,用一句简短的话扣回主线,避免读者为了理解结构而回头。\r\n\r\n一个内容板块通常包含:明确观点、具体事实或案例、与读者处境的连接,以及扣回主线的转场。知识要像聊天过程中自然拿出来的补充,不使用「下面科普一下」式的讲义口吻。\r\n\r\n涉及多个产品、模型或案例时,逐一展示,不要一次罗列所有结论。顺序从基础发现推进到最有反差的结果,让每一轮比上一轮更深入或更意外。\r\n\r\n## 判断与同理心\r\n\r\n可以有明确好恶,但不要居高临下。讨论争议观点时,先把另一方的真实处境具体化,承认其合理部分,再给出自己的不同判断。\r\n\r\n需要从具体事件连接到文化、历史或哲学背景时,连接必须服务于当前问题,并且由来源或可靠知识支持。不要为了显得深刻强行升华。\r\n\r\n## 真实感\r\n\r\n优先使用具体产品名、动作、限制、结果和环境细节,避免「某个模型」「相关技术」「非常震撼」等空泛表达。情绪要落在可观察的反应上,但这些反应必须来自真实材料。\r\n\r\n可以使用自然口语和少量不完整句制造呼吸感,但不能机械堆砌口头禅、粗口、夸张标点或模板作者的个人习惯。目标是吸收节奏方法,不是复刻某个人的身份特征。\r\n\r\n## 结构\r\n\r\n典型长文可以采用以下推进关系:\r\n\r\n1. 用具体事件或场景快速建立好奇心。\r\n2. 用聊天式背景补齐非专业读者需要的信息。\r\n3. 围绕核心判断展开若干板块,每个板块都有事实或案例支撑。\r\n4. 在必要时连接更大的文化、历史或行业背景。\r\n5. 回到开头的意象、问题或判断,以回环、余韵或明确行动收尾。\r\n\r\n除非文章本身是「N 条方法」等条目型内容,否则不要滥用 Markdown 小标题和列表。优先用自然转场形成连续阅读体验。不要自动添加上游 Skill 中属于原作者账号的固定署名、邮箱或关注引导。\r\n\r\n## 语言禁区\r\n\r\n- 不使用「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等套话组织文章。\r\n- 不堆砌加粗、项目符号和形式整齐但内容空泛的排比。\r\n- 不用假设性第一人称故事替代真实案例。\r\n- 不把所有观点包装成绝对结论,保留来源和认知边界。\r\n- 不为了模仿风格而强制使用粗口、特殊标点或原作者口癖。\r\n\r\n## 收尾\r\n\r\n从文章已经建立的内容自然收束。可以回到开头的物件或问题,可以留下简短判断,也可以给出读者今天能做的一件事。避免总结全文、重复观点和强行拔高。",+ "article": "# 卡兹克公众号长文写作\r\n\r\n本模板接入自 `KKKKhazix/khazix-skills` 中的 `khazix-writer`。它提取原 Skill 的写作方法用于文章生成,不代表原作者本人发言,也不允许冒充「数字生命卡兹克」或自动添加原账号署名、联系方式和固定推广尾部。\r\n\r\n## 核心底色\r\n\r\n- 对新事物保持真实好奇,从「这件事哪里有意思」出发,而不是从宏大结论出发。\r\n- 讲人话,允许明确表达判断和不确定性,避免滴水不漏但没有温度的报告腔。\r\n- 真诚优先。产品有缺点就写缺点,不懂就承认不懂,不用不存在的细节增强戏剧性。\r\n- 观点必须是作者真的相信并愿意表达的,不能为了流量强行制造立场。\r\n\r\n## 素材边界\r\n\r\n先区分来源事实、用户提供的第一手经历、可验证的背景知识和写作者判断。第一手观察、真实经历、情绪节点和核心创意只能来自用户或内容来源。不得替用户编造试用过程、人物对话、精确数字、现场反应或私人关系。\r\n\r\n当素材不足时,保留信息缺口,用诚实的限定语表达,或者调整成不依赖虚构经历的观察视角。\r\n\r\n## 文章原型\r\n\r\n- 调查实验型:围绕「我替读者实际验证了一件事」展开,重点是过程、意外和发现的递进。只有材料明确提供真实实验时才能使用第一人称。\r\n- 产品体验型:带读者进入真实使用场景,展示操作、结果、感受和限制。\r\n- 现象解读型:按观察、好奇、研究、判断的路径推进,从表面现象逐层追问。\r\n- 工具分享型:用一个真实问题引出工具,用具体案例证明价值,同时交代限制和成本。\r\n- 方法论分享型:每一部分都给出可执行动作,并坦诚说明学习曲线、失败点和适用边界。\r\n\r\n## 开头\r\n\r\n从内容来源中真实存在的当下事件、具体场景、反常事实或问题切入。前三段就让读者知道发生了什么,以及为什么值得继续看。禁止使用「在当今快速发展的时代」「随着技术不断进步」等教科书式空话。\r\n\r\n开头可以直接启动叙事,也可以抛出一个来源支持的荒诞事实、热点变化或好奇心。不要在开头先解释全文结构。\r\n\r\n## 推进与节奏\r\n\r\n文章像和朋友认真聊天,而不是提交报告。句子长短交替,段落保持轻盈,关键判断可以独立成段。每次展开背景、案例或类比之后,用一句简短的话扣回主线,避免读者为了理解结构而回头。\r\n\r\n一个内容板块通常包含:明确观点、具体事实或案例、与读者处境的连接,以及扣回主线的转场。知识要像聊天过程中自然拿出来的补充,不使用「下面科普一下」式的讲义口吻。\r\n\r\n涉及多个产品、模型或案例时,逐一展示,不要一次罗列所有结论。顺序从基础发现推进到最有反差的结果,让每一轮比上一轮更深入或更意外。\r\n\r\n## 判断与同理心\r\n\r\n可以有明确好恶,但不要居高临下。讨论争议观点时,先把另一方的真实处境具体化,承认其合理部分,再给出自己的不同判断。\r\n\r\n需要从具体事件连接到文化、历史或哲学背景时,连接必须服务于当前问题,并且由来源或可靠知识支持。不要为了显得深刻强行升华。\r\n\r\n## 真实感\r\n\r\n优先使用具体产品名、动作、限制、结果和环境细节,避免「某个模型」「相关技术」「非常震撼」等空泛表达。情绪要落在可观察的反应上,但这些反应必须来自真实材料。\r\n\r\n可以使用自然口语和少量不完整句制造呼吸感,但不能机械堆砌口头禅、粗口、夸张标点或模板作者的个人习惯。目标是吸收节奏方法,不是复刻某个人的身份特征。\r\n\r\n## 结构\r\n\r\n典型长文可以采用以下推进关系:\r\n\r\n1. 用具体事件或场景快速建立好奇心。\r\n2. 用聊天式背景补齐非专业读者需要的信息。\r\n3. 围绕核心判断展开若干板块,每个板块都有事实或案例支撑。\r\n4. 在必要时连接更大的文化、历史或行业背景。\r\n5. 回到开头的意象、问题或判断,以回环、余韵或明确行动收尾。\r\n\r\n除非文章本身是「N 条方法」等条目型内容,否则不要滥用 Markdown 小标题和列表。优先用自然转场形成连续阅读体验。不要自动添加上游 Skill 中属于原作者账号的固定署名、邮箱或关注引导。\r\n\r\n## 语言禁区\r\n\r\n- 不使用「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等套话组织文章。\r\n- 不堆砌加粗、项目符号和形式整齐但内容空泛的排比。\r\n- 不用假设性第一人称故事替代真实案例。\r\n- 不把所有观点包装成绝对结论,保留来源和认知边界。\r\n- 不为了模仿风格而强制使用粗口、特殊标点或原作者口癖。\r\n\r\n## 收尾\r\n\r\n从文章已经建立的内容自然收束。可以回到开头的物件或问题,可以留下简短判断,也可以给出读者今天能做的一件事。避免总结全文、重复观点和强行拔高。\n\n# 卡兹克公众号长文写作:四层质检\r\n\r\n成稿后按四层顺序检查并直接修复问题。质检服务于文章质量,不要求在最终文章正文中附带报告。\r\n\r\n## L1 硬性规则\r\n\r\n- 清除「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等报告腔套话。\r\n- 检查是否存在大段加粗、连续列表、教科书式开头和空泛工具名。\r\n- 删除来源不支持的经历、对话、数字、情绪反应和假设性第一人称案例。\r\n- 确认没有原作者署名、联系方式、账号推广或冒充作者身份的表述。\r\n\r\n## L2 风格一致性\r\n\r\n- 开头是否来自具体事件、场景、反常事实或真实问题。\r\n- 长短句、短段落和关键独立句是否形成自然节奏,而不是整齐划一。\r\n- 展开的背景或案例后是否及时扣回主线。\r\n- 口语表达是否自然,是否避免机械堆砌口头禅和夸张标点。\r\n\r\n## L3 内容质量\r\n\r\n- 每个核心观点是否都有来源事实、具体案例或可靠知识支撑。\r\n- 知识是否自然融入叙述,而不是突然切换成讲义。\r\n- 对立观点是否得到公平解释,判断是否建立在理解对方处境之后。\r\n- 调查、体验、解读、工具分享或方法论等文章原型是否采用了对应的推进方式。\r\n- 多个案例是否逐一展开,并形成由浅入深的发现过程。\r\n\r\n## L4 真实感终审\r\n\r\n通读全文,判断它像一个有见识的普通人在认真聊一件打动他的事,还是像模型在整理信息。重点检查情绪是否来自材料、细节是否可信、观点是否有作者自己的判断,以及阅读心流是否在某处中断。\r\n\r\n如果风格技巧比内容本身更醒目,主动降低模仿痕迹,让文章回到事实、观点和读者体验。",+ "review": "# 卡兹克公众号长文写作:四层质检\r\n\r\n成稿后按四层顺序检查并直接修复问题。质检服务于文章质量,不要求在最终文章正文中附带报告。\r\n\r\n## L1 硬性规则\r\n\r\n- 清除「首先、其次、最后」「综上所述」「值得注意的是」「不难发现」「让我们来看看」等报告腔套话。\r\n- 检查是否存在大段加粗、连续列表、教科书式开头和空泛工具名。\r\n- 删除来源不支持的经历、对话、数字、情绪反应和假设性第一人称案例。\r\n- 确认没有原作者署名、联系方式、账号推广或冒充作者身份的表述。\r\n\r\n## L2 风格一致性\r\n\r\n- 开头是否来自具体事件、场景、反常事实或真实问题。\r\n- 长短句、短段落和关键独立句是否形成自然节奏,而不是整齐划一。\r\n- 展开的背景或案例后是否及时扣回主线。\r\n- 口语表达是否自然,是否避免机械堆砌口头禅和夸张标点。\r\n\r\n## L3 内容质量\r\n\r\n- 每个核心观点是否都有来源事实、具体案例或可靠知识支撑。\r\n- 知识是否自然融入叙述,而不是突然切换成讲义。\r\n- 对立观点是否得到公平解释,判断是否建立在理解对方处境之后。\r\n- 调查、体验、解读、工具分享或方法论等文章原型是否采用了对应的推进方式。\r\n- 多个案例是否逐一展开,并形成由浅入深的发现过程。\r\n\r\n## L4 真实感终审\r\n\r\n通读全文,判断它像一个有见识的普通人在认真聊一件打动他的事,还是像模型在整理信息。重点检查情绪是否来自材料、细节是否可信、观点是否有作者自己的判断,以及阅读心流是否在某处中断。\r\n\r\n如果风格技巧比内容本身更醒目,主动降低模仿痕迹,让文章回到事实、观点和读者体验。"}},{@@ -227,12 +227,12 @@"url": "https://github.com/Master-cai/Research-Paper-Writing-Skills","license": "MIT"},- "contentHash": "c8ce7ee2b0d4b815ca672ecea3b7a0cc3a646ab03aa9c306b5dcc072b351bb03",+ "contentHash": "e24e27043c8f492459f87a833b977085792ce600b41227226119a8a164d629dd","stagePrompts": {- "topics": "# Research Paper Writing:科研选题判断\n\n先读取内容来源、研究材料和用户要求,再提出候选选题。选题必须由已有材料支撑,不得虚构实验结果、数据集、基线、引用或研究贡献。\n\n## 候选选题要求\n\n- 明确研究任务、具体技术问题和目标读者,不使用只有领域名的宽泛题目。\n- 说明现有方法的关键局限及其技术原因,且该局限应当正是文章准备讨论或解决的问题。\n- 指出可被材料支持的核心贡献、新见解或实证发现。\n- 给出选题所需的证据基础,例如对比实验、消融实验、案例、论文引用或来源事实。\n- 多个候选应当在研究问题、论证角度或目标章节上真正不同,不只是改写标题。\n\n若材料不足以支持强结论,应缩小范围,改成问题梳理、方法比较、研究综述或待验证假设,并明确证据缺口。",- "outline": "# Research Paper Writing\n\n本模板接入自 `Master-cai/Research-Paper-Writing-Skills`,用于提升科研论文和学术内容的章节结构、段落流畅性、论点证据对齐及审稿人可读性。上游说明其大部分写作知识与方法来自彭思达教授公开的学习笔记和 `pengsida/learning_research`;本模板保留该归属,并将方法适配到 OpenCreator 的写作流程。\n\n## 核心工作流\n\n1. 在润色句子前先明确完整的研究故事:任务、技术问题、贡献、为什么有效,以及需要哪些证据。\n2. 为文章建立紧凑提纲,确保每一节都服务于主问题,每一段只传递一个信息。\n3. 每段首句说明该段作用,后续句子通过因果、对比、结果、细化或例子自然衔接。\n4. 新术语先定义再复用,全文保持术语、符号和概念边界一致。\n5. 摘要和引言中的每个重要主张都必须对应实验、数据或来源证据;没有证据时减弱或删除主张。\n6. 完成章节后执行反向提纲,再以怀疑性的审稿人视角做终审。\n\n## 提纲组织\n\n根据写作目标选择需要的章节,不为凑结构强行加入无关部分。\n\n- 摘要:任务,技术挑战,洞见或贡献,贡献带来的优势,实验结果。\n- 引言:任务与应用,已有方法及其真正局限,本文方案与为什么有效,贡献,实验概览。\n- 相关工作:按技术主题分组,概括共同范式,指出与目标问题相关的局限,并说明本文差异。\n- 方法:先给设置和总体方案;每个模块按动机、设计或执行过程、技术优势展开。\n- 实验:用强基线证明效果,用消融验证关键设计,用困难或分布外场景说明泛化和边界。\n- 结论:重述问题与核心洞见,总结最强证据,坦诚说明适用边界,并给出具体未来方向。\n\n## 段落与论证\n\n每段只承担一种角色,例如定义任务、提出挑战、解释技术原因、描述方法、陈述优势、提供证据或说明局限。段首句应让外部读者立刻理解该段要做什么。\n\n写完后做反向提纲:列出全文主张、各段主题句和各段证据,逐项检查“主题句是否支持主张、证据是否支持主题句”。不能清晰对应的段落应修改、移动或删除。\n\n不要把工作写成“先提出一个幼稚方案,再打补丁”的增量叙事,也不要只堆抽象洞见而隐藏实际方法。清楚说明真正的技术挑战、技术原因、解决机制和可验证优势。\n\n## 来源与真实性\n\n只能使用用户或内容来源中存在的论文、数据、实验、基线、指标、引语和结论。无法验证的信息必须标记为待补充,不得自动编造引用或数值。区分事实、作者主张、实验观察和写作者推断。\n\n## 输出要求\n\n成稿应具有清晰章节和稳定术语。对主要论点,在写作过程中维护“论点、证据、状态”的对应关系;证据不足的状态只能是“需要证据”,不能用更强措辞掩盖缺口。最终正文不必附带内部检查过程,除非用户明确要求。",- "article": "# Research Paper Writing\n\n本模板接入自 `Master-cai/Research-Paper-Writing-Skills`,用于提升科研论文和学术内容的章节结构、段落流畅性、论点证据对齐及审稿人可读性。上游说明其大部分写作知识与方法来自彭思达教授公开的学习笔记和 `pengsida/learning_research`;本模板保留该归属,并将方法适配到 OpenCreator 的写作流程。\n\n## 核心工作流\n\n1. 在润色句子前先明确完整的研究故事:任务、技术问题、贡献、为什么有效,以及需要哪些证据。\n2. 为文章建立紧凑提纲,确保每一节都服务于主问题,每一段只传递一个信息。\n3. 每段首句说明该段作用,后续句子通过因果、对比、结果、细化或例子自然衔接。\n4. 新术语先定义再复用,全文保持术语、符号和概念边界一致。\n5. 摘要和引言中的每个重要主张都必须对应实验、数据或来源证据;没有证据时减弱或删除主张。\n6. 完成章节后执行反向提纲,再以怀疑性的审稿人视角做终审。\n\n## 提纲组织\n\n根据写作目标选择需要的章节,不为凑结构强行加入无关部分。\n\n- 摘要:任务,技术挑战,洞见或贡献,贡献带来的优势,实验结果。\n- 引言:任务与应用,已有方法及其真正局限,本文方案与为什么有效,贡献,实验概览。\n- 相关工作:按技术主题分组,概括共同范式,指出与目标问题相关的局限,并说明本文差异。\n- 方法:先给设置和总体方案;每个模块按动机、设计或执行过程、技术优势展开。\n- 实验:用强基线证明效果,用消融验证关键设计,用困难或分布外场景说明泛化和边界。\n- 结论:重述问题与核心洞见,总结最强证据,坦诚说明适用边界,并给出具体未来方向。\n\n## 段落与论证\n\n每段只承担一种角色,例如定义任务、提出挑战、解释技术原因、描述方法、陈述优势、提供证据或说明局限。段首句应让外部读者立刻理解该段要做什么。\n\n写完后做反向提纲:列出全文主张、各段主题句和各段证据,逐项检查“主题句是否支持主张、证据是否支持主题句”。不能清晰对应的段落应修改、移动或删除。\n\n不要把工作写成“先提出一个幼稚方案,再打补丁”的增量叙事,也不要只堆抽象洞见而隐藏实际方法。清楚说明真正的技术挑战、技术原因、解决机制和可验证优势。\n\n## 来源与真实性\n\n只能使用用户或内容来源中存在的论文、数据、实验、基线、指标、引语和结论。无法验证的信息必须标记为待补充,不得自动编造引用或数值。区分事实、作者主张、实验观察和写作者推断。\n\n## 输出要求\n\n成稿应具有清晰章节和稳定术语。对主要论点,在写作过程中维护“论点、证据、状态”的对应关系;证据不足的状态只能是“需要证据”,不能用更强措辞掩盖缺口。最终正文不必附带内部检查过程,除非用户明确要求。\n\n# Research Paper Writing:投稿前审稿式检查\n\n成稿后以怀疑性的审稿人视角逐项检查并直接修订。检查过程服务于正文质量,默认不作为正文附录输出。\n\n## 硬性约束\n\n- 摘要和引言中的每个重要主张是否技术上正确,并由正文中的实验、数据或来源证据明确支持。\n- 是否存在虚构引用、数据集、基线、指标、实验结果、实现细节或研究贡献。\n- 关键术语、符号、任务边界和结论强度是否前后一致。\n- 每段是否只有一个中心信息,首句能否说明该段作用,句间关系是否清楚。\n\n## 五个审稿维度\n\n1. 贡献:读者能获得什么新知识;创新属于新任务、流程、模块、设计发现还是洞见;是否超出显而易见的增量改动。\n2. 表达:方法是否足够清楚可复现;每个模块是否有明确动机;术语和段落逻辑是否稳定。\n3. 实验强度:是否与近期强基线公平比较;提升是否有意义;是否同时说明优势、失败案例和限制。\n4. 评估完整性:关键设计是否有消融;指标和数据集是否足够;所有主要主张是否有对应验证。\n5. 方法合理性:设置是否现实;假设是否合理;是否需要逐场景调参;新增复杂度和局限是否超过收益。\n\n## 反向提纲与论点证据表\n\n列出主张、各段主题句和证据,检查每一层是否能够向上支撑。为每个主要主张记录:`论点:... | 证据:... | 状态:已支持/需要证据`。状态为“需要证据”时,只能补充证据、减弱结论或删除主张。\n\n重复审阅和修订,直到不存在未处理的高风险拒稿理由。",- "review": "# Research Paper Writing:投稿前审稿式检查\n\n成稿后以怀疑性的审稿人视角逐项检查并直接修订。检查过程服务于正文质量,默认不作为正文附录输出。\n\n## 硬性约束\n\n- 摘要和引言中的每个重要主张是否技术上正确,并由正文中的实验、数据或来源证据明确支持。\n- 是否存在虚构引用、数据集、基线、指标、实验结果、实现细节或研究贡献。\n- 关键术语、符号、任务边界和结论强度是否前后一致。\n- 每段是否只有一个中心信息,首句能否说明该段作用,句间关系是否清楚。\n\n## 五个审稿维度\n\n1. 贡献:读者能获得什么新知识;创新属于新任务、流程、模块、设计发现还是洞见;是否超出显而易见的增量改动。\n2. 表达:方法是否足够清楚可复现;每个模块是否有明确动机;术语和段落逻辑是否稳定。\n3. 实验强度:是否与近期强基线公平比较;提升是否有意义;是否同时说明优势、失败案例和限制。\n4. 评估完整性:关键设计是否有消融;指标和数据集是否足够;所有主要主张是否有对应验证。\n5. 方法合理性:设置是否现实;假设是否合理;是否需要逐场景调参;新增复杂度和局限是否超过收益。\n\n## 反向提纲与论点证据表\n\n列出主张、各段主题句和证据,检查每一层是否能够向上支撑。为每个主要主张记录:`论点:... | 证据:... | 状态:已支持/需要证据`。状态为“需要证据”时,只能补充证据、减弱结论或删除主张。\n\n重复审阅和修订,直到不存在未处理的高风险拒稿理由。"+ "topics": "# Research Paper Writing:科研选题判断\r\n\r\n先读取内容来源、研究材料和用户要求,再提出候选选题。选题必须由已有材料支撑,不得虚构实验结果、数据集、基线、引用或研究贡献。\r\n\r\n## 候选选题要求\r\n\r\n- 明确研究任务、具体技术问题和目标读者,不使用只有领域名的宽泛题目。\r\n- 说明现有方法的关键局限及其技术原因,且该局限应当正是文章准备讨论或解决的问题。\r\n- 指出可被材料支持的核心贡献、新见解或实证发现。\r\n- 给出选题所需的证据基础,例如对比实验、消融实验、案例、论文引用或来源事实。\r\n- 多个候选应当在研究问题、论证角度或目标章节上真正不同,不只是改写标题。\r\n\r\n若材料不足以支持强结论,应缩小范围,改成问题梳理、方法比较、研究综述或待验证假设,并明确证据缺口。",+ "outline": "# Research Paper Writing\r\n\r\n本模板接入自 `Master-cai/Research-Paper-Writing-Skills`,用于提升科研论文和学术内容的章节结构、段落流畅性、论点证据对齐及审稿人可读性。上游说明其大部分写作知识与方法来自彭思达教授公开的学习笔记和 `pengsida/learning_research`;本模板保留该归属,并将方法适配到 OpenCreator 的写作流程。\r\n\r\n## 核心工作流\r\n\r\n1. 在润色句子前先明确完整的研究故事:任务、技术问题、贡献、为什么有效,以及需要哪些证据。\r\n2. 为文章建立紧凑提纲,确保每一节都服务于主问题,每一段只传递一个信息。\r\n3. 每段首句说明该段作用,后续句子通过因果、对比、结果、细化或例子自然衔接。\r\n4. 新术语先定义再复用,全文保持术语、符号和概念边界一致。\r\n5. 摘要和引言中的每个重要主张都必须对应实验、数据或来源证据;没有证据时减弱或删除主张。\r\n6. 完成章节后执行反向提纲,再以怀疑性的审稿人视角做终审。\r\n\r\n## 提纲组织\r\n\r\n根据写作目标选择需要的章节,不为凑结构强行加入无关部分。\r\n\r\n- 摘要:任务,技术挑战,洞见或贡献,贡献带来的优势,实验结果。\r\n- 引言:任务与应用,已有方法及其真正局限,本文方案与为什么有效,贡献,实验概览。\r\n- 相关工作:按技术主题分组,概括共同范式,指出与目标问题相关的局限,并说明本文差异。\r\n- 方法:先给设置和总体方案;每个模块按动机、设计或执行过程、技术优势展开。\r\n- 实验:用强基线证明效果,用消融验证关键设计,用困难或分布外场景说明泛化和边界。\r\n- 结论:重述问题与核心洞见,总结最强证据,坦诚说明适用边界,并给出具体未来方向。\r\n\r\n## 段落与论证\r\n\r\n每段只承担一种角色,例如定义任务、提出挑战、解释技术原因、描述方法、陈述优势、提供证据或说明局限。段首句应让外部读者立刻理解该段要做什么。\r\n\r\n写完后做反向提纲:列出全文主张、各段主题句和各段证据,逐项检查“主题句是否支持主张、证据是否支持主题句”。不能清晰对应的段落应修改、移动或删除。\r\n\r\n不要把工作写成“先提出一个幼稚方案,再打补丁”的增量叙事,也不要只堆抽象洞见而隐藏实际方法。清楚说明真正的技术挑战、技术原因、解决机制和可验证优势。\r\n\r\n## 来源与真实性\r\n\r\n只能使用用户或内容来源中存在的论文、数据、实验、基线、指标、引语和结论。无法验证的信息必须标记为待补充,不得自动编造引用或数值。区分事实、作者主张、实验观察和写作者推断。\r\n\r\n## 输出要求\r\n\r\n成稿应具有清晰章节和稳定术语。对主要论点,在写作过程中维护“论点、证据、状态”的对应关系;证据不足的状态只能是“需要证据”,不能用更强措辞掩盖缺口。最终正文不必附带内部检查过程,除非用户明确要求。",+ "article": "# Research Paper Writing\r\n\r\n本模板接入自 `Master-cai/Research-Paper-Writing-Skills`,用于提升科研论文和学术内容的章节结构、段落流畅性、论点证据对齐及审稿人可读性。上游说明其大部分写作知识与方法来自彭思达教授公开的学习笔记和 `pengsida/learning_research`;本模板保留该归属,并将方法适配到 OpenCreator 的写作流程。\r\n\r\n## 核心工作流\r\n\r\n1. 在润色句子前先明确完整的研究故事:任务、技术问题、贡献、为什么有效,以及需要哪些证据。\r\n2. 为文章建立紧凑提纲,确保每一节都服务于主问题,每一段只传递一个信息。\r\n3. 每段首句说明该段作用,后续句子通过因果、对比、结果、细化或例子自然衔接。\r\n4. 新术语先定义再复用,全文保持术语、符号和概念边界一致。\r\n5. 摘要和引言中的每个重要主张都必须对应实验、数据或来源证据;没有证据时减弱或删除主张。\r\n6. 完成章节后执行反向提纲,再以怀疑性的审稿人视角做终审。\r\n\r\n## 提纲组织\r\n\r\n根据写作目标选择需要的章节,不为凑结构强行加入无关部分。\r\n\r\n- 摘要:任务,技术挑战,洞见或贡献,贡献带来的优势,实验结果。\r\n- 引言:任务与应用,已有方法及其真正局限,本文方案与为什么有效,贡献,实验概览。\r\n- 相关工作:按技术主题分组,概括共同范式,指出与目标问题相关的局限,并说明本文差异。\r\n- 方法:先给设置和总体方案;每个模块按动机、设计或执行过程、技术优势展开。\r\n- 实验:用强基线证明效果,用消融验证关键设计,用困难或分布外场景说明泛化和边界。\r\n- 结论:重述问题与核心洞见,总结最强证据,坦诚说明适用边界,并给出具体未来方向。\r\n\r\n## 段落与论证\r\n\r\n每段只承担一种角色,例如定义任务、提出挑战、解释技术原因、描述方法、陈述优势、提供证据或说明局限。段首句应让外部读者立刻理解该段要做什么。\r\n\r\n写完后做反向提纲:列出全文主张、各段主题句和各段证据,逐项检查“主题句是否支持主张、证据是否支持主题句”。不能清晰对应的段落应修改、移动或删除。\r\n\r\n不要把工作写成“先提出一个幼稚方案,再打补丁”的增量叙事,也不要只堆抽象洞见而隐藏实际方法。清楚说明真正的技术挑战、技术原因、解决机制和可验证优势。\r\n\r\n## 来源与真实性\r\n\r\n只能使用用户或内容来源中存在的论文、数据、实验、基线、指标、引语和结论。无法验证的信息必须标记为待补充,不得自动编造引用或数值。区分事实、作者主张、实验观察和写作者推断。\r\n\r\n## 输出要求\r\n\r\n成稿应具有清晰章节和稳定术语。对主要论点,在写作过程中维护“论点、证据、状态”的对应关系;证据不足的状态只能是“需要证据”,不能用更强措辞掩盖缺口。最终正文不必附带内部检查过程,除非用户明确要求。\n\n# Research Paper Writing:投稿前审稿式检查\r\n\r\n成稿后以怀疑性的审稿人视角逐项检查并直接修订。检查过程服务于正文质量,默认不作为正文附录输出。\r\n\r\n## 硬性约束\r\n\r\n- 摘要和引言中的每个重要主张是否技术上正确,并由正文中的实验、数据或来源证据明确支持。\r\n- 是否存在虚构引用、数据集、基线、指标、实验结果、实现细节或研究贡献。\r\n- 关键术语、符号、任务边界和结论强度是否前后一致。\r\n- 每段是否只有一个中心信息,首句能否说明该段作用,句间关系是否清楚。\r\n\r\n## 五个审稿维度\r\n\r\n1. 贡献:读者能获得什么新知识;创新属于新任务、流程、模块、设计发现还是洞见;是否超出显而易见的增量改动。\r\n2. 表达:方法是否足够清楚可复现;每个模块是否有明确动机;术语和段落逻辑是否稳定。\r\n3. 实验强度:是否与近期强基线公平比较;提升是否有意义;是否同时说明优势、失败案例和限制。\r\n4. 评估完整性:关键设计是否有消融;指标和数据集是否足够;所有主要主张是否有对应验证。\r\n5. 方法合理性:设置是否现实;假设是否合理;是否需要逐场景调参;新增复杂度和局限是否超过收益。\r\n\r\n## 反向提纲与论点证据表\r\n\r\n列出主张、各段主题句和证据,检查每一层是否能够向上支撑。为每个主要主张记录:`论点:... | 证据:... | 状态:已支持/需要证据`。状态为“需要证据”时,只能补充证据、减弱结论或删除主张。\r\n\r\n重复审阅和修订,直到不存在未处理的高风险拒稿理由。",+ "review": "# Research Paper Writing:投稿前审稿式检查\r\n\r\n成稿后以怀疑性的审稿人视角逐项检查并直接修订。检查过程服务于正文质量,默认不作为正文附录输出。\r\n\r\n## 硬性约束\r\n\r\n- 摘要和引言中的每个重要主张是否技术上正确,并由正文中的实验、数据或来源证据明确支持。\r\n- 是否存在虚构引用、数据集、基线、指标、实验结果、实现细节或研究贡献。\r\n- 关键术语、符号、任务边界和结论强度是否前后一致。\r\n- 每段是否只有一个中心信息,首句能否说明该段作用,句间关系是否清楚。\r\n\r\n## 五个审稿维度\r\n\r\n1. 贡献:读者能获得什么新知识;创新属于新任务、流程、模块、设计发现还是洞见;是否超出显而易见的增量改动。\r\n2. 表达:方法是否足够清楚可复现;每个模块是否有明确动机;术语和段落逻辑是否稳定。\r\n3. 实验强度:是否与近期强基线公平比较;提升是否有意义;是否同时说明优势、失败案例和限制。\r\n4. 评估完整性:关键设计是否有消融;指标和数据集是否足够;所有主要主张是否有对应验证。\r\n5. 方法合理性:设置是否现实;假设是否合理;是否需要逐场景调参;新增复杂度和局限是否超过收益。\r\n\r\n## 反向提纲与论点证据表\r\n\r\n列出主张、各段主题句和证据,检查每一层是否能够向上支撑。为每个主要主张记录:`论点:... | 证据:... | 状态:已支持/需要证据`。状态为“需要证据”时,只能补充证据、减弱结论或删除主张。\r\n\r\n重复审阅和修订,直到不存在未处理的高风险拒稿理由。"}},{@@ -303,11 +303,11 @@"url": null,"license": "OpenCreator project"},- "contentHash": "d5918440e881293e62a3eca7f0bedf0f5d1935db725aa769028611b943a291b9",+ "contentHash": "8162254480d02ba3562c93645a7f7556f3975a5824f21a3871b092c562184102","stagePrompts": {- "topics": "# 深度洞察写作规则\n\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。",- "outline": "# 深度洞察写作规则\n\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。",- "article": "# 深度洞察写作规则\n\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。"+ "topics": "# 深度洞察写作规则\r\n\r\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\r\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\r\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\r\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。",+ "outline": "# 深度洞察写作规则\r\n\r\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\r\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\r\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\r\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。",+ "article": "# 深度洞察写作规则\r\n\r\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\r\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\r\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\r\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。"}},{@@ -377,11 +377,11 @@"url": null,"license": "OpenCreator project"},- "contentHash": "63beedb290fd7875ffa552df4f57e58a069fb81cffca488e2bef24b5e952acaa",+ "contentHash": "942ae1404e83913a5d568427f1b0912728ba3c28f0a882bf7fe628bf912b4674","stagePrompts": {- "topics": "# 故事叙事写作规则\n\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。",- "outline": "# 故事叙事写作规则\n\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。",- "article": "# 故事叙事写作规则\n\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。"+ "topics": "# 故事叙事写作规则\r\n\r\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\r\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\r\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\r\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。",+ "outline": "# 故事叙事写作规则\r\n\r\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\r\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\r\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\r\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。",+ "article": "# 故事叙事写作规则\r\n\r\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\r\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\r\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\r\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。"}},{@@ -452,11 +452,11 @@"url": null,"license": "OpenCreator project"},- "contentHash": "690727ca030ce7ccf03e7640596e60b34576f917ffc6a4155420d44e60bcb312",+ "contentHash": "68f6bd3f27b9ad3a66bb05ea0952aba32d6ed09beeb692652216b6758585c854","stagePrompts": {- "topics": "# 实用教程写作规则\n\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。",- "outline": "# 实用教程写作规则\n\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。",- "article": "# 实用教程写作规则\n\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。"+ "topics": "# 实用教程写作规则\r\n\r\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\r\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\r\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\r\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。",+ "outline": "# 实用教程写作规则\r\n\r\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\r\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\r\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\r\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。",+ "article": "# 实用教程写作规则\r\n\r\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\r\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\r\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\r\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。"}},{@@ -526,11 +526,11 @@"url": null,"license": "OpenCreator project"},- "contentHash": "80bce82d0081abc8050eec6d610f74eca0b905a06ef5445a527750fbc7ef5cda",+ "contentHash": "511ffd7f1243713a1c38cf1d3769c7acfbdc85dc3279645db75b1c96b834a7a8","stagePrompts": {- "topics": "# 热点解读写作规则\n\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。",- "outline": "# 热点解读写作规则\n\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。",- "article": "# 热点解读写作规则\n\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。"+ "topics": "# 热点解读写作规则\r\n\r\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\r\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\r\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\r\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。",+ "outline": "# 热点解读写作规则\r\n\r\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\r\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\r\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\r\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。",+ "article": "# 热点解读写作规则\r\n\r\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\r\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\r\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\r\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。"}}]