GongYuanCaiJi/dsh-archify

Plugin插件 Native原生 ⭐ 9 MIT Data & Analysis数据与分析

移植自 tt-a1i/archify(MIT,v2.14.0,官方 DSH 包 @tt-a1i/archify-dsh@0.1.0 同源同版本)。 技能本体(archify/ 与 examples/)逐字保留,只适配了 dsh 的打包与命名。

catalog descriptioncatalog 简介 / catalog description:DeepSeek Harness 插件:用 JSON 规格生成可验证的架构图、流程图、时序图、数据流图与生命周期图(移植自 tt-a1i/archify)

Project Overview项目介绍

dsh-archify is a diagramming agent skill built natively for DeepSeek Harness, ported verbatim from the upstream tt-a1i/archify project. It lets AI agents generate validated diagrams including architecture, workflow, sequence, data flow, and lifecycle diagrams from a simple JSON specification, outputting a self-contained HTML file as the final artifact. To install from GitHub directly, run the command dsh plugin --profile <your profile> add github:GongYuanCaiJi/dsh-archify in your terminal. If you need to install from a local clone, clone the repo first, run npm install to stage the skill files, then add the local path to your DSH profile.

Once installed, you can ask your DSH agent to load the archify skill by name, and provide a clear description of the diagram you need. For example, you can prompt the agent to map the runtime architecture of a target repository, specify 8 to 12 core components, mark external dependencies and trust boundaries, then output the final HTML. The agent will follow the standard workflow: first write the JSON specification, run validation on it, then generate the final HTML artifact. This plugin is ideal for software developers and solution architects who need AI-assisted diagram generation for system design and documentation.

This plugin is released under the permissive MIT license, with all upstream copyright retained by the original authors. It has a strict security posture with no telemetry, no network client code, no credential handling, and no background services. The only lifecycle hook included is prepare to stage the skill files, no preinstall or postinstall hooks that could run unexpected code. It requires Node.js version 22.19.0 or newer, and DSH version 0.1.0-rc.6 or newer. One known limitation is that all skill documentation remains in English as the upstream original.

dsh-archify 是一款专为 DeepSeek Harness 打造的原生绘图 agent 技能插件,移植自 tt-a1i/archify 项目,核心能力是基于 JSON 规格生成可验证的架构图、流程图、时序图、数据流图与生命周期图,最终输出独立的 HTML 文件。它支持五种图型,可在生成前对规格做确定性校验,提供多种视觉主题切换,支持多格式导出,还能转换输入的 Mermaid 代码做美化,也可对比两份架构快照输出对比图。

用户可以在 DSH 中直接通过官方命令安装,安装方式支持从 GitHub 仓库拉取,也支持从本地克隆目录安装。使用时只需要让 agent 加载 archify 技能,给出绘图需求,比如绘制仓库的运行时架构,agent 会先编写 JSON 规格文件,再通过校验命令验证规格,最后生成交付独立的 HTML 文件。这款插件适合需要让 AI 辅助生成各类技术架构图、梳理系统逻辑的开发者和架构师使用。

本插件采用 MIT 许可证开源,所有核心技能文件逐字保留上游内容,仅做 DSH 打包适配,可通过 SHA-256 校验验证无修改。它无遥测、无网络客户端、无后台服务,仅保留 prepare 脚本暂存技能文件,没有额外的安装钩子。环境要求 Node.js 版本 ^22.19.0 或 >=24.0.0,DSH 版本不低于 0.1.0-rc.6,已知限制为技能文案为英文未翻译。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:GongYuanCaiJi/dsh-archify

把 GongYuanCaiJi/dsh-archify 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-archify

简体中文 | English

License DSH 上游

一句话:给 DeepSeek Harness 一个会画图的 agent 技能 —— 用 JSON 规格生成可验证的架构图、流程图、时序图、数据流图与生命周期图,输出独立 HTML。

移植自 tt-a1i/archify(MIT,v2.14.0,官方 DSH 包 @tt-a1i/archify-dsh@0.1.0 同源同版本)。 技能本体(archify/ 与 examples/)逐字保留,只适配了 dsh 的打包与命名。

✨ 功能

  • 🗺️ 五种图型 —— architecture / workflow / sequence / dataflow / lifecycle,一个 JSON 规格对应一种
  • ✅ 可验证 —— 提交前跑 validate,确定性校验给出 9 项验收(showcase)或基础验收(standard)
  • 🌗 深浅主题 + 视觉预设 —— classic 默认,signal-flow / blueprint / editorial 按需切换
  • 📤 多格式导出 —— 独立 HTML、PNG、SVG、WebM,以及 1200×630 分享卡片
  • 🔀 Mermaid 输入 —— 粘贴 flowchart / sequenceDiagram / stateDiagram,转为 Archify JSON 再美化
  • 🔍 架构对比 —— compare 两份快照,输出 Before / Delta / After 三态 HTML

📸 效果

给一个场景描述,agent 产出 JSON 规格并交付独立 HTML:

> 用 archify 画这个仓库的运行时架构,8–12 个核心组件,一条主路径,标出外部依赖与信任边界。

  write  runtime.architecture.json      ← agent 先写规格
  bash   node bin/archify.mjs validate architecture runtime.architecture.json --quality showcase
  bash   node bin/archify.mjs deliver architecture runtime.architecture.json runtime.html --quality showcase
  → 交付 runtime.html(深浅主题、可搜索、可分享)

📦 安装

dsh plugin --profile <你的 profile> add github:GongYuanCaiJi/dsh-archify

安装时会通过 prepare 脚本把 archify/ 暂存为 skills/。若 pnpm 拦下构建步骤,在 profile 的 pnpm-workspace.yaml 里把本包加进 allowBuilds,再重跑一次。

从本地目录安装(需要先执行 npm install 触发暂存):

git clone https://github.com/GongYuanCaiJi/dsh-archify.git
cd dsh-archify && npm install        # prepare 产出 skills/
dsh plugin --profile <你的 profile> add ../dsh-archify

环境要求:Node.js ^22.19.0 || >=24.0.0,dsh 0.1.0-rc.6。

🚀 用法

让 agent 按名字加载技能:

Use the archify skill to map this repository's runtime architecture.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.
After delivery, return the exact workspace paths of the specification JSON and the HTML artifact.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-connect-qoder 下一个 Next dsh-vision →