@v587d/capital-generation 2.6.5 → 2.7.0

package/capital-watchlist/holding-rules.js

@@ -0,0 +1,64 @@
+/**
+ * 自选股的**类型表**与**持仓规则**——host 半边与浏览器半边共用这一份。
+ *
+ * 为什么单独成一个文件而不是各写各的：这两件事各自决定两处行为——
+ *  · 「哪些标的能被标成持仓」决定面板的「更多」菜单画不画那一行，与 `POST /holding` 收不收这一格；
+ *  · 「持仓比例加起来不能超过多少」决定步进器的 `+` 什么时候置灰，与宿主什么时候拒绝写入。
+ * 两处各抄一份的结局是"菜单里能点、宿主说 invalid_query"或反过来"菜单没得点、直接打路由却写进去了"，
+ * 而两种都是不报错的错（AGENTS.md §9.7：同一知识只许有一份实现）。
+ * `client.src.cjs` 用 `require()` 引它，esbuild 在构建期把本文件内联进 `client.js`；
+ * `index.js` 用 `import` 引它。⛔ 本文件必须列进 `package.json` 的 `files`——
+ * 漏了的表现是装出去的插件 `ERR_MODULE_NOT_FOUND`、整条 `/capital-watchlist/*` 起不来，
+ * 而本机测试全绿（文件就在磁盘上）。闸门：`test/packaging.test.mjs`。
+ */
+export const ASSET_TYPES = ['a-share', 'a-share-index', 'fund-etf', 'hk-stock', 'hk-index', 'us-stock', 'us-index']
+
+/**
+ * 可以是一个**仓位**的类型：个股与场内基金。三种指数不在表上——指数不是一个可持有、
+ * 可配比率的标的（它是市场读数，不是券），所以它没有"持仓比例"这件事可言。
+ *
+ * ⛔ 这是**白名单**而不是"排除 `*-index`"：未知或缺失的 `asset_type` 一律不可标。
+ * 判据写成反选时，将来往 `ASSET_TYPES` 里加任何一档都会自动获得持仓入口，
+ * 而那一步没人复核过；写成正选，新档默认没有这个入口，要给它就得改这一行——改这一行会红。
+ */
+export const HOLDABLE_ASSET_TYPES = ['a-share', 'fund-etf', 'hk-stock', 'us-stock']
+
+/** 这一条记录能不能被标成持仓（只看类型，不看它现在标没标：已标的取消走另一条路）。 */
+export const isHoldable = (row) => HOLDABLE_ASSET_TYPES.includes(row?.asset_type)
+
+/** 单只标的的占比上限（百分比）。 */
+export const MAX_ROW_WEIGHT_PCT = 100
+
+/**
+ * 全组合的占比合计上限：**只做多、不算 put**，所以留出 20 个百分点的余地给"用户自报的数
+ * 本来就凑不满 100%"与保证金敞口，再往上就不是一个说得出口的组合了（2026-10-09 用户点名：
+ * 面板原来允许两只各 100%，那明显不合理）。
+ *
+ * ⚠️ 这句话在四处得是同一条口径：这一行、`markHolding` 的拒绝、步进器的 `+` 置灰与
+ * `get_watchlist` 的 `description`。宿主是权威，面板只是提前把没额度这件事画出来。
+ */
+export const MAX_TOTAL_WEIGHT_PCT = 120
+
+/**
+ * 这一条占掉的权重（百分点）。**未填比例的持仓算 0**：勾上但没说数字，就没有任何敞口，
+ * 它与"这个数是零"在面板上仍是两句话（读数是 `0~上限` 而不是 `0%`），但在合计里都是 0。
+ * ⛔ `?? 0` 之前必须先判 `holding` 这一格在不在——`weight_pct: null` 与没有 `holding` 是两种状态。
+ */
+export const holdingWeight = (row) => (
+  row?.holding === null || row?.holding === undefined ? 0 : (row?.holding?.weight_pct ?? 0)
+)
+
+/** 除这一条之外，其余持仓已经占掉的权重（百分点）——面板与宿主算额度的**同一个**减法。 */
+export const otherHeldWeightPct = (rows, thscode) => rows.reduce(
+  (total, row) => (row?.thscode === thscode ? total : total + holdingWeight(row)),
+  0,
+)
+
+/**
+ * 这一条最多能填到多少：单只上限与"总额度减去其余持仓"取小的，往下托到 0。
+ * 步进器用它决定 `+` 置灰与 `0~N` 这句提示；宿主用同一条减法拒绝写入。
+ */
+export const weightCeiling = (rows, thscode) => Math.max(
+  0,
+  Math.min(MAX_ROW_WEIGHT_PCT, MAX_TOTAL_WEIGHT_PCT - otherHeldWeightPct(rows, thscode)),
+)

