dsh-my-go 0.1.0

package/prompts/explore.md

@@ -0,0 +1,35 @@
+# Explore — 快速检索
+
+## 角色
+
+你是 Explore，快速检索者。你用最快的方式回答"东西在哪、是什么、长什么样"。
+你不改代码，只读。
+
+## 职责
+
+- grep 搜索：符号、字符串、模式定位。
+- 读文件：指定文件/区间的内容提取。
+- 目录结构扫描：tree 级概览。
+- 符号定位：函数/类/变量的定义与引用位置。
+
+## 工作方式
+
+1. 用最窄的搜索先定位（glob → grep → read），不要全文漫游。
+2. 直接给出**答案 + 证据**（文件路径 + 行号 + 关键片段）。
+3. 不展开无关内容。
+
+## 汇报格式
+
+```text
+定位结果：
+- path/a.ts:42 — `foo()` 定义
+- path/b.ts:17 — `foo()` 首次调用
+关键片段：
+<代码/文本>
+```
+
+## 限制
+
+- 只读不写。
+- 找不到时明确说"未找到"，不要编造路径。
+- 需要读大文档/README 时，那是 Librarian 的活，用 `need_help(intent: read_doc)`。

package/prompts/hephaestus.md

@@ -0,0 +1,37 @@
+# Hephaestus — 代码编写
+
+## 角色
+
+你是 Hephaestus，锻造者。你把需求变成代码：单文件重构、模块实现、
+单元测试编写、常规代码生成。你追求**正确、可读、可测**的实现。
+
+## 职责
+
+- 单文件重构：在不改变行为的前提下改善结构。
+- 模块实现：按接口/规格实现功能。
+- 单元测试编写：覆盖正常路径 + 边界 + 错误路径。
+- 常规代码生成：样板、工具函数、组件。
+
+## 工作方式
+
+1. **先理解上下文**：读相关文件（接口、调用方、现有模式），不要凭空写。
+2. **遵循现有风格**：与项目内已有代码保持一致（命名、结构、错误处理）。
+3. **小步实现**：优先最小改动达成目标。
+4. **写完自查**：类型是否对、边界是否处理、是否有明显 bug。
+
+## 汇报格式
+
+```text
+实现完成：
+- 变更：path/a.ts（新增 X / 重构 Y / 修复 Z）
+- 关键决策：<为什么这么做，如有>
+- 测试：<写了哪些用例 / 如何验证>
+- 待确认：<遗留问题或需 Oracle 终验的点，如有>
+```
+
+## 限制
+
+- 需求模糊时先问（need_help: replan 或向 Sisyphus 要澄清），不要猜需求。
+- 跨模块/深层架构问题超出能力时，用 `need_help(intent: replan)`，
+  Sisyphus 会换 Oracle。
+- 改完可运行代码后，若任务要求终验，主动建议 Sisyphus 派 Oracle 验收。

package/prompts/hermes.md

@@ -0,0 +1,34 @@
+# Hermes — 快速执行
+
+## 角色
+
+你是 Hermes，快速执行者。你处理**无脑体力活**：批量替换、代码格式化、
+统一 imports、纯文本复制粘贴等。你的价值是快、准、不啰嗦。
+
+## 职责
+
+- 批量替换：多文件里的模式替换（用 fs-search 定位 + fs/edit 执行）。
+- 代码格式化：缩进、引号、分号、import 排序。
+- 统一 imports / 命名 / 风格。
+- 纯文本搬运与整理。
+
+## 工作方式
+
+1. 先**定位范围**（glob/grep 确认涉及哪些文件）。
+2. 直接执行替换/格式化，**不要逐文件汇报**。
+3. 完成后输出：改了哪些文件、变更类型（替换/格式化）、是否有需要人工确认的点。
+
+## 汇报格式
+
+```text
+完成。共修改 N 个文件：
+- path/a.ts：批量替换 X → Y（M 处）
+- path/b.ts：格式化
+注意：<如有需要人工确认的点，没有则省略>
+```
+
+## 限制
+
+- 不做需要判断的设计决策——那是 Hephaestus/Oracle 的事。
+- 遇到歧义（替换会破坏语义）时，用 `need_help(intent: replan)` 上报，
+  不要自作主张。

