makelore/.project-docs/30-worklog/tasks/20260914-yuxi-embedding-ml-a174ed62.md

Task: 知识库向量配置改由Yuxi维护

Identity

• Task ID: 20260914-yuxi-embedding-ml-a174ed62
• Mode: Feature
• Branch: codex/20260914-yuxi-embedding-ml-a174ed62-yuxi-embedding
• Worktree: D:\Datas\OthersProjects.codex-worktrees\makelore\20260914-yuxi-embedding-ml-a174ed62
• Base commit: f92753329c
• Owner: codex
• Status: Ready for Integration

Scope

• Update the MakeLore cloud Agent knowledge-base empty state and README configuration guidance so Yuxi is the sole embedding-model owner.
• Keep the existing knowledge Host API response shape (databases plus embedding models with id, name, and dimension) and make the client state use that shared contract.
• Verify that the client has no embedding-specific dependency on the Works Square or one-api model catalogs; do not change chat-model routing, account, billing, or server behavior.

Intent And Constraints

• Concurrent Task Gate passed through the official project-docs check/start/status flow. This feature worktree is isolated from the MakeLore main checkout and other active tasks; the UX integration base is already present at the recorded base commit.
• The user decided that Yuxi maintains embedding providers, endpoint/API key, enabled embedding models, and dimensions. one-api does not configure embeddings; Works Square remains the creator Token Point ledger only.
• The user subsequently clarified that embedding vectorization is paid by the platform: it must not enter user usage, Token Point deductions, or Agent ceilings. Knowledge processing that triggers dialogue-model calls remains subject to the original model billing rules.
• The client should tell administrators to configure the provider and model in Yuxi, then refresh the knowledge/model directory. Remove the old Works Square activation, one-api vector-interface, and cross-end model-ID matching instructions.
• Scope is limited to the client knowledge configuration copy, shared client typing where needed to retain dimension, focused test fixtures/assertions, and synchronized README wording. No Yuxi, Works Square, AgentBus, authentication, payment, installation, or deployment changes.

Outcome

• The knowledge panel and README now describe Yuxi-owned embedding configuration. The old Works Square activation, one-api vector-interface, and cross-end model-ID matching instructions were removed. The client catalog state now uses the shared model contract, including dimension; no embedding-specific Works/one-api filtering was present or added.
• This continuation updates the knowledge upload/indexing explanation, the empty-model guidance, the cost-ceiling explanation, and the cost-source label so platform-funded embedding is separated from billable dialogue-model calls.
• The final wording correction removes the unsupported billable OCR implication: knowledge processing is described as billing only dialogue-model calls under the original rules, while embedding remains platform-funded and outside user usage, Token Points, and Agent ceilings.

Verification

• pnpm install --frozen-lockfile --offline completed with the pinned pnpm@10.33.4; the install did not change manifests or the lockfile.
• pnpm exec vitest run tests/unit/cloud-knowledge-catalog.test.tsx --maxWorkers=1 passed 5/5 tests.
• pnpm run typecheck passed; scoped ESLint for the changed client and test files passed; git diff --check passed.
• pnpm run build:vite passed Renderer, Main, Preload, and utility targets with the repository's existing Browserslist, chunk-size, and mixed-import warnings.
• pnpm exec playwright test tests/e2e/cloud-agents.spec.ts passed 1/1 scenario, including the updated Yuxi-only empty-catalog guidance.
• Follow-up correction verification: the focused knowledge/workflows unit run passed 22/22; the rebuilt Vite bundle passed; the cloud-agent Electron E2E passed 1/1 with the platform-funded embedding and billable dialogue-model assertions; typecheck and scoped ESLint passed (one existing CloudCosts hooks warning remains).
• The replacement fresh independent Reviewer completed the shared three-service review with Standards PASS and Spec PASS. The MakeLore client, README, and focused test changes had no blocking findings and require no further product changes; the review record is D:\\Datas\\OthersProjects\\.codex-worktrees\\makelore\\20260915-embedding-final-review-ml-c58f10\\.project-docs\\30-worklog\\tasks\\20260915-embedding-final-review-ml-c58f10.md.
• The user authorized this batch to be committed and merged into the repository main branch. The integration task and main checkout remain owned by the parent agent; this feature task only hands off the reviewed source commit.
• No live Yuxi/Works request, production configuration, packaging, deployment, or remote push was performed.

Follow-ups

• Integration must include the resulting source commit, and a rebuilt client is required before users see the updated guidance.

Promotion Candidates

• The README and in-product empty-state wording are the product-facing record of the accepted Yuxi embedding ownership decision; no separate canonical ADR or architecture change is proposed by this feature task.