dsh-code-reading 0.1.8

0.1.8 · 2026-10-25

项目地图与导图体验

• 新仓库默认进入项目地图，通过原生阅读会话生成 AI 导览；支持交互式思维导图、路径导航、历史知识点关联和增量更新。
• 导图视口使用取整后的 contentRect 测量，减少缩放边界抖动；保留证据核验、模型范围确认及失败恢复。

DSH 0.2.1-rc.3 兼容

• 将当前源码的精确 engines.dsh、五个可选 Host peer 和原生兼容检查 SDK 同步到 0.2.1-rc.3，重新生成依赖锁文件；不启用版本豁免，也不扩大到未验证的未来版本。
• 原生门禁回归覆盖既有 0.1.7（目标 0.2.1-rc.2）被拒绝、当前源码无需豁免通过、各 peer 遗留旧约束及旧宿主／未来预发布版拒绝；保留 Host/Client 一致性检查。
• 本次兼容修复不改变阅读档案格式、工具权限或持久化逻辑。Host、Client 与包版本提升为 0.1.8；既有 0.1.7 归档保持不可变且仍只适用 rc.2。安装新版并按安装器要求重启后才会更新运行中的 DSH。

精简提示与默认阅读模型

• 去掉欢迎页 CODE READING · 按需探索 提示和目录中的独立“当前仓库”选择区；单仓不留空条，多仓由目录根节点切换，保留仓库身份与迟到响应隔离。
• 源码发送确认突出所选提供方／模型和所选文件行范围；问题阅读明确未限定文件。保留一条发送及补读上下文说明，仓库路径和端点核对说明折叠查看，不把选区冒充后端硬权限边界。
• 阅读设置只保留默认阅读代码模型与插件档案位置。设置按插件根独立持久化并带 CAS，仅用于之后新建的阅读，不覆盖已有会话或 DSH 全局默认；可清除覆盖、不可用时不静默切换。旧档案无须迁移。
• 安装与使用页改为三步操作，版本与连接排查默认折叠。随 0.1.8 交付；安装并重启后才会更新运行中的 GUI。

仓库移除 Host 能力握手

• 修复相同包版本号但 Host 仍运行旧构建时，页面错误开放仓库移除并只显示 UNKNOWN_METHOD 的缺口。Host 的只读状态接口声明 remove-project 能力，Client 在就绪前核验；缺少能力时暂停变更并说明应确认安装包、完整退出重开 DSH，而非仅刷新页面。
• 对握手后删除接口仍返回 UNKNOWN_METHOD 的情形，明确本次删除未执行，保留项目／档案并禁用继续删除；恢复连接只发只读请求，不自动重放删除，不降级为直接操作文件。
• 此修复不修改档案格式、源码或已发布归档，不代表已经更新用户运行中的 Host。

完整文件与精简工作台

• 源码文件一次请求加载完整内容，移除上一段／下一段及跳行分页；证据与搜索命中在完整文件内滚动定位。兼容旧页段位置；超出 1 MiB 或 20,000 行整份拒绝，不显示部分文件。AI reading_read 的 400 行／100,000 字符预算保持不变。
• 移除目录搜索动作按钮（Enter 搜内容、Shift+Enter 查路径）、目录底部只读／导航提示、空态红框内的说明与动作，以及标题旁宣传提示。临时阅读说明移至底部状态栏，在问题阅读页同样可见。
• 仓库选择新增“管理仓库…”与删除确认；仅逻辑移除整个阅读项目，源码和原阅读档案不删除、仓库绑定不变。任一会话分析中禁止移除，准入／会话锁与最终原子提交守卫拒绝迟到写入；旧页面及保留工具不能继续使用已移除绑定。
• 本轮 JSON 回归使用固定来源和哈希的真实 DeepSeek translator 代码片段与最小离线样例，验证非法 JSON 不执行／重发、合法转义保真。补充模型可见的字段转义说明；提示约束仅降低风险，不宣称能根治真实模型格式错误。未读取当次真实故障参数或发送真实模型请求。

DeepSeek 工具 JSON 输出约束

