prts-terrarchive

prts-terrarchive

PRTS.chat 为 DeepSeek Harness（DSH）提供的资料插件：把《明日方舟》与 《明日方舟：终末地》的游戏原文、档案，以及社区审校 Wiki、实体图鉴与《泰拉年表》 装进本地资料包，为 Agent 提供带原文行号的检索与引用工具，并可按需接入 PRTS.chat 云端混合检索与 DSH 原生网页工具。

中文 | English

这是什么

本插件为 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。
• 《泰拉年表》数据：来源于 PRTS Wiki《泰拉年表》，供本插件的时间线检索使用。

核心特性

特性 · 说明 自由组合 · PRTS 模式继承标准模式的完整能力；创造模式可将 PRTS 工具加入任意自定义模式 双游戏资料 · 明日方舟与终末地原文、档案、审校 Wiki、实体与时间线使用统一工具检索 读取去重 · 会话级证据状态跟踪已进入模型上下文的原文，重复/重叠读取自动回放或只补读新行 自带皮肤 · Harness 默认 / PRTS Agent / Endfield AIC / 莱茵生命资料馆

莱茵生命资料馆

在 设置 → 插件 → PRTS 语料 → 界面皮肤 选择「莱茵生命资料馆」，然后在会话中打开 「资料馆」。检索阵列、调查板、重点证据盒和双层档案架位于同一个三维场景。 可用底部导航、边缘入口或点击可见模型切换，镜头连续移动。

调查板工具与调查技能仅在「莱茵生命资料馆」皮肤下启用。其他皮肤直接在对话中检索和回答，不会要求建板或把回答只存入板内报告。同一 PRTS 会话切换皮肤后会更新工具，无需新建对话；切出莱茵不会删除已保存的线索、报告或档案，切回后可继续查看。

• 检索阵列保留候选资料；档案架收录已交付给 Agent 的资料或用户主动收藏的资料，分别保留已读和引用状态，每页上下两层、每层十二份。
• 重点证据盒属于指定调查板，用于暂存待核对、待整理的材料；放入盒子不会自动标成已读，也不必先收藏。
• 调查板由 Agent 持续添加线索与关系，中央保留带版本的报告。新建还是延续调查由 LLM 通过调查工具决定，追问不会机械地创建新板。
• 纸片支持拖动、缩放、红绳连线与手动编辑。编辑沿用同款纸色和编号，自动保存并支持撤销；板面数据由 Host 持久化。
• 手动检索支持本地与云端模式及高级设置。阅读器支持 Markdown、来源版本、命中位置与实际已读范围；返回时恢复原入口、筛选和阅读位置。
• 手动浏览暂时停留在当前资料，Agent 下一次查阅时恢复跟随；点击「暂停跟随」才会持续暂停，直到点击「恢复跟随」。用户查看的板、Agent 工作板和证据盒目标分别管理。

长文分页、档案架分页、减少动态效果和无 WebGL 时的文字阅读模式均可用。 操作细节见 资料馆说明 与 交互与资料分层。

前端沿用 Three.js + TypeScript + Vite。三维主体、档案循环导航与渲染使用原项目实现和 默认画质；主界面按调查用途重新设计，原版演示档案已全部移除。开发预览读取本地真实资料包，不连接 Agent：

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.2.0-rc.1（包内 engines.dsh 声明）；已按 0.2.1-rc.2 源码逐项核对
• 官方 Electron Desktop：使用与插件兼容的 DSH 桌面版本；桌面自带运行时
• 磁盘空间：语料大小以设置页与 release 清单为准，下载前不会自动占用完整语料空间

安装

官方 Electron Desktop（推荐）

在新版 DSH 桌面端，无需打开终端：

1. 打开左侧 插件，点击右上角 ＋ 添加插件。
2. 在「包名或地址」输入框中粘贴下面带版本号的 npm 包名；只填包名，不要填 `npm install` 或 `dsh plugin add` 命令：

prts-terrarchive@0.2.3

建议指定版本。只填 prts-terrarchive 时，安装预览可能显示 npm 的 latest，实际安装却选择较旧的版本，原因见下方说明。

1. 在 安装源 中按网络情况选择「npm 官方源」或「中国大陆镜像源」，点击 安装。
2. 安装完成后点击 立即启用；如果直接关闭了对话框，请在已安装列表中打开插件开关。
3. 打开 设置 → 插件 → PRTS 语料 下载资料并选择皮肤，然后新建会话，选择 PRTS 模式。

「添加插件」也接受以下来源，任选一种即可，不需要重复安装：

来源 · 输入框中填写的内容 · 适用情况 npm（推荐） · prts-terrarchive@0.2.3 · 安装指定发布版本 GitHub · https://github.com/HTian-qwq/prts-terrarchive.git · 安装仓库源码，需要本机能访问 GitHub 本地目录 · D:\ds\prts-terrarchive · 安装已下载的完整插件目录；替换为本机实际绝对路径

也支持本地 .tgz 插件包的绝对路径。仓库和 npm 包均已包含构建好的界面与 JavaScript 运行时依赖，仅安装或更新插件无需另装 js-yaml、zod 或运行 npm ci。

安装源只影响 npm 包及依赖下载，不能代理 GitHub 仓库或压缩包直链。 如果 GitHub 无法连接，可以改填 npm 包名并选择镜像源。新发布版本在镜像中尚未可用时，可切换「npm 官方源」重试。

