prts-terrarchive

资料与配置

• 默认资料目录：$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 可能保留已申请的 堆页，因此操作系统看到的常驻内存不会在查询结束后立即回落。