• 针对 reading_publish 字符串内部英文双引号未转义导致的 DeepSeek Messages stream: tool input is invalid JSON，导师归档步骤和工具描述补充单个 JSON 对象、字符串转义与有效短示例；减少短结论重复全文，保留完整正文和原证据／范围校验。此为模型输出约束，不宣称提示能保证合法输出。
• 页面识别该确定错误，明确本轮未完成、已保存内容保留及先核对状态后手动重试；不回显原工具参数，不自动修复、重发或伪造归档成功。其它提供方错误和网络结果未确认的幂等恢复保持原样。
• 使用实际失败工具参数离线重放已安装的 DeepSeek 解析器，确认与未转义引号的最小例子报同一错误，正确转义的对照可通过。未修改已安装 DSH，未额外调用真实模型。

方法级阅读与代码优先 IDE

• 代码阅读按完整方法／函数／构造器等可调用单元归档；类或整文件可作为更大的阅读范围，非代码文档／数据豁免。未知编程语言不因缺少高亮而跳过规则。语义边界由 AI 识别，Host 核验原字节 SHA256、UTF16 排他范围及连续完整读取证据，不宣称通用 AST 证明。

• 新知识点保存代码单元名称、范围、结论与证据；本轮选区焦点仅保存身份／版本／行列，原子随模式／意图提交并在非选区请求中清空。兼容旧档案及空新增字段的发布凭据，不猜测补全旧方法范围。

• 打开源码时，在同一阅读项目内跨会话关联当前版本解读：行号栏标记、代码悬浮／键盘焦点预览已有结论，显式按钮精确打开对应会话和知识点。不额外调用模型、不改浏览器 Selection，也不增加源码或结论的浏览器持久化；标记不等于用户已理解。

• 不同源码哈希的解读留在历史中，不硬挂到当前旧行号；旧记录无方法范围时不伪造标记。关联检索与显示有明确预算和截断提示，非实时文件监听，不自动进行语义重绑。

• 工作台改为左侧文件目录、中间代码与阅读共用的文档标签、右侧阅读列表。桌面目录默认展开，可折叠并在 200–420px 内调整宽度；窄屏两侧按需用抽屉打开，中央代码可最大化。

• 初开仓库中央显示“选择文件，开始阅读”，不自动显示大对话表单。右侧已有记录只打开，即使为空也不另建；“新建阅读”创建独立记录并在中央打开表单，“开始问题阅读／问题阅读”打开当前记录。

• 文件标签最多 12 个，仅在页面内存中保留身份与位置；切换时重新读取、按哈希核验并恢复滚动，不增加浏览器源码或对话持久化。元数据兼容恢复中央代码／阅读文档类型与既有位置，不承诺持久化全部标签或历史源码字节。

• 手动选择方法／类文字后，右键或 Shift+F10 可用“AI 生成逻辑图”，沿用会话模型与源码发送范围确认；Host 核验哈希、行列、选文并创建证据。方法优先流程图呈现分支、异常与返回，类按实际协作使用类图或流程图；不宣称自动 AST／静态调用分析。

• 逻辑图在中央阅读文档图优先展示，并保留解释、证据、完整 Markdown 与图源码。缺图、空图或触发安全校验时拒绝归档为已完成逻辑图；沿用 Mermaid 输入限制、SVG 清洗与受限 iframe，不扩张工具权限。

• 绘图意图仅控制明确请求的本轮，普通解释和后续追问不永久变成绘图任务。问题阅读按需结合业务解释、调用链与关键实现；代码阅读优先选区逻辑、必要上下游和相关业务，理解自查仅在用户要求时进行。

• 移除固定五阶段导航与空阶段占位，只列实际知识点，按实际结构化内容提供维度切换；旧档案继续展示完整正文。保留代码高亮、明暗主题、可见焦点和减少动态效果偏好，以及现有仓库／模型选择与失败恢复行为。

• 新阅读使用仓库目录名称，无需填写项目名和仓库名；既有名称和档案不自动更改。模式与本轮意图原子保存，不消耗旧阶段 revision；保留取消、模型和版本的最终准入检查、请求重放与空维度列表的旧发布凭据哈希兼容。

• 以上变更随 0.1.8 交付；既有 0.1.7 归档保持不可变，安装新版后才会更新运行中的 GUI。

验证范围：构建、Node 回归、隔离浏览器、真实 tarball 静态核验与包内 Host/Client 复验。仅 Windows 适用的路径检查在 Linux 跳过；未安装进运行中的 DSH，未调用真实模型。