@feng0531/dsh-vcs 0.4.10 → 0.5.1

package/README.md

@@ -17,6 +17,7 @@
 | 浏览 Git 历史 | 搜索提交说明、作者、路径与提交时间范围（since/until，含边界，按 committer date）；查看本地分支、提交图、提交详情与目录 |
 | 比较历史版本 | 比较提交与选定父提交，或选择两个本地提交进行 A/B 比较 |
 | 追溯代码来源 | 文件历史、唯一来源重命名追踪（含改名同时修改）、Blame（逐行查看最后修改者和提交） |
+| 搜索与定位 | 搜索固定提交中的内容，点击结果定位命中行，返回保留结果 |
 | 查看其他内容 | 支持部分静态图片比较；较大历史 UTF-8 文件可分段阅读 |
 | 浏览 SVN 历史 | 明确同意连接后，查看 HTTPS 仓库日志、修订差异和文件历史 |
 
@@ -27,14 +28,16 @@
 需要：
 
 - Node.js **22 或更新版本**。
-- DSH Web：声明兼容 **0.1.7-rc.2 或 0.2.0-rc.2**。
+- DSH Web：声明兼容 **0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.2 或 0.2.1-rc.5**。
 - 系统 PATH 中有 Git 或 SVN；只使用 Git 时无需安装 SVN。
 
 profile是DSH的配置和插件环境，不是Session。下面的web是示例，请先确认运行中的DSH使用哪个profile；若不同，替换命令中的web。宿主插件命令通过pnpm执行，需确保该工具可用。
 
 在终端执行：
 
-	dsh plugin --profile web add @feng0531/dsh-vcs@0.3.73
+	dsh plugin --profile web add "@feng0531/dsh-vcs@<已确认发布到 npm 的版本>"
+
+GitHub 与 npm 的可用版本可能不同；例如 0.4.11 仅发布 GitHub。安装前核对目标渠道，候选源码版本不等于已发布版本。
 
 安装后由你自行重启 DSH，再刷新原来的 Web 页面。安装会改变所选 profile；升级前请备份配置。**本项目的发布不会自动升级或重启你的 DSH。**
 
@@ -46,7 +49,7 @@ profile是DSH的配置和插件环境，不是Session。下面的web是示例，
 
 ## 更新与免重启加载
 
-VCS 顶部“更新插件”打开更新说明、宿主插件管理器与最新发布链接，不直接安装或卸载。安装新版后点击“检查并加载已安装更新”：后端指纹一致才重新挂载前端，否则提示自行重启 DSH。第一次引入此功能需要重启一次。后端、依赖锁、加载器、字典或编辑器资源变化均需重启。加载失败保留旧版或显示恢复操作，不自动重启。
+VCS 顶部“更新插件”提供更新检查、宿主插件管理器与最新发布链接。明确勾选确认后，更新按钮会委托宿主安装指定正式版本，修改当前插件环境；不会自动重启，缺少宿主更新接口时改用插件管理器。安装新版后点击“检查并加载已安装更新”：后端指纹一致才重新挂载前端，否则提示自行重启 DSH。第一次引入此功能需要重启一次。后端、依赖锁、加载器、字典或编辑器资源变化均需重启。加载失败保留旧版或显示恢复操作，不自动重启。
 
 ## 开始使用
 
@@ -81,14 +84,14 @@ VCS 顶部“更新插件”打开更新说明、宿主插件管理器与最新
 
 - **不是完整的 Fork 客户端**：没有仓库写操作，历史图和列表都有容量限制；分支导航使用本地分支、标签及本地缓存的远程跟踪引用，不连接远端、不 fetch。
 - 普通文本比较每侧最多 **2MiB**。Git提交／A-B／工作区三个模式比较超限时可手动加载完整文本（UTF-8／GBK／带BOM的UTF-16），每侧最多 **8MiB、10万行**，单行最多65536字符；计算超时会明确提示结果不完整。工作区读取期间发生变化会拒绝结果，但不是系统级原子快照；SVN大文件仍不支持。
-- 历史 UTF-8 正文分段最多 **16MiB**；分段阅读不是完整Diff，与上述完整比较是不同功能。
+- 历史 UTF-8 正文分段最多 **16MiB**；分段阅读不是完整 Diff。正文按固定对象缓存，最多 32MiB／8 项／60 秒，缓存命中仍重新验证请求授权。历史目录按需分页，每页最多 100 项，单目录仍有 10 万项和 16MiB 命令输出上限。
 - 重命名追溯仅沿第一父链，至少50%相似且确认唯一删除源／新增目标；合并、复制、歧义或累计32次确认后停止。
 - 子模块变更只显示 Index 记录的提交指针与本地检出状态（已检出／未初始化／目录缺失／不可读）；不进入子模块、不读取其 HEAD，也不更新或同步。
 - 树浏览和来源行预览可手动查看该历史路径的文件历史，并可选跟随重命名；路径必须存在于所选提交，跟随规则与路径历史一致（第一父链、≥50%相似、唯一确认、32次上限）。
 - 冲突文件可额外手动查看 Git Index 阶段1／2／3，任意两阶段可只读比较。缺失阶段显示为空、不推断原内容；阶段编号不声称合并／变基归属。每阶段仍为 2MiB 预览；不读取工作文件、不解决冲突，子模块只显示提交引用，链接只显示目标文本。
 - 图片支持 PNG、基线/渐进 JPEG 和简单静态 VP8／无损VP8L WebP；动画、扩展 WebP、算术编码/CMYK JPEG 等不支持。
 - 支持 UTF-8、GBK、带 BOM 的 UTF-16；不是通用编码检测器。
-- 取消状态／比较请求不保证立即停止底层进程，进程仍受超时和输出上限控制。
+- 本地读取整次请求默认最多 15 秒，子命令共享剩余预算；取消或超时会终止子进程树并等待清理，不保证立即完成。操作系统拒绝终止时仍可能延迟。
 
 ## 常见问题