前言¶

做智能體開發時，項目分析文檔是高頻產物：讀一遍代碼，輸出文檔類型、工程類型、事實臺賬和結論。問題在於文檔質量沒有客觀標準。同一份「項目分析」，模型寫出來之後沒人能判斷它漏了什麼、錯在哪：事實臺賬是否與代碼一致、工程類型判斷是否站得住，都靠人眼復看，代價高且不一致。

dsh-project-brief 針對的就是這個環節。它是 DeepSeek Harness（DSH）的客戶端插件，由 xxuucc 維護，在輸入框上方加一塊麪板，並把項目分析文檔的產出改成帶斷言的形式，讓文檔可以被檢查而不是被信任。

這是做什麼的¶

一句話：把項目分析文檔的生成位置前移到輸入框上方，併爲文檔內容加上可判卷的約束。

維護者：xxuucc。分類：客戶端。目錄頁標註星標爲 0（按 SkillHub 目錄頁數據）。

Source: https://www.skillhub.cn/plugins/xxuucc/dsh-project-brief

核心功能¶

輸入框上方面板¶

插件在輸入框上方增加面板區域。按插件簡介，項目分析文檔的生成入口位於該面板內，而不是在對話過程中臨時調用某個命令。

來源：SkillHub 目錄頁插件簡介，原文爲「輸入框上方面板 + 可判卷的項目分析文檔生成」。

可判卷的項目分析文檔¶

按目錄頁簡介，插件產出的項目分析文檔包含兩部分：

1、事實臺賬：把文檔中出現的事實性內容逐條登記，形成可逐條覈對的清單。
2、18 項斷言：文檔需要滿足 18 項可判定的斷言，用於判卷（即逐項檢查是否成立）。

「判卷」在這裏指對斷言逐項做真/假判定。資料中沒有給出斷言的具體條目，也沒有給出判卷的輸出形式，因此這 18 項斷言的內容需要以插件源碼爲準。

文檔類型與工程類型可擴展¶

簡介同時說明文檔類型與工程類型是可擴展的，即插件不把分析範圍固定在單一文檔類型或單一工程類型上，允許自行擴充。資料中沒有列出已內置的文檔類型或工程類型，也沒有給出擴展的配置方式。

安裝與啓用¶

目前公開資料中沒有可用的安裝命令。

SkillHub 目錄頁以前端渲染爲主，抓取不到正文；GitHub 倉庫頁與 raw README 在本次寫作時均無法打開，因此無法從資料中核對安裝命令。按照本文的約束，不憑插件名稱拼接 dsh plugin add 一類命令。

啓用前請自行覈對：

# 待覈實：該命令未在已抓取資料中出現，請以插件源碼或目錄頁實際說明爲準

另外需要注意，插件運行在當前 dsh 進程權限之下。安裝前應先查看源碼，確認插件的聲明範圍與許可證（資料中未給出許可證信息），再決定是否啓用。

典型用法¶

按目錄頁簡介，插件的產出物是一份含事實臺賬與 18 項斷言的項目分析文檔。因爲資料中沒有 README 與示例命令，下面只描述可用部分，不補全具體調用方式。

1、在輸入框上方的面板中發起項目分析文檔生成。具體的觸發方式資料中沒有說明。
2、拿到文檔後，檢查事實臺賬是否逐條對應到代碼中的事實。
3、對 18 項斷言逐項做真/假判定，未通過的項即判卷不通過項。

斷言條目和判卷的具體執行方式，同樣需要以插件源碼爲準。

適用場景與注意¶

適合以下情況：

1、需要對智能體產出的項目分析文檔做客觀檢查，而不是人工復看。
2、文檔類型或工程類型超出插件內置範圍，願意自行擴展。
3、願意先讀源碼再啓用插件，而不是直接安裝第三方客戶端插件。

需要注意：

1、以插件當前 dsh 進程權限運行。插件能讀取的文件與能執行的操作，取決於啓動 dsh 時所用的用戶與目錄權限。
2、安裝前先檢查源碼與許可證。本插件源碼位於 https://github.com/xxuucc/dsh-project-brief ，本文寫作時無法訪問該頁面，無法確認許可證與實現細節。
3、SkillHub（skillhub.cn）是獨立的社區目錄站點，與 DeepSeek / 幻方無官方從屬關係，因此這不是官方應用商店，目錄頁信息僅作參考。
4、18 項斷言的條目內容可能在後續版本中變化，判卷前請確認與當前源碼一致。

小結¶

dsh-project-brief 的價值不在「多生成一份文檔」，而在把項目分析文檔的生成入口固定到輸入框上方的面板，並用事實臺賬加 18 項斷言讓它可以被逐項判定。如果你正被項目分析文檔的可靠性問題困擾，可以從源碼確認斷言條目與擴展方式，再決定是否採用。

目錄頁：https://www.skillhub.cn/plugins/xxuucc/dsh-project-brief
源碼：https://github.com/xxuucc/dsh-project-brief