dsh-my-favorites

DSH My Favorites

为 DeepSeek Harness Desktop 提供本机的会话与网址收藏功能。

兼容性

• 本插件要求 DSH ≥ v0.1.2-alpha.1。
• 不兼容 DSH v0.1.1-rc.2 及更早版本：v0.1.2-alpha.1 存在破坏性更新，@deepseek-ai/dsh-client-runtime 已被移除，createSnapshotStore 迁入新私有包 @deepseek-ai/dsh-client-store，插件客户端已按新包名导出适配。
• @deepseek-ai/dsh-client-* 与 dsh-home-paths 均为 DSH 私有包、未发布到公共 npm，运行时由 DSH 自身编译产物解析；插件不把它们声明为可安装依赖（dependencies/peerDependencies 均不写入），因此 dsh plugin add 走公共 registry 也能正常安装。请使用对应版本的 DSH Desktop 安装本插件。

功能

会话收藏

• 在会话标题栏中，紧邻 Preset（例如 Coding 模式）控件显示星标按钮。
• 点击 ☆ 收藏当前会话；点击 ★ 立即取消收藏。
• 在左侧侧栏 “新会话”按钮正下方 显示收藏区域：全部网址收藏以 icon/1–4 个字符的紧凑标签常驻显示，悬停可查看名称和 URL。
• 收藏会话 (N) 为默认收起的会话收藏夹；点击展开或关闭，展开后点击会话会切换并自动收起。
• 在会话收藏夹中按住 ⌘ Command 拖动会话项即可调整排序。
• 点击会话标签或完整收藏列表中的会话，即可切换到该会话。
• 会话标题变化后，侧栏和收藏列表优先显示最新标题；已删除或无法打开的会话可从收藏列表中移除。
• 当前会话在收藏夹中以「整行常驻 hover 背景」标注为激活状态。

快捷键切换

• 快速按 ⌘+⌥+`` （macOS）或 Ctrl+`` （其它平台）并松开：立即切换到上一个收藏会话，不弹出列表。
• 长按（约 0.25 秒）：弹出居中的收藏会话切换列表；继续按住则循环高亮，松开确认切换所选会话；Esc 或点击遮罩取消。
• 兼容死键（dead key）键盘布局：切换器依赖物理键位而非 ` 的 keyup 事件，在中文/多语言输入法下同样可靠。

网址收藏

• 侧栏“收藏”弹层同时展示已配置的网址收藏。
• 每个网址收藏包含名称、URL、可选自定义 icon 与“使用网站图标”开关；侧栏标签展示优先级固定为 网站 favicon > 自定义 icon > 名称。网站图标从 {协议}://{域名}/favicon.ico 加载，失败时自动回退。
• 点击网址会通过 DSH Desktop 的外部链接策略，在系统默认浏览器中打开。
• 仅允许 http:、https: 与 mailto: URL。
• 「启用收藏的网站」开关（默认开启）：关闭后侧栏不再显示网址快捷标签，仅保留会话收藏夹；已保存的网址收藏与设置项完整保留，重新开启即恢复显示。

插件配置

在 设置 → 插件 → 插件配置 → 收藏 中可以：

• 新增网址收藏；
• 编辑名称、URL 和自定义字母徽标；
• 删除网址收藏；
• 调整网址收藏的显示顺序；
• 用「启用收藏的网站」开关控制侧栏网址快捷标签的显隐。

安装与构建

构建

在插件目录执行：

pnpm install
pnpm run build

构建后的入口为：

• lib/index.js：Host 侧收藏存储服务（持久化到 $DSH_HOME/storages/dsh-my-favorites.json，并暴露 myFavorites RPC 服务）；
• lib/typert.host.js：Host 面 Typert 清单（./typert，由 DSH 的 typert-loader 自动注册）；
• lib/client.js：DSH Web 客户端 UI 扩展（经 remote.myFavorites.* 读写收藏数据）。

安装到 DSH

DSH 通过 dsh plugin 子命令管理 profile 插件（等价于在 profile 目录内执行 pnpm）。安装本插件：

# 从 GitHub 安装（推荐；可加 #tag/分支 锁定版本）
dsh plugin --profile web add github:qiqiangvae/dsh-my-favorites

# 本机/开发：从本地路径软链接安装
dsh plugin --profile web add link:/path/to/dsh-my-favorites

# 从 npm 安装
dsh plugin --profile web add dsh-my-favorites

将 <profile> 换成你的目标 profile（如 web、desktop、tui）。

必须同时把 dsh-my-favorites 列入该 profile package.json 的 dsh.profile.bundles 数组；只加入 dependencies 不会启用插件。安装后重启 DSH（或重新加载 profile）即可生效。

数据与限制

• 收藏数据保存在本机 $DSH_HOME/storages/dsh-my-favorites.json（默认 ~/.dsh/storages/dsh-my-favorites.json）中，不写入 settings.yaml，不跨设备同步，也不提供导入/导出。
• 会话收藏保存的是当前 DSH 实例内的会话 ID，因此不适合跨机器、跨 DSH 数据目录迁移。
• 远程浏览器连接不具备宿主 RPC 写入权限时，收藏设置不会持久化。
• 若已收藏的会话被删除或当前实例不再能识别该 ID，切换会话会失败；请从收藏列表移除该条目。

开发验证

本项目已通过以下本地验证：

pnpm run typecheck
node --check lib/index.js
node --check lib/typert.host.js
node --check lib/client.js

本机若缺少 DSH 私有包的 pnpm 离线镜像元数据，pnpm install --offline 可能失败；可在具备 DSH 依赖源的环境中正常安装并构建。