提问图谱（dsh-ask-graph）

把 DeepSeek Harness（DSH）工作区里的会话历史整理成可下钻的专题图 / 问题图。

功能

• 读取当前工作区的会话历史，按功能/语义归入专题。
• 专题总览按时间形成串行/并行有向图；点击专题进入问题子图。
• 问题按时间串联，点击节点在右侧查看完整问题与 DSH 回复。
• 支持「智能整理」：调用当前 DSH 模型按上下文语义重组专题。
• 支持搜索定位、手动归类、专题总结、在原会话中定位问题。
• 导出：
  • HTML：大纲 + 专题/问题有向图 + 完整内容 + 内部链接，单文件离线打开。
  • SVG：专题总览图 + 每个专题的问题图。
  • Bluepin Vault：标准 pages/、assets/、daily/ 目录，带 wiki 链接、图片与 SVG 图。

环境

• DSH 0.2.1 系列（Web / Desktop 客户端）。
• 插件是 Client 插件；图谱状态保存在浏览器 localStorage，按工作区隔离。

数据与权限

• 读取当前工作区中 DSH 会话的问题、回复和图片附件，用于归类与展示。
• 「智能整理」会把待整理的问题与回复发送给当前配置的 DSH 模型；不调用其他外部服务。
• 导出只写浏览器下载文件（HTML/SVG/ZIP）；插件不向第三方上传数据。
• 图片无法读取时会在导出结果中保留原链接或给出警告。

开发

pnpm install
pnpm build
pnpm test
node scripts/smoke.mjs

构建产物：dist/client.js。

安装

团队安装（推荐）

从 GitHub Release 下载 dsh-ask-graph-1.0.0.tgz，然后安装到你的 DSH profile：

dsh plugin --profile web add ./dsh-ask-graph-1.0.0.tgz

Desktop 版把 web 换成 desktop（或你实际使用的 profile 名）。安装后重启 DSH。

包内已包含预构建的 dist/client.js，团队机器不需要安装 Node 依赖或执行构建。

也可以直接从公开仓库的 tag 安装：

dsh plugin --profile web add github:tonyischen/ds_ask_graph#v1.0.0

从源码目录安装

dsh plugin --profile web add file:D:\DSH\ds_ask_graph

开发调试时也可以使用 DSH 插件管理器的 install_bundle（目录路径）或 profile 的 link: 依赖。

npm（尚未发布）

发布到 npm 后可直接：

dsh plugin --profile web add dsh-ask-graph

发布（维护者）

项目 .npmrc 已指向 npm 官方 registry；发布前会自动执行 build 和 test。

首次发布：

npm login
npm whoami
npm publish

如果 npm 账号启用了 2FA，按提示输入 OTP。发布后可用：

npm view dsh-ask-graph version

自动发布：在 GitHub 仓库 Secrets 中添加 NPM_TOKEN，然后推送 v* tag，工作流 .github/workflows/release.yml 会构建、测试并发布。

许可

MIT，见 LICENSE。

目录

src/
  client.jsx      插件入口与 View 注册
  ui.jsx          图谱、详情面板、交互
  core.js         事件配对、专题归类、布局
  graph.js        dagre 布局
  semantic.js     智能整理提示词与解析
  bluepin.js      Bluepin vault 生成
  html.js         HTML 报告
  svg.js          专题/问题 SVG
  images.js       DSH 附件与 Markdown 图片解析
  zip.js          无依赖 ZIP writer
tests/            单元测试