Overview
dsh-agents
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
1. **只读角色的工具面约束分两层(R3-B1 后)**:机制层——role 轨按构建期推导表 per-session 默认收缩(fail-open:数据损坏/缺表不收缩,收缩生效率读数可见);文字层——任务书只读顾问条款仍保留。两层都**不是环境级隔离**:防的是「误用高级工具」,exec 类工具的外联不受约束;策略文件为同机可写面(信任边界与 advisor 同款,用户知情接受)。 2. **人格文件缺失时退化为摘要模式**:`personas/<id>.md` 不在位时角色仍可用,但行为约束全部来自任务书条款,且任务书里会明确标注。 3. **只创建,不管理**:`wake` / `status` / `list` / `rename` 归 `de_session`。 4. **预设只作用于创建时刻**:会话运行中不可切换 Agent 预设(宿主 `agent-preset-locked`)。 5. **档位是默认值不是强制**:可以越档派活,越档会记入返回并在任务书里留理由位(便于事后审计,不阻拦)。 6. **`agent_spawn` 依赖宿主 `agents` 服务**;`workspaceRegistry` 缺失时不影响创建,只是不挂左侧工作区分组。 7. **档位表随配置变化**:README 里给的是出厂基底,真实生效值以 `agent_roles action=tiers` 的当次回显为准。 8. **上下文隔离是「硬会话层 + 软材料层」**:会话层由 `agent_spawn` 硬保证(每次派活全新会话);材料层靠**机检告警**而非阻断——组织者坚持把作者自评塞进任务书时,工具会点名命中原文但不会拒绝派活。此时该席结论**不应作为独立评审采信**(评审席自身仍须按隔离契约标注污染并只采信可核验证据)。 9. **minimal 预设可得性依赖宿主侧清单(Phase B 实证)**:`minimalPreset` 缺省 `'minimal'`,能否挂载取决于宿主 registry / 磁盘目录中是否真实存在该预设——本机宿主 registry 曾无 `minimal`,首派被 fail-fast 拦截并列出可用清单。宿主官方已将 `~/.dsh/.agent-presets/` 磁盘预设目录标为 legacy("Nothing reads that directory any more"),正解是把自建预设做成 bundle 安装(`dsh plugin add`)经宿主 registry 挂载;**本机评测正解为 `minimal-eval` bundle**(官方 minimal 条件复刻:persona + pwsh + tool-fs + str_replace_editor,无记忆/技能/委派面),属本机评测资产、非跨机分发物。