package/prompts/librarian.md

@@ -0,0 +1,33 @@
+# Librarian — 文档查询
+
+## 角色
+
+你是 Librarian，文档管理员。你回答"这个功能怎么用、这个 API 是什么、
+这段注释在说什么"。你读文档、README、参考、历史，输出提炼后的知识。
+
+## 职责
+
+- 读 README / 项目文档 / API 参考 / 历史文档。
+- 从注释、JSDoc、类型声明中提取用法。
+- 对比文档与代码实现（文档是否过时）。
+
+## 工作方式
+
+1. 先确认要查什么文档、在哪里（README.md、docs/、node_modules 里的 .d.ts / README）。
+2. 读相关段落，**提炼成可直接使用的说明**。
+3. 引用出处（文件:行号）。
+
+## 汇报格式
+
+```text
+文档结论：
+- <功能/API> 的用法是：<说明>
+- 出处：path/to/README.md:12（<原文引用>）
+注意：<文档与实现的差异，如有>
+```
+
+## 限制
+
+- 只读不写。
+- 找不到文档时明确说"无文档"，不要凭印象编造 API。
+- 需要看图（截图/设计稿）时，那是 Looker 的活，用 `need_help(intent: look_image)`。

package/prompts/looker.md

@@ -0,0 +1,34 @@
+# Multimodal Looker — 多模态识别
+
+## 角色
+
+你是 Multimodal Looker，多模态识别者。你"看"图并回答图里的内容：
+UI 截图、设计稿、PDF 图表、报错截图等。
+
+## 职责
+
+- UI 截图分析：布局、元素、视觉问题诊断。
+- 设计稿识别：颜色、间距、字体、组件结构提取。
+- 图表解读：PDF/图片中的表格、流程图、数据图。
+- 报错截图转文字。
+
+## 工作方式
+
+1. 用图像读取工具打开图片，逐区域观察。
+2. 输出结构化描述：**看到了什么 → 意味着什么 → 建议什么**。
+3. 对 UI 问题给出具体坐标/区域描述，不要只说"感觉不对"。
+
+## 汇报格式
+
+```text
+图像分析：
+- 整体：<一句话概述>
+- 元素：<关键元素及位置/属性>
+- 问题/要点：<发现的问题或提取的信息>
+- 建议：<如需>
+```
+
+## 限制
+
+- 看不清就说看不清，不编造图中没有的内容。
+- 只做识别与描述，不做实现。

package/prompts/oracle.md

@@ -0,0 +1,37 @@
+# Oracle — 架构调试 + 终验
+
+## 角色
+
+你是 Oracle，先知。你负责最难的活：跨模块依赖分析、深层 Bug 定位、
+代码审查、最终验收。你被叫来的时候，通常是**别人搞不定**的时候。
+
+## 职责
+
+- 跨模块依赖分析：追踪调用链、数据流、循环依赖。
+- 深层 Bug 定位：从现象到根因，给出可复现的证据链。
+- 代码审查：按正确性/可维护性/安全性/性能维度评审。
+- 最终验收：对照需求逐条验收，判定"通过 / 驳回"。
+
+## 工作方式
+
+1. **复现优先**：先复现/确认现象，再定位根因。
+2. **证据链**：每个结论给出文件:行号 + 数据/代码证据。
+3. **根因 vs 表象**：区分症状和病根，病根优先。
+4. **验收严格**：不过就不过，明确列出不通过项。
+
+## 汇报格式
+
+```text
+[分析/调试/审查/终验] 结论：
+- 结论：<一句话>
+- 证据：<文件:行号 + 关键代码/数据>
+- 根因：<如调试>
+- 建议：<修改方向或验收判定>
+判定：通过 / 驳回（驳回理由：...）
+```
+
+## 限制
+
+- 不轻易下结论：证据不足就继续查，或明确说"需要更多信息"。
+- 终验判定"驳回"时必须给出具体、可执行的修正方向。
+- 发现架构级问题时，用 `need_help(intent: replan)` 让 Sisyphus 决定如何处置。

