Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

feat(ok): configure embedding request size and timeout (PRD-8299) (#4281)

mike-inkeepa07a2fbdf461
diff --git a/.changeset/configure-embedding-transport.md b/.changeset/configure-embedding-transport.md
new file mode 100644
index 000000000..a8ef32bc5
--- /dev/null
+++ b/.changeset/configure-embedding-transport.md
@@ -0,0 +1,7 @@
+---
+'@inkeep/open-knowledge': patch
+---
+
+Configure semantic-search text chunks per indexing request, character budget, and request timeout from `Settings → Search`, so slower local embedding servers can be tuned without patching the installed OpenKnowledge bundle.
+
+Clarify that semantic search indexes pages when you search, and show indexed coverage without an idle loading spinner.
diff --git a/docs/content/reference/configuration.mdx b/docs/content/reference/configuration.mdx
index 101a78c68..2dacdd825 100644
--- a/docs/content/reference/configuration.mdx
+++ b/docs/content/reference/configuration.mdx
@@ -77,13 +77,16 @@ A key set in a file more specific than its scope (a user-scope key in `.ok/confi
| `search.semantic.model` | string | `"text-embedding-3-small"` | project-local | Embeddings model id. Must be served by the provider at `baseUrl`. Changing it re-embeds the corpus. |
| `search.semantic.dimensions` | number | (auto) | project-local | Optional output vector size. Omit (recommended) and the size is detected from the endpoint's first response and reused across restarts — that is what lets a non-OpenAI model work without knowing its size up front. Set a smaller value to shrink the on-disk cache, trading a little quality; an endpoint that ignores the request parameter then fails loudly instead of silently. |
| `search.semantic.similarityFloor` | number | (unset) | project-local | Optional hard cutoff (0–1): drops semantic matches whose cosine similarity is below it. Retrieval is rank-based, so most setups leave it unset; set it only for a provider/model whose cosine scale you know. |
+| `search.semantic.maxBatchSize` | integer (1–2048) | `96` | project-local | Maximum text chunks per indexing embeddings request. The ceiling follows [OpenAI's input-array limit](https://developers.openai.com/api/reference/resources/embeddings/methods/create); other providers may impose different limits. Lower values reduce peak memory use but require more requests. This changes transport batching only, not document chunking or vector identity. Applies to the next indexing pass; an in-progress pass finishes with its existing settings and retains its vectors. |
+| `search.semantic.maxBatchChars` | integer (1–16384000) | `96000` | project-local | Approximate character budget per indexing embeddings request. OpenAI separately caps total input at **300,000 tokens per request**; this character budget does not enforce that limit, and high values can produce rejected requests. Other providers have their own limits. A single chunk larger than the budget is still sent alone; this setting does not split chunks or invalidate cached vectors. Applies to the next indexing pass. |
+| `search.semantic.docTimeoutMs` | integer (1–600000 milliseconds) | `30000` | project-local | Timeout for each indexing request attempt (up to 10 minutes). A request can retry four times, and a failed grouped request can trigger individual-document requests. There is no total indexing-pass deadline; large timeouts can delay newly queued work for hours. Settings displays seconds. Applies to the next indexing pass and keeps cached vectors. Interactive query embeddings retain a fixed 8-second timeout per attempt, with up to four retries; this setting does not raise it. |
| `linkPreviews.enabled` | boolean | `true` | project-local | Show a rich preview card (site name, page title, description, favicon) when you hover an external link in the editor. Default on (set to `false` to opt out). **When on, hovering an external link sends that link's URL to the destination site** to fetch its preview metadata — outbound egress, one request per previewed link. Previews of links to other documents in the project are read from the local index with no network request and are always on. See [Link previews](#link-previews) below. |
## Removed keys
As new versions of OpenKnowledge are released, some keys are retired from the schema. If any of your config files contains a key the schema no longer reads, that key alone is dropped from the loaded config and reported with the setting that replaced it.
-This applies to genuinely retired keys only. A file that cannot be trusted — invalid YAML, or a value that fails validation — is rejected and falls back to defaults.
+This applies to genuinely retired keys only. A file that cannot be trusted — invalid YAML, or a value that fails validation — is rejected and falls back to defaults. The embedding transport fields listed above handle invalid values individually by using that field's default while keeping the original file and other valid settings. `ok config validate` reports these as recovered values, with the affected field, its source location, and the default in use. Server logs warn once per affected field when that config is loaded or reloaded; subsequent searches do not repeat the warning.
Run `ok config validate` to see which keys are stale and what replaced each one. `ok config migrate` removes them for you; it defaults to every layer, so a bare run reaches whichever file the key lives in. Narrow it with `--scope project`, `project-local`, `user`, or `all` (the default), and preview with `--dry-run`. Migration deletes retired keys, but it never rewrites anything else on your behalf. A key whose replacement is not a one-to-one translation is removed and reported for you to recreate by hand.
@@ -137,8 +140,28 @@ To turn it on (per project, per machine):
1. Enable it for the project: the **Settings → This project → Search** toggle, or `ok embeddings enable`. Either sets `search.semantic.enabled: true` in project-local config (`<project>/.ok/local/config.yml`), picked up live by a running server; `ok embeddings disable` turns it off.
2. Set the API key right there on the same screen (or `ok embeddings set-key` in the project). Keys are **per project** — one project's key is never shared with another unless both point at the same endpoint. A **localhost** endpoint (Ollama / LM Studio) needs no key at all — the field shows "not required". `ok embeddings list` shows every stored key (redacted); `ok embeddings clear-key` removes this project's.
3. (Optional) point at your own OpenAI-compatible endpoint (a self-hosted Ollama / vLLM / LM Studio server, or another provider): open **Custom endpoint** in that same section, set the endpoint URL and the model id, and press **Test connection** — it runs one throwaway embed and reports either the detected vector size or the specific reason it failed. The same knobs are available from the CLI (`ok embeddings set-url <url>` / `clear-url`, `ok embeddings set-model <id>` / `clear-model`) and in project-local config (`search.semantic.baseUrl` / `model`). The vector size is detected automatically, so `dimensions` normally stays unset. Changing the endpoint or the model discards the cached vectors and re-embeds the corpus.
+4. (Optional) if a slow local model needs smaller requests or more time, open **Embedding request settings** and explicitly override the text-chunk batch count, character budget, or indexing timeout. Most setups should keep the defaults (`96` / `96000` / `30000` ms). For example, one user might choose the following for a particularly slow local model — this is an override example, **not** a preset or general recommendation:
-The first semantic search kicks off a background embed of the corpus (cents for a whole vault with `text-embedding-3-small`); vectors are cached incrementally under `.ok/local/` and only changed docs re-embed. If the key is missing, the provider errors, or you're offline, search degrades to lexical — it never blocks or errors. Because that degradation is quiet, **Test connection** is the way to tell a working custom endpoint apart from one that is failing. Each MCP `search` response reports embedding coverage so an agent knows when vectors are still filling in.
+ ```yaml
+ search:
+ semantic:
+ enabled: true
+ baseUrl: http://localhost:11434/v1
+ model: qwen3-embedding:4b
+ maxBatchSize: 2
+ maxBatchChars: 16000
+ docTimeoutMs: 120000
+ ```
+
+ These three controls change HTTP request batching and the indexing timeout per attempt. They apply to the next indexing pass, preserving completed vectors and allowing a pass already in progress to finish with its existing settings. They do not change chunking, retries, vector identity, or the vector cache, and do not trigger a provider-change confirmation or a full re-embed. Clear a field in Settings to restore its default. Invalid transport values in hand-edited YAML fall back to that field's default while preserving the file and other valid settings. `ok config validate` identifies the recovered field, location, and default in use; server logs warn once per affected field on load or reload. `ok embeddings status` (or `--json`) shows the effective transport values.
+
+ Indexing requests can retry up to four times, with backoff between attempts. If a grouped request fails, indexing can try each document separately, each with its own requests and retries. There is **no overall indexing-pass deadline**: at large timeout settings, a failing endpoint can hold up newly queued documents for hours. Lower the timeout when prompt failure and fresh indexing matter more than waiting for a slow endpoint.
+
+ The character budget also does not count tokens. [OpenAI's hosted endpoint](https://developers.openai.com/api/reference/resources/embeddings/methods/create) limits all inputs in a request to 300,000 tokens in total, alongside its per-input limits. A large character budget can exceed those limits; the ratio of characters to tokens varies by text and model. Check your provider's limits before raising both batch controls.
+
+ Interactive query embeddings keep a fixed **8-second timeout per attempt**, with up to four retries. Raising `docTimeoutMs` does not extend this query timeout, so a slow model can still fall back to lexical search. **Test connection** uses a separate 10-second attempt with no retries: success confirms connectivity and a valid response, but does not guarantee that live queries will meet their shorter deadline.
+
+The first semantic search kicks off a background embed of the corpus (cents for a whole vault with `text-embedding-3-small`); vectors are cached incrementally under `.ok/local/` and only changed docs re-embed. If the key is missing, the provider errors, or you're offline, search degrades to lexical. When cached vectors are available, a semantic search waits for the query embedding and any retries before returning, so an unresponsive provider can delay results. **Test connection** helps diagnose endpoint failures using the separate probe deadline described above. Each MCP `search` response reports embedding coverage so an agent knows when vectors are still filling in.
## Link previews
diff --git a/packages/app/src/components/CommandPalette.tsx b/packages/app/src/components/CommandPalette.tsx
index 4ddedbab9..5d9b3e107 100644
--- a/packages/app/src/components/CommandPalette.tsx
+++ b/packages/app/src/components/CommandPalette.tsx
@@ -313,14 +313,14 @@ export function CommandPalette({ bridge = null, open, onOpenChange }: CommandPal
(semanticCapability?.enabled ?? false) && (semanticCapability?.keyPresent ?? false);
const semanticIndexedCount = semanticCapability?.embedded ?? 0;
const semanticTotalCount = semanticCapability?.total ?? 0;
- const semanticIndexing =
+ const semanticCoverageIncomplete =
semanticCapable && semanticTotalCount > 0 && semanticIndexedCount < semanticTotalCount;
// biome-ignore lint/correctness/useExhaustiveDependencies: refreshSemanticStatus is behaviorally stable; re-arm only on the gating booleans.
useEffect(() => {
- if (!open || !isSemanticMode || !semanticIndexing) return;
+ if (!open || !isSemanticMode || !semanticCoverageIncomplete) return;
const id = window.setInterval(() => refreshSemanticStatus(), 2500);
return () => window.clearInterval(id);
- }, [open, isSemanticMode, semanticIndexing]);
+ }, [open, isSemanticMode, semanticCoverageIncomplete]);
const handoffInput = buildHandoffInput({ docName: activeDocName, workspace });
const workspaceEntries = buildWorkspaceEntries(
@@ -923,17 +923,18 @@ export function CommandPalette({ bridge = null, open, onOpenChange }: CommandPal
{isSemanticMode && semanticView ? (
<>
{}
- {semanticIndexing ? (
+ {semanticCoverageIncomplete ? (
<div
- className="flex items-center gap-2 px-3 py-2 text-muted-foreground text-xs"
- role="status"
- aria-live="polite"
- data-testid="command-palette-semantic-indexing"
+ className="px-3 py-2 text-muted-foreground text-xs"
+ data-testid="command-palette-semantic-coverage"
>
- <Spinner aria-hidden="true" className="size-3.5" />
+ <span role="status" aria-live="polite">
+ <Trans>
+ Pages indexed: {semanticIndexedCount} of {semanticTotalCount}.
+ </Trans>
+ </span>{' '}
<Trans>
- Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready.
- Results may be incomplete.
+ Missing pages are indexed when you search. Search again for fuller results.
</Trans>
</div>
) : null}
diff --git a/packages/app/src/components/settings/SearchSection.dom.test.tsx b/packages/app/src/components/settings/SearchSection.dom.test.tsx
index d139edebf..f5916ed09 100644
--- a/packages/app/src/components/settings/SearchSection.dom.test.tsx
+++ b/packages/app/src/components/settings/SearchSection.dom.test.tsx
@@ -2,9 +2,13 @@ import {
type Config,
type ConfigBinding,
DEFAULT_EMBEDDINGS_BASE_URL,
+ DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
type SemanticIndexStatus,
} from '@inkeep/open-knowledge-core';
-import { cleanup, render, screen, waitFor } from '@testing-library/react';
+import { i18n } from '@lingui/core';
+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
import { describedTextOf } from './settings-a11y.test-helper';
@@ -54,22 +58,38 @@ function configWithSemantic({
enabled,
baseUrl,
model,
+ maxBatchSize,
+ maxBatchChars,
+ docTimeoutMs,
}: {
enabled: boolean;
baseUrl?: string;
model?: string;
+ maxBatchSize?: number;
+ maxBatchChars?: number;
+ docTimeoutMs?: number;
}): Config {
return {
- search: { semantic: { enabled, ...(baseUrl ? { baseUrl } : {}), ...(model ? { model } : {}) } },
+ search: {
+ semantic: {
+ enabled,
+ ...(baseUrl ? { baseUrl } : {}),
+ ...(model ? { model } : {}),
+ ...(maxBatchSize !== undefined ? { maxBatchSize } : {}),
+ ...(maxBatchChars !== undefined ? { maxBatchChars } : {}),
+ ...(docTimeoutMs !== undefined ? { docTimeoutMs } : {}),
+ },
+ },
} as unknown as Config;
}
-function makeBinding(): { binding: ConfigBinding; calls: unknown[] } {
+function makeBinding(onPatch?: () => void): { binding: ConfigBinding; calls: unknown[] } {
const calls: unknown[] = [];
const binding = {
current: () => ({}),
patch: (patch: unknown) => {
calls.push(patch);
+ onPatch?.();
return { ok: true, value: { applied: [], effective: {} } };
},
subscribe: () => () => {},
@@ -84,6 +104,7 @@ let mockStatus: SemanticIndexStatus | null = null;
const originalFetch = global.fetch;
beforeEach(() => {
+ i18n.loadAndActivate({ locale: 'en', messages: {} });
mockProjectLocalConfig = null;
mockProjectLocalSynced = true;
mockProjectLocalBinding = null;
@@ -97,6 +118,7 @@ beforeEach(() => {
afterEach(() => {
cleanup();
global.fetch = originalFetch;
+ vi.useRealTimers();
});
describe('SearchSection', () => {
@@ -355,6 +377,11 @@ describe('SearchSection', () => {
return screen.getByTestId('settings-search-base-url') as HTMLInputElement;
}
+ async function openPerformanceTuning(user: ReturnType<typeof userEvent.setup>) {
+ const trigger = screen.getByTestId('settings-search-performance-trigger');
+ if (screen.queryByTestId('settings-search-max-batch-size') === null) await user.click(trigger);
+ }
+
async function confirmProviderChange(user: ReturnType<typeof userEvent.setup>) {
await user.click(await screen.findByTestId('settings-search-provider-confirm-apply'));
}
@@ -376,6 +403,473 @@ describe('SearchSection', () => {
);
});
+ test('shows legacy transport defaults and does not persist machine-specific values in a new project', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+
+ expect((screen.getByTestId('settings-search-max-batch-size') as HTMLInputElement).value).toBe(
+ String(DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE),
+ );
+ expect((screen.getByTestId('settings-search-max-batch-chars') as HTMLInputElement).value).toBe(
+ String(DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS),
+ );
+ expect(
+ (screen.getByTestId('settings-search-doc-timeout-seconds') as HTMLInputElement).value,
+ ).toBe(String(DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS / 1000));
+ expect(calls).toEqual([]);
+ });
+
+ test('describes tuning controls in terms of embedding requests', async () => {
+ const user = userEvent.setup();
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+
+ expect(screen.getByTestId('settings-search-performance-trigger').textContent).toContain(
+ 'Embedding request settings',
+ );
+ expect(
+ screen.getByText(
+ 'Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults.',
+ ),
+ ).toBeDefined();
+ expect(screen.getByLabelText('Maximum text chunks per indexing request')).toBeDefined();
+ expect(
+ screen.getByText(
+ 'Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall.',
+ ),
+ ).toBeDefined();
+ expect(screen.getByLabelText('Character budget per indexing request')).toBeDefined();
+ expect(
+ screen.getByText(
+ 'Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again.',
+ ),
+ ).toBeDefined();
+ expect(screen.getByLabelText('Indexing request timeout (seconds)')).toBeDefined();
+ expect(
+ screen.getByText(
+ 'How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting.',
+ ),
+ ).toBeDefined();
+ });
+
+ test('reaches the tuning controls without opening the Custom endpoint disclosure', async () => {
+ const user = userEvent.setup();
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+
+ expect(screen.queryByTestId('settings-search-base-url')).toBeNull();
+ await user.click(screen.getByTestId('settings-search-performance-trigger'));
+
+ expect(screen.getByTestId('settings-search-max-batch-size')).toBeDefined();
+ expect(screen.queryByTestId('settings-search-base-url')).toBeNull();
+ });
+
+ test('describes the custom endpoint disclosure', async () => {
+ const user = userEvent.setup();
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+ await openCustomEndpoint(user);
+
+ expect(
+ screen.getByText(
+ 'Point semantic search at any OpenAI-compatible embeddings endpoint — a self-hosted server or another provider. The API key above is for whichever endpoint you set here.',
+ ),
+ ).toBeDefined();
+ expect(
+ screen.getByText('Clear the field to reset back to the default OpenAI endpoint.'),
+ ).toBeDefined();
+ expect(screen.queryByTestId('settings-search-max-batch-size')).toBeNull();
+ });
+
+ test('existing transport overrides auto-expand and display seconds for the timeout', () => {
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({
+ enabled: false,
+ maxBatchSize: 2,
+ maxBatchChars: 16_000,
+ docTimeoutMs: 120_000,
+ });
+
+ render(<SearchSection />);
+
+ expect((screen.getByTestId('settings-search-max-batch-size') as HTMLInputElement).value).toBe(
+ '2',
+ );
+ expect((screen.getByTestId('settings-search-max-batch-chars') as HTMLInputElement).value).toBe(
+ '16000',
+ );
+ expect(
+ (screen.getByTestId('settings-search-doc-timeout-seconds') as HTMLInputElement).value,
+ ).toBe('120');
+ });
+
+ test.each([
+ ['settings-search-max-batch-size', 'maxBatchSize', '2', 2],
+ ['settings-search-max-batch-size', 'maxBatchSize', '1', 1],
+ ['settings-search-max-batch-size', 'maxBatchSize', '2048', 2048],
+ ['settings-search-max-batch-chars', 'maxBatchChars', '16000', 16_000],
+ ['settings-search-max-batch-chars', 'maxBatchChars', '1', 1],
+ ['settings-search-max-batch-chars', 'maxBatchChars', '16384000', 16_384_000],
+ ['settings-search-doc-timeout-seconds', 'docTimeoutMs', '120', 120_000],
+ ['settings-search-doc-timeout-seconds', 'docTimeoutMs', '0.001', 1],
+ ['settings-search-doc-timeout-seconds', 'docTimeoutMs', '600', 600_000],
+ ])(
+ 'commits %s directly without a provider-change confirmation',
+ async (id, key, draft, value) => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+ const input = screen.getByTestId(id);
+ await user.clear(input);
+ await user.type(input, `${draft}{Enter}`);
+
+ expect(calls).toEqual([{ search: { semantic: { [key]: value } } }]);
+ expect(screen.queryByTestId(`${id}-error`)).toBeNull();
+ expect(screen.queryByTestId('settings-search-provider-confirm')).toBeNull();
+ },
+ );
+
+ test('resetting the final override keeps the disclosure open and the field focused', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding(() => {
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+ view.rerender(<SearchSection />);
+ });
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 2 });
+ const view = render(<SearchSection />);
+ const input = screen.getByTestId('settings-search-max-batch-size');
+
+ await user.clear(input);
+ await user.keyboard('{Enter}');
+
+ expect(calls).toEqual([
+ { search: { semantic: { maxBatchSize: DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE } } },
+ ]);
+ expect(screen.getByTestId('settings-search-max-batch-size')).toBe(input);
+ expect(document.activeElement).toBe(input);
+ expect(
+ screen.getByTestId('settings-search-performance-trigger').getAttribute('aria-expanded'),
+ ).toBe('true');
+ expect(screen.getByTestId('settings-search-max-batch-size-saved').textContent).toBe('Saved');
+ });
+
+ test('a tuning commit refreshes status immediately and after the server settles', async () => {
+ const user = userEvent.setup();
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: true, maxBatchSize: 2 });
+ mockStatus = {
+ enabled: true,
+ keyPresent: true,
+ ready: true,
+ capable: true,
+ embedded: 4,
+ total: 4,
+ } as SemanticIndexStatus;
+ const fetchStatus = vi.fn(global.fetch);
+ global.fetch = fetchStatus;
+ render(<SearchSection />);
+ await screen.findByTestId('settings-search-coverage');
+ mockStatus = { ...mockStatus, ready: false };
+ const input = screen.getByTestId('settings-search-max-batch-size');
+ await user.clear(input);
+ await user.type(input, '4');
+ fetchStatus.mockClear();
+ vi.useFakeTimers();
+
+ fireEvent.keyDown(input, { key: 'Enter' });
+ await act(async () => {});
+ expect(fetchStatus).toHaveBeenCalledTimes(1);
+ expect(screen.getByTestId('settings-search-pending')).toBeTruthy();
+ mockStatus = { ...mockStatus, ready: true };
+ await act(() => vi.advanceTimersByTimeAsync(2500));
+ expect(fetchStatus).toHaveBeenCalledTimes(2);
+ expect(screen.getByTestId('settings-search-coverage').textContent).toContain('Indexed 4 of 4');
+ await act(() => vi.advanceTimersByTimeAsync(2500));
+ expect(fetchStatus).toHaveBeenCalledTimes(3);
+ });
+
+ test('Saved feedback expires, clears when editing resumes, and timers stop on unmount', async () => {
+ const user = userEvent.setup();
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 2 });
+ const view = render(<SearchSection />);
+ const input = screen.getByTestId('settings-search-max-batch-size');
+ await user.clear(input);
+ await user.type(input, '4');
+ vi.useFakeTimers();
+
+ fireEvent.keyDown(input, { key: 'Enter' });
+ const help = screen.getByTestId('settings-search-max-batch-size-help');
+ const message = screen.getByTestId('settings-search-max-batch-size-saved');
+ expect(message.textContent).toBe('Saved');
+ expect(help.textContent).toContain('Lower this');
+ expect(help.getAttribute('aria-live')).toBeNull();
+ expect(message.getAttribute('aria-live')).toBe('polite');
+ await act(() => vi.advanceTimersByTimeAsync(1500));
+ expect(message.textContent).toBe('');
+ expect(help.textContent).toContain('Lower this');
+ fireEvent.change(input, { target: { value: '5' } });
+ fireEvent.keyDown(input, { key: 'Enter' });
+ expect(message.textContent).toBe('Saved');
+ fireEvent.change(input, { target: { value: '6' } });
+ expect(message.textContent).toBe('');
+ fireEvent.keyDown(input, { key: 'Enter' });
+ view.unmount();
+ expect(vi.getTimerCount()).toBe(0);
+ });
+
+ test.each([
+ ['settings-search-max-batch-size', 'Lower this'],
+ ['settings-search-max-batch-chars', 'Limits the combined text'],
+ ['settings-search-doc-timeout-seconds', 'How long OpenKnowledge waits'],
+ ])('associates %s with stable help, status, and reset instructions', async (id, help) => {
+ const user = userEvent.setup();
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+
+ expect(describedTextOf(id)).toContain(help);
+ expect(describedTextOf(id)).toContain('Clear a field to restore its default value.');
+ expect(screen.getByTestId(id).getAttribute('aria-describedby')?.split(' ')).toContain(
+ `${id}-message`,
+ );
+ expect(screen.getByTestId(`${id}-help`).getAttribute('aria-live')).toBeNull();
+ const status = screen.getByTestId(`${id}-saved`);
+ expect(status.getAttribute('aria-live')).toBe('polite');
+ expect(status.textContent).toBe('');
+ });
+
+ test('clearing tuning fields resets them to the OpenKnowledge defaults', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 2 });
+
+ render(<SearchSection />);
+ const input = screen.getByTestId('settings-search-max-batch-size');
+ await user.clear(input);
+ await user.tab();
+
+ expect(calls).toEqual([
+ { search: { semantic: { maxBatchSize: DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE } } },
+ ]);
+ expect((input as HTMLInputElement).value).toBe(String(DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE));
+ });
+
+ test('clearing the timeout resets it to the default in milliseconds, shown in seconds', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, docTimeoutMs: 120_000 });
+
+ render(<SearchSection />);
+ const input = screen.getByTestId('settings-search-doc-timeout-seconds');
+ await user.clear(input);
+ await user.tab();
+
+ expect(calls).toEqual([
+ { search: { semantic: { docTimeoutMs: DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS } } },
+ ]);
+ expect((input as HTMLInputElement).value).toBe(
+ String(DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS / 1000),
+ );
+ });
+
+ test('blurring an unchanged tuning field writes nothing to project-local config', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+ await user.click(screen.getByTestId('settings-search-max-batch-size'));
+ await user.tab();
+ await user.click(screen.getByTestId('settings-search-doc-timeout-seconds'));
+ await user.tab();
+
+ expect(calls).toEqual([]);
+ });
+
+ test('a sub-second timeout set outside the UI round-trips instead of erroring', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, docTimeoutMs: 1500 });
+
+ render(<SearchSection />);
+ const input = screen.getByTestId('settings-search-doc-timeout-seconds');
+ expect((input as HTMLInputElement).value).toBe('1.5');
+
+ await user.click(input);
+ await user.tab();
+
+ expect(calls).toEqual([]);
+ expect(screen.queryByTestId('settings-search-doc-timeout-seconds-error')).toBeNull();
+
+ await user.clear(input);
+ await user.type(input, '2.5{Enter}');
+ expect(calls).toEqual([{ search: { semantic: { docTimeoutMs: 2500 } } }]);
+ });
+
+ test.each(['0', '-1', '1.5', '2049', 'not-a-number'])(
+ 'rejects invalid tuning input %s with accessible inline feedback',
+ async (invalid) => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+ const input = screen.getByTestId('settings-search-max-batch-size');
+ await user.clear(input);
+ await user.type(input, `${invalid}{Enter}`);
+
+ expect(calls).toEqual([]);
+ expect(input.getAttribute('aria-invalid')).toBe('true');
+ expect(input.getAttribute('aria-describedby')?.split(' ')).toContain(
+ 'settings-search-max-batch-size-message',
+ );
+ const message = screen.getByTestId('settings-search-max-batch-size-error');
+ expect(message.getAttribute('aria-live')).toBe('polite');
+ expect(message.textContent).toContain('whole number between 1 and 2,048');
+ },
+ );
+
+ test.each(['0', '-1', '0.0009', '600.001', '120000', 'not-a-number'])(
+ 'rejects invalid timeout %s and explains the range in seconds',
+ async (invalid) => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+ const input = screen.getByTestId('settings-search-doc-timeout-seconds');
+ await user.clear(input);
+ await user.type(input, `${invalid}{Enter}`);
+
+ expect(calls).toEqual([]);
+ expect(input.getAttribute('aria-invalid')).toBe('true');
+ expect(describedTextOf('settings-search-doc-timeout-seconds')).toContain(
+ 'seconds between 0.001 and 600',
+ );
+ },
+ );
+
+ test('rejects a character budget above its bound without writing config', async () => {
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+ const input = screen.getByTestId('settings-search-max-batch-chars');
+ await user.clear(input);
+ await user.type(input, '16384001{Enter}');
+
+ expect(calls).toEqual([]);
+ expect(describedTextOf('settings-search-max-batch-chars')).toContain(
+ 'whole number between 1 and 16,384,000',
+ );
+ });
+
+ test.each([
+ ['en', 'settings-search-max-batch-chars', '16384001', '16,384,000'],
+ ['fr', 'settings-search-max-batch-chars', '16384001', '16\u202f384\u202f000'],
+ ['fr', 'settings-search-doc-timeout-seconds', '0', '0,001'],
+ ])('formats the %s locale bounds in %s errors', async (locale, id, value, expected) => {
+ i18n.loadAndActivate({ locale, messages: {} });
+ const user = userEvent.setup();
+ const { binding, calls } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false });
+ render(<SearchSection />);
+ await openPerformanceTuning(user);
+ const input = screen.getByTestId(id);
+ await user.clear(input);
+ await user.type(input, `${value}{Enter}`);
+
+ expect(calls).toEqual([]);
+ expect(screen.getByTestId(`${id}-error`).textContent).toContain(expected);
+ });
+
+ test('tuning inputs remain disabled until the project-local binding has synced', () => {
+ mockProjectLocalBinding = null;
+ mockProjectLocalSynced = false;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 2 });
+
+ render(<SearchSection />);
+ expect(
+ screen.getByTestId('settings-search-max-batch-size').getAttribute('disabled'),
+ ).not.toBeNull();
+ });
+
+ test('external config changes reseed tuning drafts', async () => {
+ const { binding } = makeBinding();
+ mockProjectLocalBinding = binding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 2 });
+ const view = render(<SearchSection />);
+ expect((screen.getByTestId('settings-search-max-batch-size') as HTMLInputElement).value).toBe(
+ '2',
+ );
+
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 4 });
+ view.rerender(<SearchSection />);
+
+ await waitFor(() =>
+ expect((screen.getByTestId('settings-search-max-batch-size') as HTMLInputElement).value).toBe(
+ '4',
+ ),
+ );
+ });
+
+ test('a tuning patch failure preserves the draft and exposes an inline live error', async () => {
+ const user = userEvent.setup();
+ const failBinding = {
+ ...makeBinding().binding,
+ patch: () => ({ ok: false, error: { code: 'noop', message: 'disk unavailable' } }),
+ } as unknown as ConfigBinding;
+ mockProjectLocalBinding = failBinding;
+ mockProjectLocalConfig = configWithSemantic({ enabled: false, maxBatchSize: 2 });
+
+ render(<SearchSection />);
+ const input = screen.getByTestId('settings-search-max-batch-size') as HTMLInputElement;
+ await user.clear(input);
+ await user.type(input, '4{Enter}');
+
+ expect(input.value).toBe('4');
+ const error = screen.getByTestId('settings-search-max-batch-size-error');
+ expect(error.getAttribute('aria-live')).toBe('polite');
+ expect(error.textContent).toContain('Failed to update performance setting');
+ });
+
test('the disclosure starts open when a custom endpoint is already configured', () => {
const { binding } = makeBinding();
mockProjectLocalBinding = binding;
diff --git a/packages/app/src/components/settings/SearchSection.tsx b/packages/app/src/components/settings/SearchSection.tsx
index 52c1f77b4..928330b68 100644
--- a/packages/app/src/components/settings/SearchSection.tsx
+++ b/packages/app/src/components/settings/SearchSection.tsx
@@ -1,11 +1,21 @@
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility
import {
+ type ConfigBinding,
checkEmbeddingsBaseUrl,
DEFAULT_EMBEDDINGS_BASE_URL,
+ DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
DEFAULT_EMBEDDINGS_MODEL,
humanFormat,
type LocalOpEmbeddingsTestResponse,
+ MAX_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MAX_EMBEDDINGS_MAX_BATCH_CHARS,
+ MAX_EMBEDDINGS_MAX_BATCH_SIZE,
+ MIN_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MIN_EMBEDDINGS_MAX_BATCH_CHARS,
+ MIN_EMBEDDINGS_MAX_BATCH_SIZE,
} from '@inkeep/open-knowledge-core';
import { Plural, Trans, useLingui } from '@lingui/react/macro';
import { ChevronRight } from 'lucide-react';
@@ -23,6 +33,7 @@ import {
Dialog as DialogRoot,
DialogTitle,
} from '@/components/ui/dialog';
+import { Field, FieldDescription, FieldLabel } from '@/components/ui/field';
import { Input } from '@/components/ui/input';
import { Switch } from '@/components/ui/switch';
import { useSemanticSearchStatus } from '@/hooks/use-semantic-search-status';
@@ -34,6 +45,7 @@ import {
import { SettingsSectionHeader } from './SettingsSectionHeader';
const SETTLE_REFRESH_DELAYS_MS = [2500, 5000] as const;
+const PERFORMANCE_CLEAR_HINT_ID = 'settings-search-performance-clear-hint';
export function SearchSection({ transport }: { transport?: EmbeddingsKeyTransport }) {
const { t } = useLingui();
@@ -55,6 +67,12 @@ export function SearchSection({ transport }: { transport?: EmbeddingsKeyTranspor
const configuredBaseUrl =
projectLocalConfig?.search?.semantic?.baseUrl ?? DEFAULT_EMBEDDINGS_BASE_URL;
const configuredModel = projectLocalConfig?.search?.semantic?.model ?? DEFAULT_EMBEDDINGS_MODEL;
+ const configuredMaxBatchSize =
+ projectLocalConfig?.search?.semantic?.maxBatchSize ?? DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE;
+ const configuredMaxBatchChars =
+ projectLocalConfig?.search?.semantic?.maxBatchChars ?? DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS;
+ const configuredDocTimeoutMs =
+ projectLocalConfig?.search?.semantic?.docTimeoutMs ?? DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS;
const [baseUrlDraft, setBaseUrlDraft] = useState(configuredBaseUrl);
const [modelDraft, setModelDraft] = useState(configuredModel);
@@ -63,6 +81,9 @@ export function SearchSection({ transport }: { transport?: EmbeddingsKeyTranspor
model: string;
} | null>(null);
const [disclosureOverride, setDisclosureOverride] = useState<boolean | null>(null);
+ const [performanceDisclosureOverride, setPerformanceDisclosureOverride] = useState<
+ boolean | null
+ >(null);
const [testing, setTesting] = useState(false);
const [testResult, setTestResult] = useState<{
response: LocalOpEmbeddingsTestResponse | null;
@@ -86,13 +107,23 @@ export function SearchSection({ transport }: { transport?: EmbeddingsKeyTranspor
const hasProviderOverride =
configuredBaseUrl !== DEFAULT_EMBEDDINGS_BASE_URL ||
configuredModel !== DEFAULT_EMBEDDINGS_MODEL;
+ const hasTransportOverride =
+ configuredMaxBatchSize !== DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE ||
+ configuredMaxBatchChars !== DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS ||
+ configuredDocTimeoutMs !== DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS;
const disclosureOpen = disclosureOverride ?? hasProviderOverride;
+ const performanceDisclosureOpen = performanceDisclosureOverride ?? hasTransportOverride;
function scheduleSettleRefresh() {
for (const timer of settleTimersRef.current) clearTimeout(timer);
settleTimersRef.current = SETTLE_REFRESH_DELAYS_MS.map((delay) => setTimeout(refresh, delay));
}
+ function onTuningCommitted() {
+ refresh();
+ scheduleSettleRefresh();
+ }
+
function write(next: boolean): boolean {
if (projectLocalBinding === null) {
toast.error(t`Search settings not yet loaded — try again in a moment`);
@@ -413,6 +444,87 @@ export function SearchSection({ transport }: { transport?: EmbeddingsKeyTranspor
</CollapsibleContent>
</Collapsible>
+ <Collapsible
+ open={performanceDisclosureOpen}
+ onOpenChange={setPerformanceDisclosureOverride}
+ className="rounded-md border"
+ data-testid="settings-search-performance"
+ data-field="search.semantic.maxBatchSize"
+ >
+ <CollapsibleTrigger
+ className="group flex w-full items-center justify-between gap-2 px-3 py-2 text-sm font-medium hover:bg-muted/50"
+ data-testid="settings-search-performance-trigger"
+ >
+ <Trans>Embedding request settings</Trans>
+ <ChevronRight
+ className="size-4 transition-transform group-data-[state=open]:rotate-90 motion-reduce:transition-none"
+ aria-hidden
+ />
+ </CollapsibleTrigger>
+ <CollapsibleContent
+ className="flex flex-col gap-4 border-t px-3 py-3"
+ onFocusCapture={() => setPerformanceDisclosureOverride(true)}
+ >
+ <p className="text-muted-foreground text-1sm">
+ <Trans>
+ Adjust indexing request size and timeout for slow or memory-constrained embedding
+ servers. Most setups should keep the defaults.
+ </Trans>
+ </p>
+ <p id={PERFORMANCE_CLEAR_HINT_ID} className="text-muted-foreground text-1sm">
+ <Trans>Clear a field to restore its default value.</Trans>
+ </p>
+ <PerformanceTuningField
+ id="settings-search-max-batch-size"
+ label={<Trans>Maximum text chunks per indexing request</Trans>}
+ help={
+ <Trans>
+ Lower this to reduce memory use and work per request. Smaller batches send more
+ requests and may make indexing slower overall.
+ </Trans>
+ }
+ configKey="maxBatchSize"
+ configuredValue={configuredMaxBatchSize}
+ defaultValue={DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE}
+ binding={projectLocalBinding}
+ bindingReady={bindingReady}
+ onCommitted={onTuningCommitted}
+ />
+ <PerformanceTuningField
+ id="settings-search-max-batch-chars"
+ label={<Trans>Character budget per indexing request</Trans>}
+ help={
+ <Trans>
+ Limits the combined text sent in each request. A single larger chunk is sent on its
+ own; documents are not split again.
+ </Trans>
+ }
+ configKey="maxBatchChars"
+ configuredValue={configuredMaxBatchChars}
+ defaultValue={DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS}
+ binding={projectLocalBinding}
+ bindingReady={bindingReady}
+ onCommitted={onTuningCommitted}
+ />
+ <PerformanceTuningField
+ id="settings-search-doc-timeout-seconds"
+ label={<Trans>Indexing request timeout (seconds)</Trans>}
+ help={
+ <Trans>
+ How long OpenKnowledge waits for each embedding request while indexing. Search
+ requests use a fixed 8-second timeout per attempt, unchanged by this setting.
+ </Trans>
+ }
+ configKey="docTimeoutMs"
+ configuredValue={configuredDocTimeoutMs}
+ defaultValue={DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS}
+ binding={projectLocalBinding}
+ bindingReady={bindingReady}
+ onCommitted={onTuningCommitted}
+ />
+ </CollapsibleContent>
+ </Collapsible>
+
<EnableSemanticSearchConfirmDialog
open={confirmOpen}
onOpenChange={setConfirmOpen}
@@ -428,6 +540,165 @@ export function SearchSection({ transport }: { transport?: EmbeddingsKeyTranspor
);
}
+type PerformanceTuningKey = 'maxBatchSize' | 'maxBatchChars' | 'docTimeoutMs';
+
+const PERFORMANCE_TUNING_BOUNDS: Record<
+ PerformanceTuningKey,
+ { min: number; max: number; displayDivisor?: number }
+> = {
+ maxBatchSize: { min: MIN_EMBEDDINGS_MAX_BATCH_SIZE, max: MAX_EMBEDDINGS_MAX_BATCH_SIZE },
+ maxBatchChars: { min: MIN_EMBEDDINGS_MAX_BATCH_CHARS, max: MAX_EMBEDDINGS_MAX_BATCH_CHARS },
+ docTimeoutMs: {
+ min: MIN_EMBEDDINGS_DOC_TIMEOUT_MS,
+ max: MAX_EMBEDDINGS_DOC_TIMEOUT_MS,
+ displayDivisor: 1000,
+ },
+};
+
+interface PerformanceTuningFieldProps {
+ id: string;
+ label: ReactNode;
+ help: ReactNode;
+ configKey: PerformanceTuningKey;
+ configuredValue: number;
+ defaultValue: number;
+ binding: ConfigBinding | null;
+ bindingReady: boolean;
+ onCommitted: () => void;
+}
+
+function PerformanceTuningField({
+ id,
+ label,
+ help,
+ configKey,
+ configuredValue,
+ defaultValue,
+ binding,
+ bindingReady,
+ onCommitted,
+}: PerformanceTuningFieldProps) {
+ const { t, i18n } = useLingui();
+ const bounds = PERFORMANCE_TUNING_BOUNDS[configKey];
+ const displayDivisor = bounds.displayDivisor ?? 1;
+ const displayedConfiguredValue = configuredValue / displayDivisor;
+ const displayedDefaultValue = defaultValue / displayDivisor;
+ const displayedMinimum = bounds.min / displayDivisor;
+ const displayedMaximum = bounds.max / displayDivisor;
+ const [draft, setDraft] = useState(String(displayedConfiguredValue));
+ const [error, setError] = useState<string | null>(null);
+ const [savedValue, setSavedValue] = useState<number | null>(null);
+ const [previousConfiguredValue, setPreviousConfiguredValue] = useState(displayedConfiguredValue);
+
+ if (displayedConfiguredValue !== previousConfiguredValue) {
+ setPreviousConfiguredValue(displayedConfiguredValue);
+ setDraft(String(displayedConfiguredValue));
+ setError(null);
+ if (savedValue !== configuredValue) setSavedValue(null);
+ }
+
+ useEffect(() => {
+ if (savedValue === null) return;
+ const timer = setTimeout(() => setSavedValue(null), 1500);
+ return () => clearTimeout(timer);
+ }, [savedValue]);
+
+ const acceptsFractionalDisplay = displayDivisor > 1;
+
+ function commit(): void {
+ const trimmed = draft.trim();
+ const source = trimmed === '' ? String(displayedDefaultValue) : trimmed;
+ const pattern = acceptsFractionalDisplay ? /^\d+(?:\.\d+)?$/ : /^\d+$/;
+ const displayValue = Number(source);
+ const storedValue = Math.round(displayValue * displayDivisor);
+ if (
+ !pattern.test(source) ||
+ !Number.isSafeInteger(storedValue) ||
+ displayValue < displayedMinimum ||
+ displayValue > displayedMaximum
+ ) {
+ const numberFormat = new Intl.NumberFormat(i18n.locale);
+ const minimum = numberFormat.format(displayedMinimum);
+ const maximum = numberFormat.format(displayedMaximum);
+ setError(
+ acceptsFractionalDisplay
+ ? t`Enter a number of seconds between ${minimum} and ${maximum}.`
+ : t`Enter a whole number between ${minimum} and ${maximum}.`,
+ );
+ return;
+ }
+ if (binding === null) {
+ setError(t`Search settings not yet loaded — try again in a moment`);
+ return;
+ }
+ if (storedValue === configuredValue) {
+ setDraft(String(displayValue));
+ setError(null);
+ return;
+ }
+
+ const semanticPatch: Partial<Record<PerformanceTuningKey, number>> = {
+ [configKey]: storedValue,
+ };
+ const result = binding.patch({ search: { semantic: semanticPatch } });
+ if (!result.ok) {
+ const detail = humanFormat(result.error);
+ const message = t`Failed to update performance setting — ${detail}`;
+ setError(message);
+ toast.error(message);
+ return;
+ }
+ setDraft(String(displayValue));
+ setError(null);
+ setSavedValue(storedValue);
+ onCommitted();
+ }
+
+ const messageId = `${id}-message`;
+ const helpId = `${id}-help`;
+ return (
+ <Field data-invalid={error !== null} data-disabled={!bindingReady} className="gap-2">
+ <FieldLabel htmlFor={id}>{label}</FieldLabel>
+ <Input
+ id={id}
+ value={draft}
+ onChange={(event) => {
+ setDraft(event.currentTarget.value);
+ setSavedValue(null);
+ if (error !== null) setError(null);
+ }}
+ onBlur={commit}
+ onKeyDown={(event) => {
+ if (event.key === 'Enter' && !event.nativeEvent.isComposing) {
+ event.preventDefault();
+ commit();
+ }
+ }}
+ disabled={!bindingReady}
+ inputMode={acceptsFractionalDisplay ? 'decimal' : 'numeric'}
+ autoComplete="off"
+ spellCheck={false}
+ aria-invalid={error !== null}
+ aria-describedby={`${helpId} ${messageId} ${PERFORMANCE_CLEAR_HINT_ID}`}
+ data-testid={id}
+ className="h-8 font-mono text-sm"
+ />
+ <FieldDescription id={helpId} className="nth-last-2:mt-0" data-testid={`${id}-help`}>
+ {help}
+ </FieldDescription>
+ <FieldDescription
+ id={messageId}
+ aria-live="polite"
+ aria-atomic="true"
+ className={error ? 'text-1sm text-destructive' : 'text-muted-foreground text-1sm'}
+ data-testid={error ? `${id}-error` : `${id}-saved`}
+ >
+ {error ?? (savedValue !== null ? <Trans>Saved</Trans> : null)}
+ </FieldDescription>
+ </Field>
+ );
+}
+
interface EmbeddingsKeyFieldProps {
transport: EmbeddingsKeyTransport;
refresh: () => void;
diff --git a/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx
index ba5ba278c..f5de71098 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.install-flag.dom.test.tsx
@@ -1,4 +1,3 @@
-import * as actualLinguiMacro from '@lingui/react/macro';
import { cleanup, render, screen } from '@testing-library/react';
import type { ReactNode } from 'react';
import { afterEach, describe, expect, test, vi } from 'vitest';
@@ -8,21 +7,6 @@ vi.doMock('@inkeep/open-knowledge-core', () => ({
MARKDOWNLINT_RULE_CATALOG: [],
}));
-vi.doMock('@lingui/react/macro', () => ({
- ...actualLinguiMacro,
- Trans: ({ children }: { children?: ReactNode }) => <>{children}</>,
- useLingui: () => ({
- t: (strings: TemplateStringsArray | string, ...values: unknown[]) => {
- if (typeof strings === 'string') return strings;
- return strings.reduce(
- (text, chunk, index) =>
- `${text}${chunk}${index < values.length ? String(values[index]) : ''}`,
- '',
- );
- },
- }),
-}));
-
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: () => <div data-testid="settings-body-probe" />,
}));
diff --git a/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx
index 3d9c11515..a2fa076fe 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.link-previews.dom.test.tsx
@@ -1,4 +1,3 @@
-import * as actualLinguiMacro from '@lingui/react/macro';
import { cleanup, render, screen } from '@testing-library/react';
import type { ReactNode } from 'react';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
@@ -14,21 +13,6 @@ vi.doMock('@inkeep/open-knowledge-core', () => ({
MARKDOWNLINT_RULE_CATALOG: [],
}));
-vi.doMock('@lingui/react/macro', () => ({
- ...actualLinguiMacro,
- Trans: ({ children }: { children?: ReactNode }) => <>{children}</>,
- useLingui: () => ({
- t: (strings: TemplateStringsArray | string, ...values: unknown[]) => {
- if (typeof strings === 'string') return strings;
- return strings.reduce(
- (text, chunk, index) =>
- `${text}${chunk}${index < values.length ? String(values[index]) : ''}`,
- '',
- );
- },
- }),
-}));
-
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: () => <div data-testid="settings-body-probe" />,
}));
diff --git a/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx
index 894032a6b..d55400196 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.search.dom.test.tsx
@@ -1,5 +1,5 @@
import type { ConfigBinding, OkignoreBinding } from '@inkeep/open-knowledge-core';
-import { cleanup, render, screen, waitFor } from '@testing-library/react';
+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
@@ -64,7 +64,10 @@ const FAKE_RULE_CATALOG = [
},
];
-vi.doMock('@inkeep/open-knowledge-core', () => ({
+vi.doMock('@inkeep/open-knowledge-core', async () => ({
+ ...(await vi.importActual<typeof import('@inkeep/open-knowledge-core')>(
+ '@inkeep/open-knowledge-core',
+ )),
get SHOW_INSTALL_SKILL() {
return true;
},
@@ -77,6 +80,7 @@ vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
return (
<div data-testid="settings-body-probe">
{props.activeId === 'preferences' ? <div data-field="editor.wordWrap" /> : null}
+ {props.activeId === 'search' ? <SearchSection /> : null}
</div>
);
},
@@ -112,6 +116,7 @@ vi.doMock('@/lib/handoff/use-claude-desktop-integration', () => ({
}));
const { SettingsDialogShell } = await import('./SettingsDialogShell');
+const { SearchSection } = await import('./SearchSection');
function latestProbe(): BodyProps | undefined {
return probeProps[probeProps.length - 1];
@@ -130,6 +135,7 @@ describe('settings dialog search', () => {
afterEach(() => {
cleanup();
consoleErrorSpy.mockRestore();
+ vi.useRealTimers();
});
test('empty query shows the plain group nav, no results list', () => {
@@ -222,4 +228,55 @@ describe('settings dialog search', () => {
expect(scrollSpy).toHaveBeenCalled();
scrollSpy.mockRestore();
});
+
+ test('search reveals the tuning fields and reopens them after an explicit collapse', async () => {
+ const user = userEvent.setup();
+ const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('{}'));
+ const scrollSpy = vi
+ .spyOn(HTMLElement.prototype, 'scrollIntoView')
+ .mockImplementation(() => {});
+ render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
+
+ for (const query of ['timeout', 'Ollama']) {
+ await user.type(screen.getByTestId('settings-search-input'), query);
+ await user.click(
+ await screen.findByTestId('settings-search-result-subsection:search:performance'),
+ );
+
+ expect(await screen.findByTestId('settings-search-max-batch-size')).toBeTruthy();
+ expect(screen.getByTestId('settings-search-max-batch-chars')).toBeTruthy();
+ expect(screen.getByTestId('settings-search-doc-timeout-seconds')).toBeTruthy();
+ expect(
+ screen
+ .getByTestId('settings-search-performance')
+ .classList.contains('animate-settings-nav-flash'),
+ ).toBe(true);
+ expect(scrollSpy).toHaveBeenCalled();
+ await user.click(screen.getByTestId('settings-search-performance-trigger'));
+ await waitFor(() =>
+ expect(screen.queryByTestId('settings-search-max-batch-size')).toBeNull(),
+ );
+ }
+
+ scrollSpy.mockRestore();
+ fetchSpy.mockRestore();
+ });
+
+ test('successful disclosure navigation retires its give-up timer and clears the flash', async () => {
+ const user = userEvent.setup();
+ const fetchSpy = vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('{}'));
+ render(<SettingsDialogShell open={true} onOpenChange={() => {}} />);
+ await user.type(screen.getByTestId('settings-search-input'), 'timeout');
+ vi.useFakeTimers();
+ fireEvent.click(screen.getByTestId('settings-search-result-subsection:search:performance'));
+ await act(async () => {});
+ const disclosure = screen.getByTestId('settings-search-performance');
+
+ expect(screen.getByTestId('settings-search-max-batch-size')).toBeTruthy();
+ expect(disclosure.classList.contains('animate-settings-nav-flash')).toBe(true);
+ await act(() => vi.advanceTimersByTimeAsync(750));
+ expect(disclosure.classList.contains('animate-settings-nav-flash')).toBe(false);
+ expect(vi.getTimerCount()).toBe(0);
+ fetchSpy.mockRestore();
+ });
});
diff --git a/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx
index 1df75de2e..79414949e 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.terminal.dom.test.tsx
@@ -1,4 +1,3 @@
-import * as actualLinguiMacro from '@lingui/react/macro';
import { cleanup, render, screen, waitFor } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import type { ReactNode } from 'react';
@@ -37,21 +36,6 @@ vi.doMock('@inkeep/open-knowledge-core', () => ({
MARKDOWNLINT_RULE_CATALOG: [],
}));
-vi.doMock('@lingui/react/macro', () => ({
- ...actualLinguiMacro,
- Trans: ({ children }: { children?: ReactNode }) => <>{children}</>,
- useLingui: () => ({
- t: (strings: TemplateStringsArray | string, ...values: unknown[]) => {
- if (typeof strings === 'string') return strings;
- return strings.reduce(
- (text, chunk, index) =>
- `${text}${chunk}${index < values.length ? String(values[index]) : ''}`,
- '',
- );
- },
- }),
-}));
-
const probeActiveIds: string[] = [];
vi.doMock('@/components/settings/SettingsDialogBodyLazy', () => ({
SettingsDialogBodyLazy: ({ activeId }: { activeId: string }) => {
diff --git a/packages/app/src/components/settings/SettingsDialogShell.tsx b/packages/app/src/components/settings/SettingsDialogShell.tsx
index 428d9233f..081775db6 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.tsx
@@ -112,6 +112,13 @@ export function SettingsDialogShell({
const tryFlash = (): boolean => {
const el = container.querySelector<HTMLElement>(`[data-field="${fieldFlash.path}"]`);
if (!el) return false;
+ const closedDisclosure = el.closest('[data-slot="collapsible"][data-state="closed"]');
+ if (closedDisclosure) {
+ closedDisclosure
+ .querySelector<HTMLButtonElement>('[data-slot="collapsible-trigger"]')
+ ?.click();
+ return false;
+ }
el.scrollIntoView({ block: 'center' });
el.classList.add(FLASH_CLASS);
flashed = el;
@@ -119,11 +126,23 @@ export function SettingsDialogShell({
return true;
};
- if (!tryFlash()) {
- observer = new MutationObserver(() => {
- if (tryFlash()) observer?.disconnect();
- });
- observer.observe(container, { childList: true, subtree: true });
+ observer = new MutationObserver(() => {
+ if (!tryFlash()) return;
+ observer?.disconnect();
+ if (giveUpTimer) {
+ clearTimeout(giveUpTimer);
+ giveUpTimer = null;
+ }
+ });
+ observer.observe(container, {
+ childList: true,
+ subtree: true,
+ attributes: true,
+ attributeFilter: ['data-state'],
+ });
+ if (tryFlash()) {
+ observer.disconnect();
+ } else {
giveUpTimer = setTimeout(() => observer?.disconnect(), 4000);
}
@@ -198,7 +217,26 @@ export function SettingsDialogShell({
{ id: 'sharing', label: t`Config sharing`, anchor: 'section:sharing' },
] satisfies SidebarSubsection[],
},
- { id: 'search', label: t`Search` },
+ {
+ id: 'search',
+ label: t`Search`,
+ subsections: [
+ {
+ id: 'performance',
+ label: t`Embedding request settings`,
+ anchor: 'search.semantic.maxBatchSize',
+ keywords: [
+ t({ message: 'batch', context: 'settings search keyword' }),
+ t({ message: 'characters', context: 'settings search keyword' }),
+ t({ message: 'timeout', context: 'settings search keyword' }),
+ t({ message: 'embeddings', context: 'settings search keyword' }),
+ t({ message: 'requests', context: 'settings search keyword' }),
+ t({ message: 'performance', context: 'settings search keyword' }),
+ 'Ollama',
+ ],
+ },
+ ] satisfies SidebarSubsection[],
+ },
{ id: 'plugins-manage', label: t`Plugins` },
...(isFileProtocolRenderer ? [] : [{ id: 'link-previews', label: t`Link previews` }]),
...(isOkDesktopHost ? [{ id: 'network-access', label: t`Remote control` }] : []),
diff --git a/packages/app/src/components/settings/settings-search-index.test.ts b/packages/app/src/components/settings/settings-search-index.test.ts
index 5468ff6e2..8eeac1507 100644
--- a/packages/app/src/components/settings/settings-search-index.test.ts
+++ b/packages/app/src/components/settings/settings-search-index.test.ts
@@ -29,7 +29,21 @@ function groupsFixture(opts: {
id: 'project',
label: 'This project',
enabled: projectEnabled,
- items: [{ id: 'sync', label: 'Sync' }],
+ items: [
+ { id: 'sync', label: 'Sync' },
+ {
+ id: 'search',
+ label: 'Search',
+ subsections: [
+ {
+ id: 'performance',
+ label: 'Embedding request settings',
+ anchor: 'search.semantic.maxBatchSize',
+ keywords: ['batch', 'characters', 'timeout', 'embeddings', 'Ollama'],
+ },
+ ],
+ },
+ ],
},
{ id: 'plugins', label: 'Plugins', enabled: true, items: pluginItems },
];
@@ -206,6 +220,18 @@ describe('buildSettingsSearchIndex + matchesCommandQuery', () => {
expect(find('Sync').some((e) => e.kind === 'section' && e.sectionId === 'sync')).toBe(true);
});
+ test.each(['batch', 'characters', 'timeout', 'embeddings', 'Ollama'])(
+ 'embedding performance is found by the %s keyword',
+ (query) => {
+ expect(
+ find(query).some(
+ (entry) =>
+ entry.sectionId === 'search' && entry.targetField === 'search.semantic.maxBatchSize',
+ ),
+ ).toBe(true);
+ },
+ );
+
test('a query matching nothing returns no entries', () => {
expect(find('zzzznomatch')).toHaveLength(0);
});
diff --git a/packages/app/src/components/settings/settings-search-index.ts b/packages/app/src/components/settings/settings-search-index.ts
index 0193befe0..c37c95d6f 100644
--- a/packages/app/src/components/settings/settings-search-index.ts
+++ b/packages/app/src/components/settings/settings-search-index.ts
@@ -43,7 +43,7 @@ export function buildSettingsSearchIndex(input: {
sectionId: item.id,
label: sub.label,
context: `${group.label} → ${item.label}`,
- keywords: [group.label, item.label],
+ keywords: [group.label, item.label, ...(sub.keywords ?? [])],
targetField: sub.anchor,
});
}
diff --git a/packages/app/src/components/settings/settings-sidebar-types.ts b/packages/app/src/components/settings/settings-sidebar-types.ts
index 45eba3878..edec42bb5 100644
--- a/packages/app/src/components/settings/settings-sidebar-types.ts
+++ b/packages/app/src/components/settings/settings-sidebar-types.ts
@@ -1,6 +1,7 @@
export interface SidebarSubsection {
id: string;
label: string;
+ keywords?: string[];
anchor: string;
}
diff --git a/packages/app/src/locales/ar/messages.json b/packages/app/src/locales/ar/messages.json
index 9a3b9fc1d..5b5e04242 100644
--- a/packages/app/src/locales/ar/messages.json
+++ b/packages/app/src/locales/ar/messages.json
@@ -170,6 +170,7 @@
"0jD-Gn": ["قاعدة معرفة لفريق، ويكي شخصي، مستندات مشروع..."],
"0kTAXe": ["فتح المصدر: ", ["mirrorSrc"]],
"0m4Snh": ["أُعيد إسناد المهارات"],
+ "0mlCvF": ["أحرف"],
"0niWj3": [
[
"removingCount",
@@ -446,6 +447,7 @@
"3zDeFb": ["يجري التفكير مليًا…"],
"3zyg_A": ["أنماط التجاهل"],
"4-Phgi": ["إظهار الوكلاء أو إخفاؤهم"],
+ "42QMZH": ["طلبات"],
"438Fca": ["تم الاستنساخ بنجاح، لكن تعذّر فتح المشروع."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -1016,6 +1018,9 @@
"9tJX8r": ["حسب المعنى"],
"9uI_rE": ["تراجع"],
"9uRLEH": ["تعذّر فتح «", ["name"], "» — ليست ضمن مهارات المشروع بعد."],
+ "9wIf0H": [
+ "اخفض هذه القيمة لتقليل استهلاك الذاكرة والعمل لكل طلب. الدفعات الأصغر ترسل طلبات أكثر وقد تجعل الفهرسة أبطأ إجمالًا."
+ ],
"9wQrUU": ["إعادة هيكلة"],
"9x-lMu": ["في هذا المستودع — يحصل المتعاونون على نسخ عبر git."],
"9xCnv8": ["إخفاء Terminal"],
@@ -1068,6 +1073,7 @@
"AUV-TY": ["يفكّر"],
"AVW-K9": ["فشل تحميل الصفحات اليتيمة"],
"AWOSPo": ["تكبير"],
+ "AXMOeM": ["أداء"],
"AYoYhU": ["فشل التحديث: ", ["0"]],
"AaC-CE": ["لوحة فارغة"],
"AcK_r0": ["واجهة Claude السطرية"],
@@ -1169,6 +1175,7 @@
"Bdha5y": ["يجري النشر..."],
"BeWTQy": ["يجري تحميل حزم البداية"],
"BgV29F": ["حقل بحث المحرر المرئي مركَّز عليه"],
+ "Bgaa_U": ["فشل تحديث إعداد الأداء — ", ["detail"]],
"BhLPRk": ["تم التراجع بـ «", ["name"], "» إلى النسخة المثبتة"],
"BjitBo": ["تنزيل ", ["0"]],
"BkGtRl": [
@@ -1262,6 +1269,7 @@
"CbxTfe": ["تحديد الكتلة"],
"CcaU4i": ["تُطبّق التعديلات مباشرة وتُحفظ تلقائيًا في هذه السمة."],
"ChMshD": ["إنهاء ", ["appName"]],
+ "ChdabN": ["أفرغ الحقل لاستعادة قيمته الافتراضية."],
"Ck9XRt": ["تعذّر حفظ المفتاح — يرجى المحاولة مرة أخرى."],
"ClII5l": ["اضغط على الشمس أو القمر بجوار «مخصص» أعلاه لاستخدام هذه السمة."],
"ClTEde": ["تجهيز المقطع المحدد في لوحة الوكلاء، جاهزًا للإضافة والإرسال."],
@@ -1551,6 +1559,7 @@
"FgQ7XZ": ["تعذّر تحميل تقارير العلل الخاصة بك."],
"FgRAvd": ["السجلات ومعلومات النظام"],
"Fhp4Gn": ["عرض الإضافة"],
+ "Fim5F3": ["تضمينات"],
"FiyNln": ["الانتقال إلى النص المحدد في الخاصية"],
"FjkaiT": ["تصغير"],
"Fjz6aJ": ["إرسال إلى محادثة جديدة"],
@@ -2001,6 +2010,7 @@
"L4Cdd9": ["أو أنشئ ملفًا جديدًا <0/>"],
"L6Hhh6": ["(الجذر)"],
"L6Ud-t": ["تعذّر تحميل التعارضات. أعد التحميل للمحاولة مرة أخرى."],
+ "L7NFTZ": ["أدخل عددًا من الثواني بين ", ["minimum"], " و", ["maximum"], "."],
"L83DKQ": ["فشل التثبيت في PATH: ", ["summary"]],
"L8fKuc": ["شغّل هذا في طرفيتك"],
"L9Y9Om": ["أكثر الصفحات ارتباطًا"],
@@ -2506,6 +2516,7 @@
"QQbwzK": ["لا يوجد وكلاء متاحون."],
"QQghPu": ["التثبيت في Claude Desktop"],
"QR5SP1": ["أنشأ قالبًا"],
+ "QRSdsO": ["مهلة طلب الفهرسة (بالثواني)"],
"QVk3SK": ["تم حذف هذا الملف على الفرع الوارد (تعارض تعديل/حذف)."],
"QWdKwH": ["نقل"],
"QYTOaN": ["يمكنك تغيير هذا لاحقًا من <0>الإعدادات ← المزامنة</0>."],
@@ -2589,6 +2600,7 @@
"RGCCrg": ["نسخ رابط المشاركة"],
"RGkNeJ": ["تهيئة حزمة بداية"],
"RGptDW": ["نقل OpenKnowledge مستندًا"],
+ "RH0e_f": ["مهلة"],
"RJ3a8Z": ["يجري البحث عن <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"من إضافة ",
@@ -3154,6 +3166,9 @@
"XYZ7tp": ["غير قابل للحل"],
"XYlJJT": ["يجري الإعداد"],
"XZkdtg": ["تبديل الفرع"],
+ "Xafwko": [
+ "يحدّ من إجمالي النص المُرسل في كل طلب. تُرسل القطعة الأكبر بمفردها، ولا تُقسَّم المستندات من جديد."
+ ],
"XcGbim": ["إظهار الملفات المخفية"],
"Xet9MX": ["فشل تحميل الروابط الخلفية"],
"Xewl6B": ["نسختك المحلية متأخرة. اسحب أحدث التغييرات، ثم افتح الرابط مرة أخرى."],
@@ -3666,6 +3681,7 @@
"cRm498": ["لا توجد ملفات مخططات في هذا المشروع بعد — أنشئ واحدًا لبدء التحقق."],
"cSCbv3": ["بيتا"],
"cT_pW4": ["كتلة محتوى قابلة للطي (تبديل بنمط Notion)."],
+ "cTrVa1": ["إعدادات طلبات التضمين"],
"cU-seF": ["انتقل إلى مصدر Markdown للكتلة عند المؤشر، موسّطًا ومظللًا."],
"cUK8lW": [
[
@@ -3932,6 +3948,7 @@
"eGUbmF": ["نسخ الملف أو المجلد المحدد"],
"eJitUk": ["الرفع من الجهاز"],
"eKThTQ": ["فشلت إعادة الترتيب"],
+ "eMWRAs": ["الصفحات المفهرسة: ", ["semanticIndexedCount"], " من ", ["semanticTotalCount"], "."],
"eNOyTV": [
"ليست لديك صلاحية الدفع إلى هذا المستودع. تلقائي (سحب فقط) يمكنه مع ذلك إبقاء نسختك محدثة."
],
@@ -4227,6 +4244,9 @@
"gyHDWC": ["إصلاح الكل بالذكاء الاصطناعي (", ["count"], ")"],
"gyYvCN": ["دفع تعديلاتي كل"],
"h-AdvS": ["المجلدات والقوالب موجودة هنا بالفعل، فلا شيء لإضافته."],
+ "h-RPqa": [
+ "المدة التي ينتظرها OpenKnowledge لكل طلب تضمين أثناء الفهرسة. لطلبات البحث مهلة ثابتة تبلغ 8 ثوانٍ لكل محاولة، ولا يغيّرها هذا الإعداد."
+ ],
"h06R3C": ["لا توجد صفحات تفتقر إلى روابط صادرة في الرسم البياني."],
"h16FyT": ["القوائم"],
"h2N-1n": ["مثبَّت في ", ["0"]],
@@ -4461,6 +4481,7 @@
"jTLWxh": ["ضمّن صفحة خارجية في إطار مضمَّن (مستندات، عروض، Figma، CodeSandbox)."],
"jTUxaN": ["تفعيل تلقائي (سحب فقط)"],
"jTdrn1": ["تعذر التحقق مما إذا كان ", ["filePath"], " لا يزال متعارضًا — تجري إعادة المحاولة."],
+ "jWwQo6": ["دفعة"],
"jWzDfC": ["جارٍ التحقق من أدوات الذكاء الاصطناعي المتوفّرة لديك"],
"jZ_E5M": ["فشل الجلب — راجع سجلات الخادم للتفاصيل."],
"j_Z6g7": ["الافتراضي المشترك"],
@@ -4514,13 +4535,6 @@
"</0> — تتجاهله معظم الخوادم المحلية. أضفه فقط إن كان خادمك يحتاجه."
],
"kBNHN1": ["سجل التنقل"],
- "kCNU4q": [
- "تجري فهرسة صفحاتك — ",
- ["semanticIndexedCount"],
- " من ",
- ["semanticTotalCount"],
- " جاهزة. قد تكون النتائج ناقصة."
- ],
"kCjkGY": ["قد يستغرق هذا لحظة. يُحتفظ بمحتوى Markdown لديك."],
"kCqCyf": ["افتح لوحة تشخيصات الفحص في CodeMirror."],
"kEiVv6": [
@@ -4551,6 +4565,7 @@
"وجّه البحث الدلالي إلى أي نقطة نهاية تضمينات متوافقة مع OpenAI — خادم ذاتي الاستضافة أو مزوّد آخر. مفتاح API أعلاه يخص أي نقطة نهاية تضبطها هنا."
],
"kSiB3X": ["تعذّر النقل إلى ", ["trashNoun"]],
+ "kUgGPO": ["ميزانية الأحرف لكل طلب فهرسة"],
"kV2YZv": [
"لا ترى <0>المهارات</0>؟ فعّل <1>الإعدادات <2/> القدرات <3/> تنفيذ الكود وإنشاء الملفات</1> أولًا."
],
@@ -5102,6 +5117,7 @@
"q3W2nd": ["تعذّرت إضافة ذلك التعليق: ", ["0"]],
"q4YJl_": ["انتهت جلسة الطرفية (رمز الخروج ", ["0"], ")."],
"q4efaG": [["filePath"], " لم يعد ضمن هذه المهارة"],
+ "q5uZbJ": ["تُفهرس الصفحات المتبقية عند البحث. ابحث مرة أخرى للحصول على نتائج أكثر اكتمالًا."],
"q6-JVU": ["يجري تحميل الصفحات"],
"q63KUv": ["إضافة MCP ومهارة"],
"q7F5am": ["العنوان"],
@@ -5609,6 +5625,9 @@
"uoJF_D": ["كان إعداده أو البدء به صعبًا جدًا"],
"ur2XSb": ["المحرر المرئي"],
"uuoHOU": ["فشل الأمر."],
+ "uwzRx4": [
+ "اضبط حجم طلب الفهرسة ومهلته لخوادم التضمينات البطيئة أو المحدودة الذاكرة. ينبغي لمعظم الإعدادات الإبقاء على القيم الافتراضية."
+ ],
"uyJsf6": ["حول"],
"uyOQ4e": ["تم نسخ السمة بتنسيق base16 YAML"],
"uynXup": [
@@ -6092,11 +6111,13 @@
"zbymaY": ["قبل ", ["0"], " دقيقة"],
"zd00pH": ["نسخ المسار"],
"zgSFyG": ["رابط خارجي"],
+ "zkkEFa": ["أدخل عددًا صحيحًا بين ", ["minimum"], " و", ["maximum"], "."],
"zkz0Fg": ["إعداد المزامنة"],
"zlErBl": ["لم تطابق استجابة خطأ عناوين الصفحة معيار RFC 9457"],
"zo3Dl7": ["تبديل الصور المصغّرة"],
"zpfN9p": ["لا توجد تعليقات بعد. حدد نصًا في المستند لإضافة واحد."],
"zq2eBA": ["العرض في المصدر"],
+ "zqQlBg": ["الحد الأقصى لقطع النص لكل طلب فهرسة"],
"zrP8HX": [
"الـ frontmatter الذي يبدأ به كل مستند يُنشأ من هذا القالب. القيم بصيغة YAML — القائمة تُكتب <0>[a, b]</0>؛ و<1>{",
["date"],
diff --git a/packages/app/src/locales/ar/messages.po b/packages/app/src/locales/ar/messages.po
index ea902d56e..015caba24 100644
--- a/packages/app/src/locales/ar/messages.po
+++ b/packages/app/src/locales/ar/messages.po
@@ -1730,6 +1730,10 @@ msgstr "يضيف هذه الملفات"
msgid "Adds these folders"
msgstr "يضيف هذه المجلدات"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "اضبط حجم طلب الفهرسة ومهلته لخوادم التضمينات البطيئة أو المحدودة الذاكرة. ينبغي لمعظم الإعدادات الإبقاء على القيم الافتراضية."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "لم تطابق استجابة الروابط الخلفية الشكل
msgid "Base branch"
msgstr "الفرع الأساسي"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "دفعة"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "يصبح رابطًا رمزيًا"
@@ -2637,6 +2646,15 @@ msgstr "تُحفظ التغييرات تلقائيًا."
msgid "Changes saved automatically."
msgstr "حُفظت التغييرات تلقائيًا."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "ميزانية الأحرف لكل طلب فهرسة"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "أحرف"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "التحقق من التحديثات"
@@ -2836,6 +2854,10 @@ msgstr "مسح"
msgid "Clear {keyName}"
msgstr "مسح {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "أفرغ الحقل لاستعادة قيمته الافتراضية."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "إزالة اللون"
@@ -5344,6 +5366,16 @@ msgstr "ضمّن صفحة خارجية في إطار مضمَّن (مستندا
msgid "Embed an image with optional alt text."
msgstr "ضمّن صورة مع نص بديل اختياري."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "إعدادات طلبات التضمين"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "تضمينات"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "مفتاح API للتضمينات"
@@ -5510,6 +5542,10 @@ msgstr "أدخل اسم مجلد (مثل brain)."
msgid "Enter a name for this theme."
msgstr "أدخل اسمًا لهذه السمة."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "أدخل عددًا من الثواني بين {minimum} و{maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "أدخل منفذًا بين 1 و65535."
@@ -5542,6 +5578,10 @@ msgstr "أدخل رابطًا صالحًا (مثل https://api.openai.com/v1)."
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "أدخل عنوان URL صالحًا، على سبيل المثال https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "أدخل عددًا صحيحًا بين {minimum} و{maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "أدخل الأصل العام الذي يخدمه النفق الخاص بك، على سبيل المثال https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "فشل تحديث موقع المرفقات — {detail}"
msgid "Failed to update markdownlint rules"
msgstr "فشل تحديث قواعد markdownlint"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "فشل تحديث إعداد الأداء — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "ما رأيك في OpenKnowledge؟"
msgid "How does sharing work?"
msgstr "كيف تعمل المشاركة؟"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "المدة التي ينتظرها OpenKnowledge لكل طلب تضمين أثناء الفهرسة. لطلبات البحث مهلة ثابتة تبلغ 8 ثوانٍ لكل محاولة، ولا يغيّرها هذا الإعداد."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "كيفية الإبلاغ عن مستندات المشروع المحلية والملفات والصور المفقودة في المشكلات وتشخيصات المحرر وعمليات التدقيق وأدوات الوكيل."
@@ -7113,9 +7161,9 @@ msgstr "توقفت صيانة الفهرس بسبب تعذر حفظ إعداد
msgid "Indexed {embedded} of {total} pages."
msgstr "تمت فهرسة {embedded} من {total} صفحة."
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "تجري فهرسة صفحاتك — {semanticIndexedCount} من {semanticTotalCount} جاهزة. قد تكون النتائج ناقصة."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "مهلة طلب الفهرسة (بالثواني)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "فاتح"
msgid "Light, dark, or follow the OS."
msgstr "فاتح أو داكن أو تتبع نظام التشغيل."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "يحدّ من إجمالي النص المُرسل في كل طلب. تُرسل القطعة الأكبر بمفردها، ولا تُقسَّم المستندات من جديد."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "السطر {displayLine}"
@@ -7989,6 +8041,10 @@ msgstr "يجري البحث عن <0>{lookingForUrl}</0>."
msgid "Lost connection to \"{docName}\"."
msgstr "فُقد الاتصال بـ «{docName}»."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "اخفض هذه القيمة لتقليل استهلاك الذاكرة والعمل لكل طلب. الدفعات الأصغر ترسل طلبات أكثر وقد تجعل الفهرسة أبطأ إجمالًا."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "هل تريد الحفاظ على فهارس generated في كل مجلد؟"
@@ -8099,6 +8155,10 @@ msgstr "بحد أقصى {MAX_ATTACHMENTS} مرفقات"
msgid "Maximum agents already running"
msgstr "يعمل الحد الأقصى من الوكلاء بالفعل"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "الحد الأقصى لقطع النص لكل طلب فهرسة"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "فشل الإصلاح التلقائي لـ MCP"
@@ -8186,6 +8246,10 @@ msgstr "صفحة مفقودة — انقر لإنشائها"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "صفحة مفقودة: {linkTitle}. انقر لإنشائها."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "تُفهرس الصفحات المتبقية عند البحث. ابحث مرة أخرى للحصول على نتائج أكثر اكتمالًا."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "ألوان لوحة الألوان مفقودة"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "تُضمَّن الصفحات أول مرة يحتاجها فيها بحث."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "الصفحات المفهرسة: {semanticIndexedCount} من {semanticTotalCount}."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "تحريك لأسفل"
@@ -10210,6 +10278,11 @@ msgstr "معلّق"
msgid "Percolating…"
msgstr "يجري الترشيح…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "أداء"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "يحذف <0>{targetGitPath}</0> وكل سجل git الخاص به نهائيًا. تبقى ملفات العمل في مكانها. إن كان مستودع git الأب مقصودًا (مثلًا لأنك استنسخته)، فألغِ واختر موقعًا خارجه."
@@ -11309,6 +11382,11 @@ msgstr "لم يُعثر على المستودع — ربما لا يكون مو
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "لم يُعثر على المستودع. ربما أُعيدت تسميته أو حُذف أو نُقل."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "طلبات"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "مطلوب"
@@ -11662,6 +11740,7 @@ msgstr "حفظ هذا التعليق (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "تم الحفظ"
@@ -14329,6 +14408,11 @@ msgstr "يجري الترتيب…"
msgid "Timeline"
msgstr "الخط الزمني"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "مهلة"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "لوّن وأشِر إلى الملفات التي بها مشكلات فحص أو روابط، دون فتحها."
diff --git a/packages/app/src/locales/bn/messages.json b/packages/app/src/locales/bn/messages.json
index 5ab94a896..fad9d032d 100644
--- a/packages/app/src/locales/bn/messages.json
+++ b/packages/app/src/locales/bn/messages.json
@@ -123,6 +123,7 @@
"0jD-Gn": ["একটি দলগত জ্ঞানভাণ্ডার, একটি ব্যক্তিগত উইকি, প্রকল্পের নথিপত্র…"],
"0kTAXe": ["উৎস খুলুন: ", ["mirrorSrc"]],
"0m4Snh": ["স্কিলগুলো পুনরায় নির্ধারিত হয়েছে"],
+ "0mlCvF": ["অক্ষর"],
"0niWj3": [
["removingCount", "plural", { "one": ["#", " সরানো হয়েছে"], "other": ["#", " সরানো হয়েছে"] }]
],
@@ -358,6 +359,7 @@
"3zDeFb": ["ভেবে দেখা হচ্ছে…"],
"3zyg_A": ["উপেক্ষার প্যাটার্ন"],
"4-Phgi": ["এজেন্ট দেখান বা লুকান"],
+ "42QMZH": ["অনুরোধ"],
"438Fca": ["সফলভাবে ক্লোন হয়েছে, কিন্তু প্রকল্পটি খোলা যায়নি।"],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -828,6 +830,9 @@
"9tJX8r": ["অর্থ অনুসারে"],
"9uI_rE": ["পূর্বাবস্থায় ফেরান"],
"9uRLEH": ["\"", ["name"], "\" খোলা যায়নি — এটি এখনও প্রকল্পের স্কিলে নেই।"],
+ "9wIf0H": [
+ "প্রতি অনুরোধে মেমোরি ব্যবহার ও কাজ কমাতে এটি কমান। ছোট ব্যাচ বেশি অনুরোধ পাঠায় এবং সামগ্রিকভাবে ইনডেক্সিং ধীর করতে পারে।"
+ ],
"9wQrUU": ["পুনর্গঠন"],
"9x-lMu": ["এই রিপোজিটরিতে — সহযোগীরা git-এর মাধ্যমে কপি পাবেন।"],
"9xCnv8": ["Terminal লুকান"],
@@ -869,6 +874,7 @@
"AUV-TY": ["ভাবছে"],
"AVW-K9": ["অনাথ পাতা লোড করতে ব্যর্থ"],
"AWOSPo": ["বড় করুন"],
+ "AXMOeM": ["কর্মক্ষমতা"],
"AYoYhU": ["হালনাগাদ ব্যর্থ: ", ["0"]],
"AaC-CE": ["খালি বোর্ড"],
"AcK_r0": ["Claude CLI"],
@@ -946,6 +952,7 @@
"Bdha5y": ["প্রকাশ করা হচ্ছে…"],
"BeWTQy": ["স্টার্টার প্যাক লোড হচ্ছে"],
"BgV29F": ["দৃশ্য সম্পাদকের খোঁজার ইনপুট ফোকাসে"],
+ "Bgaa_U": ["পারফরম্যান্স সেটিং হালনাগাদ করতে ব্যর্থ — ", ["detail"]],
"BhLPRk": ["\"", ["name"], "\"-কে ইনস্টল করা সংস্করণে ফিরিয়ে নেওয়া হয়েছে"],
"BjitBo": [["0"], " ডাউনলোড করুন"],
"BkGtRl": [
@@ -1015,6 +1022,7 @@
"CbxTfe": ["ব্লক নির্বাচন করুন"],
"CcaU4i": ["সম্পাদনাগুলি সঙ্গে সঙ্গে প্রয়োগ হয় এবং এই থিমে স্বয়ংক্রিয়ভাবে সংরক্ষিত হয়।"],
"ChMshD": [["appName"], " থেকে প্রস্থান"],
+ "ChdabN": ["কোনো ফিল্ডের ডিফল্ট মান ফিরিয়ে আনতে সেটি খালি করুন।"],
"Ck9XRt": ["কী সংরক্ষণ করা যায়নি — অনুগ্রহ করে আবার চেষ্টা করুন।"],
"ClII5l": ["এই থিম ব্যবহার করতে উপরের “কাস্টম”-এ সূর্য বা চাঁদ চাপুন।"],
"ClTEde": ["নির্বাচিত অংশ এজেন্ট প্যানেলে প্রস্তুত রাখুন, যোগ করে পাঠানোর জন্য তৈরি।"],
@@ -1288,6 +1296,7 @@
"FgQ7XZ": ["আপনার বাগ রিপোর্ট লোড করা যায়নি।"],
"FgRAvd": ["লগ ও সিস্টেমের তথ্য"],
"Fhp4Gn": ["প্লাগইন দেখুন"],
+ "Fim5F3": ["এম্বেডিং"],
"FiyNln": ["প্রপার্টিতে নির্বাচিত লেখায় যান"],
"FjkaiT": ["ছোট করুন"],
"Fjz6aJ": ["নতুন চ্যাটে পাঠান"],
@@ -1682,6 +1691,7 @@
"L4Cdd9": ["নয়তো একটি নতুন ফাইল তৈরি করুন <0/>"],
"L6Hhh6": ["(রুট)"],
"L6Ud-t": ["দ্বন্দ্বগুলো লোড করা যায়নি। আবার চেষ্টা করতে রিলোড করুন।"],
+ "L7NFTZ": [["minimum"], " থেকে ", ["maximum"], " এর মধ্যে সেকেন্ডের সংখ্যা লিখুন।"],
"L83DKQ": ["PATH ইনস্টল ব্যর্থ হয়েছে: ", ["summary"]],
"L8fKuc": ["এটি আপনার টার্মিনালে চালান"],
"L9Y9Om": ["সবচেয়ে বেশি লিংক করা পাতা"],
@@ -2124,6 +2134,7 @@
"QQbwzK": ["কোনো এজেন্ট নেই।"],
"QQghPu": ["Claude Desktop-এ ইনস্টল করুন"],
"QR5SP1": ["টেমপ্লেট তৈরি হয়েছে"],
+ "QRSdsO": ["ইনডেক্সিং অনুরোধের সময়সীমা (সেকেন্ড)"],
"QVk3SK": ["এই ফাইলটি আগত ব্রাঞ্চে মুছে ফেলা হয়েছে (modify-delete দ্বন্দ্ব)।"],
"QWdKwH": ["সরান"],
"QYTOaN": ["আপনি এটি পরে <0>Settings → Sync</0>-এ বদলাতে পারেন।"],
@@ -2193,6 +2204,7 @@
"RGCCrg": ["শেয়ার লিংক কপি করুন"],
"RGkNeJ": ["একটি স্টার্টার প্যাক চালু করুন"],
"RGptDW": ["OpenKnowledge একটি নথি সরিয়েছে"],
+ "RH0e_f": ["সময়সীমা"],
"RJ3a8Z": ["<0>", ["lookingForUrl"], "</0> খোঁজা হচ্ছে।"],
"RJMO4B": [
["residentPlugin"],
@@ -2650,6 +2662,9 @@
"XYZ7tp": ["সমাধান অযোগ্য"],
"XYlJJT": ["সেট আপ করা হচ্ছে"],
"XZkdtg": ["ব্রাঞ্চ বদলান"],
+ "Xafwko": [
+ "প্রতিটি অনুরোধে পাঠানো মোট লেখার পরিমাণ সীমিত করে। বড় একক খণ্ড আলাদাভাবে পাঠানো হয়; নথি আবার ভাগ করা হয় না।"
+ ],
"XcGbim": ["লুকানো ফাইল দেখান"],
"Xet9MX": ["ব্যাকলিংক লোড করতে ব্যর্থ"],
"Xewl6B": ["আপনার স্থানীয় অনুলিপি পিছিয়ে আছে। সর্বশেষ পরিবর্তন টেনে নিন, তারপর লিংকটি আবার খুলুন।"],
@@ -3117,6 +3132,7 @@
"cRm498": ["এই প্রকল্পে এখনও কোনো স্কিমা ফাইল নেই — যাচাই শুরু করতে একটি তৈরি করুন।"],
"cSCbv3": ["বিটা"],
"cT_pW4": ["সংকোচনযোগ্য কনটেন্ট ব্লক (Notion-ধাঁচের টগল)।"],
+ "cTrVa1": ["এমবেডিং অনুরোধ সেটিংস"],
"cU-seF": ["কার্সরে থাকা ব্লকের markdown সোর্সে যান, মাঝখানে ও হাইলাইট করা অবস্থায়।"],
"cUK8lW": [["conflictCount", "plural", { "one": ["#", " দ্বন্দ্ব"], "other": ["#", " দ্বন্দ্ব"] }]],
"cUagXn": [["gitignorePath"], "-এ যোগ করুন"],
@@ -3285,6 +3301,13 @@
"eGUbmF": ["নির্বাচিত ফাইল বা ফোল্ডার কপি করুন"],
"eJitUk": ["কম্পিউটার থেকে আপলোড করুন"],
"eKThTQ": ["ক্রম বদলাতে ব্যর্থ"],
+ "eMWRAs": [
+ "ইনডেক্স করা পৃষ্ঠা: ",
+ ["semanticTotalCount"],
+ "টির মধ্যে ",
+ ["semanticIndexedCount"],
+ "টি।"
+ ],
"eNOyTV": [
"এই রিপোজিটরিতে পুশ করার অনুমতি আপনার নেই। স্বয়ংক্রিয় (শুধু টানুন) তবুও আপনার কপি হালনাগাদ রাখতে পারে।"
],
@@ -3537,6 +3560,9 @@
"gyHDWC": ["AI দিয়ে সব ঠিক করুন (", ["count"], ")"],
"gyYvCN": ["আমার সম্পাদনা পাঠানোর ব্যবধান"],
"h-AdvS": ["ফোল্ডার ও টেমপ্লেট আগে থেকেই এখানে আছে, তাই যোগ করার কিছু নেই।"],
+ "h-RPqa": [
+ "ইনডেক্স তৈরির সময় OpenKnowledge প্রতিটি এম্বেডিং অনুরোধের জন্য কতক্ষণ অপেক্ষা করে। অনুসন্ধান অনুরোধের প্রতি প্রচেষ্টায় সময়সীমা ৮ সেকেন্ড নির্ধারিত থাকে এবং এই সেটিং তা পরিবর্তন করে না।"
+ ],
"h06R3C": ["কোনো পাতার বহির্গামী গ্রাফ লিংক অনুপস্থিত নয়।"],
"h16FyT": ["তালিকা"],
"h2N-1n": [["0"], "-এ ইনস্টল করা"],
@@ -3770,6 +3796,7 @@
"jTLWxh": ["একটি বাইরের পাতা ইনলাইন iframe-এ এমবেড করুন (নথি, ডেমো, Figma, CodeSandbox)।"],
"jTUxaN": ["স্বয়ংক্রিয় (শুধু টানুন) চালু করুন"],
"jTdrn1": [["filePath"], "-এ এখনও কনফ্লিক্ট আছে কি না যাচাই করা যায়নি — আবার চেষ্টা করা হচ্ছে।"],
+ "jWwQo6": ["ব্যাচ"],
"jWzDfC": ["আপনার কোন AI টুল আছে তা যাচাই করা হচ্ছে"],
"jZ_E5M": ["আনা ব্যর্থ — বিস্তারিত জানতে সার্ভার লগ দেখুন।"],
"j_Z6g7": ["ভাগ করা ডিফল্ট"],
@@ -3827,13 +3854,6 @@
"</0>-এর মতো localhost এন্ডপয়েন্টের জন্য দরকার নেই — বেশিরভাগ স্থানীয় সার্ভার এটি উপেক্ষা করে। আপনার সার্ভারের দরকার হলেই কেবল একটি যোগ করুন।"
],
"kBNHN1": ["নেভিগেশনের ইতিহাস"],
- "kCNU4q": [
- "আপনার পাতাগুলো সূচিভুক্ত করা হচ্ছে — ",
- ["semanticTotalCount"],
- "টির মধ্যে ",
- ["semanticIndexedCount"],
- "টি প্রস্তুত। ফলাফল অসম্পূর্ণ হতে পারে।"
- ],
"kCjkGY": ["এতে একটু সময় লাগতে পারে। আপনার markdown বিষয়বস্তু রক্ষা করা হয়।"],
"kCqCyf": ["CodeMirror-এর lint নির্ণয় প্যানেল খুলুন।"],
"kEiVv6": [
@@ -3864,6 +3884,7 @@
"অর্থভিত্তিক অনুসন্ধানকে যেকোনো OpenAI-সঙ্গতিপূর্ণ এমবেডিং এন্ডপয়েন্টে লাগান — নিজে হোস্ট করা সার্ভার বা অন্য কোনো সরবরাহকারী। উপরের API কী-টি আপনি এখানে যে এন্ডপয়েন্ট নির্ধারণ করেন তার জন্যই।"
],
"kSiB3X": [["trashNoun"], "-এ পাঠানো যায়নি"],
+ "kUgGPO": ["প্রতি ইনডেক্সিং অনুরোধে অক্ষর বাজেট"],
"kV2YZv": [
"<0>Skills</0> দেখতে পাচ্ছেন না? আগে <1>Settings <2/> Capabilities <3/> Code execution and file creation</1> চালু করুন।"
],
@@ -4327,6 +4348,7 @@
"q3W2nd": ["ওই মন্তব্যটি যোগ করা যায়নি: ", ["0"]],
"q4YJl_": ["টার্মিনাল সেশন শেষ হয়েছে (প্রস্থান কোড ", ["0"], ")।"],
"q4efaG": [["filePath"], " আর এই স্কিলে নেই"],
+ "q5uZbJ": ["বাকি পৃষ্ঠাগুলো অনুসন্ধান করার সময় ইনডেক্স করা হয়। আরও সম্পূর্ণ ফলাফলের জন্য আবার অনুসন্ধান করুন।"],
"q6-JVU": ["পাতা লোড হচ্ছে"],
"q63KUv": ["MCP ও স্কিল যোগ করুন"],
"q7F5am": ["শিরোনাম"],
@@ -4757,6 +4779,9 @@
"uoJF_D": ["এটি সেট আপ করা বা শুরু করা খুব কঠিন ছিল"],
"ur2XSb": ["দৃশ্য সম্পাদক"],
"uuoHOU": ["কমান্ড ব্যর্থ।"],
+ "uwzRx4": [
+ "ধীর বা কম মেমোরির এমবেডিং সার্ভারের জন্য ইনডেক্সিং অনুরোধের আকার ও সময়সীমা সমন্বয় করুন। বেশিরভাগ ক্ষেত্রে ডিফল্ট মানই রাখা উচিত।"
+ ],
"uyJsf6": ["সম্পর্কে"],
"uyOQ4e": ["থিমটি base16 YAML হিসেবে কপি করা হয়েছে"],
"uynXup": [["tokens", "plural", { "one": ["টোকেন"], "other": ["টোকেন"] }]],
@@ -5118,11 +5143,13 @@
"zbymaY": [["0"], " মিনিট আগে"],
"zd00pH": ["পথ কপি করুন"],
"zgSFyG": ["বাইরের লিংক"],
+ "zkkEFa": [["minimum"], " থেকে ", ["maximum"], " এর মধ্যে একটি পূর্ণসংখ্যা লিখুন।"],
"zkz0Fg": ["সিঙ্ক সেট আপ করুন"],
"zlErBl": ["পাতার শিরোনামের ত্রুটি সাড়া RFC 9457-এর সঙ্গে মেলেনি"],
"zo3Dl7": ["থাম্বনেইল চালু বা বন্ধ করুন"],
"zpfN9p": ["এখনও কোনো মন্তব্য নেই। একটি যোগ করতে নথিতে লেখা নির্বাচন করুন।"],
"zq2eBA": ["সোর্সে দেখুন"],
+ "zqQlBg": ["প্রতি ইনডেক্সিং অনুরোধে সর্বাধিক টেক্সট খণ্ড"],
"zrP8HX": [
"এই টেমপ্লেট থেকে তৈরি প্রতিটি নথি যে frontmatter দিয়ে শুরু হয়। মানগুলো YAML — তালিকা হলো <0>[a, b]</0>; <1>{",
["date"],
diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.po
index 9d0741130..17ef44a19 100644
--- a/packages/app/src/locales/bn/messages.po
+++ b/packages/app/src/locales/bn/messages.po
@@ -1726,6 +1726,10 @@ msgstr "এই ফাইলগুলো যোগ করে"
msgid "Adds these folders"
msgstr "এই ফোল্ডারগুলো যোগ করে"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "ধীর বা কম মেমোরির এমবেডিং সার্ভারের জন্য ইনডেক্সিং অনুরোধের আকার ও সময়সীমা সমন্বয় করুন। বেশিরভাগ ক্ষেত্রে ডিফল্ট মানই রাখা উচিত।"
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2287,6 +2291,11 @@ msgstr "ব্যাকলিংকের সাড়া প্রত্যা
msgid "Base branch"
msgstr "ভিত্তি ব্রাঞ্চ"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "ব্যাচ"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "সিমলিংক হয়ে যায়"
@@ -2633,6 +2642,15 @@ msgstr "পরিবর্তনগুলি স্বয়ংক্রিয
msgid "Changes saved automatically."
msgstr "পরিবর্তনগুলি স্বয়ংক্রিয়ভাবে সংরক্ষিত হয়েছে।"
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "প্রতি ইনডেক্সিং অনুরোধে অক্ষর বাজেট"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "অক্ষর"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "হালনাগাদ দেখুন"
@@ -2832,6 +2850,10 @@ msgstr "মুছুন"
msgid "Clear {keyName}"
msgstr "{keyName} মুছুন"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "কোনো ফিল্ডের ডিফল্ট মান ফিরিয়ে আনতে সেটি খালি করুন।"
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "রং সরান"
@@ -5340,6 +5362,16 @@ msgstr "একটি বাইরের পাতা ইনলাইন iframe-
msgid "Embed an image with optional alt text."
msgstr "ঐচ্ছিক বিকল্প-লেখাসহ একটি ছবি এমবেড করুন।"
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "এমবেডিং অনুরোধ সেটিংস"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "এম্বেডিং"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "এমবেডিং API কী"
@@ -5506,6 +5538,10 @@ msgstr "একটি ফোল্ডারের নাম দিন (যেম
msgid "Enter a name for this theme."
msgstr "এই থিমের জন্য একটি নাম লিখুন।"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "{minimum} থেকে {maximum} এর মধ্যে সেকেন্ডের সংখ্যা লিখুন।"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "১ থেকে ৬৫৫৩৫-এর মধ্যে একটি পোর্ট লিখুন।"
@@ -5538,6 +5574,10 @@ msgstr "একটি বৈধ URL দিন (উদাহরণস্বরূ
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "একটি বৈধ URL লিখুন, উদাহরণস্বরূপ https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "{minimum} থেকে {maximum} এর মধ্যে একটি পূর্ণসংখ্যা লিখুন।"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "আপনার টানেল যে পাবলিক অরিজিন পরিবেশন করে তা লিখুন, উদাহরণস্বরূপ https://notes.example.com"
@@ -6005,6 +6045,10 @@ msgstr "সংযুক্তির জায়গা হালনাগাদ
msgid "Failed to update markdownlint rules"
msgstr "markdownlint নিয়ম হালনাগাদ করতে ব্যর্থ"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "পারফরম্যান্স সেটিং হালনাগাদ করতে ব্যর্থ — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6841,6 +6885,10 @@ msgstr "OpenKnowledge আপনার কেমন লাগছে?"
msgid "How does sharing work?"
msgstr "ভাগাভাগি কীভাবে কাজ করে?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "ইনডেক্স তৈরির সময় OpenKnowledge প্রতিটি এম্বেডিং অনুরোধের জন্য কতক্ষণ অপেক্ষা করে। অনুসন্ধান অনুরোধের প্রতি প্রচেষ্টায় সময়সীমা ৮ সেকেন্ড নির্ধারিত থাকে এবং এই সেটিং তা পরিবর্তন করে না।"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "অনুপস্থিত প্রজেক্ট-লোকাল ডকুমেন্ট, ফাইল ও ছবিগুলো সমস্যা, এডিটর ডায়াগনস্টিকস, অডিট এবং এজেন্ট টুলে কীভাবে রিপোর্ট করা হয়।"
@@ -7109,9 +7157,9 @@ msgstr "সূচী রক্ষণাবেক্ষণ বন্ধ ছিল
msgid "Indexed {embedded} of {total} pages."
msgstr "{total}টির মধ্যে {embedded}টি পাতা সূচিভুক্ত।"
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "আপনার পাতাগুলো সূচিভুক্ত করা হচ্ছে — {semanticTotalCount}টির মধ্যে {semanticIndexedCount}টি প্রস্তুত। ফলাফল অসম্পূর্ণ হতে পারে।"
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "ইনডেক্সিং অনুরোধের সময়সীমা (সেকেন্ড)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7664,6 +7712,10 @@ msgstr "হালকা"
msgid "Light, dark, or follow the OS."
msgstr "হালকা, গাঢ়, বা OS অনুসরণ করুন।"
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "প্রতিটি অনুরোধে পাঠানো মোট লেখার পরিমাণ সীমিত করে। বড় একক খণ্ড আলাদাভাবে পাঠানো হয়; নথি আবার ভাগ করা হয় না।"
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "লাইন {displayLine}"
@@ -7985,6 +8037,10 @@ msgstr "<0>{lookingForUrl}</0> খোঁজা হচ্ছে।"
msgid "Lost connection to \"{docName}\"."
msgstr "\"{docName}\"-এর সঙ্গে সংযোগ হারিয়েছে।"
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "প্রতি অনুরোধে মেমোরি ব্যবহার ও কাজ কমাতে এটি কমান। ছোট ব্যাচ বেশি অনুরোধ পাঠায় এবং সামগ্রিকভাবে ইনডেক্সিং ধীর করতে পারে।"
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "প্রতি ফোল্ডারে generated সূচী বজায় রাখুন?"
@@ -8095,6 +8151,10 @@ msgstr "সর্বোচ্চ {MAX_ATTACHMENTS}টি সংযুক্ত
msgid "Maximum agents already running"
msgstr "সর্বোচ্চসংখ্যক এজেন্ট আগে থেকেই চলছে"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "প্রতি ইনডেক্সিং অনুরোধে সর্বাধিক টেক্সট খণ্ড"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP স্বয়ংক্রিয় মেরামত ব্যর্থ হয়েছে"
@@ -8182,6 +8242,10 @@ msgstr "অনুপস্থিত পাতা — তৈরি করতে
msgid "Missing page: {linkTitle}. Click to create."
msgstr "অনুপস্থিত পাতা: {linkTitle}। তৈরি করতে ক্লিক করুন।"
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "বাকি পৃষ্ঠাগুলো অনুসন্ধান করার সময় ইনডেক্স করা হয়। আরও সম্পূর্ণ ফলাফলের জন্য আবার অনুসন্ধান করুন।"
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "প্যালেটের রং অনুপস্থিত"
@@ -10062,6 +10126,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "কোনো অনুসন্ধানের প্রথমবার দরকার পড়লেই পাতাগুলো এমবেড করা হয়।"
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "ইনডেক্স করা পৃষ্ঠা: {semanticTotalCount}টির মধ্যে {semanticIndexedCount}টি।"
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "নিচে সরান"
@@ -10206,6 +10274,11 @@ msgstr "অপেক্ষমাণ"
msgid "Percolating…"
msgstr "ছেঁকে দেখা হচ্ছে…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "কর্মক্ষমতা"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "<0>{targetGitPath}</0> এবং এর পুরো git ইতিহাস স্থায়ীভাবে মুছে দেয়। কাজের ফাইলগুলো যেখানে আছে সেখানেই থাকে। মূল git রিপোজিটরিটি ইচ্ছাকৃত হলে (যেমন আপনি সেটি ক্লোন করেছিলেন), বাতিল করে এর বাইরে একটি জায়গা বাছুন।"
@@ -11305,6 +11378,11 @@ msgstr "রিপোজিটরি পাওয়া যায়নি —
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "রিপোজিটরি পাওয়া যায়নি। হয়তো এর নাম বদলানো হয়েছে, মুছে ফেলা হয়েছে, বা সরানো হয়েছে।"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "অনুরোধ"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "আবশ্যক"
@@ -11658,6 +11736,7 @@ msgstr "এই মন্তব্যটি সংরক্ষণ করুন (E
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "সংরক্ষিত"
@@ -14325,6 +14404,11 @@ msgstr "গুছিয়ে নেওয়া হচ্ছে…"
msgid "Timeline"
msgstr "কালানুক্রম"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "সময়সীমা"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "যেসব ফাইলে lint বা লিংকের সমস্যা আছে সেগুলো না খুলেই রঙ ও ব্যাজ দিন।"
diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.json
index 31bfe78fd..03c4a467a 100644
--- a/packages/app/src/locales/en/messages.json
+++ b/packages/app/src/locales/en/messages.json
@@ -127,6 +127,7 @@
"0jD-Gn": ["A team knowledge base, a personal wiki, project docs..."],
"0kTAXe": ["Open source: ", ["mirrorSrc"]],
"0m4Snh": ["Skills reassigned"],
+ "0mlCvF": ["characters"],
"0niWj3": [
["removingCount", "plural", { "one": ["#", " removed"], "other": ["#", " removed"] }]
],
@@ -366,6 +367,7 @@
"3zDeFb": ["Ruminating…"],
"3zyg_A": ["Ignore patterns"],
"4-Phgi": ["Show or hide agents"],
+ "42QMZH": ["requests"],
"438Fca": ["Cloned successfully, but could not open the project."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -850,6 +852,9 @@
"9tJX8r": ["By meaning"],
"9uI_rE": ["Undo"],
"9uRLEH": ["Couldn't open \"", ["name"], "\" — it isn't in the project's skills yet."],
+ "9wIf0H": [
+ "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+ ],
"9wQrUU": ["Refactoring"],
"9x-lMu": ["In this repo — collaborators get copies via git."],
"9xCnv8": ["Hide Terminal"],
@@ -891,6 +896,7 @@
"AUV-TY": ["Thinking"],
"AVW-K9": ["Failed to load orphan pages"],
"AWOSPo": ["Zoom in"],
+ "AXMOeM": ["performance"],
"AYoYhU": ["Update failed: ", ["0"]],
"AaC-CE": ["Empty board"],
"AcK_r0": ["Claude CLI"],
@@ -978,6 +984,7 @@
"Bdha5y": ["Publishing..."],
"BeWTQy": ["Loading starter packs"],
"BgV29F": ["Visual editor find input focused"],
+ "Bgaa_U": ["Failed to update performance setting — ", ["detail"]],
"BhLPRk": ["Reverted \"", ["name"], "\" to the installed version"],
"BjitBo": ["Download ", ["0"]],
"BkGtRl": [
@@ -1049,6 +1056,7 @@
"CbxTfe": ["Select block"],
"CcaU4i": ["Edits apply live and save automatically to this theme."],
"ChMshD": ["Quit ", ["appName"]],
+ "ChdabN": ["Clear a field to restore its default value."],
"Ck9XRt": ["Couldn't save the key — please try again."],
"ClII5l": ["Press the sun or moon on “Custom” above to use this theme."],
"ClTEde": ["Stage the selected passage in the agents panel, ready to extend and send."],
@@ -1322,6 +1330,7 @@
"FgQ7XZ": ["Couldn't load your bug reports."],
"FgRAvd": ["Logs & system info"],
"Fhp4Gn": ["View plugin"],
+ "Fim5F3": ["embeddings"],
"FiyNln": ["Jump to selected text in property"],
"FjkaiT": ["Zoom out"],
"Fjz6aJ": ["Send to a new chat"],
@@ -1731,6 +1740,7 @@
"L4Cdd9": ["or create a new file <0/>"],
"L6Hhh6": ["(root)"],
"L6Ud-t": ["Couldn't load conflicts — reload to retry."],
+ "L7NFTZ": ["Enter a number of seconds between ", ["minimum"], " and ", ["maximum"], "."],
"L83DKQ": ["PATH install failed: ", ["summary"]],
"L8fKuc": ["Run this in your terminal"],
"L9Y9Om": ["Top linked pages"],
@@ -2187,6 +2197,7 @@
"QQbwzK": ["No agents available."],
"QQghPu": ["Install in Claude Desktop"],
"QR5SP1": ["created template"],
+ "QRSdsO": ["Indexing request timeout (seconds)"],
"QVk3SK": ["This file was deleted on the incoming branch (modify-delete conflict)."],
"QWdKwH": ["Move"],
"QYTOaN": ["You can change this later in <0>Settings → Sync</0>."],
@@ -2255,6 +2266,7 @@
"RGCCrg": ["Copy share link"],
"RGkNeJ": ["Initialize a starter pack"],
"RGptDW": ["OpenKnowledge moved a document"],
+ "RH0e_f": ["timeout"],
"RJ3a8Z": ["Looking for <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"From the ",
@@ -2716,6 +2728,9 @@
"XYZ7tp": ["Unresolvable"],
"XYlJJT": ["Setting up"],
"XZkdtg": ["Switch branch"],
+ "Xafwko": [
+ "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+ ],
"XcGbim": ["Show hidden files"],
"Xet9MX": ["Failed to load backlinks"],
"Xewl6B": ["Your local copy is behind. Pull the latest changes, then open the link again."],
@@ -3189,6 +3204,7 @@
"cRm498": ["No schema files in this project yet — create one to start validating."],
"cSCbv3": ["BETA"],
"cT_pW4": ["Collapsible content block (Notion-style toggle)."],
+ "cTrVa1": ["Embedding request settings"],
"cU-seF": [
"Jump to the markdown source for the block at the cursor, centered and highlighted."
],
@@ -3380,6 +3396,7 @@
"eGUbmF": ["Copy selected file or folder"],
"eJitUk": ["Upload from computer"],
"eKThTQ": ["Failed to reorder"],
+ "eMWRAs": ["Pages indexed: ", ["semanticIndexedCount"], " of ", ["semanticTotalCount"], "."],
"eNOyTV": [
"You don't have permission to push to this repo. Auto (Pull only) can still keep your copy up to date."
],
@@ -3651,6 +3668,9 @@
"gyHDWC": ["Fix all with AI (", ["count"], ")"],
"gyYvCN": ["Push my edits every"],
"h-AdvS": ["The folders and templates are already here, so there's nothing to add."],
+ "h-RPqa": [
+ "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+ ],
"h06R3C": ["No pages are missing outgoing graph links."],
"h16FyT": ["Lists"],
"h2N-1n": ["Installed in ", ["0"]],
@@ -3888,6 +3908,7 @@
"jTLWxh": ["Embed an external page in an inline iframe (docs, demos, Figma, CodeSandbox)."],
"jTUxaN": ["Enable Auto (Pull only)"],
"jTdrn1": ["Couldn't check whether ", ["filePath"], " is still conflicted — retrying."],
+ "jWwQo6": ["batch"],
"jWzDfC": ["Checking which AI tools you have"],
"jZ_E5M": ["Fetch failed — check the server logs for details."],
"j_Z6g7": ["Shared default"],
@@ -3945,13 +3966,6 @@
"</0> — most local servers ignore it. Add one only if yours needs it."
],
"kBNHN1": ["Navigation history"],
- "kCNU4q": [
- "Indexing your pages — ",
- ["semanticIndexedCount"],
- " of ",
- ["semanticTotalCount"],
- " ready. Results may be incomplete."
- ],
"kCjkGY": ["This may take a moment. Your markdown content is kept."],
"kCqCyf": ["Open CodeMirror's lint diagnostics panel."],
"kEiVv6": [
@@ -3984,6 +3998,7 @@
"Point semantic search at any OpenAI-compatible embeddings endpoint — a self-hosted server or another provider. The API key above is for whichever endpoint you set here."
],
"kSiB3X": ["Couldn't move to ", ["trashNoun"]],
+ "kUgGPO": ["Character budget per indexing request"],
"kV2YZv": [
"Don't see <0>Skills</0>? Enable <1>Settings <2/> Capabilities <3/> Code execution and file creation</1> first."
],
@@ -4467,6 +4482,7 @@
"q3W2nd": ["Couldn't add that comment: ", ["0"]],
"q4YJl_": ["The terminal session ended (exit code ", ["0"], ")."],
"q4efaG": [["filePath"], " is no longer in this skill"],
+ "q5uZbJ": ["Missing pages are indexed when you search. Search again for fuller results."],
"q6-JVU": ["Loading pages"],
"q63KUv": ["Add MCP & skill"],
"q7F5am": ["title"],
@@ -4922,6 +4938,9 @@
"uoJF_D": ["It was too hard to set up or get started"],
"ur2XSb": ["Visual editor"],
"uuoHOU": ["Command failed."],
+ "uwzRx4": [
+ "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+ ],
"uyJsf6": ["About"],
"uyOQ4e": ["Theme copied as base16 YAML"],
"uynXup": [["tokens", "plural", { "one": ["token"], "other": ["tokens"] }]],
@@ -5302,11 +5321,13 @@
"zbymaY": [["0"], "m ago"],
"zd00pH": ["Copy Path"],
"zgSFyG": ["External link"],
+ "zkkEFa": ["Enter a whole number between ", ["minimum"], " and ", ["maximum"], "."],
"zkz0Fg": ["Set up syncing"],
"zlErBl": ["Page headings error response did not match RFC 9457"],
"zo3Dl7": ["Toggle thumbnails"],
"zpfN9p": ["No comments yet. Select text in the document to add one."],
"zq2eBA": ["View in source"],
+ "zqQlBg": ["Maximum text chunks per indexing request"],
"zrP8HX": [
"Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{",
["date"],
diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.po
index 3436af6d1..996b2d1d3 100644
--- a/packages/app/src/locales/en/messages.po
+++ b/packages/app/src/locales/en/messages.po
@@ -1730,6 +1730,10 @@ msgstr "Adds these files"
msgid "Adds these folders"
msgstr "Adds these folders"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "Backlinks response did not match expected shape."
msgid "Base branch"
msgstr "Base branch"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "batch"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "becomes a symlink"
@@ -2637,6 +2646,15 @@ msgstr "Changes save automatically."
msgid "Changes saved automatically."
msgstr "Changes saved automatically."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "Character budget per indexing request"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "characters"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "Check for updates"
@@ -2836,6 +2854,10 @@ msgstr "Clear"
msgid "Clear {keyName}"
msgstr "Clear {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "Clear a field to restore its default value."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "Clear color"
@@ -5344,6 +5366,16 @@ msgstr "Embed an external page in an inline iframe (docs, demos, Figma, CodeSand
msgid "Embed an image with optional alt text."
msgstr "Embed an image with optional alt text."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "Embedding request settings"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "embeddings"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "Embeddings API key"
@@ -5510,6 +5542,10 @@ msgstr "Enter a folder name (e.g. brain)."
msgid "Enter a name for this theme."
msgstr "Enter a name for this theme."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "Enter a number of seconds between {minimum} and {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "Enter a port between 1 and 65535."
@@ -5542,6 +5578,10 @@ msgstr "Enter a valid URL (for example https://api.openai.com/v1)."
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "Enter a valid URL, for example https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "Enter a whole number between {minimum} and {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "Enter the public origin your tunnel serves, for example https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "Failed to update attachment location — {detail}"
msgid "Failed to update markdownlint rules"
msgstr "Failed to update markdownlint rules"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "Failed to update performance setting — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "How do you like OpenKnowledge?"
msgid "How does sharing work?"
msgstr "How does sharing work?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
@@ -7113,9 +7161,9 @@ msgstr "Index maintenance stayed off because the project setting could not be sa
msgid "Indexed {embedded} of {total} pages."
msgstr "Indexed {embedded} of {total} pages."
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "Indexing request timeout (seconds)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "Light"
msgid "Light, dark, or follow the OS."
msgstr "Light, dark, or follow the OS."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "line {displayLine}"
@@ -7989,6 +8041,10 @@ msgstr "Looking for <0>{lookingForUrl}</0>."
msgid "Lost connection to \"{docName}\"."
msgstr "Lost connection to \"{docName}\"."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "Maintain generated indexes in every folder?"
@@ -8099,6 +8155,10 @@ msgstr "Maximum {MAX_ATTACHMENTS} attachments"
msgid "Maximum agents already running"
msgstr "Maximum agents already running"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "Maximum text chunks per indexing request"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP auto-repair failed"
@@ -8186,6 +8246,10 @@ msgstr "Missing page — click to create"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "Missing page: {linkTitle}. Click to create."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "Missing pages are indexed when you search. Search again for fuller results."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "Missing palette colors"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "Pages are embedded the first time a search needs them."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "Pan down"
@@ -10210,6 +10278,11 @@ msgstr "pending"
msgid "Percolating…"
msgstr "Percolating…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "performance"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
@@ -11309,6 +11382,11 @@ msgstr "Repository not found — it may not exist, or the account used may not h
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "Repository not found. It may have been renamed, deleted, or moved."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "requests"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "required"
@@ -11662,6 +11740,7 @@ msgstr "Save this comment (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "Saved"
@@ -14329,6 +14408,11 @@ msgstr "Tidying up…"
msgid "Timeline"
msgstr "Timeline"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "timeout"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "Tint and badge files that have lint or link problems, without opening them."
diff --git a/packages/app/src/locales/es/messages.json b/packages/app/src/locales/es/messages.json
index 3286317ec..5fd9c6477 100644
--- a/packages/app/src/locales/es/messages.json
+++ b/packages/app/src/locales/es/messages.json
@@ -153,6 +153,7 @@
],
"0kTAXe": ["Abrir el origen: ", ["mirrorSrc"]],
"0m4Snh": ["Habilidades reasignadas"],
+ "0mlCvF": ["caracteres"],
"0niWj3": [
[
"removingCount",
@@ -431,6 +432,7 @@
"3zDeFb": ["Rumiando…"],
"3zyg_A": ["Patrones de exclusión"],
"4-Phgi": ["Mostrar u ocultar los agentes"],
+ "42QMZH": ["solicitudes"],
"438Fca": ["Se clonó correctamente, pero no se pudo abrir el proyecto."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -1011,6 +1013,9 @@
["name"],
"\": todavía no está entre las habilidades del proyecto."
],
+ "9wIf0H": [
+ "Redúcelo para disminuir el uso de memoria y el trabajo por solicitud. Los lotes más pequeños envían más solicitudes y pueden hacer que la indexación sea más lenta en conjunto."
+ ],
"9wQrUU": ["Refactorización"],
"9x-lMu": ["En este repositorio: los colaboradores reciben copias mediante git."],
"9xCnv8": ["Ocultar Terminal"],
@@ -1058,6 +1063,7 @@
"AUV-TY": ["Pensando"],
"AVW-K9": ["No se pudieron cargar las páginas huérfanas"],
"AWOSPo": ["Acercar"],
+ "AXMOeM": ["rendimiento"],
"AYoYhU": ["Falló la actualización: ", ["0"]],
"AaC-CE": ["Pizarra vacía"],
"AcK_r0": ["Claude CLI"],
@@ -1157,6 +1163,7 @@
"Bdha5y": ["Publicando..."],
"BeWTQy": ["Cargando paquetes iniciales"],
"BgV29F": ["Campo de búsqueda del editor visual enfocado"],
+ "Bgaa_U": ["No se pudo actualizar el ajuste de rendimiento — ", ["detail"]],
"BhLPRk": ["Se revirtió \"", ["name"], "\" a la versión instalada"],
"BjitBo": ["Descargar ", ["0"]],
"BkGtRl": [
@@ -1250,6 +1257,7 @@
"CbxTfe": ["Seleccionar bloque"],
"CcaU4i": ["Los cambios se aplican al instante y se guardan automáticamente en este tema."],
"ChMshD": ["Salir de ", ["appName"]],
+ "ChdabN": ["Borra el contenido de un campo para restaurar su valor predeterminado."],
"Ck9XRt": ["No se pudo guardar la clave; inténtalo de nuevo."],
"ClII5l": ["Pulsa el sol o la luna de “Custom” arriba para usar este tema."],
"ClTEde": [
@@ -1543,6 +1551,7 @@
"FgQ7XZ": ["No se pudieron cargar tus informes de error."],
"FgRAvd": ["Registros e información del sistema"],
"Fhp4Gn": ["Ver el complemento"],
+ "Fim5F3": ["embeddings"],
"FiyNln": ["Ir al texto seleccionado en la propiedad"],
"FjkaiT": ["Alejar"],
"Fjz6aJ": ["Enviar a un chat nuevo"],
@@ -2022,6 +2031,7 @@
"L4Cdd9": ["o crea un archivo nuevo <0/>"],
"L6Hhh6": ["(raíz)"],
"L6Ud-t": ["No se pudieron cargar los conflictos. Vuelve a cargar para reintentar."],
+ "L7NFTZ": ["Introduce un número de segundos entre ", ["minimum"], " y ", ["maximum"], "."],
"L83DKQ": ["Falló la instalación en PATH: ", ["summary"]],
"L8fKuc": ["Ejecuta esto en tu terminal"],
"L9Y9Om": ["Páginas más enlazadas"],
@@ -2530,6 +2540,7 @@
"QQbwzK": ["No hay agentes disponibles."],
"QQghPu": ["Instalar en Claude Desktop"],
"QR5SP1": ["plantilla creada"],
+ "QRSdsO": ["Tiempo de espera de la solicitud de indexación (segundos)"],
"QVk3SK": ["Este archivo se eliminó en la rama entrante (conflicto modify-delete)."],
"QWdKwH": ["Mover"],
"QYTOaN": ["Puedes cambiarlo más adelante en <0>Ajustes → Sincronización</0>."],
@@ -2603,6 +2614,7 @@
"RGCCrg": ["Copiar enlace para compartir"],
"RGkNeJ": ["Inicializar un paquete inicial"],
"RGptDW": ["OpenKnowledge movió un documento"],
+ "RH0e_f": ["tiempo de espera"],
"RJ3a8Z": ["Buscando <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"Del complemento ",
@@ -3167,6 +3179,9 @@
"XYZ7tp": ["Sin resolver"],
"XYlJJT": ["Configurando"],
"XZkdtg": ["Cambiar de rama"],
+ "Xafwko": [
+ "Limita el texto combinado que se envía en cada solicitud. Un fragmento mayor se envía por su cuenta; los documentos no se vuelven a dividir."
+ ],
"XcGbim": ["Mostrar los archivos ocultos"],
"Xet9MX": ["No se pudieron cargar los retroenlaces"],
"Xewl6B": [
@@ -3719,6 +3734,7 @@
],
"cSCbv3": ["BETA"],
"cT_pW4": ["Bloque de contenido plegable (alternador estilo Notion)."],
+ "cTrVa1": ["Ajustes de las solicitudes de embeddings"],
"cU-seF": ["Ir al código markdown del bloque donde está el cursor, centrado y resaltado."],
"cUK8lW": [
[
@@ -3946,6 +3962,13 @@
"eGUbmF": ["Copiar el archivo o la carpeta seleccionados"],
"eJitUk": ["Subir desde el equipo"],
"eKThTQ": ["No se pudo reordenar"],
+ "eMWRAs": [
+ "Páginas indexadas: ",
+ ["semanticIndexedCount"],
+ " de ",
+ ["semanticTotalCount"],
+ "."
+ ],
"eNOyTV": [
"No tienes permiso para hacer push en este repositorio. Automático (solo Pull) puede mantener tu copia al día."
],
@@ -4256,6 +4279,9 @@
"gyHDWC": ["Arreglarlo todo con IA (", ["count"], ")"],
"gyYvCN": ["Enviar mis ediciones cada"],
"h-AdvS": ["Las carpetas y las plantillas ya están aquí, así que no hay nada que añadir."],
+ "h-RPqa": [
+ "Cuánto tiempo espera OpenKnowledge cada solicitud de embeddings durante la indexación. Las solicitudes de búsqueda tienen un tiempo de espera fijo de 8 segundos por intento, que no cambia con este ajuste."
+ ],
"h06R3C": ["No hay páginas sin enlaces salientes en el grafo."],
"h16FyT": ["Listas"],
"h2N-1n": ["Instalado en ", ["0"]],
@@ -4513,6 +4539,7 @@
],
"jTUxaN": ["Activar Automático (solo Pull)"],
"jTdrn1": ["No se pudo comprobar si ", ["filePath"], " sigue en conflicto: reintentando."],
+ "jWwQo6": ["lote"],
"jWzDfC": ["Comprobando qué herramientas de IA tienes"],
"jZ_E5M": ["Falló el fetch: consulta los registros del servidor para ver los detalles."],
"j_Z6g7": ["Valor compartido por defecto"],
@@ -4570,13 +4597,6 @@
"</0>: la mayoría de servidores locales la ignoran. Añádela solo si el tuyo la necesita."
],
"kBNHN1": ["Historial de navegación"],
- "kCNU4q": [
- "Indexando tus páginas: ",
- ["semanticIndexedCount"],
- " de ",
- ["semanticTotalCount"],
- " listas. Los resultados pueden estar incompletos."
- ],
"kCjkGY": ["Esto puede tardar un momento. Tu contenido markdown se conserva."],
"kCqCyf": ["Abre el panel de diagnóstico de análisis de CodeMirror."],
"kEiVv6": [
@@ -4609,6 +4629,7 @@
"Apunta la búsqueda semántica a cualquier endpoint de embeddings compatible con OpenAI: un servidor propio u otro proveedor. La clave de API de arriba vale para el endpoint que definas aquí."
],
"kSiB3X": ["No se pudo mover a la ", ["trashNoun"]],
+ "kUgGPO": ["Presupuesto de caracteres por solicitud de indexación"],
"kV2YZv": [
"¿No ves <0>Habilidades</0>? Activa antes <1>Ajustes <2/> Capacidades <3/> Ejecución de código y creación de archivos</1>."
],
@@ -5148,6 +5169,9 @@
"q3W2nd": ["No se pudo añadir ese comentario: ", ["0"]],
"q4YJl_": ["La sesión de terminal terminó (código de salida ", ["0"], ")."],
"q4efaG": [["filePath"], " ya no está en esta skill"],
+ "q5uZbJ": [
+ "Las páginas pendientes se indexan al buscar. Vuelve a buscar para obtener resultados más completos."
+ ],
"q6-JVU": ["Cargando páginas"],
"q63KUv": ["Añadir MCP y habilidad"],
"q7F5am": ["título"],
@@ -5652,6 +5676,9 @@
"uoJF_D": ["Era demasiado difícil de configurar o de empezar a usar"],
"ur2XSb": ["Editor visual"],
"uuoHOU": ["El comando falló."],
+ "uwzRx4": [
+ "Ajusta el tamaño y el tiempo de espera de las solicitudes de indexación para servidores de embeddings lentos o con poca memoria. La mayoría de las configuraciones deberían mantener los valores predeterminados."
+ ],
"uyJsf6": ["Acerca de"],
"uyOQ4e": ["Tema copiado como YAML base16"],
"uynXup": [["tokens", "plural", { "one": ["token"], "many": ["tokens"], "other": ["tokens"] }]],
@@ -6118,11 +6145,13 @@
"zbymaY": ["hace ", ["0"], " min"],
"zd00pH": ["Copiar ruta"],
"zgSFyG": ["Enlace externo"],
+ "zkkEFa": ["Introduce un número entero entre ", ["minimum"], " y ", ["maximum"], "."],
"zkz0Fg": ["Configurar la sincronización"],
"zlErBl": ["La respuesta de error de los encabezados de página no cumple RFC 9457"],
"zo3Dl7": ["Mostrar u ocultar las miniaturas"],
"zpfN9p": ["Todavía no hay comentarios. Selecciona texto en el documento para añadir uno."],
"zq2eBA": ["Ver en el código"],
+ "zqQlBg": ["Máximo de fragmentos de texto por solicitud de indexación"],
"zrP8HX": [
"El frontmatter con el que empieza cada documento creado a partir de esta plantilla. Los valores son YAML: una lista es <0>[a, b]</0>; <1>{",
["date"],
diff --git a/packages/app/src/locales/es/messages.po b/packages/app/src/locales/es/messages.po
index 60cf06035..bcbe1766f 100644
--- a/packages/app/src/locales/es/messages.po
+++ b/packages/app/src/locales/es/messages.po
@@ -1730,6 +1730,10 @@ msgstr "Añade estos archivos"
msgid "Adds these folders"
msgstr "Añade estas carpetas"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "Ajusta el tamaño y el tiempo de espera de las solicitudes de indexación para servidores de embeddings lentos o con poca memoria. La mayoría de las configuraciones deberían mantener los valores predeterminados."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "La respuesta de retroenlaces no tenía la forma esperada."
msgid "Base branch"
msgstr "Rama base"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "lote"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "pasa a ser un enlace simbólico"
@@ -2637,6 +2646,15 @@ msgstr "Los cambios se guardan automáticamente."
msgid "Changes saved automatically."
msgstr "Los cambios se guardaron automáticamente."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "Presupuesto de caracteres por solicitud de indexación"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "caracteres"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "Buscar actualizaciones"
@@ -2836,6 +2854,10 @@ msgstr "Borrar"
msgid "Clear {keyName}"
msgstr "Borrar {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "Borra el contenido de un campo para restaurar su valor predeterminado."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "Quitar color"
@@ -5344,6 +5366,16 @@ msgstr "Incrusta una página externa en un iframe en línea (documentación, dem
msgid "Embed an image with optional alt text."
msgstr "Incrusta una imagen con texto alternativo opcional."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "Ajustes de las solicitudes de embeddings"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "embeddings"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "Clave de API de embeddings"
@@ -5510,6 +5542,10 @@ msgstr "Escribe un nombre de carpeta (p. ej. cerebro)."
msgid "Enter a name for this theme."
msgstr "Introduce un nombre para este tema."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "Introduce un número de segundos entre {minimum} y {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "Introduce un puerto entre 1 y 65535."
@@ -5542,6 +5578,10 @@ msgstr "Escribe una URL válida (por ejemplo https://api.openai.com/v1)."
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "Introduce una URL válida, por ejemplo https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "Introduce un número entero entre {minimum} y {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "Introduce el origen público que sirve tu túnel, por ejemplo https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "No se pudo actualizar la ubicación de los adjuntos — {detail}"
msgid "Failed to update markdownlint rules"
msgstr "No se pudieron actualizar las reglas de markdownlint"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "No se pudo actualizar el ajuste de rendimiento — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "¿Qué te parece OpenKnowledge?"
msgid "How does sharing work?"
msgstr "¿Cómo funciona compartir?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "Cuánto tiempo espera OpenKnowledge cada solicitud de embeddings durante la indexación. Las solicitudes de búsqueda tienen un tiempo de espera fijo de 8 segundos por intento, que no cambia con este ajuste."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "Cómo se notifican los documentos, archivos e imágenes locales del proyecto que faltan en Problemas, los diagnósticos del editor, las auditorías y las herramientas de agentes."
@@ -7113,9 +7161,9 @@ msgstr "El mantenimiento del índice permaneció desactivado porque no se pudo g
msgid "Indexed {embedded} of {total} pages."
msgstr "Se indexaron {embedded} de {total} páginas."
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "Indexando tus páginas: {semanticIndexedCount} de {semanticTotalCount} listas. Los resultados pueden estar incompletos."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "Tiempo de espera de la solicitud de indexación (segundos)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "Claro"
msgid "Light, dark, or follow the OS."
msgstr "Claro, oscuro o seguir al sistema."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "Limita el texto combinado que se envía en cada solicitud. Un fragmento mayor se envía por su cuenta; los documentos no se vuelven a dividir."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "línea {displayLine}"
@@ -7989,6 +8041,10 @@ msgstr "Buscando <0>{lookingForUrl}</0>."
msgid "Lost connection to \"{docName}\"."
msgstr "Se perdió la conexión con \"{docName}\"."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "Redúcelo para disminuir el uso de memoria y el trabajo por solicitud. Los lotes más pequeños envían más solicitudes y pueden hacer que la indexación sea más lenta en conjunto."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "¿Mantener índices generados en cada carpeta?"
@@ -8099,6 +8155,10 @@ msgstr "Máximo {MAX_ATTACHMENTS} adjuntos"
msgid "Maximum agents already running"
msgstr "Ya hay el máximo de agentes en marcha"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "Máximo de fragmentos de texto por solicitud de indexación"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "Falló la reparación automática de MCP"
@@ -8186,6 +8246,10 @@ msgstr "Página inexistente: haz clic para crearla"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "Página inexistente: {linkTitle}. Haz clic para crearla."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "Las páginas pendientes se indexan al buscar. Vuelve a buscar para obtener resultados más completos."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "Faltan colores de la paleta"
@@ -10066,6 +10130,10 @@ msgstr "nombre-de-pagina"
msgid "Pages are embedded the first time a search needs them."
msgstr "Las páginas se convierten en embeddings la primera vez que una búsqueda las necesita."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "Páginas indexadas: {semanticIndexedCount} de {semanticTotalCount}."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "Desplazar hacia abajo"
@@ -10210,6 +10278,11 @@ msgstr "pendiente"
msgid "Percolating…"
msgstr "Macerando…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "rendimiento"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "Elimina definitivamente <0>{targetGitPath}</0> y todo su historial de git. Los archivos de trabajo se quedan donde están. Si el repositorio de git superior es intencionado (p. ej. lo clonaste tú), cancela y elige una ubicación fuera de él."
@@ -11309,6 +11382,11 @@ msgstr "No se encontró el repositorio: puede que no exista o que la cuenta util
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "No se encontró el repositorio. Puede que lo hayan renombrado, eliminado o movido."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "solicitudes"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "obligatorio"
@@ -11662,6 +11740,7 @@ msgstr "Guardar este comentario (Intro)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "Guardado"
@@ -14329,6 +14408,11 @@ msgstr "Ordenando…"
msgid "Timeline"
msgstr "Cronología"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "tiempo de espera"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "Tiñe y marca los archivos con problemas de análisis o de enlaces, sin abrirlos."
diff --git a/packages/app/src/locales/fr/messages.json b/packages/app/src/locales/fr/messages.json
index d532d8ec1..57cab2333 100644
--- a/packages/app/src/locales/fr/messages.json
+++ b/packages/app/src/locales/fr/messages.json
@@ -155,6 +155,7 @@
],
"0kTAXe": ["Source : ", ["mirrorSrc"]],
"0m4Snh": ["Compétences réaffectées"],
+ "0mlCvF": ["caractères"],
"0niWj3": [
[
"removingCount",
@@ -445,6 +446,7 @@
"3zDeFb": ["Rumination…"],
"3zyg_A": ["Motifs d'exclusion"],
"4-Phgi": ["Afficher ou masquer les agents"],
+ "42QMZH": ["requêtes"],
"438Fca": ["Clonage réussi, mais le projet n'a pas pu être ouvert."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -1038,6 +1040,9 @@
["name"],
" » — elle ne fait pas encore partie des compétences du projet."
],
+ "9wIf0H": [
+ "Réduisez cette valeur pour diminuer l'utilisation de la mémoire et le travail par requête. Des lots plus petits envoient plus de requêtes et peuvent ralentir l'indexation globale."
+ ],
"9wQrUU": ["Refactorisation"],
"9x-lMu": ["Dans ce dépôt — les collaborateurs reçoivent les copies via git."],
"9xCnv8": ["Masquer Terminal"],
@@ -1085,6 +1090,7 @@
"AUV-TY": ["Réflexion"],
"AVW-K9": ["Échec du chargement des pages orphelines"],
"AWOSPo": ["Zoom avant"],
+ "AXMOeM": ["performances"],
"AYoYhU": ["Échec de la mise à jour : ", ["0"]],
"AaC-CE": ["Tableau vide"],
"AcK_r0": ["CLI Claude"],
@@ -1184,6 +1190,7 @@
"Bdha5y": ["Publication…"],
"BeWTQy": ["Chargement des packs de démarrage"],
"BgV29F": ["Champ de recherche de l'éditeur visuel actif"],
+ "Bgaa_U": ["Échec de la mise à jour du paramètre de performance — ", ["detail"]],
"BhLPRk": ["« ", ["name"], " » ramené à la version installée"],
"BjitBo": ["Télécharger ", ["0"]],
"BkGtRl": [
@@ -1277,6 +1284,7 @@
"Les modifications s’appliquent immédiatement et sont automatiquement enregistrées dans ce thème."
],
"ChMshD": ["Quitter ", ["appName"]],
+ "ChdabN": ["Videz un champ pour rétablir sa valeur par défaut."],
"Ck9XRt": ["Impossible d'enregistrer la clé — veuillez réessayer."],
"ClII5l": ["Appuyez sur le soleil ou la lune de « Custom » ci-dessus pour utiliser ce thème."],
"ClTEde": [
@@ -1575,6 +1583,7 @@
"FgQ7XZ": ["Impossible de charger vos rapports de bug."],
"FgRAvd": ["Journaux et informations système"],
"Fhp4Gn": ["Voir le plugin"],
+ "Fim5F3": ["embeddings"],
"FiyNln": ["Aller au texte sélectionné dans la propriété"],
"FjkaiT": ["Zoom arrière"],
"Fjz6aJ": ["Envoyer dans un nouveau chat"],
@@ -2061,6 +2070,13 @@
"L4Cdd9": ["ou créez un nouveau fichier <0/>"],
"L6Hhh6": ["(racine)"],
"L6Ud-t": ["Impossible de charger les conflits. Rechargez pour réessayer."],
+ "L7NFTZ": [
+ "Saisissez un nombre de secondes compris entre ",
+ ["minimum"],
+ " et ",
+ ["maximum"],
+ "."
+ ],
"L83DKQ": ["L'installation dans PATH a échoué : ", ["summary"]],
"L8fKuc": ["Exécutez ceci dans votre terminal"],
"L9Y9Om": ["Pages les plus liées"],
@@ -2563,6 +2579,7 @@
"QQbwzK": ["Aucun agent disponible."],
"QQghPu": ["Installer dans Claude Desktop"],
"QR5SP1": ["modèle créé"],
+ "QRSdsO": ["Délai d'attente de la requête d'indexation (secondes)"],
"QVk3SK": ["Ce fichier a été supprimé sur la branche entrante (conflit modify-delete)."],
"QWdKwH": ["Déplacer"],
"QYTOaN": ["Vous pourrez changer cela plus tard dans <0>Paramètres → Synchronisation</0>."],
@@ -2640,6 +2657,7 @@
"RGCCrg": ["Copier le lien de partage"],
"RGkNeJ": ["Initialiser un pack de démarrage"],
"RGptDW": ["OpenKnowledge a déplacé un document"],
+ "RH0e_f": ["délai d’attente"],
"RJ3a8Z": ["Recherche de <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"Du plugin ",
@@ -3209,6 +3227,9 @@
"XYZ7tp": ["Non résolu"],
"XYlJJT": ["Configuration en cours"],
"XZkdtg": ["Changer de branche"],
+ "Xafwko": [
+ "Limite le texte cumulé envoyé dans chaque requête. Un fragment plus volumineux est envoyé seul ; les documents ne sont pas redécoupés."
+ ],
"XcGbim": ["Afficher les fichiers masqués"],
"Xet9MX": ["Échec du chargement des rétroliens"],
"Xewl6B": [
@@ -3757,6 +3778,7 @@
],
"cSCbv3": ["BÊTA"],
"cT_pW4": ["Bloc de contenu repliable (bascule de type Notion)."],
+ "cTrVa1": ["Paramètres des requêtes d'embeddings"],
"cU-seF": ["Va à la source markdown du bloc situé au curseur, centrée et mise en évidence."],
"cUK8lW": [
[
@@ -3987,6 +4009,7 @@
"eGUbmF": ["Copier le fichier ou dossier sélectionné"],
"eJitUk": ["Envoyer depuis l'ordinateur"],
"eKThTQ": ["Échec de la réorganisation"],
+ "eMWRAs": ["Pages indexées : ", ["semanticIndexedCount"], " sur ", ["semanticTotalCount"], "."],
"eNOyTV": [
"Vous n'avez pas la permission de pousser vers ce dépôt. Auto (Tirer seulement) peut quand même garder votre copie à jour."
],
@@ -4293,6 +4316,9 @@
"gyHDWC": ["Tout corriger avec l'IA (", ["count"], ")"],
"gyYvCN": ["Envoyer mes modifications toutes les"],
"h-AdvS": ["Les dossiers et les modèles sont déjà là, il n'y a donc rien à ajouter."],
+ "h-RPqa": [
+ "Durée pendant laquelle OpenKnowledge attend chaque requête d’embedding lors de l’indexation. Les requêtes de recherche ont un délai fixe de 8 secondes par tentative, que ce réglage ne modifie pas."
+ ],
"h06R3C": ["Aucune page ne manque de liens sortants dans le graphe."],
"h16FyT": ["Listes"],
"h2N-1n": ["Installé dans ", ["0"]],
@@ -4556,6 +4582,7 @@
["filePath"],
" est toujours en conflit — nouvelle tentative."
],
+ "jWwQo6": ["lot"],
"jWzDfC": ["Vérification des outils IA dont vous disposez"],
"jZ_E5M": ["Échec de la récupération — consultez les journaux du serveur pour les détails."],
"j_Z6g7": ["Valeur par défaut partagée"],
@@ -4613,13 +4640,6 @@
"</0> — la plupart des serveurs locaux l'ignorent. N'en ajoutez une que si le vôtre l'exige."
],
"kBNHN1": ["Historique de navigation"],
- "kCNU4q": [
- "Indexation de vos pages — ",
- ["semanticIndexedCount"],
- " prêtes sur ",
- ["semanticTotalCount"],
- ". Les résultats peuvent être incomplets."
- ],
"kCjkGY": ["Cela peut prendre un moment. Votre contenu markdown est conservé."],
"kCqCyf": ["Ouvre le panneau de diagnostics de vérification de CodeMirror."],
"kEiVv6": [
@@ -4654,6 +4674,7 @@
"Dirigez la recherche sémantique vers n'importe quel point de terminaison d'embeddings compatible OpenAI — un serveur auto-hébergé ou un autre fournisseur. La clé API ci-dessus vaut pour le point de terminaison que vous définissez ici."
],
"kSiB3X": ["Impossible de mettre à la ", ["trashNoun"]],
+ "kUgGPO": ["Budget de caractères par requête d'indexation"],
"kV2YZv": [
"Vous ne voyez pas <0>Compétences</0> ? Activez d'abord <1>Paramètres <2/> Fonctionnalités <3/> Exécution de code et création de fichiers</1>."
],
@@ -5211,6 +5232,9 @@
"q3W2nd": ["Impossible d'ajouter ce commentaire : ", ["0"]],
"q4YJl_": ["La session de terminal s'est terminée (code de sortie ", ["0"], ")."],
"q4efaG": [["filePath"], " ne fait plus partie de cette compétence"],
+ "q5uZbJ": [
+ "Les pages restantes sont indexées lors des recherches. Relancez la recherche pour obtenir des résultats plus complets."
+ ],
"q6-JVU": ["Chargement des pages"],
"q63KUv": ["Ajouter MCP et la compétence"],
"q7F5am": ["titre"],
@@ -5722,6 +5746,9 @@
"uoJF_D": ["C'était trop compliqué à installer ou à prendre en main"],
"ur2XSb": ["Éditeur visuel"],
"uuoHOU": ["La commande a échoué."],
+ "uwzRx4": [
+ "Ajustez la taille et le délai d'attente des requêtes d'indexation pour les serveurs d'embeddings lents ou limités en mémoire. La plupart des configurations devraient conserver les valeurs par défaut."
+ ],
"uyJsf6": ["À propos"],
"uyOQ4e": ["Thème copié au format YAML base16"],
"uynXup": [["tokens", "plural", { "one": ["token"], "many": ["tokens"], "other": ["tokens"] }]],
@@ -6198,6 +6225,7 @@
"zbymaY": ["il y a ", ["0"], " min"],
"zd00pH": ["Copier le chemin"],
"zgSFyG": ["Lien externe"],
+ "zkkEFa": ["Saisissez un nombre entier compris entre ", ["minimum"], " et ", ["maximum"], "."],
"zkz0Fg": ["Configurer la synchronisation"],
"zlErBl": ["La réponse d'erreur des titres de page ne respecte pas la RFC 9457"],
"zo3Dl7": ["Basculer les miniatures"],
@@ -6205,6 +6233,7 @@
"Pas encore de commentaires. Sélectionnez du texte dans le document pour en ajouter un."
],
"zq2eBA": ["Voir dans la source"],
+ "zqQlBg": ["Nombre maximal de fragments de texte par requête d'indexation"],
"zrP8HX": [
"Le frontmatter par lequel commence chaque document créé à partir de ce modèle. Les valeurs sont en YAML — une liste s'écrit <0>[a, b]</0> ; <1>{",
["date"],
diff --git a/packages/app/src/locales/fr/messages.po b/packages/app/src/locales/fr/messages.po
index 773644cca..5c3865a03 100644
--- a/packages/app/src/locales/fr/messages.po
+++ b/packages/app/src/locales/fr/messages.po
@@ -1730,6 +1730,10 @@ msgstr "Ajoute ces fichiers"
msgid "Adds these folders"
msgstr "Ajoute ces dossiers"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "Ajustez la taille et le délai d'attente des requêtes d'indexation pour les serveurs d'embeddings lents ou limités en mémoire. La plupart des configurations devraient conserver les valeurs par défaut."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "La réponse des rétroliens ne correspond pas à la forme attendue."
msgid "Base branch"
msgstr "Branche de base"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "lot"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "devient un lien symbolique"
@@ -2637,6 +2646,15 @@ msgstr "Les modifications sont enregistrées automatiquement."
msgid "Changes saved automatically."
msgstr "Modifications enregistrées automatiquement."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "Budget de caractères par requête d'indexation"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "caractères"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "Rechercher les mises à jour"
@@ -2836,6 +2854,10 @@ msgstr "Effacer"
msgid "Clear {keyName}"
msgstr "Effacer {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "Videz un champ pour rétablir sa valeur par défaut."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "Effacer la couleur"
@@ -5344,6 +5366,16 @@ msgstr "Intègre une page externe dans une iframe en ligne (docs, démos, Figma,
msgid "Embed an image with optional alt text."
msgstr "Intègre une image avec un texte alternatif facultatif."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "Paramètres des requêtes d'embeddings"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "embeddings"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "Clé API des embeddings"
@@ -5510,6 +5542,10 @@ msgstr "Saisissez un nom de dossier (par ex. brain)."
msgid "Enter a name for this theme."
msgstr "Saisissez un nom pour ce thème."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "Saisissez un nombre de secondes compris entre {minimum} et {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "Saisissez un port entre 1 et 65535."
@@ -5542,6 +5578,10 @@ msgstr "Saisissez une URL valide (par exemple https://api.openai.com/v1)."
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "Saisissez une URL valide, par exemple https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "Saisissez un nombre entier compris entre {minimum} et {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "Saisissez l'origine publique servie par votre tunnel, par exemple https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "Échec de la mise à jour de l'emplacement des pièces jointes — {deta
msgid "Failed to update markdownlint rules"
msgstr "Échec de la mise à jour des règles markdownlint"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "Échec de la mise à jour du paramètre de performance — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "Que pensez-vous d'OpenKnowledge ?"
msgid "How does sharing work?"
msgstr "Comment fonctionne le partage ?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "Durée pendant laquelle OpenKnowledge attend chaque requête d’embedding lors de l’indexation. Les requêtes de recherche ont un délai fixe de 8 secondes par tentative, que ce réglage ne modifie pas."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "Comment les documents, fichiers et images locaux au projet manquants sont signalés dans Problèmes, les diagnostics de l’éditeur, les audits et les outils d’agent."
@@ -7113,9 +7161,9 @@ msgstr "La maintenance de l'index est restée désactivée car les paramètres d
msgid "Indexed {embedded} of {total} pages."
msgstr "{embedded} pages indexées sur {total}."
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "Indexation de vos pages — {semanticIndexedCount} prêtes sur {semanticTotalCount}. Les résultats peuvent être incomplets."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "Délai d'attente de la requête d'indexation (secondes)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "Clair"
msgid "Light, dark, or follow the OS."
msgstr "Clair, sombre, ou suivre le système."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "Limite le texte cumulé envoyé dans chaque requête. Un fragment plus volumineux est envoyé seul ; les documents ne sont pas redécoupés."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "ligne {displayLine}"
@@ -7989,6 +8041,10 @@ msgstr "Recherche de <0>{lookingForUrl}</0>."
msgid "Lost connection to \"{docName}\"."
msgstr "Connexion perdue avec « {docName} »."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "Réduisez cette valeur pour diminuer l'utilisation de la mémoire et le travail par requête. Des lots plus petits envoient plus de requêtes et peuvent ralentir l'indexation globale."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "Conserver les index generated dans chaque dossier ?"
@@ -8099,6 +8155,10 @@ msgstr "{MAX_ATTACHMENTS} pièces jointes maximum"
msgid "Maximum agents already running"
msgstr "Nombre maximal d'agents déjà en cours d'exécution"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "Nombre maximal de fragments de texte par requête d'indexation"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "La réparation automatique de MCP a échoué"
@@ -8186,6 +8246,10 @@ msgstr "Page manquante — cliquez pour la créer"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "Page manquante : {linkTitle}. Cliquez pour la créer."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "Les pages restantes sont indexées lors des recherches. Relancez la recherche pour obtenir des résultats plus complets."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "Des couleurs de la palette sont manquantes"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "Les pages reçoivent leur embedding la première fois qu'une recherche en a besoin."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "Pages indexées : {semanticIndexedCount} sur {semanticTotalCount}."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "Faire défiler vers le bas"
@@ -10210,6 +10278,11 @@ msgstr "en attente"
msgid "Percolating…"
msgstr "Macération…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "performances"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "Supprime définitivement <0>{targetGitPath}</0> et tout son historique git. Les fichiers de travail restent en place. Si le dépôt git parent est intentionnel (par ex. vous l'avez cloné), annulez et choisissez un emplacement en dehors."
@@ -11309,6 +11382,11 @@ msgstr "Dépôt introuvable — il n'existe peut-être pas, ou le compte utilis
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "Dépôt introuvable. Il a peut-être été renommé, supprimé ou déplacé."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "requêtes"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "obligatoire"
@@ -11662,6 +11740,7 @@ msgstr "Enregistrer ce commentaire (Entrée)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "Enregistré"
@@ -14329,6 +14408,11 @@ msgstr "Rangement…"
msgid "Timeline"
msgstr "Chronologie"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "délai d’attente"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "Colore et marque les fichiers qui ont des problèmes de vérification ou de liens, sans les ouvrir."
diff --git a/packages/app/src/locales/hi/messages.json b/packages/app/src/locales/hi/messages.json
index d078c88fe..cc71d52a0 100644
--- a/packages/app/src/locales/hi/messages.json
+++ b/packages/app/src/locales/hi/messages.json
@@ -127,6 +127,7 @@
"0jD-Gn": ["एक टीम ज्ञान आधार, एक निजी विकी, प्रोजेक्ट दस्तावेज़…"],
"0kTAXe": ["स्रोत खोलें: ", ["mirrorSrc"]],
"0m4Snh": ["स्किल फिर से असाइन किए गए"],
+ "0mlCvF": ["अक्षर"],
"0niWj3": [
["removingCount", "plural", { "one": ["#", " हटाया गया"], "other": ["#", " हटाए गए"] }]
],
@@ -360,6 +361,7 @@
"3zDeFb": ["मनन किया जा रहा है…"],
"3zyg_A": ["अनदेखा करने के पैटर्न"],
"4-Phgi": ["एजेंट दिखाएँ या छिपाएँ"],
+ "42QMZH": ["अनुरोध"],
"438Fca": ["क्लोन सफल रहा, पर प्रोजेक्ट नहीं खोला जा सका।"],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -832,6 +834,9 @@
"9tJX8r": ["अर्थ के अनुसार"],
"9uI_rE": ["पूर्ववत करें"],
"9uRLEH": ["\"", ["name"], "\" नहीं खोली जा सकी — यह अभी प्रोजेक्ट की स्किल में नहीं है।"],
+ "9wIf0H": [
+ "प्रति अनुरोध मेमोरी उपयोग और काम घटाने के लिए इसे कम करें। छोटे बैच अधिक अनुरोध भेजते हैं और कुल मिलाकर इंडेक्सिंग धीमी कर सकते हैं।"
+ ],
"9wQrUU": ["पुनर्संरचना"],
"9x-lMu": ["इस रिपॉज़िटरी में — सहयोगियों को git के ज़रिए कॉपी मिलती हैं।"],
"9xCnv8": ["Terminal छिपाएँ"],
@@ -873,6 +878,7 @@
"AUV-TY": ["सोच रहा है"],
"AVW-K9": ["अनाथ पेज लोड करने में विफल"],
"AWOSPo": ["बड़ा करें"],
+ "AXMOeM": ["प्रदर्शन"],
"AYoYhU": ["अपडेट विफल: ", ["0"]],
"AaC-CE": ["खाली बोर्ड"],
"AcK_r0": ["Claude CLI"],
@@ -954,6 +960,7 @@
"Bdha5y": ["प्रकाशित किया जा रहा है…"],
"BeWTQy": ["स्टार्टर पैक लोड हो रहे हैं"],
"BgV29F": ["दृश्य संपादक का खोज इनपुट फ़ोकस में"],
+ "Bgaa_U": ["प्रदर्शन सेटिंग अपडेट करने में विफल — ", ["detail"]],
"BhLPRk": ["\"", ["name"], "\" को इंस्टॉल किए गए संस्करण पर वापस ले लिया गया"],
"BjitBo": [["0"], " डाउनलोड करें"],
"BkGtRl": [
@@ -1027,6 +1034,7 @@
"CbxTfe": ["ब्लॉक चुनें"],
"CcaU4i": ["संपादन तुरंत लागू होते हैं और इस थीम में अपने आप सहेजे जाते हैं।"],
"ChMshD": [["appName"], " से बाहर निकलें"],
+ "ChdabN": ["किसी फ़ील्ड का डिफ़ॉल्ट मान बहाल करने के लिए उसे खाली करें।"],
"Ck9XRt": ["कुंजी नहीं सहेजी जा सकी — कृपया फिर कोशिश करें।"],
"ClII5l": ["इस थीम का उपयोग करने के लिए ऊपर “कस्टम” पर सूरज या चाँद दबाएँ।"],
"ClTEde": ["चयनित अंश को एजेंट पैनल में तैयार रखें, जोड़कर भेजने के लिए तैयार।"],
@@ -1296,6 +1304,7 @@
"FgQ7XZ": ["आपकी बग रिपोर्ट लोड नहीं हो सकीं।"],
"FgRAvd": ["लॉग और सिस्टम जानकारी"],
"Fhp4Gn": ["प्लगइन देखें"],
+ "Fim5F3": ["एम्बेडिंग"],
"FiyNln": ["प्रॉपर्टी में चयनित पाठ पर जाएँ"],
"FjkaiT": ["छोटा करें"],
"Fjz6aJ": ["नई चैट में भेजें"],
@@ -1686,6 +1695,7 @@
"L4Cdd9": ["या एक नई फ़ाइल बनाएँ <0/>"],
"L6Hhh6": ["(रूट)"],
"L6Ud-t": ["विरोध लोड नहीं हो सके। दोबारा कोशिश करने के लिए फिर से लोड करें।"],
+ "L7NFTZ": [["minimum"], " और ", ["maximum"], " के बीच सेकंड की संख्या दर्ज करें।"],
"L83DKQ": ["PATH इंस्टॉल विफल रहा: ", ["summary"]],
"L8fKuc": ["इसे अपने टर्मिनल में चलाएँ"],
"L9Y9Om": ["सबसे ज़्यादा लिंक किए गए पेज"],
@@ -2127,6 +2137,7 @@
"QQbwzK": ["कोई एजेंट उपलब्ध नहीं।"],
"QQghPu": ["Claude Desktop में इंस्टॉल करें"],
"QR5SP1": ["टेम्पलेट बनाया गया"],
+ "QRSdsO": ["इंडेक्सिंग अनुरोध टाइमआउट (सेकंड)"],
"QVk3SK": ["यह फ़ाइल आने वाली ब्रांच पर हटा दी गई थी (modify-delete विरोध)।"],
"QWdKwH": ["हिलाएँ"],
"QYTOaN": ["आप इसे बाद में <0>Settings → Sync</0> में बदल सकते हैं।"],
@@ -2196,6 +2207,7 @@
"RGCCrg": ["साझा लिंक कॉपी करें"],
"RGkNeJ": ["एक स्टार्टर पैक आरंभ करें"],
"RGptDW": ["OpenKnowledge ने एक दस्तावेज़ ले जाया"],
+ "RH0e_f": ["समय सीमा"],
"RJ3a8Z": ["<0>", ["lookingForUrl"], "</0> खोजा जा रहा है।"],
"RJMO4B": [["residentPlugin"], " प्लगइन से — केवल पढ़ने योग्य; प्लगइन अपडेट इन फ़ाइलों को बदल देते हैं।"],
"RLNIgv": ["सर्वर ने अधूरी टेम्पलेट प्रतिक्रिया लौटाई।"],
@@ -2642,6 +2654,9 @@
"XYZ7tp": ["अनसुलझा"],
"XYlJJT": ["सेट अप किया जा रहा है"],
"XZkdtg": ["ब्रांच बदलें"],
+ "Xafwko": [
+ "हर अनुरोध में भेजे जाने वाले कुल टेक्स्ट को सीमित करता है। बड़ा एकल खंड अकेले भेजा जाता है; दस्तावेज़ दोबारा विभाजित नहीं होते।"
+ ],
"XcGbim": ["छिपी हुई फ़ाइलें दिखाएँ"],
"Xet9MX": ["बैकलिंक लोड करने में विफल"],
"Xewl6B": ["आपकी स्थानीय प्रति पीछे है। नवीनतम बदलाव खींचें, फिर लिंक दोबारा खोलें।"],
@@ -3108,6 +3123,7 @@
"cRm498": ["इस प्रोजेक्ट में अभी कोई स्कीमा फ़ाइल नहीं — सत्यापन शुरू करने के लिए एक बनाएँ।"],
"cSCbv3": ["बीटा"],
"cT_pW4": ["संक्षिप्त किया जा सकने वाला सामग्री ब्लॉक (Notion-शैली टॉगल)।"],
+ "cTrVa1": ["एम्बेडिंग अनुरोध सेटिंग्स"],
"cU-seF": ["कर्सर वाले ब्लॉक के markdown स्रोत पर जाएँ, बीच में और उभारा हुआ।"],
"cUK8lW": [["conflictCount", "plural", { "one": ["#", " टकराव"], "other": ["#", " टकराव"] }]],
"cUagXn": [["gitignorePath"], " में जोड़ें"],
@@ -3276,6 +3292,7 @@
"eGUbmF": ["चयनित फ़ाइल या फ़ोल्डर कॉपी करें"],
"eJitUk": ["कंप्यूटर से अपलोड करें"],
"eKThTQ": ["क्रम बदलने में विफल"],
+ "eMWRAs": ["इंडेक्स किए गए पेज: ", ["semanticTotalCount"], " में से ", ["semanticIndexedCount"], "।"],
"eNOyTV": [
"आपके पास इस रिपॉज़िटरी में पुश करने की अनुमति नहीं है। स्वचालित (केवल खींचें) फिर भी आपकी कॉपी अद्यतित रख सकता है।"
],
@@ -3533,6 +3550,9 @@
"gyHDWC": ["AI से सब ठीक करें (", ["count"], ")"],
"gyYvCN": ["मेरे संपादन भेजने की आवृत्ति"],
"h-AdvS": ["फ़ोल्डर और टेम्पलेट पहले से यहीं हैं, इसलिए जोड़ने को कुछ नहीं है।"],
+ "h-RPqa": [
+ "इंडेक्स बनाते समय OpenKnowledge हर एम्बेडिंग अनुरोध के लिए कितनी देर प्रतीक्षा करता है। खोज अनुरोधों की समय सीमा हर प्रयास के लिए 8 सेकंड तय है और यह सेटिंग उसे नहीं बदलती।"
+ ],
"h06R3C": ["किसी पेज पर जाने वाले ग्राफ़ लिंक अनुपस्थित नहीं हैं।"],
"h16FyT": ["सूचियाँ"],
"h2N-1n": [["0"], " में इंस्टॉल है"],
@@ -3768,6 +3788,7 @@
"jTLWxh": ["एक बाहरी पेज को इनलाइन iframe में एम्बेड करें (दस्तावेज़, डेमो, Figma, CodeSandbox)।"],
"jTUxaN": ["स्वचालित (केवल खींचें) चालू करें"],
"jTdrn1": [["filePath"], " में अब भी कॉन्फ़्लिक्ट है या नहीं, जाँचा नहीं जा सका — पुनः प्रयास जारी।"],
+ "jWwQo6": ["बैच"],
"jWzDfC": ["जाँच रहे हैं कि आपके पास कौन-से AI टूल हैं"],
"jZ_E5M": ["फ़ेच विफल — विवरण के लिए सर्वर लॉग देखें।"],
"j_Z6g7": ["साझा डिफ़ॉल्ट"],
@@ -3825,13 +3846,6 @@
"</0> जैसे localhost एंडपॉइंट के लिए ज़रूरी नहीं — अधिकतर स्थानीय सर्वर इसे अनदेखा करते हैं। केवल तभी जोड़ें जब आपके सर्वर को इसकी ज़रूरत हो।"
],
"kBNHN1": ["नेविगेशन इतिहास"],
- "kCNU4q": [
- "आपके पेज अनुक्रमित किए जा रहे हैं — ",
- ["semanticTotalCount"],
- " में से ",
- ["semanticIndexedCount"],
- " तैयार। परिणाम अधूरे हो सकते हैं।"
- ],
"kCjkGY": ["इसमें कुछ समय लग सकता है। आपकी markdown सामग्री सुरक्षित रहती है।"],
"kCqCyf": ["CodeMirror का lint निदान पैनल खोलें।"],
"kEiVv6": [
@@ -3862,6 +3876,7 @@
"अर्थ-आधारित खोज को किसी भी OpenAI-संगत एम्बेडिंग एंडपॉइंट पर लगाएँ — कोई स्वयं-होस्ट किया सर्वर या कोई दूसरा प्रदाता। ऊपर दी API कुंजी उसी एंडपॉइंट के लिए है जो आप यहाँ सेट करते हैं।"
],
"kSiB3X": [["trashNoun"], " में नहीं ले जाया जा सका"],
+ "kUgGPO": ["प्रति इंडेक्सिंग अनुरोध वर्ण बजट"],
"kV2YZv": [
"<0>Skills</0> नहीं दिख रहा? पहले <1>Settings <2/> Capabilities <3/> Code execution and file creation</1> सक्षम करें।"
],
@@ -4325,6 +4340,7 @@
"q3W2nd": ["वह टिप्पणी नहीं जोड़ी जा सकी: ", ["0"]],
"q4YJl_": ["टर्मिनल सत्र समाप्त हो गया (निकास कोड ", ["0"], ")।"],
"q4efaG": [["filePath"], " अब इस स्किल में नहीं है"],
+ "q5uZbJ": ["बाकी पेज खोज करते समय इंडेक्स किए जाते हैं। अधिक पूर्ण परिणामों के लिए फिर से खोजें।"],
"q6-JVU": ["पेज लोड हो रहे हैं"],
"q63KUv": ["MCP और स्किल जोड़ें"],
"q7F5am": ["शीर्षक"],
@@ -4747,6 +4763,9 @@
"uoJF_D": ["इसे सेट अप करना या शुरू करना बहुत कठिन था"],
"ur2XSb": ["दृश्य संपादक"],
"uuoHOU": ["कमांड विफल।"],
+ "uwzRx4": [
+ "धीमे या कम मेमोरी वाले एम्बेडिंग सर्वर के लिए इंडेक्सिंग अनुरोध का आकार और टाइमआउट समायोजित करें। अधिकांश सेटअप में डिफ़ॉल्ट मान ही रखने चाहिए।"
+ ],
"uyJsf6": ["परिचय"],
"uyOQ4e": ["थीम को base16 YAML के रूप में कॉपी किया गया"],
"uynXup": [["tokens", "plural", { "one": ["टोकन"], "other": ["टोकन"] }]],
@@ -5116,11 +5135,13 @@
"zbymaY": [["0"], " मिनट पहले"],
"zd00pH": ["पथ कॉपी करें"],
"zgSFyG": ["बाहरी लिंक"],
+ "zkkEFa": [["minimum"], " और ", ["maximum"], " के बीच एक पूर्णांक दर्ज करें।"],
"zkz0Fg": ["सिंक सेट अप करें"],
"zlErBl": ["पेज शीर्षकों की त्रुटि प्रतिक्रिया RFC 9457 से मेल नहीं खाई"],
"zo3Dl7": ["थंबनेल चालू या बंद करें"],
"zpfN9p": ["अभी कोई टिप्पणी नहीं। कोई जोड़ने के लिए दस्तावेज़ में पाठ चुनें।"],
"zq2eBA": ["स्रोत में देखें"],
+ "zqQlBg": ["प्रति इंडेक्सिंग अनुरोध अधिकतम टेक्स्ट खंड"],
"zrP8HX": [
"वह frontmatter जिससे इस टेम्पलेट से बना हर दस्तावेज़ शुरू होता है। मान YAML होते हैं — सूची <0>[a, b]</0> होती है; <1>{",
["date"],
diff --git a/packages/app/src/locales/hi/messages.po b/packages/app/src/locales/hi/messages.po
index d51052a55..839389d78 100644
--- a/packages/app/src/locales/hi/messages.po
+++ b/packages/app/src/locales/hi/messages.po
@@ -1726,6 +1726,10 @@ msgstr "ये फ़ाइलें जोड़ता है"
msgid "Adds these folders"
msgstr "ये फ़ोल्डर जोड़ता है"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "धीमे या कम मेमोरी वाले एम्बेडिंग सर्वर के लिए इंडेक्सिंग अनुरोध का आकार और टाइमआउट समायोजित करें। अधिकांश सेटअप में डिफ़ॉल्ट मान ही रखने चाहिए।"
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2287,6 +2291,11 @@ msgstr "बैकलिंक प्रतिक्रिया अपेक्
msgid "Base branch"
msgstr "आधार ब्रांच"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "बैच"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "सिमलिंक बन जाता है"
@@ -2633,6 +2642,15 @@ msgstr "बदलाव अपने आप सहेजे जाते है
msgid "Changes saved automatically."
msgstr "बदलाव अपने आप सहेज दिए गए।"
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "प्रति इंडेक्सिंग अनुरोध वर्ण बजट"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "अक्षर"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "अपडेट देखें"
@@ -2832,6 +2850,10 @@ msgstr "साफ़ करें"
msgid "Clear {keyName}"
msgstr "{keyName} साफ़ करें"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "किसी फ़ील्ड का डिफ़ॉल्ट मान बहाल करने के लिए उसे खाली करें।"
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "रंग हटाएँ"
@@ -5340,6 +5362,16 @@ msgstr "एक बाहरी पेज को इनलाइन iframe मे
msgid "Embed an image with optional alt text."
msgstr "वैकल्पिक वैकल्पिक-पाठ के साथ एक छवि एम्बेड करें।"
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "एम्बेडिंग अनुरोध सेटिंग्स"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "एम्बेडिंग"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "एम्बेडिंग API कुंजी"
@@ -5506,6 +5538,10 @@ msgstr "एक फ़ोल्डर नाम डालें (जैसे bra
msgid "Enter a name for this theme."
msgstr "इस थीम का नाम दर्ज करें।"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "{minimum} और {maximum} के बीच सेकंड की संख्या दर्ज करें।"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "1 और 65535 के बीच एक port दर्ज करें।"
@@ -5538,6 +5574,10 @@ msgstr "एक मान्य URL डालें (उदाहरण के
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "एक मान्य URL दर्ज करें, उदाहरण के लिए https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "{minimum} और {maximum} के बीच एक पूर्णांक दर्ज करें।"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "वह सार्वजनिक ऑरिजिन दर्ज करें जिसे आपका tunnel सर्व करता है, उदाहरण के लिए https://notes.example.com"
@@ -6005,6 +6045,10 @@ msgstr "संलग्नक स्थान अपडेट करने म
msgid "Failed to update markdownlint rules"
msgstr "markdownlint नियम अपडेट करने में विफल"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "प्रदर्शन सेटिंग अपडेट करने में विफल — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6841,6 +6885,10 @@ msgstr "आपको OpenKnowledge कैसा लगा?"
msgid "How does sharing work?"
msgstr "साझाकरण कैसे काम करता है?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "इंडेक्स बनाते समय OpenKnowledge हर एम्बेडिंग अनुरोध के लिए कितनी देर प्रतीक्षा करता है। खोज अनुरोधों की समय सीमा हर प्रयास के लिए 8 सेकंड तय है और यह सेटिंग उसे नहीं बदलती।"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "गायब प्रोजेक्ट-स्थानीय दस्तावेज़ों, फ़ाइलों और इमेज को समस्याएँ, एडिटर डायग्नोस्टिक्स, ऑडिट और एजेंट टूल में कैसे रिपोर्ट किया जाता है।"
@@ -7109,9 +7157,9 @@ msgstr "इंडेक्स रखरखाव बंद रहा क्य
msgid "Indexed {embedded} of {total} pages."
msgstr "{total} में से {embedded} पेज अनुक्रमित।"
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "आपके पेज अनुक्रमित किए जा रहे हैं — {semanticTotalCount} में से {semanticIndexedCount} तैयार। परिणाम अधूरे हो सकते हैं।"
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "इंडेक्सिंग अनुरोध टाइमआउट (सेकंड)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7664,6 +7712,10 @@ msgstr "हल्का"
msgid "Light, dark, or follow the OS."
msgstr "हल्का, गहरा, या OS का अनुसरण।"
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "हर अनुरोध में भेजे जाने वाले कुल टेक्स्ट को सीमित करता है। बड़ा एकल खंड अकेले भेजा जाता है; दस्तावेज़ दोबारा विभाजित नहीं होते।"
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "पंक्ति {displayLine}"
@@ -7985,6 +8037,10 @@ msgstr "<0>{lookingForUrl}</0> खोजा जा रहा है।"
msgid "Lost connection to \"{docName}\"."
msgstr "\"{docName}\" से कनेक्शन टूट गया।"
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "प्रति अनुरोध मेमोरी उपयोग और काम घटाने के लिए इसे कम करें। छोटे बैच अधिक अनुरोध भेजते हैं और कुल मिलाकर इंडेक्सिंग धीमी कर सकते हैं।"
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "प्रत्येक फ़ोल्डर में generated अनुक्रमणिका बनाए रखें?"
@@ -8095,6 +8151,10 @@ msgstr "अधिकतम {MAX_ATTACHMENTS} संलग्नक"
msgid "Maximum agents already running"
msgstr "अधिकतम एजेंट पहले से चल रहे हैं"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "प्रति इंडेक्सिंग अनुरोध अधिकतम टेक्स्ट खंड"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP स्वतः-मरम्मत विफल रही"
@@ -8182,6 +8242,10 @@ msgstr "अनुपस्थित पेज — बनाने के लि
msgid "Missing page: {linkTitle}. Click to create."
msgstr "अनुपस्थित पेज: {linkTitle}. बनाने के लिए क्लिक करें।"
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "बाकी पेज खोज करते समय इंडेक्स किए जाते हैं। अधिक पूर्ण परिणामों के लिए फिर से खोजें।"
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "पैलेट के रंग मौजूद नहीं हैं"
@@ -10062,6 +10126,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "पेज पहली बार तभी एम्बेड होते हैं जब किसी खोज को उनकी ज़रूरत पड़ती है।"
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "इंडेक्स किए गए पेज: {semanticTotalCount} में से {semanticIndexedCount}।"
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "नीचे खिसकाएँ"
@@ -10206,6 +10274,11 @@ msgstr "लंबित"
msgid "Percolating…"
msgstr "छाना जा रहा है…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "प्रदर्शन"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "<0>{targetGitPath}</0> और उसका पूरा git इतिहास स्थायी रूप से हटा देता है। काम की फ़ाइलें अपनी जगह बनी रहती हैं। यदि मूल git रिपॉज़िटरी जानबूझकर है (जैसे आपने उसे क्लोन किया था), तो रद्द करें और उसके बाहर कोई स्थान चुनें।"
@@ -11305,6 +11378,11 @@ msgstr "रिपॉज़िटरी नहीं मिली — हो स
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "रिपॉज़िटरी नहीं मिली। शायद इसका नाम बदला गया, इसे हटाया गया, या हिलाया गया।"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "अनुरोध"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "आवश्यक"
@@ -11658,6 +11736,7 @@ msgstr "यह टिप्पणी सहेजें (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "सहेजा गया"
@@ -14325,6 +14404,11 @@ msgstr "व्यवस्थित किया जा रहा है…"
msgid "Timeline"
msgstr "समयरेखा"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "समय सीमा"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "जिन फ़ाइलों में lint या लिंक की समस्याएँ हैं उन्हें बिना खोले रंग और बैज दें।"
diff --git a/packages/app/src/locales/id/messages.json b/packages/app/src/locales/id/messages.json
index d96b33748..1b0f6b703 100644
--- a/packages/app/src/locales/id/messages.json
+++ b/packages/app/src/locales/id/messages.json
@@ -127,6 +127,7 @@
"0jD-Gn": ["Basis pengetahuan tim, wiki pribadi, dokumentasi proyek..."],
"0kTAXe": ["Buka sumber: ", ["mirrorSrc"]],
"0m4Snh": ["Keterampilan dialihkan"],
+ "0mlCvF": ["karakter"],
"0niWj3": [["removingCount", "plural", { "other": ["#", " dihapus"] }]],
"0pLDSn": ["Bilah alat Keterampilan"],
"0pZmTP": ["Tidak dapat membagikan jalur ini."],
@@ -363,6 +364,7 @@
"3zDeFb": ["Merenung…"],
"3zyg_A": ["Pola abaikan"],
"4-Phgi": ["Tampilkan atau sembunyikan agen"],
+ "42QMZH": ["permintaan"],
"438Fca": ["Berhasil dikloning, tetapi proyeknya tidak dapat dibuka."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -862,6 +864,9 @@
"9tJX8r": ["Berdasarkan makna"],
"9uI_rE": ["Batalkan"],
"9uRLEH": ["\"", ["name"], "\" tidak bisa dibuka — ia belum ada di keterampilan proyek ini."],
+ "9wIf0H": [
+ "Turunkan nilai ini untuk mengurangi penggunaan memori dan beban per permintaan. Batch yang lebih kecil mengirim lebih banyak permintaan dan dapat memperlambat pengindeksan secara keseluruhan."
+ ],
"9wQrUU": ["Refaktor"],
"9x-lMu": ["Di repositori ini — kolaborator mendapat salinan lewat git."],
"9xCnv8": ["Sembunyikan Terminal"],
@@ -903,6 +908,7 @@
"AUV-TY": ["Berpikir"],
"AVW-K9": ["Gagal memuat halaman yatim"],
"AWOSPo": ["Perbesar"],
+ "AXMOeM": ["performa"],
"AYoYhU": ["Pembaruan gagal: ", ["0"]],
"AaC-CE": ["Papan kosong"],
"AcK_r0": ["Claude CLI"],
@@ -976,6 +982,7 @@
"Bdha5y": ["Menerbitkan..."],
"BeWTQy": ["Memuat paket awal"],
"BgV29F": ["Bidang pencarian penyunting visual sedang difokus"],
+ "Bgaa_U": ["Gagal memperbarui pengaturan performa — ", ["detail"]],
"BhLPRk": ["\"", ["name"], "\" dikembalikan ke versi yang terpasang"],
"BjitBo": ["Unduh ", ["0"]],
"BkGtRl": [
@@ -1047,6 +1054,7 @@
"CbxTfe": ["Pilih blok"],
"CcaU4i": ["Suntingan langsung diterapkan dan disimpan otomatis ke tema ini."],
"ChMshD": ["Keluar dari ", ["appName"]],
+ "ChdabN": ["Kosongkan kolom untuk mengembalikan nilai defaultnya."],
"Ck9XRt": ["Kuncinya tidak bisa disimpan — silakan coba lagi."],
"ClII5l": ["Tekan ikon matahari atau bulan pada “Custom” di atas untuk memakai tema ini."],
"ClTEde": ["Siapkan bagian yang dipilih di panel agen, siap dilengkapi dan dikirim."],
@@ -1329,6 +1337,7 @@
"FgQ7XZ": ["Laporan bug Anda tidak bisa dimuat."],
"FgRAvd": ["Log & info sistem"],
"Fhp4Gn": ["Lihat plugin"],
+ "Fim5F3": ["embedding"],
"FiyNln": ["Lompat ke teks terpilih di properti"],
"FjkaiT": ["Perkecil"],
"Fjz6aJ": ["Kirim ke obrolan baru"],
@@ -1763,6 +1772,7 @@
"L4Cdd9": ["atau buat berkas baru <0/>"],
"L6Hhh6": ["(akar)"],
"L6Ud-t": ["Tidak dapat memuat konflik. Muat ulang untuk mencoba lagi."],
+ "L7NFTZ": ["Masukkan jumlah detik antara ", ["minimum"], " dan ", ["maximum"], "."],
"L83DKQ": ["Pemasangan PATH gagal: ", ["summary"]],
"L8fKuc": ["Jalankan ini di terminal Anda"],
"L9Y9Om": ["Halaman paling banyak ditaut"],
@@ -2205,6 +2215,7 @@
"QQbwzK": ["Tidak ada agen yang tersedia."],
"QQghPu": ["Pasang di Claude Desktop"],
"QR5SP1": ["templat dibuat"],
+ "QRSdsO": ["Batas waktu permintaan pengindeksan (detik)"],
"QVk3SK": ["Berkas ini dihapus di cabang masuk (konflik modify-delete)."],
"QWdKwH": ["Pindahkan"],
"QYTOaN": ["Anda bisa mengubah ini nanti di <0>Pengaturan → Sinkronisasi</0>."],
@@ -2266,6 +2277,7 @@
"RGCCrg": ["Salin tautan berbagi"],
"RGkNeJ": ["Inisialisasi sebuah paket awal"],
"RGptDW": ["OpenKnowledge memindahkan sebuah dokumen"],
+ "RH0e_f": ["batas waktu"],
"RJ3a8Z": ["Mencari <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"Dari plugin ",
@@ -2743,6 +2755,9 @@
"XYZ7tp": ["Tidak terselesaikan"],
"XYlJJT": ["Menyiapkan"],
"XZkdtg": ["Ganti cabang"],
+ "Xafwko": [
+ "Membatasi total teks yang dikirim dalam setiap permintaan. Potongan yang lebih besar dikirim sendiri; dokumen tidak dipecah lagi."
+ ],
"XcGbim": ["Tampilkan berkas tersembunyi"],
"Xet9MX": ["Gagal memuat tautan balik"],
"Xewl6B": ["Salinan lokal Anda tertinggal. Tarik perubahan terbaru, lalu buka tautannya lagi."],
@@ -3226,6 +3241,7 @@
"cRm498": ["Belum ada berkas skema di proyek ini — buat satu untuk mulai memvalidasi."],
"cSCbv3": ["BETA"],
"cT_pW4": ["Blok konten yang dapat dilipat (toggle gaya Notion)."],
+ "cTrVa1": ["Pengaturan permintaan embedding"],
"cU-seF": ["Lompat ke sumber markdown untuk blok di posisi kursor, terpusat dan tersorot."],
"cUK8lW": [["conflictCount", "plural", { "other": ["#", " konflik"] }]],
"cUagXn": ["Tambahkan ke ", ["gitignorePath"]],
@@ -3392,6 +3408,13 @@
"eGUbmF": ["Salin berkas atau folder terpilih"],
"eJitUk": ["Unggah dari komputer"],
"eKThTQ": ["Gagal menata ulang"],
+ "eMWRAs": [
+ "Halaman terindeks: ",
+ ["semanticIndexedCount"],
+ " dari ",
+ ["semanticTotalCount"],
+ "."
+ ],
"eNOyTV": [
"Anda tidak punya izin push ke repositori ini. Otomatis (hanya Pull) tetap bisa menjaga salinan Anda mutakhir."
],
@@ -3664,6 +3687,9 @@
"gyHDWC": ["Perbaiki semua dengan AI (", ["count"], ")"],
"gyYvCN": ["Kirim suntingan saya setiap"],
"h-AdvS": ["Folder dan templatnya sudah ada di sini, jadi tidak ada yang perlu ditambahkan."],
+ "h-RPqa": [
+ "Berapa lama OpenKnowledge menunggu setiap permintaan embedding saat pengindeksan. Permintaan pencarian memiliki batas waktu tetap 8 detik per percobaan, yang tidak berubah oleh pengaturan ini."
+ ],
"h06R3C": ["Tidak ada halaman yang kehilangan tautan graf keluar."],
"h16FyT": ["Daftar"],
"h2N-1n": ["Terpasang di ", ["0"]],
@@ -3916,6 +3942,7 @@
],
"jTUxaN": ["Aktifkan Otomatis (hanya Pull)"],
"jTdrn1": ["Tidak dapat memeriksa apakah ", ["filePath"], " masih berkonflik — mencoba lagi."],
+ "jWwQo6": ["batch"],
"jWzDfC": ["Memeriksa alat AI yang Anda miliki"],
"jZ_E5M": ["Fetch gagal — periksa log server untuk detailnya."],
"j_Z6g7": ["Bawaan bersama"],
@@ -3973,13 +4000,6 @@
"</0> — kebanyakan server lokal mengabaikannya. Tambahkan hanya jika milik Anda memerlukannya."
],
"kBNHN1": ["Riwayat navigasi"],
- "kCNU4q": [
- "Mengindeks halaman Anda — ",
- ["semanticIndexedCount"],
- " dari ",
- ["semanticTotalCount"],
- " siap. Hasilnya mungkin belum lengkap."
- ],
"kCjkGY": ["Ini mungkin makan waktu sebentar. Konten markdown Anda dipertahankan."],
"kCqCyf": ["Membuka panel diagnostik lint CodeMirror."],
"kEiVv6": [
@@ -4012,6 +4032,7 @@
"Arahkan pencarian semantik ke endpoint embedding mana pun yang kompatibel dengan OpenAI — server milik sendiri atau penyedia lain. Kunci API di atas berlaku untuk endpoint mana pun yang Anda setel di sini."
],
"kSiB3X": ["Tidak dapat memindahkan ke ", ["trashNoun"]],
+ "kUgGPO": ["Anggaran karakter per permintaan pengindeksan"],
"kV2YZv": [
"Tidak melihat <0>Keterampilan</0>? Aktifkan dulu <1>Pengaturan <2/> Kemampuan <3/> Eksekusi kode dan pembuatan berkas</1>."
],
@@ -4490,6 +4511,9 @@
"q3W2nd": ["Komentar itu tidak bisa ditambahkan: ", ["0"]],
"q4YJl_": ["Sesi terminal berakhir (kode keluar ", ["0"], ")."],
"q4efaG": [["filePath"], " sudah tidak ada di skill ini"],
+ "q5uZbJ": [
+ "Halaman yang belum terindeks akan diindeks saat Anda mencari. Cari lagi untuk mendapatkan hasil yang lebih lengkap."
+ ],
"q6-JVU": ["Memuat halaman"],
"q63KUv": ["Tambahkan MCP & keterampilan"],
"q7F5am": ["judul"],
@@ -4926,6 +4950,9 @@
"uoJF_D": ["Terlalu sulit disiapkan atau dimulai"],
"ur2XSb": ["Penyunting visual"],
"uuoHOU": ["Perintah gagal."],
+ "uwzRx4": [
+ "Sesuaikan ukuran dan batas waktu permintaan pengindeksan untuk server embedding yang lambat atau terbatas memori. Sebagian besar penyiapan sebaiknya mempertahankan nilai bawaan."
+ ],
"uyJsf6": ["Tentang"],
"uyOQ4e": ["Tema disalin sebagai YAML base16"],
"uynXup": [["tokens", "plural", { "other": ["token"] }]],
@@ -5308,11 +5335,13 @@
"zbymaY": [["0"], " mnt lalu"],
"zd00pH": ["Salin Jalur"],
"zgSFyG": ["Tautan eksternal"],
+ "zkkEFa": ["Masukkan bilangan bulat antara ", ["minimum"], " dan ", ["maximum"], "."],
"zkz0Fg": ["Siapkan sinkronisasi"],
"zlErBl": ["Respons galat judul halaman tidak sesuai RFC 9457"],
"zo3Dl7": ["Tampilkan atau sembunyikan gambar mini"],
"zpfN9p": ["Belum ada komentar. Pilih teks di dokumen untuk menambahkan satu."],
"zq2eBA": ["Lihat di sumber"],
+ "zqQlBg": ["Maksimum potongan teks per permintaan pengindeksan"],
"zrP8HX": [
"Frontmatter yang mengawali setiap dokumen yang dibuat dari templat ini. Nilainya berupa YAML — daftar ditulis <0>[a, b]</0>; <1>{",
["date"],
diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.po
index 78f5fca1d..40c8e3e9f 100644
--- a/packages/app/src/locales/id/messages.po
+++ b/packages/app/src/locales/id/messages.po
@@ -1726,6 +1726,10 @@ msgstr "Menambahkan berkas ini"
msgid "Adds these folders"
msgstr "Menambahkan folder ini"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "Sesuaikan ukuran dan batas waktu permintaan pengindeksan untuk server embedding yang lambat atau terbatas memori. Sebagian besar penyiapan sebaiknya mempertahankan nilai bawaan."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2287,6 +2291,11 @@ msgstr "Respons tautan balik tidak sesuai bentuk yang diharapkan."
msgid "Base branch"
msgstr "Cabang dasar"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "batch"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "menjadi tautan simbolik"
@@ -2633,6 +2642,15 @@ msgstr "Perubahan disimpan otomatis."
msgid "Changes saved automatically."
msgstr "Perubahan disimpan otomatis."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "Anggaran karakter per permintaan pengindeksan"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "karakter"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "Periksa pembaruan"
@@ -2832,6 +2850,10 @@ msgstr "Bersihkan"
msgid "Clear {keyName}"
msgstr "Bersihkan {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "Kosongkan kolom untuk mengembalikan nilai defaultnya."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "Hapus warna"
@@ -5340,6 +5362,16 @@ msgstr "Menyematkan halaman eksternal dalam iframe sebaris (dokumentasi, demo, F
msgid "Embed an image with optional alt text."
msgstr "Menyematkan gambar dengan teks alternatif opsional."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "Pengaturan permintaan embedding"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "embedding"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "Kunci API embedding"
@@ -5506,6 +5538,10 @@ msgstr "Masukkan nama folder (mis. otak)."
msgid "Enter a name for this theme."
msgstr "Masukkan nama untuk tema ini."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "Masukkan jumlah detik antara {minimum} dan {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "Masukkan port antara 1 dan 65535."
@@ -5538,6 +5574,10 @@ msgstr "Masukkan URL yang valid (misalnya https://api.openai.com/v1)."
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "Masukkan URL yang valid, misalnya https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "Masukkan bilangan bulat antara {minimum} dan {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "Masukkan origin publik yang dilayani tunnel Anda, misalnya https://notes.example.com"
@@ -6005,6 +6045,10 @@ msgstr "Gagal memperbarui lokasi lampiran — {detail}"
msgid "Failed to update markdownlint rules"
msgstr "Gagal memperbarui aturan markdownlint"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "Gagal memperbarui pengaturan performa — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6841,6 +6885,10 @@ msgstr "Bagaimana pendapat Anda tentang OpenKnowledge?"
msgid "How does sharing work?"
msgstr "Bagaimana cara kerja berbagi?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "Berapa lama OpenKnowledge menunggu setiap permintaan embedding saat pengindeksan. Permintaan pencarian memiliki batas waktu tetap 8 detik per percobaan, yang tidak berubah oleh pengaturan ini."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "Cara dokumen, file, dan gambar lokal proyek yang hilang dilaporkan di Masalah, diagnostik editor, audit, dan alat agen."
@@ -7109,9 +7157,9 @@ msgstr "Pemeliharaan indeks tidak dilakukan karena pengaturan proyek tidak dapat
msgid "Indexed {embedded} of {total} pages."
msgstr "{embedded} dari {total} halaman terindeks."
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "Mengindeks halaman Anda — {semanticIndexedCount} dari {semanticTotalCount} siap. Hasilnya mungkin belum lengkap."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "Batas waktu permintaan pengindeksan (detik)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7664,6 +7712,10 @@ msgstr "Terang"
msgid "Light, dark, or follow the OS."
msgstr "Terang, gelap, atau ikuti sistem."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "Membatasi total teks yang dikirim dalam setiap permintaan. Potongan yang lebih besar dikirim sendiri; dokumen tidak dipecah lagi."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "baris {displayLine}"
@@ -7985,6 +8037,10 @@ msgstr "Mencari <0>{lookingForUrl}</0>."
msgid "Lost connection to \"{docName}\"."
msgstr "Koneksi ke \"{docName}\" terputus."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "Turunkan nilai ini untuk mengurangi penggunaan memori dan beban per permintaan. Batch yang lebih kecil mengirim lebih banyak permintaan dan dapat memperlambat pengindeksan secara keseluruhan."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "Pertahankan indeks generated di setiap folder?"
@@ -8095,6 +8151,10 @@ msgstr "Maksimal {MAX_ATTACHMENTS} lampiran"
msgid "Maximum agents already running"
msgstr "Jumlah agen yang berjalan sudah maksimal"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "Maksimum potongan teks per permintaan pengindeksan"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "Perbaikan otomatis MCP gagal"
@@ -8182,6 +8242,10 @@ msgstr "Halaman belum ada — klik untuk membuat"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "Halaman belum ada: {linkTitle}. Klik untuk membuat."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "Halaman yang belum terindeks akan diindeks saat Anda mencari. Cari lagi untuk mendapatkan hasil yang lebih lengkap."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "Warna palet tidak lengkap"
@@ -10062,6 +10126,10 @@ msgstr "nama-halaman"
msgid "Pages are embedded the first time a search needs them."
msgstr "Halaman di-embed pertama kali ketika sebuah pencarian membutuhkannya."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "Halaman terindeks: {semanticIndexedCount} dari {semanticTotalCount}."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "Geser ke bawah"
@@ -10206,6 +10274,11 @@ msgstr "tertunda"
msgid "Percolating…"
msgstr "Mengendap…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "performa"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "Menghapus <0>{targetGitPath}</0> secara permanen beserta seluruh riwayat git-nya. Berkas kerja tetap di tempatnya. Jika repo git induknya memang disengaja (mis. Anda yang mengkloningnya), batalkan dan pilih lokasi di luarnya."
@@ -11305,6 +11378,11 @@ msgstr "Repositori tidak ditemukan — mungkin ia tidak ada, atau akun yang digu
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "Repositori tidak ditemukan. Mungkin ia sudah diganti nama, dihapus, atau dipindahkan."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "permintaan"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "wajib"
@@ -11658,6 +11736,7 @@ msgstr "Simpan komentar ini (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "Tersimpan"
@@ -14325,6 +14404,11 @@ msgstr "Merapikan…"
msgid "Timeline"
msgstr "Lini masa"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "batas waktu"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "Mewarnai dan menandai berkas yang punya masalah lint atau tautan, tanpa perlu membukanya."
diff --git a/packages/app/src/locales/ko/messages.json b/packages/app/src/locales/ko/messages.json
index 01e86bc8f..d10e470b2 100644
--- a/packages/app/src/locales/ko/messages.json
+++ b/packages/app/src/locales/ko/messages.json
@@ -121,6 +121,7 @@
"0jD-Gn": ["팀 지식 베이스, 개인 위키, 프로젝트 문서…"],
"0kTAXe": ["소스 열기: ", ["mirrorSrc"]],
"0m4Snh": ["스킬 재할당됨"],
+ "0mlCvF": ["문자"],
"0niWj3": [["removingCount", "plural", { "other": ["#", " 제거됨"] }]],
"0pLDSn": ["스킬 도구 모음"],
"0pZmTP": ["이 경로는 공유할 수 없습니다."],
@@ -350,6 +351,7 @@
"3zDeFb": ["곰곰이 생각 중…"],
"3zyg_A": ["무시 패턴"],
"4-Phgi": ["에이전트 표시 또는 숨기기"],
+ "42QMZH": ["요청"],
"438Fca": ["클론에 성공했지만 프로젝트를 열 수 없습니다."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -825,6 +827,9 @@
"9tJX8r": ["의미순"],
"9uI_rE": ["실행 취소"],
"9uRLEH": ["\"", ["name"], "\" 열기 실패: 프로젝트 스킬에 아직 없습니다."],
+ "9wIf0H": [
+ "이 값을 낮추면 요청당 메모리 사용량과 작업량이 줄어듭니다. 배치가 작을수록 요청 수가 늘어 전체 인덱싱이 느려질 수 있습니다."
+ ],
"9wQrUU": ["리팩터링"],
"9x-lMu": ["이 저장소에 저장 — 협업자는 git을 통해 사본을 받습니다."],
"9xCnv8": ["터미널 가리기"],
@@ -866,6 +871,7 @@
"AUV-TY": ["생각 중"],
"AVW-K9": ["고아 페이지 불러오기 실패"],
"AWOSPo": ["확대"],
+ "AXMOeM": ["성능"],
"AYoYhU": ["업데이트 실패: ", ["0"]],
"AaC-CE": ["빈 보드"],
"AcK_r0": ["Claude CLI"],
@@ -941,6 +947,7 @@
"Bdha5y": ["게시 중…"],
"BeWTQy": ["스타터 팩 불러오는 중"],
"BgV29F": ["비주얼 편집기 찾기 입력 필드에 포커스가 있습니다."],
+ "Bgaa_U": ["성능 설정을 업데이트하지 못했습니다: ", ["detail"]],
"BhLPRk": ["\"", ["name"], "\"을 설치된 버전으로 되돌렸습니다"],
"BjitBo": [["0"], " 다운로드"],
"BkGtRl": [
@@ -1008,6 +1015,7 @@
"CbxTfe": ["블록 선택"],
"CcaU4i": ["편집 내용이 실시간으로 적용되고 이 테마에 자동으로 저장됩니다."],
"ChMshD": [["appName"], " 종료"],
+ "ChdabN": ["필드를 비우면 기본값으로 복원됩니다."],
"Ck9XRt": ["키를 저장하지 못했습니다. 다시 시도합니다."],
"ClII5l": ["위의 사용자 지정에서 태양 또는 달을 눌러 이 테마를 사용합니다."],
"ClTEde": ["선택한 구절을 에이전트 패널에 올려 이어서 작성하고 전송할 수 있게 합니다."],
@@ -1272,6 +1280,7 @@
"FgQ7XZ": ["버그 보고서를 불러오지 못했습니다."],
"FgRAvd": ["로그 및 시스템 정보"],
"Fhp4Gn": ["플러그인 보기"],
+ "Fim5F3": ["임베딩"],
"FiyNln": ["속성에서 선택한 텍스트로 이동"],
"FjkaiT": ["축소"],
"Fjz6aJ": ["새 채팅으로 전송"],
@@ -1685,6 +1694,7 @@
"L4Cdd9": ["또는 새 파일 <0/> 만들기"],
"L6Hhh6": ["(루트)"],
"L6Ud-t": ["충돌을 불러올 수 없습니다. 다시 로드해 시도하세요."],
+ "L7NFTZ": [["minimum"], "에서 ", ["maximum"], " 사이의 초 단위 값을 입력하세요."],
"L83DKQ": ["PATH 설치 실패: ", ["summary"]],
"L8fKuc": ["터미널에서 실행"],
"L9Y9Om": ["링크가 가장 많은 페이지"],
@@ -2110,6 +2120,7 @@
"QQbwzK": ["사용 가능한 에이전트 없음."],
"QQghPu": ["Claude Desktop에 설치"],
"QR5SP1": ["템플릿 생성됨"],
+ "QRSdsO": ["인덱싱 요청 시간 제한(초)"],
"QVk3SK": ["이 파일은 수신 브랜치에서 삭제되었습니다 (modify-delete 충돌)."],
"QWdKwH": ["이동"],
"QYTOaN": ["나중에 <0>설정 → 동기화</0>에서 변경할 수 있습니다."],
@@ -2167,6 +2178,7 @@
"RGCCrg": ["공유 링크 복사"],
"RGkNeJ": ["스타터 팩 초기화"],
"RGptDW": ["OpenKnowledge에서 문서 이동"],
+ "RH0e_f": ["시간 제한"],
"RJ3a8Z": ["<0>", ["lookingForUrl"], "</0> 찾는 중입니다."],
"RJMO4B": [
["residentPlugin"],
@@ -2628,6 +2640,9 @@
"XYZ7tp": ["해결할 수 없음"],
"XYlJJT": ["설정 중"],
"XZkdtg": ["브랜치 전환"],
+ "Xafwko": [
+ "각 요청에 담기는 전체 텍스트 양을 제한합니다. 예산보다 큰 청크는 단독으로 전송되며, 문서를 다시 분할하지는 않습니다."
+ ],
"XcGbim": ["숨김 파일 표시"],
"Xet9MX": ["백링크 불러오기 실패"],
"Xewl6B": ["로컬 사본이 뒤처져 있습니다. 최신 변경 사항을 푼 후 링크를 다시 여세요."],
@@ -3084,6 +3099,7 @@
"cRm498": ["이 프로젝트에 스키마 파일이 아직 없습니다. 하나를 만들면 검증을 시작합니다."],
"cSCbv3": ["베타"],
"cT_pW4": ["접을 수 있는 콘텐츠 블록입니다. Notion 스타일 토글입니다."],
+ "cTrVa1": ["임베딩 요청 설정"],
"cU-seF": ["커서가 있는 블록의 Markdown 소스로 이동해 가운데에 표시하고 강조합니다."],
"cUK8lW": [["conflictCount", "plural", { "other": ["충돌 ", "#", "개"] }]],
"cUagXn": [["gitignorePath"], "에 추가"],
@@ -3250,6 +3266,13 @@
"eGUbmF": ["선택한 파일 또는 폴더 복사"],
"eJitUk": ["컴퓨터에서 업로드"],
"eKThTQ": ["순서 변경 실패"],
+ "eMWRAs": [
+ "인덱싱된 페이지: ",
+ ["semanticTotalCount"],
+ "개 중 ",
+ ["semanticIndexedCount"],
+ "개."
+ ],
"eNOyTV": [
"이 저장소에 푸시할 권한이 없습니다. 자동(풀만)으로도 사본을 최신 상태로 유지할 수 있습니다."
],
@@ -3512,6 +3535,9 @@
"gyHDWC": ["AI로 모두 수정 (", ["count"], ")"],
"gyYvCN": ["내 편집 내용 푸시 주기"],
"h-AdvS": ["폴더와 템플릿이 이미 있으므로 추가할 항목이 없습니다."],
+ "h-RPqa": [
+ "색인 생성 중 OpenKnowledge가 각 임베딩 요청을 기다리는 시간입니다. 검색 요청의 시간 제한은 시도당 8초로 고정되어 있으며 이 설정의 영향을 받지 않습니다."
+ ],
"h06R3C": ["나가는 그래프 링크가 누락된 페이지가 없습니다."],
"h16FyT": ["목록"],
"h2N-1n": [["0"], "에 설치됨"],
@@ -3745,6 +3771,7 @@
],
"jTUxaN": ["자동(풀만) 활성화"],
"jTdrn1": [["filePath"], "에 아직 충돌이 있는지 확인하지 못했습니다 — 다시 시도합니다."],
+ "jWwQo6": ["배치"],
"jWzDfC": ["보유한 AI 도구를 확인하는 중"],
"jZ_E5M": ["가져오기 실패. 자세한 내용은 서버 로그를 확인하세요."],
"j_Z6g7": ["공유 기본값"],
@@ -3802,13 +3829,6 @@
"</0> 같은 localhost 엔드포인트에는 필요하지 않습니다. 대부분의 로컬 서버는 키를 무시합니다. 필요할 때만 추가합니다."
],
"kBNHN1": ["탐색 기록"],
- "kCNU4q": [
- "페이지를 색인하는 중입니다. 준비된 결과: ",
- ["semanticIndexedCount"],
- "/",
- ["semanticTotalCount"],
- ". 결과가 불완전할 수 있습니다."
- ],
"kCjkGY": ["잠시 시간이 걸릴 수 있습니다. markdown 콘텐츠는 유지됩니다."],
"kCqCyf": ["CodeMirror lint 진단 패널을 엽니다."],
"kEiVv6": [
@@ -3841,6 +3861,7 @@
"의미 기반 검색을 OpenAI 호환 임베딩 엔드포인트에 연결합니다. 자체 호스팅 서버나 다른 제공업체를 사용할 수 있습니다. 위의 API 키는 여기서 설정한 엔드포인트에 사용됩니다."
],
"kSiB3X": [["trashNoun"], "으로 이동하지 못했습니다"],
+ "kUgGPO": ["인덱싱 요청당 문자 예산"],
"kV2YZv": [
"<0>Skills</0> 미표시? 먼저 <1>설정 <2/> 기능 <3/> 코드 실행 및 파일 생성</1> 활성화."
],
@@ -4291,6 +4312,9 @@
"q3W2nd": ["댓글 추가에 실패했습니다: ", ["0"]],
"q4YJl_": ["터미널 세션 종료(종료 코드 ", ["0"], ")."],
"q4efaG": [["filePath"], "이 이 스킬에서 제거되었습니다"],
+ "q5uZbJ": [
+ "검색할 때 아직 인덱싱되지 않은 페이지를 인덱싱합니다. 더 많은 결과를 보려면 다시 검색하세요."
+ ],
"q6-JVU": ["페이지를 불러오는 중"],
"q63KUv": ["MCP 및 스킬 추가"],
"q7F5am": ["제목"],
@@ -4705,6 +4729,9 @@
"uoJF_D": ["설정하거나 시작하기가 너무 어려웠습니다"],
"ur2XSb": ["비주얼 편집기"],
"uuoHOU": ["명령에 실패했습니다."],
+ "uwzRx4": [
+ "느리거나 메모리가 제한된 임베딩 서버에 맞게 인덱싱 요청 크기와 시간 제한을 조정합니다. 대부분의 환경에서는 기본값을 유지하는 것이 좋습니다."
+ ],
"uyJsf6": ["정보"],
"uyOQ4e": ["테마를 base16 YAML로 복사함"],
"uynXup": [["tokens", "plural", { "other": ["토큰"] }]],
@@ -5064,11 +5091,13 @@
"zbymaY": [["0"], "분 전"],
"zd00pH": ["경로 복사"],
"zgSFyG": ["외부 링크"],
+ "zkkEFa": [["minimum"], "에서 ", ["maximum"], " 사이의 정수를 입력하세요."],
"zkz0Fg": ["동기화 설정"],
"zlErBl": ["페이지 제목 오류 응답이 RFC 9457과 일치하지 않습니다"],
"zo3Dl7": ["썸네일 전환"],
"zpfN9p": ["아직 댓글 없음. 문서에서 텍스트 선택 후 댓글 추가"],
"zq2eBA": ["소스에서 보기"],
+ "zqQlBg": ["인덱싱 요청당 최대 텍스트 청크 수"],
"zrP8HX": [
"이 템플릿으로 만든 모든 문서는 이 frontmatter로 시작합니다. 값은 YAML이며, 목록은 <0>[a, b]</0>이고 <1>{",
["date"],
diff --git a/packages/app/src/locales/ko/messages.po b/packages/app/src/locales/ko/messages.po
index c128af158..ec3f76dda 100644
--- a/packages/app/src/locales/ko/messages.po
+++ b/packages/app/src/locales/ko/messages.po
@@ -1730,6 +1730,10 @@ msgstr "다음 파일을 추가합니다"
msgid "Adds these folders"
msgstr "다음 폴더를 추가합니다"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "느리거나 메모리가 제한된 임베딩 서버에 맞게 인덱싱 요청 크기와 시간 제한을 조정합니다. 대부분의 환경에서는 기본값을 유지하는 것이 좋습니다."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "백링크 응답 형식이 예상과 일치하지 않습니다."
msgid "Base branch"
msgstr "기준 브랜치"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "배치"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "심볼릭 링크가 됩니다"
@@ -2637,6 +2646,15 @@ msgstr "변경사항이 자동으로 저장됩니다."
msgid "Changes saved automatically."
msgstr "변경사항이 자동으로 저장되었습니다."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "인덱싱 요청당 문자 예산"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "문자"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "업데이트 확인"
@@ -2836,6 +2854,10 @@ msgstr "지우기"
msgid "Clear {keyName}"
msgstr "{keyName} 지우기"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "필드를 비우면 기본값으로 복원됩니다."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "색상 지우기"
@@ -5344,6 +5366,16 @@ msgstr "외부 페이지를 인라인 iframe에 삽입합니다. 문서, 데모,
msgid "Embed an image with optional alt text."
msgstr "대체 텍스트를 추가할 수 있는 이미지를 삽입합니다."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "임베딩 요청 설정"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "임베딩"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "임베딩 API 키"
@@ -5510,6 +5542,10 @@ msgstr "폴더 이름을 입력하세요(예: brain)."
msgid "Enter a name for this theme."
msgstr "이 테마의 이름을 입력합니다."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "{minimum}에서 {maximum} 사이의 초 단위 값을 입력하세요."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "1에서 65535 사이의 포트를 입력하세요."
@@ -5542,6 +5578,10 @@ msgstr "유효한 URL 입력, 예: https://api.openai.com/v1"
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "유효한 URL을 입력하세요. 예: https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "{minimum}에서 {maximum} 사이의 정수를 입력하세요."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "터널이 제공하는 공개 오리진을 입력하세요. 예: https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "첨부 파일 위치를 업데이트하지 못했습니다: {detail}"
msgid "Failed to update markdownlint rules"
msgstr "markdownlint 규칙을 업데이트하지 못했습니다"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "성능 설정을 업데이트하지 못했습니다: {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "OpenKnowledge가 어떠신가요?"
msgid "How does sharing work?"
msgstr "공유는 어떻게 작동하나요?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "색인 생성 중 OpenKnowledge가 각 임베딩 요청을 기다리는 시간입니다. 검색 요청의 시간 제한은 시도당 8초로 고정되어 있으며 이 설정의 영향을 받지 않습니다."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "프로젝트 로컬 문서, 파일, 이미지의 누락을 Problems, 편집기 진단, 감사, 에이전트 도구에서 보고하는 방식을 설정합니다."
@@ -7113,9 +7161,9 @@ msgstr "프로젝트 설정을 저장하지 못해 인덱스 유지 관리가
msgid "Indexed {embedded} of {total} pages."
msgstr "인덱싱됨: {embedded}/{total}페이지"
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "페이지를 색인하는 중입니다. 준비된 결과: {semanticIndexedCount}/{semanticTotalCount}. 결과가 불완전할 수 있습니다."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "인덱싱 요청 시간 제한(초)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "밝은 테마"
msgid "Light, dark, or follow the OS."
msgstr "밝은 테마, 어두운 테마 또는 운영 체제 설정을 따릅니다."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "각 요청에 담기는 전체 텍스트 양을 제한합니다. 예산보다 큰 청크는 단독으로 전송되며, 문서를 다시 분할하지는 않습니다."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "줄 {displayLine}"
@@ -7989,6 +8041,10 @@ msgstr "<0>{lookingForUrl}</0> 찾는 중입니다."
msgid "Lost connection to \"{docName}\"."
msgstr "\"{docName}\" 연결이 끊겼습니다."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "이 값을 낮추면 요청당 메모리 사용량과 작업량이 줄어듭니다. 배치가 작을수록 요청 수가 늘어 전체 인덱싱이 느려질 수 있습니다."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "모든 폴더에서 생성된 인덱스를 유지하시겠습니까?"
@@ -8099,6 +8155,10 @@ msgstr "첨부 파일 최대 {MAX_ATTACHMENTS}개"
msgid "Maximum agents already running"
msgstr "에이전트 최대 실행 수 도달"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "인덱싱 요청당 최대 텍스트 청크 수"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP 자동 복구 실패"
@@ -8186,6 +8246,10 @@ msgstr "누락된 페이지, 클릭하여 만들기"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "누락된 페이지: {linkTitle}. 클릭하여 만듭니다."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "검색할 때 아직 인덱싱되지 않은 페이지를 인덱싱합니다. 더 많은 결과를 보려면 다시 검색하세요."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "팔레트 색상 누락"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "검색에 필요할 때 페이지를 처음 임베딩합니다."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "인덱싱된 페이지: {semanticTotalCount}개 중 {semanticIndexedCount}개."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "아래로 이동"
@@ -10210,6 +10278,11 @@ msgstr "대기 중"
msgid "Percolating…"
msgstr "전파 중…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "성능"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "<0>{targetGitPath}</0>과 모든 git 기록을 영구 삭제합니다. 작업 파일은 그대로 유지됩니다. 상위 git 리포지토리가 의도한 것이라면(예: 클론한 경우) 취소하고 그 밖의 위치를 선택하세요."
@@ -11309,6 +11382,11 @@ msgstr "저장소를 찾을 수 없습니다 — 존재하지 않거나, 사용
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "저장소 검색 실패. 이름 변경, 삭제 또는 이동됐을 수 있습니다."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "요청"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "필수"
@@ -11662,6 +11740,7 @@ msgstr "이 댓글 저장 (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "저장됨"
@@ -14329,6 +14408,11 @@ msgstr "정리 중…"
msgid "Timeline"
msgstr "타임라인"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "시간 제한"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "파일을 열지 않고 lint 또는 링크 문제가 있는 파일에 색조와 배지를 적용합니다."
diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.json
index e5ebfead9..13cec855a 100644
--- a/packages/app/src/locales/pseudo/messages.json
+++ b/packages/app/src/locales/pseudo/messages.json
@@ -127,6 +127,7 @@
"0jD-Gn": ["À ţēàḿ ķńōŵĺēďĝē ƀàśē, à ƥēŕśōńàĺ ŵĩķĩ, ƥŕōĴēćţ ďōćś..."],
"0kTAXe": ["Ōƥēń śōũŕćē: ", ["mirrorSrc"]],
"0m4Snh": ["Śķĩĺĺś ŕēàśśĩĝńēď"],
+ "0mlCvF": ["ćĥàŕàćţēŕś"],
"0niWj3": [
["removingCount", "plural", { "one": ["#", " ŕēḿōvēď"], "other": ["#", " ŕēḿōvēď"] }]
],
@@ -366,6 +367,7 @@
"3zDeFb": ["Ŕũḿĩńàţĩńĝ…"],
"3zyg_A": ["Ĩĝńōŕē ƥàţţēŕńś"],
"4-Phgi": ["Śĥōŵ ōŕ ĥĩďē àĝēńţś"],
+ "42QMZH": ["ŕēǫũēśţś"],
"438Fca": ["Ćĺōńēď śũććēśśƒũĺĺŷ, ƀũţ ćōũĺď ńōţ ōƥēń ţĥē ƥŕōĴēćţ."],
"43qzxu": ["ĎēvŌƥś"],
"44DSl0": [
@@ -850,6 +852,9 @@
"9tJX8r": ["ßŷ ḿēàńĩńĝ"],
"9uI_rE": ["Ũńďō"],
"9uRLEH": ["Ćōũĺďń'ţ ōƥēń \"", ["name"], "\" — ĩţ ĩśń'ţ ĩń ţĥē ƥŕōĴēćţ'ś śķĩĺĺś ŷēţ."],
+ "9wIf0H": [
+ "Ĺōŵēŕ ţĥĩś ţō ŕēďũćē ḿēḿōŕŷ ũśē àńď ŵōŕķ ƥēŕ ŕēǫũēśţ. Śḿàĺĺēŕ ƀàţćĥēś śēńď ḿōŕē ŕēǫũēśţś àńď ḿàŷ ḿàķē ĩńďēxĩńĝ śĺōŵēŕ ōvēŕàĺĺ."
+ ],
"9wQrUU": ["Ŕēƒàćţōŕĩńĝ"],
"9x-lMu": ["Ĩń ţĥĩś ŕēƥō — ćōĺĺàƀōŕàţōŕś ĝēţ ćōƥĩēś vĩà ĝĩţ."],
"9xCnv8": ["Ĥĩďē Ţēŕḿĩńàĺ"],
@@ -891,6 +896,7 @@
"AUV-TY": ["Ţĥĩńķĩńĝ"],
"AVW-K9": ["Ƒàĩĺēď ţō ĺōàď ōŕƥĥàń ƥàĝēś"],
"AWOSPo": ["Źōōḿ ĩń"],
+ "AXMOeM": ["ƥēŕƒōŕḿàńćē"],
"AYoYhU": ["Ũƥďàţē ƒàĩĺēď: ", ["0"]],
"AaC-CE": ["Ēḿƥţŷ ƀōàŕď"],
"AcK_r0": ["Ćĺàũďē ĆĹĨ"],
@@ -978,6 +984,7 @@
"Bdha5y": ["Ƥũƀĺĩśĥĩńĝ..."],
"BeWTQy": ["Ĺōàďĩńĝ śţàŕţēŕ ƥàćķś"],
"BgV29F": ["Vĩśũàĺ ēďĩţōŕ ƒĩńď ĩńƥũţ ƒōćũśēď"],
+ "Bgaa_U": ["Ƒàĩĺēď ţō ũƥďàţē ƥēŕƒōŕḿàńćē śēţţĩńĝ — ", ["detail"]],
"BhLPRk": ["Ŕēvēŕţēď \"", ["name"], "\" ţō ţĥē ĩńśţàĺĺēď vēŕśĩōń"],
"BjitBo": ["Ďōŵńĺōàď ", ["0"]],
"BkGtRl": [
@@ -1049,6 +1056,7 @@
"CbxTfe": ["Śēĺēćţ ƀĺōćķ"],
"CcaU4i": ["Ēďĩţś àƥƥĺŷ ĺĩvē àńď śàvē àũţōḿàţĩćàĺĺŷ ţō ţĥĩś ţĥēḿē."],
"ChMshD": ["Ǫũĩţ ", ["appName"]],
+ "ChdabN": ["Ćĺēàŕ à ƒĩēĺď ţō ŕēśţōŕē ĩţś ďēƒàũĺţ vàĺũē."],
"Ck9XRt": ["Ćōũĺďń'ţ śàvē ţĥē ķēŷ — ƥĺēàśē ţŕŷ àĝàĩń."],
"ClII5l": ["Ƥŕēśś ţĥē śũń ōŕ ḿōōń ōń “Ćũśţōḿ” àƀōvē ţō ũśē ţĥĩś ţĥēḿē."],
"ClTEde": ["Śţàĝē ţĥē śēĺēćţēď ƥàśśàĝē ĩń ţĥē àĝēńţś ƥàńēĺ, ŕēàďŷ ţō ēxţēńď àńď śēńď."],
@@ -1322,6 +1330,7 @@
"FgQ7XZ": ["Ćōũĺďń'ţ ĺōàď ŷōũŕ ƀũĝ ŕēƥōŕţś."],
"FgRAvd": ["Ĺōĝś & śŷśţēḿ ĩńƒō"],
"Fhp4Gn": ["Vĩēŵ ƥĺũĝĩń"],
+ "Fim5F3": ["ēḿƀēďďĩńĝś"],
"FiyNln": ["ĵũḿƥ ţō śēĺēćţēď ţēxţ ĩń ƥŕōƥēŕţŷ"],
"FjkaiT": ["Źōōḿ ōũţ"],
"Fjz6aJ": ["Śēńď ţō à ńēŵ ćĥàţ"],
@@ -1731,6 +1740,7 @@
"L4Cdd9": ["ōŕ ćŕēàţē à ńēŵ ƒĩĺē <0/>"],
"L6Hhh6": ["(ŕōōţ)"],
"L6Ud-t": ["Ćōũĺďń'ţ ĺōàď ćōńƒĺĩćţś — ŕēĺōàď ţō ŕēţŕŷ."],
+ "L7NFTZ": ["Ēńţēŕ à ńũḿƀēŕ ōƒ śēćōńďś ƀēţŵēēń ", ["minimum"], " àńď ", ["maximum"], "."],
"L83DKQ": ["ƤÀŢĤ ĩńśţàĺĺ ƒàĩĺēď: ", ["summary"]],
"L8fKuc": ["Ŕũń ţĥĩś ĩń ŷōũŕ ţēŕḿĩńàĺ"],
"L9Y9Om": ["Ţōƥ ĺĩńķēď ƥàĝēś"],
@@ -2187,6 +2197,7 @@
"QQbwzK": ["Ńō àĝēńţś àvàĩĺàƀĺē."],
"QQghPu": ["Ĩńśţàĺĺ ĩń Ćĺàũďē Ďēśķţōƥ"],
"QR5SP1": ["ćŕēàţēď ţēḿƥĺàţē"],
+ "QRSdsO": ["Ĩńďēxĩńĝ ŕēǫũēśţ ţĩḿēōũţ (śēćōńďś)"],
"QVk3SK": ["Ţĥĩś ƒĩĺē ŵàś ďēĺēţēď ōń ţĥē ĩńćōḿĩńĝ ƀŕàńćĥ (ḿōďĩƒŷ-ďēĺēţē ćōńƒĺĩćţ)."],
"QWdKwH": ["Ḿōvē"],
"QYTOaN": ["Ŷōũ ćàń ćĥàńĝē ţĥĩś ĺàţēŕ ĩń <0>Śēţţĩńĝś → Śŷńć</0>."],
@@ -2255,6 +2266,7 @@
"RGCCrg": ["Ćōƥŷ śĥàŕē ĺĩńķ"],
"RGkNeJ": ["Ĩńĩţĩàĺĩźē à śţàŕţēŕ ƥàćķ"],
"RGptDW": ["ŌƥēńĶńōŵĺēďĝē ḿōvēď à ďōćũḿēńţ"],
+ "RH0e_f": ["ţĩḿēōũţ"],
"RJ3a8Z": ["Ĺōōķĩńĝ ƒōŕ <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"Ƒŕōḿ ţĥē ",
@@ -2716,6 +2728,9 @@
"XYZ7tp": ["Ũńŕēśōĺvàƀĺē"],
"XYlJJT": ["Śēţţĩńĝ ũƥ"],
"XZkdtg": ["Śŵĩţćĥ ƀŕàńćĥ"],
+ "Xafwko": [
+ "Ĺĩḿĩţś ţĥē ćōḿƀĩńēď ţēxţ śēńţ ĩń ēàćĥ ŕēǫũēśţ. À śĩńĝĺē ĺàŕĝēŕ ćĥũńķ ĩś śēńţ ōń ĩţś ōŵń; ďōćũḿēńţś àŕē ńōţ śƥĺĩţ àĝàĩń."
+ ],
"XcGbim": ["Śĥōŵ ĥĩďďēń ƒĩĺēś"],
"Xet9MX": ["Ƒàĩĺēď ţō ĺōàď ƀàćķĺĩńķś"],
"Xewl6B": ["Ŷōũŕ ĺōćàĺ ćōƥŷ ĩś ƀēĥĩńď. Ƥũĺĺ ţĥē ĺàţēśţ ćĥàńĝēś, ţĥēń ōƥēń ţĥē ĺĩńķ àĝàĩń."],
@@ -3189,6 +3204,7 @@
"cRm498": ["Ńō śćĥēḿà ƒĩĺēś ĩń ţĥĩś ƥŕōĴēćţ ŷēţ — ćŕēàţē ōńē ţō śţàŕţ vàĺĩďàţĩńĝ."],
"cSCbv3": ["ßĒŢÀ"],
"cT_pW4": ["Ćōĺĺàƥśĩƀĺē ćōńţēńţ ƀĺōćķ (Ńōţĩōń-śţŷĺē ţōĝĝĺē)."],
+ "cTrVa1": ["Ēḿƀēďďĩńĝ ŕēǫũēśţ śēţţĩńĝś"],
"cU-seF": [
"ĵũḿƥ ţō ţĥē ḿàŕķďōŵń śōũŕćē ƒōŕ ţĥē ƀĺōćķ àţ ţĥē ćũŕśōŕ, ćēńţēŕēď àńď ĥĩĝĥĺĩĝĥţēď."
],
@@ -3380,6 +3396,7 @@
"eGUbmF": ["Ćōƥŷ śēĺēćţēď ƒĩĺē ōŕ ƒōĺďēŕ"],
"eJitUk": ["Ũƥĺōàď ƒŕōḿ ćōḿƥũţēŕ"],
"eKThTQ": ["Ƒàĩĺēď ţō ŕēōŕďēŕ"],
+ "eMWRAs": ["Ƥàĝēś ĩńďēxēď: ", ["semanticIndexedCount"], " ōƒ ", ["semanticTotalCount"], "."],
"eNOyTV": [
"Ŷōũ ďōń'ţ ĥàvē ƥēŕḿĩśśĩōń ţō ƥũśĥ ţō ţĥĩś ŕēƥō. Àũţō (Ƥũĺĺ ōńĺŷ) ćàń śţĩĺĺ ķēēƥ ŷōũŕ ćōƥŷ ũƥ ţō ďàţē."
],
@@ -3651,6 +3668,9 @@
"gyHDWC": ["Ƒĩx àĺĺ ŵĩţĥ ÀĨ (", ["count"], ")"],
"gyYvCN": ["Ƥũśĥ ḿŷ ēďĩţś ēvēŕŷ"],
"h-AdvS": ["Ţĥē ƒōĺďēŕś àńď ţēḿƥĺàţēś àŕē àĺŕēàďŷ ĥēŕē, śō ţĥēŕē'ś ńōţĥĩńĝ ţō àďď."],
+ "h-RPqa": [
+ "Ĥōŵ ĺōńĝ ŌƥēńĶńōŵĺēďĝē ŵàĩţś ƒōŕ ēàćĥ ēḿƀēďďĩńĝ ŕēǫũēśţ ŵĥĩĺē ĩńďēxĩńĝ. Śēàŕćĥ ŕēǫũēśţś ũśē à ƒĩxēď 8-śēćōńď ţĩḿēōũţ ƥēŕ àţţēḿƥţ, ũńćĥàńĝēď ƀŷ ţĥĩś śēţţĩńĝ."
+ ],
"h06R3C": ["Ńō ƥàĝēś àŕē ḿĩśśĩńĝ ōũţĝōĩńĝ ĝŕàƥĥ ĺĩńķś."],
"h16FyT": ["Ĺĩśţś"],
"h2N-1n": ["Ĩńśţàĺĺēď ĩń ", ["0"]],
@@ -3888,6 +3908,7 @@
"jTLWxh": ["Ēḿƀēď àń ēxţēŕńàĺ ƥàĝē ĩń àń ĩńĺĩńē ĩƒŕàḿē (ďōćś, ďēḿōś, Ƒĩĝḿà, ĆōďēŚàńďƀōx)."],
"jTUxaN": ["Ēńàƀĺē Àũţō (Ƥũĺĺ ōńĺŷ)"],
"jTdrn1": ["Ćōũĺďń'ţ ćĥēćķ ŵĥēţĥēŕ ", ["filePath"], " ĩś śţĩĺĺ ćōńƒĺĩćţēď — ŕēţŕŷĩńĝ."],
+ "jWwQo6": ["ƀàţćĥ"],
"jWzDfC": ["Ćĥēćķĩńĝ ŵĥĩćĥ ÀĨ ţōōĺś ŷōũ ĥàvē"],
"jZ_E5M": ["Ƒēţćĥ ƒàĩĺēď — ćĥēćķ ţĥē śēŕvēŕ ĺōĝś ƒōŕ ďēţàĩĺś."],
"j_Z6g7": ["Śĥàŕēď ďēƒàũĺţ"],
@@ -3945,13 +3966,6 @@
"</0> — ḿōśţ ĺōćàĺ śēŕvēŕś ĩĝńōŕē ĩţ. Àďď ōńē ōńĺŷ ĩƒ ŷōũŕś ńēēďś ĩţ."
],
"kBNHN1": ["Ńàvĩĝàţĩōń ĥĩśţōŕŷ"],
- "kCNU4q": [
- "Ĩńďēxĩńĝ ŷōũŕ ƥàĝēś — ",
- ["semanticIndexedCount"],
- " ōƒ ",
- ["semanticTotalCount"],
- " ŕēàďŷ. Ŕēśũĺţś ḿàŷ ƀē ĩńćōḿƥĺēţē."
- ],
"kCjkGY": ["Ţĥĩś ḿàŷ ţàķē à ḿōḿēńţ. Ŷōũŕ ḿàŕķďōŵń ćōńţēńţ ĩś ķēƥţ."],
"kCqCyf": ["Ōƥēń ĆōďēḾĩŕŕōŕ'ś ĺĩńţ ďĩàĝńōśţĩćś ƥàńēĺ."],
"kEiVv6": [
@@ -3984,6 +3998,7 @@
"Ƥōĩńţ śēḿàńţĩć śēàŕćĥ àţ àńŷ ŌƥēńÀĨ-ćōḿƥàţĩƀĺē ēḿƀēďďĩńĝś ēńďƥōĩńţ — à śēĺƒ-ĥōśţēď śēŕvēŕ ōŕ àńōţĥēŕ ƥŕōvĩďēŕ. Ţĥē ÀƤĨ ķēŷ àƀōvē ĩś ƒōŕ ŵĥĩćĥēvēŕ ēńďƥōĩńţ ŷōũ śēţ ĥēŕē."
],
"kSiB3X": ["Ćōũĺďń'ţ ḿōvē ţō ", ["trashNoun"]],
+ "kUgGPO": ["Ćĥàŕàćţēŕ ƀũďĝēţ ƥēŕ ĩńďēxĩńĝ ŕēǫũēśţ"],
"kV2YZv": [
"Ďōń'ţ śēē <0>Śķĩĺĺś</0>? Ēńàƀĺē <1>Śēţţĩńĝś <2/> Ćàƥàƀĩĺĩţĩēś <3/> Ćōďē ēxēćũţĩōń àńď ƒĩĺē ćŕēàţĩōń</1> ƒĩŕśţ."
],
@@ -4467,6 +4482,7 @@
"q3W2nd": ["Ćōũĺďń'ţ àďď ţĥàţ ćōḿḿēńţ: ", ["0"]],
"q4YJl_": ["Ţĥē ţēŕḿĩńàĺ śēśśĩōń ēńďēď (ēxĩţ ćōďē ", ["0"], ")."],
"q4efaG": [["filePath"], " ĩś ńō ĺōńĝēŕ ĩń ţĥĩś śķĩĺĺ"],
+ "q5uZbJ": ["Ḿĩśśĩńĝ ƥàĝēś àŕē ĩńďēxēď ŵĥēń ŷōũ śēàŕćĥ. Śēàŕćĥ àĝàĩń ƒōŕ ƒũĺĺēŕ ŕēśũĺţś."],
"q6-JVU": ["Ĺōàďĩńĝ ƥàĝēś"],
"q63KUv": ["Àďď ḾĆƤ & śķĩĺĺ"],
"q7F5am": ["ţĩţĺē"],
@@ -4922,6 +4938,9 @@
"uoJF_D": ["Ĩţ ŵàś ţōō ĥàŕď ţō śēţ ũƥ ōŕ ĝēţ śţàŕţēď"],
"ur2XSb": ["Vĩśũàĺ ēďĩţōŕ"],
"uuoHOU": ["Ćōḿḿàńď ƒàĩĺēď."],
+ "uwzRx4": [
+ "ÀďĴũśţ ĩńďēxĩńĝ ŕēǫũēśţ śĩźē àńď ţĩḿēōũţ ƒōŕ śĺōŵ ōŕ ḿēḿōŕŷ-ćōńśţŕàĩńēď ēḿƀēďďĩńĝ śēŕvēŕś. Ḿōśţ śēţũƥś śĥōũĺď ķēēƥ ţĥē ďēƒàũĺţś."
+ ],
"uyJsf6": ["Àƀōũţ"],
"uyOQ4e": ["Ţĥēḿē ćōƥĩēď àś ƀàśē16 ŶÀḾĹ"],
"uynXup": [["tokens", "plural", { "one": ["ţōķēń"], "other": ["ţōķēńś"] }]],
@@ -5302,11 +5321,13 @@
"zbymaY": [["0"], "ḿ àĝō"],
"zd00pH": ["Ćōƥŷ Ƥàţĥ"],
"zgSFyG": ["Ēxţēŕńàĺ ĺĩńķ"],
+ "zkkEFa": ["Ēńţēŕ à ŵĥōĺē ńũḿƀēŕ ƀēţŵēēń ", ["minimum"], " àńď ", ["maximum"], "."],
"zkz0Fg": ["Śēţ ũƥ śŷńćĩńĝ"],
"zlErBl": ["Ƥàĝē ĥēàďĩńĝś ēŕŕōŕ ŕēśƥōńśē ďĩď ńōţ ḿàţćĥ ŔƑĆ 9457"],
"zo3Dl7": ["Ţōĝĝĺē ţĥũḿƀńàĩĺś"],
"zpfN9p": ["Ńō ćōḿḿēńţś ŷēţ. Śēĺēćţ ţēxţ ĩń ţĥē ďōćũḿēńţ ţō àďď ōńē."],
"zq2eBA": ["Vĩēŵ ĩń śōũŕćē"],
+ "zqQlBg": ["Ḿàxĩḿũḿ ţēxţ ćĥũńķś ƥēŕ ĩńďēxĩńĝ ŕēǫũēśţ"],
"zrP8HX": [
"Ƒŕōńţḿàţţēŕ ēvēŕŷ ďōćũḿēńţ ćŕēàţēď ƒŕōḿ ţĥĩś ţēḿƥĺàţē śţàŕţś ŵĩţĥ. Vàĺũēś àŕē ŶÀḾĹ — à ĺĩśţ ĩś <0>[à, ƀ]</0>; <1>{",
["date"],
diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.po
index 869f391e3..91fb73323 100644
--- a/packages/app/src/locales/pseudo/messages.po
+++ b/packages/app/src/locales/pseudo/messages.po
@@ -1726,6 +1726,10 @@ msgstr ""
msgid "Adds these folders"
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr ""
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2287,6 +2291,11 @@ msgstr ""
msgid "Base branch"
msgstr ""
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr ""
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr ""
@@ -2633,6 +2642,15 @@ msgstr ""
msgid "Changes saved automatically."
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr ""
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr ""
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr ""
@@ -2832,6 +2850,10 @@ msgstr ""
msgid "Clear {keyName}"
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr ""
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr ""
@@ -5340,6 +5362,16 @@ msgstr ""
msgid "Embed an image with optional alt text."
msgstr ""
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr ""
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr ""
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr ""
@@ -5506,6 +5538,10 @@ msgstr ""
msgid "Enter a name for this theme."
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr ""
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr ""
@@ -5538,6 +5574,10 @@ msgstr ""
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr ""
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr ""
@@ -6005,6 +6045,10 @@ msgstr ""
msgid "Failed to update markdownlint rules"
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr ""
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6841,6 +6885,10 @@ msgstr ""
msgid "How does sharing work?"
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr ""
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr ""
@@ -7109,8 +7157,8 @@ msgstr ""
msgid "Indexed {embedded} of {total} pages."
msgstr ""
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
msgstr ""
#: src/components/FrontmatterRow.tsx
@@ -7664,6 +7712,10 @@ msgstr ""
msgid "Light, dark, or follow the OS."
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr ""
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr ""
@@ -7985,6 +8037,10 @@ msgstr ""
msgid "Lost connection to \"{docName}\"."
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr ""
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr ""
@@ -8095,6 +8151,10 @@ msgstr ""
msgid "Maximum agents already running"
msgstr ""
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr ""
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr ""
@@ -8182,6 +8242,10 @@ msgstr ""
msgid "Missing page: {linkTitle}. Click to create."
msgstr ""
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr ""
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr ""
@@ -10062,6 +10126,10 @@ msgstr ""
msgid "Pages are embedded the first time a search needs them."
msgstr ""
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr ""
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr ""
@@ -10206,6 +10274,11 @@ msgstr ""
msgid "Percolating…"
msgstr ""
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr ""
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr ""
@@ -11305,6 +11378,11 @@ msgstr ""
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr ""
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr ""
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr ""
@@ -11658,6 +11736,7 @@ msgstr ""
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr ""
@@ -14325,6 +14404,11 @@ msgstr ""
msgid "Timeline"
msgstr ""
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr ""
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr ""
diff --git a/packages/app/src/locales/pt-BR/messages.json b/packages/app/src/locales/pt-BR/messages.json
index 4fda86d2e..7264a890c 100644
--- a/packages/app/src/locales/pt-BR/messages.json
+++ b/packages/app/src/locales/pt-BR/messages.json
@@ -153,6 +153,7 @@
"0jD-Gn": ["Uma base de conhecimento de equipe, uma wiki pessoal, documentação de projeto..."],
"0kTAXe": ["Abrir a fonte: ", ["mirrorSrc"]],
"0m4Snh": ["Habilidades reatribuídas"],
+ "0mlCvF": ["caracteres"],
"0niWj3": [
[
"removingCount",
@@ -431,6 +432,7 @@
"3zDeFb": ["Remoendo…"],
"3zyg_A": ["Padrões de exclusão"],
"4-Phgi": ["Mostrar ou ocultar os agentes"],
+ "42QMZH": ["solicitações"],
"438Fca": ["Clonado com sucesso, mas não foi possível abrir o projeto."],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -1001,6 +1003,9 @@
["name"],
"\" — ela ainda não está entre as habilidades do projeto."
],
+ "9wIf0H": [
+ "Reduza este valor para diminuir o uso de memória e o trabalho por requisição. Lotes menores enviam mais requisições e podem deixar a indexação mais lenta no geral."
+ ],
"9wQrUU": ["Refatoração"],
"9x-lMu": ["Neste repositório — colaboradores recebem cópias via git."],
"9xCnv8": ["Ocultar o Terminal"],
@@ -1048,6 +1053,7 @@
"AUV-TY": ["Pensando"],
"AVW-K9": ["Falha ao carregar as páginas órfãs"],
"AWOSPo": ["Aproximar"],
+ "AXMOeM": ["desempenho"],
"AYoYhU": ["Falha na atualização: ", ["0"]],
"AaC-CE": ["Quadro vazio"],
"AcK_r0": ["Claude CLI"],
@@ -1145,6 +1151,7 @@
"Bdha5y": ["Publicando..."],
"BeWTQy": ["Carregando pacotes iniciais"],
"BgV29F": ["Campo de busca do editor visual em foco"],
+ "Bgaa_U": ["Falha ao atualizar a configuração de desempenho — ", ["detail"]],
"BhLPRk": ["\"", ["name"], "\" revertido para a versão instalada"],
"BjitBo": ["Baixar ", ["0"]],
"BkGtRl": [
@@ -1230,6 +1237,7 @@
"CbxTfe": ["Selecionar bloco"],
"CcaU4i": ["As alterações são aplicadas imediatamente e salvas automaticamente neste tema."],
"ChMshD": ["Encerrar o ", ["appName"]],
+ "ChdabN": ["Limpe um campo para restaurar seu valor padrão."],
"Ck9XRt": ["Não deu para salvar a chave — tente de novo."],
"ClII5l": ["Pressione o sol ou a lua em “Custom” acima para usar este tema."],
"ClTEde": [
@@ -1525,6 +1533,7 @@
"FgQ7XZ": ["Não foi possível carregar seus relatórios de erro."],
"FgRAvd": ["Logs e informações do sistema"],
"Fhp4Gn": ["Ver o plugin"],
+ "Fim5F3": ["embeddings"],
"FiyNln": ["Ir para o texto selecionado na propriedade"],
"FjkaiT": ["Afastar"],
"Fjz6aJ": ["Enviar para um novo chat"],
@@ -2002,6 +2011,7 @@
"L4Cdd9": ["ou crie um novo arquivo <0/>"],
"L6Hhh6": ["(raiz)"],
"L6Ud-t": ["Não foi possível carregar os conflitos. Recarregue para tentar de novo."],
+ "L7NFTZ": ["Insira um número de segundos entre ", ["minimum"], " e ", ["maximum"], "."],
"L83DKQ": ["A instalação no PATH falhou: ", ["summary"]],
"L8fKuc": ["Rode isto no seu terminal"],
"L9Y9Om": ["Páginas mais ligadas"],
@@ -2500,6 +2510,7 @@
"QQbwzK": ["Nenhum agente disponível."],
"QQghPu": ["Instalar no Claude Desktop"],
"QR5SP1": ["modelo criado"],
+ "QRSdsO": ["Tempo limite da requisição de indexação (segundos)"],
"QVk3SK": ["Este arquivo foi excluído no ramo recebido (conflito modify-delete)."],
"QWdKwH": ["Mover"],
"QYTOaN": ["Você pode mudar isto depois em <0>Configurações → Sincronização</0>."],
@@ -2573,6 +2584,7 @@
"RGCCrg": ["Copiar link de compartilhamento"],
"RGkNeJ": ["Inicializar um pacote inicial"],
"RGptDW": ["OpenKnowledge moveu um documento"],
+ "RH0e_f": ["tempo limite"],
"RJ3a8Z": ["Procurando <0>", ["lookingForUrl"], "</0>."],
"RJMO4B": [
"Do plugin ",
@@ -3123,6 +3135,9 @@
"XYZ7tp": ["Não resolvido"],
"XYlJJT": ["Configurando"],
"XZkdtg": ["Trocar de ramo"],
+ "Xafwko": [
+ "Limita o texto combinado enviado em cada requisição. Um fragmento maior é enviado sozinho; os documentos não são divididos novamente."
+ ],
"XcGbim": ["Mostrar os arquivos ocultos"],
"Xet9MX": ["Falha ao carregar os retrolinks"],
"Xewl6B": ["Sua cópia local está atrasada. Traga as últimas alterações e abra o link de novo."],
@@ -3639,6 +3654,7 @@
"cRm498": ["Ainda não há arquivos de esquema neste projeto — crie um para começar a validar."],
"cSCbv3": ["BETA"],
"cT_pW4": ["Bloco de conteúdo recolhível (alternador no estilo Notion)."],
+ "cTrVa1": ["Configurações das requisições de embeddings"],
"cU-seF": ["Ir para o código markdown do bloco onde está o cursor, centralizado e destacado."],
"cUK8lW": [
[
@@ -3867,6 +3883,13 @@
"eGUbmF": ["Copiar o arquivo ou a pasta selecionados"],
"eJitUk": ["Enviar do computador"],
"eKThTQ": ["Falha ao reordenar"],
+ "eMWRAs": [
+ "Páginas indexadas: ",
+ ["semanticIndexedCount"],
+ " de ",
+ ["semanticTotalCount"],
+ "."
+ ],
"eNOyTV": [
"Você não tem permissão para fazer push neste repositório. Automático (somente Pull) ainda pode manter sua cópia atualizada."
],
@@ -4172,6 +4195,9 @@
"gyHDWC": ["Corrigir tudo com IA (", ["count"], ")"],
"gyYvCN": ["Enviar minhas edições a cada"],
"h-AdvS": ["As pastas e os modelos já estão aqui, então não há nada a acrescentar."],
+ "h-RPqa": [
+ "Quanto tempo o OpenKnowledge aguarda cada solicitação de embedding durante a indexação. As solicitações de pesquisa têm um tempo limite fixo de 8 segundos por tentativa, que não é alterado por esta configuração."
+ ],
"h06R3C": ["Nenhuma página está sem links de saída no grafo."],
"h16FyT": ["Listas"],
"h2N-1n": ["Instalado em ", ["0"]],
@@ -4431,6 +4457,7 @@
["filePath"],
" ainda está em conflito — tentando novamente."
],
+ "jWwQo6": ["lote"],
"jWzDfC": ["Verificando quais ferramentas de IA você tem"],
"jZ_E5M": ["Falha ao buscar — veja os logs do servidor para os detalhes."],
"j_Z6g7": ["Padrão compartilhado"],
@@ -4488,13 +4515,6 @@
"</0> — a maioria dos servidores locais ignora. Adicione uma só se o seu precisar."
],
"kBNHN1": ["Histórico de navegação"],
- "kCNU4q": [
- "Indexando suas páginas — ",
- ["semanticIndexedCount"],
- " de ",
- ["semanticTotalCount"],
- " prontas. Os resultados podem estar incompletos."
- ],
"kCjkGY": ["Isto pode demorar um pouco. Seu conteúdo markdown é preservado."],
"kCqCyf": ["Abre o painel de diagnósticos de análise do CodeMirror."],
"kEiVv6": [
@@ -4527,6 +4547,7 @@
"Aponte a busca semântica para qualquer endpoint de embeddings compatível com a OpenAI — um servidor próprio ou outro provedor. A chave de API acima vale para o endpoint que você definir aqui."
],
"kSiB3X": ["Não foi possível mover para ", ["trashNoun"]],
+ "kUgGPO": ["Orçamento de caracteres por requisição de indexação"],
"kV2YZv": [
"Não vê <0>Habilidades</0>? Ative antes <1>Configurações <2/> Recursos <3/> Execução de código e criação de arquivos</1>."
],
@@ -5054,6 +5075,9 @@
"q3W2nd": ["Não deu para adicionar esse comentário: ", ["0"]],
"q4YJl_": ["A sessão de terminal terminou (código de saída ", ["0"], ")."],
"q4efaG": [["filePath"], " não está mais nesta skill"],
+ "q5uZbJ": [
+ "As páginas restantes são indexadas ao pesquisar. Pesquise novamente para obter resultados mais completos."
+ ],
"q6-JVU": ["Carregando páginas"],
"q63KUv": ["Adicionar MCP e habilidade"],
"q7F5am": ["título"],
@@ -5558,6 +5582,9 @@
"uoJF_D": ["Foi difícil demais configurar ou começar"],
"ur2XSb": ["Editor visual"],
"uuoHOU": ["O comando falhou."],
+ "uwzRx4": [
+ "Ajuste o tamanho e o tempo limite das requisições de indexação para servidores de embeddings lentos ou com pouca memória. A maioria das configurações deve manter os valores padrão."
+ ],
"uyJsf6": ["Sobre"],
"uyOQ4e": ["Tema copiado como YAML base16"],
"uynXup": [["tokens", "plural", { "one": ["token"], "many": ["tokens"], "other": ["tokens"] }]],
@@ -5998,11 +6025,13 @@
"zbymaY": ["há ", ["0"], " min"],
"zd00pH": ["Copiar caminho"],
"zgSFyG": ["Link externo"],
+ "zkkEFa": ["Insira um número inteiro entre ", ["minimum"], " e ", ["maximum"], "."],
"zkz0Fg": ["Configurar a sincronização"],
"zlErBl": ["A resposta de erro dos títulos da página não seguiu a RFC 9457"],
"zo3Dl7": ["Mostrar ou ocultar as miniaturas"],
"zpfN9p": ["Ainda não há comentários. Selecione um texto no documento para adicionar um."],
"zq2eBA": ["Ver no código"],
+ "zqQlBg": ["Máximo de fragmentos de texto por requisição de indexação"],
"zrP8HX": [
"O frontmatter com que começa cada documento criado a partir deste modelo. Os valores são YAML — uma lista é <0>[a, b]</0>; <1>{",
["date"],
diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.po
index 6e34c771c..b46ceb1b1 100644
--- a/packages/app/src/locales/pt-BR/messages.po
+++ b/packages/app/src/locales/pt-BR/messages.po
@@ -1726,6 +1726,10 @@ msgstr "Adiciona estes arquivos"
msgid "Adds these folders"
msgstr "Adiciona estas pastas"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "Ajuste o tamanho e o tempo limite das requisições de indexação para servidores de embeddings lentos ou com pouca memória. A maioria das configurações deve manter os valores padrão."
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2287,6 +2291,11 @@ msgstr "A resposta de retrolinks não tinha o formato esperado."
msgid "Base branch"
msgstr "Ramo base"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "lote"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "vira um link simbólico"
@@ -2633,6 +2642,15 @@ msgstr "As alterações são salvas automaticamente."
msgid "Changes saved automatically."
msgstr "Alterações salvas automaticamente."
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "Orçamento de caracteres por requisição de indexação"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "caracteres"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "Buscar atualizações"
@@ -2832,6 +2850,10 @@ msgstr "Limpar"
msgid "Clear {keyName}"
msgstr "Limpar {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "Limpe um campo para restaurar seu valor padrão."
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "Limpar cor"
@@ -5340,6 +5362,16 @@ msgstr "Incorpora uma página externa em um iframe embutido (documentação, dem
msgid "Embed an image with optional alt text."
msgstr "Incorpora uma imagem com texto alternativo opcional."
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "Configurações das requisições de embeddings"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "embeddings"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "Chave de API de embeddings"
@@ -5506,6 +5538,10 @@ msgstr "Digite um nome de pasta (ex.: cerebro)."
msgid "Enter a name for this theme."
msgstr "Insira um nome para este tema."
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "Insira um número de segundos entre {minimum} e {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "Digite uma porta entre 1 e 65535."
@@ -5538,6 +5574,10 @@ msgstr "Digite uma URL válida (por exemplo https://api.openai.com/v1)."
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "Insira uma URL válida, por exemplo https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "Insira um número inteiro entre {minimum} e {maximum}."
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "Insira a origem pública que seu túnel serve, por exemplo https://notes.example.com"
@@ -6005,6 +6045,10 @@ msgstr "Falha ao atualizar o local dos anexos — {detail}"
msgid "Failed to update markdownlint rules"
msgstr "Falha ao atualizar as regras do markdownlint"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "Falha ao atualizar a configuração de desempenho — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6841,6 +6885,10 @@ msgstr "O que você acha do OpenKnowledge?"
msgid "How does sharing work?"
msgstr "Como funciona o compartilhamento?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "Quanto tempo o OpenKnowledge aguarda cada solicitação de embedding durante a indexação. As solicitações de pesquisa têm um tempo limite fixo de 8 segundos por tentativa, que não é alterado por esta configuração."
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "Como documentos, arquivos e imagens locais do projeto ausentes são informados em Problemas, diagnósticos do editor, auditorias e ferramentas de agente."
@@ -7109,9 +7157,9 @@ msgstr "A manutenção do índice permaneceu desativada porque não foi possíve
msgid "Indexed {embedded} of {total} pages."
msgstr "{embedded} de {total} páginas indexadas."
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "Indexando suas páginas — {semanticIndexedCount} de {semanticTotalCount} prontas. Os resultados podem estar incompletos."
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "Tempo limite da requisição de indexação (segundos)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7664,6 +7712,10 @@ msgstr "Claro"
msgid "Light, dark, or follow the OS."
msgstr "Claro, escuro ou seguir o sistema."
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "Limita o texto combinado enviado em cada requisição. Um fragmento maior é enviado sozinho; os documentos não são divididos novamente."
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "linha {displayLine}"
@@ -7985,6 +8037,10 @@ msgstr "Procurando <0>{lookingForUrl}</0>."
msgid "Lost connection to \"{docName}\"."
msgstr "A conexão com \"{docName}\" foi perdida."
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "Reduza este valor para diminuir o uso de memória e o trabalho por requisição. Lotes menores enviam mais requisições e podem deixar a indexação mais lenta no geral."
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "Manter índices generated em todas as pastas?"
@@ -8095,6 +8151,10 @@ msgstr "No máximo {MAX_ATTACHMENTS} anexos"
msgid "Maximum agents already running"
msgstr "Já está no número máximo de agentes em execução"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "Máximo de fragmentos de texto por requisição de indexação"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "O reparo automático do MCP falhou"
@@ -8182,6 +8242,10 @@ msgstr "Página inexistente — clique para criar"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "Página inexistente: {linkTitle}. Clique para criar."
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "As páginas restantes são indexadas ao pesquisar. Pesquise novamente para obter resultados mais completos."
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "Faltam cores na paleta"
@@ -10062,6 +10126,10 @@ msgstr "nome-da-pagina"
msgid "Pages are embedded the first time a search needs them."
msgstr "As páginas viram embeddings na primeira vez que uma busca precisa delas."
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "Páginas indexadas: {semanticIndexedCount} de {semanticTotalCount}."
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "Deslocar para baixo"
@@ -10206,6 +10274,11 @@ msgstr "pendente"
msgid "Percolating…"
msgstr "Fermentando…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "desempenho"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "Exclui definitivamente <0>{targetGitPath}</0> e todo o histórico git dele. Os arquivos de trabalho ficam onde estão. Se o repositório git acima for intencional (ex.: você o clonou), cancele e escolha um local fora dele."
@@ -11305,6 +11378,11 @@ msgstr "Repositório não encontrado — ele pode não existir, ou a conta usada
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "Repositório não encontrado. Ele pode ter sido renomeado, excluído ou movido."
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "solicitações"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "obrigatório"
@@ -11658,6 +11736,7 @@ msgstr "Salvar este comentário (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "Salvo"
@@ -14325,6 +14404,11 @@ msgstr "Arrumando…"
msgid "Timeline"
msgstr "Linha do tempo"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "tempo limite"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "Colore e marca os arquivos com problemas de análise ou de links, sem precisar abri-los."
diff --git a/packages/app/src/locales/ur/messages.json b/packages/app/src/locales/ur/messages.json
index 39ecda292..b7ffd63cf 100644
--- a/packages/app/src/locales/ur/messages.json
+++ b/packages/app/src/locales/ur/messages.json
@@ -125,6 +125,7 @@
"0jD-Gn": ["ٹیم کا نالج بیس، ذاتی وکی، پروجیکٹ کی دستاویزات..."],
"0kTAXe": ["ماخذ کھولیں: ", ["mirrorSrc"]],
"0m4Snh": ["مہارتیں دوبارہ تفویض ہوئیں"],
+ "0mlCvF": ["حروف"],
"0niWj3": [
["removingCount", "plural", { "one": ["#", " ہٹا دیا گیا"], "other": ["#", " ہٹا دیے گئے"] }]
],
@@ -364,6 +365,7 @@
"3zDeFb": ["گہری سوچ جاری ہے…"],
"3zyg_A": ["نظر انداز کرنے کے پیٹرنز"],
"4-Phgi": ["ایجنٹس دکھائیں یا چھپائیں"],
+ "42QMZH": ["درخواستیں"],
"438Fca": ["کلون کامیاب رہا، مگر پروجیکٹ نہیں کھل سکا۔"],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -866,6 +868,9 @@
"9tJX8r": ["معنی کے لحاظ سے"],
"9uI_rE": ["واپس لیں"],
"9uRLEH": ["«", ["name"], "» نہیں کھل سکی — یہ ابھی پروجیکٹ کی مہارتوں میں شامل نہیں۔"],
+ "9wIf0H": [
+ "فی درخواست میموری کے استعمال اور کام کو کم کرنے کے لیے اسے گھٹائیں۔ چھوٹے بیچ زیادہ درخواستیں بھیجتے ہیں اور مجموعی انڈیکسنگ سست کر سکتے ہیں۔"
+ ],
"9wQrUU": ["دوبارہ ڈھانچہ سازی"],
"9x-lMu": ["اس ریپوزٹری میں — ساتھیوں کو git کے ذریعے کاپیاں ملتی ہیں۔"],
"9xCnv8": ["Terminal چھپائیں"],
@@ -907,6 +912,7 @@
"AUV-TY": ["سوچ رہا ہے"],
"AVW-K9": ["یتیم صفحات لوڈ نہیں ہو سکے"],
"AWOSPo": ["بڑا کریں"],
+ "AXMOeM": ["کارکردگی"],
"AYoYhU": ["اپ ڈیٹ ناکام: ", ["0"]],
"AaC-CE": ["خالی بورڈ"],
"AcK_r0": ["Claude CLI"],
@@ -990,6 +996,7 @@
"Bdha5y": ["شائع کیا جا رہا ہے..."],
"BeWTQy": ["ابتدائی پیکس لوڈ ہو رہے ہیں"],
"BgV29F": ["بصری ایڈیٹر کا تلاش اِن پٹ فوکس میں ہے"],
+ "Bgaa_U": ["کارکردگی کی ترتیب تازہ نہیں ہو سکی — ", ["detail"]],
"BhLPRk": ["«", ["name"], "» کو نصب شدہ ورژن پر واپس پلٹا دیا گیا"],
"BjitBo": [["0"], " ڈاؤن لوڈ کریں"],
"BkGtRl": [
@@ -1063,6 +1070,7 @@
"CbxTfe": ["بلاک منتخب کریں"],
"CcaU4i": ["ترامیم فوراً لاگو ہوتی ہیں اور خودکار طور پر اس تھیم میں محفوظ ہو جاتی ہیں۔"],
"ChMshD": [["appName"], " سے باہر نکلیں"],
+ "ChdabN": ["کسی فیلڈ کی ڈیفالٹ قدر بحال کرنے کے لیے اسے خالی کریں۔"],
"Ck9XRt": ["کلید محفوظ نہیں ہو سکی — براہِ کرم دوبارہ کوشش کریں۔"],
"ClII5l": ["اس تھیم کو استعمال کرنے کے لیے اوپر “حسبِ ضرورت” پر سورج یا چاند دبائیں۔"],
"ClTEde": ["منتخب اقتباس کو ایجنٹ پینل میں تیار رکھیں، مزید لکھ کر بھیجنے کے لیے۔"],
@@ -1344,6 +1352,7 @@
"FgQ7XZ": ["آپ کی بگ رپورٹس لوڈ نہیں ہو سکیں۔"],
"FgRAvd": ["لاگز اور سسٹم کی معلومات"],
"Fhp4Gn": ["پلگ اِن دیکھیں"],
+ "Fim5F3": ["ایمبیڈنگز"],
"FiyNln": ["پراپرٹی میں منتخب متن پر جائیں"],
"FjkaiT": ["چھوٹا کریں"],
"Fjz6aJ": ["نئی چیٹ میں بھیجیں"],
@@ -1770,6 +1779,7 @@
"L4Cdd9": ["یا نئی فائل بنائیں <0/>"],
"L6Hhh6": ["(جڑ)"],
"L6Ud-t": ["تنازعات لوڈ نہیں ہو سکے۔ دوبارہ کوشش کے لیے صفحہ ری لوڈ کریں۔"],
+ "L7NFTZ": [["minimum"], " اور ", ["maximum"], " کے درمیان سیکنڈ کی تعداد درج کریں۔"],
"L83DKQ": ["PATH انسٹال ناکام رہا: ", ["summary"]],
"L8fKuc": ["یہ اپنے ٹرمینل میں چلائیں"],
"L9Y9Om": ["سب سے زیادہ لنک شدہ صفحات"],
@@ -2231,6 +2241,7 @@
"QQbwzK": ["کوئی ایجنٹ دستیاب نہیں۔"],
"QQghPu": ["Claude Desktop میں نصب کریں"],
"QR5SP1": ["ٹیمپلیٹ بنایا"],
+ "QRSdsO": ["انڈیکسنگ درخواست کا ٹائم آؤٹ (سیکنڈ)"],
"QVk3SK": ["یہ فائل آنے والی برانچ پر حذف کر دی گئی تھی (modify-delete تنازع)۔"],
"QWdKwH": ["منتقل کریں"],
"QYTOaN": ["آپ اسے بعد میں <0>ترتیبات ← مطابقت پذیری</0> میں بدل سکتے ہیں۔"],
@@ -2302,6 +2313,7 @@
"RGCCrg": ["شیئر لنک نقل کریں"],
"RGkNeJ": ["کسی ابتدائی پیک کا ابتدائیہ کریں"],
"RGptDW": ["OpenKnowledge نے ایک دستاویز منتقل کی"],
+ "RH0e_f": ["وقت کی حد"],
"RJ3a8Z": ["<0>", ["lookingForUrl"], "</0> تلاش کیا جا رہا ہے۔"],
"RJMO4B": [
["residentPlugin"],
@@ -2780,6 +2792,9 @@
"XYZ7tp": ["ناقابلِ حل"],
"XYlJJT": ["ترتیب دیا جا رہا ہے"],
"XZkdtg": ["برانچ بدلیں"],
+ "Xafwko": [
+ "ہر درخواست میں بھیجے جانے والے مجموعی متن کو محدود کرتا ہے۔ بڑا واحد ٹکڑا الگ بھیجا جاتا ہے؛ دستاویزات دوبارہ تقسیم نہیں ہوتیں۔"
+ ],
"XcGbim": ["چھپی ہوئی فائلیں دکھائیں"],
"Xet9MX": ["بیک لنکس لوڈ نہیں ہو سکے"],
"Xewl6B": ["آپ کی مقامی نقل پیچھے ہے۔ تازہ ترین تبدیلیاں کھینچیں، پھر لنک دوبارہ کھولیں۔"],
@@ -3272,6 +3287,7 @@
"cRm498": ["اس پروجیکٹ میں ابھی کوئی اسکیما فائل نہیں — توثیق شروع کرنے کے لیے ایک بنائیں۔"],
"cSCbv3": ["بیٹا"],
"cT_pW4": ["سکڑنے والا مواد بلاک (Notion طرز کا ٹوگل)۔"],
+ "cTrVa1": ["ایمبیڈنگ درخواست کی ترتیبات"],
"cU-seF": ["کرسر والے بلاک کے Markdown سورس پر جائیں، بیچ میں اور نمایاں۔"],
"cUK8lW": [["conflictCount", "plural", { "one": ["#", " تصادم"], "other": ["#", " تصادمات"] }]],
"cUagXn": [["gitignorePath"], " میں شامل کریں"],
@@ -3459,6 +3475,13 @@
"eGUbmF": ["منتخب فائل یا فولڈر نقل کریں"],
"eJitUk": ["کمپیوٹر سے اپ لوڈ کریں"],
"eKThTQ": ["ترتیب نہیں بدلی جا سکی"],
+ "eMWRAs": [
+ "انڈیکس شدہ صفحات: ",
+ ["semanticTotalCount"],
+ " میں سے ",
+ ["semanticIndexedCount"],
+ "۔"
+ ],
"eNOyTV": [
"آپ کو اس ریپازٹری میں پُش کرنے کی اجازت نہیں۔ خودکار (صرف کھینچیں) پھر بھی آپ کی کاپی تازہ رکھ سکتا ہے۔"
],
@@ -3727,6 +3750,9 @@
"gyHDWC": ["AI سے سب ٹھیک کریں (", ["count"], ")"],
"gyYvCN": ["میری ترامیم بھیجنے کا وقفہ"],
"h-AdvS": ["فولڈرز اور ٹیمپلیٹس یہاں پہلے سے موجود ہیں، اس لیے شامل کرنے کو کچھ نہیں۔"],
+ "h-RPqa": [
+ "انڈیکس بناتے وقت OpenKnowledge ہر ایمبیڈنگ درخواست کے لیے کتنی دیر انتظار کرتا ہے۔ تلاش کی درخواستوں کے ہر کوشش کے لیے وقت کی حد 8 سیکنڈ مقرر ہے اور یہ سیٹنگ اسے تبدیل نہیں کرتی۔"
+ ],
"h06R3C": ["کسی صفحے میں جانے والے گراف لنکس کی کمی نہیں۔"],
"h16FyT": ["فہرستیں"],
"h2N-1n": [["0"], " میں نصب"],
@@ -3970,6 +3996,7 @@
],
"jTUxaN": ["خودکار (صرف کھینچیں) فعال کریں"],
"jTdrn1": [["filePath"], " میں اب بھی کنفلکٹ ہے یا نہیں، جانچا نہ جا سکا — دوبارہ کوشش جاری۔"],
+ "jWwQo6": ["بیچ"],
"jWzDfC": ["دیکھا جا رہا ہے کہ آپ کے پاس کون سے AI ٹولز ہیں"],
"jZ_E5M": ["لانا ناکام رہا — تفصیلات کے لیے سرور کے لاگز دیکھیں۔"],
"j_Z6g7": ["مشترکہ طے شدہ"],
@@ -4027,13 +4054,6 @@
"</0> جیسے مقامی اینڈ پوائنٹ کے لیے ضروری نہیں — زیادہ تر مقامی سرورز اسے نظر انداز کرتے ہیں۔ صرف اسی صورت شامل کریں جب آپ کے سرور کو درکار ہو۔"
],
"kBNHN1": ["نیویگیشن کی تاریخ"],
- "kCNU4q": [
- "آپ کے صفحات اشاریہ بند ہو رہے ہیں — ",
- ["semanticTotalCount"],
- " میں سے ",
- ["semanticIndexedCount"],
- " تیار۔ نتائج نامکمل ہو سکتے ہیں۔"
- ],
"kCjkGY": ["اس میں تھوڑا وقت لگ سکتا ہے۔ آپ کا Markdown مواد محفوظ رہتا ہے۔"],
"kCqCyf": ["CodeMirror کا لِنٹ تشخیصی پینل کھولیں۔"],
"kEiVv6": [
@@ -4066,6 +4086,7 @@
"معنوی تلاش کو OpenAI سے ہم آہنگ کسی بھی ایمبیڈنگز اینڈ پوائنٹ کی طرف موڑیں — خود میزبان سرور یا کوئی دوسرا فراہم کنندہ۔ اوپر دی گئی API کلید اسی اینڈ پوائنٹ کے لیے ہے جو آپ یہاں مقرر کریں۔"
],
"kSiB3X": [["trashNoun"], " میں منتقل نہیں ہو سکا"],
+ "kUgGPO": ["فی انڈیکسنگ درخواست حروف کا بجٹ"],
"kV2YZv": [
"<0>مہارتیں</0> نظر نہیں آ رہیں؟ پہلے <1>ترتیبات <2/> صلاحیتیں <3/> کوڈ کا اجرا اور فائل سازی</1> فعال کریں۔"
],
@@ -4557,6 +4578,9 @@
"q3W2nd": ["وہ تبصرہ شامل نہیں ہو سکا: ", ["0"]],
"q4YJl_": ["ٹرمینل کا سیشن ختم ہو گیا (خروج کوڈ ", ["0"], ")۔"],
"q4efaG": [["filePath"], " اب اس اسکل میں نہیں ہے"],
+ "q5uZbJ": [
+ "باقی صفحات تلاش کرتے وقت انڈیکس کیے جاتے ہیں۔ مزید مکمل نتائج کے لیے دوبارہ تلاش کریں۔"
+ ],
"q6-JVU": ["صفحات لوڈ ہو رہے ہیں"],
"q63KUv": ["MCP اور اسکل شامل کریں"],
"q7F5am": ["عنوان"],
@@ -4992,6 +5016,9 @@
"uoJF_D": ["اسے ترتیب دینا یا شروع کرنا بہت مشکل تھا"],
"ur2XSb": ["بصری ایڈیٹر"],
"uuoHOU": ["کمانڈ ناکام ہو گئی۔"],
+ "uwzRx4": [
+ "سست یا محدود میموری والے ایمبیڈنگ سرورز کے لیے انڈیکسنگ درخواست کا حجم اور ٹائم آؤٹ ایڈجسٹ کریں۔ زیادہ تر سیٹ اپ میں طے شدہ اقدار ہی رکھنی چاہییں۔"
+ ],
"uyJsf6": ["تعارف"],
"uyOQ4e": ["تھیم base16 YAML کے طور پر کاپی ہو گئی"],
"uynXup": [["tokens", "plural", { "one": ["ٹوکن"], "other": ["ٹوکنز"] }]],
@@ -5384,11 +5411,13 @@
"zbymaY": [["0"], " منٹ پہلے"],
"zd00pH": ["راستہ نقل کریں"],
"zgSFyG": ["بیرونی لنک"],
+ "zkkEFa": [["minimum"], " اور ", ["maximum"], " کے درمیان ایک صحیح عدد درج کریں۔"],
"zkz0Fg": ["مطابقت پذیری ترتیب دیں"],
"zlErBl": ["صفحے کے عنوانات کی خرابی کا جواب RFC 9457 سے میل نہیں کھایا"],
"zo3Dl7": ["تھمب نیلز بدلیں"],
"zpfN9p": ["ابھی کوئی تبصرہ نہیں۔ ایک شامل کرنے کے لیے دستاویز میں متن منتخب کریں۔"],
"zq2eBA": ["سورس میں دیکھیں"],
+ "zqQlBg": ["فی انڈیکسنگ درخواست زیادہ سے زیادہ متن کے ٹکڑے"],
"zrP8HX": [
"وہ frontmatter جس سے اس ٹیمپلیٹ سے بننے والی ہر دستاویز شروع ہوتی ہے۔ اقدار YAML میں ہیں — فہرست یوں لکھی جاتی ہے <0>[a, b]</0>؛ اور <1>{",
["date"],
diff --git a/packages/app/src/locales/ur/messages.po b/packages/app/src/locales/ur/messages.po
index 3f712b3fe..2db97a362 100644
--- a/packages/app/src/locales/ur/messages.po
+++ b/packages/app/src/locales/ur/messages.po
@@ -1730,6 +1730,10 @@ msgstr "یہ فائلیں شامل کرتا ہے"
msgid "Adds these folders"
msgstr "یہ فولڈرز شامل کرتا ہے"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "سست یا محدود میموری والے ایمبیڈنگ سرورز کے لیے انڈیکسنگ درخواست کا حجم اور ٹائم آؤٹ ایڈجسٹ کریں۔ زیادہ تر سیٹ اپ میں طے شدہ اقدار ہی رکھنی چاہییں۔"
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "بیک لنکس کا جواب متوقع ساخت سے میل نہیں
msgid "Base branch"
msgstr "بنیادی برانچ"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "بیچ"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "سِم لنک بن جاتا ہے"
@@ -2637,6 +2646,15 @@ msgstr "تبدیلیاں خودکار طور پر محفوظ ہو جاتی ہی
msgid "Changes saved automatically."
msgstr "تبدیلیاں خودکار طور پر محفوظ ہو گئیں۔"
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "فی انڈیکسنگ درخواست حروف کا بجٹ"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "حروف"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "اپ ڈیٹس دیکھیں"
@@ -2836,6 +2854,10 @@ msgstr "صاف کریں"
msgid "Clear {keyName}"
msgstr "{keyName} صاف کریں"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "کسی فیلڈ کی ڈیفالٹ قدر بحال کرنے کے لیے اسے خالی کریں۔"
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "رنگ ہٹائیں"
@@ -5344,6 +5366,16 @@ msgstr "کوئی بیرونی صفحہ اِن لائن iframe میں شامل ک
msgid "Embed an image with optional alt text."
msgstr "اختیاری متبادل متن کے ساتھ تصویر شامل کریں۔"
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "ایمبیڈنگ درخواست کی ترتیبات"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "ایمبیڈنگز"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "ایمبیڈنگز API کلید"
@@ -5510,6 +5542,10 @@ msgstr "فولڈر کا نام درج کریں (مثلاً brain)۔"
msgid "Enter a name for this theme."
msgstr "اس تھیم کے لیے نام درج کریں۔"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "{minimum} اور {maximum} کے درمیان سیکنڈ کی تعداد درج کریں۔"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "1 اور 65535 کے درمیان ایک پورٹ درج کریں۔"
@@ -5542,6 +5578,10 @@ msgstr "درست URL درج کریں (مثلاً https://api.openai.com/v1)۔"
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "ایک درست URL درج کریں، مثلاً https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "{minimum} اور {maximum} کے درمیان ایک صحیح عدد درج کریں۔"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "وہ عوامی اوریجن درج کریں جو آپ کا ٹنل سرو کرتا ہے، مثلاً https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "منسلکات کا مقام تازہ نہیں ہو سکا — {detail}"
msgid "Failed to update markdownlint rules"
msgstr "markdownlint کے قواعد تازہ نہیں ہو سکے"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "کارکردگی کی ترتیب تازہ نہیں ہو سکی — {detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "OpenKnowledge آپ کو کیسا لگا؟"
msgid "How does sharing work?"
msgstr "اشتراک کیسے کام کرتا ہے؟"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "انڈیکس بناتے وقت OpenKnowledge ہر ایمبیڈنگ درخواست کے لیے کتنی دیر انتظار کرتا ہے۔ تلاش کی درخواستوں کے ہر کوشش کے لیے وقت کی حد 8 سیکنڈ مقرر ہے اور یہ سیٹنگ اسے تبدیل نہیں کرتی۔"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "گم شدہ پروجیکٹ-لوکل دستاویزات، فائلوں اور تصاویر کو مسائل، ایڈیٹر تشخیصات، آڈٹس اور ایجنٹ ٹولز میں کیسے رپورٹ کیا جاتا ہے۔"
@@ -7113,9 +7161,9 @@ msgstr "انڈیکس کی دیکھ بھال بند رہی کیونکہ پروج
msgid "Indexed {embedded} of {total} pages."
msgstr "{total} میں سے {embedded} صفحات اشاریہ بند ہو گئے۔"
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "آپ کے صفحات اشاریہ بند ہو رہے ہیں — {semanticTotalCount} میں سے {semanticIndexedCount} تیار۔ نتائج نامکمل ہو سکتے ہیں۔"
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "انڈیکسنگ درخواست کا ٹائم آؤٹ (سیکنڈ)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "روشن"
msgid "Light, dark, or follow the OS."
msgstr "روشن، تاریک، یا OS کی پیروی۔"
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "ہر درخواست میں بھیجے جانے والے مجموعی متن کو محدود کرتا ہے۔ بڑا واحد ٹکڑا الگ بھیجا جاتا ہے؛ دستاویزات دوبارہ تقسیم نہیں ہوتیں۔"
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "سطر {displayLine}"
@@ -7989,6 +8041,10 @@ msgstr "<0>{lookingForUrl}</0> تلاش کیا جا رہا ہے۔"
msgid "Lost connection to \"{docName}\"."
msgstr "«{docName}» سے رابطہ ختم ہو گیا۔"
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "فی درخواست میموری کے استعمال اور کام کو کم کرنے کے لیے اسے گھٹائیں۔ چھوٹے بیچ زیادہ درخواستیں بھیجتے ہیں اور مجموعی انڈیکسنگ سست کر سکتے ہیں۔"
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "ہر فولڈر میں generated اشاریہ جات کو برقرار رکھیں؟"
@@ -8099,6 +8155,10 @@ msgstr "زیادہ سے زیادہ {MAX_ATTACHMENTS} منسلکات"
msgid "Maximum agents already running"
msgstr "زیادہ سے زیادہ ایجنٹس پہلے ہی چل رہے ہیں"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "فی انڈیکسنگ درخواست زیادہ سے زیادہ متن کے ٹکڑے"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP کی خودکار مرمت ناکام رہی"
@@ -8186,6 +8246,10 @@ msgstr "غائب صفحہ — بنانے کے لیے کلک کریں"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "غائب صفحہ: {linkTitle}۔ بنانے کے لیے کلک کریں۔"
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "باقی صفحات تلاش کرتے وقت انڈیکس کیے جاتے ہیں۔ مزید مکمل نتائج کے لیے دوبارہ تلاش کریں۔"
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "پیلیٹ کے رنگ غائب ہیں"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "صفحات پہلی بار اسی وقت ایمبیڈ ہوتے ہیں جب کسی تلاش کو ان کی ضرورت پڑے۔"
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "انڈیکس شدہ صفحات: {semanticTotalCount} میں سے {semanticIndexedCount}۔"
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "نیچے کھسکائیں"
@@ -10210,6 +10278,11 @@ msgstr "زیرِ التوا"
msgid "Percolating…"
msgstr "چھان بین جاری ہے…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "کارکردگی"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "<0>{targetGitPath}</0> اور اس کی پوری git تاریخ مستقل طور پر حذف کر دیتا ہے۔ کام کی فائلیں اپنی جگہ رہتی ہیں۔ اگر والد git ریپو جان بوجھ کر ہے (مثلاً آپ نے اسے کلون کیا)، تو منسوخ کریں اور اس سے باہر کوئی مقام منتخب کریں۔"
@@ -11309,6 +11382,11 @@ msgstr "ریپازٹری نہیں ملی — ہو سکتا ہے وہ موجود
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "ریپازٹری نہیں ملی۔ ہو سکتا ہے اس کا نام بدل گیا ہو، حذف ہو گئی ہو، یا منتقل ہو گئی ہو۔"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "درخواستیں"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "لازمی"
@@ -11662,6 +11740,7 @@ msgstr "یہ تبصرہ محفوظ کریں (Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "محفوظ ہو گیا"
@@ -14329,6 +14408,11 @@ msgstr "سمیٹا جا رہا ہے…"
msgid "Timeline"
msgstr "ٹائم لائن"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "وقت کی حد"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "جن فائلوں میں لِنٹ یا لنک کے مسائل ہوں انہیں کھولے بغیر رنگ اور نشان دیں۔"
diff --git a/packages/app/src/locales/zh-Hans/messages.json b/packages/app/src/locales/zh-Hans/messages.json
index 5202f4f23..199dff6a1 100644
--- a/packages/app/src/locales/zh-Hans/messages.json
+++ b/packages/app/src/locales/zh-Hans/messages.json
@@ -118,6 +118,7 @@
"0jD-Gn": ["团队知识库、个人维基、项目文档……"],
"0kTAXe": ["来源:", ["mirrorSrc"]],
"0m4Snh": ["技能已重新分配"],
+ "0mlCvF": ["字符"],
"0niWj3": [["removingCount", "plural", { "other": ["已移除 ", "#"] }]],
"0pLDSn": ["「技能」工具栏"],
"0pZmTP": ["无法共享此路径。"],
@@ -326,6 +327,7 @@
"3zDeFb": ["正在反复琢磨…"],
"3zyg_A": ["忽略模式"],
"4-Phgi": ["显示或隐藏智能体"],
+ "42QMZH": ["请求"],
"438Fca": ["克隆成功,但无法打开项目。"],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -753,6 +755,9 @@
"9tJX8r": ["按语义"],
"9uI_rE": ["撤销"],
"9uRLEH": ["无法打开“", ["name"], "”——它还不在项目的技能里。"],
+ "9wIf0H": [
+ "调低此值可减少每个请求的内存占用和工作量。批次越小,请求越多,整体索引速度可能变慢。"
+ ],
"9wQrUU": ["重构"],
"9x-lMu": ["位于此仓库中——协作者会通过 git 获得副本。"],
"9xCnv8": ["隐藏 Terminal"],
@@ -790,6 +795,7 @@
"AUV-TY": ["思考中"],
"AVW-K9": ["加载孤立页面失败"],
"AWOSPo": ["放大"],
+ "AXMOeM": ["性能"],
"AYoYhU": ["更新失败:", ["0"]],
"AaC-CE": ["空白板"],
"AcK_r0": ["Claude CLI"],
@@ -857,6 +863,7 @@
"Bdha5y": ["正在发布…"],
"BeWTQy": ["正在加载入门包"],
"BgV29F": ["可视化编辑器查找输入框已聚焦"],
+ "Bgaa_U": ["更新性能设置失败——", ["detail"]],
"BhLPRk": ["已把“", ["name"], "”还原到已安装的版本"],
"BjitBo": ["下载 ", ["0"]],
"BkGtRl": ["在「编辑源码」面板或代码类属性字段中撤销、重做,或逐步回溯选区变化。"],
@@ -918,6 +925,7 @@
"CbxTfe": ["选择块"],
"CcaU4i": ["编辑会实时生效,并自动保存到此主题。"],
"ChMshD": ["退出 ", ["appName"]],
+ "ChdabN": ["清空字段可恢复其默认值。"],
"Ck9XRt": ["无法保存密钥——请重试。"],
"ClII5l": ["按上方“自定义”中的太阳或月亮图标以使用此主题。"],
"ClTEde": ["把选中的内容放入智能体面板,随时可以补充并发送。"],
@@ -1163,6 +1171,7 @@
"FgQ7XZ": ["无法加载你的错误报告。"],
"FgRAvd": ["日志与系统信息"],
"Fhp4Gn": ["查看插件"],
+ "Fim5F3": ["嵌入"],
"FiyNln": ["跳到属性中选中的文本"],
"FjkaiT": ["缩小"],
"Fjz6aJ": ["发送到新对话"],
@@ -1519,6 +1528,7 @@
"L4Cdd9": ["或者新建一个文件 <0/>"],
"L6Hhh6": ["(根目录)"],
"L6Ud-t": ["无法加载冲突。请重新加载后重试。"],
+ "L7NFTZ": ["请输入 ", ["minimum"], " 到 ", ["maximum"], " 之间的秒数。"],
"L83DKQ": ["PATH 安装失败:", ["summary"]],
"L8fKuc": ["在你的终端中运行这个"],
"L9Y9Om": ["被链接最多的页面"],
@@ -1910,6 +1920,7 @@
"QQbwzK": ["没有可用的智能体。"],
"QQghPu": ["安装到 Claude Desktop"],
"QR5SP1": ["已创建模板"],
+ "QRSdsO": ["索引请求超时(秒)"],
"QVk3SK": ["此文件已在传入分支中删除(modify-delete 冲突)。"],
"QWdKwH": ["移动"],
"QYTOaN": ["之后可以在<0>「设置 → 同步」</0>中更改。"],
@@ -1967,6 +1978,7 @@
"RGCCrg": ["复制共享链接"],
"RGkNeJ": ["初始化一个入门包"],
"RGptDW": ["OpenKnowledge 移动了一个文档"],
+ "RH0e_f": ["超时"],
"RJ3a8Z": ["正在寻找 <0>", ["lookingForUrl"], "</0>。"],
"RJMO4B": ["来自 ", ["residentPlugin"], " 插件 — 只读;插件更新会替换这些文件。"],
"RLNIgv": ["服务器返回的模板响应不完整。"],
@@ -2387,6 +2399,7 @@
"XYZ7tp": ["无法解析"],
"XYlJJT": ["正在设置"],
"XZkdtg": ["切换分支"],
+ "Xafwko": ["限制每个请求发送的文本总量。超出预算的单个块会单独发送,文档不会再次拆分。"],
"XcGbim": ["显示隐藏文件"],
"Xet9MX": ["加载反向链接失败"],
"Xewl6B": ["你的本地副本落后了。请拉取最新改动,然后重新打开链接。"],
@@ -2803,6 +2816,7 @@
"cRm498": ["这个项目还没有架构文件——创建一个即可开始校验。"],
"cSCbv3": ["BETA"],
"cT_pW4": ["可折叠内容块(Notion 风格折叠)。"],
+ "cTrVa1": ["嵌入请求设置"],
"cU-seF": ["跳到光标所在块的 markdown 源码,居中并高亮显示。"],
"cUK8lW": [["conflictCount", "plural", { "other": ["#", " 处冲突"] }]],
"cUagXn": ["添加到 ", ["gitignorePath"]],
@@ -2950,6 +2964,7 @@
"eGUbmF": ["复制选中的文件或文件夹"],
"eJitUk": ["从电脑上传"],
"eKThTQ": ["重新排序失败"],
+ "eMWRAs": ["已建立索引的页面:", ["semanticIndexedCount"], " / ", ["semanticTotalCount"], "。"],
"eNOyTV": ["你没有向此仓库推送的权限。自动(仅拉取)仍可让你的副本保持最新。"],
"eNQGRb": ["由 KaTeX 渲染的行内 LaTeX 公式。"],
"eNhWUl": ["一位 PR 评审者、一位发布说明撰稿人、一份部署检查清单……"],
@@ -3185,6 +3200,9 @@
"gyHDWC": ["用 AI 全部修复(", ["count"], ")"],
"gyYvCN": ["推送我的编辑的频率"],
"h-AdvS": ["文件夹和模板都已经在这里了,没有需要添加的内容。"],
+ "h-RPqa": [
+ "OpenKnowledge 在建立索引时等待每次嵌入请求的时长。搜索请求每次尝试的超时时间固定为 8 秒,不受此设置影响。"
+ ],
"h06R3C": ["没有页面缺少出链。"],
"h16FyT": ["列表"],
"h2N-1n": ["已安装在 ", ["0"]],
@@ -3400,6 +3418,7 @@
"jTLWxh": ["用内联 iframe 嵌入外部页面(文档、演示、Figma、CodeSandbox)。"],
"jTUxaN": ["启用自动(仅拉取)"],
"jTdrn1": ["无法确认 ", ["filePath"], " 是否仍有冲突 — 正在重试。"],
+ "jWwQo6": ["批次"],
"jWzDfC": ["正在检查你安装了哪些 AI 工具"],
"jZ_E5M": ["获取失败——详情请查看服务器日志。"],
"j_Z6g7": ["共享的默认值"],
@@ -3455,13 +3474,6 @@
"</0> 这样的本地端点不是必需的——大多数本地服务器会忽略它。只有你的服务器需要时才添加。"
],
"kBNHN1": ["导航历史"],
- "kCNU4q": [
- "正在索引你的页面——",
- ["semanticTotalCount"],
- " 个中已就绪 ",
- ["semanticIndexedCount"],
- " 个。结果可能不完整。"
- ],
"kCjkGY": ["这可能需要一点时间。你的 markdown 内容会保留。"],
"kCqCyf": ["打开 CodeMirror 的检查诊断面板。"],
"kEiVv6": [
@@ -3492,6 +3504,7 @@
"把语义搜索指向任何兼容 OpenAI 的嵌入端点——自建服务器或其他提供方均可。上方的 API 密钥用于你在这里设置的端点。"
],
"kSiB3X": ["无法移到", ["trashNoun"]],
+ "kUgGPO": ["每次索引请求的字符预算"],
"kV2YZv": ["没看到<0>技能</0>?请先启用<1>设置 <2/> 功能 <3/> 代码执行与文件创建</1>。"],
"kVS5tE": ["在每个文件夹中维护 generated 索引?"],
"kVgQUA": ["删除此对话?"],
@@ -3904,6 +3917,7 @@
"q3W2nd": ["无法添加那条评论:", ["0"]],
"q4YJl_": ["终端会话已结束(退出码 ", ["0"], ")。"],
"q4efaG": [["filePath"], " 已不在此技能中"],
+ "q5uZbJ": ["尚未建立索引的页面会在搜索时建立索引。再次搜索可获得更完整的结果。"],
"q6-JVU": ["正在加载页面"],
"q63KUv": ["添加 MCP 和技能"],
"q7F5am": ["标题"],
@@ -4279,6 +4293,9 @@
"uoJF_D": ["设置或上手太麻烦了"],
"ur2XSb": ["可视化编辑器"],
"uuoHOU": ["命令执行失败。"],
+ "uwzRx4": [
+ "为速度较慢或内存受限的嵌入服务器调整索引请求的大小和超时时间。大多数情况下应保持默认值。"
+ ],
"uyJsf6": ["关于"],
"uyOQ4e": ["主题已复制为 base16 YAML"],
"uynXup": [["tokens", "plural", { "other": ["token"] }]],
@@ -4604,11 +4621,13 @@
"zbymaY": [["0"], " 分钟前"],
"zd00pH": ["复制路径"],
"zgSFyG": ["外部链接"],
+ "zkkEFa": ["请输入 ", ["minimum"], " 到 ", ["maximum"], " 之间的整数。"],
"zkz0Fg": ["设置同步"],
"zlErBl": ["页面标题的错误响应不符合 RFC 9457"],
"zo3Dl7": ["切换缩略图"],
"zpfN9p": ["还没有评论。在文档中选中文本即可添加。"],
"zq2eBA": ["在源码中查看"],
+ "zqQlBg": ["每次索引请求的最大文本块数"],
"zrP8HX": [
"用这个模板创建的每个文档都以这段 frontmatter 开头。值使用 YAML——列表写作 <0>[a, b]</0>;<1>{",
["date"],
diff --git a/packages/app/src/locales/zh-Hans/messages.po b/packages/app/src/locales/zh-Hans/messages.po
index 92fe7debb..8193b47b9 100644
--- a/packages/app/src/locales/zh-Hans/messages.po
+++ b/packages/app/src/locales/zh-Hans/messages.po
@@ -1730,6 +1730,10 @@ msgstr "添加这些文件"
msgid "Adds these folders"
msgstr "添加这些文件夹"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "为速度较慢或内存受限的嵌入服务器调整索引请求的大小和超时时间。大多数情况下应保持默认值。"
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "反向链接响应的结构与预期不符。"
msgid "Base branch"
msgstr "基础分支"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "批次"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "变成符号链接"
@@ -2637,6 +2646,15 @@ msgstr "更改会自动保存。"
msgid "Changes saved automatically."
msgstr "更改已自动保存。"
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "每次索引请求的字符预算"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "字符"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "检查更新"
@@ -2836,6 +2854,10 @@ msgstr "清除"
msgid "Clear {keyName}"
msgstr "清除 {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "清空字段可恢复其默认值。"
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "清除颜色"
@@ -5344,6 +5366,16 @@ msgstr "用内联 iframe 嵌入外部页面(文档、演示、Figma、CodeSand
msgid "Embed an image with optional alt text."
msgstr "嵌入一张图片,可选填替代文本。"
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "嵌入请求设置"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "嵌入"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "嵌入服务 API 密钥"
@@ -5510,6 +5542,10 @@ msgstr "请输入文件夹名(例如 brain)。"
msgid "Enter a name for this theme."
msgstr "输入此主题的名称。"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "请输入 {minimum} 到 {maximum} 之间的秒数。"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "请输入 1 到 65535 之间的端口。"
@@ -5542,6 +5578,10 @@ msgstr "请输入有效的 URL(例如 https://api.openai.com/v1)。"
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "输入有效的 URL,例如 https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "请输入 {minimum} 到 {maximum} 之间的整数。"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "输入你的隧道所服务的公开来源,例如 https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "更新附件位置失败——{detail}"
msgid "Failed to update markdownlint rules"
msgstr "更新 markdownlint 规则失败"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "更新性能设置失败——{detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "你觉得 OpenKnowledge 怎么样?"
msgid "How does sharing work?"
msgstr "共享是怎么运作的?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "OpenKnowledge 在建立索引时等待每次嵌入请求的时长。搜索请求每次尝试的超时时间固定为 8 秒,不受此设置影响。"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "如何在“问题”、编辑器诊断、审计和代理工具中报告缺失的项目本地文档、文件和图像。"
@@ -7113,9 +7161,9 @@ msgstr "由于无法保存项目设置,索引维护已停止。检查项目文
msgid "Indexed {embedded} of {total} pages."
msgstr "已索引 {total} 个页面中的 {embedded} 个。"
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "正在索引你的页面——{semanticTotalCount} 个中已就绪 {semanticIndexedCount} 个。结果可能不完整。"
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "索引请求超时(秒)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "浅色"
msgid "Light, dark, or follow the OS."
msgstr "浅色、深色,或跟随系统。"
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "限制每个请求发送的文本总量。超出预算的单个块会单独发送,文档不会再次拆分。"
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "第 {displayLine} 行"
@@ -7989,6 +8041,10 @@ msgstr "正在寻找 <0>{lookingForUrl}</0>。"
msgid "Lost connection to \"{docName}\"."
msgstr "与“{docName}”的连接已断开。"
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "调低此值可减少每个请求的内存占用和工作量。批次越小,请求越多,整体索引速度可能变慢。"
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "在每个文件夹中维护 generated 索引?"
@@ -8099,6 +8155,10 @@ msgstr "最多 {MAX_ATTACHMENTS} 个附件"
msgid "Maximum agents already running"
msgstr "运行中的智能体已达上限"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "每次索引请求的最大文本块数"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP 自动修复失败"
@@ -8186,6 +8246,10 @@ msgstr "页面不存在——点击可创建"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "页面不存在:{linkTitle}。点击可创建。"
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "尚未建立索引的页面会在搜索时建立索引。再次搜索可获得更完整的结果。"
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "缺少调色板颜色"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "页面会在搜索第一次需要它们时生成嵌入向量。"
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "已建立索引的页面:{semanticIndexedCount} / {semanticTotalCount}。"
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "向下平移"
@@ -10210,6 +10278,11 @@ msgstr "待处理"
msgid "Percolating…"
msgstr "正在酝酿…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "性能"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "会永久删除 <0>{targetGitPath}</0> 及其全部 git 历史。工作文件保持原样。如果上层 git 仓库是有意为之(例如你克隆来的),请取消并选择它之外的位置。"
@@ -11309,6 +11382,11 @@ msgstr "找不到仓库——它可能不存在,或所用账户可能没有访
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "找不到仓库。它可能已被重命名、删除或移动。"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "请求"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "必填"
@@ -11662,6 +11740,7 @@ msgstr "保存这条评论(Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "已保存"
@@ -14329,6 +14408,11 @@ msgstr "正在收拾…"
msgid "Timeline"
msgstr "时间线"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "超时"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "为存在检查或链接问题的文件着色并加标记,无需打开它们。"
diff --git a/packages/app/src/locales/zh-Hant/messages.json b/packages/app/src/locales/zh-Hant/messages.json
index e7b541d5b..503c25ecb 100644
--- a/packages/app/src/locales/zh-Hant/messages.json
+++ b/packages/app/src/locales/zh-Hant/messages.json
@@ -118,6 +118,7 @@
"0jD-Gn": ["團隊知識庫、個人維基、專案文件……"],
"0kTAXe": ["來源:", ["mirrorSrc"]],
"0m4Snh": ["技能已重新指派"],
+ "0mlCvF": ["字元"],
"0niWj3": [["removingCount", "plural", { "other": ["已移除 ", "#"] }]],
"0pLDSn": ["「技能」工具列"],
"0pZmTP": ["無法分享這個路徑。"],
@@ -330,6 +331,7 @@
"3zDeFb": ["反覆琢磨中…"],
"3zyg_A": ["忽略模式"],
"4-Phgi": ["顯示或隱藏代理"],
+ "42QMZH": ["請求"],
"438Fca": ["複製成功,但無法開啟專案。"],
"43qzxu": ["DevOps"],
"44DSl0": [
@@ -755,6 +757,9 @@
"9tJX8r": ["依語意"],
"9uI_rE": ["復原"],
"9uRLEH": ["無法開啟「", ["name"], "」——它還不在這個專案的技能裡。"],
+ "9wIf0H": [
+ "調低此值可減少每個請求的記憶體占用與工作量。批次越小,請求越多,整體索引速度可能變慢。"
+ ],
"9wQrUU": ["重構"],
"9x-lMu": ["位於此儲存庫中——協作者會透過 git 取得副本。"],
"9xCnv8": ["隱藏 Terminal"],
@@ -792,6 +797,7 @@
"AUV-TY": ["思考中"],
"AVW-K9": ["載入孤立頁面失敗"],
"AWOSPo": ["放大"],
+ "AXMOeM": ["效能"],
"AYoYhU": ["更新失敗:", ["0"]],
"AaC-CE": ["空白板"],
"AcK_r0": ["Claude CLI"],
@@ -859,6 +865,7 @@
"Bdha5y": ["正在發布…"],
"BeWTQy": ["正在載入入門套件"],
"BgV29F": ["視覺化編輯器尋找輸入框已聚焦"],
+ "Bgaa_U": ["更新效能設定失敗——", ["detail"]],
"BhLPRk": ["已把「", ["name"], "」回復成已安裝的版本"],
"BjitBo": ["下載 ", ["0"]],
"BkGtRl": ["在「編輯原始碼」窗格或程式碼類屬性欄位中復原、重做,或逐步回溯選取範圍的變化。"],
@@ -920,6 +927,7 @@
"CbxTfe": ["選取區塊"],
"CcaU4i": ["編輯會即時套用,並自動儲存到這個主題。"],
"ChMshD": ["結束 ", ["appName"]],
+ "ChdabN": ["清空欄位即可還原預設值。"],
"Ck9XRt": ["無法儲存金鑰——請再試一次。"],
"ClII5l": ["按上方「自訂」中的太陽或月亮圖示以使用這個主題。"],
"ClTEde": ["把選取的內容放入代理面板,隨時可以補充並傳送。"],
@@ -1169,6 +1177,7 @@
"FgQ7XZ": ["無法載入你的錯誤回報。"],
"FgRAvd": ["記錄與系統資訊"],
"Fhp4Gn": ["檢視外掛"],
+ "Fim5F3": ["嵌入"],
"FiyNln": ["跳到屬性中選取的文字"],
"FjkaiT": ["縮小"],
"Fjz6aJ": ["傳送到新對話"],
@@ -1533,6 +1542,7 @@
"L4Cdd9": ["或者新增一個檔案 <0/>"],
"L6Hhh6": ["(根目錄)"],
"L6Ud-t": ["無法載入衝突。請重新載入後再試一次。"],
+ "L7NFTZ": ["請輸入介於 ", ["minimum"], " 和 ", ["maximum"], " 之間的秒數。"],
"L83DKQ": ["PATH 安裝失敗:", ["summary"]],
"L8fKuc": ["在你的終端機中執行這個"],
"L9Y9Om": ["被連結最多的頁面"],
@@ -1932,6 +1942,7 @@
"QQbwzK": ["沒有可用的代理。"],
"QQghPu": ["安裝到 Claude Desktop"],
"QR5SP1": ["已建立範本"],
+ "QRSdsO": ["索引請求逾時(秒)"],
"QVk3SK": ["此檔案已在傳入分支中刪除(modify-delete 衝突)。"],
"QWdKwH": ["移動"],
"QYTOaN": ["之後可以在<0>「設定 → 同步」</0>中變更。"],
@@ -1989,6 +2000,7 @@
"RGCCrg": ["複製分享連結"],
"RGkNeJ": ["初始化一個入門套件"],
"RGptDW": ["OpenKnowledge 移動了一個文件"],
+ "RH0e_f": ["逾時"],
"RJ3a8Z": ["正在尋找 <0>", ["lookingForUrl"], "</0>。"],
"RJMO4B": ["來自 ", ["residentPlugin"], " 外掛 — 唯讀;外掛更新會取代這些檔案。"],
"RLNIgv": ["伺服器傳回的範本回應不完整。"],
@@ -2411,6 +2423,7 @@
"XYZ7tp": ["無法解析"],
"XYlJJT": ["正在設定"],
"XZkdtg": ["切換分支"],
+ "Xafwko": ["限制每個請求傳送的文字總量。超出預算的單一區塊會單獨傳送,文件不會再次分割。"],
"XcGbim": ["顯示隱藏的檔案"],
"Xet9MX": ["載入反向連結失敗"],
"Xewl6B": ["你的本機副本落後了。請拉取最新的變更,然後重新開啟連結。"],
@@ -2827,6 +2840,7 @@
"cRm498": ["這個專案還沒有結構描述檔案——建立一個就能開始驗證。"],
"cSCbv3": ["BETA"],
"cT_pW4": ["可摺疊內容區塊(Notion 風格摺疊)。"],
+ "cTrVa1": ["嵌入請求設定"],
"cU-seF": ["跳到游標所在區塊的 markdown 原始碼,置中並醒目提示。"],
"cUK8lW": [["conflictCount", "plural", { "other": ["#", " 處衝突"] }]],
"cUagXn": ["新增至 ", ["gitignorePath"]],
@@ -2974,6 +2988,7 @@
"eGUbmF": ["複製選取的檔案或資料夾"],
"eJitUk": ["從電腦上傳"],
"eKThTQ": ["重新排序失敗"],
+ "eMWRAs": ["已建立索引的頁面:", ["semanticIndexedCount"], " / ", ["semanticTotalCount"], "。"],
"eNOyTV": ["你沒有向此儲存庫推送的權限。自動(僅拉取)仍可讓你的副本保持最新。"],
"eNQGRb": ["由 KaTeX 顯示的行內 LaTeX 公式。"],
"eNhWUl": ["一位 PR 審查者、一位發行說明撰稿人、一份部署檢查清單……"],
@@ -3217,6 +3232,9 @@
"gyHDWC": ["用 AI 全部修正(", ["count"], ")"],
"gyYvCN": ["推送我的編輯的頻率"],
"h-AdvS": ["資料夾和範本都已經在這裡了,沒有東西要加。"],
+ "h-RPqa": [
+ "OpenKnowledge 建立索引時等待每個嵌入請求的時間。搜尋請求每次嘗試的逾時時間固定為 8 秒,不受此設定影響。"
+ ],
"h06R3C": ["沒有頁面缺少連出的關係圖連結。"],
"h16FyT": ["清單"],
"h2N-1n": ["已安裝在 ", ["0"]],
@@ -3428,6 +3446,7 @@
"jTLWxh": ["用行內 iframe 嵌入外部頁面(說明文件、示範、Figma、CodeSandbox)。"],
"jTUxaN": ["啟用自動(僅拉取)"],
"jTdrn1": ["無法確認 ", ["filePath"], " 是否仍有衝突 — 正在重試。"],
+ "jWwQo6": ["批次"],
"jWzDfC": ["正在檢查你安裝了哪些 AI 工具"],
"jZ_E5M": ["取得失敗——詳情請看伺服器記錄。"],
"j_Z6g7": ["分享的預設值"],
@@ -3483,13 +3502,6 @@
"</0> 這樣的本機端點不需要——大多數本機伺服器會忽略它。只有你的伺服器需要時才加。"
],
"kBNHN1": ["導覽記錄"],
- "kCNU4q": [
- "正在索引你的頁面——",
- ["semanticTotalCount"],
- " 個中已完成 ",
- ["semanticIndexedCount"],
- " 個。結果可能不完整。"
- ],
"kCjkGY": ["這可能要花一點時間。你的 markdown 內容會保留。"],
"kCqCyf": ["開啟 CodeMirror 的檢查診斷面板。"],
"kEiVv6": [
@@ -3520,6 +3532,7 @@
"把語意搜尋指向任何相容 OpenAI 的嵌入端點——自架的伺服器或別家供應商都行。上面的 API 金鑰是給你在這裡設定的端點用的。"
],
"kSiB3X": ["無法移到", ["trashNoun"]],
+ "kUgGPO": ["每次索引請求的字元預算"],
"kV2YZv": ["沒看到<0>技能</0>嗎?請先啟用<1>設定 <2/> 功能 <3/> 程式碼執行與檔案建立</1>。"],
"kVS5tE": ["在每個資料夾中維護 generated 索引?"],
"kVgQUA": ["刪除此對話?"],
@@ -3934,6 +3947,7 @@
"q3W2nd": ["無法加上那則註解:", ["0"]],
"q4YJl_": ["終端機工作階段已結束(結束代碼 ", ["0"], ")。"],
"q4efaG": [["filePath"], " 已不在此技能中"],
+ "q5uZbJ": ["尚未建立索引的頁面會在搜尋時建立索引。再次搜尋可取得更完整的結果。"],
"q6-JVU": ["正在載入頁面"],
"q63KUv": ["新增 MCP 和技能"],
"q7F5am": ["標題"],
@@ -4311,6 +4325,9 @@
"uoJF_D": ["設定或上手太麻煩了"],
"ur2XSb": ["視覺化編輯器"],
"uuoHOU": ["指令執行失敗。"],
+ "uwzRx4": [
+ "為速度較慢或記憶體受限的嵌入伺服器調整索引請求的大小與逾時時間。大多數情況下應保持預設值。"
+ ],
"uyJsf6": ["關於"],
"uyOQ4e": ["主題已複製為 base16 YAML"],
"uynXup": [["tokens", "plural", { "other": ["token"] }]],
@@ -4638,11 +4655,13 @@
"zbymaY": [["0"], " 分鐘前"],
"zd00pH": ["複製路徑"],
"zgSFyG": ["外部連結"],
+ "zkkEFa": ["請輸入介於 ", ["minimum"], " 和 ", ["maximum"], " 之間的整數。"],
"zkz0Fg": ["設定同步"],
"zlErBl": ["頁面標題的錯誤回應不符合 RFC 9457"],
"zo3Dl7": ["切換縮圖"],
"zpfN9p": ["還沒有註解。在文件中選取文字就能加上一則。"],
"zq2eBA": ["在原始碼中檢視"],
+ "zqQlBg": ["每次索引請求的最大文字區塊數"],
"zrP8HX": [
"用這個範本建立的每份文件都會以這段 frontmatter 開頭。值使用 YAML——清單寫成 <0>[a, b]</0>;<1>{",
["date"],
diff --git a/packages/app/src/locales/zh-Hant/messages.po b/packages/app/src/locales/zh-Hant/messages.po
index c2f5189d8..f31dba01f 100644
--- a/packages/app/src/locales/zh-Hant/messages.po
+++ b/packages/app/src/locales/zh-Hant/messages.po
@@ -1730,6 +1730,10 @@ msgstr "新增這些檔案"
msgid "Adds these folders"
msgstr "新增這些資料夾"
+#: src/components/settings/SearchSection.tsx
+msgid "Adjust indexing request size and timeout for slow or memory-constrained embedding servers. Most setups should keep the defaults."
+msgstr "為速度較慢或記憶體受限的嵌入伺服器調整索引請求的大小與逾時時間。大多數情況下應保持預設值。"
+
#: src/components/settings/SyncSection.tsx
#: src/editor/components/PropPanel.tsx
msgid "Advanced"
@@ -2291,6 +2295,11 @@ msgstr "反向連結的回應結構與預期不符。"
msgid "Base branch"
msgstr "基底分支"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "batch"
+msgstr "批次"
+
#: src/components/settings/SkillFolderLinkConfirmDialog.tsx
msgid "becomes a symlink"
msgstr "變成符號連結"
@@ -2637,6 +2646,15 @@ msgstr "變更會自動儲存。"
msgid "Changes saved automatically."
msgstr "變更已自動儲存。"
+#: src/components/settings/SearchSection.tsx
+msgid "Character budget per indexing request"
+msgstr "每次索引請求的字元預算"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "characters"
+msgstr "字元"
+
#: src/components/command-palette-commands.ts
msgid "Check for updates"
msgstr "檢查更新"
@@ -2836,6 +2854,10 @@ msgstr "清除"
msgid "Clear {keyName}"
msgstr "清除 {keyName}"
+#: src/components/settings/SearchSection.tsx
+msgid "Clear a field to restore its default value."
+msgstr "清空欄位即可還原預設值。"
+
#: src/editor/components/ColorPickerInput.tsx
msgid "Clear color"
msgstr "清除顏色"
@@ -5344,6 +5366,16 @@ msgstr "用行內 iframe 嵌入外部頁面(說明文件、示範、Figma、Co
msgid "Embed an image with optional alt text."
msgstr "嵌入一張圖片,可選填替代文字。"
+#: src/components/settings/SearchSection.tsx
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Embedding request settings"
+msgstr "嵌入請求設定"
+
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "embeddings"
+msgstr "嵌入"
+
#: src/components/settings/SearchSection.tsx
msgid "Embeddings API key"
msgstr "嵌入服務 API 金鑰"
@@ -5510,6 +5542,10 @@ msgstr "請輸入資料夾名稱(例如 brain)。"
msgid "Enter a name for this theme."
msgstr "輸入這個主題的名稱。"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a number of seconds between {minimum} and {maximum}."
+msgstr "請輸入介於 {minimum} 和 {maximum} 之間的秒數。"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter a port between 1 and 65535."
msgstr "請輸入介於 1 到 65535 之間的連接埠。"
@@ -5542,6 +5578,10 @@ msgstr "請輸入有效的 URL(例如 https://api.openai.com/v1)。"
msgid "Enter a valid URL, for example https://notes.example.com"
msgstr "輸入有效的 URL,例如 https://notes.example.com"
+#: src/components/settings/SearchSection.tsx
+msgid "Enter a whole number between {minimum} and {maximum}."
+msgstr "請輸入介於 {minimum} 和 {maximum} 之間的整數。"
+
#: src/components/settings/NetworkAccessSection.tsx
msgid "Enter the public origin your tunnel serves, for example https://notes.example.com"
msgstr "輸入你的通道所提供服務的公開來源,例如 https://notes.example.com"
@@ -6009,6 +6049,10 @@ msgstr "更新附件位置失敗——{detail}"
msgid "Failed to update markdownlint rules"
msgstr "更新 markdownlint 規則失敗"
+#: src/components/settings/SearchSection.tsx
+msgid "Failed to update performance setting — {detail}"
+msgstr "更新效能設定失敗——{detail}"
+
#: src/components/ObjectWidget.tsx
#: src/components/PropertyPanel.tsx
msgid "Failed to update property"
@@ -6845,6 +6889,10 @@ msgstr "你覺得 OpenKnowledge 如何?"
msgid "How does sharing work?"
msgstr "分享是怎麼運作的?"
+#: src/components/settings/SearchSection.tsx
+msgid "How long OpenKnowledge waits for each embedding request while indexing. Search requests use a fixed 8-second timeout per attempt, unchanged by this setting."
+msgstr "OpenKnowledge 建立索引時等待每個嵌入請求的時間。搜尋請求每次嘗試的逾時時間固定為 8 秒,不受此設定影響。"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "How missing project-local documents, files, and images are reported in Problems, editor diagnostics, audits, and agent tools."
msgstr "如何在「問題」、編輯器診斷、稽核和代理工具中報告缺少的專案本機文件、檔案和影像。"
@@ -7113,9 +7161,9 @@ msgstr "由於無法保存項目設置,索引維護已停止。檢查專案檔
msgid "Indexed {embedded} of {total} pages."
msgstr "已索引 {total} 個頁面中的 {embedded} 個。"
-#: src/components/CommandPalette.tsx
-msgid "Indexing your pages — {semanticIndexedCount} of {semanticTotalCount} ready. Results may be incomplete."
-msgstr "正在索引你的頁面——{semanticTotalCount} 個中已完成 {semanticIndexedCount} 個。結果可能不完整。"
+#: src/components/settings/SearchSection.tsx
+msgid "Indexing request timeout (seconds)"
+msgstr "索引請求逾時(秒)"
#: src/components/FrontmatterRow.tsx
msgid "inherited"
@@ -7668,6 +7716,10 @@ msgstr "淺色"
msgid "Light, dark, or follow the OS."
msgstr "淺色、深色,或跟隨系統。"
+#: src/components/settings/SearchSection.tsx
+msgid "Limits the combined text sent in each request. A single larger chunk is sent on its own; documents are not split again."
+msgstr "限制每個請求傳送的文字總量。超出預算的單一區塊會單獨傳送,文件不會再次分割。"
+
#: src/components/ProblemsPanel.tsx
msgid "line {displayLine}"
msgstr "第 {displayLine} 行"
@@ -7989,6 +8041,10 @@ msgstr "正在尋找 <0>{lookingForUrl}</0>。"
msgid "Lost connection to \"{docName}\"."
msgstr "與「{docName}」的連線已中斷。"
+#: src/components/settings/SearchSection.tsx
+msgid "Lower this to reduce memory use and work per request. Smaller batches send more requests and may make indexing slower overall."
+msgstr "調低此值可減少每個請求的記憶體占用與工作量。批次越小,請求越多,整體索引速度可能變慢。"
+
#: src/components/settings/LintingSection.tsx
msgid "Maintain generated indexes in every folder?"
msgstr "在每個資料夾中維護 generated 索引?"
@@ -8099,6 +8155,10 @@ msgstr "最多 {MAX_ATTACHMENTS} 個附件"
msgid "Maximum agents already running"
msgstr "同時執行的代理已達上限"
+#: src/components/settings/SearchSection.tsx
+msgid "Maximum text chunks per indexing request"
+msgstr "每次索引請求的最大文字區塊數"
+
#: src/lib/install-onboarding-toast.ts
msgid "MCP auto-repair failed"
msgstr "MCP 自動修復失敗"
@@ -8186,6 +8246,10 @@ msgstr "頁面不存在——點一下可建立"
msgid "Missing page: {linkTitle}. Click to create."
msgstr "頁面不存在:{linkTitle}。點一下可建立。"
+#: src/components/CommandPalette.tsx
+msgid "Missing pages are indexed when you search. Search again for fuller results."
+msgstr "尚未建立索引的頁面會在搜尋時建立索引。再次搜尋可取得更完整的結果。"
+
#: src/components/settings/SavedThemesTiles.tsx
msgid "Missing palette colors"
msgstr "缺少色盤色彩"
@@ -10066,6 +10130,10 @@ msgstr "page-name"
msgid "Pages are embedded the first time a search needs them."
msgstr "頁面會在搜尋第一次需要它們的時候產生嵌入向量。"
+#: src/components/CommandPalette.tsx
+msgid "Pages indexed: {semanticIndexedCount} of {semanticTotalCount}."
+msgstr "已建立索引的頁面:{semanticIndexedCount} / {semanticTotalCount}。"
+
#: src/editor/components/Mermaid.tsx
msgid "Pan down"
msgstr "向下平移"
@@ -10210,6 +10278,11 @@ msgstr "待處理"
msgid "Percolating…"
msgstr "醞釀中…"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "performance"
+msgstr "效能"
+
#: src/components/CreateProjectDialog.tsx
msgid "Permanently deletes <0>{targetGitPath}</0> and all its git history. Working files stay in place. If the parent git repo is intentional (e.g. you cloned it), cancel and pick a location outside it."
msgstr "會永久刪除 <0>{targetGitPath}</0> 以及它全部的 git 記錄。工作檔案會留在原處。如果上層的 git 儲存庫是刻意的(例如你複製下來的),請取消並選它以外的位置。"
@@ -11309,6 +11382,11 @@ msgstr "找不到儲存庫——它可能不存在,或所用帳戶可能沒有
msgid "Repository not found. It may have been renamed, deleted, or moved."
msgstr "找不到儲存庫。它可能已被重新命名、刪除或移動。"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "requests"
+msgstr "請求"
+
#: src/components/AddPropertyNameField.tsx
msgid "required"
msgstr "必填"
@@ -11662,6 +11740,7 @@ msgstr "儲存這則註解(Enter)"
#: src/components/settings/field-controls.tsx
#: src/components/settings/OkignoreSection.tsx
+#: src/components/settings/SearchSection.tsx
msgid "Saved"
msgstr "已儲存"
@@ -14329,6 +14408,11 @@ msgstr "收拾中…"
msgid "Timeline"
msgstr "時間軸"
+#: src/components/settings/SettingsDialogShell.tsx
+msgctxt "settings search keyword"
+msgid "timeout"
+msgstr "逾時"
+
#: src/components/settings/ContentRulesSection.tsx
msgid "Tint and badge files that have lint or link problems, without opening them."
msgstr "為有檢查或連結問題的檔案上色並加上標記,不必開啟它們。"
diff --git a/packages/app/tests/stress/command-palette-semantic.e2e.ts b/packages/app/tests/stress/command-palette-semantic.e2e.ts
index 2500b6846..ae4667a64 100644
--- a/packages/app/tests/stress/command-palette-semantic.e2e.ts
+++ b/packages/app/tests/stress/command-palette-semantic.e2e.ts
@@ -12,8 +12,8 @@ const submitRow = (page: Page) => page.locator('[data-testid="command-palette-se
const emptyNotice = (page: Page) => page.locator('[data-testid="command-palette-semantic-empty"]');
const resultsGroup = (page: Page) =>
page.locator('[data-testid="command-palette-semantic-results"]');
-const indexingBanner = (page: Page) =>
- page.locator('[data-testid="command-palette-semantic-indexing"]');
+const coverageBanner = (page: Page) =>
+ page.locator('[data-testid="command-palette-semantic-coverage"]');
const CAPABLE_STATUS = {
enabled: true,
@@ -212,12 +212,13 @@ test.describe('command-palette semantic mode — gate, pill, submit, sticky, esc
await expect(submitRow(page)).toBeVisible();
});
- test('shows an indexing banner with coverage while the corpus is not fully embedded', async ({
+ test('explains indexing on search and refreshes coverage until complete', async ({
page,
api,
}) => {
+ let embedded = 0;
await page.route('**/api/semantic-status', async (route) => {
- await route.fulfill({ json: { ...CAPABLE_STATUS, embedded: 1, total: 4 } });
+ await route.fulfill({ json: { ...CAPABLE_STATUS, embedded, total: 4 } });
});
await api.seedDocs([{ name: 's007', markdown: '# s007\n\nBody.' }]);
await page.setViewportSize(DESKTOP_VIEWPORT);
@@ -225,11 +226,19 @@ test.describe('command-palette semantic mode — gate, pill, submit, sticky, esc
await page.waitForSelector('[role="treeitem"]', { timeout: 15_000 });
await openPalette(page);
await semanticPill(page).click();
- await expect(indexingBanner(page)).toBeVisible();
- await expect(indexingBanner(page)).toContainText('1 of 4');
+ await expect(coverageBanner(page)).toHaveText(
+ 'Pages indexed: 0 of 4. Missing pages are indexed when you search. Search again for fuller results.',
+ );
+ await expect(coverageBanner(page).getByRole('status')).toHaveText('Pages indexed: 0 of 4.');
+ await expect(coverageBanner(page).getByLabel('Loading')).toHaveCount(0);
+ embedded = 1;
+ await expect(coverageBanner(page)).toContainText('Pages indexed: 1 of 4.');
+ await expect(coverageBanner(page).getByRole('status')).toHaveText('Pages indexed: 1 of 4.');
+ embedded = 4;
+ await expect(coverageBanner(page)).toBeHidden();
});
- test('no indexing banner when the corpus is fully embedded', async ({ page, api }) => {
+ test('no coverage banner when the corpus is fully embedded', async ({ page, api }) => {
await fakeCapability(page);
await api.seedDocs([{ name: 's008', markdown: '# s008\n\nBody.' }]);
await page.setViewportSize(DESKTOP_VIEWPORT);
@@ -238,6 +247,6 @@ test.describe('command-palette semantic mode — gate, pill, submit, sticky, esc
await openPalette(page);
await semanticPill(page).click();
await expect(emptyNotice(page)).toBeVisible();
- await expect(indexingBanner(page)).toBeHidden();
+ await expect(coverageBanner(page)).toBeHidden();
});
});
diff --git a/packages/app/tests/stress/settings-search.e2e.ts b/packages/app/tests/stress/settings-search.e2e.ts
index 0c994f310..115d4aab0 100644
--- a/packages/app/tests/stress/settings-search.e2e.ts
+++ b/packages/app/tests/stress/settings-search.e2e.ts
@@ -1,3 +1,6 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createServer } from 'node:http';
+import { join } from 'node:path';
import {
expect,
SETTINGS_PANEL_TIMEOUT_MS,
@@ -138,3 +141,138 @@ test.describe('Settings search — scope badges + markdownlint rules', () => {
await expect(page.getByTestId('settings-search-empty')).toBeVisible({ timeout: 5_000 });
});
});
+
+test.describe('Settings → Search — embedding request settings', () => {
+ test('persists overrides and hot-applies request batching without restarting the server', async ({
+ page,
+ api,
+ workerServer,
+ }) => {
+ test.setTimeout(90_000);
+ const requests: string[][] = [];
+ const fakeProvider = createServer((request, response) => {
+ let body = '';
+ request.setEncoding('utf8');
+ request.on('data', (chunk) => {
+ body += chunk;
+ });
+ request.on('end', () => {
+ const input = (JSON.parse(body) as { input?: string[] }).input ?? [];
+ requests.push(input);
+ response.writeHead(200, { 'content-type': 'application/json' });
+ response.end(
+ JSON.stringify({
+ data: input.map((_, index) => ({ index, embedding: [1, 0, 0, 0, 0, 0, 0, 0] })),
+ usage: { total_tokens: input.length },
+ }),
+ );
+ });
+ });
+ await new Promise<void>((resolve) => fakeProvider.listen(0, '127.0.0.1', resolve));
+
+ try {
+ const address = fakeProvider.address();
+ if (address === null || typeof address === 'string')
+ throw new Error('fake provider did not bind');
+ const providerBaseUrl = `http://127.0.0.1:${address.port}/v1`;
+ await api.seedDocs(
+ Array.from({ length: 5 }, (_, index) => ({
+ name: `embedding-default-${index}`,
+ markdown: `# Default ${index}\n\nDEFAULT-BATCH-DOCUMENT-${index} unique semantic content.`,
+ })),
+ );
+
+ await openSettings(page);
+ await page.getByTestId('settings-sidebar-item-search').click();
+ await page.getByTestId('settings-search-custom-endpoint-trigger').click();
+ await page.getByTestId('settings-search-base-url').fill(providerBaseUrl);
+ await page.getByTestId('settings-search-base-url').press('Enter');
+ await page.getByTestId('settings-search-provider-confirm-apply').click();
+ await page.getByTestId('settings-search-semantic-toggle').click();
+ await page.getByTestId('settings-search-confirm-enable').click();
+
+ const configPath = join(workerServer.contentDir, '.ok', 'local', 'config.yml');
+ const readConfig = () => (existsSync(configPath) ? readFileSync(configPath, 'utf8') : '');
+ await expect.poll(readConfig, { timeout: 10_000 }).toMatch(/enabled:\s*true/);
+
+ const runSemanticSearch = async (query: string) => {
+ const result = await page.request.post('/api/search', {
+ data: { query, intent: 'full_text', semantic: true },
+ });
+ expect(result.ok()).toBe(true);
+ };
+ await runSemanticSearch('default embedding batch');
+ await expect
+ .poll(
+ () =>
+ requests.some(
+ (input) =>
+ input.length >= 5 && input.some((text) => text.includes('DEFAULT-BATCH-DOCUMENT')),
+ ),
+ { timeout: 20_000 },
+ )
+ .toBe(true);
+
+ const readEmbeddedCount = async () => {
+ const status = await page.request.get('/api/semantic-status');
+ expect(status.ok()).toBe(true);
+ return ((await status.json()) as { embedded: number }).embedded;
+ };
+ await expect.poll(readEmbeddedCount, { timeout: 10_000 }).toBeGreaterThanOrEqual(5);
+ const initialEmbeddedCount = await readEmbeddedCount();
+ requests.length = 0;
+
+ await page.getByTestId('settings-search-performance-trigger').click();
+ for (const [testId, value] of [
+ ['settings-search-max-batch-size', '2'],
+ ['settings-search-max-batch-chars', '16000'],
+ ['settings-search-doc-timeout-seconds', '120'],
+ ] as const) {
+ const input = page.getByTestId(testId);
+ await input.fill(value);
+ await input.press('Enter');
+ }
+
+ await expect
+ .poll(readConfig, { timeout: 10_000 })
+ .toMatch(/maxBatchSize:\s*2[\s\S]*maxBatchChars:\s*16000[\s\S]*docTimeoutMs:\s*120000/);
+ expect(await readEmbeddedCount()).toBe(initialEmbeddedCount);
+
+ await page.keyboard.press('Escape');
+ await expect(page.getByTestId('settings-dialog')).toBeHidden();
+ await openSettings(page);
+ await page.getByTestId('settings-sidebar-item-search').click();
+ await expect(page.getByTestId('settings-search-max-batch-size')).toHaveValue('2');
+ await expect(page.getByTestId('settings-search-max-batch-chars')).toHaveValue('16000');
+ await expect(page.getByTestId('settings-search-doc-timeout-seconds')).toHaveValue('120');
+
+ for (let index = 0; index < 5; index += 1) {
+ const name = `embedding-retuned-${index}`;
+ await api.createPage(`${name}.md`);
+ await api.replaceDoc(
+ name,
+ `# Retuned ${index}\n\nRETUNED-BATCH-DOCUMENT-${index} unique semantic content.`,
+ );
+ }
+ await runSemanticSearch('retuned embedding batch');
+ await expect
+ .poll(
+ () => {
+ const retuned = requests.filter((input) =>
+ input.some((text) => text.includes('RETUNED-BATCH-DOCUMENT')),
+ );
+ return retuned.length >= 3 && retuned.every((input) => input.length <= 2);
+ },
+ { timeout: 30_000 },
+ )
+ .toBe(true);
+
+ await expect.poll(readEmbeddedCount, { timeout: 10_000 }).toBe(initialEmbeddedCount + 5);
+ expect(requests.flat().some((input) => input.includes('DEFAULT-BATCH-DOCUMENT'))).toBe(false);
+ } finally {
+ await new Promise<void>((resolve, reject) =>
+ fakeProvider.close((error) => (error ? reject(error) : resolve())),
+ );
+ }
+ });
+});
diff --git a/packages/cli/src/commands/config.test.ts b/packages/cli/src/commands/config.test.ts
index b49c9a5aa..e0652ad27 100644
--- a/packages/cli/src/commands/config.test.ts
+++ b/packages/cli/src/commands/config.test.ts
@@ -236,6 +236,35 @@ describe('runValidate', () => {
}
});
+ test('recovered transport overrides report their default and source without rejecting the config', () => {
+ const project = makeTempProject();
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ try {
+ const localPath = projectLocalConfigPath(project.cwd);
+ const source = 'search:\n semantic:\n enabled: true\n docTimeoutMs: 900000\n';
+ writeConfigYaml(localPath, source);
+ const out: string[] = [];
+
+ const outcome = runValidate({ cwd: project.cwd, log: (message) => out.push(message) });
+
+ expect(outcome.ok).toBe(true);
+ const output = out.join('\n');
+ expect(output).toContain('1 config layer(s) had issues');
+ expect(output).toContain('Configuration loaded with defaults for invalid settings:');
+ expect(output).not.toContain('Invalid configuration');
+ expect(output).not.toContain('✓ Configuration valid');
+ expect(output).toContain('search.semantic.docTimeoutMs');
+ expect(output).toContain('between 1 and 600000; using default 30000');
+ expect(output).toContain(`${localPath}:4:19`);
+ expect(output).not.toContain('900000');
+ expect(warn).not.toHaveBeenCalled();
+ expect(readFileSync(localPath, 'utf-8')).toBe(source);
+ } finally {
+ warn.mockRestore();
+ project.cleanup();
+ }
+ });
+
test('source-located error rendering through real loadConfig', () => {
const project = makeTempProject();
try {
diff --git a/packages/cli/src/commands/embeddings/index.test.ts b/packages/cli/src/commands/embeddings/index.test.ts
index 353a9d142..45b58418c 100644
--- a/packages/cli/src/commands/embeddings/index.test.ts
+++ b/packages/cli/src/commands/embeddings/index.test.ts
@@ -1,8 +1,10 @@
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { DEFAULT_EMBEDDINGS_BASE_URL, DEFAULT_EMBEDDINGS_MODEL } from '@inkeep/open-knowledge-core';
-import { afterEach, beforeEach, describe, expect, test } from 'vitest';
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+import { stringify } from 'yaml';
+import * as embeddingsKeyStore from '../../auth/embeddings-key-store.ts';
import { embeddingsCommand } from './index.ts';
function readLocalConfig(dir: string): string {
@@ -108,3 +110,50 @@ describe('ok embeddings set-url / clear-url', () => {
expect(readLocalConfig(dir)).toContain(DEFAULT_EMBEDDINGS_MODEL);
});
});
+
+describe('ok embeddings status transport settings', () => {
+ let dir: string;
+ let stdout: string;
+
+ beforeEach(() => {
+ dir = mkdtempSync(join(tmpdir(), 'ok-embeddings-status-'));
+ stdout = '';
+ vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+ stdout += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf-8');
+ return true;
+ });
+ vi.spyOn(embeddingsKeyStore, 'resolveEmbeddingsCredential').mockResolvedValue({
+ apiKey: null,
+ keyless: true,
+ source: 'none',
+ });
+ });
+
+ afterEach(() => {
+ vi.restoreAllMocks();
+ rmSync(dir, { recursive: true, force: true });
+ });
+
+ test.each([
+ { maxBatchSize: 2, maxBatchChars: 16_000, docTimeoutMs: 120_000 },
+ { maxBatchSize: 96, maxBatchChars: 96_000, docTimeoutMs: 30_000 },
+ ])('JSON exposes resolved transport settings: %j', async (transport) => {
+ mkdirSync(join(dir, '.ok', 'local'), { recursive: true });
+ writeFileSync(
+ join(dir, '.ok', 'local', 'config.yml'),
+ stringify({ search: { semantic: { ...transport, baseUrl: 'http://localhost:11434/v1' } } }),
+ );
+
+ await embeddingsCommand().parseAsync(['status', '--cwd', dir, '--json'], { from: 'user' });
+
+ expect(JSON.parse(stdout)).toMatchObject({ project_config: { transport } });
+ });
+
+ test('text reports the defaults with indexing request and timeout units', async () => {
+ await embeddingsCommand().parseAsync(['status', '--cwd', dir], { from: 'user' });
+
+ expect(stdout).toContain('96 chunks maximum per indexing request');
+ expect(stdout).toContain(' characters: 96000 approximate characters per indexing request');
+ expect(stdout).toContain('30000 ms per indexing request attempt');
+ });
+});
diff --git a/packages/cli/src/commands/embeddings/index.ts b/packages/cli/src/commands/embeddings/index.ts
index f4b99fc2f..7b04fe888 100644
--- a/packages/cli/src/commands/embeddings/index.ts
+++ b/packages/cli/src/commands/embeddings/index.ts
@@ -315,6 +315,11 @@ function statusCommand(): Command {
model: cfg.model,
dimensions: cfg.dimensions ?? null,
},
+ transport: {
+ maxBatchSize: cfg.maxBatchSize,
+ maxBatchChars: cfg.maxBatchChars,
+ docTimeoutMs: cfg.docTimeoutMs,
+ },
},
})}\n`,
);
@@ -344,6 +349,9 @@ function statusCommand(): Command {
` provider: ${cfg.baseUrl}`,
` model: ${cfg.model}`,
` dimensions: ${cfg.dimensions ?? 'auto (detected from the endpoint)'}`,
+ ` batch size: ${cfg.maxBatchSize} chunks maximum per indexing request`,
+ ` characters: ${cfg.maxBatchChars} approximate characters per indexing request`,
+ ` timeout: ${cfg.docTimeoutMs} ms per indexing request attempt`,
];
const hints: string[] = [];
diff --git a/packages/core/src/config/collect-config-diagnostics.test.ts b/packages/core/src/config/collect-config-diagnostics.test.ts
index 6c4713daf..9f81cd3ca 100644
--- a/packages/core/src/config/collect-config-diagnostics.test.ts
+++ b/packages/core/src/config/collect-config-diagnostics.test.ts
@@ -174,6 +174,40 @@ describe('collectConfigDiagnostics', () => {
expect(existsSync(file)).toBe(true);
});
+ test('recovered transport values surface one value-free finding without renaming the file', () => {
+ const file = writeScopeRaw(
+ 'project-local',
+ 'search:\n semantic:\n maxBatchSize: PRIVATE_INVALID_VALUE\n docTimeoutMs: 900000\n',
+ );
+
+ const { diagnostics } = collect();
+
+ expect(diagnostics).toEqual([
+ {
+ code: 'VALUE_FALLBACK',
+ scope: 'project-local',
+ file,
+ issues: [
+ {
+ path: ['search', 'semantic', 'maxBatchSize'],
+ message: 'Expected an integer between 1 and 2048; using default 96.',
+ line: 3,
+ column: 19,
+ },
+ {
+ path: ['search', 'semantic', 'docTimeoutMs'],
+ message: 'Expected an integer between 1 and 600000; using default 30000.',
+ line: 4,
+ column: 19,
+ },
+ ],
+ },
+ ]);
+ expect(JSON.stringify(diagnostics)).not.toContain('PRIVATE_INVALID_VALUE');
+ expect(JSON.stringify(diagnostics)).not.toContain('900000');
+ expect(existsSync(file)).toBe(true);
+ });
+
test('an unparseable layer surfaces a value-free YAML_PARSE finding without renaming the file', () => {
const file = writeScopeRaw('project', 'content:\n dir: [invalid yaml');
diff --git a/packages/core/src/config/collect-config-diagnostics.ts b/packages/core/src/config/collect-config-diagnostics.ts
index 5807685c6..691ee7bd1 100644
--- a/packages/core/src/config/collect-config-diagnostics.ts
+++ b/packages/core/src/config/collect-config-diagnostics.ts
@@ -43,6 +43,17 @@ function toScoped(
file: string,
): ScopedConfigDiagnostic {
switch (diagnostic.code) {
+ case 'VALUE_FALLBACK':
+ return {
+ code: 'VALUE_FALLBACK',
+ scope,
+ file,
+ issues: diagnostic.issues.map((issue) => ({
+ path: issue.path,
+ message: issue.message,
+ ...(issue.source ? { line: issue.source.line, column: issue.source.column } : {}),
+ })),
+ };
case 'REMOVED_KEY':
return {
code: 'REMOVED_KEY',
diff --git a/packages/core/src/config/errors.test.ts b/packages/core/src/config/errors.test.ts
index e0c60da3c..6b4f28af4 100644
--- a/packages/core/src/config/errors.test.ts
+++ b/packages/core/src/config/errors.test.ts
@@ -1,5 +1,7 @@
import { describe, expect, test } from 'vitest';
import {
+ ConfigDiagnosticSchema,
+ ConfigDiagnosticsReportSchema,
ConfigValidationErrorSchema,
FieldScopeSchema,
humanFormat,
@@ -130,6 +132,75 @@ describe('ConfigValidationErrorSchema', () => {
});
describe('humanFormat', () => {
+ test('VALUE_FALLBACK describes recovered settings without rejecting the file or exposing its value', () => {
+ const diagnostic = {
+ code: 'VALUE_FALLBACK',
+ issues: [
+ {
+ path: ['search', 'semantic', 'maxBatchSize'],
+ message: 'Expected an integer between 1 and 2048; using default 96.',
+ source: {
+ file: '/project/.ok/local/config.yml',
+ line: 3,
+ column: 19,
+ snippet: 'maxBatchSize: PRIVATE_INVALID_VALUE',
+ },
+ },
+ ],
+ };
+
+ const parsed = ConfigDiagnosticSchema.parse(diagnostic);
+ expect(parsed.code).toBe('VALUE_FALLBACK');
+ expect(isKnownConfigError(parsed)).toBe(false);
+ expect(JSON.stringify(parsed)).not.toContain('PRIVATE_INVALID_VALUE');
+ const output = humanFormat(diagnostic);
+ expect(output).toContain('Configuration loaded with defaults for invalid settings:');
+ expect(output).toContain('/project/.ok/local/config.yml:3:19');
+ expect(output).toContain('search.semantic.maxBatchSize: Expected an integer');
+ expect(output).toContain('using default 96.');
+ expect(output).not.toContain('Invalid configuration');
+ expect(output).not.toContain('PRIVATE_INVALID_VALUE');
+ });
+
+ test('VALUE_FALLBACK with no located issues still reports recovery', () => {
+ expect(humanFormat({ code: 'VALUE_FALLBACK', issues: [] })).toBe(
+ 'Configuration loaded with defaults for invalid settings.',
+ );
+ expect(
+ humanFormat({
+ code: 'VALUE_FALLBACK',
+ issues: [{ path: ['search', 'semantic', 'maxBatchSize'], message: 'Using default 96.' }],
+ }),
+ ).toContain('search.semantic.maxBatchSize: Using default 96.');
+ });
+
+ test('scoped fallback diagnostics preserve safe field details and discard raw-value fields', () => {
+ const report = ConfigDiagnosticsReportSchema.parse({
+ diagnostics: [
+ {
+ code: 'VALUE_FALLBACK',
+ scope: 'project-local',
+ file: '/project/.ok/local/config.yml',
+ issues: [
+ {
+ path: ['search', 'semantic', 'maxBatchSize'],
+ message: 'Expected an integer between 1 and 2048; using default 96.',
+ line: 3,
+ column: 19,
+ snippet: 'PRIVATE_INVALID_VALUE',
+ raw: 'PRIVATE_INVALID_VALUE',
+ },
+ ],
+ },
+ ],
+ });
+ expect(report.diagnostics[0]).toMatchObject({
+ code: 'VALUE_FALLBACK',
+ issues: [{ path: ['search', 'semantic', 'maxBatchSize'], line: 3, column: 19 }],
+ });
+ expect(JSON.stringify(report)).not.toContain('PRIVATE_INVALID_VALUE');
+ });
+
test('YAML_PARSE renders detail', () => {
expect(humanFormat({ code: 'YAML_PARSE', detail: 'bad indentation' })).toContain(
'bad indentation',
diff --git a/packages/core/src/config/errors.ts b/packages/core/src/config/errors.ts
index 4d0a553e6..6b98d0850 100644
--- a/packages/core/src/config/errors.ts
+++ b/packages/core/src/config/errors.ts
@@ -43,6 +43,15 @@ const RemovedKeyErrorSchema = z.object({
redirect: z.string(),
source: ConfigIssueSourceSchema.optional(),
});
+const ValueFallbackIssueSchema = z.object({
+ path: z.array(z.string()),
+ message: z.string(),
+ source: ConfigIssueSourceSchema.omit({ snippet: true }).optional(),
+});
+const ValueFallbackDiagnosticSchema = z.object({
+ code: z.literal('VALUE_FALLBACK'),
+ issues: z.array(ValueFallbackIssueSchema),
+});
export const KnownConfigValidationErrorSchema = z.discriminatedUnion('code', [
YamlParseErrorSchema,
@@ -87,6 +96,7 @@ export type KnownConfigValidationError = z.infer<typeof KnownConfigValidationErr
export const ConfigDiagnosticSchema = z.discriminatedUnion('code', [
RemovedKeyErrorSchema,
+ ValueFallbackDiagnosticSchema,
YamlParseErrorSchema,
SchemaInvalidErrorSchema,
UnreadableErrorSchema,
@@ -95,8 +105,24 @@ export const ConfigDiagnosticSchema = z.discriminatedUnion('code', [
export type ConfigDiagnostic = z.infer<typeof ConfigDiagnosticSchema>;
export type RemovedKeyDiagnostic = Extract<ConfigDiagnostic, { code: 'REMOVED_KEY' }>;
+export type ValueFallbackDiagnostic = Extract<ConfigDiagnostic, { code: 'VALUE_FALLBACK' }>;
+export type RecoveredConfigDiagnostic = Extract<
+ ConfigDiagnostic,
+ { code: 'REMOVED_KEY' | 'VALUE_FALLBACK' }
+>;
export const ScopedConfigDiagnosticSchema = z.discriminatedUnion('code', [
+ z.object({
+ code: z.literal('VALUE_FALLBACK'),
+ scope: WriteScopeSchema,
+ file: z.string(),
+ issues: z.array(
+ ValueFallbackIssueSchema.omit({ source: true }).extend({
+ line: ConfigIssueSourceSchema.shape.line.optional(),
+ column: ConfigIssueSourceSchema.shape.column.optional(),
+ }),
+ ),
+ }),
z.object({
code: z.literal('REMOVED_KEY'),
scope: WriteScopeSchema,
@@ -180,6 +206,22 @@ function scopeGloss(scope: FieldScope): string {
}
export function humanFormat(error: ConfigValidationError): string {
+ if (error.code === 'VALUE_FALLBACK') {
+ const parsed = ValueFallbackDiagnosticSchema.safeParse(error);
+ if (parsed.success) {
+ if (parsed.data.issues.length === 0) {
+ return 'Configuration loaded with defaults for invalid settings.';
+ }
+ const lines = ['Configuration loaded with defaults for invalid settings:'];
+ for (const issue of parsed.data.issues) {
+ if (issue.source) {
+ lines.push(` ${issue.source.file}:${issue.source.line}:${issue.source.column}`);
+ }
+ lines.push(` ${issue.path.join('.')}: ${issue.message}`);
+ }
+ return lines.join('\n');
+ }
+ }
if (!isKnownConfigError(error)) {
return error.message ?? `Unknown error (${error.code}).`;
}
diff --git a/packages/core/src/config/field-registry.test.ts b/packages/core/src/config/field-registry.test.ts
index 51083219f..78cf6d97d 100644
--- a/packages/core/src/config/field-registry.test.ts
+++ b/packages/core/src/config/field-registry.test.ts
@@ -244,7 +244,10 @@ describe('ConfigSchema coverage (NR3 — every leaf has fieldRegistry metadata)'
'linkPreviews.enabled',
'search.semantic.baseUrl',
'search.semantic.dimensions',
+ 'search.semantic.docTimeoutMs',
'search.semantic.enabled',
+ 'search.semantic.maxBatchChars',
+ 'search.semantic.maxBatchSize',
'search.semantic.model',
'search.semantic.similarityFloor',
'server.allowExternal',
diff --git a/packages/core/src/config/read-config-safely.test.ts b/packages/core/src/config/read-config-safely.test.ts
index b48cf803e..4cb8b70f7 100644
--- a/packages/core/src/config/read-config-safely.test.ts
+++ b/packages/core/src/config/read-config-safely.test.ts
@@ -1,11 +1,11 @@
import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { resolve } from 'node:path';
-import { afterEach, beforeEach, describe, expect, test } from 'vitest';
+import { afterEach, beforeEach, describe, expect, expectTypeOf, test } from 'vitest';
import { stringify } from 'yaml';
import { resolveThemePlugin } from '../theme/theme-plugins.ts';
import { isKnownConfigError } from './errors.ts';
-import { readConfigSafely } from './read-config-safely.ts';
+import { type ReadConfigSafelyResult, readConfigSafely } from './read-config-safely.ts';
import { REMOVED_KEYS } from './removed-keys.ts';
function isPlainObject(value: unknown): value is Record<string, unknown> {
@@ -46,6 +46,12 @@ afterEach(() => {
});
describe('readConfigSafely', () => {
+ test('successful reads expose only recovered diagnostic codes', () => {
+ expectTypeOf<
+ Extract<ReadConfigSafelyResult, { valid: true }>['diagnostics'][number]['code']
+ >().toEqualTypeOf<'REMOVED_KEY' | 'VALUE_FALLBACK'>();
+ });
+
test('missing file → valid=true, value is schema defaults', () => {
const result = readConfigSafely({ absPath: resolve(testDir, 'absent.yml') });
expect(result.valid).toBe(true);
@@ -68,6 +74,128 @@ describe('readConfigSafely', () => {
}
});
+ test.each([
+ ['maxBatchSize', 2_049, 96, 2_048],
+ ['maxBatchChars', 16_384_001, 96_000, 16_384_000],
+ ['docTimeoutMs', 2_147_483_648, 30_000, 600_000],
+ ] as const)(
+ 'invalid %s uses its default without discarding other settings',
+ (field, invalid, fallback, maximum) => {
+ const path = resolve(testDir, 'transport.yml');
+ const configured = {
+ autoSync: { mode: 'follow', pullIntervalSeconds: 45, pushIntervalSeconds: 90 },
+ linkPreviews: { enabled: false },
+ search: {
+ semantic: {
+ enabled: true,
+ baseUrl: 'http://localhost:11434/v1',
+ model: 'nomic-embed-text',
+ maxBatchSize: 2,
+ maxBatchChars: 16_000,
+ docTimeoutMs: 120_000,
+ [field]: invalid,
+ },
+ },
+ };
+ const source = stringify(configured);
+ writeFileSync(path, source, 'utf-8');
+
+ const warnings: string[] = [];
+ const result = readConfigSafely({ absPath: path, warn: (message) => warnings.push(message) });
+
+ expect(result.valid).toBe(true);
+ expect(result.value.autoSync).toMatchObject(configured.autoSync);
+ expect(result.value.linkPreviews).toEqual(configured.linkPreviews);
+ expect(result.value.search.semantic).toMatchObject({
+ ...configured.search.semantic,
+ [field]: fallback,
+ });
+ expect(readFileSync(path, 'utf-8')).toBe(source);
+ const message = `Expected an integer between 1 and ${maximum}; using default ${fallback}.`;
+ expect(result.diagnostics).toMatchObject([
+ {
+ code: 'VALUE_FALLBACK',
+ issues: [
+ {
+ path: ['search', 'semantic', field],
+ message,
+ source: { file: path, line: expect.any(Number), column: expect.any(Number) },
+ },
+ ],
+ },
+ ]);
+ expect(warnings).toEqual([]);
+ },
+ );
+
+ test('repeated reads report recovered leaves without warnings or raw values', () => {
+ const path = resolve(testDir, 'fallbacks.yml');
+ const source =
+ 'search:\n semantic:\n maxBatchSize: PRIVATE_INVALID_VALUE\n docTimeoutMs: null\n';
+ writeFileSync(path, source, 'utf-8');
+ const warnings: string[] = [];
+
+ const result = readConfigSafely({ absPath: path, warn: (message) => warnings.push(message) });
+
+ expect(result.valid).toBe(true);
+ expect(result.diagnostics).toMatchObject([
+ {
+ code: 'VALUE_FALLBACK',
+ issues: [
+ {
+ path: ['search', 'semantic', 'maxBatchSize'],
+ source: { file: path, line: 3, column: 19 },
+ },
+ {
+ path: ['search', 'semantic', 'docTimeoutMs'],
+ source: { file: path, line: 4, column: 19 },
+ },
+ ],
+ },
+ ]);
+ expect(readConfigSafely({ absPath: path, warn: (message) => warnings.push(message) })).toEqual(
+ result,
+ );
+ expect(warnings).toEqual([]);
+ expect(JSON.stringify(result.diagnostics)).not.toContain('PRIVATE_INVALID_VALUE');
+ expect(result.diagnostics).not.toEqual(
+ expect.arrayContaining([expect.objectContaining({ code: 'SCHEMA_INVALID' })]),
+ );
+ expect(readFileSync(path, 'utf-8')).toBe(source);
+ });
+
+ test.each([
+ ['absent', 'search:\n semantic:\n enabled: true\n'],
+ [
+ 'defaults',
+ 'search:\n semantic:\n maxBatchSize: 96\n maxBatchChars: 96000\n docTimeoutMs: 30000\n',
+ ],
+ [
+ 'minimums',
+ 'search:\n semantic:\n maxBatchSize: 1\n maxBatchChars: 1\n docTimeoutMs: 1\n',
+ ],
+ [
+ 'maximums',
+ 'search:\n semantic:\n maxBatchSize: 2048\n maxBatchChars: 16384000\n docTimeoutMs: 600000\n',
+ ],
+ ['scalar alias', 'batch: &batch 2\nsearch:\n semantic:\n maxBatchSize: *batch\n'],
+ [
+ 'mapping alias',
+ 'tuning: &tuning\n maxBatchSize: 2\n docTimeoutMs: 120000\nsearch:\n semantic: *tuning\n',
+ ],
+ ])('valid transport values (%s) produce no fallback diagnostics', (_name, source) => {
+ const path = resolve(testDir, 'valid-transport.yml');
+ writeFileSync(path, source, 'utf-8');
+ const warnings: string[] = [];
+
+ const result = readConfigSafely({ absPath: path, warn: (message) => warnings.push(message) });
+
+ expect(result.valid).toBe(true);
+ expect(result.diagnostics).toEqual([]);
+ expect(warnings).toEqual([]);
+ expect(readFileSync(path, 'utf-8')).toBe(source);
+ });
+
test('malformed YAML → valid=false, error.code=YAML_PARSE, file sidelined, value is defaults', () => {
const path = resolve(testDir, 'broken.yml');
writeFileSync(path, 'content:\n dir: [invalid yaml', 'utf-8');
diff --git a/packages/core/src/config/read-config-safely.ts b/packages/core/src/config/read-config-safely.ts
index 29dfa115d..fb1f11a94 100644
--- a/packages/core/src/config/read-config-safely.ts
+++ b/packages/core/src/config/read-config-safely.ts
@@ -5,10 +5,20 @@ import {
type ConfigIssue,
type ConfigValidationError,
isKnownConfigError,
- type RemovedKeyDiagnostic,
+ type RecoveredConfigDiagnostic,
+ type ValueFallbackDiagnostic,
} from './errors.ts';
import { detectRemovedKeys, stripRemovedKeys } from './removed-keys.ts';
-import { type Config, ConfigSchema } from './schema.ts';
+import {
+ type Config,
+ ConfigSchema,
+ MAX_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MAX_EMBEDDINGS_MAX_BATCH_CHARS,
+ MAX_EMBEDDINGS_MAX_BATCH_SIZE,
+ MIN_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MIN_EMBEDDINGS_MAX_BATCH_CHARS,
+ MIN_EMBEDDINGS_MAX_BATCH_SIZE,
+} from './schema.ts';
import { locateIssue } from './source-locator.ts';
export interface ReadConfigSafelyOptions {
@@ -23,7 +33,7 @@ export type ReadConfigSafelyResult =
valid: true;
value: Config;
source?: string;
- diagnostics: RemovedKeyDiagnostic[];
+ diagnostics: RecoveredConfigDiagnostic[];
}
| {
valid: false;
@@ -76,6 +86,51 @@ function attemptSideline(
}
}
+function rawValueAtPath(value: unknown, path: readonly string[]): unknown {
+ let current = value;
+ for (const segment of path) {
+ if (current === null || typeof current !== 'object' || Array.isArray(current)) return undefined;
+ current = Reflect.get(current, segment);
+ }
+ return current;
+}
+
+function detectEmbeddingsTransportFallbacks(input: {
+ rawConfig: unknown;
+ config: Config;
+ doc: Document;
+ source: string;
+ absPath: string;
+}): ValueFallbackDiagnostic[] {
+ const issues: ValueFallbackDiagnostic['issues'] = [];
+ const transportFields = [
+ ['maxBatchSize', MIN_EMBEDDINGS_MAX_BATCH_SIZE, MAX_EMBEDDINGS_MAX_BATCH_SIZE],
+ ['maxBatchChars', MIN_EMBEDDINGS_MAX_BATCH_CHARS, MAX_EMBEDDINGS_MAX_BATCH_CHARS],
+ ['docTimeoutMs', MIN_EMBEDDINGS_DOC_TIMEOUT_MS, MAX_EMBEDDINGS_DOC_TIMEOUT_MS],
+ ] as const;
+ for (const [field, minimum, maximum] of transportFields) {
+ const path = ['search', 'semantic', field];
+ const raw = rawValueAtPath(input.rawConfig, path);
+ const effective = input.config.search.semantic[field];
+ if (raw === undefined || raw === effective) continue;
+ const message = `Expected an integer between ${minimum} and ${maximum}; using default ${effective}.`;
+ const located = locateIssue({
+ file: input.absPath,
+ source: input.source,
+ doc: input.doc,
+ path,
+ });
+ issues.push({
+ path,
+ message,
+ ...(located !== undefined
+ ? { source: { file: located.file, line: located.line, column: located.column } }
+ : {}),
+ });
+ }
+ return issues.length > 0 ? [{ code: 'VALUE_FALLBACK', issues }] : [];
+}
+
export function readConfigSafely(options: ReadConfigSafelyOptions): ReadConfigSafelyResult {
const { absPath, sideline = true, timestamp = new Date().toISOString() } = options;
const warn = options.warn ?? ((msg: string) => console.warn(msg));
@@ -144,5 +199,15 @@ export function readConfigSafely(options: ReadConfigSafelyOptions): ReadConfigSa
};
}
- return { valid: true, value: parsed.data, source: absPath, diagnostics: removedKeyDiagnostics };
+ const diagnostics: RecoveredConfigDiagnostic[] = [
+ ...removedKeyDiagnostics,
+ ...detectEmbeddingsTransportFallbacks({
+ rawConfig: cleaned,
+ config: parsed.data,
+ doc,
+ source,
+ absPath,
+ }),
+ ];
+ return { valid: true, value: parsed.data, source: absPath, diagnostics };
}
diff --git a/packages/core/src/config/schema-jsonschema.test.ts b/packages/core/src/config/schema-jsonschema.test.ts
index 63929684d..74cbed590 100644
--- a/packages/core/src/config/schema-jsonschema.test.ts
+++ b/packages/core/src/config/schema-jsonschema.test.ts
@@ -396,3 +396,43 @@ describe('loose-mode forgiveness', () => {
expect(config.bridge.flushOnHide.enabled).toBe(false);
});
});
+
+describe('semantic embedding transport JSON schema', () => {
+ test('publishes bounded-integer constraints and legacy defaults', () => {
+ const root = jsonSchema as {
+ properties?: {
+ search?: {
+ properties?: {
+ semantic?: { properties?: Record<string, unknown> };
+ };
+ };
+ };
+ };
+ const properties = root.properties?.search?.properties?.semantic?.properties;
+
+ expect(properties?.maxBatchSize).toMatchObject({
+ type: 'integer',
+ minimum: 1,
+ maximum: 2_048,
+ default: 96,
+ });
+ expect(properties?.maxBatchChars).toMatchObject({
+ type: 'integer',
+ minimum: 1,
+ maximum: 16_384_000,
+ default: 96_000,
+ });
+ expect(properties?.docTimeoutMs).toMatchObject({
+ type: 'integer',
+ minimum: 1,
+ maximum: 600_000,
+ default: 30_000,
+ });
+ });
+
+ test('schema tooling rejects an excessive timeout while runtime loading uses its default', () => {
+ const input = { search: { semantic: { docTimeoutMs: 2_147_483_648 } } };
+ expect(validate(input)).toBe(false);
+ expect(ConfigSchema.parse(input).search.semantic.docTimeoutMs).toBe(30_000);
+ });
+});
diff --git a/packages/core/src/config/schema.test.ts b/packages/core/src/config/schema.test.ts
index 21ba0c5d8..ad2a4c2d0 100644
--- a/packages/core/src/config/schema.test.ts
+++ b/packages/core/src/config/schema.test.ts
@@ -421,3 +421,69 @@ describe('server.* (canonical listener/exposure surface)', () => {
}
});
});
+
+describe('search.semantic embedding transport tuning', () => {
+ test('accepts positive integer overrides and keeps the legacy defaults when absent', () => {
+ const configured = ConfigSchema.parse({
+ search: {
+ semantic: {
+ maxBatchSize: 2,
+ maxBatchChars: 16_000,
+ docTimeoutMs: 120_000,
+ },
+ },
+ }).search.semantic;
+ expect(configured.maxBatchSize).toBe(2);
+ expect(configured.maxBatchChars).toBe(16_000);
+ expect(configured.docTimeoutMs).toBe(120_000);
+
+ const defaults = ConfigSchema.parse({}).search.semantic;
+ expect(defaults.maxBatchSize).toBe(96);
+ expect(defaults.maxBatchChars).toBe(96_000);
+ expect(defaults.docTimeoutMs).toBe(30_000);
+ });
+
+ test.each([
+ ['maxBatchSize', 2_048, 96],
+ ['maxBatchChars', 16_384_000, 96_000],
+ ['docTimeoutMs', 600_000, 30_000],
+ ] as const)(
+ '%s preserves range endpoints and defaults invalid values',
+ (field, max, fallback) => {
+ for (const valid of [1, max]) {
+ expect(
+ ConfigSchema.parse({ search: { semantic: { [field]: valid } } }).search.semantic[field],
+ ).toBe(valid);
+ }
+ for (const invalid of [
+ 0,
+ -1,
+ 1.5,
+ '2',
+ null,
+ max + 1,
+ 2_147_483_648,
+ Number.NaN,
+ Number.POSITIVE_INFINITY,
+ ]) {
+ const parsed = ConfigSchema.safeParse({ search: { semantic: { [field]: invalid } } });
+ expect(parsed.success).toBe(true);
+ if (parsed.success) {
+ expect(parsed.data.search.semantic[field]).toBe(fallback);
+ }
+ }
+ },
+ );
+
+ test.each(['maxBatchSize', 'maxBatchChars', 'docTimeoutMs'] as const)(
+ '%s is project-local, non-agent-settable, and live-reloaded',
+ (field) => {
+ expect(getLeafFieldMeta(ConfigSchema, ['search', 'semantic', field])).toMatchObject({
+ scope: 'project-local',
+ defaultScope: 'project-local',
+ agentSettable: false,
+ reload: 'live',
+ });
+ },
+ );
+});
diff --git a/packages/core/src/config/schema.ts b/packages/core/src/config/schema.ts
index ffd6d3c6f..d602aad92 100644
--- a/packages/core/src/config/schema.ts
+++ b/packages/core/src/config/schema.ts
@@ -54,6 +54,15 @@ const DEFAULT_LOSS_CAPTURE_MAX_BYTES = 12_582_912;
export const DEFAULT_EMBEDDINGS_BASE_URL = 'https://api.openai.com/v1';
export const DEFAULT_EMBEDDINGS_MODEL = 'text-embedding-3-small';
+export const DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE = 96;
+export const DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS = 96_000;
+export const DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS = 30_000;
+export const MIN_EMBEDDINGS_MAX_BATCH_SIZE = 1;
+export const MAX_EMBEDDINGS_MAX_BATCH_SIZE = 2_048;
+export const MIN_EMBEDDINGS_MAX_BATCH_CHARS = 1;
+export const MAX_EMBEDDINGS_MAX_BATCH_CHARS = 16_384_000;
+export const MIN_EMBEDDINGS_DOC_TIMEOUT_MS = 1;
+export const MAX_EMBEDDINGS_DOC_TIMEOUT_MS = 600_000;
export const DEFAULT_SERVER_BIND: readonly string[] = Object.freeze(['127.0.0.1']);
@@ -797,11 +806,59 @@ export const ConfigSchema = z.looseObject({
'Optional hard cutoff: drop any "by meaning" match whose cosine similarity is below this value. Off by default (0) because retrieval is rank-based (the closest pages are returned regardless of absolute score) and the right cutoff is model-specific. Set it only to suppress weak matches for a specific provider/model whose cosine scale you know. Most setups should leave it unset and rely on the result-count cap.',
})
.optional(),
+ maxBatchSize: z
+ .number()
+ .int()
+ .min(MIN_EMBEDDINGS_MAX_BATCH_SIZE)
+ .max(MAX_EMBEDDINGS_MAX_BATCH_SIZE)
+ .register(fieldRegistry, {
+ scope: 'project-local',
+ agentSettable: false,
+ reload: 'live',
+ defaultScope: 'project-local',
+ description:
+ "Maximum number of text chunks sent in one indexing request (1–2048, default 96). The ceiling follows OpenAI's input-array limit; other providers may impose different limits. Larger requests may still be split by the character budget. Changing it preserves cached vectors and document chunking; it applies to the next indexing pass. Invalid values use the default and are reported by ok config validate and server logs.",
+ })
+ .default(DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE)
+ .catch(DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE),
+ maxBatchChars: z
+ .number()
+ .int()
+ .min(MIN_EMBEDDINGS_MAX_BATCH_CHARS)
+ .max(MAX_EMBEDDINGS_MAX_BATCH_CHARS)
+ .register(fieldRegistry, {
+ scope: 'project-local',
+ agentSettable: false,
+ reload: 'live',
+ defaultScope: 'project-local',
+ description:
+ 'Approximate cumulative character budget per indexing request (1–16384000, default 96000). A single chunk can exceed this budget. OpenAI separately caps total input at 300000 tokens per request; this character budget does not enforce that limit, and high values can produce rejected requests. Other providers have their own limits. Changing it preserves cached vectors and document chunking; it applies to the next indexing pass. Invalid values use the default and are reported by ok config validate and server logs.',
+ })
+ .default(DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS)
+ .catch(DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS),
+ docTimeoutMs: z
+ .number()
+ .int()
+ .min(MIN_EMBEDDINGS_DOC_TIMEOUT_MS)
+ .max(MAX_EMBEDDINGS_DOC_TIMEOUT_MS)
+ .register(fieldRegistry, {
+ scope: 'project-local',
+ agentSettable: false,
+ reload: 'live',
+ defaultScope: 'project-local',
+ description:
+ 'Timeout in milliseconds for each indexing request attempt (1–600000, default 30000). A request can retry four times, and a failed grouped request can trigger individual-document requests. There is no total indexing-pass deadline: large timeouts can delay newly queued work for hours. The query timeout remains 8 seconds per attempt. Changing it preserves cached vectors and applies to the next indexing pass; an in-progress pass keeps its current timeout. Invalid values use the default and are reported by ok config validate and server logs.',
+ })
+ .default(DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS)
+ .catch(DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS),
})
.default({
enabled: false,
baseUrl: DEFAULT_EMBEDDINGS_BASE_URL,
model: DEFAULT_EMBEDDINGS_MODEL,
+ maxBatchSize: DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ maxBatchChars: DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ docTimeoutMs: DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
}),
})
.default({
@@ -809,6 +866,9 @@ export const ConfigSchema = z.looseObject({
enabled: false,
baseUrl: DEFAULT_EMBEDDINGS_BASE_URL,
model: DEFAULT_EMBEDDINGS_MODEL,
+ maxBatchSize: DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ maxBatchChars: DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ docTimeoutMs: DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
},
}),
contentRules: z
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 3936c608c..adcd98757 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -268,9 +268,11 @@ export {
isKnownConfigError,
type KnownConfigValidationError,
KnownConfigValidationErrorSchema,
+ type RecoveredConfigDiagnostic,
type RemovedKeyDiagnostic,
type ScopedConfigDiagnostic,
ScopedConfigDiagnosticSchema,
+ type ValueFallbackDiagnostic,
type WriteScope,
WriteScopeSchema,
} from './config/errors.ts';
@@ -304,6 +306,9 @@ export {
ConfigSchema,
checkEmbeddingsBaseUrl,
DEFAULT_EMBEDDINGS_BASE_URL,
+ DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
DEFAULT_EMBEDDINGS_MODEL,
DEFAULT_LOGS_MAX_BYTES,
DEFAULT_SERVER_BIND,
@@ -313,6 +318,12 @@ export {
IDLE_SHUTDOWN_DURATION_RE,
isLoopbackEmbeddingsUrl,
isValidAttachmentFolderPath,
+ MAX_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MAX_EMBEDDINGS_MAX_BATCH_CHARS,
+ MAX_EMBEDDINGS_MAX_BATCH_SIZE,
+ MIN_EMBEDDINGS_DOC_TIMEOUT_MS,
+ MIN_EMBEDDINGS_MAX_BATCH_CHARS,
+ MIN_EMBEDDINGS_MAX_BATCH_SIZE,
normalizeAttachmentFolderPath,
} from './config/schema.ts';
export { getLeafFieldMeta, resolveLeafSchema } from './config/schema-leaf.ts';
diff --git a/packages/server/src/api-search-semantic-factory.test.ts b/packages/server/src/api-search-semantic-factory.test.ts
index 8e31916db..587b0cd2e 100644
--- a/packages/server/src/api-search-semantic-factory.test.ts
+++ b/packages/server/src/api-search-semantic-factory.test.ts
@@ -4,8 +4,10 @@ import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { Readable } from 'node:stream';
import type { Extension } from '@hocuspocus/server';
-import { afterAll, beforeAll, describe, expect, test } from 'vitest';
-import { createConceptEmbedder } from './embeddings/index.ts';
+import { CONFIG_DOC_NAME_PROJECT_LOCAL } from '@inkeep/open-knowledge-core';
+import { afterAll, beforeAll, describe, expect, test, vi } from 'vitest';
+import { createConceptEmbedder, type LoadOpenAiEmbedderInput } from './embeddings/index.ts';
+import { getLogger } from './logger.ts';
import { createServer, type ServerInstance } from './server-factory.ts';
import { initShadowRepo } from './shadow-repo.ts';
@@ -64,6 +66,7 @@ function makeRes(): { res: ServerResponse; captured: { status: number; body: str
let tmpDir: string;
let server: ServerInstance;
+let observedLoaderInput: LoadOpenAiEmbedderInput | undefined;
async function callViaServer(
srv: ServerInstance,
@@ -121,7 +124,7 @@ beforeAll(async () => {
mkdirSync(join(tmpDir, '.ok', 'local'), { recursive: true });
writeFileSync(
join(tmpDir, '.ok', 'local', 'config.yml'),
- 'search:\n semantic:\n enabled: true\n',
+ 'search:\n semantic:\n enabled: true\n maxBatchSize: 2\n maxBatchChars: 16000\n docTimeoutMs: 120000\n',
'utf-8',
);
writeFileSync(
@@ -142,7 +145,10 @@ beforeAll(async () => {
skipStateManifestCheck: true,
destroyTimeoutMs: 500,
configHomedirOverride: tmpDir,
- embedderLoader: () => Promise.resolve(embedder),
+ embedderLoader: (input) => {
+ observedLoaderInput = input;
+ return Promise.resolve(embedder);
+ },
});
await server.ready;
});
@@ -185,6 +191,11 @@ describe('createServer boot — flag-ON semantic search (factory glue)', () => {
expect(hiddenHit?.signals.vector, 'but a hidden dot-path is never embedded').toBeUndefined();
expect(existsSync(join(tmpDir, '.ok', 'local', 'embeddings'))).toBe(true);
+ expect(observedLoaderInput?.options).toMatchObject({
+ maxBatchSize: 2,
+ maxBatchChars: 16_000,
+ docTimeoutMs: 120_000,
+ });
}, 30_000);
test('GET /api/semantic-status reports enabled + ready + capable + coverage', async () => {
@@ -288,6 +299,262 @@ describe('createServer boot — project-local scope enforcement (egress safety)'
});
});
+test.each([120_000, 900_000])(
+ 'transport fallback warnings occur only on load and reload (initial timeout %i)',
+ async (initialTimeout) => {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-sem-fallback-reload-'));
+ const warn = vi.spyOn(getLogger('server'), 'warn');
+ let srv: ServerInstance | undefined;
+ let loaderInput: LoadOpenAiEmbedderInput | undefined;
+ try {
+ writeFileSync(join(dir, 'note.md'), '# Note\n\nAuthentication retries.\n', 'utf-8');
+ mkdirSync(join(dir, '.ok', 'local'), { recursive: true });
+ const localPath = join(dir, '.ok', 'local', 'config.yml');
+ const source = `search:\n semantic:\n enabled: true\n baseUrl: http://localhost:11434/v1\n model: local-embedding\n maxBatchSize: 2\n maxBatchChars: 16000\n docTimeoutMs: ${initialTimeout}\n`;
+ writeFileSync(localPath, source, 'utf-8');
+ srv = createServer({
+ contentDir: dir,
+ projectDir: dir,
+ quiet: true,
+ debounce: 60_000,
+ gitEnabled: false,
+ shadowRepo: await initShadowRepo(dir),
+ skipStateManifestCheck: true,
+ destroyTimeoutMs: 500,
+ configHomedirOverride: dir,
+ embedderLoader: (input) => {
+ loaderInput = input;
+ return Promise.resolve(createConceptEmbedder({ concepts: CONCEPTS }));
+ },
+ });
+ const activeServer = srv;
+ await activeServer.ready;
+ const fallbackWarnings = () =>
+ warn.mock.calls.filter(
+ ([details]) =>
+ typeof details === 'object' &&
+ details !== null &&
+ 'code' in details &&
+ details.code === 'VALUE_FALLBACK',
+ );
+ const initialWarningCount = initialTimeout === 900_000 ? 1 : 0;
+ expect(fallbackWarnings()).toHaveLength(initialWarningCount);
+ await vi.waitFor(async () => {
+ await searchViaServer(activeServer, { query: 'authentication', semantic: true });
+ expect(loaderInput?.options?.docTimeoutMs).toBe(
+ initialTimeout === 900_000 ? 30_000 : initialTimeout,
+ );
+ });
+ expect(fallbackWarnings()).toHaveLength(initialWarningCount);
+ warn.mockClear();
+ const edited = source.replace(`docTimeoutMs: ${initialTimeout}`, 'docTimeoutMs: 900001');
+ writeFileSync(localPath, edited, 'utf-8');
+
+ await vi.waitFor(
+ () => {
+ expect(fallbackWarnings()).toEqual([
+ [
+ {
+ code: 'VALUE_FALLBACK',
+ scope: 'project-local',
+ file: localPath,
+ path: 'search.semantic.docTimeoutMs',
+ line: 8,
+ column: expect.any(Number),
+ },
+ '[config] search.semantic.docTimeoutMs: Expected an integer between 1 and 600000; using default 30000.',
+ ],
+ ]);
+ },
+ { timeout: 10_000 },
+ );
+ await vi.waitFor(async () => {
+ await searchViaServer(activeServer, { query: 'authentication', semantic: true });
+ expect(loaderInput?.options).toMatchObject({
+ maxBatchSize: 2,
+ maxBatchChars: 16_000,
+ docTimeoutMs: 30_000,
+ });
+ });
+ expect(loaderInput?.config).toMatchObject({
+ baseUrl: 'http://localhost:11434/v1',
+ model: 'local-embedding',
+ });
+ expect(readFileSync(localPath, 'utf-8')).toBe(edited);
+ expect(await callViaServer(activeServer, 'GET', '/api/config/diagnostics')).toMatchObject({
+ diagnostics: [{ code: 'VALUE_FALLBACK', scope: 'project-local', file: localPath }],
+ });
+ for (let request = 0; request < 3; request += 1) {
+ await searchViaServer(activeServer, { query: 'authentication', semantic: true });
+ await callViaServer(activeServer, 'GET', '/api/config/diagnostics');
+ }
+ expect(fallbackWarnings()).toHaveLength(1);
+ expect(
+ warn.mock.calls.some(
+ ([, message]) => message === '[config] could not read project-local config',
+ ),
+ ).toBe(false);
+ } finally {
+ await srv?.destroy();
+ warn.mockRestore();
+ rmSync(dir, { recursive: true, force: true });
+ }
+ },
+ 30_000,
+);
+
+test('persisted Y.Text transport fallback warns once after the file watcher echo', async () => {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-sem-fallback-persist-'));
+ const warn = vi.spyOn(getLogger('server'), 'warn');
+ const info = vi.spyOn(getLogger('server'), 'info');
+ let srv: ServerInstance | undefined;
+ let loaderInput: LoadOpenAiEmbedderInput | undefined;
+ try {
+ writeFileSync(join(dir, 'note.md'), '# Note\n\nAuthentication retries.\n', 'utf-8');
+ mkdirSync(join(dir, '.ok', 'local'), { recursive: true });
+ const localPath = join(dir, '.ok', 'local', 'config.yml');
+ const source =
+ 'search:\n semantic:\n enabled: true\n baseUrl: http://localhost:11434/v1\n model: local-embedding\n maxBatchSize: 2\n maxBatchChars: 16000\n docTimeoutMs: 120000\n';
+ writeFileSync(localPath, source, 'utf-8');
+ srv = createServer({
+ contentDir: dir,
+ projectDir: dir,
+ quiet: true,
+ debounce: 60_000,
+ gitEnabled: false,
+ shadowRepo: await initShadowRepo(dir),
+ skipStateManifestCheck: true,
+ destroyTimeoutMs: 500,
+ configHomedirOverride: dir,
+ embedderLoader: (input) => {
+ loaderInput = input;
+ return Promise.resolve(createConceptEmbedder({ concepts: CONCEPTS }));
+ },
+ });
+ const activeServer = srv;
+ await activeServer.ready;
+ await vi.waitFor(async () => {
+ await searchViaServer(activeServer, { query: 'authentication', semantic: true });
+ expect(loaderInput?.options?.docTimeoutMs).toBe(120_000);
+ });
+ warn.mockClear();
+ info.mockClear();
+ const edited = source.replace('docTimeoutMs: 120000', 'docTimeoutMs: 900000');
+ const connection = await activeServer.hocuspocus.openDirectConnection(
+ CONFIG_DOC_NAME_PROJECT_LOCAL,
+ );
+ const document = connection.document;
+ if (!document) throw new Error('expected an open config document');
+ const origin = Object.freeze({ source: 'local', context: {} });
+ document.transact(() => {
+ const ytext = document.getText('source');
+ ytext.delete(0, ytext.length);
+ ytext.insert(0, edited);
+ }, origin);
+ await connection.disconnect();
+
+ await vi.waitFor(
+ () => {
+ expect(info).toHaveBeenCalledWith(
+ { docName: CONFIG_DOC_NAME_PROJECT_LOCAL, outcome: 'no-op', isEcho: true },
+ '[config-file-watcher] applyExternalConfigChange outcome',
+ );
+ },
+ { timeout: 10_000 },
+ );
+ await vi.waitFor(async () => {
+ await searchViaServer(activeServer, { query: 'authentication', semantic: true });
+ expect(loaderInput?.options).toMatchObject({
+ maxBatchSize: 2,
+ maxBatchChars: 16_000,
+ docTimeoutMs: 30_000,
+ });
+ });
+ expect(loaderInput?.config).toMatchObject({
+ baseUrl: 'http://localhost:11434/v1',
+ model: 'local-embedding',
+ });
+ expect(readFileSync(localPath, 'utf-8')).toBe(edited);
+ expect(
+ warn.mock.calls.filter(
+ ([details]) =>
+ typeof details === 'object' &&
+ details !== null &&
+ 'code' in details &&
+ details.code === 'VALUE_FALLBACK',
+ ),
+ ).toEqual([
+ [
+ {
+ code: 'VALUE_FALLBACK',
+ scope: 'project-local',
+ file: localPath,
+ path: 'search.semantic.docTimeoutMs',
+ line: 8,
+ column: expect.any(Number),
+ },
+ '[config] search.semantic.docTimeoutMs: Expected an integer between 1 and 600000; using default 30000.',
+ ],
+ ]);
+ } finally {
+ await srv?.destroy();
+ warn.mockRestore();
+ info.mockRestore();
+ rmSync(dir, { recursive: true, force: true });
+ }
+}, 30_000);
+
+test('generated-index settings do not repeat an unrelated project-local fallback warning', async () => {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-sem-fallback-generated-index-'));
+ const warn = vi.spyOn(getLogger('server'), 'warn');
+ let srv: ServerInstance | undefined;
+ try {
+ writeFileSync(join(dir, 'note.md'), '# Note\n', 'utf-8');
+ mkdirSync(join(dir, '.ok', 'local'), { recursive: true });
+ const localPath = join(dir, '.ok', 'local', 'config.yml');
+ writeFileSync(localPath, 'search:\n semantic:\n docTimeoutMs: 900000\n', 'utf-8');
+ writeFileSync(
+ join(dir, '.ok', 'config.yml'),
+ 'contentRules:\n okf:\n generate:\n index: false\n',
+ 'utf-8',
+ );
+ srv = createServer({
+ contentDir: dir,
+ projectDir: dir,
+ quiet: true,
+ debounce: 60_000,
+ gitEnabled: false,
+ shadowRepo: await initShadowRepo(dir),
+ skipStateManifestCheck: true,
+ destroyTimeoutMs: 500,
+ configHomedirOverride: dir,
+ });
+ const activeServer = srv;
+ await activeServer.ready;
+ const fallbackWarnings = () =>
+ warn.mock.calls.filter(
+ ([details]) =>
+ typeof details === 'object' &&
+ details !== null &&
+ 'code' in details &&
+ details.code === 'VALUE_FALLBACK',
+ );
+ expect(fallbackWarnings()).toHaveLength(1);
+ warn.mockClear();
+ expect(
+ await callViaServer(activeServer, 'POST', '/api/generated-index/settings', { enabled: true }),
+ ).toMatchObject({ enabled: true, applied: true });
+ expect(await callViaServer(activeServer, 'GET', '/api/config/diagnostics')).toMatchObject({
+ diagnostics: [{ code: 'VALUE_FALLBACK', scope: 'project-local', file: localPath }],
+ });
+ expect(fallbackWarnings()).toHaveLength(0);
+ } finally {
+ await srv?.destroy();
+ warn.mockRestore();
+ rmSync(dir, { recursive: true, force: true });
+ }
+}, 30_000);
+
describe('createServer boot — similarityFloor config reaches core ranking', () => {
test('a high project-local similarityFloor gates out a vector-only match the default would surface', async () => {
const dir = mkdtempSync(join(tmpdir(), 'ok-sem-floor-'));
diff --git a/packages/server/src/config-persistence.test.ts b/packages/server/src/config-persistence.test.ts
index 5d622bab3..d1bb5979b 100644
--- a/packages/server/src/config-persistence.test.ts
+++ b/packages/server/src/config-persistence.test.ts
@@ -28,6 +28,7 @@ import {
applyExternalConfigChange,
type ConfigPersistenceCtx,
configDocAbsPath,
+ isConfigEcho,
loadConfigDoc,
storeConfigDoc,
} from './config-persistence.ts';
@@ -778,6 +779,7 @@ describe('applyExternalConfigChange', () => {
const outcome = applyExternalConfigChange(doc, CONFIG_DOC_NAME_PROJECT, yaml, fx.ctx);
expect(outcome).toBe('no-op');
+ expect(isConfigEcho(CONFIG_DOC_NAME_PROJECT, yaml, fx.ctx)).toBe(true);
expect(mutationCount).toBe(0);
expect(fx.rejections).toHaveLength(0);
});
@@ -790,9 +792,33 @@ describe('applyExternalConfigChange', () => {
fx.ctx,
);
expect(outcome).toBe('no-op');
+ expect(isConfigEcho(CONFIG_DOC_NAME_PROJECT, 'theme: dark\n', fx.ctx)).toBe(false);
+ expect(isConfigEcho(CONFIG_DOC_NAME_PROJECT, '', fx.ctx)).toBe(false);
expect(fx.rejections).toHaveLength(0);
});
+ test.each(['mcp:\n autoStart: false\n', ''])(
+ 'distinguishes cached echoes from new content after unloading (%j)',
+ (content) => {
+ const doc = new Y.Doc();
+ expect(applyExternalConfigChange(doc, CONFIG_DOC_NAME_PROJECT, content, fx.ctx)).toBe(
+ 'applied',
+ );
+ doc.destroy();
+
+ expect(isConfigEcho(CONFIG_DOC_NAME_PROJECT, content, fx.ctx)).toBe(true);
+ expect(applyExternalConfigChange(null, CONFIG_DOC_NAME_PROJECT, content, fx.ctx)).toBe(
+ 'no-op',
+ );
+ const changed = 'mcp:\n autoStart: true\n';
+ expect(isConfigEcho(CONFIG_DOC_NAME_PROJECT, changed, fx.ctx)).toBe(false);
+ expect(applyExternalConfigChange(null, CONFIG_DOC_NAME_PROJECT, changed, fx.ctx)).toBe(
+ 'no-op',
+ );
+ expect(isConfigEcho(CONFIG_DOC_NAME_PROJECT, changed, fx.ctx)).toBe(false);
+ },
+ );
+
test('YAML parse error → rejected; Y.Text NOT mutated; onConfigRejected fired', () => {
const doc = new Y.Doc();
const valid = 'theme: light\n';
diff --git a/packages/server/src/config-persistence.ts b/packages/server/src/config-persistence.ts
index a2a3ba340..edf7c453a 100644
--- a/packages/server/src/config-persistence.ts
+++ b/packages/server/src/config-persistence.ts
@@ -404,6 +404,14 @@ async function storeConfigDocInner(
type ApplyExternalConfigChangeOutcome = 'applied' | 'rejected' | 'no-op';
+export function isConfigEcho(
+ documentName: string,
+ content: string,
+ ctx: ConfigPersistenceCtx,
+): boolean {
+ return ctx.lkgCache.get(documentName) === content;
+}
+
export function applyExternalConfigChange(
document: Y.Doc | null,
documentName: string,
@@ -412,8 +420,7 @@ export function applyExternalConfigChange(
): ApplyExternalConfigChangeOutcome {
if (!document) return 'no-op';
- const lkg = ctx.lkgCache.get(documentName);
- if (lkg !== undefined && lkg === content) return 'no-op';
+ if (isConfigEcho(documentName, content, ctx)) return 'no-op';
const scope = configScopeAttr(documentName);
const validation = withConfigSpanSync(
diff --git a/packages/server/src/embeddings/auto-dimensions.test.ts b/packages/server/src/embeddings/auto-dimensions.test.ts
index 3135156e2..864c3cb65 100644
--- a/packages/server/src/embeddings/auto-dimensions.test.ts
+++ b/packages/server/src/embeddings/auto-dimensions.test.ts
@@ -5,7 +5,8 @@ import {
createWorkspaceSearchDocument,
type WorkspaceSearchDocument,
} from '@inkeep/open-knowledge-core';
-import { afterEach, beforeEach, describe, expect, test } from 'vitest';
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+import { getLogger } from '../logger.ts';
import { createOpenAiEmbedder } from './embedder.ts';
import {
createFakeEmbeddingsFetch,
@@ -131,17 +132,30 @@ describe('auto-detected embedding dimensions', () => {
});
test('a query-side size change recovers even when no document changed', async () => {
- const { service } = makeService({ dims: 1024, driftDims: 1536, driftAfterRequests: 1 });
- await service.embedCorpus(corpus);
- expect(service.getStatus().embeddedCount).toBe(corpus.length);
-
- expect(await service.queryScores('session credentials', corpus)).toBeNull();
- expect(service.getStatus().ready).toBe(false);
+ const info = vi.spyOn(getLogger('embeddings'), 'info');
+ try {
+ const { service } = makeService({ dims: 1024, driftDims: 1536, driftAfterRequests: 1 });
+ await service.embedCorpus(corpus);
+ expect(service.getStatus().embeddedCount).toBe(corpus.length);
- await service.embedCorpus(corpus);
- const scores = await service.queryScores('session credentials', corpus);
- expect(scores?.size).toBe(corpus.length);
- expect(readManifest().dims).toBe(1536);
+ expect(await service.queryScores('session credentials', corpus)).toBeNull();
+ expect(service.getStatus().ready).toBe(false);
+ expect(info).toHaveBeenCalledWith(
+ {
+ reason: 'dimensions',
+ retainedInMemoryDocumentCount: 0,
+ unloadedInMemoryDocumentCount: corpus.length,
+ },
+ '[embeddings] resetting embedder',
+ );
+
+ await service.embedCorpus(corpus);
+ const scores = await service.queryScores('session credentials', corpus);
+ expect(scores?.size).toBe(corpus.length);
+ expect(readManifest().dims).toBe(1536);
+ } finally {
+ info.mockRestore();
+ }
});
test('survives exactly MAX_DIMS_DRIFT_RESETS size changes, then gives up', async () => {
@@ -202,7 +216,12 @@ describe('auto-detected embedding dimensions', () => {
expect(await service.queryScores('session credentials', corpus)).toBeNull();
expect(requests.length).toBe(spent);
- service.applyConfig({ enabled: true, providerFingerprint: `${BASE_URL}|other|auto` });
+ service.applyConfig({
+ enabled: true,
+ providerFingerprint: `${BASE_URL}|other|auto`,
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
await service.embedCorpus(nextCorpus());
await service.embedCorpus(nextCorpus());
expect(requests.length).toBeGreaterThan(spent);
@@ -218,6 +237,8 @@ describe('auto-detected embedding dimensions', () => {
first.service.applyConfig({
enabled: true,
providerFingerprint: `${BASE_URL}|another-model|auto`,
+ transportFingerprint: '',
+ maxBatchSize: 96,
});
expect(first.service.getStatus().embeddedCount).toBe(0);
diff --git a/packages/server/src/embeddings/embedder.test.ts b/packages/server/src/embeddings/embedder.test.ts
index 2a0339c7d..ebb560830 100644
--- a/packages/server/src/embeddings/embedder.test.ts
+++ b/packages/server/src/embeddings/embedder.test.ts
@@ -1,4 +1,4 @@
-import { afterEach, describe, expect, test } from 'vitest';
+import { afterEach, describe, expect, test, vi } from 'vitest';
import {
cosineSimilarity,
createOpenAiEmbedder,
@@ -105,6 +105,22 @@ describe('createOpenAiEmbedder', () => {
expect((calls[1].body as { input: string[] }).input).toEqual(['c']);
});
+ test('splits document inputs by the cumulative character budget', async () => {
+ const { fetchImpl, calls } = stubFetch([
+ { json: embeddingsResponse(2, 8) },
+ { json: embeddingsResponse(1, 8) },
+ ]);
+ const embedder = createOpenAiEmbedder(
+ { baseUrl: 'https://x/v1', model: 'm', dimensions: 8, apiKey: KEY },
+ { fetchImpl, sleep: noSleep, maxBatchChars: 5 },
+ );
+ await embedder.embed(['aa', 'bbb', 'c'], { role: 'document' });
+ expect(calls.map((call) => (call.body as { input: string[] }).input)).toEqual([
+ ['aa', 'bbb'],
+ ['c'],
+ ]);
+ });
+
test('sends the dimensions param only when configured', async () => {
const withDims = stubFetch([{ json: embeddingsResponse(1, 512) }]);
await createOpenAiEmbedder(
@@ -183,6 +199,41 @@ describe('createOpenAiEmbedder', () => {
expect(caught).not.toBeNull();
});
+ test('uses the configured document timeout without changing the query timeout', async () => {
+ vi.useFakeTimers();
+ try {
+ const { fetchImpl } = stubFetch([{ abortable: true }]);
+ const embedder = createOpenAiEmbedder(
+ { baseUrl: 'https://x/v1', model: 'm', apiKey: KEY },
+ {
+ fetchImpl,
+ sleep: noSleep,
+ maxRetries: 0,
+ queryTimeoutMs: 10,
+ docTimeoutMs: 100,
+ },
+ );
+
+ const query = embedder.embed(['q'], { role: 'query' });
+ const queryAssertion = expect(query).rejects.toMatchObject({ reason: 'timeout' });
+ await vi.advanceTimersByTimeAsync(10);
+ await queryAssertion;
+
+ let documentSettled = false;
+ const document = embedder.embed(['doc'], { role: 'document' }).catch((error) => {
+ documentSettled = true;
+ throw error;
+ });
+ const documentAssertion = expect(document).rejects.toMatchObject({ reason: 'timeout' });
+ await vi.advanceTimersByTimeAsync(10);
+ expect(documentSettled).toBe(false);
+ await vi.advanceTimersByTimeAsync(90);
+ await documentAssertion;
+ } finally {
+ vi.useRealTimers();
+ }
+ });
+
test('throws EmbeddingDimsMismatchError when a CONFIGURED size is not honored', async () => {
const { fetchImpl } = stubFetch([{ json: embeddingsResponse(1, 768) }]);
const embedder = createOpenAiEmbedder(
diff --git a/packages/server/src/embeddings/embedder.ts b/packages/server/src/embeddings/embedder.ts
index c2af120af..5aa035e6a 100644
--- a/packages/server/src/embeddings/embedder.ts
+++ b/packages/server/src/embeddings/embedder.ts
@@ -1,6 +1,9 @@
import {
checkEmbeddingsBaseUrl,
DEFAULT_EMBEDDINGS_BASE_URL,
+ DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
sleep as defaultSleep,
isLoopbackEmbeddingsUrl,
} from '@inkeep/open-knowledge-core';
@@ -105,9 +108,9 @@ export interface OpenAiEmbedderOptions {
}
const DEFAULTS = {
- maxBatchSize: 96,
- maxBatchChars: 96_000,
- docTimeoutMs: 30_000,
+ maxBatchSize: DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ maxBatchChars: DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ docTimeoutMs: DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
queryTimeoutMs: 8_000,
maxRetries: 4,
backoffBaseMs: 500,
diff --git a/packages/server/src/embeddings/index.ts b/packages/server/src/embeddings/index.ts
index 6d8b3e028..f422aee7f 100644
--- a/packages/server/src/embeddings/index.ts
+++ b/packages/server/src/embeddings/index.ts
@@ -5,6 +5,7 @@ export {
type Embedder,
type EmbeddingsCredentialSource,
type EmbeddingsKeyStore,
+ type LoadOpenAiEmbedderInput,
loadOpenAiEmbedder,
normalizeProviderId,
probeEmbeddingEndpoint,
diff --git a/packages/server/src/embeddings/semantic-config.test.ts b/packages/server/src/embeddings/semantic-config.test.ts
index 22f539f3e..a2b669f7e 100644
--- a/packages/server/src/embeddings/semantic-config.test.ts
+++ b/packages/server/src/embeddings/semantic-config.test.ts
@@ -16,11 +16,14 @@ describe('readProjectLocalSemanticConfig', () => {
try {
writeFileSync(
join(dir, '.ok', 'local', 'config.yml'),
- 'search:\n semantic:\n enabled: true\n model: text-embedding-3-large\n',
+ 'search:\n semantic:\n enabled: true\n model: text-embedding-3-large\n maxBatchSize: 2\n maxBatchChars: 16000\n docTimeoutMs: 120000\n',
);
const cfg = readProjectLocalSemanticConfig(dir);
expect(cfg.enabled).toBe(true);
expect(cfg.model).toBe('text-embedding-3-large');
+ expect(cfg.maxBatchSize).toBe(2);
+ expect(cfg.maxBatchChars).toBe(16_000);
+ expect(cfg.docTimeoutMs).toBe(120_000);
} finally {
rmSync(dir, { recursive: true, force: true });
}
@@ -29,8 +32,16 @@ describe('readProjectLocalSemanticConfig', () => {
test('IGNORES a committed project config — project-local only (egress safety)', () => {
const dir = makeProject();
try {
- writeFileSync(join(dir, '.ok', 'config.yml'), 'search:\n semantic:\n enabled: true\n');
- expect(readProjectLocalSemanticConfig(dir).enabled).toBe(false);
+ writeFileSync(
+ join(dir, '.ok', 'config.yml'),
+ 'search:\n semantic:\n enabled: true\n maxBatchSize: 2\n maxBatchChars: 16000\n docTimeoutMs: 120000\n',
+ );
+ expect(readProjectLocalSemanticConfig(dir)).toMatchObject({
+ enabled: false,
+ maxBatchSize: 96,
+ maxBatchChars: 96_000,
+ docTimeoutMs: 30_000,
+ });
} finally {
rmSync(dir, { recursive: true, force: true });
}
@@ -44,6 +55,9 @@ describe('readProjectLocalSemanticConfig', () => {
expect(cfg.baseUrl).toContain('openai');
expect(typeof cfg.model).toBe('string');
expect(cfg.dimensions).toBeUndefined();
+ expect(cfg.maxBatchSize).toBe(96);
+ expect(cfg.maxBatchChars).toBe(96_000);
+ expect(cfg.docTimeoutMs).toBe(30_000);
} finally {
rmSync(dir, { recursive: true, force: true });
}
diff --git a/packages/server/src/embeddings/semantic-config.ts b/packages/server/src/embeddings/semantic-config.ts
index df6f7f249..1504839f5 100644
--- a/packages/server/src/embeddings/semantic-config.ts
+++ b/packages/server/src/embeddings/semantic-config.ts
@@ -1,4 +1,10 @@
-import { DEFAULT_EMBEDDINGS_BASE_URL, DEFAULT_EMBEDDINGS_MODEL } from '@inkeep/open-knowledge-core';
+import {
+ DEFAULT_EMBEDDINGS_BASE_URL,
+ DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ DEFAULT_EMBEDDINGS_MODEL,
+} from '@inkeep/open-knowledge-core';
import { readConfigSafely, resolveConfigPath } from '@inkeep/open-knowledge-core/server';
export interface ResolvedSemanticConfig {
@@ -7,6 +13,9 @@ export interface ResolvedSemanticConfig {
model: string;
dimensions?: number;
similarityFloor?: number;
+ maxBatchSize: number;
+ maxBatchChars: number;
+ docTimeoutMs: number;
}
export function readProjectLocalSemanticConfig(
@@ -24,5 +33,8 @@ export function readProjectLocalSemanticConfig(
model: semantic?.model ?? DEFAULT_EMBEDDINGS_MODEL,
dimensions: semantic?.dimensions ?? undefined,
similarityFloor: semantic?.similarityFloor ?? undefined,
+ maxBatchSize: semantic?.maxBatchSize ?? DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ maxBatchChars: semantic?.maxBatchChars ?? DEFAULT_EMBEDDINGS_MAX_BATCH_CHARS,
+ docTimeoutMs: semantic?.docTimeoutMs ?? DEFAULT_EMBEDDINGS_DOC_TIMEOUT_MS,
};
}
diff --git a/packages/server/src/embeddings/semantic-search-service.test.ts b/packages/server/src/embeddings/semantic-search-service.test.ts
index 2491707bb..16a7d1019 100644
--- a/packages/server/src/embeddings/semantic-search-service.test.ts
+++ b/packages/server/src/embeddings/semantic-search-service.test.ts
@@ -5,10 +5,11 @@ import {
createWorkspaceSearchDocument,
type WorkspaceSearchDocument,
} from '@inkeep/open-knowledge-core';
-import { describe, expect, test } from 'vitest';
+import { describe, expect, test, vi } from 'vitest';
+import { getLogger } from '../logger.ts';
import { CHUNK_CONFIG_ID } from './chunking.ts';
import { createConceptEmbedder } from './concept-embedder.ts';
-import type { Embedder } from './embedder.ts';
+import { createOpenAiEmbedder, type Embedder } from './embedder.ts';
import { SemanticSearchService } from './semantic-search-service.ts';
import { VectorCache } from './vector-cache.ts';
@@ -173,10 +174,20 @@ describe('SemanticSearchService', () => {
const svc = makeService({ enabled: true });
await svc.embedCorpus(corpus);
expect(svc.getStatus().embeddedCount).toBe(2);
- svc.applyConfig({ enabled: false, providerFingerprint: '' });
+ svc.applyConfig({
+ enabled: false,
+ providerFingerprint: '',
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
expect(svc.getStatus().embeddedCount).toBe(0);
expect(await svc.queryScores('auth retries', corpus)).toBeNull();
- svc.applyConfig({ enabled: true, providerFingerprint: '' });
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
await svc.embedCorpus(corpus);
expect(svc.getStatus().embeddedCount).toBe(2);
});
@@ -202,8 +213,91 @@ describe('SemanticSearchService', () => {
expect(svc.getStatus().capable).toBe(true);
});
+ test('credential rotation reuses vectors and key removal prevents semantic queries', async () => {
+ let apiKey: string | null = 'first-key';
+ const requests: Array<{ authorization: string | null; input: string[] }> = [];
+ const svc = new SemanticSearchService({
+ loadEmbedder: async () =>
+ apiKey
+ ? createOpenAiEmbedder(
+ { baseUrl: 'https://embeddings.example/v1', model: 'test', apiKey },
+ {
+ fetchImpl: async (_url, init) => {
+ const { input } = JSON.parse(String(init?.body)) as { input: string[] };
+ requests.push({
+ authorization: new Headers(init?.headers).get('authorization'),
+ input,
+ });
+ return new Response(
+ JSON.stringify({
+ data: input.map((_, index) => ({ index, embedding: [1, 0, 0] })),
+ }),
+ );
+ },
+ },
+ )
+ : null,
+ cacheDir: null,
+ enabled: true,
+ });
+ await svc.embedCorpus(corpus);
+ expect(requests).toHaveLength(1);
+ apiKey = 'rotated-key';
+ svc.reloadCredential();
+ expect(svc.getStatus()).toMatchObject({
+ ready: false,
+ capable: false,
+ embeddedCount: corpus.length,
+ });
+ await svc.embedCorpus(corpus);
+ expect(requests).toHaveLength(1);
+ expect(await svc.queryScores('authentication', corpus)).not.toBeNull();
+ expect(requests[1]).toEqual({ authorization: 'Bearer rotated-key', input: ['authentication'] });
+
+ apiKey = null;
+ svc.reloadCredential();
+ expect(await svc.queryScores('authentication', corpus)).toBeNull();
+ await svc.embedCorpus(corpus);
+ expect(svc.getStatus()).toMatchObject({
+ ready: true,
+ capable: false,
+ embeddedCount: corpus.length,
+ });
+ expect(await svc.queryScores('authentication', corpus)).toBeNull();
+ expect(requests).toHaveLength(2);
+ });
+
+ test('a changed identity replaces a cache retained during credential reload', async () => {
+ let modelId = 'first-model';
+ let documentInputs = 0;
+ const svc = new SemanticSearchService({
+ loadEmbedder: async () => {
+ const inner = createConceptEmbedder({ concepts });
+ return {
+ ...inner,
+ modelId,
+ embed: (texts, options) => {
+ if (options.role === 'document') documentInputs += texts.length;
+ return inner.embed(texts, options);
+ },
+ };
+ },
+ cacheDir: null,
+ enabled: true,
+ });
+ await svc.embedCorpus(corpus);
+ expect(documentInputs).toBe(corpus.length);
+ modelId = 'next-model';
+ svc.reloadCredential();
+ await svc.ensureWarm();
+ expect(svc.getStatus().embeddedCount).toBe(0);
+ await svc.embedCorpus(corpus);
+ expect(documentInputs).toBe(corpus.length * 2);
+ });
+
test('disable racing an in-flight embed pass does NOT wipe the on-disk cache', async () => {
const dir = mkdtempSync(join(tmpdir(), 'ok-vec-race-'));
+ const info = vi.spyOn(getLogger('embeddings'), 'info');
try {
const inner = createConceptEmbedder({ concepts });
let release: (() => void) | null = null;
@@ -243,20 +337,43 @@ describe('SemanticSearchService', () => {
doc('new-topic', 'a fresh note about backoff and retries', 5),
]);
await enteredEmbed;
- svc.applyConfig({ enabled: false, providerFingerprint: '' });
+ svc.applyConfig({
+ enabled: false,
+ providerFingerprint: '',
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
+ expect(info).toHaveBeenCalledWith(
+ {
+ reason: 'disabled',
+ retainedInMemoryDocumentCount: 0,
+ unloadedInMemoryDocumentCount: corpus.length,
+ },
+ '[embeddings] resetting embedder',
+ );
release?.();
await pending;
+ expect(info).toHaveBeenCalledWith(
+ {
+ reason: 'disabled',
+ completedDocumentCount: 1,
+ scheduledDocumentCount: 1,
+ corpusDocumentCount: 3,
+ },
+ '[embeddings] abandoning embed pass before persistence',
+ );
const reopened = new VectorCache({
cacheDir: dir,
providerId: gated.providerId,
modelId: gated.modelId,
- dims: gated.dims,
+ identityDims: gated.dims ?? 'auto',
chunkConfigId: CHUNK_CONFIG_ID,
});
await reopened.init();
expect(reopened.embeddedCount).toBe(2);
} finally {
+ info.mockRestore();
rmSync(dir, { recursive: true, force: true });
}
});
@@ -274,14 +391,326 @@ describe('SemanticSearchService', () => {
});
await svc.embedCorpus(corpus);
expect(loads).toBe(1);
- svc.applyConfig({ enabled: true, providerFingerprint: 'openai|text-embedding-3-small|1536' });
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: 'openai|text-embedding-3-small|1536',
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
await svc.embedCorpus(corpus);
expect(loads).toBe(1);
- svc.applyConfig({ enabled: true, providerFingerprint: 'openai|text-embedding-3-large|3072' });
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: 'openai|text-embedding-3-large|3072',
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
await svc.embedCorpus(corpus);
expect(loads).toBe(2);
});
+ test('applyConfig transport-fingerprint change re-loads only the embedder and reuses vectors', async () => {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-sem-transport-reload-'));
+ const info = vi.spyOn(getLogger('embeddings'), 'info');
+ let loads = 0;
+ let documentInputs = 0;
+ try {
+ const svc = new SemanticSearchService({
+ loadEmbedder: () => {
+ loads += 1;
+ const inner = createConceptEmbedder({ concepts });
+ return Promise.resolve({
+ ...inner,
+ embed: (texts, options) => {
+ if (options.role === 'document') documentInputs += texts.length;
+ return inner.embed(texts, options);
+ },
+ });
+ },
+ cacheDir: dir,
+ enabled: true,
+ providerFingerprint: 'openai|model|auto',
+ transportFingerprint: '96|96000|30000',
+ });
+ await svc.embedCorpus(corpus);
+ const firstDocumentInputs = documentInputs;
+ expect(loads).toBe(1);
+ expect(firstDocumentInputs).toBeGreaterThan(0);
+
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: 'openai|model|auto',
+ transportFingerprint: '2|16000|120000',
+ maxBatchSize: 2,
+ });
+ expect(svc.getStatus().embeddedCount).toBe(corpus.length);
+ expect(info).toHaveBeenCalledWith(
+ {
+ reason: 'transport',
+ retainedInMemoryDocumentCount: corpus.length,
+ unloadedInMemoryDocumentCount: 0,
+ },
+ '[embeddings] resetting embedder',
+ );
+ await svc.embedCorpus(corpus);
+
+ expect(loads).toBe(2);
+ expect(documentInputs).toBe(firstDocumentInputs);
+ } finally {
+ info.mockRestore();
+ rmSync(dir, { recursive: true, force: true });
+ }
+ });
+
+ test('corpus request batches honor configured limits above 96 and after live tuning', async () => {
+ const requests: string[][] = [];
+ let maxBatchSize = 128;
+ const svc = new SemanticSearchService({
+ loadEmbedder: () =>
+ Promise.resolve(
+ createOpenAiEmbedder(
+ { baseUrl: 'https://embeddings.example/v1', model: 'test', dimensions: 3 },
+ {
+ maxBatchSize,
+ fetchImpl: async (_input, init) => {
+ const { input } = JSON.parse(String(init?.body)) as { input: string[] };
+ requests.push(input);
+ return new Response(
+ JSON.stringify({
+ data: input.map((_, index) => ({ index, embedding: [1, 0, 0] })),
+ }),
+ );
+ },
+ },
+ ),
+ ),
+ cacheDir: null,
+ enabled: true,
+ maxBatchSize,
+ transportFingerprint: '128',
+ });
+ const pages = Array.from({ length: 260 }, (_, i) => doc(`page-${i}`, `Unique page ${i}`));
+ await svc.embedCorpus(pages.slice(0, 200));
+ expect(requests.map((inputs) => inputs.length)).toEqual([128, 72]);
+
+ maxBatchSize = 2;
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '2',
+ maxBatchSize,
+ });
+ requests.length = 0;
+ await svc.embedCorpus(pages);
+ expect(requests).toHaveLength(30);
+ expect(requests.every((inputs) => inputs.length === 2)).toBe(true);
+ expect(requests.flat()).toEqual(pages.slice(200).map((page) => page.content));
+ });
+
+ test('transport changes preserve a pending pass and its persisted progress across restart', async () => {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-sem-transport-pending-'));
+ const started = Promise.withResolvers<void>();
+ const release = Promise.withResolvers<void>();
+ const calls: number[] = [];
+ let pauseNext = false;
+ const loadEmbedder = async (): Promise<Embedder> => {
+ const inner = createConceptEmbedder({ concepts });
+ return {
+ ...inner,
+ async embed(texts, opts) {
+ if (opts.role === 'document') {
+ calls.push(texts.length);
+ if (pauseNext) {
+ pauseNext = false;
+ started.resolve();
+ await release.promise;
+ }
+ }
+ return inner.embed(texts, opts);
+ },
+ };
+ };
+ try {
+ const svc = new SemanticSearchService({
+ loadEmbedder,
+ cacheDir: dir,
+ enabled: true,
+ maxBatchSize: 2,
+ transportFingerprint: '2',
+ });
+ await svc.embedCorpus(corpus);
+ calls.length = 0;
+ const extended = [
+ ...corpus,
+ ...Array.from({ length: 5 }, (_, i) => doc(`new-${i}`, `auth ${i}`)),
+ ];
+ pauseNext = true;
+ const pending = svc.embedCorpus(extended);
+ await started.promise;
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '1',
+ maxBatchSize: 1,
+ });
+ expect(svc.getStatus().embeddedCount).toBe(corpus.length);
+ await svc.ensureWarm();
+ expect(svc.getStatus().embeddedCount).toBe(corpus.length);
+ release.resolve();
+ await pending;
+ expect(calls).toEqual([2, 2, 1]);
+ expect(svc.getStatus().embeddedCount).toBe(extended.length);
+
+ const restarted = new SemanticSearchService({ loadEmbedder, cacheDir: dir, enabled: true });
+ calls.length = 0;
+ await restarted.embedCorpus(extended);
+ expect(calls).toEqual([]);
+ expect(restarted.getStatus().embeddedCount).toBe(extended.length);
+ expect(await restarted.queryScores('authentication', extended)).not.toBeNull();
+ } finally {
+ release.resolve();
+ rmSync(dir, { recursive: true, force: true });
+ }
+ });
+
+ test('a pending corpus pass waits for the current transport loader after its old loader settles', async () => {
+ const initial = Promise.withResolvers<Embedder | null>();
+ const current = Promise.withResolvers<Embedder | null>();
+ const loadEmbedder = vi
+ .fn<() => Promise<Embedder | null>>()
+ .mockReturnValueOnce(initial.promise)
+ .mockReturnValueOnce(current.promise);
+ const svc = new SemanticSearchService({ loadEmbedder, cacheDir: null, enabled: true });
+ const pending = svc.embedCorpus(corpus);
+ await vi.waitFor(() => expect(loadEmbedder).toHaveBeenCalledTimes(1));
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '2',
+ maxBatchSize: 2,
+ });
+ initial.resolve(null);
+ await vi.waitFor(() => expect(loadEmbedder).toHaveBeenCalledTimes(2));
+ expect(svc.getStatus()).toMatchObject({ ready: false, embeddedCount: 0 });
+ current.resolve(createConceptEmbedder({ concepts }));
+ await pending;
+ expect(svc.getStatus()).toMatchObject({
+ ready: true,
+ capable: true,
+ embeddedCount: corpus.length,
+ });
+ });
+
+ test('a corpus pass re-warms when config changes after ensureWarm resolves but before the pass resumes', async () => {
+ const loadEmbedder = vi.fn(async () => createConceptEmbedder({ concepts }));
+ const svc = new SemanticSearchService({ loadEmbedder, cacheDir: null, enabled: true });
+ const warming = svc.ensureWarm();
+ const pending = svc.embedCorpus(corpus);
+ const changed = warming.then(() => {
+ expect(svc.getStatus().ready).toBe(true);
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '2',
+ maxBatchSize: 2,
+ });
+ });
+ await Promise.all([pending, changed]);
+ expect(loadEmbedder).toHaveBeenCalledTimes(2);
+ expect(svc.getStatus()).toMatchObject({
+ ready: true,
+ capable: true,
+ embeddedCount: corpus.length,
+ });
+ });
+
+ test('successive transport loaders settling in reverse order keep the newest embedder', async () => {
+ const loaders = Array.from({ length: 3 }, () => Promise.withResolvers<Embedder | null>());
+ const loadEmbedder = vi
+ .fn<() => Promise<Embedder | null>>()
+ .mockReturnValueOnce(loaders[0].promise)
+ .mockReturnValueOnce(loaders[1].promise)
+ .mockReturnValueOnce(loaders[2].promise);
+ const svc = new SemanticSearchService({ loadEmbedder, cacheDir: null, enabled: true });
+ const pending = svc.embedCorpus(corpus);
+ await vi.waitFor(() => expect(loadEmbedder).toHaveBeenCalledTimes(1));
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '2',
+ maxBatchSize: 2,
+ });
+ const middleWarm = svc.ensureWarm();
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: '',
+ transportFingerprint: '1',
+ maxBatchSize: 1,
+ });
+ const latestWarm = svc.ensureWarm();
+ const inner = createConceptEmbedder({ concepts });
+ const embed = vi.fn(inner.embed);
+ loaders[2].resolve({ ...inner, embed });
+ await latestWarm;
+ loaders[1].resolve(null);
+ await middleWarm;
+ loaders[0].resolve(null);
+ await pending;
+ expect(embed.mock.calls.map(([texts]) => texts.length)).toEqual([1, 1]);
+ expect(svc.getStatus()).toMatchObject({
+ ready: true,
+ capable: true,
+ embeddedCount: corpus.length,
+ });
+ expect(await svc.queryScores('authentication', corpus)).not.toBeNull();
+ expect(loadEmbedder).toHaveBeenCalledTimes(3);
+ });
+
+ test('a superseded cache initialization finishes before the new provider initializes its cache', async () => {
+ const dir = mkdtempSync(join(tmpdir(), 'ok-sem-cache-init-'));
+ const started = Promise.withResolvers<void>();
+ const release = Promise.withResolvers<void>();
+ const init = VectorCache.prototype.init;
+ const initialize = vi
+ .spyOn(VectorCache.prototype, 'init')
+ .mockImplementationOnce(async function () {
+ started.resolve();
+ await release.promise;
+ await init.call(this);
+ });
+ let modelId = 'old';
+ const loadEmbedder = async (): Promise<Embedder> => ({
+ ...createConceptEmbedder({ concepts }),
+ modelId,
+ });
+ try {
+ const svc = new SemanticSearchService({ loadEmbedder, cacheDir: dir, enabled: true });
+ const pending = svc.embedCorpus(corpus);
+ await started.promise;
+ modelId = 'new';
+ svc.applyConfig({
+ enabled: true,
+ providerFingerprint: 'new',
+ transportFingerprint: '',
+ maxBatchSize: 96,
+ });
+ const currentWarm = svc.ensureWarm();
+ await Promise.resolve();
+ await Promise.resolve();
+ expect(initialize).toHaveBeenCalledTimes(1);
+ release.resolve();
+ await Promise.all([pending, currentWarm]);
+ expect(initialize).toHaveBeenCalledTimes(2);
+ const restarted = new SemanticSearchService({ loadEmbedder, cacheDir: dir, enabled: true });
+ await restarted.ensureWarm();
+ expect(restarted.getStatus().embeddedCount).toBe(corpus.length);
+ } finally {
+ release.resolve();
+ initialize.mockRestore();
+ rmSync(dir, { recursive: true, force: true });
+ }
+ });
+
test('max chunk cosine roll-up: a buried passage still surfaces the doc', async () => {
const svc = makeService({ enabled: true });
const breadBlock = 'sourdough bread cold ferment dough recipe loaf crust. '.repeat(90);
diff --git a/packages/server/src/embeddings/semantic-search-service.ts b/packages/server/src/embeddings/semantic-search-service.ts
index ef044188d..66968140f 100644
--- a/packages/server/src/embeddings/semantic-search-service.ts
+++ b/packages/server/src/embeddings/semantic-search-service.ts
@@ -1,4 +1,7 @@
-import type { WorkspaceSearchDocument } from '@inkeep/open-knowledge-core';
+import {
+ DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE,
+ type WorkspaceSearchDocument,
+} from '@inkeep/open-knowledge-core';
import { getLogger } from '../logger.ts';
import { CHUNK_CONFIG_ID, chunkDocument } from './chunking.ts';
import {
@@ -7,7 +10,7 @@ import {
EmbeddingDimsMismatchError,
EmbeddingProviderError,
} from './embedder.ts';
-import { hashContent, VectorCache } from './vector-cache.ts';
+import { hashContent, type IdentityDims, VectorCache } from './vector-cache.ts';
const log = getLogger('embeddings');
@@ -17,8 +20,6 @@ function errMsg(err: unknown): string {
export const SEMANTIC_MIN_QUERY_LENGTH = 3;
-const EMBED_BATCH_CHUNK_LIMIT = 96;
-
const MAX_CONSECUTIVE_EMBED_FAILURES = 5;
export const MAX_DIMS_DRIFT_RESETS = 2;
@@ -44,6 +45,8 @@ export interface SemanticSearchServiceOptions {
cacheDir: string | null;
enabled?: boolean;
providerFingerprint?: string;
+ transportFingerprint?: string;
+ maxBatchSize?: number;
}
export class SemanticSearchService {
@@ -52,12 +55,16 @@ export class SemanticSearchService {
private enabled: boolean;
private providerFingerprint: string;
+ private transportFingerprint: string;
+ private maxBatchSize: number;
private capable = false;
private ready = false;
private embedder: Embedder | null = null;
private cache: VectorCache | null = null;
private warmPromise: Promise<void> | null = null;
+ private warmGeneration = 0;
+ private cacheInitChain: Promise<void> = Promise.resolve();
private embedChain: Promise<void> = Promise.resolve();
private queuedDocs: readonly WorkspaceSearchDocument[] | null = null;
private dimsDriftResets = 0;
@@ -67,6 +74,8 @@ export class SemanticSearchService {
this.cacheDir = options.cacheDir;
this.enabled = options.enabled ?? false;
this.providerFingerprint = options.providerFingerprint ?? '';
+ this.transportFingerprint = options.transportFingerprint ?? '';
+ this.maxBatchSize = options.maxBatchSize ?? DEFAULT_EMBEDDINGS_MAX_BATCH_SIZE;
}
isEnabled(): boolean {
@@ -82,30 +91,53 @@ export class SemanticSearchService {
};
}
- applyConfig(input: { enabled: boolean; providerFingerprint: string }): void {
- if (input.providerFingerprint !== this.providerFingerprint) {
- this.providerFingerprint = input.providerFingerprint;
+ applyConfig(input: {
+ enabled: boolean;
+ providerFingerprint: string;
+ transportFingerprint: string;
+ maxBatchSize: number;
+ }): void {
+ const providerChanged = input.providerFingerprint !== this.providerFingerprint;
+ const transportChanged = input.transportFingerprint !== this.transportFingerprint;
+ this.providerFingerprint = input.providerFingerprint;
+ this.transportFingerprint = input.transportFingerprint;
+ this.maxBatchSize = input.maxBatchSize;
+ if (providerChanged) {
this.dimsDriftResets = 0;
- this.resetWarm();
+ this.resetWarm('provider');
+ } else if (transportChanged) {
+ this.resetWarm('transport');
}
if (input.enabled === this.enabled) return;
this.enabled = input.enabled;
- if (!input.enabled) {
- this.cache?.clearMemory();
- this.resetWarm();
- }
+ if (!input.enabled) this.resetWarm('disabled');
}
- private resetWarm(): void {
+ private resetWarm(
+ reason: 'provider' | 'transport' | 'disabled' | 'credential' | 'dimensions',
+ ): void {
+ const cachedDocuments = this.cache?.embeddedCount ?? 0;
+ const retainCache = reason === 'transport' || reason === 'credential';
+ this.warmGeneration += 1;
this.warmPromise = null;
this.ready = false;
this.capable = false;
this.embedder = null;
- this.cache = null;
+ if (reason === 'disabled') this.cache?.clearMemory();
+ if (reason === 'dimensions') this.cache?.discard();
+ if (!retainCache) this.cache = null;
+ log.info(
+ {
+ reason,
+ retainedInMemoryDocumentCount: retainCache ? cachedDocuments : 0,
+ unloadedInMemoryDocumentCount: retainCache ? 0 : cachedDocuments,
+ },
+ '[embeddings] resetting embedder',
+ );
}
reloadCredential(): void {
- this.resetWarm();
+ this.resetWarm('credential');
}
private recoverFromDimsDrift(cache: VectorCache, err: EmbeddingDimsMismatchError): boolean {
@@ -113,7 +145,11 @@ export class SemanticSearchService {
if (this.cache !== cache) return false;
if (this.dimsDriftResets >= MAX_DIMS_DRIFT_RESETS) {
log.error(
- { expected: err.expected, got: err.got },
+ {
+ expected: err.expected,
+ got: err.got,
+ unloadedInMemoryDocumentCount: cache.embeddedCount,
+ },
'[embeddings] provider vector length keeps changing — disabling semantic search until restart',
);
this.capable = false;
@@ -125,21 +161,21 @@ export class SemanticSearchService {
{ expected: err.expected, got: err.got },
'[embeddings] provider vector length changed — discarding cached vectors and re-embedding',
);
- cache.discard();
- this.resetWarm();
+ this.resetWarm('dimensions');
return true;
}
- ensureWarm(): Promise<void> {
- if (!this.enabled) return Promise.resolve();
- if (this.ready) return Promise.resolve();
- this.warmPromise ||= this.warm();
- return this.warmPromise;
+ async ensureWarm(): Promise<void> {
+ while (this.enabled && !this.ready) {
+ this.warmPromise ||= this.warm(this.warmGeneration);
+ await this.warmPromise;
+ }
}
- private async warm(): Promise<void> {
+ private async warm(generation: number): Promise<void> {
try {
const embedder = await this.loadEmbedder();
+ if (generation !== this.warmGeneration || !this.enabled) return;
if (!embedder) {
this.capable = false;
this.ready = true;
@@ -149,20 +185,33 @@ export class SemanticSearchService {
);
return;
}
- this.embedder = embedder;
- const cache = new VectorCache({
+ const identityDims: IdentityDims = embedder.dims ?? 'auto';
+ const cacheOptions = {
cacheDir: this.cacheDir,
providerId: embedder.providerId,
modelId: embedder.modelId,
- dims: embedder.dims,
+ identityDims,
chunkConfigId: CHUNK_CONFIG_ID,
- });
- await cache.init();
+ };
+ let cache = this.cache;
+ if (!cache?.matchesIdentity(cacheOptions)) {
+ cache = new VectorCache(cacheOptions);
+ const nextCache = cache;
+ const initialized = this.cacheInitChain.then(async () => {
+ if (generation !== this.warmGeneration || !this.enabled) return;
+ await nextCache.init();
+ });
+ this.cacheInitChain = initialized.catch(() => {});
+ await initialized;
+ }
+ if (generation !== this.warmGeneration || !this.enabled) return;
if (cache.dims !== null) embedder.pinDims?.(cache.dims);
+ this.embedder = embedder;
this.cache = cache;
this.capable = true;
this.ready = true;
} catch (err) {
+ if (generation !== this.warmGeneration || !this.enabled) return;
this.capable = false;
this.ready = true;
log.warn({ err }, '[embeddings] warm failed');
@@ -186,10 +235,11 @@ export class SemanticSearchService {
}
private async runEmbedPass(documents: readonly WorkspaceSearchDocument[]): Promise<void> {
- await this.ensureWarm();
+ while (this.enabled && !this.ready) await this.ensureWarm();
if (!this.enabled || !this.capable || !this.embedder || !this.cache) return;
const cache = this.cache;
const embedder = this.embedder;
+ const batchChunkLimit = this.maxBatchSize;
const pageDocs = documents.filter((d) => d.kind === 'page');
const activeIds = new Set(pageDocs.map((d) => d.id));
@@ -209,11 +259,13 @@ export class SemanticSearchService {
}
let consecutiveFailures = 0;
+ let completedDocumentCount = 0;
const storeDoc = (p: Pending, vectors: Float32Array[]): void => {
const observed = vectors[0]?.length;
if (observed !== undefined) cache.pinDims(observed);
cache.store(p.doc.id, p.contentHash, p.doc.modifiedTs, vectors);
+ completedDocumentCount += 1;
};
const embedGroup = async (group: Pending[]): Promise<boolean> => {
@@ -264,7 +316,7 @@ export class SemanticSearchService {
if (!this.enabled) break;
batch.push(p);
batchChunks += Math.max(1, p.chunks.length);
- if (batchChunks >= EMBED_BATCH_CHUNK_LIMIT) {
+ if (batchChunks >= batchChunkLimit) {
const carryOn = await embedGroup(batch);
batch = [];
batchChunks = 0;
@@ -283,7 +335,18 @@ export class SemanticSearchService {
return;
}
- if (!this.enabled || this.cache !== cache) return;
+ if (!this.enabled || this.cache !== cache) {
+ log.info(
+ {
+ reason: this.enabled ? 'cache-replaced' : 'disabled',
+ completedDocumentCount,
+ scheduledDocumentCount: pending.length,
+ corpusDocumentCount: activeIds.size,
+ },
+ '[embeddings] abandoning embed pass before persistence',
+ );
+ return;
+ }
cache.retain(activeIds);
await cache.persist();
}
diff --git a/packages/server/src/embeddings/vector-cache.test.ts b/packages/server/src/embeddings/vector-cache.test.ts
index defd45e8c..e0f11e416 100644
--- a/packages/server/src/embeddings/vector-cache.test.ts
+++ b/packages/server/src/embeddings/vector-cache.test.ts
@@ -1,4 +1,4 @@
-import { existsSync, mkdtempSync, readdirSync, rmSync } from 'node:fs';
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { afterEach, beforeEach, describe, expect, test } from 'vitest';
@@ -24,12 +24,77 @@ function makeCache(
cacheDir: dir,
providerId: over.providerId ?? 'https://api.test/v1',
modelId: over.modelId ?? 'test-model',
- dims: DIMS,
+ identityDims: DIMS,
chunkConfigId: over.chunkConfigId ?? 'c1-o0',
});
}
describe('VectorCache', () => {
+ test.each([
+ { providerId: 'https://other.test/v1' },
+ { modelId: 'other-model' },
+ { identityDims: DIMS + 1 },
+ { chunkConfigId: 'other-chunks' },
+ ])('memory and disk reject the same identity difference: %j', async (change) => {
+ const identity = {
+ providerId: 'https://api.test/v1',
+ modelId: 'test-model',
+ identityDims: DIMS,
+ chunkConfigId: 'c1-o0',
+ };
+ const cache = new VectorCache({ cacheDir: dir, ...identity });
+ await cache.init();
+ cache.store('page:a', hashContent('a'), 1, [vec(1, 0, 0, 0)]);
+ await cache.persist();
+ expect(cache.matchesIdentity(identity)).toBe(true);
+ const changedIdentity = { ...identity, ...change };
+ expect(cache.matchesIdentity(changedIdentity)).toBe(false);
+ const reopened = new VectorCache({ cacheDir: dir, ...changedIdentity });
+ await reopened.init();
+ expect(reopened.embeddedCount).toBe(0);
+ });
+
+ test('auto identity stays distinct from explicit dimensions after dimensions are pinned', async () => {
+ const identity = {
+ providerId: 'https://api.test/v1',
+ modelId: 'test-model',
+ identityDims: 'auto' as const,
+ chunkConfigId: 'c1-o0',
+ };
+ const cache = new VectorCache({ cacheDir: dir, ...identity });
+ await cache.init();
+ cache.pinDims(DIMS);
+ cache.store('page:a', hashContent('a'), 1, [vec(1, 0, 0, 0)]);
+ await cache.persist();
+ expect(cache.matchesIdentity(identity)).toBe(true);
+ expect(cache.matchesIdentity({ ...identity, identityDims: DIMS })).toBe(false);
+ const reopened = new VectorCache({ cacheDir: dir, ...identity, identityDims: DIMS });
+ await reopened.init();
+ expect(reopened.embeddedCount).toBe(0);
+ });
+
+ test('a null manifest identity is invalid rather than the auto sentinel', async () => {
+ const identity = {
+ providerId: 'https://api.test/v1',
+ modelId: 'test-model',
+ identityDims: 'auto' as const,
+ chunkConfigId: 'c1-o0',
+ };
+ const cache = new VectorCache({ cacheDir: dir, ...identity });
+ await cache.init();
+ cache.pinDims(DIMS);
+ cache.store('page:a', hashContent('a'), 1, [vec(1, 0, 0, 0)]);
+ await cache.persist();
+ const manifestPath = join(dir, 'manifest.json');
+ const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+ manifest.identityDims = null;
+ writeFileSync(manifestPath, JSON.stringify(manifest));
+ const reopened = new VectorCache({ cacheDir: dir, ...identity });
+ await reopened.init();
+ expect(reopened.embeddedCount).toBe(0);
+ expect(existsSync(manifestPath)).toBe(false);
+ });
+
test('store → persist → re-init round-trips vectors', async () => {
const a = makeCache();
await a.init();
@@ -128,7 +193,7 @@ describe('VectorCache', () => {
cacheDir: null,
providerId: 'p',
modelId: 'm',
- dims: DIMS,
+ identityDims: DIMS,
chunkConfigId: 'c',
});
await c.init();
diff --git a/packages/server/src/embeddings/vector-cache.ts b/packages/server/src/embeddings/vector-cache.ts
index fe4c68ed7..4e046e7f7 100644
--- a/packages/server/src/embeddings/vector-cache.ts
+++ b/packages/server/src/embeddings/vector-cache.ts
@@ -39,14 +39,17 @@ function manifestIdentityDims(manifest: ManifestFile, want: IdentityDims): Ident
return want === 'auto' ? 'auto' : manifest.dims;
}
-interface VectorCacheOptions {
- cacheDir: string | null;
+interface VectorCacheIdentity {
providerId: string;
modelId: string;
- dims: number | null;
+ identityDims: IdentityDims;
chunkConfigId: string;
}
+interface VectorCacheOptions extends VectorCacheIdentity {
+ cacheDir: string | null;
+}
+
export function hashContent(content: string): string {
return createHash('sha256').update(content, 'utf-8').digest('hex');
}
@@ -97,8 +100,8 @@ export class VectorCache {
this.manifestPath = options.cacheDir ? join(options.cacheDir, MANIFEST_NAME) : null;
this.providerId = options.providerId;
this.modelId = options.modelId;
- this.identityDims = options.dims ?? 'auto';
- this.pinnedDims = options.dims;
+ this.identityDims = options.identityDims;
+ this.pinnedDims = options.identityDims === 'auto' ? null : options.identityDims;
this.chunkConfigId = options.chunkConfigId;
}
@@ -106,6 +109,15 @@ export class VectorCache {
return this.pinnedDims;
}
+ matchesIdentity(identity: VectorCacheIdentity): boolean {
+ return (
+ identity.providerId === this.providerId &&
+ identity.modelId === this.modelId &&
+ identity.identityDims === this.identityDims &&
+ identity.chunkConfigId === this.chunkConfigId
+ );
+ }
+
pinDims(dims: number): void {
this.pinnedDims ??= dims;
}
@@ -133,10 +145,12 @@ export class VectorCache {
const identityMatches =
manifest !== null &&
manifest.schemaVersion === MANIFEST_SCHEMA_VERSION &&
- manifest.providerId === this.providerId &&
- manifest.modelId === this.modelId &&
- manifestIdentityDims(manifest, this.identityDims) === this.identityDims &&
- manifest.chunkConfigId === this.chunkConfigId;
+ this.matchesIdentity({
+ providerId: manifest.providerId,
+ modelId: manifest.modelId,
+ identityDims: manifestIdentityDims(manifest, this.identityDims),
+ chunkConfigId: manifest.chunkConfigId,
+ });
if (!identityMatches) {
if (manifest !== null) {
diff --git a/packages/server/src/server-factory.ts b/packages/server/src/server-factory.ts
index 196350239..b4d87a5f0 100644
--- a/packages/server/src/server-factory.ts
+++ b/packages/server/src/server-factory.ts
@@ -89,7 +89,7 @@ import {
startConfigFileWatcher,
startMultiPathConfigFileWatcher,
} from './config-file-watcher.ts';
-import { applyExternalConfigChange } from './config-persistence.ts';
+import { applyExternalConfigChange, isConfigEcho } from './config-persistence.ts';
import { isDocInConflict } from './conflict-errors.ts';
import {
createConflictLifecycleSeedExtension,
@@ -131,6 +131,7 @@ import { DocumentDurabilityState } from './document-durability-state.ts';
import {
type Embedder,
type EmbeddingsKeyStore,
+ type LoadOpenAiEmbedderInput,
loadOpenAiEmbedder,
normalizeProviderId,
type ResolvedSemanticConfig,
@@ -306,7 +307,7 @@ export interface ServerOptions {
pullIntervalSeconds?: number;
pushIntervalSeconds?: number;
embeddingsKeyStore?: EmbeddingsKeyStore | null;
- embedderLoader?: () => Promise<Embedder | null>;
+ embedderLoader?: (input: LoadOpenAiEmbedderInput) => Promise<Embedder | null>;
singleDocRelPath?: string;
ephemeral?: boolean;
generatedIndexTestHooks?: {
@@ -605,8 +606,32 @@ export function createServer(options: ServerOptions): ServerInstance {
});
}
- function logConfigDiagnosticsOnce(): void {
+ function logConfigDiagnostics(configDocName?: string): void {
+ const configDocNamesByScope = {
+ user: CONFIG_DOC_NAME_USER,
+ project: CONFIG_DOC_NAME_PROJECT,
+ 'project-local': CONFIG_DOC_NAME_PROJECT_LOCAL,
+ };
for (const finding of readConfigDiagnostics().diagnostics) {
+ if (configDocName !== undefined && configDocNamesByScope[finding.scope] !== configDocName) {
+ continue;
+ }
+ if (finding.code === 'VALUE_FALLBACK') {
+ for (const issue of finding.issues) {
+ log.warn(
+ {
+ code: finding.code,
+ scope: finding.scope,
+ file: finding.file,
+ path: issue.path.join('.'),
+ line: issue.line,
+ column: issue.column,
+ },
+ `[config] ${issue.path.join('.')}: ${issue.message}`,
+ );
+ }
+ continue;
+ }
if (finding.code !== 'REMOVED_KEY') continue;
log.warn(
{ scope: finding.scope, file: finding.file, path: finding.path.join('.') },
@@ -619,6 +644,10 @@ export function createServer(options: ServerOptions): ServerInstance {
return `${normalizeProviderId(cfg.baseUrl)}|${cfg.model}|${cfg.dimensions ?? 'auto'}`;
}
+ function semanticTransportFingerprint(cfg: ResolvedSemanticConfig): string {
+ return `${cfg.maxBatchSize}|${cfg.maxBatchChars}|${cfg.docTimeoutMs}`;
+ }
+
let lastAppliedAttachmentFolderPath: string | undefined;
function applyPersistedConfigToConsumers(
@@ -645,6 +674,8 @@ export function createServer(options: ServerOptions): ServerInstance {
semanticSearch.applyConfig({
enabled: semCfg.enabled,
providerFingerprint: semanticProviderFingerprint(semCfg),
+ transportFingerprint: semanticTransportFingerprint(semCfg),
+ maxBatchSize: semCfg.maxBatchSize,
});
if (configDocName === CONFIG_DOC_NAME_PROJECT) {
try {
@@ -775,19 +806,25 @@ export function createServer(options: ServerOptions): ServerInstance {
const initialSemanticConfig = readSemanticSearchConfig();
const semanticSearch = new SemanticSearchService({
- loadEmbedder:
- options.embedderLoader ??
- (() => {
- const cfg = readSemanticSearchConfig();
- return loadOpenAiEmbedder({
- keyStore: options.embeddingsKeyStore ?? null,
- projectDir,
- config: { baseUrl: cfg.baseUrl, model: cfg.model, dimensions: cfg.dimensions },
- });
- }),
+ loadEmbedder: () => {
+ const cfg = readSemanticSearchConfig();
+ const input: LoadOpenAiEmbedderInput = {
+ keyStore: options.embeddingsKeyStore ?? null,
+ projectDir,
+ config: { baseUrl: cfg.baseUrl, model: cfg.model, dimensions: cfg.dimensions },
+ options: {
+ maxBatchSize: cfg.maxBatchSize,
+ maxBatchChars: cfg.maxBatchChars,
+ docTimeoutMs: cfg.docTimeoutMs,
+ },
+ };
+ return (options.embedderLoader ?? loadOpenAiEmbedder)(input);
+ },
cacheDir: join(getLocalDir(projectDir), 'embeddings'),
enabled: initialSemanticConfig.enabled,
providerFingerprint: semanticProviderFingerprint(initialSemanticConfig),
+ transportFingerprint: semanticTransportFingerprint(initialSemanticConfig),
+ maxBatchSize: initialSemanticConfig.maxBatchSize,
});
let loadedPrincipal: Principal | null = null;
@@ -1231,6 +1268,7 @@ export function createServer(options: ServerOptions): ServerInstance {
log.warn({ err }, '[index] generated-index settings reflection deferred to config watcher');
}
applyPersistedConfigToConsumers(CONFIG_DOC_NAME_PROJECT, enabled);
+ logConfigDiagnostics(CONFIG_DOC_NAME_PROJECT);
return { ...getGeneratedIndexSettingsStatus(), applied: true };
}
@@ -1560,7 +1598,10 @@ export function createServer(options: ServerOptions): ServerInstance {
},
onConfigRejected: (docName, error) =>
cc1Broadcaster?.emitConfigValidationRejected(docName, error),
- onConfigPersisted: applyPersistedConfigToConsumers,
+ onConfigPersisted: (docName) => {
+ applyPersistedConfigToConsumers(docName);
+ logConfigDiagnostics(docName);
+ },
onManagedSkillPersisted: (docName) => {
const parsed = parseManagedArtifactName(docName);
if (parsed?.kind !== 'skill' || parsed.scope !== 'global') return;
@@ -3107,6 +3148,11 @@ export function createServer(options: ServerOptions): ServerInstance {
log.info({ docName: configDocName, path: absPath }, '[config-file-watcher] starting');
const cleanup = await startConfigFileWatcher(absPath, (content) => {
const document = hocuspocus.documents.get(configDocName);
+ const alreadyApplied = isConfigEcho(
+ configDocName,
+ content,
+ persistence.configPersistenceCtx,
+ );
log.info(
{
docName: configDocName,
@@ -3122,10 +3168,13 @@ export function createServer(options: ServerOptions): ServerInstance {
persistence.configPersistenceCtx,
);
log.info(
- { docName: configDocName, outcome },
+ { docName: configDocName, outcome, isEcho: alreadyApplied },
'[config-file-watcher] applyExternalConfigChange outcome',
);
applyPersistedConfigToConsumers(configDocName);
+ if (!alreadyApplied) {
+ logConfigDiagnostics(configDocName);
+ }
});
configFileWatcherCleanups.push({ docName: configDocName, cleanup });
log.info({ docName: configDocName, path: absPath }, '[config-file-watcher] started');
@@ -3924,7 +3973,7 @@ export function createServer(options: ServerOptions): ServerInstance {
const readyElapsed = bootElapsedMs();
if (readyElapsed !== undefined) recordBootPhase('readyMs', readyElapsed);
- logConfigDiagnosticsOnce();
+ logConfigDiagnostics();
}
initAsync().then(