@musnows/scriverse 0.6.3 → 0.6.5

package/dist/public/app.js

@@ -1,7 +1,7 @@
 import { buildRelationshipGraph, createGalaxyRenderer, renderRelationshipMindMap } from "/relationship-graph.js?v=20260728-galaxy-edge-stars-v3";
 import { collapseExcessBlankLines, formatDateTime, normalizeParagraphSpacing } from "/text-formatting.js?v=20260713-saved-at-seconds";
 import { renderMarkdown } from "/markdown.js?v=20260731-no-external-images-v1";
-import { buildAiReferenceScope, findAiMention, listAiMentionOptions } from "/ai-mentions.js?v=20260716-chapter-references";
+import { findAiMention, listAiMentionOptions, mergeAiReferenceScope } from "/ai-mentions.js?v=20260801-context-setting-mention-v1";
 import { shouldShowAiQuickActions } from "/ai-conversation.js?v=20260713-quick-actions";
 import { calculateLineNumberRowHeight, calculateLineNumberRowTop, calculateLineNumberTextOffset, calculateLineNumberTop } from "/line-number-layout.js?v=20260713-row-box-alignment";
 import { buildVditorLineNumberRows } from "/vditor-line-number-layout.js?v=20260729-vditor-line-numbers-v3";
@@ -36,7 +36,7 @@ import {
   taskScopeLabel,
   timelineStatusLabel,
   characterStateFieldLabel
-} from "/display-labels.js?v=20260728-hybrid-search-v1";
+} from "/display-labels.js?v=20260801-google-vertex";
 import { parsePageRoute, serializePageRoute } from "/page-route.js?v=20260731-work-comments-v2";
 import { splitRelationshipKeywordInput, splitRelationshipKeywords, uniqueRelationshipKeywords } from "/relationship-keywords.js?v=20260720-relationship-keyword-chips";
 import { tokenizeVisibleSpaces } from "/whitespace-visualization.js?v=20260718-visible-whitespace";
