@khorsheed/dsh-datasets-tool

@khorsheed/dsh-datasets 的伴生工具行：模型可见的 8 个 datasets_* 工具与 datasets:tools 提示词段，按会话授予——只出现在引用了它的 agent preset 组合的会话里。/datasets slash 的注册自 preset 可见性收口（A3）起也归本行（落进 preset scope 层，handler 与定义留在 core）；服务（ctx.datasets）、CLI 与题集 tab 留在 core；这一行只进 preset，不进 profile 根。单实例多模式（提案 2026-08-26）工具行解耦的第三对（M4'③）。

形态：不自挂载的伴生包

只注册工具，不发布服务（ctx.provide 为零）——preset 挂载面的 isolate-realm 规则只拒服务行，工具行可裸放 preset（官方 tool-bash 行同构）。
不声明 dsh.bundle：作为依赖安装只让模块可解析（plain dependency，同 @khorsheed/dsh-local-agent-dsh-headless 先例），不会自动挂到任何组合。授予入口是 preset 的 agent.cordis.yml 按名引用：
```
- id: datasets-tool
  name: '@khorsheed/dsh-datasets-tool'
  config:
    tools: authoring     # 可选；缺省 all
```
运行依赖 core 的全局服务：core 服务声明为 inject = ['datasets']（同族 companion 例外，见 scripts/check-plugin-independence.ts 的 COMMUNITY_SERVICE_INJECTORS）——preset 的 standing scope 在注册表激活时挂载，早于 profile 靠后 bundle 行提供 core，apply 时一次性 ctx.get 探测看到 ABSENT 后没有任何东西会重跑该行（rc.1 挂载序；2026-09-27 3080 生产实证），声明式 inject 让该行 pending 到 core 提供再 apply。core（@khorsheed/dsh-datasets）未挂载时该行保持 pending（注册表审计显示 waiting for datasets；不炸 preset 挂载，该 preset 组合照常挂上、不报错，只是模型看不到这些工具），core 出现后行激活、工具与提示词段注册生效；行内 ctx.get('datasets') 守卫保留为防御性直调路径。工具注册走 ctx.inject(['tools']) 延迟注入（挂载序竞态的历史教训），无 tools 注册表的组合同样安全。
工具定义工厂由 core 的 ./tool 子路径导出（@khorsheed/dsh-datasets/tool 的 datasetToolDefinitions(service, options)），业务实现零复制；origin tag 的 owner 是本包（挂在哪个包名下就归因到哪个包）。

配置（可选）：tools 决定这一行授予哪一组工具。分组是从 core 搬来的：core 不再注册任何模型工具，也不再贡献提示词段。

`tools`	注册的工具
`read`	六个读类动词：`datasets_list` / `datasets_show` / `datasets_describe` / `datasets_read` / `datasets_snapshot` / `datasets_validate`
`authoring`	read + `datasets_put_item`（起草进工作树；`git commit` 仍是人的）
`all`（缺省）	authoring + `datasets_worktree_path`（整层物化，写只读物化缓存）
`none`	无——连 `datasets:tools` 提示词段也不贡献

提示词段（T73）告诉模型：题集只按登记引用 / 取，先调 datasets_list；从不传路径；名字对不上唯一题集就用 ask_user_question 让人选；没登记的仓库请人去题集 tab 登记，不自己去读。它不再提 /datasets bind（已退役）。

四档是一条包含链；评测域建议 authoring：规划期 agent 要读题、要出题，整层物化是编排器的动作。

安装

# core 仍按原样全局安装（服务 / CLI / slash / 题集 tab 都在 core）
dsh plugin --profile web add @khorsheed/dsh-datasets
# 伴生包只需装到 profile 的 node_modules（可解析即可，不会自挂载）
dsh plugin --profile web add @khorsheed/dsh-datasets-tool
# 然后在目标 preset 的 agent.cordis.yml 加上面那行

dev 场景包的开发模式 preset（profiles/dev/presets/dev）已带此行（缺省 all）；评测包的 eval 预设（profiles/web-eval）以 tools: authoring 引用它——同一 profile 里其它预设的会话一个都拿不到。

Compatibility

npm 发布线（@deepseek-ai/dsh@0.1.5-rc.1）：✅ 完整——工具注册进宿主 tools 注册表并贡献提示词段；0.1.5 官方插件列表的「会话插件」组按 preset 组合呈现本行（短名标题、状态徽标、活挂载相位点）。core 缺席时组合照常挂载，该行保持 pending（注册表审计显示 waiting for datasets），core 出现后行激活并注册工具。
源码线（deepseek-harness master）：✅（verifiedHost: 0.1.5-rc.1）。
低于 0.1.5 的宿主：preset 组合与工具行机制在更早的线上已存在，但「会话插件」清单视图是 0.1.5 的呈现——与 typesafe-tool 等伴生行同一档，minHost 钉 0.1.5-rc.1。
发布顺序：引用伴生行的 pack 必须先有伴生包被发布 / 安装；行解析失败会让该 preset 组合报 broken（实例 boot 不受影响），不是静默降级。

版本线对照：0.1.0 起支持宿主 0.1.5-rc.1 及以后。

@khorsheed/dsh-datasets-tool

설치

문서