灵渠 Link2Context

local-first context compiler

把收藏链接编译成 agent-ready context。

Link2Context 是一个开源 CLI / Python library，把公开文章、社媒图文和媒体线索整理成 context.json、context.md、本地 store、知识图谱输入和 agent 查询包。

Status Alpha, built for local development and fixture-backed testing.
License MIT licensed, GitHub-first, open for extension.
Boundary No hosted service, no platform bypass, no interaction scraping.
查看源码 运行 Quickstart
link2context 
$ python -m link2context "https://mp.weixin.qq.com/s/..." --out outputs/sample

outputs/sample/
  context.json
  context.md
  manifest.json

quality:
  source: public url
  media: placeholders
  handoff: ready

项目能力

当前重点很窄：保守采集、统一上下文、离线回归、本地查询。它不是下载器，也不是平台自动化工具。

Sources

公开链接输入

支持公开微信公众号文章 URL 和公开小红书笔记 URL 的保守 HTML 解析。

Context

统一输出契约

抽取标题、作者、时间、摘要、正文、图片和视频占位信息，输出稳定 context 文件。

Store

本地知识入口

将 context 导入 SQLite store，再导出 graph、profile 和 agent query package。

Boundary

清晰平台边界

不绕过登录和风控，不采集评论点赞，不提交 Cookie、token 或私有内容。

适配平台

当前把平台状态讲清楚：已支持的社媒链接走保守 HTML 解析；视频和网页来源通过媒体适配与后续输入契约进入管线。

Supported

微信公众号

公开文章 URL 到结构化 context，适合离线 fixture 和批量处理。

Supported

小红书

公开笔记 URL 的保守 HTML 解析，Cookie 仅作为本地请求头使用。

Media path

B站视频

面向视频 ASR、时间轴和引用定位的输入方向，保持本地外部命令适配。

Media path

YouTube / Web

用于网页、视频、图文和 PDF 进入统一 context schema 的后续扩展。

工作流

长期目标是一条可自托管、可二次开发的本地内容编译管线：从链接进入，到上下文、图谱、检索和 agent handoff。

1

Collect

接收文章、社媒链接、视频、图文、PDF 和网页来源。

2

Normalize

清洗正文、媒体、引用、实体、时间、作者和来源。

3

Connect

抽取主题、人物、产品、地点、事件和关系。

4

Retrieve

按主题、问题、时间线和关系查询本地上下文。

5

Act

给 AI agent 提供可信上下文、引用证据和本地兴趣画像。

文档入口

README 保留完整命令和 schema 说明；专题文档用于解释架构、契约、媒体流程和开源发布检查。

README 项目概览、安装命令、核心 CLI 工作流和 schema 说明。 Quickstart 最小离线闭环：context 文件、store query 和 handoff export。 Architecture 模块、数据流、契约和边界。 Export Contracts 稳定文件、可选字段和外部工具校验命令。 Media OCR / ASR fake、Tesseract、Sona/Vibe 和自定义命令模板。 Roadmap 近期里程碑和后续开源方向。

Project stance

Alpha, local-first, GitHub-first.

适合本地自用、开发者二次开发和离线 fixture 回归测试。项目不提供托管账号服务，也不做平台写操作自动化。 

python -m pip install -e ".[dev]"
python -m pytest tests -q
python -m link2context --url-list examples/wechat_urls.txt --out outputs/batch
python -m link2context --verify-batch outputs/batch
python -m link2context.store query data/context-store.sqlite --q "agent"
从收藏到上下文，不经过托管黑箱。 所有输出都留在本地文件和本地数据库里，方便审计、复现和交给 agent 使用。
阅读完整文档