← 返回列表
⚠ 装前注意
DeepSeek Harness 插件:用 JSON…
基本兼容但装前注意:未发布到 npm registry,仅可从源码安装 · 最近上游提交 2026/8/16 · 已提供中文文档
DeepSeek Harness 插件:用 JSON 规格生成可验证的架构图、流程图、时序图、数据流图与生命周期图(移植自 tt-a1i/archify)
综合分
34.1
GitHub 分
34.1
用户评分
—
★ Stars
8
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add GongYuanCaiJi/dsh-archify未发布到 npm registry,仅可从源码安装,改用 GitHub 源安装
数据截至 2026/9/18(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-archify(未发布到 npm,仅可源码安装)
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry,仅可从源码安装
验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 16:16:42
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
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 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 ^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. 卸载: dsh plugin --profile remove dsh-archify Produced Files 限制: shell 命令生成的文件不会自动出现在 Web 端的 Produced Files 栏, 请让 agent 返回规格 JSON 与 HTML 工件的精确工作区路径,再从工作区打开(上游官方 DSH 包同样如此)。 安全姿态: 无遥测、无网络客户端、无凭据处理、无后台服务;没有 install / postinstall / preinstall 生命周期钩子(仅 prepare 暂存技能文件)。 移植说明(对上游 tt-a1i/archify @ archify-dsh-v0.1.0) 逐字保留,diff 可验证:archify/(SKILL.md、renderers、schemas、bin、examples、recipes、 references、assets、delta、scripts、test)与根目录 examples/ 全部为上游原文件。 这一点你可以自己验,不必信我们 —— THIRD_PARTY_NOTICES.md 钉住了上游 release tag、commit 与逐字文件的 SHA-256,附可直接复制的比对命令; test/zero-regression.test.mjs 每次 npm test 都会重算比对。 适配处(上游官方 DSH 包 @tt-a1i/archify-dsh@0.1.0 → dsh-archify): 包名与解析路径改为 dsh-archify;新增 prepare(上游发预构建 tarball,git 安装需要 自行暂存 skills/);上游仓库根目录的网站/发布文件(docs/、README_EN.md、 README_ZH.md、benchmarks/、.github/ 等)不属于技能本体,未移植。 已知限制: 技能文案是英文 —— 那是上游原文,逐字保留未做翻译。 🛠 开发 npm install # prepare 暂存 skills/archify npm test # adapter 测试 + 技能自身测试(golden + 全部自包含单测) npm run test:skill # 只跑技能测试 node scripts/pack.mjs --out /tmp/dsh-archify.tgz # 本地打 tarball scripts/run-skill-tests.mjs 会跳过 19 个无法在移植仓库运行的技能测试:18 个绑定上游仓库 根目录网站/发布文件的测试(docs/、README_ZH.md、benchmarks/、ROADMAP.md、 .github/ 等,见文件内清单)加 1 个依赖 ajv devDependency 的 generate-validators.test.mjs(adapter 按上游安全姿态刻意保持零依赖;提交的 generated-validators.mjs 已由 THIRD_PARTY_NOTICES.md 钉住哈希并在每次 npm test 重验)。被跳过的测试文件本身仍在 archify/test/ 原样保留。 📄 License MIT。上游 tt-a1i/archify Copyright (c) 2026 tt-a1i (Archify),Copyright (c) 2025 Cocoon AI, 本移植 Copyright (c) 2026 GongYuanCaiJi (dsh port)。见 LICENSE。 感谢 tt-a1i 的原作者 —— 如果这个插件对你有用, 也请去给上游仓库点个 star。 English 简体中文 License DSH Upstream 一句话:一个用于 DeepSeek Harness 的图表绘制 agent 技能 —— 将一个小型带类型的 JSON 规范转换为经过校验的架构、工作流、时序、数据流或生命周期图,并作为自包含的 HTML 产物输出。 这是 tt-a1i/archify 的移植版(MIT,v2.14.0;与官方 @tt-a1i/archify-dsh@0.1.0 同源)。 技能载荷(archify/ 和 examples/)与上游逐字节一致;仅对 dsh 的打包与命名做了适配。 ✨ 特性 - 🗺️ 五种图表类型 —— 从一份 JSON 规范生成架构 / 工作流 / 时序 / 数据流 / 生命周期图 - ✅ 可验证 —— 确定性的 validate,提供 9 项检查的 showcase 或 basic 验收回执 - 🌗 主题与预设 —— 深色/浅色,外加 signal-flow / blueprint / editorial 视觉预设 - 📤 导出 —— 独立 HTML、PNG、SVG、WebM,以及 1200×630 分享卡片 - 🔀 Mermaid 输入 —— 粘贴 flowchart / sequenceDiagram / stateDiagram,重新编写为 Archify JSON - 🔍 架构对比 —— 用 compare 将两个快照对比为 Before / Delta / After HTML 📸 效果 描述一个系统,agent 会编写 JSON 规范并交付 HTML: Use the archify skill to map this repository's runtime architecture. write runtime.architecture.json ← agent authors the spec first bash node bin/archify.mjs validate architecture runtime.architecture.json --quality showcasebash node bin/archify.mjs deliver architecture runtime.architecture.json runtime.html --quality showcase → 交付 runtime.html(深色/浅色,可搜索,可分享) 📦 安装 bash dsh plugin --profile add github:GongYuanCaiJi/dsh-archify prepare 脚本会在安装时将 archify/ 暂存到 skills/ 中。如果 pnpm 阻止了构建步骤, 请将此包添加到该 profile 的 pnpm-workspace.yaml 中的 allowBuilds,然后重新运行。 从本地目录安装(先运行 npm install 以触发暂存): bash git clone https://github.com/GongYuanCaiJi/dsh-archify.git cd dsh-archify && npm install # prepare stages skills/ dsh plugin --profile add ../dsh-archify 需要 Node.js ^22.19.0 || >=24.0.0 和 dsh 0.1.0-rc.6。 🚀 用法 让 agent 按名称加载该 skill: text 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. 卸载: bash dsh plugin --profile remove dsh-archify Produced Files 限制: 由 shell 命令创建的文件不会自动出现在 Web Produced Files 条带中——请让 agent 返回规范 JSON 和 HTML 产物的确切工作区路径, 然后从工作区打开它们(与官方上游 DSH 包相同)。 安全态势: 无遥测、网络客户端、凭据处理或后台 服务;无 install / postinstall / preinstall 生命周期钩子(仅 prepare 暂存 skill 文件)。 移植说明(对比上游 tt-a1i/archify @ archify-dsh-v0.1.0) 字节级一致、可通过 diff 验证:archify/(SKILL.md、渲染器、schema、bin、示例、 recipes、references、assets、delta、scripts、test)以及根目录的 examples/ 均为上游文件。 自行验证——不要只听我们的一面之词——THIRD_PARTY_NOTICES.md 固定了上游发布标签、提交以及逐文件 SHA-256,并附有可直接复制粘贴的比较命令; test/zero-regression.test.mjs 会在每次 npm test 时重新检查这些固定值。 适配(官方 @tt-a1i/archify-dsh@0.1.0 → dsh-archify):包名和解析 路径;新增 prepare(上游提供预构建的 tarball;git 安装必须自行暂存 skills/); 上游仓库根目录的网站/发布文件(docs/、README_EN.md、README_ZH.md、 benchmarks/、.github/ 等)不属于 skill 载荷的一部分,未予移植。 已知限制: skill 副本为英文——那是上游的原始文本,逐字保留。 🛠 开发 bash npm install # prepare stages skills/archify npm test # adapter tests + skill's own tests (golden + self-contained units) npm run test:skill # skill tests only node scripts/pack.mjs --out /tmp/dsh-archify.tgz # 在本地构建一个 tarball scripts/run-skill-tests.mjs 会跳过 19 个无法在移植仓库中运行的技能测试:其中 18 个 绑定到上游仓库根目录的 website/release 文件(docs/、README_ZH.md、benchmarks/、 ROADMAP.md、.github/、……;完整列表在该文件内),再加上 generate-validators.test.mjs, 它需要 ajv devDependency,而适配器有意不携带该依赖(上游的安全策略;已提交的 generated-validators.mjs 在 THIRD_PARTY_NOTICES.md 中做了哈希固定,并在每次 npm test 时 重新校验)。被跳过的测试文件原封不动地保留在 archify/test/ 下。 📄 许可证 MIT。上游 tt-a1i/archify Copyright (c) 2026 tt-a1i (Archify)、Copyright (c) 2025 Cocoon AI, 本移植版本 Copyright (c) 2026 GongYuanCaiJi (dsh port)。参见 LICENSE。 感谢 tt-a1i —— 如果这个插件对你有用, 也请给上游仓库点个 star。
扫码进群