dsh-agent-toolkit
DeepSeek Harness plugin: agent registry with layered prompts, parallel delegation, Feishu bots and token usage.
DeepSeek Harness（dsh）插件，把五个 Agent 生产力功能合进一个包：
- Agent 注册表 —— UI 管理的可复用 Agent 名册（persona、模型、工具白名单），支持 YAML 首启导入，内置
main / explorer / general 三个角色。
- 分层提示词 —— 语义化提示词分层 + 按模型匹配的覆盖/追加规则，内置模型层随模型家族（Claude、GPT、Gemini、Kimi……）自动切换。
- 并行委派 ——
team_delegate 工具从名册启动一次性子 Agent，web UI 渲染实时委派卡。
- 飞书 bots —— 项目绑定飞书自建应用，扫码一键创建应用，在飞书里以流式卡片与 Agent 对话。
- Token 用量 —— 按日/按小时计量，13 周活动热力图 + 单日堆叠图 +
/token-usage 命令。由依赖包 @dsh-agent-toolkit/token-usage 提供，可独立安装。
详细使用手册（中文，多文件）见仓库 docs/usage/ 目录。
安装
dsh plugin --profile <profile 名> add dsh-agent-toolkit
--profile 为必填项；profile 是 $DSH_HOME/profiles/<name>（默认 ~/.dsh/profiles/<name>）下的目录，可用 dsh plugin --profile <name> list 查看已有插件。包自带 cordis.patch.yml（bundles 层），装进 profile 后自动激活，无需手工添加 patch 条目。
配置
配置写在 cordis.yml 中，按插件 id dsh-agent-toolkit 覆盖：
- id: dsh-agent-toolkit
config:
timezone: Asia/Shanghai
modules:
feishu: true
usage: true
修改配置触发 HMR 热替换，无需重启。
| 配置项 | 类型 | 默认值 | 说明 |
|---|
modules.feishu | boolean | true | 启用飞书 bots 模块 |
modules.usage | boolean | true | 启用 token 用量模块 |
layers | array | [{ name: 'persona', order: 10, text: '' }] | 语义化提示词分层 {name, order, text}（首启种子/重置默认值；层结构固定，UI 仅可编辑 persona 文本；base/model-notes 保留名不可占用） |
rules | array | 内置 15 条规则 | 按模型匹配的覆盖/追加规则 |
timezone | string | Asia/Shanghai | 用量按日/按小时聚合的时区 |
provider | string | spawn | 委派用的 subagent provider 名 |
toolName | string | team_delegate | 委派工具对模型的可见名 |
feishu.* | — | 见手册 | 卡片节流/字节上限、扫码超时、表情、错误摘要长度 |
layers / rules 为整体替换语义（不是合并）；字段完整说明见 config-reference.md。
功能速览
Agent 注册表
宿主设置面板 → 「Agent 工具箱」→ Agents tab（页内三 tab：Agents / 定时任务 / 分层提示词）创建/编辑/删除角色。页面为卡片流，按创建时间升序，main 置顶只读，编辑/新建内联展开；飞书 Bot 列表也并入各 Agent 卡片。每个角色有 id、名称、描述、persona 提示词、可选模型覆盖、可选工具白名单（团队 preset 工具 + 全局工具，仅白名单语义）。首次激活时把 $DSH_HOME/agent-team/roles/*.yml 一次性导入。
截图待补拍（设置面板收编后界面已变）。
分层提示词
四层模型固定层栈：harness:identity（原生只读）→ 模型层（内置 prompt-stack:base，只读，按模型命中规则整体覆盖）→ persona（prompt-stack:persona，唯一可编辑层，存 prompt_layers 表）→ model-notes（自动层，只读）。层不可增删/改名/改序。规则按 provider / model / modelPattern（glob）匹配当前模型，打分最高者生效：overrides 整体替换指定层（合法目标 = base + 存储层名），append 渲染进 model-notes。模型身份在会话首条消息组装时钉住，中途切模型不改写系统提示词。cordis.yml 的 systemPrompt.persona 恢复原生语义（渲染在 identity 后、模型层前），与 UI persona 层各自独立。
委派
team_delegate(role, description, prompt) 前台启动一次性子 Agent：maxDepth: 1（禁止嵌套委派）、继承父会话取消信号，成员的 persona/模型/工具白名单来自注册表。web UI 渲染委派卡，可一键查看子对话。
飞书 bots
在设置面板 → 「Agent 工具箱」→ Agents 的各 Agent 卡片下方管理该 Agent 名下的 Bot（归属锁定，不可改绑）。两步创建：绑定项目（归属 main 时另配 Provider/模型；归角色则继承角色装配），再绑定飞书应用——扫码一键创建（OAuth 2.0 Device Authorization Grant，密钥只入 credentials 不落表）或手动填 App ID / App Secret。群聊需 @机器人；运维指令 /new、/stop、/status。
截图待补拍（Bot 列表已并入 Agents 卡片）。
Token 用量
侧边栏底栏「Token 用量」：13 周活动热力图 + 单日堆叠图（按模型/按项目/压缩单列）；或在任意会话运行 /token-usage [YYYY-MM-DD]。
Token 用量面板
运行前提
- 宿主 dsh 需提供注入服务：
storageDomain、tools、subagents、systemPrompt、commands、llm、agentDefaultModel、agents、tokenMeter、credentials（webServer 可选，headless/CLI 下 HTTP API 自动不注册）。
- 委派需要具备
persona + depthLimit 能力的 subagent provider（如 spawn）。
- 安装时 npm 会自动带入依赖
@dsh-agent-toolkit/token-usage；两者不要再单独并列安装（计量先到先得，见该包 README）。
- peer dependency：
@deepseek-ai/cordis ^4。
License
MIT
