interactive-code-map 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

interactive-code-map 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

interactive-code-map 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

interactive-code-map 还在维护吗？

GitHub 7 星。最近一次上游提交在 2026/10/10。

交互证据图谱 YuLaiZ/interactive-code-map

DeepSeek Harness

YuLaiZ24 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

一个跨客户端 skill，将代码库证据或非代码业务流程描述转换为单个可交互的 HTML 证据图谱；它用结构化…

37.1/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/10 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。以下命令仍可尝试，但可能失败。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add YuLaiZ/interactive-code-map

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么

dsh 原生插件 · vision

装得上吗

作者未把包发布到 npm，只能用源码安装

插件本身没问题，是分发方式不同

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 24 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包interactive-code-map（未发布到 npm，仅可源码安装）

✓Node 引擎要求 >=20 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/31 04:49:07

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件

查看扫描证据（共 13 处，展示前 10 条）

读取本地文件
playwright.config.mjs:9
|| (!process.env.CI && process.platform === 'darwin' && existsSync(macChrome) ? macChrome : undefined);
读取本地文件
skill/renderer/build-html.mjs:31
const template = readFileSync(path.join(directory, 'template.html'), 'utf8');
读取本地文件
skill/renderer/build-html.mjs:32
const renderSource = readFileSync(path.join(directory, 'render.js'), 'utf8');
读取本地文件
skill/renderer/build-html.mjs:33
const encoderSource = readFileSync(path.join(directory, 'mermaid-encoder.mjs'), 'utf8');
读取本地文件
skill/renderer/build-html.mjs:34
const sequenceEncoderSource = readFileSync(path.join(directory, 'mermaid-sequence-encoder.mjs'), 'utf8');
读取本地文件
skill/renderer/build-html.mjs:35
const dslSource = readFileSync(path.join(directory, 'mapspec-to-mermaid.mjs'), 'utf8');
读取本地文件
skill/renderer/build-html.mjs:36
const sequenceDslSource = readFileSync(path.join(directory, 'mapspec-to-mermaid-sequence.mjs'), 'utf8');
写入本地文件
skill/renderer/build-html.mjs:256
writeFileSync(descriptor, content);
写入本地文件
skill/renderer/build-html.mjs:259
renameSync(tmpPath, outPath);
删除本地文件
skill/renderer/build-html.mjs:269
unlinkSync(tmpPath);

扫描于 2026/11/2（1 天前） · 范围全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

2 张 · 点击查看大图

功能亮点

生成可交互HTML图谱
支持代码库证据
支持业务流程描述

跨客户端 AI 技能，把代码库和业务流程转成带证据的交互式流程图与时序图

README

由 DeepSeek 最新模型翻译生成

interactive-code-map 一个跨客户端 skill，将代码库证据或非代码业务流程描述转换为单个可交互的 HTML 证据图谱；它用结构化 MapSpec 分离调研与展示，并显式呈现证据状态。每张图谱按问题选择图型：结构与依赖读作流程图，而"谁在什么时刻调谁"类的交互（请求/响应、回调重试、协议握手）读作带逐消息证据的时序图。效果演示流程图交互式证据图谱演示：缩放、拖动、关系高亮、点击钉住与行号证据时序图按调用顺序阅读，查看条件分支，并打开消息背后的源码证据。时序图演示：阅读视图、缩放、平移、消息证据、单选中高亮与全图概览在线 Demo - 中文 Demo（流程图） - 中文时序 Demo - English demo - English sequence demo 安装可安装包是仓库中的 skill/ 目录，必须保持其完整，包含 SKILL.md、SKILL.zh-CN.md、renderer/ 与 references/。随包提供供安装者阅读的 Skill 中文译本；skill/SKILL.md 仍是唯一执行入口。

展开完整文档（README 剩余 1 节）

interactive-code-map

一个跨客户端 skill，将代码库证据或非代码业务流程描述转换为单个可交互的 HTML 证据图谱；它用结构化 MapSpec 分离调研与展示，并显式呈现证据状态。每张图谱按问题选择图型：结构与依赖读作流程图，而"谁在什么时刻调谁"类的交互（请求/响应、回调重试、协议握手）读作带逐消息证据的时序图。

效果演示

流程图

交互式证据图谱演示：缩放、拖动、关系高亮、点击钉住与行号证据

