@downcity/plugins 1.0.4

package/src/voice/types/VoicePlugin.ts

@@ -0,0 +1,194 @@
+/**
+ * Voice Plugin 类型定义。
+ *
+ * 关键点（中文）
+ * - Voice 的行为配置与转写依赖配置统一收敛到 `plugins.asr`。
+ * - 这里的类型名直接反映 plugin 自身能力，不再保留 asset 心智。
+ */
+
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+
+/**
+ * Voice Plugin 行为配置。
+ */
+export interface VoicePluginConfig {
+  /**
+   * 兼容统一结构化配置约束的索引签名。
+   */
+  [key: string]: JsonValue | undefined;
+  /**
+   * 是否把转写结果注入 system/prompt 行为链。
+   */
+  injectPrompt?: boolean;
+  /**
+   * 是否在消息进入 Agent 前自动增强语音内容。
+   */
+  augmentMessage?: boolean;
+  /**
+   * 转写提供者类型。
+   */
+  provider?: "local" | "command";
+  /**
+   * 当前激活模型 ID（可选）。
+   */
+  modelId?: string;
+  /**
+   * 模型根目录（可选）。
+   */
+  modelsDir?: string;
+  /**
+   * Python 可执行文件（可选）。
+   */
+  pythonBin?: string;
+  /**
+   * 自定义命令模板（可选）。
+   */
+  command?: string;
+  /**
+   * 默认语言提示（可选）。
+   */
+  language?: string;
+  /**
+   * 转写超时时间（毫秒，可选）。
+   */
+  timeoutMs?: number;
+  /**
+   * 本地推理策略（可选）。
+   */
+  strategy?: "auto" | "funasr" | "transformers-whisper" | "command";
+  /**
+   * 已安装模型列表（可选）。
+   */
+  installedModels?: string[];
+}
+
+/**
+ * Voice 转写配置。
+ */
+export interface VoiceTranscriberConfig {
+  /**
+   * 兼容统一结构化配置约束的索引签名。
+   */
+  [key: string]: JsonValue | undefined;
+  /**
+   * 转写提供者类型。
+   *
+   * 说明（中文）
+   * - `local`：使用内建本地模型与 Python Runner。
+   * - `command`：使用用户自定义命令模板。
+   */
+  provider?: "local" | "command";
+  /**
+   * 本地模型 ID（可选）。
+   *
+   * 说明（中文）
+   * - 这是 asr plugin 内部依赖字段，不要求其他 service 直接感知。
+   */
+  modelId?: string;
+  /**
+   * 模型根目录（可选）。
+   */
+  modelsDir?: string;
+  /**
+   * Python 可执行文件（可选）。
+   */
+  pythonBin?: string;
+  /**
+   * 自定义命令模板（可选）。
+   */
+  command?: string;
+  /**
+   * 默认语言提示（可选）。
+   */
+  language?: string;
+  /**
+   * 转写超时时间（毫秒，可选）。
+   */
+  timeoutMs?: number;
+  /**
+   * 本地推理策略（可选）。
+   *
+   * 说明（中文）
+   * - `auto`：按模型自动选择 runner。
+   * - `funasr` / `transformers-whisper`：固定使用对应 runner。
+   * - `command`：使用自定义命令模板。
+   */
+  strategy?: "auto" | "funasr" | "transformers-whisper" | "command";
+  /**
+   * 已安装模型列表（可选）。
+   *
+   * 说明（中文）
+   * - 仅作为状态快照使用，不应被 plugin 直接依赖。
+   */
+  installedModels?: string[];
+}
+
+/**
+ * Voice 转写安装输入。
+ */
+export interface VoiceTranscriberInstallInput {
+  /**
+   * 兼容统一结构化配置约束的索引签名。
+   */
+  [key: string]: JsonValue | undefined;
+  /**
+   * 需要安装的模型 ID 列表（可选）。
+   */
+  modelIds?: string[];
+  /**
+   * 安装完成后激活的模型 ID（可选）。
+   */
+  activeModel?: string;
+  /**
+   * 是否强制覆盖已存在资源。
+   */
+  force?: boolean;
+  /**
+   * 模型目录（可选）。
+   */
+  modelsDir?: string;
+  /**
+   * Python 可执行文件（可选）。
+   */
+  pythonBin?: string;
+  /**
+   * 是否同时安装转写依赖。
+   */
+  installDeps?: boolean;
+  /**
+   * HuggingFace Token（可选）。
+   */
+  hfToken?: string;
+}
+
+/**
+ * Voice 转写句柄。
+ */
+export interface VoiceTranscriberHandle {
+  /**
+   * 执行音频转写。
+   */
+  transcribe(input: {
+    /**
+     * 待转写音频路径。
+     */
+    audioPath: string;
+    /**
+     * 语言提示（可选）。
+     */
+    language?: string;
+  }): Promise<{
+    /**
+     * 转写是否成功。
+     */
+    success: boolean;
+    /**
+     * 转写文本（可选）。
+     */
+    text?: string;
+    /**
+     * 错误信息（可选）。
+     */
+    error?: string;
+  }>;
+}

