DSH 架构图：让 agent 画出一张可验证的系统图
Mermaid 给你一张图，archify skill 给你一份带类型的规格、一个自包含的交互式 HTML 架构图，以及一份校验回执——它的仓库里还写明了一条社区版 DeepSeek Harness 接入路径。下面是真实的一次「一句话生成」实录。
最近更新: 2026-11-12
Mermaid 代码块仍然是在对话里最快拿到一张图的办法，但它到图就停了。这一页讲的是下一步：agent 读你的仓库或你的描述，写出一份带类型的规格，渲染成一个自包含的交互式 HTML 架构图，并且在产物通过自己的检查之前拒绝交付。背后的 skill 叫 archify（tt-a1i/archify——我们 2026-09-27 核对时 72,468 stars），它的仓库里带了一套有文档的 DeepSeek Harness 接入方案。
看截图前先说清一件事：这段画面里没有出现 DeepSeek Harness 界面。出现的是作者的 GitHub 页面、archify 官网，以及一个通用 agent IDE 的分屏会话，所以请把它当成这个 skill 的产出与工作流记录，而不是 dsh 操作演示。下文所有命令与数字都在 2026-09-27 对照 github.com/tt-a1i/archify、它的 integrations/deepseek-harness README 与 npm registry 重新核对过。录屏里那个 GitHub 页面显示 'Starred 19.1k'，因为它是项目更早期录的。
结论速览
- ▸archify 是 agent skill，不是 dsh 内置功能。通用安装：npx skills add tt-a1i/archify -g；要在 dsh 里用，就装社区包：dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0。
- ▸不需要仓库也能起步，一句话就够。想要有来源支撑的图，就让 agent 分析仓库并给出 8–12 个核心组件、一条主路径、外部依赖与信任边界。
- ▸交付物是两个文件：一份带类型的架构规格，和一个自包含的交互式 HTML 架构图——打开、转发、导出都不需要装任何东西。
- ▸交付被回执卡住：9/9 showcase 检查、0 errors、0 warnings、visual_review passed、四种桌面宽度无溢出，外加规格与产物的 sha256。
Archify 在 GitHub 上：仓库、安装方式和这段时间的变化
Archify 是 agent skill，不是应用，也不是 dsh 的功能：把它装进你在用的 agent，描述系统或者让 agent 去读仓库，它就会写出一份带类型的规格，再渲染成一个自包含的交互式 HTML 图。仓库是 Apache-2.0，官网 archify.si，README 自己的一句话是「把你想理解、想规划或想分享的东西，变成可交互的可视化」。
下面这些数字是 2026-11-12 当天从 GitHub API、仓库 README 和 npm registry 读到的值，只代表那一天，不是实时计数。
仓库与包的状态，核实于 2026-11-12
- GitHub stars
- 95,759
- Fork
- 6,548
- 贡献者
- 86
- main 最新提交
- 7e45f36 · 2026-11-10
- Archify 最新发布
- v3.2.0 · 2026-10-19
- npm 上的 DSH 适配包
- @tt-a1i/archify-dsh@1.1.0 · 2026-11-08
- 适配包接受的宿主
- @deepseek-ai/dsh@0.2.1-rc.2
- npm 周下载量
- 14,465 · 2026-11-04 → 2026-11-10
在 DeepSeek Harness 里怎么装
仓库的 integrations/deepseek-harness README 只给了一条受支持的路径，而且随 1.1.0 改了：装精确版本，不要从 Git 源码装。
第 1 行把 Skill-only 的 bundle 装进 web profile，第 2 行是让 dsh 加载它的那句话，第 3 行是卸载。不要用 dsh plugin add tt-a1i/archify——仓库根目录不是 dsh 包（issue #341）。README 还强调两件事：适配包只接受 developer-preview 的 @deepseek-ai/dsh@0.2.1-rc.2；个人或项目里同名的 archify skill 优先级高于 bundle，所以升级插件不等于升级真正被加载的那个 skill，排查前先看实际加载的源路径。
integrations/deepseek-harness README
和 2026-09-27 那次核对相比，变了什么
- ▸stars 从 72,468 涨到 95,759，Fork 6,548，贡献者 86。录屏里的 19.1k 和正文里的 72,468 都是更早的读数，不是笔误。
- ▸DSH 适配包从 0.1.0 走到 1.0.0、再到 1.1.0：0.1.0 内置 Archify 2.14.0、对应宿主 0.1.0-rc.6（也就是下面 TL;DR 和分步教程里还写着的那个版本）；1.0.0 换成 Archify 3.0.1、宿主 0.1.2-rc.1；1.1.0 内置 Archify 3.2.0、接受 0.2.1-rc.2。
- ▸Archify 本体从 2.14.0 到 3.2.0：3.0 重做了阅读器并移除了引导视图和 story 视图（下面第 6 步截图里的引导章节是 2.x 时代的产物），3.1 把图类型扩到十种（ERD、Class、Tree、Timeline、Waterfall），3.2 增加了一页式 explainer。
- ▸协议：skill 转为 Apache-2.0，仓库现在标的也是 Apache-2.0；DSH 适配包仍是 MIT，包内保留 Skill 的 LICENSE 和 NOTICE。
- ▸通用安装命令也换了：README 不再以 npx skills add tt-a1i/archify -g 为主，而是让 agent 读 llms.txt，或者执行 npx -y skills@latest add https://archify.si --skill archify --agent <agent> --global --copy --yes；只想试试不安装可以用 npx skills use tt-a1i/archify@archify --agent codex。
- ▸1.1.0 还修了 #906：1.0.0 关掉了宿主的默认 skill 根目录，导致个人和项目 skill 消失，1.1.0 改回 includeDefaultRoots: true。
上面的 TL;DR、分步教程和原有 FAQ 的数字与措辞刻意保留在 2026-09-27，因为它们描述的是那支录屏。要看当前状态请看本节，装之前也自己再核一遍：宿主仍是 developer-preview，而 npm 上 dsh 的 latest 在 2026-11-12 已经是 0.2.2-rc.1，比适配包声明支持的版本更新。
从安装到拿到回执，一步一步来
装之前先弄清它到底是什么
- 1
先读仓库，再决定装不装
打开 github.com/tt-a1i/archify 看目录：179 次提交、25 个分支，有 .impeccable、benchmarks/ordinary-model-floor、experiments 这些目录——以及跟我们最相关的 integrations/deepseek-harness，它最近一条提交是 'ci(dsh): install acceptance runtime with pnpm'。About 一行把它定义为把可验证的架构图、工作流图、时序图、数据流图与生命周期图渲染成自包含 HTML 的 agent skill，标签里能看到 deepseek-harness、dsh-plugin 和 mermaid-alternative。
npx skills add tt-a1i/archify -g
先看目录：dsh 适配层在仓库里，不在 skill 核心里。跳到视频 2:40 - 2
装通用 skill，再决定要不要 dsh 社区包
通用安装路径同时支持 Cursor、Claude Code、Codex CLI 与 OpenCode。仓库另外写明了一条 DSH 社区接入：@tt-a1i/archify-dsh@0.1.0，一个只装 skill 的包，声明对 developer-preview 版 @deepseek-ai/dsh@0.1.0-rc.6 与 Node ^22.19.0 或 >=24.0.0 的实验性兼容，内置 Archify Skill 2.14.0，并在自己的 README 里明说这不是 DeepSeek 官方产品、也不代表 DeepSeek 背书。不要试 dsh plugin add tt-a1i/archify——仓库根目录没有 DSH 包元数据（issue #341）。另有一个第三方移植 GongYuanCaiJi/dsh-archify，2026 年 8 月创建，自述为移植自 tt-a1i/archify。
dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0Use the archify skill to map this repository's runtime architecture.
安装命令与它的适用边界，都写在 README 和 releases 页里。跳到视频 2:30
它承诺交付什么
- 3
先去官网确认输出形态
官网主标题是 'From plain English to architecture you can trust'，LIVE PROOF 面板播放的是真实生成出来的产物而不是效果图，下面还有三张可以点开看的样本：S-01 Agent Tool Call、S-02 Production Deployment、S-03 Cache Miss。真正值得记的是下面那排数字：5 种图类型、4 套视觉预设、2 套配好色的主题、4× 原生导出倍率——以及 0 依赖，这正是这个 HTML 能随手转发的原因。
05 DIAGRAM TYPES · 04 VISUAL PRESETS · 02 COORDINATED THEMES4× NATIVE EXPORT SCALE · 00 DEPENDENCIES
LIVE PROOF 播的是真实产物，计数器最后一项停在 00 依赖。跳到视频 0:48 - 4
先定图类型，再写提示词
画廊里列了五种视觉语言——Architecture、Workflow、Sequence、Data Flow、Lifecycle，而仓库里签入的 Proof Lab 有 11 个场景，连同它们的 JSON 源文件、命名视图与校验回执。画面上的 Architecture 例子是一条 Web 请求路径：CloudFront → Load Balancer → API Server → PostgreSQL，旁边挂着 S3、SQS 与一个 worker，图例统计出 2 个数据库、3 个云资源、1 个安全组、1 个消息总线、1 个外部系统。仓库也明确写了自动解析 Mermaid 不在范围内，所以类型要在提示词里说清楚，别指望它吞一个 .mmd 文件。
Architecture · Workflow · Sequence · Data Flow · LifecycleT-01 Architecture · T-03 Sequence · T-04 Data Flow · T-05 Lifecycle
带类型图例的 Architecture，同一画廊里还有 Sequence、Data Flow 与 Lifecycle。跳到视频 0:55
跑一次真实任务，连同那份回执
- 5
一句话下需求，然后逐行读校验回执
录屏里整句提示词就是「Archify 生成这个项目的架构图」。用时 2 分 44 秒，返回两件产物——架构图 HTML 与架构图规格，并在上面列出必须通过的检查：diagram_type: architecture、validation: 9/9 showcase, 0 errors, 0 warnings、visual_review: passed，以及 1440×900、1600×1000、1920×1080、2048×1320 四种桌面尺寸均无溢出。会话里还会打出 specification_sha256 与 artifact_sha256，diff 计数器显示规格被改动 +52 行、删除 0 行。
diagram_type: architecturevalidation: 9/9 showcase, 0 errors, 0 warningsvisual_review: passed桌面尺寸: 1440×900 · 1600×1000 · 1920×1080 · 2048×1320 均无溢出
2 分 44 秒、一句话，换来一份可以逐行读的回执。跳到视频 1:24 - 6
走一遍引导章节，看这张图到底主张了什么
生成的 HTML 自带作者写好的引导章节。第 3/3 章「WorkFlow 执行」按顺序走五个停靠点——Workflow Runtime、Child Session、Tool Surface、Runtime Evidence、Project Workspace——并放大到 145%，每个节点还带自己的细节标签：Child Session 是 in-process · bounded tools · fail-closed，Tool Surface 是 ordinary · package tools，Workflow Runtime 是 graph · runner · journal，Runtime Evidence 是 journal · artifacts · receipts。静态渲染给不了这一层；页面图例同时统计出 5 个后端节点、1 个数据库、1 个安全边界、1 个外部系统。
引导视图 3 / 3 · WorkFlow 执行01 Workflow Runtime → 02 Child Session → 03 Tool Surface → 04 Runtime Evidence → 05 Project Workspace
引导章节把图变成讲解动线，每个节点还保留自己的细节标签。跳到视频 2:06 - 7
把产物留在工作区，并把路径要回来
产物最后那三张卡——Pi-native composition、Runtime authority、Evidence boundary——是这张图在自我声明权力与证据的边界：session、模型、skill、信任与普通工具归 Pi 所有；子会话继承上下文，拿到的是 fail-closed 的工具交集；完成与否由终局证据确立，而不是界面标签。在 dsh 里还要记住这个包写明的限制：shell 命令创建的文件不会自动出现在 Web Produced Files 横条里，所以最后一句要请 agent 返回规格 JSON 与 HTML 产物在工作区里的确切路径。
After delivery, return the exact workspace paths of the specification JSON and the HTML artifact.
产物自己划了界：运行时拥有什么，什么才算证据。跳到视频 2:13
Mermaid 先画，要经得起评审时再上 archify
两者不是对手，而 archify 仓库对这条边界说得相当直白。
- ▸Mermaid 就地渲染，成本是一个代码块：适合随手就丢的草图，或者只需读一遍的时序。
- ▸Mermaid 的产出是一次渲染。你没法点节点、没法沿命名路径走、没法打开来源指针，也没法交给别人一份「这个产物可复现」的回执。
- ▸archify 自己就写着：'Archify is not a general-purpose drawing editor or a Mermaid theme'，而自动解析 Mermaid 被明确列在范围之外。
- ▸它换来的是另一套交付契约——带类型的 JSON IR，对 schema、布局、HTML/SVG、路径与标签到路径间距做原子化校验，检查不过时给出机器可读的修复回执。
- ▸一个可行的分工：对话里那张图用 Mermaid，要进设计评审、事故复盘或新人文档的那张图用 archify。
常见问题
这段画面真正会引出的问题，答案来自仓库与 npm registry 的实测。
DSH 有官方的架构图插件吗？
没有。dsh 这条路是社区接入，发布为 @tt-a1i/archify-dsh@0.1.0；它的 README 明说这不是 DeepSeek 官方产品、也不代表 DeepSeek 背书，目标是 developer-preview 的 @deepseek-ai/dsh@0.1.0-rc.6，内置 Archify Skill 2.14.0。另有一个第三方移植 GongYuanCaiJi/dsh-archify，2026 年 8 月出现，自述移植自 tt-a1i/archify。两者都是同一个 skill 外面的适配层。
视频里是 DeepSeek Harness 在跑 archify 吗？
不是。画面里是 GitHub 仓库页、archify 官网，以及一个分屏的 agent IDE 会话，dsh 的 Web 界面从未出现。它能证明的是这个 skill 的产出与作者的工作流，不是一次 dsh 会话。本页所有命令都来自仓库 README 或 npm registry，均在 2026-09-27 核对。
能把我现有的 Mermaid 图变成交互式产物吗？
不能自动完成。仓库把自动解析 Mermaid 明确列在范围之外，所以没有 .mmd 导入通道。你仍然可以用文字描述同一个系统，让 agent 据此写出带类型的规格。
「validation: 9/9 showcase, 0 errors, 0 warnings」到底证明了什么？
它证明产物与作者写的规格一致，并在这四种桌面宽度下通过了内置的 schema、布局、渲染、路径与标签到路径间距检查——所以这个文件可复现，也可以放心转发。它不证明架构本身是对的：图来自你或你的来源的描述，而且仓库自己也说明这类产物不会去探测线上基础设施。
Archify 的 GitHub 仓库在哪，还在维护吗？
在 github.com/tt-a1i/archify，Apache-2.0。仍在活跃维护：95,759 stars、6,548 Fork、86 位贡献者，main 上最后一次提交是 2026-11-10 的 7e45f36，Archify 最新发布 v3.2.0（2026-10-19），DSH 适配包 @tt-a1i/archify-dsh 1.1.0 于 2026-11-08 发布，截至 2026-11-10 那一周 npm 下载 14,465 次（均为 2026-11-12 核实）。需要打问号的是 DSH 这条路而不是仓库本身：适配包由社区维护，只接受 @deepseek-ai/dsh@0.2.1-rc.2，落后于 npm 上 dsh 的 latest（0.2.2-rc.1）。
相关教程
画出第一张可验证的图之后，往下看这些。
来源与署名
画面来源：下方署名的这一支 B 站视频，每一步都深链到对应秒数。本页所有命令与数字均在 2026-09-27 对照 github.com/tt-a1i/archify、它的 integrations/deepseek-harness README 与 npm registry 核对；录屏里的 GitHub 页面显示 19.1k stars，因为它是项目更早期录的。第一次接触 skill 这种形式？可以看 skill 编写指南