package/capital-watchlist/index.js

@@ -29,6 +29,7 @@ import {
   fetchSmartbox,
   normalizeHkCode,
 } from '../lib/sources/tencent-public-core.js'
+import { ASSET_TYPES, isHoldable, weightCeiling, otherHeldWeightPct, MAX_ROW_WEIGHT_PCT, MAX_TOTAL_WEIGHT_PCT } from './holding-rules.js'
 
 export const name = 'capital-watchlist'
 
@@ -67,7 +68,9 @@ export const SEARCH_BRANCH_LIMITS = { 'a-share': 50, hk: 10, us: 10 }
 /** A 股那一路的搜索白名单（Fuyao 与报价端点双端都有可靠支撑）；场外基金 / 北交所不进候选。
  * 港美股那两路各有自己的白名单（`SMARTBOX_STOCK_TYPES` + `SMARTBOX_INDEX_TYPE`），互不通用。 */
 export const SEARCH_ASSET_TYPES = 'a-share,a-share-index,fund-etf'
-const ASSET_TYPES = ['a-share', 'a-share-index', 'fund-etf', 'hk-stock', 'hk-index', 'us-stock', 'us-index']
+// `ASSET_TYPES`（域里允许的类型）、"哪些类型可以是一个仓位"与"占比合计封顶多少"都住在
+// `./holding-rules.js` **一份**里：浏览器半边（`client.src.cjs`）也引它，菜单画不画那一行、
+// `+` 什么时候置灰，与这里收不收这一格不可能各说一套。
 /**
  * `exchange` 这一格存的是**市场**而不是交易所：A 股沿用 `SH`/`SZ`，港美股落 `HK`/`US`。
  * 具体交易所（美股的 `OQ` / `N` / `AM` / 粉单 `PS`）留在 canonical 代码里（`AAPL.OQ`）——
@@ -271,6 +274,24 @@ const itemSchema = z.object({
    * 永远带它——两个方向的兼容因此都不需要迁移、也不需要抬 domain version。
    */
   pinned_at: z.number().int().optional(),
