Skip to content

[WIP] 微内核重构:Rust 核心、Go 扩展、协议模板与独立分发 - #675

Closed
LIghtJUNction wants to merge 118 commits into
mainfrom
wip/rust-core-go-extensions
Closed

LIghtJUNction wants to merge 118 commits into
mainfrom
wip/rust-core-go-extensions

Conversation

@LIghtJUNction

@LIghtJUNction LIghtJUNction commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

开发主线交接(2026-10-12)

开发默认主线现为 wip/rust-core-go-extensions;旧单体 main 与 traditional 冻结于 3948a0a1ee1cefdd016a7aa45a11851545bb4b85。分支交接不是发布、部署或验收通过。原问题、源码基线、测试与未完成项保留;旧单体路径仅作历史证据,后续先在微服务源码重新确认并按职责移植,不回灌旧数据库/权限/资金实现。

主线/S11 跟踪:#895。Extore 商品同步:#894,未验收,禁止部署,尤其禁止合并/推送 Extore main。

本 PR 原为 WIP → main。现在 WIP 已成为默认开发主线,旧 main 已冻结,因此关闭这个旧合并通道;没有执行合并,S11 仍未完成。原正文、局部验证及剩余责任保留,后续验收在 #895 跟踪。

S11 串行集成状态 — 2026-10-12

BLOCKED / Draft:本轮只完成前置项核对和一项构建租约修复,未完成 S11 的最终装配、迁移或整站验收。

继续更新本 PR,不新建替代集成 PR。读取时 WIP HEAD 为 a28f06e88b7adf3701937f2a4018689bdc96ad85,main HEAD 为 de2c439f26446792d4a605b2b91fa2b84777e284;这仅固定本次观察,不表示完成了该 main 的全部功能等价审查。任务文档中 5999dc656 的 HumanGrant 增量仍须纳入 A02/A10/S11 验收。

本轮 没有修改共享 WIP 的源码 HEAD。实际代码修复推送到已有 A09 PR #878;下面十份候选没有被批量合并。原 PR 元数据不是 Draft,与正文不符;现已转为 Draft。

前置 PR 与剩余责任

以下是根据各候选 PR 的范围、验证记录与明确缺项建立的接收清单,不是完整 main 功能分母或全部源码审计。PR 已创建不等于代码、接口、冻结回执及测试均已完成。各项继续更新原 PR,不另建重复 PR。

任务 现有 PR 已交付的局部范围 完成 S11 前仍需交付
A01 #881 管理员权限和逐账号批准预检 完整权限目录;可信持久身份上的业务检查;批准/审计/凭据失效事务及真实 PG 验证
A02 #877;另有 #866 OAuth 会话双因素拒绝检查、邮箱注册显式不可用;HumanGrant 候选 认证/Key/会话兼容合同;完整双因素、HumanGrant 等要求及真实服务测试;与 A10 明确邮箱行为
A03 #884 整批开账累计溢出及历史归属预检 冻结来源/资金单位合同;受控实际写入、目标校验、重放与未知结果恢复;订阅、Key、账本联接。--apply 仍拒绝
A04 #875 历史金额/用量投影与有限 JSON 导出 模块/依赖接入、锁文件、统一授权查询、完整财务 ZIP 与真实 PG/HTTP 测试;当前候选尚不能按完整集成测试编译
A05 #879 支付凭据保留、原渠道身份与恢复修复 Go 测试、宿主装配、冻结资金合同、持久化及实际进程重启恢复
A06 #876 分离只读对账与首次扣款 Go/PG 测试、商店/交付/退款等完整资金流程、身份和订单合同
A07 #882 用量校验和精确额度报价 Rust 编译测试、价格快照及真实预留/结算接入、供应商/流式/故障联合验证
A08 #883 助手历史凭据过滤修复 完整会话存储、安全模型委托、工具权限/预算/扣费/MCP 等集成与恢复
A09 #878 分发校验器及本地构建租约;本轮修复下级进程提前失锁 资源分配与合同冻结、Core 数据库维护/备份恢复/pgroll 适配、最终实际打包安装与 1C1G 验证
A10 #880 HumanGrant Web 入口和设置的局部候选 与 A02 冻结后端合同、翻译和完整 Web 检查、真实浏览器旅程及独立 CLI 范围验收

