# AI 使用与代码来源声明

[简体中文](AI_USAGE.md) · [English](AI_USAGE.en.md)

本文说明 `dsh-sidebar-row-menu` 中人工智能（AI）的参与范围、人工审核方式、代码引用
来源与免责边界。它不改变 [LICENSE](LICENSE)（MIT）的任何条款。

## 1. 结论摘要

- 本项目的**源码与文档主要由 AI 辅助生成**，由项目所有者提出需求、审阅并验证。
- AI 不是版权主体；本项目按 MIT 许可发布，使用者获得的权利与义务以 MIT 为准。
- 项目**不提供任何担保**。AI 生成的代码可能包含错误、遗漏或不适用于你的环境。
- 第三方代码的版权与许可单独列在 [NOTICE.md](NOTICE.md)，不因本项目采用 MIT 而改变。

## 2. 使用的工具与模型

- 开发环境：DeepSeek Harness（DSH）编码智能体。
- 模型：`deepseek-flash`（DeepSeek）。
- 交互方式：项目所有者以自然语言提出需求、指出缺陷并确认行为；智能体读取 DSH 内置
  包源码与现有插件源码，编写/重构代码、文档与测试，并在本机验证。

## 3. AI 参与的范围

| 部分 | AI 参与程度 | 说明 |
| --- | --- | --- |
| `lib/client.js` | 高 | 初稿与多轮重构均由 AI 完成 |
| `lib/host/*.js` | 高 | 由 AI 从 `lib/index.js` 拆分并改写 |
| `test/*.test.mjs` | 高 | 测试用例与伪造 DOM/fiber 由 AI 编写 |
| `scripts/install.ps1` | 高 | 由 AI 编写并在本机执行验证 |
| `README*.md` / `NOTICE*.md` / 本文 | 高 | 由 AI 起草并随代码更新 |
| 需求、缺陷判断、最终取舍 | 人类 | 由项目所有者决定 |

没有人类逐行重写全部代码。人工审核以**行为验证**为主：阅读关键路径、运行测试、
在真实 DSH 客户端中触发菜单并观察结果。

## 4. 已验证与未验证

已验证：

- 11 项自动化测试（宿主纯函数、路由状态码、客户端模块装配、slot 注册、菜单项顺序、
  会话右键委托、剪贴板内容）；
- 在 Windows 上的 DSH 桌面客户端中实测：工作区右键在指针处弹出、会话右键在指针处
  展开内置菜单并包含本插件条目；
- 宿主 `/open` 路由在本机返回预期状态码。

未完全验证：

- 所有 DSH 版本、所有主题、所有缩放比例与多显示器组合；
- 非 Windows 平台的启动分支（代码保留 `darwin` / `linux` 路径，但未实测）；
- 与其他第三方插件的组合冲突（slot 机制设计上兼容，但未穷举）。

## 5. 代码来源与引用

- 改编自 `dsh-sidebar-context-menu`（MIT, miao-ge）与 `dsh-workspace-menu`
  （BSD-3-Clause, @0imzero）；复用范围、版权声明与许可证全文见
  [NOTICE.md](NOTICE.md)。
- 对接 DSH 内置包时只读取其公开接口、类型与运行时行为，**未复制内置包源代码**。
- 仓库历史（Git commits）记录了每次变更；`v1.0.0`、`v1.1.0`、`v1.2.0` 是行为分界点。

## 6. 数据与隐私

- 插件在本地运行，**不包含遥测、统计上报或远程请求**。
- 客户端只读取 DSH 已渲染到内存中的工作区/会话对象（标题、`cwd`、归档/置顶状态），
  用于生成菜单与复制路径。
- 宿主路由只接受本机（loopback）请求，且只打开**已存在的绝对目录**。
- 剪贴板写入仅发生在你点击“复制工作区路径 / 复制 Session ID”时。

## 7. 使用建议

1. 在生产环境采用前，阅读 `lib/client.js` 与 `lib/host/*.js`，确认行为符合预期。
2. 运行 `npm run test`（或受限环境用 `npm run test:local`）。
3. 保留 `NOTICE.md` 与 `LICENSE`，以满足上游 MIT / BSD-3-Clause 的署名要求。
4. 若发现 AI 生成代码导致的问题，请提交 issue 或 PR；欢迎人工修正。

## 8. 免责声明

本项目按“现状”提供，不附带任何明示或默示的担保，包括但不限于适销性、特定用途适用性
与不侵权担保。使用本项目造成的任何直接或间接损失，作者与贡献者不承担责任。完整条款
以 [LICENSE](LICENSE) 为准。