dsh-run2skill 0.5.0-alpha.2 → 0.5.0-alpha.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.en.md CHANGED
@@ -1,151 +1,104 @@
1
- # dsh-run2skill
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
- [中文](README.md) | English
5
+ <p align="center"><strong>Turn today's lessons into tomorrow's skills.</strong></p>
4
6
 
5
- Have you run into any of these situations?
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&amp;label=npm" alt="npm version" /></a>
9
+ <a href="docs/compatibility.md"><img src="https://img.shields.io/badge/DSH-0.2.0--rc.2-153B3C" alt="Supports DSH 0.2.0-rc.2" /></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
- - You teach an agent the same workflow today, then teach it again in a new session tomorrow.
8
- - You keep correcting the agent step by step: “Do not edit that file,” “write the test first,” or “this check is required.”
9
- - The agent finally learns the right approach, but the lesson disappears when the conversation ends.
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
- `dsh-run2skill` turns the corrections, constraints, and workflows you explicitly teach a DeepSeek Harness (DSH) agent into reviewable, reusable native Skills.
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
- > The current stable release is [`0.4.0`](https://www.npmjs.com/package/dsh-run2skill/v/0.4.0), for DSH Web `0.1.2-rc.1` only. The `0.5.0-alpha.2` preview is available under npm's `next` tag for DSH Web `0.1.7-rc.2` only.
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
- ![Real DSH Web flow from a pending Run2Skill draft through human review to a successfully saved Skill](docs/assets/run2skill-demo.gif)
22
+ ![Run2Skill: open the plugin, review a draft, and save](docs/assets/run2skill-demo.gif)
23
+
24
+ *Main-branch interface · sample draft walkthrough*
26
25
 
27
- 1. **Find the draft** — Run2Skill only notifies you when action is required and places the draft under **Settings → Plugins → Run2Skill**.
28
- 2. **Review its evidence and scope** — inspect the rationale, filtered conversation evidence, target scope, and the complete `SKILL.md` that would be written.
29
- 3. **Request a revision if needed** — leave one short instruction and Run2Skill generates a new complete draft; the old version is not published and the new one still needs review.
30
- 4. **Save only after approval** — successful results appear under Recent activity and remain ordinary native DSH Skills.
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 the three key screenshots</summary>
32
+ <summary>View key screens</summary>
34
33
 
35
- ![A pending Skill draft in the Run2Skill settings page](docs/assets/01-proposal-inbox.png)
34
+ ![Draft inbox](docs/assets/01-proposal-inbox.png)
36
35
 
37
- ![Evidence, target scope, and review content for a Run2Skill Skill draft](docs/assets/02-review-details.png)
36
+ ![Draft sources and content](docs/assets/02-review-details.png)
38
37
 
39
- ![A successfully created native Skill shown in Run2Skill Recent activity](docs/assets/03-saved-activity.png)
38
+ ![Saved Skill and recent activity](docs/assets/03-saved-activity.png)
40
39
 
41
40
  </details>
42
41
 
43
42
  ## Install
44
43
 
45
- 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.1.7-rc.2`, install the preview:
46
-
47
- ```bash
48
- dsh plugin --profile web add dsh-run2skill@0.5.0-alpha.2
49
- ```
50
-
51
- For DSH `0.1.2-rc.1`, continue using the stable release:
44
+ Supports DSH **0.2.0-rc.2** on Windows Desktop and Web.
45
+
46
+ **Desktop**: set up the command through **Manage dsh Command…** in the app. Complete the first launch, exit the app, and run:
52
47
 
53
48
  ```bash
54
- dsh plugin --profile web add dsh-run2skill@0.4.0
49
+ dsh plugin --profile desktop add dsh-run2skill
55
50
  ```
56
51
 
57
- Restart DSH Web. Open **Settings → Plugins**; the plugin is loaded when the **Run2Skill** tab appears.
58
-
59
- 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.
60
-
61
- ## Use it while you work
52
+ **Web**: install Node.js `^22.19.0 || >=24.0.0` and make sure `pnpm` and `dsh` are available. Then run:
62
53
 
63
- Continue talking to DSH normally. For example:
64
-
65
- ```text
66
- Save this workflow as a Skill so it can be reused later.
54
+ ```bash
55
+ dsh plugin --profile web add dsh-run2skill
67
56
  ```
68
57
 
69
- You can also give an explicit correction, describe a durable constraint, or teach a reusable ordered workflow during ordinary work. You do not need to stop and manually reconstruct a `SKILL.md` file.
58
+ Restart DSH after installation. Run2Skill uses the model selected in the current session. See [Compatibility](docs/compatibility.md) for version details.
70
59
 
71
- After each conversation turn, Run2Skill records only low-cost observations; it does not call a model to review every turn. Batch detection runs at bounded batch boundaries, when the session becomes idle, or when you explicitly request saving or immediate synthesis. Only reusable experience proceeds to Skill lookup and draft generation.
60
+ ## Use
72
61
 
73
- When something needs your attention, DSH shows one native notification. To review a draft:
62
+ Work with your Agent as usual and describe the practices you want to reuse:
74
63
 
75
- 1. Open **Settings → Plugins → Run2Skill**.
76
- 2. Review the draft, its intended scope, evidence, and complete content.
77
- 3. Approve and save it, request a revision, discard it, or retry a failed save.
78
- 4. After a successful save, it is an ordinary native DSH Skill and remains usable even if Run2Skill is later uninstalled.
64
+ - **Correction**: “Write a failing test before changing the implementation.”
65
+ - **Constraint**: “Use Chinese for GitHub copy in this project.”
66
+ - **Workflow**: “Check the upstream version, then run compatibility checks.”
67
+ - **Save request**: “Save this workflow as a Skill for reuse.”
79
68
 
80
- If a draft is not right, submit one revision request of at most 2,048 UTF-8 bytes. The Host uses the current complete draft to generate a new immutable version, records the parent/child relationship, and invalidates the old approval. You must inspect and approve the new version. This is not a free-form editor and does not bypass lookup, human review, or safe publication.
69
+ 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**.
81
70
 
82
- Drafts can target the current project (`PROJECT`) or the current user (`USER`). The current release writes only to DSH's default Skill storage. If you replace or disable that storage, Run2Skill stops safely instead of guessing a path.
71
+ 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.
83
72
 
84
- ## What it learns
73
+ ## Settings
85
74
 
86
- Run2Skill focuses on reusable experience that you state explicitly:
75
+ - **Automatic learning**: organize lessons from conversations automatically. When off, explicit “save as a Skill” requests still work.
76
+ - **Recent activity**: see Skills created or updated in the last seven days.
77
+ - **Clear all caches**: preview and clear pending drafts and intermediate data, keeping saved Skills, conversations, and DSH settings.
87
78
 
88
- - **Correction:** “Do not fix the implementation first; write a failing test.”
89
- - **Durable constraint:** “All GitHub copy in this project must be written in Chinese.”
90
- - **Workflow:** “Check the upstream version, run compatibility probes, then update the evidence.”
91
- - **Explicit save request:** “Save this process as a Skill.”
92
-
93
- 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.
94
-
95
- ## You remain in control
96
-
97
- You can turn **Automatic learning** off under **Settings → Plugins → Run2Skill**:
98
-
99
- - On: explicit corrections, durable constraints, and workflows may produce Skill drafts.
100
- - Off: ordinary automatic learning pauses, while an explicit “save this as a Skill” request still works.
101
-
102
- 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.
103
-
104
- 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:
105
-
106
- - original DSH session records;
107
- - already published native Skills;
108
- - provider, agent, or other DSH settings.
109
-
110
- See [Storage and upgrades](docs/storage-and-upgrades.md) for the detailed retention and migration rules.
79
+ Run2Skill manages drafts locally and sends selected, redacted conversation excerpts to the current model. See [Storage and upgrades](docs/storage-and-upgrades.md).
111
80
 
112
81
  ## Update and uninstall
113
82
 
114
- Install another explicit version:
83
+ Update, then restart DSH:
115
84
 
116
85
  ```bash
117
- dsh plugin --profile web add dsh-run2skill@<version>
86
+ dsh plugin --profile desktop add dsh-run2skill
118
87
  ```
119
88
 
120
89
  Uninstall:
121
90
 
122
91
  ```bash
123
- dsh plugin --profile web remove dsh-run2skill
92
+ dsh plugin --profile desktop remove dsh-run2skill
124
93
  ```
125
94
 
126
- Restart DSH Web after either command. Uninstalling does not delete published Skills and keeps Run2Skill data by default. Use **Clear all cache** on the settings page before uninstalling if you want to remove that data.
127
-
128
- ## Troubleshooting
129
-
130
- - **The Run2Skill tab is missing:** confirm that you use the DSH `web` profile and restarted DSH Web after installation.
131
- - **“Run2Skill is currently limited” (`DEGRADED`):** do not manually delete storage files. Retry, then report the issue if the state persists.
132
- - **“This Run2Skill version is incompatible” (`INCOMPATIBLE`):** verify your DSH version and restore a compatible Run2Skill version.
133
- - **No Skill draft appears:** confirm that the current session has an available model, or say “Save this workflow as a Skill.”
134
- - **A `PROJECT` draft cannot be saved:** the current session must belong to a project workspace recognized by DSH.
135
- - **You changed DSH Skill storage:** the current release supports only the default storage and stops safely instead of guessing where to write.
136
-
137
- 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.
95
+ 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.
138
96
 
139
- ## Learn more
97
+ ## Help and contribute
140
98
 
141
- - [Changelog](CHANGELOG.md)
142
- - [DSH compatibility](docs/compatibility.md)
143
- - [Storage and upgrades](docs/storage-and-upgrades.md)
144
- - [Product requirements](docs/product/prd.md)
145
- - [Architecture baseline](docs/architecture/baseline.md)
146
- - [Design document index](docs/design/README.md)
147
- - [Single-owner design for one Skill-save intent](docs/design/single-owner-skill-save.md)
148
- - [Contributing](CONTRIBUTING.md)
149
- - [Maintainer compatibility probes](probes/README.md)
99
+ - [Report an issue](https://github.com/qkycir-123/dsh-run2skill/issues)
100
+ - [Compatibility](docs/compatibility.md) · [Changelog](CHANGELOG.md)
101
+ - [Contributing](CONTRIBUTING.md) · [Maintainer probes](probes/README.md)
102
+ - [Product requirements](docs/product/prd.md) · [Architecture and design](docs/architecture/baseline.md)
150
103
 
151
- This project is licensed under the [MIT License](LICENSE). Licenses for dependencies embedded in the client bundle are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
104
+ [MIT License](LICENSE) · [Third-party licenses](THIRD_PARTY_NOTICES.md)
package/README.md CHANGED
@@ -1,155 +1,104 @@
1
- # dsh-run2skill
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
- 中文 | [English](README.en.md)
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&amp;label=npm" alt="npm 版本" /></a>
9
+ <a href="docs/compatibility.md"><img src="https://img.shields.io/badge/DSH-0.2.0--rc.2-153B3C" alt="支持 DSH 0.2.0-rc.2" /></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
- - 同一套工作流,今天教 Agent 一遍,明天换个 Session 又教一遍;
8
- - Agent 每走一步都需要你纠正:“别改那个文件”“先跑测试”“这个步骤不能省”;
9
- - 终于把 Agent 教会了,对话一结束,经验也跟着下班了。
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
- 如果你已经受够了在对话框里重复当师傅,`dsh-run2skill` 就是来做这件事的:
12
-
13
- > 把你在 DeepSeek Harness(DSH)里明确教给 Agent 的纠正、约束和工作流,整理成可审核、可复用的原生 Skill。
14
-
15
- 一句话说:**你负责在真实工作里教一次,run2skill 负责把值得复用的部分整理成技能草稿;你点头,它才落盘。**
16
-
17
- 它不会让 Agent 偷偷给自己立规矩。每份技能草稿都可以先看来源、适用范围和完整内容,然后由你决定确认保存还是放弃草稿。只有确认后,它才会写入 DSH 的原生 Skill 目录。
18
-
19
- > 当前稳定版为 [`0.4.0`](https://www.npmjs.com/package/dsh-run2skill/v/0.4.0),仅支持 DSH Web `0.1.2-rc.1`。`0.5.0-alpha.2` 通过 npm `next` 标签提供预览,仅支持 DSH Web `0.1.7-rc.2`。
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
- ![Run2Skill 从待审核技能草稿、人工核对到成功沉淀的真实 DSH Web 流程](docs/assets/run2skill-demo.gif)
22
+ ![Run2Skill:打开插件、审核草稿、确认保存](docs/assets/run2skill-demo.gif)
28
23
 
29
- 1. **发现技能草稿**:Run2Skill 只在有事项需要处理时提醒你,并把草稿放在 **设置 → 插件 → Run2Skill**。
30
- 2. **核对来源与范围**:查看生成理由、经过过滤的对话证据、保存范围以及将要写入的完整 `SKILL.md`。
31
- 3. **不满意就要求修改**:写一条简短意见,Run2Skill 会生成新的完整草稿;旧版本不会直接发布,新版本仍需你审核。
32
- 4. **确认后才保存**:成功结果会进入“最近活动”;保存下来的内容是普通的 DSH 原生 Skill。
24
+ *main 分支界面 · 示例草稿演示*
25
+
26
+ 1. 打开 **左侧栏 → 插件 → Run2Skill**。
27
+ 2. 查看草稿的用途、适用范围、对话来源和完整内容。
28
+ 3. 按需提出修改意见,或直接**确认并保存**。
29
+ 4. 在**最近活动**中查看结果,下次相关任务即可使用这个 Skill。
33
30
 
34
31
  <details>
35
- <summary>查看三张关键界面截图</summary>
32
+ <summary>查看关键界面</summary>
36
33
 
37
- ![Run2Skill 设置页中的待审核技能草稿](docs/assets/01-proposal-inbox.png)
34
+ ![待审核草稿](docs/assets/01-proposal-inbox.png)
38
35
 
39
- ![Run2Skill 技能草稿的来源、保存范围与审核内容](docs/assets/02-review-details.png)
36
+ ![草稿来源与内容](docs/assets/02-review-details.png)
40
37
 
41
- ![Run2Skill 最近活动中显示已经成功创建的原生 Skill](docs/assets/03-saved-activity.png)
38
+ ![保存结果与最近活动](docs/assets/03-saved-activity.png)
42
39
 
43
40
  </details>
44
41
 
45
42
  ## 安装
46
43
 
47
- 先确认你使用的 DSH Web 版本,已经安装 Node.js `^22.19.0 || >=24.0.0`,并能在终端运行 `dsh` 和 `pnpm`。DSH `0.1.7-rc.2` 安装预发布版:
48
-
49
- ```bash
50
- dsh plugin --profile web add dsh-run2skill@0.5.0-alpha.2
51
- ```
52
-
53
- DSH `0.1.2-rc.1` 继续安装稳定版:
44
+ 适用于 DSH **0.2.0-rc.2** 的 Windows Desktop 和 Web。
45
+
46
+ **Desktop**:在应用中通过 **Manage dsh Command…** 配置命令,完成首次启动后退出应用,再运行:
54
47
 
55
48
  ```bash
56
- dsh plugin --profile web add dsh-run2skill@0.4.0
49
+ dsh plugin --profile desktop add dsh-run2skill
57
50
  ```
58
51
 
59
- 重启 DSH Web。打开 **Settings → Plugins**,看到 **run2skill** 卡片就说明插件已加载。
60
-
61
- run2skill 不需要单独填写模型密钥。需要分析技能草稿时,它沿用当前 DSH 会话已经选择的模型;如果当前会话没有可用模型,学习会停止并显示原因,不会偷偷换用其他模型。
52
+ **Web**:准备好 Node.js `^22.19.0 || >=24.0.0`、`pnpm` 和 `dsh` 命令,再运行:
62
53
 
63
- ## 用法:你继续干活,它负责记笔记
64
-
65
- 平时照常和 DSH 对话即可。例如:
66
-
67
- ```text
68
- 把这个流程保存成 Skill,以后可以复用。
54
+ ```bash
55
+ dsh plugin --profile web add dsh-run2skill
69
56
  ```
70
57
 
71
- 你也可以在正常工作中明确纠正做法、说明长期约束,或给出有顺序的可复用流程。不用为了“教它”停下当前任务,也不用自己打开 `SKILL.md` 边回忆边编辑。
58
+ 安装后重启 DSH。Run2Skill 使用当前会话选择的模型。版本信息见 [兼容性](docs/compatibility.md)。
72
59
 
73
- run2skill 会在每轮对话完成后只做低成本记录,不会每轮调用模型复盘。到达有界批次边界、会话进入空闲,或你明确请求保存/立即整理时,才会触发一次批次检测;只有检测到可复用经验,才继续查重和技能草稿生成。
60
+ ## 使用
74
61
 
75
- 当有需要你处理的事项时,DSH 会显示一条原生通知;平时页面顶部不会常驻 run2skill 状态框。处理技能草稿时:
62
+ 照常与 Agent 工作,把值得复用的做法说清楚:
76
63
 
77
- 1. 打开 **Settings → Plugins → run2skill**。
78
- 2. 在待处理列表中查看技能草稿、适用范围和内容差异。
79
- 3. 选择确认并保存、要求修改、放弃草稿,或在保存失败后重试。
80
- 4. 保存成功后,结果就是普通的 DSH 原生 Skill;即使以后卸载 run2skill,它仍然可以被 DSH 使用。
64
+ - **纠正**:“先写失败测试,再修实现。”
65
+ - **约束**:“这个项目的 GitHub 文案统一用中文。”
66
+ - **工作流**:“先核对上游版本,再运行兼容性检查。”
67
+ - **保存请求**:“把这个流程保存成 Skill,以后复用。”
81
68
 
82
- 如果草稿不合适,可以先写一条不超过 2048 UTF-8 字节的修改意见。Host 会基于当前完整草稿生成新的不可变版本,保留父子版本关系并让旧批准失效;你必须重新查看并确认新版本。这个入口不是自由编辑器,也不会绕过查重、人工审核或安全发布。
69
+ Run2Skill 在会话空闲或收到保存请求时整理经验。有草稿需要审核时,DSH 会通知你。也可以打开插件页,点击**立即整理本次经验**。
83
70
 
84
- 技能草稿可以保存到当前项目(`PROJECT`)或当前用户(`USER`)范围。当前版本只会写入 DSH 默认的 Skill 存储目录;如果你改过 Skill 的存储方式或关闭了默认目录,run2skill 会停止保存,不会猜测写入位置。
71
+ 每份草稿都附有对话来源。你可以确认保存、要求修改,或放弃草稿。Skill 支持保存到**当前项目**或**所有项目**,使用 DSH 默认的 Skill 目录。
85
72
 
86
- ## 它会学什么
73
+ ## 设置
87
74
 
88
- run2skill 目前专注于你**明确表达**的可复用经验:
75
+ - **自动学习**:自动从对话中整理经验;关闭后仍可明确请求“保存为 Skill”。
76
+ - **最近活动**:查看最近 7 天新建或更新的 Skill。
77
+ - **清理所有缓存**:预览并清理待处理草稿与中间缓存,保留已保存的 Skill、会话记录和 DSH 设置。
89
78
 
90
- - **纠正**:“不要直接修实现,先写失败测试。”
91
- - **长期约束**:“这个项目的所有 GitHub 文案都使用中文。”
92
- - **工作流**:“先核对上游版本,再跑兼容性探针,最后更新证据。”
93
- - **显式保存请求**:“把这个流程保存成 Skill。”
94
-
95
- 它不会因为 Agent 偶尔成功一次,就自作主张地把所有操作写成永久规则。它学的是你明确教过的东西,不是猜你的心思。
96
-
97
- ## 你仍然握着方向盘
98
-
99
- 在 **Settings → Plugins → run2skill** 中可以关闭**自动学习**:
100
-
101
- - 开启:明确的纠正、长期约束和工作流可以生成技能草稿。
102
- - 关闭:暂停普通自动学习;你明确说“保存为 Skill”时仍然可以生成技能草稿。
103
-
104
- run2skill 是本地优先插件。它不会保存模型密钥,也不会复制完整会话;送去模型分析的只是经过筛选、截断和敏感信息清理的必要内容。技能草稿保存前始终需要你确认。
105
-
106
- 换句话说:run2skill 可以帮你整理经验,但不会替你签字。
107
-
108
- 设置页也提供**清理所有缓存**功能。它会删除 Run2Skill 自己产生的中间缓存、待处理技能草稿、失败与非敏感诊断记录,但不会删除:
109
-
110
- - DSH 的原始会话记录;
111
- - 已发布的原生 Skill;
112
- - Provider、Agent 或其他 DSH 设置。
113
-
114
- 更详细的保留与升级规则见 [数据存储与升级](docs/storage-and-upgrades.md)。
79
+ Run2Skill 在本地管理草稿,并将经过筛选和脱敏的必要对话片段交给当前模型分析。详见 [数据存储与升级](docs/storage-and-upgrades.md)。
115
80
 
116
81
  ## 更新与卸载
117
82
 
118
- 更新到另一个明确版本:
83
+ 更新后重启 DSH:
119
84
 
120
85
  ```bash
121
- dsh plugin --profile web add dsh-run2skill@<version>
86
+ dsh plugin --profile desktop add dsh-run2skill
122
87
  ```
123
88
 
124
89
  卸载:
125
90
 
126
91
  ```bash
127
- dsh plugin --profile web remove dsh-run2skill
92
+ dsh plugin --profile desktop remove dsh-run2skill
128
93
  ```
129
94
 
130
- 两种操作后都请重启 DSH Web。卸载不会删除已经发布的 Skill,也默认保留 run2skill 的数据;如果你希望清除这些数据,请在卸载前先使用设置页中的**清理所有缓存**。
131
-
132
- ## 遇到问题
133
-
134
- - **看不到 run2skill 卡片**:确认使用的是 DSH `web` profile,并在安装后重启了 DSH Web。
135
- - **提示“run2skill 当前功能受限”**(内部状态码:`DEGRADED`):不要手工删除存储文件;重试后仍无法恢复时,可在 GitHub Issues 报告。
136
- - **提示“run2skill 当前版本不兼容”**(内部状态码:`INCOMPATIBLE`):确认 DSH 是否为受支持版本,再恢复与它兼容的 run2skill 版本。
137
- - **没有生成技能草稿**:确认当前会话有可用模型;也可以直接说“把这个流程保存成 Skill”。
138
- - **无法保存到当前项目**(`PROJECT`):当前会话必须位于 DSH 能识别的项目工作区。
139
- - **改过 Skill 的存储目录或存储方式**:当前版本只支持 DSH 默认设置,会选择安全停止,不会猜测写入位置。
140
-
141
- 欢迎在 [GitHub Issues](https://github.com/qkycir-123/dsh-run2skill/issues) 报告问题。请不要附上密钥、完整 Session、私人路径或包含敏感信息的日志。
95
+ Web 用户将 `desktop` 换成 `web`。卸载后已保存的 Skill 和插件数据继续保留;需要清理缓存时,可在卸载前使用插件页的清理功能。
142
96
 
143
- ## 进一步了解
97
+ ## 帮助与贡献
144
98
 
145
- - [版本变化](CHANGELOG.md)
146
- - [DSH 兼容性](docs/compatibility.md)
147
- - [数据存储与升级](docs/storage-and-upgrades.md)
148
- - [产品需求](docs/product/prd.md)
149
- - [架构基线](docs/architecture/baseline.md)
150
- - [设计文档索引](docs/design/README.md)
151
- - [同一 Skill 保存意图的单一生成所有者设计](docs/design/single-owner-skill-save.md)
152
- - [贡献指南](CONTRIBUTING.md)
153
- - [维护者兼容性探针](probes/README.md)
99
+ - [报告问题](https://github.com/qkycir-123/dsh-run2skill/issues)
100
+ - [兼容性](docs/compatibility.md) · [更新记录](CHANGELOG.md)
101
+ - [贡献指南](CONTRIBUTING.md) · [维护者探针](probes/README.md)
102
+ - [产品需求](docs/product/prd.md) · [架构与设计](docs/architecture/baseline.md)
154
103
 
155
- 本项目采用 [MIT License](LICENSE)。Client bundle 内嵌依赖的许可声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
104
+ [MIT License](LICENSE) · [第三方许可](THIRD_PARTY_NOTICES.md)
Binary file