# archify

> Adds Archify diagram Skill to DeepSeek Harness: enables dsh to read repositories in conversations and generate five types of interactive system diagrams, outputting shareable HTML files.

## Metadata

- Author: [@tt-a1i](https://github.com/tt-a1i)
- Repo: <https://github.com/tt-a1i/archify.git>
- GitHub: [tt-a1i/archify](https://github.com/tt-a1i/archify)
- Stars: 14,684
- Language: HTML
- License: [MIT](https://spdx.org/licenses/MIT.html)
- Homepage: <https://tt-a1i.github.io/archify/>
- Topics: `agent-skills`, `architecture-as-code`, `architecture-diagram`, `claude-skill`, `code-visualization`, `codex`, `coding-agents`, `data-flow-diagram`, `deepseek-harness`, `developer-tools`, `diagram-as-code`, `diagrams`, `diagrams-as-code`, `dsh-plugin`, `mermaid-alternative`, `opencode`, `sequence-diagram`, `software-architecture`, `system-design`, `text-to-diagram`
- Forks: 1,056
- Open Issues: 19
- Last push: 2026-08-20T12:16:54.000Z
- Added: 2026-08-20T00:00:00.000Z

## Install

```bash
dsh plugin --profile web add github:tt-a1i/archify/integrations/deepseek-harness
```

## Wiki

## 一句话定位
把 Archify 技术图 Skill 挂到 DeepSeek Harness 上，让 dsh 在聊天里读取代码、产出五种带校验的交互式系统地图（架构/工作流/时序/数据流/生命周期），最终生成可分享的自包含 HTML 文件。

## 核心能力
- 注入 Archify 文件系统 Skill，让 dsh 加载现成的架构图技能包
- 读仓库生成五种交互式系统地图（架构、序列、工作流、数据流、生命周期）
- 输出的图全部带 typed JSON 校验，确保结构自洽后再渲染
- 导出可分享的单文件 HTML，支持搜索节点、上下游追溯、暗/亮主题切换
- 提供 Before/Delta/After 差异视图，便于评审架构改动
- 通过 shell 写出 JSON 与 HTML 产物到工作区，无需启动额外服务

## 技术实现
- **语言**: JavaScript (ESM)
- **关键依赖**: 无运行时依赖；仅依赖 Node 内置模块 `node:module`、`node:path`
- **架构模式**: DSH bundle patch（`cordis.patch.yml`）——通过 `insert` 指令向宿主注入一个名为 `archify-plugin` 的文件系统 Skill Provider，由 `@deepseek-ai/dsh-skill-filesystem` 实现
- **入口文件**: `integrations/deepseek-harness/lib/index.js`（仅导出 `resolveArchifySkillRoot` 纯函数，把安装包内的 `skills/` 目录解析到 DSH profile）

## 适用场景
想在 dsh 里直接和 agent 对话，让它把一个仓库画成可分享的架构图，而不必自己装额外桌面工具、复制 prompt 或手动跑 CLI 的用户。适配器适合那些已经把 dsh 当日常 Agent 工作台、又需要给同事或 PR 评审方提供"看一眼就懂"的系统全景的人。

## 前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DeepSeek Harness (DSH) | `@deepseek-ai/dsh@0.1.0-rc.6` | 仅在开发者预览版验证，不代表跨版本稳定承诺 |
| Node.js | `^22.19.0` 或 `>=24.0.0` | 适配器使用 `node:module` 内置 API |
| 运行平台 | macOS / Windows / Linux | 源码无平台相关调用 |
| 原生模块 | 无 | `package.json` 不声明 `dependencies`、`peerDependencies` 或 `optionalDependencies` |

## 安装方式
```bash
dsh plugin --profile web add github:tt-a1i/archify/integrations/deepseek-harness
```

## 配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| providerName | string | 在 DSH 内部标识这个 Skill 包的来源名字 | `archify-plugin` |
| includeDefaultRoots | boolean | 是否同时加载 Skill 文件系统自带的默认目录 | `false`（仅使用本插件打包的目录） |
| bundledSkillDir | path | Archify Skill 文件在已安装 npm 包内的绝对路径，启动时由 `createRequire` 解析得出 | 安装后自动定位到包内 `skills/` |

适配器自身不暴露用户级配置入口；以上三栏由 `cordis.patch.yml` 注入到宿主，无需在安装后手动调整。

## 常见问题

**Q: 这个插件是 DeepSeek 官方出品的吗？**

A: 不是。仓库首页和插件 README 都明确标注 "Community integration" 和 "not an official DeepSeek product"，仅在开发者预览版 dsh 上验证可用，不代表跨版本稳定承诺。

**Q: 安装之后我怎么调用它？**

A: 在 dsh 对话里直接说 "Use the archify skill to map this repository's runtime architecture" 或其中文表述，agent 就会加载 Archify Skill，按 typed JSON 生成校验过的图。Skill 内部命令需要 shell 权限（validate / deliver / preview）。

**Q: 生成的图为什么不出现在 dsh Web 的 Produced Files 列表里？**

A: 因为 Archify 通过 shell 写出 HTML/JSON，不会自动进入 Produced Files 通道。需要让 agent 在交付完图后，把生成的 specification JSON 和 HTML 的精确工作区绝对路径返回给你，你从工作区里直接打开。

**Q: 这个适配器会在我电脑上偷偷开端口、上报数据或读我的 key 吗？**

A: 不会。`integrations/deepseek-harness/lib/index.js` 只有一个纯函数 `resolveArchifySkillRoot`，整库没有 `child_process`、`fetch`、`setInterval`、`Worker`、`process.env.*TOKEN` 等关键词（`adapter-security.test.mjs` 强制断言）。没有 telemetry、没有网络请求、没有 prepare/install/postinstall 钩子。

**Q: 卸载命令是什么？**

A: `dsh plugin --profile web remove @tt-a1i/archify-dsh`。它只会移除适配器与 Skill 注入，不会删除你之前生成的图文件。

**Q: 升级 dsh 之后还能用吗？**

A: 适配器当前仅在开发者预览版 `@deepseek-ai/dsh@0.1.0-rc.6` 上验证，README 明确写 "It is not a stable cross-version guarantee"。等 dsh 进入正式版本后需要看适配器是否同步发布新版。

**Q: 我可以同时保留别的 Skill 或自定义目录吗？**

A: 注入配置里 `includeDefaultRoots` 默认为 `false`，只暴露本插件打包的 `skills/` 目录；如果你已经在 dsh profile 里挂了别的 Skill Provider，它们互不影响。

## 上手难度
入门 — 用户只需在 dsh 对话里用一句英文（或其中文版本）触发即可，Skill 内部命令由 agent 自动调度。

## 已知问题与限制
- 仅在开发者预览版 `@deepseek-ai/dsh@0.1.0-rc.6` 上验证，README 明确说明不代表跨版本稳定承诺
- 通过 shell 产出的 JSON / HTML 不会自动进入 dsh Web 客户端的 Produced Files 通道，需要让 agent 返回精确工作区路径
- 适配器不注册 render / validate / deliver 工具，Archify 的内部命令必须由 agent 在 Skill 流程里调度，用户无法手工调用
- v0.1.0 与上游 Archify 主线版本（v2.15.0）解耦，更新节奏可能滞后

---

This document is auto-generated by [deepseek-plugin.org](https://deepseek-plugin.org). HTML page: [archify](https://deepseek-plugin.org/plugins/tt-a1i/archify/integrations/deepseek-harness)
Wiki generated by AI (model: `MiniMax-M3`)