# 复用与改动说明

本项目原创部分包括会话草稿仓库与 CAS、恢复队列、受限 DS 视觉建议服务、图片/建议跨 iframe 接续、面板状态和用途输入。

## Excalidraw

`vite.config.ts` 在构建时仅将 Excalidraw 无条件附加的 esm.sh 字体后备地址替换为同源地址，避免离线 CSP 错误；没有改动绘图算法。

`@excalidraw/excalidraw` 0.18.1 提供画笔、形状、文本、撤销与图像导出。不是本项目开发的绘图引擎。MIT；字体还包含 OFL 等许可，完整文本见 `third_party_licenses` 与 `THIRD_PARTY_NOTICES.md`。

## dsh-diagram

来源：https://github.com/hanzhangzzz/dsh-diagram/tree/v0.6.1 ，提交 `ea4279ef9a9b6a1751d1a06930ff4c140cd02f38`，MIT，原始许可位于 `third_party_licenses/external/dsh-diagram-LICENSE`。

改编文件：`src/core/scene.ts`（从场景契约提取，删除语义布局相关内容）、`src/host/static.ts`（改变资产前缀）、`build/client-bundle.ts`、`build/copy-excalidraw-fonts.mjs`、`build/generate-third-party-notices.mjs`；字体许可文件和包的许可例外文本也据其清单复用。新增依赖缺失的 fastdom/strictdom 许可从各自 GitHub README 的 License 节提取；来源记录在生成脚本中。上游 README 来源未固定至发布标签，许可来源核查仍应随升级复查。

## DeepSeek Harness

来源：https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.2.1-alpha.1 ，提交 `5badb15009ae1756c3afe0ae0cef1faafc290ccc`，MIT，原始许可位于 `third_party_licenses/external/deepseek-harness-LICENSE`。

`tests/browse-picker.overlay.yml` 改编自官方 Web 自动化测试覆盖层。

`src/client/ConversationWidthControls.tsx`、`ConversationRoot.module.css` 来自官方会话组件，前者修改为分栏宽度约束。`SketchShell.tsx` 的会话阶段计算依据官方 `ConversationMainPanel`。附件桥针对这个版本控制器已导出的 `createDrafts/releaseDraftAttachment` 适配，不代表所有 DSH 版本均有相同接口。

修改这些复用文件时保留上游归属；未来升级需要重新检查接口、许可证和回归。生成的第三方清单保守涵盖运行时依赖树，部分包属于未执行的动态可选能力。

## 0.2.1 社区参考

审阅 dsh-diagram v0.6.1 的 `SceneAutosaveController.dispose()`、会话 `conversation.view` 登记，以及固定版 DSH `ui-theme` 的公开主题事件、CSS 生命周期与原生 Button/Slot hooks。此轮沿用已有许可证和归属，自动保存实现保留本项目的 mutationId/CAS 与本地恢复队列。

另参考 [dsh-mermaid](https://github.com/AKS1st/dsh-mermaid/tree/2708cdf2e2eb1c0cd15448c3d3d680b8fba58d48)（MIT）的按需加载、失败保留基础内容设计；没有复制源码或引入该组件，未采用其固定 DOM 观察与模拟发送做法。具体取舍见 `docs/native-integration.md`。

## 0.3.x Agent 协作参考

审阅上述固定版 DSH `dsh-tools` 的公开 DSL、工具执行会话上下文与注册释放接口，以及 dsh-diagram v0.6.1 `src/host/tools.ts` 的会话限定读取模式。新工具和 SSE 通知为本项目实现，未复制其语义图布局、编译器或独立聊天 UI。现有 MIT 许可与来源声明继续保留。

0.3.1 的图形提议通过 Excalidraw 0.18.1 已公开的 `convertToExcalidrawElements`、`newElementWith`、`restoreElements`、`updateScene` 与历史捕获 API 应用；没有复制其内部几何、绑定或渲染代码。原生选择/框选直接读取公开 appState 的 selectedElementIds。操作契约、结果校验、提议存储及界面为本项目增量实现，第三方许可清单保持原样。

0.3.2 的选区 PNG 直接复用同版 `exportToBlob`，不复制边界、字体或光栅化算法。审阅官方 v0.18.1（`a2ec2889babf7d2295469c6d90ebe77fae57df84`）Collab 的历史捕获/连接释放边界，未复制多人同步实现。

`src/host/image-reference.ts` 和 `service.ts` 的图片工具输出、路线能力门禁模式改编自固定版 DSH [`packages/fs/tool-fs/src/read-image.ts`](https://github.com/deepseek-ai/deepseek-harness/blob/5badb15009ae1756c3afe0ae0cef1faafc290ccc/packages/fs/tool-fs/src/read-image.ts)。使用其公开 attachments/工具接口，沿用 DSH MIT 归属与许可；未复制文件路径读取能力。

另外只参考 tldraw [`image-export.mdx`](https://github.com/tldraw/tldraw/blob/035b741dc331bf76a4cb9af27c346be10bba2a88/apps/docs/content/sdk-features/image-export.mdx) 的选区导出流程。其 SDK 许可证与 MIT 不同，没有复制代码、引入依赖或将其列为本包包含组件。详细取舍见 [0.3.2 实现说明](docs/submission-v0.3.2.md)。