dsh-plugin-aghr 0.0.0-stage → 0.6.1

package/lib/client.js

@@ -0,0 +1,294 @@
+window.__ModuleLoader__.load({
+	id: "dsh-plugin-aghr",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		const React = require("react");
+		const h = React.createElement;
+
+		/** 本插件在客户端语言服务里的命名空间。 */
+		const NS = "dshPluginAghr";
+
+		//#region 样式
+		/**
+		 * 本页样式。
+		 *
+		 * 手写注入而不是 CSS 模块：本包没有编译步骤，`lib/client.js` 就是最终产物。
+		 * 只用 dsh 自己的设计令牌（`--dsw-alias-*` / `--dsw-radius-*`），跟随主题与明暗模式；
+		 * `data-plugin-css` 上的标记与官方客户端插件同一写法，重复挂载只注入一次。
+		 */
+		const CSS = [
+			".dsh-aghr-section{display:flex;flex-direction:column;gap:16px}",
+			".dsh-aghr-head{display:flex;flex-direction:column;gap:6px}",
+			".dsh-aghr-title{margin:0;font-size:20px;font-weight:500;line-height:28px}",
+			".dsh-aghr-lede{margin:0;font-size:14px;line-height:22px;color:var(--dsw-alias-label-secondary)}",
+			".dsh-aghr-block{display:flex;flex-direction:column;gap:8px}",
+			".dsh-aghr-block-title{margin:0;font-size:14px;font-weight:500;line-height:20px}",
+			".dsh-aghr-muted{margin:0;color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:20px}",
+			".dsh-aghr-list{margin:0;padding-left:20px;display:flex;flex-direction:column;gap:6px}",
+			".dsh-aghr-list li{font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary)}",
+			".dsh-aghr-facts{margin:0}",
+			".dsh-aghr-facts div{display:flex;align-items:center;justify-content:space-between;gap:16px;min-height:40px;padding:6px 2px;border-bottom:.5px solid var(--dsw-alias-border-l2)}",
+			".dsh-aghr-facts dt{flex:none;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}",
+			".dsh-aghr-facts dd{margin:0;min-width:0;text-align:end;overflow-wrap:anywhere;font-size:13px;line-height:20px}",
+			".dsh-aghr-code{font-family:var(--ds-font-family-code);font-size:12px;padding:2px 6px;border-radius:4px;background:var(--dsw-alias-bg-module-platform);box-decoration-break:clone}",
+			".dsh-aghr-note{margin:0;display:flex;align-items:flex-start;gap:8px;padding:10px 12px;border-radius:var(--dsw-radius-md);background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}",
+			".dsh-aghr-steps{margin:0;padding:0;list-style:none;display:flex;flex-direction:column;gap:10px;counter-reset:dsh-aghr-step}",
+			".dsh-aghr-steps li{display:flex;gap:10px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary)}",
+			".dsh-aghr-steps li:before{counter-increment:dsh-aghr-step;content:counter(dsh-aghr-step);flex:none;display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;border-radius:50%;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-primary);font-size:11px;font-weight:500}",
+		].join("");
+
+		const CSS_TAG_ID = "dsh-plugin-aghr/aghrSection.css";
+		if (
+			typeof document !== "undefined" &&
+			document.querySelector("style[data-plugin-css=" + JSON.stringify(CSS_TAG_ID) + "]") === null
+		) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "dsh-plugin-aghr";
+			tag.dataset.pluginCss = CSS_TAG_ID;
+			tag.textContent = CSS;
+			document.head.appendChild(tag);
+		}
+		//#endregion
+
+		//#region 文案
+		/** 中文文案。 */
+		const zh = {
+			tabLabel: "AGHR",
+			title: "AGHR 团队（中文）",
+			lede: "让模型把复杂任务做完、做对：先探清题目，再决定拆不拆；拆开的每一步都能被检查，验不了的地方老实标成不确定。",
+			whatTitle: "它解决什么",
+			whatBody:
+				"一次性要模型给出完整答案，常见毛病是跳步、隐含假设不说、中间错了一路往后传，最后你还没法核验。这个包把「拆不拆、拆到哪、怎么验」变成一套能照着走的流程，并且让执行和审计由不同的角色来做——因为模型说「我算对了」本身不是证据。",
+			contentsTitle: "装了什么",
+			contentPresetTitle: "1. 一个会话预设",
+			contentPresetBody:
+				"新建会话时选上它，会话里就有四个职责位：Leader 对接你并对交付负责，Planner 拆任务定验收标准，Operator 干活，Validator 事后审计。",
+			contentSkillTitle: "2. 一份方法技能",
+			contentSkillBody:
+				"技能正文随包分发，插件启用时注册给会话。内容是照着做的流程：先探测、按认知难点拆、给每个节点定验收条件、验不过就分类回退、结论标验证状态。",
+			contentUiTitle: "3. 这一页",
+			contentUiBody: "Plugins 页里的说明页，讲清这个包是什么、怎么用、代价在哪。",
+			usageTitle: "怎么用",
+			usageStep1: "新建会话时在预设选择里挑「AGHR 团队（中文）」，会话就按四个职责位分工。",
+			usageStep2: "技能默认可用，模型自己会调；也可以直接说「用 aghr 拆这个问题」。",
+			usageStep3: "适合结果必须能验的任务：教材级题目、工程计算、多步代码改动、多来源核对。",
+			usageStep4: "在 Plugins 页停用本包就回到你原来的预设，它不改任何全局配置。",
+			factsTitle: "包信息",
+			factPackage: "包名",
+			factVersion: "版本",
+			factPreset: "预设",
+			factSkill: "技能",
+			factSlots: "客户端位置",
+			factSlotsValue: "Plugins 页：一个标签页，加详情页里的一段说明",
+			noteTitle: "注意",
+			noteDuplicate: "这个包比别的预设更费上下文和时间：它的取向是宁可多花也要把任务做完，不是省 token。",
+			noteShadow:
+				"技能同名冲突：工作区里已经有同名技能时以工作区那份为准——项目级目录的优先级高于包内注册，不是本包的缺陷。",
+			detailTitle: "这个包里的东西",
+			detailBody: "一个会话预设、一份方法技能，以及 Plugins 页里的这一页说明。",
+		};
+
+		/** 英文文案。 */
+		const en = {
+			tabLabel: "AGHR",
+			title: "AGHR team (Chinese)",
+			lede: "For finishing hard tasks right: probe the task first, decide whether and where to split, keep every step checkable, and mark what cannot be verified as uncertain.",
+			whatTitle: "What it solves",
+			whatBody:
+				"Asking a model for the full answer in one shot tends to skip steps, hide assumptions, carry an early error to the end, and leave you no way to check. This package turns “whether to split, where, and how to verify” into a procedure, and separates doing from auditing — a model saying “it is correct” is not evidence.",
+			contentsTitle: "What is inside",
+			contentPresetTitle: "1. A session preset",
+			contentPresetBody:
+				"Pick it when starting a session and you get four seats: Leader faces you and owns delivery, Planner splits the task and sets acceptance criteria, Operator does the work, Validator audits afterwards.",
+			contentSkillTitle: "2. A method skill",
+			contentSkillBody:
+				"The skill body ships with the package and is registered when the plugin loads: probe first, split by cognitive difficulty, give each node acceptance criteria, classify failures and roll back, label every conclusion with a verification status.",
+			contentUiTitle: "3. This page",
+			contentUiBody: "A page in Plugins explaining what the package is, how to use it, and what it costs.",
+			usageTitle: "How to use it",
+			usageStep1: "Start a session and choose “AGHR 团队（中文）” in the preset selector; the session then works in four seats.",
+			usageStep2: "The skill is available by default; you can also say “use aghr to split this”.",
+			usageStep3: "Best fit: tasks whose results must be checkable — textbook problems, engineering calculations, multi-step code changes, cross-source checks.",
+			usageStep4: "Disabling the bundle in Plugins returns you to your previous preset; no global configuration is changed.",
+			factsTitle: "Package",
+			factPackage: "Package",
+			factVersion: "Version",
+			factPreset: "Preset",
+			factSkill: "Skill",
+			factSlots: "Client surface",
+			factSlotsValue: "Plugins page: one tab, plus a section on the detail page",
+			noteTitle: "Caveats",
+			noteDuplicate: "This preset spends more context and time than others: it is built to finish the task, not to save tokens.",
+			noteShadow:
+				"Same-named skills: a skill in the workspace wins over the bundled one — project roots outrank runtime registration, and that is by design.",
+			detailTitle: "Inside this package",
+			detailBody: "A session preset, a method skill, and this page in Plugins.",
+		};
+		//#endregion
+
+		//#region 组件
+		/**
+		 * 一行键值对。
+		 *
+		 * @param {object} props - `{ label, value }`。
+		 * @returns {object} React 元素。
+		 */
+		function Fact(props) {
+			return h("div", null, h("dt", null, props.label), h("dd", null, props.value));
+		}
+
+		/**
+		 * 小标题 + 内容块。
+		 *
+		 * @param {object} props - `{ title, children }`。
+		 * @returns {object} React 元素。
+		 */
+		function Block(props) {
+			return h(
+				"section",
+				{ className: "dsh-aghr-block" },
+				h("h3", { className: "dsh-aghr-block-title" }, props.title),
+				props.children,
+			);
+		}
+
+		/**
+		 * 本包的说明正文。
+		 *
+		 * @param {object} props - 由 `inject()` 合入的 `{ t }`，以及 slot 提供的标准 props。
+		 * @returns {object} React 元素。
+		 */
+		function AghrSection(props) {
+			const t = props.t;
+			return h(
+				"div",
+				{ className: "dsh-aghr-section" },
+				h(
+					"header",
+					{ className: "dsh-aghr-head" },
+					h("h2", { className: "dsh-aghr-title" }, t("title")),
+					h("p", { className: "dsh-aghr-lede" }, t("lede")),
+				),
+				h(Block, { title: t("whatTitle") }, h("p", { className: "dsh-aghr-muted" }, t("whatBody"))),
+				h(
+					Block,
+					{ title: t("contentsTitle") },
+					h(
+						"ul",
+						{ className: "dsh-aghr-list" },
+						h("li", null, h("strong", null, t("contentPresetTitle")), " — ", t("contentPresetBody")),
+						h("li", null, h("strong", null, t("contentSkillTitle")), " — ", t("contentSkillBody")),
+						h("li", null, h("strong", null, t("contentUiTitle")), " — ", t("contentUiBody")),
+					),
+				),
+				h(
+					Block,
+					{ title: t("usageTitle") },
+					h(
+						"ol",
+						{ className: "dsh-aghr-steps" },
+						h("li", null, t("usageStep1")),
+						h("li", null, t("usageStep2")),
+						h("li", null, t("usageStep3")),
+						h("li", null, t("usageStep4")),
+					),
+				),
+				h(
+					Block,
+					{ title: t("factsTitle") },
+					h(
+						"dl",
+						{ className: "dsh-aghr-facts" },
+						h(Fact, { label: t("factPackage"), value: h("code", { className: "dsh-aghr-code" }, "dsh-plugin-aghr") }),
+						// 版本号要与 package.json 一致（浏览器半读不到 manifest，只能写在这里）。
+						h(Fact, { label: t("factVersion"), value: "0.6.1" }),
+						h(Fact, { label: t("factPreset"), value: h("code", { className: "dsh-aghr-code" }, "aghr") }),
+						h(Fact, { label: t("factSkill"), value: h("code", { className: "dsh-aghr-code" }, "aghr") }),
+						h(
+							Fact,
+							{
+								label: t("factSlots"),
+								value: t("factSlotsValue"),
+							},
+						),
+					),
+				),
+				h(
+					Block,
+					{ title: t("noteTitle") },
+					h("p", { className: "dsh-aghr-note" }, t("noteDuplicate")),
+					h("p", { className: "dsh-aghr-note" }, t("noteShadow")),
+				),
+			);
+		}
+
+		/**
+		 * 本包详情页上的补充段。
+		 *
+		 * 只在打开本包的页面时渲染；其它 bundle / 行 / 官方插件一律返回 null。
+		 *
+		 * @param {object} props - `{ t, subject }`。
+		 * @returns {object|null} React 元素。
+		 */
+		function AghrDetailSection(props) {
+			const subject = props.subject;
+			const name = subject !== undefined && subject.kind === "bundle" ? subject.pkg.name : undefined;
+			if (name !== "dsh-plugin-aghr") return null;
+			const t = props.t;
+			return h(
+				"section",
+				{ className: "dsh-aghr-block" },
+				h("h3", { className: "dsh-aghr-block-title" }, t("detailTitle")),
+				h("p", { className: "dsh-aghr-muted" }, t("detailBody")),
+			);
+		}
+		//#endregion
+
+		/** 依赖的客户端服务。 */
+		const inject = ["slots", "locale"];
+
+		/**
+		 * 注册文案与两个槽位。
+		 *
+		 * @param {import("@deepseek-ai/cordis").Context} ctx - 浏览器插件上下文。
+		 */
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, { zh, en }), "dsh-plugin-aghr: dictionaries");
+			const t = ctx.locale.bind(NS);
+
+			// Plugins 页顶部的「AGHR」标签页：说明这个包干什么、装了什么、怎么用。
+			// 参数形状照 @deepseek-ai/dsh-client-ui-plugin-market/lib/client.js 的「发现」标签页。
+			ctx.slots.inject("plugins.tab", () =>
+				ctx.slots.register(
+					{
+						name: "plugins.tab",
+						id: "aghr",
+						order: 60,
+						label: () => t("tabLabel"),
+						locale: NS,
+						inject: () => ({ t }),
+					},
+					AghrSection,
+				),
+			);
+
+			// 本包自己的详情页：只对 subject.kind === "bundle" 且 pkg.name 为本包名的页面渲染。
+			ctx.slots.inject("plugins.detail.section", () =>
+				ctx.slots.register(
+					{
+						name: "plugins.detail.section",
+						id: "aghr-detail",
+						order: 60,
+						inject: () => ({ t }),
+					},
+					AghrDetailSection,
+				),
+			);
+		}
+
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	},
+});

