How to use archify
Adds Archify diagram Skill to DeepSeek Harness: enables dsh to read repositories in conversations and generate five types of interactive system diagrams, outputting shareable HTML files.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
archify
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add @tt-a1i/archify-dsh
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
- Open it and present — five diagram types, four presets, dark/light themes, built-in brand marks, and finite motion
- Review architecture changes before merge — compare two validated snapshots as Before / Delta / After, with exact added, removed, changed, moved, and rerouted facts
- One file, ready to trust and share — typed JSON IR and deterministic checks produce self-contained HTML plus PNG, SVG, WebM, and 1200×630 share cards
- Typed JSON IR — every renderer-backed mode has a schema and reproducible source.
- Atomic validation before delivery — schema, layout, HTML/SVG, route, and label-to-route clearance checks must all pass before a showcase artifact replaces the last known good output.
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
Is this plugin officially produced by DeepSeek?
No. Both the repository homepage and the plugin README clearly label it as "Community integration" and "not an official DeepSeek product". It has only been verified to work on the developer preview version of dsh and does not represent a stable cross-version commitment.
How do I invoke it after installation?
Just say "Use the archify skill to map this repository's runtime architecture" (or its Chinese equivalent) in the dsh conversation, and the agent will load the Archify Skill to generate a validated diagram based on typed JSON. The internal Skill commands require shell permissions (validate / deliver / preview).
Why doesn't the generated diagram appear in dsh Web's Produced Files list?
Because Archify writes HTML/JSON through shell and does not automatically enter the Produced Files channel. You need to ask the agent to return the exact workspace absolute paths of the generated specification JSON and HTML after delivering the diagram, and then open them directly from the workspace.
Will this adapter secretly open ports, report data, or read my key on my computer?
No. integrations/deepseek-harness/lib/index.js contains only a pure function resolveArchifySkillRoot, and the entire codebase has no keywords like child_process, fetch, setInterval, Worker, process.env.*TOKEN (enforced by adapter-security.test.mjs assertions). There is no telemetry, no network requests, and no prepare/install/postinstall hooks.
What is the uninstall command?
dsh plugin --profile web remove @tt-a1i/archify-dsh. It will only remove the adapter and Skill injection, and will not delete the diagram files you previously generated.
Will it still work after upgrading dsh?
The adapter is currently only verified on the developer preview version @deepseek-ai/[email protected], and the README explicitly states "It is not a stable cross-version guarantee". After dsh enters the official version, you will need to check if the adapter has released a new version accordingly.
— source: plugin_wiki.faq_json
Compatibility
- DSH: 0.1.0-rc.6
- Node: ^22.19.0 || >=24.0.0
- Platforms: macOS, Windows, Linux
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule