prts-terrarchive 0.2.0 → 0.2.2

package/README.en.md

@@ -4,7 +4,7 @@ The optional **Rhine Lab Archive** skin combines a continuous 3D retrieval array
 persistent investigation boards, a per-board evidence inbox, and a two-level archive rack
 with 24 sources per page. The Agent adds clues and relationships and publishes versioned
 reports; it decides whether a follow-up continues an investigation or starts a new one.
-Candidates stay in the array, while actually read or manually saved sources enter the rack.
+Browsing candidates stay in the array. Sources delivered to the Agent and manual bookmarks enter the rack; original-reading and citation states remain separate.
 Users can stage important material in a chosen board's inbox, edit matching paper cards,
 and connect clues with red strings.
 
@@ -18,8 +18,12 @@ browser reads and unrelated pages do not acknowledge them.
 Enable it in Settings → Plugins → PRTS Corpus → Skin, then open the archive from
 a session header. Local and cloud search, Markdown reading, excerpts and tool activity
 share the workspace. Returning from a source restores the previous view and position.
-Manual browsing pauses automatic Agent following until explicitly resumed. Visible room
-models also navigate between stations. A text reader remains available without WebGL.
+Investigation tools and their skill are enabled only with the Rhine Lab skin. Other skins
+use ordinary retrieval and reply directly in the conversation. Switching skins updates the
+tools in the same PRTS session; no new session is required. Saved clues, reports and archives
+remain available when you return to Rhine Lab.
+Manual browsing holds the current source until the next Agent read. Explicitly pausing
+following keeps it paused until resumed. Visible room models also navigate between stations. A text reader remains available without WebGL.
 
 For local development, use Node.js 22.19 or newer, then run `npm ci`,
 `npm run build:rhine`, and `npm run preview:rhine`. See the
@@ -36,8 +40,8 @@ allowance of 1,000 calls per user per day for DSH clients; this policy may
 change as service capacity evolves.
 
 - Registers DSH `ToolDefinition`s through the host plugin interface.
-- Host-resident instance (settings UI + data manager) + per-session "PRTS
-  mode" preset that mounts the tools only for sessions that select it.
+- Host-resident settings UI and data manager, with Agent tools composed into
+  PRTS mode or user-defined presets. PRTS mode inherits the full standard toolset.
 - The fixed `https://prts.chat` origin is the trust source for latest-release
   resolution and manifests; ModelScope and the configurable fallback only serve
   bytes for that fixed release and cannot select or attest a version.
@@ -52,20 +56,68 @@ change as service capacity evolves.
 ## Install
 
 Web requires Node.js >= 22.19 and DSH >= 0.1.2-alpha.2. The current compatibility
-target is DSH 0.1.7-rc.2. An official Electron Desktop installation supplies
+target is DSH 0.2.0-rc.1. An official Electron Desktop installation supplies
 its own runtime. Corpus disk usage is shown in Settings before download.
 
+### Official Electron Desktop (recommended)
+
+Recent DSH Desktop builds let you install from the UI without a terminal:
+
+1. Open **Plugins** in the sidebar, then click **+ Add plugin**.
+2. Paste the npm package name into **Package name or address**. Enter only the name, **not an `npm install` or `dsh plugin add` command**:
+
+   ```text
+   prts-terrarchive
+   ```
+
+   Without a version, this installs npm's `latest`. To pin this release, enter `prts-terrarchive@0.2.2`.
+3. Choose the official npm registry or the mainland China mirror under **Registry**, then click **Install**.
+4. Click **Enable now** after installation. If you close the dialog instead, turn on the plugin in the installed list.
+5. Open **Settings → Plugins → PRTS Corpus** to download the corpus and choose a skin, then start a new session in **PRTS mode**.
+
+The same dialog accepts these alternatives. Choose one; you do not need to install each source:
+
+| Source | Text to enter | Use |
+| --- | --- | --- |
+| npm (recommended) | `prts-terrarchive` | Install a published release |
+| GitHub | `https://github.com/HTian-qwq/prts-terrarchive.git` | Install repository source; requires access to GitHub |
+| Local directory | `D:\ds\prts-terrarchive` | Install a complete downloaded checkout; replace this with its actual absolute path |
+
+An absolute path to a local `.tgz` package is also supported. The checkout and npm package
+include the built UI and JavaScript runtime dependencies. Installing or updating the plugin
+does not require a separate `js-yaml` / `zod` installation or `npm ci`.
+
+**Registry selection affects npm packages and dependencies, not GitHub downloads or direct tarball URLs.**
+If GitHub is unreachable, enter the npm package name and choose a mirror instead. If a mirror
+does not yet have a newly published version, try the official npm registry.
+
+**Upgrades:** the current Desktop installation UI does not provide automatic updates.
+For npm or GitHub installs, uninstall from the plugin details, then add and enable the plugin
+again; change any pinned version to your target release. For a local checkout, run `git pull`
+in the original directory, then fully quit and restart Desktop. Plugin and corpus updates
+are separate; manage corpus versions in **PRTS Corpus**.
+
+Older Desktop releases may accept only npm package names; use `prts-terrarchive` and follow
+their activation prompts. Electron manages the `desktop` profile: do not run
+`node bin/install.js desktop` or `dsh plugin --profile desktop`.
+
 ### Local Web installation
 
 Install from a local checkout, or use PRTS Portable with the plugin already included:
 
 ```bash
-npm install --global @deepseek-ai/dsh@0.1.7-rc.2
+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
 ```
 