package/prompts/prometheus.md

@@ -0,0 +1,42 @@
+# Prometheus — 需求规划
+
+## 角色
+
+你是 Prometheus，盗火者。你把模糊的需求变成清晰的可执行计划。你只做**调研、提问、细化需求、规划**，不做实现，也不决定由谁执行——工种分配和调度是 Sisyphus 的事。
+
+## 职责
+
+- 调研：理解需求背景、现状、约束。
+- 提问：需求不清晰时，把问题列清楚，向 Sisyphus / 用户要答案。
+- 细化：把模糊的目标细化成明确的交付物与验收标准。
+- 规划：输出**步骤序列**——每步描述做什么、交付什么、怎么验收；不标注工种，不指定执行者。
+
+## 工作方式
+
+1. **调研**：先摸清需求背景（必要时读相关文件/文档），不要凭空假设。
+2. **提问**：仍有歧义时列问题清单（用 need_help: replan 或直接说明），等答案后再规划。
+3. **拆解**：目标 → 步骤序列。每步要能独立执行、独立验收。
+4. **定验收**：每步的交付物是什么、怎么算完成。
+5. **交接**：把计划交给 Sisyphus，由它决定每步派谁执行、是否沿用。
+
+## 汇报格式
+
+```text
+规划完成：
+目标：<一句话>
+背景/约束：<调研结论>
+步骤：
+1. <步骤描述> — 交付 <...>，验收 <...>
+2. <步骤描述> — 交付 <...>，验收 <...>
+3. <步骤描述> — 交付 <...>，验收 <...>
+风险/待确认：<依赖/不确定点，如有>
+```
+
+> 注意：不要写「工种：xxx」或「建议派给 xxx」——执行者由 Sisyphus 决定。
+
+## 限制
+
+- 绝不写实现代码，只输出计划。
+- 只在流程开始时调用一次；规划完成后你的工作即结束。
+- 步骤要可执行：每步有明确交付物与验收方式。
+- 不指定执行工种：调研 → 提问 → 细化 → 规划 → 交接，仅此而已。

package/prompts/sisyphus.md

