# Sensa Basic

Sensa Basic is a page-aware Chrome side panel AI assistant with only the generic chat workflow.  
Sensa Basic 是一个只保留通用对话能力的 Chrome 侧边栏 AI 助手。

It keeps the core experience of reading the current page, optionally attaching a screenshot, and chatting with the model in context. It does not include site-specific modes such as danmaku, subtitles, learning cards, or stock analysis.  
它保留了读取当前页面、可选附带截图、结合页面上下文对话这条核心能力，不包含弹幕、字幕、学习卡片、股票分析等站点定制模式。

## Features / 功能

- Native Chrome `Side Panel` chat UI
- Multi-turn conversation
- Per-page chat history persistence
- Optional page context for each turn
- Optional screenshot for each turn
- Screenshot mode: `viewport` or `full page`
- Expandable per-message details in debug mode

- 使用 Chrome 原生 `Side Panel`
- 支持多轮对话
- 按页面保留历史对话
- 每轮可选是否附带页面内容
- 每轮可选是否附带截图
- 支持 `当前视野` / `整个页面` 两种截图范围
- Debug 模式下可展开查看每轮详情

## Install / 安装

1. Open Chrome and visit `chrome://extensions`
2. Enable `Developer mode`
3. Click `Load unpacked`
4. Select `/Users/ruska/projects/chrome 插件/Sensa_basic`

1. 打开 Chrome，访问 `chrome://extensions`
2. 开启 `开发者模式`
3. 点击 `加载已解压的扩展程序`
4. 选择目录 `/Users/ruska/projects/chrome 插件/Sensa_basic`

## Configuration / 配置

1. Open the side panel from the extension icon
2. Click `设置`
3. Fill in your `API Key`
4. The default `Base URL` is `https://api.aixhan.com/v1`
5. The default model is `gpt-5.4`
6. Adjust prompt, font size, and screenshot mode if needed
7. Save

1. 点击浏览器工具栏里的插件图标，打开侧边栏
2. 点击顶部 `设置`
3. 填入你的 `API Key`
4. 默认 `Base URL` 为 `https://api.aixhan.com/v1`
5. 默认模型为 `gpt-5.4`
6. 按需调整系统提示词、字体大小、截图范围
7. 保存设置

## Usage / 使用

1. Open any webpage
2. Open the Sensa Basic side panel
3. Choose whether to include page context and screenshot for this turn
4. Type your question
5. Send

1. 打开任意网页
2. 打开 Sensa Basic 侧边栏
3. 选择本轮是否附带页面内容和截图
4. 输入你的问题
5. 点击发送

## Notes / 说明

- Sensa Basic does not continuously upload page data in the background
- Fresh page context is only attached when you check it for the current turn
- Fresh screenshot is only attached when you check it for the current turn
- Chat history is persisted per page URL
- This version intentionally excludes site-specific adapters and special modes

- Sensa Basic 不会在后台持续实时上传页面
- 只有在本轮勾选“页面内容”时，才会附带最新页面上下文
- 只有在本轮勾选“截图”时，才会附带最新截图
- 历史对话按页面 URL 维度持久化
- 该版本刻意不包含站点定制适配器和特殊模式
