dsh-run2skill 0.5.0-alpha.3 → 0.5.0-alpha.6
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.en.md +52 -123
- package/README.md +52 -127
- package/THIRD_PARTY_NOTICES.md +1 -1
- package/assets/run2skill-logo.webp +0 -0
- package/lib/client.js +661 -431
- package/lib/index.d.ts +3 -1
- package/lib/index.js +98 -17
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +38 -32
package/README.en.md
CHANGED
|
@@ -1,169 +1,98 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="docs/assets/run2skill-hero.png" alt="Run2Skill — Teach once. Reuse the skill." width="1000" />
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
<p align="center"><strong>Turn today's lessons into tomorrow's skills.</strong></p>
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
<p align="center">
|
|
8
|
+
<a href="https://www.npmjs.com/package/dsh-run2skill"><img src="https://img.shields.io/npm/v/dsh-run2skill?color=247C78&label=npm" alt="npm version" /></a>
|
|
9
|
+
<a href="docs/compatibility.md"><img src="https://img.shields.io/badge/DSH_Web-0.2.2--rc.1-153B3C" alt="Supports DSH 0.2.2-rc.1 Web" /></a>
|
|
10
|
+
<a href="https://github.com/qkycir-123/dsh-run2skill/actions/workflows/ci.yml"><img src="https://github.com/qkycir-123/dsh-run2skill/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a>
|
|
11
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-EAB45C" alt="MIT license" /></a>
|
|
12
|
+
</p>
|
|
6
13
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
14
|
+
<p align="center">
|
|
15
|
+
<a href="#install">Install</a> · <a href="#see-the-complete-flow">Full flow</a> · <a href="docs/compatibility.md">Compatibility</a> · <a href="CHANGELOG.md">Changelog</a> · <a href="README.md">中文</a>
|
|
16
|
+
</p>
|
|
10
17
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
> You teach once while doing real work. Run2Skill prepares a Skill draft from the reusable parts. Nothing is saved until you approve it.
|
|
14
|
-
|
|
15
|
-
Run2Skill does not let an agent silently create permanent rules for itself. Every draft shows its source, intended scope, and complete content before you decide whether to save or discard it. Only an approved draft is written to DSH's native Skill directory.
|
|
16
|
-
|
|
17
|
-
> npm's default `latest` and `next` tags both point to the preview [`0.5.0-alpha.3`](https://www.npmjs.com/package/dsh-run2skill/v/0.5.0-alpha.3), for Windows x64 Desktop and Web on DSH `0.2.0-rc.2`. For DSH Web `0.1.7-rc.2`, install `0.5.0-alpha.2`; for DSH Web `0.1.2-rc.1`, install the stable [`0.4.0`](https://www.npmjs.com/package/dsh-run2skill/v/0.4.0) release.
|
|
18
|
-
|
|
19
|
-
`0.4.0` uses the Remote/API Gateway and browser-authentication contracts from DSH `0.1.2-rc.1`, and adapts its Session, Storage/Profile, Settings, and plugin-lifecycle changes. It supports only the retained built-in `standard` preset. Continue using `dsh-run2skill@0.3.1` with the older DSH `0.1.1-rc.2` line.
|
|
20
|
-
|
|
21
|
-
Low-noise learning status, **Synthesize this experience now**, revision requests that generate a new draft, and bounded preservation of important long-workflow evidence remain available. An immediate request still waits for the agent to stop and for complete facts, then follows the existing lookup, review, and publication safety gates. Internal batch counters are not shown in the settings page.
|
|
18
|
+
Run2Skill turns the corrections, constraints, and workflows you teach an Agent in DeepSeek Harness (DSH) into reusable Skills. Review a draft, request changes, and approve it to save.
|
|
22
19
|
|
|
23
20
|
## See the complete flow
|
|
24
21
|
|
|
25
|
-
|
|
23
|
+
|
|
24
|
+
*Main-branch interface · sample draft walkthrough*
|
|
26
25
|
|
|
27
|
-
1.
|
|
28
|
-
2.
|
|
29
|
-
3.
|
|
30
|
-
4.
|
|
26
|
+
1. Open **Sidebar → Plugins → Run2Skill**.
|
|
27
|
+
2. Review the draft’s purpose, scope, source conversation, and full content.
|
|
28
|
+
3. Request changes or **approve and save**.
|
|
29
|
+
4. Check **Recent activity**. The Skill is ready for a related task.
|
|
31
30
|
|
|
32
31
|
<details>
|
|
33
|
-
<summary>View
|
|
32
|
+
<summary>View key screens</summary>
|
|
34
33
|
|
|
35
|
-
|
|
36
35
|
|
|
37
|
-
|
|
38
37
|
|
|
39
|
-
|
|
40
39
|
|
|
41
40
|
</details>
|
|
42
41
|
|
|
43
42
|
## Install
|
|
44
43
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
`0.5.0-alpha.3` has passed Windows Desktop compatibility checks. On Windows Desktop, use the dsh command provided by **Manage dsh Command…**. Launch Desktop once to initialize it, quit completely, then install the plugin:
|
|
44
|
+
**Web (DSH 0.2.2-rc.1)**: install Node.js `>=24.9.0` and make sure `pnpm` and `dsh` are available. Install `0.5.0-alpha.6`:
|
|
48
45
|
|
|
49
46
|
```bash
|
|
50
|
-
dsh plugin --profile
|
|
47
|
+
dsh plugin --profile web add dsh-run2skill@0.5.0-alpha.6
|
|
51
48
|
```
|
|
52
49
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
### Web installation and older DSH versions
|
|
56
|
-
|
|
57
|
-
Check your DSH Web version, install Node.js `^22.19.0 || >=24.0.0`, and make sure both `dsh` and `pnpm` are available. For DSH `0.2.0-rc.2`, install the current npm default:
|
|
58
|
-
|
|
59
|
-
```bash
|
|
60
|
-
dsh plugin --profile web add dsh-run2skill
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
For DSH `0.1.7-rc.2`, use the matching release:
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
dsh plugin --profile web add dsh-run2skill@0.5.0-alpha.2
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
For DSH `0.1.2-rc.1`, continue using the stable release:
|
|
50
|
+
**Windows Desktop (DSH 0.2.0-rc.2)**: set up the command through **Manage dsh Command…**. Complete the first launch, exit the app, and install `0.5.0-alpha.4`:
|
|
70
51
|
|
|
71
52
|
```bash
|
|
72
|
-
dsh plugin --profile
|
|
53
|
+
dsh plugin --profile desktop add dsh-run2skill@0.5.0-alpha.4
|
|
73
54
|
```
|
|
74
55
|
|
|
75
|
-
Restart DSH
|
|
76
|
-
|
|
77
|
-
Run2Skill does not need a separate model key. When it analyzes a Skill draft, it uses the model already selected for the current DSH session. If the session has no available model, learning stops and reports the reason instead of silently switching providers.
|
|
78
|
-
|
|
79
|
-
## Use it while you work
|
|
80
|
-
|
|
81
|
-
Continue talking to DSH normally. For example:
|
|
82
|
-
|
|
83
|
-
```text
|
|
84
|
-
Save this workflow as a Skill so it can be reused later.
|
|
85
|
-
```
|
|
56
|
+
Restart DSH after installation. Run2Skill uses the model selected in the current session. See [Compatibility](docs/compatibility.md) for version details.
|
|
86
57
|
|
|
87
|
-
|
|
58
|
+
## Use
|
|
88
59
|
|
|
89
|
-
|
|
60
|
+
Work with your Agent as usual and describe the practices you want to reuse:
|
|
90
61
|
|
|
91
|
-
|
|
62
|
+
- **Correction**: “Write a failing test before changing the implementation.”
|
|
63
|
+
- **Constraint**: “Use Chinese for GitHub copy in this project.”
|
|
64
|
+
- **Workflow**: “Check the upstream version, then run compatibility checks.”
|
|
65
|
+
- **Save request**: “Save this workflow as a Skill for reuse.”
|
|
92
66
|
|
|
93
|
-
|
|
94
|
-
2. Review the draft, its intended scope, evidence, and complete content.
|
|
95
|
-
3. Approve and save it, request a revision, discard it, or retry a failed save.
|
|
96
|
-
4. After a successful save, it is an ordinary native DSH Skill and remains usable even if Run2Skill is later uninstalled.
|
|
67
|
+
Run2Skill organizes lessons when the session is idle or you request a save. DSH notifies you when a draft needs review. You can also open the plugin and choose **Organize this session now**.
|
|
97
68
|
|
|
98
|
-
|
|
69
|
+
Each draft includes its source conversation. Approve it, request changes, or discard it. Save Skills for the **current project** or **all projects**, using DSH’s default Skill directories.
|
|
99
70
|
|
|
100
|
-
|
|
71
|
+
## Settings
|
|
101
72
|
|
|
102
|
-
|
|
73
|
+
- **Automatic learning**: organize lessons from conversations automatically. When off, explicit “save as a Skill” requests still work.
|
|
74
|
+
- **Recent activity**: see Skills created or updated in the last seven days.
|
|
75
|
+
- **Clear all caches**: preview and clear pending drafts and intermediate data, keeping saved Skills, conversations, and DSH settings.
|
|
103
76
|
|
|
104
|
-
Run2Skill
|
|
105
|
-
|
|
106
|
-
- **Correction:** “Do not fix the implementation first; write a failing test.”
|
|
107
|
-
- **Durable constraint:** “All GitHub copy in this project must be written in Chinese.”
|
|
108
|
-
- **Workflow:** “Check the upstream version, run compatibility probes, then update the evidence.”
|
|
109
|
-
- **Explicit save request:** “Save this process as a Skill.”
|
|
110
|
-
|
|
111
|
-
It does not turn every successful agent action into a permanent rule. It learns what you clearly taught, rather than trying to guess your intent.
|
|
112
|
-
|
|
113
|
-
## You remain in control
|
|
114
|
-
|
|
115
|
-
You can turn **Automatic learning** off under **Settings → Plugins → Run2Skill**:
|
|
116
|
-
|
|
117
|
-
- On: explicit corrections, durable constraints, and workflows may produce Skill drafts.
|
|
118
|
-
- Off: ordinary automatic learning pauses, while an explicit “save this as a Skill” request still works.
|
|
119
|
-
|
|
120
|
-
Run2Skill is local-first. It does not store model keys or copy the whole session. Only the necessary, filtered, truncated, and redacted context is sent to the session's selected model for analysis. Every Skill draft requires your approval before it is saved.
|
|
121
|
-
|
|
122
|
-
The settings page also provides **Clear all cache**. It removes Run2Skill-owned intermediate cache, pending Skill drafts, failures, and non-sensitive diagnostics, but never removes:
|
|
123
|
-
|
|
124
|
-
- original DSH session records;
|
|
125
|
-
- already published native Skills;
|
|
126
|
-
- provider, agent, or other DSH settings.
|
|
127
|
-
|
|
128
|
-
See [Storage and upgrades](docs/storage-and-upgrades.md) for the detailed retention and migration rules.
|
|
77
|
+
Run2Skill manages drafts locally and sends selected, redacted conversation excerpts to the current model. See [Storage and upgrades](docs/storage-and-upgrades.md).
|
|
129
78
|
|
|
130
79
|
## Update and uninstall
|
|
131
80
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
```bash
|
|
135
|
-
dsh plugin --profile web add dsh-run2skill@<version>
|
|
136
|
-
```
|
|
81
|
+
Follow the installation instructions for your host version, then restart DSH.
|
|
137
82
|
|
|
138
83
|
Uninstall:
|
|
139
84
|
|
|
140
85
|
```bash
|
|
141
|
-
dsh plugin --profile
|
|
86
|
+
dsh plugin --profile desktop remove dsh-run2skill
|
|
142
87
|
```
|
|
143
88
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
## Troubleshooting
|
|
147
|
-
|
|
148
|
-
- **The Run2Skill tab is missing:** confirm that you use the DSH `web` profile and restarted DSH Web after installation.
|
|
149
|
-
- **“Run2Skill is currently limited” (`DEGRADED`):** do not manually delete storage files. Retry, then report the issue if the state persists.
|
|
150
|
-
- **“This Run2Skill version is incompatible” (`INCOMPATIBLE`):** verify your DSH version and restore a compatible Run2Skill version.
|
|
151
|
-
- **No Skill draft appears:** confirm that the current session has an available model, or say “Save this workflow as a Skill.”
|
|
152
|
-
- **A `PROJECT` draft cannot be saved:** the current session must belong to a project workspace recognized by DSH.
|
|
153
|
-
- **You changed DSH Skill storage:** the current release supports only the default storage and stops safely instead of guessing where to write.
|
|
154
|
-
|
|
155
|
-
Report problems through [GitHub Issues](https://github.com/qkycir-123/dsh-run2skill/issues). Do not attach keys, complete sessions, private paths, or logs containing sensitive information.
|
|
89
|
+
For Web, replace `desktop` with `web`. Saved Skills and plugin data remain after uninstalling. To clear caches, use the plugin’s cleanup action before uninstalling.
|
|
156
90
|
|
|
157
|
-
##
|
|
91
|
+
## Help and contribute
|
|
158
92
|
|
|
159
|
-
- [
|
|
160
|
-
- [
|
|
161
|
-
- [
|
|
162
|
-
- [Product requirements](docs/product/prd.md)
|
|
163
|
-
- [Architecture baseline](docs/architecture/baseline.md)
|
|
164
|
-
- [Design document index](docs/design/README.md)
|
|
165
|
-
- [Single-owner design for one Skill-save intent](docs/design/single-owner-skill-save.md)
|
|
166
|
-
- [Contributing](CONTRIBUTING.md)
|
|
167
|
-
- [Maintainer compatibility probes](probes/README.md)
|
|
93
|
+
- [Report an issue](https://github.com/qkycir-123/dsh-run2skill/issues)
|
|
94
|
+
- [Compatibility](docs/compatibility.md) · [Changelog](CHANGELOG.md)
|
|
95
|
+
- [Contributing](CONTRIBUTING.md) · [Maintainer probes](probes/README.md)
|
|
96
|
+
- [Product requirements](docs/product/prd.md) · [Architecture and design](docs/architecture/baseline.md)
|
|
168
97
|
|
|
169
|
-
|
|
98
|
+
[MIT License](LICENSE) · [Third-party licenses](THIRD_PARTY_NOTICES.md)
|
package/README.md
CHANGED
|
@@ -1,173 +1,98 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="docs/assets/run2skill-hero.png" alt="Run2Skill — Teach once. Reuse the skill." width="1000" />
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
<p align="center"><strong>把对话经验，变成下次可用的 Skill。</strong></p>
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
<p align="center">
|
|
8
|
+
<a href="https://www.npmjs.com/package/dsh-run2skill"><img src="https://img.shields.io/npm/v/dsh-run2skill?color=247C78&label=npm" alt="npm 版本" /></a>
|
|
9
|
+
<a href="docs/compatibility.md"><img src="https://img.shields.io/badge/DSH_Web-0.2.2--rc.1-153B3C" alt="支持 DSH 0.2.2-rc.1 Web" /></a>
|
|
10
|
+
<a href="https://github.com/qkycir-123/dsh-run2skill/actions/workflows/ci.yml"><img src="https://github.com/qkycir-123/dsh-run2skill/actions/workflows/ci.yml/badge.svg" alt="CI 状态" /></a>
|
|
11
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-EAB45C" alt="MIT 许可证" /></a>
|
|
12
|
+
</p>
|
|
6
13
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
14
|
+
<p align="center">
|
|
15
|
+
<a href="#安装">安装</a> · <a href="#看一遍完整流程">完整流程</a> · <a href="docs/compatibility.md">兼容性</a> · <a href="CHANGELOG.md">更新记录</a> · <a href="README.en.md">English</a>
|
|
16
|
+
</p>
|
|
10
17
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
> 把你在 DeepSeek Harness（DSH）里明确教给 Agent 的纠正、约束和工作流，整理成可审核、可复用的原生 Skill。
|
|
14
|
-
|
|
15
|
-
一句话说：**你负责在真实工作里教一次，run2skill 负责把值得复用的部分整理成技能草稿；你点头，它才落盘。**
|
|
16
|
-
|
|
17
|
-
它不会让 Agent 偷偷给自己立规矩。每份技能草稿都可以先看来源、适用范围和完整内容，然后由你决定确认保存还是放弃草稿。只有确认后，它才会写入 DSH 的原生 Skill 目录。
|
|
18
|
-
|
|
19
|
-
> npm 默认 `latest` 与 `next` 均指向预发布版 [`0.5.0-alpha.3`](https://www.npmjs.com/package/dsh-run2skill/v/0.5.0-alpha.3)，支持 DSH `0.2.0-rc.2` 的 Windows x64 Desktop 和同版本 Web。DSH Web `0.1.7-rc.2` 请安装 `0.5.0-alpha.2`；DSH Web `0.1.2-rc.1` 请安装稳定版 [`0.4.0`](https://www.npmjs.com/package/dsh-run2skill/v/0.4.0)。
|
|
20
|
-
|
|
21
|
-
`0.4.0` 改用 DSH `0.1.2-rc.1` 的 Remote/API Gateway 与浏览器认证契约，并适配 Session、Storage/Profile、Settings 和插件生命周期变化。它只支持 RC1 保留的内置 `standard` preset；使用旧 DSH `0.1.1-rc.2` 时请继续安装 `dsh-run2skill@0.3.1`。
|
|
22
|
-
|
|
23
|
-
低噪声整理状态、“立即整理本次经验”、按意见生成新版草稿，以及长工作流关键证据保留继续保留。“立即整理”仍会等待 Agent 停止运行和事实完整，并继续经过查重、审核与发布安全门；设置页不会展示内部批次计数。
|
|
18
|
+
Run2Skill 把你在 DeepSeek Harness（DSH）里教给 Agent 的纠正、约束和工作流，整理成可复用的 Skill。你查看草稿、提出修改意见，确认后保存。
|
|
24
19
|
|
|
25
20
|
## 看一遍完整流程
|
|
26
21
|
|
|
27
|
-
|
|
23
|
+
|
|
24
|
+
*main 分支界面 · 示例草稿演示*
|
|
28
25
|
|
|
29
|
-
1.
|
|
30
|
-
2.
|
|
31
|
-
3.
|
|
32
|
-
4.
|
|
26
|
+
1. 打开 **左侧栏 → 插件 → Run2Skill**。
|
|
27
|
+
2. 查看草稿的用途、适用范围、对话来源和完整内容。
|
|
28
|
+
3. 按需提出修改意见，或直接**确认并保存**。
|
|
29
|
+
4. 在**最近活动**中查看结果，下次相关任务即可使用这个 Skill。
|
|
33
30
|
|
|
34
31
|
<details>
|
|
35
|
-
<summary
|
|
32
|
+
<summary>查看关键界面</summary>
|
|
36
33
|
|
|
37
|
-
|
|
38
35
|
|
|
39
|
-
|
|
40
37
|
|
|
41
|
-
|
|
42
39
|
|
|
43
40
|
</details>
|
|
44
41
|
|
|
45
42
|
## 安装
|
|
46
43
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
`0.5.0-alpha.3` 已完成 Windows 桌面兼容验收。Windows Desktop 使用应用 **Manage dsh Command…** 提供的 dsh 命令。首次启动初始化后完全退出，再安装插件：
|
|
44
|
+
**Web（DSH 0.2.2-rc.1）**：准备好 Node.js `>=24.9.0`、`pnpm` 和 `dsh` 命令，安装 `0.5.0-alpha.6`：
|
|
50
45
|
|
|
51
46
|
```bash
|
|
52
|
-
dsh plugin --profile
|
|
47
|
+
dsh plugin --profile web add dsh-run2skill@0.5.0-alpha.6
|
|
53
48
|
```
|
|
54
49
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
### Web 安装与旧版 DSH
|
|
58
|
-
|
|
59
|
-
先确认你使用的 DSH Web 版本，已经安装 Node.js `^22.19.0 || >=24.0.0`，并能在终端运行 `dsh` 和 `pnpm`。DSH `0.2.0-rc.2` 安装当前 npm 默认版本：
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
dsh plugin --profile web add dsh-run2skill
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
DSH `0.1.7-rc.2` 使用对应版本：
|
|
66
|
-
|
|
67
|
-
```bash
|
|
68
|
-
dsh plugin --profile web add dsh-run2skill@0.5.0-alpha.2
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
DSH `0.1.2-rc.1` 继续安装稳定版：
|
|
50
|
+
**Windows Desktop（DSH 0.2.0-rc.2）**：通过 **Manage dsh Command…** 配置命令，完成首次启动后退出应用，安装 `0.5.0-alpha.4`：
|
|
72
51
|
|
|
73
52
|
```bash
|
|
74
|
-
dsh plugin --profile
|
|
53
|
+
dsh plugin --profile desktop add dsh-run2skill@0.5.0-alpha.4
|
|
75
54
|
```
|
|
76
55
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
run2skill 不需要单独填写模型密钥。需要分析技能草稿时，它沿用当前 DSH 会话已经选择的模型；如果当前会话没有可用模型，学习会停止并显示原因，不会偷偷换用其他模型。
|
|
80
|
-
|
|
81
|
-
## 用法：你继续干活，它负责记笔记
|
|
82
|
-
|
|
83
|
-
平时照常和 DSH 对话即可。例如：
|
|
84
|
-
|
|
85
|
-
```text
|
|
86
|
-
把这个流程保存成 Skill，以后可以复用。
|
|
87
|
-
```
|
|
56
|
+
安装后重启 DSH。Run2Skill 使用当前会话选择的模型。版本信息见 [兼容性](docs/compatibility.md)。
|
|
88
57
|
|
|
89
|
-
|
|
58
|
+
## 使用
|
|
90
59
|
|
|
91
|
-
|
|
60
|
+
照常与 Agent 工作，把值得复用的做法说清楚：
|
|
92
61
|
|
|
93
|
-
|
|
62
|
+
- **纠正**：“先写失败测试，再修实现。”
|
|
63
|
+
- **约束**：“这个项目的 GitHub 文案统一用中文。”
|
|
64
|
+
- **工作流**：“先核对上游版本，再运行兼容性检查。”
|
|
65
|
+
- **保存请求**：“把这个流程保存成 Skill，以后复用。”
|
|
94
66
|
|
|
95
|
-
|
|
96
|
-
2. 在待处理列表中查看技能草稿、适用范围和内容差异。
|
|
97
|
-
3. 选择确认并保存、要求修改、放弃草稿，或在保存失败后重试。
|
|
98
|
-
4. 保存成功后，结果就是普通的 DSH 原生 Skill；即使以后卸载 run2skill，它仍然可以被 DSH 使用。
|
|
67
|
+
Run2Skill 在会话空闲或收到保存请求时整理经验。有草稿需要审核时，DSH 会通知你。也可以打开插件页，点击**立即整理本次经验**。
|
|
99
68
|
|
|
100
|
-
|
|
69
|
+
每份草稿都附有对话来源。你可以确认保存、要求修改，或放弃草稿。Skill 支持保存到**当前项目**或**所有项目**，使用 DSH 默认的 Skill 目录。
|
|
101
70
|
|
|
102
|
-
|
|
71
|
+
## 设置
|
|
103
72
|
|
|
104
|
-
|
|
73
|
+
- **自动学习**：自动从对话中整理经验；关闭后仍可明确请求“保存为 Skill”。
|
|
74
|
+
- **最近活动**：查看最近 7 天新建或更新的 Skill。
|
|
75
|
+
- **清理所有缓存**：预览并清理待处理草稿与中间缓存，保留已保存的 Skill、会话记录和 DSH 设置。
|
|
105
76
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
- **纠正**：“不要直接修实现，先写失败测试。”
|
|
109
|
-
- **长期约束**：“这个项目的所有 GitHub 文案都使用中文。”
|
|
110
|
-
- **工作流**：“先核对上游版本，再跑兼容性探针，最后更新证据。”
|
|
111
|
-
- **显式保存请求**：“把这个流程保存成 Skill。”
|
|
112
|
-
|
|
113
|
-
它不会因为 Agent 偶尔成功一次，就自作主张地把所有操作写成永久规则。它学的是你明确教过的东西，不是猜你的心思。
|
|
114
|
-
|
|
115
|
-
## 你仍然握着方向盘
|
|
116
|
-
|
|
117
|
-
在 **Settings → Plugins → run2skill** 中可以关闭**自动学习**：
|
|
118
|
-
|
|
119
|
-
- 开启：明确的纠正、长期约束和工作流可以生成技能草稿。
|
|
120
|
-
- 关闭：暂停普通自动学习；你明确说“保存为 Skill”时仍然可以生成技能草稿。
|
|
121
|
-
|
|
122
|
-
run2skill 是本地优先插件。它不会保存模型密钥，也不会复制完整会话；送去模型分析的只是经过筛选、截断和敏感信息清理的必要内容。技能草稿保存前始终需要你确认。
|
|
123
|
-
|
|
124
|
-
换句话说：run2skill 可以帮你整理经验，但不会替你签字。
|
|
125
|
-
|
|
126
|
-
设置页也提供**清理所有缓存**功能。它会删除 Run2Skill 自己产生的中间缓存、待处理技能草稿、失败与非敏感诊断记录，但不会删除：
|
|
127
|
-
|
|
128
|
-
- DSH 的原始会话记录；
|
|
129
|
-
- 已发布的原生 Skill；
|
|
130
|
-
- Provider、Agent 或其他 DSH 设置。
|
|
131
|
-
|
|
132
|
-
更详细的保留与升级规则见 [数据存储与升级](docs/storage-and-upgrades.md)。
|
|
77
|
+
Run2Skill 在本地管理草稿，并将经过筛选和脱敏的必要对话片段交给当前模型分析。详见 [数据存储与升级](docs/storage-and-upgrades.md)。
|
|
133
78
|
|
|
134
79
|
## 更新与卸载
|
|
135
80
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
```bash
|
|
139
|
-
dsh plugin --profile web add dsh-run2skill@<version>
|
|
140
|
-
```
|
|
81
|
+
按上方安装说明选择与宿主匹配的版本，安装后重启 DSH。
|
|
141
82
|
|
|
142
83
|
卸载：
|
|
143
84
|
|
|
144
85
|
```bash
|
|
145
|
-
dsh plugin --profile
|
|
86
|
+
dsh plugin --profile desktop remove dsh-run2skill
|
|
146
87
|
```
|
|
147
88
|
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
## 遇到问题
|
|
151
|
-
|
|
152
|
-
- **看不到 run2skill 卡片**：确认使用的是 DSH `web` profile，并在安装后重启了 DSH Web。
|
|
153
|
-
- **提示“run2skill 当前功能受限”**（内部状态码：`DEGRADED`）：不要手工删除存储文件；重试后仍无法恢复时，可在 GitHub Issues 报告。
|
|
154
|
-
- **提示“run2skill 当前版本不兼容”**（内部状态码：`INCOMPATIBLE`）：确认 DSH 是否为受支持版本，再恢复与它兼容的 run2skill 版本。
|
|
155
|
-
- **没有生成技能草稿**：确认当前会话有可用模型；也可以直接说“把这个流程保存成 Skill”。
|
|
156
|
-
- **无法保存到当前项目**（`PROJECT`）：当前会话必须位于 DSH 能识别的项目工作区。
|
|
157
|
-
- **改过 Skill 的存储目录或存储方式**：当前版本只支持 DSH 默认设置，会选择安全停止，不会猜测写入位置。
|
|
158
|
-
|
|
159
|
-
欢迎在 [GitHub Issues](https://github.com/qkycir-123/dsh-run2skill/issues) 报告问题。请不要附上密钥、完整 Session、私人路径或包含敏感信息的日志。
|
|
89
|
+
Web 用户将 `desktop` 换成 `web`。卸载后已保存的 Skill 和插件数据继续保留；需要清理缓存时，可在卸载前使用插件页的清理功能。
|
|
160
90
|
|
|
161
|
-
##
|
|
91
|
+
## 帮助与贡献
|
|
162
92
|
|
|
163
|
-
- [
|
|
164
|
-
- [
|
|
165
|
-
- [
|
|
166
|
-
- [产品需求](docs/product/prd.md)
|
|
167
|
-
- [架构基线](docs/architecture/baseline.md)
|
|
168
|
-
- [设计文档索引](docs/design/README.md)
|
|
169
|
-
- [同一 Skill 保存意图的单一生成所有者设计](docs/design/single-owner-skill-save.md)
|
|
170
|
-
- [贡献指南](CONTRIBUTING.md)
|
|
171
|
-
- [维护者兼容性探针](probes/README.md)
|
|
93
|
+
- [报告问题](https://github.com/qkycir-123/dsh-run2skill/issues)
|
|
94
|
+
- [兼容性](docs/compatibility.md) · [更新记录](CHANGELOG.md)
|
|
95
|
+
- [贡献指南](CONTRIBUTING.md) · [维护者探针](probes/README.md)
|
|
96
|
+
- [产品需求](docs/product/prd.md) · [架构与设计](docs/architecture/baseline.md)
|
|
172
97
|
|
|
173
|
-
|
|
98
|
+
[MIT License](LICENSE) · [第三方许可](THIRD_PARTY_NOTICES.md)
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
Binary file
|