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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则