@dsh-external/dsh-file-trace

LIMITATIONS

Known limitations

- 只覆盖当前加载窗口内的操作，并与 Chat 视图一致；翻页加载后自动补全。 - 编辑的"完整文件上下文"依赖窗口内更早的**同一文件**写入/读取内容；若无，则仅显示模型提供的 old_string/new_string 片段。 - 行级 diff + 行内字符级高亮；语法高亮为轻量正则分词（无语法树），多行块注释状态按行序推导、跨行正确着色，复杂构造可能不完全精确。 - **脱敏层定位（非安全边界）**：脱敏只作用于本插件的渲染层，目的是**截图 / 分享 diff 给他人时的便利保护**；它不是安全边界——原始内容仍完整保留在会话日志中，任何能读取会话文件的插件或工具都能看到未脱敏内容。需要真正保护密钥时应在源头（凭据管理、文件权限）处理。 - **HTML 渲染预览的安全取舍**：iframe 沙箱**三档可手动切换**（渲染时面板头有一键循环按钮）：`受限`（无脚本）/`脚本`（`allow-scripts`，不透明源）/`宽松`（另加 `allow="autoplay; fullscreen"` 权限策略）。默认 `脚本`；`宽松` 允许音频自动播放等权限，但仍是**不透明源**————页面动画与交互逻辑可运行（页面自己的回退/错误处理也能生效），且运行在**不透明源**里：拿不到 DSH 宿主页面的 DOM/存储/Cookie，无法发起同源请求。`srcDoc` 无基准 URL，**相对路径的资源（图片/CSS/fetch 同目录文件）不解析**（绝对 http(s) 可访问）——依赖本地伴生文件的页面会走自身回退逻辑。渲染输入经过脱敏层（与其它视图一致），但渲染的是模型读到的文档内容本身——不要把渲染视图当作「可信 HTML」的执行环境。 - **脱敏 × mermaid 已知边界**：Markdown 阅读模式下，若 mermaid 图的**无引号**节点标签里含被脱敏的密钥（遮罩产物 `[REDACTED]` 自带嵌套方括号），该图会因语法破坏而渲染失败、回退显示源码（信息不泄漏，仅图不可看）。**规避方法**：节点标签一律加引号（`A["文本"]` 写作 `A["含密钥的文本"]` 形式即可安全遮罩）；关闭脱敏开关亦可恢复渲染。会话日志始终保留原始字节，仅影响显示。 - 中英文 README 一致性记录见 `README.i18n.yaml`。