前言¶
在 DeepSeek Harness（DSH）里做企业级 AI，常见做法是自己在会话侧拼页面、再单独对接 IAM、Skill、Agent 与计量。一线班组长或部门用户往往缺少统一入口：看板、执行卡、钉钉通知和 Skill 点名调用分散在不同工具里。01men/DeptAI-UI-DSH（npm 包名 @ybkk/gate-01）把「AI 代理与人类的协作前台」做成 cordis 插件，可一键装进 dsh；与上游治理底座 01men/ybkkasi 是不同项目——本项目是调用方，通过既有契约使用底座的资产与权限，交付物集中在部门面板、执行卡与钉钉桥等前台能力。下面介绍它是什么、能做什么，以及如何安装与访问。
这是什么¶
- 仓库与插件标识：GitHub 01men/DeptAI-UI-DSH，社区目录页 SkillHub · DeptAI-UI-DSH。
- 维护者：01men；分类为工作流；仓库当前 GitHub 星标为 1。
- 一句话定位：「01门」——行业 AI 工作台（IAW）与一线面板/看板，基于 DSH「一切皆插件」架构；范围包括
plugin-panel-core（部门 Agent 工作台面板）、plugin-rq-card（会话内执行卡）、plugin-dingtalk-bridge（钉钉桥）、14 行业图谱包（packages/platform-core/scenegraphs/）与行业主题引擎。 - 与底座的关系：不重复实现治理底座；连接底座后，全量数据经本机代理接入（浏览器零跨域），登录在底座侧完成。未连接底座时，仍可打开内置演示看板做预览。
核心功能¶
行业 AI 工作台（IAW）¶
资料记载 IAW v1.0 已落地：五空间信息架构、14 行业图谱包与 14 行业主题引擎；未激活行业为只读演示预览。钉钉设备流登录由面板代发起，未登录或未绑定时会自动弹出激活指令（演示环境 README 中另有 mock 连接器说明，生产基线需按部署文档配置）。
面板、执行卡与钉钉桥¶
- plugin-panel-core：部门侧 Agent 工作台面板，适合班组长/一线看板场景。
- plugin-rq-card：会话内四态执行卡，并作为 dsh.client 双面插件导出（包导出路径
./client）。 - plugin-dingtalk-bridge：群桥、审批推送与告警通道。
宿主挂载形态（dsh 单入口）¶
plugin-dsh-bridge 将元冰可数据面（REST、控制台 SPA、docs、MCP）以 /rq 前缀挂进 dsh 的 webServer；可配合 startHttp: false 关闭平台独立端口，由 dsh web 端口作为唯一入口。配套面板、执行卡与钉钉桥在同一插件树中协作。
面板契约（与 Agent/Skill 协作）¶
M1-1 契约冻结文档中，与面板直接相关的能力包括：J1 面板技能/Agent 点名直调（含诚实降级 200 + ok:false）、J2 统一入口分诊、J3 会话直通、J4 用量报表。前台通过 REST/代理调用底座，而不是在插件内复制 IAM 或 MCP 部署逻辑。
npm 发布与 dsh 兼容性¶
npm 已发布 @ybkk/gate-01@1.2.1（README 现状说明）。package.json 中声明 dsh 兼容区间为 >=0.1.0-rc.7 <0.2.0，profile 为 web；bundle 通过 cordis.patch.yml 注入插件树，client 侧注入 dsh 官方 UI 运行时组件。
安装与启用¶
插件会随 dsh 进程加载，权限与当前 dsh 运行用户一致。安装前建议在 GitHub 阅读源码与 MIT 许可证，确认与现有 dsh 版本匹配。
通过 dsh 插件市场（GitHub）¶
README 给出的官方命令如下：
dsh plugin add github:01men/DeptAI-UI-DSH
通过 npm¶
同一交付物也可经 npm 安装（与上述 GitHub 插件为同一 @ybkk/gate-01 包）：
npm install @ybkk/gate-01
在完整 dsh 运行时中，按项目 cordis.yml / cordis.patch.yml 将插件挂载进 dsh web 即可；具体宿主路径以仓库文档为准。
安装后访问面板¶
装入 dsh 后，打开内置演示看板的路径为（端口以你本机 dsh web 为准）：
http://127.0.0.1:<端口>/gate01/panel/
连接治理底座后，业务数据经本机代理接入；登录流程在底座侧完成。
典型用法¶
1、评估演示数据（独立宿主模式，非 dsh 插件最小路径）¶
若检出源码做平台评估，README 提供演示模式（与「仅装 dsh 插件」是不同形态，但可对照 UI 与契约行为）：
DEMO_SEED=1 npm start
演示账号口令均为 Ybk@2026（如 admin、ops、dev 等，详见 README 表格）。钉钉 mock 扫码可用工号 DD0002。
2、在 dsh 会话中使用执行卡客户端¶
npm 包导出 client 入口，供 dsh 客户端插件引用：
// 引用方式以 package.json exports 为准
import ... from '@ybkk/gate-01/client';
plugin-rq-card 与会话 UI 配合，呈现执行卡四态；点名调用 Skill/Agent 的行为遵循 J1 等契约（失败时诚实降级而非 silent fail）。
3、连接底座后的日常协作¶
- 管理员在底座侧完成 IAM/OIDC 与场景授权（sceneCode，fail-closed 语义见 release notes）。
- 一线用户从
/gate01/panel/进入 IAW，按行业图谱包与主题引擎切换场景（未激活行业为只读预览）。 - 需要群通知或审批时，经
plugin-dingtalk-bridge出站；Skill/Agent 调用走面板代理，避免浏览器跨域直连底座 API。
企业部署与 Agent 一键接入的 runbook 见仓库 docs/deploy-enterprise.md；宿主挂载运维注意项见 docs/host-features-ops-notes.md。
适用场景与注意¶
适合谁
- 已在或计划接入
01men/ybkkasi治理底座、希望用 dsh 统一入口的团队。 - 需要部门看板、班组长工作台、会话内执行卡，以及钉钉作为通知/登录通道的一线场景。
- 需要 14 行业图谱包与主题引擎做行业化演示或逐步激活的团队（定价模式资料记载为「团队 + 领域资产」，制造业可走私有化项目制）。
注意事项
- 插件以当前 dsh 进程权限运行；安装前检查源码、依赖与 MIT 许可证。
- 与
01men/ybkkasi是调用关系，勿将本仓库当作底座备份或替代实现。 - dsh 版本需落在
@ybkk/gate-01声明的兼容区间内（>=0.1.0-rc.7 <0.2.0）；Node 引擎要求>=22.6（独立宿主开发时）。 - SkillHub 目录为社区插件索引，与 DeepSeek / 幻方无官方从属关系；星标与版本以 GitHub / npm 为准。
结尾¶
DeptAI-UI-DSH 把「01门」前台——IAW、部门面板、执行卡与钉钉桥——打包成 DSH cordis 插件，用 dsh plugin add github:01men/DeptAI-UI-DSH 或 @ybkk/gate-01 接入，在 /gate01/panel/ 即可看到看板入口；与治理底座联机后，身份与六类资产仍由底座统一管理，前台专注人机协作与一线交付。
- 目录页：https://www.skillhub.cn/plugins/01men/DeptAI-UI-DSH
- GitHub：https://github.com/01men/DeptAI-UI-DSH