时序图

按调用顺序阅读，查看条件分支，并打开消息背后的源码证据。

时序图演示：阅读视图、缩放、平移、消息证据、单选中高亮与全图概览

在线 Demo

- 中文 Demo（流程图）
- 中文时序 Demo
- English demo
- English sequence demo

安装

可安装包是仓库中的 skill/ 目录，必须保持其完整，包含 SKILL.md、SKILL.zh-CN.md、renderer/ 与 references/。

随包提供供安装者阅读的 Skill 中文译本；skill/SKILL.md 仍是唯一执行入口。

任何支持 skill 的 Agent 客户端

任何能安装 skill 的 Agent 客户端都可以使用它——包括 Codex、ZCode、Claude Code、Claude Desktop Code、WorkBuddy 与 DeepSeek Harness。可把下面这段话直接发送给你的客户端：

请获取 https://github.com/YuLaiZ/interactive-code-map。使用当前客户端支持的 skill 安装机制，将其中的 skill/ 目录安装为 interactive-code-map skill；保持该目录完整，包含 SKILL.md、SKILL.zh-CN.md、renderer/ 与 references/。确认该 skill 可被发现，且能生成相对路径的 HTML 图谱。若当前客户端不能自行安装 skill，请报告准确的手工导入步骤；不要猜测内部目录，也不要创建软链接。

每个客户端自行管理安装位置，并不存在可移植的共享目录。这段指令是首选通用入口：由客户端选择其受支持的安装方式，不把机器专属路径写进项目。

本地或离线 checkout

当 Agent 已以本仓库作为工作区时，把上面指令的首句替换为：请把当前工作区的 skill/ 目录安装为 interactive-code-map skill。 其余完整性与降级要求不变。

只有当客户端明确支持、且你希望开发目录改动实时可见时，才使用开发态软链接；它不是发布安装合同。

手动生成 HTML 图谱

根据已检查的代码或资料创建 MapSpec 后，用选定证据根校验 verified 证据，并生成相对输出路径：

~~~bash
node skill/renderer/build-html.mjs \
--in path/to/mapspec.json \
--out docs/code-map.html \
--repo-root path/to/evidence-root \
--cdn-profile global

--repo-root 是证据根目录：代码图谱时为仓库根，非代码业务流程图谱时为用户资料所在目录。两种情况下 verified 证据都指向实际检查过的行；仅来自口述描述的断言保持 inferred 或 unconfirmed。

--canonical-url <https-url> 为可选参数：图谱发布地址已知时传入，生成的 HTML 会带上对应的 与 og:url。每份生成图谱还会以 meta.summary 生成 meta description，并附带 og: 与 Twitter summary card 标签。

构建器会校验 MapSpec、内联应用代码和 CSS，并原子写入输出；它绝不会删除输入的 MapSpec。生成的 HTML 打开时需要联网加载固定版本的 React、ReactDOM 与 Mermaid 运行时依赖。

CDN 交付 profile

- global（默认）：所有依赖均按 jsDelivr → unpkg 回退。
- china-friendly：React 与 ReactDOM 按 npmmirror → staticfile → jsDelivr → unpkg → bootcdn 回退；Mermaid 按 npmmirror → jsDelivr → unpkg 回退。

只有用户明确偏好中国大陆访问，或明确目标受众在中国大陆时，才选择 china-friendly。用户语言本身不足以决定 profile；只有构建环境能代表目标用户、且用户同意联网探测时，才适合根据实际速度选择。每个已配置来源均使用 HTTPS、固定版本、SRI 校验、8 秒超时，且只作为有序回退源。

生成前，Agent 会询问是否把键盘操作与小视口使用纳入本次图谱的验收范围。只有用户确认后，才承诺并验证这些能力；未选择不会阻塞图谱交付。

图内操作说明

每份生成图谱都有固定且本地化的三段说明：阅读说明、证据状态与操作。每张节点卡片的左上角还会直接显示与图例一致的小状态点，边框样式作为辅助提示。操作段会显示主要交互：点击卡片查看详情；点击任意关系线可钉住与悬停完全相同的高亮动画（同时仅一条，悬停机制不受影响），再次点击该线、按 Esc 或单击空白位置可取消，拖动画布不会误清；使用 Tab 选择卡片或关系线，Enter 打开或钉住，Esc 关闭详情面板并清除钉住。节点也支持空格作为等价的按钮操作。生成 HTML 的文档语言、图谱区域名称与依赖加载失败页也使用同一语言。上文的生成前确认仍决定键盘与小视口能力是否属于本次交付的验收范围。

