From 4ab6f25241ee98dd4335f85d894eaa11e95eefea Mon Sep 17 00:00:00 2001 From: Yoan Huang Date: Sun, 6 Sep 2026 14:54:05 +0800 Subject: [PATCH] feat: update database documentation and remove reference field guide from prompts --- doc/database.md | 2 +- src/main/services/ai/human/prompts/brain.ts | 10 ------ .../unit/ai/brain-prompt-formatting.test.ts | 2 ++ .../selected-context-workspace-path.test.ts | 36 +++---------------- 4 files changed, 8 insertions(+), 42 deletions(-) diff --git a/doc/database.md b/doc/database.md index 63a9044a..7564c5b0 100644 --- a/doc/database.md +++ b/doc/database.md @@ -54,7 +54,7 @@ SQLite 保存以下业务数据： - 当前代码支持的最终 schema version 是 `10`，由 `CURRENT_SCHEMA_VERSION` 定义。 - version `1–9` 已随正式版发布，永久保留且不可改写。已知历史例外只有 version 2 的旧名称 `workspace_change_sets`；version 9 继续负责修复通知字段。 -- version `10` 是破坏性升级，不迁旧数据。`upgrade_from_v9` 从 v9 升级时 DROP 旧表再建最终结构：新增 `partner`；删除 `chat_session`、`chat_session_ui_state`（以及 `chat_conversation_memory`、`chat_session_resume_snapshot`、`ai_run_event`、`chat_session_skill_state`、`chat_message`）；`chat_session_message_log` / `ai_run` / `ai_file_change` / `docx_apply` 改挂 `partner_id`；新增 `partner_ui_state`；`workbench_ui_state` 只留 `active_view_key`，删除 `draft_state_json`；`scheduled_task` 改挂 `partner_id`；`workspace_source` 去掉 name 且 `root_path UNIQUE`；`web_source` 去掉 `workspace_id` 且 `UNIQUE(normalized_url)`；`ai_run` 不再保存 `workspace_json`。不存在、也不新建 `chat_search_turn`。空库仍执行 version `1–10`，跑完后结构与 v9 升级路径一致。 +- version `10` 是破坏性升级，不迁旧数据。`upgrade_from_v9` 从 v9 升级时 DROP 旧表再建最终结构：新增 `partner`；删除 `chat_session`、`chat_session_ui_state`（以及 `chat_conversation_memory`、`chat_session_resume_snapshot`、`ai_run_event`、`chat_session_skill_state`、`chat_message`）；`chat_session_message_log` / `ai_run` / `ai_file_change` / `docx_apply` 改挂 `partner_id`；新增 `partner_ui_state`；`workbench_ui_state` 只留 `active_view_key`，删除 `draft_state_json`；`scheduled_task` 改挂 `partner_id`；`workspace_source` 去掉 name 且 `root_path UNIQUE`；`web_source` 去掉 `workspace_id` 且 `UNIQUE(normalized_url)`；`ai_run` 不再保存 `workspace_json`。不存在、也不新建 `chat_search_turn`。空库仍执行 version `1–10`，跑完后结构与 v9 升级路径一致。LanceDB 不在 SQLite migration 事务里；v10 清空 `document` 后旧 chunk 会成为孤儿，检索按 SQLite 有效 generation 过滤，不会命中。不在启动路径删除 `userData/lancedb`。 - 哪些 migration 已正式发布，以 `migrations/released-migrations.json` 为唯一边界。未进入清单的连续迁移可以在发布前合并或重写；进入清单后只能新增更高版本修复。 ### 版本身份与执行规则 diff --git a/src/main/services/ai/human/prompts/brain.ts b/src/main/services/ai/human/prompts/brain.ts index 44636ea1..9e8a9022 100644 --- a/src/main/services/ai/human/prompts/brain.ts +++ b/src/main/services/ai/human/prompts/brain.ts @@ -69,12 +69,6 @@ ${external.map((skill) => renderSkillLine(skill.skillId, skill.description, skil `.trim() } -const REFERENCE_FIELD_GUIDE = `字段说明： -- 类型：资料来源类型，目前支持本地文件、本地目录、网页资料。 -- 资源地址：这份资料对应的本地路径或网页地址。 -- 文档知识库状态：这份资料本身是否可被知识库检索。 -- 知识库文档ID：这份资料在知识库中的文档标识；没有对应知识库文档时显示为“无”。` - export const buildBrainSystemPrompt = (input: { ctx: AiRunContext }): string => ` @@ -120,10 +114,6 @@ export const buildBrainSystemPrompt = (input: { ctx: AiRunContext }): string => ${renderSkillCatalog(input.ctx.platform)} - -${REFERENCE_FIELD_GUIDE} - - ${renderLocalEnvironmentText(input.ctx)} diff --git a/tests/case/unit/ai/brain-prompt-formatting.test.ts b/tests/case/unit/ai/brain-prompt-formatting.test.ts index 216ee805..55eb546d 100644 --- a/tests/case/unit/ai/brain-prompt-formatting.test.ts +++ b/tests/case/unit/ai/brain-prompt-formatting.test.ts @@ -49,6 +49,8 @@ describe('ai unit brain prompt formatting', () => { expect(environment).toContain('runtime_paths.assets：') expect(environment).not.toContain('current_time') expect(system).not.toContain('current_time.local_iso') + expect(system).not.toContain('reference_field_guide') + expect(system).not.toContain('字段说明') }) it('keeps context efficiency and planning rules concise', () => { diff --git a/tests/case/unit/ai/selected-context-workspace-path.test.ts b/tests/case/unit/ai/selected-context-workspace-path.test.ts index c573ccb9..a171e887 100644 --- a/tests/case/unit/ai/selected-context-workspace-path.test.ts +++ b/tests/case/unit/ai/selected-context-workspace-path.test.ts @@ -5,35 +5,24 @@ import { } from '../../../../src/main/services/ai/human/prompts/referenceScope' describe('ai unit selected context workspace path', () => { - it('renders workspace rootPath without a workspace-only path restriction', () => { + it('does not render workspace roots inside reference scope', () => { const text = renderReferenceScopeText( buildReferenceScope({ - workspace: { - workspaceId: 'workspace-1', - workspaceName: 'display-name-only', - rootPath: '/tmp/real-workspace-root' - }, selectedReferences: [] }) ) - expect(text).toContain('用户工作区域：') - expect(text).toContain('- 根目录：/tmp/real-workspace-root') + expect(text).toContain('用户指定的参考范围：') + expect(text).toContain('- 当前没有用户显式指定的参考范围。') + expect(text).not.toContain('用户工作区域：') + expect(text).not.toContain('根目录：') expect(text).not.toContain('默认应优先在此目录内完成用户任务') - expect(text).not.toContain('所有任务文件和新生成的产物都必须位于这个工作区内') - expect(text).not.toContain('display-name-only') expect(text).not.toContain('cwd') - expect(text).not.toContain('显式指定 cwd') }) it('renders selected references and direct kb narrowing pairs when user explicitly selected inputs', () => { const text = renderReferenceScopeText( buildReferenceScope({ - workspace: { - workspaceId: 'workspace-1', - workspaceName: 'display-name-only', - rootPath: '/tmp/real-workspace-root' - }, selectedReferences: [ { kind: 'file', @@ -56,11 +45,6 @@ describe('ai unit selected context workspace path', () => { expect( renderReferenceScopeText( buildReferenceScope({ - workspace: { - workspaceId: 'workspace-1', - workspaceName: 'display-name-only', - rootPath: '/tmp/real-workspace-root' - }, selectedReferences: [ { kind: 'directory', @@ -90,11 +74,6 @@ describe('ai unit selected context workspace path', () => { expect( renderReferenceScopeText( buildReferenceScope({ - workspace: { - workspaceId: 'workspace-1', - workspaceName: 'display-name-only', - rootPath: '/tmp/real-workspace-root' - }, selectedReferences: [ { kind: 'web', @@ -116,11 +95,6 @@ describe('ai unit selected context workspace path', () => { it('renders user selected attachments with compact content-info template', () => { const text = renderReferenceScopeText( buildReferenceScope({ - workspace: { - workspaceId: 'workspace-1', - workspaceName: 'display-name-only', - rootPath: '/tmp/real-workspace-root' - }, selectedReferences: [], attachments: [ {