扩展插件实验室S2P2/dsh-lab

dsh-lab

我的 DeepSeek Harness（DSH）扩展实验室——可复用的插件、Agent 预设，以及配套研究。

⚠️ 早期实验性扩展。 这里的一切都处于活跃且不受约束的实验阶段：API 会破坏性变更，行为会改变，各包与预设之间的质量参差不齐。使用风险自负——在将任何内容安装到持有你凭据的 profile 之前，请先阅读源码；如果你依赖其中任何内容，请固定确切的插件版本。

为什么

Skills 通过文本塑造 agent 行为；插件添加确定性工具、UI 和运行时行为；预设将这些能力组合成用途专用的 agent。当这些层次需要协同演进时，本实验室将它们保持在一起，同时在插件与预设之间保留清晰的产物边界。

包

| 包 | 状态 | 说明 |
|---|---|---|
| packages/dsh-quota-bar | 🌱 v0.1.x · spec #1（已完成） · v0.2 settings #6 | 侧边栏页脚中的 GLM Coding Plan 配额卡片：5 小时/每周/工具窗口 + 重置时间，采用主题原生卡片。宿主侧通过回环路由获取（credentials-service 密钥解析）；解析器已做单元测试。移植自经过验证的 pi-config statusline 逻辑。 |
| packages/dsh-grilling-card | 🌱 v0.1 · spec #2（已实现，dogfooding 中） | 丰富的拷问/访谈问题卡片：推荐答案、一键接受、逐轮进行、前沿计量器、已记录轮次的转录视图。双面（宿主 grill_round 工具 + composer-takeover 卡片）；往返、wire-legality 和 MCP-elicitation 测试。 |
| packages/dsh-ask-card | 🌱 早期 · dogfooding 中 | 为原版 ask_user_question 提供更丰富的转录视图：原版已显示问题和记录的答案，而此插件还显示所有提供的选项、推荐、选择、自定义答案、多选状态和状态上下文。展开的卡片比原版占用更多垂直空间；折叠行为保持与原版类似。 |
| packages/dsh-glossary | 📋 spec #3 | 上下文术语表界面：术语侧边栏、聊天框自动补全、带建议的 avoid-list 标记。 |
| packages/dsh-wayfinder-map | 📋 spec #4 | 带阻塞边的决策票据图（wayfinder 可视化）。 |
| packages/dsh-frontier | 📋 spec #5（被 #4 阻塞） | 确定性的 implement-spec 编排器：票据图、前沿计算、审批门控的破坏性操作。 |
规范状态： #1 已实现并关闭（grilled → prototyped → shipped 2026-08-22）。#2 已实现（grilled → prototyped → built 2026-08-23，dogfooding）。#3–#5 是 2026-08-22 规划会议留下的粗略种子，标记为 needs-triage —— 每个都需要经过一轮 grilling 才能进入 ready-for-agent 状态以供实现。

Presets

自定义 Agent presets 位于 presets/ 下，每个 preset id 对应一个直接子目录。Presets 是受源码控制的组合，而非 npm 包，且不得包含 API 密钥、令牌、密码或其他机密。Host/profile 凭据保留在 preset 之外，并在运行时解析。

第一个脚手架是 presets/writing：一个刻意精简的、专注于写作的 Agent 组合，包含文件/搜索、web、questions 以及 preset 本地 Skills，但不包含 shell、编码工作流或 subagents。

presets/standard-lean 是已发布的 standard preset 的快照副本，移除了 Plan 模式、Workflow 和 Ralph，并以一个紧凑的 complete: true persona 作为整个系统提示词；有关升级漂移的注意事项，请参阅其 README。

安装（包发布后）

dsh plugin --profile web add @s2p2/

然后重启 dsh web。

开发

pnpm install
pnpm build
dogfood: link a package into your web profile
dsh plugin --profile web add ../dsh-lab/packages/dsh-quota-bar

对于 preset 开发，将 DSH Agent preset 根目录指向此 checkout 的 presets/ 目录，或将单个 preset 复制到 $DSH_HOME/.agent-presets/。以 Git checkout 作为唯一事实来源。

注意：pnpm 11+ 通过 minimumReleaseAge（默认 24 小时）对新发布的包进行限制。对于你自己刚发布的包，请在 profile 的 pnpm-workspace.yaml 中设置 minimumReleaseAge: 0（参见 dsh-web-ui#71）。

发布通过 changesets 进行：在更改包的 PR 中运行 pnpm changeset，合并自动维护的 "Version Packages" PR，然后 Release workflow 会提升版本、写入 CHANGELOG 并打标签。当第一个包发布时，npm 发布功能开启（pnpm changeset publish + NPM_TOKEN）。Presets 不属于 Changesets/npm 发布流程的一部分。

布局

packages/   one npm package per reusable plugin
presets//      one filesystem Agent preset per immediate child directory
docs/research/     primary-source research notes feeding the specs
CONTEXT.md         domain glossary for the lab's contexts
shared/            code shared across plugins (planned)
.dsh/              dogfooding: skills + profile bits for working on this repo (planned)