提问图谱 tonyischen/ds_ask_graph

提问图谱（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/ 单元测试