@windypro-rourou/dsh-code-studio 0.1.2 → 0.1.4
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 +37 -31
- package/package.json +5 -3
package/README.md
CHANGED
|
@@ -1,42 +1,48 @@
|
|
|
1
|
-
# Code Studio
|
|
1
|
+
# Code Studio — DSH Web UI 文件修改监视器 · 代码工作台
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
> A **file-change monitor & code editor** inside the DeepSeek Harness Web UI.
|
|
4
|
+
> Watch agent edits land as line-by-line diffs in real time, right beside your
|
|
5
|
+
> conversation — then open, edit and save any workspace file without leaving
|
|
6
|
+
> the browser.
|
|
5
7
|
|
|
6
|
-
|
|
7
|
-
## 瀹夎锛堝凡瑁呭ソ锛?
|
|
8
|
-
鎻掍欢宸插畨瑁呭埌 web profile锛?DSH_HOME/profiles/web锛夛細
|
|
9
|
-
- 鍖呬綅浜?profiles/web/node_modules/@windypro-rourou/dsh-code-studio
|
|
10
|
-
- cordis.patch.yml 宸叉彃鍏?code-studio 琛?- package.json 宸插姞鍏?link:F:/CycleMaster/dsh-code-studio 渚濊禆
|
|
8
|
+
在 DeepSeek Harness 的 Web 界面里，实时监视 Agent 对文件的每一次修改：**改动落盘的瞬间**，逐行 Diff（`+` 新增 / `−` 删除 / `~` 修改）自动浮现在你的会话旁；内置语法高亮编辑器，随时查看和修改工作区文件。**不用离开 DSH，Agent 改了哪里、改了什么，一目了然。**
|
|
11
9
|
|
|
12
|
-
|
|
13
|
-
### 鎵嬪姩瀹夎锛堝叾浠栨満鍣級
|
|
10
|
+
## 核心价值
|
|
14
11
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
12
|
+
- 🔭 **实时文件修改监视**：基于会话工具事件直推，Agent 每次 write / edit 完成立即推送 Diff —— 不依赖文件系统轮询，不漏报、不延迟。
|
|
13
|
+
- 🗂 **多工作区覆盖**：自动监视所有会话的工作区目录，Agent 在任意目录改文件都能捕获。
|
|
14
|
+
- 🔒 **按会话隔离**：每个 Code Studio 只响应当前会话的修改，切换会话互不干扰。
|
|
15
|
+
- 🧠 **会话状态记忆**：变更列表、打开的标签、面板宽度按会话分别保留（本地持久化）。
|
|
16
|
+
- 📝 **语法高亮编辑器**：类编辑器体验，行号、光标、滚动同步；`Ctrl+S` 保存，`Ctrl+D` 查看 Diff。
|
|
17
|
+
- 📐 **可拖拽面板**：宽度自由调整并记住；UI 与 DSH 主题完全一致（`--dsw-alias-*` 令牌）。
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
# - id: code-studio
|
|
21
|
-
# name: '@windypro-rourou/dsh-code-studio'
|
|
22
|
-
```
|
|
19
|
+
## 安装
|
|
23
20
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
21
|
+
```sh
|
|
22
|
+
dsh plugin --profile web add @windypro-rourou/dsh-code-studio
|
|
23
|
+
# 或使用 GitHub 源
|
|
24
|
+
dsh plugin --profile web add github:WindyPro-rourou/dsh-code-studio
|
|
27
25
|
```
|
|
28
26
|
|
|
29
|
-
|
|
27
|
+
重启 `dsh web` 后，左侧边栏出现 **Code Studio** 入口。
|
|
28
|
+
|
|
29
|
+
## 兼容性
|
|
30
|
+
|
|
31
|
+
- 验证版本：**DSH ≥ 0.1.1-rc.2**（`@deepseek-ai/dsh`、`dsh-web-app`、`dsh-base`、`dsh-client-runtime`）。
|
|
32
|
+
- 依赖的 API：`webServer.register`、`session/event`（`tool/call` / `tool/result`）、`sessions.list()`、客户端 `slots` 服务 —— 在 0.1.1-rc.2 中均保持兼容。
|
|
33
|
+
|
|
34
|
+
## 使用
|
|
35
|
+
|
|
36
|
+
1. 打开 Code Studio（右侧面板，可拖左缘调宽）。
|
|
37
|
+
2. 让 Agent 修改代码 —— 面板**自动浮现**该文件的逐行 Diff：行号前 `+`（绿）/ `−`（红）/ `~`（黄），未改动大段自动折叠。
|
|
38
|
+
3. 「文件」页签：浏览工作区、打开文件、直接编辑保存（`Ctrl+S`）。
|
|
39
|
+
|
|
40
|
+
## 技术说明
|
|
30
41
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
| 鎸夐敭 | 鍔熻兘 |
|
|
34
|
-
| --- | --- |
|
|
35
|
-
| Ctrl+S | 淇濆瓨褰撳墠鏂囦欢 |
|
|
36
|
-
| Ctrl+D | 鍒囨崲 缂栬緫 / Diff 瑙嗗浘 |
|
|
42
|
+
- **Host**（`lib/index.js`）：监听 `session/event` 工具事件（`tool/call` ↔ `tool/result` 配对），对写文件工具即时读取并推送 before/after；递归文件监视 + mtime 轮询兜底；`/api/code-studio/*` REST + SSE。
|
|
43
|
+
- **Client**（`lib/client.js`）：浏览器 bundle，仅依赖 react；LCS 行级 Diff 引擎、语法高亮、按会话状态管理。
|
|
37
44
|
|
|
38
|
-
##
|
|
39
|
-
- Host锛歭ib/index.js 鈥?webServer.register 娉ㄥ唽 6 涓矾鐢憋紱fs.watch(recursive) + 1500ms mtime 杞锛涘姣忎釜鏂囦欢缁存姢鍩虹嚎蹇収锛屼粠鑰屼骇鍑虹簿纭殑 before/after銆?- Client锛歭ib/client.js 鈥?绾祻瑙堝櫒 bundle锛坵indow.__ModuleLoader__.load锛夛紝浠呬緷璧?react/react-dom锛涜嚜甯?LCS 琛岀骇 diff 寮曟搸涓庢牱寮忋€?- 璺緞瀹夊叏锛欰PI 浠呮帴鍙?loopback + 鍚屾簮鏍囪璇锋眰銆?
|
|
40
|
-
## 宸茬煡闄愬埗
|
|
45
|
+
## 已知限制
|
|
41
46
|
|
|
42
|
-
-
|
|
47
|
+
- 单文件 > 512KB 不读取内容（防浏览器卡顿）。
|
|
48
|
+
- 通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底（仍会捕获，可能有少量延迟）。
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@windypro-rourou/dsh-code-studio",
|
|
3
|
-
"description": "
|
|
4
|
-
"version": "0.1.
|
|
3
|
+
"description": "File-change monitor \u0026 code editor for the DSH Web UI: watch agent edits land as line-by-line diffs in real time, right beside your conversation, then view and edit any workspace file without leaving the browser.",
|
|
4
|
+
"version": "0.1.4",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
7
7
|
"types": "lib/types/index.d.ts",
|
|
@@ -43,7 +43,9 @@
|
|
|
43
43
|
},
|
|
44
44
|
"peerDependencies": {
|
|
45
45
|
"@deepseek-ai/cordis": "^4.0.1",
|
|
46
|
-
"react": "^18.2.0"
|
|
46
|
+
"react": "^18.2.0",
|
|
47
|
+
"@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
|
|
48
|
+
"@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8"
|
|
47
49
|
},
|
|
48
50
|
"files": [
|
|
49
51
|
"lib/**/*.js",
|