Skip to content

docs(extensions): 定义独立 Mac Peer、开放分发与本地文件收入合同 - #42

Merged
xiaoland merged 5 commits into
mainfrom
feat/mac-local-files-contract
Oct 26, 2026
Merged

xiaoland merged 5 commits into
mainfrom
feat/mac-local-files-contract

Conversation

@xiaoland

@xiaoland xiaoland commented Oct 23, 2026 •

Copy link
Copy Markdown
Member

本 PR 汇总独立 Mac Peer、Capture 和本地文件扩展的共享合同,替代此前的父候选 #39。

Capture 由各分发独立完成采集和直接写入;共享资料使用 Block/Relation/Storage,本机 SQLite 保存草稿、待办及确认结果,不增加 Capture 专表。共享分发标识是开放字符串,加载能力由各宿主校验。本机启停与指定信息库的共享版本选择分别表达。目录文件使用 inkcre-peer-file://<peer-id>/<绝对路径>;修改更新当前正文,原件删除后保留内容并标记来源失效。

验证:对最新 main 重排后,pnpm --dir website check 及 Website contract 均通过。人工复查确认合同符合用户对等 Peer、简单实现和未发布候选直接修订的要求;不声明正式包已发布。

关联交付:InKCre/impl-py#158、InKCre/impl-ts#164 及 Swift/Runtime 修正 PR。共享文档先合并,再单独更新消费者 gitlink。合并不迁移现有开发数据;回退可撤回本 PR 文档变更。

- 定义 Mac 系统采集与持久待办的能力边界
- 明确通过共享公告调用采集能力,收入后由其他 Peer 独立读取
- 将采集构图与校验归还 Mac Peer,读取分发可选。

- 定义图、原始字节和幂等回执的原子提交合同。
- 将 Capture 业务事务归属扩展,Mac 原生直连共享 PostgreSQL
- 定义随签名应用交付的精确分发及启停参与语义
- 明确 Peer 文件位置、更新、删除保留及提取范围
- 区分原生本地停用与共享参与同步
- 移除独立 Capture 共享回执表合同,保留原身份恢复语义。

- 区分本机运行开关与指定信息库的内置版本选择。
@xiaoland
xiaoland force-pushed the feat/mac-local-files-contract branch from 831e835 to 5777f1d Compare October 26, 2026 14:31
@xiaoland xiaoland changed the title docs(local-files): 定义持续收入与跨端读取合同 docs(extensions): 定义独立 Mac Peer、开放分发与本地文件收入合同 Oct 26, 2026
@xiaoland
xiaoland changed the base branch from feat/mac-capture-topology to main October 26, 2026 14:31
@xiaoland
xiaoland marked this pull request as draft October 26, 2026 14:35
@xiaoland
xiaoland marked this pull request as ready for review October 26, 2026 14:35
@xiaoland
xiaoland merged commit 311c69b into main Oct 26, 2026
3 checks passed
xiaoland added a commit to InKCre/impl-py that referenced this pull request Oct 26, 2026
- 固定已推送的 Hub 合同提交 831e835
- 与分发实现提交分离,合并依赖 InKCre/docs#42
xiaoland added a commit to InKCre/impl-ts that referenced this pull request Oct 26, 2026
- 固定已推送的 Hub 合同提交 831e835
- 与分发实现提交分离,合并依赖 InKCre/docs#42
xiaoland added a commit to InKCre/impl-py that referenced this pull request Oct 26, 2026
* feat(capture): 原子保存共享采集图与幂等回执

- 新增受 Peer JWT 保护的 Capture HTTP 分发及原始图文解释
- 通过组合事务提交图、标准二进制存储和材料指纹回执
- 在当前迁移头后追加 capture_receipts,Host SDK 增至 0.3.4
- 验证并发重放、冲突、删除后重放及失败回滚

* fix(capture): 通过共享数据库协议独立提交采集图

- 新增 SECURITY INVOKER 原子提交函数,统一保存图、原图和幂等回执。

- 移除 Python 提交服务与 Capture UoW,保留可选读取 Resolver。

- 保留旧待办摘要,数据库计算图摘要并覆盖并发、冲突和回滚。

* fix(database): 在角色配置阶段授予采集函数权限

- 迁移不假定 authenticated 已存在,修复全新集群初始化。

- 复用现有角色配置对数据库函数统一授权,不修改已发布迁移。

* ref(database): 收敛未发布的 Capture 原生协议

- 合并候选回执 schema 并接纳 swift_bundled 参与身份
- 删除旧提交 RPC 与兼容分支,保留 main 历史迁移
- 随 Python Capture 分发交付 MIT 许可

* feat(local-files): 提供独立 Python 正文读取分发

- 读取本地文件元数据与已收入正文,不依赖原 Peer 在线
- 保留原件失效与上次成功修订语义,仅注册 Resolver

* docs(shared): 对齐本地文件候选合同

- 固定已推送的 Hub 合同提交 831e835
- 与分发实现提交分离,合并依赖 InKCre/docs#42

* ref(extensions): 移除 Capture 专表并开放 Peer 分发协议

- Capture 使用现有图与本机待办完成恢复,不维护共享回执。

- 共享分发标识开放,实际执行能力由宿主边界校验。

* docs(shared): 对齐已合并的独立 Peer 与文件收入合同

* docs(database): 说明开放分发后的迁移回退边界
xiaoland added a commit to InKCre/impl-ts that referenced this pull request Oct 26, 2026
* feat(capture): 添加共享采集内容的 Web 读取分发

- 解释有序原文、原始图片、真实来源和独立附注
- 复用 Core Resolver、存储和内容导航,支持采集者停机后冷读
- 接入独立构建、包契约、Changeset 和隔离预览清单

* docs(capture): 明确读取分发不是 Mac 写入前提

- 引用共享图合同,移除 Python 执行者依赖说明。

* fix(extension): 识别随应用交付的 Swift 分发

- 解释原生参与身份并阻止不受支持的 Registry 版本请求
- 随 Capture 读取产物交付 MIT 许可和发布意图

* feat(local-files): 提供 Web 文件正文读取分发

- 展示已收入正文、原件位置、失效状态与提取范围
- 只注册读取能力,保留可重定位 Module Federation 产物
- 未发布版本仅记录 patch 发布意图

* docs(shared): 对齐本地文件候选合同

- 固定已推送的 Hub 合同提交 831e835
- 与分发实现提交分离,合并依赖 InKCre/docs#42

* ref(extensions): 开放 Peer 分发标识并保留宿主加载边界

- 共享状态和命令允许原生宿主格式,不扩充固定语言白名单。

- 读取 Capture 提交身份,Registry 安装操作仍只处理实际支持的产物。

* fix(extensions): 对齐主线工具链与 Registry 版本选择边界

- 新增分发沿用工作区浏览器类型与公开 UI 依赖。

- 修正开放分发后的安装器类型检查与合同测试门禁。

* docs(shared): 对齐已合并的独立 Peer 与文件收入合同

This branch was successfully deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant