@v587d/capital-generation 2.7.6 → 2.7.7

package/CHANGELOG.md

@@ -7,6 +7,25 @@
 - **第三位（patch）**：不破坏既有工具 / 配置 / 会话的新增与修复（如 2.1.1、2.1.2）。
 - **第二位（minor）**：有需要用户知晓的行为变更，且段内附迁移说明（如 2.1.0 的图表呈现通道重做、2.2.0 的数据源与检索来源扩容、2.4.0 的**必须换宿主版本**——本插件自己的工具与数据契约没变，所以只抬第二位）。
 
+## [2.7.7] - 2026-10-12
+
+精选 Skills 的开关改为**每轮生效**，并修掉首轮注入竞态。既有契约完全没动：工具入参与返回、能力清单、
+四把密钥与凭据引用名、配置字段、会话日志格式、你已有的自选股数据与**已经开启的那几项 Skill**，全部照旧；
+宿主要求与 2.7.6 相同（DSH`@0.2.0-rc.2`），不必换版本，升级无需迁移。**更正 2.7.6 的说法**：
+切换开关不再需要新开一份 Capital 会话——正在使用的会话里改完设置、发下一条指令，Skill 列表就按
+最新选择刷新（2.7.6 写的"照旧要新开一份 Capital 会话才读得到"随本版作废）。
+
+### Changed
+
+- **精选 Skills 随开随用**：开关现在每轮对话开始时重读，Skill 列表跟着设置走——打开哪颗，
+  下一条指令就出现在可用列表里；关掉哪颗，下一条指令就不再出现。"建好会话再打开开关永远看不到"
+  与"关掉后旧列表还挂在会话里"两种情况一并消失。默认仍是全关；全关的会话不扫快照、不起 watcher。
+
+### Fixed
+
+- **首轮 Skill 列表与注册竞态**：Agent 建立时的注入现在等技能注册真正落位才放行，首轮可用列表
+  不再可能赶在注册之前被读到（此前文档这样承诺，实现并没有等）。
+
 ## [2.7.6] - 2026-10-12
 
 精选 Skills 的**收录判据纠正一处**，并据此放开 5 颗。既有契约完全没动：工具入参与返回、能力清单、

package/README.md

@@ -16,7 +16,7 @@
 <p align="center">
   <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="awesome · DSH plugin"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License"></a>
-  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.7.6-9cf" alt="Version"></a>
+  <a href="https://github.com/v587d/capital-generation/releases"><img src="https://img.shields.io/badge/version-2.7.7-9cf" alt="Version"></a>
 </p>
 
 # Capital Generation
@@ -144,7 +144,7 @@ https://github.com/v587d/capital-generation
 | :---: | :---: |
 | <a href="assets/watchlist-popup.png"><img src="assets/watchlist-popup.png" alt="管理自选股" width="400"></a> | <a href="assets/watchlist-more.png"><img src="assets/watchlist-more.png" alt="标记持仓" width="400"></a> |
 
-- **精选 Skills：** 当前收录 6 个开源项目、共 59 个 Skill（默认全部关闭，在配置页按需打开）
+- **精选 Skills：** 当前收录 6 个开源项目、共 59 个 Skill（默认全部关闭，在配置页按需打开；随时切换，无需新建会话，正在使用的 Capital 会话下一条指令即生效）
 
 | 项目名称 | 收录边界 |
 | :---: | :---: |
@@ -165,7 +165,7 @@ https://github.com/v587d/capital-generation
 
 - **安装后找不到 Capital 模式？** 确认插件出现在「插件」→ 已安装列表；Web / CLI profile 安装后要重启该 profile，并在新会话选择模式。
 - **配置在哪？** 打开「插件」→ 已安装的 **Capital Generation**，页面顶部就是「数据源 / 精选 Skills / 包含的组件」三格，四把密钥都在第一格；不在 DSH 的普通「设置」页面，也不用点进任何一行组件。保存密钥后新建会话再试。
-- **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.7.6` 或 `@2.7.6`。
+- **桌面端升级后仍是旧版？** 桌面端安装时会固定所解析的版本，不会自动升级。卸载后重新安装，再到插件详情查看版本号；如需指定版本，可在地址末尾加 `#v2.7.7` 或 `@2.7.7`。
 - **刚发布的新版本装不到？** 桌面端取包时会跳过**刚发布不久**的版本（宿主侧包管理器的发布冷却策略，实测会静默装成上一个版本），国内镜像的同步也可能滞后一段时间。急着用最新代码，改用仓库地址安装最直接。
 - **网页抓取失败？** 配置卡片中的「允许启动本地提取网页内容」默认开启：AnySearch 提取失败时可尝试本机直连。关闭后，本机直连的具名来源查询也不可用；请检查该开关和网络连接。
 - **Wind 那部分会消耗积分？** 会。公告与新闻检索、宏观 / 行业 / 汇率指标、按日期区间取的历史 K 线都按次消耗你在 Wind 侧的额度；额度与条款以 Wind 为准，插件不做用量封顶。没配 `WIND_API_KEY` 时这几类不可用，其余功能照常。

package/capital-config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-config",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "Capital 模式的取数凭据与偏好配置行：卡片坐在 @v587d/capital-generation 插件主页的「配置」段，点这一行本身没有表单。",
   "license": "MIT",
   "type": "module",

package/capital-watchlist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-watchlist",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "Capital 模式的用户自选股（宿主级清单 + Fuyao 报价快照 + /capital-watchlist 路由 + 输入框菜单弹窗）：由 @v587d/capital-generation 随包携带并作为 host 平面行挂载。",
   "license": "MIT",
   "type": "module",

package/chart-ui/package.json

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

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

@@ -22,6 +22,17 @@ function selectedNames(selection) {
 function readSelection(source) {
     return typeof source === 'function' ? source() : source;
 }
+// 选择指纹只认 catalog 的 key 集合：pre-step 每轮拿它对比"上次交给注册表的选择"，
+// 变了才失效目录缓存，未变就零成本放行。
+function selectionFingerprint(selection) {
+    return SELECTED_SKILL_CATALOG.map(({ key }) => (selection[key] === true ? '1' : '0')).join('');
+}
+// agent/pre-step 是 dsh-agent 声明的事件，类型不在本包的 import 面里；按结构挂到注入后的
+// Agent context（其 scope tag 就是该 Agent，dispatch 的 scope filter 才放行这条监听）。
+function onPreStepEvent(ctx, listener) {
+    const events = ctx;
+    return events.on?.('agent/pre-step', listener);
+}
 function strictCapitalPreset(ctx, agent) {
     try {
         const presets = ctx.get?.('agentPresets');
@@ -35,62 +46,101 @@ function strictCapitalPreset(ctx, agent) {
 /** 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.
+    // passes a reader so a settings toggle is observed at the next step of every
+    // live root Agent: list()/get() filter against the current selection, and the
+    // pre-step hook below refreshes the visible catalog when the selection changes.
     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 }) => {
+    const stop = listenCtx.on('agent/created', async ({ 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,
+        try {
+            // agent/created 是串行事件、DSH 等监听器 settle 才继续创建：await 注入 Fiber，
+            // provider 与 pre-step 钩子都在首轮 prompt 前落位（首轮 catalog 不与注册竞态）。
+            await 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;
+                let control;
+                // 上次交给 skills 注册表的选择指纹。开关是 settings 偏好，不在 Agent 创建时定格：
+                // 全关也照常注册 provider（否则会话创建后打开开关永远不出现），靠下面的 pre-step
+                // 钩子每轮对齐设置。
+                let served = selectionFingerprint(readSelection(selection));
+                injectedCtx.effect(() => {
+                    const unregister = skills.registerProvider((registration) => {
+                        control = registration;
+                        filesystemProvider = createFilesystemProvider(injectedCtx, registration, {
+                            providerName: PROVIDER_NAME,
+                            includeDefaultRoots: false,
+                            customSkillDirs: SKILL_ROOTS,
+                            watch: true,
+                        });
+                        const provider = {
+                            name: PROVIDER_NAME,
+                            async list(options) {
+                                // 调用期现读：开关是 settings 偏好，不许在 Agent 创建时定格。
+                                const enabled = selectedNames(readSelection(selection));
+                                // 全关是默认常态：短路掉，不碰快照目录（filesystem watcher 在它的 list()
+                                // 里才启动，短路保证默认关闭的会话不起任何 watcher）。
+                                if (enabled.size === 0)
+                                    return [];
+                                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 (!selectedNames(readSelection(selection)).has(candidate.name)) {
+                                    throw new Error(`selected skill is not enabled: ${candidate.name}`);
+                                }
+                                return filesystemProvider.get(candidate, options);
+                            },
+                        };
+                        return provider;
                     });
-                    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}`);
+                    // 每轮 pre-step 重读开关：集合变了就调 provider control 的 invalidate()，失效
+                    // skills 的目录缓存（revision++），tool-skill 随后的 catalog 快照因此按最新开关
+                    // 重算；未变则 digest 不变、catalog 不重发。必须在放行 next() 之前做完——
+                    // waterfall 里 tool-skill 是 await next() 之后才快照，但监听器注册顺序不归我们
+                    // 管，先做完再放行在两种顺序下都赶得上本轮快照。设置读取失败只降级，不阻断本轮。
+                    const stopPreStep = onPreStepEvent(injectedCtx, (_payload, next) => {
+                        try {
+                            const fingerprint = selectionFingerprint(readSelection(selection));
+                            if (fingerprint !== served) {
+                                served = fingerprint;
+                                control?.invalidate();
                             }
-                            return filesystemProvider.get(candidate, options);
-                        },
+                        }
+                        catch (error) {
+                            ctx.logger?.warn?.(`capital-generation: selected skill settings unreadable (${String(error)})`);
+                        }
+                        return next();
+                    });
+                    return () => {
+                        if (typeof stopPreStep === 'function')
+                            stopPreStep();
+                        unregister();
+                        void filesystemProvider?.dispose();
+                        filesystemProvider = undefined;
                     };
-                    return provider;
-                });
-                return () => {
-                    unregister();
-                    void filesystemProvider?.dispose();
-                    filesystemProvider = undefined;
-                };
-            }, `capital-generation: selected skills for ${agentSessionId(agent) ?? 'root'}`);
-        });
+                }, `capital-generation: selected skills for ${agentSessionId(agent) ?? 'root'}`);
+            });
+        }
+        catch (error) {
+            // selected skills 是可选能力：注入失败只降级告警，不能把整个 Agent 创建挡掉。
+            ctx.logger?.warn?.(`capital-generation: selected skills are unavailable (${String(error)})`);
+        }
     });
     ctx.effect?.(() => () => {
         if (typeof stop === 'function')

package/lib/index.js

@@ -205,8 +205,9 @@ export function apply(ctx, config) {
         return resolvedConfig;
     };
     const effectiveConfig = readEffectiveConfig();
-    // selectedSkills 是 live 的 settings 偏好：按 root Agent 创建时重读；无 settings
-    // 服务时沿用 preset 配置，避免为静态关闭配置额外挂一个永远空转的监听器。
+    // selectedSkills 是 live 的 settings 偏好：provider 在每轮 agent/pre-step 与每次
+    // list()/get() 调用现读，切换开关不需要新建会话（见 docs/dev/selected-skills.md）；
+    // 无 settings 服务时沿用 preset 配置，避免为静态关闭配置额外挂一个永远空转的监听器。
     const selectedSkills = typeof settings?.describe === 'function'
         ? () => readEffectiveConfig().selectedSkills ?? {}
         : effectiveConfig.selectedSkills ?? {};

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

@@ -6,7 +6,7 @@
  * between validation and connect. Closing that window would require a custom
  * dispatcher; this module keeps the same explicit trade-off as dsh-search-first.
  */
-export declare const LOCAL_FETCH_CLIENT_VERSION = "2.7.6";
+export declare const LOCAL_FETCH_CLIENT_VERSION = "2.7.7";
 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

@@ -7,7 +7,7 @@
  * dispatcher; this module keeps the same explicit trade-off as dsh-search-first.
  */
 import { htmlToMarkdown, stripInvisibleText } from './html-markdown.js';
-export const LOCAL_FETCH_CLIENT_VERSION = '2.7.6';
+export const LOCAL_FETCH_CLIENT_VERSION = '2.7.7';
 export const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export class LocalFetchError extends Error {
     code;

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

@@ -52,7 +52,7 @@ export interface WindCallResult {
  * `test/chart-composition.test.mjs` 守着（会因漂移而失败），这里原本是写死的第二处，
  * 一次发版就得记得改两遍。所以本常量由测试一并核对（见 `test/wind-client.test.mjs`）。
  */
-export declare const WIND_CLIENT_VERSION = "2.7.6";
+export declare const WIND_CLIENT_VERSION = "2.7.7";
 export interface WindClient {
     callTool(toolName: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<WindCallResult>;
 }

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

@@ -35,7 +35,7 @@ export const WIND_SERVER_ENDPOINTS = {
  * `test/chart-composition.test.mjs` 守着（会因漂移而失败），这里原本是写死的第二处，
  * 一次发版就得记得改两遍。所以本常量由测试一并核对（见 `test/wind-client.test.mjs`）。
  */
-export const WIND_CLIENT_VERSION = '2.7.6';
+export const WIND_CLIENT_VERSION = '2.7.7';
 function errorText(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/capital-generation",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "Capital Generation：面向中国散户的 AI 投资助手插件(Capital mode Agent Preset）",
   "icon": "assets/cg-icon.png",
   "author": "v587d",