docs: rewrite

Update apple-intelligence-and-siri.mdx Update siri-and-search.mdx Update apple-tv.mdx Update .gitmodules Delete siri Delete tv
NSRingo · Nov 14, 2024 · 3d9f698 · 3d9f698
1 parent ffd46ef
commit 3d9f698
Show file tree

Hide file tree

Showing 6 changed files with 300 additions and 16 deletions.
diff --git a/.gitmodules b/.gitmodules
@@ -1,9 +1,3 @@
-[submodule "wiki/siri"]
-	path = wiki/siri
-	url = https://github.com/NSRingo/Siri.wiki.git
-[submodule "wiki/tv"]
-	path = wiki/tv
-	url = https://github.com/NSRingo/TV.wiki.git
 [submodule "wiki/geo-services"]
 	path = wiki/geo-services
 	url = https://github.com/NSRingo/GeoServices.wiki.git
diff --git a/docs/guide/Siri/apple-intelligence-and-siri.mdx b/docs/guide/Siri/apple-intelligence-and-siri.mdx
@@ -1,6 +1,5 @@
 import { ModuleInstall } from "@theme";
 import _Footer from "../_Footer.md";
-import Siri from "@wiki/siri/🟥-Apple智能与Siri.md";
 
 # 🟥 Apple 智能与 Siri
 
@@ -21,5 +20,33 @@ Siri 区分「Siri 请求」和「Siri 建议」两部分
 
 :::
 
-<Siri />
+## Siri 请求 (Siri Requests)
+### 简介
+  * 保持模块启用,即可将「Siri 请求」改为国际版
+
+  * 注:
+    * 「Siri 请求」的网络搜索结果直接来源于`guzzoni.smoot.apple.com`,可以通过 MitM 改写请求
+
+### 使用说明
+todo
+
+## Siri 建议 (Siri Suggestions)
+### 简介
+
+
+### 使用说明
+
+
+### 功能列表
+
+
+### 配置方法
+
+
+### 安装链接
+
+
+### 更新日志
+
+
 <_Footer />
diff --git a/docs/guide/Siri/siri-and-search.mdx b/docs/guide/Siri/siri-and-search.mdx
@@ -1,6 +1,5 @@
-import { ModuleInstall } from "@theme";
+import { Steps, ModuleInstall } from "@theme";
 import _Footer from "../_Footer.md";
-import Siri from "@wiki/siri/⭕-Siri与搜索.md";
 
 # ⭕ Siri 与搜索
 
@@ -12,6 +11,11 @@ Siri 区分「询问 Siri」和「Siri 建议」两部分
 
 :::
 
+## 询问 Siri (Ask Siri)
+> ⚠️「询问 Siri」所使用的`guzzoni.apple.com`，不可以通过 MitM 改写请求。
+
+## Siri 建议 (Siri Suggestions)
+
 :::danger ‼️ 已失效
 
  以通过推送安全响应更新  
@@ -20,6 +24,110 @@ Siri 区分「询问 Siri」和「Siri 建议」两部分
 
 :::
 
