@@ -2,19 +2,19 @@
[English ](README.md ) | 中文
自引用 Cordis 工具集：三个面向模型的工具，操作当前 DSH 进程中的存活 运行时。设计归属（ 沙箱语义、临时 Plugin 生命周期与组合、生成的 API 目录、 既定决策） 工具集 Agent Note ](../../../.agents/notes/implemented/feature/2026-07-08-self-referential-cordis-toolset.md )。
自引用 Cordis 工具集：三个面向模型的工具，操作当前 DSH 进程中的实时 运行时。沙箱语义、临时插件 生命周期与组合、生成的 API 目录及 既定决策详 见[工具集 Agent Note（ ](../../../.agents/notes/implemented/feature/2026-07-08-self-referential-cordis-toolset.md )。
## 功能
- `cordis_inspect` ：当前进程运行时的只读报告，包括服务、全部存活 Plugin fiber、已注册工具、`cordis_mount` 临时 Plugin 子集，以及目录支持的 `api` ／ `events` 参考。精确的 `name` 配合 `what: "api"` 或 `what: "events"` 可缩窄报告，并附上原始源代码 JSDoc。
- `cordis_mount` ：立即求值模型编写的 JavaScript 且不保存到任何位置；代码必须返回一个以 `dyn-<n>` 跟踪、仅存于内存的临时 Plugin 。
- `cordis_unmount` ：卸载一个 `dyn-<n>` 临时 Plugin， 完全停稳后返回；它不能删 除 Loader、配置或已安装的 Plugin 。
- `cordis_inspect` ：当前进程运行时的只读报告，包括服务、全部存活插件 fiber、已注册工具、`cordis_mount` 临时插件 子集，以及目录支持的 `api` ／ `events` 参考。精确的 `name` 配合 `what: "api"` 或 `what: "events"` 可缩窄报告，并附上原始源代码 JSDoc。
- `cordis_mount` ：立即求值模型编写的 JavaScript 且不保存到任何位置；代码必须返回一个仅存于内存、 以 `dyn-<n>` 为标识进行跟踪的临时插件 。
- `cordis_unmount` ：卸载一个 `dyn-<n>` 临时插件，并只在其拥有的 effect 完全停稳后返回；它不能移 除 Loader 插件、已配置插件或已安装插件 。
精确的 面向模型 schema 见[生成的工具目录 ](../../../docs/tool-catalog.md )。
面向模型的确切 schema 见[生成的工具目录 ](../../../docs/tool-catalog.md )。
规范成功值 分别为检查字符串、挂载 `{ id, pluginName, state, provides, waitingFor }` ，以及卸载 `{ id, pluginName }` 。原生 renderer 会说明临时 Plugin 正在运行还是等待中，并说明它可用至被卸载或 DSH 重启；卸载结果确认它已移除。
规范成功结果 分别为检查字符串、挂载 `{ id, pluginName, state, provides, waitingFor }` ，以及卸载 `{ id, pluginName }` 。原生渲染会说明临时插件 正在运行还是等待中，并说明它可用至被卸载或 DSH 重启；卸载结果确认它已移除。
临时 Plugin 只存在于共享 DSH 进程内存中。它可跨后续 turn 保持活跃，也可能影响同一进程中的其他 session ，但会在 `cordis_unmount` 、工具集卸载或 DSH 重启后消失。它不会创建 Plugin 文件、安装 package、修改 `cordis.yml` 或个人／项目配置、跨重启存续，也不能自动转为正式 Plugin 。若要保留实验结果，应让 A gent 通过常规开发流程实现普通的本地、项目或仓库 Plugin 。
临时插件 只存在于共享 DSH 进程内存中。它可跨后续轮次 保持活跃，也可能影响同一进程中的其他会话 ，但会在 `cordis_unmount` 、工具集卸载或 DSH 重启后消失。它不会创建插件 文件、安装任何包（ package） `cordis.yml` 或个人／项目配置、跨重启存续，也不能自动转为正式插件 。若要保留实验结果，应让 a gent（智能体） 通过常规开发流程实现普通的本地、项目或仓库插件 。
## 信任立场
@@ -24,17 +24,17 @@
| 字段 | 默认值 | 含义 |
|---|---|---|
| `vmTimeoutMs` | `5000` | 临时 Plugin 代码求值中同步部分的边界；
| `vmTimeoutMs` | `5000` | 临时插件 代码求值中同步部分的边界；
## 生成的 API 目录
`src/api-catalog.ts` 由 `scripts/gen-cordis-api.ts` 生成，使用与 [docs/cordis-catalog ](../../../docs/cordis-catalog/services.md ) 相同的 AST 遍历，并由 `pnpm run verify-cordis-api` （位于 `doc-sync` 中）实施新鲜度门禁，绝不可手工编辑。`cordis_inspect` 在调用时把该目录与存活服务 store 取交集。宽泛的 `api` ／ `events` 报告只渲染摘要与签名；精确 `name` 会选择保留的方法／事件 JSDoc， 高声失败 。
`src/api-catalog.ts` 由 `scripts/gen-cordis-api.ts` 生成，使用与 [docs/cordis-catalog ](../../../docs/cordis-catalog/services.md ) 相同的 AST 遍历，并由 `pnpm run verify-cordis-api` （位于 `doc-sync` 中）实施新鲜度门禁，绝不可手工编辑。`cordis_inspect` 在调用时把该目录与存活服务 store 取交集。宽泛的 `api` ／ `events` 报告只渲染摘要与签名；精确 `name` 会选择保留的方法／事件 JSDoc， 明确报错 。
## 渲染
三个工具都渲染 `generic` 卡片（`read` ／ `execute` ／ `delete` ） ； `cordis_mount` 以 `rawInput` 携带临时 Plugin 代码。presenter 是 args 的纯函数；结果保留默认文本渲染。
三个工具都渲染 `generic` 卡片（`read` ／ `execute` ／ `delete` ） ； `cordis_mount` 以 `rawInput` 携带临时插件 代码。presenter 是 args 的纯函数；结果保留默认文本渲染。
## 导出形状
## 导出形式
Namespace 插件：命名导出 `name` ／ `inject` ／ `Config` ／ `apply` ，无默认导出（[docs/postmortem/0001 ](../../../docs/postmortem/0001-acp-default-export-drops-inject.md )）。
@@ -58,29 +58,29 @@ Namespace 插件：命名导出 `name`／ ／ ／
#### 模型看到的内容
检查会精确地用 `## <section>` 加换行及数据相关主体 来拼接选中区段，各区段之间留一个空行；`what: "temporary"` 使用 `## Temporary Plugins` 标题。每个临时 Plugin 行都会报告 running／ 、 提供与 等待的服务，以及持续至卸载或 DSH 重启的生命周期；空状态说明 `cordis_mount` Plugin 会在重启时消失。宽泛的 API／ ； `name` 配合 `what: "api"` 或 `what: "events"` 返回一个精确目标及其原始 JSDoc。挂载返回 `Temporary Plugin <id> is running (...)` 或 `Temporary Plugin <id> is pending (...)` ；卸载返回 `Temporary Plugin <id> was unmounted and removed.` 。提交的程序保留在 assistant 工具调用历史中。
检查会精确地用 `## <section>` 加换行及取决于数据的正文 来拼接选中区段，各区段之间留一个空行；`what: "temporary"` 使用 `## Temporary Plugins` 标题。每个临时插件 行都会报告 running／ ，以及其 提供和 等待的服务，以及持续至卸载或 DSH 重启的生命周期；空状态说明 `cordis_mount` 插件 会在重启时消失。宽泛的 API／ ； `name` 配合 `what: "api"` 或 `what: "events"` 返回一个精确目标及其原始 JSDoc。挂载返回 `Temporary Plugin <id> is running (...)` 或 `Temporary Plugin <id> is pending (...)` ；卸载返回 `Temporary Plugin <id> was unmounted and removed.` 。提交的程序保留在 assistant 工具调用历史中。
#### Token 影响
检查输出与挂载代码取决于数据，并在压缩前重复发送；生命周期确认文本很短。
检查输出与挂载代码取决于数据，并在压缩（ ）
#### KV Cache 影响
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 配置项 失效。
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目 失效。
### cordis_mount 后的后续请求
#### 模型看到的内容
临时 Plugin 可以注册工具、提示词贡献或监听器，改变其目标 scope 的后续请求；`cordis_unmount` 会在完全停稳后移除这些贡献。
临时插件 可以注册工具、提示词贡献或监听器，改变其目标 scope 的后续请求；`cordis_unmount` 会在完全停稳后移除这些贡献。
#### Token 影响
间接 token 影响等于临时 Plugin 的贡献，且只在其进程内生命周期内持续。
间接 token 影响等于临时插件 的贡献，且只在其进程内生命周期内持续。
#### KV Cache 影响
挂载或卸载提示词／工具贡献会改变后续请求前缀，并可能使从第一个变化的贡献起的复用失效；临时 Plugin 集合不变时，前缀保持稳定。
挂载或卸载提示词／工具贡献会改变后续请求前缀，并可能使从第一个变化的贡献起的复用失效；临时插件 集合不变时，前缀保持稳定。
## 已知限制与暂缓事项
Tianyi Cui