Repository navigation
Releases
Releases · l246804/dsh-pstack
v0.5.0
概要
本次发布对齐 DSH 0.2.2-rc.2,内置 pstack 升级到 0.15.43。主要变化是工具面从 7 个收缩到 4 个、角色文件升到 version 2 结构化路由,以及会话级 Poteto 工作流开关取代根预设。升级本插件前,请先把 DSH 升到 >=0.2.2-rc.2。
新增能力
- Poteto 工作流开关:不用再先选预设,按会话开启,可以和任意能承载它的预设搭配;固定提示、没有技能工具的预设(如 Minimal)不启用,也不能手动打开。开启后每轮把 poteto-mode 规则保留在系统提示里。
- 用法:在模型与推理等级菜单切换当前会话的开关。快捷键在 设置 → 通用设置 → 快捷键 里绑。新会话默认在 Pstack 配置弹窗的「通用」页设置。
- Agent Teams 开关:新增会话级「启用智能体团队协作」开关,以及全局默认「新会话默认开启智能体团队协作」。打开后 pstack_subagent 启动团队成员,可以在团队任务板上跟踪共享工作。
- 用法:在模型与推理等级菜单切换当前会话的开关。新会话默认在 Pstack 配置弹窗的「通用」页设置。委派时给 pstack_subagent 传 name,便于用 list_agents 定位。
行为变更
- 兼容表改为按 DSH 范围分组:之前一张表记录当前 pstack 基线,现在每个 DSH 范围一张小表,根 README 只留最新三个范围,更早的移到 docs/compatibility-history.md 及其中文副本。
- 原因:单表看不出插件版本和 pstack 的对应,手写兼容键又和现有元数据重复。见 docs/decisions/2026-11-17-compatibility-table-grouping.md。
- 放弃未保存草稿改用统一的风险确认弹窗:之前用浏览器原生 confirm,现在用 DSH RiskConfirmation,需要显式勾选确认后才能继续。
破坏性变更与迁移
- 工具面从 7 个收缩到 4 个:移除 pstack_skill、pstack_agents、pstack_send,改由原生 list_agents、send_message 和直接读文件完成同样的事,pstack_subagent 与 pstack_interrupt 的参数名也有调整。这些接口由 agent 在真实调用时按新定义自动适配,不需要用户手动迁移。
- 原因:pstack_skill 被模型忽略,只增加工具面。DSH 0.2.2-rc.2 用原生 list_agents、send_message 统一了 Standard 与 Team,内置预设又禁用了原生 interrupt_agent。
- 移除根预设 poteto-mode 与 poteto-mode-creator:之前会话创建时选这两个根预设启用 Poteto,现在只能用会话级开关,插件随包只提供子代理预设(poteto-agent、comment-sicko、readonly)。
- 迁移:不再选择根预设,改为在模型与推理等级菜单打开 Poteto 工作流开关,或在 Pstack 配置弹窗的「通用」页设为新会话默认。
- 原因:根预设要按各自基础模式的工具集单独拼装,DSH 版本变动时容易对不齐,而这种变动又不影响其他适配工具。参照上游 Cursor 的 Custom Mode 后,改为工作流开关,可与任意预设搭配,包括 PTC 预设。
- 角色文件升到 version 2:之前角色用 provider/model [effort] 字符串数组,现在改为结构化路由对象并升到 version 2。读取时自动迁移,.mdc 转成 JSON 并删除旧文件,version 1 字符串路由原地重写为 version 2。
- 迁移:自动完成,无需手动操作。
- 原因:provider 也可能含 /,按第一个 / 拆分字符串会有歧义。见 docs/decisions/2026-11-16-structured-role-routes.md。
- 角色清单从 17 个减到 9 个,预算从 4 档减到 3 档:上游 pstack 0.15.43 退役 8 个角色、去掉 unlimited 档并把上限降到 xhigh,角色变为 9 个、预算变为 3 档(large、medium、small)。
- 迁移:读取角色文件时自动丢弃退役角色,并把 unlimited 迁移为 large。要重新配置可重跑 /setup-pstack。
修复
- 推荐插件表:之前推荐插件页列出 dsh-browser-use 与 dsh-mcp-client,两者在 DSH 0.2.2-rc.2 不可切换、始终显示未安装,现在移除,可选插件表同步更新。
- docs-drift 检查拆分:之前把冗余、文档耦合、无依据扩写合成一项、报告模板只写五类,模型读到合并标签就跳过其余;现在拆成具名检查,报告列全八类,语言漂移也从术语里分出。
- decision-audit 报告改版:之前每个发现重复四行文本、类名是字母,难以扫读;现在以处置表开头、发现用表格列出、类名写成文字,Legacy 和未验证项单独成表。
兼容基线
- DSH 范围:>=0.2.2-rc.1 → >=0.2.2-rc.2(先升级 DSH,再升级本插件)
- pstack 版本:0.15.36 → 0.15.43
其他(内部)
- 发布说明改由 agent 会话生成,并作为发布前置条件(changes/RELEASE.md),旧的产物差异生成器移除。见 docs/decisions/2026-11-16-release-notes-authored-by-agent.md。
- 客户端 UI 改用 DSH primitives,Host 改用官方 DSH 服务类型,依赖按官方 catalog 对齐,兼容表改由脚本维护。
- playground 证据与截图刷新,评审记录 redaction 增强,本仓文档与决策记录做了清理。
- poteto 内部模块移到
src/poteto/,顶层只保留真正的入口,避免内部工具被当成公开子路径导出。
v0.4.1
概要
统一三个 pstack 工具的路由字段为 provider / model / reasoningEffort;pstack_roles 报告每条路由的可用档位和是否仍被提供;pstack_models 只在 provider 标题下列模型 id。
行为变更
- 路由字段统一:pstack_models 现在按 provider 标题下列模型 id,pstack_roles 输出 provider、model、reasoningEffort。
- 原因:合并串被调用方当 model 传会拼成 provider/provider/model,被预检拒。
- 影响:取 provider 用标题、model 用行分开传;读 pstack_roles 把 effort 改成 reasoningEffort。
- pstack_roles 报告档位:每条路由现在带 efforts、defaultEffort、served,served:false 表示该路由不再被提供。
- 原因:原来只有单个 effort,临时调档只能猜,猜错吃一次预检失败。
- 影响:派发前从 efforts 里选档;pstack_models 只用于 setup 发现或校验。
- provider 发现失败给出原因:路由失败时带 served:false 和原因,不再当成 stale。
- 影响:路由不可用时能直接看到原因。
v0.4.0
概要
角色配置文件从 .mdc 迁到 typed JSON;pstack_subagent 收缩成只管路由的薄封装,fan-out 改为多次调用;新增 pstack_agents、pstack_send、pstack_interrupt 三个子代理控制工具。含两处破坏性变更,升级前先看迁移。
新增能力
- 子代理控制工具:新增 pstack_agents(列子代理)、pstack_send(续聊)、pstack_interrupt(打断)。
- 原因:Agent Teams 会遮蔽原生 list_agents、send_message、interrupt_agent,pstack 子代理需要有对等工具。
- 用法:用 pstack_agents 拿子代理 id,再用 pstack_send 续聊或 pstack_interrupt 打断。
破坏性变更与迁移
- 角色文件改为 typed JSON:$DSH_HOME/pstack-models.mdc 改成 $DSH_HOME/pstack-models.json,首次读取旧 .mdc 自动迁移为 JSON 并删除旧文件。
- 原因:上游 .mdc 属 Cursor 规则文件,DSH 不支持 rules 下的 .mdc;并入 AGENTS.md 不适用,单开豁免又不值当。
- 迁移:升级前备份 pstack-models.mdc,确认首次启动迁移保留了自定义路由。
- pstack_subagent 收缩为薄封装:只收 provider、model、reasoningEffort,删除 role、roleRoute、roleIndex、autoPanel 和角色文件解析,fan-out 改为一条消息里多次调用。
- 原因:agent 常传错 roleIndex,角色选择被工具固化,未对齐上游 Cursor 与适配 Claude Code 的派发流程。
- 迁移:role:"x" 改成读角色文件或 pstack_roles 拿 provider、model、reasoningEffort 分别传;批量改成多次调用。
其他(内部)
- 发布说明改为产物差异加 changes 注记生成;清理行号字段、预算 warnings 与客户端文案;DSH peer 依赖改为 caret 范围。对使用者无影响。
v0.3.1
🚀 Features
View changes on GitHub
v0.3.0
🚨 Breaking Changes
- Support dsh0.2.2-alpha.3 - by leihaohao (c1870)
- Remove optional render tool and align documentation - by leihaohao (468b7)
- Consolidate role editing and budget planning - by leihaohao (b04ef)
🚀 Features
- Implement the pstack plugin - by leihaohao (2caf5)
- Add optional rendering tool - by leihaohao (4063b)
- Source cursor-team-kit skills from GitHub and generate package exports - by leihaohao (afd00)
- Rewrite the pstack client UI - by leihaohao (814a8)
- Expose authored skills and test presets - by leihaohao (ae634)
- Add poteto-mode root preset - by leihaohao (4dc09)
- Add Creator poteto-mode preset - by leihaohao (7689f)
- Make pstack_subagent the only delegation path - by leihaohao (44560)
- Localize plugin copy and preset labels - by leihaohao (228f8)
- Polish pstack client configuration UI - by leihaohao (6bc94)
- Refine pstack configuration UI - by leihaohao (72dcc)
- Add route clear controls - by leihaohao (3f08b)
- Automate release compatibility metadata - by leihaohao (0ae96)
- Apply reasoning budgets to role routes - by leihaohao (03d2a)
🐞 Bug Fixes
- Reject maxDepth zero in pstack_subagent - by leihaohao (61370)
- Distinguish pstack tool cards - by leihaohao (0fae1)
- Hide component filter on pstack plugin detail - by leihaohao (d4327)
- Restore component filter and refine role reset controls - by leihaohao (223d3)
- Move clear action beside role reset - by leihaohao (a438e)
- Preserve delegation outcomes and validate role writes - by leihaohao (cfed8)
- Preserve client drafts and report plugin outcomes - by leihaohao (a6100)
- Resolve plugin manager when remote arrives - by leihaohao (89b7e)
- Make unconfigured role routes directly editable - by leihaohao (97a85)
- Register Host role Remote endpoints with Typert - by leihaohao (b6aba)
- Update yaml import to use namespace import - by leihaohao (7c21f)
- Collapse duplicate role lines on save - by leihaohao (076e6)
- build:
- Configure browser platform for client pack - by leihaohao (587c2)
- client:
- deps:
- ext-004:
- 默认推荐统一 forge 入口并阻止与独立 worktree 重复挂载 - by leihaohao (5e961)
- subagent:
- Use configured depth cap for nested delegation - by leihaohao (973e2)
- test:
- Make poteto-mode apply test hermetic - by leihaohao (9da18)
View changes on GitHub
v0.2.2
v0.3.0-beta.1
🚨 Breaking Changes
- Support dsh0.2.2-alpha.3 - by leihaohao (c1870)
🐞 Bug Fixes
- deps:
- ext-004:
- 默认推荐统一 forge 入口并阻止与独立 worktree 重复挂载 - by leihaohao (5e961)
View changes on GitHub
v0.2.1
🚀 Features
- playground: 新增能力自动化 runner 与 config.json 模型配置 - by leihaohao (e69b4)
- pstack: 新增只读角色能力查询 pstack_roles - by leihaohao (9c8e7)
🐞 Bug Fixes
- pstack:
View changes on GitHub
v0.2.0
🚀 Features
- Rebuild unit 1 static asset pipeline - by leihaohao (58e9d)
- Ship unit 2 bundle and bundled skill provider - by leihaohao (f42fd)
- Ship unit 3 roles and delegation - by leihaohao (a3f8b)
- Ship unit 4 workflow skills and worktree mount - by leihaohao (67954)
- Ship unit 5 restricted history and fix swarm race routes - by leihaohao (0f5ee)
- Ship unit 6 long-running workflows on goal, reminder, and local watcher - by leihaohao (e4a14)
- Ship unit 7 release review of promise-to-delivery copy - by leihaohao (f4e8c)
- Declare a Host timeout budget on pstack_script - by leihaohao (9ed85)
- Let a route value carry a slash inside its model id - by leihaohao (f0f20)
- Restore per-delegation reasoning effort, and stop calling it forbidden - by leihaohao (4c3ea)
- Add a vendored third-party skill tree with pinned provenance - by leihaohao (7aba7)
- Tell every agent where working files go - by leihaohao (d9aa7)
- Ship archived decision, architecture, and glossary skills - by leihaohao (8db7b)
- 收录 retro 技能并移除 vendored 符号链接 - by leihaohao (478a5)
- 生成树渲染前校验覆盖层哈希 - by leihaohao (e5042)
- 收录 retro 与 writing-for-agents 技能 - by leihaohao (06ccb)
- 完成 pstack DSH 插件、审查与适配文档 - by leihaohao (2d472)
- 完成 pstack port 实现并移植 statechart - by leihaohao (f1ab4)
- 更新图标名称 - by leihaohao (2cdb7)
- 补充插件展示元信息与双语 README - by leihaohao (61855)
- 增加 FIX 重放与归档工具 - by leihaohao (3b951)
- Pstack port #1 implement(角色文件改名 pstack-models.mdc) - by leihaohao in #1 (c1369)
- Add harness documentation consistency checks - by leihaohao (98a39)
- Pstack issue #2 实现(EXT-003 角色模型配置页) - by leihaohao in #2 (c119e)
- 增加上游 DSH 讨论反馈技能 - by leihaohao (d9b79)
- Pstack issue #4 实现(EXT-004 推荐可选插件启用页) - by leihaohao in #4 (705b1)
- Pstack issue #8 实现(EXT-003 推理强度说明) - by leihaohao in #8 (ff473)
- 增加真实插件测试场 playground - by leihaohao (4392f)
- 增加 playground 视觉验证工具与脚本命令决策 - by leihaohao (a8a74)
- Pstack issue #12 实现(EXT-005 bundle 配置模态框) - by leihaohao in #12 (c73a4)
- Pstack issue #14 实现(EXT-003 角色标签与布局补充) - by leihaohao in #14 (ad7a2)
- 完善 bundle 配置入口与推荐插件文案 - by leihaohao (b2a83)
- skills:
🐞 Bug Fixes
- Close pre-release asset and script gaps - by leihaohao (50cfa)
- Track scripts/runtime so a fresh clone can build - by leihaohao (78dfd)
- Refresh pnpm-lock.yaml so a fresh clone installs without diff - by leihaohao (53af1)
- Declare pstack-script's inject so the row can register - by leihaohao (37dd4)
- Let pstack_script's signal be null and require the fields it returns - by leihaohao (8c5ca)
- Let pstack_history's two session ids be null, and validate every variant - by leihaohao (9f2fa)
- Read this row's loader entry in the worktree mount guard - by leihaohao (6dc26)
- Run pstack_script in the session's directory, not the Host's - by leihaohao (d826d)
- Let pstack_history read a child that works inside a worktree - by leihaohao (efbbf)
- Make worktree-audit's --sessions input a shape the model can build - by leihaohao (cfd4e)
- Decide worktree usage from a matching session, not a non-empty list - by leihaohao (d6d27)
- Retarget four prose references at files that actually ship - by leihaohao (28cc3)
- Audit every patched file, and fail on an unreviewed known concept - by leihaohao (7bf3e)
- Drop
minimum, then close four checks that skipped what they claimed - by leihaohao (fe168) - Make
outputIncludesevidence, and pair smoke cases by id - by leihaohao (192b8) - Pin the paging boundary, and stop calling a truncated window "full" - by leihaohao (f2d90)
- Make sessionQuery an optional service so pstack_history always registers - by leihaohao (5d0f9)
- Normalise worktree paths, stop guessing background starts, keep output bytes - by leihaohao (91530)
- Compare invocation flags with upstream, not with our own output - by leihaohao (e0c75)
- Gate pstack_script ids, and drop an allowlist entry that matched nothing - by leihaohao (5d3af)
- Decide a background start from the spawn/error race, not a guess - by leihaohao (e7010)
- Restore the step semantics of effort, and pin upstream differences in a checked ledger - by leihaohao (0a1a0)
- Stop the shipped playbooks pointing at this repository's build scripts - by leihaohao (5aa25)
- Move the vendored skill tree out of the directory the generator replaces - by leihaohao (be942)
- Check the divergence ledger by member, not just by count - by leihaohao (50008)
- Read the prompt registry without injecting it - by leihaohao (75d71)
- Keep the built artifacts independent of where n...
v0.2.0-beta.3
🚀 Features
- Pstack port #1 implement(角色文件改名 pstack-models.mdc) - by leihaohao in #1 (c1369)
- Add harness documentation consistency checks - by leihaohao (98a39)
🐞 Bug Fixes
- Update prepare script to include vp config - by leihaohao (57f24)
- 恢复 harness 文档门禁任务名 check:harness-doc(check 委托运行) - by leihaohao (40cc2)