Skip to content
Back to search

dsh-guide-tutor

屏幕教学助手:悬浮球 + 实时标注 + 步骤面板(DeepSeek Harness 插件)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fahsq72lan--dsh-guide-tutor/badge.svg)](/listings/fahsq72lan--dsh-guide-tutor)

HTML

<a href="/listings/fahsq72lan--dsh-guide-tutor"><img src="/api/listings/fahsq72lan--dsh-guide-tutor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 91 lines
  1. # 屏幕教学助手
  2. 在 Windows 桌面上手把手教你操作。点一下悬浮球,它截屏、在屏幕上画圈、旁边写步骤、用语音念出来,你照着做完点「下一步」。
  3. 本地跑,不录屏、不上传。
  4. ## 用起来是什么样
  5. 1. 你说「教我 xxx」,或者直接点球;
  6. 2. 它看一眼你的屏幕,在面板上写下这一步要做什么;
  7. 3. 在屏幕上把要点的按钮圈出来,箭头指过去;
  8. 4. 说话解释,字幕跟着语音走;
  9. 5. 你做完点「下一步」,它重新截屏,看对不对,再给下一步;
  10. 6. 完事点「✓」,标注清掉,面板收回球。
  11. 卡住了直接说「我不知道在哪」,它会重新截图找。
  12. ## 两个进程
  13. - `index.js` —— DSH 插件,注册 `guide_*` 工具,管知识库,把悬浮层拉起来并守着它,对外开一个本机 HTTP + SSE。
  14. - `native/overlay.ps1` —— PowerShell + WPF 写的悬浮层,三扇窗口:球、全屏标注层(鼠标穿透)、半透明面板。
  15. 改 `index.js` 要重启 DSH;改 `overlay.ps1` 只要 `guide_overlay restart`。
  16. ## 工具
  17. | 工具 | 干什么 |
  18. | --- | --- |
  19. | `guide_screen` | 截屏,返回图片给模型看 |
  20. | `guide_teach` | 画标注 + 写面板(标题、正文、步骤、当前步) |
  21. | `guide_say` | 朗读 + 同步字幕 |
  22. | `guide_finish` | 收尾:清标注、折叠面板 |
  23. | `guide_overlay` | 启停悬浮层 |
  24. | `guide_kb` | 知识库读写(.md / .docx) |
  25. | `video_*` | B 站视频:取字幕、写摘要、回忆 |
  26. 清单、番茄钟、专注环、日记、时间线这些在 `guide-coach` 里,不在这里。
  27. ## 装
  28. 已经装在 desktop profile 里(`link:` 到本目录)。重装:
  29. ```
  30. plugin_manager action=install_bundle target=<本目录绝对路径>
  31. ```
  32. 改完 Host 代码记得重启 DSH。没有热重载。
  33. ## 数据在哪
  34. `%USERPROFILE%\.dsh\guide-tutor\`
  35. | 文件 | 是什么 |
  36. | --- | --- |
  37. | `state.json` | 面板、标注、球的唯一真相,悬浮层每 250ms 读一次 |
  38. | `events.jsonl` | 悬浮层发给宿主的事件(ready / captured / step / mode / voice / done…) |
  39. | `shots\` | 每张截图 |
  40. | `kb\` | 知识库 |
  41. | `chatlog.json` | 面板「记录」看的那份对话流水,最多 120 条 |
  42. | `overlay.log` / `plugin.log` | 出问题先看这俩 |
  43. ## 一些细节,都是踩过坑才这么写的
  44. **字幕位置**:出现在最近一次标注旁边,放不下就放上面;没有标注时在屏幕底部居中。
  45. **语音**:默认用 Edge 的晓晓(`zh-CN-XiaoxiaoNeural`,要联网),合成失败自动退回系统 SAPI 的惠惠。想完全离线就把 `config.ttsEngine` 设成 `sapi`。回复会拆成一句一句念,句间停顿,不是一口气念完。
  46. **面板大小**:底部滑块 70%–180%,只缩放上半部分。底部那排按钮不跟着变,不然滑块会越拖越长、直接冲到顶。
  47. **顶部任务条**:显示当前时段该做的事,带秒级倒计时。没课的时候自动隐藏。
  48. **球上滚轮**:`Ctrl + 滚轮` 一档 5%。
  49. **端口**:默认 41999,被占了自动 +1。状态页是 `http://127.0.0.1:41999/`。
  50. **浏览器**:状态页可以装成桌面应用(Edge 地址栏右侧「安装此站点为应用」)。需要 `assets/` 里的图标。
  51. ## 为什么有些东西看着奇怪
  52. - **标注层要鼠标穿透**:不然你点不到下面的按钮。
  53. - **截屏前先隐藏 0.2 秒**:不然截图里全是自己的标注和面板。
  54. - **球和面板同一帧切换**:分两帧会闪。
  55. - **改 HTML 里的正则要小心**:`index.js` 的 dashboard 模板是模板字符串,`\/` 会被吃掉,得写成 `[/]`。
  56. ## 知识库
  57. `kb\` 下面放 `.md` 或 `.docx`。存 Word 时用 Markdown 生成排版(标题、列表、表格都能转),也能导入已有的 `.docx`。
  58. ## 视频
  59. 支持 B 站:`video_learn` 拿字幕存进视频库,`video_note` 写摘要,`video_recall` 按关键词回忆。没登录态的话用 `video_cookie` 存 SESSDATA。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.