DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

huayuguo /

huayuguo/dsh-gitee-chat

Topic repository only

Gitee enterprise project management for DeepSeek Harness: project board, repos & WIKI, knowledge base, and write-back through the bundled Gitee Ent MCP gateway.

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: main@ba5cc1e8

dsh-gitee-chat

中文 · English

把 Gitee 项目管理装进 DSH 会话: 一整页能点的项目工作台 + 一套能写的工具 + 随包的 55 个 Gitee 企业 MCP 工具。

  • 面板不占上下文:工作项/合并请求/知识库的数据由面板自己向宿主取,多大的数据量都不进模型;
  • 工具只回摘要:gitee_board 给模型的是几十到一千 token 的摘要,卡片直接向宿主路由要全量数据;
  • 写操作有边界:界面只做最小写集合(状态 / 指派 / 评论 / 新建工作项 / PR 动作),其余交给 MCP。

Gitee 项目面板:概览页 · 项目进度 · 风险与 PR 待办

能做什么

会话头里的「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)

—/ 5

No ratings yet

Manifest verification required

Commit ba5cc1e8b866

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout