前言¶
做智能体或长会话时，资料和链接往往散在浏览器收藏夹里，和 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 仓库。
