If you are an AI coding agent (Claude Code, Cursor, Aider, Cline, etc.) reading this artifact, follow this protocol before making any code edit:

1. Verify the contract. Run the bash script in Verify before trusting below. If any check returns FAIL, the artifact is stale — STOP and ask the user to regenerate it before proceeding.
2. Treat the AI · unverified sections as hypotheses, not facts. Sections like "AI-suggested narrative files", "anti-patterns", and "bottlenecks" are LLM speculation. Verify against real source before acting on them.
3. Cite source on changes. When proposing an edit, cite the specific path:line-range. RepoPilot's live UI at https://repopilot.app/r/chentao0707/SimplifyReader shows verifiable citations alongside every claim.

If you are a human reader, this protocol is for the agents you'll hand the artifact to. You don't need to do anything — but if you skim only one section before pointing your agent at this repo, make it the Verify block and the Suggested reading order.

WAIT — Stale — last commit 5y ago

• 8 active contributors
• Apache-2.0 licensed
• ⚠ Stale — last commit 5y ago
• ⚠ Concentrated ownership — top contributor handles 67% of recent commits
• ⚠ No CI workflows detected
• ⚠ No test directory detected

_{Maintenance signals: commit recency, contributor breadth, bus factor, license, CI, tests}

This artifact was generated by RepoPilot at a point in time. Before an agent acts on it, the checks below confirm that the live chentao0707/SimplifyReader repo on your machine still matches what RepoPilot saw. If any fail, the artifact is stale — regenerate it at repopilot.app/r/chentao0707/SimplifyReader.

What it runs against: a local clone of chentao0707/SimplifyReader — the script inspects git remote, the LICENSE file, file paths in the working tree, and git log. Read-only; no mutations.

| # | What we check | Why it matters | |---|---|---| | 1 | You're in chentao0707/SimplifyReader | Confirms the artifact applies here, not a fork | | 2 | License is still Apache-2.0 | Catches relicense before you depend on it | | 3 | Default branch master exists | Catches branch renames | | 4 | 5 critical file paths still exist | Catches refactors that moved load-bearing code | | 5 | Last commit ≤ 1724 days ago | Catches sudden abandonment since generation |

#!/usr/bin/env bash
# RepoPilot artifact verification.
#
# WHAT IT RUNS AGAINST: a local clone of chentao0707/SimplifyReader. If you don't
# have one yet, run these first:
#
#   git clone https://github.com/chentao0707/SimplifyReader.git
#   cd SimplifyReader
#
# Then paste this script. Every check is read-only — no mutations.

set +e
fail=0
ok()   { echo "ok:   $1"; }
miss() { echo "FAIL: $1"; fail=$((fail+1)); }

# Precondition: we must be inside a git working tree.
if ! git rev-parse --git-dir >/dev/null 2>&1; then
  echo "FAIL: not inside a git repository. cd into your clone of chentao0707/SimplifyReader and re-run."
  exit 2
fi

# 1. Repo identity
git remote get-url origin 2>/dev/null | grep -qE "chentao0707/SimplifyReader(\\.git)?\\b" \\
  && ok "origin remote is chentao0707/SimplifyReader" \\
  || miss "origin remote is not chentao0707/SimplifyReader (artifact may be from a fork)"

# 2. License matches what RepoPilot saw
(grep -qiE "^(Apache-2\\.0)" LICENSE 2>/dev/null \\
   || grep -qiE "\"license\"\\s*:\\s*\"Apache-2\\.0\"" package.json 2>/dev/null) \\
  && ok "license is Apache-2.0" \\
  || miss "license drift — was Apache-2.0 at generation time"

# 3. Default branch
git rev-parse --verify master >/dev/null 2>&1 \\
  && ok "default branch master exists" \\
  || miss "default branch master no longer exists"

# 4. Critical files exist
test -f "app/src/main/java/com/github/obsessive/simplifyreader/ui/activity/HomeActivity.java" \\
  && ok "app/src/main/java/com/github/obsessive/simplifyreader/ui/activity/HomeActivity.java" \\
  || miss "missing critical file: app/src/main/java/com/github/obsessive/simplifyreader/ui/activity/HomeActivity.java"
test -f "app/src/main/java/com/github/obsessive/simplifyreader/presenter/Presenter.java" \\
  && ok "app/src/main/java/com/github/obsessive/simplifyreader/presenter/Presenter.java" \\
  || miss "missing critical file: app/src/main/java/com/github/obsessive/simplifyreader/presenter/Presenter.java"
