Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
docs(dsh): explain cordis patch execution boundary
杨嘉伟bb0e5e35e20e
diff --git a/integrations/deepseek-harness/README.md b/integrations/deepseek-harness/README.mdindex 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 dThe 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.+## InstallUse 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.mjsindex 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 snassert.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', () => {