前言¶
在 DeepSeek Harness（DSH）裏用技能，常見做法是手動記技能名、在輸入框敲 /技能名，或到各 Agent 工具各自的技能目錄裏翻找。Claude Code、Codex、ZCode、Cursor、Gemini 的技能往往分散在 ~/.claude/skills、~/.cursor/skills 等路徑，和 DSH 自帶的 ~/.dsh/skills 並不在同一套界面裏管理。對話進行中，也不容易判斷「這一輪該不該用某個技能」。
下面介紹社區插件 dsh-charlotte（維護者 AlpFallen，分類：工作流）。它給 DSH 增加一個側欄入口，把技能瀏覽、啓用、安裝、回收站與「授權後一次點擊加載」收進同一套數據驅動界面，並在對話側做宿主側實時推薦；同時以只讀方式掛載多家 Agent 的技能目錄，不改動原文件。
這是什麼¶
dsh-charlotte 是裝在 DSH 裏的技能啓動器與技能庫。側欄只增加「dsh-charlotte」一個入口：首頁有緊湊列表、真實功能分類、常用與收藏、右側詳情抽屜；對話輸入區上方可在合適時機展示推薦卡。外部 Claude / Codex / ZCode / Cursor / Gemini 技能目錄以只讀 provider 掛載爲 DSH 技能來源；對本地可寫目錄仍保留啓用、安裝、刪除與回收站能力。
插件當前版本 0.7.3，許可證 MIT。社區目錄頁：skillhub.cn/plugins/AlpFallen/dsh-charlotte。DSH 生態理念是「一切皆插件」；SkillHub 等爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
單一入口與管理頁¶
作用域、拖拽安裝、回收站、刷新和語言切換收在 更多 菜單。列表行內展示名稱與版本、描述、可用狀態、來源、收藏/置頂，以及 使用、詳情；詳情在右側抽屜，含推薦理由、適用/排除場景、觸發條件、權限、依賴、版本、來源路徑與真實使用記錄。
常用、收藏與功能分類¶
首頁頂部順序爲：置頂 → 收藏 → 按真實調用頻率補足（最多 4 條）；無數據時不渲染該塊。分類由技能自身的名稱、描述與觸發條件計算，包括開發工作、代碼質量、項目理解、文檔與知識、任務協作、設計與創作、辦公文檔、郵件溝通、學習教練等；零計數類不顯示，不設「其他」類。
搜索、篩選與排序¶
搜索覆蓋名稱、描述、用途、關鍵詞、觸發條件與分類。可按分類、來源（項目級 / 用戶專屬 / 插件提供 / 系統內置）、狀態篩選。排序支持調用頻率、名稱、最近使用；不提供「下載時間」排序（索引中沒有該字段）。
只讀掛載外部技能庫¶
只讀 provider 註冊例如：
~/.claude/skills、~/.codex/skills、~/.zcode/skills、~/.cursor/skills、~/.gemini/skills（含~/.gemini/antigravity/skills）- 各工作區下的
.claude|.codex|.zcode|.cursor|.gemini/skills - 可通過配置
extraDirs增加自定義目錄
文件留在原處；frontmatter 字段會映射到 DSH 語義，目錄變更可熱更新。對掛載技能的啓停寫在 dsh-charlotte 的覆蓋表，不寫回外部 SKILL.md。
本地技能：安裝、啓停與回收站¶
可寫根包括全局 ~/.dsh/skills、共享 ~/.agents/skills、以及項目下的 <project>/.dsh/skills / .agents/skills。支持拖拽文件夾或 .zip 安裝（先校驗 SKILL.md 含 kebab-case name 與 description 並預覽）。刪除進入 ~/.dsh/charlotte/trash，可恢復或清空。
對話內實時推薦¶
宿主在 agent/pre-step 根據本輪用戶原文與技能元數據做評估；客戶端在本輪迴答結束（running 由真變假）後，在輸入框上方展示推薦卡，不打斷生成，也不把「推薦」等同於「加載」。
推薦流程包括：快速排除未啓用 / 用戶不可調用 / 依賴缺失 → 語義匹配 → 排序 → 權限與依賴檢查。寒暄、過短提示默認不推薦；卡片提供 使用 與 忽略，點 使用 與管理頁相同的授權加載鏈路。
「加載」在 DSH 中的含義¶
DSH 沒有「不產生模型回合就注入技能指令」的獨立 API。支持的準備方式是官方 /技能名 composer token：點擊 使用 後，宿主先校驗可見性、啓用狀態與依賴，再把 /技能名 寫入當前或新建對話的輸入框並關閉啓動器；不會自動發送消息、不會啓動 Agent 回合。只有你發送消息後，宿主才把 token 轉爲技能指令；發送前刪掉 token 則技能不生效。加載中再次點擊可取消；失敗展示宿主返回的真實原因。
插件自帶技能與中文界面¶
由 DSH 插件或 bundled provider 註冊的技能以只讀「插件」卡片出現在同一網格，技能站只負責展示與加載，不能啓停或刪除。界面可中英切換；列表有一句通俗中文簡介，詳情展示官方描述與中文專業版概述（優先技能自帶的 simple-zh / professional-zh，其次 locale/skills.zh.json 中與原文哈希匹配的條目）。
安裝與啓用¶
桌面應用¶
設置 → 插件 → 添加插件 → 安裝第三方插件，填寫：
https://github.com/AlpFallen/dsh-charlotte
該入口同樣接受 npm 包名和本地目錄。安裝完成後重啓應用，側邊欄「設置」按鈕上方會出現 dsh-charlotte 入口。
說明：桌面 profile 由 Electron 應用託管，CLI 的 dsh plugin --profile desktop add 會被拒絕（profile "desktop" is managed exclusively by the Electron application）。從 GitHub 安裝時倉庫已包含編譯好的 client/client.js，無需本地構建。
命令行（web profile）¶
dsh plugin --profile web add github:AlpFallen/dsh-charlotte
README 記載：作者在桌面 App 內置 DSH 0.2.1-rc.3（Node 24.21.0）上驗證；另用 CLI 安裝的 DSH 0.1.5-rc.2 做過宿主接口比對。更新的 0.2.x 未在文檔中全部驗證。
可選配置¶
配置寫在 profile 補丁層 plugins.dsh-charlotte 下；未知鍵啓動即報錯。示例（均可選）：
plugins:
dsh-charlotte:
sources:
claude: true
codex: { project: false }
zcode: true
cursor: true
gemini: true
extraDirs:
- { path: ~/my-skills, label: mine, rank: 300 }
watch: true
slugifyNames: true
synthesizeDescription: true
recommend:
enabled: true
maxItems: 3
threshold: 0.18
minIntentChars: 10
minValueScore: 0.2
cooldownMs: 45000
maxPerSession: 8
dedupeJaccard: 0.6
sameTaskJaccard: 0.55
comboRatio: 0.75
典型用法¶
- 安裝並重啓 DSH 後，從側欄打開 dsh-charlotte，在首頁或「全部技能」中搜索、按分類或來源篩選，打開詳情抽屜審閱觸發條件與權限依賴。
- 需要在本輪對話使用某技能時，點擊 使用；確認輸入框出現
/技能名後，補充任務描述併發送。不要期望插件替你在未發送的情況下執行技能。 - 對話進行中，若宿主判定有合適技能，回答結束後輸入框上方會出現推薦卡；可 使用 或 忽略（忽略後同一任務內不再重複推同一技能，直到需求實質變化）。
- 要把 Claude / Cursor 等目錄裏的技能納入列表且不改原文件，保持
sources中對應項爲true；僅需部分目錄時按 README 細項開關或extraDirs調整。 - 安裝新技能：通過 更多 菜單進入安裝面板，拖拽技能文件夾或
.zip，預覽確認後寫入可寫根目錄。
適用場景與注意¶
適合誰：長期在 DSH 裏用技能、同時還在 Claude Code / Codex / ZCode / Cursor / Gemini 生態積累技能目錄的開發者；希望在一個界面裏瀏覽、啓停、安裝，並在對話中收到基於上下文的推薦，而不是每次手動回憶技能名。
安全與權限：插件以當前 DSH 進程權限運行；掛載與上傳的技能均爲第三方內容，啓用前請自行審閱源碼與 SKILL.md。技能「使用」授權不等於刪除文件、發消息等高風險操作——這些仍由 DSH 工具權限與審批獨立校驗。變更類 HTTP 接口拒絕跨源請求。運行狀態位於 ~/.dsh/charlotte/（如 state.json、overrides.json、trash/），不進插件倉庫。
停用語義：對模型停用但用戶仍可調用的技能會標記爲「僅用戶」，仍可使用；用戶不可調用的技能不能使用。
結尾¶
dsh-charlotte 把 DSH 裏的技能管理、多 Agent 技能目錄只讀彙總、對話側推薦與 /name 加載鏈路接到一起，側欄一個入口即可完成「發現 → 授權 → 加載 → 發送後執行」的準備步驟。安裝前建議在 GitHub 閱讀 README 與安全模型說明。
