私域数据模型与存储

    状态：已实现（无对外 HTTP REST；桌面端本地 + 私有云对象存储）
    源码：py_tauri_works/src/services/privateDomain/
    UI：开发者模式 → 私域（/private-domain）

    私域为 Agent 划定领域边界，包含五类积累条目、提升标准/动作，以及绑定的 memoryScope（向量记忆分区）。

    :::tip 两类数据

    • 五类卡片（知识 / 流程 / 规则 / 决策 / 评价）：私域条目，Host 软件连接不会自动增加。
    • 向量记忆：按 memoryScope 计数；Host chat / summarize 成功后可写入（需向量组件就绪）。 :::

    核心类型

    PrivateDomain

    字段说明
    id如 pd_mt4pgifv_uug8px
    name / description / icon展示
    memoryScope如 user:1/domain:pd_xxx（创建时自动生成）
    linkedSopIds / linkedSkillIds关联 SOP / 技能
    assets五类积累条目数组
    improvementStandards提升标准
    improvementActions提升动作（memory / sop / skill / prompt / manual）
    isSystem系统用户私域，不可删除

    五类积累（PrivateDomainAssetKind）

    key中文名
    knowledge私有知识库
    workflow领域动作流程
    validation业务校验规则
    decisions历史决策样本
    evaluation领域评价标准

    PrivateDomainAsset（条目）

    id、kind、title、summary、content、tags、linkedSopId、linkedSkillId、source（manual | imported）、时间戳。

    本地持久化

    键 / 文件内容
    localStorage.private_domains_v1自定义子私域数组（不含系统用户私域体）
    用户系统私域userSystemPrivateDomain.ts 单独管理，与登录态绑定
    localStorage.host_bridge_client_private_domainsHost clientId → 私域挂接 id
    localStorage.integrationsMCP 项含 memoryScopeBinding

    变更事件：PRIVATE_DOMAIN_CHANGED_EVENT（private-domain-changed）。

    前端 Store API（摘要）

    privateDomainStore.ts 导出（供扩展与调试参考）：

    函数说明
    listPrivateDomains() / listCustomPrivateDomains()列出私域
    getPrivateDomain(id)单条
    createPrivateDomain(...)创建子私域
    updatePrivateDomain(...)更新元数据
    deletePrivateDomain(id)删除（系统私域不可删）
    upsertAsset / deleteAsset五类条目 CRUD
    upsertImprovementStandard / upsertImprovementAction提升标准/动作
    buildDomainMemoryScope(domainId)生成 scope 字符串

    层级常量：WORKS_ROOT_DOMAIN_ID、USER_SYSTEM_DOMAIN_ID（privateDomainHierarchy.ts）。

    私有云对象键

    通过 api/storage/index.ts 上传/拉取（需登录与私有云配置）：

    对象路径内容
    desktop/{userId}/private-domains/domains.json私域定义合并包
    desktop/{userId}/memory/meta.json记忆元数据（不含向量）
    desktop/{userId}/memory/exports/{clientId}.jsonHost 分区导出
    desktop/{userId}/integrations/mcp.jsonMCP 连接配置云同步

    服务：privateDomainCloudSyncService.ts、memoryCloudSyncService.ts、integrationCloudSyncService.ts。

    设置 → 系统设置 → 向量记忆 → 分区管理 中可「同步私域到云」。

    记忆分区挂接

    灵感绑定（ownership）

    bindPrivateDomainToImmediate(immediateId, privateDomainId) — 灵感页选择私域；Agent Run 注入 privateDomainPrompt 并解析 scope。

    MCP 连接挂接（非 ownership）

    bindIntegrationMemoryScope(integrationId, binding)：

    binding 值含义
    null / __host_isolated__连接隔离（Host 场景为 host:{clientId}）
    __works_root__Works 主私域（user:{cloudUserId}）
    pd_xxx子私域 id

    字段 privateDomainId 已废弃，统一用 memoryScopeBinding。

    软件连接挂接

    hostBridgeClientBindings.ts：setHostClientPrivateDomainId(clientId, domainId)
    与 MCP 挂接语义相同，按 登记 clientId 存储。

    解析最终 scope：resolveHostMemoryScope(clientId) → 挂接私域的 memoryScope 或 host:{clientId}。

    导入 / 导出

    privateDomainExportService.ts / privateDomainImportService.ts：

    格式说明
    JSON完整 schema，可合并导入
    Markdown人类可读领域文档
    PDF排版导出

    可选附带本私域 memoryScope 下的长期记忆文本。向量本身通过 记忆分区 管理。

    Agent 集成

    模块作用
    privateDomainContext.tsresolveMemoryScopeForAgent、buildPrivateDomainPromptLayer
    privateDomainAutoDeposit.tsRun 结束后自动沉淀条目
    privateDomainStats.ts页内「记忆 N 条」与各类统计
    promptLayers.tsPrompt 顺序：Rules → Soul → 私域 → SOP → 技能

    相关文档