@dybai/dsh-editor 0.4.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -5
- package/client.js +2126 -108
- package/host/log-serialize.js +154 -0
- package/host/log-service.js +504 -0
- package/host/preferences-service.js +5 -5
- package/index.js +47 -10
- package/locale/en.json +14 -2
- package/locale/zh.json +14 -2
- package/package.json +4 -2
package/README.md
CHANGED
|
@@ -1,20 +1,36 @@
|
|
|
1
1
|
# @dybai/dsh-editor
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**@dybai/dsh-editor** 让 DeepSeek Harness(DSH)工作区里的文本文件可以直接在对话旁就地编辑、保存(`Ctrl+S`)。DSH 原本只能只读预览工作区文件,想改就得跳出对话换外部工具;本插件补上「改文件」这一环:打开即编辑、保存写回磁盘,外部修改和误删都有保护。
|
|
4
|
+
|
|
5
|
+
它同时是可扩展的**编辑器框架**:工具栏、状态栏、编辑模式、键位等全部开放给第三方插件,契约见 [docs/contracts.md](docs/contracts.md)。
|
|
6
|
+
|
|
7
|
+
## 安装
|
|
8
|
+
|
|
9
|
+
前置要求:DSH 引擎 `dsh >= 0.2.1-rc.5`;安装完成后浏览器 **Ctrl+F5** 刷新生效。
|
|
10
|
+
|
|
11
|
+
**插件市场(推荐)**:
|
|
12
|
+
|
|
13
|
+
1. DSH 设置 → 插件 → 安装官方可选 bundle `@deepseek-ai/dsh-experimental-plugin-market-bundle`(实验性插件市场,提供 Discover 标签页);
|
|
14
|
+
2. 在市场设置里**添加索引源**:`https://raw.githubusercontent.com/dybai/dsh-editor/main/market-index.json`;
|
|
15
|
+
3. Discover 里找到「DSH 编辑器」→ 安装 → 刷新页面。
|
|
16
|
+
|
|
17
|
+
**npm 直接安装**:`plugin_manager` → `install_bundle`,spec 填 `@dybai/dsh-editor@0.4.0`(新版本号以 npm 页面或市场索引为准)。
|
|
18
|
+
|
|
19
|
+
**本地开发**:`install_bundle` 的目标为本仓库目录的绝对路径;开发循环见 [docs/deploy.zh-CN.md](docs/deploy.zh-CN.md) §3。
|
|
4
20
|
|
|
5
21
|
## 框架概述
|
|
6
22
|
|
|
7
23
|
三层架构:
|
|
8
24
|
|
|
9
25
|
- **集成层**(任意第三方插件,零依赖):注册座位 occupant、消费 `dshEditor` 服务、注册编辑模式、经导航契约打开文件——只依赖"名字",不 require 本包;
|
|
10
|
-
- **框架层**(本包):唯一状态与编排所有者——tab 状态机与保存队列(乐观并发 + 冲突横幅)、模式解析与挂载、工具栏/状态栏 chrome
|
|
26
|
+
- **框架层**(本包):唯一状态与编排所有者——tab 状态机与保存队列(乐观并发 + 冲突横幅)、模式解析与挂载、工具栏/状态栏 chrome 与座位渲染、草稿/视图状态持久化、Host RPC 桥;
|
|
11
27
|
- **模式层**(React 组件):内容视图。内置 `plain-text`(fallback);第三方以 `extension`/`builtin` 带注册排序接入,切换模式保草稿。
|
|
12
28
|
|
|
13
29
|
完整契约见 **[docs/contracts.md](docs/contracts.md)**(座位 owner props、句柄切片、模式描述符、Host RPC、导航契约、持久化、演进规则)。
|
|
14
30
|
|
|
15
31
|
## 快速开始
|
|
16
32
|
|
|
17
|
-
|
|
33
|
+
**安装**:见上方[「安装」](#安装)章节(插件市场 / npm 包 / 本地目录三条渠道)。
|
|
18
34
|
|
|
19
35
|
**打开**:
|
|
20
36
|
|
|
@@ -23,7 +39,7 @@ DSH Web 分栏的可扩展**编辑器框架**:让会话工作区里的文本
|
|
|
23
39
|
|
|
24
40
|
**保存与键位**:
|
|
25
41
|
|
|
26
|
-
- `Ctrl+S` 保存前台编辑器;`Ctrl+Shift+S` 保存当前会话全部未保存的编辑器;`Ctrl+D`
|
|
42
|
+
- `Ctrl+S` 保存前台编辑器;`Ctrl+Shift+S` 保存当前会话全部未保存的编辑器;`Ctrl+D` 删除光标行/选区触及行;`Ctrl+G` 打开跳转到行面板。这四条是**框架自管键位**:编辑器根元素拦截 keydown 并自行 `preventDefault`(对任何组合有效,不受 DSH web 快捷键白名单限制),编辑器之外浏览器默认行为照旧;
|
|
27
43
|
- 键位是全局用户偏好:编辑器状态栏右端的小键盘图标打开键位面板,逐动作「录制」新组合(允许任何组合,含浏览器保留键)或「恢复默认」,持久化到 Host 存储、所有已挂载编辑器立即生效(详见 [docs/contracts.md](docs/contracts.md) §6);
|
|
28
44
|
- 磁盘文件被外部修改时出现冲突横幅:**重新加载并丢弃本地修改** 或 **仍要保存(覆盖磁盘)**;
|
|
29
45
|
- 编辑中途崩溃/刷新后重新打开同一文件,未保存草稿自动恢复(磁盘文件也变过时先出冲突横幅,绝不静默覆盖)。
|
|
@@ -42,6 +58,27 @@ DSH Web 分栏的可扩展**编辑器框架**:让会话工作区里的文本
|
|
|
42
58
|
- 设置面板新增「高亮光标所在行」开关(默认开,全局持久化,对所有已挂载编辑器立即生效);
|
|
43
59
|
- 第三方模式可在描述符声明 `activeLine: true` 接入同一契约:经组件 prop `highlightActiveLine` 接收偏好、以快照 `selection.lineStart`/`lineEnd` 为高亮范围自行绘制(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
|
|
44
60
|
|
|
61
|
+
**行号列**(0.5.0):
|
|
62
|
+
|
|
63
|
+
- 编辑区内容左侧显示行号列:宽度随最大行号位数自适应(跨 100/1000 行等进位时自动加宽),随滚动、编辑、行导航实时同步;
|
|
64
|
+
- 设置面板新增「显示行号」开关(默认开,全局持久化,对所有已挂载编辑器立即生效)。开关只控制数字显隐:分界竖线与左侧预留带常驻,切换不会移动正文位置;
|
|
65
|
+
- 无描述符声明字段:`showLineNumbers` 偏好经组件 prop 直接送达到每个挂载的模式组件,第三方模式可自行接入(绘制行号列)或安全忽略(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
|
|
66
|
+
|
|
67
|
+
**跳转到行**(0.6.0):
|
|
68
|
+
|
|
69
|
+
- `Ctrl+G` 打开跳转面板(状态栏 `Ln/Col` 指示器正上方的小输入面板),输入框默认置空并自动聚焦:输入行号后回车或点「跳转」即把光标定位到**目标行行首**(焦点随之回到编辑区),面板关闭;
|
|
70
|
+
- 输入自动收敛到 `1–总行数`(越界取最近的有效行);空/非数字输入给出内联提示、不跳转;文件仍在加载时也允许输入,加载完成后延迟落点(`failed` 相位禁用跳转);
|
|
71
|
+
- 面板关闭路径:跳转成功 / `Esc` / 点击面板外 / 页签转为不可见;
|
|
72
|
+
- `Ctrl+G` 与其余三条一样可在键位面板「录制」改键;**旧版本已自定义过键位的用户升级后键位原样保留**,新增的跳转键按 `Ctrl+G → Ctrl+Shift+G → Ctrl+Alt+G` 候选链自动补位(默认键被占用时顺延),迁移只发生在读取侧、不改写已存储数据;
|
|
73
|
+
- 热键链路(派发/退避/解析/跳转/迁移)带 `[dsh-editor]` 前缀的 `console.debug` 日志,浏览器控制台勾选 verbose 即可定位每一步的状态。
|
|
74
|
+
|
|
75
|
+
**光标与视口位置恢复**(0.8.0):
|
|
76
|
+
|
|
77
|
+
- 关闭页签、刷新页面或切换回同一文件时,自动恢复上次的选区(光标或多行选区)与可视区域(垂直 + 水平滚动),有记录时不再从文件顶部开始;
|
|
78
|
+
- 位置按“工作区根 + 文件路径”记忆:同一工作区跨会话共享(工作区根未知时按会话隔离),不同工作区的同名文件互不干扰;localStorage 明文保存(仅本机,LRU 200 条 / 90 天);
|
|
79
|
+
- 显式导航优先:带 `line` 打开、`Ctrl+G` 跳转不会被旧位置覆盖;
|
|
80
|
+
- 文件内容变短或行被删除时,位置收敛到当前文本的有效行;第三方编辑模式可经可选 props `initialScroll` / `onScrollChange` 接入滚动恢复(不接入也会恢复机器选区;模式需按契约镜像机器选区并让编辑区取得焦点,光标才可见)。
|
|
81
|
+
|
|
45
82
|
## 集成接口摘要
|
|
46
83
|
|
|
47
84
|
| 契约面 | 入口 | 一句话 |
|
|
@@ -60,7 +97,6 @@ DSH Web 分栏的可扩展**编辑器框架**:让会话工作区里的文本
|
|
|
60
97
|
- `contentKind: 'raw'` 路径与自定义传输(二进制/分页内容由模式自带读写);
|
|
61
98
|
- hex / CodeMirror 高亮等 builtin 富模式及细粒度扩展面(编辑区浮层座位:find/minimap);
|
|
62
99
|
- `fs` 字节写 facet(当前仅整文件 UTF-8 文本写,≤4 MB,文本格式白名单);
|
|
63
|
-
- 光标位置恢复(草稿恢复后光标不回位);
|
|
64
100
|
- 模式关联管理设置页(关联目前仅经模式菜单"设为默认/恢复默认"管理)。
|
|
65
101
|
|
|
66
102
|
另有:只能编辑会话工作区内的文本文件;编辑器以独立 tab 打开,不替换当前预览 tab;键位录制会拒绝浏览器生命周期保留组合(Ctrl/⌘+W/T/N/Q、Ctrl+Tab 等)并给出提示——页面层无法可靠拦截这类浏览器默认行为。
|