Skip to content

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.

feat(agent): guide first-run setup and reuse local Codex credentials

Leggett8605a73d696e
diff --git a/.github/workflows/desktop-release.yml b/.github/workflows/desktop-release.yml
index a9f0bdf5..89359839 100644
--- a/.github/workflows/desktop-release.yml
+++ b/.github/workflows/desktop-release.yml
@@ -124,11 +124,22 @@ jobs:
exit 1
fi
- uses: actions/checkout@v4
- - name: Select Xcode for macOS icon appearances
+ - name: 验证并使用 macOS Command Line Tools
if: matrix.platform == 'darwin'
- uses: maxim-lobanov/setup-xcode@v1
- with:
- xcode-version: latest-stable
+ shell: bash
+ run: |
+ set -euo pipefail
+ tools=/Library/Developer/CommandLineTools
+ if [[ ! -d "$tools" ]]; then
+ echo '::error::macOS Command Line Tools 未安装;打包不使用完整 Xcode。'
+ exit 1
+ fi
+ for tool in iconutil codesign; do
+ command -v "$tool" >/dev/null
+ done
+ DEVELOPER_DIR="$tools" xcrun --find notarytool
+ DEVELOPER_DIR="$tools" xcrun --find stapler
+ echo "DEVELOPER_DIR=$tools" >> "$GITHUB_ENV"
- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
with:
diff --git a/README.md b/README.md
index f38447e6..a819e918 100644
--- a/README.md
+++ b/README.md
@@ -323,7 +323,7 @@ pnpm web:dev
Open `http://127.0.0.1:19861/`. The development server starts the local daemon on demand and injects a temporary Runtime token through a same-origin proxy, so no connection token needs to be copied manually.
-On first launch, the Runtime prepares a default project. The composer is ready as soon as the connection completes. To work on the daemon only:
+On first launch, the Runtime prepares a default project and checks local Codex settings. Confirm an existing ChatGPT sign-in or API key to use local Codex, or select a provider and enter its model, endpoint, and API key. The composer is ready after setup. To work on the daemon only:
```bash
pnpm daemon:dev
diff --git a/apps/daemon/src/codex/probe-home.ts b/apps/daemon/src/codex/probe-home.ts
index 821023f7..7374b430 100644
--- a/apps/daemon/src/codex/probe-home.ts
+++ b/apps/daemon/src/codex/probe-home.ts
@@ -80,6 +80,16 @@ export function createCodexIsolatedHome(
};
}
+export function importLocalCodexConfiguration(sourceHome: string, isolatedHome: string): boolean {
+ if (resolve(sourceHome) === resolve(isolatedHome)
+ || (existsSync(join(isolatedHome, 'auth.json')) || existsSync(join(isolatedHome, 'config.toml')))
+ || (!existsSync(join(sourceHome, 'auth.json')) && !existsSync(join(sourceHome, 'config.toml')))) {
+ return false;
+ }
+ createCodexIsolatedHome(sourceHome, isolatedHome);
+ return true;
+}
+
function createMinimalProbeConfig(sourceHome: string, probeHome: string): void {
const sourcePath = join(sourceHome, 'config.toml');
if (!existsSync(sourcePath)) return;
diff --git a/apps/daemon/src/main.ts b/apps/daemon/src/main.ts
index 55ab1dd9..ddd19cfb 100644
--- a/apps/daemon/src/main.ts
+++ b/apps/daemon/src/main.ts
@@ -18,7 +18,7 @@ import {
type RuntimeCapabilityMatrix
} from './codex/capabilities.js';
import { resolveCodexHome } from './codex/home.js';
-import { createCodexIsolatedHome } from './codex/probe-home.js';
+import { createCodexIsolatedHome, importLocalCodexConfiguration } from './codex/probe-home.js';
import {
CODEX_PROBE_TIMEOUT_MS,
probeCodex
@@ -87,6 +87,8 @@ async function main(): Promise<void> {
: codexHome;
if (environment.codexHome === undefined) {
createCodexIsolatedHome(localCodexHome, codexHome);
+ } else if (process.env.OPENCREATOR_LOCAL_CODEX_HOME) {
+ importLocalCodexConfiguration(process.env.OPENCREATOR_LOCAL_CODEX_HOME, codexHome);
}
readOpenCreatorConfig(configFile);
mkdirSync(dataDir, { recursive: true });
diff --git a/apps/daemon/test/unit/codex-probe-home.test.ts b/apps/daemon/test/unit/codex-probe-home.test.ts
index 8983934f..ecac39cc 100644
--- a/apps/daemon/test/unit/codex-probe-home.test.ts
+++ b/apps/daemon/test/unit/codex-probe-home.test.ts
@@ -12,7 +12,8 @@ import { parse } from '@iarna/toml';
import { afterEach, describe, expect, it } from 'vitest';
import {
createCodexIsolatedHome,
- createCodexProbeHome
+ createCodexProbeHome,
+ importLocalCodexConfiguration
} from '../../src/codex/probe-home.js';
let tempDir = '';
@@ -23,6 +24,20 @@ afterEach(() => {
});
describe('Codex Probe 临时 Home', () => {
+ it('imports a local login once and does not overwrite an existing OpenCreator selection', () => {
+ tempDir = mkdtempSync(join(tmpdir(), 'opencreator-codex-import-test-'));
+ const sourceHome = join(tempDir, 'source');
+ const isolatedHome = join(tempDir, 'isolated');
+ mkdirSync(sourceHome);
+ writeFileSync(join(sourceHome, 'auth.json'), '{"OPENAI_API_KEY":"local-secret"}');
+ writeFileSync(join(sourceHome, 'config.toml'), 'model = "local-model"\n');
+ expect(importLocalCodexConfiguration(sourceHome, isolatedHome)).toBe(true);
+ expect(readFileSync(join(isolatedHome, 'auth.json'), 'utf8')).toContain('local-secret');
+ writeFileSync(join(isolatedHome, 'config.toml'), 'model = "user-choice"\n');
+ expect(importLocalCodexConfiguration(sourceHome, isolatedHome)).toBe(false);
+ expect(readFileSync(join(isolatedHome, 'config.toml'), 'utf8')).toContain('user-choice');
+ });
+
it('refreshes the isolated provider from the local Codex home', () => {
tempDir = mkdtempSync(join(tmpdir(), 'opencreator-isolated-provider-test-'));
const sourceHome = join(tempDir, 'source');
diff --git a/apps/desktop/e2e/creator-packaged-app.spec.ts b/apps/desktop/e2e/creator-packaged-app.spec.ts
index 5585032d..1c150163 100644
--- a/apps/desktop/e2e/creator-packaged-app.spec.ts
+++ b/apps/desktop/e2e/creator-packaged-app.spec.ts
@@ -1602,6 +1602,15 @@ async function waitForWorkspace(page: Page): Promise<void> {
await expect.poll(async () => (
await page.evaluate(() => window.opencreatorDesktop?.readBootstrapState())
)?.phase).toBe('ready');
+ const confirmed = await page.evaluate(() => window.localStorage.getItem('opencreator.agent-setup-confirmed.v1') !== null);
+ if (!confirmed) {
+ const setup = page.getByRole('heading', { name: '开始使用 Agent' });
+ await setup.waitFor({ state: 'visible', timeout: 5_000 }).catch(() => undefined);
+ if (await setup.isVisible()) {
+ await page.getByRole('button', { name: '使用本机 Codex,继续' }).click();
+ await expect(setup).toBeHidden();
+ }
+ }
await expect(page.locator('.opencreator-shell')).toBeVisible();
}
diff --git a/apps/desktop/e2e/desktop.spec.ts b/apps/desktop/e2e/desktop.spec.ts
index a89ff9d1..89b8f60b 100644
--- a/apps/desktop/e2e/desktop.spec.ts
+++ b/apps/desktop/e2e/desktop.spec.ts
@@ -45,6 +45,73 @@ const fakeCodexLauncherSource = join(e2eDir, 'fixtures', 'fake-codex-launcher.go
test.describe.configure({ mode: 'serial' });
+test('@package-smoke 全新账号启动时引导配置 Agent,跳过后可重新配置', async () => {
+ const fixture = await launchPackagedDesktop('success', { signedOut: true });
+ try {
+ await waitForRuntimeReady(fixture.page, false);
+ await expect(fixture.page.getByRole('heading', { name: '开始使用 Agent' })).toBeVisible();
+ await expect(fixture.page.getByRole('combobox', { name: '供应商' })).toBeVisible();
+ await expect(fixture.page.getByRole('button', { name: '使用 ChatGPT 登录' })).toHaveCount(0);
+ await fixture.page.getByRole('button', { name: '暂时跳过' }).click();
+ await fixture.page.getByRole('button', { name: '设置', exact: true }).click();
+ await fixture.page.getByRole('button', { name: /AI 服务/ }).click();
+ await expect(fixture.page.getByText('Agent 尚未配置,无法发送任务。')).toBeVisible();
+ await fixture.page.getByRole('button', { name: '配置 Agent' }).click();
+ await expect(fixture.page.getByRole('heading', { name: '开始使用 Agent' })).toBeVisible();
+ } finally {
+ await closeFixture(fixture);
+ }
+});
+
+test('@package-smoke 已有 API 凭据时仍显示复用确认和手动填写入口', async () => {
+ const fixture = await launchPackagedDesktop('success');
+ try {
+ await waitForRuntimeReady(fixture.page, false);
+ await expect(fixture.page.getByRole('heading', { name: '开始使用 Agent' })).toBeVisible();
+ await expect(fixture.page.getByRole('button', { name: '自定义模型服务' })).toBeVisible();
+ await expect(fixture.page.getByText(/API Key 已配置/)).toBeVisible();
+ await expect(fixture.page.getByLabel('API Key')).toHaveCount(0);
+ await fixture.page.getByRole('button', { name: '使用本机 Codex,继续' }).click();
+ await expect(fixture.page.getByRole('heading', { name: '开始使用 Agent' })).toBeHidden();
+ } finally {
+ await closeFixture(fixture);
+ }
+});
+
+test('@package-smoke 自定义 Provider 无 ChatGPT 登录态时可复用已有配置', async () => {
+ const fixture = await launchPackagedDesktop('success', { seedLocalCodexProvider: true });
+ try {
+ await waitForRuntimeReady(fixture.page, false);
+ await expect(fixture.page.getByRole('heading', { name: '开始使用 Agent' })).toBeVisible();
+ await expect(fixture.page.getByText('已找到本机 Codex')).toBeVisible();
+ await expect(fixture.page.getByText(/API Key 已配置 · custom-model/)).toBeVisible();
+ await expect(fixture.page.getByLabel('API Key')).toHaveCount(0);
+ await fixture.page.getByRole('button', { name: '使用本机 Codex,继续' }).click();
+ await expect(fixture.page.getByRole('heading', { name: '开始使用 Agent' })).toBeHidden();
+ expect(existsSync(join(fixture.root, 'codex-home', 'auth.json'))).toBe(false);
+ } finally {
+ await closeFixture(fixture);
+ }
+});
+
+test('首次启动从本机 Codex 导入配置但不修改原目录', async () => {
+ const fixture = await launchPackagedDesktop('success', { seedLocalCodex: true });
+ try {
+ await waitForRuntimeReady(fixture.page, false);
+ const source = join(fixture.root, 'codex-home');
+ const state = await fixture.page.evaluate(() => window.opencreatorDesktop?.readBootstrapState());
+ const imported = state?.codexHome;
+ expect(imported).toBeDefined();
+ if (imported === undefined) throw new Error('Codex home is unavailable');
+ expect(readFileSync(join(imported, 'config.toml'), 'utf8')).toContain('model = "existing-model"');
+ expect(readFileSync(join(source, 'config.toml'), 'utf8')).toBe('model = "existing-model"\n');
+ expect(readFileSync(join(imported, 'auth.json'), 'utf8')).toBe(readFileSync(join(source, 'auth.json'), 'utf8'));
+ await expect(fixture.page.getByRole('button', { name: '使用本机 Codex,继续' })).toBeVisible();
+ } finally {
+ await closeFixture(fixture);
+ }
+});
+
test('打包 App 将旧 Electron 数据当作无关数据且不迁移', async () => {
const fixture = await launchPackagedDesktop('success', {
minimalPath: true,
@@ -1065,6 +1132,9 @@ async function launchPackagedDesktop(
runtimeMode?: 'bundled' | 'external';
seedLegacyData?: boolean;
writeCurrentConfig?: boolean;
+ signedOut?: boolean;
+ seedLocalCodex?: boolean;
+ seedLocalCodexProvider?: boolean;
telemetryUrl?: string;
} = {}
): Promise<DesktopFixture> {
@@ -1076,6 +1146,23 @@ async function launchPackagedDesktop(
: join(root, 'bin');
const stateDir = join(root, 'fake-codex-state');
const codexHome = join(root, 'codex-home');
+ if (options.seedLocalCodex) {
+ mkdirSync(codexHome, { recursive: true });
+ writeFileSync(join(codexHome, 'auth.json'), '{"OPENAI_API_KEY":"existing-key"}');
+ writeFileSync(join(codexHome, 'config.toml'), 'model = "existing-model"\n');
+ }
+ if (options.seedLocalCodexProvider) {
+ mkdirSync(codexHome, { recursive: true });
+ writeFileSync(join(codexHome, 'config.toml'), [
+ 'model = "custom-model"',
+ 'model_provider = "gateway"',
+ '[model_providers.gateway]',
+ 'base_url = "https://gateway.example.test/v1"',
+ 'experimental_bearer_token = "provider-secret"',
+ 'requires_openai_auth = false',
+ ''
+ ].join('\n'));
+ }
const userData = join(root, 'user-data');
writeCodexShim(binDir);
mkdirSync(userData, { recursive: true });
@@ -1120,6 +1207,8 @@ async function launchPackagedDesktop(
OPENCREATOR_CODEX_APPLICATION_ROOTS: join(root, 'Applications'),
OPENCREATOR_E2E_FAKE_CODEX_STATE_DIR: stateDir,
OPENCREATOR_E2E_FAKE_CODEX_MODE: mode,
+ OPENCREATOR_E2E_FAKE_CODEX_SIGNED_OUT: options.signedOut ? '1' : '0',
+ OPENCREATOR_E2E_FAKE_CODEX_CUSTOM_PROVIDER: options.seedLocalCodexProvider ? '1' : '0',
OPENCREATOR_E2E_NODE_BINARY: process.execPath,
OPENCREATOR_E2E_FAKE_CODEX_SCRIPT: fakeCodexScript,
...(options.telemetryUrl === undefined
@@ -1212,7 +1301,7 @@ async function navigateToAppRoute(page: Page, hash: string): Promise<void> {
}, hash);
}
-async function waitForRuntimeReady(page: Page): Promise<void> {
+async function waitForRuntimeReady(page: Page, confirmSetup = true): Promise<void> {
await page.waitForURL(url => (
url.protocol === 'opencreator-app:'
&& url.hostname === 'app'
@@ -1220,6 +1309,16 @@ async function waitForRuntimeReady(page: Page): Promise<void> {
await expect.poll(async () => await page.evaluate(async () => {
return (await window.opencreatorDesktop?.readBootstrapState())?.phase;
})).toBe('ready');
+ if (!confirmSetup) return;
+ const confirmed = await page.evaluate(() => window.localStorage.getItem('opencreator.agent-setup-confirmed.v1') !== null);
+ if (confirmed) return;
+ const setup = page.getByRole('heading', { name: '开始使用 Agent' });
+ await setup.waitFor({ state: 'visible', timeout: 5_000 }).catch(() => undefined);
+ if (!await setup.isVisible()) return;
+ const useLocalCodex = page.getByRole('button', { name: '使用本机 Codex,继续' });
+ if (await useLocalCodex.isVisible()) await useLocalCodex.click();
+ await setup.waitFor({ state: 'hidden', timeout: 3_000 }).catch(() => undefined);
+ if (await setup.isVisible()) await page.getByRole('button', { name: '暂时跳过' }).click();
}
async function runtimeRequest<T>(
diff --git a/apps/desktop/e2e/fixtures/fake-codex.mjs b/apps/desktop/e2e/fixtures/fake-codex.mjs
index ac762ca5..508e16cf 100755
--- a/apps/desktop/e2e/fixtures/fake-codex.mjs
+++ b/apps/desktop/e2e/fixtures/fake-codex.mjs
@@ -193,7 +193,10 @@ async function handleAppServer() {
if (message.method === 'account/read') {
send({
id: message.id,
- result: { account: null, requiresOpenaiAuth: true }
+ result: process.env.OPENCREATOR_E2E_FAKE_CODEX_SIGNED_OUT === '1'
+ || process.env.OPENCREATOR_E2E_FAKE_CODEX_CUSTOM_PROVIDER === '1'
+ ? { account: null, requiresOpenaiAuth: process.env.OPENCREATOR_E2E_FAKE_CODEX_CUSTOM_PROVIDER !== '1' }
+ : { account: { type: 'apiKey' }, requiresOpenaiAuth: false }
});
continue;
}
@@ -202,10 +205,19 @@ async function handleAppServer() {
send({
id: message.id,
result: {
- config: {
- model: 'gpt-5',
- openai_base_url: ''
- },
+ config: process.env.OPENCREATOR_E2E_FAKE_CODEX_CUSTOM_PROVIDER === '1'
+ ? {
+ model: 'custom-model',
+ model_provider: 'gateway',
+ model_providers: {
+ gateway: {
+ base_url: 'https://gateway.example.test/v1',
+ experimental_bearer_token: 'provider-secret',
+ requires_openai_auth: false
+ }
+ }
+ }
+ : { model: 'gpt-5', openai_base_url: '' },
layers: []
}
});
diff --git a/apps/desktop/electron-builder.yml b/apps/desktop/electron-builder.yml
index 545c822e..34ffcb12 100644
--- a/apps/desktop/electron-builder.yml
+++ b/apps/desktop/electron-builder.yml
@@ -70,7 +70,6 @@ afterSign: ./scripts/notarize-after-sign.mjs
mac:
category: public.app-category.developer-tools
extendInfo:
- CFBundleIconName: OpenCreator
CFBundleDevelopmentRegion: zh_CN
CFBundleLocalizations:
- zh_CN
diff --git a/apps/desktop/resources/OpenCreator.icon/icon.json b/apps/desktop/resources/OpenCreator.icon/icon.json
deleted file mode 100644
index fa414687..00000000
--- a/apps/desktop/resources/OpenCreator.icon/icon.json
+++ /dev/null
@@ -1,21 +0,0 @@
-{
- "fill-specializations": [
- { "value": { "solid": "srgb:1.00000,1.00000,1.00000,1.00000" } },
- { "appearance": "dark", "value": { "solid": "srgb:1.00000,1.00000,1.00000,1.00000" } }
- ],
- "groups": [
- {
- "layers": [
- {
- "name": "OpenCreator",
- "image-name": "mark.png",
- "glass": false
- }
- ],
- "shadow": { "kind": "neutral", "opacity": 0 },
- "specular": false,
- "translucency": { "enabled": false, "value": 0 }
- }
- ],
- "supported-platforms": { "squares": ["macOS"] }
-}
diff --git a/apps/desktop/scripts/launch-first-run-test.command b/apps/desktop/scripts/launch-first-run-test.command
new file mode 100755
index 00000000..9de687a4
--- /dev/null
+++ b/apps/desktop/scripts/launch-first-run-test.command
@@ -0,0 +1,26 @@
+#!/bin/zsh
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "$0")" && pwd)"
+app="$script_dir/../release/mac-arm64/OpenCreator.app"
+manifest="$script_dir/../release/opencreator-desktop-build-manifest.json"
+profile="$HOME/Library/Application Support/OpenCreator First Run Test"
+
+if [[ ! -f "$manifest" || ! -f "$app/Contents/Resources/web/index.html" ]]; then
+ print -u2 '请先完成 pnpm desktop:package 和包校验,再运行首启测试。'
+ exit 1
+fi
+
+if [[ "${1:-}" == '--reset' ]]; then
+ rm -rf -- "$profile"
+elif [[ "$#" -ne 0 ]]; then
+ print -u2 '用法:launch-first-run-test.command [--reset]'
+ exit 1
+fi
+
+mkdir -p -- "$profile/config" "$profile/electron" "$profile/Documents"
+print "测试配置目录:$profile"
+print '不会清除已安装 OpenCreator 的配置;如检测到本机 Codex 登录或模型设置,将复制到测试目录供你确认。'
+OPENCREATOR_HOME="$profile/config" \
+OPENCREATOR_DEFAULT_PROJECT_ROOT="$profile/Documents" \
+"$app/Contents/MacOS/OpenCreator" --user-data-dir="$profile/electron"
diff --git a/apps/desktop/scripts/mac-app-icon.mjs b/apps/desktop/scripts/mac-app-icon.mjs
index a828f156..13edaac0 100644
--- a/apps/desktop/scripts/mac-app-icon.mjs
+++ b/apps/desktop/scripts/mac-app-icon.mjs
@@ -1,129 +1,35 @@
import { execFileSync } from 'node:child_process';
-import { copyFileSync, existsSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
+import { mkdtempSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import sharp from 'sharp';
-export function assertMacAppIconRenditions(entries) {
- const images = [];
- for (const appearance of ['NSAppearanceNameAqua', 'NSAppearanceNameDarkAqua']) {
- const stack = entries.find(entry => (
- entry.AssetType === 'IconImageStack'
- && entry.Name === 'OpenCreator'
- && entry.Appearance === appearance
- ));
- const group = entries.find(entry => (
- entry.AssetType === 'IconGroup'
- && entry.Name === 'OpenCreator/Group'
- && entry.Appearance === appearance
- ));
- const background = stack?.Layers?.find(layer => layer.AssetType === 'Color');
- const image = group?.Layers?.find(layer => layer.AssetType === 'Image');
- if (background?.['Color components']?.length !== 4
- || background['Color components'].some(component => component !== 1)
- || !image?.SHA1Digest) {
- throw new Error(`macOS app icon is missing the white backing and image for ${appearance}.`);
- }
- images.push(image.SHA1Digest);
- }
- if (images[0] !== images[1]) {
- throw new Error('macOS light and dark app icons must use the same image.');
- }
-}
-
-export function verifyMacAppIconCatalog(path, options = {}) {
- const run = options.execFileSync ?? execFileSync;
- const entries = JSON.parse(run('xcrun', ['assetutil', '--info', path], {
- encoding: 'utf8', timeout: 30_000
- }));
- assertMacAppIconRenditions(entries);
-}
-
-export async function prepareMacAppIcon(context, options = {}) {
- if (context.electronPlatformName !== 'darwin') return;
-
- const run = options.execFileSync ?? execFileSync;
- const version = run('xcrun', [
- 'actool', '--version', '--output-format', 'human-readable-text'
- ], { encoding: 'utf8', timeout: 30_000 });
- const majorVersion = Number(version.match(/short-bundle-version:\s*(\d+)/)?.[1]);
- if (!Number.isInteger(majorVersion) || majorVersion < 26) {
- throw new Error('macOS app icon appearances require Xcode 26 or newer (actool >= 26).');
- }
-
- const iconName = 'OpenCreator';
- const resources = join(context.packager.projectDir, 'resources');
- const appResources = join(
- context.appOutDir,
- `${context.packager.appInfo.productFilename}.app`,
- 'Contents', 'Resources'
- );
- const temporary = mkdtempSync(join(tmpdir(), 'opencreator-app-icon-'));
+export async function verifyMacAppIcon(iconPath, sourcePath, options = {}) {
+ const temporary = mkdtempSync(join(tmpdir(), 'opencreator-icon-'));
try {
- const source = join(temporary, `${iconName}.icon`);
- const output = join(temporary, 'compiled');
- mkdirSync(join(source, 'Assets'), { recursive: true });
- mkdirSync(output);
- copyFileSync(join(resources, `${iconName}.icon`, 'icon.json'), join(source, 'icon.json'));
- await createMacAppIconMark(
- join(resources, 'icon.png'), join(source, 'Assets', 'mark.png')
- );
- run('xcrun', [
- 'actool', source,
- '--compile', output,
- '--output-format', 'human-readable-text',
- '--output-partial-info-plist', join(output, 'icon-info.plist'),
- '--app-icon', iconName,
- '--include-all-app-icons',
- '--enable-on-demand-resources', 'NO',
- '--target-device', 'mac',
- '--minimum-deployment-target', '12.0',
- '--platform', 'macosx'
- ], { encoding: 'utf8', timeout: 120_000 });
- const catalog = join(output, 'Assets.car');
- if (!existsSync(catalog)) {
- throw new Error('actool did not generate the macOS app icon catalog.');
+ const iconset = join(temporary, 'OpenCreator.iconset');
+ (options.execFileSync ?? execFileSync)('iconutil', [
+ '--convert', 'iconset', '--output', iconset, iconPath
+ ], { encoding: 'utf8', timeout: 30_000 });
+ const source = await sharp(sourcePath).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+ const packaged = await sharp(join(iconset, '[email protected]'))
+ .ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+ if (source.info.width !== 1024 || source.info.height !== 1024
+ || packaged.info.width !== source.info.width
+ || packaged.info.height !== source.info.height
+ || !packaged.data.equals(source.data)) {
+ throw new Error('Packaged macOS icon does not match resources/icon.png');
}
- verifyMacAppIconCatalog(catalog, { execFileSync: run });
- mkdirSync(appResources, { recursive: true });
- copyFileSync(catalog, join(appResources, 'Assets.car'));
} finally {
rmSync(temporary, { recursive: true, force: true });
}
}
-export async function createMacAppIconMark(source, destination) {
- const { data, info } = await sharp(source).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
- let left = info.width;
- let top = info.height;
- let right = -1;
- let bottom = -1;
- for (let y = 0; y < info.height; y++) {
- for (let x = 0; x < info.width; x++) {
- const index = (y * info.width + x) * 4;
- const alpha = data[index + 3];
- if (alpha > 0) {
- left = Math.min(left, x);
- top = Math.min(top, y);
- right = Math.max(right, x);
- bottom = Math.max(bottom, y);
- }
- const darkness = 255 - (data[index] + data[index + 1] + data[index + 2]) / 3;
- data[index] = 0;
- data[index + 1] = 0;
- data[index + 2] = 0;
- data[index + 3] = Math.round(alpha * darkness / 255);
- }
- }
- if (right < left || bottom < top) {
- throw new Error('macOS app icon source PNG is empty.');
- }
- const size = Math.max(right - left + 1, bottom - top + 1);
- const cropLeft = Math.max(0, Math.round((left + right - size + 1) / 2));
- const cropTop = Math.max(0, Math.round((top + bottom - size + 1) / 2));
- await sharp(data, { raw: { width: info.width, height: info.height, channels: 4 } })
- .extract({ left: cropLeft, top: cropTop, width: size, height: size })
- .resize(1024, 1024)
- .png()
- .toFile(destination);
+export async function prepareMacAppIcon(context) {
+ if (context.electronPlatformName !== 'darwin') return;
+ await verifyMacAppIcon(
+ join(context.appOutDir, `${context.packager.appInfo.productFilename}.app`,
+ 'Contents', 'Resources', 'icon.icns'),
+ join(context.packager.projectDir, 'resources', 'icon.png')
+ );
}
diff --git a/apps/desktop/scripts/verify-package.mjs b/apps/desktop/scripts/verify-package.mjs
index 97fa5c1b..76943f3e 100644
--- a/apps/desktop/scripts/verify-package.mjs
+++ b/apps/desktop/scripts/verify-package.mjs
@@ -40,7 +40,7 @@ import {
findPythonRuntimeMarker,
verifyStickmanBuildBinding
} from './package-content-contract.mjs';
-import { verifyMacAppIconCatalog } from './mac-app-icon.mjs';
+import { verifyMacAppIcon } from './mac-app-icon.mjs';
const scriptDir = dirname(fileURLToPath(import.meta.url));
const desktopDir = resolve(scriptDir, '..');
@@ -109,7 +109,7 @@ assertExists(join(daemonDir, 'runtime', 'opencreator-runtime', 'SKILL.md'));
assertExists(join(daemonDir, 'runtime', 'opencreator-runtime', 'manifest.json'));
assertAsarContents();
-assertBrandingContents();
+await assertBrandingContents();
assertDaemonContents();
assertCreatorPresetContents();
assertWebContents();
@@ -211,7 +211,7 @@ function assertAsarContents() {
}
}
-function assertBrandingContents() {
+async function assertBrandingContents() {
const desktopResourcesDir = join(resourcesDir, 'desktop-resources');
const sourceResourcesDir = resolve(desktopDir, 'resources');
const packagedIcon = join(desktopResourcesDir, 'icon.png');
@@ -234,16 +234,15 @@ function assertBrandingContents() {
}
if (targetPlatform === 'darwin') {
- assertExists(join(resourcesDir, 'icon.icns'));
- const catalog = join(resourcesDir, 'Assets.car');
- assertExists(catalog);
- verifyMacAppIconCatalog(catalog);
- const iconName = spawnSync('plutil', [
- '-extract', 'CFBundleIconName', 'raw', '-o', '-',
+ const icon = join(resourcesDir, 'icon.icns');
+ assertExists(icon);
+ await verifyMacAppIcon(icon, sourceIcon);
+ const iconFile = spawnSync('plutil', [
+ '-extract', 'CFBundleIconFile', 'raw', '-o', '-',
join(packageRoot, 'Contents', 'Info.plist')
], { encoding: 'utf8' });
- if (iconName.status !== 0 || iconName.stdout.trim() !== 'OpenCreator') {
- throw new Error('Packaged macOS app does not reference the icon appearance catalog.');
+ if (iconFile.status !== 0 || iconFile.stdout.trim() !== 'icon.icns') {
+ throw new Error('Packaged macOS app does not reference the verified icon.icns.');
}
}
}
diff --git a/apps/desktop/src/main/daemon-manager.ts b/apps/desktop/src/main/daemon-manager.ts
index 424e682a..1a0df001 100644
--- a/apps/desktop/src/main/daemon-manager.ts
+++ b/apps/desktop/src/main/daemon-manager.ts
@@ -1,5 +1,7 @@
import { EventEmitter } from 'node:events';
import { spawn } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
import { utilityProcess, type UtilityProcess } from 'electron';
import type {
DaemonBootstrapEvent,
@@ -316,6 +318,8 @@ export function buildDaemonEnvironment(
? {}
: { OPENCREATOR_CODEX_COMMIT: input.codexCommit }),
CODEX_HOME: input.codexHome,
+ OPENCREATOR_LOCAL_CODEX_HOME: process.env.CODEX_HOME?.trim()
+ || join(input.env.HOME || input.env.USERPROFILE || homedir(), '.codex'),
OPENCREATOR_DATA_DIR: input.dataDir,
...(input.creatorRuntimeRoot === undefined
? {}
diff --git a/apps/desktop/test/daemon-output.test.ts b/apps/desktop/test/daemon-output.test.ts
index f76b58c2..5b14b3d7 100644
--- a/apps/desktop/test/daemon-output.test.ts
+++ b/apps/desktop/test/daemon-output.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
import {
DEFAULT_DAEMON_START_TIMEOUT_MS,
DaemonStartError,
@@ -12,6 +12,7 @@ import {
} from '../src/main/daemon-manager.js';
describe('Daemon stdout parser', () => {
+ afterEach(() => vi.unstubAllEnvs());
it('parses bootstrap events and the final connection without logging assumptions', () => {
expect(parseDaemonOutputLine(JSON.stringify({
type: 'opencreator_daemon_bootstrap',
@@ -109,6 +110,7 @@ describe('Daemon stdout parser', () => {
});
it('passes the product home and exact Codex home to the Daemon', () => {
+ vi.stubEnv('CODEX_HOME', '/Users/demo/.codex-custom');
const environment = buildDaemonEnvironment({
entryPath: '/app/daemon/main.js',
cwd: '/Users/demo',
@@ -129,6 +131,7 @@ describe('Daemon stdout parser', () => {
OPENCREATOR_HOME: '/Users/demo/.opencreator',
OPENCREATOR_DATA_DIR: '/Users/demo/.opencreator/data',
CODEX_HOME: '/Users/demo/.opencreator/runtime/codex',
+ OPENCREATOR_LOCAL_CODEX_HOME: '/Users/demo/.codex-custom',
OPENCREATOR_CODEX_VERSION: '0.149.0',
OPENCREATOR_CODEX_COMMIT: 'bundled-commit',
OPENCREATOR_MANAGED_PARENT_PID: String(process.pid)
diff --git a/apps/desktop/test/mac-app-icon.test.mjs b/apps/desktop/test/mac-app-icon.test.mjs
index d123444d..39c60cd8 100644
--- a/apps/desktop/test/mac-app-icon.test.mjs
+++ b/apps/desktop/test/mac-app-icon.test.mjs
@@ -1,13 +1,10 @@
-import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { copyFileSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
-import { afterEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, describe, expect, it } from 'vitest';
import sharp from 'sharp';
-import {
- assertMacAppIconRenditions,
- createMacAppIconMark,
- prepareMacAppIcon
-} from '../scripts/mac-app-icon.mjs';
+import { prepareMacAppIcon, verifyMacAppIcon } from '../scripts/mac-app-icon.mjs';
const temporaryDirectories = [];
afterEach(() => {
@@ -16,122 +13,53 @@ afterEach(() => {
}
});
-describe('macOS app icon appearances', () => {
- it('preserves the PNG white background and black mark in both appearances', () => {
- const icon = JSON.parse(readFileSync(
- new URL('../resources/OpenCreator.icon/icon.json', import.meta.url), 'utf8'
- ));
- expect(icon['fill-specializations']).toEqual([
- { value: { solid: 'srgb:1.00000,1.00000,1.00000,1.00000' } },
- { appearance: 'dark', value: { solid: 'srgb:1.00000,1.00000,1.00000,1.00000' } }
- ]);
- expect(icon.groups[0].layers[0]['image-name']).toBe('mark.png');
- const config = readFileSync(new URL('../electron-builder.yml', import.meta.url), 'utf8');
- expect(config).toContain('CFBundleIconName: OpenCreator');
- expect(config).toContain('icon: resources/icon.png');
- });
+describe('macOS app icon without Xcode', () => {
+ const source = new URL('../resources/icon.png', import.meta.url).pathname;
- it('extracts the original black mark without the PNG white rounded background', async () => {
- const output = mkdtempSync(join(tmpdir(), 'opencreator-mark-test-'));
- temporaryDirectories.push(output);
- const destination = join(output, 'mark.png');
- await createMacAppIconMark(new URL('../resources/icon.png', import.meta.url).pathname, destination);
- const { data, info } = await sharp(destination).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+ it('uses the same source image in both appearances, with a white background and black mark', async () => {
+ const { data, info } = await sharp(source).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
expect([info.width, info.height]).toEqual([1024, 1024]);
- expect(data[3]).toBe(0);
- let opaque = 0;
- let nonBlack = 0;
+ let white = 0;
+ let black = 0;
for (let index = 0; index < data.length; index += 4) {
- if (data[index] !== 0 || data[index + 1] !== 0 || data[index + 2] !== 0) nonBlack++;
- if (data[index + 3] > 200) opaque++;
- }
- expect(nonBlack).toBe(0);
- expect(opaque).toBeGreaterThan(80_000);
- });
-
- it('does not invoke macOS tools on other platforms', async () => {
- const run = vi.fn();
- for (const platform of ['win32', 'linux']) {
- await prepareMacAppIcon({ electronPlatformName: platform }, { execFileSync: run });
+ if (data[index + 3] < 250) continue;
+ if (data[index] > 245 && data[index + 1] > 245 && data[index + 2] > 245) white++;
+ if (data[index] < 25 && data[index + 1] < 25 && data[index + 2] < 25) black++;
}
- expect(run).not.toHaveBeenCalled();
+ expect(white).toBeGreaterThan(300_000);
+ expect(black).toBeGreaterThan(80_000);
});
- it.each(['16.4', 'unknown'])('requires a supported actool version (%s)', async version => {
- await expect(prepareMacAppIcon(
- { electronPlatformName: 'darwin' },
- { execFileSync: () => `short-bundle-version: ${version}` }
- )).rejects.toThrow(/Xcode 26 or newer/);
+ it('does not use macOS tools on other platforms', async () => {
+ await prepareMacAppIcon({ electronPlatformName: 'win32' });
+ await prepareMacAppIcon({ electronPlatformName: 'linux' });
});
- it('derives from the source PNG and verifies the catalog before installing it', async () => {
- const context = createContext();
- let source;
- const run = vi.fn((_command, args) => {
- if (args.includes('--version')) return 'short-bundle-version: 27.0';
- if (args[0] === 'assetutil') return JSON.stringify(catalogEntries());
- source = args[1];
- expect(existsSync(join(source, 'Assets', 'mark.png'))).toBe(true);
- writeFileSync(join(args[args.indexOf('--compile') + 1], 'Assets.car'), 'icon-catalog');
- return '';
- });
-
- await prepareMacAppIcon(context, { execFileSync: run });
- expect(readFileSync(join(resources(context), 'Assets.car'), 'utf8')).toBe('icon-catalog');
- expect(run.mock.calls[1][1]).toContain('12.0');
- expect(existsSync(source)).toBe(false);
- });
+ it.skipIf(process.platform !== 'darwin')('verifies the generated icon pixels against the source PNG', async () => {
+ const root = mkdtempSync(join(tmpdir(), 'opencreator-icon-test-'));
+ temporaryDirectories.push(root);
+ const iconset = join(root, 'original.iconset');
+ const bundled = join(root, 'icon.icns');
+ mkdirSync(iconset);
+ copyFileSync(source, join(iconset, '[email protected]'));
+ execFileSync('iconutil', ['--convert', 'icns', '--output', bundled, iconset]);
+ await expect(verifyMacAppIcon(bundled, source)).resolves.toBeUndefined();
- it('rejects incomplete or different appearances', () => {
- const entries = catalogEntries();
- expect(() => assertMacAppIconRenditions(entries)).not.toThrow();
- expect(() => assertMacAppIconRenditions(entries.filter(
- entry => entry.Appearance !== 'NSAppearanceNameDarkAqua'
- ))).toThrow(/white backing/);
- entries[2].Layers[0]['Color components'] = [0.1, 0.1, 0.1, 1];
- expect(() => assertMacAppIconRenditions(entries)).toThrow(/white backing/);
- entries[2].Layers[0]['Color components'] = [1, 1, 1, 1];
- entries[3].Layers[0].SHA1Digest = 'different';
- expect(() => assertMacAppIconRenditions(entries)).toThrow(/same image/);
+ const changed = join(root, 'changed.png');
+ await sharp(source).modulate({ brightness: 0.5 }).toFile(changed);
+ await expect(verifyMacAppIcon(bundled, changed)).rejects.toThrow(/does not match/);
});
- it('does not install an absent catalog', async () => {
- const context = createContext();
- await expect(prepareMacAppIcon(context, {
- execFileSync: (_command, args) => (
- args.includes('--version') ? 'short-bundle-version: 27.0' : ''
- )
- })).rejects.toThrow(/did not generate/);
- expect(existsSync(join(resources(context), 'Assets.car'))).toBe(false);
+ it.skipIf(process.platform !== 'darwin')('fails if the macOS icon is absent', async () => {
+ const root = mkdtempSync(join(tmpdir(), 'opencreator-icon-test-'));
+ temporaryDirectories.push(root);
+ await expect(prepareMacAppIcon({
+ electronPlatformName: 'darwin',
+ appOutDir: root,
+ packager: {
+ projectDir: new URL('..', import.meta.url).pathname,
+ appInfo: { productFilename: 'OpenCreator' }
+ }
+ })).rejects.toThrow();
});
});
-
-function createContext() {
- const appOutDir = mkdtempSync(join(tmpdir(), 'opencreator-icon-test-'));
- temporaryDirectories.push(appOutDir);
- return {
- electronPlatformName: 'darwin',
- appOutDir,
- packager: {
- projectDir: new URL('..', import.meta.url).pathname,
- appInfo: { productFilename: 'OpenCreator' }
- }
- };
-}
-
-function resources(context) {
- return join(context.appOutDir, 'OpenCreator.app', 'Contents', 'Resources');
-}
-
-function catalogEntries() {
- return ['NSAppearanceNameAqua', 'NSAppearanceNameDarkAqua'].flatMap(appearance => [
- {
- AssetType: 'IconImageStack', Name: 'OpenCreator', Appearance: appearance,
- Layers: [{ AssetType: 'Color', 'Color components': [1, 1, 1, 1] }]
- },
- {
- AssetType: 'IconGroup', Name: 'OpenCreator/Group', Appearance: appearance,
- Layers: [{ AssetType: 'Image', SHA1Digest: 'same-image' }]
- }
- ]);
-}
diff --git a/apps/web/src/app/App.test.tsx b/apps/web/src/app/App.test.tsx
index 4c183a74..43cfae3b 100644
--- a/apps/web/src/app/App.test.tsx
+++ b/apps/web/src/app/App.test.tsx
@@ -32,6 +32,7 @@ import {
} from './AppController.js';
import { PROJECTS_STORAGE_KEY } from '../features/projects/project-model.js';
import type { OpenCreatorProject } from '../features/projects/project-model.js';
+import { confirmAgentSetup } from '../features/settings/StartupAgentSetup.js';
import type { HostBridge } from '../host/bridge.js';
import type { SubscribeRunEventsInput } from '../runtime/sse.js';
import type { FileTreeNode, WorkspaceFile } from '../services/file-service.js';
@@ -72,8 +73,27 @@ const testCreatorPresets: CreatorPresetSummary[] = [{
]
}];
+const wrappedRuntimeFetches = new WeakMap<NonNullable<AppProps['runtimeFetch']>, NonNullable<AppProps['runtimeFetch']>>();
+
function App(props: AppProps = {}) {
- return <ProductionApp projectNavigationMode="tree" {...props} />;
+ const originalFetch = props.runtimeFetch;
+ const runtimeFetch = originalFetch === undefined ? undefined : async (input: RequestInfo | URL, init?: RequestInit) => {
+ const url = String(input);
+ if (url.endsWith('/codex/readiness') || (url.endsWith('/codex/provider') && init?.method !== 'PATCH')) {
+ try {
+ return await originalFetch(input, init);
+ } catch {
+ return jsonResponse(url.endsWith('/codex/readiness') ? {
+ state: 'ready', codexHome: '/tmp/codex',
+ account: { status: 'ready', accountStatus: 'signed_in' },
+ binary: { status: 'ready' }, protocol: { status: 'ready' }, models: { status: 'ready' }, diagnostics: []
+ } : { baseUrl: '', model: 'gpt-test', apiKeyConfigured: true, authentication: 'api_key' });
+ }
+ }
+ return originalFetch(input, init);
+ };
+ if (originalFetch !== undefined && runtimeFetch !== undefined) wrappedRuntimeFetches.set(originalFetch, runtimeFetch);
+ return <ProductionApp projectNavigationMode="tree" {...props} runtimeFetch={runtimeFetch} />;
}
function navigateToTestRoute(hash: string) {
@@ -84,6 +104,120 @@ function navigateToTestRoute(hash: string) {
describe('App', () => {
beforeEach(() => {
window.history.replaceState(null, '', '#/chat');
+ confirmAgentSetup({
+ readiness: {
+ state: 'ready', mode: 'bundled', version: 'test', commit: null,
+ binaryPath: '/codex', codexHome: '/tmp/codex', checkedAt: new Date(0).toISOString(),
+ account: { status: 'ready', accountStatus: 'signed_in' },
+ binary: { status: 'ready' }, protocol: { status: 'ready' }, models: { status: 'ready' },
+ skills: { status: 'ready' }, toolServer: { status: 'ready' }, diagnostics: []
+ },
+ provider: { baseUrl: '', model: 'gpt-test', apiKeyConfigured: true, authentication: 'api_key' }
+ });
+ });
+
+ it.each(['browser', 'desktop'] as const)(
+ 'guides unauthenticated users in the %s host and restores Agent input after configuration',
+ async hostKind => {
+ const user = userEvent.setup();
+ const hostBridge = createHostBridge();
+ hostBridge.kind = hostKind;
+ hostBridge.readConnectionConfig = async () => ({
+ baseUrl: 'http://127.0.0.1:60764', token: 'runtime-token'
+ });
+ let authenticated = false;
+ const runtimeFetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+ const url = String(input);
+ const projectResponse = handleDefaultProjectApiRequest(url, init);
+ if (projectResponse !== undefined) return projectResponse;
+ if (url.endsWith('/healthz')) return jsonResponse({ ok: true });
+ if (url.endsWith('/codex/status')) return jsonResponse(createCodexStatusResponse());
+ if (url.endsWith('/codex/readiness')) return jsonResponse({
+ state: authenticated ? 'ready' : 'degraded',
+ account: { status: authenticated ? 'ready' : 'not_authenticated', accountStatus: authenticated ? 'signed_in' : 'signed_out' },
+ binary: { status: 'ready' }, protocol: { status: 'ready' }, models: { status: 'ready' }, diagnostics: []
+ });
+ if (url.endsWith('/codex/provider') && init?.method === 'PATCH') {
+ authenticated = true;
+ return jsonResponse({ baseUrl: 'https://api.openai.com/v1', model: 'gpt-test', apiKeyConfigured: true, authentication: 'api_key' });
+ }
+ if (url.endsWith('/codex/provider')) return jsonResponse({ baseUrl: authenticated ? 'https://api.openai.com/v1' : '', model: 'gpt-test', apiKeyConfigured: authenticated, authentication: authenticated ? 'api_key' : 'none' });
+ if (url.includes('/threads?')) return jsonResponse({ threads: [] });
+ throw new Error(`Unexpected request ${url}`);
+ };
+
+ render(<App hostBridge={hostBridge} runtimeFetch={runtimeFetch} />);
+ expect(await screen.findByRole('heading', { name: '开始使用 Agent' })).toBeInTheDocument();
+ expect(screen.queryByLabelText('OpenCreator 导航')).not.toBeInTheDocument();
+ await user.click(screen.getByRole('button', { name: '暂时跳过' }));
+ expect(await screen.findByText('Agent 尚未配置,暂时无法发送任务。')).toBeInTheDocument();
+ await user.click(screen.getByRole('button', { name: '配置 Agent' }));
+ expect(await screen.findByRole('combobox', { name: '供应商' })).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: '使用 ChatGPT 登录' })).not.toBeInTheDocument();
+ await user.click(screen.getByRole('button', { name: '暂时跳过' }));
+ await user.click(screen.getByRole('button', { name: '设置' }));
+ await user.click(await screen.findByRole('button', { name: /AI 服务/ }));
+ await user.click(screen.getByRole('button', { name: '配置 Agent' }));
+ await user.selectOptions(await screen.findByRole('combobox', { name: '供应商' }), 'openai');
+ expect(screen.getByLabelText('模型名称')).toHaveValue('gpt-5.6-sol');
+ await user.type(screen.getByLabelText('API Key'), 'secret');
+ await user.click(screen.getByRole('button', { name: '保存并开始使用' }));
+ await waitFor(() => {
+ expect(screen.queryByRole('heading', { name: '开始使用 Agent' })).not.toBeInTheDocument();
+ expect(window.location.hash).toBe('#/new');
+ });
+ expect(screen.queryByText('Agent 尚未配置,暂时无法发送任务。')).not.toBeInTheDocument();
+
+ cleanup();
+ render(<App hostBridge={hostBridge} runtimeFetch={runtimeFetch} />);
+ await waitFor(() => {
+ expect(screen.queryByText('正在检查 Agent 配置…')).not.toBeInTheDocument();
+ expect(screen.getByLabelText('OpenCreator 导航')).toBeInTheDocument();
+ });
+ expect(screen.queryByRole('heading', { name: '开始使用 Agent' })).not.toBeInTheDocument();
+ }
+ );
+
+ it('asks to confirm an existing ChatGPT login on first run, then remembers that choice while it remains valid', async () => {
+ window.localStorage.clear();
+ const user = userEvent.setup();
+ let signedIn = true;
+ const hostBridge = createHostBridge();
+ hostBridge.readConnectionConfig = async () => ({ baseUrl: 'http://127.0.0.1:60764', token: 'runtime-token' });
+ const runtimeFetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+ const url = String(input);
+ const projectResponse = handleDefaultProjectApiRequest(url, init);
+ if (projectResponse !== undefined) return projectResponse;
+ if (url.endsWith('/healthz')) return jsonResponse({ ok: true });
+ if (url.endsWith('/codex/status')) return jsonResponse(createCodexStatusResponse());
+ if (url.endsWith('/codex/readiness')) return jsonResponse({
+ state: signedIn ? 'ready' : 'degraded', codexHome: '/tmp/codex',
+ account: { status: signedIn ? 'ready' : 'not_authenticated', accountStatus: signedIn ? 'signed_in' : 'signed_out' },
+ binary: { status: 'ready' }, protocol: { status: 'ready' }, models: { status: 'ready' }, diagnostics: []
+ });
+ if (url.endsWith('/codex/provider')) return jsonResponse({
+ baseUrl: '', model: 'gpt-test', apiKeyConfigured: false, authentication: signedIn ? 'chatgpt' : 'none'
+ });
+ if (url.includes('/threads?')) return jsonResponse({ threads: [] });
+ throw new Error(`Unexpected request ${url}`);
+ };
+
+ render(<App hostBridge={hostBridge} runtimeFetch={runtimeFetch} />);
+ expect(await screen.findByText('已找到本机 Codex')).toBeInTheDocument();
+ expect(screen.queryByLabelText('OpenCreator 导航')).not.toBeInTheDocument();
+ await user.click(screen.getByRole('button', { name: '使用本机 Codex,继续' }));
+ await waitFor(() => expect(screen.queryByRole('heading', { name: '开始使用 Agent' })).not.toBeInTheDocument());
+
+ cleanup();
+ render(<App hostBridge={hostBridge} runtimeFetch={runtimeFetch} />);
+ await waitFor(() => expect(screen.getByLabelText('OpenCreator 导航')).toBeInTheDocument());
+ expect(screen.queryByRole('heading', { name: '开始使用 Agent' })).not.toBeInTheDocument();
+
+ cleanup();
+ signedIn = false;
+ render(<App hostBridge={hostBridge} runtimeFetch={runtimeFetch} />);
+ expect(await screen.findByRole('heading', { name: '开始使用 Agent' })).toBeInTheDocument();
+ expect(screen.getByRole('combobox', { name: '供应商' })).toBeInTheDocument();
});
it('maps valid skills and configured MCP servers into Composer commands', () => {
@@ -3662,7 +3796,7 @@ describe('App', () => {
prompt,
resumeMode: 'auto'
});
- expect(sseFetchImpl).toBe(runtimeFetch);
+ expect(sseFetchImpl).toBe(wrappedRuntimeFetches.get(runtimeFetch));
expect(screen.queryByRole('button', { name: /查看运行详情/ })).not.toBeInTheDocument();
expect(screen.queryByText(/当前动态/)).not.toBeInTheDocument();
diff --git a/apps/web/src/app/AppController.tsx b/apps/web/src/app/AppController.tsx
index dfd6f2b5..cd5876b4 100644
--- a/apps/web/src/app/AppController.tsx
+++ b/apps/web/src/app/AppController.tsx
@@ -112,6 +112,13 @@ import type {
DefaultPermissionPreference,
RuntimeStatus
} from '../features/settings/OpenCreatorSettingsView.js';
+import {
+ confirmAgentSetup,
+ isAgentSetupConfirmed,
+ StartupAgentSetup,
+ type AgentSetupSnapshot
+} from '../features/settings/StartupAgentSetup.js';
+import { useLocalizedCopy } from '../i18n/useLocalizedCopy.js';
import type { McpCapabilities } from '../features/settings/McpSettingsView.js';
import { OpenCreatorSidebar } from '../features/shell/OpenCreatorSidebar.js';
import {
@@ -287,6 +294,7 @@ export function AppController(props: AppControllerProps) {
t
} = useAppLanguage();
const appIssues = usePageIssueState('app-controller');
+ const l = useLocalizedCopy();
const persistedNavigation = useMemo(readPersistedNavigation, []);
const initialState = useMemo(
() => createInitialState(props.route, persistedNavigation),
@@ -348,6 +356,8 @@ export function AppController(props: AppControllerProps) {
status: 'disconnected',
message: '正在等待本地服务'
});
+ const [agentSetup, setAgentSetup] = useState<'checking' | 'ready' | 'needed' | 'skipped'>('checking');
+ const [agentSetupSnapshot, setAgentSetupSnapshot] = useState<AgentSetupSnapshot>();
const [runDiagnosticsById, setRunDiagnosticsById] = useState<Record<string, RunDiagnosticsResponse | undefined>>({});
const [runAttachmentsById, setRunAttachmentsById] = useState<Record<string, AttachmentResponse[] | undefined>>({});
const [runContextById, setRunContextById] = useState<Record<string, RunContextResponse | undefined>>({});
@@ -1282,6 +1292,22 @@ export function AppController(props: AppControllerProps) {
};
}, [connectionService]);
+ useEffect(() => {
+ if (connectionState.status !== 'connected' || connectionService === null || agentSetup !== 'checking') return;
+ let canceled = false;
+ void Promise.all([
+ connectionService.getCodexReadiness(), connectionService.getCodexProvider()
+ ]).then(([readiness, provider]) => {
+ if (canceled) return;
+ const snapshot = { readiness, provider };
+ setAgentSetupSnapshot(snapshot);
+ setAgentSetup(isAgentSetupConfirmed(snapshot) ? 'ready' : 'needed');
+ }).catch(() => {
+ if (!canceled) setAgentSetup('needed');
+ });
+ return () => { canceled = true; };
+ }, [agentSetup, connectionService, connectionState.status]);
+
const availabilityProbeStatus = connectionState.status === 'connected'
? connectionState.codexStatus.availabilityProbe?.status
: undefined;
@@ -4233,9 +4259,12 @@ export function AppController(props: AppControllerProps) {
)
|| selectedPendingRunStart !== undefined
|| selectedRunsLoading
- || connectionState.status !== 'connected';
+ || connectionState.status !== 'connected'
+ || agentSetup === 'skipped';
const composerDisabledReason = connectionState.status !== 'connected'
? t('conversation.connectingRuntime')
+ : agentSetup === 'skipped'
+ ? l('请先配置 Agent 模型服务', 'Configure the Agent model service first')
: projectLoadError !== undefined
? t('conversation.checkingTask')
: conversationNeedsProject && currentProject === undefined
@@ -4524,6 +4553,14 @@ export function AppController(props: AppControllerProps) {
onDismiss={() => setPendingMemorySuggestion(undefined)}
/>
) : null}
+ {agentSetup === 'skipped' ? (
+ <div className="startup-agent-banner" role="status">
+ {l('Agent 尚未配置,暂时无法发送任务。', 'Agent is not configured; you cannot send tasks yet.')}
+ <button type="button" onClick={() => setAgentSetup('needed')}>
+ {l('配置 Agent', 'Set up Agent')}
+ </button>
+ </div>
+ ) : null}
{conversationComposer}
{showConversationEmptyState ? creatorDashboard : null}
</div>
@@ -4745,6 +4782,8 @@ export function AppController(props: AppControllerProps) {
cleanupService={cleanupService}
creatorServicesService={creatorServicesService}
codexRuntimeService={connectionService}
+ agentSetupNeeded={agentSetup === 'skipped'}
+ onOpenAgentSetup={() => setAgentSetup('needed')}
memoryService={memoryService}
memoryProjects={memoryProjectOptions}
memoryThreads={memoryThreadOptions}
@@ -4823,7 +4862,7 @@ export function AppController(props: AppControllerProps) {
}
aria-live="polite"
/>
- <AppLayout
+ {agentSetup === 'needed' ? null : <AppLayout
sidebar={
<OpenCreatorSidebar
projects={projects}
@@ -4896,7 +4935,25 @@ export function AppController(props: AppControllerProps) {
mobileSidebarOpen={mobileSidebarOpen}
onOpenMobileSidebar={openMobileSidebar}
onCloseMobileSidebar={dismissMobileSidebar}
- />
+ />}
+ {agentSetup === 'checking' && connectionState.status === 'connected' ? (
+ <main className="startup-agent-setup" role="status">
+ {l('正在检查 Agent 配置…', 'Checking Agent configuration…')}
+ </main>
+ ) : null}
+ {agentSetup === 'needed' && connectionService !== null ? (
+ <StartupAgentSetup
+ service={connectionService}
+ initialSnapshot={agentSetupSnapshot}
+ onReady={snapshot => {
+ confirmAgentSetup(snapshot);
+ setAgentSetupSnapshot(snapshot);
+ setAgentSetup('ready');
+ startNewConversation({ destination: 'home' });
+ }}
+ onSkip={() => setAgentSetup('skipped')}
+ />
+ ) : null}
{projectDropActive ? (
<div className="project-drop-overlay" role="status" aria-live="polite">
<FolderInput aria-hidden="true" size={30} />
diff --git a/apps/web/src/features/settings/CreatorServicesSettingsView.tsx b/apps/web/src/features/settings/CreatorServicesSettingsView.tsx
index 99ecf1b6..b018d1dd 100644
--- a/apps/web/src/features/settings/CreatorServicesSettingsView.tsx
+++ b/apps/web/src/features/settings/CreatorServicesSettingsView.tsx
@@ -43,6 +43,7 @@ import type { CreatorServicesSettingsService } from '../../services/creator-serv
import type { ConnectionService } from '../../services/connection-service.js';
import { IssueList } from '../issues/IssuePresenter.js';
import { usePageIssueState } from '../issues/page-issue-state.js';
+import { inferLlmProviderId, llmProviderOptions } from './llm-provider-selection.js';
import './creator-services-settings.css';
export type CreatorServicesSection = 'text' | 'transcription' | 'tts' | 'image' | 'video';
@@ -550,7 +551,7 @@ function TextModelSettings(props: SettingsGroupProps & {
{props.mode === 'custom' ? <label className="creator-services-field is-wide">
<span>{l('供应商', 'Provider')}</span>
<select value={props.providerId} onChange={event => props.onProviderIdChange(event.target.value)}>
- {Object.values(creatorProviderCatalogById.llm).map(provider => (
+ {llmProviderOptions.map(provider => (
<option key={provider.id} value={provider.id}>{provider.label}</option>
))}
</select>
@@ -615,15 +616,6 @@ function TextModelSettings(props: SettingsGroupProps & {
);
}
-function inferLlmProviderId(baseUrl: string, model: string): string {
- const normalizedUrl = baseUrl.toLowerCase();
- const normalizedModel = model.toLowerCase();
- if (normalizedUrl.includes('deepseek') || normalizedModel.startsWith('deepseek-')) return 'deepseek';
- if (normalizedUrl.includes('minimax') || normalizedModel.startsWith('minimax-')) return 'minimax';
- if (normalizedUrl.includes('openai.com')) return 'openai';
- return 'custom';
-}
-
function validateModelFields(
baseUrl: string,
model: string,
diff --git a/apps/web/src/features/settings/OpenCreatorSettingsView.tsx b/apps/web/src/features/settings/OpenCreatorSettingsView.tsx
index 36ea9939..2efc97c6 100644
--- a/apps/web/src/features/settings/OpenCreatorSettingsView.tsx
+++ b/apps/web/src/features/settings/OpenCreatorSettingsView.tsx
@@ -73,6 +73,8 @@ export type OpenCreatorSettingsViewProps = {
cleanupService?: CleanupSettingsService | null;
creatorServicesService?: CreatorServicesSettingsService | null;
codexRuntimeService?: CodexRuntimeSettingsService | null;
+ agentSetupNeeded?: boolean;
+ onOpenAgentSetup?(): void;
memoryService?: MemorySettingsService | null;
memoryProjects?: MemoryScopeOption[];
memoryThreads?: MemoryScopeOption[];
@@ -168,16 +170,27 @@ export function OpenCreatorSettingsView(props: OpenCreatorSettingsViewProps) {
/>
) : null}
{activeTab === 'ai-services' ? (
- <Suspense fallback={
- <p role="status">{l('正在加载 AI 服务设置…', 'Loading AI service settings…')}</p>
- }>
- <CreatorServicesSettingsView
- connected={props.runtimeStatus.connected}
- service={props.creatorServicesService ?? null}
- modelService={props.codexRuntimeService ?? null}
- initialSection={props.initialSection}
- />
- </Suspense>
+ <>
+ {props.agentSetupNeeded && props.onOpenAgentSetup !== undefined ? (
+ <div className="settings-inline-warning" role="status">
+ {l('Agent 尚未配置,无法发送任务。', 'Agent is not configured; tasks cannot be sent.')}
+ {' '}
+ <button className="settings-secondary-button" type="button" onClick={props.onOpenAgentSetup}>
+ {l('配置 Agent', 'Set up Agent')}
+ </button>
+ </div>
+ ) : null}
+ <Suspense fallback={
+ <p role="status">{l('正在加载 AI 服务设置…', 'Loading AI service settings…')}</p>
+ }>
+ <CreatorServicesSettingsView
+ connected={props.runtimeStatus.connected}
+ service={props.creatorServicesService ?? null}
+ modelService={props.codexRuntimeService ?? null}
+ initialSection={props.initialSection}
+ />
+ </Suspense>
+ </>
) : null}
{activeTab === 'local-components' && props.runtimeDependencies !== undefined ? (
<RuntimeComponentsSettingsView
diff --git a/apps/web/src/features/settings/StartupAgentSetup.test.tsx b/apps/web/src/features/settings/StartupAgentSetup.test.tsx
new file mode 100644
index 00000000..ba5d4717
--- /dev/null
+++ b/apps/web/src/features/settings/StartupAgentSetup.test.tsx
@@ -0,0 +1,195 @@
+import type { CodexProviderConfig, CodexRuntimeReadiness } from '@opencreator/protocol';
+import { cleanup, render, screen, waitFor } from '@testing-library/react';
+import { userEvent } from '@testing-library/user-event';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { LanguageProvider } from '../../i18n/LanguageProvider.js';
+import {
+ availableAgentMode, confirmAgentSetup, isAgentSetupConfirmed,
+ StartupAgentSetup, type AgentSetupService, type AgentSetupSnapshot
+} from './StartupAgentSetup.js';
+
+function readiness(accountStatus: 'signed_out' | 'signed_in' | 'expired', state: 'ready' | 'degraded' | 'blocked' = 'ready'): CodexRuntimeReadiness {
+ return {
+ state,
+ mode: 'bundled', version: 'test', commit: null, binaryPath: '/codex',
+ codexHome: '/tmp/codex', checkedAt: new Date(0).toISOString(),
+ account: { status: accountStatus === 'signed_in' ? 'ready' : 'not_authenticated', accountStatus },
+ binary: { status: 'ready' }, protocol: { status: 'ready' }, models: { status: 'ready' },
+ skills: { status: 'ready' }, toolServer: { status: 'ready' }, diagnostics: []
+ };
+}
+
+function createService(): AgentSetupService {
+ let provider: CodexProviderConfig = { baseUrl: '', model: '', apiKeyConfigured: false, authentication: 'none' };
+ let accountStatus: 'signed_in' | 'signed_out' = 'signed_out';
+ return {
+ getCodexReadiness: vi.fn(async () => readiness(accountStatus)),
+ getCodexProvider: vi.fn(async () => provider),
+ updateCodexProvider: vi.fn(async input => {
+ accountStatus = 'signed_in';
+ provider = { baseUrl: input.baseUrl, model: input.model, apiKeyConfigured: true, authentication: 'api_key' };
+ return provider;
+ })
+ };
+}
+
+function mount(service: AgentSetupService, initialSnapshot?: AgentSetupSnapshot) {
+ const onReady = vi.fn();
+ const onSkip = vi.fn();
+ render(<LanguageProvider initialPreference="zh-CN">
+ <StartupAgentSetup service={service} initialSnapshot={initialSnapshot} onReady={onReady} onSkip={onSkip} />
+ </LanguageProvider>);
+ return { onReady, onSkip };
+}
+
+describe('StartupAgentSetup', () => {
+ afterEach(() => { cleanup(); window.localStorage.clear(); });
+
+ it('only offers reuse for a ready Codex with usable credentials', () => {
+ const provider: CodexProviderConfig = { baseUrl: 'https://gateway.example.test/v1', model: 'model-1', apiKeyConfigured: true, authentication: 'api_key' };
+ expect(availableAgentMode({ readiness: readiness('signed_out', 'degraded'), provider })).toBe('api_key');
+ expect(availableAgentMode({ readiness: readiness('signed_out', 'degraded'), provider: { ...provider, model: '' } })).toBeNull();
+ expect(availableAgentMode({ readiness: readiness('signed_out', 'degraded'), provider: { ...provider, apiKeyConfigured: false } })).toBeNull();
+ expect(availableAgentMode({ readiness: readiness('signed_out', 'degraded'), provider: { ...provider, baseUrl: '' } })).toBeNull();
+ expect(availableAgentMode({ readiness: readiness('signed_out', 'blocked'), provider })).toBeNull();
+ expect(availableAgentMode({ readiness: readiness('expired', 'degraded'), provider: {
+ ...provider, baseUrl: '', apiKeyConfigured: false, authentication: 'chatgpt'
+ } })).toBeNull();
+ });
+
+ it('confirms an existing ChatGPT sign-in without a second detection or a key form', async () => {
+ const service = createService();
+ const provider: CodexProviderConfig = { baseUrl: '', model: 'gpt-test', apiKeyConfigured: false, authentication: 'chatgpt' };
+ const snapshot = { readiness: readiness('signed_in'), provider };
+ const { onReady } = mount(service, snapshot);
+ expect(isAgentSetupConfirmed(snapshot)).toBe(false);
+ expect(screen.getByText('已找到本机 Codex')).toBeInTheDocument();
+ expect(screen.getByText(/ChatGPT 登录 · gpt-test/)).toBeInTheDocument();
+ expect(screen.queryByLabelText('API Key')).not.toBeInTheDocument();
+ await userEvent.setup().click(screen.getByRole('button', { name: '使用本机 Codex,继续' }));
+ expect(onReady).toHaveBeenCalledWith(snapshot);
+ expect(service.getCodexReadiness).not.toHaveBeenCalled();
+ expect(service.getCodexProvider).not.toHaveBeenCalled();
+ expect(service.updateCodexProvider).not.toHaveBeenCalled();
+ });
+
+ it('lets users choose a different provider even when local Codex is available', async () => {
+ const service = createService();
+ const snapshot: AgentSetupSnapshot = { readiness: readiness('signed_in'), provider: {
+ baseUrl: '', model: 'gpt-test', apiKeyConfigured: false, authentication: 'chatgpt'
+ } };
+ const { onReady } = mount(service, snapshot);
+ const user = userEvent.setup();
+ await user.click(screen.getByRole('button', { name: '自定义模型服务' }));
+ expect(screen.getByRole('combobox', { name: '供应商' })).toBeInTheDocument();
+ await user.selectOptions(screen.getByRole('combobox', { name: '供应商' }), 'deepseek');
+ expect(screen.getByLabelText('Base URL')).toHaveValue('https://api.deepseek.com');
+ expect(screen.getByLabelText('模型名称')).toHaveValue('deepseek-v4-pro');
+ await user.type(screen.getByLabelText('API Key'), 'custom-key');
+ await user.click(screen.getByRole('button', { name: '保存并开始使用' }));
+ expect(service.updateCodexProvider).toHaveBeenCalledWith({
+ baseUrl: 'https://api.deepseek.com', model: 'deepseek-v4-pro', apiKey: 'custom-key'
+ });
+ await waitFor(() => expect(onReady).toHaveBeenCalledOnce());
+ });
+
+ it('reuses a custom provider token without ChatGPT login or a second request', async () => {
+ const service = createService();
+ const provider: CodexProviderConfig = { baseUrl: 'https://gateway.example.test/v1', model: 'model-1', apiKeyConfigured: true, authentication: 'api_key' };
+ const snapshot = { readiness: readiness('signed_out', 'degraded'), provider };
+ const { onReady } = mount(service, snapshot);
+ expect(screen.getByText(/API Key 已配置 · model-1/)).toBeInTheDocument();
+ expect(screen.queryByLabelText('API Key')).not.toBeInTheDocument();
+ await userEvent.setup().click(screen.getByRole('button', { name: '使用本机 Codex,继续' }));
+ expect(onReady).toHaveBeenCalledWith(snapshot);
+ expect(service.getCodexReadiness).not.toHaveBeenCalled();
+ expect(service.getCodexProvider).not.toHaveBeenCalled();
+ expect(service.updateCodexProvider).not.toHaveBeenCalled();
+ confirmAgentSetup(snapshot);
+ expect(isAgentSetupConfirmed(snapshot)).toBe(true);
+ expect(isAgentSetupConfirmed({ ...snapshot, provider: { ...provider, apiKeyConfigured: false } })).toBe(false);
+ });
+
+ it('shows provider and API key fields immediately without credentials, never a login action', async () => {
+ const service = createService();
+ const { onReady } = mount(service);
+ const user = userEvent.setup();
+ const providerSelect = await screen.findByRole('combobox', { name: '供应商' });
+ expect(providerSelect).toHaveValue('openai');
+ expect(screen.getByLabelText('Base URL')).toHaveValue('https://api.openai.com/v1');
+ expect(screen.getByLabelText('模型名称')).toHaveValue('gpt-5.6-sol');
+ await user.selectOptions(providerSelect, 'minimax');
+ expect(screen.queryByRole('button', { name: '使用 ChatGPT 登录' })).not.toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: '使用本机 Codex,继续' })).not.toBeInTheDocument();
+ expect(screen.getByLabelText('Base URL')).toHaveValue('https://api.minimax.io');
+ expect(screen.getByLabelText('模型名称')).toHaveValue('MiniMax-M2.7');
+ await user.type(screen.getByLabelText('API Key'), 'secret');
+ await user.click(screen.getByRole('button', { name: '保存并开始使用' }));
+ await waitFor(() => expect(onReady).toHaveBeenCalledOnce());
+ expect(service.updateCodexProvider).toHaveBeenCalledWith({ baseUrl: 'https://api.minimax.io', model: 'MiniMax-M2.7', apiKey: 'secret' });
+ expect(screen.getByLabelText('API Key')).toHaveValue('');
+ });
+
+ it('only reuses a saved key without editing the existing provider', async () => {
+ const service = createService();
+ const provider: CodexProviderConfig = { baseUrl: 'https://gateway.example.test/v1', model: 'model-1', apiKeyConfigured: true, authentication: 'api_key' };
+ const snapshot = { readiness: readiness('signed_out', 'degraded'), provider };
+ const { onReady } = mount(service, snapshot);
+ const user = userEvent.setup();
+ await user.click(screen.getByRole('button', { name: '自定义模型服务' }));
+ await user.clear(screen.getByLabelText('模型名称'));
+ await user.type(screen.getByLabelText('模型名称'), 'new-model');
+ expect(screen.getByRole('button', { name: '保存并开始使用' })).toBeDisabled();
+ await user.clear(screen.getByLabelText('模型名称'));
+ await user.type(screen.getByLabelText('模型名称'), 'model-1');
+ await user.click(screen.getByRole('button', { name: '保存并开始使用' }));
+ expect(onReady).toHaveBeenCalledWith(snapshot);
+ expect(service.updateCodexProvider).not.toHaveBeenCalled();
+ });
+
+ it('retains the key on a failed save', async () => {
+ const service = createService();
+ vi.mocked(service.getCodexReadiness).mockResolvedValue(readiness('signed_out', 'blocked'));
+ const { onReady } = mount(service);
+ const user = userEvent.setup();
+ await user.selectOptions(await screen.findByRole('combobox', { name: '供应商' }), 'openai');
+ await user.type(screen.getByLabelText('API Key'), 'secret');
+ await user.click(screen.getByRole('button', { name: '保存并开始使用' }));
+ expect(await screen.findByRole('alert')).toHaveTextContent('模型服务尚未就绪');
+ expect(screen.getByLabelText('API Key')).toHaveValue('secret');
+ expect(onReady).not.toHaveBeenCalled();
+ });
+
+ it('allows the default OpenAI endpoint without a Base URL', async () => {
+ const service = createService();
+ const { onReady } = mount(service);
+ const user = userEvent.setup();
+ await screen.findByRole('combobox', { name: '供应商' });
+ await user.clear(screen.getByLabelText('Base URL'));
+ await user.type(screen.getByLabelText('API Key'), 'secret');
+ await user.click(screen.getByRole('button', { name: '保存并开始使用' }));
+ expect(service.updateCodexProvider).toHaveBeenCalledWith({ baseUrl: '', model: 'gpt-5.6-sol', apiKey: 'secret' });
+ await waitFor(() => expect(onReady).toHaveBeenCalledOnce());
+ });
+
+ it('retries initial detection after a transient error', async () => {
+ const service = createService();
+ vi.mocked(service.getCodexProvider).mockRejectedValueOnce(new Error('暂时无法读取')).mockResolvedValue({
+ baseUrl: 'https://gateway.example.test/v1', model: 'model-1', apiKeyConfigured: true, authentication: 'api_key'
+ });
+ const { onReady } = mount(service);
+ expect(await screen.findByRole('alert')).toHaveTextContent('暂时无法读取');
+ await userEvent.setup().click(screen.getByRole('button', { name: '重新检测' }));
+ expect(await screen.findByText('已找到本机 Codex')).toBeInTheDocument();
+ await userEvent.setup().click(screen.getByRole('button', { name: '使用本机 Codex,继续' }));
+ expect(onReady).toHaveBeenCalledOnce();
+ });
+
+ it('supports skipping without changing local Codex', async () => {
+ const service = createService();
+ const { onSkip } = mount(service);
+ await userEvent.setup().click(screen.getByRole('button', { name: '暂时跳过' }));
+ expect(onSkip).toHaveBeenCalledOnce();
+ expect(service.updateCodexProvider).not.toHaveBeenCalled();
+ });
+});
diff --git a/apps/web/src/features/settings/StartupAgentSetup.tsx b/apps/web/src/features/settings/StartupAgentSetup.tsx
new file mode 100644
index 00000000..7455b823
--- /dev/null
+++ b/apps/web/src/features/settings/StartupAgentSetup.tsx
@@ -0,0 +1,227 @@
+import { creatorProviderCatalogById, type CodexProviderConfig, type CodexRuntimeReadiness } from '@opencreator/protocol';
+import { useEffect, useRef, useState } from 'react';
+import { useLocalizedCopy } from '../../i18n/useLocalizedCopy.js';
+import type { ConnectionService } from '../../services/connection-service.js';
+import { readJsonFromStorage, writeJsonToStorage } from '../../storage/browser-storage.js';
+import { inferLlmProviderId, llmProviderOptions } from './llm-provider-selection.js';
+import './startup-agent-setup.css';
+
+export type AgentSetupSnapshot = { readiness: CodexRuntimeReadiness; provider: CodexProviderConfig };
+type AgentSetupMode = 'codex' | 'custom';
+const confirmationKey = 'opencreator.agent-setup-confirmed.v1';
+
+export type AgentSetupService = Pick<ConnectionService,
+ | 'getCodexReadiness'
+ | 'getCodexProvider'
+ | 'updateCodexProvider'>;
+
+export function needsAgentSetup(readiness: CodexRuntimeReadiness): boolean {
+ return readiness.account.accountStatus === 'signed_out'
+ || readiness.account.accountStatus === 'expired'
+ || readiness.account.status === 'not_authenticated';
+}
+
+export function availableAgentMode({ readiness, provider }: AgentSetupSnapshot): 'chatgpt' | 'api_key' | null {
+ if (readiness.binary.status !== 'ready' || readiness.protocol.status !== 'ready'
+ || readiness.models.status !== 'ready' || readiness.state === 'blocked') return null;
+ if (provider.authentication === 'chatgpt' && provider.baseUrl.length === 0
+ && !needsAgentSetup(readiness) && readiness.account.status === 'ready') return 'chatgpt';
+ if (provider.authentication === 'api_key' && provider.apiKeyConfigured && provider.model.trim().length > 0
+ && (readiness.account.status === 'ready' && readiness.account.accountStatus === 'signed_in'
+ || readiness.account.status === 'not_authenticated' && readiness.account.accountStatus === 'signed_out'
+ && provider.baseUrl.trim().length > 0)) return 'api_key';
+ return null;
+}
+
+function confirmationValue(snapshot: AgentSetupSnapshot): string {
+ const { readiness, provider } = snapshot;
+ return JSON.stringify([
+ readiness.codexHome, availableAgentMode(snapshot), provider.authentication,
+ provider.baseUrl, provider.model, provider.apiKeyConfigured
+ ]);
+}
+
+export function isAgentSetupConfirmed(snapshot: AgentSetupSnapshot): boolean {
+ return availableAgentMode(snapshot) !== null
+ && readJsonFromStorage<string>(confirmationKey) === confirmationValue(snapshot);
+}
+
+export function confirmAgentSetup(snapshot: AgentSetupSnapshot): void {
+ try {
+ writeJsonToStorage(confirmationKey, confirmationValue(snapshot));
+ } catch {}
+}
+
+export function StartupAgentSetup(props: {
+ service: AgentSetupService;
+ initialSnapshot?: AgentSetupSnapshot;
+ onReady(snapshot: AgentSetupSnapshot): void;
+ onSkip(): void;
+}) {
+ const l = useLocalizedCopy();
+ const activeRef = useRef(true);
+ const [snapshot, setSnapshot] = useState(props.initialSnapshot);
+ const [mode, setMode] = useState<AgentSetupMode>(
+ props.initialSnapshot !== undefined && availableAgentMode(props.initialSnapshot) !== null ? 'codex' : 'custom'
+ );
+ const [providerId, setProviderId] = useState(() => props.initialSnapshot?.provider.baseUrl
+ ? inferLlmProviderId(props.initialSnapshot.provider.baseUrl, props.initialSnapshot.provider.model)
+ : 'openai');
+ const [baseUrl, setBaseUrl] = useState(props.initialSnapshot?.provider.baseUrl || creatorProviderCatalogById.llm.openai?.defaultBaseUrl || '');
+ const [model, setModel] = useState(props.initialSnapshot?.provider.model || creatorProviderCatalogById.llm.openai?.models[0]?.id || '');
+ const [apiKey, setApiKey] = useState('');
+ const [loading, setLoading] = useState(props.initialSnapshot === undefined);
+ const [retryCount, setRetryCount] = useState(0);
+ const [busy, setBusy] = useState(false);
+ const [error, setError] = useState<string>();
+
+ useEffect(() => {
+ activeRef.current = true;
+ return () => { activeRef.current = false; };
+ }, []);
+
+ useEffect(() => {
+ if (props.initialSnapshot !== undefined) return;
+ let canceled = false;
+ void Promise.all([props.service.getCodexReadiness(), props.service.getCodexProvider()])
+ .then(([readiness, provider]) => {
+ if (canceled) return;
+ const next = { readiness, provider };
+ setSnapshot(next);
+ setMode(availableAgentMode(next) === null ? 'custom' : 'codex');
+ setProviderId(provider.baseUrl ? inferLlmProviderId(provider.baseUrl, provider.model) : 'openai');
+ setBaseUrl(provider.baseUrl || creatorProviderCatalogById.llm.openai?.defaultBaseUrl || '');
+ setModel(provider.model || creatorProviderCatalogById.llm.openai?.models[0]?.id || '');
+ })
+ .catch(cause => { if (!canceled) setError(messageOf(cause)); })
+ .finally(() => { if (!canceled) setLoading(false); });
+ return () => { canceled = true; };
+ }, [props.initialSnapshot, props.service, retryCount]);
+
+ const existingMode = snapshot === undefined ? null : availableAgentMode(snapshot);
+ const reusableKey = snapshot?.provider.authentication === 'api_key'
+ && snapshot.provider.apiKeyConfigured && baseUrl.trim() === snapshot.provider.baseUrl
+ && model.trim() === snapshot.provider.model;
+
+ async function saveProvider() {
+ setBusy(true);
+ setError(undefined);
+ try {
+ if (reusableKey && apiKey.trim().length === 0 && snapshot !== undefined && existingMode !== null) {
+ props.onReady(snapshot);
+ return;
+ }
+ if (!reusableKey || apiKey.trim().length > 0) {
+ await props.service.updateCodexProvider({
+ baseUrl, model, ...(apiKey.trim().length === 0 ? {} : { apiKey })
+ });
+ }
+ const [readiness, provider] = await Promise.all([
+ props.service.getCodexReadiness(), props.service.getCodexProvider()
+ ]);
+ if (!activeRef.current) return;
+ const next = { readiness, provider };
+ if (availableAgentMode(next) !== 'api_key') {
+ throw new Error(readiness.diagnostics.join(';') || l('模型服务尚未就绪,请检查配置。', 'The model service is not ready. Check your settings.'));
+ }
+ setApiKey('');
+ props.onReady(next);
+ } catch (cause) {
+ if (activeRef.current) setError(messageOf(cause));
+ } finally {
+ if (activeRef.current) setBusy(false);
+ }
+ }
+
+ function selectProvider(id: string) {
+ const preset = creatorProviderCatalogById.llm[id];
+ if (preset === undefined) return;
+ setProviderId(id);
+ setBaseUrl(preset.defaultBaseUrl ?? '');
+ setModel(preset.models[0]?.id ?? '');
+ setApiKey('');
+ setError(undefined);
+ }
+
+ function skip() {
+ activeRef.current = false;
+ props.onSkip();
+ }
+
+ return (
+ <main className="startup-agent-setup">
+ <section className="startup-agent-setup__card" aria-labelledby="startup-agent-title">
+ <span className="startup-agent-setup__eyebrow">OpenCreator · Agent</span>
+ <h1 id="startup-agent-title">{l('开始使用 Agent', 'Get started with Agent')}</h1>
+ {loading ? <p role="status">{l('正在检查本机 Codex…', 'Checking local Codex…')}</p> : null}
+ {!loading && existingMode !== null ? (
+ <>
+ <p>{l('本机 Codex 已有可用配置,可直接用于 OpenCreator。', 'Your local Codex is ready to use with OpenCreator.')}</p>
+ <div className="startup-agent-setup__detected" role="status">
+ <strong>{l('已找到本机 Codex', 'Local Codex found')}</strong>
+ <span>{existingMode === 'chatgpt'
+ ? l('ChatGPT 登录', 'ChatGPT sign-in')
+ : l('API Key 已配置', 'API key configured')}
+ {snapshot?.provider.model ? ` · ${snapshot.provider.model}` : ''}</span>
+ </div>
+ <div className="startup-agent-setup__choices" role="group" aria-label={l('模型服务来源', 'Model source')}>
+ <button type="button" disabled={busy} aria-pressed={mode === 'codex'} onClick={() => { setMode('codex'); setError(undefined); }}>
+ {l('使用本机 Codex', 'Use local Codex')}
+ </button>
+ <button type="button" disabled={busy} aria-pressed={mode === 'custom'} onClick={() => { setMode('custom'); setError(undefined); }}>
+ {l('自定义模型服务', 'Custom model service')}
+ </button>
+ </div>
+ </>
+ ) : !loading && snapshot !== undefined ? (
+ <p>{l('配置模型服务后即可开始使用 Agent。', 'Set up a model provider to start using Agent.')}</p>
+ ) : null}
+ {!loading && mode === 'codex' && existingMode !== null && snapshot !== undefined ? (
+ <button type="button" className="startup-agent-setup__primary" onClick={() => props.onReady(snapshot)}>
+ {l('使用本机 Codex,继续', 'Use local Codex and continue')}
+ </button>
+ ) : !loading && snapshot !== undefined ? (
+ <form className="startup-agent-setup__form" onSubmit={event => { event.preventDefault(); void saveProvider(); }}>
+ <label>{l('供应商', 'Provider')}
+ <select value={providerId} onChange={event => selectProvider(event.target.value)}>
+ {llmProviderOptions.map(provider => <option key={provider.id} value={provider.id}>{provider.label}</option>)}
+ </select>
+ </label>
+ <label>{l('模型名称', 'Model name')}
+ <input required list="startup-agent-models" value={model} onChange={event => setModel(event.target.value)} placeholder="gpt-5.6-sol" />
+ </label>
+ <datalist id="startup-agent-models">
+ {creatorProviderCatalogById.llm[providerId]?.models.map(option => (
+ <option key={option.id} value={option.id} />
+ ))}
+ </datalist>
+ <label>Base URL
+ <input required={providerId !== 'openai'} type="url" value={baseUrl} onChange={event => setBaseUrl(event.target.value)} placeholder="https://api.openai.com/v1" />
+ </label>
+ <label>API Key
+ <input required={!reusableKey} type="password" autoComplete="new-password" value={apiKey} onChange={event => setApiKey(event.target.value)} />
+ </label>
+ {reusableKey ? <small>{l('现有配置未变,留空可复用 API Key。', 'Leave blank to reuse the existing key when settings are unchanged.')}</small> : null}
+ <button className="startup-agent-setup__primary" type="submit" disabled={busy || model.trim().length === 0
+ || (providerId !== 'openai' && baseUrl.trim().length === 0) || (apiKey.trim().length === 0 && !reusableKey)}>
+ {busy ? l('正在保存…', 'Saving…') : l('保存并开始使用', 'Save and continue')}
+ </button>
+ </form>
+ ) : null}
+ {error === undefined ? null : <p className="startup-agent-setup__error" role="alert">{error}</p>}
+ {error !== undefined && snapshot === undefined && !loading ? (
+ <button type="button" onClick={() => { setLoading(true); setError(undefined); setRetryCount(count => count + 1); }}>
+ {l('重新检测', 'Retry detection')}
+ </button>
+ ) : null}
+ <button className="startup-agent-setup__skip" type="button" onClick={skip}>
+ {l('暂时跳过', 'Skip for now')}
+ </button>
+ </section>
+ </main>
+ );
+}
+
+function messageOf(cause: unknown): string {
+ return cause instanceof Error ? cause.message : String(cause);
+}
diff --git a/apps/web/src/features/settings/llm-provider-selection.ts b/apps/web/src/features/settings/llm-provider-selection.ts
new file mode 100644
index 00000000..4bba156a
--- /dev/null
+++ b/apps/web/src/features/settings/llm-provider-selection.ts
@@ -0,0 +1,12 @@
+import { creatorProviderCatalogById } from '@opencreator/protocol';
+
+export const llmProviderOptions = Object.values(creatorProviderCatalogById.llm);
+
+export function inferLlmProviderId(baseUrl: string, model: string): string {
+ const normalizedUrl = baseUrl.toLowerCase();
+ const normalizedModel = model.toLowerCase();
+ if (normalizedUrl.includes('deepseek') || normalizedModel.startsWith('deepseek-')) return 'deepseek';
+ if (normalizedUrl.includes('minimax') || normalizedModel.startsWith('minimax-')) return 'minimax';
+ if (normalizedUrl.includes('openai.com')) return 'openai';
+ return 'custom';
+}
diff --git a/apps/web/src/features/settings/startup-agent-setup.css b/apps/web/src/features/settings/startup-agent-setup.css
new file mode 100644
index 00000000..cfdb4bee
--- /dev/null
+++ b/apps/web/src/features/settings/startup-agent-setup.css
@@ -0,0 +1,66 @@
+.startup-agent-setup {
+ position: fixed;
+ z-index: 70;
+ inset: 0;
+ display: grid;
+ place-items: center;
+ overflow: auto;
+ padding: max(32px, var(--opencreator-titlebar-height, 0px)) 20px 32px;
+ background: var(--bg);
+}
+
+.startup-agent-setup__card {
+ width: min(100%, 480px);
+ display: grid;
+ gap: 18px;
+ padding: 32px;
+ border: 1px solid var(--border);
+ border-radius: 16px;
+ background: var(--surface);
+}
+
+.startup-agent-setup__eyebrow { color: var(--accent-strong); font-size: 13px; font-weight: 700; }
+.startup-agent-setup__card h1 { margin: 0; font-size: 27px; }
+.startup-agent-setup__card p { margin: 0; color: var(--muted); line-height: 1.6; }
+.startup-agent-setup__card .startup-agent-setup__detected {
+ display: grid;
+ gap: 4px;
+ padding: 12px;
+ border: 1px solid var(--accent);
+ border-radius: 8px;
+ background: var(--surface-2);
+ color: var(--text);
+ overflow-wrap: anywhere;
+}
+.startup-agent-setup__choices { display: flex; gap: 8px; }
+.startup-agent-setup__choices button { flex: 1; }
+.startup-agent-setup__card button,
+.startup-agent-setup__card input,
+.startup-agent-setup__card select {
+ min-height: 40px;
+ padding: 8px 12px;
+ border: 1px solid var(--border);
+ border-radius: 8px;
+ color: var(--text);
+ background: var(--surface-2);
+ font: inherit;
+}
+.startup-agent-setup__choices button[aria-pressed="true"] { border-color: var(--accent); }
+.startup-agent-setup__card button:disabled { opacity: .5; cursor: not-allowed; }
+.startup-agent-setup__form { display: grid; gap: 12px; }
+.startup-agent-setup__form label { display: grid; gap: 6px; font-size: 13px; }
+.startup-agent-setup__form label span,
+.startup-agent-setup__form small { color: var(--muted); }
+.startup-agent-setup__card .startup-agent-setup__primary { background: var(--accent); color: var(--on-accent); border-color: var(--accent); }
+.startup-agent-setup__card .startup-agent-setup__skip { justify-self: center; border: 0; background: transparent; color: var(--muted); }
+.startup-agent-setup__card .startup-agent-setup__error { color: var(--danger); }
+
+.startup-agent-banner {
+ width: min(760px, 100%);
+ margin: 0 auto 10px;
+ padding: 14px;
+ border: 1px solid var(--border);
+ border-radius: 10px;
+ background: var(--surface);
+}
+.startup-agent-banner button { margin-left: 12px; color: var(--accent-strong); background: transparent; border: 0; cursor: pointer; }
diff --git a/docs/zh/README.md b/docs/zh/README.md
index b65074e2..3b799b19 100644
--- a/docs/zh/README.md
+++ b/docs/zh/README.md
@@ -323,7 +323,7 @@ pnpm web:dev
打开 `http://127.0.0.1:19861/`。开发服务器会按需启动本地 daemon,并通过同源代理注入临时 Runtime token,不需要手工复制连接信息。
-首次启动时,Runtime 会准备默认项目;连接完成后输入框即可直接使用。如果只需要调试 daemon:
+首次启动时,Runtime 会准备默认项目,并检查本机 Codex 配置。已有可用登录态或 API Key 时,确认使用本机 Codex 即可;否则在引导页选择供应商并填写模型、Base URL(使用 OpenAI 默认地址时可留空)和 API Key。配置完成后即可使用输入框。如果只需要调试 daemon:
```bash
pnpm daemon:dev
diff --git a/packages/writing-templates/src/generated/catalog.json b/packages/writing-templates/src/generated/catalog.json
index ad7bf591..f6d6586d 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": "6138b9650c64749debc4e47b8174cb1d67bb2b5115efe9e6dedd9a5c495c6dd0",
+ "contentHash": "290ffd63506d5502c5e83c1b711cb841e355cd924333d4b6926cdbc4416fcd67",
"stagePrompts": {
- "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- 技法是否服务于人物和事实;如果技巧比内容更醒目,应主动削弱。"
+ "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- 技法是否服务于人物和事实;如果技巧比内容更醒目,应主动削弱。"
}
},
{
@@ -147,12 +147,12 @@
"url": "https://github.com/KKKKhazix/khazix-skills/blob/main/khazix-writer/SKILL.md",
"license": "MIT"
},
- "contentHash": "13dcacebc8ba4ef7797b2548e42e730325bca15afb337c160392aab4dacdc795",
+ "contentHash": "e2c5e7040fe5439e16d9a07746cf429292a94360df03b35ad213c1fc2db0e628",
"stagePrompts": {
- "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如果风格技巧比内容本身更醒目,主动降低模仿痕迹,让文章回到事实、观点和读者体验。"
+ "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如果风格技巧比内容本身更醒目,主动降低模仿痕迹,让文章回到事实、观点和读者体验。"
}
},
{
@@ -227,12 +227,12 @@
"url": "https://github.com/Master-cai/Research-Paper-Writing-Skills",
"license": "MIT"
},
- "contentHash": "e24e27043c8f492459f87a833b977085792ce600b41227226119a8a164d629dd",
+ "contentHash": "c8ce7ee2b0d4b815ca672ecea3b7a0cc3a646ab03aa9c306b5dcc072b351bb03",
"stagePrompts": {
- "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重复审阅和修订,直到不存在未处理的高风险拒稿理由。"
+ "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重复审阅和修订,直到不存在未处理的高风险拒稿理由。"
}
},
{
@@ -303,11 +303,11 @@
"url": null,
"license": "OpenCreator project"
},
- "contentHash": "8162254480d02ba3562c93645a7f7556f3975a5824f21a3871b092c562184102",
+ "contentHash": "d5918440e881293e62a3eca7f0bedf0f5d1935db725aa769028611b943a291b9",
"stagePrompts": {
- "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- 结尾给出可执行建议或后续观察信号,不重复全文摘要。"
+ "topics": "# 深度洞察写作规则\n\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。",
+ "outline": "# 深度洞察写作规则\n\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。",
+ "article": "# 深度洞察写作规则\n\n- 选题必须包含可验证的问题、明确受众和有信息增量的判断,避免空泛的大词。\n- 大纲先给核心结论,再用事实、数据、案例或来源中的对比逐层论证。\n- 正文区分来源事实与作者判断。二到四个主体章节即可,每个章节回答一个具体问题。\n- 结尾给出可执行建议或后续观察信号,不重复全文摘要。"
}
},
{
@@ -377,11 +377,11 @@
"url": null,
"license": "OpenCreator project"
},
- "contentHash": "942ae1404e83913a5d568427f1b0912728ba3c28f0a882bf7fe628bf912b4674",
+ "contentHash": "63beedb290fd7875ffa552df4f57e58a069fb81cffca488e2bef24b5e952acaa",
"stagePrompts": {
- "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- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。"
+ "topics": "# 故事叙事写作规则\n\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。",
+ "outline": "# 故事叙事写作规则\n\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。",
+ "article": "# 故事叙事写作规则\n\n- 选题从一个有行动、关系或冲突的人物切入,而不是先讲抽象道理。\n- 大纲按场景推进组织,每个场景都必须推动人物、冲突或核心观点发生变化。\n- 正文使用具体动作、对话和环境细节,保持段落节奏;没有来源支持的细节不得补写。\n- 结尾回扣开篇的场景、动作或问题,避免直接喊口号和强行升华。"
}
},
{
@@ -452,11 +452,11 @@
"url": null,
"license": "OpenCreator project"
},
- "contentHash": "68f6bd3f27b9ad3a66bb05ea0952aba32d6ed09beeb692652216b6758585c854",
+ "contentHash": "690727ca030ce7ccf03e7640596e60b34576f917ffc6a4155420d44e60bcb312",
"stagePrompts": {
- "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- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。"
+ "topics": "# 实用教程写作规则\n\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。",
+ "outline": "# 实用教程写作规则\n\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。",
+ "article": "# 实用教程写作规则\n\n- 选题写清目标读者要解决的问题、完成后的具体结果和适用边界。\n- 大纲按执行顺序排列步骤,每一步都说明目的、动作、输入输出和常见风险。\n- 正文优先使用清单、表格、示例和验证方式;命令、版本、数据不得脱离来源臆造。\n- 结尾给出能够逐项核对的完成检查,而不是泛泛总结。"
}
},
{
@@ -526,11 +526,11 @@
"url": null,
"license": "OpenCreator project"
},
- "contentHash": "511ffd7f1243713a1c38cf1d3769c7acfbdc85dc3279645db75b1c96b834a7a8",
+ "contentHash": "80bce82d0081abc8050eec6d610f74eca0b905a06ef5445a527750fbc7ef5cda",
"stagePrompts": {
- "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- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。"
+ "topics": "# 热点解读写作规则\n\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。",
+ "outline": "# 热点解读写作规则\n\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。",
+ "article": "# 热点解读写作规则\n\n- 选题必须指出已确认的事件、受影响对象和一个值得解释的关键问题。\n- 大纲依次组织事实速览、必要背景、影响分析和后续观察信号。\n- 正文明确标记哪些是来源事实、哪些是作者判断;不把推测写成事实。\n- 避免标题党、夸大因果和来源没有支持的数字,结尾保留不确定性。"
}
}
]