@michengai/dsh-skills-manager 0.1.0 → 0.1.1

package/README.md

@@ -5,11 +5,12 @@
 <h1 align="center">DSH Skills Manager</h1>
 
 <p align="center">
-  <strong>Manage local DeepSeek Harness skills with a clear boundary for shared Agent skills.</strong>
+  <strong>An npm-installable DeepSeek Harness Web plugin for managing local skills safely.</strong>
 </p>
 
 <p align="center">
   <a href="https://github.com/MichengAI/dsh-skills-manager/issues">Report an issue</a>
+  · <a href="https://www.npmjs.com/package/@michengai/dsh-skills-manager">View on npm</a>
 </p>
 
 <p align="center">
@@ -18,6 +19,7 @@
 
 <p align="center">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache License 2.0"></a>
+  <a href="https://www.npmjs.com/package/@michengai/dsh-skills-manager"><img src="https://img.shields.io/npm/v/%40michengai/dsh-skills-manager?label=npm" alt="npm package"></a>
   <img src="https://img.shields.io/badge/DSH-Web%20Plugin-10b981" alt="DSH Web Plugin">
   <img src="https://img.shields.io/badge/Node.js-%E2%89%A520-339933?logo=nodedotjs&logoColor=white" alt="Node.js 20 or later">
 </p>
@@ -48,11 +50,11 @@
 
 The shared Agent directory is intentionally read-only in both the interface and the server API.
 
-## Install
+## Quick start
 
-Requirements: a working DeepSeek Harness Web installation. The published package declares Node.js 20 or later for the DSH runtime.
+You need a working DeepSeek Harness Web installation. Do not run `npm install` in an arbitrary directory: install the plugin into the DSH Web profile instead.
 
-Install the published package into the Web profile:
+1. Run:
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -60,16 +62,23 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web add @michengai/dsh-skills-manager
 ```
 
-No source checkout is required. Restart DSH, then open **Settings → Skills**. If a package mirror has not synchronized the latest version yet, append `--registry=https://registry.npmjs.org/` to the install command.
+2. Restart DSH or reload the active Web profile.
+3. Open **Settings → Skills**. No source checkout is required.
 
-## How to use it
+If a package mirror has not synchronized the latest version yet, append `--registry=https://registry.npmjs.org/` to the install command.
 
-1. Open **Settings → Skills**. The panel separates **DSH Skills** from **Shared Agent Skills** and shows each skill's name, form, description, and current invocation status.
-2. In **DSH Skills**, choose **Enable** or **Disable** to control both model invocation and the `/` manual command. Other `SKILL.md` metadata remains untouched.
-3. Choose **Upload Plugin** in the upper-right corner. Select the plugin directory's `SKILL.md`; the complete plugin directory is copied to `$DSH_HOME\skills`.
-4. When the browser does not provide the selected file path, use **Choose Plugin Directory** in the dialog and select the directory that contains `SKILL.md`.
-5. Confirm any replacement of a same-name skill. Use **Delete** only for DSH-local skills you no longer need.
-6. Treat **Shared Agent Skills** as an inspection list: their controls are deliberately unavailable so the shared global skill metadata stays unchanged.
+## Use the Skills panel
+
+| Goal | What to do | Scope |
+| --- | --- | --- |
+| Check a skill | Open **Settings → Skills** to see its name, form, description, and invocation status. | DSH and shared Agent skills |
+| Enable or disable | Choose **Enable** or **Disable**. This changes model invocation and the `/` manual command without rewriting other `SKILL.md` metadata. | DSH skills only |
+| Upload a plugin | Choose **Upload Plugin**, then select the plugin directory's `SKILL.md`. DSH copies the complete directory, including scripts and resources. | DSH skills only |
+| Select a directory instead | If the selected file has no usable path, choose **Choose Plugin Directory** and select the directory that contains `SKILL.md`. | DSH skills only |
+| Replace or delete | Confirm a same-name replacement; use **Delete** for a DSH-local skill you no longer need. | DSH skills only |
+| Inspect shared skills | Review shared Agent skills without changing their metadata. | Read-only |
+
+Press **Escape** to close only the frontmost upload or confirmation dialog; the Settings page remains open.
 
 ## Development and verification
 
