前言¶
在 DeepSeek Harness（DSH）裏做創意類任務，常見做法是反覆在對話裏改 prompt，或者把 Agent 輸出的 HTML、Markdown 複製到本地逐個打開。方案一多，歷史版本就散在聊天記錄裏，橫向對比和從某個方向繼續分叉都不順手。
Ramify 是面向這類場景的 DSH 插件：把多個創作方向組織成一棵即時更新的創意樹，在 Harness 內直接查看、比較，並從任意節點繼續發散。下面介紹它的定位、能力與安裝用法。
這是什麼¶
Ramify（@ramify/dsh-ramify）是 DeepSeek Harness 的原生創意分支畫布插件，由 yanglongyun 維護，在 SkillHub 社區目錄 歸類爲「工作流」。源碼託管於 GitHub，採用 MIT 許可證。
它通過標準插件清單、Cordis 服務和 Client UI 插槽接入 DSH，不修改 Harness 源碼。Agent 生成的多個方向、可運行作品和後續修訂會寫入同一棵創意樹；界面提交走當前 DSH 會話，不需要在 Ramify 裏單獨配置模型或 API Key。
核心功能¶
創意樹工作流¶
工作方式可以概括爲五步：
- 點擊 DSH 左側欄的 Ramify，打開內置工作臺。
- 在 Ramify 輸入框中填寫需求，並選擇方案數量。
- 插件立即創建項目並進入畫布，同時把任務提交給當前 DSH 會話和模型。
- Agent 通過 Ramify 工具持續寫入節點，畫布上即時出現預覽。
- 點擊節點右上角的發散按鈕，輸入修改要求，從該節點繼續生成分支；舊方案保持不變。
作品預覽與持久化¶
HTML、Markdown、SVG、圖片、視頻和音頻作品可在畫布內直接預覽。數據通過 SQLite 本地持久化，前端以輕量輪詢感知變更；默認保存在操作系統應用數據目錄，升級或重啓不會清空。
畫布卡片縮略圖使用空 sandbox，不執行 JavaScript，避免大量作品同時跑腳本拖慢界面；右側詳情與新窗口作品則按普通網頁完整運行，可加載外部資源、聯網和提交表單。
Agent 工具集¶
插件向當前模型註冊以下工具，供對話中直接調用：
| 工具 | 用途 |
|---|---|
ramify_start |
啓動或連接畫布 |
ramify_project_create |
創建項目與根節點 |
ramify_project_list |
列出項目 |
ramify_project_tree |
讀取完整創意樹 |
ramify_node_add |
添加單個節點或作品佔位符 |
ramify_node_batch |
原子化創建多層節點樹 |
ramify_node_complete |
寫入 HTML、Markdown、SVG 或媒體作品 |
ramify_node_update |
更新標題、文本或樹位置 |
ramify_settings |
切換主題和界面語言 |
運行時架構¶
Ramify UI (DSH overlay iframe)
│ 結構化創建/分支意圖
▼
DSH Client UI 會話橋 ──► 當前 DSH 會話與模型
│ │
│ 輕量輪詢感知變更 │ Ramify tools
▼ ▼
本地 Ramify runtime ◄──── 項目、節點與作品
│
└── SQLite + 本地 artifact 文件
默認端口：DSH Web UI 爲 http://127.0.0.1:3099，Ramify runtime 爲 http://127.0.0.1:9519。安裝後插件會自動啓動本地畫布，無需單獨運行 CLI；卸載時會清理自己啓動的運行時，已有 Ramify 實例會被複用而不會被關閉。
安裝與啓用¶
環境要求：
- Node.js 22.19 或更高版本
- DeepSeek Harness 0.1.0-rc.6（README 標註的當前測試版本）或兼容版本
從源碼安裝（當前推薦）¶
git clone https://github.com/yanglongyun/dsh-ramify.git
cd dsh-ramify
npm install
npm run build
dsh plugin --profile web add "$PWD"
dsh web --port 3099
上述命令來自插件 README。倉庫在 GitHub 上也可通過 yanglongyun/ramify-dsh 訪問。
npm 包（發佈後）¶
dsh plugin --profile web add @ramify/dsh-ramify
dsh web --port 3099
啓動後點擊 DSH 左側欄底部的 Ramify。工作臺會嵌入 DSH 覆層；頂部外部打開按鈕可作爲獨立窗口使用。
可選配置¶
在 profile 的 cordis.patch.yml 中可覆蓋端口、數據目錄和超時：
- id: ramify
name: '@ramify/dsh-ramify'
config:
port: 9519
dataDir: '/absolute/path/to/ramify-data'
startupTimeoutMs: 5000
shutdownTimeoutMs: 3000
dataDir 省略時，Linux 默認路徑爲 ${XDG_DATA_HOME:-~/.local/share}/ramify/。
典型用法¶
可以從 Ramify 輸入框直接發起，也可以在 DSH 對話裏要求 Agent 調用。README 給出的示例如下：
使用 Ramify 爲這個 AI 搜索產品探索三個明顯不同的落地頁方向，做出可預覽頁面讓我比較。
提交後插件先創建項目並打開畫布，Agent 隨後向同一項目寫入節點，你在樹狀視圖中並排比較各方向，再對滿意的節點繼續發散。
適用場景與注意¶
適合誰： 需要在 DSH 內並行探索多個創意方向、並希望保留分支歷史的開發者或產品/設計協作場景——例如落地頁方案、交互原型、文案變體等可預覽產出。
安全與權限： 插件以當前 dsh 進程權限運行，會在本機啓動 Ramify runtime 並讀寫本地數據。安裝前建議閱讀源碼與 MIT 許可證，確認依賴和運行時行爲符合你的環境要求。插件不接收或存儲模型 API Key，模型調用由當前 DSH 會話負責。
生態說明： DSH 奉行「一切皆插件」；SkillHub 是社區維護的插件目錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
Ramify 把「多方案生成—橫向對比—節點級分叉」收進 DSH 工作臺，減少在聊天和本地文件之間來回搬運。若你正在 Harness 裏做創意迭代，可以從社區目錄或 GitHub 獲取插件並按 README 安裝試用。
