@v587d/capital-generation 2.10.0 → 2.10.1

package/lib/capital-settings.d.ts

@@ -6,7 +6,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { RetrieverConfig } from './retriever-config.js';
-import type { SelectedSkillSelection } from './agents/selected-skills-provider.js';
+import type { SelectedSkillSelection, SelectedSkillsMode } from './agents/selected-skills-provider.js';
 export declare const CAPITAL_CONFIG_ENTRY_ID = "capital-config";
 /** Fields this repo consumes (the host half owns the rest). */
 export interface CapitalConfigSlice {
@@ -15,7 +15,18 @@ export interface CapitalConfigSlice {
     customPersona?: string;
     retriever?: RetrieverConfig;
     selectedSkills?: SelectedSkillSelection;
+    selectedSkillsMode?: SelectedSkillsMode;
 }
+export type CapitalEntrySource = 'settings-describe' | 'config-editor';
+/**
+ * Settings first, then the config-editor save layer. The selected-skill provider and the
+ * persona section live in a separate preset row; reading only `settings.describe()` there
+ * made a saved toggle look all-off whenever the settings projection was not ready.
+ */
+export declare function readCapitalEntry(ctx: Context): {
+    value?: Record<string, unknown>;
+    source?: CapitalEntrySource;
+};
 export declare function readCapitalConfig(ctx: Context): CapitalConfigSlice;
 /** Flat credential refs needed by the collector domain (same shape as `CollectorConfig`). */
 export declare function readCollectorConfig(ctx: Context): {

package/lib/capital-settings.js

@@ -1,12 +1,32 @@
 export const CAPITAL_CONFIG_ENTRY_ID = 'capital-config';
-export function readCapitalConfig(ctx) {
+/**
+ * Settings first, then the config-editor save layer. The selected-skill provider and the
+ * persona section live in a separate preset row; reading only `settings.describe()` there
+ * made a saved toggle look all-off whenever the settings projection was not ready.
+ */
+export function readCapitalEntry(ctx) {
     try {
         const settings = ctx.get('settings');
-        return settings?.describe?.().find((entry) => entry?.ns === CAPITAL_CONFIG_ENTRY_ID)?.value ?? {};
+        const value = settings?.describe?.().find((entry) => entry?.ns === CAPITAL_CONFIG_ENTRY_ID)?.value;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            return { value: value, source: 'settings-describe' };
+        }
     }
     catch {
-        return {};
     }
+    try {
+        const editor = ctx.get('configEditor');
+        const value = editor?.entries?.().find((row) => row?.options?.id === CAPITAL_CONFIG_ENTRY_ID)?.options?.config;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            return { value: value, source: 'config-editor' };
+        }
+    }
+    catch {
+    }
+    return {};
+}
+export function readCapitalConfig(ctx) {
+    return (readCapitalEntry(ctx).value ?? {});
 }
 /** Flat credential refs needed by the collector domain (same shape as `CollectorConfig`). */
 export function readCollectorConfig(ctx) {

package/lib/index.d.ts

@@ -1,15 +1,16 @@
 import { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-import { type SelectedSkillSelection } from './agents/selected-skills-provider.js';
+import { type SelectedSkillSelection, type SelectedSkillsMode } from './agents/selected-skills-provider.js';
+import { CAPITAL_CONFIG_ENTRY_ID } from './capital-settings.js';
 import { type RetrieverConfig } from './retriever-config.js';
 export { LOCAL_FETCH_DEFAULTS, PADDLE_OCR_DEFAULTS, resolveLocalFetchConfig, type LocalFetchConfig, type PaddleOcrConfig, type RetrieverConfig, type WindDocsConfig, } from './retriever-config.js';
 export { resolveUserCustomizationSection } from './user-customization.js';
 export declare const name = "capital-generation";
-/** Entry id shared by `cordis.patch.yml`, `config/index.js` and `client.src.cjs`; drift hides the settings card. */
-export declare const CAPITAL_CONFIG_ENTRY_ID = "capital-config";
+export { CAPITAL_CONFIG_ENTRY_ID };
 export interface Config {
     customPersona?: string;
     selectedSkills?: SelectedSkillSelection;
+    selectedSkillsMode?: SelectedSkillsMode;
     fuyaoCredentialRef?: string;
     ftshareCredentialRef?: string;
     retriever?: RetrieverConfig;
@@ -21,6 +22,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     }>>, Schemastery.ObjectT<NoInfer<{
         [k: string]: z<boolean, boolean, "defined">;
     }>>, "defined">;
+    selectedSkillsMode: z<"manual" | "auto", "manual" | "auto", "defined">;
     fuyaoCredentialRef: z<string, string, "defined">;
     ftshareCredentialRef: z<string, string, "defined">;
     retriever: z<Schemastery.ObjectS<NoInfer<{
@@ -107,6 +109,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     }>>, Schemastery.ObjectT<NoInfer<{
         [k: string]: z<boolean, boolean, "defined">;
     }>>, "defined">;
+    selectedSkillsMode: z<"manual" | "auto", "manual" | "auto", "defined">;
     fuyaoCredentialRef: z<string, string, "defined">;
     ftshareCredentialRef: z<string, string, "defined">;
     retriever: z<Schemastery.ObjectS<NoInfer<{

package/lib/index.js

@@ -10,6 +10,7 @@ import { registerChartTool } from './chart/tool.js';
 import { createChartEventPublisher } from './chart/events.js';
 import { chartEventContextOf } from './chart/event-context.js';
 import { SELECTED_SKILL_CATALOG } from './agents/selected-skills-provider.js';
+import { CAPITAL_CONFIG_ENTRY_ID, readCapitalEntry } from './capital-settings.js';
 import { registerChartSourceTool } from './chart/source-token.js';
 import { registerSourceTools, registerWebRetrieverTools } from './web-retriever/tools.js';
 import { LOCAL_FETCH_DEFAULTS, PADDLE_OCR_DEFAULTS, } from './retriever-config.js';
@@ -17,8 +18,7 @@ import { createRetrieverRuntime } from './retriever-runtime.js';
 export { LOCAL_FETCH_DEFAULTS, PADDLE_OCR_DEFAULTS, resolveLocalFetchConfig, } from './retriever-config.js';
 export { resolveUserCustomizationSection } from './user-customization.js';
 export const name = 'capital-generation';
-/** Entry id shared by `cordis.patch.yml`, `config/index.js` and `client.src.cjs`; drift hides the settings card. */
-export const CAPITAL_CONFIG_ENTRY_ID = 'capital-config';
+export { CAPITAL_CONFIG_ENTRY_ID };
 const WindDocsSchema = z.object({
     endpoint: z.string().default('').description('可选：覆盖 Wind 文档检索端点'),
     credentialRef: z.string().default('').description('可选：DSH credentials 引用名，空 = WIND_API_KEY'),
@@ -51,13 +51,16 @@ const RetrieverSchema = z.object({
 // Derive toggles from the catalog: a hand-copied list silently drops defaults at the entry→plugin boundary.
 const SelectedSkillsSchema = z.object(Object.fromEntries(SELECTED_SKILL_CATALOG.map(({ key, name }) => [
     key,
-    z.boolean().default(false).description(`Enable the community experiment "${name}" for the Auto mode root Agent`),
+    z.boolean().default(false).description(`Enable the community method "${name}" for the Capital role(s) that own it`),
 ]))).default(Object.fromEntries(SELECTED_SKILL_CATALOG.map(({ key }) => [key, false])));
 export const Config = z.object({
     customPersona: z.string()
         .default('')
         .description('自动模式的附加人设文本（独立 section，非 deployment:persona）；核心安全约束始终保留'),
-    selectedSkills: SelectedSkillsSchema.description('Community selected-skill experiments; default off and visible only to the Auto mode root Agent'),
+    selectedSkills: SelectedSkillsSchema.description('Community selected methods; default off, each visible only to the Capital role(s) that own it'),
+    selectedSkillsMode: z.union(['manual', 'auto'])
+        .default('manual')
+        .description('精选 Skill 暴露方式：manual = 只用勾选；auto = 按角色开放全部方法，运行期忽略勾选'),
     fuyaoCredentialRef: z.string()
         .default('FUYAO_API_KEY')
         .description('Fuyao credentials 引用名，空 = FUYAO_API_KEY'),
@@ -70,22 +73,10 @@ export const Config = z.object({
 /** Fallback order: settings.describe → configEditor.entries → boot preset, so unreadable never
  * reads as "all toggles off". Resolve services per call: boot fibers apply in parallel. */
 export function readCapitalSettings(ctx, bootConfig) {
-    const settings = ctx.get('settings');
-    try {
-        const resolved = settings?.describe?.().find((entry) => entry.ns === CAPITAL_CONFIG_ENTRY_ID)?.value;
+    const entry = readCapitalEntry(ctx);
+    if (entry.value !== undefined) {
         // Re-parse through this plugin's schema: fills defaults and surfaces schema drift.
-        if (resolved && typeof resolved === 'object')
-            return { config: Config(resolved), source: 'settings-describe' };
-    }
-    catch {
-    }
-    const configEditor = ctx.get('configEditor');
-    try {
-        const raw = configEditor?.entries?.().find((row) => row?.options?.id === CAPITAL_CONFIG_ENTRY_ID)?.options?.config;
-        if (raw && typeof raw === 'object')
-            return { config: Config(raw), source: 'config-editor' };
-    }
-    catch {
+        return { config: Config(entry.value), source: entry.source ?? 'settings-describe' };
     }
     return { config: bootConfig, source: 'preset' };
 }

package/lib/root-extras-entry.d.ts

@@ -1,15 +1,12 @@
 /**
- * `tools/root-extras` row: root-only selected-skills provider and the `customPersona`
- * system-prompt section. This row registers no tools; both pieces re-read settings
- * every turn so saved changes apply on the next step.
+ * `tools/root-extras` row: the `customPersona` system-prompt section. Root-only; this row
+ * registers no tools. Selected skills moved to the role-scoped `tools/selected-skills` row.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import { type SelectedSkillSelection } from './agents/selected-skills-provider.js';
 export declare const name = "capital-root-extras";
 export declare const inject: string[];
 interface RootExtrasConfig {
     customPersona?: string;
-    selectedSkills?: SelectedSkillSelection;
 }
 /** Re-read per turn so a settings save applies to the same session on the next step. */
 export declare function readRootExtrasConfig(ctx: Context): RootExtrasConfig;

package/lib/root-extras-entry.js

@@ -1,4 +1,3 @@
-import { registerRootSelectedSkills } from './agents/selected-skills-provider.js';
 import { userCustomizationSection } from './user-customization.js';
 import { readCapitalConfig } from './capital-settings.js';
 export const name = 'capital-root-extras';
@@ -6,10 +5,9 @@ export const inject = ['systemPrompt'];
 /** Re-read per turn so a settings save applies to the same session on the next step. */
 export function readRootExtrasConfig(ctx) {
     const config = readCapitalConfig(ctx);
-    return { customPersona: config.customPersona, selectedSkills: config.selectedSkills };
+    return { customPersona: config.customPersona };
 }
 export function apply(ctx) {
-    registerRootSelectedSkills(ctx, () => readRootExtrasConfig(ctx).selectedSkills ?? {});
     let lastPersonaError;
     const section = userCustomizationSection(() => readRootExtrasConfig(ctx).customPersona, (error) => {
         const message = error instanceof Error ? error.message : String(error);

package/lib/selected-skills-entry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `tools/selected-skills` row: role-scoped selected-skill catalog plus its role prompt section.
+ * The row is mounted once per Capital preset (`config.role`) and registers into that Agent's
+ * own scope only; it never writes to the preset standing scope or the host scope.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type SelectedSkillRole } from './agents/selected-skills-provider.js';
+export declare const name = "capital-selected-skills";
+export declare const inject: string[];
+interface Config {
+    role?: SelectedSkillRole;
+}
+export declare function apply(ctx: Context, config?: Config): void;
+export {};

package/lib/selected-skills-entry.js

@@ -0,0 +1,43 @@
+import { registerSelectedSkills, renderSelectedSkillsBrief, SELECTED_SKILL_ENTRY_ROLES, } from './agents/selected-skills-provider.js';
+import { readCapitalConfig } from './capital-settings.js';
+export const name = 'capital-selected-skills';
+export const inject = ['systemPrompt'];
+const SECTION_NAME = 'capital:selected-skills';
+/** After the persona, before the user-customization section (order 100). */
+const SECTION_ORDER = 60;
+const accessOf = (ctx) => ({
+    selection: () => readCapitalConfig(ctx).selectedSkills ?? {},
+    mode: () => (readCapitalConfig(ctx).selectedSkillsMode === 'auto' ? 'auto' : 'manual'),
+});
+export function apply(ctx, config = {}) {
+    const role = config.role ?? 'main';
+    if (!SELECTED_SKILL_ENTRY_ROLES.includes(role)) {
+        throw new Error(`capital-selected-skills: unknown role "${String(role)}"`);
+    }
+    registerSelectedSkills(ctx, role, accessOf(ctx));
+    let lastRenderError;
+    ctx.effect(() => {
+        const dispose = ctx.systemPrompt.section({
+            name: SECTION_NAME,
+            order: SECTION_ORDER,
+            // Upstream-derived prose can contain `{{...}}`; this section is literal.
+            interpolate: false,
+            text: (context) => {
+                try {
+                    // dsh-agent passes its Agent as the assembly scope; the usage ledger is keyed by session.
+                    const agent = context?.agent;
+                    return renderSelectedSkillsBrief(role, accessOf(ctx), agent);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    if (message !== lastRenderError) {
+                        lastRenderError = message;
+                        ctx.logger?.warn?.(`capital-generation: selected skill prompt unreadable (${message})`);
+                    }
+                    return '';
+                }
+            },
+        });
+        return typeof dispose === 'function' ? dispose : () => { };
+    }, 'capital-generation.selected-skills()');
+}

package/lib/web-retriever/local-fetch.d.ts

@@ -3,7 +3,7 @@
  * Known limit: DNS resolves per request but the IP is not pinned to the connection,
  * so a rebinding window remains (same trade-off as dsh-search-first).
  */
-export declare const LOCAL_FETCH_CLIENT_VERSION = "2.10.0";
+export declare const LOCAL_FETCH_CLIENT_VERSION = "2.10.1";
 export declare const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export type LocalFetchErrorCode = 'ABORTED' | 'TIMEOUT' | 'INVALID_URL' | 'BLOCKED_URL' | 'DNS' | 'REDIRECT' | 'HTTP' | 'TOO_LARGE' | 'UNSUPPORTED_CONTENT_TYPE';
 export declare class LocalFetchError extends Error {

package/lib/web-retriever/local-fetch.js

@@ -4,7 +4,7 @@
  * so a rebinding window remains (same trade-off as dsh-search-first).
  */
 import { htmlToMarkdown, stripInvisibleText } from './html-markdown.js';
-export const LOCAL_FETCH_CLIENT_VERSION = '2.10.0';
+export const LOCAL_FETCH_CLIENT_VERSION = '2.10.1';
 export const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export class LocalFetchError extends Error {
     code;

package/lib/web-retriever/wind-client.d.ts

@@ -35,7 +35,7 @@ export interface WindCallResult {
     code?: WindErrorCode;
 }
 /** Must match `package.json` version; a test pins the two together. */
-export declare const WIND_CLIENT_VERSION = "2.10.0";
+export declare const WIND_CLIENT_VERSION = "2.10.1";
 export interface WindClient {
     callTool(toolName: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<WindCallResult>;
 }

package/lib/web-retriever/wind-client.js

@@ -19,7 +19,7 @@ export const WIND_SERVER_ENDPOINTS = {
     analytics_data: 'https://mcp.wind.com.cn/vserver_analytics_data/mcp/',
 };
 /** Must match `package.json` version; a test pins the two together. */
-export const WIND_CLIENT_VERSION = '2.10.0';
+export const WIND_CLIENT_VERSION = '2.10.1';
 function errorText(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-generation",
-  "version": "2.10.0",
+  "version": "2.10.1",
   "description": "Capital Generation：面向中国散户的 AI 投资助手插件（自动模式 Agent Preset）",
   "icon": "assets/cg-icon.png",
   "author": "v587d",
@@ -82,6 +82,11 @@
       "import": "./lib/root-extras-entry.js",
       "default": "./lib/root-extras-entry.js"
     },
+    "./tools/selected-skills": {
+      "types": "./lib/selected-skills-entry.d.ts",
+      "import": "./lib/selected-skills-entry.js",
+      "default": "./lib/selected-skills-entry.js"
+    },
     "./tools/time": {
       "types": "./lib/time-entry.d.ts",
       "import": "./lib/time-entry.js",
@@ -103,6 +108,8 @@
     "watchlist",
     "preset",
     "selected-skills/catalog.js",
+    "selected-skills/routing.js",
+    "selected-skills/ROUTING.md",
     "selected-skills/README.md",
     "selected-skills/investment-skills",
     "selected-skills/china-stock-research-skills",
@@ -146,7 +153,8 @@
     "docs:capabilities": "npm run build && node scripts/gen-capability-table.mjs",
     "verify:sessions": "node scripts/verify-sessions.mjs",
     "audit:tool-errors": "node scripts/audit-tool-errors.mjs",
-    "ptc:report": "node scripts/ptc-session-report.mjs"
+    "ptc:report": "node scripts/ptc-session-report.mjs",
+    "report:skill-usage": "node scripts/skill-usage-report.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/preset/capital-generation/agent.patch.yml

@@ -118,7 +118,7 @@
       config:
         id: capital-data-junior
         name: 分析师
-        description: 分析师（内部角色）：读取同一会话中已经取回的数据，做质量检查、统计汇总，并判断是否需要图表；需要时委派绘图专员。通常由自动模式委派；单独打开时没有取数入口，也读不到别的会话的数据。
+        description: 分析师（内部角色）：读取同一会话中已经取回的数据，做质量检查、统计汇总与假设建模，并判断是否需要图表；需要时委派绘图专员。通常由自动模式委派；单独打开时没有取数入口，也读不到别的会话的数据。
         order: 5
         plugins:
           - id: persona
@@ -126,10 +126,10 @@
             config:
               prefix: |-
                 # ROLE & IDENTITY
-                你是数据分析师（data_junior）：接收只含
-                DatasetRef 标识与问题的 profile_request / query_request，用 describe_dataset 一次完成
-                inspect/profile/受控 query（单点复核用 inspect_dataset / profile_dataset / query_dataset）。
-                描述完成后必须加载可视化协议，按 gate 决定是否创建 visualization_specialist；若创建则等其终态，再用 send_message 回传。载荷中不得出现原始数据行。你不是投资分析师
+                你是数据分析师（data_junior）：接收主 Agent 的 profile_request / query_request
+                （DatasetRef + 问题；describe_dataset 一次完成描述，单点复核才用 inspect/profile/query_dataset），
+                以及无 Dataset 的假设建模请求（假设与口径由主 Agent 给）。有 Dataset 时按 DUTIES 6 出图；
+                创建 specialist 后等终态再回传。载荷中不得出现原始数据行。你不是投资分析师
                 （不做投资判断、不输出买卖建议），也不改写原始 Dataset。你是主 Agent 的直接子 Agent，
                 与 data_collector 是兄弟：你不会被 data_collector 创建或指挥，互通一律经主 Agent 中继；
                 visualization_specialist 是你的异步子 Agent，不向主 Agent 直接发消息。
@@ -137,8 +137,10 @@
 
                 # DUTIES
                 0. 第一步先加载协议：Dataset 工具前先 skill capital-data-profile（必须 tools.skill，别直调）；写 query_request
-                   或做算术再加 skill capital-data-query；描述后无条件加载 skill capital-visualization-protocol，
-                   再选择 gate。载荷样例、事实读法、data_gap 与 QuerySpec 细则都在 skill 里。
+                   或做算术再加 skill capital-data-query；描述后无条件加载可视化协议 capital-visualization-protocol，
+                   再选择 gate。
+                0.1 无 Dataset 的假设建模：跳过数据 profile 与可视化 gate，按 capital-data-query 的「无数据建模」节算；
+                   缺关键输入回传 model_input_gap，不引入外部数据、不写买卖建议。
                 1. 启动自检：先看 SDK 有无 tools.describe_dataset，没有就 send_message 回告；正常时登记 data_junior_ready。
 
                 2. 只用受控工具：dataset_ids 按主 Agent 转发的原样使用；一切路径都是 opaque
@@ -153,8 +155,7 @@
                 5. 回传：用 tools.send_message 逐份回传结构化载荷（type / task_id / dataset_id / profile_ref
                    或 query_result），字段按工具返回原样填入——字段名、数值、日期一律不改写；可附表或
                    摘要，禁止只回传 markdown 汇总。失败回传 profile_failed / query_failed 与 error/code，
-                   绝不编造统计或查询结果；失败不影响原始 Dataset，可按主 Agent 指示重试。
-                   同一 task_id + dataset_id 已完成 profile 不重复做；后续汇总/出图复用已有 profile。
+                   绝不编造统计或查询结果；失败不影响原始 Dataset，可按主 Agent 指示重试。同一 task_id + dataset_id 已完成 profile 不重复做。
                 6. 可视化 gate 是硬步骤：每份 profile 后都跑，触发它的是数据与问题，不是用户是否说“要图”。用户明确要求图表时不得 not_needed；profile 显示时间序列、OHLC+volume、多期比较或多个可比数值序列时必须选择 recommended，先 prepare_chart_source，再调用 subagent_visualization_specialist。只有字段/数据不足、视图无法表达或 token 无法安全签发时才可 blocked；简单标量/少量 KPI、纯文本或表格更清楚时才可 not_needed。委派 prompt 显式限定“只到 profile”或“不要图”时仍给 gate 结论但不出图，并写明未出图是委派收窄而非数据不支持；prompt 只带 refs、有限事实与视图意图。
                 7. 出图 barrier：有 specialist 时，等每颗 specialist 的回传与结算通知都齐（rendered / skipped / failed），再回传 profile 与 chart_ref。
 
@@ -183,6 +184,10 @@
 
           - id: tool-skill
             name: '@deepseek-ai/dsh-tool-skill'
+          - id: capital-selected-skills
+            name: '@v587d/capital-generation/tools/selected-skills'
+            config:
+              role: data_junior
 
           # PTC: presentation is preset-scoped; the host runtime (dsh-base) stays per-call.
           - id: tool-presentation
@@ -344,6 +349,10 @@
 
           - id: tool-skill
             name: '@deepseek-ai/dsh-tool-skill'
+          - id: capital-selected-skills
+            name: '@v587d/capital-generation/tools/selected-skills'
+            config:
+              role: web_retriever
 
           # ── compaction: both rows must live in one realm; thresholdChars 8192 is the instance-wide single value ──
           - id: compaction
@@ -443,6 +452,10 @@
 
           - id: tool-skill
             name: '@deepseek-ai/dsh-tool-skill'
+          - id: capital-selected-skills
+            name: '@v587d/capital-generation/tools/selected-skills'
+            config:
+              role: data_analyst
 
           # ── compaction: both rows must live in one realm; thresholdChars 8192 is the instance-wide single value ──
           - id: compaction
@@ -501,10 +514,10 @@
                 6. 用户要求实际持仓或投资组合复盘时先加载 skill capital-portfolio-review；自选股不等于持仓。重叠请求以主问题为准，确需另一任务范围时再叠加相应 skill。
 
                 # OUTPUT CONVENTIONS
-                关键指标与截止用表格；子 Agent 回传按原样引用。
+                关键指标与截止用表格；子 Agent 回传按原样引用。「使用的方法」节只在动态清单非空时写：逐个点名并说明用途，不得漏。
                 图表由 data_junior 的可视化 gate 统一出品：你不画图、不评价图；派的时机与收窄见下方「数据调度纪律」。
                 图表交付：收到 chart_refs 后调用一次 present_charts（一次传全部 ref；refs 丢了就传 task_id）——它只记录清单，宿主会在最终答复前写入答复末尾的「交付」行，提前调用不会落进中间轮。正文不要提图表、不在正文里罗列图表文件 / 路径 / HTML。图表是呈现不是分析：不用图推断数字，数值结论一律以 profile / query 回传为准。
-                最终答（硬）：必须自足——结论、关键证据与来源标注、局限与风险、观察 / 验证 / 防守选项；归因准确。**禁止“分析已完成 / 结论见上 / 如上”这类指针式收尾**：界面只展示最后一轮答复、前面轮次会被折叠，指针句会让用户什么也看不到。被通知唤醒且无新增信息时：不输出可见正文（让上一条完整结论成为最后一轮），或重发一份自足总结；绝不写指针句。
+                最终答（硬）：必须自足——结论、关键证据与来源标注、局限与风险、观察 / 验证 / 防守选项；归因准确。**禁止“分析已完成 / 结论见上 / 如上”这类指针式收尾**：界面只展示最后一轮答复、前面轮次会被折叠，指针句会让用户什么也看不到。被通知唤醒且无新增信息时：不输出可见正文（让上一条完整结论成为最后一轮），或重发一份自足总结；绝不写「无新增信息」「结论见上」这类占位句。
 
                 # RULES & DISCIPLINE
                 读文件只用 read：只读 skill 分册与工作区文件；不读 capital-data/ 落盘（原始行不进入上下文），不读 ~/.dsh/；
@@ -532,11 +545,12 @@
                    subagent_data_collector / subagent_data_junior / subagent_web_retriever；subagent_visualization_specialist 不是你的 direct-child 创建工具，只能由 data_junior 在可视化 gate 后调用；description 必须等于角色标签；参数写 prompt，不需要复制任何模板。返回 durable id 后立即记入委派清单；每会话只需一个同角色 Agent，不要反复创建。
 
                 4. 路由（硬）
-                   a. 行情/财务/历史→data_collector；质检/统计/可视化编排→data_junior；
-                      网页事实 → web_retriever。prompt 带已消歧标的与完整代码；多角色可并行，但先复用/创建并记清单。
+                   a. 行情/财务/历史→data_collector；质检/建模（DCF、估值、三表、情景、敏感性等，含纯算术）/统计/可视化编排→data_junior；
+                      网页事实 → web_retriever。即使不取数、只有用户假设也交 data_junior：你只给假设与口径，不自己算。
+                      prompt 带已消歧标的与完整代码；多角色可并行，但先复用/创建并记清单。
 
                    b. 主 Agent 禁止自行检索；宿主若仍暴露 web_search / web_fetch，也不得调用。
-                   本插件的检索与具名来源工具不在你的工具表里；外部检索只经 web_retriever 回传。
+                   外部检索只经 web_retriever 回传。
                    工作目录里的本地 PDF / 图片可直接用 ocr 解析（外部链接仍走委派）。
 
                    c. data_collector、data_junior、web_retriever 是兄弟子 Agent，互通经主 Agent 中继；
@@ -578,7 +592,7 @@
 
                 2. 委派写明问题、标的、时间窗、所需新鲜度与证据用途，让 data_collector 按目录选足相关能力；
                    不预设能力数量，不带内部源键名；载荷与重试表 → skill capital-data-protocol，
-                   读回 junior 的 profile / query 回传 → skill capital-data-profile / capital-data-query。
+
                    禁止任何消息携带完整原始 rows。
 
                 3. 每收到一份 dataset_ready 就登记 DatasetRef。结构化数据到达就必须派 data_junior 做
@@ -588,7 +602,7 @@
                    只在收到 data_collection_completed 后才判定取数结束；等 junior 已收数据的 profile
                    和补数缺口对齐后，再让它复用已有 profile 汇总并完成可视化 gate；用户明确不要图时
                    把「不要图」一并传入，由 junior 停在 gate 结论；把 profile_ref / chart_refs 记入委派清单
-                   （chart_refs 是最终答复前 present_charts 的入参，不要丢）；失败按 error/code 修正或指示重试。
+                   （chart_refs 不要丢）；失败按 error/code 修正或指示重试。
 
                 4. 输出必须披露 capability、source_label、captured_at 与缺失字段。
                    原始行永不进入你的上下文；网页比对仅作异常抽样，不写成绝对真实。
@@ -678,6 +692,10 @@
 
           - id: tool-skill
             name: '@deepseek-ai/dsh-tool-skill'
+          - id: capital-selected-skills
+            name: '@v587d/capital-generation/tools/selected-skills'
+            config:
+              role: main
 
           # ── compaction: both rows must live in one realm; thresholdChars 8192 is the instance-wide single value ──
           - id: compaction

package/preset/capital-generation/skills/capital-data-query/SKILL.md

@@ -5,6 +5,7 @@ description: Use when aggregating a Dataset or computing a derived number — th
 
 # Capital 数据协议 · 第三册：受控查询与派生算术
 
+> **定位**：本册只定义受控查询与派生算术；DCF、三表、风险建模等方法在精选方法层，命中时按角色目录另行加载。
 本册是数据协议的第三册（§3.3 run_code 只做派生算术 / §4 受控查询）。时间轴与 `time_facts` 在第二册
 `capital-data-profile` §3.2，载荷契约与重试纪律在第一册 `capital-data-protocol`。
 
@@ -75,6 +76,24 @@ N 日均量必须写明。
 重复主键、时间范围、最小/最大/均值/分位数——**只报告可计算的部分**，数据不足就如实说明。
 
 
+### 3.4 无 Dataset 的假设建模
+
+主 Agent 交来的假设建模请求没有 `DatasetRef`：营收、利润率、税率、WACC、永续增长、股本等都由
+prompt 给定。它仍然走 `run_code`，但**不是**取数，也不套数据 profile / 可视化 gate。
+
+- **只算假设，不补外部事实**：不得用记忆、网页或 `fetch` 填市场价格、财报、无风险利率；缺什么就
+  在回传里列什么。需要真实数据时回传 `model_input_gap`，由主 Agent 交 `data_collector` 取回后再算。
+- **缺关键输入**：`model_input_gap` 写明缺项、为什么影响结论，以及可选的 illustrative 默认值（必须
+  标成假设，不能与用户给定值混在一列）。不要直接问用户——你不在用户对话里。
+- **回传形状**：`type: "model_result"` + `task_id` + `assumptions`（逐项注明用户给定 / illustrative）
+  + `method`（公式或步骤）+ `results`（表格）+ `sensitivity`（若有）+ `caveats`（失效条件）。字段名与
+  数值照程序返回值写，不手抄。
+- **边界**：不做投资判断、不给买卖建议、不承诺收益；结论与建议由主 Agent 写。没有 Dataset 就没有
+  `chart_source_ref`，可视化 gate 默认 `not_needed`；只有委派明确给了可出图的数据时才考虑出图。
+- **方法**：需要估值/建模方法时，按角色目录加载精选方法（如 `china-dcf` / `three-statement-modeling`），
+  但方法只提供口径与步骤，不提供这家公司的真实数字。
+
+
 ## 4. 受控查询（主 Agent ↔ data_junior）
 
 请求：

package/preset/capital-generation/skills/capital-equity-research/SKILL.md

@@ -5,6 +5,10 @@ description: Use when the user requests a complete research report or comprehens
 
 # 单一上市公司投研与风险审阅
 
+> **定位**：本协议只定义研究流程、证据门与报告形状；估值、财务质量、行业竞争等分析方法在精选方法层。
+> 主 Agent 能加载的方法（如 `china-initiating-coverage` / `buffett-investment-framework`）按主目录加载；
+> 估值、三表等 data_junior 方法不在主目录里，交给 data_junior 按它的目录加载。
+> 协议与方法正交：不要用本协议替代方法，也不要用方法改写本协议的证据门。
 本 skill 只供主 Agent 编排单一标的的完整研究报告；报告就是最终答复正文，不创建单独的报告产物。它不增加工具权限、不创建新角色、不要求每项都调用一个工具。普通的单点事实问题不必套用本流程；用户明确要求完整报告时，各维度必须有证据支持的结论或明确的未评估理由。
 
 ## 1. 边界与入口

package/preset/capital-generation/skills/capital-event-impact/SKILL.md

@@ -5,6 +5,9 @@ description: Use for a focused impact analysis of a listed company's announcemen
 
 # 事件与公告影响分析
 
+> **定位**：本协议只定义事件核验、影响链与输出流程；财报前瞻、催化剂日历、事件研究等方法在精选方法层。
+> 任务同时命中且该方法在本角色目录中可用时，按名加载对应 Skill（如 `china-earnings-preview` / `earnings-preview` / `catalyst-*`）；
+> 协议与方法正交：不要用本协议替代方法，也不要用方法改写本协议的证据门。
 本 skill 只供主 Agent 处理聚焦某上市公司事件的影响问题；分析写在最终答复，不新增工具、角色或报告通道。用户只问“有没有公告/公告是什么”时核实事实并简答；明确要求完整单股研究时以 `capital-equity-research` 为主，本 skill 只补事件核验，不重复拉全套数据。
 
 ## 1. 定位与委派

package/preset/capital-generation/skills/capital-orchestration/SKILL.md

@@ -11,10 +11,10 @@ description: Use when delegating in Capital mode — running the per-round list_
 ## 1. 每轮预检（不可跳过）
 
 - 触发点：**每次新的用户请求或新一轮任务**。在"本轮第一次调用任何创建工具"之前完成。
-- 创建工具指：`subagent_data_collector`、`subagent_data_junior`、`subagent_web_retriever`，以及今后新增的任何**专用**委派工具。
+- 创建工具：`subagent_data_collector` / `subagent_data_junior` / `subagent_web_retriever`。
 - 查询方式：`list_agents(scope="children")`，一次即可。
-- 不要把它当成"仅在会话恢复时才做的回忆步骤"：上一轮查到的空列表不能代替本轮查询。
-- 一次查询结果覆盖本轮所有角色，不要为每个角色重复查询；等待回传期间也不要轮询。
+- 上一轮的空列表不能代替本轮查询。
+- 一次查询覆盖全部角色；等待回传期间不要轮询。
 
 ## 1.1 Canonical task_id（不可分叉）
 
@@ -32,15 +32,13 @@ description: Use when delegating in Capital mode — running the per-round list_
    只要出现在列表里，就用该 id 调 `send_message` 派发本次任务。`running` 在其最近的 step 边界
    接收消息；`inactive` 带着自己的上下文开一个新回合。
    不得因为"空闲""上一任务已完成""任务标题变了""想并行"而创建第二个同角色 Agent。
-3. **诊断/暂时不可用**：已记录 id 但列表出现 diagnostic 或暂时不可用，先用该 id 尝试
-   `send_message`，或重新 `list_agents` 核验；不得直接创建第二个同角色 Agent。
+3. **诊断/暂时不可用**：先用已记录 id 尝试 `send_message` 或重新核验；不得创建第二个同角色 Agent。
 4. **确实不存在**：只有确认该 child 不存在且没有可用复用 id，才进入创建分支。
 
 ### 2.1 ID 纪律（防长上下文抄错 id）
 
-child id 是随机 UUID、无语义可校验，长会话里凭记忆/从历史轮次复述 id 极易抄错，甚至把
-A 角色的请求投给 B 角色。官方机制是 **`list_agents` 即权威 id 存储**——id 不需要被记住，
-只需要在用之前查一次：
+child id 是随机 UUID，长会话里凭记忆复述极易抄错，甚至把 A 角色的请求投给 B 角色。
+**`list_agents` 即权威 id 存储**：用之前查一次就够了：
 
 - `send_message` 的 `agent_id` 只从**最近一次 `list_agents` 的渲染输出**复制（每行就是
   `id [status] — label`）；不从早前轮次的上下文、委派清单或旧工具回执里复述 id。
@@ -83,7 +81,7 @@ A 角色的请求投给 B 角色。官方机制是 **`list_agents` 即权威 id
 | 诉求 | 归属 |
 |------|------|
 | 行情、财务、历史、交易日历等结构化数据 | `data_collector` |
-| 数据集质量检查、缺失/重复/时间范围/基础统计 | `data_junior` |
+| 数据集质量检查、基础统计、无 Dataset 的假设建模/估值/情景/敏感性 | `data_junior`（给假设与口径，不自己算） |
 | 网页材料、公告、新闻、传闻原文、公司背景、需要最新信息的事实 | `web_retriever` |
 | 专业分析（Python、回测、统计检验） | 尚未启用——先由 `data_junior` 出基础 profile，并如实告知用户 |
 

package/preset/capital-generation/skills/capital-portfolio-review/SKILL.md

@@ -5,6 +5,9 @@ description: Use when the user requests a review of their actual holdings or inv
 
 # 持仓与组合复盘
 
+> **定位**：本协议只定义持仓读取、证据门与复盘输出；收益归因、集中度、配置偏离等分析框架在精选方法层。
+> 任务同时命中且该方法在本角色目录中可用时，按名加载对应 Skill（如 `portfolio-review` / `risk-stress-test`）；
+> 协议与方法正交：不要用本协议替代方法，也不要用方法改写本协议的证据门。
 本 skill 只供主 Agent 对用户的实际持仓做组合层复盘；最终答复就是交付，不创建持仓账户、报告文件、自动跟踪或交易指令。仓位有两个来路：用户当场给的表／文字，以及他在自选股面板里亲手标过持仓的那几条（经 `get_watchlist` 读到的 `held` 与自报的 `weight_pct`）。自选清单**只能经这条只读工具**读，券商账户仍读不到；未标持仓的关注条目、历史对话里的提及与市场公开的机构持仓都不算用户仓位。`holding_marked_age_days` 较大（或用户说过最近调过仓）时，先把那几格向用户复述确认再用于组合判断——别拿一句很久以前的话算今天的风险。
 
 ## 1. 输入边界与委派

package/preset/capital-generation/skills/capital-web-evidence/SKILL.md

@@ -5,6 +5,7 @@ description: Use when returning or labelling what was retrieved — the numbered
 
 # Capital 检索协议 · 第二册：回传格式、来源核验与文档解析
 
+> **定位**：本册只定义回传格式、来源核验与文档解析；具体分析与精读方法在精选方法层，命中时按角色目录另行加载。
 本册是检索协议的第二册（§5 回传格式 / §6 官方证券来源域名核验 / §7 抓取与失败处置 / §8 文档解析 `ocr`）。
 "去哪取、怎么调"在第一册 `capital-web-protocol` §1–§4；两册 §编号连续，跨册引用照原编号点名。
 

package/preset/capital-generation/skills/capital-web-protocol/SKILL.md

@@ -5,6 +5,9 @@ description: Use in Capital mode when retrieving external material — the anyse
 
 # Capital 检索协议 · 第一册：来源边界与收敛
 
+> **定位**：本协议只定义来源边界、检索收敛与回传格式；10-K 精读、电话会纪要、逐条核验等方法在精选方法层。
+> 任务同时命中且该方法在本角色目录中可用时，按名加载对应 Skill（如 `10k-digest` / `earnings-call-analysis` / `fact-check`）；
+> 协议与方法正交：不要用本协议替代方法，也不要用方法改写本协议的来源纪律。
 `web_retriever` 子 Agent 的工作细则；主 Agent 呈现检索结论时同样按 `capital-web-evidence` §5 的回传格式保留来源标注。
 persona 只保留硬规则（先定来源再动手、只用这十四个工具、一次一个 URL、无来源不作证据）；
 本文件是其余细节。