@klarkxy/dsh-dev-index 0.1.1 → 0.1.2

package/README.md

@@ -2,30 +2,19 @@
 
 [Chinese documentation](README.zh-CN.md)
 
-A DeepSeek Harness bundle that walks an agent through a short workflow: confirm the target DSH version, prefer the official plugin-development skill and runtime inspection when they exist, pick a task, then verify the plugin. The docs stay outside this package.
+A lightweight DeepSeek Harness skill. It points an agent at official DSH material and does not ship or maintain a copy of the docs.
 
-The index itself is not in this package. `docs/` in [klarkxy/dsh-plugins](https://github.com/klarkxy/dsh-plugins) is the only copy, and it is published at [https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/). `docs/meta.json` records `officialTag` and `officialCommit` for the [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) revision those pages describe. Every area, task, and architecture-rules page names the official file it came from. The index does not invent APIs.
+Inside a running DSH, prefer the official `cordis-plugin-development` skill and the read-only inspect tools `cordis_inspect_list` and `cordis_inspect_query`. Every `plugin_manager` action needs `danger-full-access` or a one-off approval. The environment's own tool policy still applies.
 
-## Why a skill
-
-DSH's agent-facing knowledge contract is a skill on `ctx.skills`. `@deepseek-ai/dsh-skill` documents `ctx.skills.register` for an embedded instruction set, and `@deepseek-ai/dsh-tool-skill` puts model-invocable skills in the session catalog and loads them with the `skill` tool. A preset would replace the agent's composition. A tool would have to be called before the agent knew the index existed. A host-level skill is listed beside the agent's other skills and stays available in every base-backed profile.
-
-On `apply`, this plugin registers the skill `dsh-dev-index`. The body is a short workflow, then the fetch list. It tells the agent to compare `meta.json` `officialTag` and `officialCommit` with the target DSH version and, on a mismatch, to treat the pages as unverified. It does not embed that revision, so a daily docs refresh does not require a new package release.
+Readable docs are the official site [https://deepseek-harness.github.io/deepseek-harness/](https://deepseek-harness.github.io/deepseek-harness/) (Chinese at the site root, English under `/en/`) and [llms.txt](https://deepseek-harness.github.io/deepseek-harness/llms.txt). That site is the latest published release. Source and type declarations default to [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) `master`. When the target version differs, use the matching `dsh-v*` tag and do not mix versions.
 
-- `https://klarkxy.github.io/dsh-plugins/llms.txt`
-- `https://klarkxy.github.io/dsh-plugins/index.json`
-- `https://klarkxy.github.io/dsh-plugins/meta.json`
-- `https://klarkxy.github.io/dsh-plugins/tasks/index.md`
-- `https://klarkxy.github.io/dsh-plugins/tasks/<id>.md`
-- `https://klarkxy.github.io/dsh-plugins/areas/<id>.md`
+[https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/) only redirects there. Old paths on that host redirect as well.
 
-English is the default. Human-readable pages also exist in Simplified Chinese under `zh/` (for example `zh/llms.txt`, `zh/tasks/<id>.md`, and `zh/areas/<id>.md`). `index.json` and `meta.json` stay in English.
-
-If Pages does not respond, the same paths are on GitHub `main`:
+## Why a skill
 
-`https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/`
+DSH's agent-facing knowledge contract is a skill on `ctx.skills`. `@deepseek-ai/dsh-skill` documents `ctx.skills.register` for an embedded instruction set, and `@deepseek-ai/dsh-tool-skill` puts model-invocable skills in the session catalog and loads them with the `skill` tool. A preset would replace the agent's composition. A tool would have to be called before the agent knew the pointer existed. A host-level skill is listed beside the agent's other skills and stays available in every base-backed profile.
 
-The body also lists task ids and area ids so the agent knows which files exist. It does not copy page text.
+On `apply`, this plugin registers the skill `dsh-dev-index`. The body is static. It does not embed a commit, a tag, or a URL on this repository.
 
 `sdk-minimal` does not mount `@deepseek-ai/dsh-skill`. There the plugin stays pending because it injects `skills`. Web, headless, sdk, and acp build on `@deepseek-ai/dsh-base`, which mounts the registry.
 
@@ -52,9 +41,9 @@ allowBuilds:
   '@klarkxy/dsh-dev-index': true
 ```
 
-Run the add again. That allowance executes this package's build on the machine. Pin a commit when the plugin source must not move. The index the skill fetches still follows `main` and the Pages site.
+Run the add again. That allowance executes this package's build on the machine. Pin a commit when the plugin source must not move.
 
-Peer ranges on `@deepseek-ai/dsh-skill` are checked against the running `dsh` version. This package requires DSH `>=0.1.7-rc.2 <0.2.0` because it calls `ctx.skills.register` from that release. `engines.dsh` is not enforced by the loader; the peer range is. The indexed docs revision is `docs/meta.json`, not this peer range.
+Peer ranges on `@deepseek-ai/dsh-skill` are checked against the running `dsh` version. This package requires DSH `>=0.1.7-rc.2 <0.2.0` because it calls `ctx.skills.register` from that release. `engines.dsh` is not enforced by the loader; the peer range is.
 
 ## Install from this checkout
 
@@ -72,21 +61,7 @@ dsh --profile web --dump-config
 
 The composition should contain a `dsh-dev-index` row. In a new session, load the `dsh-dev-index` skill before changing DSH plugins or presets.
 
-## Configuration
-
-The patch sets the only key. A later layer that overrides the row must restate it, because a patch replaces `config` wholesale.
-
-| Key | Default | Meaning |
-| --- | --- | --- |
-| `pagesBaseUrl` | `https://klarkxy.github.io/dsh-plugins/` | Absolute http(s) base URL written into the skill body. A missing trailing slash is added. The raw GitHub fallback stays on this repository's `main`. |
-
-## Refresh
-
-The daily procedure is [docs/REFRESH.md](../../docs/REFRESH.md). Regenerate the rendered site from `docs/` with:
-
-```bash
-node plugins/dsh-dev-index/scripts/build-site.mjs
-```
+There is no configuration. The patch inserts the plugin and does not set keys.
 
 ## License
 

package/README.zh-CN.md

@@ -2,30 +2,19 @@
 
 [English documentation](README.md)
 
-这是一个 DeepSeek Harness bundle。它给 agent 一段短流程：确认目标 DSH 版本，在官方插件开发技能和运行时检查可用时优先使用它们，再选一个任务并验证插件。文档不在这个包里。
+这是一个很轻的 DeepSeek Harness skill。它把 agent 指到官方材料，不携带、也不维护一份文档副本。
 
-索引正文不在这个包里。[klarkxy/dsh-plugins](https://github.com/klarkxy/dsh-plugins) 仓库的 `docs/` 是唯一副本，并发布在 [https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/)。`docs/meta.json` 记录这些页面所描述的 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 修订：`officialTag` 与 `officialCommit`。每个 area、任务和架构规则页都标明官方文件路径。索引不发明 API。
+在正在运行的 DSH 里，优先用官方技能 `cordis-plugin-development`，以及只读的 `cordis_inspect_list` 和 `cordis_inspect_query`。`plugin_manager` 的每个动作都需要 `danger-full-access` 或一次性审批。环境自己的工具策略仍然适用。
 
-## 为什么用 skill
-
-DSH 面向 agent 的知识契约是 `ctx.skills` 上的 skill。`@deepseek-ai/dsh-skill` 用 `ctx.skills.register` 登记嵌入式说明，`@deepseek-ai/dsh-tool-skill` 把模型可调用的 skill 放进会话目录，并用 `skill` 工具加载。Preset 会换掉 agent 的组合。工具必须先被调用，agent 才知道索引存在。宿主层 skill 会和其他 skill 一起出现在目录里，base 上的 profile 都能用。
-
-`apply` 时本插件登记 skill `dsh-dev-index`。正文先是一段短流程，再列出读取地址。它让 agent 把 `meta.json` 的 `officialTag`、`officialCommit` 和目标 DSH 版本比较；不一致时把页面当作未经核实。正文不写入该修订，因此每天刷新 `docs/` 不需要发布新的插件包。
+给人读的文档在官方站点 [https://deepseek-harness.github.io/deepseek-harness/](https://deepseek-harness.github.io/deepseek-harness/)（简体中文在根路径，英文在 `/en/`）和 [llms.txt](https://deepseek-harness.github.io/deepseek-harness/llms.txt)。该站点是最近发布的版本。源码和类型声明默认看 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 的 `master`。目标版本不同时，改用对应的 `dsh-v*` 标签，不要混用版本。
 
-- `https://klarkxy.github.io/dsh-plugins/llms.txt`
-- `https://klarkxy.github.io/dsh-plugins/index.json`
-- `https://klarkxy.github.io/dsh-plugins/meta.json`
-- `https://klarkxy.github.io/dsh-plugins/tasks/index.md`
-- `https://klarkxy.github.io/dsh-plugins/tasks/<id>.md`
-- `https://klarkxy.github.io/dsh-plugins/areas/<id>.md`
+[https://klarkxy.github.io/dsh-plugins/](https://klarkxy.github.io/dsh-plugins/) 只做跳转。该主机上的旧路径也会跳走。
 
-英文是默认语言。给人读的页面在 `zh/` 下另有简体中文版（例如 `zh/llms.txt`、`zh/tasks/<id>.md` 和 `zh/areas/<id>.md`）。`index.json` 和 `meta.json` 保持英文。Agent 默认仍读取上面的英文文件。
-
-Pages 没有响应时，同样的路径在 GitHub 的 `main` 上：
+## 为什么用 skill
 
-`https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/`
+DSH 面向 agent 的知识契约是 `ctx.skills` 上的 skill。`@deepseek-ai/dsh-skill` 用 `ctx.skills.register` 登记嵌入式说明，`@deepseek-ai/dsh-tool-skill` 把模型可调用的 skill 放进会话目录，并用 `skill` 工具加载。Preset 会换掉 agent 的组合。工具必须先被调用，agent 才知道这个指针存在。宿主层 skill 会和其他 skill 一起出现在目录里，base 上的 profile 都能用。
 
-正文还列出任务 id 和 area id，方便 agent 知道有哪些文件。它不复制页面正文。
+`apply` 时本插件登记 skill `dsh-dev-index`。正文是静态的。它不写入提交、标签，也不写入本仓库的 URL。
 
 `sdk-minimal` 没有挂载 `@deepseek-ai/dsh-skill`。本插件 `inject` 了 `skills`，在那里会一直等待。`web`、`headless`、`sdk` 和 `acp` 建立在 `@deepseek-ai/dsh-base` 上，base 会挂载这个注册表。
 
@@ -52,9 +41,9 @@ allowBuilds:
   '@klarkxy/dsh-dev-index': true
 ```
 
-然后再执行一次 add。该许可会在本机执行这个包的构建。需要固定插件来源时请钉住 commit。skill 读取的索引仍然跟随 `main` 和 Pages 站点。
+然后再执行一次 add。该许可会在本机执行这个包的构建。需要固定插件来源时请钉住 commit。
 
-`@deepseek-ai/dsh-skill` 上的 peer 范围会对照正在运行的 `dsh` 版本检查。本包要求 DSH `>=0.1.7-rc.2 <0.2.0`，因为 `ctx.skills.register` 来自该版本。加载器不强制 `engines.dsh`；生效的是 peer 范围。索引描述的官方修订记在 `docs/meta.json`，不由这个 peer 范围表示。
+`@deepseek-ai/dsh-skill` 上的 peer 范围会对照正在运行的 `dsh` 版本检查。本包要求 DSH `>=0.1.7-rc.2 <0.2.0`，因为 `ctx.skills.register` 来自该版本。加载器不强制 `engines.dsh`；生效的是 peer 范围。
 
 ## 从本仓库安装
 
@@ -72,21 +61,7 @@ dsh --profile web --dump-config
 
 组合结果里应有 `dsh-dev-index` 这一行。新会话在修改 DSH 插件或 Preset 之前，先加载 `dsh-dev-index` 这个 skill。
 
-## 配置
-
-补丁写出了唯一的键。后一层如果覆盖这一行，必须整份重写 `config`，因为补丁替换的是整个 `config` 对象。
-
-| 键 | 默认值 | 含义 |
-| --- | --- | --- |
-| `pagesBaseUrl` | `https://klarkxy.github.io/dsh-plugins/` | 写进 skill 正文的 http(s) 绝对基址。缺少末尾斜杠时会补上。GitHub 原始文件回退固定在本仓库的 `main`。 |
-
-## 更新索引
-
-每日步骤见 [docs/REFRESH.md](../../docs/REFRESH.md)。从 `docs/` 重新生成站点页面：
-
-```bash
-node plugins/dsh-dev-index/scripts/build-site.mjs
-```
+没有配置项。补丁只插入插件，不设置键。
 
 ## 许可证
 

package/cordis.patch.yml

@@ -1,5 +1,3 @@
 - insert:
     - id: dsh-dev-index
       name: '@klarkxy/dsh-dev-index'
-      config:
-        pagesBaseUrl: https://klarkxy.github.io/dsh-plugins/

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "@klarkxy/dsh-dev-index",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "main": "lib/index.js",
-  "description": "Workflow skill that helps an agent pick a DeepSeek Harness extension mechanism and deliver a verified plugin.",
+  "description": "Lightweight skill that points an agent at official DeepSeek Harness docs and runtime inspection.",
   "engines": {
     "dsh": ">=0.1.7-rc.2 <0.2.0"
   },

package/lib/index.d.ts

@@ -2,14 +2,9 @@ import type { Context } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
 export declare const name = "@klarkxy/dsh-dev-index";
 export declare const inject: string[];
-export declare const DEFAULT_PAGES_BASE_URL = "https://klarkxy.github.io/dsh-plugins/";
 export interface Config {
-    pagesBaseUrl: string;
 }
 export declare const Config: z<Config>;
-export interface ResolvedConfig {
-    readonly pagesBaseUrl: string;
-}
 export interface IndexedSkill {
     readonly name: string;
     readonly description: string;
@@ -26,8 +21,7 @@ export interface SkillHost {
         register(skill: IndexedSkill): () => void;
     };
 }
-export declare function normalizePagesBaseUrl(value: string): string;
-export declare function resolveConfig(config: Config): ResolvedConfig;
-export declare function createSkill(pagesBaseUrl: string): IndexedSkill;
+export declare function resolveConfig(config: Config | undefined): Config;
+export declare function createSkill(): IndexedSkill;
 export declare function apply(ctx: Context & SkillHost, config: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -2,48 +2,29 @@ import z from "@deepseek-ai/schemastery";
 import { renderSkillBody, SKILL_DESCRIPTION, SKILL_NAME, SKILL_WHEN_TO_USE } from "./skill-body.js";
 export const name = "@klarkxy/dsh-dev-index";
 export const inject = ["skills"];
-export const DEFAULT_PAGES_BASE_URL = "https://klarkxy.github.io/dsh-plugins/";
-export const Config = z.object({
-    pagesBaseUrl: z.string().default(DEFAULT_PAGES_BASE_URL),
-});
-const CONFIG_KEYS = new Set(["pagesBaseUrl"]);
-export function normalizePagesBaseUrl(value) {
-    let url;
-    try {
-        url = new URL(value);
-    }
-    catch {
-        throw new Error("dsh-dev-index: pagesBaseUrl must be an absolute http(s) URL");
-    }
-    if (url.protocol !== "http:" && url.protocol !== "https:") {
-        throw new Error("dsh-dev-index: pagesBaseUrl must be an absolute http(s) URL");
-    }
-    return value.endsWith("/") ? value : `${value}/`;
-}
+export const Config = z.object({});
 export function resolveConfig(config) {
-    if (config === null || typeof config !== "object") {
-        throw new Error("dsh-dev-index: configuration is required");
+    const value = config ?? {};
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("dsh-dev-index: configuration must be an object");
     }
-    for (const key of Object.keys(config)) {
-        if (!CONFIG_KEYS.has(key))
-            throw new Error(`dsh-dev-index: unknown config key "${key}"`);
+    for (const key of Object.keys(value)) {
+        throw new Error(`dsh-dev-index: unknown config key "${key}"`);
     }
-    return Object.freeze({
-        pagesBaseUrl: normalizePagesBaseUrl(config.pagesBaseUrl),
-    });
+    return Object.freeze({});
 }
-export function createSkill(pagesBaseUrl) {
+export function createSkill() {
     return {
         name: SKILL_NAME,
         description: SKILL_DESCRIPTION,
         whenToUse: SKILL_WHEN_TO_USE,
         source: "bundled",
         invocation: { modelInvocable: true, userInvocable: true },
-        content: renderSkillBody(pagesBaseUrl),
+        content: renderSkillBody(),
     };
 }
 export function apply(ctx, config) {
-    const resolved = resolveConfig(config);
-    ctx.skills.register(createSkill(resolved.pagesBaseUrl));
+    resolveConfig(config);
+    ctx.skills.register(createSkill());
 }
 //# sourceMappingURL=index.js.map

package/lib/skill-body.d.ts

@@ -1,10 +1,9 @@
-export declare const RAW_DOCS_BASE = "https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/";
 export declare const SKILL_NAME = "dsh-dev-index";
-export declare const SKILL_DESCRIPTION = "Pick a DeepSeek Harness extension mechanism and deliver a verified plugin. Prefer the official plugin-development skill and runtime inspection inside DSH. Cite pinned docs. Do not invent APIs.";
-export declare const SKILL_WHEN_TO_USE = "Use for DSH secondary development when choosing how to extend the harness: tools, execution policy, settings UI, panels, session-derived state, or providers.";
-/** Area ids the skill names so an agent knows what to fetch. Docs stay authoritative. */
-export declare const AREA_IDS: readonly ["orientation", "plugin-module", "bundle-profile-patch", "cli", "tools", "skills", "presets-persona", "system-prompt", "sessions-titles", "llm-providers", "hooks", "mcp", "ui-slots", "settings-approval", "plugin-manager-inspect", "other-seams"];
-/** Task ids. The architecture-rules guide is a page, not a task pack. */
-export declare const TASK_IDS: readonly ["add-a-tool", "add-a-tool-policy", "add-a-settings-ui", "add-a-ui-panel", "add-session-derived-state", "implement-or-replace-a-provider"];
-export declare function renderSkillBody(pagesBaseUrl: string): string;
+export declare const SKILL_DESCRIPTION = "Point at official DeepSeek Harness docs, the plugin-development skill, and runtime inspection. Do not invent APIs.";
+export declare const SKILL_WHEN_TO_USE = "Use for DSH secondary development: tools, execution policy, settings UI, panels, session-derived state, or providers.";
+export declare const OFFICIAL_DOCS_SITE = "https://deepseek-harness.github.io/deepseek-harness/";
+export declare const OFFICIAL_LLMS_TXT = "https://deepseek-harness.github.io/deepseek-harness/llms.txt";
+export declare const OFFICIAL_REPOSITORY = "https://github.com/deepseek-ai/deepseek-harness";
+export declare const OFFICIAL_RAW_DOCS = "https://raw.githubusercontent.com/deepseek-ai/deepseek-harness/master/docs/";
+export declare function renderSkillBody(): string;
 //# sourceMappingURL=skill-body.d.ts.map

package/lib/skill-body.js

@@ -1,76 +1,29 @@
 const BODY_LIMIT = 7500;
-export const RAW_DOCS_BASE = "https://raw.githubusercontent.com/klarkxy/dsh-plugins/main/docs/";
 export const SKILL_NAME = "dsh-dev-index";
-export const SKILL_DESCRIPTION = "Pick a DeepSeek Harness extension mechanism and deliver a verified plugin. Prefer the official plugin-development skill and runtime inspection inside DSH. Cite pinned docs. Do not invent APIs.";
-export const SKILL_WHEN_TO_USE = "Use for DSH secondary development when choosing how to extend the harness: tools, execution policy, settings UI, panels, session-derived state, or providers.";
-/** Area ids the skill names so an agent knows what to fetch. Docs stay authoritative. */
-export const AREA_IDS = [
-    "orientation",
-    "plugin-module",
-    "bundle-profile-patch",
-    "cli",
-    "tools",
-    "skills",
-    "presets-persona",
-    "system-prompt",
-    "sessions-titles",
-    "llm-providers",
-    "hooks",
-    "mcp",
-    "ui-slots",
-    "settings-approval",
-    "plugin-manager-inspect",
-    "other-seams",
-];
-/** Task ids. The architecture-rules guide is a page, not a task pack. */
-export const TASK_IDS = [
-    "add-a-tool",
-    "add-a-tool-policy",
-    "add-a-settings-ui",
-    "add-a-ui-panel",
-    "add-session-derived-state",
-    "implement-or-replace-a-provider",
-];
-export function renderSkillBody(pagesBaseUrl) {
+export const SKILL_DESCRIPTION = "Point at official DeepSeek Harness docs, the plugin-development skill, and runtime inspection. Do not invent APIs.";
+export const SKILL_WHEN_TO_USE = "Use for DSH secondary development: tools, execution policy, settings UI, panels, session-derived state, or providers.";
+export const OFFICIAL_DOCS_SITE = "https://deepseek-harness.github.io/deepseek-harness/";
+export const OFFICIAL_LLMS_TXT = "https://deepseek-harness.github.io/deepseek-harness/llms.txt";
+export const OFFICIAL_REPOSITORY = "https://github.com/deepseek-ai/deepseek-harness";
+export const OFFICIAL_RAW_DOCS = "https://raw.githubusercontent.com/deepseek-ai/deepseek-harness/master/docs/";
+export function renderSkillBody() {
     const lines = [
-        "Deliver a verified DeepSeek Harness plugin. Do not invent APIs. This skill does not bundle a copy of the docs.",
+        "Deliver a verified DeepSeek Harness plugin. Do not invent APIs. This skill does not copy official material.",
         "",
         "1. Confirm the development goal and the target DSH version: the tag or commit the process is actually running.",
-        "2. Read meta.json. officialTag and officialCommit are the DSH revision these pages were written against. If the target version differs, treat every page as unverified for that version and check type declarations and source pinned to the target commit. Do not silently substitute this index for another version.",
-        "3. Inside a running DSH, check whether the official cordis-plugin-development skill and the runtime tools cordis_inspect_list and cordis_inspect_query are available. Prefer that skill for install, configuration, and debugging, and prefer those tools for what is actually mounted. cordis_inspect_query does not itself request danger-full-access. Every plugin_manager action does. The environment's tool permission policy still applies to both.",
-        "4. Outside DSH, do not assume those tools exist. Read the docs, type declarations, and source pinned to the target version. Mark every conclusion that could not be runtime-verified.",
-        "5. Open the task index, pick one task, and load the linked area pages, official contracts, and constraints. Read tasks/architecture-rules.md before choosing a mechanism.",
-        "6. Verify the exact APIs you will call. Use runtime inspection when it is available. Otherwise use the pinned types. Do not copy an API from memory.",
-        "7. Implement, then run that task's verification checklist.",
-        "8. Report which checklist items were verified and which remain unverified.",
-        "",
-        "Context7 (/deepseek-ai/deepseek-harness) tracks master. Use it only as a secondary source for scattered examples. It is not this index's pinned revision. If it disagrees with the target version, ignore it.",
-        "",
-        "Fetch the English index from GitHub Pages:",
-        `- ${pagesBaseUrl}llms.txt`,
-        `- ${pagesBaseUrl}index.json`,
-        `- ${pagesBaseUrl}meta.json`,
-        `- ${pagesBaseUrl}tasks/index.md`,
-        `- ${pagesBaseUrl}tasks/<id>.md`,
-        `- ${pagesBaseUrl}tasks/architecture-rules.md`,
-        `- ${pagesBaseUrl}areas/<id>.md`,
-        "",
-        "index.json lists task ids, guide ids, and area ids. meta.json records officialTag and officialCommit. English is the default. Simplified Chinese human-readable pages live under zh/ (zh/llms.txt, zh/tasks/<id>.md, zh/areas/<id>.md). index.json and meta.json stay in English.",
-        "",
-        "If the Pages site does not respond, fetch the same files from GitHub main:",
-        `- ${RAW_DOCS_BASE}llms.txt`,
-        `- ${RAW_DOCS_BASE}index.json`,
-        `- ${RAW_DOCS_BASE}meta.json`,
-        `- ${RAW_DOCS_BASE}tasks/index.md`,
-        `- ${RAW_DOCS_BASE}tasks/<id>.md`,
-        `- ${RAW_DOCS_BASE}tasks/architecture-rules.md`,
-        `- ${RAW_DOCS_BASE}areas/<id>.md`,
-        "",
-        "Task ids:",
-        ...TASK_IDS.map((id) => `- ${id}`),
-        "",
-        "Area ids:",
-        ...AREA_IDS.map((id) => `- ${id}`),
+        "2. Inside a running DSH, prefer the official cordis-plugin-development skill when it is installed. Prefer cordis_inspect_list and cordis_inspect_query for what is actually mounted. Both are read-only and do not request danger-full-access. Every plugin_manager action needs danger-full-access or a one-off approval. The environment's own tool policy still applies. Outside DSH, do not assume that skill or those tools exist.",
+        `3. Read the official documentation site: ${OFFICIAL_DOCS_SITE} (Chinese at the site root, English under /en/). Its llms.txt is ${OFFICIAL_LLMS_TXT}. The site is the latest published release. Compare it with the target version.`,
+        `4. For docs, type declarations, and source, start at ${OFFICIAL_REPOSITORY} on master. Raw docs: ${OFFICIAL_RAW_DOCS}... If the target version differs from master, list tags on that repository, choose the matching dsh-v* tag, and replace master with that tag. Read docs, type declarations, and source from that one tag. Never silently mix versions.`,
+        "5. Official entry points on that same ref:",
+        "- docs/cookbook/extension-cookbook.md",
+        "- docs/cookbook/",
+        "- docs/subsystems/",
+        "- docs/tool-catalog.md",
+        "- docs/config-catalog.md",
+        "- packages/preset/agent-preset/skills/cordis-plugin-development/SKILL.md",
+        "- packages/preset/agent-preset/skills/cordis-plugin-development/references/practices.md",
+        "6. Verify the exact APIs you will call against runtime inspection when it is available, otherwise against the chosen ref.",
+        "7. Report which items were verified and which remain unverified.",
     ];
     const body = lines.join("\n");
     if (body.length > BODY_LIMIT) {

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "DSH development index",
-    "description": "Help an agent pick a DSH extension mechanism and deliver a verified plugin."
+    "description": "Point at official DSH docs, the plugin-development skill, and runtime inspection."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "DSH 开发索引",
-    "description": "帮助智能体选择 DSH 扩展机制并交付经过验证的插件。"
+    "description": "指向官方 DSH 文档、插件开发技能和运行时检查。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@klarkxy/dsh-dev-index",
-  "version": "0.1.1",
-  "description": "Workflow skill that helps an agent pick a DeepSeek Harness extension mechanism and deliver a verified plugin.",
+  "version": "0.1.2",
+  "description": "Lightweight skill that points an agent at official DeepSeek Harness docs and runtime inspection.",
   "icon": "./icon.svg",
   "keywords": [
     "dsh-plugin",
@@ -15,7 +15,7 @@
     "url": "git+https://github.com/klarkxy/dsh-plugins.git",
     "directory": "plugins/dsh-dev-index"
   },
-  "homepage": "https://klarkxy.github.io/dsh-plugins/",
+  "homepage": "https://deepseek-harness.github.io/deepseek-harness/",
   "bugs": {
     "url": "https://github.com/klarkxy/dsh-plugins/issues"
   },
@@ -50,10 +50,7 @@
     "prepare": "pnpm build",
     "prepack": "pnpm build",
     "typecheck": "tsc -p tsconfig.json",
-    "test": "vitest run",
-    "site": "node scripts/build-site.mjs",
-    "verify-citations": "node scripts/verify-citations.mjs",
-    "check-languages": "node scripts/check-languages.mjs"
+    "test": "vitest run"
   },
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
@@ -84,6 +81,6 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dshRelease": {
-    "contentHash": "271e90a176f8975205471618d07c5841fdbddbb080174f6e53c8226b6175b476"
+    "contentHash": "78283c526c5c409111d736bf2afa6dd6d592483019a8520e52697e3da7ad6ad2"
   }
 }