prts-terrarchive 0.2.0

package/README.md

@@ -0,0 +1,423 @@
+# prts-terrarchive
+
+PRTS.chat 为 DeepSeek Harness（DSH）提供的资料插件：把《明日方舟》与
+《明日方舟：终末地》的游戏原文、档案，以及社区审校 Wiki、实体图鉴与《泰拉年表》
+装进本地资料包，为 Agent 提供带原文行号的检索与引用工具，并可按需接入
+PRTS.chat 云端混合检索与 DSH 原生网页工具。
+
+[中文](README.md) | [English](README.en.md)
+
+## 这是什么
+
+本插件为 DSH 提供明日方舟与终末地联合资料检索能力。插件先从 PRTS.chat 取得已批准的
+最新 release 与逐文件摘要，再从 ModelScope 镜像或 PRTS.chat 下载本地语料；
+Agent 可以离线检索并按原文行号阅读材料；可选的 PRTS.chat 云端混合检索用于发现
+候选材料，并将结果映射回本地原文核验。由于云端服务承载能力有限，当前为每个用户
+每日提供 1000 次 DSH 匿名云端检索调用额度；额度策略可能根据实际运行情况调整。
+
+- **本地检索**：`corpus_search` 用同一组参数同时检索两款游戏，
+  支持游戏、资料类型、内容形式、角色、活动／任务、Wiki 字段等结构化过滤；
+- **原文阅读**：`corpus_read` 可按关卡代号、密录名、角色资料类别直接定位，
+  并可连续阅读整个明日方舟活动或终末地任务；引用格式统一为《篇章名》第 N 行；
+- **活动时间线**：`timeline_search` 检索 PRTS Wiki《泰拉年表》本地投影，
+  支持实体别名自动裂变与出处标记反查；
+- **云端混合检索**：双模块模式下一次 `cloud_search` 默认并行查询两款游戏的图谱、档案、
+  原文与 Wiki，联合排序后映射回本地篇章；
+
+## 数据来源声明
+
+- **自建 Wiki 数据**：来源于 [littlepangding/arknights_lore_wiki](https://github.com/littlepangding/arknights_lore_wiki)。
+- **《泰拉年表》数据**：来源于 [PRTS Wiki《泰拉年表》](https://prts.wiki/w/%E6%B3%B0%E6%8B%89%E5%B9%B4%E8%A1%A8)，供本插件的时间线检索使用。
+
+## 核心特性
+
+| 特性 | 说明 |
+| --- | --- |
+| 按需加载 | 工具只挂在「PRTS 模式」预设下，标准/极简等模式不受污染 |
+| 双游戏资料 | 明日方舟与终末地原文、档案、审校 Wiki、实体与时间线使用统一工具检索 |
+| 读取去重 | 会话级证据状态跟踪已进入模型上下文的原文，重复/重叠读取自动回放或只补读新行 |
+| 自带皮肤 | Harness 默认 / PRTS Agent / Endfield AIC / 莱茵生命资料馆 |
+
+## 莱茵生命资料馆
+
+在 **设置 → 插件 → PRTS 语料 → 界面皮肤** 选择「莱茵生命资料馆」，然后在会话中打开
+「资料馆」。检索阵列、调查板、重点证据盒和双层档案架位于同一个三维场景。
+可用底部导航、边缘入口或点击可见模型切换，镜头连续移动。
+
+- **检索阵列**保留候选资料；**档案架**收录 Agent 实际读过或用户主动收藏的资料，每页上下两层、每层十二份。
+- **重点证据盒**属于指定调查板，用于暂存待核对、待整理的材料；放入盒子不会自动标成已读，也不必先收藏。
+- **调查板**由 Agent 持续添加线索与关系，中央保留带版本的报告。新建还是延续调查由 LLM 通过调查工具决定，追问不会机械地创建新板。
+- 纸片支持拖动、缩放、红绳连线与手动编辑。编辑沿用同款纸色和编号，自动保存并支持撤销；板面数据由 Host 持久化。
+- 手动检索支持本地与云端模式及高级设置。阅读器支持 Markdown、来源版本、命中位置与实际已读范围；返回时恢复原入口、筛选和阅读位置。
+- 手动浏览会暂停 Agent 自动跟随，点击「恢复跟随」后继续。用户查看的板、Agent 工作板和证据盒目标分别管理。
+
+长文分页、档案架分页、减少动态效果和无 WebGL 时的文字阅读模式均可用。
+操作细节见 [资料馆说明](docs/rhine-lab.md) 与 [交互与资料分层](docs/rhine-interaction-flow.md)。
+
+前端沿用 Three.js + TypeScript + Vite。三维主体、档案循环导航与渲染使用原项目实现和
+默认画质；主界面按调查用途重新设计，原版演示档案已全部移除。开发预览读取本地真实资料包，不连接 Agent：
+
+```bash
+npm ci
+npm run build:rhine
+npm run preview:rhine
+```
+
+打开 `http://127.0.0.1:4177`。可通过 `PRTS_RHINE_RELEASES=/path/to/releases` 指定只读资料包目录。
+直接预览证据白板：`http://127.0.0.1:4177/?rhineView=board`。
+语法检查使用 `npm run check`，测试使用 `npm test`；浏览器检查使用 `npm run test:rhine:browser`（需要 Playwright）。
+
+## 环境要求
+
+- Web：Node.js **≥ 22.19**，DSH 运行时 **≥ 0.1.2-alpha.2**；当前适配目标为 **0.1.7-rc.2**
+- 官方 Electron Desktop：使用与插件兼容的 DSH 桌面版本；桌面自带运行时
+- 磁盘空间：语料大小以设置页与 release 清单为准，下载前不会自动占用完整语料空间
+
+## 安装
+
+### Web 本地安装
+
+可以从本地源码安装，或使用已内置插件的 PRTS Portable：
+
+```bash
+npm install --global @deepseek-ai/dsh@0.1.7-rc.2
+git clone https://github.com/HTian-qwq/prts-terrarchive.git
+cd prts-terrarchive
+node bin/install.js web
+```
+
+本地安装器把插件加入指定 profile。DSH `0.1.7` 起由插件直接注册「PRTS 模式」；
+旧版 DSH 仍创建或迁移 `$DSH_HOME/.agent-presets/prts` 中的兼容预设。省略第二个参数时使用当前插件目录，也可以传入另一个本地目录或压缩包：
+
+```bash
+node bin/install.js web /path/to/prts-terrarchive
+```
+
+### Web：从 npm 安装
+
+可直接从 npm 安装插件 bundle，无需额外运行安装脚本：
+
+```bash
+dsh plugin --profile web add prts-terrarchive@0.2.0
+```
+
+重启 `dsh web` 后，DSH `0.1.7` 起由插件注册「PRTS 模式」，禁用或卸载插件时
+自动撤销；默认模式和正在运行的普通会话保持不变。新版不读取旧的
+`$DSH_HOME/.agent-presets/prts` 文件。若曾自定义旧预设，请在新版的模式配置中手动迁移；
+旧文件会保留。旧版 DSH 继续使用文件模板，已有用户修改不会被覆盖。npm 安装不执行 `postinstall`。
+
+```bash
+dsh plugin --profile web remove prts-terrarchive
+```
+
+### 官方 Electron Desktop
+
+适用于兼容 DSH `0.1.7` 插件接口的 Electron Desktop。在 **桌面应用的插件管理窗口** 输入
+`prts-terrarchive@0.2.0` 安装，随后选用「PRTS 模式」。官方桌面只接受 npm registry
+包名和版本，不接受 GitHub 地址、本地目录或 tarball；其 `desktop` profile 由应用管理，
+不要运行 `node bin/install.js desktop` 或 `dsh plugin --profile desktop`。
+
+Web 与官方桌面共享默认的 `$DSH_HOME` 用户资料，但各自安装插件。插件包包含界面、地图
+模型、贴图、技能和预设，**不包含语料、Node/DSH 运行库或用户数据**。首次使用请在
+「设置 → 插件 → PRTS 语料」自行下载语料，切换皮肤无需另下模型和贴图。
+
+PRTS Portable 发行包预装插件、预设和完整语料，解压后无需另行下载语料。
+官方 Electron 便携版使用 `build-electron.ps1` 构建，原 WebView2 构建入口继续保留，
+详见 [Portable 仓库](https://github.com/HTian-qwq/prts-terrarchive-portable)。
+
+Portable 打包器已放置插件时，仍可使用 `node bin/install.js web --preset-only` 生成或迁移
+兼容预设；该选项不调用 DSH CLI。
+
+### Windows
+
+Web 本地安装需要可用的 `dsh.cmd`。安装器经 cmd.exe 调用它，插件路径含换行或
+`%` `!` `&` `|` `<` `>` `^` `"` 时会明确报错，请改用不含这些字符的目录。
+`DSH` 环境变量可指定 `dsh.cmd` 的绝对路径。官方 DSH 的语料默认保存到
+`%USERPROFILE%\.dsh\prts-corpus\releases`；Portable 的会话和设置保存在发行目录的
+`userdata`，语料及后续资料更新保存在 `corpus/releases`。
+
+## 安装后：五步上手
+
+1. **重启** `dsh web` 或所用桌面应用；
+2. **设置 → 插件 →「PRTS 语料」**：选择皮肤（Harness 默认 / PRTS Agent / Endfield AIC / 莱茵生命资料馆）；皮肤模型、贴图与字体已随插件包安装；
+3. **版本管理**：Portable 已附带完整语料；其他安装方式下载双游戏资料（优先 ModelScope 镜像；大小以设置页与当前 release
+   清单为准）。未安装资料时
+   PRTS 模式仍可进入；调用本地工具会提醒前往本设置页安装；
+4. **新建会话，顶部模式下拉选「PRTS 模式」**；
+5. 直接用自然语言提问，或让模型调用下列工具。
+
+## PRTS 模式的工具面
+
+| 来源 | 工具 | 用途 |
+| --- | --- | --- |
+| dsh-base（所有模式共有） | bash/sandbox 等 | 常规 Agent 能力，本插件不裁剪 |
+| 本插件 | `corpus_search` | 本地语料 grep 检索与目录浏览 |
+| 本插件 | `corpus_read` | 按玩家可见定位器或自然标题读取官方行号原文 |
+| 本插件 | `corpus_i18n` | 终末地官方多语言原文查询、名称与档案对照 |
+| 本插件 | `timeline_search` | 活动时间线检索 / 出处反查 |
+| 本插件 | `cloud_search` / `cloud_inspect` | PRTS.chat 云端混合检索（默认匿名会话） |
+| `@deepseek-ai/dsh-tool-web` | `web_search` / `web_fetch` | 公网检索与已知 URL 精读核验 |
+| `@deepseek-ai/dsh-tool-skill` | skill 加载器 | 按需加载检索策略技能 |
+| 本插件 | `prts-retrieval` 技能 | 检索配方与字段语义（按需注入，不占 system prompt） |
+
+## 工具详解
+
+### corpus_i18n — 终末地官方多语言查询
+
+使用带本地化附件的终末地资料包（插件 0.2.0 起支持）：
+
+```js
+corpus_i18n({query: "管理员，你来了。", languages: ["EN", "JP", "KR"]})
+corpus_i18n({title: "<检索结果的完整标题>", line: 1, languages: ["EN"]})
+```
+
+也可用已有 `document_uid` 替代标题。名称/原句默认精确匹配，片段可加 `match_mode:"literal"`；外语反查加 `source_language:"EN"`。返回官方字典中的文本及来源，默认不显示内部文本 ID；显式设 `include_ids:true` 才返回字符串 ID，供 `text_ids` 精确复查。空译文、未映射来源、未安装附件分别报告，不自动生成译文。
+
+角色档案按整条记录、档案库按内容块返回，中文行号只是来源定位，不表示各语言分段相同。长记录会分页，原样提交 `page.continuation` 即可续查。旧资料包仍可搜索和阅读；多语言附件须随新资料版本安装。
+
+构建方式和数据格式见 [官方多语言工具](docs/endfield-official-i18n.md)。
+
+### corpus_search — 本地语料检索
+
+像 grep 一样搜索本地语料；命中立即返回原行及上下各一行，按文档归并。`query` 使用
+短实体名、篇章展示名或原句片段；也可省略 `query`，仅按过滤条件列出资料入口。
+
+| 参数 | 说明 |
+| --- | --- |
+| `query` | 搜索词（≤512 码点）；在 NFKC 归一化 + 小写后的文本上匹配 |
+| `games` | 可选游戏过滤；省略时同时搜索 `arknights` 与 `endfield` |
+| `resource_types` | 资料类型过滤（数组内 OR）；明日方舟与终末地可选值见下文 |
+| `content_types` | 内容形式，例如 `dialogue`、`cutscene`、`radio`、`sns_chat` |
+| `collection_names` | 明日方舟活动名或终末地任务名，使用同一个字段 |
+| `match_mode` | `literal`（默认，连续字面匹配）/ `regex`（线性安全子集：字面量、`^`/`$`、`.`、字符类、转义和固定次数 `{n}`；不支持分组、分支及可变量词） |
+| `character_names` / `story_names` / `activity_names` | 角色 / 篇章 / 活动展示名过滤 |
+| `entity_names` | 只返回出现指定实体的行（自动展开别名） |
+| `speakers` | 结构化说话人过滤，只匹配亲口台词 |
+| `wiki_sections` | Wiki 标签字段过滤（相关活动、剧情总结、角色剧情概括等 16 种） |
+| `context_terms` | 要求命中附近（±3 行）同时出现的语境词，≤8 个 |
+| `after` | 下一页的版本绑定可读锚点 `{ data_version, resource_type, title, position }`；与原搜索条件一起原样提交 |
+
+约束：过滤数组每项非空、最多 16 项、单项最长 512 码点。结果预算固定，
+保留原搜索条件，并把返回的 `next_after` 原样放入 `after`，可确定性扫描到
+`exhausted=true`。锚点使用完整 `data_version`、资料类型和自然标题；资料版本切换后
+旧锚点会被拒绝，必须重新搜索。分页不向模型暴露内部签名串。
+
+**明日方舟资料类型（resource_types）**：`story` 官方剧情原文；`character_profile` 档案/招聘/
+潜能；`character_module` 模组；`character_voice` 语音；`character_skin` 时装；
+`operator_record` 干员密录；`character_bundle` 指定角色的档案+模组+语音+密录；
+`character_wiki` 规范角色 Wiki；`story_wiki` 活动/密录 Wiki；
+`character_activity_wiki` 角色×活动辅助 Wiki；`reviewed_wiki` 全部自建 Wiki；
+`terra_journey` 大地巡旅；`entity_profile` 实体资料；`reference` 时间线等引用资料。
+
+**终末地资料类型**：`original_story` 官方剧情原文；`archive` 官方档案；
+`knowledge` 知识资料；`wiki` 整理性 Wiki；`character_story` 角色故事；
+`timeline` 时间线资料；`entity_profile` 实体资料。可配合 `content_types` 区分对话、
+过场、广播、通讯、环境对话、SNS 等内容形式。
+
+### corpus_read — 原文阅读
+
+优先使用游戏内关卡代号、密录名、角色名、活动名或任务名；无法稳定定位时再使用搜索返回的完整标题。
+不使用内部 `document_id`、ref 或路径。搜索结果只在同名歧义时给出公开稳定的 `document_uid`；它替代 `title`，不得同时提交两者。同名多合集不会自动合并。
+
+| 用法 | 参数 |
+| --- | --- |
+| 明日方舟关卡 | `stage_code`；同代号多篇时加 `story_part`：`before` / `after` / `story`；加 `line` 可定点读上下文 |
+| 干员密录 | `character_name` + `record_name`；多段密录加 `segment` |
+| 角色官方资料 | `character_name` + `material`，类别为 `profile/module/voice/skin/recruitment/potential` |
+| 双模块同名角色消歧 | 在角色定位参数之外加 `game: "arknights"` 或 `game: "endfield"`；无同名歧义时不填 |
+| 整活动连续阅读 | `activity_name` + `mode: "activity"` |
+| 终末地任务连续阅读 | `collection_name` + `mode: "collection"`，可选 `content_types` |
+| 其他资料定点上下文 | `title` + `line` |
+| 读 Wiki 字段 | `title` + `section`（精确读取标签字段，不含标签行） |
+| 分页读其他全文 | `title` + `mode: "document"`（`max_lines` 默认 100、上限 500；`max_chars` 默认 12000、上限 100000） |
+| 同名单篇 | `document_uid` + `line`，或 `document_uid` + `mode: "document"`；不再提交 `title` |
+| 续读 | 原样提交 `page.continuation`；单篇使用 `line`，活动/任务使用版本绑定的 `position`；旧 `cursor` 仅兼容历史会话 |
+
+每次读取只选一种主定位方式。`max_lines/max_chars` 只限制输出量，不能代替 `line`、`section` 或 `mode`。
+
+重复读取与部分补读保持正常的预算和续页位置。部分补读会用 `coverage` 标明本页复用的上文行及新返回行；全文是否读完仍以 `page.has_more` 为准。
+
+引用格式统一为「《篇章名》第 N 行」。剧情文档只返回请求的原文；剧情总结与活动
+时间线必须通过 `timeline_search` 或 Wiki 字段显式检索，不自动夹带。
+
+### timeline_search — 活动时间线
+
+按活动名、年份及自动展开的实体别名检索活动时间线（PRTS Wiki《泰拉年表》本地投影）。
+
+| 参数 | 说明 |
+| --- | --- |
+| `query` | 可选的事件正文短语（≤200 字符） |
+| `activity_names` | 活动展示名（≤20 项，如「孤星」；接受主线章节号常见写法） |
+| `entity_names` | 角色/实体展示名（≤20 项，自动经别名图鉴裂变后检索） |
+| `year_start` / `year_end` | 年份范围（含端点，可单独使用） |
+| `source_marker` | 反查模式：原样传回结果中的「年表出处:tle_…」标记，返回该事件完整来源 |
+| `max_results` | 最多返回事件数，默认 20、上限 100 |
+
+### cloud_search / cloud_inspect — 云端混合检索（可选）
+
+用自然语言查询 PRTS.chat 云端的图谱、档案、原文、自建 Wiki 和时间线组合索引。
+默认走**匿名会话**（内置 PoW 挑战，无需账号），也可在设置页配置静态 token。
+返回末尾的「## 可读取原文」列出已映射到本地篇章的完整标题与行号，直接按
+`title + line` 调用 `corpus_read` 核验。`cloud_inspect` 用于复查最近一次云端
+检索的状态（回答材料、候选、诊断），`request_id` 由运行时自动注入。
+
+本地资料尚未安装或无法读取时，云端答案仍会返回，并提示本地原文映射不可用；安装或修复资料包后可继续核验原文。
+
+### web_search / web_fetch — DSH 原生网页工具
+
+由 PRTS 模式挂载：`web_search` 发现网页候选，`web_fetch` 读取已知 URL 正文，
+用于语料之外的历史沿革、词源、民俗等公网信息核验。DSH `0.1.2-alpha.1` 起的匿名
+HTTP provider 只允许公网 HTTP(S)，并包含 DNS 解析校验、连接地址固定、同源重定向
+以及响应大小和超时限制。
+
+## 检索配方
+
+Wiki 资料不是无差别文本池：工具会区分规范角色页、活动/密录页和角色×活动辅助页。
+常见问题的组合方式：
+
+```text
+凯尔希参加过哪些活动？
+  → corpus_search({ resource_types: ["character_wiki"],
+                     character_names: ["凯尔希"], wiki_sections: ["相关活动"] })
+
+凯尔希在《孤星》里做了什么？
+  → corpus_search({ resource_types: ["story_wiki"], activity_names: ["孤星"],
+                     wiki_sections: ["角色剧情概括"], query: "凯尔希" })
+
+1102 年 1 月发生了什么？
+  → timeline_search({ year_start: 1102, year_end: 1102 })
+
+某人亲口说过什么？
+  → corpus_search({ speakers: ["阿米娅"], query: "博士" })
+```
+
+完整字段语义与更多配方见 `skills/prts-retrieval/references/wiki-schema.md`
+与 `retrieval-recipes.md`（模型通过 `prts-retrieval` 技能按需读取）。
+
+## 资料与配置
+
+- 默认资料目录：`$DSH_HOME/prts-corpus/releases`；用户配置：`$DSH_HOME/prts-corpus.json`
+- 配置分三层：内置默认值 ← `cordis.patch.yml` 行内 config ← 用户文件（设置页写入，立即生效）
+- 版本检查固定请求 `https://prts.chat` 的 `current`；release、pack 和逐分片摘要均以
+  PRTS.chat 为信任源，不能被配置改到其他站点。ModelScope 与可配置回退站点只提供
+  该固定 release 的压缩字节；
+  文件写入前校验大小和 SHA-256，同一 release 的并发准备由跨进程锁合并
+- 设置页通过 Harness Connection 认证 RPC 访问 Host；修改配置后云端工具热注册/注销
+
+读取或搜索期间切换资料版本时，请求会返回可重试的 `PACKAGE_VERSION_MISMATCH`，
+重新定位到当前版本后再调用即可。旧任务不会回写新版本的正文或倒排缓存，缓存复用
+及跨篇章读取也受同一版本检查约束。
+
+**可配置项**（`$DSH_HOME/prts-corpus.json`，设置页可视化编辑）：
+
+| 键 | 默认 | 说明 |
+| --- | --- | --- |
+| `uiSkin` | `harness` | 皮肤：`harness` / `prts-agent` / `endfield-aic` / `rhine-lab` |
+| `cloudEnabled` | 裸插件 `false`；官方 PRTS preset `true` | 云端工具开关；安装器生成的 PRTS 模式默认启用匿名云端检索 |
+| `cloudBaseUrl` | `https://prts.chat` | 云端地址（https，或仅环回主机的 http） |
+| `cloudToken` | 空 | 静态 Bearer token；留空使用匿名 PoW 会话 |
+| `cloudGame` | `all` | `all`（一次检索两款游戏）/ `arknights` / `endfield` |
+| `enabledGames` | `["arknights","endfield"]` | 本地与云端工具允许检索的模块；单模块可只保留其中一项，新会话会装配对应 Skill |
+| `cloudUserId` | 空 | 匿名会话的稳定用户标识 |
+| `cloudTimeoutMs` | `90000` | 云端请求超时（1000–600000） |
+| `cloudMaxResponseBytes` | 32 MiB | 云端响应上限（1 KiB–64 MiB） |
+| `downloadSiteBaseUrl` | `https://prts.chat` | 仅作为校验哈希后的字节回退站点；不参与选版或签发摘要 |
+| `downloadOrder` | `["modelscope","site"]` | 下载源顺序 |
+| `cacheShards` | `24` | 正文分片 LRU 缓存大小（1–128） |
+
+静态 token 绑定保存时的服务源（协议、主机和端口），不会随基础配置或用户配置中的地址变化发送给其他源。旧用户配置若尚无源绑定，请在设置页的令牌框重新输入并保存一次；旧值保留在文件中，重新保存前不会用于请求。只改同源 URL 路径不影响已绑定 token。
+
+若在 preset 的 `prts-corpus.config.enabledGames` 设置基础范围，也应把相同数组传给相邻的 `prts-terrarchive/skill` entry；安装器生成和迁移的官方 PRTS preset 已自动保持两者一致。用户配置文件中的 `enabledGames` 会同时覆盖两边，修改后请新建会话以装配新的模块说明。
+
+实体检索提示会在 `prts-retrieval` Skill 加载后，按当前用户问题写入 DSH 动态上下文快照；新快照会取代旧快照。PRTS 段只列出当前搭载的资料模块、当前问题命中的规范实体与游戏归属，以及与本轮实体相关的再旅者关系。工具调用标题会同时标明本地或云端资料及检索的游戏范围。
+
+**内存说明**：新版资料包附带轻量 `document_catalog`，启动只从目录建立篇章定位、
+标题、别名和检索元数据；正文分片在读取或命中后才解压，并由 `cacheShards` 限制缓存
+数量。旧资料包仍兼容，但首次初始化需要扫描其正文分片。Node/V8 可能保留已申请的
+堆页，因此操作系统看到的常驻内存不会在查询结束后立即回落。
+
+## 皮肤
+
+设置 → 插件 → PRTS 语料中选择：
+
+- **Harness 默认**：不改动宿主外观；
+- **PRTS Agent**：PRTS 终端风格界面；
+- **Endfield AIC**：明日方舟：终末地终端风格，含 3D 地图。所需运行代码、模型与贴图已预压缩并随插件包安装，切换皮肤不会触发额外下载。
+- **莱茵生命资料馆**：保留 RhineLabUI 原版循环档案阵列，加入 Agent 调查板、重点证据盒、双层分页档案架、本地／云端检索、阅读和摘录。开发时运行 `npm run build:rhine` 和 `npm run preview:rhine`。
+- **Agent 回看与协作提醒**：`investigation_get` 可以分页回看线索正文、报告、档案架和重点证据盒，也能按来源 ID 读取保存的正文。手动收藏会同步到会话存储，旧浏览器收藏自动补入。用户新增或修改材料后，运行中的 Agent 在下一次推理时收到提醒，空闲时留到下次对话；只有成功读取对应内容才标为已查看，浏览器查看不会消除提醒。用法见 [调查工作流](skills/prts-investigation/SKILL.md)。
+
+Endfield AIC 的插件代码、UI 集成与地图渲染实现采用 MIT License；其中使用的游戏衍生模型与贴图不属于 MIT 授权范围，仅作为该可选皮肤的组成部分随包提供。具体文件范围见 [GAME_ASSETS.md](GAME_ASSETS.md)。这与「版本管理」下载的语料相互独立：语料按需从 ModelScope 下载，皮肤资源无需另行下载。
+
+## 开发
+
+```bash
+npm run check        # 全部源码语法检查
+npm test             # node --test 全量测试；语料集成用例需本地 data/releases，否则自动跳过
+git diff --check     # 检查待提交文本
+```
+
+真实网络下载脚本 `test/real-download.mjs` 不在默认测试集中，避免单元测试意外
+下载大型资料。
+
+**目录结构**：
+
+```text
+src/
+  index.js               插件入口：工具注册、配置装配、云端热重载
+  search.js              corpus_search 执行层（候选预筛、扫描、签名游标分页）
+  search-projection.js   搜索结果的模型可见投影与渲染
+  read.js                corpus_read 执行层（单篇/活动/终末地任务连续阅读）
+  timeline.js            timeline_search 执行层（别名裂变、年份交集、出处反查）
+  store.js               资料包只读访问层（1/2/3-gram 倒排、旧包短词回退、分片 LRU）
+  wiki.js                Wiki 文档角色与标签字段解析
+  entity-recognizer.js   实体别名 Aho-Corasick 自动机
+  evidence-state.js      会话级证据状态（读取覆盖去重、上下文可见性判定）
+  cloud.js               云端客户端（匿名 PoW 会话、静态 token、限流）
+  cloud-projection.js    云端结果的模型可见投影
+  source-map.js          云端证据 → 本地篇章映射
+  installer.js           资料下载器（双源回退、SHA-256 校验、跨进程锁）
+  state.js               三层配置与共享状态
+  ui.js                  设置页 API（Connection RPC）与静态资源
+  skill.js               prts-retrieval 技能注册
+lib/
+  client.js              Web 客户端入口（皮肤生命周期、设置 UI 席位）
+  skins/common.css       插件公共控件样式（始终加载）
+  skins/prts-agent.css   PRTS Agent 独立皮肤（仅启用时加载）
+  skins/endfield-aic.css Endfield AIC 独立皮肤（仅启用时加载）
+  endfield-map/          终末地皮肤地图资源（brotli/gzip 预压缩）
+bin/
+  install.js             一键安装器
+  pack-map-assets.mjs    地图资源压缩打包脚本
+contracts/               工具请求/响应 JSON Schema
+skills/prts-retrieval/   检索策略技能（字段语义、检索配方）
+presets/                 PRTS 模式声明及旧版用户预设初始化
+```
+
+## 兼容性
+
+DSH `0.1.2-alpha.1` 与 `0.1.2-alpha.2`（web profile）已完成历史真机验证；其中
+`alpha.1` 通过官方 tag 构建并完成安装、预设解析、宿主启动、设置路由和客户端 bundle
+加载检查。当前插件适配目标为 DSH `0.1.7-rc.2`，共享 Connection Fetch 通道支持
+Web 与官方 Electron 源码实现；Web 同时保留 HTTP 路由。新版声明式预设与
+旧版文件预设均通过本项目单元测试；`0.1.7-rc.2` 的完整 Host 启动及 Windows Electron 实机端到端验证仍待完成。
+Electron 便携版默认固定 `0.1.7-rc.2` 官方 tag；旧 Electron 构建入口仍固定
+`0.1.5-alpha.1`，原 WebView2 构建固定 `0.1.3-alpha.1`。发行版仍需通过 Windows 上的真实 Host 冒烟。
+
+旧版自定义部署若关闭 `includeUserRoot` 且没有其它 `trust: user` 的预设目录，插件不会写入
+预设或更改 roots；部署者需先启用用户预设功能。插件依赖宿主内部接口（`ctx.tools`、
+`agent/pre-step`、Connection Fetch、agent 预设、客户端 slots/theme）；DSH 大版本升级后
+请按「安装 → 重启 → 设置页 → PRTS 模式 → 语料工具 → 网页工具 → 皮肤 → 版本热切换」
+过一遍冒烟。
+
+## 许可证与第三方内容
+
+本项目按以下边界提供和授权内容：
+
+- **原创代码与文档**：采用 [MIT License](LICENSE)。
+- **游戏相关内容**：《明日方舟》《明日方舟：终末地》相关名称、商标、图像、模型、贴图、游戏数据及其他游戏素材不属于 MIT 授权范围，其权利归各自权利人所有。终末地皮肤所携带资源的具体范围见 [GAME_ASSETS.md](GAME_ASSETS.md)。
+- **语料数据**：完整语料不随 Git 仓库或插件代码分发；用户通过插件下载的 PRTS.chat
+  资料集适用 [明日方舟资料集](https://modelscope.cn/datasets/HTiantian/prts-agent-corpus-arknights)
+  与 [终末地资料集](https://modelscope.cn/datasets/HTiantian/prts-agent-corpus-endfield)
+  页面标明的许可证、来源声明和使用条款，不因本项目采用 MIT License 而改变。
+
+本项目为非官方社区项目，与相关游戏的开发商、发行商及其关联方不存在隶属、赞助或背书关系。完整声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,61 @@
+# Third-Party Notices
+
+## Scope of the MIT License
+
+Unless otherwise stated, the original source code and documentation in this repository are licensed under the MIT License in [`LICENSE`](LICENSE).
+
+The MIT License does not apply to third-party names, trademarks, artwork, images, models, textures, game data, corpus data, or other materials identified below. Nothing in this repository grants permission to use those materials beyond rights granted by their respective rights holders or by applicable law.
+
+## Arknights and Arknights: Endfield
+
+Arknights, Arknights: Endfield, their names, trademarks, characters, artwork, images, models, textures, game data, and other game-related materials belong to their respective rights holders.
+
+The game-derived models and textures used by the optional Arknights: Endfield skin are excluded from this repository's MIT License. The affected packaged files are listed in [`GAME_ASSETS.md`](GAME_ASSETS.md). The original plugin source code, UI code, and map-rendering implementation remain licensed under the MIT License unless a file states otherwise.
+
+PRTS.chat and prts-terrarchive are unofficial community projects. They are not affiliated with, endorsed by, sponsored by, or otherwise officially connected with the developers or publishers of Arknights or Arknights: Endfield.
+
+## Corpus datasets
+
+The complete corpus datasets are not included in this Git repository or in the bundled plugin code. The plugin first obtains the current release identity and file digests from PRTS.chat; users may then explicitly download the digest-bound bytes from the listed ModelScope mirrors, with PRTS.chat as a fallback byte source:
+
+- [PRTS.chat Arknights corpus](https://modelscope.cn/datasets/HTiantian/prts-agent-corpus-arknights)
+- [PRTS Arknights: Endfield corpus](https://modelscope.cn/datasets/HTiantian/prts-agent-corpus-endfield)
+
+Downloaded datasets retain their upstream licenses and notices, including the source declarations below and those on the corresponding ModelScope dataset pages. This repository's MIT License does not relicense corpus data.
+
+## PRTS Wiki: Terra timeline (泰拉年表)
+
+Timeline data comes from [PRTS Wiki's 泰拉年表](https://prts.wiki/w/%E6%B3%B0%E6%8B%89%E5%B9%B4%E8%A1%A8), authored by the editors identified in its [revision history](https://prts.wiki/index.php?title=%E6%B3%B0%E6%8B%89%E5%B9%B4%E8%A1%A8&action=history), under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/). PRTS.chat extracts and structures event data and groups it by activity for retrieval. The source chronology is inferred from game stories and may contain errors or unfinished content; that limitation also applies to the processed data. This use does not imply endorsement by PRTS Wiki.
+
+The PRTS-authored timeline material retains its CC BY-NC-SA 4.0 license; the independent plugin code remains under this repository's MIT License. Quoted game-original content retains its respective rights, as described above.
+
+## Self-built Wiki: arknights_lore_wiki
+
+Self-built Wiki data is sourced from [littlepangding/arknights_lore_wiki](https://github.com/littlepangding/arknights_lore_wiki). Its original material is covered by the [upstream MIT License](https://github.com/littlepangding/arknights_lore_wiki/blob/main/LICENSE), Copyright (c) 2025 littlepangding. Quoted game text and other third-party material retain their respective rights.
+
+## Other third-party software and assets
+
+Dependencies and other third-party components remain subject to their own licenses. Their inclusion or use does not change those licenses.
+
+## Rhine Lab archive browser
+
+The optional `rhine-lab` skin adapts the archive interaction and uses the original
+`archive-cassette.glb` and `archive-assembly.glb` from [LBEILC/RhineLabUI](https://github.com/LBEILC/RhineLabUI)
+(source revision `e313777`). Its program code is MIT, Copyright (c) 2026 LBEILC;
+the notice is preserved in `lib/rhine/licenses/RhineLabUI-MIT.txt`.
+The upstream README explicitly excludes GLB models and original-work visual
+materials from that MIT grant. `lib/rhine/assets/*.glb` retain
+those upstream restrictions and the rights of the original rights holders.
+This package does not relicense that model, the Rhine Lab identity, or game lore.
+The packaged skin does not include upstream audio or PV footage. Four unmodified MiSans fonts
+are included with their upstream copyright notice and license in `lib/rhine/fonts/NOTICE.txt`
+and `lib/rhine/fonts/MiSans-license.pdf`. Rolling Number 0.4.1 retains its MIT license
+in `lib/rhine/licenses/rolling-number-MIT.txt`.
+
+The bundled Three.js runtime is MIT, Copyright © 2010–2026 three.js authors;
+its license is preserved in `lib/rhine/licenses/three-MIT.txt`.
+
+Research report formatting uses [markdown-it](https://github.com/markdown-it/markdown-it)
+15.0.1 and its bundled dependencies. Their MIT and BSD notices are preserved in
+`lib/rhine/licenses/markdown-it-MIT.txt`, `entities-BSD-2-Clause.txt`, `linkify-it-MIT.txt`,
+`mdurl-MIT.txt`, `punycode.js-MIT.txt`, and `uc.micro-MIT.txt` in that directory.

package/bin/bake-rhine-details.mjs

@@ -0,0 +1,34 @@
+// Run with .node22/bin/node. Produces version-bound normal/coverage data, no GL.
+import { readFile, writeFile } from 'node:fs/promises';
+import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
+import { createArrayDetail } from './rhine-detail-baker.ts';
+import { detailSignature } from '../ui/rhine/original/detail-signature.ts';
+const bytes = await readFile(new URL('../lib/rhine/assets/archive-cassette.glb', import.meta.url));
+const asset = await new GLTFLoader().parseAsync(bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength), '');
+asset.scene.updateMatrixWorld(true);
+const mesh = asset.scene.getObjectsByProperty('isMesh', true).find(mesh => mesh.material.name.startsWith('Internal_Ceramic'));
+const source = mesh.geometry.clone().applyMatrix4(mesh.matrixWorld).scale(1, 1, 1), indices = [], position = source.attributes.position;
+for (let i = 0; i < source.index.count; i += 3) {
+  const vertices = [source.index.getX(i), source.index.getX(i + 1), source.index.getX(i + 2)];
+  if (vertices.every(v => position.getZ(v) > 0.22)) indices.push(...vertices);
+}
+source.setIndex(indices);
+const bake = createArrayDetail('Array_Interior_Lettering', source, mesh.material);
+if (!bake) throw new Error('The shallow lettering could not be baked');
+const { width, height, data } = bake.texture.image;
+const runs = [];
+let previous = -1, count = 0;
+for (let i = 0; i < data.length; i += 4) {
+  const value = (data[i] + data[i + 1] * 256 + data[i + 2] * 65536 + data[i + 3] * 16777216) >>> 0;
+  if (value !== previous && count) { runs.push(count, previous); count = 0; }
+  previous = value; count++;
+}
+if (count) runs.push(count, previous);
+bake.geometry.computeBoundingBox();
+const bounds = bake.geometry.boundingBox;
+const payload = { signature: detailSignature(source), width, height, sourceTriangles: indices.length / 3,
+  min: bounds.min.toArray(), max: bounds.max.toArray(), runs };
+await writeFile(new URL('../ui/rhine/original/array-detail-data.ts', import.meta.url),
+  '// Generated by bin/bake-rhine-details.mjs from archive-cassette.glb.\nexport default ' + JSON.stringify(payload) + ';\n');
+console.log({ signature: payload.signature, width, height, textureBytes: data.byteLength, encodedRuns: runs.length / 2 });
+bake.geometry.dispose(); bake.material.dispose(); bake.texture.dispose(); source.dispose();