adhdgofly-dsh-ext

dsh plugin --profile web add adhdgofly-dsh-ext

adhdgofly-dsh-ext

把 adhdgofly-ide-ext 的词性高亮机制搬进 DeepSeek Harness（DSH）Web 界面：在已渲染的 Markdown 内容区（对话消息、Deliverables 等）把名词染绿、动词染红、形容词/副词染紫、其他染灰，支持深/浅双色板、词性筛选即时开关、流式输出防抖与代码块豁免。

本插件是纯客户端 DOM 后处理插件（dsh.client 双面包），不改 DSH 源码；分词引擎与压缩词典来自 ADHDGoFly 生态（MIT），经 npx @deepseek-ai/dsh plugin --profile web add 一条命令安装。

---

功能

• 词性高亮：英文（含后缀词形还原）+ 中文（正向最大匹配），名词绿 / 动词红 / 形副紫 / 其他灰。
• 深/浅色板：跟随 DSH 主题（theme 服务），颜色与 adhdgofly-ide-ext 一致。
• 词性筛选：即时生效——文字保留、颜色移除（CSS 覆盖，无需重新分词）。
• 高亮样式：color（文字变色，默认）/ highlight（背景框 + 边框）。
• 流式兼容：[data-streaming] 消息流完前跳过，settle 后自动高亮；MutationObserver + 防抖 + 重入锁。
• 代码块豁免：pre/code、.markdown-code-block、按钮/输入框/装饰区不参与高亮。
• 属性契约（v0.1.2）：任何带 data-adhdgofly-highlight 属性的元素自动被高亮（无需写入 containers 配置、无需重新加载）——openharness-reader 的 Markdown 预览即用此契约接入；其他插件可照此联动。未带该属性的页面不受影响。
• 设置页（v0.1.3 双模式）：配置面有两个并存入口——① Settings → ADHDGoFly 左侧分区（保留原位，老习惯不变）；② Settings → 插件 → 「插件配置」标签页里的 ADHDGoFly 卡片（rc.7 官方插件设置机制）。两者绑定同一个 adhdgofly settings 命名空间（宿主侧 schema 持久化，loopback 下改任一处另一处自动同步）；远程浏览器自动回退 localStorage。可在设置里用「设置入口 / Settings entry」选择只留一种（both/classic/plugin-card，刷新生效）。
• 词频统计（v0.2.0，方案 012）：自动累计高亮词频（仅存本浏览器 localStorage，不上传；内容哈希 LRU 去重，React 重挂载不重复计数）。设置两个入口均提供「设置 / 统计」双标签页，统计页含：概览（累计/今日/连续天数）、螺旋词云（高频词居中、字号随词频增大、按词性着色；支持 50/100/200 词与名词/动词/形副筛选，中文/English 分语）、近 30 天趋势、词性分布、Top 20、新词速览（近 7 天新晋高频词）、一键清空。statsEnabled 可整体关闭统计。
• 主界面浮动开关（v0.2.0）：右下角高亮笔按钮，单击即开/关词性高亮，与设置页开关双向同步；开启时按钮上方显示迷你统计（今日/累计词数 + 今日 Top3），关闭时已高亮的文字自动去色（重新开启即时恢复，无需重新分词）。

安装

前置：本机已安装 DeepSeek Harness（DSH），且已初始化 web profile（npx @deepseek-ai/dsh web 跑过一次即可）。当前版本 0.1.5。

方式一：App 插件中心（推荐，无需命令行）

1. 下载并安装 openharness 桌面 App：

• 发布页：<https://github.com/zuoguyoupan2023/openharness/releases>（当前 v0.1.0：<https://github.com/zuoguyoupan2023/openharness/releases/tag/v0.1.0>）

2. 打开 App，在左侧边栏进入「插件中心」；

3. 在「特别推荐」里找到 adhdgofly-dsh-ext；

4. 点击「安装」，等待安装完成——DSH 会自动重启并应用，无需手动操作；

5. 重启后即可在 Web 设置里看到配置入口（见 §配置）。

方式二：命令行安装

# 1) 安装 DSH（首次）
npx @deepseek-ai/dsh web

# 2) 安装插件
npx @deepseek-ai/dsh plugin --profile web add adhdgofly-dsh-ext

#    若 pnpm ≥ 10 报 ERR_PNPM_ADDING_TO_ROOT，命令末尾加 -w：
npx @deepseek-ai/dsh plugin --profile web add -w adhdgofly-dsh-ext

⚠️ 命令行安装后必须重启 DSH 才生效

1. 在正在运行的 DSH Web 终端按 Ctrl+C 停止当前进程；

2. 重新启动：npx @deepseek-ai/dsh web

（若机器已把 dsh 装进 PATH，dsh web / dsh --profile web 与之等价，任选其一）

3. 等 Web 界面重新打开后刷新浏览器页面。

不重启的话，正在运行的 DSH 进程的 boot 图里没有本插件，刷新页面也不会加载它。

npx @deepseek-ai/dsh plugin add 会：

1. 在 ~/.dsh/profiles/web 里 pnpm add 本包；

2. 自动 reconcile：检测到 dsh.bundle 声明，把 adhdgofly-dsh-ext 追加进 dsh.profile.bundles，成为 profile 补丁层。

