前言¶
DSH 生态强调“一切皆插件”。当 DeepSeek Harness Web 主窗口需要加入工作角色页签、对话区像素办公室浮层，但不想改 dsh 源码时，可以用 dsh-ui-agents-pixe。它由 EternalNight996 维护，许可证为 MIT。
下面介绍这个插件的核心功能、安装方式，以及可复现的典型用法。
这是什么¶
dsh-ui-agents-pixe 是一个面向 DSH Web 主窗口的持久客户端插件。它把「工作角色」页签和「像素办公室」浮层加到主窗口中：内置 508 张完整角色卡（The Agency en 255 + agency-agents-zh zh 253），让 agent 可按角色名取回完整角色卡，也可以进行团队编排。
package.json 声明 engines 要求 node >=22，许可证为 MIT。
核心功能¶
工作角色页签¶
- 内置 508 张完整角色卡：
The Agency en 255+agency-agents-zh zh 253 - 支持搜索、中英切换、分部分类选人
像素办公室浮层¶
- 使用
Canvas 2D程序化像素小人，可站立、打字、踱步 - 浮层可拖动、折叠、缩放
- 选人即入列
- 左键点击任一像素人可查看完整角色卡
agents_pixe_roles 工具¶
agents_pixe_roles 由宿主半边注册，agent 可按角色名取回完整角色卡。
默认情况下，agents_pixe_roles / agents_pixe_team 工具与提示段不注册；关闭角色工具和 AI 闲聊时为纯本地零 token 消耗。
agents_pixe_team 团队编排¶
agents_pixe_team 用于团队编排：领袖拆解任务，成员开独立子代理并行执行，最后由领袖汇总。
成员上限默认 4、最大 6。
AI 聊天¶
像素办公室的台词可接入 AI，支持内置 AI 或外部接口。
开启后可生成 20 字内中文闲聊；失败或返回空时回退。AI 开启后受预算限制：每小时最多 60 次真实调用、估算 token 上限 60K，超出回退罐头台词。
设置与 token 控制¶
在「设置 → 像素办公室」分区中，可管控：
- 角色工具
- AI 聊天开关
- 台词频率
- 思考模式
- 取卡粒度：完整卡 / 仅规则 / 仅交付物
该插件还包含 token 实时显示与预算控制，用于显示会话用量并限制 AI 调用。
安装与启用¶
先运行安装命令：
dsh plugin --profile web add dsh-ui-agents-pixe
再重启 dsh web 使首次安装生效。
README 明确提醒：统一使用 dsh plugin 命令，不要使用 npx @deepseek-ai/dsh 安装。
经过上面的步骤，聊天页出现「工作角色」页签，对话区出现可折叠的像素办公室浮层。它声明为持久客户端插件，使用 npm 双面包和 cordis 组合补丁层（dsh.bundle.patch），自挂载，安装即生效，重启不丢。
如需安装可视化插件市场，可运行：
dsh plugin --profile web add dshmarket
典型用法¶
开启角色工具或 AI 闲聊¶
在「设置 → 像素办公室」中开启角色工具或 AI 闲聊，并选择取卡粒度：
- 完整卡
- 仅规则
- 仅交付物
查看完整角色卡¶
左键点击任一像素人，即可打开完整角色卡。
接入外部 AI 聊天¶
在页面中赋值一个异步函数，即可接管台词：
window.__AGENTS_PIXE_CHAT__ = async (req) => '你好，人类'
编程式控制 AI 聊天¶
window.__AGENTS_PIXE_CHAT_API__.setEnabled(true)
window.__AGENTS_PIXE_CHAT_API__.setProvider(async (req) => '…')
window.__AGENTS_PIXE_CHAT_API__.isOn()
使用团队编排¶
使用 agents_pixe_team 时，由领袖拆解任务，成员开独立子代理并行执行，最后由领袖汇总。成员上限默认 4、最大 6。
适用场景与注意¶
适合以下用法：
- 需要在 DSH Web 主窗口浏览、搜索和选择内置角色卡
- 需要把已选角色以像素办公室形式展示
- 需要
agent按角色名取回完整角色卡 - 需要默认零 token、按需开启角色工具、AI 闲聊或团队编排
注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证 - README 中关于智子内核的说法存在冲突：一处称
v1.0.9新增system prompt注入，另一处称本插件不自带智子内核、不注入system prompt。本文不把内核注入作为确定功能 - 手动保存的自定义团队保存在本机
localStorage - AI 生成的自定义角色保存在
~/.dsh/agents-pixe/custom-roles.json
链接¶
GitHub：https://github.com/EternalNight996/dsh-ui-agents-pixe
