Under the Sun · 本地增强服务 2.0.2
=====================================

这是「完整模式」才需要的可选组件。
只装插件也能用 RSS + AI + 日报，不影响。


一、安装前先确认
----------------
1. Obsidian 里已经装好 Under the Sun 插件，并且启用了
2. 电脑是 Mac（这个组件目前只支持 macOS）

如果插件还没装：
  打开 Obsidian → 设置 → 第三方插件 → 关闭「受限模式」
  → 点「浏览」→ 搜索 Under the Sun → 安装并启用


二、安装（只需要点一个文件）
----------------------------
双击本文件夹里的：

  ① 双击我安装.command

然后会弹出一个黑色窗口。不要怕，它在复制文件，不是出错。

窗口里会问你一个问题（只有找到多个笔记库时才会问）：

  找到多个笔记库，请选一个（输入数字后按回车）：
    1) /Users/你的用户名/Documents/我的笔记库
    2) /Users/你的用户名/Documents/工作笔记
    选择：

输入 1 或 2，按回车。

如果只找到一个笔记库，它不会问，直接继续。

之后等待 1–3 分钟，看到这一行就成功了：

  安装完成 ✓


三、程序装在哪里
----------------
固定装在这里，不需要你选：

  /Users/你的用户名/Library/Application Support/UnderTheSun/backend

为什么放这里：
  macOS 不允许后台程序读取「下载」「桌面」「文稿」里的文件。
  放在上面这个位置，开机自动启动才能正常工作。

装完之后，解压出来的这个安装文件夹可以整个删掉，
不影响使用（程序已经复制到上面的位置）。


四、如果 macOS 不让打开
-----------------------
提示「无法打开，因为无法验证开发者」或「Apple 无法验证」，
这是苹果对没有花钱签名的软件的统一拦截，不是病毒。

方法一（推荐）：
  右键点「① 双击我安装.command」→ 选「打开」→ 再点「打开」

方法二：
  苹果菜单 → 系统设置 → 隐私与安全性
  → 拉到最下面 → 点「仍要打开」
  → 再双击一次

方法三（终端）：
  1. 打开「启动台」，搜索 终端，点开
  2. 输入 cd 加一个空格：cd 
  3. 把本文件夹拖进终端窗口，按回车
  4. 输入下面这行，按回车：
       ./①\ 双击我安装.command


五、装完怎么确认
----------------
1. 打开 Obsidian
2. 点左侧的报纸图标，打开 Under the Sun 主页
3. 拉到最下面，看到：

     本地增强服务  v2.0.2 · 已连接

就说明成功了。
如果显示「未连接」，等 30 秒，或重启一次 Obsidian。


六、安装失败怎么办
------------------
安装器会自己检查。失败时它会：

  1. 显示「安装没有完成」
  2. 说明原因
  3. 打印最近几十行日志
  4. 停止刚装的后台服务，避免它反复重启

需要帮助时，把这一个文件发给作者：

  /Users/你的用户名/Library/Application Support/UnderTheSun/backend/logs/backend.log

常见原因：
  - 网络不通，装不上 Python 依赖
  - 8765 端口被别的程序占用
  - 安装目录没有写入权限

手动检查服务状态（会打字的话）：

  curl -s http://127.0.0.1:8765/health

正常会返回：
  {"ok": true, "version": "2.0.2", "api": 1}


七、卸载
--------
打开「终端」，依次输入下面三行，每行按回车：

  launchctl bootout gui/$(id -u)/com.0xtack.underthesun.backend
  rm ~/Library/LaunchAgents/com.0xtack.underthesun.backend.plist
  rm -rf ~/Library/Application\ Support/UnderTheSun

插件本身在 Obsidian 里卸载：
  设置 → 第三方插件 → Under the Sun → 卸载


八、装完会得到什么
------------------
- 每天 07:00 和 19:00 自动抓取热榜和新闻（可在插件里改时间）
- 日报写到笔记库的：朝闻天下/日报/
- 跟踪笔记写到：朝闻天下/跟踪/
- 电脑关机或睡眠时不会运行，开机后等下一个时间点
