前言¶
用 DeepSeek Harness 做智能体开发时,TeamAI 的安装、团队仓库初始化、技能同步、MCP 和提示词往往要在终端和多个工具之间切换。仓库 README 说明:本插件提供 DeepSeek Harness 的侧边栏页面,安装后上述操作集中在一个界面完成;页面调用本机 teamai,改仓库时只提交对应文件,不重做 TeamAI,也不嵌入其仪表盘。
下面介绍插件定位、能力、安装步骤和典型用法,事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-teamai-panel 由维护者 backtomyfuture 发布,分类为 客户端 插件(package.json 中 dsh.client.platform 为 web,通过 Cordis 注入侧边栏布局)。一句话定位:DeepSeek Harness sidebar panel for TeamAI skills and usage(目录简介);完整描述为 TeamAI 技能、MCP 与提示词在 DSH 侧边栏中的管理入口。
团队仓库、usage.jsonl 和 ~/.dsh/skills 留在每台机器上,不会随插件安装包迁移。
核心功能¶
页面打开后默认是「开始」,其余分「技能」「MCP」「提示词」。技能仍对应 README 中的三份清单:
- 团队仓库里的技能,以及
pull是否会按目录名下发。 - 当前工作区合并后真正生效的一份,标出目录和优先级;项目副本不会被标成团队副本。
- TeamAI 使用记录里
tool为dsh的次数和最近时间。
开始¶
- 尚未安装 teamai 时显示「安装 TeamAI」。
- 已安装但未绑定仓库时,填写
owner/repo或https://github.com/owner/repo再初始化。 - 已初始化的机器会说明上述两种情况。
若仓库还没有 teamai.yaml,初始化会向默认分支推送空骨架;页面不收集令牌,认证依赖本机已登录的 Git。已有配置时初始化不加 --force,不会静默覆盖。
技能¶
- 展示三份清单,支持安装到本机、按技能推送。
- 安装执行
teamai pull,会安装当前配置应收到的全部技能,并同步规则、文档、环境变量和钩子;没有按单个技能拉取的命令。 - 推送只提交点中的那一份;排除名单只改本机,不进团队仓库。
插件对照的是磁盘上的技能目录(未重做 pull),优先级如下:
| 优先级 | 目录 |
|---|---|
| 100 | <项目>/.dsh/skills |
| 200 | <项目>/.agents/skills |
| 400 | $DSH_HOME/skills,默认 ~/.dsh/skills |
| 500 | ~/.agents/skills |
优先级 300 的自定义目录不读,因为本插件不解析 DSH 的 Config。命名空间会装平;标签和 deliveredInstead 不在此重算。
MCP¶
- 查看团队 MCP,以及新增、替换、删除根
mcp/mcp.yaml里的服务器;保存和删除只提交该文件。 - 命令、参数、请求头、环境变量值和地址写入仓库后,页面不再显示。
- 注入执行
teamai mcp inject,写的是 TeamAI 支持的其他代理;DeepSeek Harness 不加载这些 MCP 服务器。 - 从其他代理移除执行
teamai mcp remove,只清本机工具配置,不改团队仓库。
团队 MCP 与技能、规则、钩子同属一个仓库与同一次发现;README 说明再拆一个插件会重复工作区发现与本机接口。列表仅说明服务器是否存在、传输方式、是否配置了命令或地址、工具名与所需键名。
提示词¶
读取、保存和删除 prompts/ 下的 Markdown;保存和删除只提交对应文件。提示词正文仅在打开那一条时返回。
只读资源¶
同一仓库里的规则、文档、环境变量键名、子代理、钩子、模型、工作流等仍为只读;0 表示仓库尚未放置该项。环境变量只显示键名。模型栏展示的是仓库里的网关配置,不是模型市场,页面也不切换模型。
响应中不包含绝对路径、变量值、密钥、MCP 命令细节等;与 README 中的隐私设计一致。
安装与启用¶
本机需要已安装 dsh,并且已经运行过 teamai init。Desktop 应用使用 desktop profile。先完全退出 DeepSeek Harness,再执行:
dsh plugin --profile desktop add dsh-teamai-panel
浏览器里通过 dsh web 使用时,装到 web profile,将上面命令中的 desktop 换成 web。# 后可跟包含界面版本的提交哈希;去掉则跟踪 main。安装包为手写 JavaScript,无 prepare 构建,因此不需要为该包开启 allowBuilds。
重新打开 DSH 后,侧边栏会出现 「TeamAI资源中心」。
package.json 标明版本 0.3.2,运行时 Node >= 20,许可证 MIT。
典型用法¶
- 在「开始」完成 teamai 安装(若需要)、填写团队
owner/repo并完成初始化与同步。 - 在「技能」查看三份清单,执行
teamai pull等价操作(通过页面触发),按需推送选中的技能变更。 - 在「MCP」维护根
mcp/mcp.yaml,需要给其他代理用时执行teamai mcp inject;仅从本机其他代理清理时用teamai mcp remove。 - 在「提示词」编辑
prompts/下 Markdown 并提交到团队仓库。
开发本插件时,仓库内可执行:
npm install
npm test
侧边栏与客户端契约对照 DeepSeek Harness 提交 ce7073d51254c26cd63b22a60835b8f948deb447(2026-10-29);可行性说明见仓库内 docs/dsh-teamai-plugin-feasibility.md。
适用场景与注意¶
适合谁:已在用 TeamAI 管理团队技能与仓库、并希望把这些操作放进 DSH 侧边栏的开发者,而不是在 Harness 里重做一套 TeamAI 仪表盘。
使用记录可能一直是 0:DSH 默认 DSH_PERMISSION_MODE=workspace-write 时,钩子只能写 dsh 的启动目录。启动目录不是用户主目录时,TeamAI 可能写不下使用记录。从主目录启动 dsh,或设置 DSH_PERMISSION_MODE=danger-full-access,记录才会出现;页面上显示 0 在此情况下不表示「没有使用」。
权限与安全:插件在本机 dsh 进程权限下运行,会调用 teamai 并可能向 Git 远程提交文件。安装前应阅读源码与 MIT 许可证,确认团队仓库与 MCP 配置策略符合组织要求。社区目录 skillhub.cn 为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-teamai-panel 把 TeamAI 的安装初始化、技能清单、MCP 根配置和提示词维护收进 DeepSeek Harness 侧边栏,底层仍依赖本机 teamai 与 Git 认证,改动范围控制在单文件或单目录提交。