Laurel 功能管理面板 Sakayorilove/dsh-laurel

Laurel 套件 · 给 DeepSeek Harness 的「功能管理」面板 + 四个功能插件

说人话：装上它，Harness 的设置里会多出一个功能管理面板，面板里四行开关，分别控制四个小功能。每个功能都能单独开、单独关，也能单独更新 —— 不喜欢一个，关掉就行，不影响别的。

| 开关 | 它干什么 |
| 通知 | 你在忙别的窗口时，AI 有问题要问你、等你批准、或者干完了，弹一条 Windows 通知并响一声，不用一直盯着 |
| Claude 主题 | 把界面换成暖黄的纸面配色 + 更适合阅读的正文排版。只改外观，不碰你的数据和别的插件 |
| 记忆与上下文 | 让 AI 跨会话记得事：本会话 → 本工作区 → 全局，三级范围；读别的项目需要你逐次授权。数据只存在你自己电脑上 |
| 可视化规划模式 | 把一个大任务画成节点图，拆成能并行的小批次；方案要你采纳并批准才开工，做完有审计报告。体积大，默认关着 |

四个功能出厂全是关的——你想用哪个，自己打开。

装它（三步，照着做就行）

先说一句前提：这套东西是「一个面板 + 四个插件」。在 Harness 看来是五个包，所以要一次把五个都装上；只装面板那一个，面板里那四行会解析不到，点了没反应。

第 1 步：拿到代码

git clone https://github.com/Sakayorilove/dsh-laurel

（不想用命令行：在仓库页面点绿色的 Code → Download ZIP，解压到一个长期不动的目录。）

第 2 步：把五个包装进你的 Harness（Windows 侧，不是 WSL 里）

打开 PowerShell，进到刚下载的文件夹，跑：

node scripts/install-profile.mjs

它会自己找到你的 Harness profile，写好五个依赖、跑一次安装、再校验一遍； 中途出错会整体回滚，不会把你的环境弄坏。找不到 profile 时，它会告诉你怎么把路径填进去。

第 3 步：完全退出 Harness，再打开

注意是完全退出（右下角托盘也退掉），不是关窗口。然后进 设置 → 功能管理，把想要的功能打开。

开了之后：界面上能立刻看到的（主题、面板本身）刷新一下页面就生效；需要重启才生效的（通知、记忆这类后台逻辑）会在提示里说明。

装完发现不对？

| 现象 | 多半是因为 |
| 面板里没有四行，或者点了开关没反应 | 只装了面板，没装四个模块 → 重跑第 2 步的安装命令 |
| 打开了但界面没变化 | 没有完全退出重开；或只刷新了页面但改的是后台半边 |
| 四个功能显示「已关闭」 | 这是出厂默认，自己在面板里打开就行 |
| 主题没生效 | 它有两道开关：功能管理里打开，「设置 → Claude 羊皮纸」里也要勾上 |
| 想让 Harness 回到装之前的样子 | node scripts/install-profile.mjs --rollback 回滚；--uninstall 移除五个依赖 |

支持范围：这套在 DeepSeek Harness 桌面版 0.2.0-rc.2（Windows + WSL2）上验证过。
更早或更新的版本没测过 —— 宿主升级后如果界面细节回退，通常是客户端类名变了，来提 Issue 就行。

给 AI 助手看的精确指令

你要让 AI 帮你装，把下面整段原样发给它。这一节是机器可读版本，保留了全部路径与参数。

任务：在 Windows 上把 Laurel 套件装进 DeepSeek Harness。

前提（必须遵守）：
- 本套件在宿主看来是五个直接依赖：laurel-center（装载机/面板） + laurel + dsh-claude-parchment
+ dsh-strata + dsh-loom（四个模块）。只装 laurel-center 会导致它插入的其余四行解析不到。
- 改的是 Windows 的 profile，所以 pnpm 必须在 Windows 侧跑；不要在 WSL 里对 Windows profile 跑 pnpm（会写出 Windows 解析不了的链接）。