时序图（meta.diagramKind: "sequence"）以生命线与有序消息替代节点卡片与关系线，并用 loop/opt/alt 帧表达重复、条件与互斥分支：参与者与消息各携带三态证据，每条消息自动编号，点击消息或参与者会打开对应证据详情并保持该记录高亮，直到面板关闭或按 Esc 清除。时序图图例使用参与者、消息与帧语境，关系线钉住操作不适用。

可直接查看原创的英文 MapSpec与中文 MapSpec。两者共享同一个小型示例源码目录、图谱结构、断言状态和证据数据；仅图谱读者可见文案与固定 UI 按语言本地化。英文 Demo 使用 global；中文 Demo 明确面向中国大陆访问者，使用 china-friendly。英文时序 MapSpec与中文时序 MapSpec把同一份示例源码按调用时序阅读，两种图型并排对照。可用以下命令重新生成已提交的 HTML：

~~~bash
node skill/renderer/build-html.mjs \
--in examples/demo/expected-mapspec.json \
--out examples/demo/expected-output.html \
--repo-root examples/demo/sample-repo \
--canonical-url https://yulaiz.github.io/interactive-code-map/en/

~~~bash
node skill/renderer/build-html.mjs \
--in examples/demo/expected-mapspec.zh-CN.json \
--out examples/demo/expected-output.zh-CN.html \
--repo-root examples/demo/sample-repo \
--cdn-profile china-friendly \
--canonical-url https://yulaiz.github.io/interactive-code-map/zh-CN/

~~~bash
node skill/renderer/build-html.mjs \
--in examples/demo/expected-mapspec.sequence.json \
--out examples/demo/expected-output.sequence.html \
--repo-root examples/demo/sample-repo \
--canonical-url https://yulaiz.github.io/interactive-code-map/en/sequence/

~~~bash
node skill/renderer/build-html.mjs \
--in examples/demo/expected-mapspec.sequence.zh-CN.json \
--out examples/demo/expected-output.sequence.zh-CN.html \
--repo-root examples/demo/sample-repo \
--cdn-profile china-friendly \
--canonical-url https://yulaiz.github.io/interactive-code-map/zh-CN/sequence/

原则

- 仅包含原创实现和示例。
- MapSpec 证据状态明确为 verified、inferred 或 unconfirmed。
- 生成产物不得包含绝对本机路径、凭据或敏感源码内容。
- 运行时依赖固定版本，并通过受 SRI 保护的回退源加载。
- 键盘操作与小视口使用是推荐项，不是默认验收要求；Agent 会为每份图谱确认是否纳入。

开发

需要 Node.js 20 或更高版本。

~~~bash
npm install
npm run test:mapspec
npm run test:build

仅在当前环境已有兼容浏览器时运行：

npm run test:browser

npm test 会在已配置好的开发或 CI 环境中运行三组测试。浏览器回归应先复用 Playwright 配置可访问的现有兼容浏览器；macOS 本地可使用已安装的 Google Chrome。若没有兼容浏览器，应把 npx playwright install chromium 作为独立的可选安装建议，说明它会下载 Chromium，并等待用户确认后再执行。skill 的冒烟验证不会自行安装浏览器工具。

验证

- npm run test:mapspec：验证零依赖校验器以及 Schema / 校验器包含关系。
- npm run test:build：验证 Mermaid 编码、依赖配置、构建安全和原子输出。
- npm run test:browser：验证渲染器回归，包括图谱加载、可选的键盘与响应式能力、平移缩放、CDN/SRI/超时回退、子图标题避让，以及长 htmlLabels 是否落在 foreignObject 可用尺寸内。测试期间使用字节级一致、经 SRI 校验的本地 UMD 镜像；生成的 HTML 本身仍使用固定的 CDN 源。

贡献

贡献指引见 CONTRIBUTING.zh-CN.md。

安全问题报告

漏洞报告方式见 SECURITY.zh-CN.md。

许可证

本项目采用 MIT License。