xuc865/dsh-librarian

把一次成功的任务，登记成下一次会主动出现的能力书。
一个复古像素界面，为 DeepSeek Harness Web UI 配备动漫 Plugin 图书管理员。

📚 这是什么

DSH Librarian 是 DeepSeek Harness Web UI 的动态能力沉淀插件。

你照常在 DSH 里完成任务。任务结束后，它会判断其中是否出现了可以在不同输入上复用的稳定能力；值得保存的能力会成为原生 Cordis Plugin，并由二次元图书管理员 Mira / 米拉 登记进插件图书馆。

它不是另一个工作流画布，也不会把 50 次任务变成 50 个全局插件。新插件默认属于当前会话；只有同一稳定能力在另一个隔离会话里再次被独立需要，才允许提升为用户级馆藏。

🧭 四个关键词：长期、动态、跨会话、陪伴

- 长期：有版本、有来路，能审批、启停、回退和删除。
- 动态：随证据 split / merge / replace / compose。
- 跨会话：会话级起步，独立复用后再提升到用户级。
- 陪伴：Mira 解释加载了什么、为什么选它、现在什么状态；Host 继续负责权限。

flowchart LR
A[任务完成] --> B[会话书架]
B --> C{另一个会话再次需要?}
C -->|否| B
C -->|是 · Host 校验| D[用户级馆藏]
D -. 元数据可见 .-> E[新会话]
E -->|picker 选中后| F[审批与运行]

真实运行界面：完整像素化的 DSH Web 外壳、Plugin 票根馆藏，以及右侧动态二次元 Mira 全身立绘。

🖥️ 整套 DSH Web 都是像素风

这不是只覆盖 Plugin 页面的独立皮肤。Client 启动后会给 DSH Web 宿主安装全局像素主题；即使关闭 Librarian 浮层，下面这些区域仍保持同一套黑墨、旧纸米色和珊瑚红视觉：

- 左侧品牌区、工作区、搜索与会话树；
- 顶部标题、对话 / 轨迹标签与 Session Log；
- 用户消息、Agent 回复、Think、Tool Call 和代码块；
- 底部输入框、模型选择器、权限选项与发送按钮；
- 对话区会显示运行中 / 待批准 Plugin 的像素状态小票，悬停可查看已加载名称；
- Settings、弹窗、焦点态与像素滚动条；
- 窄屏布局会缩短硬阴影并保留宿主原有的响应式结构。

主题只改变视觉层，不接管 DSH 的布局尺寸、交互语义或可访问性；Librarian 浮层仍是独立 Portal，因此米拉、馆藏票根和宿主界面可以分别迭代。

🎟️ 像素图书馆

界面采用黑墨、旧书米色与珊瑚红的像素票根风格：

- 每个 Plugin 是一张带孔票根 / 一本能力书；
- 右侧是二次元图书管理员 Mira 的动态全身立绘，保留人物轮廓、表情与服装细节，不使用方块人替身；
- 项目内置 4×2 八帧动画图，循环播放待机、眨眼和翻书，当前完整循环约 4.2 秒；
- 点击馆藏，米拉会说明能力用途、状态、作用域和 lineage；
- 通用 · 按需加载 与 本会话 · 按需加载 明确区分两层冷库；
- 运行态 Plugin 可检查源码、批准、拒绝、启停或两步删除；
- 工作流档案室、表单、模板和导入导出也统一采用像素视觉语言；
- 窄屏自动收起管理员区域，保留完整馆藏操作。

🗄️ 两层馆藏

┌─────────────────────────────────────────────────────────┐
│                    USER ARCHIVE                         │
│  ~/.dsh/plugin-sedimentation/user-plugins.json          │
│  每个新会话可见 · 元数据冷加载 · picker 选中后才执行     │
└──────────────────────────┬──────────────────────────────┘
│ independently needed again
│ confidence ≥ 0.8
▼
┌─────────────────────────────────────────────────────────┐
│                   SESSION SHELF                         │
│  /.dsh/plugin-sedimentation/plugins.json     │
│  新 Plugin 的默认归宿 · 只属于当前隔离会话               │
└─────────────────────────────────────────────────────────┘

