文档修改

frontend-web/docs/素材专家检索.md

@@ -32,6 +32,20 @@ ai_writing:
 
 ---
 
+## 1.5 检索关键词数量
+
+素材专家的检索词数量由**用户在写作表单中指定**（「检索关键词数量」输入框，
+范围 `1~10`，默认 `6`）。数量越多素材越全面，但检索与排序更耗时。
+
+- 该参数随 `POST /api/ai-writing/start` 的 `keyword_count` 字段传入，写入 `AIWritingState.keyword_count`。
+- `researcher_node` 用它决定让 LLM 生成多少个检索词、并发检索多少个方向
+  （`EXTRACT_KEYWORDS_USER` prompt 按该数量格式化，`search_keywords = keywords[:keyword_count]`）。
+- 非法值（缺省 / 越界 / 非数字）由前后端双重兜底：后端 `_resolve_keyword_count()`
+  规整到 `[1, 10]`，越界回退默认 `6`。
+- 补充搜索（`re_search`）时用户额外添加的关键词不会被该上限截断。
+
+---
+
 ## 2. 内网接口规格
 
 - **地址**：`http://10.106.57.180:7863/knowledge_base/search_docs_es`

frontend-web/src/open-canvas/api/ai-writing.ts

@@ -21,6 +21,7 @@ export async function startWritingSession(req: AIWritingRequest): Promise<string
       target_audience: req.targetAudience,
       word_count_target: req.wordCountTarget,
       model_name: req.modelName ?? '',
+      keyword_count: req.keywordCount,
     }),
   });
   if (!resp.ok) throw new Error(`启动失败: ${resp.status}`);

frontend-web/src/open-canvas/components/ai-writing/AIWritingForm.tsx

@@ -36,6 +36,7 @@ export function AIWritingForm({ onSubmit, disabled }: AIWritingFormProps) {
   const [articleType, setArticleType] = useState('analysis');
   const [audience, setAudience] = useState('普通读者');
   const [wordCountInput, setWordCountInput] = useState('800');
+  const [keywordCountInput, setKeywordCountInput] = useState('6');
   const [modelName, setModelName] = useState('');
   const [models, setModels] = useState<ModelOption[]>([]);
 
@@ -94,15 +95,27 @@ export function AIWritingForm({ onSubmit, disabled }: AIWritingFormProps) {
     }
   }
 
+  // 检索关键词数量限定 1~10，非法值回退默认 6
+  function handleKeywordCountBlur() {
+    const num = parseInt(keywordCountInput, 10);
+    if (isNaN(num)) {
+      setKeywordCountInput('6');
+    } else {
+      setKeywordCountInput(String(Math.max(1, Math.min(10, num))));
+    }
+  }
+
   function handleSubmit(e: React.FormEvent) {
     e.preventDefault();
     if (!intent.trim()) return;
     const wordCount = Math.max(100, parseInt(wordCountInput, 10) || 800);
+    const keywordCount = Math.max(1, Math.min(10, parseInt(keywordCountInput, 10) || 6));
     onSubmit({
       userIntent: intent.trim(),
       articleType,
       targetAudience: audience.trim() || '普通读者',
       wordCountTarget: wordCount,
+      keywordCount,
       modelName: modelName || undefined,
     });
   }
@@ -158,6 +171,25 @@ export function AIWritingForm({ onSubmit, disabled }: AIWritingFormProps) {
         </div>
       </div>
 
+      <div className="space-y-1.5">
+        <label className="text-xs font-medium text-muted-foreground">检索关键词数量（1~10）</label>
+        <input
+          type="number"
+          min={1}
+          max={10}
+          step={1}
+          className={INPUT_CLASS}
+          placeholder="6"
+          value={keywordCountInput}
+          onChange={(e) => setKeywordCountInput(e.target.value)}
+          onBlur={handleKeywordCountBlur}
+          disabled={disabled}
+        />
+        <p className="text-[11px] text-muted-foreground/70">
+          素材收集专家用几个关键词检索，越多素材越全面但耗时更长。
+        </p>
+      </div>
+
       <div className="space-y-1.5">
         <label className="text-xs font-medium text-muted-foreground">目标读者</label>
         <input

frontend-web/src/open-canvas/components/ai-writing/AIWritingPanel.tsx

@@ -425,6 +425,9 @@ export function AIWritingPanel() {
               <ReqRow label="目标字数">
                 <span className="text-muted-foreground">{state.request.wordCountTarget} 字</span>
               </ReqRow>
+              <ReqRow label="检索关键词数量">
+                <span className="text-muted-foreground">{state.request.keywordCount} 个</span>
+              </ReqRow>
               {state.request.modelName && (
                 <ReqRow label="写作模型">
                   <span className="text-muted-foreground">{state.request.modelName}</span>

frontend-web/src/open-canvas/types/ai-writing.ts

@@ -135,6 +135,8 @@ export interface AIWritingRequest {
   targetAudience: string;
   wordCountTarget: number;
   modelName?: string;
+  /** 素材检索关键词数量（1~10，默认 6） */
+  keywordCount: number;
 }
 
 // ── 流式审核条目 ──────────────────────────────────────────────────────────────