package/src/web/Dependency.ts

@@ -0,0 +1,17 @@
+/**
+ * Web Plugin 兼容导出层。
+ *
+ * 关键点（中文）
+ * - `web` plugin 只保留薄适配层。
+ * - 真正的联网/浏览器能力由外部 provider 项目负责。
+ */
+
+export {
+  readWebPluginConfig,
+  writeWebPluginConfig,
+} from "@/web/runtime/Config.js";
+export {
+  inspectWebPluginDependency,
+  installWebPluginDependency,
+  doctorWebPluginDependency,
+} from "@/web/runtime/Source.js";

package/src/web/PROMPT.agent-browser.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/web/PROMPT.agent-browser.ts.txt
+const TEXT_MODULE_CONTENT = "# Web Plugin / agent-browser\n\n当前 provider 是 `agent-browser`。\n\n你应直接使用 `agent-browser` 项目的浏览器自动化方法，而不是在本项目里自己实现浏览器交互。\n\n工作原则：\n\n- 浏览器交互、打开页面、点击、填写、截图、滚动等操作优先交给 `agent-browser`\n- 严格遵循 `agent-browser` 的基本工作流：\n  1. `open`\n  2. `snapshot -i`\n  3. 使用元素引用交互\n  4. 页面变化后重新 snapshot\n- 如果 `agent-browser` 命令不可用，应先报告依赖缺失\n\n你在处理需要浏览器操作的任务时，应以外部 `agent-browser` 项目为准。\n";
+
+export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.agent-browser.ts.txt

@@ -0,0 +1,17 @@
+# Web Plugin / agent-browser
+
+当前 provider 是 `agent-browser`。
+
+你应直接使用 `agent-browser` 项目的浏览器自动化方法，而不是在本项目里自己实现浏览器交互。
+
+工作原则：
+
+- 浏览器交互、打开页面、点击、填写、截图、滚动等操作优先交给 `agent-browser`
+- 严格遵循 `agent-browser` 的基本工作流：
+  1. `open`
+  2. `snapshot -i`
+  3. 使用元素引用交互
+  4. 页面变化后重新 snapshot
+- 如果 `agent-browser` 命令不可用，应先报告依赖缺失
+
+你在处理需要浏览器操作的任务时，应以外部 `agent-browser` 项目为准。

package/src/web/PROMPT.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/web/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "# Web Plugin\n\n此 plugin 已内化 `web-access` 的核心联网策略。只要 plugin 启用，就应把联网任务当作一等能力处理。\n\n## 总原则\n\n- 目标驱动：像人一样思考，先定义成功标准，再选择最可能直达的起点。\n- 过程校验：每一步结果都是证据。路径不推进时，及时切换方法，不在错误方式上反复重试。\n- 一手来源优先：搜索引擎用于发现线索，结论尽量回到官网、官方平台、原始页面、官方文档或源码。\n- 完成即停止：达到目标后不要为了“看起来更完整”继续消耗额外步骤。\n\n## 工具选择\n\n- 需要发现信息来源、查关键词脉络：优先 `WebSearch`\n- 已知 URL，需要定向提取页面正文或答案：优先 `WebFetch`\n- 已知 URL，需要原始 HTML、meta、JSON-LD 等结构化内容：优先 `curl`\n- 需要登录态、动态渲染、站内导航、复杂交互或反爬站点：直接使用浏览器/CDP 能力\n- 页面正文导向内容可优先考虑 Jina 类 markdown 预处理，以节省 token；但数据面板、商品页、复杂布局页面不要盲信预处理结果\n\n## 浏览器策略\n\n- 进入浏览器层后，先理解页面结构，再决定下一步动作\n- 程序化手段快但更容易触发反爬；GUI 交互更慢但确定性更高。程序化受阻时，回退到 GUI\n- 优先使用页面自身生成的链接，不要手工猜测或裁剪站内 URL 参数\n- 只操作自己创建的标签页，不打扰用户已有标签页；任务结束后关闭自己创建的标签页\n- 遇到登录墙时，先判断它是否真的阻挡目标；只有目标确实拿不到时再要求用户登录\n\n## 并行与核实\n\n- 多个独立调研目标可并行拆分；有依赖关系的目标不要盲目并行\n- 核实类任务要回到一手来源，不要用多个二手报道互相循环印证\n\n来源说明：该内化策略参考 `https://github.com/eze-is/web-access`，并按 Downcity plugin 体系进行了收敛与改写。\n";
+
+export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.ts.txt

