DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-asl

d

dsh-asl

Manifest valid

ASL Mode and Skill workspace for DeepSeek Harness: editable Mermaid canvas, Markdown files and native DeepSeek editing.

UI (client)hasBundlePatch

简体中文 · English

dsh-asl

把技能放回工作场景里,在 DeepSeek Harness 中接着做事。

Release Checks MIT License

为什么需要它 · 怎么用 · 开始使用 · 架构 · 安装与排错

你可能已经存了不少 Skill。真正开始工作时,还要想一遍:这次该用哪几个,材料放在哪里,上次调整过的方法能不能接着用。

dsh-asl 把 ASL Harness 的工作环境带进 DeepSeek Harness。 用 Mode 整理一种反复要做的工作,在画板上看清技能怎样配合;打开节点里的技能,阅读和修改它的文件。需要 DeepSeek 帮忙时,就在当前页面继续对话。

Creator Studio 技能画板

Creator Studio 示例画板,来自实际插件组件。显示哪些技能,由你连接的 Environment 决定。

为什么做这个插件

一篇公众号稿可能要用到资料核查、作者采访、写作、配图和排版;投研工作也有自己的材料、判断方式和工具。把这些能力平铺在同一个目录里,时间一长,找得到文件也未必记得该怎么配合。

ASL 用 Mode 保存这样的工作场景。dsh-asl 给它一个可以直接操作的工作区:技能关系、文件和原生 DeepSeek 对话放在同一条使用路径里。写过的内容留在自己的文件夹中,下次进入这个 Mode,还能从这里继续。

它延续 ASL Harness 的分工:ASL 管工作环境和内容,DeepSeek Harness 管模型、会话与工具执行。已有的 ASL 技能库可以直接连接。

先看一遍怎么用

以“把投研材料整理成公众号文章”为例,你可以在自己的内容创作 Mode 中这样工作:

  1. 进入场景。 手动选择 Mode,或输入这次的目标,让工作区按现有 Mode 的名称和用途匹配;有歧义时自己选。
  2. 看清关系。 进入后就是 Mermaid 技能画板。单击节点打开技能预览,双击改名;拖动节点、连接技能,或直接编辑 Mermaid 原文。
  3. 边看边改。 单击节点,右侧显示技能目录与 Markdown。可以直接编辑原文、保存,或放大阅读;右键可复制路径、显示系统目录及打开原生 Sidebar。需要完整文件页时,点「打开技能 ↗」或按 Ctrl+Enter。
  4. 交给 DeepSeek。 在底部原生输入框说明目标。业务文章与卡片保存在当前项目;需要改技能时才编辑技能文件。左下进度窗列出实际工具调用与已保存产物,点击文件即可预览;选中节点不会被当作正在执行。
  5. 需要新能力时再找。 在画板上画框,把范围交给右侧会话,协助查找、检查和采用技能。每次成功保存后,画板随之更新。

这个例子需要你自己的研究与创作技能。仓库附带的起步样例只包含产品分析和资料研究,用来熟悉安装与操作。

Mode、Skill 和画板,分别是什么

对象你会用它做什么保存在什么地方
Environment长期保存自己的技能与工作场景一个普通的本地文件夹
Mode组织一种反复进入的工作状态,如研究、创作或产品分析modes/<mode-id>/
Skill保存某项专业能力的说明、脚本、模板和参考资料skills/<skill-id>/
Mermaid 画板看见、调整技能关系与常用工作范式Mode 的 MODE.md;成员配置在 mode.yaml
DeepSeek 会话围绕当前内容提出目标、查找资料和执行修改DeepSeek Harness 原生会话

一条连线可以表示“这些材料供下一项技能使用”,也可以表示补充研究、分支或反馈。Agent 按当前任务选择怎么做,图本身不保存任务运行状态。多个 Mode 可以引用同一项 Skill,修改时仍落在同一份文件上。

开始使用

