dsh-reading-mode

DSh（DeepSeek Harness）阅读模式插件：英语文章批注阅读面板。Host 端提供模型分析服务，Client 端在阅读会话中渲染右侧批注面板，支持选中句子/文段提问、一键解析文章难点（词汇、句式、熟词生义、短语、修辞、背景与主旨结构）。

功能

• 📖 在 agentPreset === 'reading' 的会话中显示阅读批注入口（会话头部按钮 / 侧边栏底部按钮）。
• 📝 粘贴英文文章后，文章按段落和句子切分渲染。
• ❓ 点击句子或选择文段添加批注问题，提交后由当前会话模型统一回答（答案内联显示在原文下方）。
• 🔍 一键解析：输出文章主旨与段落结构、难点句子、生僻词汇、熟词生义、特殊句式、地道短语、写作手法、文化背景。
• 🪟 右侧浮层面板，支持编辑、删除、折叠批注；模型未返回结构化 JSON 时展示原始输出。

目录结构

dsh-reading-mode/
├── lib/                 # 构建产物（host + client bundle）
│   ├── index.js         # host 插件：/reading-mode/start、/reading-mode/poll
│   ├── client.js        # client bundle（由 scripts/build-client.js 生成）
│   └── types/index.d.ts
├── src/
│   └── client.js        # client 源码
├── scripts/
│   └── build-client.js  # 重新生成 lib/client.js
├── presets/
│   └── reading/         # 阅读模式 agent preset 示例
├── package.json
└── README.md

npm 安装（GitHub 直接安装，未发布到 npm）

npm install github:lidonwonk/dsh-reading-mode

安装到 dsh

1. 将本仓库克隆/复制到 $DSH_HOME/plugins/dsh-reading-mode/（$DSH_HOME 默认为 ~/.dsh）。
2. 将 presets/reading/ 下的两个文件复制到 $DSH_HOME/.agent-presets/reading/：
   • preset.yml
   • agent.cordis.yml
3. 确保 dsh 配置中已有可用模型，例如 ~/.dsh/settings.yaml 中设置了 agent-default-model；插件会优先跟随会话实际模型。
4. 重启 dsh web（或按 dsh 的插件热更新机制加载）。

使用

1. 在 dsh 中新建/切换到 reading 预设的会话。
2. 点击会话头部或侧边栏底部的 📖 阅读批注。
3. 粘贴英文文章并点击 载入文章。
4. 点击任意句子，或选中一段文字后点击浮出的 ❓ 添加疑问，输入问题并保存。
5. 点击 提交问题 (N) 获取所有批注问题的回答。
6. 点击 一键解析 生成全文难点分析。

开发

修改 src/client.js 后，重新生成 client bundle：

node scripts/build-client.js

验证语法：

node --check lib/index.js
node --check lib/client.js

说明

• 插件通过 HTTP 路由与 client 通信：POST /reading-mode/start 创建任务，POST /reading-mode/poll 轮询进度。
• Host 端任务为后台流式调用模型；最大同时任务数 50，请求体上限 2 MB。
• 阅读面板的 CSS/状态全部内置于 client bundle，不依赖额外前端构建链。
• 本项目在termux环境下开发，不同平台上可能存在兼容性或者UI问题。