@@ -110,8 +110,11 @@ const state = {
   aiCitations: [],
   aiReferences: [],
   aiPromptSent: false,
+  aiTaskType: "chat",
+  aiContextScope: { type: "none" },
   aiConversationId: null,
   aiConversations: [],
+  aiRoleplayCharacter: null,
   aiLastMessageAt: null,
   settings: [],
   dirty: false,
@@ -336,6 +339,7 @@ function applyWorkAccessMode() {
   $("#ai-prompt").readOnly = aiReadOnly;
   $("#ai-prompt").setAttribute("aria-readonly", String(aiReadOnly));
   $("#ai-send").classList.toggle("permission-hidden", aiReadOnly);
+  renderAiRoleplayCharacterSelect();
   updateBackgroundTaskCenterVisibility();
   if (proseReadOnly) {
     chapterEditorReadOnly = true;
@@ -1281,7 +1285,7 @@ function aiReferenceKey(reference) {
 }
 
 function aiReferenceKindLabel(reference) {
-  return ({ character: "角色", setting: "设定", chapter: "章节" })[reference.kind] ?? "引用";
+  return ({ character: "角色", setting: "设定", chapter: "章节", "context-settings": "能力" })[reference.kind] ?? "引用";
 }
 
 function createAiReferenceChip(reference) {
@@ -1322,7 +1326,7 @@ function renderAiReferences() {
 
 function renderAiQuickActions() {
   const quickActions = $(".quick-actions");
-  const visible = shouldShowAiQuickActions(state.aiPromptSent);
+  const visible = !state.aiRoleplayCharacter && shouldShowAiQuickActions(state.aiPromptSent);
   quickActions.classList.toggle("hidden", !visible);
   quickActions.setAttribute("aria-hidden", String(!visible));
 }
@@ -1357,7 +1361,15 @@ function updateMessageCreatedAt(message, createdAt) {
 
 function resetAiFeed() {
   state.aiLastMessageAt = null;
-  $("#ai-feed").innerHTML = '<div class="assistant-message"><span class="message-heading"><span>助手</span></span><div class="message-body"><p>选择章节和模型后，可以问答、续写或校对。所有引用都基于已保存正文。</p></div></div>';
+  const roleplayName = state.aiRoleplayCharacter?.name;
+  $("#ai-feed").innerHTML = roleplayName
+    ? `<div class="assistant-message"><span class="message-heading"><span>${esc(roleplayName)}</span></span><div class="message-body"><p>正在扮演 ${esc(roleplayName)}。我只能通过角色卡和与自己有关的记忆回答。</p></div></div>`
+    : '<div class="assistant-message"><span class="message-heading"><span>助手</span></span><div class="message-body"><p>选择章节和模型后，可以问答、续写或校对。所有引用都基于已保存正文。</p></div></div>';
+}
+
+function aiAssistantLabel(suffix = "") {
+  const name = state.aiRoleplayCharacter?.name || "助手";
+  return suffix ? `${name} · ${suffix}` : name;
 }
 
 function createAiContextCompactionDivider({ kind = "conversation", ariaLabel = "已压缩上下文", title = "" } = {}) {
@@ -1462,7 +1474,8 @@ const AI_TOOL_DISPLAY_NAMES = {
   grep: "查询正文关键字",
   search_story_entities: "搜索作品实体",
   read_character_sections: "读取人物 Markdown 章节",
-  search_drafts: "搜索想法"
+  search_drafts: "搜索想法",
+  recall_self: "回忆自身"
 };
 
 const AI_TOOL_DESCRIPTIONS = {
@@ -1471,7 +1484,8 @@ const AI_TOOL_DESCRIPTIONS = {
   grep: "查询正文关键字所在的完整段落及章节信息。",
   search_story_entities: "按实体名、拼音或短关键词混合检索设定、人物、组织等结构化记录；非语义问答。",
   read_character_sections: "读取指定人物 Markdown 档案章节的摘要或原文。",
-  search_drafts: "搜索可能采用、也可能永远不会进入正文或正式设定的未确认临时想法。"
+  search_drafts: "搜索可能采用、也可能永远不会进入正文或正式设定的未确认临时想法。",
+  recall_self: "读取当前扮演角色自己的角色卡、档案，以及自己参与的关系、时间线和正文记忆。"
 };
 
 let aiFeedScrollFrame = null;
@@ -1690,7 +1704,7 @@ function renderAiConversationHistory() {
     const title = document.createElement("strong");
     title.textContent = conversation.title;
     const meta = document.createElement("small");
-    meta.textContent = `${conversation.messageCount} 条 · ${formatDateTime(conversation.updatedAt)}`;
+    meta.textContent = `${conversation.messageCount} 条${conversation.roleplayCharacter?.name ? ` · 扮演 ${conversation.roleplayCharacter.name}` : ""} · ${formatDateTime(conversation.updatedAt)}`;
     button.append(title, meta);
     button.addEventListener("click", () => openAiConversation(conversation.id));
     host.append(button);
@@ -1786,6 +1800,9 @@ async function openAiConversation(conversationId, hideHistory = true) {
   upsertAiConversationSummary(conversation);
   state.aiConversationId = conversation.id;
   state.aiPromptSent = conversation.messages.some((message) => message.role === "user");
+  applyAiConversationTaskType(conversation.taskType);
+  applyAiConversationContextScope(conversation.contextScope);
+  applyAiRoleplayCharacter(conversation.roleplayCharacter);
   resetAiContextMeter();
   $("#ai-conversation-title").textContent = conversation.title;
   resetAiFeed();
@@ -1805,12 +1822,15 @@ async function openAiConversation(conversationId, hideHistory = true) {
   if (hideHistory) setAiHistoryVisible(false);
 }
 
-async function createNewAiConversation() {
+async function createNewAiConversation(taskType = "chat") {
   if (!state.work) return;
-  const conversation = await api(`/api/works/${state.work.id}/ai-conversations`, { method: "POST", body: {} });
+  const conversation = await api(`/api/works/${state.work.id}/ai-conversations`, { method: "POST", body: { taskType } });
   upsertAiConversationSummary(conversation);
   state.aiConversationId = conversation.id;
   state.aiPromptSent = false;
+  applyAiConversationTaskType(conversation.taskType);
+  applyAiConversationContextScope(conversation.contextScope);
+  applyAiRoleplayCharacter(conversation.roleplayCharacter);
   $("#ai-conversation-title").textContent = conversation.title;
   resetAiFeed();
   hideAiContextWarning();
@@ -1819,12 +1839,131 @@ async function createNewAiConversation() {
   setAiHistoryVisible(false);
 }
 
+function renderAiRoleplayCharacterSelect() {
+  const select = $("#ai-roleplay-character");
+  const selectedId = String(state.aiRoleplayCharacter?.id ?? "");
+  const availableCharacters = state.characters.filter((character) => !character.mergedIntoCharacterId);
+  const options = [{ id: "", name: "选择角色卡" }, ...availableCharacters.map((character) => ({
+    id: String(character.id),
+    name: String(character.name)
+  }))];
+  if (selectedId && !options.some((option) => option.id === selectedId)) {
+    options.push({ id: selectedId, name: String(state.aiRoleplayCharacter.name) });
+  }
+  select.replaceChildren(...options.map((option) => {
+    const element = document.createElement("option");
+    element.value = option.id;
+    element.textContent = option.name;
+    return element;
+  }));
+  select.value = selectedId;
+  const canSelectCharacter = Boolean(state.work)
+    && canReadModule("characters")
+    && canWritePermissionModule(state.work, "ai-chat");
+  select.disabled = !canSelectCharacter || state.aiPromptSent;
+  select.title = canSelectCharacter
+    ? "为当前对话选择角色卡；角色扮演时 Agent 只能查询与该角色自身有关的记忆"
+    : "当前账户没有角色模块读取权限";
+}
+
+function syncAiTaskOptions() {
+  const roleplaySelected = $("#ai-task").value === "roleplay";
+  $("#ai-scope").classList.toggle("hidden", roleplaySelected);
+  $("#ai-scope").setAttribute("aria-hidden", String(roleplaySelected));
+  $("#ai-roleplay-character").classList.toggle("hidden", !roleplaySelected);
+  $("#ai-roleplay-character").setAttribute("aria-hidden", String(!roleplaySelected));
+  $("#ai-task").disabled = state.aiPromptSent;
+  $("#ai-task").title = state.aiPromptSent ? "对话开始后不能切换任务类型" : "";
+  $("#ai-scope").disabled = roleplaySelected || state.aiPromptSent;
+  $("#ai-scope").title = state.aiPromptSent
+    ? "对话开始后不能切换上下文引用"
+    : roleplaySelected ? "角色扮演模式只使用角色自身的记忆" : "";
+}
+
+function applyAiConversationTaskType(taskType) {
+  const normalizedTaskType = ["chat", "roleplay", "continue", "polish"].includes(taskType) ? taskType : "chat";
+  state.aiTaskType = normalizedTaskType;
+  $("#ai-task").value = normalizedTaskType;
+  $("#ai-task").dataset.previousValue = normalizedTaskType;
+  syncAiTaskOptions();
+}
+
+function applyAiConversationContextScope(scope) {
+  const normalizedScope = scope && typeof scope === "object" ? JSON.parse(JSON.stringify(scope)) : { type: "none" };
+  state.aiContextScope = normalizedScope;
+  $("#ai-scope").value = normalizedScope.type === "book" ? "book"
+    : normalizedScope.type === "volume" ? "volume"
+    : normalizedScope.type === "chapter" && normalizedScope.includeBookSummary ? "chapter-summary"
+    : normalizedScope.type === "chapter" ? "chapter"
+    : "none";
+  syncAiTaskOptions();
+}
+
+function applyAiRoleplayCharacter(character) {
+  state.aiRoleplayCharacter = character?.id ? character : null;
+  const active = Boolean(state.aiRoleplayCharacter);
+  if (active) $("#ai-scope").value = "none";
+  $(".ai-panel").classList.toggle("is-roleplaying", active);
+  $("#ai-prompt").dataset.placeholder = active
+    ? `以 ${String(state.aiRoleplayCharacter.name)} 的身份开始对话……`
+    : "告诉 AI 你想讨论或修改什么……";
+  renderAiRoleplayCharacterSelect();
+  syncAiTaskOptions();
+  renderAiQuickActions();
+  resetAiContextMeter();
+}
+
+function refreshAiMessageRoleLabels() {
+  $("#ai-feed").querySelectorAll(".assistant-message .message-heading > span").forEach((label) => {
+    label.textContent = aiAssistantLabel();
+  });
+}
+
+async function updateAiRoleplayCharacter(characterId) {
+  const conversationId = await ensureAiConversation();
+  const conversation = await api(`/api/ai-conversations/${conversationId}/roleplay`, {
+    method: "PATCH",
+    body: { characterId: characterId || null }
+  });
+  upsertAiConversationSummary(conversation);
+  applyAiConversationTaskType(conversation.taskType);
+  applyAiRoleplayCharacter(conversation.roleplayCharacter);
+  if ($("#ai-feed").querySelector("[data-message-id]")) refreshAiMessageRoleLabels();
+  else resetAiFeed();
+  toast(conversation.roleplayCharacter
+    ? `已进入 ${conversation.roleplayCharacter.name} 的角色扮演模式`
+    : "已退出角色扮演模式");
+}
+
 async function ensureAiConversation() {
   if (state.aiConversationId) return state.aiConversationId;
-  await createNewAiConversation();
+  await createNewAiConversation($("#ai-task").value);
   return state.aiConversationId;
 }
 
+async function persistAiConversationTaskType(taskType) {
+  const conversationId = await ensureAiConversation();
+  const conversation = await api(`/api/ai-conversations/${conversationId}/task-type`, {
+    method: "PATCH",
+    body: { taskType }
+  });
+  upsertAiConversationSummary(conversation);
+  applyAiConversationTaskType(conversation.taskType);
+  applyAiRoleplayCharacter(conversation.roleplayCharacter);
+  return conversation;
+}
+
+async function persistAiConversationContextScope(scope) {
+  const conversationId = await ensureAiConversation();
+  const conversation = await api(`/api/ai-conversations/${conversationId}/context-scope`, {
+    method: "PATCH",
+    body: { scope }
+  });
+  upsertAiConversationSummary(conversation);
+  applyAiConversationContextScope(conversation.contextScope);
+  return conversation;
+}
+
 async function persistAiConversationMessage(role, content, citations = [], metadata = {}) {
   const conversationId = await ensureAiConversation();
   if (!conversationId) throw new Error("无法创建 AI 对话");
@@ -1903,10 +2042,11 @@ function updateAiMentionMenu() {
     ...chapter,
     volumeTitle: volume.title
   }))) ?? [];
-  const options = listAiMentionOptions(state.characters, state.settings, chapters, match.query);
+  const options = listAiMentionOptions(state.characters, state.settings, chapters, match.query)
+    .filter((item) => item.kind !== "context-settings" || $("#ai-task").value !== "roleplay");
   menu.innerHTML = options.length
     ? options.map((item) => `<button class="ai-mention-option" type="button" role="option" data-ai-reference-kind="${esc(item.kind)}" data-ai-reference-id="${esc(item.id)}" data-ai-reference-name="${esc(item.name)}"><small>${esc(item.kindLabel)}</small><strong>${esc(item.name)}</strong></button>`).join("")
-    : '<p class="ai-mention-empty">没有匹配的角色、设定或章节</p>';
+    : '<p class="ai-mention-empty">没有匹配的角色、设定、章节或上下文能力</p>';
   menu.classList.remove("hidden");
 }
 
@@ -2128,7 +2268,7 @@ function clearChapterLineSelection() {
 }
 
 const typographyStorageKey = "ai-novel-typography-v1";
-const typographyDefaults = Object.freeze({ cjkFont: "system", latinFont: "system", fontSize: 17, density: "balanced" });
+const typographyDefaults = Object.freeze({ cjkFont: "system", latinFont: "system", fontSize: 17, uiFontSize: 16, aiFontSize: 14, density: "balanced" });
 const cjkFontStacks = {
   system: '"PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", "Heiti SC"',
   pingfang: '"PingFang SC", "Heiti SC", "Microsoft YaHei", "Noto Sans CJK SC"',
@@ -2144,15 +2284,21 @@ const latinFontStacks = {
   consolas: 'Consolas, "Liberation Mono", Menlo, Monaco, "SFMono-Regular"'
 };
 const typographyFontSizes = [15, 16, 17, 18, 20];
+const typographyUiFontSizes = [14, 15, 16, 17, 18];
+const typographyAiFontSizes = [12, 13, 14, 15, 16];
 const densityLineHeights = { compact: 1.4, balanced: 1.55, relaxed: 1.75 };
 
 function normalizeTypographySettings(input) {
   const value = input && typeof input === "object" ? input : {};
   const fontSize = Number(value.fontSize);
+  const uiFontSize = Number(value.uiFontSize);
+  const aiFontSize = Number(value.aiFontSize);
   return {
     cjkFont: Object.hasOwn(cjkFontStacks, value.cjkFont) ? value.cjkFont : typographyDefaults.cjkFont,
     latinFont: Object.hasOwn(latinFontStacks, value.latinFont) ? value.latinFont : typographyDefaults.latinFont,
     fontSize: typographyFontSizes.includes(fontSize) ? fontSize : typographyDefaults.fontSize,
+    uiFontSize: typographyUiFontSizes.includes(uiFontSize) ? uiFontSize : typographyDefaults.uiFontSize,
+    aiFontSize: typographyAiFontSizes.includes(aiFontSize) ? aiFontSize : typographyDefaults.aiFontSize,
     density: Object.hasOwn(densityLineHeights, value.density) ? value.density : typographyDefaults.density
   };
 }
@@ -2204,9 +2350,15 @@ function applyTypographySettings(settings) {
   root.style.setProperty("--font-latin", latinFontStacks[normalized.latinFont]);
   root.style.setProperty("--editor-font-size", `${normalized.fontSize}px`);
   root.style.setProperty("--editor-line-height", String(densityLineHeights[normalized.density]));
+  root.style.setProperty("--ui-font-size", `${normalized.uiFontSize}px`);
+  root.style.setProperty("--ui-font-scale", String(normalized.uiFontSize / typographyDefaults.uiFontSize));
+  root.style.setProperty("--ai-font-size", `${normalized.aiFontSize}px`);
+  root.style.setProperty("--ai-font-scale", String(normalized.aiFontSize / typographyDefaults.aiFontSize));
   root.dataset.cjkFont = normalized.cjkFont;
   root.dataset.latinFont = normalized.latinFont;
   root.dataset.fontSize = String(normalized.fontSize);
+  root.dataset.uiFontSize = String(normalized.uiFontSize);
+  root.dataset.aiFontSize = String(normalized.aiFontSize);
   root.dataset.density = normalized.density;
   scheduleChapterLineNumbers();
 }
@@ -2227,6 +2379,8 @@ function fillAppearanceForm(settings) {
   $("#appearance-cjk-font").value = normalized.cjkFont;
   $("#appearance-latin-font").value = normalized.latinFont;
   $("#appearance-font-size").value = String(normalized.fontSize);
+  $("#appearance-ui-font-size").value = String(normalized.uiFontSize);
+  $("#appearance-ai-font-size").value = String(normalized.aiFontSize);
   $("#appearance-density").value = normalized.density;
 }
 
@@ -2236,6 +2390,8 @@ function readAppearanceForm() {
     cjkFont: form.get("cjkFont"),
     latinFont: form.get("latinFont"),
     fontSize: form.get("fontSize"),
+    uiFontSize: form.get("uiFontSize"),
+    aiFontSize: form.get("aiFontSize"),
     density: form.get("density")
   });
 }
@@ -2246,6 +2402,7 @@ function renderTypographyPreview() {
   preview.style.fontFamily = `${latinFontStacks[settings.latinFont]}, ${cjkFontStacks[settings.cjkFont]}, monospace, sans-serif`;
   preview.style.fontSize = `${settings.fontSize}px`;
   preview.style.lineHeight = String(densityLineHeights[settings.density]);
+  $("#font-size-preview").textContent = `界面 ${settings.uiFontSize} px · Agent 对话 ${settings.aiFontSize} px`;
 }
 
 function openAppearanceDialog() {
@@ -3976,10 +4133,14 @@ function resetWorkScopedUiCaches() {
   state.aiPromptSent = false;
   state.aiConversationId = null;
   state.aiConversations = [];
+  state.aiRoleplayCharacter = null;
   renderAiCitations();
   renderAiReferences();
   renderAiQuickActions();
   resetAiFeed();
+  applyAiConversationTaskType("chat");
+  applyAiConversationContextScope({ type: "none" });
+  applyAiRoleplayCharacter(null);
   $("#ai-conversation-title").textContent = "新对话";
   $("#ai-model").innerHTML = '<option value="">使用创作助手时加载模型</option>';
   resetAiContextMeter();
@@ -6467,6 +6628,7 @@ function openTaskDetailDialog(task, trace) {
       </li>`;
     }
     if (item.type === "book") return "<li>全书</li>";
+    if (item.type === "settings-catalog") return "<li>设定库</li>";
     if (item.type === "selection") return item.restricted
       ? "<li>选定内容（正文读取权限受限）</li>"
       : `<li>选定内容：${esc(item.selection || "未提供")}</li>`;
@@ -6548,7 +6710,7 @@ function renderProviderCards(providers, models) {
     }).join("")}</div>
     <div class="card-actions"><button data-edit-provider="${esc(provider.id)}">编辑配置</button>${provider.status === "enabled" ? `<button data-test-provider="${esc(provider.id)}" ${providerModels.length ? "" : "disabled aria-disabled=\"true\" title=\"请先添加模型\""}>测试连接</button>` : ""}<button data-add-model="${esc(provider.id)}">添加模型</button></div></article>`;
   }).join("")}</div>`
-    : emptyModule("尚未配置 AI 供应商", "添加 OpenAI 或 Anthropic 兼容接口地址和密钥，测试成功后再添加模型。");
+    : emptyModule("尚未配置 AI 供应商", "添加 OpenAI、Anthropic 或 Google Vertex 接口地址和凭据，测试成功后再添加模型。");
 }
 
 function bindPlatformProviderActions(host, providers, models) {
@@ -7051,6 +7213,7 @@ async function renderBookAiSettings() {
     title: "本书 Token 用量",
     description: `仅统计《${state.work.title}》迄今产生的 AI Token 消耗与缓存命中情况。`
   })}</section><section class="config-section"><div class="config-section-header"><div><h2>每日 Token 额度</h2><p>限制本书在后端部署时区（${esc(quotaTimezone)}）每个自然日可使用的输入与输出 Token 总量。额度最低为 10,000；达到额度后，新的 AI 请求会等到后端时区的次日零点重置后再执行。</p></div></div><div class="config-inline-save"><label><input id="daily-token-quota-enabled" type="checkbox" ${dailyTokenQuota === null ? "" : "checked"}>启用每日额度</label><label class="daily-token-quota-field">每日额度<input id="daily-token-quota" type="number" min="10000" max="2000000000" step="1000" value="${esc(String(dailyTokenQuota ?? 10000))}" aria-label="本书每日 Token 额度" ${dailyTokenQuota === null ? "disabled" : ""}></label><button id="save-daily-token-quota" class="ghost-button config-save-button" type="button">保存</button></div><p id="daily-token-quota-status" class="usage-measurement-note" role="status">${esc(quotaStatusText)}</p></section><section class="config-section"><div class="config-section-header"><div><h2>本书系统提示词</h2><p>会追加在内置系统提示词和平台全局系统提示词之后，只影响《${esc(state.work.title)}》的 AI 请求。</p></div></div><div class="field-label"><textarea id="work-system-prompt" rows="8" aria-label="本书系统提示词" placeholder="例如：叙事使用第三人称，哥斯拉不得离开地球。">${esc(settings.systemPrompt)}</textarea></div><div class="card-actions"><button id="save-work-system-prompt" class="ghost-button config-save-button" type="button">保存本书提示词</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>人物关系拼音索引</h2><p>平时由系统记录增量任务；“同步增量队列”只处理发生变化的来源，“完整重建索引”会将本书全部正文和设定来源重新排队。</p></div></div><div id="relationship-search-index-status" role="status" aria-live="polite">${relationshipIndexStatusMarkup(relationshipIndex)}</div><div class="relationship-index-actions"><button id="sync-relationship-search-index" class="primary-button config-save-button" type="button">同步增量队列</button><button id="refresh-relationship-search-index" class="ghost-button" type="button">刷新状态</button><button id="rebuild-relationship-search-index" class="ghost-button config-save-button" type="button">完整重建索引</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>全书概要引用配额</h2><p>引用全书概要时按分卷保留覆盖，并优先加入与当前问题相关的章节概要；该比例控制概要可使用的上下文预算。</p></div></div><div class="config-inline-save"><label class="book-summary-context-percent-field">上下文占比（%）<input id="book-summary-context-percent" type="number" min="1" max="90" value="${esc(String(settings.bookSummaryContextPercent ?? 50))}" aria-label="全书概要引用上下文占比"></label><button id="save-book-summary-context-percent" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>对话上下文 Compact</h2><p>对话 context 使用独立预算。达到该百分比阈值时先提醒；继续发送会对较早消息执行 compact，压缩上下文占用，并尽量保留最近八条原文。</p></div></div><div class="config-inline-save"><label class="context-compact-threshold-field">Compact 阈值（%）<input id="context-compact-threshold" type="number" min="50" max="90" value="${esc(String(settings.contextCompactThreshold ?? 85))}" aria-label="对话上下文 compact 阈值"></label><button id="save-context-compact-threshold" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>Agent 工具调用上限</h2><p>限制单次回答里 Agent 可调用工具的次数，并用「全局倍数」给整次回答加一道不会因 Compact 重置的熔断阀，防止工具死循环空耗 Token。调用上限 5–48（默认 12）；全局倍数 1–6（默认 3，全局上限 = 调用上限 × 倍数）。<a class="config-doc-link" href="https://scriverse.top/docs/global-tool-call-limit.html" target="_blank" rel="noopener noreferrer">了解原理与推荐设置</a></p></div></div><div class="config-inline-save"><label class="agent-tool-call-limit-field">调用上限<input id="agent-tool-call-limit" type="number" min="5" max="48" value="${esc(String(settings.agentToolCallLimit ?? 12))}" aria-label="Agent 工具调用上限"></label><div class="agent-tool-call-global-multiplier-field"><span id="agent-tool-call-global-multiplier-label">全局倍数</span><div class="settings-layout-toggle agent-tool-call-global-multiplier-toggle" role="group" aria-labelledby="agent-tool-call-global-multiplier-label">${[1, 2, 3, 4, 5, 6].map((value) => `<button type="button" data-global-multiplier="${value}" aria-pressed="${Number(settings.agentToolCallGlobalMultiplier ?? 3) === value}">${value}</button>`).join("")}</div><input id="agent-tool-call-global-multiplier" type="hidden" value="${esc(String(Math.min(6, Math.max(1, Number(settings.agentToolCallGlobalMultiplier ?? 3) || 3))))}" aria-label="Agent 工具调用全局倍数"></div><button id="save-agent-tool-call-limit" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>AI 查询工具</h2><p>工具默认可用，作为已有上下文的补充。关闭后模型不会看到对应能力；所有工具只读且有数量、篇幅与调用轮次限制。已开始的对话会锁定创建时的工具集，修改后仅对新对话生效，避免打断 prompt cache。</p></div></div><div class="ai-agent-tools"><label><input name="agent-tool" type="checkbox" value="story_index" ${agentTools.has("story_index") ? "checked" : ""}><span><strong>作品目录与章节概要</strong><small>分页获取卷章、章节 ID 和当前概要，不返回正文。</small></span></label><label><input name="agent-tool" type="checkbox" value="read_chapters" ${agentTools.has("read_chapters") ? "checked" : ""}><span><strong>读取章节</strong><small>按章节 ID 获取概要或正文，每次最多 3 章。</small></span></label><label><input name="agent-tool" type="checkbox" value="search_story_entities" ${agentTools.has("search_story_entities") ? "checked" : ""}><span><strong>搜索作品实体</strong><small>按实体名、拼音或短关键词混合检索设定、人物、组织、时间线、关系、大纲和伏笔；非语义问答。</small></span></label></div><div class="card-actions"><button id="save-agent-tools" class="ghost-button config-save-button" type="button">保存工具设置</button></div></section>${renderTaskDefaults(models, providers, taskDefaults, settings)}`;
+  $("#daily-token-quota-status").closest(".config-section").insertAdjacentHTML("afterend", `<section class="config-section"><div class="config-section-header"><div><h2>设定上下文注入</h2><p>开启后，本书的普通 AI 请求会自动注入锁定设定、组织、种族与相关约束；即使本轮同时使用“@注入上下文设定”，也只会注入一次。</p></div></div><div class="config-inline-save"><label><input id="always-include-setting-info" type="checkbox" ${settings.alwaysIncludeSettingInfo ? "checked" : ""}>是否注入设定</label><button id="save-always-include-setting-info" class="ghost-button config-save-button" type="button">保存</button></div></section>`);
   bindUsageCalendarInteractions(host);
   scrollUsageCalendarsToLatest(host);
   host.querySelector('input[name="agent-tool"][value="search_story_entities"]').closest("label").insertAdjacentHTML(
@@ -7122,6 +7285,20 @@ async function renderBookAiSettings() {
       button.disabled = false;
     }
   });
+  $("#save-always-include-setting-info").addEventListener("click", async () => {
+    const button = $("#save-always-include-setting-info");
+    button.disabled = true;
+    try {
+      const alwaysIncludeSettingInfo = $("#always-include-setting-info").checked;
+      await api(`/api/works/${state.work.id}/ai-settings`, { method: "PATCH", body: { alwaysIncludeSettingInfo } });
+      toast(alwaysIncludeSettingInfo ? "已开启全局设定上下文注入" : "已关闭全局设定上下文注入");
+      setAiContextMeter(null);
+    } catch (error) {
+      toast(error.message, "error");
+    } finally {
+      button.disabled = false;
+    }
+  });
   $("#save-work-system-prompt").addEventListener("click", async () => {
     const button = $("#save-work-system-prompt");
     button.disabled = true;
@@ -7309,21 +7486,31 @@ async function ensureAiModelsLoaded() {
 
 function currentAiRequestScope() {
   if (!state.work) return null;
-  const taskType = $("#ai-task").value;
-  const scopeType = $("#ai-scope").value;
-  const requiresChapter = taskType === "polish" || taskType === "continue" || scopeType !== "none";
+  const selectedTaskType = $("#ai-task").value;
+  const roleplaySelected = selectedTaskType === "roleplay";
+  const taskType = roleplaySelected ? "chat" : selectedTaskType;
+  if (state.aiPromptSent) {
+    const conversationScope = JSON.parse(JSON.stringify(state.aiContextScope ?? { type: "none" }));
+    conversationScope.includeSettingInfo = false;
+    const scope = mergeAiReferenceScope(conversationScope, state.aiReferences);
+    return { taskType, scope, conversationScope, selection: typeof conversationScope.selection === "string" ? conversationScope.selection : "" };
+  }
+  const scopeType = roleplaySelected ? "none" : $("#ai-scope").value;
+  const requiresChapter = taskType === "polish" || taskType === "continue" || (scopeType !== "none" && scopeType !== "settings-catalog");
   if (requiresChapter && !state.chapter) return null;
   const selection = state.chapter ? $("#chapter-content").value.slice($("#chapter-content").selectionStart, $("#chapter-content").selectionEnd) : "";
   const volume = state.chapter ? state.work.volumes.find((item) => item.id === state.chapter.volumeId) : null;
   const includeBookSummary = scopeType === "chapter-summary";
-  const scope = taskType === "polish" ? { type: "chapter", chapterId: state.chapter?.id, selection }
+  const conversationScope = taskType === "polish" ? { type: "chapter", chapterId: state.chapter?.id, selection }
     : scopeType === "none" ? { type: "none", ...(taskType === "continue" && state.chapter ? { chapterId: state.chapter.id } : {}) }
     : scopeType === "book" ? { type: "book" }
     : scopeType === "volume" ? { type: "volume", volumeId: volume?.id }
+    : scopeType === "settings-catalog" ? { type: "settings-catalog" }
     : { type: "chapter", chapterId: state.chapter?.id };
-  Object.assign(scope, buildAiReferenceScope(state.aiReferences));
-  if (includeBookSummary) scope.includeBookSummary = true;
-  return { taskType, scope, selection };
+  if (includeBookSummary) conversationScope.includeBookSummary = true;
+  conversationScope.includeSettingInfo = false;
+  const scope = mergeAiReferenceScope(conversationScope, state.aiReferences);
+  return { taskType, scope, conversationScope, selection };
 }
 
 function renderAiContextDistribution(usage) {
@@ -7429,6 +7616,7 @@ async function loadAiReferences() {
   if (state.work?.id !== workId || generation !== workScopedUiGeneration) return;
   state.characters = characters;
   state.settings = settings;
+  renderAiRoleplayCharacterSelect();
   loadedAiReferencesWorkId = workId;
 }
 
@@ -9707,23 +9895,66 @@ async function openTaskDialog() {
 
 function openProviderDialog(item) {
   const protocol = item?.protocol ?? "openai-chat-completions";
-  const defaultBaseUrl = protocol === "anthropic-messages" ? "https://api.anthropic.com" : "https://api.openai.com/v1";
-  openDialog(item ? "编辑 AI 供应商" : "新建 AI 供应商", field("name", "显示名称", "text", item?.name) + field("protocol", "接口协议", "select", protocol, [["openai-chat-completions", "OpenAI Chat Completions"], ["anthropic-messages", "Anthropic Messages"]]) + field("baseUrl", "API 基础地址", "url", item?.baseUrl ?? defaultBaseUrl) + field("apiKey", item ? "替换 API 密钥（留空则不变）" : "API 密钥", "password") + field("concurrencyLimit", "最大并发请求数", "number", item?.concurrencyLimit ?? 10) + field("rpmLimit", "每分钟请求上限", "number", item?.rpmLimit ?? 10) + field("note", "用途备注", "textarea", item?.note) + field("enabled", item ? "启用供应商" : "立即启用", "checkbox", item ? item.status === "enabled" : true), async (form) => {
-    const body = { name: form.get("name"), protocol: form.get("protocol"), baseUrl: form.get("baseUrl"), concurrencyLimit: Number(form.get("concurrencyLimit")), rpmLimit: Number(form.get("rpmLimit")), note: form.get("note"), status: form.get("enabled") === "on" ? "enabled" : "disabled" };
-    if (!item || String(form.get("apiKey") ?? "").trim()) body.apiKey = form.get("apiKey");
-    await api(item ? `/api/providers/${item.id}` : "/api/platform/ai/providers", { method: item ? "PATCH" : "POST", body });
-    await renderPlatformAiConfig();
-    await loadModels();
-  }, item ? "协议、限流与凭据" : "OpenAI / Anthropic 兼容协议");
-  if (!item) {
-    const protocolSelect = $("#dialog-fields select[name='protocol']");
-    const baseUrlInput = $("#dialog-fields input[name='baseUrl']");
-    protocolSelect.addEventListener("change", () => {
-      baseUrlInput.value = protocolSelect.value === "anthropic-messages"
-        ? "https://api.anthropic.com"
-        : "https://api.openai.com/v1";
-    });
-  }
+  const providerProtocolOptions = [
+    ["openai-chat-completions", "OpenAI Chat Completions"],
+    ["anthropic-messages", "Anthropic Messages"],
+    ["google-vertex", "Google Vertex"]
+  ];
+  const defaultBaseUrlForProtocol = (value) => {
+    if (value === "anthropic-messages") return "https://api.anthropic.com";
+    if (value === "google-vertex") {
+      return "https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/endpoints/openapi";
+    }
+    return "https://api.openai.com/v1";
+  };
+  const credentialFieldForProtocol = (value) => {
+    if (value === "google-vertex") {
+      return field(
+        "apiKey",
+        item ? "替换服务账号 JSON（留空则不变）" : "服务账号 JSON",
+        "textarea",
+        ""
+      );
+    }
+    return field("apiKey", item ? "替换 API 密钥（留空则不变）" : "API 密钥", "password");
+  };
+  const defaultBaseUrl = item?.baseUrl ?? defaultBaseUrlForProtocol(protocol);
+  openDialog(
+    item ? "编辑 AI 供应商" : "新建 AI 供应商",
+    field("name", "显示名称", "text", item?.name)
+      + field("protocol", "接口协议", "select", protocol, providerProtocolOptions)
+      + field("baseUrl", "API 基础地址", "url", defaultBaseUrl)
+      + `<div data-provider-credential-field>${credentialFieldForProtocol(protocol)}</div>`
+      + field("concurrencyLimit", "最大并发请求数", "number", item?.concurrencyLimit ?? 10)
+      + field("rpmLimit", "每分钟请求上限", "number", item?.rpmLimit ?? 10)
+      + field("note", "用途备注", "textarea", item?.note)
+      + field("enabled", item ? "启用供应商" : "立即启用", "checkbox", item ? item.status === "enabled" : true),
+    async (form) => {
+      const body = {
+        name: form.get("name"),
+        protocol: form.get("protocol"),
+        baseUrl: form.get("baseUrl"),
+        concurrencyLimit: Number(form.get("concurrencyLimit")),
+        rpmLimit: Number(form.get("rpmLimit")),
+        note: form.get("note"),
+        status: form.get("enabled") === "on" ? "enabled" : "disabled"
+      };
+      if (!item || String(form.get("apiKey") ?? "").trim()) body.apiKey = form.get("apiKey");
+      await api(item ? `/api/providers/${item.id}` : "/api/platform/ai/providers", { method: item ? "PATCH" : "POST", body });
+      await renderPlatformAiConfig();
+      await loadModels();
+    },
+    item ? "协议、限流与凭据" : "OpenAI / Anthropic / Google Vertex"
+  );
+  const protocolSelect = $("#dialog-fields select[name='protocol']");
+  const baseUrlInput = $("#dialog-fields input[name='baseUrl']");
+  const credentialHost = $("#dialog-fields [data-provider-credential-field]");
+  const syncProviderCredentialField = () => {
+    const nextProtocol = protocolSelect.value;
+    credentialHost.innerHTML = credentialFieldForProtocol(nextProtocol);
+    if (!item) baseUrlInput.value = defaultBaseUrlForProtocol(nextProtocol);
+  };
+  protocolSelect.addEventListener("change", syncProviderCredentialField);
 }
 
 function openModelDialog(providerId, item = null) {
@@ -9793,10 +10024,17 @@ async function sendAi() {
   if (!modelId) return toast("请先在 AI 管理中配置并选择模型", "error");
   const instruction = aiPromptText().trim();
   if (!instruction) return toast("请输入指令", "error");
+  if ($("#ai-task").value === "roleplay" && !state.aiRoleplayCharacter) return toast("请先选择角色卡", "error");
   const requestScope = currentAiRequestScope();
   if (!requestScope) return toast("请先选择章节", "error");
   const { taskType, scope, selection } = requestScope;
   if (taskType === "polish" && !selection) return toast("请先在正文中选中一段文本", "error");
+  try {
+    await persistAiConversationTaskType($("#ai-task").value);
+    await persistAiConversationContextScope(requestScope.conversationScope);
+  } catch (error) {
+    return toast(`对话配置锁定失败：${error.message}`, "error");
+  }
   setAiAssistantStatus("ready");
   const citations = state.aiCitations.map(({ chapterId, chapterTitle, startLine, endLine, text }) => ({ chapterId, chapterTitle, startLine, endLine, text }));
   let persistedUserMessage = null;
@@ -9808,12 +10046,15 @@ async function sendAi() {
       return toast(`对话记录创建失败：${error.message}`, "error");
     }
     state.aiPromptSent = true;
+    syncAiTaskOptions();
+    renderAiRoleplayCharacterSelect();
     renderAiQuickActions();
     appendMessage("user", instruction, citations, persistedUserMessage.createdAt, {}, persistedUserMessage.id);
     clearAiPromptComposer();
   }
   $("#ai-send").disabled = true;
   $("#ai-send").textContent = "发送中";
+  $("#ai-roleplay-character").disabled = true;
   try {
     let assistantContent = "";
     let assistantMessage;
@@ -9869,6 +10110,7 @@ async function sendAi() {
   } finally {
     $("#ai-send").disabled = false;
     $("#ai-send").textContent = "发送";
+    renderAiRoleplayCharacterSelect();
   }
 }
 
@@ -9882,7 +10124,7 @@ async function streamChat(body) {
   let messageMounted = false;
   const mountAssistantMessage = () => {
     if (messageMounted) return;
-    attachMessageHeading(message, "助手 · 正在生成");
+    attachMessageHeading(message, aiAssistantLabel("正在生成"));
     $("#ai-feed").append(message);
     messageMounted = true;
     scrollAiFeedToBottom();
@@ -9955,6 +10197,8 @@ async function streamChat(body) {
           state.aiConversationId = persistedUserMessage.conversationId;
           updateAiConversationSummaryFromMessage(persistedUserMessage);
           state.aiPromptSent = true;
+          syncAiTaskOptions();
+          renderAiRoleplayCharacterSelect();
           renderAiQuickActions();
           appendMessage("user", persistedUserMessage.content, persistedUserMessage.citations, persistedUserMessage.createdAt, {}, persistedUserMessage.id);
           clearAiPromptComposer();
@@ -10038,7 +10282,7 @@ async function streamChat(body) {
     typewriter.reveal();
     message.classList.remove("is-streaming");
     content.setAttribute("aria-busy", "false");
-    message.querySelector(".message-heading > span").textContent = "助手 · 生成中断";
+    message.querySelector(".message-heading > span").textContent = aiAssistantLabel("生成中断");
     renderAiProcessSteps(message, processSteps, true, elapsedProcessTime());
     meta.textContent = "生成中断";
     scrollAiFeedToBottom();
@@ -10054,7 +10298,7 @@ function appendMessage(role, text, citations = [], createdAt = null, metadata =
     ? `<p class="ai-error-text">${esc(text)}</p>`
     : renderMarkdown(text);
   message.innerHTML = `<div class="message-body">${messageBody}</div>`;
-  const heading = attachMessageHeading(message, role === "user" ? "作者" : "助手", createdAt ?? undefined);
+  const heading = attachMessageHeading(message, role === "user" ? "作者" : aiAssistantLabel(), createdAt ?? undefined);
   if (isFailure) {
     message.dataset.status = "failed";
     const failureBadge = document.createElement("strong");
@@ -11318,8 +11562,58 @@ $("#ai-model").addEventListener("focus", () => {
   ensureAiModelsLoaded().catch((error) => toast(`模型加载失败：${error.message}`, "error"));
 });
 $("#ai-model").addEventListener("change", () => setAiContextMeter(null));
-$("#ai-task").addEventListener("change", () => setAiContextMeter(null));
-$("#ai-scope").addEventListener("change", () => setAiContextMeter(null));
+$("#ai-roleplay-character").addEventListener("focus", async () => {
+  try {
+    await ensureAiReferencesLoaded();
+    renderAiRoleplayCharacterSelect();
+  } catch (error) {
+    toast(`角色卡加载失败：${error.message}`, "error");
+  }
+});
+$("#ai-roleplay-character").addEventListener("change", async (event) => {
+  const select = event.currentTarget;
+  const characterId = select.value;
+  select.disabled = true;
+  try {
+    await updateAiRoleplayCharacter(characterId);
+  } catch (error) {
+    renderAiRoleplayCharacterSelect();
+    toast(`角色扮演模式切换失败：${error.message}`, "error");
+  } finally {
+    renderAiRoleplayCharacterSelect();
+  }
+});
+$("#ai-task").addEventListener("change", async (event) => {
+  const select = event.currentTarget;
+  const previousTaskType = select.dataset.previousValue || state.aiTaskType || "chat";
+  const nextTaskType = select.value;
+  if (state.aiPromptSent) {
+    applyAiConversationTaskType(previousTaskType);
+    return toast("当前对话已经开始，请新建对话后再切换任务类型", "error");
+  }
+  applyAiConversationTaskType(nextTaskType);
+  if (state.aiConversationId) {
+    select.disabled = true;
+    try {
+      await persistAiConversationTaskType(nextTaskType);
+    } catch (error) {
+      applyAiConversationTaskType(previousTaskType);
+      toast(`任务类型切换失败：${error.message}`, "error");
+    } finally {
+      syncAiTaskOptions();
+      renderAiRoleplayCharacterSelect();
+    }
+  }
+  setAiContextMeter(null);
+});
+$("#ai-scope").addEventListener("change", (event) => {
+  if (state.aiPromptSent) {
+    applyAiConversationContextScope(state.aiContextScope);
+    return toast("当前对话已经开始，请新建对话后再切换上下文引用", "error");
+  }
+  event.currentTarget.title = "";
+  setAiContextMeter(null);
+});
 $("#ai-mention-menu").addEventListener("click", (event) => {
   const button = event.target.closest("[data-ai-reference-id]");
   if (button) selectAiMention(button);
@@ -11602,7 +11896,7 @@ $("#ai-prompt").addEventListener("keydown", (event) => {
 $(".quick-actions").addEventListener("click", (event) => {
   const button = event.target.closest("[data-task]");
   if (!button) return;
-  $("#ai-task").value = button.dataset.task;
+  applyAiConversationTaskType(button.dataset.task);
   setAiPromptText(button.dataset.prompt);
   $("#ai-prompt").focus();
 });