@@ -83,18 +92,18 @@ node test\core-test.mjs
 
 Project status, usage boundaries, architecture, and iteration records start at the [documentation entry point](https://github.com/MichengAI/dsh-skills-manager/blob/master/docs/00-%E4%BA%A4%E6%8E%A5%E5%85%A5%E5%8F%A3/00-%E9%98%85%E8%AF%BB%E5%AF%BC%E8%88%AA.md). The Chinese operational guide is available at `docs\02-产品与业务\01-使用说明.md` in the repository.
 
-## Publishing
+## Maintainer release
 
-The user-level npm registry may point to a download mirror such as `registry.npmmirror.com`; mirrors do not accept publication. This package therefore pins publication to the official npm registry. A maintainer with npm publishing access can release the current version with:
+The package is published as [`@michengai/dsh-skills-manager`](https://www.npmjs.com/package/@michengai/dsh-skills-manager). To release a new version:
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-npm login --registry=https://registry.npmjs.org/
+npm version patch
 npm publish
 ```
 
-`prepublishOnly` runs the core test suite before publication, and `publishConfig.registry` prevents `npm publish` from going to a configured download mirror. Use `npm run pack:check` to inspect the exact tarball contents without publishing.
+`prepublishOnly` runs the core test suite before publication. The package always publishes to the official npm registry; use `npm run pack:check` to inspect the tarball first.
 
 ## License
 

package/README.zh-CN.md

@@ -5,11 +5,12 @@
 <h1 align="center">DSH Skills Manager</h1>
 
 <p align="center">
-  <strong>管理本地 DeepSeek Harness 技能，并为公共 Agent 技能提供清晰、安全的查看边界。</strong>
+  <strong>通过 npm 安装的 DeepSeek Harness Web 插件，用于安全管理本地技能。</strong>
 </p>
 
 <p align="center">
   <a href="https://github.com/MichengAI/dsh-skills-manager/issues">反馈问题</a>
+  · <a href="https://www.npmjs.com/package/@michengai/dsh-skills-manager">在 npm 查看</a>
 </p>
 
 <p align="center">
@@ -18,6 +19,7 @@
 
 <p align="center">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache License 2.0"></a>
+  <a href="https://www.npmjs.com/package/@michengai/dsh-skills-manager"><img src="https://img.shields.io/npm/v/%40michengai/dsh-skills-manager?label=npm" alt="npm 包"></a>
   <img src="https://img.shields.io/badge/DSH-Web%20Plugin-10b981" alt="DSH Web Plugin">
   <img src="https://img.shields.io/badge/Node.js-%E2%89%A520-339933?logo=nodedotjs&logoColor=white" alt="Node.js 20 或更高版本">
 </p>
@@ -48,11 +50,11 @@
 
 公共 Agent 目录在界面和服务端均为只读，用于避免误改共享的全局技能元数据。
 
-## 安装
+## 快速开始
 
-环境要求：可正常运行的 DeepSeek Harness Web 环境。已发布的包会声明 DSH 运行时需要 Node.js 20 或更高版本。
+环境要求：可正常运行的 DeepSeek Harness Web 环境。不要在任意目录执行 `npm install`；应将插件安装到 DSH Web profile。
 
-将已发布 npm 包安装到 Web profile：
+1. 执行：
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -60,16 +62,23 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web add @michengai/dsh-skills-manager
 ```
 
-无需下载源码。重启 DSH 后，打开「设置 → 技能」。若软件源镜像尚未同步最新版本，可在安装命令末尾添加 `--registry=https://registry.npmjs.org/`。
+2. 重启 DSH 或重新加载当前 Web profile。
+3. 打开「设置 → 技能」。无需下载源码。
 
-## 使用说明
+若软件源镜像尚未同步最新版本，可在安装命令末尾添加 `--registry=https://registry.npmjs.org/`。
 
-1. 打开「设置 → 技能」。面板会区分「DSH 技能」和「公共 Agent 技能」，并展示每个技能的名称、形态、说明和调用状态。
-2. 仅在「DSH 技能」分组中使用「启用」或「停用」。它会同步控制模型调用和 `/` 手动命令，且不会改写 `SKILL.md` 的其他元数据。
-3. 点击右上角「上传插件」，选择插件目录中的 `SKILL.md`；整个插件目录会复制到 `$DSH_HOME\skills`。
-4. 若客户端无法提供所选文件路径，在弹窗中点击「选择插件文件夹」，并选择包含 `SKILL.md` 的目录。
-5. 遇到同名技能时，根据提示确认是否覆盖；仅在「DSH 技能」分组中使用「删除」移除不再需要的插件。
-6. 「公共 Agent 技能」仅供智能查看，不提供启停、上传、覆盖或删除，以保护共享的全局技能元数据。
+## 使用技能面板
+
+| 目标 | 操作 | 范围 |
+| --- | --- | --- |
+| 查看技能 | 打开「设置 → 技能」，查看名称、形态、说明和调用状态。 | DSH 与公共 Agent 技能 |
+| 启用或停用 | 点击「启用」或「停用」。它会同步控制模型调用和 `/` 手动命令，不会改写 `SKILL.md` 的其他元数据。 | 仅 DSH 技能 |
+| 上传插件 | 点击「上传插件」，选择插件目录内的 `SKILL.md`。DSH 会复制完整目录，包括脚本和资源。 | 仅 DSH 技能 |
+| 改选插件目录 | 若所选文件没有可用路径，点击「选择插件文件夹」，并选择包含 `SKILL.md` 的目录。 | 仅 DSH 技能 |
+| 覆盖或删除 | 同名时按提示确认覆盖；使用「删除」移除不再需要的 DSH 本地技能。 | 仅 DSH 技能 |
+| 查看公共技能 | 查看公共 Agent 技能，不修改其元数据。 | 只读 |
+
+按 ESC 只关闭最上层上传框或确认框，设置页保持打开。
 
 ## 开发与验证
 
@@ -83,18 +92,18 @@ node test\core-test.mjs
 
 项目状态、使用边界、技术架构和迭代记录从[文档交接入口](https://github.com/MichengAI/dsh-skills-manager/blob/master/docs/00-%E4%BA%A4%E6%8E%A5%E5%85%A5%E5%8F%A3/00-%E9%98%85%E8%AF%BB%E5%AF%BC%E8%88%AA.md)开始；详细操作说明见仓库中的 `docs\02-产品与业务\01-使用说明.md`。
 
-## 发布 npm 包
+## 维护者发布
 
-用户级 npm registry 可能指向 `registry.npmmirror.com` 等下载镜像；镜像不接受发布。本包已固定发布目标为官方 npm registry，拥有 npm 发布权限的维护者可执行：
+本包已发布为 [`@michengai/dsh-skills-manager`](https://www.npmjs.com/package/@michengai/dsh-skills-manager)。发布新版本时执行：
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-npm login --registry=https://registry.npmjs.org/
+npm version patch
 npm publish
 ```
 
-发布前会由 `prepublishOnly` 自动运行核心测试，`publishConfig.registry` 会避免 `npm publish` 写入下载镜像。执行 `npm run pack:check` 可在不发布的情况下检查最终 tarball 内容。
+发布前会由 `prepublishOnly` 自动运行核心测试。包始终发布到官方 npm registry；可先执行 `npm run pack:check` 检查 tarball 内容。
 
 ## 许可证
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@michengai/dsh-skills-manager",
-  "version": "0.1.0",
-  "description": "DSH Web plugin: manage local DSH skills and safely view shared Agent skills.",
+  "version": "0.1.1",
+  "description": "NPM-installable DSH Web plugin for managing local skills and viewing shared Agent skills safely.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",