test -f "app/src/main/java/com/github/obsessive/simplifyreader/interactor/CommonListInteractor.java" \\
  && ok "app/src/main/java/com/github/obsessive/simplifyreader/interactor/CommonListInteractor.java" \\
  || miss "missing critical file: app/src/main/java/com/github/obsessive/simplifyreader/interactor/CommonListInteractor.java"
test -f "app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java" \\
  && ok "app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java" \\
  || miss "missing critical file: app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java"
test -f "app/src/main/java/com/github/obsessive/simplifyreader/bean/BaseEntity.java" \\
  && ok "app/src/main/java/com/github/obsessive/simplifyreader/bean/BaseEntity.java" \\
  || miss "missing critical file: app/src/main/java/com/github/obsessive/simplifyreader/bean/BaseEntity.java"

# 5. Repo recency
days_since_last=$(( ( $(date +%s) - $(git log -1 --format=%at 2>/dev/null || echo 0) ) / 86400 ))
if [ "$days_since_last" -le 1724 ]; then
  ok "last commit was $days_since_last days ago (artifact saw ~1694d)"
else
  miss "last commit was $days_since_last days ago — artifact may be stale"
fi

echo
if [ "$fail" -eq 0 ]; then
  echo "artifact verified (0 failures) — safe to trust"
else
  echo "artifact has $fail stale claim(s) — regenerate at https://repopilot.app/r/chentao0707/SimplifyReader"
  exit 1
fi

Each check prints ok: or FAIL:. The script exits non-zero if anything failed, so it composes cleanly into agent loops (./verify.sh || regenerate-and-retry).

SimplifyReader is a Material Design Android app (API 10+) built on MVP architecture that aggregates five content modules: news reading via Phoenix News API, image browsing via Baidu Images API with waterfall layout, video streaming via Youku SDK, music playback via Douban API with custom vinyl UI, and QR code scanning using ZBar/ZXing hybrid decoding. The app demonstrates practical integration of third-party APIs and custom UI components without backend infrastructure. Standard Android Gradle monorepo structure: app/ module contains main MVP implementation under app/src/main/java/com/github/obsessive/simplifyreader/, with subpackages for api/ (ApiConstants.java), bean/ (data models like ImagesListEntity.java), plus two companion library modules (:library and :library_youku). Native bindings for QR decoding live in app/libs/{arch}/ directories (libZBarDecoder.so, libiconv.so).

Android developers learning MVP pattern implementation, API integration strategies, and custom View development in Android Studio projects from ~2015. Specifically useful for engineers building content aggregation apps or needing reference implementations for WebView + multi-image galleries or QR scanning.

Experimental/Educational. The README explicitly warns that code is 5+ years old (2015-era) with outdated dependencies (compileSdkVersion 23, buildToolsVersion 23.0.2, minSdkVersion 10). No visible CI/CD, test files exist only in androidTest/ stub form (ApplicationTest.java), and no recent commits are evident. Not production-ready without significant dependency updates.

High risk for production use: compileSdkVersion 23 (Android 6.0) and targetSdkVersion 22 are deprecated; Youku SDK is Eclipse-era code manually migrated to Studio; QR scanning uses legacy ZBar .so files for multiple architectures (armeabi, mips, mips64) that are no longer maintained. Single maintainer (chentao0707), no active issue tracking visible, and third-party APIs (Phoenix News, Baidu Images, Youku, Douban) are undocumented/potentially rate-limited.

No active development. README explicitly states 'project is from several years ago' and 'if it doesn't run normally, check logs and solve it yourself.' The codebase is frozen at a reference point; no visible PRs, issues, or recent commits indicate ongoing work.

Clone and open in Android Studio 3.0+: git clone https://github.com/chentao0707/SimplifyReader.git && cd SimplifyReader && ./gradlew assembleDebug. Requires JDK 8+ (for compileSdkVersion 23) and Android SDK 23+ installed. Note: Build will likely fail due to outdated dependencies—follow Gradle error logs to resolve.

Daily commands: After cloning and resolving build errors: ./gradlew installDebug or use Android Studio's Run button (connected device/emulator required). No dev server—this is a client-only app that hits external APIs.

