Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

docs(dsh): explain cordis patch execution boundary

杨嘉伟bb0e5e35e20e
diff --git a/integrations/deepseek-harness/README.md b/integrations/deepseek-harness/README.md
index 9f575378..a646ad6f 100644
--- a/integrations/deepseek-harness/README.md
+++ b/integrations/deepseek-harness/README.md
@@ -10,6 +10,12 @@ The pending **v0.2.0** release is prepared for experimental compatibility with d
The adapter registers no native render/validate/deliver tools, custom Web client, Produced Files chips, telemetry, credentials handling, background services, or install hooks. The pending v0.2.0 Skill includes an optional, notification-only stable Archify update checker; it never upgrades the plugin. Authored remote brand assets may also use the Skill's bounded network path. The adapter itself makes no network requests.
+## Patch execution boundary
+
+The `cordis.patch.yml` file is configuration consumed by the DSH host. Its `bundledSkillDir` value uses the host loader's `!!js` expression to resolve the installed package's `skills` directory when the entry is activated. This expression runs in the DSH host process, outside the agent sandbox; it is not an inert YAML value and should be treated as host-loaded code.
+
+The current expression is intentionally limited to Node's built-in `path` and `module` helpers for package resolution. It does not fetch data, read credentials, spawn processes, or register another permission path. The normal `lib/index.js` resolver documents the same package-root logic, but the filesystem provider is mounted directly by the patch, so that module is not the activation hook for this bundle. Keep the published install exact-pinned and review any patch change as host-process code.
+
## Install
Use the prebuilt npm package with an exact version. Do not install from Git source.
diff --git a/integrations/deepseek-harness/test/docs-contract.test.mjs b/integrations/deepseek-harness/test/docs-contract.test.mjs
index 07fc3778..a7f34fdf 100644
--- a/integrations/deepseek-harness/test/docs-contract.test.mjs
+++ b/integrations/deepseek-harness/test/docs-contract.test.mjs
@@ -45,6 +45,10 @@ test('DSH documentation identifies the published release and pinned candidate sn
assert.match(integration, /repository root is not a DSH package/);
assert.match(integration, /current adapter Git HEAD blob/);
assert.match(integration, /working-tree edits are not package inputs/);
+ assert.match(integration, /`cordis\.patch\.yml` file is configuration consumed by the DSH host/);
+ assert.match(integration, /`!!js` expression to resolve the installed package's `skills` directory/);
+ assert.match(integration, /runs in the DSH host process, outside the agent sandbox/);
+ assert.match(integration, /does not fetch data, read credentials, spawn processes, or register another permission path/);
});
test('English and Chinese docs cover install, invoke, uninstall, community wording, and Produced Files', () => {