前言¶
做智能体或长会话时,资料和链接往往散在浏览器收藏夹里,和 DeepSeek Harness(DSH)主界面是两套入口。靠记忆或临时翻 Chrome 书签栏,成本高,也不方便在对话里直接引用某条收藏。
星河书签(dsh-bookmarks-desk)是 DSH 生态里分类为「记忆」的插件,把本机 Chromium 系浏览器的书签以只读方式接进侧栏:索引列表与书脊书架两套视图、自建无限层级分类、搜索与卡片详情,分类与备注落在本地目录,不写回浏览器书签文件。下面介绍它是什么、能做什么、如何安装与典型用法。
这是什么¶
安装并启用后,DSH 侧栏会多一个「星河书签」面板。插件读取本机浏览器书签文件(只读不改),在面板里展示收藏,并在 ~/.dsh/bookmarks-desk/ 保存你自己的分类树、改名、简介等覆盖数据。
维护者为 GitHub 用户 hanxiaoxin0715,仓库 hanxiaoxin0715/dsh-bookmarks-desk,当前 package 版本为 0.1.0,许可证 MIT。社区目录页:SkillHub 插件页(独立站点,与 DeepSeek / 幻方无官方从属关系)。
核心功能¶
两套视图¶
- 索引视图:一行一条,展示标题、域名、简介、分类、添加时间;
Ctrl K搜索,↑↓选择,Enter打开。 - 书脊视图:按分类分层的书架,每条收藏像一本书;悬停出浮层,点开在右侧停靠卡片。两种视图可一键切换,滚动位置和选中项会保留。
分类与系统视图¶
分类由你自己建立,插件不预置分类体系。左栏可内联新建主分类,在任意分类的 ⋯ 菜单里新建子分类,层级不限;支持双击改名,以及上移、下移、删除(删父级会级联删子分类,书签退回「未分类」,不删浏览器里的原始收藏)。
系统视图包括:全部收藏、最近添加、未分类,计数随数据更新。左栏搜索框可按分类名过滤,命中项连同祖先链一起显示。
卡片详情与交互¶
卡片展示简介、分类(下拉直接改归类)、文件夹路径、添加时间、来源、网址;可操作:打开、复制链接、发到新会话、记到备注。浮层会根据鼠标在左半屏或右半屏自动出现在对侧,减少遮挡;点开卡片后列表会为停靠卡片让位。
安全与数据¶
插件只对浏览器书签文件做 readFile,不写入 Chrome 等配置。本地数据目录 ~/.dsh/bookmarks-desk/ 中,overrides.json 存分类与覆盖信息,enrich.json 存助手生成的简介缓存,pins.jsonl 存置顶;README 说明插件无上报逻辑。
安装与启用¶
环境要求:DSH >= 0.2.1-rc.5(package.json 中为 <0.3.0),Node >= 20。
方式一:DSH Desktop¶
打开 设置 → 插件,搜索 dsh-bookmarks-desk 安装,然后重启应用。
方式二:命令行(GitHub)¶
dsh plugin --profile desktop add github:hanxiaoxin0715/dsh-bookmarks-desk
装完后重启 dsh web 或 DSH Desktop,侧栏会出现「星河书签」。--profile desktop 可换成你自己的 profile 名;DSH Desktop 自带 profile 建议用应用内插件设置,命令行无法改其运行中状态。
方式三:命令行(npm,发布到 npm 之后)¶
dsh plugin --profile desktop add dsh-bookmarks-desk
卸载¶
dsh plugin --profile desktop remove dsh-bookmarks-desk
本地面板数据在 ~/.dsh/bookmarks-desk/;若要一并清除,需手动删除该目录。
浏览器与配置¶
默认只读 Chrome。Windows、macOS、Linux 上支持 Chrome、Chrome Beta、Edge、Brave、Chromium。主力浏览器读不到书签时会自动尝试其它浏览器,避免面板为空。已登录 Chrome 时优先读 AccountBookmarks,否则退回普通 Bookmarks。
合并多个浏览器时设置环境变量:
# macOS / Linux
export BOOKMARKS_DESK_BROWSERS=chrome,edge,brave
# Windows PowerShell
$env:BOOKMARKS_DESK_BROWSERS = "chrome,edge"
可用值:chrome、chrome-beta、edge、brave、chromium。
典型用法¶
日常浏览与归类¶
- 在侧栏打开「星河书签」,在索引视图用
Ctrl K搜标题或域名,用Enter在系统浏览器打开。 - 切换到书脊视图,按自己的项目建分类树,在卡片详情里用分类下拉把收藏归到对应节点。
- 使用「全部 / 最近添加 / 未分类」系统视图处理新导入或未归类的条目。
本地预览(无需安装 DSH)¶
仓库提供虚构示例数据 examples/demo-bookmarks.json。可在插件目录执行:
node scripts/preview.mjs
会在本机启动预览服务(README 示例为 http://127.0.0.1:62605/),用示例数据注入真实面板 UI,改 panel/index.html 后刷新即可,无构建步骤。
批量归类(可选)¶
scripts/classify.mjs 按你已建好的分类名,结合文件夹同名、域名/标题命中、内置主题词典或 --rules ./my-rules.json 做批量归类;只写入 overrides.json,不写浏览器书签。
node scripts/classify.mjs # 只打印分布,不写入
node scripts/classify.mjs --write # 写入(自动备份 overrides.json)
node scripts/classify.mjs --inbox 收件箱 --write # 未命中项归到「收件箱」
适用场景与注意¶
适合在 DSH 里做研发、写作或长对话、又大量依赖 Chromium 收藏夹作为「外脑」的用户:侧栏即可检索、分类、把链接发到新会话或记备注,无需来回切浏览器。
安装前建议自行查看仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行,会读本机浏览器书签路径;虽声明只读且不上传,仍属敏感本地数据,环境应在你可控的机器上使用。
不支持 Safari 等非 Chromium 书签格式;多浏览器合并依赖 BOOKMARKS_DESK_BROWSERS 与环境中的实际安装情况。
结尾¶
星河书签把浏览器收藏只读接进 DSH 侧栏,用自建分类与双视图把链接管理和对话上下文放在一起,本地存储、不写回浏览器。进一步了解可看 SkillHub 目录页 与 GitHub 仓库。