From 46e7f6f1cd37124493be48bbb85f6a6d1de59c17 Mon Sep 17 00:00:00 2001 From: brother7 <7brother7@gmail.com> Date: Sun, 13 Sep 2026 23:26:41 +0800 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E8=AE=B0=E5=BD=95=E5=BE=AE?= =?UTF-8?q?=E4=BF=A1=E6=9C=AC=E4=BA=BA=E5=85=8D=E9=85=8D=E5=AF=B9=E4=B8=BB?= =?UTF-8?q?=E5=88=86=E6=94=AF=E9=9B=86=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ADR-2026-09-11-personal-cloud-agents.md | 6 ++- .../20-architecture/system-overview.md | 2 + .project-docs/30-worklog/current-state.md | 2 + .../20260913-merge-wechat-self-ml-a904d7c1.md | 40 +++++++++++++++++++ 4 files changed, 48 insertions(+), 2 deletions(-) create mode 100644 .project-docs/30-worklog/tasks/20260913-merge-wechat-self-ml-a904d7c1.md 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 index d649b55..c1404d5 100644 --- 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 @@ -27,16 +27,18 @@ Accepted / implemented，2026-09-11 集成。产品范围、三端分工、创 ## Personal WeChat Publication（2026-09-13 accepted / implemented） -- Published cloud agents expose a native personal WeChat panel: create/adopt account, local QR rendering, verification, self pairing/invitations, access revocation, enable/pause, route switch, disconnect, safe activity and failed-file retry. +- Published cloud agents expose a native personal WeChat panel: create/adopt account, local QR rendering, login verification, direct use by the scanning owner, contact invitations, access revocation, enable/pause, route switch, disconnect, safe activity and failed-file retry. Creator self-pairing codes are removed, including stale recovery presentation; invited contacts still receive a complete invitation command. - Renderer uses typed Host operations. Main owns credentials, network, per-account durable original operations and file saving. Verification codes never enter the recovery journal; uncertain mutations require explicit recovery. - QR payloads are encoded locally. Account or Provider-generation changes clear transient state. Enable confirmation shows the actual published version, audience and task/daily budget, including zero. - Own WeChat conversations use dedicated Yuxi session endpoints for approval, stop/new session, complete history pagination and automatically refreshed deliverables. The creator cannot browse invited callers' content. -- Scheduled result notification requires an explicit paired self target. Execution completion and WeChat delivery status remain distinct; retrying a failed file part does not run the model again. +- The scanning owner's first message establishes their history and available notification conversation. Scheduled result notification requires an explicitly selected self target. Execution completion and WeChat delivery status remain distinct; retrying a failed file part does not run the model again. Source `2e710db0fb512f276fda8ae8a3939d366b34a972`, [source task](../30-worklog/tasks/20260913-agentbus-channels-ml-3ec75b90.md). Final 81 focused tests, typecheck, production build and 2 Electron scenarios passed, with independent review PASS. Tests use local Host fixtures; real WeChat, billing, packaging and deployment acceptance remain pending. ## Evidence And Limits +The creator no-code change explicitly replaces the earlier pairing step. See [reviewed source task](../30-worklog/tasks/20260913-wechat-auto-self-ml-3679bce2.md): 64 focused tests, typecheck, build, scoped lint and an inspected Electron scenario passed; independent review passed. Main remains the network boundary and Yuxi/AgentBus establish identity. Compatible backend and client deployment is required; historical connections missing scanning identity need one reconnect. No real WeChat acceptance or installer was produced by this change. + 源：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/20-architecture/system-overview.md b/.project-docs/20-architecture/system-overview.md index 018350e..c6e9d27 100644 --- a/.project-docs/20-architecture/system-overview.md +++ b/.project-docs/20-architecture/system-overview.md @@ -2,6 +2,8 @@ ## Current Architecture +扫码本人免配对：微信 Adapter 从持久登录状态读取扫码者身份并匹配原始发送者，Core 经绑定、代次、Worker 和会话范围校验后提供 `is_self`，Yuxi 才建立本人 caller/session。客户端不声明本人身份；邀请、撤销和调用者内容隔离保持原规则。历史空身份连接重新扫码后会刷新运行实例，无需推进账号代次。 + 个人微信云智能体已按 [已接受渠道决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md) 集成：AgentBus 拥有共享身份下的 Worker/ChannelAccount 路由及交付，Yuxi 拥有独立调用者会话和原生执行，Works Square 拥有创建者词元点数，MakeLore Main 拥有桌面授权与恢复。沿用标准 Worker，不增加独立 Adapter 池；付款不授予受邀调用者内容权限。上线验收与本地代码集成分开记录。 个人云智能体职责见 [已接受决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md)：Yuxi 拥有云执行，WS 拥有账号和词元点数，MakeLore Main 提供 Host API；Code/Pi、Canvas、Robot 保持既有体系。 diff --git a/.project-docs/30-worklog/current-state.md b/.project-docs/30-worklog/current-state.md index 6d3f57d..559d487 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-13：任务 `20260913-merge-wechat-self-ml-a904d7c1` 将已审查源 `8c1b161d0e14394beb62ae7f7e05c96cfed045b2` 无冲突快进合入本地 `main`。个人微信发布页移除本人配对入口，扫码本人直接使用；首条消息建立本人历史和通知目标，其他联系人仍通过独立邀请接入。源任务记录原样导入，独立 Reviewer 最终 PASS，验证与线上限制见[源任务](tasks/20260913-wechat-auto-self-ml-3679bce2.md)。原有 3 份未跟踪文档保持不变；未推送、部署或清理工作区。 + - 2026-09-13：任务 `20260913-merge-agentbus-channels-ml-c4e81f2a` 经用户授权移交主目录后，将渠道源 `2e710db0fb512f276fda8ae8a3939d366b34a972` 从 `03774d0625a5a0d0221dbb9989e88a9406e0fa48` 无冲突快进合入本地 `main`。产品代码与已审查、测试的源完全一致，源任务记录原样导入；个人微信、共享 SSO 与按用户隔离规则见 [渠道决策](../10-decisions/ADR-2026-09-11-personal-cloud-agents.md)。原有 3 份文档改动原样保留；未推送或部署。授权清理的源工作区因 Git 目录非空错误部分移除，残余保留，分支和提交完整。 - 2026-09-13：续接任务 `20260912-land-model-capabilities-c6fa4309`，将图片附件修复源 `03fc50f7a9009b8e5c43fada8bc3365103dc732c` 从 `1d661f7` 无冲突快进合入本地 main。发送时、Pi 实时消息与历史恢复均保留图片引用，重复投影复用附件文件。产品树与已验证源完全相同，复用其相关回归、真实 Pi 新会话/恢复会话 HTTP、Electron 图片刷新、类型检查与构建证据。三个原有未跟踪记录保持原样；工作区清理等待单独确认，未推送、打包或安装。详见[图片流转](../20-architecture/data-flow.md#code-image-attachment-projection)。 diff --git a/.project-docs/30-worklog/tasks/20260913-merge-wechat-self-ml-a904d7c1.md b/.project-docs/30-worklog/tasks/20260913-merge-wechat-self-ml-a904d7c1.md new file mode 100644 index 0000000..c315178 --- /dev/null +++ b/.project-docs/30-worklog/tasks/20260913-merge-wechat-self-ml-a904d7c1.md @@ -0,0 +1,40 @@ +# Task: 合并微信本人免配对改动到主分支 + +## Identity + +- Task ID: 20260913-merge-wechat-self-ml-a904d7c1 +- Mode: Integration +- Branch: main +- Worktree: D:\Datas\OthersProjects\makelore +- Base commit: 4ca1f89a7e2d1a2c7e90af3b4aeb3541f3f0cd4f +- Owner: codex +- Status: Ready for Integration + +## Scope + +- Integrate the reviewed creator WeChat auto-self source into the local main branch and promote its accepted identity/UI contract. Preserve the existing foreign documents and all source/review worktrees. + +## Intent And Constraints + +- Official Concurrent/Planning Gates Passed after explicit user authorization for one fresh read-only Reviewer and all three primary ownership handoffs. Existing foreign document states are adopted unchanged through the official scripts. Read active/startup/current/channel sources and source outcomes; unchanged peer contexts reused, fresh review peers added. Historical placeholders remain unknown/read-only with no concrete semantic dependency. +- User explicitly removes creator pairing codes while preserving separate invited callers and privacy. Source task records are imported unchanged after commit; this Integration task owns canonical promotion. +- Plan: finish independent review, remedy any supported findings in source-owned tasks, commit final sources, fast-forward main branches, promote bounded canonical changes, verify ancestry/product equivalence and documentation drift, then record completion. No push, deployment or directory removal. + +## Outcome + +- Integrated source `8c1b161d0e14394beb62ae7f7e05c96cfed045b2` by conflict-free fast-forward onto local `main`. Product files and the imported source task record remain identical to the reviewed source. Promoted the creator no-code identity contract to the accepted channel decision, architecture and current-state. +- The single user-authorized fresh Reviewer returned final PASS after the AgentBus active legacy-reconnect finding was fixed. Existing 3 unrelated untracked documents remain outside this commit; source and review worktrees are retained. No push, deployment, packaging or paid requests. + +## Verification + +- Source ancestry and exact product/imported-record equivalence passed after fast-forward; only the three named canonical documents and this Integration record are changed. Git diff whitespace checks passed. Reusing final source checks because integration changed no product code. +- Source evidence: 64 focused tests, typecheck, scoped lint, production build and one inspected Electron fixture scenario passed; independent panel check passed 15 cases. +- Read the fresh review tasks' Scope/Intent/Promotion; no outstanding semantic conflict. Official documentation drift and completion gates are required before final response and are recorded by their command results. + +## Follow-ups + +- Deploy compatible AgentBus Core/WeChat Adapter and Yuxi API/Worker, and distribute an updated MakeLore client separately. Historical connections without stored scanning identity need one reconnect. No new environment variables or schema migration. Real WeChat delivery remains an external acceptance step. + +## Promotion Candidates + +- Promoted the source task's accepted creator no-code identity/UI decision, replacing the prior self-pairing requirement at the user's explicit request. Existing invitations, revocation, caller privacy and creator billing remain. No candidates deferred.