Promotion 由 Host 调用的一次性 picker 子 Agent 提议，并经过以下校验：

1. 来源 lineage 必须在 Host allowlist 中；
2. 证据必须来自不同会话；
3. reason 非空，confidence 至少为 0.8；
4. 同 lineage 但不同语义会生成 derived lineage，不覆盖旧能力；
5. 每次最多选择三个 Plugin，主 Agent 永远看不到完整源码目录。

❄️ 冷加载，而不是“看见就运行”

图书馆展示的是安全的元数据票根。DSH 启动时不会把 Plugin 源码塞进主 Agent prompt，也不会定义、激活或执行全部 Plugin。

flowchart LR
U[User turn] --> P[Host picker child Agent]
S[Session metadata] --> P
G[User metadata] --> P
P -->|0..3 selected lineage IDs| V[Host validation]
V -->|valid| L[Define / reuse / share]
V -->|no match| N[Keep catalog cold]
L --> R[Rebuild current turn tools]

当用户级 Plugin 已在另一个 Agent 中运行时，后续会话会共享同一个活动实例，记录：

{ "status": "running", "reused": true, "shared": true }

这样可以避免重复注册全局 Tool 和 host-half-failed。

🧾 Pending 的四个动作

| 动作 | 含义 |
| --- | --- |
| Inspect | 通过同源只读 no-store 接口查看不可变 Package 元数据、Host/Client 源码和权限提示 |
| Approve | 只批准并激活当前 pending Package |
| Reject | 拒绝当前审批请求，但保留 Plugin 定义、Package 历史和上一稳定版本 |
| Delete | 两步确认后永久 undefine Plugin |

🛠️ 安装

要求本机已经安装 DSH，并存在 web profile。

git clone https://github.com/xuc865/dsh-librarian.git
cd dsh-librarian
dsh plugin --profile web add .
dsh web

升级本地开发版本时，重新执行 add 并重启 Web：

dsh plugin --profile web remove @local/dsh-librarian
dsh plugin --profile web add .
dsh web --no-open

🧪 验证

npm test
node --check lib/index.js
node --check lib/client.js
npm pack --dry-run --json

当前回归覆盖：

- Plugin CRUD 与 library review 调度；
- Recipe 本地输入不会泄漏到 refinement prompt；
- Inspect / Approve / Reject / Delete 的独立语义；
- 冷目录、picker 输出验证、跨会话 promotion；
- 跨 Agent 活动实例共享；
- 同 lineage 不同语义的 derived-lineage 保护。

🧭 项目结构

dsh-librarian/
├── assets/                       # README 像素素材
├── docs/                         # 实际 Web UI 截图
├── lib/
│   ├── index.js                  # Host：沉淀、目录、promotion、加载策略
│   └── client.js                 # Client：全局 DSH 像素主题、图书馆、米拉与审批
├── scripts/
│   ├── run-batch-experiment.mjs  # 10 会话 × 5 连续追问
│   └── run-scope-regression.mjs  # shared / derived-lineage 真实回归
├── test/index.test.js
├── cordis.patch.yml
└── package.json

🧠 设计原则

- Private first — 新能力先进入本会话书架。
- Evidence before promotion — 跨会话真实复用后才进入通用馆藏。
- Metadata before source — 可发现不等于已执行。
- One stable capability per book — 一本能力书只负责一件稳定的事。
- Mira explains, Host decides — UI 负责可理解，Host 负责安全边界。
- Reversible by default — 替换先 staged，验证后才退休旧版本。

相关探索

dsh-evolve 侧重从执行轨迹中提炼 Experience，并在 Agent 卡住时提醒换一种策略；Librarian 管理的是可加载、可审批、可跨会话提升的原生 Cordis Plugin。一个整理“这条路怎么走”，一个整理“这个工具以后怎么用”，两条路线可以并行。

License

MIT