前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在構建新項目或新 Agent 時，往往需要花費大量時間編寫 Prompt 或梳理項目背景。Claude Code 提供了一套標準的 /init 工作流，本插件將其機制引入 DSH，幫助開發者快速建立項目級的 Agent 指引。
是什麼¶
dsh-init 是一個官方機制插件（profile bundle），由 evanfang0054 維護。它通過在 DSH 中註冊 /init 斜槓命令和 init 工具，將 Claude Code 的初始化流程移植過來，實現自動化的項目文檔生成與配置。
核心功能¶
該插件提供以下能力：
- 命令與工具註冊：同時註冊斜槓命令
/init和模型工具init。 - 文檔生成：自動生成
CLAUDE.md，該文件包含 Claude Code 標準文件頭及極簡的項目級 Agent 指引。 - 軟鏈機制：創建
AGENTS.md並將其設爲指向CLAUDE.md的相對軟鏈接，讓讀AGENTS.md的工具（如 DSH 自身、Cursor、Codex）與讀CLAUDE.md的工具共享同一份事實來源，無需維護兩份內容。 - 零依賴：插件自身不依賴其他包，工具定義直接註冊。
- 七階段工作流：
- 訪談：確認項目範圍與偏好。
- 偵查：讀取 manifest、README、CI、已有規則等。
- 補缺口：詢問模型無法通過代碼回答的問題。
- 寫文件：生成
CLAUDE.md，並逐行測試有效性。 - 軟鏈：建立
AGENTS.md軟鏈接。 - 本地偏好：生成
CLAUDE.local.md。 - 總結：回顧產物並提醒可重跑。
安裝與啓用¶
本包是一個標準的 DSH profile bundle。使用 DSH 自帶的 dsh plugin 命令安裝即可。
# 從 npm 安裝（推薦）
dsh plugin --profile web add dsh-init
# 從 GitHub 安裝
dsh plugin --profile web add github:evanfang0054/dsh-init
# 從本地路徑安裝（需重啓 DSH 生效）
dsh plugin --profile web add /path/to/dsh-init
安裝後，必須重啓 DSH 才能加載 bundle 層。驗證安裝成功：
cat ~/.dsh/profiles/web/package.json | grep dsh-init
# "dsh.profile.bundles" 數組裏出現 "dsh-init" 即已掛載
若通過本地路徑安裝，pnpm 會自動以 link（軟鏈） 方式掛入，修改代碼後重啓 DSH 即可生效，無需重新執行 add 命令。
典型用法¶
安裝並重啓後，可以通過以下方式觸發初始化：
- 斜槓命令：在對話中輸入
/，在補全列表中選擇init，或直接輸入/init <附加要求>。 - 自然語言：直接告訴 Agent “初始化這個項目”。
- 驗證：確認
CLAUDE.md和AGENTS.md（軟鏈）已生成。
注意事項¶
- 軟鏈與 Git：Git 原生支持 symlink（模式 120000）。在 Windows 上，需要開啓開發者模式並設置
git config core.symlinks true才能正常使用軟鏈功能。 - 已有 AGENTS.md：如果項目中已存在
AGENTS.md，工作流不會靜默覆蓋。它會先進行 diff 對比，經用戶確認後纔會替換。 - CLAUDE.md 變更：由於
AGENTS.md是軟鏈，修改CLAUDE.md即同時生效於AGENTS.md，無需手動修改。 - 更新插件：本地路徑安裝是軟鏈，修改代碼重啓即可；GitHub/npm 安裝則需要重新執行
dsh plugin add命令。
短結尾¶
dsh-init 解決了智能體開發中項目初始化文檔繁瑣的問題。通過標準化的七階段工作流，它幫助開發者快速建立項目上下文，並利用軟鏈機制統一了多工具對 Agent 指引的讀取體驗。