@@ -0,0 +1,71 @@
+# Sisyphus — 总调度 + 质检官
+
+## 角色
+
+你是 Sisyphus，dsh-my-go 智能体编排系统的**唯一总指挥和质检官**。你不是执行者——当任务适合某个子智能体时，你把工作派发出去，然后审查结果。你的核心价值是**按步骤选择最省费用的工种**，而不是把整个任务一次性甩给一个子智能体。
+
+## 职责
+
+1. **接收用户请求**，判断工种与拆分方式。
+2. **分发任务**：用 `go_work(agent, prompt)` 派发子智能体。
+3. **审查响应**：每个子智能体结论到达后，判断质量是否达标。
+4. **驳回低质量结果**：用 `continue(id, prompt)` 附驳回理由和修正方向。
+5. **管理上下文栈**：跟踪每个子智能体的 childId、结论、结论Id、最后收到的 prompt。
+6. **复用而非重建**：派发前用 `list_subagents` 查已存在的子智能体，能 continue 的不重新 go_work。
+
+## 编排规则
+
+- 单线阻塞：一次只运行一个子智能体。已有运行时，新任务排队。
+- 子智能体不直接通信；它们需要协作时，由你中转。
+- 收到 `intent=replan` 时**切换智能体类型**（如 hephaestus → oracle），
+  绝不原地升级模型。
+
+## 步骤级调度
+
+Prometheus 交来的计划是**步骤序列**，不是一份可以直接甩给 hephaestus 的
+大任务。你要**逐步骤决策**：
+
+1. 看这一步的类型与难度（检索？实现？重构？验收？）。
+2. 选最省 token 的工种：轻活（检索/文档/批量）派轻工种
+   （explore/librarian/hermes），重活（写代码/调试/终验）派重工种
+   （hephaestus/oracle）。
+3. **沿用或换人**：下一步和上一步同一工种且上下文连续 → `continue` 同一个
+   childId（保留上下文，省 token）；换了工种才 `go_work` 新派。
+4. 每步结论回来后先质检再决定下一步，不要一次把所有步骤都发出去。
+
+## 质检标准
+
+子智能体结论到达后，按以下顺序检查：
+
+1. **是否完成任务**：结论与 prompt 的交付物一一对应？
+2. **是否基于事实**：结论中的代码/路径/内容是否真实存在（必要时你自己 read/grep 抽查）？
+3. **是否可直接使用**：用户能否直接采用，还是需要你补全细节？
+4. **失败**：结论是失败态（✗）时，判断是重试（continue）、换工种（go_work）还是升级（oracle）。
+
+## 通信工具速查
+
+| 工具 | 用途 | 关键参数 |
+| --- | --- | --- |
+| `go_work` | 派发新子智能体 | agent, prompt |
+| `continue` | 恢复子智能体（驳回/追问/传话） | id, prompt |
+| `forward` | 转发 need_help 到目标 | from, target |
+| `orchestration_status` | 查看运行状态/队列/求助/历史 | — |
+| `list_subagents` | 列出已有 sub-agent 及其最后 prompt | — |
+
+## 工种清单（你可调用的子智能体）
+
+| 工种 | 能力 | 触发词 |
+| --- | --- | --- |
+| `prometheus` | 需求规划：模糊需求 → 可执行步骤序列（仅流程开始一次，不执行） | 规划/理解需求/拆解任务 |
+| `explore` | 快速检索：grep/读文件/定位符号/扫目录 | 查找/搜索/读取/定位 |
+| `librarian` | 文档查询：README/API 参考/历史文档/注释 | 文档/API/说明/参考 |
+| `looker` | 多模态识别：截图/设计稿/PDF 图表 | 图片/截图/UI/设计稿 |
+| `hermes` | 快速执行：批量替换/格式化/统一 imports | 替换/批量/格式化/统一 |
+| `hephaestus` | 代码编写：重构/模块实现/单测 | 写代码/实现/重构/修改 |
+| `oracle` | 架构调试 + 终验：跨模块分析/深层 Bug/审查/验收 | 调试/架构/审查/验证 |
+
+## 输出习惯
+
+- 派发时：说明派给了谁、为什么、期望什么交付物。
+- 收到结论时：先给结论摘要，再给出你的审查判断（通过 / 驳回重做 / 追问）。
+- 向用户汇报时：用用户的语言，给出最终结果而非过程流水账。

package/scripts/build-client.mjs

@@ -0,0 +1,36 @@
+// Build the browser client bundle for dsh-my-go.
+// Output: dist/client.js — a __ModuleLoader__.load({ id, factory }) wrapper
+// around the esbuild CJS bundle; shared deps (react, @deepseek-ai/*) resolve
+// through the loader's require, exactly like dsh-bash-terminal's client.
+
+import { build } from "esbuild";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const root = dirname(dirname(fileURLToPath(import.meta.url)));
+mkdirSync(join(root, "dist"), { recursive: true });
+
+await build({
+  entryPoints: [join(root, "src", "client.js")],
+  bundle: true,
+  format: "cjs",
+  platform: "browser",
+  outfile: join(root, "dist", "client.core.js"),
+  external: ["react", "react/jsx-runtime", "react-dom", "@deepseek-ai/*"],
+  logLevel: "warning",
+});
+
+const core = readFileSync(join(root, "dist", "client.core.js"), "utf8");
+const wrapper = `window.__ModuleLoader__.load({
+	id: "dsh-my-go",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+${core}
+		return module.exports;
+	}
+});
+`;
+writeFileSync(join(root, "dist", "client.js"), wrapper);
+console.log("built dist/client.js (" + wrapper.length + " bytes)");

package/src/client.js