• app/src/main/java/com/github/obsessive/simplifyreader/ui/activity/HomeActivity.java — Main entry point for the app's five-module navigation (news, images, videos, music, QR code); orchestrates the tab-based UI structure
• app/src/main/java/com/github/obsessive/simplifyreader/presenter/Presenter.java — Base presenter interface defining the MVP contract that all module presenters must implement
• app/src/main/java/com/github/obsessive/simplifyreader/interactor/CommonListInteractor.java — Core data-fetching abstraction used across all list-based modules; defines the interactor pattern for API calls and caching
• app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java — Centralized API endpoint configuration; stores all third-party service URLs (news, images, videos, music)
• app/src/main/java/com/github/obsessive/simplifyreader/bean/BaseEntity.java — Root data model for all API responses; ensures consistent serialization across news, images, videos, and music payloads
• app/build.gradle — Build configuration defining SDK version (23), dependencies, and native library includes (ZBar decoder for QR scanning)
• app/src/main/AndroidManifest.xml — Declares all activities, services (MusicPlayService), permissions, and broadcast receivers (PhoneCallReceiver) for the five modules

Add a New Content Module (e.g., Podcasts)

1. Create a new entity class in app/src/main/java/com/github/obsessive/simplifyreader/bean/ extending BaseEntity to model the API response structure (app/src/main/java/com/github/obsessive/simplifyreader/bean/PodcastsListEntity.java)
2. Add the API endpoint constant to ApiConstants.java (app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java)
3. Create an interactor interface in app/src/main/java/com/github/obsessive/simplifyreader/interactor/ and implement it in impl/ folder with API call logic (app/src/main/java/com/github/obsessive/simplifyreader/interactor/impl/PodcastsListInteractorImpl.java)
4. Create a presenter interface and implementation in app/src/main/java/com/github/obsessive/simplifyreader/presenter/impl/PodcastsListPresenterImpl.java extending the interactor (app/src/main/java/com/github/obsessive/simplifyreader/presenter/impl/PodcastsListPresenterImpl.java)
5. Add a new Activity/Fragment in app/src/main/java/com/github/obsessive/simplifyreader/ui/activity/ that implements the presenter's view interface (app/src/main/java/com/github/obsessive/simplifyreader/ui/activity/PodcastsActivity.java)
6. Register the new Activity in AndroidManifest.xml and add a tab for it in HomeActivity.java (app/src/main/AndroidManifest.xml)

Add an API Data Source

1. Add the API base URL and endpoint path to ApiConstants.java (app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java)
2. Create response entity classes in app/src/main/java/com/github/obsessive/simplifyreader/bean/ (e.g., ResponseXxxListEntity.java) matching the JSON structure (app/src/main/java/com/github/obsessive/simplifyreader/bean/ResponseXxxListEntity.java)
3. Implement a new interactor in app/src/main/java/com/github/obsessive/simplifyreader/interactor/impl/ that calls the API via HTTP client and transforms the response (app/src/main/java/com/github/obsessive/simplifyreader/interactor/impl/XxxInteractorImpl.java)
4. Wire the interactor into the relevant presenter's implementation (app/src/main/java/com/github/obsessive/simplifyreader/presenter/impl/XxxPresenterImpl.java)

Handle Pagination & Load More

1. Ensure your entity implements CommonListInteractor interface in the interactor layer (app/src/main/java/com/github/obsessive/simplifyreader/interactor/CommonListInteractor.java)
2. In the presenter implementation, track the current page number and call interactor.loadMore(pageNumber) on scroll (app/src/main/java/com/github/obsessive/simplifyreader/presenter/impl/XxxListPresenterImpl.java)
3. In the Activity/Fragment, use BaseSingleLoadedListener callback to receive paginated results and append to RecyclerView/ListView (app/src/main/java/com/github/obsessive/simplifyreader/listeners/BaseSingleLoadedListener.java)

Integrate a New Media Service (Music/Video Player)

1. Create a new player wrapper class extending MusicPlayer in app/src/main/java/com/github/obsessive/simplifyreader/player/

Youku SDK: Manually ported Eclipse library to Android Studio; may have missing gradle metadata or incompatible bytecode. ZBar: Multi-arch .so files (armeabi, mips, mips64, x86) target obsolete Android NDK ABIs; modern builds use only armeabi-v7a and arm64-v8a. API keys: Phoenix News, Baidu, Youku, Douban endpoints are hardcoded in ApiConstants.java—likely rate-limited or revoked (no error handling visible). Umeng: latest.integration dependency resolution may fail; substitute with pinned version. minSdkVersion 10: Requires compatibility shims (NineOldAndroids) but targets compileSdkVersion 23—deprecated patterns throughout.

