前言¶
在 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 安装试用。