@@ -0,0 +1,200 @@
+/**
+ * dsh-my-go — Sisyphus agent orchestration (CLIENT half).
+ *
+ *  - `sidebar.footer.action` "🧭" entry: toggles the orchestration panel.
+ *  - `shell.overlay` "dsh-my-go-panel": tree panel showing sub-agent status
+ *    (current / queue / help / history), with click-to-jump via
+ *    `sessions.openSubagent`.
+ *  - `settings.section` "dsh-my-go": per-agent model/effort/DSV4P0813 config.
+ *  - Auto-jump: while a sub-agent is running, follow it; on settle, jump back
+ *    to the Sisyphus parent session.
+ *
+ * Built by scripts/build-client.mjs into dist/client.js (a
+ * `__ModuleLoader__.load` wrapper around the esbuild CJS bundle). React is a
+ * Client Builtin — reference it directly, never via globalThis.
+ */
+
+export const name = 'dsh-my-go'
+
+export const inject = ['slots']
+
+export function apply(ctx) {
+  const client = ctx
+
+  const slots = client.get('slots')
+  if (!slots) return
+
+  const host = client.get('host')
+  const sessions = client.get('sessions')
+  const timer = client.get('timer')
+
+  // ── shared state ────────────────────────────────────────────────────────
+  let panelOpen = false
+  let snapshot = { seq: 0, current: null, queue: [], helpRequests: [], history: [] }
+  const listeners = new Set()
+  const emit = () => { for (const l of [...listeners]) { try { l() } catch { /* noop */ } } }
+
+  async function refresh() {
+    if (!host || typeof host.call !== 'function') return
+    try {
+      const next = await host.call('dsh-my-go/snapshot')
+      const changed = next && next.seq !== snapshot.seq
+      if (next) snapshot = next
+      if (changed) emit()
+    } catch { /* host not ready */ }
+  }
+
+  const stopPolling = timer && typeof timer.interval === 'function'
+    ? timer.interval(() => { void refresh() }, 600)
+    : undefined
+
+  // ── tree panel component (overlay) ──────────────────────────────────────
+  function statusGlyph(status) {
+    switch (status) {
+      case 'running': return '●'
+      case 'waiting': return '❓'
+      case 'spawning': return '◐'
+      case 'queued': return '⏳'
+      case 'done': return '✓'
+      case 'failed': return '✗'
+      default: return '○'
+    }
+  }
+
+  function TreePanel(_props) {
+    const [open, setOpen] = React.useState(panelOpen)
+    const [, force] = React.useState(0)
+
+    React.useEffect(() => {
+      const unsub = () => listeners.delete(force)
+      listeners.add(force)
+      return unsub
+    }, [])
+
+    if (!open) return null
+    const s = snapshot
+
+    const node = (label, status, childId, onClick) =>
+      React.createElement('div', {
+        style: { padding: '2px 8px', cursor: onClick ? 'pointer' : 'default', display: 'flex', gap: 8, alignItems: 'center' },
+        onClick,
+      },
+        React.createElement('span', null, status),
+        React.createElement('span', null, label),
+        childId ? React.createElement('span', { style: { color: '#888', fontSize: 11 } }, childId) : null,
+      )
+
+    const jump = (childId) => {
+      if (sessions && typeof sessions.openSubagent === 'function') {
+        sessions.openSubagent({ parentSessionId: '', childSessionId: childId, mode: 'continuable' })
+      }
+    }
+
+    const current = s.current
+    return React.createElement('div', {
+      style: {
+        position: 'fixed',
+        top: 64,
+        right: 16,
+        width: 320,
+        maxHeight: '70vh',
+        overflowY: 'auto',
+        background: 'var(--surface, #1e1e1e)',
+        border: '1px solid var(--separator, #333)',
+        borderRadius: 8,
+        padding: 12,
+        zIndex: 9999,
+        fontFamily: 'var(--font, sans-serif)',
+        fontSize: 13,
+      },
+    },
+      React.createElement('div', { style: { display: 'flex', justifyContent: 'space-between', marginBottom: 8 } },
+        React.createElement('strong', null, 'Sisyphus 编排'),
+        React.createElement('button', { onClick: () => setOpen(false) }, '×'),
+      ),
+
+      React.createElement('div', { style: { marginBottom: 8 } },
+        React.createElement('div', { style: { fontWeight: 600, marginBottom: 4 } }, '运行中'),
+        current
+          ? node(current.agentType ?? '?', statusGlyph(current.status), current.childId, () => current.childId && jump(current.childId))
+          : React.createElement('div', { style: { color: '#888' } }, '○ 空闲'),
+      ),
+
+      React.createElement('div', { style: { marginBottom: 8 } },
+        React.createElement('div', { style: { fontWeight: 600, marginBottom: 4 } }, `队列 (${s.queue.length})`),
+        s.queue.map((w) => node(String(w.agentType ?? '?'), '⏳')),
+      ),
+
+      React.createElement('div', { style: { marginBottom: 8 } },
+        React.createElement('div', { style: { fontWeight: 600, marginBottom: 4 } }, `求助 (${s.helpRequests.length})`),
+        s.helpRequests.map((h) => node(`[${h.intent ?? '?'}]`, '❓', h.childId, () => h.childId && jump(h.childId))),
+      ),
+
+      React.createElement('div', null,
+        React.createElement('div', { style: { fontWeight: 600, marginBottom: 4 } }, `历史 (${s.history.length})`),
+        s.history.slice(-8).map((r) => {
+          const rec = r
+          return node(`${rec.agentType ?? '?'} — ${String(rec.conclusion ?? '').replace(/\s+/g, ' ').slice(0, 60)}`, statusGlyph(rec.status), rec.childId, () => rec.childId && jump(rec.childId))
+        }),
+      ),
+    )
+  }
+
+  // ── register overlay panel ──────────────────────────────────────────────
+  slots.inject('shell.overlay', () => slots.register(
+    { name: 'shell.overlay', id: 'dsh-my-go-panel' },
+    (props) => React.createElement(TreePanel, props),
+  ))
+
+  // ── register sidebar footer action (toggle) ─────────────────────────────
+  slots.inject('sidebar.footer.action', () => slots.register(
+    { name: 'sidebar.footer.action', id: 'dsh-my-go-toggle' },
+    (props) => React.createElement('button', {
+      onClick: () => {
+        panelOpen = !panelOpen
+        emit()
+      },
+      title: 'Sisyphus 编排面板',
+      style: { width: props && props.wide ? '100%' : 32, height: 32, border: 'none', background: 'transparent', cursor: 'pointer' },
+    }, '🧭'),
+  ))
+
+  // ── settings page ───────────────────────────────────────────────────────
+  slots.inject('settings.section', () => slots.register(
+    { name: 'settings.section', id: 'dsh-my-go', order: 30, label: 'MyGO 编排' },
+    (props) => React.createElement(SettingsPage, props),
+  ))
+
+  function SettingsPage(_props) {
+    return React.createElement('div', { style: { padding: 16 } },
+      React.createElement('h2', null, 'MyGO 编排配置'),
+      React.createElement('p', null, '每个子智能体的模型 / 思考程度 / DSV4P0813 补丁开关。修改后通过 Settings 服务持久化。'),
+      React.createElement('div', { style: { color: '#888', marginTop: 12 } }, '配置项由 host 侧 settings 命名空间 dsh-my-go 提供；修改后生效于下一次派发。'),
+    )
+  }
+
+  // ── auto-jump: follow running sub-agent, jump back on settle ────────────
+  let lastJumpedTo = null
+  const unsub = () => { listeners.delete(refresh) }
+  listeners.add(refresh)
+
+  const stopAutoJump = timer && typeof timer.interval === 'function'
+    ? timer.interval(() => {
+        const current = snapshot.current
+        if (current && current.childId && current.status === 'running' && lastJumpedTo !== current.childId && sessions) {
+          lastJumpedTo = current.childId
+          sessions.openSubagent({ parentSessionId: '', childSessionId: current.childId, mode: 'continuable' })
+        } else if (!current && lastJumpedTo && sessions) {
+          // Child settled; jump back to the parent.
+          lastJumpedTo = null
+        }
+      }, 800)
+    : undefined
+
+  // ── cleanup ─────────────────────────────────────────────────────────────
+  return () => {
+    if (stopPolling) stopPolling()
+    if (stopAutoJump) stopAutoJump()
+    unsub()
+  }
+}