跳到主内容

deepseek-harness 使用指南

为 DeepSeek Harness 注入 Archify 技术图 Skill:让 dsh 在对话里读仓库生成五种交互式系统地图,产出可分享的 HTML 文件。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

archify

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @tt-a1i/archify-dsh

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Open it and present — five diagram types, four presets, dark/light themes, built-in brand marks, and finite motion
  • Review architecture changes before merge — compare two validated snapshots as Before / Delta / After, with exact added, removed, changed, moved, and rerouted facts
  • One file, ready to trust and share — typed JSON IR and deterministic checks produce self-contained HTML plus PNG, SVG, WebM, and 1200×630 share cards
  • Typed JSON IR — every renderer-backed mode has a schema and reproducible source.
  • Atomic validation before delivery — schema, layout, HTML/SVG, route, and label-to-route clearance checks must all pass before a showcase artifact replaces the last known good output.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是 DeepSeek 官方出品的吗?

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

安装之后我怎么调用它?

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

生成的图为什么不出现在 dsh Web 的 Produced Files 列表里?

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

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

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

卸载命令是什么?

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

升级 dsh 之后还能用吗?

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

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6
  • Node: ^22.19.0 || >=24.0.0
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则