概览
dsh-follow-edits
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **高亮渲染器替换了内置代码预览**:为叠加 diff 标色,注册了 `priority: extension` 的渲染器,默认不再用内置 Shiki 语法高亮(可在预览的渲染器下拉里切回「代码」)。后续可考虑内置高亮 + 叠加 diff。 - **精确行号依赖一个非会话状态映射**:host 在 `tools/pre-execute` 里把「callId → oldStr 起始行」存进内存映射,投影在 `tool/result` 折叠时读取它。这属于 `practices.md` 点名的「读取撕裂的非会话状态的 apply」(评审级、非机械可查),代价是冷读/重放时该映射为空,行号只能回退到 client 侧搜索。 - **终端跟随是降级且依赖递归监听**:shell 改动走 `node:fs.watch({recursive:true})`(Windows/macOS 支持,**Linux 上静默不生效**);没有前后内容所以只能「打开文件」;只跟随文本/代码后缀,跳过 `node_modules`/`.git`/`dist` 等目录。 - **shell 改动的投递要等下一次会话事件**:文件系统事件是异步的,投影只在会话事件驱动时重新计算 wire 值,所以 shell 改动通常在紧随其后的那次事件(往往是 shell 自己的 `tool/result`)到达;若事件先到,则顺延到下一跳。 - 跟随所有会话(含后台);如只想跟随当前会话,在 client.js 里加 `retainedBy.mainView` 过滤即可。 - dsh 是 developer preview,API 会随 rc 版本漂移。