未获得十份完整的冻结合同、源码 manifest 和私有接线请求,不能以 PR 标题或若干隔离测试代替。S11 后续按 A01→A02→A03→A04/05/06/07→A08 的实际依赖统一接线,A09/A10 消费同版接口;遇到缺项继续回到上表原 PR 修正,不猜测权限或金融规则。

本轮实际代码与验证

已有 PR #878 新增提交 478f658cd7d550f7813f12e8a13630d0c8afb89e,仅修改测试用构建租约脚本及新增对应测试,+253/-13。原脚本只等待直接子进程,启动进程退出或关闭继承描述符后,仍活跃的下级进程会失去构建锁。修复用独立、短暂的 Linux 监督进程持锁并等待本地后代退出;不会扫描或停止无关进程。

  • 基线原有 10 项测试通过;新增的三个进程反例在原实现均失败。
  • 最终源文件:15 项唯一测试通过、0 skip;实际测试包括进程终止和下级进程存活,不是对象重建替身。
  • Linux / Python 3.13.5,命令:python -W error::DeprecationWarning -B -m unittest discover -s tests/architecture_completion -p 'test_build_lease*.py' -v。
  • 已核最终代码与测试的远端 blob SHA 等于本地实测文件,并以预期旧 HEAD 检查正常推进已有分支;不是强推。
  • 监督器自身被终止、远程 Docker daemon 作业、数据库写入锁、CPU/内存限制不在此修复证明范围内。

这些是 异地沙箱的测试工具验证,不是原工作区的 mise、Core/Go/Web/CLI、PG、分发或整站验收。未改产品运行配置、数据库结构、CI 触发器或子模块指针。

尚未执行的 S11 验收

本环境未找到任务指定工作区 /home/lightjunction/Documents/GITHUB/api.lmm.best-microservices,没有其私有合同/租约/历史源快照和本地服务,也没有所需 mise/Rust/Bun/PostgreSQL/Docker 工具。直接 Git 网络访问失败后使用已连接 GitHub 读取并更新既有 PR;这不等于访问了原工作区。

因此仍未执行:最终共享代码装配与完整组合构建;真实 PG 权限/资金/跨进程验证;同一源归档到全新目标的受控导入与对账;完整浏览器/CLI 旅程;最终安装/恢复/资源测试及本地切换。源码候选未被冻结和业务合同未完成也是独立阻断,不是只补装工具就能通过。

不标记 100%,不启用未验证的付费/管理能力,不改旧目标库或生产状态。本轮没有合并、发版、部署或移动真实资金。下面原有验证记录保留为历史证据,不得作为本轮 S11 组合通过的证据。


历史范围:文档、协议与独立分发

以下记录对应 f1f637423379a8b732d2cd1484834cebcb024798,不是当前 WIP HEAD。

当轮为全新安装的微服务重构,不升级或导入现有数据库,不把旧 Go 单体恢复为运行时回退;未合入 main、未发布 Release、未部署生产。

  • 分支:wip/rust-core-go-extensions
  • Rust 核心拥有身份、权限、资金和模型流量;Go 扩展拥有各自业务数据,不连接核心数据库。
  • 已有模块不等于已完成宿主组装或真实资金联合验收。架构入口:架构与状态。