步骤：
1. 克隆仓库并进入目录：
git clone https://github.com/Sakayorilove/dsh-laurel
cd <仓库目录>
2. 跑安装事务（它会写五个依赖 → pnpm install → 校验，失败整体回滚）：
node scripts/install-profile.mjs
也可以显式指定：
node scripts/install-profile.mjs "C:\Users\<用户名>\.dsh\profiles\desktop" --center <仓库绝对路径>
只校验不改动： --check 回滚： --rollback 卸载： --uninstall
3. 校验装配（只读）：
node scripts/verify-installed.mjs
期望：五个依赖的 realpath 分别落在 <仓库> 与 <仓库>/packages/<模块>，patch 五行、模块默认 disabled。
4. 告诉用户：完全退出 Harness 再打开，然后进「设置 → 功能管理」打开需要的功能。
客户端半边刷新页面即生效；宿主半边（通知/记忆等）需要完全重启。

等价的手工做法（profile 的 package.json，五个都要有）：
"dependencies": {
"laurel-center": "link:<仓库绝对路径>", "laurel": "link:<仓库绝对路径>/packages/laurel", "dsh-claude-parchment": "link:<仓库绝对路径>/packages/dsh-claude-parchment", "dsh-strata": "link:<仓库绝对路径>/packages/dsh-strata", "dsh-loom": "link:<仓库绝对路径>/packages/dsh-loom" } 并确保 "dsh.profile.bundles" 里有 "laurel-center"，且没有把四个模块另写成 bundle 行。

只读自检（不需要装任何依赖，克隆下来就能跑）：
node scripts/check.mjs # 期望:通过 213 项,失败 0 项
node scripts/integration-probe.mjs # 期望:通过 29 项
node scripts/bootgraph-probe.mjs # 期望:通过 33 项
node scripts/module.mjs check # 期望:0 问题

相关环境变量(可选):
DSH_LOOM_WSL_USER 指定 WSL 用户(默认用该发行版的默认用户) DSH_LOOM_WSL_WORKTREE_BASE 指定 Loom 工作树的 WSL 侧基础目录 LAUREL_CENTER_INSTALL 指定安装面目录(默认从 profile 推导)

不要做的事:
- 不要手改安装面里的文件(它由 node scripts/release.mjs 从源码生成)
- 不要手改构建产物 lib/client.js(改源码后跑 node scripts/build-client.mjs)

常见配置

- 通知提示音：「设置 → 通知」里可以填一个 wav 文件的绝对路径； Windows 自带的在 C:\Windows\Media\ 下,例如 C:/Windows/Media/Windows Notify Calendar.wav。
- 记忆数据：存在 $DSH_HOME/strata/memories.jsonl,是追加式的——遗忘会追加一条事件,不删旧行,方便你以后核对。
- Loom 的工作树：默认放在插件自己的数据目录;想放到 WSL 里(更快)就设 DSH_LOOM_WSL_WORKTREE_BASE,例如 /home/<你的 WSL 用户>/projects/.dsh-loom。

给开发者

node scripts/check.mjs # 装载机离线自检(213 项)
node scripts/integration-probe.mjs # patch 组出 loader 树、开关语义
node scripts/bootgraph-probe.mjs # boot graph 行、bundle id、inject 值域
node scripts/module.mjs check # 四个模块的落点是否一致
node scripts/build-client.mjs # 改了客户端源码后重建产物
node scripts/release.mjs --to <目录> # 从源码生成只含运行文件的安装面

上面几条不需要装依赖,克隆下来就能跑;CI 每次 push 与 PR 都跑这几条。
各模块自己的测试需要额外依赖,见 CONTRIBUTING.md。

| 文档 | 内容 |
| MODULES.md | 装载机与模块的关系、单独更新、增删模块、标签约定 |
| CHANGELOG.md | 变化记录 |
| CONTRIBUTING.md | 环境、提交前必跑的检查、硬规矩 |
| SECURITY.md | 安全问题怎么报、各模块接触哪些数据 |
| THIRD-PARTY.md | 第三方接口与参考(不打包任何第三方运行时依赖) |
| docs/PLUGIN-CONTRACT.md | 与 DSH 客户端模块系统的接线契约 |

许可

MIT,见 LICENSE;每个模块的 packages/<目录>/LICENSE 同样保留。