docs(集成): 同步平台承担的知识库向量规则
Some checks failed
Electron E2E / Electron E2E (macos-latest) (push) Has been cancelled
Electron E2E / Electron E2E (ubuntu-latest) (push) Has been cancelled
Electron E2E / Electron E2E (windows-latest) (push) Has been cancelled

This commit is contained in:
2026-09-15 10:04:38 +08:00
parent c466039adb
commit a39fbc1619
6 changed files with 62 additions and 6 deletions

View File

@@ -8,12 +8,18 @@ Accepted / implemented2026-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 Funding2026-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 迁移及身份/服务凭据配置。

View File

@@ -2,6 +2,8 @@
## Active Decisions
- [知识库向量配置与平台承担](ADR-2026-09-11-personal-cloud-agents.md)2026-09-15 amended / implementedembedding 由 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 / implementedone-api 官方事实、Works v2 授权投影、受管模型图片输入与 Main-owned reasoningChoice取代受管模型的静态推测与 Pi 枚举映射。

View File

@@ -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

View File

@@ -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/sessionMain 持有请求恢复与凭据。发布页只显示关联摘要与入口;详见[用户级账号决策](../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

View File

@@ -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`。面向非专业用户与 815 岁学生的创建引导、基础要求、高级设置折叠、保存后重新试用、历史对比及首次自用确认已集成,见[已接受决策](../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

View File

@@ -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 与原有聊天计费边界;历史任务记录保留原样。