package/lib/index.js

@@ -0,0 +1,304 @@
+/**
+ * dsh-plugin-aghr —— Host 半。
+ *
+ * 做两件事，都走运行时 API，不往 profile 里贴预设：
+ *   1) 把包内 `skill/SKILL.md` 注册成名为 `aghr` 的技能；
+ *   2) 用 `ctx.agentPresets.register()` 注册预设 `aghr`（四职责位团队版）。
+ * 另外它让本包出现在 host Loader 的行表里：`@deepseek-ai/dsh-client-modules`
+ * 按行名解析到本包的 package.json、读 `dsh.client`，才会加载浏览器半 `./client`。
+ *
+ * 为什么不把预设写进 cordis.patch.yml：那样写出来的是一份**静态复制的插件表**，
+ * 换一台机器、换一个版本就得整份重抄，而且会把别人 profile 里的本机配置（绝对路径、
+ * 私有 MCP）一起带出去。`ctx.agentPresets.register()` 接受 `{ id, name, description,
+ * order, plugins }`，`plugins` 是普通的 Cordis 行表，所以在代码里按需挑行、按需给
+ * 配置即可：这份包只声明自己真正需要的行。
+ *
+ * 为什么不给 `@deepseek-ai/dsh-skill-filesystem` 配 `customSkillDirs` / `bundledSkillDir`：
+ * 这两个配置项只有"目录路径"一种表达方式，前者按 dsh 进程 cwd 解析，后者是单值且默认
+ * 取环境变量 `DSH_BUNDLED_SKILL_DIR`，第三方包没法指向自己包内目录，只能写死绝对路径。
+ * `ctx.skills.register()` 不需要任何路径配置。
+ *
+ * @module dsh-plugin-aghr
+ */
+
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+/** 包内技能正文的位置；用 import.meta.url 定位，不写死绝对路径。 */
+const SKILL_URL = new URL("../skill/SKILL.md", import.meta.url);
+
+/** 注册到 `ctx.skills` 的技能名，与 SKILL.md frontmatter 的 name 一致。 */
+const SKILL_NAME = "aghr";
+
+/** 预设的治理正文，随包分发，改文本不用改代码。 */
+const PERSONA_URL = new URL("../assets/persona-aghr.md", import.meta.url);
+
+/** 技能的资源根：模型提到 skill 里的相对路径时按这里解析。 */
+const RESOURCE_BASE = {
+	kind: "directory",
+	path: fileURLToPath(new URL("../assets/", import.meta.url))
+};
+
+/** 随包技能在目录里的排序权重，与 skill-filesystem 的随包根同级。 */
+const BUNDLED_SKILL_RANK = 600;
+
+/**
+ * frontmatter 缺失或解析失败时的兜底描述。
+ *
+ * `ctx.skills.register()` 要求 description 是非空字符串（dsh-skill 的
+ * validateRuntimeSkill 会直接读 `skill.description.length`），所以这条兜底不能省。
+ */
+const FALLBACK_DESCRIPTION =
+	"自适应粒度人机协同求解（AGHR）：先探测再决定要不要拆、怎么拆，用可验证性分类与验证状态控制错误传播。";
+
+/**
+ * 拆出 YAML frontmatter 与正文。
+ *
+ * 只实现本技能需要的极小子集（`---` 包裹、单行 `key: value` 标量），不引入 YAML 依赖：
+ * 本包要能被任意 profile 直接 link，多一个依赖就多一处版本冲突。
+ *
+ * 解析不出 description 时保留兜底描述、仍把正文交给技能服务——宁可退化，不要让技能消失。
+ *
+ * @param {string} raw - SKILL.md 的完整内容。
+ * @returns {{ description: string, content: string }} 技能定义所需的描述与正文。
+ */
+function parseSkill(raw) {
+	const text = raw.replace(/^\uFEFF/, "");
+	const opening = /^---[ \t]*\r?\n/.exec(text);
+	if (opening === null) return { description: FALLBACK_DESCRIPTION, content: text };
+
+	const rest = text.slice(opening[0].length);
+	const closing = /^(?:---|\.\.\.)[ \t]*\r?\n/m.exec(rest);
+	if (closing === null) return { description: FALLBACK_DESCRIPTION, content: text };
+
+	const frontmatter = rest.slice(0, closing.index);
+	const content = rest.slice(closing.index + closing[0].length);
+	if (content.trim() === "") return { description: FALLBACK_DESCRIPTION, content: text };
+
+	let description = "";
+	for (const line of frontmatter.split(/\r?\n/)) {
+		const match = /^description[ \t]*:[ \t]*(.*)$/.exec(line);
+		if (match === null) continue;
+		let value = match[1].trim();
+		// 去掉可能存在的成对引号；本技能的 description 是裸标量，这里只是容错。
+		if (value.length >= 2 && (value[0] === '"' || value[0] === "'") && value.at(-1) === value[0]) {
+			value = value.slice(1, -1);
+		}
+		description = value;
+		break;
+	}
+
+	return { description: description === "" ? FALLBACK_DESCRIPTION : description, content };
+}
+
+// ── 预设行表 ────────────────────────────────────────────────────────────────
+// 每一行都是本包自己挑的，不照抄任何一台机器的 profile。
+// 需要什么能力就放什么行；放不进去的能力（比如本机私有 MCP）交给使用者自己加。
+
+const PREFIX = "“如果你忘记了自己是谁，回看工作区 AGENTS.md——那里有我给你的信件”。--tigrisheep";
+
+const personaRow = (suffix) => ({
+	id: "persona",
+	name: "@deepseek-ai/dsh-persona",
+	config: { prefix: PREFIX, suffix }
+});
+
+const ROW = {
+	instructions: { id: "agent-instructions", name: "@deepseek-ai/dsh-agent-instructions", config: { maxBytes: 65536 } },
+	time: { id: "time-context", name: "@deepseek-ai/dsh-time-context" },
+	fs: { id: "tool-fs", name: "@deepseek-ai/dsh-tool-fs" },
+	fsSearch: {
+		id: "tool-fs-search",
+		name: "@deepseek-ai/dsh-tool-fs-search",
+		config: { sampleOverCapGlobResults: false }
+	},
+	bash: { id: "tool-bash", name: "@deepseek-ai/dsh-tool-bash", disabled: process.platform === "win32" },
+	pwsh: { id: "tool-pwsh", name: "@deepseek-ai/dsh-tool-pwsh", disabled: process.platform !== "win32" },
+	jobs: { id: "tool-jobs", name: "@deepseek-ai/dsh-tool-jobs" },
+	web: { id: "tool-web", name: "@deepseek-ai/dsh-tool-web", config: { fetch: true, searchTimeoutMs: 60000 } },
+	skillFiles: { id: "skill-filesystem", name: "@deepseek-ai/dsh-skill-filesystem" },
+	skillTool: { id: "tool-skill", name: "@deepseek-ai/dsh-tool-skill" },
+	todo: { id: "tool-todo", name: "@deepseek-ai/dsh-tool-todo", config: { allowParallelInProgress: true } },
+	ask: { id: "tool-ask-user", name: "@deepseek-ai/dsh-tool-ask-user" },
+	present: { id: "present", name: "@deepseek-ai/dsh-tool-present" },
+	subagent: {
+		id: "tool-subagent",
+		name: "@deepseek-ai/dsh-tool-subagent",
+		config: { provider: "spawn", toolName: "subagent", modelSelectionSettings: true }
+	},
+	subagentControl: { id: "tool-subagent-control", name: "@deepseek-ai/dsh-tool-subagent-control" },
+	subagentList: { id: "tool-subagent-list-agents", name: "@deepseek-ai/dsh-tool-subagent-control/list-agents" }
+};
+
+/**
+ * 压缩：必须整组装进同一个 isolate 隔离域。
+ *
+ * `command-compact` 注入 `compaction` 服务；如果提供者 `compaction-basic` 单独加
+ * `isolate: { compaction: true }`，它就在自己的隔离域里，域外的 `command-compact`
+ * 永远等不到这个服务，装配会以 `waiting for compaction` 报错。所以这里用 group 行
+ * 承载 isolate，让提供者与消费者落在同一域内。
+ *
+ * `tool-result-pruner` 同样提供域内服务 `toolResultPruner`（`compaction-basic` 用
+ * `ctx.get("toolResultPruner")` 按需取用，取不到就退回不裁剪），所以它的服务名也必须
+ * 写进 isolate 映射——漏写会让该实现登记到 root realm，预设挂载直接失败：
+ * `Preset services require isolate realms: toolResultPruner`。
+ *
+ * **相对 0.4.1，这一行是新增的，属行为变化而不是纯修复**：装了本预设的会话里，`bash` / `read`
+ * 超过阈值的长输出会被裁掉中间一段（头尾保留），上下文增长更慢、更晚触发压缩，模型看到的工具
+ * 结果也随之变短。这条不写 config，用插件自身默认 8192/4096/1024。
+ *
+ * 不设 `compaction-basic.config.modelPolicies`：那是「本机 provider/model 组合 + 每档
+ * 预算」的机器相关配置，写进包里等于把别人的模型清单当默认值；`thresholdRatio` 等
+ * 通用预算也交给插件自身默认值，避免和上游默认值漂移。`tool-result-pruner` 同理不传
+ * config，用包内默认 8192/4096/1024。
+ *
+ * 这份常量对外导出，仅作可复核的测试缝：验证脚本可以拿它单独装配一次压缩域。
+ */
+const COMPACTION_ROWS = [
+	{
+		id: "compaction",
+		name: "cordis:group",
+		group: true,
+		isolate: { compaction: true, toolResultPruner: true },
+		config: [
+			{ id: "compaction-basic", name: "@deepseek-ai/dsh-compaction-basic" },
+			{ id: "command-compact", name: "@deepseek-ai/dsh-command-compact" },
+			{ id: "tool-result-pruner", name: "@deepseek-ai/dsh-compaction-tool-result-pruner" }
+		]
+	}
+];
+
+/**
+ * 团队版行表：四职责位要能读、能算、能检索、能派活、能计划。
+ *
+ * 刻意不含的东西：本机私有 MCP、run_code 之外的自定义工具、任何绝对路径。
+ */
+function teamRows(suffix) {
+	return [
+		personaRow(suffix),
+		ROW.instructions,
+		ROW.time,
+		ROW.bash,
+		ROW.pwsh,
+		ROW.fs,
+		ROW.fsSearch,
+		ROW.jobs,
+		ROW.skillFiles,
+		ROW.skillTool,
+		ROW.web,
+		ROW.subagent,
+		ROW.subagentControl,
+		ROW.subagentList,
+		ROW.ask,
+		ROW.todo,
+		ROW.present,
+		...COMPACTION_ROWS
+	];
+}
+
+const PRESET = {
+	id: "aghr",
+	name: "AGHR 团队（中文）",
+	description: "四职责位：Leader 管用户与交付，Planner 管规划与事后决策，Operator 管执行，Validator 管事后审计。",
+	order: 6,
+	rows: teamRows
+};
+
+function readText(url) {
+	return readFileSync(url, "utf8");
+}
+
+/** Cordis 插件名。 */
+const name = "dsh-plugin-aghr";
+
+/**
+ * 依赖的服务：`skills` 负责技能注册，`agentPresets` 负责预设注册。
+ *
+ * 缺任一服务的 profile 里本行不会启用（技能与预设自然不可用），但浏览器半照样加载：
+ * 客户端发现看的是 Loader 行表，不看这一行是否 apply 成功。
+ */
+const inject = ["skills", "agentPresets"];
+
+/**
+ * 注册预设，并把它自己的注销函数交给本插件的 fiber。
+ *
+ * `ctx.agentPresets.register()` 是 **async**，成功时返回这份定义自己的注销函数。
+ * 那个返回值必须挂到 `ctx.effect` 上：热重载时 Cordis 先 dispose 旧 fiber、再重新执行
+ * 本插件的 `apply`，没有注销动作，旧定义就留在 `registry.definitions` 里，第二次
+ * `register()` 直接抛 `Duplicate agent preset: aghr`（web.log 里表现为
+ * `dsh: fatal load failure`）。
+ *
+ * 注意两件容易写错的事：
+ *
+ * 1. **必须 await**。`register()` 拒绝时（id 重复、id 为空字符串）异常是走 promise
+ *    拒绝的，不 await 就变成未捕获拒绝，绕开下面这个 try/catch，还会打断整条 Loader 行。
+ * 2. **挂 disposer 只挂一份**。effect 的回调立即执行、返回的就是注销函数，不要在回调里
+ *    再调一次 `register()`：那会在每次重载时多注册一份，反过来杀掉新实例。
+ *
+ * 装配期（mountPreset）的失败不会让 promise 拒绝——registry 自己把诊断记成 `broken`
+ * 并写一条 warn，所以这里 catch 到的都是「定义没能登记」这一层的问题。
+ *
+ * @param {import("@deepseek-ai/cordis").Context} ctx - Host 插件上下文。
+ */
+async function registerPreset(ctx) {
+	let unregister;
+	try {
+		const suffix = readText(PERSONA_URL);
+		unregister = await ctx.agentPresets.register({
+			id: PRESET.id,
+			name: PRESET.name,
+			description: PRESET.description,
+			order: PRESET.order,
+			plugins: PRESET.rows(suffix)
+		});
+	} catch (error) {
+		ctx.logger.error(`dsh-plugin-aghr: 注册预设 ${PRESET.id} 失败：${String(error)}`);
+		return;
+	}
+
+	try {
+		ctx.effect(() => () => unregister(), "dsh-plugin-aghr: agent preset");
+	} catch (error) {
+		// 注册期间本插件的 fiber 已被卸载（热重载的竞态窗口）：effect 挂不上去，
+		// 就得当场自己注销，否则这份定义会永久留在 registry 里。
+		//
+		// 注销动作自身也要包住：它若再抛，异常会从 `apply` 冒出去，把整条 Loader 行打成
+		// FAILED —— 正是本次修复要消灭的形态。故失败只记日志、照常返回；代价是那份定义
+		// 残留在 registry 里，随进程重启消失。成功路径的顺序未变（先 await，后 warn）。
+		try {
+			await unregister();
+			ctx.logger.warn(`dsh-plugin-aghr: 预设 ${PRESET.id} 登记期间插件已卸载，已当场注销：${String(error)}`);
+		} catch (failure) {
+			ctx.logger.error(`dsh-plugin-aghr: 预设 ${PRESET.id} 登记期间插件已卸载，且当场注销失败（定义残留至重启）：${String(failure)}；原始错误：${String(error)}`);
+		}
+	}
+}
+
+/**
+ * 注册技能与预设。
+ *
+ * 两件事各自 try/catch：技能失败不该连带预设消失，预设失败也不该让技能掉线。
+ * `ctx.skills.register()` 自己把清理动作挂到调用方 fiber 上（`skills.register()`
+ * effect），本函数不需要额外处理；`ctx.agentPresets.register()` 则相反，清理函数由
+ * 调用方负责，见 {@link registerPreset}。
+ *
+ * 返回的 promise 不会拒绝：本函数内部已吞掉全部失败，只写日志。这样包内资产缺失或
+ * 注册失败都不会把整条 Loader 行打成 FAILED，浏览器半照常加载。
+ *
+ * @param {import("@deepseek-ai/cordis").Context} ctx - Host 插件上下文。
+ */
+async function apply(ctx) {
+	let content = "";
+	let description = FALLBACK_DESCRIPTION;
+	try {
+		({ content, description } = parseSkill(readText(SKILL_URL)));
+		ctx.skills.register({ name: SKILL_NAME, description, content, resourceBase: RESOURCE_BASE, rank: BUNDLED_SKILL_RANK });
+	} catch (error) {
+		// 包内资产缺失是打包错误。记一条错误就退出，不要抛出把整条 Loader 行打成 FAILED。
+		ctx.logger.error(`dsh-plugin-aghr: 注册技能 aghr 失败：${String(error)}`);
+	}
+
+	await registerPreset(ctx);
+}
+
+export { COMPACTION_ROWS, apply, inject, name, parseSkill };

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "AGHR team (Chinese)",
+    "description": "For anyone who needs a model to get hard tasks right: a Chinese preset plus a method skill that probes before splitting and says what can be verified."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "AGHR 团队（中文）",
+    "description": "给需要模型把复杂任务做对的人：一个中文预设配一份方法技能，先探清再决定拆不拆，每个结论都标出能不能验。"
+  }
+}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "dsh-plugin-aghr",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.6.1",
+  "private": false,
+  "description": "AGHR（自适应粒度人机协同求解）：一个四职责位中文 agent preset、一份 AGHR skill，以及 Plugins 页上的说明页。",
+  "author": "tigrisheep",
+  "icon": "./icon.svg",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./assets/persona-aghr.md": "./assets/persona-aghr.md",
+    "./CHANGELOG.md": "./CHANGELOG.md",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./skill/SKILL.md": "./skill/SKILL.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "assets/*.md",
+    "cordis.patch.yml",
+    "icon.svg",
+    "lib/client.js",
+    "lib/index.js",
+    "locale/*.json",
+    "skill/SKILL.md"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "aghr",
+    "agent-preset",
+    "skill"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
+      ]
+    }
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/tigrisheep/dsh-plugin-aghr#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tigrisheep/dsh-plugin-aghr.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tigrisheep/dsh-plugin-aghr/issues"
+  }
+}