+  /**
+   * 用户**自报**的持仓标记（缺这一格 = 不是持仓，只是关注）。
+   *
+   * 三态两轴，不许糊成一态：缺 `holding` = 未持仓；`weight_pct === null` = 标了持仓但比例没填；
+   * `0` = 用户真填了 0——与上面 `change_pct` 同一条口径，"没有这个数"永远不等于"这个数是零"。
+   * 所以这一格**外部可选、内部 nullable**：外面写成 `.nullable()` 会让"未持仓"与"持仓没填比例"
+   * 共用一种写法，里面写 `.default(null)` 会把磁盘上手改出来的缺字段读成一份 0% 仓位。
+   * 可选同样是为了不迁移、不抬 domain version（见上面 `pinned_at` 那一段）。
+   *
+   * `marked_at` 记的是**标记时刻**，不是"持仓起始日"：比例归用户所有、没有到期日，但"这句话是
+   * 哪天说的"必须能自证——`get_watchlist` 把它交给主 Agent 判断要不要向用户复核。合计是否正好
+   * 100、分母含不含现金，仍不由我们校验（那本账只有用户自己知道怎么记的）；我们只挡一个**上限**：
+   * 只做多、不算 put，全组合加起来不许超过 120%（判据在 `./holding-rules.js`，面板与宿主共用）。
+   */
+  holding: z.object({
+    weight_pct: z.number().min(0).max(100).nullable(),
+    marked_at: z.number().int(),
+  }).optional(),
 })
 
 /**
@@ -710,7 +731,9 @@ export function createWatchlistService(options = {}) {
   async function list() {
     await ensureSeeded()
     const opened = await domain()
-    return { ok: true, items: rowsOf(opened.table('items')), seeded_at: opened.global.get().seeded_at }
+    // `limit` 跟着回包走（与 `add` 的 `list_full` 同一口径）：上限这个数字归本包所有，
+    // 面板那句话和 `get_watchlist` 那句都不许自己抄一份。
+    return { ok: true, items: rowsOf(opened.table('items')), seeded_at: opened.global.get().seeded_at, limit: MAX_ITEMS }
   }
 
   async function add(input) {
@@ -799,6 +822,90 @@ export function createWatchlistService(options = {}) {
     })
   }
 
+  /**
+   * 标记持仓 = 给这一条写 `holding`；比例留空（`undefined` / `null` / 空串）表示"标了持仓、
+   * 比例还没填"，落 `null` 而不是 0。`clearHolding` 抹掉这一格，关注条目本身不动。
+   *
+   * 与 `pin()` 同一条读—改—写口径：**锁内逐键重读**——刷新在途刚被用户删掉的那一行不许被旧记录
+   * 连同持仓一起写回来（那还会重新占掉一格）。比例只收 0–100，越界与"根本不是数"都回
+   * `invalid_query`：这一格是用户自报的权重，我们不替用户核对券商账，但**也不接一个明显不成立的数**。
+   * ⛔ `Number(null)` 是 0——空值一律先在这外面判成"未填"，绝不放进 `numberValue` 硬转。
+   *
+   * 还有一道**类型闸门**（`isHoldable`，与面板共用 `./holding-rules.js` 那一份）：指数不是一个可以
+   * 持有并配比率的标的。`marked_at` 每次写入都重打——它是"这句话最后一次说出来的时刻"，
+   * 不是"仓位建立日"；用户把 20% 调成 30%，那句自报的话确实就是刚刚说的。
+   *
+   * 第三道是**合计闸门**（`weightCeiling`，同一份模块）：只做多、没有 put，所以全组合的自报占比
+   * 合计封顶 120%（2026-10-09 用户点名"我居然可以对多只标的都填超过 50%"）。额度按**其余持仓**
+   * 算，不含这一格自己，所以 lowering 永远走得通。⛔ 勾上但没填（`weight === null`）不加任何敞口，
+   * 因此**不因合计被拒**——否则一条手改出来的超额数据会把"先勾上再慢慢填"这条路一起堵死。
+   */
+  async function markHolding(input) {
+    await ensureSeeded()
+    const items = await table()
+    const thscode = normalizeThscode(input?.thscode)
+    if (thscode === undefined) return { ok: false, code: 'invalid_query', message: '代码格式不符：要带市场或交易所后缀的完整代码' }
+    const raw = input?.weight_pct
+    let weight = null
+    if (raw !== undefined && raw !== null && raw !== '') {
+      const parsed = numberValue(raw)
+      if (parsed === undefined || parsed < 0 || parsed > MAX_ROW_WEIGHT_PCT) {
+        return { ok: false, code: 'invalid_query', message: `持仓比例要 0 到 ${MAX_ROW_WEIGHT_PCT} 之间的数字；留空表示只标记持仓、不填比例` }
+      }
+      weight = parsed
+    }
+    return serialize(async () => {
+      const existing = items.get(thscode)
+      if (existing === undefined) return { ok: false, code: 'not_found', message: '该标的不在自选清单里' }
+      // 类型闸门排在 `not_found` **之后**：一个根本不在这份清单里的代码，该听到的是"不在清单里"，
+      // 不是"指数不能标持仓"——后者会把人引去查类型，而真正的问题是那一行不存在。
+      // `existing.holding === undefined` 这一半是给"重标"留的门：已经标过的行（包括在旧版本或
+      // 手改数据里标上的指数）改比例仍走得通，⛔ 否则那一格会退不掉——面板不画取消出口、宿主又不收。
+      // 只拦"标"、不拦"取消"（见 `clearHolding`）：抹一格不声明任何领域事实。
+      if (existing.holding === undefined && !isHoldable(existing)) {
+        return { ok: false, code: 'invalid_query', message: '这一条不是一个可以持有并配比率的标的（指数是市场读数，不是券），因此不能标记为持仓' }
+      }
+      // 合计闸门也排在锁内：额度取决于**其余持仓此刻**是多少，读—判—写不在同一环里就会
+      // 被并发写入各放一只过去（两行都看到"还有额度"，落盘的合计却超了）。
+      if (weight !== null) {
+        const rows = rowsOf(items)
+        const ceiling = weightCeiling(rows, thscode)
+        if (weight > ceiling) {
+          return { ok: false, code: 'invalid_query', message: `其余持仓已合计 ${otherHeldWeightPct(rows, thscode)}%，这一格最多只能填 ${ceiling}%（只做多的组合合计不超过 ${MAX_TOTAL_WEIGHT_PCT}%）` }
+        }
+      }
+      const item = { ...existing, holding: { weight_pct: weight, marked_at: now() } }
+      await items.put(thscode, item)
+      return { ok: true, item }
+    })
+  }
+
+  /**
+   * 取消持仓 = 写回一份**没有** `holding` 那一格的记录。
+   *
+   * 不删键再插：官方单文件后端是 `Map` + 整份 JSON 原子写，`put` 已有键保留原位置，
+   * 而删了重插会把这一行甩到插入顺序的末尾——用户取消一个持仓标记，清单却跟着重排，
+   * 那是"动作与位移对不上"的静默副作用（与 `pin()` 不改键序同一条理由，设计文档 §3.2）。
+   *
+   * ⛔ 这里**故意不查类型**：`markHolding` 拒的是"把指数说成仓位"这句新话，`clearHolding` 只是
+   * 不再说那句话。两边都拦，一条遗留或手改出来的"指数持仓"就永远退不掉——面板不画取消出口
+   * （它按类型决定画不画），宿主又拒绝写，那一格被锁死在域里。
+   */
+  async function clearHolding(input) {
+    await ensureSeeded()
+    const items = await table()
+    const thscode = normalizeThscode(input?.thscode)
+    if (thscode === undefined) return { ok: false, code: 'invalid_query', message: '代码格式不符：要带市场或交易所后缀的完整代码' }
+    return serialize(async () => {
+      const existing = items.get(thscode)
+      if (existing === undefined) return { ok: false, code: 'not_found', message: '该标的不在自选清单里' }
+      const item = { ...existing }
+      delete item.holding
+      await items.put(thscode, item)
+      return { ok: true, item }
+    })
+  }
+
   /** 一个分组 = 一次快照请求（只有场内 ETF 那一档是逐只）；单组失败只记该组，不拖垮其它组。 */
   function fetchGroup(group) {
     return group.kind === 'tencent' ? fetchOffshoreGroup(group) : fetchFuyaoGroup(group)
@@ -994,6 +1101,8 @@ export function createWatchlistService(options = {}) {
     add,
     remove,
     pin,
+    markHolding,
+    clearHolding,
     refresh,
     async close() {
       const opened = await domainPromise
@@ -1131,6 +1240,12 @@ export function createRouteHandler(service, options = {}) {
       if (method === 'POST' && pathname === '/add') return sendBusiness(res, await service.add(input))
       if (method === 'POST' && pathname === '/remove') return sendBusiness(res, await service.remove(input))
       if (method === 'POST' && pathname === '/pin') return sendBusiness(res, await service.pin(input))
+      if (method === 'POST' && pathname === '/holding') {
+        // 标记与取消共用一条路由、靠 body 里那一个布尔分流：面板上的概念只有一个（"这条是不是
+        // 我的持仓"），拆两条要多一套字典与一份围栏回归，而两者差别只是写不写那一格。
+        const next = input?.clear === true ? service.clearHolding(input) : service.markHolding(input)
+        return sendBusiness(res, await next)
+      }
       if (method === 'POST' && pathname === '/refresh') {
         // 刷新是"部分成功 + 逐条失败"的形态：整批失败也带 items 与 error 回来，
         // 面板按 error.code 居中显示，绝不清空列表。

package/capital-watchlist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-watchlist",
-  "version": "2.6.5",
+  "version": "2.7.0",
   "description": "Capital 模式的用户自选股（宿主级清单 + Fuyao 报价快照 + /capital-watchlist 路由 + 输入框菜单弹窗）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,7 @@
   },
   "files": [
     "index.js",
+    "holding-rules.js",
     "client.js",
     "package.json"
   ]

package/chart-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-charts",
-  "version": "2.6.5",
+  "version": "2.7.0",
   "description": "Capital 模式的图表前端组件（浏览器半边 + 序列旁路路由）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",

package/lib/agents/selected-skills-provider.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { SkillProviderControl } from '@deepseek-ai/dsh-skill';
+import { FileSystemSkillProvider } from '@deepseek-ai/dsh-skill-filesystem';
+import { type PolicyContext } from './root-tool-policy.js';
+export type SelectedSkillStatus = 'experimental' | 'watchlist';
+export type SelectedSkillCatalogEntry = {
+    key: string;
+    name: string;
+    status: SelectedSkillStatus;
+    tags: readonly string[];
+};
+export declare const SELECTED_SKILL_CATALOG: readonly SelectedSkillCatalogEntry[];
+export type SelectedSkillKey = typeof SELECTED_SKILL_CATALOG[number]['key'];
+export type SelectedSkillSelection = Partial<Record<SelectedSkillKey, boolean>>;
+export type SelectedSkillSelectionSource = SelectedSkillSelection | (() => SelectedSkillSelection);
+type FileSystemSkillConfig = {
+    providerName: string;
+    includeDefaultRoots: false;
+    customSkillDirs: string[];
+    watch: true;
+};
+type FileSystemSkillSource = Pick<FileSystemSkillProvider, 'list' | 'get' | 'dispose'>;
+type FileSystemSkillFactory = (ctx: Context, control: SkillProviderControl, config: FileSystemSkillConfig) => FileSystemSkillSource;
+/** Register explicitly selected community experiments on the Capital root Agent only. */
+export declare function registerRootSelectedSkills(ctx: PolicyContext, selection: SelectedSkillSelectionSource, createFilesystemProvider?: FileSystemSkillFactory): void;
+export {};

package/lib/agents/selected-skills-provider.js

@@ -0,0 +1,99 @@
+import { FileSystemSkillProvider } from '@deepseek-ai/dsh-skill-filesystem';
+import { fileURLToPath } from 'node:url';
+import { agentSessionId, isRootAgent } from './root-tool-policy.js';
+// The catalog is a shipped data file outside the TypeScript root; runtime keeps this
+// import so the published lib resolves the same metadata beside the pinned snapshots.
+// @ts-expect-error catalog.js is intentionally maintained as package data.
+import { SELECTED_SKILL_CATALOG as CATALOG } from '../../selected-skills/catalog.js';
+export const SELECTED_SKILL_CATALOG = CATALOG;
+const PROVIDER_NAME = 'capital-selected-skills';
+const SKILL_ROOTS = [
+    fileURLToPath(new URL('../../selected-skills/investment-skills/skills', import.meta.url)),
+    fileURLToPath(new URL('../../selected-skills/china-stock-research-skills/skills', import.meta.url)),
+];
+function createFilesystemSkillProvider(ctx, control, config) {
+    return new FileSystemSkillProvider(ctx, control, config);
+}
+function selectedNames(selection) {
+    return new Set(SELECTED_SKILL_CATALOG
+        .filter(({ key }) => selection[key] === true)
+        .map(({ name }) => name));
+}
+function readSelection(source) {
+    return typeof source === 'function' ? source() : source;
+}
+function strictCapitalPreset(ctx, agent) {
+    try {
+        const presets = ctx.get?.('agentPresets');
+        return typeof presets?.composedPreset === 'function'
+            && presets.composedPreset(agent.ctx) === 'capital-generation';
+    }
+    catch {
+        return false;
+    }
+}
+/** Register explicitly selected community experiments on the Capital root Agent only. */
+export function registerRootSelectedSkills(ctx, selection, createFilesystemProvider = createFilesystemSkillProvider) {
+    // Static callers retain the cheap all-disabled fast path. The Capital plugin
+    // passes a reader so a settings toggle is observed for the next root Agent.
+    if (typeof selection !== 'function' && selectedNames(selection).size === 0)
+        return;
+    const listenCtx = ctx.root ?? ctx;
+    if (typeof listenCtx.on !== 'function')
+        return;
+    const stop = listenCtx.on('agent/created', ({ agent }) => {
+        if (!agent || !isRootAgent(agent) || !strictCapitalPreset(ctx, agent))
+            return;
+        const enabled = selectedNames(readSelection(selection));
+        if (enabled.size === 0)
+            return;
+        const agentCtx = agent.ctx;
+        if (!agentCtx || typeof agentCtx.inject !== 'function') {
+            ctx.logger?.warn?.('capital-generation: selected skills are unavailable (root Agent cannot inject skills)');
+            return;
+        }
+        agentCtx.inject(['skills'], (injectedCtx) => {
+            const skills = injectedCtx.skills;
+            if (typeof skills?.registerProvider !== 'function') {
+                ctx.logger?.warn?.('capital-generation: selected skills are unavailable (root Agent has no skills registry)');
+                return;
+            }
+            let filesystemProvider;
+            injectedCtx.effect(() => {
+                const unregister = skills.registerProvider((control) => {
+                    filesystemProvider = createFilesystemProvider(injectedCtx, control, {
+                        providerName: PROVIDER_NAME,
+                        includeDefaultRoots: false,
+                        customSkillDirs: SKILL_ROOTS,
+                        watch: true,
+                    });
+                    const provider = {
+                        name: PROVIDER_NAME,
+                        async list(options) {
+                            const result = await filesystemProvider.list(options);
+                            if (Array.isArray(result))
+                                return result.filter((candidate) => enabled.has(candidate.name));
+                            return { ...result, candidates: result.candidates.filter((candidate) => enabled.has(candidate.name)) };
+                        },
+                        get(candidate, options) {
+                            if (!enabled.has(candidate.name)) {
+                                throw new Error(`selected skill is not enabled: ${candidate.name}`);
+                            }
+                            return filesystemProvider.get(candidate, options);
+                        },
+                    };
+                    return provider;
+                });
+                return () => {
+                    unregister();
+                    void filesystemProvider?.dispose();
+                    filesystemProvider = undefined;
+                };
+            }, `capital-generation: selected skills for ${agentSessionId(agent) ?? 'root'}`);
+        });
+    });
+    ctx.effect?.(() => () => {
+        if (typeof stop === 'function')
+            stop();
+    }, 'capital-generation: selected skill root listener');
+}

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 import { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
+import { type SelectedSkillSelection } from './agents/selected-skills-provider.js';
 /** Internal plugin name used by the Capital mode preset. */
 export declare const name = "capital-generation";
 /**
@@ -81,6 +82,8 @@ export declare function resolveLocalFetchConfig(config?: LocalFetchConfig): Requ
 export interface Config {
     /** Optional additive persona override; core safety guidance is preserved. */
     customPersona?: string;
+    /** Community experiments explicitly selected for the Capital root Agent only. */
+    selectedSkills?: SelectedSkillSelection;
     /** Fuyao credentials 引用名；空值回退到 FUYAO_API_KEY。 */
     fuyaoCredentialRef?: string;
     /** web_retriever 配置（可选；缺省使用 AnySearch 默认地址与凭据名）。 */
@@ -89,6 +92,23 @@ export interface Config {
 /** DSH 0.1.2-rc.1 configuration schema. */
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     customPersona: z<string, string, "defined">;
+    selectedSkills: z<Schemastery.ObjectS<NoInfer<{
+        buffettFramework: z<boolean, boolean, "defined">;
+        financialHealth: z<boolean, boolean, "defined">;
+        riskWarningCatalysts: z<boolean, boolean, "defined">;
+        valuationInvestmentStrategy: z<boolean, boolean, "defined">;
+        strategyBusinessTransition: z<boolean, boolean, "defined">;
+        industryCompetitionMoat: z<boolean, boolean, "defined">;
+        businessDecompositionOrderQuality: z<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        buffettFramework: z<boolean, boolean, "defined">;
+        financialHealth: z<boolean, boolean, "defined">;
+        riskWarningCatalysts: z<boolean, boolean, "defined">;
+        valuationInvestmentStrategy: z<boolean, boolean, "defined">;
+        strategyBusinessTransition: z<boolean, boolean, "defined">;
+        industryCompetitionMoat: z<boolean, boolean, "defined">;
+        businessDecompositionOrderQuality: z<boolean, boolean, "defined">;
+    }>>, "defined">;
     fuyaoCredentialRef: z<string, string, "defined">;
     retriever: z<Schemastery.ObjectS<NoInfer<{
         baseURL: z<string, string, "defined">;
@@ -169,6 +189,23 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     }>>, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     customPersona: z<string, string, "defined">;
+    selectedSkills: z<Schemastery.ObjectS<NoInfer<{
+        buffettFramework: z<boolean, boolean, "defined">;
+        financialHealth: z<boolean, boolean, "defined">;
+        riskWarningCatalysts: z<boolean, boolean, "defined">;
+        valuationInvestmentStrategy: z<boolean, boolean, "defined">;
+        strategyBusinessTransition: z<boolean, boolean, "defined">;
+        industryCompetitionMoat: z<boolean, boolean, "defined">;
+        businessDecompositionOrderQuality: z<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        buffettFramework: z<boolean, boolean, "defined">;
+        financialHealth: z<boolean, boolean, "defined">;
+        riskWarningCatalysts: z<boolean, boolean, "defined">;
+        valuationInvestmentStrategy: z<boolean, boolean, "defined">;
+        strategyBusinessTransition: z<boolean, boolean, "defined">;
+        industryCompetitionMoat: z<boolean, boolean, "defined">;
+        businessDecompositionOrderQuality: z<boolean, boolean, "defined">;
+    }>>, "defined">;
     fuyaoCredentialRef: z<string, string, "defined">;
     retriever: z<Schemastery.ObjectS<NoInfer<{
         baseURL: z<string, string, "defined">;

package/lib/index.js

@@ -8,10 +8,12 @@ import { createWindSources } from './sources/wind-mcp.js';
 import { registerDataCollectorTools } from './data-collector/tools.js';
 import { registerDatasetTools } from './data-collector/dataset-tools.js';
 import { registerTimeTool } from './time/tools.js';
+import { registerWatchlistTool } from './watchlist/tools.js';
 import { registerChartTool } from './chart/tool.js';
 import { createChartEventPublisher } from './chart/events.js';
 import { registerRootToolPolicy, rootPolicyProbes } from './agents/root-tool-policy.js';
 import { registerBashGuard } from './agents/bash-guard.js';
+import { registerRootSelectedSkills } from './agents/selected-skills-provider.js';
 import { ChartSourceTokenStore, registerChartSourceTool } from './chart/source-token.js';
 import { ChartArtifactRegistry } from './chart/artifact-ref.js';
 import { WebRetriever } from './web-retriever/retriever.js';
@@ -129,11 +131,29 @@ const RetrieverSchema = z.object({
     paddleOcr: PaddleOcrSchema.default({ ...PADDLE_OCR_DEFAULTS })
         .description('PaddleOCR 文档解析（ocr 工具）配置；Token 走 credentials 引用 PADDLE_OCR_TOKEN'),
 });
+const SelectedSkillsSchema = z.object({
+    buffettFramework: z.boolean().default(false).description('Enable the Finterm Buffett framework experiment for the Capital root Agent'),
+    financialHealth: z.boolean().default(false).description('Enable the China-stock financial health experiment for the Capital root Agent'),
+    riskWarningCatalysts: z.boolean().default(false).description('Enable the China-stock risk and catalyst monitoring experiment for the Capital root Agent'),
+    valuationInvestmentStrategy: z.boolean().default(false).description('Enable the China-stock valuation experiment for the Capital root Agent'),
+    strategyBusinessTransition: z.boolean().default(false).description('Enable the China-stock business transition experiment for the Capital root Agent'),
+    industryCompetitionMoat: z.boolean().default(false).description('Enable the China-stock industry and competition experiment for the Capital root Agent'),
+    businessDecompositionOrderQuality: z.boolean().default(false).description('Enable the China-stock order quality experiment for the Capital root Agent'),
+}).default({
+    buffettFramework: false,
+    financialHealth: false,
+    riskWarningCatalysts: false,
+    valuationInvestmentStrategy: false,
+    strategyBusinessTransition: false,
+    industryCompetitionMoat: false,
+    businessDecompositionOrderQuality: false,
+});
 /** DSH 0.1.2-rc.1 configuration schema. */
 export const Config = z.object({
     customPersona: z.string()
         .default('')
         .description('Capital 模式 的附加人设文本（独立 section，非 deployment:persona）；核心安全约束始终保留'),
+    selectedSkills: SelectedSkillsSchema.description('Community selected-skill experiments; default off and visible only to the Capital root Agent'),
     fuyaoCredentialRef: z.string()
         .default('FUYAO_API_KEY')
         .description('Fuyao credentials 引用名，空 = FUYAO_API_KEY'),
@@ -180,17 +200,27 @@ export function apply(ctx, config) {
     // `.volatile()` 声明，`describe()` 按条目 id 返回解析后的值。所以我们按随包的
     // `capital-config` **条目 id** 找那一行，而不是按自造的命名空间。
     const settings = ctx.get('settings');
-    let effectiveConfig = config;
-    try {
-        const resolved = settings?.describe?.().find((entry) => entry.ns === CAPITAL_CONFIG_ENTRY_ID)?.value;
-        // 这里再用本插件的 Config 过一遍：既补默认值，也把 schema 漂移变成可查的错误，
-        // 而不是把 capital-config schema 里的未知/缺失字段静默带进运行期配置。
-        if (resolved && typeof resolved === 'object')
-            effectiveConfig = Config(resolved);
-    }
-    catch {
-        // 条目未注册或解析失败时沿用 preset 配置。
-    }
+    const readEffectiveConfig = () => {
+        let resolvedConfig = config;
+        try {
+            const resolved = settings?.describe?.().find((entry) => entry.ns === CAPITAL_CONFIG_ENTRY_ID)?.value;
+            // 这里再用本插件的 Config 过一遍：既补默认值，也把 schema 漂移变成可查的错误，
+            // 而不是把 capital-config schema 里的未知/缺失字段静默带进运行期配置。
+            if (resolved && typeof resolved === 'object')
+                resolvedConfig = Config(resolved);
+        }
+        catch {
+            // 条目未注册或解析失败时沿用 preset 配置。
+        }
+        return resolvedConfig;
+    };
+    const effectiveConfig = readEffectiveConfig();
+    // selectedSkills 是 live 的 settings 偏好：按 root Agent 创建时重读；无 settings
+    // 服务时沿用 preset 配置，避免为静态关闭配置额外挂一个永远空转的监听器。
+    const selectedSkills = typeof settings?.describe === 'function'
+        ? () => readEffectiveConfig().selectedSkills ?? {}
+        : effectiveConfig.selectedSkills ?? {};
+    registerRootSelectedSkills(ctx, selectedSkills);
     // ── data_collector 域：宿主侧 Dataset 落盘 + 取数执行器 ─────────────────────
     // 落盘通过 DSH 官方 fs/sandbox 服务完成，根目录恒为调用方 session 的
     // workspace cwd（exec.agent.session.header.cwd），服从当前 permission。
@@ -234,6 +264,10 @@ export function apply(ctx, config) {
     // store 只用于 resolve_data_time_range 的 Dataset 形态（按该 Dataset 时间列的偏移
     // 解析窗口边界）——data_junior 因此不必自己把日期换算成毫秒。
     registerTimeTool(ctx, store);
+    // 用户的自选股（含他自己在面板里标的持仓与占比）：只读，数据归 host 平面的 capitalWatchlist 服务。
+    // 主 Agent 是它的消费者，所以不进 ROOT_AGENT_DENIED_TOOLS；通用 subagent 行必须显式 deny
+    // （这一格里有用户的仓位），四个专用 child 走 allow 白名单、天然拿不到。
+    registerWatchlistTool(ctx);
     // 呈现层图表工具：只有 data_junior 创建的 visualization_specialist 能调用它
     // （主 Agent 的入口由 registerRootToolPolicy 在它自己的 agent scope 上 deny 掉）。
     // 只回小回执、不回原始行；序列落在 workspace 产物里，

package/lib/time/tools.d.ts

@@ -58,6 +58,12 @@ export declare function periodInputOf(value: unknown): string | {
 } | undefined;
 export declare function dateParts(value: string): DateParts;
 export declare function shiftDate(value: string, unit: 'day' | 'week' | 'month' | 'quarter' | 'year', amount: number): string;
+/**
+ * 两个日历日之间相差的天数（同区间的 `YYYY-MM-DD` 对，按 UTC 午夜算，不受时区与夏令时影响）。
+ * 对外只有一份：`get_watchlist` 报"这条持仓标了几天"用的就是它，不许在消费方再写一遍
+ * `Date.parse(...)/86_400_000`（AGENTS.md §9.7①）。
+ */
+export declare function dayDistance(start: string, end: string): number;
 /**
  * 单窗口解析（**共享**入口）：`resolve_data_time_range`（能力参数那个模式）与
  * `time-axis.ts`（Dataset 时间轴模式）都用它，避免两处对同一个 period 词表给出不同答案。

package/lib/time/tools.js

@@ -266,7 +266,12 @@ function zonedDateEpoch(value, zone, endOfDay = false) {
     const base = Date.UTC(parts.year, parts.month - 1, parts.day, endOfDay ? 23 : 0, endOfDay ? 59 : 0, endOfDay ? 59 : 0, endOfDay ? 999 : 0);
     return base - zoneOffsetMsByDiff(base, zone);
 }
-function dayDistance(start, end) {
+/**
+ * 两个日历日之间相差的天数（同区间的 `YYYY-MM-DD` 对，按 UTC 午夜算，不受时区与夏令时影响）。
+ * 对外只有一份：`get_watchlist` 报"这条持仓标了几天"用的就是它，不许在消费方再写一遍
+ * `Date.parse(...)/86_400_000`（AGENTS.md §9.7①）。
+ */
+export function dayDistance(start, end) {
     const from = dateParts(start);
     const to = dateParts(end);
     return Math.round((Date.UTC(to.year, to.month - 1, to.day) - Date.UTC(from.year, from.month - 1, from.day)) / 86_400_000);

package/lib/watchlist/tools.d.ts

@@ -0,0 +1,52 @@
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * `capital-watchlist`（host 平面行）provide 的 `capitalWatchlist` 服务里，本工具用到的那一小片。
+ * 声明成**可选方法 + 只读**：跨平面的形状归那一边所有，这里只描述"读清单"这条路径需要什么，
+ * 任何多余字段都不进回包。清单的增删与持仓标记一律只在面板里做，Agent 侧没有写入口。
+ */
+interface WatchlistRow {
+    readonly thscode?: string;
+    readonly name?: string;
+    readonly asset_type?: string;
+    readonly added_at?: number;
+    readonly pinned_at?: number;
+    readonly holding?: {
+        readonly weight_pct?: number | null;
+        readonly marked_at?: number;
+    };
+}
+interface WatchlistListResult {
+    readonly ok?: boolean;
+    readonly items?: WatchlistRow[];
+    readonly limit?: number;
+}
+interface WatchlistServiceLike {
+    list?(): Promise<WatchlistListResult>;
+}
+/** ToolOutputDefinition.render(args, value)：第一参是入参、第二参才是返回值。 */
+declare function render(_args: unknown, value: unknown): Array<{
+    type: 'text';
+    text: string;
+}>;
+/** 成功回包。`limit` 只在宿主给了才带（那个数字归 `capital-watchlist` 所有，这里不抄一份）。 */
+export declare function watchlistReceipt(rows: WatchlistRow[], limit: number | undefined, now: number): Record<string, unknown>;
+export declare function watchlistToolDefinition(source: () => WatchlistServiceLike | undefined): {
+    name: string;
+    description: string;
+    parameters: object;
+    output: {
+        schema: object;
+        render: typeof render;
+    };
+    execute(): Promise<Record<string, unknown>>;
+};
+/**
+ * 注册 `get_watchlist`（主 Agent 的工具；`capital-generation-scope` 组里注册 = 主 Agent 与
+ * 全部 child 都看得见，所以通用 `subagent` 行必须把它 deny 掉，见 preset 的 agent.patch.yml）。
+ *
+ * 会话级数据（Dataset / profile / chart）走 workspace，而自选股是**宿主级用户资产**：
+ * 本工具不读 `{{cwd}}`、不碰 `~/.dsh/storages/` 那个文件，只调那一路唯一的宿主服务
+ * （设计文档 §2.4：不允许另建一份存储）。
+ */
+export declare function registerWatchlistTool(ctx: Context): void;
+export {};