Skip to content

docs(twitter): 定义归档接入契约并移除 JWT 寿命上限 - #38

Merged
xiaoland merged 5 commits into
mainfrom
feat/twitter-x-monkey
Oct 20, 2026
Merged

xiaoland merged 5 commits into
mainfrom
feat/twitter-x-monkey

Conversation

@xiaoland

@xiaoland xiaoland commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

定义 Twitter Extension 跨 Python/Web Distribution 的共同信息、身份/合并、关系、按需媒体与 x-monkey 兼容接入合同,配套 impl-py #145、impl-ts #140。

  • Twitter拥有共同模型与合并语义,上游基线只固定x-monkey来源Adapter的DTO;当前只保留Provider映射后的事实,不宣称完整原始响应已保存。
  • Resolver选择内容,HTTP Storage拥有网络读取;媒体仅保存元数据并按需展开,无专属CDN名单。
  • 首次连接从Core自托管账户页开始,浏览器用已有部署Secret本地签短期普通JWT,经同源Bearer建立归档Cookie,并检查实际会话。无需Web/MF;Web可提供普通账户页链接。页面不发送或持久化Secret,但用户必须信任输入Secret的部署页面。

按后续评论撤回browser-form公共协议和Host/Auth handoff,不为低频连接扩展Peer transport。保留JWT签发默认可配、归档7天/半寿命续签和完整Peer权限;持久JSON、Resolver ID、Block ID与引用兼容,两种Distribution独立版本。

当前共享提交ff82097先推送,再由两个Spoke分别更新引用。Website checks通过,10页28处链接/锚点/图片及producer两scope构建通过。

文档预览。Hub第一方扩展文档分区与持续模式属于独立议题,本PR不进行该信息架构迁移。未合并或生产发布。

- 统一 User/Post/Media 原生信息、受管关系、旧记录过渡与媒体按需读取的跨分发语义
- 记录 x-monkey 的 JWT Cookie 连接、默认七天寿命及自动续签边界
- 将 JWT 签发默认值与协议准入分离,并更新共享契约导航
- 原生媒体不预建可被独立索引的普通内容块
- 保留通用媒体物化合同及按需读取安全边界
- 分别选择 Python 与 Web 分发版本
- 明确当前 Python 分发所需的 Core Host 兼容范围
- 将共同信息模型与 x-monkey 固定协议分离
- 将媒体网络读取交还通用 Storage
- 定义 Host/Auth 的浏览器表单交接合同
- 移除通用 browser-form 凭据交接合同\n- 明确本地短期 JWT 签名、同源 Cookie 建立及可信部署前提
@xiaoland
xiaoland merged commit 7449135 into main Oct 20, 2026
2 checks passed
@xiaoland
xiaoland deleted the feat/twitter-x-monkey branch October 20, 2026 10:50

This branch was previously deployed

1 inactive deployment
preview — ff820977 Deployed Oct 20, 2026 by xiaoland via Retire exact pull-request preview #28
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