+The checkout and npm package include their built JavaScript runtime dependencies. Installing
+the plugin or updating with `git pull` requires no separate `js-yaml` or `zod` installation.
+Run `npm ci` when developing and rebuilding, and `npm run build:runtime` when updating these dependencies.
+`npm pack` and `npm publish` verify bundled versions and load every Host entry in an isolated
+directory without `node_modules` before allowing the package to be created.
+
 The local installer adds the package to the selected profile. DSH 0.1.7 and
 later register PRTS mode directly; older DSH versions still create or migrate
 the compatibility preset in `$DSH_HOME/.agent-presets/prts`. With no
@@ -82,7 +134,7 @@ Install the bundle directly from npm; no additional installer command
 or npm lifecycle hook is needed:
 
 ```bash
-dsh plugin --profile web add prts-terrarchive@0.2.0
+dsh plugin --profile web add prts-terrarchive@0.2.2
 ```
 
 Restart `dsh web`. On DSH 0.1.7 and later the plugin registers PRTS mode
@@ -97,14 +149,15 @@ run `postinstall`.
 dsh plugin --profile web remove prts-terrarchive
 ```
 
-### Official Electron Desktop
+### Tools and custom modes
 
-For Electron Desktop builds compatible with the DSH 0.1.7 plugin interface, enter
-`prts-terrarchive@0.2.0` in the **desktop application's plugin manager**.
-The manager accepts npm registry package names and versions, not GitHub URLs,
-local directories, or tarballs. Electron exclusively manages the `desktop`
-profile: do not run `node bin/install.js desktop` or
-`dsh plugin --profile desktop`.
+PRTS mode inherits the current host's complete standard composition when the plugin activates, including shell, file operations, background jobs, skills, goals, planning, delegation and workflows, then adds PRTS retrieval and investigation tools. Platform conditions, service isolation, disabled optional tools and host permissions are preserved. Restart after changing standard mode and verify in a new session.
+
+In Creative mode, ask the Agent to keep standard capabilities and add PRTS tools to a custom research mode. The globally discoverable `prts-composition` skill explains how to compose `prts-terrarchive/tools` (Agent tools only) and `prts-terrarchive/skill` (retrieval and investigation guidance), or replace PRTS mode's complete tool list. See the [composition guide](skills/prts-composition/SKILL.md).
+
+Legacy hosts seed their own standard composition into unchanged generated presets at startup. Edited or unmarked existing presets remain user-owned and require manual composition. Ordinary standard mode receives no PRTS tools automatically.
+
+### Corpus downloads and Portable
 
 Web and official Desktop share the default `$DSH_HOME` product data while
 installing their plugins separately. The plugin package includes its UI,
@@ -149,6 +202,11 @@ After the retrieval Skill loads, matched entities and relationships enter DSH's
 dynamic context for the current question. Each new snapshot supersedes the
 previous one. Tool titles identify local/cloud retrieval and the game scope.
 
+The retrieval Skill loads its core strategy and enabled game modules. Detailed tool guidance,
+procedures, recipes and diagnostics are linked for reading as needed. The investigation Skill
+loads its core workflow; recall, collaboration, quotation validation and recovery examples are
+in the [board guide](skills/prts-investigation/references/board-guide.md).
+
 ## Skins and assets
 
 - **Harness default** keeps the native DSH interface.
@@ -225,9 +283,17 @@ DSH 0.1.2-alpha.1 and 0.1.2-alpha.2 have completed historical real-host tests
 with the web profile. Alpha.1 was built from the official tag and passed
 installation, preset resolution, host startup, settings-route, and
 client-bundle checks. The current plugin compatibility target is DSH
-0.1.7-rc.2. The shared Connection Fetch transport supports Web and the official
+0.2.0-rc.1. The shared Connection Fetch transport supports Web and the official
 Electron source implementation; Web also retains HTTP routes. Declarative
-registration and legacy file seeding pass this project's unit tests. A full
+registration and legacy file seeding pass this project's unit tests. Tests against
+0.1.7-rc.2 (`477b4f420553`) also exercise real Cordis, Tools, SystemPrompt,
+Storage Domain and official web tools for scoped events, tool receipts, cold
+investigation recovery and disposal. Browser regressions cover all four skins
+with official plugin/settings components and current/legacy conversation layouts.
+Web receipts retain only text delivered to the model; URL matching merges live
+and restored archive entries. Model selection handles both modern `RemoteResult`
+and legacy `void` results, keeping the original session on failure. These tests
+use a local web-provider fixture without credentials or API calls. A full
 0.1.7-rc.2 Host launch and Windows Electron end-to-end test remain to be run.
 The default Electron portable builder pins the official 0.1.7-rc.2 tag; the legacy
 Electron entry pins 0.1.5-alpha.1 and the original WebView2 builder pins
@@ -236,7 +302,7 @@ Electron entry pins 0.1.5-alpha.1 and the original WebView2 builder pins
 Older custom deployments with `includeUserRoot: false` and no other preset root with
 `trust: user` receive no generated preset or root changes; their operator must
 first enable user preset authoring. The plugin relies on internal host surfaces
-(`ctx.tools`, `agent/pre-step`, Connection Fetch, agent presets, client
+(`ctx.tools`, `system-prompt/assemble`, Connection Fetch, agent presets, client
 slots/theme); after a DSH major upgrade, re-run the smoke checklist below.
 
 ## Development

package/README.md

@@ -33,7 +33,7 @@ Agent 可以离线检索并按原文行号阅读材料；可选的 PRTS.chat 云
 
 | 特性 | 说明 |
 | --- | --- |
-| 按需加载 | 工具只挂在「PRTS 模式」预设下，标准/极简等模式不受污染 |
+| 自由组合 | PRTS 模式继承标准模式的完整能力；创造模式可将 PRTS 工具加入任意自定义模式 |
 | 双游戏资料 | 明日方舟与终末地原文、档案、审校 Wiki、实体与时间线使用统一工具检索 |
 | 读取去重 | 会话级证据状态跟踪已进入模型上下文的原文，重复/重叠读取自动回放或只补读新行 |
 | 自带皮肤 | Harness 默认 / PRTS Agent / Endfield AIC / 莱茵生命资料馆 |
@@ -44,12 +44,14 @@ Agent 可以离线检索并按原文行号阅读材料；可选的 PRTS.chat 云
 「资料馆」。检索阵列、调查板、重点证据盒和双层档案架位于同一个三维场景。
 可用底部导航、边缘入口或点击可见模型切换，镜头连续移动。
 
-- **检索阵列**保留候选资料；**档案架**收录 Agent 实际读过或用户主动收藏的资料，每页上下两层、每层十二份。
+调查板工具与调查技能仅在「莱茵生命资料馆」皮肤下启用。其他皮肤直接在对话中检索和回答，不会要求建板或把回答只存入板内报告。同一 PRTS 会话切换皮肤后会更新工具，无需新建对话；切出莱茵不会删除已保存的线索、报告或档案，切回后可继续查看。
+
+- **检索阵列**保留候选资料；**档案架**收录已交付给 Agent 的资料或用户主动收藏的资料，分别保留已读和引用状态，每页上下两层、每层十二份。
 - **重点证据盒**属于指定调查板，用于暂存待核对、待整理的材料；放入盒子不会自动标成已读，也不必先收藏。
 - **调查板**由 Agent 持续添加线索与关系，中央保留带版本的报告。新建还是延续调查由 LLM 通过调查工具决定，追问不会机械地创建新板。
 - 纸片支持拖动、缩放、红绳连线与手动编辑。编辑沿用同款纸色和编号，自动保存并支持撤销；板面数据由 Host 持久化。
 - 手动检索支持本地与云端模式及高级设置。阅读器支持 Markdown、来源版本、命中位置与实际已读范围；返回时恢复原入口、筛选和阅读位置。
-- 手动浏览会暂停 Agent 自动跟随，点击「恢复跟随」后继续。用户查看的板、Agent 工作板和证据盒目标分别管理。
+- 手动浏览暂时停留在当前资料，Agent 下一次查阅时恢复跟随；点击「暂停跟随」才会持续暂停，直到点击「恢复跟随」。用户查看的板、Agent 工作板和证据盒目标分别管理。
 
 长文分页、档案架分页、减少动态效果和无 WebGL 时的文字阅读模式均可用。
 操作细节见 [资料馆说明](docs/rhine-lab.md) 与 [交互与资料分层](docs/rhine-interaction-flow.md)。
@@ -69,23 +71,57 @@ npm run preview:rhine
 
 ## 环境要求
 
-- Web：Node.js **≥ 22.19**，DSH 运行时 **≥ 0.1.2-alpha.2**；当前适配目标为 **0.1.7-rc.2**
+- Web：Node.js **≥ 22.19**，DSH 运行时 **≥ 0.1.2-alpha.2**；当前适配目标为 **0.2.0-rc.1**
 - 官方 Electron Desktop：使用与插件兼容的 DSH 桌面版本；桌面自带运行时
 - 磁盘空间：语料大小以设置页与 release 清单为准，下载前不会自动占用完整语料空间
 
 ## 安装
 
+### 官方 Electron Desktop（推荐）
+
+在新版 DSH 桌面端，无需打开终端：
+
+1. 打开左侧 **插件**，点击右上角 **＋ 添加插件**。
+2. 在「包名或地址」输入框中粘贴下面的 npm 包名；**只填包名，不要填 `npm install` 或 `dsh plugin add` 命令**：
+
+   ```text
+   prts-terrarchive
+   ```
+
+   不带版本号时安装 npm 的 `latest`；需要固定本次发布版本时，填 `prts-terrarchive@0.2.2`。
+3. 在 **安装源** 中按网络情况选择「npm 官方源」或「中国大陆镜像源」，点击 **安装**。
+4. 安装完成后点击 **立即启用**；如果直接关闭了对话框，请在已安装列表中打开插件开关。
+5. 打开 **设置 → 插件 → PRTS 语料** 下载资料并选择皮肤，然后新建会话，选择 **PRTS 模式**。
+
+「添加插件」也接受以下来源，任选一种即可，不需要重复安装：
+
+| 来源 | 输入框中填写的内容 | 适用情况 |
+| --- | --- | --- |
+| npm（推荐） | `prts-terrarchive` | 安装已发布版本 |
+| 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 官方源」重试。
+
+**升级插件：** 当前桌面安装界面不提供自动更新。需要升级 npm 或 GitHub 安装的插件时，在插件详情中卸载，再通过「添加插件」重新安装并启用；指定版本号时记得换成目标版本。本地源码安装先在原目录执行 `git pull`，再完全退出并重启桌面端。插件更新与语料更新分别进行，资料版本在「PRTS 语料」中管理。
+
+旧版桌面如只支持 npm 包名，请使用 `prts-terrarchive` 并按其界面提示启用。Electron 的 `desktop` profile 由应用管理，不要运行 `node bin/install.js desktop` 或 `dsh plugin --profile desktop`。
+
 ### Web 本地安装
 
 可以从本地源码安装，或使用已内置插件的 PRTS Portable：
 
 ```bash
