docs(集成): 同步平台承担的知识库向量规则
This commit is contained in:
@@ -8,12 +8,18 @@ Accepted / implemented,2026-09-11 集成。产品范围、三端分工、创
|
||||
|
||||
- MakeLore Agents 面向个人创作者,支持配置试用、发布、指定账号分享、应用 API 与主动/定时任务;不引入组织、团队钱包或小智平台。
|
||||
- Works Square 拥有账号、模块/模型资格、短期授权和唯一 Token Points 账本;Yuxi 拥有云配置、不可变版本、访问授权、原生 Request/FIFO/Run、worker、checkpoint、调度及资源;MakeLore Main 拥有凭据、网络、文件传输与账号隔离的本机恢复记录,Renderer 使用 typed Host API。
|
||||
- 创建者为自用、分享、API、定时、预览和知识模型调用付款;调用者独享会话/文件,应用是独立主体。创建者只查看应用调用状态、版本、时间及费用元数据,付款不增加内容权限。
|
||||
- 接受请求时固化身份、版本和配置;恢复与子调用沿用根 Request。每次真实模型调用重新准入,预算是当前服务端政策。
|
||||
- 每 Agent 可设根请求/每日上限;空值不增加限制,0 阻止新收费调用。北京时间零点划日,按模型准入日归属;原钱包锁内统计结算与未决预占。降低上限影响后续调用。未知用量继续预占,供应商异常超预占按原 pending_review 核对,不宣称供应商账单绝对封顶。
|
||||
- 创建者为自用、分享、API、定时、预览及知识流程中另行发起的聊天模型调用付款;知识库 embedding 由平台承担,不计算用户用量、词元点数或智能体金额预算。调用者独享会话/文件,应用是独立主体。创建者只查看应用调用状态、版本、时间及费用元数据,付款不增加内容权限。
|
||||
- 接受请求时固化身份、版本和配置;恢复与子调用沿用根 Request。每次真实模型调用检查当前访问资格,收费聊天调用另按当前服务端政策检查金额预算;embedding 不进入预算。
|
||||
- 对用户承担费用的聊天调用,每 Agent 可设根请求/每日上限;空值不增加限制,0 阻止新收费调用。北京时间零点划日,按模型准入日归属;原钱包锁内统计结算与未决预占。降低上限影响后续调用。未知用量继续预占,供应商异常超预占按原 pending_review 核对,不宣称供应商账单绝对封顶。
|
||||
- 日程建议只保存建议;手动/建议新建均默认停用,创建者核对能力、限制、结果和费用后启用。Agent 归档停用,恢复后保持停用;排队、运行或等待回答/审批的会话不能归档,活动状态取原生最新顶层 Run。旧版恢复只创建新草稿。
|
||||
- 个人 MCP/Skill/子智能体与知识复用原生资源所有权。知识替换先完成新索引,成功后移除旧文档;失败保留旧资料。本人附件导入不借用付款者权限。客户端未确认操作在重启后由用户明确重试或丢弃。
|
||||
|
||||
## Embedding Ownership And Funding(2026-09-15 accepted / implemented)
|
||||
|
||||
知识库 embedding 由 Yuxi 独占模型 spec、供应商模型 ID、地址、API Key 与实际维度,并由 Yuxi API/worker 直连供应商。费用由平台承担,不计算用户用量、不预占或扣除创建者词元点数、不占用智能体单次/每日金额预算;供应商可不返回 usage。账号、模块、调用者与知识库访问权限以及运行时限仍然生效。聊天模型继续沿用 Works Square/one-api 的授权和创建者计费;知识流程另行调用聊天模型时也遵守该规则。
|
||||
|
||||
本次明确修订早期“知识模型调用均由创建者付款”的范围。客户端知识模型列表使用 Yuxi 的 id/name/dimension,不与 Works Square/one-api 取交集;供应商凭据留在 Yuxi。客户端知识模型列表沿用 id/name/dimension 契约,配置说明只指向 Yuxi,知识及预算页面明确平台承担向量化成本。 配置和范围说明见[使用说明](../../README.md)。
|
||||
|
||||
## Consequences
|
||||
|
||||
云执行沿用 Yuxi 原生运行体系,WS 既有 Code/Canvas Gateway 和 MakeLore Code/Pi 保持各自范围。复用现有钱包避免重复账本。部署需兼容三端版本、WS 0088/0089、Yuxi 正式 schema 迁移及身份/服务凭据配置。
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
## Active Decisions
|
||||
|
||||
- [知识库向量配置与平台承担](ADR-2026-09-11-personal-cloud-agents.md):2026-09-15 amended / implemented;embedding 由 Yuxi 配置并直连供应商,不计用户用量、词元点数或金额预算,聊天沿用原计费。
|
||||
|
||||
- [个人云智能体与微信渠道](ADR-2026-09-11-personal-cloud-agents.md):2026-09-14 amended / implemented;每个微信账号独立扫码、选择已发布智能体;只接受扫码身份,移除邀请/使用范围/调用者管理。多账号路由、创建者计费及历史内容隔离保留;真实部署验收待执行。
|
||||
|
||||
- [官方模型能力与原生思考选项](ADR-2026-09-12-official-model-capabilities.md):2026-09-12 accepted / implemented;one-api 官方事实、Works v2 授权投影、受管模型图片输入与 Main-owned reasoningChoice,取代受管模型的静态推测与 Pi 枚举映射。
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# Data Flow
|
||||
|
||||
## Cloud knowledge embedding
|
||||
|
||||
MakeLore 知识库 → Yuxi 已启用 embedding 目录与知识库/发布快照 → Yuxi 直连供应商 → Milvus 索引或查询。向量费用由平台承担,不进入 one-api/Works Square 模型目录、用户用量、词元点数或智能体金额预算。下述既有受管模型能力链不作为云知识库 embedding 入口;聊天及其他原有网关能力保持。访问资格和实际运行时限仍由云执行检查。
|
||||
|
||||
## Managed model capability flow
|
||||
|
||||
one-api 官方接口/文档事实与实际 group 路由交集 -> Works 完整快照和业务授权 -> model-config v2 -> Main 安全 Provider metadata -> 产品 reasoningChoice/图片输入校验 -> 冻结父/子运行上下文 -> Pi 请求钩子清除 SDK 控制字段并写入原生字段。Renderer 消费相同能力投影,缺失事实不做名称推测;详情见[官方能力决策](../10-decisions/ADR-2026-09-12-official-model-capabilities.md)。
|
||||
@@ -96,4 +100,4 @@ Main 在接收带图消息时立即将上传 attachment id 放入 optimistic use
|
||||
|
||||
## Last Updated
|
||||
|
||||
2026-09-07
|
||||
2026-09-15
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
## Current Architecture
|
||||
|
||||
知识库 embedding 独立于原有 one-api 模型网关:Yuxi 拥有目录、供应商地址/密钥与实际维度并直连供应商,平台承担费用,不计算用户用量、词元点数或智能体金额预算。访问资格与运行时限保留,聊天计费不变;见[已接受向量规则](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md)。
|
||||
|
||||
微信账号生命周期独立于智能体:MakeLore“渠道 > 微信”展示用户的 Core ChannelAccount 清单,通过 Yuxi 用户级账号 API 连接及选择可选目标;多个账号可指向同一已发布智能体,路由切换保留登录。Core 持有路由与不可变回执,Yuxi 本地 binding 只索引当前关联并保留历史 caller/session,Main 持有请求恢复与凭据。发布页只显示关联摘要与入口;详见[用户级账号决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md)。
|
||||
|
||||
微信渠道只供扫码绑定的账号使用:Adapter 从持久登录状态匹配发送者,Core 校验绑定、代次、Worker 和会话后提供可信 `is_self`,Yuxi 据此建立账号隔离的 caller/session。其他微信需要各自扫码创建连接;不再提供使用范围、邀请或单个调用者授权管理。历史受邀记录不能进入新请求、恢复或投递,也不转为扫码账号内容。历史空身份连接需要重新扫码。
|
||||
@@ -122,4 +124,4 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
|
||||
|
||||
## Last Updated
|
||||
|
||||
2026-09-14
|
||||
2026-09-15
|
||||
|
||||
@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
|
||||
|
||||
## Integrated Through
|
||||
|
||||
- 2026-09-15:任务 `20260915-merge-platform-embedding-ml-4e78b319` 经用户授权移交主目录登记,将独立审查通过的 `c466039adb789368189e43971afe489d450d5c82` 无冲突快进合入本地 `main`。知识库 embedding 统一由 Yuxi 配置并直连供应商,平台承担费用,不计算用户用量、词元点数或金额预算;聊天计费保持。客户端知识模型列表沿用 id/name/dimension 契约,配置说明只指向 Yuxi,知识及预算页面明确平台承担向量化成本。 本次新规则取代早期知识库目录交集、one-api 向量接口和创建者付款说明,历史记录保留。源聚焦单测 22 passed、Electron E2E 1 passed、typecheck、scoped lint 与 Vite build 通过;最终文字调整后聚焦 22 单测再次通过,独立 Reviewer Standards/Spec PASS;详见[源任务](tasks/20260914-yuxi-embedding-ml-a174ed62.md)。原有三份文档保持,无新 SQL 或专用环境变量,未推送或部署;真实供应商及完整知识库拓扑验收另行执行。
|
||||
|
||||
- 2026-09-14:任务 `20260914-agent-ui-integration-4a838e7c` 将引导式智能体 UI 源 `6e6a8c92ddb66747a71af714809e2205292a0bf9` 无冲突合入本地 `main`,合并提交 `5a974cf78493b8dd92e176cc26fbe323a18e9570`。面向非专业用户与 8–15 岁学生的创建引导、基础要求、高级设置折叠、保存后重新试用、历史对比及首次自用确认已集成,见[已接受决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md)。保留主分支连接时差修复,产品代码与已验证源一致;集成时补充两条异步状态测试等待。组合验证累计 89 项相关单测、类型检查、Vite 全目标构建、Electron 引导用例通过;全量测试沿用源记录中已确认的 Pi v6/v7 既有失败限制。原有三份未跟踪记录原样保留;已授权的源工作区清理因 Git 目录非空错误受阻,残余保留,分支和提交完整。未推送、打包或部署。详见[集成记录](tasks/20260914-agent-ui-integration-4a838e7c.md)。
|
||||
|
||||
- 2026-09-14:任务 `20260914-merge-cloud-reconnect-8fe72c41` 经用户授权移交主目录登记,将源 `8a67e8bd47d814b533476a6e36421f7a5d983a27` 无冲突快进合入本地 `main`。云智能体 Main 凭证处理不再因签发端轻微快于客户端而拒绝正常的五分钟凭证,改为限制本地复用时长;服务端过期校验及既有刷新余量不变。产品树与已验证源一致,沿用 33 项相关测试、类型检查、scoped ESLint 和 Vite 全目标构建。该缺陷已复现,尚不能据此认定线上所有不可用提示均由此引起;详见[源任务](tasks/20260914-cloud-reconnect-5ad71e6c.md)。原有三份未跟踪文档保留;需要重新打包安装客户端才生效,未推送、打包、安装或部署。
|
||||
@@ -1069,4 +1071,4 @@ Robot 绑定设备默认先显示“引导配网 / 已有激活码”路径选
|
||||
|
||||
## Last Updated
|
||||
|
||||
2026-09-14
|
||||
2026-09-15
|
||||
|
||||
@@ -0,0 +1,40 @@
|
||||
# Task: 合并平台承担的知识库向量调用
|
||||
|
||||
## Identity
|
||||
|
||||
- Task ID: 20260915-merge-platform-embedding-ml-4e78b319
|
||||
- Mode: Integration
|
||||
- Branch: main
|
||||
- Worktree: D:\Datas\OthersProjects\makelore
|
||||
- Base commit: f92753329c511d60f61c156172fdf81eab2790d5
|
||||
- Owner: codex
|
||||
- Status: Ready for Integration
|
||||
|
||||
## Scope
|
||||
|
||||
- 将本批已审查的 Yuxi-only embedding 实现合入本仓主分支,并同步已接受决策、架构和集成状态。
|
||||
|
||||
## Intent And Constraints
|
||||
|
||||
- 用户明确要求 embedding 由 Yuxi 维护并由平台承担,不计算用户用量、词元点数或智能体预算;聊天沿用原有计费。
|
||||
- 2026-09-15 用户授权移交旧主目录登记、必要时替换独立 Reviewer、审查通过后提交并合并;保留本仓原有文档,不推送、部署或删除工作区。
|
||||
- Concurrent Task Gate 与 Planning Gate Passed;旧 ADR 的“知识模型调用付款”范围已由用户新决定修订。同批源实现与审查协调,其他任务记录只读。
|
||||
|
||||
## Outcome
|
||||
|
||||
- 替换 Reviewer embedding_review_replacement 对三端最终差异给出 Standards PASS / Spec PASS,无阻断;本仓源 `c466039adb789368189e43971afe489d450d5c82` 已无冲突快进合入 main。源任务记录原样导入,接纳并同步已接受的 embedding 配置/成本规则。
|
||||
|
||||
## Verification
|
||||
|
||||
- 源提交祖先检查与 --ff-only 合并通过,无冲突;合并后产品树与已审查源提交完全一致,未重复无变化的大范围测试。源任务中的实际验证和完整拓扑未验收限制原样保留。
|
||||
- git diff --check 与官方 check_doc_drift.py 通过。官方 drift 以接管时保存的 adopted_foreign_docs 状态核对原有文档未变,确认本次未修改或暂存原有文档;源任务记录作为已提交源原样导入。
|
||||
- 已接受 ADR、架构、决策索引与 current-state 同步明确 Yuxi 维护、平台承担 embedding、不计用户用量或预算、聊天原计费和既有索引保护;Integrated Through 记录实际源提交。
|
||||
|
||||
## Follow-ups
|
||||
|
||||
- 主分支合并完成;源工作区保留,单独列出路径征求清理确认,未答复不影响合并交付。审查工作区含未提交审查记录,继续保留。
|
||||
- 本次未推送、部署或操作生产数据库;没有新增 SQL 或专用环境变量。上线需部署匹配的 Yuxi API/worker、Works Square 和客户端,再验收真实供应商及完整知识库上传/索引/检索拓扑。
|
||||
|
||||
## Promotion Candidates
|
||||
|
||||
- 本 Integration 任务接纳源任务 promotion:更新个人云平台 ADR、架构与 current-state,明确平台承担 embedding 与原有聊天计费边界;历史任务记录保留原样。
|
||||
Reference in New Issue
Block a user