会话置顶着色 PerryLink/dsh-session-pin

📌 dsh-session-pin

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-session-pin（会计入 deepseek1024.com 的安装排名）。

dshfind

🪦 已退役 —— 自 2026-10-05 起停止兼容性更新。 这项能力现在由官方 harness 自身实现：DeepSeek Harness 原生内置会话置顶 —— dsh-client-ui-workspace 里的会话行菜单和悬停按钮可以置顶、取消置顶会话，置顶集合持久化在 Host 上，置顶行之间会重新排序，全部挂载在默认 Web bundle 中。这里仅剩的独有部分只是视觉层（每个置顶的行颜色、看板、标签、已保存视图）。👉 请改用内置的会话置顶。 本仓库继续公开供参考，但不会再跟进后续 host 变更。

把会话和工作区置顶到 DeepSeek Harness 侧边栏顶部，并支持为每个置顶设置行颜色。

双面（host + 浏览器）插件：两级置顶、每个置顶 8 色色板，外加一个导航整理器 —— 看板、标签、已保存视图、健康摘要和 /goto。

官方仓库。 这是 dsh-session-pin 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库均无关联。

dsh-doctor
DSH Market

English · 简体中文 · Español · Português · हिन्दी

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（40+ 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 40+ plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

兼容性

| 层面 | 状态 |
| Harness | DeepSeek Harness dsh-v0.2.1-alpha.1（GitHub tag；2026-09-22 验证：双尺 typecheck + 单元/组合测试套件 + 静态接缝检查；浏览器实测待维护者确认）。npm 依赖行 0.1.7-rc.2，peers >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0。 |
| Node | >= 22（开发下限） |
| 平台 | Web GUI（双面：host + 浏览器） |
| 模型 | 任意（纯 UI —— 不产生模型流量，不产生会话事件） |
| session/pin 事件 | 预检门控：只有当 host 的运行时事件词表认识该类型时才会写入（alpha 线的 append 已经无法再打上 ignorable 标记，所以词表成了唯一的门控信号 —— 2026-09-18 适配）；否则投影降级为设置缓存，并在首次写入前触发一条警告。 |

你能得到什么

dsh-session-pin 把重要的对话固定在侧边栏顶部，并给它们上色，让你一眼就能找到：

- 两级固定 —— 可以固定整个工作区和单个会话；固定的工作区移到工作区列表最前，固定的会话移到它所属账号的最前。
- 每个固定项单独配色 —— 每个固定项后面的色块循环切换 8 色预设调色板（Shift+点击清除）；该行会得到一条左侧强调条加一层半透明底色。
- 四个固定入口 —— 每一行悬停时出现的 [pin][swatch] 组合、会话标题栏里的固定开关、侧边栏底部的操作项（带固定面板），以及按浏览器持久化的固定，重启后仍保留固定项和颜色。
- 点击即打开 —— 点击侧边栏或固定面板里的固定行，会在当前窗口打开该会话（和 /goto 用的是同一个接缝）；两者在 alpha 线上都通过 host 的会话保留通道跳转。
- 零核心改动 —— 面向原版 DSH Web GUI 的独立插件；在较旧的基线上，每个入口都会优雅降级。

┌─ Workspaces ────────────────────────────┐
│ 🎨 Workbench ███ │ ← pinned workspace, tinted red
│ 📌 Implement login flow 3h │ ← pinned session, tinted teal
│ Fix the auth bug 1h │ ← hover shows a gray pin + swatch
│ Refactor the DB layer 2d │
└─────────────────────────────────────────┘

导航整理器

