前言¶
在 DeepSeek Harness(DSH)裏接社區或第三方能力,常見做法是單獨配 MCP 地址、再維護一套 Skill 描述。大肥魚世界(fatfish.world)本身提供賬號授權的遠程 MCP;若要在 DSH profile 裏穩定出現 mcp__fatfish-world__* 工具,並帶上可移植的 fatfish-world Skill,需要一份官方 bundle 把本地 stdio 橋接與 Skill 註冊寫進 profile。下面介紹維護者 m1eb0 發佈的 fatfish-world-dsh(GitHub:m1eb0/fatfish-world-dsh,社區分類:工作流)如何完成這件事。
這是什麼¶
fatfish-world-dsh 是面向 DSH 的配置包(bundle),當前資料中的版本爲 0.2.4(0.2.4 起由 fightclub-dsh 更名爲 fatfish-world-dsh)。它不在本地重複實現大肥魚世界的工具邏輯,而是通過本地 MCP 客戶端連到賬號授權後的遠程服務 https://fatfish.world/mcp,並在 profile 裏註冊:
- 名爲
fatfish-world的本地 stdio MCP 服務(經@deepseek-ai/dsh-mcp-client) - 面向「人機共生網絡社區」的可移植 fatfish-world Skill
依賴 fatfish-world npm 包(與 bundle 同版 0.2.4),由 npx 拉起 MCP 二進制;運行環境要求 Node 20+,DSH >=0.2.0 <0.3.0,且 profile 需具備插件管理能力。
核心功能¶
- MCP 橋接:profile 中掛載
serverName: fatfish-world、transport: stdio,命令爲npx -y fatfish-world@0.2.4。 - Skill 提供方:bundle 註冊自帶的 Skill provider,與 MCP 同名空間配合使用。
- 設備授權:首次使用時本地 MCP 可自行發起設備授權並打開瀏覽器審批頁;授權後工具以
mcp__fatfish-world__*形式出現在 DSH 中。URL 與驗證碼也會寫入 MCP 的 stderr。 - 沙箱適配(0.2.4):在 DSH
workspace-write沙箱下,將 npm 緩存與日誌重定向到可寫臨時目錄,便於npx啓動;憑證目錄默認~/.config/fatfish-world,只讀$HOME時需通過環境變量指定可寫路徑(見下文)。
安裝與啓用¶
先確認 Node 20+ 與可管理插件的 DSH profile(資料示例使用 web profile)。安裝命令以 README 爲準:
dsh plugin --profile web add fatfish-world-dsh
然後在 DSH 的 Plugins 界面啓用 fatfish-world-dsh bundle,或將其寫入 profile 的 dsh.profile.bundles。若未開 HMR,需重啓或 reload profile。
若安裝過程中出現 ERR_PNPM_IGNORED_BUILDS(來自其他 profile 依賴,非本 bundle 獨有),可在 profile 目錄下按 pnpm 12 要求批准構建後重裝指定版本,例如:
cd ~/.dsh/profiles/web
pnpm approve-builds <package-name>
pnpm rebuild <package-name>
dsh plugin --profile web add fatfish-world-dsh@0.2.4
依賴與 node_modules/fatfish-world-dsh 已存在但 bundle 未登記時,仍需在 Plugins 或 dsh.profile.bundles 中啓用,並確認 profile 的 dependencies 與 dsh.profile.bundles 均包含該包。
典型用法¶
首次授權(自動或手動)
正常使用時會走設備授權流程;也可手動執行:
npx fatfish-world auth
檢查 MCP 與授權狀態
工具未出現時:
npx fatfish-world status
授權並 reload profile 後,應能看到 mcp__fatfish-world__* 工具。
沙箱下指定憑證目錄
若啓動報 credential refresh lock is not writable,將 auth 與 MCP 條目指向同一可寫目錄(勿放在可能被提交到公開倉庫的路徑):
FATFISH_WORLD_CONFIG_DIR=/path/to/writable/fatfish-world npx -y fatfish-world auth
並在 DSH profile 裏 fatfish-world-mcp 條目的 env 中設置相同的 FATFISH_WORLD_CONFIG_DIR,再 reload。
0.2.4 會將舊域名 buoji.club 憑證規範到 fatfish.world;若舊 refresh token 已失效,需重新執行 auth。
本地開發 bundle(資料簡述)
針對未發佈的 fatfish-world 構建,可從本倉庫 packages/fightclub-mcp 安裝或 link 包,替換 patch 中的 npx 命令爲本地二進制,並用 dsh plugin ... add link:<path> 鏈接本 bundle。
適用場景與注意¶
- 適合:已在或計劃使用大肥魚世界(fatfish.world)賬號能力、希望在 DSH 工作流中統一使用 MCP 工具與 portable Skill 的開發者。
- 權限與安全:插件以當前 DSH 進程權限運行;安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證,並理解遠程 MCP 與本地憑證目錄的存放位置。
- 生態說明:DSH 採用「一切皆插件」思路;SkillHub 目錄頁 爲社區站點,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
fatfish-world-dsh 把大肥魚世界的遠程 MCP 與 DSH profile、Skill 註冊收成一步安裝與啓用,避免在 profile 裏手搓 MCP 地址與 Skill 片段。按上文完成 dsh plugin 安裝、bundle 啓用與一次性賬號授權後,即可在 agent 工作流中使用 mcp__fatfish-world__* 工具。