+### 简介
+  * 激活「Siri建议/来自APPLE的内容/来自APPLE的建议」并开启全部已知可用功能。
+
+### 解锁步骤
+* 如启用本模块后未立刻生效，可按照下列步骤激活「来自APPLE的内容\来自APPLE的建议\Siri建议」:
+    <Steps>
+      ### 第 1 步
+      启用[`📍 定位`](./GeoServices/location) + [`⭕ Siri 与搜索`](./Siri/siri-and-search)两个模块
+      > [`📍 定位`](./GeoServices/location)的地区不可以设置为`🇨🇳CN`  
+      > [`⭕ Siri 与搜索`](./Siri/siri-and-search)的地区不可以设置为`🇨🇳CN`  
+      > 可辅以`全局代理`确保稳定  
+
+      ### 第 2 步
+      打开`✈️飞行模式`，同时保持`Wi-Fi`或`有线网络`连接
+      > * 未装有 SIM 卡的 iOS/iPadOS/macOS 设备，可省略`✈️飞行模式`相关步骤。  
+      > * 装有 SIM 卡的 iOS/iPadOS 设备，也可通过`卡贴`或`海外 SIM 卡`的方式，绕过基于 SIM 卡的 `MCC/MNC` ([移动设备网络代码](https://zh.wikipedia.org/wiki/移动设备网络代码))检测。  
+
+      ### 第 3 步
+      重新冷启动一次`地图` app
+      * 指后台无`地图`应用时，重开`地图`app
+      > * 在 `Loon` 的`仪表`-`最近请求`或 `Surge` 的`工具`-`最近请求`或 `Quantumult X` 的`网络活动`中应观察到:  
+      > 1. `检测设备信息`的 `https://configuration.ls.apple.com/config/defaults` 链接  
+      > 2. `基于网络的地区检测`的 `https://gspe1-ssl.ls.apple.com/pep/gcc` 链接，且流量抓取结果不是`CN`  
+      > 3. 获取`Siri建议`配置下发的`https://api.smoot.apple.com/bag`或`https://api.smoot.apple.cn/bag`链接
+
+      ### 第 4 步
+      执行一次Spotlight搜索，测试「来自APPLE的内容\来自APPLE的建议\Siri建议」是否正常工作
+      > * 如未生效，可尝试以下方法进行激活操作:
+      >   * 重启设备 (必定触发一次Siri配置文件下发检测)
+      >     * 注意开启VPN的`开机自启`等相关功能，以便第一时间截取到下发的配置文件链接
+      >   * macOS上关闭再开启`系统偏好设置`-`聚焦`-`Siri建议`
+      >   * iOS上关闭再开启`设置`-`Siri与搜索`-`来自APPLE的内容`和`来自APPLE的建议`
+      >   * 更改`设置`-`通用`-`语言与地区`-`地区`
+      >   * 等待半小时，「Siri建议」会根据`基于网络的地区检测`结果向服务器`*.smoot.apple.com/bag`请求刷新区域设置与功能可用状态
+
+      ### 第 5 步
+      关闭`✈️飞行模式`，正常使用「来自APPLE的内容\来自APPLE的建议\Siri建议」
+      关闭[`📍 定位`](./GeoServices/location)模块
+      * 关闭[`📍 定位`](./GeoServices/location)模块为非必需步骤
+      * 取决于是否还需要激活 [📰 News](./apple-news) 等功能
+    </Steps>
+
+### 使用方式
+* 基础: 直接使用
+  * 采用[默认配置](#默认设置)
+* 进阶: 配合`Loon`设置面板或`Surge`参数设置功能进行个性化设置
+  * 提供一定的自定义设置，如`数据源`选择、`需要替换的供应商`选择等
+* 高级: 配合`BoxJs`及订阅使用
+  <details>
+  <summary>ℹ️ 用前须知：使用`BoxJs`进行配置将被视为专业用户，官方不受理因使用`BoxJs`配置导致的各种问题</summary>
+
+  1. 安装`BoxJs`插件并更新引用资源或脚本:
+     * 安装方法及下载链接详见: [🧰 BoxJs](./box-js)
+  2. 在`BoxJs`的配置面板中进行个性化设置:
+     1. 浏览器访问[BoxJs.com](http://boxjs.com)
+     2. 在[`应用`](http://boxjs.com/#/app)页面点开` iRingo`折叠
+     3. 在[`⭕ Siri`](http://boxjs.com/#/app/iRingo.Siri)根据需要填写您的设置信息
+  </details>
+
+### 功能列表
+* 在以下位置及功能中可用:
+  - [x] 聚焦搜索(Spotlight)
+  - [x] 查询(Look Up)
+  - [x] Safari浏览器(Safari)
+    - [x] 视觉搜索(Visual Look Up)
+    - [x] 智能历史记录
+  - [x] 地图(Apple Maps)
+  - [x] 新闻(Apple News)
+  - [ ] 询问Siri(Ask Siri)
+    - [x] 无SIM卡设备可被[`📍定位`](../../GeoServices/wiki/📍-定位)模块修改切换至海外版(维基百科)
+    - [ ] SIM卡设备会因「MCC / MNC」检测回退至国内版(百度百科)
+  - [x] 照片
+    - [x] 视觉搜索(Visual Look Up)
+  - [x] 电话
+  - [x] 家庭
+  - [x] 日历
+  - [x] 提醒事项
+  - [x] 通讯录
+  - [x] 信息
+  - [x] 邮件
+* 启用的功能:
+  - [x] 来自APPLE的内容(CONTENT FROM APPLE)
+  - [x] 来自APPLE的建议(SUGGESTIONS FROM APPLE)
+  - [x] Siri建议(Siri Suggestions)
+* 已知可用的信息卡片:
+  - [x] 天气 (搜索关键词`城市名 天气`或`天气 城市名`，例如`天气 上海`，不是所有城市都有天气搜索结果)
+  - [x] Siri资料(Siri Knowledge)  截图:[macOS](../blob/main/images/screenshot/Siri%20Knowledge%20-%20Spotlight%20-%20macOS.png?raw=true "Siri Knowledge - Spotlight - macOS")
+  - [x] Siri建议的网站(Siri Suggested Websites)
+  - [x] 维基百科 (macOS端需要Surge启用“增强模式”)
+  - [ ] 地图 (当地图为中国区时不显示内容，有知道解决方法或成因的请联系我)
+  - [x] 体育  截图:[macOS](../blob/main/images/screenshot/Sports%20-%20Spotlight%20-%20macOS.png?raw=true "Sports - Spotlight - macOS") / [iOS](./ScreenShots/Sports%20-%20Spotlight%20-%20iOS.jpeg?raw=true "Sports - Spotlight - iOS")
+  - [x] 股票  截图:[macOS](../blob/main/images/screenshot/Stock%20-%20Spotlight%20-%20macOS.png?raw=true "Stock - Spotlight - macOS")
+  - [x] 航班  截图:[macOS](../blob/main/images/screenshot/Flights%20-%20Spotlight%20-%20macOS.png?raw=true "Flights - Spotlight - macOS")
+  - [x] App Store\Mac App Store  截图:[macOS](../blob/main/images/screenshot/Mac%20App%20Store%20-%20Spotlight%20-%20macOS.png?raw=true "Mac App Store - Spotlight - macOS") / [iOS](../blob/main/images/screenshot/App%20Store%20-%20Spotlight%20-%20iOS.jpeg?raw=true "App Store - Spotlight - iOS")
+  - [x] 电影 & 电视节目
+    - [x] tv  截图:[macOS](../blob/main/images/screenshot/tv%20-%20Spotlight%20-%20macOS.png?raw=true "tv - Spotlight - macOS")
+    - [x] iTunes
+  - [x] 音乐
+    - [x] Apple Music  截图:[macOS](../blob/main/images/screenshot/Apple%20Music%20-%20Spotlight%20-%20macOS.png?raw=true "Apple Music - Spotlight - macOS") / [iOS](../blob/main/images/screenshot/Apple%20Music%20-%20Spotlight%20-%20iOS.jpeg?raw=true "Apple Music - Spotlight - iOS")
+    - [x] iTunes
+  - [x] 新闻
+  - [ ] Twitter集成 (官方功能列表中有此功能，有知道解决方法或成因的请联系我)
+
+### 安装链接
 <ModuleInstall urlPrefix="https://github.com/NSRingo/Siri/releases/latest/download/">
   <ModuleInstall.Tab type="loon">
     <ModuleInstall.Item
@@ -78,5 +186,39 @@ Siri 区分「询问 Siri」和「Siri 建议」两部分
     </ModuleInstall.Item>
   </ModuleInstall.Tab>
 </ModuleInstall>
-<Siri />
+
+### 更新日志
+* v3.1.0
+  * 优化与修复
+    1. 移除 NanoCat-Me 的 URL polyfill, 改为 Web API 的 URL 
+* v3.0.0
+  * 优化与修复
+    1. 重构代码
+    2. 修复bug
+* v2.1.5
+  * 优化与修复
+    1. 更新环境设置(setENV)功能，增加配置文件和缓存读取方法
+    2. 修复argument配置方法
+    3. 更新数据库(DataBase)格式
+    4. 更新脚本结束($done)方式
+* v2.1.2
+  * 优化与修复
+    1. 修复「国家或地区代码」的“自动”选项在某些地区设置下不生效的问题
+* v2.1.1
+  * 优化与修复
+    1. 增加兼容方案，Quantumult X商店版现在可以使用
+* v2.1.0
+  * 优化与修复
+    1. 更新环境设置(setENV)功能
+    2. 修复Surge的argument配置方法
+* v2.0.0
+  * 更新功能
+    1. 新增BoxJs面板支持，可以精确控制Siri功能
+    2. 增加开启Safari智能历史记录功能
+    3. 增加开启 [视觉搜索](https://support.apple.com/zh-cn/guide/iphone/iph37fdd714b/ios)(看图查询) 功能([效果预览1](https://t.me/GetSomeFriesChannel/65), [效果预览2](https://t.me/GetSomeFriesChannel/96))
+    4. 其他新增设置项，详见BoxJs设置面板
+    5. 兼容系统设置中的自定义地区设置(自定义货币，计量单位等）
+  * 优化与修复
+    1. 同步来自🍿️ [DualSubs](https://t.me/GetSomeFriesChannel/61) 的代码结构和逻辑
+
 <_Footer />
diff --git a/docs/guide/apple-tv.mdx b/docs/guide/apple-tv.mdx
@@ -1,6 +1,5 @@
-import { ModuleInstall } from "@theme";
+import { Steps, ModuleInstall } from "@theme";
 import _Footer from "./_Footer.md";
-import TV from "@wiki/tv/Home.md";
 
 # 📺 TV
 
@@ -10,6 +9,72 @@ import TV from "@wiki/tv/Home.md";
 
 :::
 
+## 简介
+* 自定义TV app的功能、板块与栏目、及语言支持。
+
+## 解锁步骤
+* 如启用本模块后重新打开`Apple TV`未见生效，可按照下列步骤激活:
+    <Steps>
+      ### 第 1 步
+      启用[`📺 TV`](./apple-tv)模块
+      打开`TV`app (app又名: `TV`或`视频`)
+
+      ### 第 2 步
+      观察是否存在下列特征:
+      * iOS/iPadOS: 
+        * iOS 17.2 前:
+          * 观察`立即观看`页面是否有`儿童`一个二级入口
+          * 观察标签栏是否为`立即观看`、`原创内容`、`商店`、`体育节目`、`资料库`五个标签页
+        * iOS 17.2 后:
+          * `立即观看`被`主页`代替，顶端采用动态展示栏，此特征失效
+          * 标签栏固定为`主页`、`原创内容(Apple TV+)`、`商店`、`资料库`、`搜索`五个标签页，此特征失效
+      * macOS/tvOS: 查看标签栏是否有`立即观看`、`tv+`、`商店`、`体育节目`、`儿童`、`资料库`六个标签页按钮
+      > 此项目的目的是为了解锁其他地区地区账号的功能，不建议美区账号用户使用  
+      > 如您的账号已经是美区账号，则可能启用前后并无差异  
+
+      ### 第 3 步
+      如不存在上述特征，可尝试以下操作强制刷新配置文件:
+      打开`TV app`(`TV`或`视频`)
+      点击右上角头像
+      点击`退出登录`
+      重新输入`Apple ID`与`密码`登入
+      > 此时应在`Surge`的`最近请求`或`Quantumult X`的`网络活动`中观察到:  
+      > `TV app`的`https://uts-api.itunes.apple.com/uts/v3/configitions`链接  
+
+      ### 第 4 步
+      如没有请冷启动一次`TV`app (app又名: `TV`或`视频`)
+    </Steps>
+
+## 功能列表
+* 混合区域支持
+  * 默认混合账号所在区(`立即观看`、`电影`)，新加坡(`tv+`、`原创内容`、`搜索`、`人物`)，美国(`电视节目`、`体育节目`、`儿童`)三个地区的内容
+    * 港澳台地区账号，拥有tv+订阅的，可以收看美区tv+的`体育节目`直播内容（如最新内置的MLB联赛直播）
+    * 转区的账号，可以通过修改`影片详情页`观看之前所在地区购买的电影等内容（如A区购买的电影，在B区未上架）
+    * 语言和字幕有地区限制的内容，可以通过修改`影片详情页`观看中文字幕的版本（如某账号在美区购买电影无中字，但是同ID的影片在港澳台地区提供中字，可以通过将`影片详情页`改为港澳台后播放获得中文字幕）
+* 多语言支持
+  * 底部标签栏与栏目入口语言自适应（目前仅适配`简体中文`、`繁体中文`、`英语`，如需更多语言适配请PR或提供翻译文本）
+  * 影片详情页语言自动回退
+    * 可自定义语言优先级，默认顺序为`简体中文（新加坡）` => `繁体中文（台湾）` => `英语（美国）`
+* 解除客户端平台限制
+  * 为macOS、Android TV、Web版`TV app`启用第三方供应商(如: Disney+,Prime Video等)影片库和服务集成
+* 硬件及平台
+  - [x] macOS
+  - [x] iPad
+  - [x] iPhone
+  - [x] Apple TV (需Surge for macOS的`网关模式`或Loon的`代理服务器`等) 
+  - [ ] Android TV (需Surge for macOS的`网关模式`或Loon的`代理服务器`等) (Android TV效果待测试，不确定是否可用)
+  - [ ] Web(待测试，不确定是否可用)
+* 分类页面
+  - [x] 立即观看
+  - [x] TV+（iOS/iPadOS版客户端为`原创内容`）
+  - [x] 商店 (`电影`、`电视节目`为`商店`二级菜单)
+  - [x] 体育节目 (macOS版客户端无关注「喜爱的球队」功能和显示比分功能)
+  - [x] 儿童 (iOS版客户端为`立即观看`二级菜单)
+  - [x] 资料库
+  - [x] 搜索
+
+## 安装链接
+
 <ModuleInstall
   urlPrefix="https://github.com/NSRingo/TV/releases/latest/download/"
   urls={{
@@ -20,5 +85,63 @@ import TV from "@wiki/tv/Home.md";
     shadowrocket: "TV.srmodule",
   }}
 />
-<TV />
+
+## 更新日志
+* v3.0.0
+  * 优化与修复
+    1. 重构代码
+    2. 修复bug
+* v2.1.0-request
+  * 优化与修复
+    1. 优化域名匹配方法，精简逻辑和代码量
+* v2.0.8-request
+  * 优化与修复
+    1. 补充`搜索`页面匹配规则
+    2. 补充`其他`页面匹配规则
+    3. 补充`原创内容`页面匹配规则
+    4. 修复`语言代码`数据库
+* v2.0.7-request
+  * 优化与修复
+    1. 补充`频道`页面匹配规则
+    2. 更新`标签页`标题数据库
+    3. 更新`模块`匹配规则和图标
+    4. 补充`其他`页面匹配规则
+* v2.0.3-response
+  * 更新功能
+    1. 新增`标签栏`与`板块入口`按钮语言自适应更改功能
+* v2.0.6-request
+  * 优化与修复
+    1. 增加`语言代码`数据库
+    2. 增加`语言代码`改写功能
+    3. 补充`影片详情`页面匹配规则
+* v2.0.5-request
+  * 优化与修复
+    1. 补充`原创内容`页面匹配规则
+    2. 补充`体育节目`页面匹配规则
+    3. 新增`搜索`页面匹配规则
+    4. 新增`待播清单`页面匹配规则
+    5. 补充`频道`页面匹配规则
+* v2.0.4-request
+  * 优化与修复
+    1. 修复`地区代码`的`自动`选项
+    2. 修复`待播清单`页面匹配规则
+    3. 补充`喜爱`功能匹配规则
+    4. 补充`人物`页面匹配规则
+    5. 补充`其他`页面匹配规则
+* v2.0.3-request
+  * 优化与修复
+    1. 新增`商店代码`数据库
+    2. 新增`商店代码`修改功能
+* v2.0.1
+  * 更新功能
+    1. 新增BoxJs面板支持，可以精确控制`TV app`功能
+    2. 增加开启第三方影片库功能
+    3. 增加自定义板块与栏目入口功能
+    4. 增加自定义每个板块与栏目地区功能
+    5. 其他新增设置项，详见BoxJs设置面板
+  * 优化与修复
+    1. 采用全新的环境变量设置(setENV)功能来存储设置、缓存和配置
+    2. 支持全新的argument配置方法，支持深路径配置写入
+    3. 采用`请求`与`回复`脚本分离的设计方式，缩短运行时间
+
 <_Footer />
diff --git a/wiki/siri b/wiki/siri
diff --git a/wiki/tv b/wiki/tv