dsh-archify

简体中文 | English

一句话：给 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  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  add ../dsh-archify

环境要求：Node.js ，dsh 。