DeepSeek Harness (DSH) 负责执行任务，但在处理长对话或复杂工作流时，原始的日志界面往往难以快速定位关键信息或进行分支探索。dsh-atlas 提供了一个可视化的会话工作区，将 DSH 的会话日志转化为卡片和分支，让长会话变得易于理解、组织和继续。
定位与原理¶
dsh-atlas 是一个运行在 DeepSeek Harness Web 环境下的客户端插件。它以 DSH 会话日志为单一事实来源，不重复或重写原有的聊天系统，而是作为一个视觉层构建在 DSH 之上，帮助开发者梳理会话结构。
安装与启用¶
安装插件需要 Node.js 环境。请执行以下命令将插件添加到 DSH Web 配置中，随后启动 Web 服务：
npx @deepseek-ai/dsh plugin --profile web add github:sumarilkkxx/dsh-atlas
npx @deepseek-ai/dsh web
DSH Web 默认会在 http://127.0.0.1:3080 启动。在设置中配置模型并选择工作区后，点击顶部导航栏的 Card View 即可进入可视化工作区。
核心功能¶
会话可视化与组织¶
插件将用户消息、模型响应和工具活动投影为卡片。每个主要会话拥有独立的画布。在画布上可以拖拽卡片、平移视图或缩放（50% 到 400%），并能自动排列节点、定位活动卡片或折叠下游卡片。
分支与实时状态¶
每轮对话生成一张卡片。从任意答案分支会使用原生 DSH Fork，保持上下文关系。卡片会实时显示准备、推理、工具调用和生成过程。一旦完成，持久化的 DSH 历史记录成为权威状态，防止出现过时的“Thinking”状态。
工具与性能指标¶
详情视图保留原始工具事件顺序，并嵌入 ECharts、Mermaid 和沙盒渲染画布。每张卡片聚合展示 LLM 时间、首 token 时间、token 率、缓存命中率以及输入/输出 token 数，但不暴露单个模型调用的详细拆解。
原生输入能力¶
Atlas 读取 DSH 完整的模型目录，支持原生选择模型、推理级别、权限预设、斜杠命令、文件和技能。从画布发起的新会话或后续对话，拥有与原生 DSH 相同的会话级权限和上下文能力。
信息组织¶
可以通过搜索会话和卡片来梳理长运行的工作。支持将卡片标记为 Important、Key Conclusion 或 Needs Verification 状态，以快速识别关键结论或需要验证的内容。
使用示例¶
- 浏览与操作：启动 DSH Web 后，点击顶部导航栏的 Card View。在画布上拖拽卡片、平移视图或使用鼠标滚轮缩放（范围 50% 至 400%）。
- 分支对话：从任意答案卡片出发，使用原生 DSH Fork 功能创建分支，继续探索不同的对话路径。
- 执行命令：通过菜单或键盘选择斜杠命令（如
/compact）并发送，系统会生成独立的命令卡片。 - 标记重点：将完成的卡片标记为 Important、Key Conclusion 或 Needs Verification，以便后续快速回顾。
数据与限制¶
数据所有权¶
dsh-atlas 仅存储辅助数据（布局、状态、摘要），DSH 拥有原始的执行历史和对话记录。删除 Atlas 画布上的卡片不会影响原始 DSH 对话。
文件解析限制¶
附件在浏览器本地解析。支持 PDF、DOCX、XLSX、CSV 以及常见的代码和配置文件。存在以下限制：
* 单文件大小：12 MB
* 总文件大小：24 MB
* 单文件提取字符数：48,000 字符
* 总提取字符数：96,000 字符
依赖说明¶
对话详情中的图表和视觉工件由可选的 dsh-artifact 插件生成。Atlas 仅负责挂载和显示这些工具输出。
结语¶
dsh-atlas 将原始的会话日志转化为可管理的卡片工作区，通过原生 DSH Fork 和实时状态保持与核心系统的紧密联系。它适合需要在长时间会话中梳理逻辑、组织工具输出或进行分支实验的开发者。