-npm install --global @deepseek-ai/dsh@0.1.7-rc.2
+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` 中的兼容预设。省略第二个参数时使用当前插件目录，也可以传入另一个本地目录或压缩包：
 
@@ -98,7 +134,7 @@ node bin/install.js web /path/to/prts-terrarchive
 可直接从 npm 安装插件 bundle，无需额外运行安装脚本：
 
 ```bash
-dsh plugin --profile web add prts-terrarchive@0.2.0
+dsh plugin --profile web add prts-terrarchive@0.2.2
 ```
 
 重启 `dsh web` 后，DSH `0.1.7` 起由插件注册「PRTS 模式」，禁用或卸载插件时
@@ -110,12 +146,15 @@ dsh plugin --profile web add prts-terrarchive@0.2.0
 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`。
+「PRTS 模式」在插件启用时继承**当前宿主的标准模式**，包含其终端、文件读写与搜索、后台任务、技能、目标、计划、子 Agent、工作流等能力，再添加 PRTS 检索和调查工具。平台条件、服务隔离及标准模式中停用的可选工具保持原配置，权限仍由 DSH 管理。修改标准模式后重启宿主，并在新会话验证。
+
+在**创造模式**可以直接要求：“保留标准模式全部能力，再加上 PRTS 检索和调查工具，创建我的研究模式。” Agent 可发现 `prts-composition` 技能，按宿主流程安装用户自己的组合。可复用入口为 `prts-terrarchive/tools`（仅 Agent 工具）和 `prts-terrarchive/skill`（检索与调查指导）；已有 skill loader 不需重复添加。示例和自定义 PRTS 完整工具清单的方法见[组合说明](skills/prts-composition/SKILL.md)。
+
+旧版 DSH 在启动时将自己版本的 standard 组合写入未修改的自动生成预设。用户修改过或没有生成标记的旧文件不会被覆盖；这类预设可按组合说明手动扩展。普通标准模式不会被自动添加 PRTS 工具。
+
+### 语料下载与 Portable
 
 Web 与官方桌面共享默认的 `$DSH_HOME` 用户资料，但各自安装插件。插件包包含界面、地图
 模型、贴图、技能和预设，**不包含语料、Node/DSH 运行库或用户数据**。首次使用请在
