chore: update AltStore source for v0.1.11

- 区分按钮填充与图标颜色，统一书架、书源、搜索和阅读设置的选中态
- 调整编辑器语法高亮、键盘工具栏及统计卡片的浅深色显示
- 适配 RSS 正文和登录网页背景，保留书源自定义样式和页面状态
- 补充外观切换、页面对比度和管理页面的回归测试

.gitignore

@@ -4,6 +4,7 @@ DerivedData/
 *.xcuserstate
 xcuserdata/
 reference/
+/GITHUB_UPLOAD.local.md
 
 artifacts/
 *.xcresult/

App/Compatibility.swift

@@ -207,9 +207,88 @@ struct ReadingPhotoPickerController: UIViewControllerRepresentable {
     }
 }
 
+private struct ReadingTXTFileImporterModifier: ViewModifier {
+    @Binding var isPresented: Bool
+    let onFiles: ([LocalBookImportFile]) -> Void
+    let onError: (Error) -> Void
+    @State private var pickedFiles: [LocalBookImportFile] = []
+    @State private var pickerHasDismissed = false
+
+    func body(content: Content) -> some View {
+        content.sheet(isPresented: $isPresented, onDismiss: {
+            pickerHasDismissed = true
+            deliverFilesWhenReady()
+        }) {
+            ReadingTXTFilePicker { files in
+                pickedFiles = files
+                isPresented = false
+                deliverFilesWhenReady()
+            } onCancel: {
+                pickedFiles = []
+                isPresented = false
+            }
+            .onAppear {
+                pickedFiles = []
+                pickerHasDismissed = false
+            }
+        }
+    }
+
+    private func deliverFilesWhenReady() {
+        // Providers may return their copies before or after dismissing Files.
+        guard pickerHasDismissed, !pickedFiles.isEmpty else { return }
+        let files = pickedFiles
+        pickedFiles = []
+        guard files.allSatisfy({ $0.url.pathExtension.lowercased() == "txt" && !$0.url.hasDirectoryPath }) else {
+            onError(LocalBookError.unsupportedFormat)
+            return
+        }
+        onFiles(files)
+    }
+}
+
+private struct ReadingTXTFilePicker: UIViewControllerRepresentable {
+    let onPick: @MainActor ([LocalBookImportFile]) -> Void
+    let onCancel: @MainActor () -> Void
+
+    func makeCoordinator() -> Coordinator { Coordinator(parent: self) }
+
+    func makeUIViewController(context: Context) -> UIDocumentPickerViewController {
+        // Plain text includes UTF-8/UTF-16 TXT, while .text and .data also allow JSON.
+        let picker = UIDocumentPickerViewController(forOpeningContentTypes: [.plainText], asCopy: true)
+        picker.allowsMultipleSelection = true
+        picker.shouldShowFileExtensions = true
+        picker.delegate = context.coordinator
+        return picker
+    }
+
+    func updateUIViewController(_ controller: UIDocumentPickerViewController, context: Context) {}
+
+    @MainActor
+    final class Coordinator: NSObject, UIDocumentPickerDelegate {
+        let parent: ReadingTXTFilePicker
+
+        init(parent: ReadingTXTFilePicker) { self.parent = parent }
+
+        func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) { parent.onCancel() }
+
+        func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
+            parent.onPick(urls.map { LocalBookImportFile(url: $0) })
+        }
+    }
+}
+
 enum ReadingSheetDetent { case medium, large }
 
 extension View {
+    func readingTXTFileImporter(
+        isPresented: Binding<Bool>,
+        onFiles: @escaping ([LocalBookImportFile]) -> Void,
+        onError: @escaping (Error) -> Void
+    ) -> some View {
+        modifier(ReadingTXTFileImporterModifier(isPresented: isPresented, onFiles: onFiles, onError: onError))
+    }
+
     func readingPhotoPicker(
         isPresented: Binding<Bool>,
         onData: @escaping (Data) -> Void,
@@ -261,6 +340,22 @@ extension View {
         }
     }
 
+    @ViewBuilder
+    func readingNavigationBarBackground() -> some View {
+        if #available(iOS 16.0, *), !ReadingCompatibility.usesLegacyUI {
+            toolbarBackground(ReadingTheme.canvas, for: .navigationBar)
+                .toolbarBackground(.visible, for: .navigationBar)
+        } else {
+            background(ReadingUIKitConfiguration { controller in
+                let appearance = UINavigationBarAppearance()
+                appearance.configureWithOpaqueBackground()
+                appearance.backgroundColor = UIColor(ReadingTheme.canvas)
+                controller.navigationController?.navigationBar.standardAppearance = appearance
+                controller.navigationController?.navigationBar.scrollEdgeAppearance = appearance
+            })
+        }
+    }
+
     @ViewBuilder
     func readingTabBarBackground() -> some View {
         if #available(iOS 16.0, *), !ReadingCompatibility.usesLegacyUI {

App/DesignSystem.swift

@@ -77,6 +77,29 @@ private struct ReadingUnavailableLabelStyle: LabelStyle {
 }
 
 extension View {
+    /// Keep filled controls dark in both appearances, independently of icon tint.
+    func readingProminentButtonStyle() -> some View {
+        buttonStyle(.borderedProminent)
+            .tint(ReadingTheme.accentFill)
+            .foregroundStyle(ReadingTheme.onAccent)
+    }
+
+    func readingSecondaryButtonStyle() -> some View {
+        buttonStyle(.bordered)
+            .tint(ReadingTheme.accentFill)
+            .foregroundStyle(ReadingTheme.accent)
+    }
+
+    @ViewBuilder
+    func readingChoiceButtonStyle(isSelected: Bool) -> some View {
+        if isSelected {
+            readingProminentButtonStyle()
+                .accessibilityAddTraits(.isSelected)
+        } else {
+            readingSecondaryButtonStyle()
+        }
+    }
+
     func readingSearchable(text: Binding<String>, isPresented: Binding<Bool>, prompt: String) -> some View {
         modifier(ReadingSearchModifier(text: text, isPresented: isPresented, prompt: prompt))
     }
@@ -144,7 +167,11 @@ private struct ReadingSearchModifier: ViewModifier {
 }
 
 enum ReadingTheme {
-    static let accent = adaptive(0x171717, dark: 0xF2F2F2)
+    static let accent = adaptive(0x171717, dark: 0xDADAE0)
+    static let accentFill = adaptive(0x171717, dark: 0x414148)
+    static let emphasisSurface = adaptive(0x171717, dark: 0x29292E)
+    static let selectionBorder = adaptive(0x171717, dark: 0x777780)
+    static let toggleTint = Color(uiColor: .systemGreen)
     static let accentSoft = adaptive(0xEEEEEF, dark: 0x29292C)
     static let coral = Color(red: 0.76, green: 0.48, blue: 0.27)
     static let paper = Color(red: 0.965, green: 0.945, blue: 0.895)
@@ -153,7 +180,7 @@ enum ReadingTheme {
     static let groupedCanvas = adaptive(0xF3F3F4, dark: 0x1C1C1F)
     static let surface = adaptive(0xFFFFFF, dark: 0x232326)
     static let separator = adaptive(0xE6E6E8, dark: 0x363639)
-    static let onAccent = adaptive(0xFFFFFF, dark: 0x171717)
+    static let onAccent = Color.white
 
     private static func adaptive(_ light: UInt32, dark: UInt32) -> Color {
         Color(uiColor: UIColor { traits in

App/Features/Activity/FileManagementView.swift

@@ -26,9 +26,9 @@ private final class FileManagementModel: ObservableObject {
         await reload(library)
     }
 
-    func importFiles(_ urls: [URL], library: BookLibraryModel) async {
+    func importFiles(_ files: [LocalBookImportFile], library: BookLibraryModel) async {
         await run(library) {
-            await library.importLocalFiles(urls)
+            await library.importPickedLocalFiles(files)
             errorMessage = library.errorMessage
             library.clearError()
         }
@@ -136,6 +136,7 @@ struct FileManagementView: View {
                             }
                         }
                     } label: { Image(systemName: "ellipsis.circle") }
+                    .accessibilityLabel("更多")
                 }
             }
         }
@@ -162,11 +163,10 @@ struct FileManagementView: View {
 
     private var importAndRenameView: some View {
         fileList
-        .fileImporter(isPresented: $importsFile, allowedContentTypes: [.text, .plainText, .data], allowsMultipleSelection: true) { result in
-            switch result {
-            case .success(let urls): Task { await model.importFiles(urls, library: library) }
-            case .failure(let error): model.errorMessage = error.localizedDescription
-            }
+        .readingTXTFileImporter(isPresented: $importsFile) { files in
+            Task { await model.importFiles(files, library: library) }
+        } onError: { error in
+            model.errorMessage = error.localizedDescription
         }
         .alert("重命名文件", isPresented: Binding(get: { renameURL != nil }, set: { if !$0 { renameURL = nil } }), presenting: renameURL) { url in
             TextField("文件名", text: $newName)

App/Features/Activity/ReadingStatisticsView.swift

@@ -47,7 +47,9 @@ struct ReadingStatisticsView: View {
         }
         .frame(maxWidth: .infinity, alignment: .leading)
         .padding(24)
-        .background(ReadingTheme.accent, in: RoundedRectangle(cornerRadius: 20))
+        .background(ReadingTheme.emphasisSurface, in: RoundedRectangle(cornerRadius: 20))
+        .accessibilityElement(children: .contain)
+        .accessibilityIdentifier("statistics.todayCard")
     }
 
     private var overviewGrid: some View {

App/Features/Books/BookDetailView.swift

@@ -194,7 +194,7 @@ struct BookDetailView: View {
                 .font(.body.weight(.medium))
                 .frame(maxWidth: .infinity, minHeight: 28)
         }
-        .buttonStyle(.borderedProminent)
+        .readingProminentButtonStyle()
         .disabled(model.chapters.isEmpty)
         Button {
             if library.contains(model.book) {
@@ -210,7 +210,7 @@ struct BookDetailView: View {
             .font(.subheadline)
             .frame(maxWidth: dynamicTypeSize.isAccessibilitySize ? .infinity : nil, minHeight: 28)
         }
-        .buttonStyle(.bordered)
+        .readingSecondaryButtonStyle()
     }
 
     @ViewBuilder

App/Features/Books/BookLibraryModel.swift

@@ -4,6 +4,20 @@ import SwiftUI
 import LegadoCore
 #endif
 
+final class LocalBookImportFile: @unchecked Sendable {
+    let url: URL
+    private let hasSecurityScope: Bool
+
+    init(url: URL) {
+        self.url = url
+        hasSecurityScope = url.startAccessingSecurityScopedResource()
+    }
+
+    deinit {
+        if hasSecurityScope { url.stopAccessingSecurityScopedResource() }
+    }
+}
+
 enum AppBookChapterRepository {
     static func live() -> any BookChapterRepository {
         let base = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask)[0]
@@ -318,10 +332,15 @@ final class BookLibraryModel: ObservableObject {
     }
 
     func importLocalFiles(_ urls: [URL]) async {
+        await importPickedLocalFiles(urls.map { LocalBookImportFile(url: $0) })
+    }
+
+    func importPickedLocalFiles(_ files: [LocalBookImportFile]) async {
+        // Keep the picker grants alive through the review and asynchronous copy.
+        defer { withExtendedLifetime(files) {} }
         var failures: [String] = []
-        for url in urls {
-            let granted = url.startAccessingSecurityScopedResource()
-            defer { if granted { url.stopAccessingSecurityScopedResource() } }
+        for file in files {
+            let url = file.url
             do {
                 let stored = try await localFiles.importFile(from: url)
                 do {

App/Features/Explore/ExploreView.swift

@@ -155,7 +155,7 @@ struct ExploreView: View {
                             Text("添加带有发现分类的书源，即可在这里浏览书籍。")
                         } actions: {
                             NavigationLink("管理书源") { SourceManagementView() }
-                                .buttonStyle(.borderedProminent)
+                                .readingProminentButtonStyle()
                         }
                     } else {
                         LazyVStack(spacing: 0) {

App/Features/RSS/RSSViews.swift

@@ -142,7 +142,7 @@ private struct RSSArticleListView: View {
                 ScrollView(.horizontal, showsIndicators: false) {
                     HStack { ForEach(Array(sorts.enumerated()), id: \.element.id) { index, sort in
                         Button(sort.name.isEmpty ? "默认" : sort.name) { selectedSort = index; Task { await refresh() } }
-                            .buttonStyle(.bordered).tint(selectedSort == index ? ReadingTheme.accent : .secondary)
+                            .readingChoiceButtonStyle(isSelected: selectedSort == index)
                     }}.padding(.horizontal)
                 }.padding(.vertical, 6)
             }
@@ -435,7 +435,7 @@ private struct RSSDownloadView: View {
                 Image(systemName: "doc.badge.arrow.up").font(.system(size: 48)).foregroundStyle(ReadingTheme.accent)
                 Text(fileName).font(.headline)
                 Text(ByteCountFormatter.string(fromByteCount: Int64(data.count), countStyle: .file)).foregroundStyle(.secondary)
-                Button("选择保存位置", systemImage: "folder") { showsExporter = true }.buttonStyle(.borderedProminent)
+                Button("选择保存位置", systemImage: "folder") { showsExporter = true }.readingProminentButtonStyle()
             }
         }.padding().navigationTitle("文件下载").toolbar { ToolbarItem(placement: .cancellationAction) { Button("关闭") { dismiss() } } }
             .task(id: url) { await download() }
@@ -464,7 +464,7 @@ private struct RSSBinaryDocument: FileDocument {
     func fileWrapper(configuration: WriteConfiguration) throws -> FileWrapper { .init(regularFileWithContents: data) }
 }
 
-private struct RSSPhotoView: View {
+struct RSSPhotoView: View {
     @Environment(\.dismiss) private var dismiss
     let value: String
     let source: RssSource
@@ -480,9 +480,13 @@ private struct RSSPhotoView: View {
                         else if loading { ProgressView() }
                         else { ReadingUnavailableView("图片加载失败", systemImage: "photo.badge.exclamationmark") }
                     }.frame(minWidth: proxy.size.width, minHeight: proxy.size.height)
-                }.background(.black)
+                }
+                .background(.black)
+                .environment(\.colorScheme, .dark)
+                .tint(.white)
             }
             .navigationTitle(source.sourceName).navigationBarTitleDisplayMode(.inline)
+            .readingNavigationBarBackground()
             .toolbar {
                 ToolbarItem(placement: .primaryAction) { Button("保存到照片", systemImage: "square.and.arrow.down") { save() }.disabled(image == nil) }
                 ToolbarItem(placement: .confirmationAction) { Button("完成") { dismiss() } }
@@ -490,6 +494,7 @@ private struct RSSPhotoView: View {
             .task(id: value) { await load() }
             .alert("图片", isPresented: Binding(get: { message != nil }, set: { if !$0 { message = nil } })) { Button("好") { message = nil } } message: { Text(message ?? "") }
         }
+        .readingTabBarHidden()
     }
 
     private func load() async {

App/Features/RSS/RSSWebReaderView.swift

@@ -41,6 +41,9 @@ struct RSSWebReaderView: UIViewRepresentable {
             controller.addUserScript(.init(source: inject, injectionTime: .atDocumentEnd, forMainFrameOnly: false))
         }
         let webView = WKWebView(frame: .zero, configuration: configuration)
+        webView.isOpaque = false
+        webView.backgroundColor = UIColor(ReadingTheme.canvas)
+        webView.scrollView.backgroundColor = UIColor(ReadingTheme.canvas)
         webView.navigationDelegate = context.coordinator
         webView.uiDelegate = context.coordinator
         webView.allowsBackForwardNavigationGestures = true

App/Features/Reader/ReaderView.swift

@@ -492,7 +492,7 @@ struct ReaderView: View {
                 .accessibilityIdentifier("reader.failureChangeSource")
             }
         }
-        .buttonStyle(.bordered)
+        .readingSecondaryButtonStyle()
     }
 
     private func openSourceSwitch() {
@@ -1118,7 +1118,7 @@ struct ReaderView: View {
                             Image(systemName: "textformat.size.smaller")
                                 .frame(width: 38, height: 32)
                         }
-                        .buttonStyle(.bordered)
+                        .readingSecondaryButtonStyle()
 
                         VStack(spacing: 2) {
                             Text("字号")
@@ -1135,7 +1135,7 @@ struct ReaderView: View {
                             Image(systemName: "textformat.size.larger")
                                 .frame(width: 38, height: 32)
                         }
-                        .buttonStyle(.bordered)
+                        .readingSecondaryButtonStyle()
                     }
 
                     HStack(spacing: 8) {
@@ -1285,14 +1285,19 @@ struct ReaderView: View {
                                         Text(choice.title)
                                             .font(.caption2)
                                     }
-                                    .foregroundStyle(pageAnimation == choice.value ? Color.white : Color.primary)
+                                    .foregroundStyle(pageAnimation == choice.value ? ReadingTheme.onAccent : Color.primary)
                                     .frame(width: 58, height: 54)
                                     .background(
-                                        pageAnimation == choice.value ? ReadingTheme.accent : Color.secondary.opacity(0.1),
+                                        pageAnimation == choice.value ? ReadingTheme.accentFill : Color.secondary.opacity(0.1),
                                         in: RoundedRectangle(cornerRadius: 12, style: .continuous)
                                     )
+                                    .overlay {
+                                        RoundedRectangle(cornerRadius: 12, style: .continuous)
+                                            .strokeBorder(pageAnimation == choice.value ? ReadingTheme.selectionBorder : .clear, lineWidth: 1)
+                                    }
                                 }
                                 .buttonStyle(.plain)
+                                .accessibilityAddTraits(pageAnimation == choice.value ? .isSelected : [])
                             }
                         }
                     }
@@ -1392,12 +1397,16 @@ struct ReaderView: View {
         Button(action: action) {
             Text(title)
                 .font(.caption.weight(.medium))
-                .foregroundStyle(selected ? Color.white : Color.primary)
+                .foregroundStyle(selected ? ReadingTheme.onAccent : Color.primary)
                 .padding(.horizontal, 12)
                 .padding(.vertical, 7)
-                .background(selected ? ReadingTheme.accent : Color.secondary.opacity(0.1), in: Capsule())
+                .background(selected ? ReadingTheme.accentFill : Color.secondary.opacity(0.1), in: Capsule())
+                .overlay {
+                    Capsule().strokeBorder(selected ? ReadingTheme.selectionBorder : .clear, lineWidth: 1)
+                }
         }
         .buttonStyle(.plain)
+        .accessibilityAddTraits(selected ? .isSelected : [])
     }
 
     private func valueSlider(

App/Features/Rules/Editor/QRCodeImportView.swift

@@ -39,7 +39,7 @@ struct QRCodeImportView: View {
                 } label: {
                     Label("从照片选择二维码", systemImage: "photo")
                         .frame(maxWidth: .infinity)
-                }.buttonStyle(.borderedProminent).disabled(isReading)
+                }.readingProminentButtonStyle().disabled(isReading)
                 Text("支持 HTTP(S) 链接、Legado 导入深链和 JSON 内容。识别后进入导入流程。")
                     .font(.footnote).foregroundStyle(.secondary)
                 if values.count > 1 {

App/Features/Rules/Editor/SyntaxCodeEditor.swift

@@ -3,6 +3,26 @@ import UIKit
 
 struct SyntaxCodeEditor: UIViewRepresentable {
     enum Language { case json, rule, javascript, regex }
+
+    // Syntax colors are text, so they need more contrast than system icon tints.
+    private enum Palette {
+        static let keyword = adaptive(0x7A2BA6, dark: 0xD5A5F5)
+        static let number = adaptive(0x895900, dark: 0xE6B66A)
+        static let operation = adaptive(0xAD285F, dark: 0xF49AB8)
+        static let punctuation = adaptive(0x14666E, dark: 0x83CED8)
+        static let string = adaptive(0x2D6B39, dark: 0x8CCF96)
+        static let key = adaptive(0x1E5EB2, dark: 0x93BFFF)
+        static let comment = adaptive(0x64646B, dark: 0xA4A4AE)
+
+        private static func adaptive(_ light: UInt32, dark: UInt32) -> UIColor {
+            UIColor { traits in
+                let hex = traits.userInterfaceStyle == .dark ? dark : light
+                return UIColor(red: CGFloat((hex >> 16) & 0xff) / 255,
+                               green: CGFloat((hex >> 8) & 0xff) / 255,
+                               blue: CGFloat(hex & 0xff) / 255, alpha: 1)
+            }
+        }
+    }
     @Binding var text: String
     var language: Language = .rule
 
@@ -13,6 +33,7 @@ struct SyntaxCodeEditor: UIViewRepresentable {
         view.delegate = context.coordinator
         view.font = .monospacedSystemFont(ofSize: 14, weight: .regular)
         view.backgroundColor = .secondarySystemGroupedBackground
+        view.tintColor = UIColor(ReadingTheme.accent)
         view.textContainerInset = UIEdgeInsets(top: 14, left: 12, bottom: 20, right: 12)
         view.autocorrectionType = .no
         view.autocapitalizationType = .none
@@ -24,6 +45,7 @@ struct SyntaxCodeEditor: UIViewRepresentable {
         view.accessibilityIdentifier = "syntaxCodeEditor"
         if #available(iOS 16.0, *) { view.isFindInteractionEnabled = true }
         let bar = UIToolbar()
+        bar.tintColor = UIColor(ReadingTheme.accent)
         bar.sizeToFit()
         bar.items = [
             UIBarButtonItem(image: UIImage(systemName: "magnifyingglass"), primaryAction: UIAction(title: "", subtitle: nil) { [weak view, coordinator = context.coordinator] _ in
@@ -126,12 +148,12 @@ struct SyntaxCodeEditor: UIViewRepresentable {
             storage.addAttributes([.font: UIFont.monospacedSystemFont(ofSize: 14, weight: .regular), .foregroundColor: UIColor.label], range: all)
             if storage.length <= 500_000 {
                 let tokens: [(String, UIColor)] = [
-                    (#"\b(?:true|false|null|undefined|return|var|let|const|if|else|function|new|for|while|try|catch|throw|await|async)\b"#, .systemPurple),
-                    (#"\b\d+(?:\.\d+)?\b"#, .systemOrange),
-                    (#"@(?:css|xpath|json|js|put|get):?|\$\.|&&|\|\||%%|##|\{\{|\}\}"#, .systemPink),
-                    (#"[{}\[\]()]"#, .systemTeal),
-                    (#""(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`"#, .systemGreen),
-                    (#""(?:\\.|[^"\\])*"(?=\s*:)"#, .systemBlue),
+                    (#"\b(?:true|false|null|undefined|return|var|let|const|if|else|function|new|for|while|try|catch|throw|await|async)\b"#, Palette.keyword),
+                    (#"\b\d+(?:\.\d+)?\b"#, Palette.number),
+                    (#"@(?:css|xpath|json|js|put|get):?|\$\.|&&|\|\||%%|##|\{\{|\}\}"#, Palette.operation),
+                    (#"[{}\[\]()]"#, Palette.punctuation),
+                    (#""(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`"#, Palette.string),
+                    (#""(?:\\.|[^"\\])*"(?=\s*:)"#, Palette.key),
                 ]
                 for (pattern, color) in tokens {
                     guard let regex = try? NSRegularExpression(pattern: pattern) else { continue }
@@ -143,7 +165,7 @@ struct SyntaxCodeEditor: UIViewRepresentable {
                     for pattern in [#"[.*+?^$|]"#, #"\\[dDsSwWbB0-9]|\{[0-9,]+\}"#] {
                         let regex = try? NSRegularExpression(pattern: pattern)
                         regex?.enumerateMatches(in: view.text, range: all) { result, _, _ in
-                            if let result { storage.addAttribute(.foregroundColor, value: UIColor.systemPink, range: result.range) }
+                            if let result { storage.addAttribute(.foregroundColor, value: Palette.operation, range: result.range) }
                         }
                     }
                 }
@@ -151,7 +173,7 @@ struct SyntaxCodeEditor: UIViewRepresentable {
                     let pattern = #"(?m)^\s*//.*$|/\*[\s\S]*?\*/"#
                     let regex = try? NSRegularExpression(pattern: pattern)
                     regex?.enumerateMatches(in: view.text, range: all) { result, _, _ in
-                        if let result { storage.addAttribute(.foregroundColor, value: UIColor.secondaryLabel, range: result.range) }
+                        if let result { storage.addAttribute(.foregroundColor, value: Palette.comment, range: result.range) }
                     }
                 }
             }

App/Features/Sources/SourceDebugView.swift

@@ -81,8 +81,7 @@ struct SourceDebugView: View {
                     Label(model.isRunning ? "正在调试…" : "运行完整链路", systemImage: "play.fill")
                         .font(.headline).frame(maxWidth: .infinity)
                 }
-                .buttonStyle(.borderedProminent)
-                .tint(ReadingTheme.accent)
+                .readingProminentButtonStyle()
                 .disabled(model.isRunning || model.keyword.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)
             }
         }

App/Features/Sources/SourceEditorView.swift

@@ -44,11 +44,10 @@ struct SourceEditorView: View {
                         HStack {
                             ForEach(BookSourceEditorSchema.sections) { section in
                                 Button(section.title) { sectionID = section.id }
-                                    .buttonStyle(.bordered)
-                                    .tint(sectionID == section.id ? ReadingTheme.accent : .secondary)
+                                    .readingChoiceButtonStyle(isSelected: sectionID == section.id)
                             }
-                            Button("选项") { sectionID = "options" }.buttonStyle(.bordered)
-                                .tint(sectionID == "options" ? ReadingTheme.accent : .secondary)
+                            Button("选项") { sectionID = "options" }
+                                .readingChoiceButtonStyle(isSelected: sectionID == "options")
                         }.padding(.horizontal)
                     }.padding(.vertical, 6)
                     Form {

App/Features/Sources/SourceLoginView.swift

@@ -1,5 +1,6 @@
 @preconcurrency import WebKit
 import SwiftUI
+import UIKit
 
 struct SourceLoginView: View {
     let source: BookSource
@@ -74,6 +75,9 @@ private struct SourceLoginWebView: UIViewRepresentable {
         let configuration = WKWebViewConfiguration()
         configuration.websiteDataStore = .default()
         let webView = WKWebView(frame: .zero, configuration: configuration)
+        webView.isOpaque = false
+        webView.backgroundColor = UIColor(ReadingTheme.canvas)
+        webView.scrollView.backgroundColor = UIColor(ReadingTheme.canvas)
         webView.navigationDelegate = context.coordinator
         context.coordinator.installExistingCookies(in: webView) { webView.load(request) }
         return webView

App/Features/Sources/SourceManagementView.swift

@@ -61,7 +61,7 @@ struct SourceManagementView: View {
                     Text("新建书源，或从文件、链接、JSON、二维码导入。")
                 } actions: {
                     Button("导入书源", action: presentFileImporter)
-                        .buttonStyle(.borderedProminent)
+                        .readingProminentButtonStyle()
                 }
             } else {
                 List {

App/RootTabView.swift

@@ -50,6 +50,10 @@ struct RootTabView: View {
                         SearchView(initialKeyword: automationSearchKeyword)
                     } else if requestedDemoPage == "sources" {
                         SourceManagementView()
+                    } else if requestedDemoPage == "rss" {
+                        RSSHomeView()
+                    } else if requestedDemoPage == "rss-photo" {
+                        RSSPhotoView(value: "data:image/png;base64,", source: RssSource(sourceUrl: "https://appearance.invalid", sourceName: "图片外观检查"))
                     } else {
                         BookshelfView()
                     }
@@ -99,7 +103,6 @@ struct RootTabView: View {
                 .tabItem { Label("我的", systemImage: "person.crop.circle") }
                 .tag(Tab.my)
         }
-        .tint(ReadingTheme.accent)
         .readingTabBarBackground()
         .preferredColorScheme(themeMode == "2" ? .dark : (themeMode == "1" || themeMode == "3" ? .light : nil))
         .transaction { transaction in
@@ -123,6 +126,8 @@ struct RootTabView: View {
                 dismissButton: .default(Text("好")) { sourceLibrary.notice = nil }
             )
         }
+        .tint(ReadingTheme.accent)
+        .toggleStyle(SwitchToggleStyle(tint: ReadingTheme.toggleTint))
     }
 
     private var requestedDemoPage: String? {
@@ -146,7 +151,7 @@ private struct BookshelfView: View {
     @EnvironmentObject private var library: BookLibraryModel
     @EnvironmentObject private var sources: SourceLibraryModel
     @State private var showsLocalImporter = false
-    @State private var pendingLocalURLs: [URL] = []
+    @State private var pendingLocalFiles: [LocalBookImportFile] = []
     @State private var selectedGroupID = BookGroup.idAll
     @State private var showsGroupManager = false
     @AppStorage("bookshelfLayout") private var bookshelfLayout = "grid3"
@@ -222,26 +227,17 @@ private struct BookshelfView: View {
         }
         .background(ReadingTheme.canvas)
         .navigationBarHidden(true)
-        .fileImporter(
-            isPresented: $showsLocalImporter,
-            allowedContentTypes: [.text, .plainText, .data],
-            allowsMultipleSelection: true
-        ) { result in
-            switch result {
-            case .success(let urls):
-                pendingLocalURLs = urls.filter { $0.pathExtension.lowercased() == "txt" }
-                if pendingLocalURLs.isEmpty, !urls.isEmpty {
-                    library.reportError(LocalBookError.unsupportedFormat)
-                }
-            case .failure(let error): library.reportError(error)
-            }
+        .readingTXTFileImporter(isPresented: $showsLocalImporter) { files in
+            pendingLocalFiles = files
+        } onError: { error in
+            library.reportError(error)
         }
         .sheet(isPresented: Binding(
-            get: { !pendingLocalURLs.isEmpty },
-            set: { if !$0 { pendingLocalURLs = [] } }
+            get: { !pendingLocalFiles.isEmpty },
+            set: { if !$0 { pendingLocalFiles = [] } }
         )) {
-            LocalBookImportReviewView(urls: pendingLocalURLs) {
-                pendingLocalURLs = []
+            LocalBookImportReviewView(files: pendingLocalFiles) {
+                pendingLocalFiles = []
             }
             .environmentObject(library)
         }
@@ -496,7 +492,7 @@ private struct ContinueReadingCard: View {
                 .foregroundStyle(ReadingTheme.onAccent)
                 .padding(.horizontal, 18)
                 .frame(minHeight: 40)
-                .background(ReadingTheme.accent, in: Capsule())
+                .background(ReadingTheme.accentFill, in: Capsule())
                 .padding(.top, 20)
             }
             .frame(maxWidth: .infinity, alignment: .leading)
@@ -646,15 +642,17 @@ private struct BookGroupSelectView: View {
 private struct LocalBookImportReviewView: View {
     @Environment(\.dismiss) private var dismiss
     @EnvironmentObject private var library: BookLibraryModel
-    let urls: [URL]
+    let files: [LocalBookImportFile]
     let onFinish: () -> Void
     @State private var selectedPaths: Set<String>
     @State private var isImporting = false
 
-    init(urls: [URL], onFinish: @escaping () -> Void) {
-        self.urls = urls
+    private var urls: [URL] { files.map(\.url) }
+
+    init(files: [LocalBookImportFile], onFinish: @escaping () -> Void) {
+        self.files = files
         self.onFinish = onFinish
-        _selectedPaths = State(initialValue: Set(urls.map(\.path)))
+        _selectedPaths = State(initialValue: Set(files.map { $0.url.path }))
     }
 
     var body: some View {
@@ -690,9 +688,9 @@ private struct LocalBookImportReviewView: View {
                 ToolbarItem(placement: .confirmationAction) {
                     Button("导入") {
                         isImporting = true
-                        let selected = urls.filter { selectedPaths.contains($0.path) }
+                        let selected = files.filter { selectedPaths.contains($0.url.path) }
                         Task {
-                            await library.importLocalFiles(selected)
+                            await library.importPickedLocalFiles(selected)
                             finish()
                         }
                     }
@@ -726,7 +724,7 @@ private struct EmptyBookshelfHero: View {
             }
             VStack(spacing: 12) {
                 Button("导入本地书", action: onImport)
-                    .buttonStyle(.borderedProminent)
+                    .readingProminentButtonStyle()
                     .controlSize(.large)
                 NavigationLink("添加书源") { SourceManagementView() }
                     .font(.subheadline)
@@ -993,7 +991,7 @@ struct SearchView: View {
                     Spacer()
                     if model.isPaused {
                         Button("继续", systemImage: "play.fill") { model.resume() }
-                            .buttonStyle(.bordered)
+                            .readingSecondaryButtonStyle()
                             .controlSize(.small)
                     } else if model.state == .searching {
                         StatusPill(text: "\(model.completedSourceCount)/\(model.totalSourceCount)", systemImage: "magnifyingglass")
@@ -1044,10 +1042,10 @@ struct SearchView: View {
         ) {
             if model.isPaused {
                 Button("继续搜索", systemImage: "play.fill") { model.resume() }
-                    .buttonStyle(.borderedProminent).tint(ReadingTheme.accent)
+                    .readingProminentButtonStyle()
             }
             Button("修改关键词", systemImage: "text.cursor") { searchIsPresented = true }
-                .buttonStyle(.bordered)
+                .readingSecondaryButtonStyle()
         }
     }
 
@@ -1058,13 +1056,13 @@ struct SearchView: View {
             systemImage: "network.slash"
         ) {
             Button("调整范围", systemImage: "scope") { showsScope = true }
-                .buttonStyle(.borderedProminent).tint(ReadingTheme.accent)
+                .readingProminentButtonStyle()
             NavigationLink {
                 SourceManagementView()
             } label: {
                 Label("管理书源", systemImage: "network")
             }
-            .buttonStyle(.bordered)
+            .readingSecondaryButtonStyle()
         }
     }
 
@@ -1288,7 +1286,7 @@ private struct SettingsView: View {
                         .clipped()
                         .overlay {
                             if colorScheme == .dark {
-                                Color.black.opacity(0.62)
+                                Color.black.opacity(0.78)
                             }
                         }
                         .overlay(alignment: .bottom) {

CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新记录
 
+## 0.1.11（2026-10-22）
+
+- 修复书架和文件管理中的本地 TXT 选择、导入确认与文件访问权限，支持大小写扩展名和多选，并排除 JSON 书源。
+- 完善深色模式下的按钮、阅读菜单、统计卡片和编辑器语法高亮，改善文字与选中态对比度。
+- 适配 RSS 正文、登录网页和图片查看页外观，保留书源自定义样式。
+- 应用版本为 `0.1.11`，构建号为 `17`。
+
 ## 0.1.10（2026-10-20）
 
 - 修复书源文件选择及导入流程，支持 JSON 多选，调整文件访问权限和导入预览展示时机。

Legado.xcodeproj/project.pbxproj

@@ -6,6 +6,8 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
+		DA1000000000000000000002 /* AppearanceContrastTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = DA2000000000000000000002; };
+		DA1000000000000000000001 /* DarkModeUITests.swift in Sources */ = {isa = PBXBuildFile; fileRef = DA2000000000000000000001; };
 		B10000000000000000000050 = {isa = PBXBuildFile; fileRef = B20000000000000000000050; };
 		B10000000000000000000030 /* ReaderScrollGeometryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = B20000000000000000000030; };
 		BC1000000000000000000001 /* WebReaderBridgeTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = BC2000000000000000000001; };
@@ -124,6 +126,8 @@
 /* End PBXBuildFile section */
 
 /* Begin PBXFileReference section */
+		DA2000000000000000000002 /* AppearanceContrastTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Tests/LegadoReaderTests/AppearanceContrastTests.swift; sourceTree = SOURCE_ROOT; };
+		DA2000000000000000000001 /* DarkModeUITests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Tests/LegadoReaderUITests/DarkModeUITests.swift; sourceTree = SOURCE_ROOT; };
 		B20000000000000000000050 = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Tests/LegadoReaderUITests/ReaderScrollGestureTests.swift; sourceTree = SOURCE_ROOT; };
 		B20000000000000000000051 = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; path = LegadoReaderUITests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
 		B20000000000000000000030 /* ReaderScrollGeometryTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Tests/LegadoReaderTests/ReaderScrollGeometryTests.swift; sourceTree = SOURCE_ROOT; };
@@ -272,6 +276,8 @@
 				AA2200000000000000000010,
 				B20000000000000000000030 /* ReaderScrollGeometryTests.swift */,
 				BC2000000000000000000001 /* WebReaderBridgeTests.swift */,
+				DA2000000000000000000001 /* DarkModeUITests.swift */,
+				DA2000000000000000000002 /* AppearanceContrastTests.swift */,
 				A30000000000000000000001 /* App */,
 				C30000000000000000000001 /* LegadoCore */,
 				A20000000000000000000024 /* txtTocRule.json */,
@@ -678,8 +684,8 @@
 /* End PBXResourcesBuildPhase section */
 
 /* Begin PBXSourcesBuildPhase section */
-		B30000000000000000000050 = {isa = PBXSourcesBuildPhase; buildActionMask = 2147483647; files = (B10000000000000000000050, AA1100000000000000000009, AA1100000000000000000010); runOnlyForDeploymentPostprocessing = 0; };
-		B30000000000000000000030 = {isa = PBXSourcesBuildPhase; buildActionMask = 2147483647; files = (B10000000000000000000030, BC1000000000000000000001); runOnlyForDeploymentPostprocessing = 0; };
+		B30000000000000000000050 = {isa = PBXSourcesBuildPhase; buildActionMask = 2147483647; files = (B10000000000000000000050, AA1100000000000000000009, AA1100000000000000000010, DA1000000000000000000001); runOnlyForDeploymentPostprocessing = 0; };
+		B30000000000000000000030 = {isa = PBXSourcesBuildPhase; buildActionMask = 2147483647; files = (B10000000000000000000030, BC1000000000000000000001, DA1000000000000000000002); runOnlyForDeploymentPostprocessing = 0; };
 		D30000000000000000000002 /* Sources */ = {
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
@@ -858,12 +864,12 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 16;
+				CURRENT_PROJECT_VERSION = 17;
 				DEVELOPMENT_ASSET_PATHS = "";
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = App/Info.plist;
 				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
-				MARKETING_VERSION = 0.1.10;
+				MARKETING_VERSION = 0.1.11;
 				OTHER_LDFLAGS = "$(inherited) -lsqlite3";
 				PRODUCT_BUNDLE_IDENTIFIER = com.epiboly.legado;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -879,11 +885,11 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 16;
+				CURRENT_PROJECT_VERSION = 17;
 				GENERATE_INFOPLIST_FILE = NO;
 				INFOPLIST_FILE = App/Info.plist;
 				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
-				MARKETING_VERSION = 0.1.10;
+				MARKETING_VERSION = 0.1.11;
 				OTHER_LDFLAGS = "$(inherited) -lsqlite3";
 				PRODUCT_BUNDLE_IDENTIFIER = com.epiboly.legado;
 				PRODUCT_NAME = "$(TARGET_NAME)";

Sources/LegadoCore/RSS/RSSReadingPolicy.swift

@@ -34,6 +34,12 @@ public struct RSSReadingPolicy: Sendable {
 
 public struct RSSHTMLProcessor: Sendable {
     public static let defaultStyle = "img{max-width:100% !important; width:auto; height:auto;}video{object-fit:fill; max-width:100% !important; width:auto; height:auto;}body{word-wrap:break-word; height:auto;max-width: 100%; width:auto;}"
+    // Keep source CSS later in the cascade so intentional source styling wins.
+    public static let appearanceStyle = """
+    :root{color-scheme:light dark;}
+    body{background-color:#fcfcfc;color:#171717;}
+    @media(prefers-color-scheme:dark){body{background-color:#111113;color:#f2f2f2;}a{color:#9ecbff;}}
+    """
     public init() {}
 
     public func contentHTML(_ content: String, style: String?) -> String {
@@ -53,7 +59,7 @@ public struct RSSHTMLProcessor: Sendable {
     }
 
     private func injectStyle(into content: String, style: String) -> String {
-        let tag = "<style>\(style)</style>"
+        let tag = "<style>\(Self.appearanceStyle)</style><style>\(style)</style>"
         if let range = content.range(of: "</style>") {
             return String(content[..<range.upperBound]) + tag + String(content[range.upperBound...])
         }

Tests/LegadoAppModelsTests/LocalFileManagementTests.swift

@@ -5,6 +5,38 @@ import LegadoCore
 
 @MainActor
 struct LocalFileManagementTests {
+    @Test func pickedTXTImportsButJSONFilesCannotBecomeLocalBooks() async throws {
+        let root = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString, isDirectory: true)
+        try FileManager.default.createDirectory(at: root, withIntermediateDirectories: true)
+        defer { try? FileManager.default.removeItem(at: root) }
+        let inputs = [
+            ("小说.TXT", "第一章 开始\n本地小说的正文"),
+            ("书源.json", #"{"bookSourceName":"书源"}"#),
+            ("大写书源.JSON", #"{"bookSourceName":"书源"}"#)
+        ]
+        let files = try inputs.map { name, text in
+            let url = root.appendingPathComponent(name)
+            try Data(text.utf8).write(to: url)
+            return LocalBookImportFile(url: url)
+        }
+        let model = BookLibraryModel(repository: InMemoryBookRepository(),
+                                     localDirectory: root.appendingPathComponent("managed"),
+                                     chapterRepository: InMemoryBookChapterRepository())
+        await model.load()
+
+        await model.importPickedLocalFiles(files)
+
+        let book = try #require(model.books.first)
+        #expect(model.books.count == 1)
+        #expect(book.origin == "local")
+        #expect(book.originName == "小说.TXT")
+        #expect(model.errorMessage?.contains("书源.json") == true)
+        #expect(model.errorMessage?.contains("大写书源.JSON") == true)
+        #expect(try await model.localFiles.list().count == 1)
+        let imported = try #require(URL(string: book.bookUrl))
+        #expect(try Data(contentsOf: imported) == Data(inputs[0].1.utf8))
+    }
+
     private func fixture(fails: Bool = false) async throws -> (URL, Book, BookLibraryModel) {
         let root = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString, isDirectory: true)
         try FileManager.default.createDirectory(at: root, withIntermediateDirectories: true)

Tests/LegadoCoreTests/LegadoDatabaseTests.swift

@@ -440,7 +440,7 @@ struct LegadoDatabaseTests {
     @Test func rssHTMLAndResourcePoliciesApplyRulesInOrder() {
         let processor = RSSHTMLProcessor()
         #expect(processor.contentHTML("<head></head><body>x</body>", style: "body{color:red}").contains("<style>body{color:red}</style></head>"))
-        #expect(processor.contentHTML("<p>x</p>", style: nil).hasPrefix("<style>\(RSSHTMLProcessor.defaultStyle)</style>"))
+        #expect(processor.contentHTML("<p>x</p>", style: nil).hasPrefix("<style>\(RSSHTMLProcessor.appearanceStyle)</style><style>\(RSSHTMLProcessor.defaultStyle)</style>"))
         var source = RssSource(sourceUrl: "https://rss", sourceName: "源")
         source.startJs = "window.ready=true"; source.startStyle = "p{font-size:20px}"
         let start = processor.startHTML("<body><p>x</p></body>", source: source)

Tests/LegadoReaderTests/AppearanceContrastTests.swift

@@ -0,0 +1,86 @@
+import SwiftUI
+import UIKit
+import WebKit
+import XCTest
+@testable import Legado
+
+@MainActor
+final class AppearanceContrastTests: XCTestCase {
+    func testLoginWebViewUsesAdaptiveBackgroundBeforeContentArrives() async throws {
+        var source = BookSource(bookSourceUrl: "https://appearance.invalid", bookSourceName: "外观测试")
+        source.loginUrl = "about:blank"
+        let controller = UIHostingController(rootView: SourceLoginView(source: source))
+        let window = UIWindow(frame: CGRect(x: 0, y: 0, width: 390, height: 844))
+        window.overrideUserInterfaceStyle = .dark
+        window.rootViewController = controller
+        window.makeKeyAndVisible()
+        defer { window.isHidden = true }
+        func webView(in view: UIView) -> WKWebView? {
+            if let view = view as? WKWebView { return view }
+            return view.subviews.lazy.compactMap { webView(in: $0) }.first
+        }
+        window.layoutIfNeeded()
+        for _ in 0..<20 {
+            if webView(in: controller.view) != nil { break }
+            try await Task.sleep(nanoseconds: 50_000_000)
+        }
+        let web = try XCTUnwrap(webView(in: controller.view))
+        XCTAssertFalse(web.isOpaque)
+        for style in [UIUserInterfaceStyle.dark, .light] {
+            window.overrideUserInterfaceStyle = style
+            window.layoutIfNeeded()
+            let traits = UITraitCollection(userInterfaceStyle: style)
+            let background = try XCTUnwrap(web.backgroundColor).resolvedColor(with: traits)
+            let scroll = try XCTUnwrap(web.scrollView.backgroundColor).resolvedColor(with: traits)
+            if style == .dark {
+                XCTAssertLessThan(luminance(background), 0.15)
+                XCTAssertLessThan(luminance(scroll), 0.15)
+            } else {
+                XCTAssertGreaterThan(luminance(background), 0.6)
+                XCTAssertGreaterThan(luminance(scroll), 0.6)
+            }
+        }
+    }
+
+    func testSyntaxTokensHaveReadableContrastInBaseAndElevatedAppearances() {
+        let samples: [(SyntaxCodeEditor.Language, String)] = [
+            (.json, #"{"title":"正文","count":12,"enabled":true,"empty":null}"#),
+            (.rule, "@css:div && $.title {{key}} ##"),
+            (.regex, #"\d+.*(word){2,4}"#),
+            (.javascript, "// comment\nconst value = 'text'; return 123; /* comment */")
+        ]
+        for style in [UIUserInterfaceStyle.light, .dark] {
+            for level in [UIUserInterfaceLevel.base, .elevated] {
+                let traits = UITraitCollection(traitsFrom: [
+                    UITraitCollection(userInterfaceStyle: style),
+                    UITraitCollection(userInterfaceLevel: level)
+                ])
+                for (language, text) in samples {
+                    let editor = SyntaxCodeEditor(text: .constant(text), language: language)
+                    let view = UITextView()
+                    view.overrideUserInterfaceStyle = style
+                    view.text = text
+                    editor.makeCoordinator().highlight(view)
+                    let background = UIColor.secondarySystemGroupedBackground.resolvedColor(with: traits)
+                    view.textStorage.enumerateAttribute(.foregroundColor, in: NSRange(location: 0, length: view.textStorage.length)) { color, _, _ in
+                        guard let color = color as? UIColor else { return XCTFail("Missing syntax color") }
+                        let foreground = color.resolvedColor(with: traits)
+                        let values = [luminance(foreground), luminance(background)].sorted()
+                        XCTAssertGreaterThanOrEqual((values[1] + 0.05) / (values[0] + 0.05), 4.5,
+                                                    "Low contrast for \(language), \(style), \(level)")
+                    }
+                }
+            }
+        }
+    }
+
+    private func luminance(_ color: UIColor) -> Double {
+        var r: CGFloat = 0, g: CGFloat = 0, b: CGFloat = 0, a: CGFloat = 0
+        XCTAssertTrue(color.getRed(&r, green: &g, blue: &b, alpha: &a))
+        func linear(_ value: CGFloat) -> Double {
+            let value = Double(value)
+            return value <= 0.04045 ? value / 12.92 : pow((value + 0.055) / 1.055, 2.4)
+        }
+        return 0.2126 * linear(r) + 0.7152 * linear(g) + 0.0722 * linear(b)
+    }
+}

Tests/LegadoReaderTests/WebReaderBridgeTests.swift

@@ -5,6 +5,56 @@ import XCTest
 
 @MainActor
 final class WebReaderBridgeTests: XCTestCase {
+    func testGeneratedRSSContentFollowsAppearanceWithoutReloading() async throws {
+        let source = RssSource(sourceUrl: "https://appearance-regression.test", sourceName: "测试")
+        let loaded = expectation(description: "HTML loaded")
+        let surface = RSSWebReaderView(
+            mode: .html(content: "<body><p>订阅正文</p><a href='#'>链接</a><button>操作</button></body>", baseURL: nil),
+            source: source, onTextChange: { _ in loaded.fulfill() }
+        )
+        let coordinator = surface.makeCoordinator()
+        let webView = WKWebView(frame: CGRect(x: 0, y: 0, width: 390, height: 844))
+        webView.navigationDelegate = coordinator
+        let window = UIWindow(frame: webView.frame)
+        let controller = UIViewController()
+        controller.overrideUserInterfaceStyle = .dark
+        controller.view.addSubview(webView)
+        window.rootViewController = controller
+        window.makeKeyAndVisible()
+        defer {
+            RSSWebReaderView.dismantleUIView(webView, coordinator: coordinator)
+            window.isHidden = true
+        }
+        coordinator.installRulesAndLoad(mode: surface.mode, in: webView)
+        await fulfillment(of: [loaded], timeout: 20)
+        let appearanceScript = """
+        [matchMedia('(prefers-color-scheme:dark)').matches,
+         getComputedStyle(document.body).backgroundColor,
+         getComputedStyle(document.body).color,
+         getComputedStyle(document.querySelector('a')).color,
+         getComputedStyle(document.documentElement).colorScheme].map(String).join('|')
+        """
+        let dark = try await webView.evaluateJavaScript(appearanceScript)
+        XCTAssertEqual(dark as? String, "true|rgb(17, 17, 19)|rgb(242, 242, 242)|rgb(158, 203, 255)|light dark")
+        _ = try await webView.evaluateJavaScript("window.appearanceMarker = 'preserved'")
+        controller.overrideUserInterfaceStyle = .light
+        window.layoutIfNeeded()
+        XCTAssertEqual(webView.traitCollection.userInterfaceStyle, .light)
+        var light = try await webView.evaluateJavaScript(appearanceScript)
+        for _ in 0..<50 {
+            if (light as? String)?.hasPrefix("false|") == true { break }
+            try await Task.sleep(nanoseconds: 100_000_000)
+            light = try await webView.evaluateJavaScript(appearanceScript)
+        }
+        XCTAssertEqual(light as? String, "false|rgb(252, 252, 252)|rgb(23, 23, 23)|rgb(0, 0, 238)|light dark")
+        let marker = try await webView.evaluateJavaScript("window.appearanceMarker")
+        XCTAssertEqual(marker as? String, "preserved")
+        // A source may intentionally override the generated article palette.
+        _ = try await webView.evaluateJavaScript("document.head.insertAdjacentHTML('beforeend', '<style>body{color:rgb(120,30,40)}</style>')")
+        let custom = try await webView.evaluateJavaScript("getComputedStyle(document.body).color")
+        XCTAssertEqual(custom as? String, "rgb(120, 30, 40)")
+    }
+
     func testPageJavaScriptCanStoreVariablesAndEvaluateContentRules() async throws {
         let source = RssSource(sourceUrl: "https://bridge-regression.test/\(UUID().uuidString)", sourceName: "测试")
         let loaded = expectation(description: "HTML loaded")

Tests/LegadoReaderUITests/DarkModeUITests.swift

@@ -0,0 +1,326 @@
+import UIKit
+import XCTest
+
+@MainActor
+final class DarkModeUITests: XCTestCase {
+    func testPrimaryActionsKeepDarkFillInBothAppearances() throws {
+        continueAfterFailure = false
+        for theme in ["2", "1"] {
+            let app = launch(["-uiDemoBookDetail", "-themeMode", theme])
+            let read = app.buttons.matching(NSPredicate(format: "label IN %@", ["开始阅读", "继续阅读"])).firstMatch
+            XCTAssertTrue(read.waitForExistence(timeout: 20))
+            XCTAssertTrue(read.isEnabled)
+            try assertReadableDarkFill(read, in: app)
+            attach(app, name: "Book detail theme \(theme)")
+            app.terminate()
+        }
+    }
+
+    func testNightReaderSelectionsKeepDarkFillAndReadableLabels() throws {
+        continueAfterFailure = false
+        let app = launch([
+            "-uiDemoReader", "-uiDemoReaderStyle", "-themeMode", "2",
+            "-readerTheme", "night", "-readerUseBackgroundImage", "NO",
+            "-lineSpacingExtra", "12", "-pageAnim", "0"
+        ])
+        XCTAssertTrue(app.navigationBars["阅读样式"].waitForExistence(timeout: 20))
+        // Expand the sheet so the controls can be inspected without clipping.
+        app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.48))
+            .press(forDuration: 0.1, thenDragTo: app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.12)))
+        let standard = app.buttons["标准"]
+        XCTAssertTrue(standard.waitForExistence(timeout: 5))
+        try assertReadableDarkFill(standard, in: app)
+        attach(app, name: "Night reader spacing selection")
+        let cover = app.buttons["覆盖"]
+        for _ in 0..<16 {
+            if cover.exists && cover.isHittable && cover.frame.maxY < app.frame.height - 50 { break }
+            app.swipeUp()
+        }
+        XCTAssertTrue(cover.exists && cover.isHittable)
+        try assertReadableDarkFill(cover, in: app)
+        attach(app, name: "Night reader animation selection")
+    }
+
+    func testDarkAppearanceAcrossTabsAndPresentedEditors() throws {
+        continueAfterFailure = false
+        let app = launch(["-themeMode", "2"])
+        XCTAssertTrue(app.tabBars.buttons["书架"].waitForExistence(timeout: 20))
+        for (tab, heading) in [("书架", "阅读，让时间有了形状"), ("发现", "下一本好书，在这里遇见"),
+                               ("统计", "每一页，都算数"), ("我的", "按照你的方式阅读")] {
+            app.tabBars.buttons[tab].tap()
+            XCTAssertTrue(app.staticTexts[heading].waitForExistence(timeout: 5))
+            if tab == "统计" {
+                let today = app.otherElements["statistics.todayCard"]
+                XCTAssertTrue(today.waitForExistence(timeout: 5))
+                try assertReadableDarkFill(today, in: app)
+            }
+            attach(app, name: "Dark tab \(tab)")
+        }
+        app.buttons["profile.globe"].tap()
+        XCTAssertTrue(app.navigationBars["书源"].waitForExistence(timeout: 10))
+        attach(app, name: "Dark source library")
+        app.buttons["更多"].firstMatch.tap()
+        app.buttons["新建书源"].tap()
+        XCTAssertTrue(app.navigationBars["新建书源"].waitForExistence(timeout: 10))
+        let basic = app.buttons["基础"]
+        try assertReadableDarkFill(basic, in: app)
+        let login = app.buttons["登录"]
+        login.tap()
+        try assertReadableDarkFill(login, in: app)
+        attach(app, name: "Dark source category selection")
+        attach(app, name: "Dark presented source editor")
+        app.segmentedControls.buttons["JSON"].tap()
+        XCTAssertTrue(app.textViews["syntaxCodeEditor"].waitForExistence(timeout: 5))
+        attach(app, name: "Dark JSON editor")
+        app.textViews["syntaxCodeEditor"].tap()
+        XCTAssertTrue(app.keyboards.firstMatch.waitForExistence(timeout: 5))
+        attach(app, name: "Dark editor keyboard and accessory toolbar")
+        let visibleKeyboard = app.keyboards.firstMatch.frame.intersection(app.frame)
+        if !visibleKeyboard.isNull && visibleKeyboard.width > 20 && visibleKeyboard.height > 20 {
+            let keyboard = try luminances(app.keyboards.firstMatch, in: app)
+            XCTAssertLessThan(keyboard[keyboard.count / 2], 0.15)
+        }
+        let accessory = app.buttons["完成"]
+        let accessoryFrame = accessory.frame.intersection(app.frame)
+        if accessory.isHittable && !accessoryFrame.isNull && accessoryFrame.width > 20 && accessoryFrame.height > 20 {
+            try assertReadableDarkFill(accessory, in: app)
+        }
+    }
+
+    func testDarkSettingsRulesAndManagementPages() throws {
+        continueAfterFailure = false
+        let app = launch(["-uiDemoTab", "settings", "-themeMode", "2"])
+        let routes: [(String, String, String?)] = [
+            ("textformat.size", "阅读设置", nil),
+            ("waveform", "在线朗读引擎", "新建"),
+            ("bookmark", "书签", nil),
+            ("clock", "阅读记录", nil),
+            ("link", "规则订阅", "新建"),
+            ("text.badge.checkmark", "净化规则", "新建规则"),
+            ("list.bullet.rectangle", "TXT目录规则", "新建"),
+            ("folder", "文件管理", nil),
+            ("gearshape", "其他设置", nil),
+            ("info.circle", "关于", nil)
+        ]
+        for (icon, title, create) in routes {
+            let entry = app.buttons["profile.\(icon)"]
+            scrollTo(entry, in: app)
+            entry.tap()
+            XCTAssertTrue(app.navigationBars[title].waitForExistence(timeout: 10))
+            try captureDarkPage(app, name: "Management \(title)")
+            if let create {
+                app.buttons[create].firstMatch.tap()
+                XCTAssertTrue(app.buttons["取消"].waitForExistence(timeout: 5))
+                try captureDarkPage(app, name: "Editor \(title)")
+                if title == "净化规则" {
+                    app.segmentedControls.buttons["测试规则"].tap()
+                    try captureDarkPage(app, name: "Rule test form")
+                }
+                app.buttons["取消"].tap()
+            }
+            if title == "其他设置" {
+                for (entry, destination) in [("网络与缓存设置", "网络与缓存"), ("章节缓存管理", "缓存管理"), ("日志与诊断", "日志与诊断")] {
+                    let link = app.buttons[entry]
+                    scrollTo(link, in: app)
+                    link.tap()
+                    XCTAssertTrue(app.navigationBars[destination].waitForExistence(timeout: 5))
+                    try captureDarkPage(app, name: "Settings \(destination)")
+                    app.navigationBars.firstMatch.buttons.element(boundBy: 0).tap()
+                }
+            }
+            if title == "关于" {
+                let license = app.buttons["开源许可"]
+                scrollTo(license, in: app)
+                license.tap()
+                XCTAssertTrue(app.navigationBars["开源许可"].waitForExistence(timeout: 5))
+                try captureDarkPage(app, name: "Licenses")
+                app.navigationBars.firstMatch.buttons.element(boundBy: 0).tap()
+            }
+            app.navigationBars.firstMatch.buttons.element(boundBy: 0).tap()
+            XCTAssertTrue(app.scrollViews["profile.scroll"].waitForExistence(timeout: 5))
+        }
+    }
+
+    func testDarkSearchFiltersAndSourceImportSheets() throws {
+        continueAfterFailure = false
+        let app = launch(["-uiDemoTab", "search", "-themeMode", "2", "-uiAutomationSearch", "深色外观检查"])
+        let cancelSearch = app.buttons.matching(NSPredicate(format: "label IN %@", ["取消", "Cancel"])).firstMatch
+        if cancelSearch.waitForExistence(timeout: 3) { cancelSearch.tap() }
+        XCTAssertTrue(app.buttons["搜索选项"].waitForExistence(timeout: 10))
+        app.buttons["搜索选项"].tap()
+        app.buttons["分组或书源"].tap()
+        XCTAssertTrue(app.navigationBars["分组或书源"].waitForExistence(timeout: 5))
+        try captureDarkPage(app, name: "Search group filter")
+        app.segmentedControls.buttons["书源"].tap()
+        try captureDarkPage(app, name: "Search source filter")
+        app.buttons["取消"].tap()
+        app.terminate()
+
+        app.launchArguments = ["-uiDemo", "-uiDemoTab", "sources", "-themeMode", "2"]
+        app.launch()
+        XCTAssertTrue(app.navigationBars["书源"].waitForExistence(timeout: 10))
+        app.buttons["排序"].tap()
+        XCTAssertTrue(app.buttons["倒序"].waitForExistence(timeout: 5))
+        try assertReadableDarkFill(app.buttons["倒序"], in: app)
+        attach(app, name: "Source sorting menu")
+        app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.8)).tap()
+        app.buttons["更多"].firstMatch.tap()
+        app.buttons["URL 或粘贴 JSON"].tap()
+        XCTAssertTrue(app.buttons["取消"].waitForExistence(timeout: 5))
+        try captureDarkPage(app, name: "Source text import")
+    }
+
+    func testDarkRSSAndBlackPhotoViewerInLightAppearance() throws {
+        continueAfterFailure = false
+        let app = launch(["-uiDemoTab", "rss", "-themeMode", "2"])
+        XCTAssertTrue(app.navigationBars["RSS"].waitForExistence(timeout: 10))
+        for tab in ["订阅", "收藏", "记录"] {
+            app.segmentedControls.buttons[tab].tap()
+            try captureDarkPage(app, name: "RSS \(tab)")
+        }
+        app.segmentedControls.buttons["订阅"].tap()
+        app.buttons["RSS操作"].tap()
+        app.buttons["新建RSS源"].tap()
+        XCTAssertTrue(app.navigationBars["新建RSS源"].waitForExistence(timeout: 5))
+        try captureDarkPage(app, name: "RSS source editor")
+        app.terminate()
+
+        app.launchArguments = ["-uiDemo", "-uiDemoTab", "rss-photo", "-themeMode", "1"]
+        app.launch()
+        XCTAssertTrue(app.alerts["图片"].waitForExistence(timeout: 10))
+        app.alerts["图片"].buttons["好"].tap()
+        let error = app.staticTexts["图片加载失败"]
+        XCTAssertTrue(error.waitForExistence(timeout: 5))
+        try assertReadableDarkFill(error, in: app)
+        let done = app.navigationBars.buttons["完成"]
+        XCTAssertTrue(done.exists && done.isEnabled)
+        attach(app, name: "Photo viewer navigation and content")
+        let toolbar = try luminances(done, in: app)
+        XCTAssertGreaterThanOrEqual((toolbar[toolbar.count * 98 / 100] + 0.05) / (toolbar[toolbar.count * 2 / 100] + 0.05), 4.5)
+        attach(app, name: "Readable photo error on black canvas")
+    }
+
+    func testNightReaderMenusAndSettings() throws {
+        continueAfterFailure = false
+        let app = launch(["-uiDemoReader", "-uiDemoReaderMenu", "-readerTheme", "night", "-themeMode", "2", "-readerUseBackgroundImage", "NO"])
+        XCTAssertTrue(app.buttons["目录"].waitForExistence(timeout: 15))
+        try captureDarkPage(app, name: "Night reader menu")
+        app.buttons["目录"].tap()
+        XCTAssertTrue(app.navigationBars["目录"].waitForExistence(timeout: 5))
+        try captureDarkPage(app, name: "Night table of contents")
+        app.buttons["关闭"].tap()
+        app.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
+        app.buttons["设置"].tap()
+        XCTAssertTrue(app.navigationBars["阅读设置"].waitForExistence(timeout: 5))
+        try captureDarkPage(app, name: "Night reader settings")
+        let click = app.buttons["点击区域设置"]
+        scrollTo(click, in: app)
+        click.tap()
+        XCTAssertTrue(app.navigationBars["点击区域设置"].waitForExistence(timeout: 5))
+        try captureDarkPage(app, name: "Night click action grid")
+    }
+
+    func testAppearanceMenuRestoresSystemAndUpdatesVisiblePage() throws {
+        continueAfterFailure = false
+        // Launch arguments override writes to UserDefaults; leave themeMode mutable here.
+        let app = launch(["-uiDemoTab", "settings"])
+        let appearance = app.buttons["profile.appearance"]
+        XCTAssertTrue(appearance.waitForExistence(timeout: 10))
+        appearance.tap()
+        let system = app.buttons["跟随系统"]
+        XCTAssertTrue(system.waitForExistence(timeout: 3))
+        system.tap()
+        let followsSystem = expectation(for: NSPredicate(format: "value == %@", "跟随系统"), evaluatedWith: appearance)
+        wait(for: [followsSystem], timeout: 5)
+        let initial = try luminances(app, in: app)
+        let systemIsDark = initial[initial.count / 2] < 0.15
+        for (choice, expectsDark) in [("深色", true), ("浅色", false), ("跟随系统", systemIsDark)] {
+            appearance.tap()
+            let option = app.buttons[choice]
+            if !option.waitForExistence(timeout: 2), app.buttons["外观"].exists { app.buttons["外观"].tap() }
+            XCTAssertTrue(option.waitForExistence(timeout: 3))
+            option.tap()
+            let changed = expectation(for: NSPredicate(format: "value == %@", choice), evaluatedWith: appearance)
+            wait(for: [changed], timeout: 5)
+            let values = try luminances(app, in: app)
+            let median = values[values.count / 2]
+            if expectsDark { XCTAssertLessThan(median, 0.15) }
+            else { XCTAssertGreaterThan(median, 0.6) }
+            attach(app, name: "Live appearance \(choice)")
+        }
+    }
+
+    private func scrollTo(_ element: XCUIElement, in app: XCUIApplication) {
+        for _ in 0..<10 {
+            if element.exists && element.isHittable { return }
+            if element.exists && element.frame.maxY < app.frame.height / 2 {
+                app.swipeDown()
+            } else {
+                app.swipeUp()
+            }
+        }
+        XCTAssertTrue(element.exists && element.isHittable)
+    }
+
+    private func captureDarkPage(_ app: XCUIApplication, name: String) throws {
+        let values = try luminances(app, in: app)
+        XCTAssertLessThan(values[values.count / 2], 0.15, "Unexpected light page or sheet: \(name)")
+        attach(app, name: name)
+    }
+
+    // Check both the rendered label contrast and the fill's actual brightness.
+    // A readable white surface must still fail the dark appearance regression.
+    private func assertReadableDarkFill(_ element: XCUIElement, in app: XCUIApplication,
+                                        file: StaticString = #filePath, line: UInt = #line) throws {
+        let luminances = try luminances(element, in: app, file: file, line: line)
+        let low = luminances[luminances.count * 2 / 100]
+        let high = luminances[luminances.count * 98 / 100]
+        XCTAssertGreaterThanOrEqual((high + 0.05) / (low + 0.05), 4.5,
+                                    "Rendered label has insufficient contrast", file: file, line: line)
+        XCTAssertLessThan(luminances[luminances.count / 2], 0.15,
+                          "Filled control or card is too bright for the dark palette", file: file, line: line)
+    }
+
+    private func luminances(_ element: XCUIElement, in app: XCUIApplication,
+                            file: StaticString = #filePath, line: UInt = #line) throws -> [Double] {
+        let image = try XCTUnwrap(app.screenshot().image.cgImage, file: file, line: line)
+        let scaleX = CGFloat(image.width) / app.frame.width
+        let scaleY = CGFloat(image.height) / app.frame.height
+        let bounds = element.frame.intersection(app.frame).insetBy(dx: 8, dy: 8)
+        let rect = CGRect(x: bounds.minX * scaleX, y: bounds.minY * scaleY,
+                          width: bounds.width * scaleX, height: bounds.height * scaleY).integral
+        let crop = try XCTUnwrap(image.cropping(to: rect), file: file, line: line)
+        var bytes = [UInt8](repeating: 0, count: crop.width * crop.height * 4)
+        try bytes.withUnsafeMutableBytes { buffer in
+            let context = try XCTUnwrap(CGContext(
+                data: buffer.baseAddress, width: crop.width, height: crop.height,
+                bitsPerComponent: 8, bytesPerRow: crop.width * 4,
+                space: CGColorSpaceCreateDeviceRGB(),
+                bitmapInfo: CGImageAlphaInfo.premultipliedLast.rawValue | CGBitmapInfo.byteOrder32Big.rawValue
+            ), file: file, line: line)
+            context.draw(crop, in: CGRect(x: 0, y: 0, width: crop.width, height: crop.height))
+        }
+        func linear(_ component: UInt8) -> Double {
+            let value = Double(component) / 255
+            return value <= 0.04045 ? value / 12.92 : pow((value + 0.055) / 1.055, 2.4)
+        }
+        let sampleStride = crop.width * crop.height > 250_000 ? 64 : 4
+        return stride(from: 0, to: bytes.count, by: sampleStride).map {
+            0.2126 * linear(bytes[$0]) + 0.7152 * linear(bytes[$0 + 1]) + 0.0722 * linear(bytes[$0 + 2])
+        }.sorted()
+    }
+
+    private func launch(_ arguments: [String]) -> XCUIApplication {
+        let app = XCUIApplication()
+        app.launchArguments = ["-uiDemo"] + arguments
+        app.launch()
+        return app
+    }
+
+    private func attach(_ app: XCUIApplication, name: String) {
+        let attachment = XCTAttachment(screenshot: app.screenshot())
+        attachment.name = name
+        attachment.lifetime = .keepAlways
+        add(attachment)
+    }
+}

Tests/LegadoReaderUITests/RuleEditorUITests.swift

@@ -2,6 +2,92 @@ import XCTest
 
 @MainActor
 final class RuleEditorUITests: XCTestCase {
+    func testBookshelfTXTFilePickerImportsTXTAndDisablesJSON() throws {
+        try exerciseLocalTXTImport(fromFileManagement: false)
+    }
+
+    func testFileManagementTXTFilePickerImportsTXTAndDisablesJSON() throws {
+        try exerciseLocalTXTImport(fromFileManagement: true)
+    }
+
+    private func exerciseLocalTXTImport(fromFileManagement: Bool) throws {
+        continueAfterFailure = false
+        let app = XCUIApplication()
+        app.launchArguments = ["-uiDemo", "-themeMode", "1", "-bookshelfLayout", "grid3"]
+        if fromFileManagement { app.launchArguments += ["-uiDemoTab", "settings", "-uiDemoFiles"] }
+        app.launch()
+        let importTitle = fromFileManagement ? "导入 TXT 文件" : "本地书"
+        let more = fromFileManagement
+            ? app.navigationBars["文件管理"].buttons["更多"].firstMatch
+            : app.buttons["更多"].firstMatch
+        XCTAssertTrue(more.waitForExistence(timeout: 20))
+        more.tap()
+        app.buttons[importTitle].tap()
+        let cancel = app.buttons.matching(NSPredicate(format: "label IN %@", ["Cancel", "取消"])).firstMatch
+        XCTAssertTrue(cancel.waitForExistence(timeout: 10))
+        cancel.tap()
+        let closed = expectation(for: NSPredicate { _, _ in !cancel.exists }, evaluatedWith: nil)
+        wait(for: [closed], timeout: 10)
+        more.tap()
+        app.buttons[importTitle].tap()
+        XCTAssertTrue(cancel.waitForExistence(timeout: 10))
+
+        let pickerFiles = app.collectionViews["File View"].cells
+        let txt = pickerFiles.matching(NSPredicate(format: "label BEGINSWITH %@", "TXT-Book")).firstMatch
+        let fixtureJSON = pickerFiles.matching(NSPredicate(format: "label BEGINSWITH %@", "JSON-Source")).firstMatch
+        let fixtures = pickerFiles.matching(NSPredicate(format: "label BEGINSWITH %@", "书源导入测试")).firstMatch
+        // The file-management page underneath the picker can also contain TXT.
+        // JSON exists only inside our fixture folder in the actual picker.
+        if !fixtureJSON.waitForExistence(timeout: 3) {
+            if !fixtures.exists {
+                let browse = app.buttons.matching(NSPredicate(format: "label IN %@", ["Browse", "浏览", "Locations", "位置"])).firstMatch
+                if browse.exists { browse.tap() }
+                if !fixtures.waitForExistence(timeout: 2) {
+                    let local = app.descendants(matching: .any).matching(NSPredicate(
+                        format: "label CONTAINS %@ OR label CONTAINS %@ OR label == %@", "我的 iPhone", "我的iPhone", "On My iPhone"
+                    )).firstMatch
+                    XCTAssertTrue(local.waitForExistence(timeout: 5))
+                    local.tap()
+                }
+            }
+            XCTAssertTrue(fixtures.waitForExistence(timeout: 10), "Run sh scripts/prepare-source-import-fixture.sh <simulator-UUID>")
+            fixtures.tap()
+        }
+        XCTAssertTrue(txt.waitForExistence(timeout: 10))
+        let open = app.buttons.matching(NSPredicate(format: "label IN %@", ["Open", "打开", "Import", "导入"])).firstMatch
+        for name in ["JSON-Source", "JSON-Uppercase"] {
+            let json = pickerFiles.matching(NSPredicate(format: "label BEGINSWITH %@", name)).firstMatch
+            XCTAssertTrue(json.waitForExistence(timeout: 5))
+            XCTAssertFalse(json.isEnabled)
+            json.coordinate(withNormalizedOffset: CGVector(dx: 0.5, dy: 0.5)).tap()
+            XCTAssertFalse(open.exists && open.isEnabled, "JSON must not be selectable as a local book")
+        }
+        txt.tap()
+        let uppercase = pickerFiles.matching(NSPredicate(format: "label BEGINSWITH %@", "TXT-Uppercase")).firstMatch
+        XCTAssertTrue(uppercase.waitForExistence(timeout: 5))
+        uppercase.tap()
+        XCTAssertTrue(open.waitForExistence(timeout: 5))
+        XCTAssertTrue(open.isEnabled)
+        attach(app, name: "TXT selectable and JSON excluded")
+        open.tap()
+
+        if fromFileManagement {
+            XCTAssertTrue(app.navigationBars["文件管理"].waitForExistence(timeout: 15))
+            app.tabBars.buttons["书架"].tap()
+        } else {
+            XCTAssertTrue(app.navigationBars["导入本地书"].waitForExistence(timeout: 15))
+            XCTAssertFalse(app.staticTexts["JSON-Source.json"].exists)
+            XCTAssertFalse(app.staticTexts["JSON-Uppercase.JSON"].exists)
+            XCTAssertTrue(app.staticTexts["TXT-Book.txt"].exists)
+            XCTAssertTrue(app.staticTexts["TXT-Uppercase.TXT"].exists)
+            app.buttons["导入"].tap()
+        }
+        // Repeated runs preserve managed files and correctly add a numeric suffix.
+        XCTAssertTrue(app.staticTexts.matching(NSPredicate(format: "label BEGINSWITH %@", "TXT-Book")).firstMatch.waitForExistence(timeout: 15))
+        XCTAssertTrue(app.staticTexts.matching(NSPredicate(format: "label BEGINSWITH %@", "TXT-Uppercase")).firstMatch.waitForExistence(timeout: 15))
+        attach(app, name: "Local TXT books imported onto shelf")
+    }
+
     func testJSONFilePickerOffersOpenAndImportsSelectedFiles() throws {
         continueAfterFailure = false
         let app = XCUIApplication()

docs/DEVELOPMENT.md

@@ -41,7 +41,7 @@ sh scripts/self-check.sh
 
 阅读器测试在 Xcode 选择 `LegadoReaderTests` / `LegadoReaderUITests` Scheme 和具体模拟器运行。联网书源测试需要显式配置对应环境变量，默认核心回归主要采用自造响应，不能将其通过解读为所有线上书源均可用。
 
-书源文件选择回归需要先在已启动的测试模拟器中准备文件共享应用（将下方 UUID 换成实际值）：
+书源和本地 TXT 文件选择回归需要先在已启动的测试模拟器中准备文件共享应用（将下方 UUID 换成实际值）：
 
 ```sh
 LEGADO_TEST_DEVICE="模拟器 UUID"
@@ -49,10 +49,12 @@ sh scripts/prepare-source-import-fixture.sh "$LEGADO_TEST_DEVICE"
 xcodebuild -project Legado.xcodeproj -scheme LegadoReaderUITests \
   -destination "platform=iOS Simulator,id=$LEGADO_TEST_DEVICE" \
   -only-testing:LegadoReaderUITests/RuleEditorUITests/testJSONFilePickerOffersOpenAndImportsSelectedFiles \
+  -only-testing:LegadoReaderUITests/RuleEditorUITests/testBookshelfTXTFilePickerImportsTXTAndDisablesJSON \
+  -only-testing:LegadoReaderUITests/RuleEditorUITests/testFileManagementTXTFilePickerImportsTXTAndDisablesJSON \
   -collect-test-diagnostics never CODE_SIGNING_ALLOWED=NO test
 ```
 
-独立测试应用只提供 `.json`、`.JSON` 和 `.txt` 样本，不会被打包进正式 App。此回归检查取消后重新打开、JSON 多选后的打开按钮、导入预检及最终保存。
+独立测试应用提供 JSON 书源和 `.txt`、`.TXT` 小说样本，不会被打包进正式 App。此回归检查取消后重新打开、书源 JSON 多选、本地 TXT 可选且 JSON 不可选、导入确认及最终保存。
 
 ## 兼容性验证
 
@@ -75,3 +77,37 @@ python3 scripts/export-open-source.py /tmp/legado-ios-open-source
 ```
 
 目标目录必须尚不存在。导出后检查内容，再用独立仓库管理；`.gitignore` 不会自动清理已经跟踪的文件。
+
+## 维护应用源
+
+`docs/altstore.json` 是 AltStore Classic、SideStore 和 LiveContainer 共用的应用源，固定地址为：
+
+```text
+https://raw.githubusercontent.com/Aminark/legado-ios/main/docs/altstore.json
+```
+
+源仅列出最新正式版，同时提供 `versions` 和旧客户端使用的顶层版本字段。版本号、构建号、最低 iOS 版本和隐私权限从实际 IPA 的 `Info.plist` 读取，下载地址、发布日期和更新说明来自 GitHub Release。目前由维护者在发布正式版后手动运行生成脚本并提交源文件。
+
+1. 新版发布时，先在 Release 草稿中上传唯一的未签名 `.ipa`，再发布正式版。
+2. 下载 GitHub 标记的 latest 正式版元数据及 IPA，运行下方生成与测试命令，检查 `docs/altstore.json` 差异后提交到 `main`。
+3. 源文件发布后，客户端刷新源即可获取该版本的下载与更新入口。只提交源码或上传未发布的草稿不会更新应用源。
+
+本地生成（需要 Python 3.9+；获取 Release 元数据时使用已登录的 GitHub CLI）：
+
+```sh
+source_update_dir=$(mktemp -d)
+gh api repos/Aminark/legado-ios/releases/latest > "$source_update_dir/release.json"
+source_release_tag=$(python3 -c 'import json,sys; print(json.load(open(sys.argv[1]))["tag_name"])' "$source_update_dir/release.json")
+gh release download "$source_release_tag" --repo Aminark/legado-ios \
+  --pattern '*.ipa' --dir "$source_update_dir"
+python3 scripts/update-altstore-source.py \
+  --ipa "$source_update_dir/legado-ios-v0.1.11-build17-unsigned.ipa" \
+  --release "$source_update_dir/release.json"
+python3 -m unittest discover -s scripts/tests -v
+```
+
+请将示例 IPA 文件名换成实际下载的附件名。脚本会核对包标识、Release 标签与 IPA 版本、文件大小，以及 Release 提供的 SHA-256（如有），避免源指向与本地检查不一致的包。当前生成器针对本项目无扩展、无额外 entitlement 的未签名 IPA；改用签名包、增加扩展或 entitlement 时，需要同步完善权限提取，生成器会拒绝带签名资源、描述文件或扩展的 IPA。
+
+发布后检查固定地址可匿名访问、图标和截图能正常加载，并下载源中 IPA 再核对大小、摘要和版本。客户端的添加源、安装、更新与签名流程需分别实测；源文件校验通过不代表已完成真机安装验证。
+
+格式说明：[AltStore 源规范](https://faq.altstore.io/developers/make-a-source)、[SideStore 源字段](https://sidestore.io/sidestore-source-types/interfaces/Source.html)、[LiveContainer 源用法](https://livecontainer.github.io/docs/guides/sources)。

docs/altstore.json

@@ -0,0 +1,63 @@
+{
+  "name": "小浣熊阅读",
+  "identifier": "com.epiboly.legado.source",
+  "subtitle": "小浣熊阅读官方应用源",
+  "description": "小浣熊阅读的最新正式版，供 AltStore Classic、SideStore 和 LiveContainer 添加。",
+  "sourceURL": "https://raw.githubusercontent.com/Aminark/legado-ios/main/docs/altstore.json",
+  "website": "https://github.com/Aminark/legado-ios",
+  "iconURL": "https://raw.githubusercontent.com/Aminark/legado-ios/main/App/Assets.xcassets/AppIcon.appiconset/AppIcon-1024.png",
+  "tintColor": "#315C50",
+  "apps": [
+    {
+      "name": "小浣熊阅读",
+      "bundleIdentifier": "com.epiboly.legado",
+      "developerName": "Aminark",
+      "subtitle": "搜书快一点，读书舒服一点。",
+      "localizedDescription": "一款优先兼容阅读书源的开源 iOS 阅读器，支持书架、搜索、阅读排版、本地 TXT、语音朗读和 RSS。应用不提供书源或在线书库，书源需自行导入。",
+      "iconURL": "https://raw.githubusercontent.com/Aminark/legado-ios/main/App/Assets.xcassets/AppIcon.appiconset/AppIcon-1024.png",
+      "tintColor": "#315C50",
+      "category": "utilities",
+      "screenshots": [
+        {
+          "imageURL": "https://raw.githubusercontent.com/Aminark/legado-ios/main/docs/images/bookshelf.png",
+          "width": 1206,
+          "height": 2622
+        },
+        {
+          "imageURL": "https://raw.githubusercontent.com/Aminark/legado-ios/main/docs/images/search.png",
+          "width": 1206,
+          "height": 2622
+        },
+        {
+          "imageURL": "https://raw.githubusercontent.com/Aminark/legado-ios/main/docs/images/reader.png",
+          "width": 1206,
+          "height": 2622
+        }
+      ],
+      "versions": [
+        {
+          "version": "0.1.11",
+          "buildVersion": "17",
+          "date": "2026-10-22T03:06:37Z",
+          "localizedDescription": "小浣熊阅读 **0.1.11**，构建号 **17**，支持 **iOS / iPadOS 15.0 及以上**。\n\n## 更新内容\n\n- 修复书架和文件管理中的本地 TXT 文件选择及导入流程，支持 `.txt`、`.TXT` 多选，排除 JSON 书源文件。\n- 保留所选文件访问权限至导入完成，调整取消后重新选择和导入确认的展示流程。\n- 完善深色模式下的主按钮、选中态、阅读菜单、统计卡片和管理页面，改善文字对比度。\n- 调整规则编辑器的语法高亮、光标和工具栏外观。\n- 适配 RSS 正文、登录网页和图片查看页的背景与导航操作，保留书源自定义样式和页面状态。\n\n## 下载安装\n\n下载附件 **`legado-ios-v0.1.11-build17-unsigned.ipa`**，使用自己的签名工具安装。支持 TrollStore 的设备可自行尝试安装；本项目暂不提供 App Store 或 TestFlight 分发。\n\n`Source code (zip / tar.gz)` 是源码压缩包，不能直接安装。`SHA256SUMS` 可用于核对 IPA 完整性。\n\n## 验证与兼容\n\n本次功能代码已通过 300 项核心与页面模型测试、15 项 iOS 测试及 11 个相关 UI 回归用例。IPA 从对应源码重新进行 iPhoneOS Release 构建。\n\nUI 回归在 iOS 18.3 模拟器完成；iOS 15 真机仍未覆盖。如有兼容问题，请在 [Issues](https://github.com/Aminark/legado-ios/issues) 反馈版本、设备、系统及复现步骤。\n\n**小浣熊阅读不提供、内置或分发网络书源，也不提供在线书库；书源需自行导入。**\n",
+          "downloadURL": "https://github.com/Aminark/legado-ios/releases/download/v0.1.11/legado-ios-v0.1.11-build17-unsigned.ipa",
+          "size": 12424247,
+          "minOSVersion": "15.0"
+        }
+      ],
+      "version": "0.1.11",
+      "versionDate": "2026-10-22T03:06:37Z",
+      "versionDescription": "小浣熊阅读 **0.1.11**，构建号 **17**，支持 **iOS / iPadOS 15.0 及以上**。\n\n## 更新内容\n\n- 修复书架和文件管理中的本地 TXT 文件选择及导入流程，支持 `.txt`、`.TXT` 多选，排除 JSON 书源文件。\n- 保留所选文件访问权限至导入完成，调整取消后重新选择和导入确认的展示流程。\n- 完善深色模式下的主按钮、选中态、阅读菜单、统计卡片和管理页面，改善文字对比度。\n- 调整规则编辑器的语法高亮、光标和工具栏外观。\n- 适配 RSS 正文、登录网页和图片查看页的背景与导航操作，保留书源自定义样式和页面状态。\n\n## 下载安装\n\n下载附件 **`legado-ios-v0.1.11-build17-unsigned.ipa`**，使用自己的签名工具安装。支持 TrollStore 的设备可自行尝试安装；本项目暂不提供 App Store 或 TestFlight 分发。\n\n`Source code (zip / tar.gz)` 是源码压缩包，不能直接安装。`SHA256SUMS` 可用于核对 IPA 完整性。\n\n## 验证与兼容\n\n本次功能代码已通过 300 项核心与页面模型测试、15 项 iOS 测试及 11 个相关 UI 回归用例。IPA 从对应源码重新进行 iPhoneOS Release 构建。\n\nUI 回归在 iOS 18.3 模拟器完成；iOS 15 真机仍未覆盖。如有兼容问题，请在 [Issues](https://github.com/Aminark/legado-ios/issues) 反馈版本、设备、系统及复现步骤。\n\n**小浣熊阅读不提供、内置或分发网络书源，也不提供在线书库；书源需自行导入。**\n",
+      "downloadURL": "https://github.com/Aminark/legado-ios/releases/download/v0.1.11/legado-ios-v0.1.11-build17-unsigned.ipa",
+      "size": 12424247,
+      "appPermissions": {
+        "entitlements": [],
+        "privacy": {
+          "NSCameraUsageDescription": "用于扫描书源和净化规则的导入二维码。",
+          "NSPhotoLibraryAddUsageDescription": "用于保存阅读页面中的图片到照片图库。"
+        }
+      }
+    }
+  ],
+  "news": []
+}

scripts/fixtures/SourceImportFixture.swift

@@ -19,6 +19,10 @@ final class FixtureAppDelegate: UIResponder, UIApplicationDelegate {
                 try? data.write(to: documents.appendingPathComponent(name), options: .atomic)
             }
         }
+        for name in ["TXT-Book.txt", "TXT-Uppercase.TXT"] {
+            try? Data("第一章 开始\n这是用于验证本地 TXT 导入的小说正文。\n第二章 后续\n正文继续。".utf8)
+                .write(to: documents.appendingPathComponent(name), options: .atomic)
+        }
         let controller = UIViewController()
         controller.view.backgroundColor = .systemBackground
         let label = UILabel()

scripts/prepare-source-import-fixture.sh

@@ -42,4 +42,4 @@ xcrun --sdk iphonesimulator swiftc -parse-as-library -swift-version 6 \
     -o "$legado_fixture_app/SourceImportFixtures"
 xcrun simctl install "$legado_fixture_device" "$legado_fixture_app"
 xcrun simctl launch --terminate-running-process "$legado_fixture_device" com.epiboly.legado.source-import-fixtures
-printf 'JSON file import fixtures are ready in Files > On My iPhone > 书源导入测试.\n'
+printf 'JSON and TXT import fixtures are ready in Files > On My iPhone > 书源导入测试.\n'

scripts/self-check.sh

@@ -7,9 +7,11 @@ cd "$workspace_dir"
 derived_data_path=${LEGADO_DERIVED_DATA_PATH:-"$workspace_dir/DerivedData"}
 source_packages_path=${LEGADO_SOURCE_PACKAGES_PATH:-"$derived_data_path/SourcePackages"}
 
-echo "[1/5] Validate bundled resources"
+echo "[1/5] Validate bundled resources and application source"
 python3 -m json.tool App/Resources/txtTocRule.json >/dev/null
 python3 -m json.tool App/Resources/httpTTS.json >/dev/null
+python3 -m json.tool docs/altstore.json >/dev/null
+python3 -m unittest discover -s scripts/tests -v
 
 echo "[2/5] Check project and Swift formatting hazards"
 plutil -lint Legado.xcodeproj/project.pbxproj >/dev/null

scripts/tests/test_altstore_source.py

@@ -0,0 +1,131 @@
+import hashlib
+import importlib.util
+import plistlib
+import tempfile
+import unittest
+import zipfile
+from pathlib import Path
+
+
+spec = importlib.util.spec_from_file_location("altstore_source", Path(__file__).parents[1] / "update-altstore-source.py")
+altstore_source = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(altstore_source)
+
+
+class AltStoreSourceTests(unittest.TestCase):
+    def setUp(self):
+        temporary = tempfile.TemporaryDirectory()
+        self.addCleanup(temporary.cleanup)
+        self.ipa = Path(temporary.name) / "reader-unsigned.ipa"
+        self.info = {
+            "CFBundleIdentifier": "com.epiboly.legado",
+            "CFBundleName": "Reader",
+            "CFBundleDisplayName": "小浣熊阅读",
+            "CFBundleShortVersionString": "1.2.3",
+            "CFBundleVersion": "42",
+            "MinimumOSVersion": "15.0",
+            "NSCameraUsageDescription": "扫描导入二维码",
+            "NSPhotoLibraryAddUsageDescription": "保存图片",
+            "NSAppTransportSecurity": {"NSAllowsArbitraryLoads": True},
+        }
+        self.release = {
+            "tag_name": "v1.2.3",
+            "published_at": "2026-10-19T01:02:03Z",
+            "draft": False,
+            "prerelease": False,
+            "body": "更新阅读体验。",
+        }
+        self.write_ipa()
+
+    def write_ipa(self, extra=None):
+        with zipfile.ZipFile(self.ipa, "w") as archive:
+            archive.writestr("Payload/Reader.app/Info.plist", plistlib.dumps(self.info, fmt=plistlib.FMT_BINARY))
+            if extra:
+                archive.writestr(extra, b"fixture")
+        self.release["assets"] = [{
+            "name": self.ipa.name,
+            "state": "uploaded",
+            "size": self.ipa.stat().st_size,
+            "digest": "sha256:" + hashlib.sha256(self.ipa.read_bytes()).hexdigest(),
+            "browser_download_url": "https://github.com/Aminark/legado-ios/releases/download/v1.2.3/reader-unsigned.ipa",
+        }]
+
+    def generate(self):
+        return altstore_source.make_source(self.ipa, self.release, "Aminark/legado-ios", "main")
+
+    def test_metadata_permissions_and_legacy_fields_match_ipa(self):
+        source = self.generate()
+        self.assertEqual(source["sourceURL"], "https://raw.githubusercontent.com/Aminark/legado-ios/main/docs/altstore.json")
+        app = source["apps"][0]
+        version = app["versions"][0]
+        self.assertEqual(app["bundleIdentifier"], self.info["CFBundleIdentifier"])
+        self.assertEqual(version["version"], "1.2.3")
+        self.assertEqual(version["buildVersion"], "42")
+        self.assertEqual(version["minOSVersion"], "15.0")
+        self.assertEqual(version["date"], self.release["published_at"])
+        for key in ("version", "size", "downloadURL"):
+            self.assertEqual(app[key], version[key])
+        self.assertEqual(app["appPermissions"], {
+            "entitlements": [],
+            "privacy": {
+                "NSCameraUsageDescription": "扫描导入二维码",
+                "NSPhotoLibraryAddUsageDescription": "保存图片",
+            },
+        })
+
+    def test_rejects_drafts_and_prereleases(self):
+        for key in ("draft", "prerelease"):
+            with self.subTest(key=key):
+                self.release[key] = True
+                with self.assertRaisesRegex(ValueError, "published stable"):
+                    self.generate()
+                self.release[key] = False
+
+    def test_rejects_wrong_release_asset(self):
+        for key, value in (("size", 1), ("digest", "sha256:wrong"),
+                           ("browser_download_url", "https://example.com/wrong.ipa"),
+                           ("name", "another.ipa"), ("state", "new")):
+            with self.subTest(key=key):
+                self.write_ipa()
+                self.release["assets"][0][key] = value
+                with self.assertRaises(ValueError):
+                    self.generate()
+
+    def test_older_github_metadata_without_digest_is_supported(self):
+        del self.release["assets"][0]["digest"]
+        self.assertEqual(self.generate()["apps"][0]["version"], "1.2.3")
+
+    def test_rejects_packages_needing_an_entitlement_audit(self):
+        for extra in ("Payload/Reader.app/_CodeSignature/CodeResources",
+                      "Payload/Reader.app/embedded.mobileprovision",
+                      "Payload/Reader.app/PlugIns/Widget.appex/Info.plist"):
+            with self.subTest(extra=extra):
+                self.write_ipa(extra)
+                with self.assertRaisesRegex(ValueError, "entitlement audit"):
+                    self.generate()
+
+    def test_rejects_unresolved_build_metadata(self):
+        self.info["CFBundleVersion"] = "$(CURRENT_PROJECT_VERSION)"
+        self.write_ipa()
+        with self.assertRaisesRegex(ValueError, "CFBundleVersion"):
+            self.generate()
+
+    def test_rejects_release_and_package_mismatches(self):
+        self.info["CFBundleIdentifier"] = "com.example.another-app"
+        self.write_ipa()
+        with self.assertRaisesRegex(ValueError, "bundle identifier"):
+            self.generate()
+        self.info["CFBundleIdentifier"] = "com.epiboly.legado"
+        self.info["CFBundleShortVersionString"] = "1.2.4"
+        self.write_ipa()
+        with self.assertRaisesRegex(ValueError, "Release tag"):
+            self.generate()
+
+    def test_rejects_publication_dates_without_a_timezone(self):
+        self.release["published_at"] = "2026-10-19T01:02:03"
+        with self.assertRaisesRegex(ValueError, "timezone"):
+            self.generate()
+
+
+if __name__ == "__main__":
+    unittest.main()

scripts/update-altstore-source.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+"""Generate the AltStore/SideStore source from a published release's unsigned IPA."""
+
+import argparse
+import hashlib
+import json
+import plistlib
+import re
+import zipfile
+from datetime import datetime
+from pathlib import Path
+from urllib.parse import quote
+
+
+def make_source(ipa: Path, release: dict, repository: str, branch: str) -> dict:
+    if release.get("draft") or release.get("prerelease"):
+        raise ValueError("Only published stable releases belong in this source")
+    date = release["published_at"]
+    if datetime.fromisoformat(date.replace("Z", "+00:00")).tzinfo is None:
+        raise ValueError("Release publication date must include a timezone")
+    assets = [asset for asset in release["assets"] if asset["name"] == ipa.name]
+    if len(assets) != 1 or assets[0].get("state") != "uploaded":
+        raise ValueError("IPA must match exactly one uploaded release asset")
+    asset = assets[0]
+    if ipa.stat().st_size != asset["size"]:
+        raise ValueError("IPA size differs from the published release asset")
+    digest = asset.get("digest")
+    if digest and digest != "sha256:" + hashlib.sha256(ipa.read_bytes()).hexdigest():
+        raise ValueError("IPA checksum differs from the published release asset")
+
+    with zipfile.ZipFile(ipa) as archive:
+        names = archive.namelist()
+        info_paths = [name for name in names if re.fullmatch(r"Payload/[^/]+\.app/Info\.plist", name)]
+        if len(info_paths) != 1:
+            raise ValueError("Expected exactly one app in Payload")
+        if any("/_CodeSignature/" in name or name.endswith("/embedded.mobileprovision")
+               or ".appex/" in name for name in names):
+            raise ValueError("Use an unsigned IPA without extensions; signed apps need an entitlement audit")
+        info = plistlib.loads(archive.read(info_paths[0]))
+    for key in ("CFBundleIdentifier", "CFBundleShortVersionString", "CFBundleVersion", "MinimumOSVersion"):
+        if not isinstance(info.get(key), str) or not info[key] or "$(" in info[key]:
+            raise ValueError(f"IPA has an invalid or unresolved {key}")
+    if info["CFBundleIdentifier"] != "com.epiboly.legado":
+        raise ValueError("IPA bundle identifier does not belong to this app")
+    if release["tag_name"] != "v" + info["CFBundleShortVersionString"]:
+        raise ValueError("Release tag does not match the IPA version")
+
+    website = f"https://github.com/{repository}"
+    download_url = f"{website}/releases/download/{quote(release['tag_name'], safe='')}/{quote(ipa.name, safe='')}"
+    if asset["browser_download_url"] != download_url:
+        raise ValueError("Release asset URL does not match the repository, tag and IPA name")
+    raw_url = f"https://raw.githubusercontent.com/{repository}/{quote(branch, safe='')}"
+    icon_url = f"{raw_url}/App/Assets.xcassets/AppIcon.appiconset/AppIcon-1024.png"
+    version = {
+        "version": info["CFBundleShortVersionString"],
+        "buildVersion": info["CFBundleVersion"],
+        "date": date,
+        "localizedDescription": release.get("body") or release.get("name") or release["tag_name"],
+        "downloadURL": download_url,
+        "size": asset["size"],
+        "minOSVersion": info["MinimumOSVersion"],
+    }
+    return {
+        "name": "小浣熊阅读",
+        "identifier": "com.epiboly.legado.source",
+        "subtitle": "小浣熊阅读官方应用源",
+        "description": "小浣熊阅读的最新正式版，供 AltStore Classic、SideStore 和 LiveContainer 添加。",
+        "sourceURL": f"{raw_url}/docs/altstore.json",
+        "website": website,
+        "iconURL": icon_url,
+        "tintColor": "#315C50",
+        "apps": [{
+            "name": info.get("CFBundleDisplayName") or info["CFBundleName"],
+            "bundleIdentifier": info["CFBundleIdentifier"],
+            "developerName": repository.split("/")[0],
+            "subtitle": "搜书快一点，读书舒服一点。",
+            "localizedDescription": "一款优先兼容阅读书源的开源 iOS 阅读器，支持书架、搜索、阅读排版、本地 TXT、语音朗读和 RSS。应用不提供书源或在线书库，书源需自行导入。",
+            "iconURL": icon_url,
+            "tintColor": "#315C50",
+            "category": "utilities",
+            "screenshots": [
+                {"imageURL": f"{raw_url}/docs/images/{name}.png", "width": 1206, "height": 2622}
+                for name in ("bookshelf", "search", "reader")
+            ],
+            "versions": [version],
+            "version": version["version"],
+            "versionDate": date,
+            "versionDescription": version["localizedDescription"],
+            "downloadURL": download_url,
+            "size": asset["size"],
+            "appPermissions": {
+                "entitlements": [],
+                "privacy": {key: value for key, value in info.items()
+                            if key.startswith("NS") and "UsageDescription" in key},
+            },
+        }],
+        "news": [],
+    }
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--ipa", required=True, type=Path)
+    parser.add_argument("--release", required=True, type=Path, help="GitHub REST release JSON")
+    parser.add_argument("--repository", default="Aminark/legado-ios")
+    parser.add_argument("--branch", default="main", help="Branch hosting the source and images")
+    parser.add_argument("--output", type=Path, default=Path("docs/altstore.json"))
+    args = parser.parse_args()
+    try:
+        source = make_source(args.ipa, json.loads(args.release.read_text(encoding="utf-8")),
+                             args.repository, args.branch)
+    except (ValueError, KeyError, OSError, zipfile.BadZipFile) as error:
+        parser.error(str(error))
+    args.output.parent.mkdir(parents=True, exist_ok=True)
+    args.output.write_text(json.dumps(source, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    print(f"Generated {args.output} from {args.ipa.name}")
+
+
+if __name__ == "__main__":
+    main()