sweaConnector

将你的个人算法学习仓库连接到 Claude，并烧录为只读 Android 查看器的工具。

Claude 直接读写你的学习仓库——帮你挑选接下来要做的题、调整日程、记录解题笔记。结果会以适配折叠屏的电子书形态应用，随时可以拿出来查看。

   ┌──────────────┐   MCP    ┌──────────────┐  빌드 시 주입  ┌──────────────┐
   │  당신의 학습   │ ───────► │    Claude    │              │  안드로이드    │
   │  저장소        │ ◄─────── │              │              │  뷰어 (APK)   │
   │  (private)    │  기록     └──────────────┘              └──────────────┘
   └──────────────┘                                                ▲
          └─────────────────────────────────────────────────────────┘

这个仓库里没有的东西

题目正文、题号、解题代码都不在这里。 它们只存在于你的 私有仓库中。

许多算法学习平台通过服务条款禁止公开、分享题目和题解。因此 sweaConnector 刻意是一个空容器——只包含工具、规约和通用 CS 概念说明，内容在构建时从你的仓库注入。fixtures/ 中的示例题目全部是虚构的。

结构

开始

git clone https://github.com/rleaderjoon/sweaConnector
cd sweaConnector
npm install
npm test                              # 13개 자체 검증 (MCP 핸드셰이크 포함)

# 1. 내 저장소가 규약에 맞는지 확인
node pipeline/extract.mjs --repo /path/to/my-study-repo --out content.json

# 2. 일정 설정 — 내 학습 저장소 루트에 .sweaconnector.json
echo '{"startDate":"2026-08-15","examDate":"2026-09-19"}' > /path/to/my-study-repo/.sweaconnector.json

# 3. Claude 에 붙이기
claude mcp add swea -- node ./mcp/index.mjs --repo /path/to/my-study-repo

# 4. 내 APK 굽기 — 콘텐츠 추출부터 서명까지 한 번에
bash pipeline/build-apk.sh /path/to/my-study-repo release

APK 会输出到 app/reader/build/outputs/apk/release/。想交给 GitHub Actions 的话，请手动运行 .github/workflows/apk.yml（因为是公开仓库，所以会烧录演示内容）。

安装到手机

1. 将 APK 上传到自己的私有仓库的 Release — gh release create v0.1.0 <apk> -R <owner>/<repo>

2. 在手机浏览器中打开该 Release 下载 APK（必须处于 GitHub 登录状态）

3. 在浏览器中允许一次安装“未知来源应用”

不要把自己的 APK 上传到公开仓库——APK 里面含有题目和题解。

屏幕

折叠再展开时会保持阅读位置（通过 configChanges 不会重新创建 Activity）。

MCP 工具

schedule_status 不是帮你阅读计划的工具，而是在计划已经偏离的前提下进行修正的工具。请先看 slackDays——它是距离考试日期剩余的天数；如果为负数，就需要加快节奏。

要求

• Node 20+

• JDK 17+ · Android SDK (platform 35) — 仅在本地构建时需要。使用 Actions 构建则不需要。

设计原则

• 只读查看器。 不在应用中编辑。写入通过 Claude(MCP) 进入仓库。

• 无运行时网络。 内容在构建时烧录进 APK。点击时无需解析任何内容，立即显示。

• 折叠屏优先。 折叠时单页，展开时显示摊开的两页。横屏、竖屏均支持。

• 示意图用矢量。 算法示意图是手写 SVG → VectorDrawable。AI 生成的图片貌似合理但实际是错误的。

许可证

MIT（仅限工具和概念说明）。你注入的内容的权利与条款合规由你自行负责。