@@ -0,0 +1,33 @@
+# Web Plugin
+
+此 plugin 已内化 `web-access` 的核心联网策略。只要 plugin 启用，就应把联网任务当作一等能力处理。
+
+## 总原则
+
+- 目标驱动：像人一样思考，先定义成功标准，再选择最可能直达的起点。
+- 过程校验：每一步结果都是证据。路径不推进时，及时切换方法，不在错误方式上反复重试。
+- 一手来源优先：搜索引擎用于发现线索，结论尽量回到官网、官方平台、原始页面、官方文档或源码。
+- 完成即停止：达到目标后不要为了“看起来更完整”继续消耗额外步骤。
+
+## 工具选择
+
+- 需要发现信息来源、查关键词脉络：优先 `WebSearch`
+- 已知 URL，需要定向提取页面正文或答案：优先 `WebFetch`
+- 已知 URL，需要原始 HTML、meta、JSON-LD 等结构化内容：优先 `curl`
+- 需要登录态、动态渲染、站内导航、复杂交互或反爬站点：直接使用浏览器/CDP 能力
+- 页面正文导向内容可优先考虑 Jina 类 markdown 预处理，以节省 token；但数据面板、商品页、复杂布局页面不要盲信预处理结果
+
+## 浏览器策略
+
+- 进入浏览器层后，先理解页面结构，再决定下一步动作
+- 程序化手段快但更容易触发反爬；GUI 交互更慢但确定性更高。程序化受阻时，回退到 GUI
+- 优先使用页面自身生成的链接，不要手工猜测或裁剪站内 URL 参数
+- 只操作自己创建的标签页，不打扰用户已有标签页；任务结束后关闭自己创建的标签页
+- 遇到登录墙时，先判断它是否真的阻挡目标；只有目标确实拿不到时再要求用户登录
+
+## 并行与核实
+
+- 多个独立调研目标可并行拆分；有依赖关系的目标不要盲目并行
+- 核实类任务要回到一手来源，不要用多个二手报道互相循环印证
+
+来源说明：该内化策略参考 `https://github.com/eze-is/web-access`，并按 Downcity plugin 体系进行了收敛与改写。

package/src/web/PROMPT.web-access.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/web/PROMPT.web-access.ts.txt
+const TEXT_MODULE_CONTENT = "# Web Plugin / web-access\n\n当前 provider 是 `web-access`。\n\n你应直接遵循已安装的 `web-access` skill/project 逻辑，而不是在本项目里重新实现一套联网框架。\n\n工作原则：\n\n- 优先沿用 `web-access` 自己的联网策略、工具选择和浏览哲学\n- 把 Downcity 的 `web` plugin 视为 provider 选择器与接入层\n- 如果 `web-access` 不可用，先指出依赖缺失，而不是自行退回到本项目里的临时实现\n\n你在处理联网任务时，应以外部 `web-access` 项目为准。\n";
+
+export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.web-access.ts.txt

@@ -0,0 +1,13 @@
+# Web Plugin / web-access
+
+当前 provider 是 `web-access`。
+
+你应直接遵循已安装的 `web-access` skill/project 逻辑，而不是在本项目里重新实现一套联网框架。
+
+工作原则：
+
+- 优先沿用 `web-access` 自己的联网策略、工具选择和浏览哲学
+- 把 Downcity 的 `web` plugin 视为 provider 选择器与接入层
+- 如果 `web-access` 不可用，先指出依赖缺失，而不是自行退回到本项目里的临时实现
+
+你在处理联网任务时，应以外部 `web-access` 项目为准。