从 72667564c0431754d4856dc2e0db55f360bd2745 开始,新增 fdfd9022 和 f1f63742 两次提交;65 个文件,新增 1,971 行、删除 4,123 行。

  1. 重写中英文首页、文档目录、开发、架构、协议和打包说明。19 份旧单体部署/数据库升级文档改为历史入口,保留路径和原文链接,移除失效命令。文档净减少 3,333 行。
  2. 用户协议(含服务条款)、隐私政策、退款政策各提供中英文 Markdown 草稿。站点、运营主体、联系方式、退款条件等由外部配置填写;默认不发布。
  3. Go 从 LMM_LEGAL_CONFIG_FILE 读取并校验协议快照。三个公开只读 API 保留前端响应结构,其他模块仍受认证保护。修改配置后只重启扩展,不重编译、不访问核心或数据库。模板未填完整时不能发布;没有新增管理员写入 API、用户同意记录或退款执行逻辑。
  4. 核心、扩展、CLI 和前端独立生成预览包。统一清单记录源码 SHA、文件摘要、大小和权限;拒绝路径越界、符号链接、额外文件及覆盖已有包。运营方 site.json、密钥和缓存不进入包内。Docker 同步携带模板和许可证。
  5. 移除向已删除 Go controller 写文件的 OpenUI 生成器及构建依赖,保留组件、提示边界和 HTML 转义测试。旧公开协议 URL 只跳转到配置后的页面,不再携带写死的运营政策。

历史验证记录(未由本轮 S11 重跑)

当轮实际源码为 f1f637423379a8b732d2cd1484834cebcb024798。

当轮预览构建与验证

  • 精确核对远端修改文件的内容与权限,与本地测试版本一致。
  • 文档链接/品牌、工作流、源码边界、11 个分发测试及 Go 协议/宿主 race 检查通过。
  • 核心和扩展的实际程序、运行镜像、许可文件及模板资源检查通过。
  • CLI 测试与 release 构建通过;前端 OpenUI 定向测试、实际构建和首包检查通过。
  • 四个真实预览包构建和 SHA-256 校验通过:核心、扩展、CLI 为 Linux amd64,前端与 CPU 无关;不声称其他平台在当轮验证。
  • 下载扩展产物后独立复核 GitHub artifact 摘要、包摘要和文件清单,并直接执行包内程序:公开读取、受保护入口、语言选择、重启更新和停用均通过。

第一次前端真实打包发现 .well-known/webmcp.json 被隐藏文件规则误拦。第二次提交只放行该精确公共路径,并增加真实文件回归和相邻私有文件拒绝测试;最终重新构建四个组件通过。早先 Go 校验服务连接失败通过重试恢复,没有关闭依赖校验。

当轮现有微服务检查记录为 success;Rust 检查及真实数据库测试、Go 全量 race、商店/客服 PostgreSQL、公开协议真实进程测试、跨进程事件恢复、Docker 通信与故障恢复检查均通过。但整站业务、支付及模型资金联调仍未完成,不能据此将 WIP 视为可发布版本。

当轮预览产物设置保留 7 天,不是正式发行或生产部署;本轮未重新核验其可下载状态。

当轮保留问题

核心模型路由、收费及资金 RPC 的最终连接、账本/预算/事件同事务处理、各业务模块宿主组装、统一空库结构检查和整站前后端联合验收仍需完成。收费依赖不可用时继续拒绝操作,不免费放行。

当轮修复了前端构建的旧 Go 生成物依赖,但没有声称全量前端回归通过。此前记录的工具配置测试旧路径依赖及其他前端失败,应单独验证和修复。协议通过文件配置,旧控制台 legal.* 设置尚未接回新宿主。

较早变基验证针对 2ed549cd,仅作历史证据,不替代当前验收。原记录的回退参考分支为 wip/backup-675-pre-rebase-20261010;本轮未修改它。

文档入口

架构收尾任务(含 S11) · 文档目录 · 隔离 Docker 开发栈 · 协议模板与配置 · 打包与分发

LIghtJUNction added a commit that referenced this pull request Oct 9, 2026
…urrent main

Consolidate the five WIP setup and temporary verification commits into one source commit based on main 4399bb6.

Preserve the complete migration from b86eb79 and all three upstream updates. Use the conflict-free combined source tree from GitHub's merge preview, with main as the sole parent (no merge commit in branch history).

Retire apps/api-rust and its deployment/package paths; retain the current Go/Web production backend. Introduce the fail-closed Rust core, native personal/team funding rules, modular Go extension host, shared contracts, and independently operated Docker services.

