# 喏这里 / Look Here

[English](README.md) | 简体中文

喏这里是一个用于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI 的划词交互插件。在 DSH 会话里选中文字后，可以直接解释、继续提问、保存回答或添加批注，同时不打断主会话。

## 主要功能

- **划词解释**：选中会话文字后显示圆点；短按快速解释，长按自定义提问或批注，优先动作可在设置中切换。
- **旁路处理**：解释和追问使用独立的 `ctx.llm` 调用，不向 DSH 主会话追加消息。
- **回答模型可选**：可以跟随当前会话，也可以在插件设置中指定 Provider 和模型。
- **保存阅读记忆**：保存完整回答或节选，再次遇到相同词语时显示历史提示。
- **批注工作流**：暂存多个锚定批注，在抽屉中编辑，然后拖入 DSH 输入框。
- **不会自动发送**：拖入批注只会修改草稿，最终内容始终由用户检查并手动发送。
- **适配使用环境**：支持中英文界面、主题色、划词手势设置和减少动态效果。

## 运行要求

- Node.js 22.19+（22.x 版本线），或 Node.js 24+
- DeepSeek Harness `0.1.0-rc.7`
- 可用的 DSH `web` profile

已经验证的 Harness 版本与插件接口见 [COMPATIBILITY.md](docs/dsh-adaptation/COMPATIBILITY.md)。

## 从 GitHub 安装

```sh
npx @deepseek-ai/dsh plugin --profile web add github:ZanderKong/look-here
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh --profile web
```

安装后需要重启 Web 服务。配置输出中应出现 `# == look-here` 层；默认访问地址为 `http://127.0.0.1:3080`。

如果需要可复现安装，可以在 GitHub spec 后追加 `#<commit-or-tag>`。

## 从本地源码安装

```sh
git clone https://github.com/ZanderKong/look-here.git
cd look-here
npm install
npm run check
npx @deepseek-ai/dsh plugin --profile web add .
npx @deepseek-ai/dsh --profile web
```

## 使用方法

1. 打开 DSH 会话，选中一段 Assistant 输出。
2. 短按圆点直接解释，或长按后提问、添加批注；具体优先动作可以在设置中调整。
3. 保存有用的解释、继续追问，或者收集多个批注。
4. 把批注篮拖进输入框，检查草稿后再手动发送。

## 诊断

在浏览器 DevTools console 中运行：

```js
await __LOOK_HERE_DSH_DIAGNOSTICS__.health()
await __LOOK_HERE_DSH_DIAGNOSTICS__.selfTest()
await __LOOK_HERE_DSH_DIAGNOSTICS__.quickExplainJobs()
await __LOOK_HERE_DSH_DIAGNOSTICS__.storage()
```

## 开发与测试

```sh
npm install
npm run build:dsh
npm test
```

`npm run check` 会先重新生成可安装的 DSH client/host 文件，再运行完整测试。

## 项目结构

```text
dsh/                  DSH host、client adapter、Cordis patch 与构建脚本
src/                  从 Chrome 插件适配而来的共享产品核心
dist/dsh/             已提交的可安装 host/client 构建产物
tests/dsh/            DSH 适配与行为测试
docs/dsh-adaptation/  架构、兼容性、安装和功能对齐说明
```

更多实现细节见[架构说明](docs/dsh-adaptation/ARCHITECTURE.md)、[安装与验收指南](docs/dsh-adaptation/INSTALL.md)和[功能对齐清单](docs/dsh-adaptation/PARITY_CHECKLIST.md)。

## 隐私与数据处理

- 选中的文字、会话上下文、问题和追问会通过 DeepSeek Harness 当前配置的模型 Provider 处理。
- 插件设置、保存的解释与批注存储在 DSH Web UI 所用浏览器 profile 的本地存储中。
- 插件不读取或保存模型 API Key，也不会自动提交输入框草稿。

除非当前模型 Provider 被允许处理相关内容，否则不要选择敏感信息。

## 项目来源

喏这里把[原 Chrome 插件](https://github.com/ZanderKong/whats-this-again)的交互模型与产品核心适配到 DeepSeek Harness Web UI。DSH 特有能力通过 adapter 接入，不是另做一套功能。

## 官方社区发现

本仓库使用 DeepSeek Harness 官方项目推荐的 [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic，因此可以在 GitHub 的 Harness 插件社区中被搜索和发现。

## 许可证

[MIT](LICENSE)