• MVP (Model-View-Presenter) Architecture — SimplifyReader's primary design pattern; separates business logic (Presenter) from UI (View) and data (Model), making it testable and modular across five content modules.
• Material Design — Core UI framework (declared in README as 'based on Google Material Design'); defines color palettes, transitions, and component specs (CardView for videos, floating action buttons, etc.).
• JNI (Java Native Interface) / NDK Bindings — QR scanning uses ZBar .so native libraries compiled for multiple ARM ABIs; understanding architecture-specific binaries and symbol resolution is critical for debugging crashes.
• Waterfall/Masonry Layout — Image gallery uses waterfall flow for responsive grid layout; commonly seen in Pinterest-like apps and requires custom LayoutManager or RecyclerView adapter logic.
• WebView & JavaScript Bridge — News detail pages load HTML via WebView with pinch-zoom gesture handling; requires careful handling of JavaScript context and URL interception for custom behavior.
• Third-Party API Integration (REST/JSON) — SimplifyReader aggregates five undocumented public APIs (Phoenix News, Baidu Images, Youku, Douban, QR endpoints); highlights API discovery, reverse-engineering, and rate-limit handling challenges.
• Gesture Detection & Custom View Rendering — Multi-image news galleries and photo viewer use pinch-zoom and swipe gestures; SimplifyReader's custom View logic for image scaling and transition effects demonstrates advanced touch event handling.

• android-architecture/samples — Google's official MVP/MVVM architecture samples for Android—comparison reference for MVP patterns used here (2015 vs. 2024 best practices).
• square/okhttp — HTTP client for Android APIs—SimplifyReader likely uses OkHttp under the hood; understanding request/response patterns helps debug API integration.
• google/zxing — Official ZXing barcode library actively maintained—SimplifyReader uses it alongside ZBar for QR decoding; better alternative for modern apps.
• JakeWharton/ButterKnife — View binding framework used throughout SimplifyReader (declared in open_source.html); referenced as key dependency for reducing boilerplate.
• JakeWharton/NineOldAndroids — Backwards-compatible animation library for pre-API11 devices required by SimplifyReader's minSdkVersion 10; legacy workaround now handled by AndroidX.

To work on one of these in Claude Code or Cursor, paste: Implement the "<title>" PR idea from CLAUDE.md, working through the checklist as the task list.

Upgrade deprecated Android build configuration and dependencies

The project uses outdated compileSdkVersion 23 and buildToolsVersion '23.0.2' (from 2015). This causes compatibility issues with modern Android devices and Play Store requirements (minSdkVersion should be ≥21). The README explicitly warns about third-party library failures. Upgrading will fix crashes and enable the app to run on modern Android versions.

• [ ] Update build.gradle: change compileSdkVersion from 23 to 34, buildToolsVersion to '34.0.0'
• [ ] Update targetSdkVersion from 22 to 34, minSdkVersion from 10 to 21
• [ ] Replace deprecated 'compile' declarations with 'implementation' in dependencies section
• [ ] Test and fix any API-level breaking changes in SimplifyReaderApplication.java and manifest permissions
• [ ] Update umeng and zxing library versions to latest stable releases

Add unit tests for MVP interactor layer (app/src/main/java/com/github/obsessive/simplifyreader/interactor/)

The interactor classes (HomeInteractor.java, CommonListInteractor.java, MusicsInteractor.java, etc.) handle business logic and API calls but have no corresponding test coverage in app/src/androidTest/. Adding unit tests will catch regressions when refactoring the MVP implementation and improve code reliability.

• [ ] Create app/src/test/java/com/github/obsessive/simplifyreader/interactor/ directory
• [ ] Add CommonListInteractorTest.java to test API response parsing and error handling
• [ ] Add HomeInteractorTest.java to test news feed data transformation
• [ ] Add MusicsInteractorTest.java to test music channel and playlist logic
• [ ] Use Mockito to mock API responses and verify correct data flow to presenters

Refactor and document MVP architecture with package reorganization

The README acknowledges the MVP implementation 'may not be very standard' but the actual presenter and view interfaces are missing from the file listing. This makes it hard for contributors to understand the architecture. Reorganizing into clear MVP layers (model/bean, view/ui, presenter, interactor) with corresponding interface definitions will improve maintainability.

• [ ] Create app/src/main/java/com/github/obsessive/simplifyreader/presenter/ package with interfaces (INewsPresenter, IMusicPresenter, etc.)
• [ ] Create app/src/main/java/com/github/obsessive/simplifyreader/view/ package and move Fragment/Activity view contracts there
• [ ] Create app/src/main/java/com/github/obsessive/simplifyreader/model/ package and consolidate bean classes with repository pattern
• [ ] Update README.md with architecture diagram showing relationships between view → presenter → interactor → model layers
• [ ] Add javadoc comments to key interfaces explaining the MVP flow

