dsh-gitee-chat
把 Gitee 项目管理装进 DSH 会话: 一整页能点的项目工作台 + 一套能写的工具 + 随包的 55 个 Gitee 企业 MCP 工具。
- 面板不占上下文:工作项/合并请求/知识库的数据由面板自己向宿主取,多大的数据量都不进模型;
- 工具只回摘要:
gitee_board给模型的是几十到一千 token 的摘要,卡片直接向宿主路由要全量数据; - 写操作有边界:界面只做最小写集合(状态 / 指派 / 评论 / 新建工作项 / PR 动作),其余交给 MCP。

能做什么
会话头里的「Gitee 项目」是一个整页工作台(渲染在会话正文区,不接管也不顶掉右侧边栏), 六个页签:
| 页签 | 内容 |
|---|---|
| 概览 | 企业级 KPI、风险提醒、最近动态 |
| 项目 | 左侧项目列表 + 仓库卡片 + 工作项表(未完成 / 已完成 / 逾期 / 全部);点行开详情,点仓库卡片下钻三栏(项目 / 仓库 / 仓库资源) |
| 我的工作项 | 负责人 + 协作者两种关系的聚合,带未完成 / 完成 / 逾期筛选 |
| 合并请求 | 待我审核 / 待我测试 / 我提出的 / 全部 + 状态筛选;点行开抽屉 |
| 知识库 | 左侧项目 + 节点树 + 可拖分栏;节点按需展开,附件按需下载,预览优先交给侧边栏 |
| 固定分析 | 9 张卡片:项目健康度 / 成员负载 / 延期清单 / 停滞 / 规范体检 / 进度偏差 / 交付容量 / 里程碑达成 / 交付趋势 |
仓库卡片下钻:项目详情里的仓库卡片点进去是三栏(项目列表 | 仓库列表 | 仓库资源), 左栏可拖宽并记住;默认「本项目」、可切「内源仓库」,口径跨项目保留;仓库详情三个页签(工作项 / 合并请求 / WIKI) 用暖浅色区分。工作项可点开详情,右上角能直接新建(挂在这个仓库下)。
合并请求全流程(抽屉里):概览 · 变更文件 · 评论 · AI 审核 → 审核通过 / 驳回 → 测试通过 →
合并;「+ 新建 PR」支持手动填表(仓库 / 分支 / 标题 / 描述 / 审查人数 / 测试人数 / 草稿 / 套用模板),
走宿主 POST /pr/create,与 MCP 的 create_enterprise_repo_pull 等价。
AI 审核:把审核任务投递到所选主会话下的子智能体(不往主会话插用户消息),面板轮询结论并给出 可一键落地的操作(提交评论并驳回 / 通过)。审核与测试模板分开绑定、面板内可编辑(存为用户副本); PR 描述模板在新建 PR 时一键套用。失败原因按白话映射(not-reviewer / nothing-to-reset / nothing-to-merge)。
工作项:新建(标题 / 负责人 / 优先级 / 计划时间必填,弹窗照 Gitee 网页版)、改状态、改派、评论; 状态用四色药丸区分。写操作后不整页重拉:后台重取数据后原地更新。详情页含描述、 前置依赖(认 Gitee 编号与 WBS 编码两种写法)与评论讨论。
能力档:只有一个 agent 预设「Gitee 项目管理」。档位不是选出来的,而是每次取数按 token 在 Gitee 云端的角色与项目关系推导:企业拥有者/超管/管理员 = 管理者(55 个 MCP 工具,跨项目分析); 某项目负责人 = 负责人档(48);其他 = 执行档(40,只看本人工作项)。换企业 / 换 token 即时改档。
安装
要求:DSH ^0.2.0-rc.2,Node ^22.19 || >=24。
# 从 npm 官方源装(推荐)
dsh plugin --profile desktop add dsh-gitee-chat
| 来源 | 命令 | 什么时候用 |
|---|---|---|
| npm 官方源 | dsh plugin --profile desktop add dsh-gitee-chat |
默认 |
| GitHub Release 附件 | dsh plugin --profile desktop add "https://github.com/huayuguo/dsh-gitee-chat/releases/download/v0.5.5/dsh-gitee-chat-0.5.5.tgz" |
直连 npm 不稳时 |
| git 直装 | dsh plugin --profile desktop add "git+https://github.com/huayuguo/dsh-gitee-chat.git#v0.5.5" |
想跟某个 tag |
本地源码(开发、改代码):
npm install --legacy-peer-deps
npm run build
dsh plugin --profile desktop add "file:$(pwd)"
也可以在应用里「设置 → 插件 → 添加插件」填 file:<本目录绝对路径>。
- profile 要对:装错是静默失效 —— 界面里什么都没有,也不报错。
- 桌面版用应用自带的
dsh(<应用目录>\resources\runtime\cli\bin\dsh.cmd),全局装的那个会拒绝--profile desktop。 - 升级 =
remove再add(装进去的是副本,没有自动更新)。从 0.5.3 升上来时,profile 里可能还留着 旧的预设行(preset-gitee-exec/preset-gitee-manager),记得一并删掉,避免出现两个 Gitee 入口。 - npm 只往官方源(
registry.npmjs.org)发;国内镜像会自动同步,不要往镜像发。 - 装完在 设置 → Gitee 企业项目 填企业版 access token。
- 脚本层面只随发运行期脚本(
scripts/setup.mjs、scripts/check-presets.mjs、scripts/gitee/), 构建与自检脚本留在仓库(npm run check用);npm 包发lib/(含lib/types/),不再发src。 - 让 AI 全程代办:本包自带
skills/dsh-gitee-chat/SKILL.md,说一句「装这个 Gitee 插件,配置项问我」即可。
配置
「设置 → Gitee 企业项目」一页管完,保存即生效,不用重启:
| 项 | 说明 |
|---|---|
| 企业版 Token | 存到 $DSH_HOME/.gitee-chat/token;取数脚本与 MCP 子进程读同一份 |
| 当前企业 | token 可见多个企业时选一个,避免「拿错公司数据」 |
| 会话里的 AI 可以读看板快照 | 默认开:gitee_board_snapshot 返回快照(带时效),不必翻页重拉 |
| 快照落盘 | 默认开:缓存写到 $DSH_HOME/.gitee-chat/cache/,重启后仍可命中 |
| 新鲜期(秒) | 默认 60,最小 10,0 = 关闭缓存 |
| 后台定期刷新 | 默认关;开着时按下面的间隔预取看板,让人打开面板就是热的 |
| 刷新间隔(秒) | 默认 60,最小 10 |
| 闲置暂停(分钟) | 默认 30:这段时间内没人用面板就不刷,避免空转与限流 |
缓存的本地覆盖写在 $DSH_HOME/.gitee-chat/config.json,优先级高于插件补丁里的静态配置。
token 解析顺序:环境变量 GITEE_ENT_MCP_ACCESS_TOKEN / GITEE_ACCESS_TOKEN / GITEE_TOKEN →
$DSH_HOME/.gitee-chat/token → $DSH_HOME/gitee-chat-token → ~/.gitee-token。
桌面版从开始菜单启动时不继承 shell 的 export,所以优先在设置页里填。
工具
| 工具 | 作用 |
|---|---|
gitee_board |
看板摘要(模型看摘要,面板看全量) |
gitee_board_snapshot |
直接读缓存快照,返回 fetchedAt / ageSeconds / stale / ttlSeconds |
gitee_role |
当前 token 的身份、人格与能力档 |
gitee_enterprises |
列出 / 切换当前企业 |
gitee_chat_health |
取数环境自检(token / 企业 / 连通性) |
gitee_ent |
公共 gateway:op:"list" → op:"schema" → op:"call",在非 Gitee 预设会话里可调 55 个企业 MCP 工具 |
Gitee 预设会话里 gitee_ent 刻意隐藏(避免绕过档位门禁),改用原生 mcp__gitee_ent__*(按档裁剪)。
只读部署(allowWrites: false)下写工具会被硬拦;真正的权限边界始终在 Gitee 云端 token 的角色。
随包 MCP
vendor/mcp-gitee-ent/ 随包分发 mcp-gitee-ent 二进制(Linux / Windows amd64,上游基线 v0.2.5,
55 个工具)。安装时自动落地到用户级 bin(Linux/macOS ~/.local/bin,Windows %USERPROFILE%\.local\bin),
不需要 go install;其他平台用 MCP_GITEE_ENT_BIN 指到自己的二进制。MCP 是进程级直连,
没有会话模式门槛:任何会话都能取数,能不能写仍看云端 token。PR 子资源参数统一为
pull_request_iid(0.5.3 及以前是 pull_request_id);fork 侧 4 个自有 PR 工具
(accept / reject / reset / test)同步改名;附件下载遇到 404 会自动兜底。
取数与缓存
- 单次取数是「起一个 Node 脚本 → HTTPS 打 Gitee 企业 API」,单轮 RTT 约 0.4s;
- 读路由带 30s 缓存,执行器结果再记 60s,并做并发单飞(同一请求同时只发一次);写完两层都清,重复点击 <10ms;
- 工作项列表悬停即预取详情,点下去直接命中缓存;
- 看板翻页改并发探测:307 条工作项 2.6s → 1.6s;工作项详情 1.8s → 0.5s(详情与评论并发、无依赖就不拉索引);
- 面板打开时先渲染上次的快照再后台刷新(默认 60s 内算新鲜),会话也能用
gitee_board_snapshot直读同一份; - 慢请求记一条
[gitee-chat][slow]日志,GITEE_CHAT_TRACE=1全量打印。
开发
npm install --legacy-peer-deps
npm run build # lib/*.js + lib/types/(宿主 / agent / 面板)
npm run check # 类型 + 冒烟 + 渲染断言 + 能力矩阵 + preset 交付 + MCP 二进制校验
npm run doctor # 可移植性体检(preset / 插件行 / 产物 / token / 企业)
npm pack # 产出可安装的 tgz(只含 package.json `files` 列出的文件)
src/index.ts 是宿主半(路由、缓存、写出口、设置),src/agent.ts 是 agent 半(工具与人格),
src/client/ 是面板组件(GiteeProjectView.tsx 为整页入口),scripts/gitee/gq.mjs 是取数脚本。
文档
| 文档 | 给谁看 |
|---|---|
USAGE.md |
使用者:界面怎么用、出问题怎么办 |
skills/dsh-gitee-chat/SKILL.md |
AI:安装 / 配置 / 诊断 / MCP 用法(索引层,细节在 references/{mcp,panel,recipes,install}.md) |
设计说明、决策记录、功能清单、能力矩阵属于内部开发资料,不随仓库分发
(node scripts/gen-capabilities.mjs 可重建能力矩阵)。
English: README.en.md
许可证
MIT © 2026 保定多普康智能科技有限公司 · jackxiao (xd20260413@outlook.com)
No comments yet. Be the first to write one.