前言¶
用 DeepSeek Harness（DSH）做需求分析、缺陷排查或任務拆解時，上下文往往還停在本地倉庫或對話裏，Gitee 企業版上的任務、需求與缺陷要另開瀏覽器對照。下面介紹社區插件 dsh-gitee-enterprise（維護者 cnHuaShao，分類：聯網工具）：在 Harness Web UI 中連接 Gitee 企業版，瀏覽與編輯工作項，並在對話裏用 @Gitee[編號] 把工作項詳情展開給模型。插件當前在 GitHub 上星標爲 0；安裝與能力以倉庫 README 爲準。
這是什麼¶
dsh-gitee-enterprise 是 DSH 的 Web 客戶端插件（package 版本 1.6.10，MIT 許可證）。定位是「Gitee Enterprise work-item workbench for DeepSeek Harness」——在側欄或對話框工具區打開「Gitee 工作臺」，管理企業項目中的任務、需求與缺陷；服務端接口前綴爲 /gitee-enterprise。
與只在 Gitee 網頁裏操作相比，它把列表、詳情、評論（視令牌類型）和對話引用接到同一條 Harness 會話裏，減少來回切換。
兩種令牌與能力邊界¶
連接時二選一（不可混用普通私人令牌與個人版 MCP 令牌當企業 MCP 用）：
| 能力 | 私人令牌（v5 API） | 企業 MCP 令牌（v8 API） |
|---|---|---|
| 瀏覽項目 / 工作項 | 支持（由可見工作項歸納項目） | 支持（完整項目列表） |
| 查看 / 更新 | 支持 | 支持 |
| 新建 / 刪除 | 不支持 | 支持 |
| 評論 | 視企業 v5 評論接口是否開放 | 支持讀寫 |
私人令牌已足夠分頁瀏覽、父子層級和多數更新場景；需要新建、刪除或完整 v8 排序與評論時，應在連接設置中改用企業 MCP 令牌。令牌保存在 %DSH_PROFILE_DIR%\gitee-enterprise\state.json（POSIX 權限 0600），不會返回給瀏覽器。
核心功能¶
工作臺列表與篩選¶
- 服務端分頁（20 / 50 / 100 條/頁，單頁最多 100），「全部」狀態使用 v5 的
state=all。 - 子工作項帶
↳縮進與父項編號；可摺疊子項；詳情頁可跳轉父工作項。 - 優先級列（P0–P3）、可搜索負責人下拉、類型標籤與狀態下拉；已完成/已取消整行置灰。
- 類型圖標區分任務、需求、缺陷；創建/更新時間在服務端排序，部分字段在 v5 下需本地掃描（最多約 2000 條時有提示）。
- 可選 工作項範圍：按負責人或協作人限制列表與
@Gitee候選；設置保存在 profile 狀態文件中。
詳情與評論¶
詳情框含「詳情 / 子任務」；描述支持 Markdown 預覽與編輯。企業 MCP 令牌下可在詳情區讀評、發評（Markdown 渲染，Ctrl / ⌘ + Enter 提交）。
對話引用¶
輸入 @ 選擇 Gitee 工作項，插入例如：
@Gitee[IKQGQK]
發送時插件拉取最新詳情（標題、類型、狀態、項目、負責人、父項、鏈接、描述等）注入上下文；描述超過 12000 字符會截斷。工作項正文按不可信背景資料處理。
入口與佈局¶
- 側欄「Gitee 工作臺」；輸入框左下 Gitee 按鈕可切到主面板。
- 若安裝
dsh-better-sidebar，側欄「+」菜單也可打開 Gitee 頁籤。 - 可收起項目欄或 Harness 右側欄以加寬列表（狀態會記住）。
列表與詳情有進程內緩存（項目約 30 分鐘、列表約 2 分鐘、詳情約 1 分鐘）；點「刷新」或增刪改後會失效。刪除需二次確認；運行刪除安全自檢 僅創建並刪除帶 [DSH-TEST] 前綴的測試項。
安裝與啓用¶
在 DSH 的插件管理 / Bundle 安裝中安裝：
dsh-gitee-enterprise
安裝後重啓或刷新 DSH。
首次使用步驟：
- 打開左側欄 Gitee 工作臺（或對話框左下 Gitee 按鈕）。
- 粘貼令牌並填寫企業 ID（企業 MCP 時）：
- 私人令牌：https://gitee.com/profile/personal_access_tokens，需勾選projects/issues相關權限。
- 企業 MCP 令牌：https://gitee.com/profile/mcp_gitee_ent_access_tokens，填寫企業數字 ID（如1234567）。 - 點擊 識別並連接，查看能力徽標。
典型用法¶
- 在工作臺按項目、狀態、負責人篩出缺陷，點開詳情只讀確認描述，再點「編輯」改狀態或負責人（令牌允許時）。
- 在對話輸入：
@Gitee[編號] 幫我分析根因，利用自動展開的完整工作項內容與模型討論。 - 僅需看自己負責項時，在連接設置開啓「工作項範圍」並選「僅負責人」，避免列表與 @ 候選混入無關工作項。
適用場景與注意¶
適合已在 Gitee 企業版 管項目、且主戰場是 DSH Web UI 的團隊。私人令牌適合日常瀏覽與更新；研發流程依賴在企業裏新建/刪工作項或穩定用評論時，應配置企業 MCP 令牌。
插件以當前 DSH 進程權限訪問 Gitee API；安裝前請自行查看 GitHub 源碼 與 MIT 許可證。DSH 生態是「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-gitee-enterprise 把 Gitee 企業版工作項接到 Harness 界面與對話上下文裏，用官方 Bundle 名 dsh-gitee-enterprise 即可安裝。文檔與問題跟蹤見倉庫 README：https://github.com/cnHuaShao/dsh-gitee-enterprise。
