dsh-plugin-guide 0.3.8 → 0.3.10

package/references/official-docs/docs/user/guide/index.zh.md

@@ -2,7 +2,7 @@
 
 [English](index.md) | 中文
 
-请先按照[根目录 README](../../../README.zh.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置；全新的 Web UI 则不会选中任何工作区，你需要添加一个工作区。
+请先按照[根目录 README](../../../README-zh.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置；全新的 Web UI 则不会选中任何工作区，你需要添加一个工作区。
 
 ## 配置模型
 
@@ -26,5 +26,5 @@ Agent（智能体）可以读取和编辑工作区文件、运行命令、委派
 
 - [配置模型](./providers.zh.md)
 - [使用 Python SDK](./python-sdk.zh.md)
-- [使用其他 CLI 模式](../../../apps/cli/README.zh.md)
+- [使用其他 CLI 模式](../../../apps/cli/README-zh.md)
 - [开发插件](../develop/basic/index.zh.md)

package/references/official-docs/docs/user/guide/mcp-memory.zh.md

@@ -2,7 +2,7 @@
 
 [English](mcp-memory.md) | 中文
 
-这三份**默认关闭的参考配置**通过 [`@deepseek-ai/dsh-mcp-client`](../../../packages/mcp/mcp-client/README.zh.md) 将一个记忆系统连接到 DSH。请选择其中一份，或复制相同的通用 MCP 配置项来连接其他服务器。
+这三份**默认关闭的参考配置**通过 [`@deepseek-ai/dsh-mcp-client`](../../../packages/mcp/mcp-client/README-zh.md) 将一个记忆系统连接到 DSH。请选择其中一份，或复制相同的通用 MCP 配置项来连接其他服务器。
 
 这些第三方配置仅作为互操作参考；收录不代表 DeepSeek 的认可、推荐、合作关系或持续支持承诺。
 

package/references/official-docs/docs/user/guide/providers.zh.md

@@ -2,7 +2,7 @@
 
 [English](providers.md) | 中文
 
-本指南假定你已按照[根 README](../../../README.zh.md#run)启动 Web UI。模型变更会在下一次请求时生效，不需要重启服务器。
+本指南假定你已按照[根 README](../../../README-zh.md#run)启动 Web UI。模型变更会在下一次请求时生效，不需要重启服务器。
 
 ## 配置 DeepSeek
 
@@ -40,7 +40,7 @@ Provider ID 是永久的，因为请求、已保存会话、模型默认值和
 
 ## 进阶配置
 
-自动生成的[插件配置目录](../../config-catalog.zh.md)列出每个插件的所有受支持字段与默认值；[`dsh-llm-pi-ai`](../../config-catalog.zh.md#deepseek-aidsh-llm-pi-ai) 就是本页所配置的那个提供方段落。[`dsh-llm-pi-ai`](../../../packages/llm/llm-pi-ai/README.zh.md) 和 [`dsh-llm-deepseek`](../../../packages/llm/llm-deepseek/README.zh.md) 参考文档负责直接 `settings.yaml` 配置、目录解析、推理控制、凭据与适配器错误。
+自动生成的[插件配置目录](../../config-catalog.zh.md)列出每个插件的所有受支持字段与默认值；[`dsh-llm-pi-ai`](../../config-catalog.zh.md#deepseek-aidsh-llm-pi-ai) 就是本页所配置的那个提供方段落。[`dsh-llm-pi-ai`](../../../packages/llm/llm-pi-ai/README-zh.md) 和 [`dsh-llm-deepseek`](../../../packages/llm/llm-deepseek/README-zh.md) 参考文档负责直接 `settings.yaml` 配置、目录解析、推理控制、凭据与适配器错误。
 
 ::: tip 表单刻意保持精简
 模型页只开放让一条路由得以存在的字段：API 密钥、显示名称、API 地址、API 协议，以及每个模型的 ID、显示名称、上下文窗口和最大输出 token 数。其余所有字段——推理等级、图片输入、请求兼容性开关、请求头、超时、重试策略——都在 `$DSH_HOME/settings.yaml` 中设置，也就是模型页写入的同一份文档。可以直接编辑它；浏览器与服务器在同一台机器时，也可以点击设置页顶部的**打开配置文件**打开它。适配器会在下一次请求时重新读取，无需重启任何东西。下面各小节介绍多数网关会用到的字段。

package/references/official-docs/docs/user/guide/python-sdk.zh.md

@@ -147,4 +147,4 @@ dsh plugin --profile sdk-minimal add file:C:/work/my-plugin-bundle
 
 需要隔离 profile、插件、凭据、设置与会话时，应使用新的 home。独立工作应使用新的 session id；只有继续同一段持久对话和会话资源时，才同时复用 harness、home 与 id。
 
-[组合包参考](../../../packages/bundle/sdk-minimal/README.zh.md)定义确切配置树，[示例参考](../../../python/sdk/examples/README.zh.md)定义可运行程序。[Python SDK 参考](../../../python/sdk/README.zh.md)介绍生命周期、结果、通知与底层行为；[dsh CLI 参考](../../../apps/cli/reference/README.zh.md)介绍 profile 分层。
+[组合包参考](../../../packages/bundle/sdk-minimal/README-zh.md)定义确切配置树，[示例参考](../../../python/sdk/examples/README-zh.md)定义可运行程序。[Python SDK 参考](../../../python/sdk/README-zh.md)介绍生命周期、结果、通知与底层行为；[dsh CLI 参考](../../../apps/cli/reference/README-zh.md)介绍 profile 分层。

package/references/official-docs/docs/web-styling.zh.md

@@ -6,7 +6,7 @@
 
 ## 职责归属
 
-[`ui-theme`](../packages/client/ui-theme/README.zh.md) 负责 `--dsw-*` 静态色阶、语义别名、排版、动效、渐变、阴影、滚动条样式以及明暗主题偏好。[`ui-layout`](../packages/client/ui-layout/README.zh.md) 将解析后的主题快照应用到文档。功能包使用语义别名，不得另行定义全局主题。
+[`ui-theme`](../packages/client/ui-theme/README-zh.md) 负责 `--dsw-*` 静态色阶、语义别名、排版、动效、渐变、阴影、滚动条样式以及明暗主题偏好。[`ui-layout`](../packages/client/ui-layout/README-zh.md) 将解析后的主题快照应用到文档。功能包使用语义别名，不得另行定义全局主题。
 
 全局样式表归 `ui-theme/src/styles/` 所有。组件样式以 CSS Modules 形式放在组件旁。当某个值属于该组件的布局或呈现约定时，组件可以定义局部自定义属性；共享颜色、排版、层级和动效属于主题包。
 

package/references/official-docs/packages/README.md

@@ -5,7 +5,7 @@ kind: "package-group"
 
 # Packages
 
-English | [中文](README.zh.md)
+English | [中文](README-zh.md)
 
 ## Summary
 

package/references/sources.md

@@ -34,7 +34,7 @@
 ## C. 本地 checkout 文档副本（references/official-docs/）
 
 - `docs/**`（215 个 md，含全部 `.zh.md` 双语对）— 教程/架构/子系统/API/cookbook 全量
-- 仓库根文件（**2026-08-14 晚新增**）：`AGENTS.md`、`CLAUDE.md`（上游为 symlink→AGENTS.md，副本存其目标文本）、`BENCHMARK.md`、`CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`、`README.zh.md`/`.i18n.yaml`、`THIRD_PARTY_NOTICES.md`、`LICENSE`
+- 仓库根文件（**2026-08-14 晚新增**）：`AGENTS.md`、`CLAUDE.md`（上游为 symlink→AGENTS.md，副本存其目标文本）、`BENCHMARK.md`、`CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`、`README-zh.md`/`.i18n.yaml`、`THIRD_PARTY_NOTICES.md`、`LICENSE`
 - `packages/AGENTS.md` · `packages/README.md` · `vendor/README.md`
 - `website-docs.ts`（站点投影清单）
 - 上游英文 `README.md` 不进入本目录（与 KB 索引同名），线上快照在 `downloads/github/harness/README.md`
@@ -130,7 +130,7 @@
 
 本项目同时改造为可安装的 DSH bundle（`package.json#dsh.bundle` + 根 `cordis.patch.yml` + `index.js` 注册 `dsh-plugin-guide` 技能），并按各收录入口的专属规则投递：
 
-- 榜单 PR：awesome-dsh-plugin [PR #465](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/465)（README.md/README.zh.md Skills 各 +1 行；#461 因 fork 分支被共享 fork 覆盖而自动关闭，已由 #465 取代）、AdamPlatin123/awesome-dsh-plugins [PR #151](https://github.com/AdamPlatin123/awesome-dsh-plugins/pull/151)（PLUGINS.md「🎓 技能」表 +1 行，运行级如实填「待测」）、0xsline/awesome-deepseek-harness [PR #183](https://github.com/0xsline/awesome-deepseek-harness/pull/183)（README.md/README.zh-CN.md Infrastructure & Development 各 +1）、bruc3van/awesome-dsh-plugin [PR #42](https://github.com/bruc3van/awesome-dsh-plugin/pull/42)（作者自荐区中英各 +1 行，`validate-curated.mjs` 本地通过）。
+- 榜单 PR：awesome-dsh-plugin [PR #465](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/465)（README.md/README-zh.md Skills 各 +1 行；#461 因 fork 分支被共享 fork 覆盖而自动关闭，已由 #465 取代）、AdamPlatin123/awesome-dsh-plugins [PR #151](https://github.com/AdamPlatin123/awesome-dsh-plugins/pull/151)（PLUGINS.md「🎓 技能」表 +1 行，运行级如实填「待测」）、0xsline/awesome-deepseek-harness [PR #183](https://github.com/0xsline/awesome-deepseek-harness/pull/183)（README.md/README.zh-CN.md Infrastructure & Development 各 +1）、bruc3van/awesome-dsh-plugin [PR #42](https://github.com/bruc3van/awesome-dsh-plugin/pull/42)（作者自荐区中英各 +1 行，`validate-curated.mjs` 本地通过）。
 - DSH Hub Workshop（omdsh-dev）：`package.json#dshWorkshop`（`omdsh-workshop-package/v1`）已提交（固定 commit `9447366f63a02229031af1e0bed2afedeff44860`）；v2 投稿经 `scripts/intake.mjs validate` 通过（"submission accepted for pending review"）；申请 [Issue #20](https://github.com/omdsh-dev/dsh-hub-workshop/issues/20)，pending-review 审核 PR 由 hub 自动化生成（异步）。
 - 官方展示：deepseek-harness Discussions [Show and tell #1824](https://github.com/deepseek-ai/deepseek-harness/discussions/1824)。
 - 自动聚合（预期延迟，复核命令）：Oh-My-DSH `PLUGINS.md`（每 4 小时）、wangshunnn/oh-my-dsh `registry/plugins.json`（根 package.json 已声明 `dsh.bundle.patch`）、YELEBAI/dsh-plugin-marketplace `registry/plugins.json`（每 2 小时扫描 + manifest 验证）、AdamPlatin123 雷达（≤8 小时）、bruc3van 每日快照、dshfind 与 Noob-stupid/yyyyukari（topic 实时聚合，无需动作）。复核：`curl -s https://raw.githubusercontent.com/<repo>/main/<文件> | grep dsh-plugin-guide`（本机直连 raw 失败时经 api.github.com/contents 取）。

package/references/website-pages.md

@@ -623,7 +623,7 @@
 ### 5.3 GitHub 仓库文档源文件（web_search 命中，均在 `github.com/deepseek-ai/deepseek-harness`）
 
 - `https://github.com/deepseek-ai/deepseek-harness`（主仓库）
-- `https://github.com/deepseek-ai/deepseek-harness/blob/master/README.md` / `README.zh.md`
+- `https://github.com/deepseek-ai/deepseek-harness/blob/master/README.md` / `README-zh.md`
 - `https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md` / `.zh.md`
 - `.../docs/development.md` / `.zh.md`
 - `.../docs/cordis-primer.md` / `.zh.md`
@@ -634,7 +634,7 @@
 - `.../docs/user/guide/index.md`
 - `.../docs/user/develop/basic/index.md`、`config.md`、`publish.md`
 - `.../packages/mcp/mcp-client/README.md`、`.../packages/llm/llm-deepseek/README.md`、`.../packages/llm/llm-pi-ai/README.md`、`.../packages/bundle/base/README.md`、`.../packages/README.md`、`.../packages/skill/SKILL.md`、`.../packages/hooks/hooks-codex/README.md`
-- `.../apps/cli/reference/README.zh.md`
+- `.../apps/cli/reference/README-zh.md`
 
 ### 5.4 第三方报道 / 生态（web_search 命中，非官方，内容 [unverified]）
 

package/scripts/check-readme-sync.mjs

@@ -10,10 +10,10 @@ import { fileURLToPath } from 'node:url'
 const root = path.dirname(path.dirname(fileURLToPath(import.meta.url)))
 const LANGUAGES = [
   ['README.md', 'en'],
-  ['README.zh.md', 'zh'],
-  ['README.es.md', 'es'],
-  ['README.pt.md', 'pt'],
-  ['README.hi.md', 'hi'],
+  ['README-zh.md', 'zh'],
+  ['README-es.md', 'es'],
+  ['README-pt.md', 'pt'],
+  ['README-hi.md', 'hi'],
 ]
 
 const headingsOf = (text) => text.split(/\r?\n/u)

package/scripts/sync-official-docs.ps1

@@ -25,10 +25,10 @@ $pruned = 0
 $mdCount = 0
 $zhCount = 0
 
-# Sync scope: docs/, root AGENTS.md/BENCHMARK.md/CLAUDE.md/CONTRIBUTING.*/README.zh.md/README.i18n.yaml/THIRD_PARTY_NOTICES.md/LICENSE, packages/AGENTS.md, packages/README.md, vendor/README.md, website/docs.ts
+# Sync scope: docs/, root AGENTS.md/BENCHMARK.md/CLAUDE.md/CONTRIBUTING.*/README-zh.md/README.i18n.yaml/THIRD_PARTY_NOTICES.md/LICENSE, packages/AGENTS.md, packages/README.md, vendor/README.md, website/docs.ts
 # Upstream root README.md is out of scope: official-docs/README.md is the KB-owned index (the upstream English README snapshot lives in downloads/github/harness/README.md).
 # Every pathspec uses the :(top) anchor so git's basename-wide matching cannot sweep in same-named symlinks (e.g. the various CLAUDE.md files).
-$paths = @(':(top)docs', ':(top)AGENTS.md', ':(top)BENCHMARK.md', ':(top)CONTRIBUTING.md', ':(top)CONTRIBUTING.zh.md', ':(top)CONTRIBUTING.i18n.yaml', ':(top)README.zh.md', ':(top)README.i18n.yaml', ':(top)THIRD_PARTY_NOTICES.md', ':(top)LICENSE', ':(top)packages/AGENTS.md', ':(top)packages/README.md', ':(top)vendor/README.md', ':(top)website/docs.ts')
+$paths = @(':(top)docs', ':(top)AGENTS.md', ':(top)BENCHMARK.md', ':(top)CONTRIBUTING.md', ':(top)CONTRIBUTING.zh.md', ':(top)CONTRIBUTING.i18n.yaml', ':(top)README-zh.md', ':(top)README.i18n.yaml', ':(top)THIRD_PARTY_NOTICES.md', ':(top)LICENSE', ':(top)packages/AGENTS.md', ':(top)packages/README.md', ':(top)vendor/README.md', ':(top)website/docs.ts')
 
 if ($gitOk) {
   # Prefer origin/master, fall back to HEAD - never the working tree (may contain untracked/unpushed content).
@@ -68,7 +68,7 @@ if ($gitOk) {
 
   # Keep only in-scope entries at the destination root (drops stale extraction residue and
   # upstream-deleted root files so the copy stays verbatim).
-  $rootKeep = @('docs','examples','packages','vendor','AGENTS.md','BENCHMARK.md','CLAUDE.md','CONTRIBUTING.md','CONTRIBUTING.zh.md','CONTRIBUTING.i18n.yaml','LICENSE','README.zh.md','README.i18n.yaml','THIRD_PARTY_NOTICES.md','SNAPSHOT.md','README.md','website-docs.ts')
+  $rootKeep = @('docs','examples','packages','vendor','AGENTS.md','BENCHMARK.md','CLAUDE.md','CONTRIBUTING.md','CONTRIBUTING.zh.md','CONTRIBUTING.i18n.yaml','LICENSE','README-zh.md','README.i18n.yaml','THIRD_PARTY_NOTICES.md','SNAPSHOT.md','README.md','website-docs.ts')
   Get-ChildItem -Force $dest | Where-Object { $rootKeep -notcontains $_.Name } | ForEach-Object {
     Remove-Item $_.FullName -Recurse -Force; $pruned++
   }
@@ -127,7 +127,7 @@ $L = @(
   "| Source ref | ``$ref`` |",
   "| Source commit | ``$sha`` |",
   "| Synced at (UTC) | $utc |",
-  '| Scope | tracked files at the ref: `docs/`, root `AGENTS.md`, `BENCHMARK.md`, `CLAUDE.md` (symlink target text), `CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`, `README.zh.md`/`.i18n.yaml` (the upstream English `README.md` is not in this dir; its snapshot lives in `downloads/github/harness/README.md`), `THIRD_PARTY_NOTICES.md`, `LICENSE`, `packages/AGENTS.md`, `packages/README.md`, `vendor/README.md`, `website/docs.ts` |',
+  '| Scope | tracked files at the ref: `docs/`, root `AGENTS.md`, `BENCHMARK.md`, `CLAUDE.md` (symlink target text), `CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`, `README-zh.md`/`.i18n.yaml` (the upstream English `README.md` is not in this dir; its snapshot lives in `downloads/github/harness/README.md`), `THIRD_PARTY_NOTICES.md`, `LICENSE`, `packages/AGENTS.md`, `packages/README.md`, `vendor/README.md`, `website/docs.ts` |',
   "| File counts | docs/: $mdCount md files ($zhCount .zh.md pairs) |",
   "| Pruned this run | $pruned out-of-scope/upstream-deleted entries |",
   '',

package/scripts/verify-artifacts.mjs

@@ -55,7 +55,7 @@ try {
     const result = runNode(['dist/dsh-plugin-dev.js', 'new', 'demo-plugin', '--lang', lang, '--dir', target])
     const hasEntry = lang === 'ts' ? existsSync(join(target, 'src', 'index.ts')) : existsSync(join(target, 'index.js'))
     const hasPatch = existsSync(join(target, 'cordis.patch.yml'))
-    const readmeCount = readdirSync(target).filter((f) => /^README(\.\w{2})?\.md$/.test(f)).length
+    const readmeCount = readdirSync(target).filter((f) => /^README(-\w{2})?\.md$/.test(f)).length
     check(result.status === 0 && hasEntry && hasPatch, `${lang} scaffold produces entry + cordis.patch.yml (exit ${result.status})`)
     check(readmeCount === 5, `${lang} scaffold produces 5 README languages (${readmeCount})`)
   }

package/scripts/verify-kit.ps1

@@ -10,7 +10,7 @@ $info = New-Object System.Collections.Generic.List[string]
 
 # ---- 1) 关键路径 ----
 $critical = @(
-  'SKILL.md','README.md','README.zh.md','README.es.md','README.pt.md','README.hi.md','LICENSE','NOTICE.md','.gitignore',
+  'SKILL.md','README.md','README-zh.md','README-es.md','README-pt.md','README-hi.md','LICENSE','NOTICE.md','.gitignore',
   'CONTRIBUTING.md','SECURITY.md','.github/ISSUE_TEMPLATE/bug_report.yml','.github/ISSUE_TEMPLATE/feature_request.yml','.github/PULL_REQUEST_TEMPLATE.md',
   'guide/plugin-dev-guide.md','guide/quick-reference.md','guide/links.md','guide/quick-reference.zh-CN.md','guide/quick-reference.es.md','guide/quick-reference.pt.md','guide/quick-reference.hi.md',
   'references/sources.md','references/harness-repo.md','references/website-pages.md',
@@ -125,7 +125,7 @@ if ($Checkout -and (Test-Path $Checkout)) {
       'CONTRIBUTING.md'        = 'CONTRIBUTING.md';
       'CONTRIBUTING.zh.md'     = 'CONTRIBUTING.zh.md';
       'CONTRIBUTING.i18n.yaml' = 'CONTRIBUTING.i18n.yaml';
-      'README.zh.md'           = 'README.zh.md';
+      'README-zh.md'           = 'README-zh.md';
       'README.i18n.yaml'       = 'README.i18n.yaml';
       'THIRD_PARTY_NOTICES.md' = 'THIRD_PARTY_NOTICES.md';
       'LICENSE'                = 'LICENSE';