在固定功能之上，还有四项浏览器本地能力，用来整理多会话工作。所有状态都走同一个 session-pin 存储（按浏览器隔离；不上传任何内容），每一项都有 Config 开关。
- 看板 — 固定项归入命名分组；看板芯片行负责创建、重命名、删除看板，并拖拽调整顺序（顺序按浏览器保存），而固定面板把每个看板的固定项归到可折叠标题下。
- 标签与视图 — 实体最多带 8 个标签（每个 ≤24 字符），通过面板的管理按钮按行设置（同时指定固定项所属看板）；筛选栏匹配文本和标签，任何筛选状态都能存成命名视图（最多 20 个），一键切换。
- 健康摘要 — 每个固定的会话行追加一行只读、脱敏的信息（N msgs · you|ai · relative time），来自公开的会话快照 — 只有计数和方向，绝不含内容。
- /goto <keyword> — 输入框里以 /goto 开头的一行加回车即可跳转：标题或标签唯一匹配就直接打开，多个匹配在提示里列出，没有匹配则给出说明。命令行永远不会到达模型。

工作原理

- 宿主部分（src/index.ts）— 把 session-pin 设置表单声明为插件自己的实时 Config：两个固定 id 列表、两个颜色映射、整理器状态，以及宿主策略（maxPins/reorderOnLoad/pruneStale 加五个功能开关）全是 .volatile() 字段。在 0.1.7 设置契约下，表单的命名空间就是其配置档条目的本地 id，所以 bundle 补丁里的 id: session-pin 行给表单命名，Plugins 页面编辑它，接受的编辑会热应用到运行中的插件；没有会话事件，没有模型流量。
- 浏览器部分（src/client.ts）— 组装一个不依赖框架的 PinStore（宿主部分的实时 Config 表单，通过 ctx.configForms.get(entryId) 读取，降级为带跨标签页同步的版本化 localStorage 文档）、一个 PinController（两级切换 / 颜色循环 / 清理 / 重排状态机），以及 UI：行覆盖层、可选的 row-slot 注册、头部切换、侧边栏底部操作，还有固定面板。排序走 ctx.workspaces。
- 日志支撑的写入通道 — 在挂载内置 dsh-session-pin 服务的构建上，每次会话切换都先通过 session.setPinned RPC 提交（session/pin 事件日志是权威存储），再把提交镜像到设置存储；RPC 失败或缓慢时降级为直接写设置。
- 日志支撑的投影读取 —— enableLogBacking（宿主 Config，默认关闭，失败即封闭）会挂载一个投影读取器，把实时的 session/pin 事件折叠进规范 pin 集合，并把折叠后的 pinned/colors 镜像到实时 Config，后者成为日志支撑状态下的幂等缓存。事件 schema、纯折叠函数（foldPinEvents）以及预检门控的追加接缝（PinLogAppender）都在 src/pin-log.ts 里：只有宿主的运行时事件词表能在首次追加之前放行写入（alpha 线的追加不再能盖上 ignorable 标记，所以旧的标记探测已移除），因此无法安全承载该事件的主机——词表不认识该类型时读取失败即封闭——永远不会收到事件；实时 Config/localStorage 存储仍是兼容与降级路径。
- 客户端接缝 —— 浏览器侧从 @deepseek-ai/dsh-client-connection 读取 SessionId/WorkspaceId 品牌（已移除的 dsh-client-runtime 包在当前主机上不再存在）；会话头部槽位的标准套件席位按本地结构契约定型。在 0.1.2-rc.1 主机上，sessions.row.action 行槽位未声明，所以会话行回退到 DOM 覆盖层，行槽位注册保持延迟。
- 构建 —— esbuild 产出宿主 ESM 半边和客户端 CJS 半边，后者包在 web 启动工厂里（window.__ModuleLoader__.load({ id, factory })）；react 被外部化到 shell 自带的 React 上，纯度门禁会在任何 @deepseek-ai/* 值导入泄漏进浏览器 bundle 时让构建失败。

用到的扩展点： settings（宿主）；sessions、workspaces、configForms、connection、slots（客户端）；locale（客户端，可选）；conversation.session.header.actions、sidebar.footer.action、shell.overlay，以及上游的 sessions.row.action 行槽位（声明时可用；0.1.2-rc.1 主机不声明它——那里的会话行由 DOM 覆盖层兜底）。模型可见影响：无 —— 这是纯 UI 插件：不添加任何会话事件，也不向任何模型请求添加 token。

快速开始

1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-session-pin#main"

or from npm (published releases)
dsh plugin --profile web add dsh-session-pin

2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: session-pin'

加载器条目 id。 在 dsh-base bundle 挂载内置宿主服务 @deepseek-ai/dsh-session-pin（条目 id 为 session-pin）的 harness 构建上，请在配置档补丁行里给这个插件一个不同的条目 id，比如 id: session-pin-ui —— 重复的 session-pin id 会让启动失败，报 "duplicate loader entry id"。

安装与卸载

- git 渠道（最新 main）：dsh plugin --profile web add "github:PerryLink/dsh-session-pin#main" —— pnpm run build 产出宿主半边（lib/index.js）和浏览器半边（lib/client.js）。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-session-pin。
- tarball 渠道：在本仓库执行 pnpm pack，然后运行 dsh plugin --profile web add ./dsh-session-pin-<version>.tgz。
- 卸载：dsh plugin --profile web remove dsh-session-pin（或者从配置档补丁里删掉那一行——这一行本身就是设置表单的命名空间，删掉它，已保存的表单值也会一并删除）。

配置

所有可调项都是 Schemastery 的 Config 字段。下面每个字段都带 .volatile()，所以既能在配置档的 Plugins 页面实时编辑，也能在 cordis.yml 里改（编辑被接受后会直接提交到运行中的插件，不需要重新挂载）；pin 列表、颜色映射、organizer 状态都是同一类字段，浏览器端那份存储之所以能持久化，靠的就是这一点。enableLogBacking 故意没有设为 volatile：它从来不属于可编辑范围，也没有任何浏览器端代码读它。cordis.patch.yml 用下面的默认值挂载这个 bundle。

| 键 | 默认值 | 含义 |
| maxPins | 0 | 每层最多固定多少个实体（会话和工作区各有自己的额度）；0 = 不限 |
| reorderOnLoad | true | 列表就绪后，重新把固定的前缀排到最前（最新的 pin 排最前） |
| pruneStale | true | 丢掉就绪列表里不存在的实体（已删除/已归档）的 pin 和颜色 |
| enableBoards | true | 在侧边栏面板里启用 pin 分组（boards） |
| enableTags | true | 启用会话/工作区标签，以及面板的过滤栏 |
| enableViews | true | 启用保存的过滤视图 |
| enableHealth | true | 启用每个已固定会话的健康摘要（只读，已脱敏） |
| enableGoto | true | 启用 /goto <keyword> 输入框命令 |
| enableLogBacking | false | 把 session/pin 事件折叠成由日志支撑的投影，并镜像到设置缓存（fail-closed：启用后以会话日志为准） |

工具与界面

| 界面 | 类型 | 说明 |
| [pin][swatch] 行内控件 | UI slot / DOM overlay | 每一行会话和工作区上的悬停控件 |
| 会话头部开关 | UI slot | 头部操作行里同一个 pin 控件，按会话 id 关联 |
| 侧边栏底部 + 固定面板 | UI slot / overlay | 列出已固定的工作区和会话，按 board 分组（可折叠），每行都能管理 board/标签，并显示颜色圆点 |
| /goto <keyword> | command | 输入框里按标题/标签快速跳转；这一行永远不会送到模型 |
| session-pin 设置表单 | host service | 插件自己的实时 Config，按配置档持久化：pin、颜色、organizer 状态 |

权限与数据

- 权限：dshWorkshop manifest 声明了 browser:local-storage、settings:read 和 settings:write。
- 数据：置顶、颜色和整理器状态存放在插件的 session-pin 设置表单里（即 pinned/workspacePinned/colors/workspaceColors/boards/tags/views 这些易失的 Config 字段）。当 web 代理不提供入口时，降级为带版本号的 localStorage 文档（v1 文档会迁移）。不上传任何内容。开启 enableLogBacking 后，实时 Config 成为日志支撑的 session/pin 投影的幂等缓存。
- 会话日志：默认没有——本插件不添加任何会话事件，也不向任何模型请求添加 token。开启 enableLogBacking 后，宿主把仅存在于日志的 session/pin 事件（由上游 session.setPinned RPC 写入）折叠进规范置顶投影；PinLogAppender 会依据运行时事件词表对自己的写入做预检门控，因此无法承载该事件的宿主永远不会收到它。模型可见的影响始终为零。

安全边界

- 仅限 UI。 无模型可见影响，无网络，无子进程；每个界面在较旧的基线上都会优雅降级。
- 状态持久且有界。 置顶和颜色随实体删除一起清理（pruneStale）；maxPins 限制每一级的置顶数量。
- 只读健康检查。 健康摘要从公开的会话快照推导计数和方向，不回写任何内容。

已知限制

- 持久化范围 —— 日志支撑的规范存放是可选开启的（enableLogBacking，默认关闭，失败即关闭），其实时读取循环要求构建版本能发出 session/pin 事件（上游 session.setPinned RPC）；在没有该事件的基线上，置顶和颜色回退到插件的 session-pin 设置表单，再回退到浏览器本地的 localStorage。在事件词表不认识该类型的宿主上，预检门控会完全禁用日志追加（失败即关闭的读取路径会拒绝这类日志），因此投影在那里降级为设置缓存。
- 排序范围 —— 置顶位置只在 Manual 排序下稳定；在 Updated 排序下，核心的活动提升会把活跃会话重新排到前面，而 reorderOnLoad 会在加载时重新确立前缀。
- 远程浏览器 —— 设置 RPC 在基线上仅限回环地址；远程浏览器回退到浏览器本地的 localStorage。
- 行徽章回退 —— 上游行槽位不可用时，会话行按标题文本匹配；标题重复时，徽章会显示在每个匹配的行上，并切换第一个匹配项（仅外观问题）。
- 行 DOM 依赖 —— 覆盖层依赖核心行的 role="treeitem" 结构，必须跟随上游 UI 变化。

路线图

- 规范归属：由日志支撑的 session/pin 事件 + pin 投影 + 写入 RPC（上游）——设置命名空间随之退出持久存储的角色，插件改为消费 useProjection('pin')。 已落地（P0）： 插件已提供 session/pin 事件 schema、纯投影折叠（foldPinEvents）、预检门控的追加接缝（PinLogAppender），以及宿主投影读取器（enableLogBacking），后者把实时的 session/pin 事件折叠回实时 Config 缓存。实时的 Config/localStorage 存储仍是兼容与降级路径；启用后以日志为准。
- 自建写入回退：在没有上游 session.setPinned RPC 的构建上，把 PinLogAppender 接上，让它追加 session/pin 事件，这样无上游基线也能按规范记录日志。
- 等 @deepseek-ai/dsh-session-pin 进入 npm 基线后，在客户端消费上游 pin 投影（useProjection('pin')）；目前 master 构建上读路径由宿主镜像兜住。
- 右键 / 行菜单的「Pin」入口（需要核心的行级菜单槽位；行徽章槽位现已在上游）。
- 规范归属就位后，做完整的取色器浮层（自定义颜色）；今天的循环色块只覆盖预设调色板。

Development

pnpm install # install dependencies
pnpm run typecheck # tsc --noEmit
pnpm test # vitest unit tests
pnpm run build # dual-half build + client-bundle purity check
node scripts/verify-live.mjs # live check against a running dsh web (DSH_CHECKOUT env)

Topics

deepseek-harness, dsh, dsh-plugin, session-pin, pin, workspace

Contributors

- @PerryLink — 创建者与维护者：pin UX、持久化、工作区排序、每个 pin 的行颜色、导航组织器，以及五种语言的文档。

PerryLink DSH Plugin Family

本项目是 PerryLink 的 33 个仍在积极维护 的 DeepSeek Harness 插件之一——总名单有 42 个，其中 6 个已冻结、3 个已退役；每一个都在下表中保留自己的行，原因写在 Status 列。如果这个插件帮到了你，其他的多半也能：

| Plugin | One-liner | Status |
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败即关闭 | |
| dsh-autotier | 自动做强/廉价模型分层路由，带确定性风险护栏和 /tier 命令 | |
| dsh-background-agents | 持久化的后台子智能体，带 Web UI 侧边栏、消息收发与中断 | 🚫 RETIRED — 见上方说明 |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排与延迟集中在一个面板。 | 🧊 FROZEN — 见仓库 README |
| dsh-catalog | DSH Desktop Market 标准目录源，服务于 PerryLink 系列 | |
| dsh-cert-mcp | 只读 MCP 服务器，对外暴露认证注册表：评级、快照和五维证据 | |
| dsh-checkpoint-rewind | 对标 Claude Code 的 /rewind：快照、会话分叉、一键恢复 | |
| dsh-claude-move | 把 Claude Code 的会话、记忆、技能和 CLAUDE.md 迁移到 DSH | 🧊 FROZEN — 见仓库 README |
| dsh-click | 跨平台原生桌面控制，面向 DeepSeek Harness——优先支持 Windows。 | |
| dsh-composer-history | 为 Web 输入框提供终端风格的输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查与引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | 面向 DeepSeek Harness 的提示词注入、越狱和密钥泄露防御。 | 🧊 FROZEN — 见仓库 README |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗式评审 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | 🧊 FROZEN — 见仓库 README |
| dsh-fast | 面向 DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 为 DSH 集成 GitHub PR/issue，每次写入都需审批把关 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存交付物 | |
| dsh-laya | 把 Laya 类型化决策（noul/choice/score）作为一等 Cordis 服务和模型可见工具 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 基于语言服务器的 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读的 MCP 运行时面板：/mcp 命令 + 设置页签，展示状态、工具和错误 | |
| dsh-memento | 需审批的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | 🧊 已冻结 —— 见仓库 README |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 对标 Claude Code outputStyles 的运行时风格切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-plugin-certification | 社区认证注册表，提供可复现校验的评级与徽章 | |
| dsh-plugin-doctor | 零依赖的 DSH 插件静态检测 + 沙箱冒烟检测器 | |
| dsh-plugin-guide | 插件开发知识库，以按需加载的智能体技能形式提供 | |
| dsh-plugin-kit | PerryLink DSH 插件共用的零运行时依赖工具包 | |
| dsh-plugin-upgrade | 一包一走廊索引的插件升级技能：把仓库路由到匹配的封闭走廊卡片 | |
| dsh-plugin-upgrade-015 | 合并后的 0.1.3-alpha.1 → 0.1.5-rc.1 升级走廊卡片，外加零依赖接缝扫描器 | 🚫 已退役 —— 走廊由 dsh-plugin-upgrade 承载 |
| dsh-reach | 多通道审批/提问桥接：微信/Telegram/飞书，会话控制台 | 🧊 已冻结 —— 见仓库 README |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与封存版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏固定会话，排序持久保存 | 🚫 已退役 —— 见上方说明 |
| dsh-session-sync | DeepSeek Harness 的跨设备会话同步 —— 为你的会话存储专门做的 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | DeepSeek Harness 的语音优先会话循环：跟它说话，听它回答。 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务看板和时间线 | 🚫 已退役 —— 见上方说明 |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/Dida365 任务桥接：会话头部面板 + 11 个工具 | |
| dsh-translate | 为 DeepSeek Harness 做服务商参数转换和确定性 JSON 修复。 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件都能在内置的 DSH Desktop Market 里浏览：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中它。安装仍然要走 Market 的 npm 身份校验，并由你确认。

许可证

Apache License 2.0 © 2026 dsh-session-pin contributors