当前版本为 0.3.17。此前基础版已在 Windows x64、官方 DSH 0.2.1-rc.5 验收;Windows 桌面版已使用真实模型验证执行进度、写入文件和点击产物预览。macOS/Linux 原生宿主尚未实测。宿主兼容声明为 >=0.2.1-rc.5 <0.3.0-0,这个范围不代表每个版本都已实测。商店/GitHub 直装后即使未配置本地路径,也能安全挂载;首次打开会提示准备 ASL 仓库和 Environment。实际读写仍需完成下面的配置。下面走 Windows 路径;完整解释和故障处理见安装指南。

安装需要四样东西:能正常打开的 DeepSeek Harness、Git、完整的 ASL 源码目录,以及 ASL 核心程序。使用下面的便携核心时,普通使用者不需要另装 Python 或构建插件。

1. 下载源码和核心

先打开一次 DSH 桌面应用,完成它自己的初始化,再完全退出。然后在 PowerShell 中执行:

git clone --recurse-submodules https://github.com/qihangzhang-272/dsh-asl.git
cd dsh-asl

upstream 是插件需要的 ASL 源码。如果之前只做了普通 clone,补执行 git submodule update --init --recursive。GitHub 的「Download ZIP」不包含子模块,建议使用上面的 Git 命令。

下载 ASL Workspace 0.5.19 Windows x64,对照同版本校验值,完整解压到你选的应用目录,例如 C:/Tools/ASL-Workspace-0.5.19。核心位于解压后的 ASL Workspace/resources/core/asl-harness.exe;请保留整个应用文件夹。

已有完整 ASL App 的话,可直接使用其中的核心,不必重复下载。

2. 准备自己的环境

有现成 ASL Environment,就用它的根目录。第一次尝试,可在 dsh-asl 目录复制一份样例:

Copy-Item -LiteralPath ./upstream/examples/personal-environment -Destination ./my-environment -Recurse

这份样例有一个 Creator Studio Mode 和两个技能。之后的试用修改会留在 my-environment,不会改到上游示例。

3. 安装插件

以下假定 dsh 命令已可用:

dsh --version
dsh plugin --profile desktop add https://github.com/qihangzhang-272/dsh-asl/releases/download/v0.3.17/dsh-asl-workspace-0.3.17.tgz --config.auto-install-peers=false --ignore-scripts

找不到 dsh 时,可使用官方桌面版安装目录下的 resources/runtime/cli/bin/dsh.cmd,具体写法见安装指南。这一步使用预构建包;安装期间保持 DSH 退出,并在完成下一步配置后再打开。

4. 填入三个路径

默认配置文件是 %USERPROFILE%/.dsh/profiles/desktop/cordis.patch.yml。如果设置过 DSH_HOME,就在该目录的 profiles/desktop/cordis.patch.yml 中修改。

保留文件中已有的其他条目,追加下面这一项;已有相同 id 时更新那一项。将示例路径替换成你自己的绝对路径,Windows 路径用 / 写最方便:

- id: asl-workspace
  config:
    sourceRoot: 'C:/Work/dsh-asl/upstream'
    environment: 'C:/Work/dsh-asl/my-environment'
    coreExecutable: 'C:/Tools/ASL-Workspace-0.5.19/ASL Workspace/resources/core/asl-harness.exe'
配置指向哪里快速确认
sourceRoot完整 ASL 源码根目录其中有 desktop/bridge.cjs
environment你的技能库根目录其中有 skills/ 和 modes/
coreExecutable随 ASL App 提供的核心程序文件名是 asl-harness.exe,不是 ASL Workspace.exe

5. 打开并试一次

从桌面重新打开 DeepSeek Harness,点左侧「ASL 工作区」。使用样例时,应能选到 Creator Studio,看到「产品分析示例」与「通用能力」两张图。

选中产品分析节点,用「打开技能 ↗」进入文件页。先做一次手动编辑、保存、重新读取,确认内容确实留在文件中。然后可在底部向 DeepSeek 发送:

用 asl_workspace 先 context,再 read 当前文件。读取后概括它的用途,先不要修改。

模型与工具权限需要先在 DSH 中配置好。若读文件正常,再要求它修改当前文件中的一句话;让它通过同一工具保存,并核对界面回读的内容。工作区存在未保存草稿时,先保存或放弃草稿,再让 DeepSeek 写入。

遇到问题可先看排错表,其中包括空白工作区、路径错误、输入框未挂载、保存冲突与图示校验失败。

内容怎样被修改

flowchart LR
  U[画板与文件编辑] --> D[共享领域服务]
  H[DSH 原生会话] --> T[asl_workspace 工具]
  T --> D
  D --> C[ASL 核心校验与保存]
  C --> E[本地 Environment]
  E --> U

手动操作和 DeepSeek 写回使用同一条保存路径。保存会检查当前目标、原文指纹和界面草稿,再交给 ASL 核心检查引用、文件边界和 Mermaid 渲染。只有成功落盘的内容才会刷新到画板或文件页。

这能防止一条迟到的回复覆盖你刚改过的内容。DSH 的模型、批准与执行权限仍由宿主管理;这些检查只约束共享工具的写入,不构成宿主其他文件工具的沙箱。

完整设计见 ARCHITECTURE.md。其中也区分了 ASL 总体框架和这个插件已经接上的部分:例如,选择工作区 Mode 不会自动重写 DSH 全局 Skill 发现目录。

常用操作

想做什么操作
选择、编辑节点单击选择;双击、Enter 或 F2 改名
打开技能文件节点旁的打开按钮,或 Ctrl+Enter
多选、移动Shift 多选;空白处框选;拖动节点
平移、缩放V/H 切换工具;空格拖动;滚轮平移;Ctrl+滚轮 缩放
全图、原始大小Shift+1/Shift+0
撤销、重做Ctrl+Z/Ctrl+Shift+Z
复制、粘贴、复制一份Ctrl+C/Ctrl+V/Ctrl+D
查看更多快捷键? 或工具栏键盘按钮

多节点复制与移动适用于流程图;其他 Mermaid 图型保留各自的结构编辑方式。编辑文字或使用输入法时,快捷键作用于文字。macOS 按键映射包含 ⌘,但尚未完成原生宿主验收。

现在的边界

技能发现需要网络,采用之前可检查来源;下载包不会自动执行安装脚本。技能采用与改图分步保存,未提供跨文件事务。画板在每次保存成功后更新,逐 token 生成节点和通用跨系统调度仍是后续工作。

插件当前通过共享工具访问技能;完整 ASL 宿主投影、培养区、来源升级与跨机同步能力,请以 ASL 主仓库 的实现状态为准。

开发与贡献

包名是 dsh-asl-workspace,公开仓库名是 dsh-asl。upstream 固定共享编辑器和客户端源码,根目录提供 DSH 安装所需的宿主代码与预构建产物。源码关系、升级方式见 UPSTREAM.md。

Node.js ≥22.19,在仓库根目录执行:

git submodule update --init --recursive
npm ci --ignore-scripts --legacy-peer-deps
npm run build
npm run test:unit
npm pack --ignore-scripts

设置 ASL_CORE_EXECUTABLE 为正式核心路径后,npm test 可运行含真实保存的集成检查。独立仓库有 61 项单元检查,含核心集成为 62 项;GitHub CI 运行构建、单元检查和打包。发布与首次安装实走记录见 验证记录。

欢迎提交 Issue 或 PR。反馈问题时请写明 DSH 版本、插件版本、操作系统、复现步骤;日志里记得去掉密钥、私人路径和正文。

许可与来源

MIT。基于同作者的 ASL Harness,共享实现固定到上游提交;界面视觉由 Google Stitch 生成。dsh-asl 是独立社区插件。

Comments

Loading…