diff --git a/.project-docs/10-decisions/ADR-2026-09-11-personal-cloud-agents.md b/.project-docs/10-decisions/ADR-2026-09-11-personal-cloud-agents.md new file mode 100644 index 00000000..afdff33c --- /dev/null +++ b/.project-docs/10-decisions/ADR-2026-09-11-personal-cloud-agents.md @@ -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 部署由各任务集成和验收；本决策不接受其尚未合入的存储实现。 diff --git a/.project-docs/10-decisions/decision-index.md b/.project-docs/10-decisions/decision-index.md index 852526ea..3bb040b3 100644 --- a/.project-docs/10-decisions/decision-index.md +++ b/.project-docs/10-decisions/decision-index.md @@ -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` | diff --git a/.project-docs/20-architecture/system-overview.md b/.project-docs/20-architecture/system-overview.md index 6cd2c0f4..12a7b26d 100644 --- a/.project-docs/20-architecture/system-overview.md +++ b/.project-docs/20-architecture/system-overview.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、不生成可信证明 | diff --git a/.project-docs/30-worklog/current-state.md b/.project-docs/30-worklog/current-state.md index 540e6686..22fc820c 100644 --- a/.project-docs/30-worklog/current-state.md +++ b/.project-docs/30-worklog/current-state.md @@ -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 diff --git a/.project-docs/30-worklog/tasks/20260911-integrate-cloud-agents-ef7bd545.md b/.project-docs/30-worklog/tasks/20260911-integrate-cloud-agents-ef7bd545.md new file mode 100644 index 00000000..f999ba19 --- /dev/null +++ b/.project-docs/30-worklog/tasks/20260911-integrate-cloud-agents-ef7bd545.md @@ -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；已确认预算范围取代旧提案“每日预算未定”，历史源记录保持只读。