docs(agents): 集成个人云智能体平台与最终费用政策
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
# 个人云智能体平台
|
||||
|
||||
## Status
|
||||
|
||||
Accepted / implemented,2026-09-11 集成。产品范围、三端分工、创建者付费与预算范围均已获用户确认。历史提案保留原样,本文表达已接受规则。
|
||||
|
||||
## Decision
|
||||
|
||||
- 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 核对,不宣称供应商账单绝对封顶。
|
||||
- 日程建议只保存建议;手动/建议新建均默认停用,创建者核对能力、限制、结果和费用后启用。Agent 归档停用,恢复后保持停用;排队、运行或等待回答/审批的会话不能归档,活动状态取原生最新顶层 Run。旧版恢复只创建新草稿。
|
||||
- 个人 MCP/Skill/子智能体与知识复用原生资源所有权。知识替换先完成新索引,成功后移除旧文档;失败保留旧资料。本人附件导入不借用付款者权限。客户端未确认操作在重启后由用户明确重试或丢弃。
|
||||
|
||||
## Consequences
|
||||
|
||||
云执行沿用 Yuxi 原生运行体系,WS 既有 Code/Canvas Gateway 和 MakeLore Code/Pi 保持各自范围。复用现有钱包避免重复账本。部署需兼容三端版本、WS 0088/0089、Yuxi 正式 schema 迁移及身份/服务凭据配置。
|
||||
|
||||
## Evidence And Limits
|
||||
|
||||
源:WS `0f1fb8af`、Yuxi `1df0142`、MakeLore `303f262`;本仓库见 [源任务](../30-worklog/tasks/20260910-personal-agent-platform-d15b2559.md)。本批独立 Reviewer 最终 PASS。源验证包含 WS 113 passed / 1 skipped 和预算 PG 4 passed,Yuxi 1985 non-slow unit / 19 HTTP-存储 integration 及归档最后补丁 3 integration,MakeLore 39 unit / Renderer tsc / build / Electron 1 passed。模型授权/供应商及沙盒释放有明确替身;MakeLore Main 全仓保留 61 项既有类型诊断。
|
||||
|
||||
真实收费模型对账、完整服务/ARQ/provisioner 与重启、安装包/协议/跨设备、生产迁移和部署仍待验收。并行 OSS 替换与远程 Milvus 部署由各任务集成和验收;本决策不接受其尚未合入的存储实现。
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
## Active Decisions
|
||||
|
||||
- [个人云智能体平台](ADR-2026-09-11-personal-cloud-agents.md):2026-09-11 accepted / implemented;三端分工、创建者付费、恢复/资源/预算及发布证据边界。
|
||||
|
||||
| ID | Decision | Status | Date | Applies To | Detail |
|
||||
|---|---|---|---|---|---|
|
||||
| ADR-008 | 交互式 AI 应用使用单一内部默认类型;目录式创建、Main-owned UUID、项目级官方插件、可选 Scaffold Skill 与发布权威分离 | Accepted / implemented, amended 2026-09-07 | 2026-09-04 | Project creation、`ProjectType`/identity、Official Plugins、Marketplace delivery、project-wide activation、Game Resource auto-delivery、release readiness | `adr-008-interactive-ai-app-scaffold.md` |
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
## Current Architecture
|
||||
|
||||
个人云智能体职责见 [已接受决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md):Yuxi 拥有云执行,WS 拥有账号和词元点数,MakeLore Main 提供 Host API;Code/Pi、Canvas、Robot 保持既有体系。
|
||||
|
||||
Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展示;Electron Main 持有认证、文件系统、安全打包、Works Square 网络访问和发布安全校验。
|
||||
|
||||
## Main Components
|
||||
@@ -16,7 +18,7 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
|
||||
| Works Session & Remembered Password | Main-owned 登录、刷新、注销、七天真实活动滑动续期与可选密码回填 | 登录、刷新、注销统一经过 Works Square;轮换凭据由 Main 安全持有和持久化。记住密码使用独立的 packaged-only OS 加密记录,不进入 Renderer 持久状态或 Works Square;客户端不携带 OAuth client secret |
|
||||
| Token Points V2 | Main-owned `/api/works/billing/points` 安全投影 → Renderer 账号菜单 | 会员管理者可查看套餐、本周与总余额及刷新时间;非管理者只获得 `shared_available` 粗粒度状态,套餐、周期和精确点数统一投影为 `null` |
|
||||
| Reset Card Wallet | Main-owned `/api/works/billing/reset-cards` list/redeem 安全投影 → Renderer 账号菜单卡包 | 仅展示 Works Square 的 owner-scoped 运营赠卡,客户端派生已到期状态但不计算重置额度、不乐观成功;服务端确认后同步刷新卡包与 Token Point V2 余额。付费重置卡仍由支付成功立即履约,不进入卡包。 |
|
||||
| Module Access Policy | Main-owned `/api/auth/me` projection → Renderer auth state → module chooser/router | Renderer 只接收 Code/Canvas/Robot 三个布尔值;缺失对象或字段默认开启,服务端 `design` 映射客户端 `painting`,额外旧字段被忽略 |
|
||||
| Module Access Policy | Main-owned `/api/auth/me` projection → Renderer auth state → module chooser/router | Renderer 接收 Code/Canvas/Robot/Agents 四个布尔权限;服务端 `design` 映射客户端 `painting`,云模块两端均为 `cloud_agents`;缺失对象/字段默认开启,额外字段被忽略 |
|
||||
| Submission Binding | 保存云端已接受的精确 app/version/review/hash 绑定 | schema v2 只记录成功提交;旧中间态迁移为 `legacy_retired`,不恢复后台任务 |
|
||||
| Play URL Projection | 校验服务端公共播放地址 | 只接受同源 HTTPS 和精确 `/apps/{app_id}/`;优先 `play_url`,`runtime_url` 仅一版本回退 |
|
||||
| Built Artifact Preflight | 在上传前对最终 built snapshot 做桌面/移动 UX fail-fast | Main 使用临时 loopback origin 与 Electron WebContents/CDP;不使用 Playwright、不生成可信证明 |
|
||||
|
||||
@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
|
||||
|
||||
## Integrated Through
|
||||
|
||||
- 2026-09-11:个人云智能体源 `303f262`(任务 `20260910-personal-agent-platform-d15b2559`,含前置提交)由 `20260911-integrate-cloud-agents-ef7bd545` 无冲突集成,实际主分支落地见本集成任务。源代码保留已审查内容;个人创作者、创建者付款、调用者内容隔离、配置/发布/分享/API/日程、恢复、资源维护和费用上限均已实现。源批次测试通过,真实模型、完整部署及安装包验收仍待执行;已确认费用规则取代旧“每日预算未定”。见 [个人云智能体决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md)。
|
||||
|
||||
- Expiring reset-card wallet source commit
|
||||
`01525834fd326a0fbcd6f537b11d6f278470f992` from task
|
||||
`20260908-reset-card-wallet-client-6c3e8a1f` is integrated onto local `main` by
|
||||
|
||||
@@ -0,0 +1,41 @@
|
||||
# Task: 集成个人云智能体平台到主分支
|
||||
|
||||
## Identity
|
||||
|
||||
- Task ID: 20260911-integrate-cloud-agents-ef7bd545
|
||||
- Mode: Integration
|
||||
- Branch: codex/20260911-integrate-cloud-agents-ef7bd545-integrate-cloud-agents
|
||||
- Worktree: D:\Datas\OthersProjects\.codex-worktrees\makelore\20260911-integrate-cloud-agents-ef7bd545
|
||||
- Base commit: 927a85fa22e003b2e09740f41e6a91c71ee278c1
|
||||
- Owner: codex
|
||||
- Status: Ready for Integration
|
||||
|
||||
## Scope
|
||||
|
||||
- 无冲突集成本仓库个人云智能体完整分支(最终源 303f262,含前置提交)到本地主分支,落实已确认的 canonical memory。
|
||||
|
||||
## Intent And Constraints
|
||||
|
||||
- Concurrent Task Gate 与 Planning Gate Passed:bundled start、integration 锁及 status 身份匹配;读取入口、本人记录、memory-index、定位、current-state、决策、架构、领域及证据/反思/承诺索引。
|
||||
- 逐项读取其他 176 个任务的 Scope、Intent And Constraints、Promotion Candidates。源任务属于集成依赖;Yuxi OSS 替换仍独立准备集成,后续需衔接存储调用点。远程 Milvus 部署不构成 ACK/云模块验收。
|
||||
- 用户已确认个人创作者、全部来源创建者付费、原生 Yuxi 运行/资源、每 Agent 根请求/每日费用上限,并要求合入主分支。Code/Pi、Canvas、Robot 保持原边界;不加入组织、小智或另一份账本。
|
||||
- 当前主分支是 reviewed source 祖先。fast-forward 保留全部提交及只读源任务文档;本轮仅编辑 canonical memory 和本人任务。主目录其他未提交文档与所有权保持原样,不推送、部署、迁移或删除工作树。
|
||||
|
||||
## Outcome
|
||||
|
||||
- 已无冲突 fast-forward 源 303f262 到独立集成分支;实际主分支尚待最终推进。
|
||||
|
||||
## Verification
|
||||
|
||||
- 源批次全新独立 Reviewer completion_review PASS;源 20260910-personal-agent-platform-d15b2559 记录实际测试与真实模型/进程/安装包限制。
|
||||
- 本轮 git diff --check、源 ancestry、代码/测试/配置与 reviewed source 一致、新增 canonical 链接及项目文档完整性/所有权边界检查全部通过。集成未引入行为修改。
|
||||
|
||||
## Follow-ups
|
||||
|
||||
- 完成验证后推进实际本地主分支;主目录接管受 skill 的显式 adoption/ownership recovery 规则约束。
|
||||
- 发布环境验收仍包括真实付费模型对账、完整 ARQ/provisioner 与重启、安装包/系统协议/跨设备、配置与生产迁移。
|
||||
- 工作树清理未获授权;成功合入实际主分支后按技能列出本批绝对路径及分支询问,保留源分支和提交。
|
||||
|
||||
## Promotion Candidates
|
||||
|
||||
- 本集成落实已确认个人云平台规则,并在 current-state 的 Integrated Through 记录源 303f262;已确认预算范围取代旧提案“每日预算未定”,历史源记录保持只读。
|
||||
Reference in New Issue
Block a user