升级 / 卸载

# 升级到最新版（当前 0.1.5）
npx @deepseek-ai/dsh plugin --profile web update adhdgofly-dsh-ext

# 卸载
npx @deepseek-ai/dsh plugin --profile web remove adhdgofly-dsh-ext

• 命令行升级/卸载后，同样需要 Ctrl+C 停止 → npx @deepseek-ai/dsh web 重启 → 刷新浏览器。
• App 插件中心里升级/卸载会自动重启并应用。

本地开发安装（file: 符号链接，改代码无需重装）

# 在插件仓库目录或其父目录执行（file: 相对路径以调用目录为锚）
npx @deepseek-ai/dsh plugin --profile web add file:../adhdgofly-dsh-ext

file: 依赖是符号链接：客户端改动 npm run build 后刷新页面即可（DSH Web 无 HMR）；patch / bundles 改动需重启 profile。安装后同样需要按上面的提醒重启一次才生效。

验证

npx @deepseek-ai/dsh --profile web --dump-config | grep -A3 adhdgofly   # 合成树里应有插件行
# 浏览器 DevTools → Network 应能看到 /plugins/adhdgofly-dsh-ext/client.js 正常返回

说明：v0.1.3 起配置面走 rc.7 插件设置机制——host 半注册 adhdgofly settings 命名空间（schemastery schema，row config 作为 base 层），client 半经 ctx.settingsScope 读取；loopback 下由宿主持久化，localStorage 仅作远程浏览器的回退缓存（见 §配置）。

公开发布（让其他用户安装）

本插件是标准的 DSH npm 插件包：dsh.bundle.patch 声明 + exports["./client"] 浏览器 bundle。推荐发布到 npm（DSH 官方同步开放 npm 插件生态），GitHub 仅作源码托管；从 GitHub 直接安装也可用，但需要额外配置（见下）。

方式一：发布到 npm（推荐）

前置：npm 账号已登录（npm login；未登录发布会报 E401），包名未被占用（npm view adhdgofly-dsh-ext 返回 404 即可用）。

npm run build:all          # 1) 生成压缩词典 2) 构建 lib/（prepublishOnly 会自动执行）
npm test                   # jsdom 冒烟测试（prepublishOnly 会自动执行）
npm publish                # 发布：自动跑 prepublishOnly（build:all + test）后再上传

• 发布内容由 files 字段决定：lib/（host + client bundle）、dicts/（压缩词典）、cordis.patch.yml、README.md（LICENSE / package.json 自动包含），压缩后约 4.4MB。
• 升级版本：npm version patch|minor|major && npm publish。
• 其他用户安装（见 §安装）：App 插件中心「特别推荐」，或命令行 npx @deepseek-ai/dsh plugin --profile web add adhdgofly-dsh-ext（pnpm ≥ 10 报错时末尾加 -w）；升级用 npx @deepseek-ai/dsh plugin --profile web update adhdgofly-dsh-ext。

方式二：从 GitHub 直接安装（备选）

npx @deepseek-ai/dsh plugin --profile web add github:你的用户名/adhdgofly-dsh-ext
# 或 git+https://github.com/你的用户名/adhdgofly-dsh-ext.git

注意：pnpm 默认阻止依赖的构建脚本（prepare），且本仓库 .gitignore 排除了 lib/ 与 dicts/ 构建产物。git 安装若要可用，二选一：

1. 发布分支强制包含构建产物：git add -f lib dicts（构建产物随源码提交，仓库体积约 +17MB）；

2. 或包内增加 prepare 构建脚本，并在安装方 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 中放行本包（pnpm 会在安装时打印所需的精确配置项）。

因此日常发布以 npm 为主，GitHub 用于源码协作、issue 与版本标签。

配置

配置项 · 默认 · 说明

enabled · true · 总开关

languages · ['en','zh'] · 启用词典语言

minWordLength · 2 · 最小词长

decorationStyle · 'color' · color 变色 / highlight 背景框

posFilter · ['n','v','a','o'] · 词性筛选（n 名词 / v 动词 / a 形副 / o 其他）

containers · ['[data-conversation-scroll]'] · 高亮根容器 CSS 选择器，可追加其他 Markdown 渲染区

三种改法（按优先级）：

1. 设置页（推荐，v0.1.3 双入口）：Settings → ADHDGoFly 左侧分区 或 Settings → 插件 →「插件配置」的 ADHDGoFly 卡片。两者绑定同一个 adhdgofly 命名空间，loopback 下由宿主持久化、互相同步；改动即时生效。

2. 行 config（~/.dsh/profiles/web/cordis.patch.yml 按 id 覆盖整行）：作为命名空间的 base 层，经 ctx.settingsScope 流入 client（rc.7 起生效）。

3. 代码默认值：改 src/host/index.ts 的 SCHEMA 默认值 与 src/client/config.ts 的 DEFAULT_CONFIG 后重新构建。

远程浏览器（非 loopback）说明：DSH 的 settings RPC 仅限 loopback，远程浏览器里设置不持久化、插件卡片不显示；此时高亮使用 localStorage 回退缓存（本地记忆）或内置默认。

开发循环

np

…(truncated)