安装预览与已安装版本不同： 使用 pnpm 11 的 DSH 默认优先安装发布满 24 小时的版本，而安装预览读取的是注册表版本。例如，0.2.3 刚发布时，只填包名可能预览 0.2.3、实际安装 0.2.2。这是安装器的版本选择差异。pnpm 官方说明介绍了这项默认设置。请按下面的升级流程卸载旧版，再填 prts-terrarchive@0.2.3 安装，完成后在插件详情中核对版本；无需清除语料或会话数据。

升级插件： 当前桌面安装界面不提供自动更新。需要升级 npm 或 GitHub 安装的插件时，在插件详情中卸载，再通过「添加插件」重新安装并启用；指定版本号时记得换成目标版本。本地源码安装先在原目录执行 git pull，再完全退出并重启桌面端。插件更新与语料更新分别进行，资料版本在「PRTS 语料」中管理。

旧版桌面如只支持 npm 包名，请使用 prts-terrarchive 并按其界面提示启用。Electron 的 desktop profile 由应用管理，不要运行 node bin/install.js desktop 或 dsh plugin --profile desktop。

Web 本地安装

可以从本地源码安装，或使用已内置插件的 PRTS Portable：

npm install --global @deepseek-ai/dsh@0.2.0-rc.1
git clone https://github.com/HTian-qwq/prts-terrarchive.git
cd prts-terrarchive
node bin/install.js web

仓库和 npm 包已包含构建好的 JavaScript 运行时依赖。仅安装插件或执行 git pull 更新源码时，无需另装 js-yaml、zod；修改代码、重新构建时才需要 npm ci。

本地安装器把插件加入指定 profile。DSH 0.1.7 起由插件直接注册「PRTS 模式」； 旧版 DSH 仍创建或迁移 $DSH_HOME/.agent-presets/prts 中的兼容预设。省略第二个参数时使用当前插件目录，也可以传入另一个本地目录或压缩包：

node bin/install.js web /path/to/prts-terrarchive

Web：从 npm 安装

可直接从 npm 安装插件 bundle，无需额外运行安装脚本：

dsh plugin --profile web add prts-terrarchive@0.2.3

重启 dsh web 后，DSH 0.1.7 起由插件注册「PRTS 模式」，禁用或卸载插件时 自动撤销；默认模式和正在运行的普通会话保持不变。新版不读取旧的 $DSH_HOME/.agent-presets/prts 文件。若曾自定义旧预设，请在新版的模式配置中手动迁移； 旧文件会保留。旧版 DSH 继续使用文件模板，已有用户修改不会被覆盖。npm 安装不执行 postinstall。

dsh plugin --profile web remove prts-terrarchive

工具与自定义模式

「PRTS 模式」在插件启用时继承当前宿主的标准模式，包含其终端、文件读写与搜索、后台任务、技能、目标、计划、子 Agent、工作流等能力，再添加 PRTS 检索和调查工具。平台条件、服务隔离及标准模式中停用的可选工具保持原配置，权限仍由 DSH 管理。修改标准模式后重启宿主，并在新会话验证。

在创造模式可以直接要求：“保留标准模式全部能力，再加上 PRTS 检索和调查工具，创建我的研究模式。” Agent 可发现 prts-composition 技能，按宿主流程安装用户自己的组合。可复用入口为 prts-terrarchive/tools（仅 Agent 工具）和 prts-terrarchive/skill（检索与调查指导）；已有 skill loader 不需重复添加。示例和自定义 PRTS 完整工具清单的方法见组合说明。

旧版 DSH 在启动时将自己版本的 standard 组合写入未修改的自动生成预设。用户修改过或没有生成标记的旧文件不会被覆盖；这类预设可按组合说明手动扩展。普通标准模式不会被自动添加 PRTS 工具。

语料下载与 Portable

Web 与官方桌面共享默认的 $DSH_HOME 用户资料，但各自安装插件。插件包包含界面、地图 模型、贴图、技能和预设，不包含语料、Node/DSH 运行库或用户数据。首次使用请在 「设置 → 插件 → PRTS 语料」自行下载语料，切换皮肤无需另下模型和贴图。

PRTS Portable 发行包预装插件、预设和完整语料，解压后无需另行下载语料。 官方 Electron 便携版使用 build-electron.ps1 构建，原 WebView2 构建入口继续保留， 详见 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 镜像）。只启用终末地时下载终末地官方资料和审校知识两包；只启用明日方舟时下载方舟的五包。之后启用另一款游戏，再点击下载或更新会补齐缺少的包，已校验文件会复用；关闭游戏不会删除已安装资料。未安装资料时

PRTS 模式仍可进入；调用本地工具会提醒前往本设置页安装；

1. 新建会话，顶部模式下拉选「PRTS 模式」；
2. 直接用自然语言提问，或让模型调用下列工具。

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）

检索 Skill 默认加载核心策略与当前启用游戏的模块说明；工具契约、详细流程、配方和诊断文档通过技能中的链接按需读取。调查 Skill 默认加载核心工作流，分页回看、协作提醒、引文验证和恢复示例见调查板操作细则。

工具详解

corpus_i18n — 终末地官方多语言查询

使用带本地化附件的终末地资料包（插件 0.2.0 起支持）：

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 即可续查。旧资料包仍可搜索和阅读；多语言附件须随新资料版本安装。

构建方式和数据格式见 官方多语言工具。

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、资料类型和自然标题；资料版本切换后 旧锚点会被拒绝，必须重新搜索。分页不向模型暴露内部签名串。