NewspaperDownloader for macOS（便携版）
====================================

Thank you for using NewspaperDownloader.


一、文件结构
-----------

解压后的目录应类似如下：

- NewspaperDownloader.app
- Setup.command
- ...

请确保 `Setup.command` 和 `NewspaperDownloader.app` 在同一个文件夹内，不要单独移动其中任何一个文件。


二、首次使用（推荐）
------------------

1. 打开解压后的文件夹。
2. 双击运行：`Setup.command`

    - 如果系统提示 “无法打开，因为来自未识别的开发者”：
      1) 用触控板两指点按（或右键）`Setup.command`
      2) 选择 **“打开”**
      3) 在弹出的对话框中选择 **“打开”**

3. `Setup.command` 会自动执行以下操作：
   - 尝试移除 `NewspaperDownloader.app` 上的 macOS 安全隔离（quarantine）标记
   - 弹出提示框：**“已完成设置，正在启动…”**
   - 自动启动 `NewspaperDownloader.app`

4. 之后使用：
   - 您可以直接双击 `NewspaperDownloader.app` 或子产品对应的.app应用程序
   - 如有需要，也可以再次运行 `Setup.command`，不会产生副作用


三、直接打开 App 时遇到安全提示怎么办？
--------------------------------------

如果您跳过 `Setup.command`，直接双击 `NewspaperDownloader.app`，可能会看到类似提示：

- “NewspaperDownloader.app cannot be opened because the developer cannot be verified”
- “无法打开，因为来自未验证的开发者”

此时建议按照以下方式处理其中一种：

方式 A：使用 Setup.command 处理（推荐）
------------------------------------
1. 回到应用所在文件夹
2. 双击运行 `Setup.command`
3. 按照第二部分的步骤执行
4. 完成后再直接双击 `NewspaperDownloader.app` 打开

方式 B：通过“隐私与安全性”放行（可选）
------------------------------------
1. 双击 `NewspaperDownloader.app`，出现安全提示后选择“取消”
2. 打开 **系统设置 → 隐私与安全性（Privacy & Security）**
3. 在页面下方找到类似信息：
   - “已阻止使用 ‘NewspaperDownloader.app’，因为其开发者无法验证”
4. 点击 **“仍要打开”** 或类似按钮，然后再次确认打开


四、卸载 / 删除
---------------

NewspaperDownloader 为便携版应用，不会在系统中安装额外组件。

如果不再使用，直接删除整个解压后的文件夹即可（包括 `NewspaperDownloader.app`、`Setup.command`、日志及下载文件等）。


五、注意事项
------------

1. 请在常规用户目录中使用，例如：
   - 桌面（Desktop）
   - 文稿（Documents）
   - 下载（Downloads）
   不建议直接放在 `/Applications` 或系统级只读目录中运行未签名的便携应用。

2. 如果您在命令行中运行应用，请确认当前路径为解压后的真实目录，而不是系统的临时 AppTranslocation 路径（通常路径中会含有 `AppTranslocation` 字样）。

3. 本应用未经过 App Store/公证签名，属于开发者面向高级用户的便携工具，仅用于个人学习与研究使用。


如果在 macOS 上启动或使用过程中遇到问题，请记录报错信息或截图，并反馈给开发者以便排查。