• Update build.gradle to compileSdkVersion 33+ and replace deprecated Android Support libs with AndroidX (no androidx dependencies visible yet); verify minSdkVersion can drop to 21+.
• Add unit tests for bean/ data models (currently empty androidTest/) and create Espresso tests for MVP Presenter interactions in news/images/qrcode modules.
• Document and refactor ApiConstants.java: confirm which APIs still work, add API key management via BuildConfig secrets, and add error handling for rate-limiting/expired endpoints.

• High · Outdated Compile SDK Version — app/build.gradle - compileSdkVersion 23. The application is compiled against Android SDK 23 (Android 6.0), which is significantly outdated (released in 2015). This misses security patches, privacy features, and modern security enhancements available in current Android versions. Fix: Update compileSdkVersion to at least 33 or higher. Current recommendation is API level 34+. Use: compileSdkVersion 34
• High · Low Target SDK Version — app/build.gradle - targetSdkVersion 22. targetSdkVersion is set to 22 (Android 5.1), which is extremely outdated. Apps targeting old SDK versions miss critical security features like runtime permissions, scoped storage, and other privacy protections introduced in later Android versions. Fix: Update targetSdkVersion to match or exceed compileSdkVersion (34+). Use: targetSdkVersion 34
• High · Low Minimum SDK Version — app/build.gradle - minSdkVersion 10. minSdkVersion is set to 10 (Android 2.3.3, released 2011). Supporting such ancient versions introduces unnecessary security risks and makes it impossible to use modern security APIs. Nearly 0% of active devices run these versions. Fix: Update minSdkVersion to at least 24 (Android 7.0). Modern standard is 26+. Use: minSdkVersion 26
• High · Disabled ProGuard/Code Obfuscation in Release Build — app/build.gradle - minifyEnabled false. Release builds have minifyEnabled set to false, meaning code is not obfuscated. This makes reverse engineering trivial and exposes sensitive logic, hardcoded strings, and API endpoints. Fix: Enable ProGuard minification: Set minifyEnabled true. Apply proper ProGuard rules in proguard-rules.pro to protect sensitive code.
• High · Outdated and Unmaintained Dependencies — app/build.gradle - Umeng dependencies, app/libs/. The project uses Umeng analytics and feedback libraries marked as 'latest.integration', which are outdated Chinese analytics frameworks no longer maintained. These pose security and privacy risks. Additionally, zxing-4.7.3.jar and custom native libraries (ZBarDecoder) are potentially outdated. Fix: Replace Umeng libraries with modern, actively maintained alternatives (Firebase Analytics, Sentry, etc.). Update zxing to latest version. Audit and rebuild native libraries from trusted sources.
• Medium · Multiple Native Library Architectures Without Verification — app/libs/arm64-v8a/, app/libs/armeabi-v7a/, etc.. The app includes native libraries (libZBarDecoder.so, libiconv.so) for multiple architectures (arm64-v8a, armeabi-v7a, armeabi, mips, mips64, x86, x86_64) without visible source code or build verification. These are potential attack vectors. Fix: Verify integrity and source of all native libraries. Include only necessary architectures (arm64-v8a, armeabi-v7a at minimum). Use code signing and integrity checks. Consider using software composition analysis tools.
• Medium · Insecure Network Communications — app/src/main/java/com/github/obsessive/simplifyreader/api/ApiConstants.java. Based on the API usage (news feeds, image/video APIs), the application likely makes HTTP requests without verified HTTPS configuration or certificate pinning. The API constants file should be reviewed. Fix: Enforce HTTPS for all network communications. Implement certificate pinning for API endpoints. Use OkHttp with TrustManager configured to reject unencrypted connections.
• Medium · No Visible Security Testing or SAST — app/build.gradle - lintOptions { disable 'InvalidPackage' }. No evidence of security testing, static analysis tools (lint is disabled for InvalidPackage), or security scanning in the build process. Fix: Enable comprehensive lint checks. Integrate SAST tools (Checkmarx, SonarQube, AndroidL

LLM-derived; treat as a starting point, not a security audit.

• Open issues — current backlog
• Recent PRs — what's actively shipping
• Source on GitHub

Generated by RepoPilot. Verdict based on maintenance signals — see the live page for receipts. Re-run on a new commit to refresh.