前言¶
在 DeepSeek Harness（DSH）里做架构说明、工作流梳理或序列图时，若只靠模型口头描述，很难得到可校验、可导出、可在浏览器里交互查看的成品。社区里已有把 Archify 适配成 DSH 插件的做法，但公开包里的 Skill 版本与上游稳定发布并不总是一致。下面介绍维护者 ya123-4 发布的 archify-skill-dsh：一个仅挂载文件系统 Skill 的 bundle，把上游 Archify 3.0.1 原样打进插件，供智能体生成架构图、工作流图、序列图、数据流图与生命周期图。
这是什么¶
archify-skill-dsh 是 DeepSeek Harness 的插件包（npm 包名 archify-skill-dsh，当前版本 3.0.1，MIT）。它不包含原生 render/validate/deliver 工具、Web 客户端、遥测或安装钩子，只做一件事：通过 @deepseek-ai/dsh-skill-filesystem 注册名为 archify-plugin 的 Skill 提供者，根目录指向包内 skills/archify/（上游 tt-a1i/archify 的 3.0.1 发布物，106 个文件与官方 archify.zip SHA256 一致）。
与 npm 上的 @tt-a1i/archify-dsh@0.1.0（内嵌 Skill 2.14.0）相比，本包明确以已发布的 3.0.1 稳定 Skill 为唯一载荷，不夹带开发快照。
社区目录页：ya123-4/archify-skill-dsh。源码与说明：GitHub。
核心功能（Archify Skill 能力）¶
资料中核实到的能力均来自内嵌 Archify 3.0.1 Skill，而非 bundle 额外注册的工具：
- 图类型：架构、工作流、序列、数据流、生命周期等 diagram。
- 输出形态：校验后的独立 HTML（内联 SVG），支持明暗主题、可选 trace 动效；可导出 PNG、JPEG、WebP、SVG、WebM。
- 输入方式：自然语言需求、粘贴 Mermaid，或在需要反映真实代码结构时结合仓库证据。
- 命令行入口（Skill 内）：例如
archify doctor、archify demo <dir>、archify finalize architecture … --quality showcase --json；在 DSH 44.0.0 / Node 24.21.0 桌面 profile 下，文档记录的validate、deliver、check、browser-check均可通过（无 Chromium 时browser-check为 skipped，见下文）。
Bundle 自身主要文件：
| 路径 | 作用 |
|---|---|
cordis.patch.yml |
插入 Skill 文件系统提供者，bundledSkillDir 指向本包 skills/ |
skills/archify/ |
上游 3.0.1 完整 Skill 目录 |
package.json |
声明 dsh.bundle.patch 与 npm 发布文件列表 |
安装与启用¶
官方 README 未提供 dsh plugin add github:… 一类 CLI 安装串；安装方式为 本地 tarball + GUI。
从 Release 或本地打包¶
- 在 GitHub Releases 下载
archify-skill-dsh-*.tgz，或在仓库根目录自行打包：
npm pack
- 打开 DSH：Sidebar → Plugins → Add plugin。
- 在对话框中粘贴
.tgz的绝对路径（也支持包名、Git 地址或本地路径，以 GUI 说明为准）。 - 点击 Install。热更新会应用到当前 composition，无需重启 DSH。
与手动 Skill 冲突¶
若本机仍存在用户级 Skill 目录 ~/.dsh/skills/archify/，会与 bundle 内同名 Skill archify 由两个提供者同时服务（用户根 rank 400、bundle 根 rank 600）。安装前应 只保留一种：要么删掉用户级目录，要么不要同时安装本插件。
运行环境：package.json 要求 Node >= 18。
典型用法¶
安装后，DSH 会在 catalog 中发现 Skill 名称 archify，基目录位于类似 …/node_modules/archify-skill-dsh/skills/archify 的路径（以实际安装位置为准）。智能体按 Skill 文档调用即可；维护者在仓库中用下列命令做过验收：
健康检查：
node skills/archify/bin/archify.mjs doctor
或在包根目录：
npm run check
演示与 finalize（示例来自 README 验证表）：
archify demo <dir>
archify finalize architecture … --quality showcase --json
finalize 与 browser-check 会驱动 基于 Chromium 的浏览器。若环境中找不到浏览器，browser-check 会 skipped（退出码 2），并出现 viewer/chrome-unavailable 警告；其余门禁仍可通过。在 Windows 上可用 Edge，且需在 启动 DSH 宿主进程的环境 中设置：
$env:ARCHIFY_CHROME = 'C:\Program Files (x86)\Microsoft Edge\Application\msedge.exe'
缺少浏览器属于环境限制，不是 bundle 缺陷。
卸载与升级 Skill 版本¶
卸载：Plugins 页面 → 该 bundle 卡片 → Uninstall。会移除 profile 依赖与 bundle 层，基础 profile 仍可用。
跟随上游升级 vendored Skill（维护者流程，供 fork 或自建包参考）：
- 从上游 release 下载官方
archify.zip，用其内容替换skills/archify/。 - 将 package
version与 Skill 版本对齐。 - 运行
npm run check；可选重复 README 中的 finalize 验证。 npm pack后通过 GUI 安装新 tarball。
适用场景与注意¶
适合谁：已在 DSH 中开发智能体、需要 可交付、可校验的架构/流程类 SVG/HTML 图，且希望固定使用 Archify 3.0.1 而非旧版适配包的用户。
安全与权限：插件以当前 DSH 进程权限运行；cordis.patch.yml 中的 bundledSkillDir 为 !!js 表达式，在宿主进程中求值（非 agent sandbox 内），仅使用 Node 内置 path/module 解析本包 skills 目录，不联网、不读凭据、不 spawn 进程。安装前仍建议阅读 源码 与 MIT 许可证；内嵌 Skill 及第三方声明见仓库内 skills/archify/THIRD_PARTY_NOTICES.md。
生态说明：DSH 社区插件目录（如 skillhub.cn）是独立站点，与 DeepSeek / 幻方无官方从属关系；本稿分类线索为「模型推理」，插件实质是 Skill 文件系统 bundle，能力侧重 diagram 生成与交付。
结尾¶
archify-skill-dsh 把 Archify 3.0.1 以最小 bundle 形式接入 DSH：无额外原生工具，安装后 catalog 即出现 archify Skill，适合需要稳定 3.x Skill 载荷的 diagram 工作流。更多信息见 目录页 与 GitHub 仓库。