@@ -160,6 +199,8 @@ Web 本地安装需要可用的 `dsh.cmd`。安装器经 cmd.exe 调用它，插
 | `@deepseek-ai/dsh-tool-skill` | skill 加载器 | 按需加载检索策略技能 |
 | 本插件 | `prts-retrieval` 技能 | 检索配方与字段语义（按需注入，不占 system prompt） |
 
+检索 Skill 默认加载核心策略与当前启用游戏的模块说明；工具契约、详细流程、配方和诊断文档通过技能中的链接按需读取。调查 Skill 默认加载核心工作流，分页回看、协作提醒、引文验证和恢复示例见[调查板操作细则](skills/prts-investigation/references/board-guide.md)。
+
 ## 工具详解
 
 ### corpus_i18n — 终末地官方多语言查询
@@ -351,6 +392,8 @@ Endfield AIC 的插件代码、UI 集成与地图渲染实现采用 MIT License
 ## 开发
 
 ```bash
+npm run build:runtime # 更新随包交付的 YAML / Zod，依赖或构建入口修改后运行
+npm run check:runtime # 隔离环境加载所有 Host 入口，不使用 node_modules
 npm run check        # 全部源码语法检查
 npm test             # node --test 全量测试；语料集成用例需本地 data/releases，否则自动跳过
 git diff --check     # 检查待提交文本
@@ -397,15 +440,21 @@ 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 通道支持
+加载检查。当前插件适配目标为 DSH `0.2.0-rc.1`，共享 Connection Fetch 通道支持
 Web 与官方 Electron 源码实现；Web 同时保留 HTTP 路由。新版声明式预设与
-旧版文件预设均通过本项目单元测试；`0.1.7-rc.2` 的完整 Host 启动及 Windows Electron 实机端到端验证仍待完成。
-Electron 便携版默认固定 `0.1.7-rc.2` 官方 tag；旧 Electron 构建入口仍固定
+旧版文件预设均通过本项目单元测试。针对 `0.1.7-rc.2`（`477b4f420553`），另以真实
+Cordis、Tools、SystemPrompt、Storage Domain 与官方网页工具验证作用域、工具回执、
+冷启动调查恢复和服务释放；四种皮肤也在官方插件管理页、设置组件及新旧会话布局下
+通过浏览器回归。网页正文仅保存实际交付给模型的文本；恢复档案按网页 URL 合并，
+避免实时结果与持久化 ID 不同造成重复入架。模型切换兼容新版 `RemoteResult` 和旧版
+`void` 接口，并在失败时保留原会话。`npm pack` / `npm publish` 还会自动检查随包运行时版本，并在无 `node_modules` 的临时目录中加载所有 Host 入口，阻止缺少运行时依赖的包发布。上述测试使用本地模拟网页提供方，无需账号或 API Key；
+当前版本的完整 Host 启动及 Windows Electron 实机端到端验证仍待完成。
+Electron 便携版默认固定 `0.2.0-rc.1` 官方 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 大版本升级后
+`system-prompt/assemble`、Connection Fetch、agent 预设、客户端 slots/theme）；DSH 大版本升级后
 请按「安装 → 重启 → 设置页 → PRTS 模式 → 语料工具 → 网页工具 → 皮肤 → 版本热切换」
 过一遍冒烟。
 

package/THIRD_PARTY_NOTICES.md

@@ -59,3 +59,13 @@ Research report formatting uses [markdown-it](https://github.com/markdown-it/mar
 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.
+
+## Bundled plugin runtime libraries
+
+The plugin includes prebuilt JavaScript runtime libraries so local checkout, npm, and
+portable installations do not need to resolve them from a user's `node_modules`.
+`lib/runtime/yaml.js` bundles js-yaml 4.3.1, MIT, Copyright (C) 2011–2015 Vitaly Puzrin;
+`lib/runtime/zod.js` bundles Zod 4.4.3, MIT, Copyright (c) 2025 Colin McDonnell.
+The complete upstream notices are included in `lib/runtime/licenses/js-yaml-MIT.txt`
+and `lib/runtime/licenses/zod-MIT.txt`. These bundles are generated from the versions
+locked in `package-lock.json` by `npm run build:runtime`.

package/bin/build-runtime.mjs

@@ -0,0 +1,32 @@
+/** Rebuild the committed pure-JavaScript runtime dependencies; no consumer install hook. */
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { build } from 'vite'
+
+const root = fileURLToPath(new URL('../', import.meta.url))
+const require = createRequire(import.meta.url)
+const manifest = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+const dependencies = { 'js-yaml': manifest.devDependencies['js-yaml'], zod: manifest.devDependencies.zod }
+const packages = Object.fromEntries(Object.entries(dependencies).map(([name, version]) => {
+  const path = require.resolve(name + '/package.json')
+  if (JSON.parse(readFileSync(path, 'utf8')).version !== version) throw new Error(`Run npm ci to install ${name}@${version}`)
+  return [name, dirname(path)]
+}))
+await build({
+  root, configFile: false, publicDir: false,
+  build: {
+    outDir: 'lib/runtime', emptyOutDir: true, target: 'node22', minify: false,
+    lib: {
+      entry: { yaml: join(root, 'resources/runtime/yaml.js'), zod: join(root, 'resources/runtime/zod.js') },
+      formats: ['es'], fileName: (_format, name) => `${name}.js`,
+    },
+    rollupOptions: { output: { banner: '// Generated by npm run build:runtime. See ./licenses/ for upstream notices.' } },
+  },
+})
+mkdirSync(join(root, 'lib/runtime/licenses'), { recursive: true })
+for (const [name, path] of Object.entries(packages)) {
+  copyFileSync(join(path, 'LICENSE'), join(root, 'lib/runtime/licenses', `${name}-MIT.txt`))
+}
+writeFileSync(join(root, 'lib/runtime/versions.json'), JSON.stringify(dependencies, null, 2) + '\n')

package/bin/check-runtime.mjs

@@ -0,0 +1,56 @@
+/** Verify all Host entry points using only shipped code, outside the checkout's dependency tree. */
+import { cpSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join, relative, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
+import { parseArgs } from 'node:util'
+
+export function checkRuntime(packageRoot) {
+  const manifest = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))
+  if (Object.keys(manifest.dependencies || {}).length) throw new Error('Bundle runtime dependencies before shipping the plugin')
+  const versions = JSON.parse(readFileSync(join(packageRoot, 'lib/runtime/versions.json'), 'utf8'))
+  for (const name of ['js-yaml', 'zod']) {
+    if (versions[name] !== manifest.devDependencies[name]) throw new Error(`Stale bundled ${name}; run npm run build:runtime`)
+    readFileSync(join(packageRoot, 'lib/runtime/licenses', `${name}-MIT.txt`))
+  }
+  const entries = Object.entries(manifest.exports).filter(([name, path]) =>
+    name !== './client' && typeof path === 'string' && /\.[cm]?js$/.test(path))
+  const temporary = mkdtempSync(join(tmpdir(), 'prts-runtime-'))
+  try {
+    const staged = join(temporary, 'plugin')
+    mkdirSync(staged)
+    // Include assets too: Host UI discovers packaged map files during import.
+    // These paths must also be selected for the actual npm package.
+    for (const path of ['package.json', 'src', 'presets', 'contracts', 'resources', 'lib']) {
+      if (path !== 'package.json' && !manifest.files.some(item => path === item || path.startsWith(item + '/'))) {
+        throw new Error(`Runtime tree is excluded from the npm package: ${path}`)
+      }
+      cpSync(join(packageRoot, path), join(staged, path), { recursive: true,
+        filter: file => !relative(packageRoot, file).split(/[\\/]/).includes('node_modules') })
+    }
+    const probe = join(staged, '__prts_runtime_check__.mjs')
+    writeFileSync(probe, `
+      for (const name of ${JSON.stringify(entries.map(([name]) => name === '.' ? manifest.name : manifest.name + name.slice(1)))}) {
+        await import(name)
+      }
+      const { readPlugins, writePlugins } = await import('./presets/composition.js')
+      const plugins = readPlugins('- id: probe\\n  name: test/probe\\n  disabled: !!js process.platform === "win32"\\n')
+      if (readPlugins(writePlugins(plugins))[0].disabled.__jsExpr !== 'process.platform === "win32"') {
+        throw new Error('Bundled preset parser lost the Cordis expression')
+      }
+    `)
+    const result = spawnSync(process.execPath, [probe], {
+      cwd: staged, encoding: 'utf8', timeout: 30000,
+      env: { ...process.env, NODE_PATH: '', NODE_OPTIONS: '' },
+    })
+    if (result.status !== 0) throw new Error(`Isolated plugin load failed:\n${result.error || result.stderr || result.stdout}`)
+    return { entries: entries.map(([name]) => name), dependencies: versions }
+  } finally { rmSync(temporary, { recursive: true, force: true }) }
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const { values } = parseArgs({ options: { package: { type: 'string' } } })
+  const result = checkRuntime(resolve(values.package || fileURLToPath(new URL('../', import.meta.url))))
+  console.error(`PRTS runtime: ${result.entries.length} Host entries loaded without node_modules`)
+}

package/bin/install.js

@@ -14,13 +14,14 @@
  * 做什么：
  *   1) 把插件加入 profile（dsh plugin add）
  *   2) DSH 0.1.7 起由插件注册「PRTS 模式」；旧版创建用户预设
- *      （$DSH_HOME/.agent-presets/prts/*），且只有选中该模式才加载语料工具
+ *      （$DSH_HOME/.agent-presets/prts/*），启动时继承该版本的标准模式
  *   3) 打印后续指引（如何设为默认模式）
  *
- * 说明：资料管理（设置页 /api + UI）由插件 host 常驻提供；语料三工具由
- * PRTS 预设加载——标准/极简等其它模式不加载 PRTS 工具。
+ * 说明：资料管理（设置页 /api + UI）由插件 host 常驻提供；
+ * PRTS 或用户自定义预设加载检索和调查工具。
  */
 import { execFileSync } from 'node:child_process'
+import { createHash } from 'node:crypto'
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join, resolve } from 'node:path'
@@ -221,6 +222,17 @@ if (usesDeclarativePresets(dshVersion)) {
 } else {
   console.log('\n[2/2] 创建 PRTS 用户预设…')
   mkdirSync(presetDir, { recursive: true })
+  const markerPath = join(presetDir, '.prts-terrarchive.json')
+  const generatedFiles = ['agent.cordis.yml', 'preset.yml']
+  const digest = (content) => createHash('sha256').update(content).digest('hex')
+  let packageOwned = !existsSync(compositionPath) && !existsSync(metadataPath)
+  try {
+    const marker = JSON.parse(readFileSync(markerPath, 'utf8'))
+    packageOwned = marker.format === 1 && marker.package === packageMetadata.name
+      && generatedFiles.every(file => existsSync(join(presetDir, file))
+        && digest(readFileSync(join(presetDir, file), 'utf8')) === marker.files?.[file])
+  } catch { /* Existing unmarked or edited presets belong to the user. */ }
+
   // 各文件独立修复；已存在的组合只迁移本插件旧 guidance，并补齐网页工具和 Skill loader，
   // 不覆盖其它用户改动。
   if (!existsSync(compositionPath)) {
@@ -261,12 +273,19 @@ if (usesDeclarativePresets(dshVersion)) {
     if (migrated !== existing) writeFileSync(compositionPath, migrated)
   }
   if (!existsSync(metadataPath)) writeFileSync(metadataPath, PRESET_METADATA)
+  // The running legacy Host can now extend its own standard preset on startup.
+  if (packageOwned) {
+    writeFileSync(markerPath, JSON.stringify({
+      format: 1, package: packageMetadata.name, version: packageMetadata.version,
+      files: Object.fromEntries(generatedFiles.map(file => [file, digest(readFileSync(join(presetDir, file), 'utf8'))])),
+    }, null, 2) + '\n')
+  }
   console.log(`  已确保预设文件存在（仅自动迁移本插件旧检索指导）：${presetDir}`)
 
   console.log('\n完成。重启 dsh 后：')
   console.log('  · 设置 → 插件 →「PRTS 语料」= 资料管理（host 常驻，始终可进）')
-  console.log('  · 新建会话顶部的模式下拉选「PRTS 模式」→ 加载语料三工具')
-  console.log('  · 标准/极简等其它模式不加载 PRTS 工具')
+  console.log('  · 新建会话选择「PRTS 模式」→ 标准模式全部能力 + PRTS 检索与调查工具')
+  console.log('  · 创造模式可加载 prts-composition 技能，将 PRTS 工具加入自定义模式')
   console.log(`  · 以后执行 dsh plugin update 后，可运行本命令加 --preset-only 同步预设迁移`)
   console.log(`  · 卸载：${dshCmd} plugin --profile ${profile} remove ${packageMetadata.name}`)
   console.log(`  · 想让新会话默认就用 PRTS 模式：设置 → Agent 预设 → 设为默认`)

package/contracts/corpus_i18n_v1.schema.json

@@ -19,30 +19,30 @@
         },
         "query": {
           "type": "string",
-          "description": "名称或原句；仅有片段时使用 match_mode=literal"
+          "description": "名称或原句"
         },
         "title": {
           "type": "string",
-          "description": "已有检索结果的完整篇章标题，与 query/document_uid/text_ids 四选一"
+          "description": "已有结果的完整篇章标题"
         },
         "document_uid": {
           "type": "string",
-          "description": "已有检索结果的文档定位，替代 title"
+          "description": "已有结果的文档定位"
         },
         "line": {
           "type": "integer",
-          "description": "已有中文结果中的行号，只用于定位对应文本/记录"
+          "description": "已有中文结果中的行号"
         },
         "text_ids": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "显式请求 ID 后可用于精确复查；普通查询不需要"
+          "description": "返回的文本 ID 字符串，用于精确复查"
         },
         "source_language": {
           "type": "string",
-          "description": "原句的语言，默认 CN；也接受 en/ja/ko/zh-CN 等标准代码"
+          "description": "原句语言，默认 CN；支持 en/ja/ko/zh-CN 等代码"
         },
         "languages": {
           "type": "array",
@@ -57,11 +57,11 @@
             "exact",
             "literal"
           ],
-          "description": "原句精确匹配或字面量片段搜索，默认 exact"
+          "description": "默认 exact 精确匹配；片段用 literal"
         },
         "include_ids": {
           "type": "boolean",
-          "description": "默认 false；仅调试、核验或精确复查时返回内部文本 ID 与来源字段"
+          "description": "核验时返回内部 ID，默认 false"
         },
         "max_matches": {
           "type": "integer",
@@ -73,7 +73,7 @@
         },
         "data_version": {
           "type": "string",
-          "description": "绑定已有结果的资料版本，避免混用版本"
+          "description": "已有结果的资料版本"
         },
         "after": {
           "type": "object",
@@ -98,7 +98,7 @@
               "type": "integer"
             }
           },
-          "description": "仅原样提交工具返回的续页位置；长记录会明确分块返回"
+          "description": "原样复制 page.continuation.after"
         }
       }
     },

package/cordis.patch.yml

@@ -1,15 +1,15 @@
-# PRTS.chat 本地语料插件层（工具层，随 bundle 默认加载）。
-# 插件零 npm 依赖；宿主只需提供 ctx.tools 注册表。
-# 五工具：corpus_search / corpus_read / timeline_search +（配置 cloud.baseUrl 时）cloud_search / cloud_inspect。
+# PRTS.chat 资料管理、模式注册与组合说明。Agent 工具按预设装配。
 # releasesDir 支持绝对路径或相对进程 cwd 的路径；默认 $DSH_HOME/prts-corpus/releases。
 - insert:
     - id: prts-preset-seed
       name: prts-terrarchive/presets
+    - id: prts-composition-skill
+      name: prts-terrarchive/composition
     - id: prts-corpus
       name: prts-terrarchive
       config:
         # host 常驻只做资料管理（/api + 设置 UI），不注册语料工具；
-        # 语料工具由 PRTS 预设（模式）的 agent.cordis.yml 加载时才注册。
+        # 语料工具由 PRTS 或用户自定义预设加载时注册。
         registerTools: false
         # releasesDir 省略时默认 $DSH_HOME/prts-corpus/releases；
         # 如资料放在别处再填绝对路径（Windows 亦可用正斜杠）。

package/docs/web-access.md

@@ -0,0 +1,24 @@
+# PRTS 模式的网页搜索与抓取
+
+PRTS 模式使用宿主 DSH 的 `web_search` / `web_fetch`。PRTS 本地语料检索和 `cloud_search` 不使用这两套网页接口。
+
+## 桌面账号登录后，搜索仍提示缺少 API Key
+
+目前核对的 DSH 0.1.7-rc.2 中，聊天的 `deepseek-account` 与默认网页搜索 `deepseek-official` 是两条独立通路。
+网页登录成功不代表已配置 DeepSeek 开放平台 API Key。账号登录 token、npm token 都不能代替这个 Key。
+
+在 DSH 的**插件 → 网页搜索**配置页面填写自己的 DeepSeek 开放平台 API Key 并保存；旧版可在**设置 → 模型**中配置相同的 `DEEPSEEK_API_KEY` 凭据。
+凭据存入宿主的凭据服务，不应写入 PRTS 插件、发行包或会话消息。已有第三方搜索提供方的用户按该提供方配置，不要为修复缺 Key 随意改写搜索端点。
+
+没有独立 Key 时，当前官方实现无法仅靠桌面账号完成默认网页搜索。PRTS 会提示这个条件，并继续可用的本地检索；这不代表现实资料已经联网核实。
+
+## `web_fetch failed: TypeError: fetch failed`
+
+网页抓取不依赖搜索的 API Key。这个错误只说明那次页面请求没有成功，日志若未记录底层原因，就无法进一步区分 DNS、连接、代理和 TLS 问题。
+两个同域名页面失败也不能推导出其他网站全部不可访问。
+
+先确认目标页面在本机网络中是否可访问，再确认 **DSH 进程**使用的网络配置。浏览器代理设置未必会传给 DSH 的 Node Host。
+当前官方源码从启动环境读取标准代理变量（如 `HTTPS_PROXY`）；如果确实需要代理，应使用本机实际的 HTTP 代理地址，在启动 DSH 前设置，然后彻底退出并重新启动 DSH。
+不要复制不属于自己机器的端口，不要用关闭证书校验来绕过 TLS 故障。旧宿主对代理的具体支持以它自己的版本为准。
+
+插件不会代填密钥、修改系统代理或替换宿主网络实现。新增故障指引会按会话及失败域名记录，成功后移除；不保存凭据、URL 查询参数或请求头。