P0 only. Keep PR #675 draft. No production deployment, data migration, or live model traffic.
@LIghtJUNction
LIghtJUNction force-pushed the wip/rust-core-go-extensions branch 2 times, most recently from 165a17e to a6e4dd6 Compare October 9, 2026 20:07
@LIghtJUNction LIghtJUNction changed the title [WIP] Rust 核心与 Go 扩展微服务迁移 [WIP] Rust 核心与 Go 扩展微服务迁移(P0 已变基并收尾) Oct 9, 2026
LIghtJUNction added a commit that referenced this pull request Oct 9, 2026
…scopes

Continue #613 with reusable account references, scoped membership rules and an adapter to existing L0-L4 policy. Preserve personal L5/L6 and the manual-only safety workflow. No production routes or migrations are enabled.

Rebased-from: aba33eb
Rebase-base: a6e4dd6 (PR #675)
LIghtJUNction added a commit that referenced this pull request Oct 9, 2026
…pilot

Continue draft #656 with database ownership, session-fenced team creation,
ID-bound invitations, member changes, audit transactions and scoped HTTP routes.
Reuse the existing optional migration registry and manual billing-safety workflow.
Team billing, keys, handles and UI remain unavailable. Full database and HTTP
regressions are written but not yet executed; keep this default-off and WIP.

Rebased-from: 8190dbf
Preserve the newer router entry from PR #675 and replay only the original
three-line SetNativeAccountRouter registration. All other patch blobs are unchanged.
LIghtJUNction added a commit that referenced this pull request Oct 9, 2026
…egressions

Keep billing safety checks manual-only. Source and test files are unchanged from the isolated verification candidate 7c11493.

Rebased-from: b85fedd
Rebase-base: a6e4dd6 (PR #675)

Complete the four-commit replay of PR #656. Retain the disabled native-account
feature and draft status. No merge, production deployment or new CI test run.

Copy link
Copy Markdown
Member Author

团队开发线收束:#656 已关闭,保留设计而非整批合入

按维护者要求,独立团队 Draft #656 已关闭、未合并。本条替代正文和 docs/core-migration.md 中此前“#656 保持独立推进”的安排。团队需求不取消,后续统一在本 PR 的 Rust 核心中落地。 本轮仅分析源码和更新 PR 记录,没有改动本分支源码、删除参考分支、合并或部署。

完整的关闭前分析、源码位置与舍取理由见:#656 (comment)
最终 head 与关键文件核对见:#656 (comment)

保留为后续实现要求

  • 登录人、当前视图、Key 归属、付款账号分开;个人/团队用 kind + id,团队不是伪造用户。
  • 平台 L5/L6、账号成长 L0–L4、团队创始人/管理员/成员与消费授权分开。自然个人 L0 可加入团队,但不自动升级个人;封禁和撤销仍优先。
  • 逐 Key 付款账号顺序与账号内部订阅/钱包顺序分开。个人 Key 默认不花团队资金;团队 Key 只能花所属团队资金。已开始请求不更换付款人,退款仍归原账号。
  • 分层预算同时约束,跨 Key 累计成员用量;换 Key、改角色或退出重入不能清零。
  • 接受邀请时重查接收人、会话、邀请人当前权限及版本。旧邀请不能恢复被移除成员;重复操作不能重复产生副作用。
  • 创始人保留单一权威记录;成员变更与审计同时提交或回滚。保留并发、撤销、回滚和严格数据库约束的测试场景。

不重复引入 Go 核心实现

#656 的 NativeAccountStore、控制器、/api/accounts 路由和可选 GORM 迁移仍是旧 Go 身份服务的实现,不整体搬进本 PR。Rust 统一负责账号、成员、权限、消费授权、预算和账务写入;Go 只处理邀请邮件、通知、展示等易变环节,通过受限核心接口和事件工作。模型调用不得同步依赖 Go 确认成员或付款权限。

本 PR 已有 accounts.rs、funding.rs 和共享付款测试;这些不用再复制。仍需注意:TeamRole::can_manage_member 只是角色层级比较,不是完整授权;resolve_order 不查询真实成员也不预留资金。下一阶段应补真实用户/会话/成员/消费授权及事务内重查,再接预算、钱包、订阅、预留、结算和退款。

验收顺序

P1:真实身份/会话、唯一团队所有者、成员和邀请、撤销与平台权限隔离。
P2:跨 Key 预算累计、单请求付款归属、团队 Key 无个人回退、重复/乱序结算和退款。
之后接 Go 邮件通知与界面;验证扩展停止不影响既有模型请求。

#656 中并发接受/拒绝唯一结果、审计失败回滚、弱化数据库约束被拒绝等测试适合作为 Rust 验收输入,不意味着其旧测试可直接证明 Rust 正确。本轮没有运行新测试,没有声称团队业务已完成;本 PR 保持 Draft、未合并、未部署。

github-actions Bot pushed a commit that referenced this pull request Oct 9, 2026
…urrent main

Consolidate the five WIP setup and temporary verification commits into one source commit based on main 4399bb6.

Preserve the complete migration from b86eb79 and all three upstream updates. Use the conflict-free combined source tree from GitHub's merge preview, with main as the sole parent (no merge commit in branch history).

Retire apps/api-rust and its deployment/package paths; retain the current Go/Web production backend. Introduce the fail-closed Rust core, native personal/team funding rules, modular Go extension host, shared contracts, and independently operated Docker services.

P0 only. Keep PR #675 draft. No production deployment, data migration, or live model traffic.
@github-actions
github-actions Bot force-pushed the wip/rust-core-go-extensions branch from 2017f14 to e0b5162 Compare October 9, 2026 21:51
@LIghtJUNction
LIghtJUNction force-pushed the wip/rust-core-go-extensions branch 2 times, most recently from fa9ebf1 to bdfa790 Compare October 9, 2026 22:38
@LIghtJUNction LIghtJUNction changed the title [WIP] Rust 核心与 Go 扩展微服务迁移(P0 已变基并收尾) [WIP] Rust 核心与 Go 扩展迁移:原生身份、团队权限与 Docker 持久化 Oct 9, 2026
@LIghtJUNction LIghtJUNction changed the title [WIP] Rust 核心与 Go 扩展迁移:原生身份、团队权限与 Docker 持久化 [WIP] Rust 核心与 Go 扩展迁移:原生身份、团队与 Protobuf 通信 Oct 9, 2026

Copy link
Copy Markdown
Member Author

核对当前 head 5f1f5b3 后,发现协议工作流有一处路径回归:

建议保留独立的 extensions-go 检查与构建步骤,并对应其 go.sum 缓存键及 push 路径;如果也要检查 api-go,可另加步骤。

本条仅基于当前提交的静态源码、目录和调用链核对,没有执行工作流或测试,也不将此前提交的通过结果视为当前 head 的验证结果。

@LIghtJUNction LIghtJUNction changed the title [WIP] Rust 核心与 Go 扩展迁移:原生身份、团队与 Protobuf 通信 [WIP] 微内核重构:全新核心数据库与 Go 扩展服务 Oct 10, 2026

Copy link
Copy Markdown
Member Author

复核当前 head 63c345afc5c4de80eb5275499a157fa270d1ad2f:上一条路径问题已在该提交解决。

扩展入口现位于 apps/api-go/cmd/extensions,重复的 apps/extensions-go 已移除;生成脚本、工作流的工作目录、缓存键与 push 路径均指向 apps/api-go。该精确提交的 运行 38012253953已成功,已逐项核对生成绑定、Rust 检查、Go race/build、Docker 恢复与边界检查步骤。

本条仅关闭此前的路径与检查目标不一致问题;专项通过不代表整站功能或生产上线验收通过,PR 仍为 Draft。

@LIghtJUNction
LIghtJUNction force-pushed the wip/rust-core-go-extensions branch 2 times, most recently from e48670e to b83723c Compare October 10, 2026 02:31
@LIghtJUNction LIghtJUNction changed the title [WIP] 微内核重构:全新核心数据库与 Go 扩展服务 [WIP] 微内核重构:全新数据库、Go 扩展服务与旧迁移入口清理 Oct 10, 2026

Copy link
Copy Markdown
Member Author

任务 06 接口协调:Protobuf 与可靠事件

工作分支:wip/mk-06-protocol-events,从当前基础提交 b83723cd 开始。仅维护协议、内部 RPC、src/events/ 和 Go internal/coreclient/,不改任务 01–05 的业务实现。

拟定公共接入点:

  • 保持 control.proto 的现有字段/语义不变,新增独立 v1 事件与受控业务命令协议。
  • Rust 生产者必须使用业务的同一个 sqlx::Transaction<Postgres> 写 outbox,不能提交后才通知;事件包含稳定业务键、类型、版本、int64 资源 ID、资源版本及原始 Protobuf payload。
  • 持久订阅由核心配置/初始化阶段预设并绑定服务身份;Go 通过 Negotiate/Pull/Acknowledge/Retry 使用短请求和租约。断线不丢订阅,不用自增 ID 游标跳过晚提交事务。
  • Go inbox 与扩展本地数据库中的业务副作用同事务提交,成功后 ACK;不能把 ACK 当作资金授权。
  • 核心命令 inbox 按服务身份 + 实际用户 ID + 方法 + 幂等键隔离,内容不一致拒绝;去重与业务更新同事务。
  • schema/events.sql 独立交付,不接入旧迁移或本轮初始化程序。

任务 01/02/03/04 请在本线程提供需要的具体命令和事件字段;账本/计费方法只允许窄操作、引用已验证业务记录,不提供任意 SQL 或设置余额。业务尚未合并时仅验证基础机制,不能将测试计数器当成真实资金业务验收。最终集成需要显式接入事件 schema、订阅配置和 RPC event store。

LIghtJUNction commented Oct 10, 2026 •

Copy link
Copy Markdown
Member Author

任务 02 → 任务 06:资金接口交接(已通过账本验收)

独立 Draft PR:#694,分支 wip/mk-02-ledger,目标为本重构分支。已验证提交 bc05ca210fb1e7119f9671776f72e3936f02d741。

真实 PostgreSQL CI:fmt、严格 clippy 通过;48 个测试全部通过,其中账本 PostgreSQL 集成测试 14/14,通过了并发扣款、重复退款和丢失 COMMIT 响应后重试。未修改共享 Protobuf、身份 schema、Go 或初始化器;未合并、未部署。

完整接口和权限约束:ledger/README.md。请任务 06 按以下约束接入:

  1. PostLedgerRequest 使用 typed oneof:Credit/Transfer/Charge/Reserve/Capture/Release/Refund/Reverse。金额和 ID 用 int64;金额单位固定 credit_500k_usd(500,000/USD);owner 是 core_identity.accounts.id,不是 user/team ID。
  2. operation key 必须永久保存并重用。scope 由认证后的服务身份确定,不能让 Go/浏览器自由填写。响应区分已提交结果、永久业务拒绝、去重冲突,以及结果未知的数据库/网络失败。网络重试必须使用完全相同的请求和 key。
  3. 按 ledger.read/credit/transfer/charge/reserve/capture/release/refund/reverse 分开授权。Credit 只允许已核验付款凭据的路径;支付引用按 provider/merchant/environment/transaction 全局命名。退款/冲正必须核验对原交易的权限,目的账户固定为原付款方。Capture/Release 必须核验原预留所属服务和请求状态。
  4. Go 不得有账本数据库写权限,也不得使用余额补丁修复业务状态。外部业务使用持久重试/核对流程;外部支付商退款确认及可靠事件投递不是账本内部记账成功的同义词。
  5. 任务 03 的预算授权与资金预留必须形成 Rust 内的原子决策或持久单次授权凭据。当前 Ledger::execute 自己拥有事务,预算组合接口尚未接入;在这一点解决之前不要开放对外资金写入口。

账本定义独立保存在 apps/core-rust/schema/ledger.sql;最终集成阶段再接入全新数据库初始化和指纹校验。请勿合并或部署主 PR 来验证此任务。

Copy link
Copy Markdown
Member Author

任务 10(wip/mk-10-payments)给任务 02/06 的协议需求:当前基础提交 b83723cd 只有身份/团队只读 RPC,支付模块不会自行增加 Protobuf 或连接核心库。

需要由 Rust 提供并经宿主 Unix socket 窄接口暴露:

  1. 按当前用户凭证、明确的 personal/team account_id 授权 topup:create/read/refund/reconcile;服务凭证不等于用户授权。
  2. prepare:在创建外部订单前冻结收款账号、操作者、渠道商户、环境、外币最小单位金额和币种,返回不可变 intent。汇率、可入账金额和政策由 Rust 决定。
  3. credit:按 intent + provider/merchant/environment/transaction 验证与全局去重,原子写账;稳定请求键与完整请求摘要同时去重。只有 durable/applied receipt 才能显示已入账,accepted/queued 不算成功。
  4. refund_hold → refund_commit / refund_release:先冻结可退款资金,再调用渠道。结果未知时不得自动释放冻结;只有渠道明确成功/失败证据可提交/释放。退款必须绑定原入账和原外部付款,不接受任意转账目标。
  5. external_refund:处理平台后台退款及乱序事件;须原子处理尚未入账、已入账但 Go 丢失响应、已入账以及已有退款冻结等情况,并阻止随后旧 credit 请求重新加钱。通过 intent/原交易定位,不能要求 Go 一定已保存 credit_id。
  6. 所有命令支持超时后重复调用/查询同一结果,返回原请求键、摘要和稳定 receipt_id;不同摘要重用同一键必须拒绝。权限不足、暂不可用与结果未知应有不同错误。

Go 模块目前采用可注入 Core 接口 + 默认拒绝的 UnavailableCore;测试使用模拟核心,不会伪造真实 RPC 已接通。渠道仅提供证据,Go 无余额字段、无核心数据库连接。完整要求及事件状态说明将随本任务 Draft PR 提交。

Wire native identity/key/profile, console compatibility, shared charging and
commerce contracts, durable payment proof recovery, and streaming checkpoints
through the Core runtime. Keep optional money paths capability-gated and retain
holds when settlement is uncertain. Expose only audited ledger projections.

Default to /etc/lmm.conf.d/core.toml, reject mixed/invalid configuration, read
private credentials from bounded files, and require explicit shared-group RPC.
Regenerate the payment and commerce Go bindings from the canonical protocols.

Validated on immutable source08: cargo test --locked --no-fail-fast --all-targets
-- --test-threads=1 (429 passed, 3 ignored), all-targets clippy -D warnings, and
89-file rustfmt. The ignored payment test separately passed its real 302-second
Go/Core/PostgreSQL recovery run; remaining ignores are a duplicated benchmark.
Fixed-binary configuration/process and 8 different-UID RPC checks also passed.

This is source integration, not full main parity or activation of the existing
local v2 migration database. Real legacy money import, provider/browser parity,
and normal-host payment acceptance remain incomplete.
Add strict file-only TOML startup and bounded private credential reads. Keep
module database pools and runtime permissions separate, wire scoped Core
commerce clients, persist typed store prices and recovery records, and reject
unsafe repricing inside the order transaction.

Add assistant history/preset compatibility and tool-market Web contracts;
keep unsupported paid/delegated actions unavailable. Persist Core-verified
payment proof results so delayed and duplicate delivery recovers safely.

Validated with mise Go 1.27.2: 849 race test events passed, 7 optional fixtures
skipped; gofmt/vet/build passed with 184 source inputs unchanged. Separate
PostgreSQL checks passed 5 store tests plus 3 subtests and 4 assistant-history
tests. Actual TOML sample and legal processes passed. The Rust-coordinated
302-second payment recovery joint test separately passed with real PG.

The store PG tests use controlled Funds, not the real Core commerce bridge.
Normal payment host wiring, assistant model delegation, tool-market actions,
and legacy Web seller-terms capability compatibility remain incomplete.
Define /etc/lmm.conf.d/{core,extensions}.toml and separate private files,
/var/lib/lmm state, /run/lmm IPC, /usr/share/lmm assets, and journal defaults.
Document XDG client paths as policy without claiming CLI implementation.

Update native packages, explicit static service users, optional RPC group
examples, noreplace configuration and non-destructive lifecycle rules. Remove
obsolete environment samples and use read-only TOML Docker mounts with separate
owner/runtime credentials and project-scoped networks. Keep optional modules
closed unless configured. Update development, protocol, legal and distribution
guards and parser attribution without changing CI trigger policy.

Local validation passed: 19 boundary, 8 workflow, 14 distribution, 5 docs,
33 documentation and 20 package-definition tests; Compose rendering/privacy
fixtures and actual fixed-binary base/legal configuration checks also passed.
Real cold Docker build and native installation were not performed. nFPM tool
build is blocked by a dependency checksum mismatch; the native-encoder attempt
fails because nfpm is unavailable, and no integrity check was bypassed.

Existing local services/data and four unfinished identity/console migration
scripts are preserved. This commit does not migrate existing installations,
initialize databases, start services, publish packages, or deploy production.
Scope AGENTS, all eight skills and setup/check guidance to the actual
microservice branch. Reuse component artifacts, avoid repeated aggregate
checks and correct the Go extension startup example. Keep core ownership,
isolated initialization and independent acceptance requirements intact.

Docs only; no runtime, test, workflow or quality-gate implementation changes.

Copy link
Copy Markdown
Member Author

WIP 文档与技能效率优化

已直接追加到 wip/rust-core-go-extensions,没有合并 main、发布或部署。

  • 基准:1cbcbee10a0558865b5667e931cd2c46d51d9d87
  • 提交:a28f06e88b7adf3701937f2a4018689bdc96ad85
  • 范围:15 份 Markdown,覆盖全部 8 个项目技能;新增 780 行、删除 925 行,净减少 145 行。

主要改动:

  1. AGENTS 改为导航;继续复用现有 WIP 和工作区,不在每轮新建分支、清理全部分支、扫描所有 PR 或安装全部工具。
  2. 技能明确触发范围和完成条件,补回首页粒子技能索引。翻译值和文档正文不再默认触发应用构建或无关工具自测;普通 PR 不套用悬赏结算流程。
  3. 部署指导适配本分支的 Rust 核心、Go 扩展、CLI 子模块和静态 Web。只构建所需组件,复用来源匹配的程序/归档;转换 Linux 包格式不重新编译每个组件。服务节点不承担无关冷构建。
  4. 修正 Go 启动示例为 go run ./cmd/extensions --config ...。质量指南移除写死的旧审查基点,直接选择所需一层,不依次重复 quick/related/full。

保留核心独立运行、核心数据库归属、安装 owner/runtime 分离、空库显式初始化、来源/签名、权限/计费/并发/失败测试及独立验收要求。没有修改应用代码、部署实现、测试断言、质量工具/阈值/债务记录、工作流或上游技能参考。

实际验证:

python3 -B /mnt/data/wip-docs-task/validate_wip_docs.py
PASS: 15 Markdown 基本格式、编码、冲突标记与代码围栏。
PASS: 8/8 技能 YAML 解析、名称/描述、索引和前端路径。
PASS: 9 段 Shell 经 bash -n 检查;没有执行示例里的安装/数据库操作。
PASS: 40 处相对链接在修改文件快照内解析;28 处匹配已读取的基准文件/目录记录。
PASS: 18 处 just 命令引用与本分支 justfile 一致。
PASS: 15/15 远端 Git blob 哈希与本地已验证文件一致,文件模式保留。

辅助验证脚本和日志仅在本次工作环境中,没有加入仓库。完整检出不可用,因此没有执行完整仓库 check-docs-brand.py --docs-only;上述结果不是全仓检查。未覆盖的原有链接、标题锚点、远程 URL、实际技能自动选择和命令运行仍未验证。没有应用构建、真实数据库、浏览器、包安装或生产验收,也没有部署耗时实测。

使用预期分支 SHA 和非强制更新写入,未覆盖其他分支历史。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blocked 有明确阻断或未决设计问题,不能直接合并或交付

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants