[xiaoland]

目的与范围

定义 inkcre/local-files 的持续收入和跨端读取合同：Mac 等具备本机文件访问能力的分发负责目录监视与提取，其他分发直接读取共享图中的正文。原件留在指定 Peer，位置采用 inkcre-peer-file://<peer-id>/<机器绝对路径>。

• 修改更新当前资料；原件删除保留最后成功正文并标记失效。
• 目录离线、权限错误和提取失败不冒充删除，不清空成功正文。
• 明确六种格式的提取范围、普通 Source Job 和读取分发职责。
• 原生本地停用不被共享状态同步、凭据或授权故障阻塞。

验证

对照 Swift、Python 和 Web 候选实现核对 URI、图关系、来源生命周期与提取范围；git diff --check 通过。本文是共享候选合同，不变更网站源码；未重复构建网站。

风险、回退与交付

合同与三个实现需协调审查，不能将读取分发视为 Mac 收入的前置服务。不引入数据库迁移、原件备份、远程传输或兼容层。回退本 PR 的文档提交即可；不改变已存数据。

依赖关系

• 直接父 PR：https://github.com/InKCre/docs/pull/39（基底 feat/mac-capture-topology）。
• 后续子 PR：无。
• 父 PR 合并后将本分支重排到最新 main，并更新基底、重跑适用检查；不直接合并仍包含父 PR 的分支。

跨仓配套

• Mac 执行分发与原生界面
• Python 读取分发
• Web 读取分发