dsh-dock 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wycto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# dsh-dock
+
+[![npm version](https://img.shields.io/npm/v/dsh-dock)](https://www.npmjs.com/package/dsh-dock)
+[![license](https://img.shields.io/npm/l/dsh-dock)](LICENSE)
+
+**DeepSeek Harness 功能中枢插件**：用一张管理面板，统一注册、开关所有小功能。
+
+模型余额、Token 用量记录、任务动画……这些散落的小功能，全部收进一个面板：
+每个功能是独立模块，有注册表、有开关、有错误隔离。新功能按注册表模式追加，老功能互不牵连。
+
+> 前身：本地原型 `feature-hub`（已安装验证），本包为其正式发布的 npm 版本。
+> 相关功能包：`@wycto/dsh-balance-panel`、`@wycto/dsh-token-usage`、`@wycto/dsh-task-pulse`
+> （后续按路线图吸收为中枢内的功能模块，或保持独立包并注册进中枢）。
+
+---
+
+## 当前状态（v0.1.0 · 基础框架）
+
+- ✅ 设置页新增一整页「功能中枢」面板（侧栏底部 → 设置 → 功能中枢）
+- ✅ 功能注册表：`FEATURES` 一处登记，面板自动渲染
+- ✅ 每功能独立开关 + 错误隔离：单个功能出错只降级自己
+- ✅ 示例功能：心跳监视、主题信息（纯 Client，开箱可用）
+- 🚧 示例功能的开关为浏览器内存态，刷新重置（持久化在 0.5.0）
+- 🚧 三个真实功能已登记为**规划占位**，面板可见但显示"规划中"
+
+## 面板入口
+
+```
+设置（侧栏底部）→ 功能中枢
+```
+
+## 目录结构
+
+```
+dsh-dock/
+├── index.js          # Host 半部：功能注册表 + 每功能生命周期（setup/dispose）+ 错误隔离
+├── client.js         # Client 半部：中枢面板（settings.section），浏览器 bundle，无需构建器
+├── cordis.patch.yml  # 组合层：insert 一行 dsh-dock
+├── package.json      # 双面程序包清单（dsh.bundle.patch + dsh.client）
+└── scripts/publish.sh # 一键发布（登录检查 + 预览 + publish）
+```
+
+## 路线图（后面要干嘛）
+
+| 版本 | 内容 | 动哪里 |
+| --- | --- | --- |
+| **0.2.0** | 接入**模型余额**：拉取所有模型 Provider 账户余额并展示 | `index.js` 的 `hostSetups.balance` 实现拉取；打通 Client↔Host 联通（typert）；`client.js` 的 balance 占位改为真实视图 |
+| **0.3.0** | 接入 **Token 用量记录**：记录全部 LLM API 调用，支持时间范围/维度筛选与统计 | `hostSetups.tokenlog` 监听事件记账；面板加统计视图 |
+| **0.4.0** | 接入**任务动画**：任务进度动画、完成/卡住通知 | 纯 Client 功能模块；如需挂对话区，在模块内注册对应 slot（如 `conversation.composer.dock`） |
+| **0.5.0** | 开关状态**持久化**、Host↔Client 双侧注册表打通 | 状态写入持久化服务；可选依赖注册（面板不在，功能照跑） |
+
+后续新增功能遵循同一模式：**注册表加一条 + 视图加一个**，即插即用。
+
+## 新增一个功能（三步）
+
+1. `client.js` 的 `FEATURES` 加一条 `{ id, name, description, defaultEnabled }`；
+2. `featureViews` 加同名组件（`react.createElement` 写法，可用 `ctx.get(...)` 取 Client 服务）；
+3. 需要 Host 侧逻辑的，在 `index.js` 的 `hostSetups` 加一个返回 disposer 的函数。
+
+## 安装
+
+开发期（link 模式）：
+
+```sh
+dsh plugin --profile web add dsh-dock   # npm 版安装
+# 或本地路径：dsh plugin --profile web add /path/to/dsh-dock
+```
+
+查看/卸载：
+
+```sh
+dsh web --dump-config                    # 查看合成层（含 dsh-dock）
+dsh plugin --profile web remove dsh-dock # 卸载
+```
+
+### 从 feature-hub 迁移
+
+本包是 feature-hub 原型的正式发布版，面板与功能几乎一致：
+
+```sh
+dsh plugin --profile web remove dsh-feature-hub
+dsh plugin --profile web add dsh-dock
+```
+
+（两个插件共存亦可，只是面板重复；建议迁移后移除旧版。）
+
+## 开发与发布
+
+- **开发提交**：Gitea 仓库（`wycto/dsh-dock`）
+- **发版**：GitHub 仓库（`github.com/wycto/dsh-dock`）打 tag 发 Release
+- **npm 发布**（无作用域名先到先得，已占用后归本账号所有）：
+
+```sh
+cd dsh-dock
+npm login          # 首次：登录你的 npm 账号（wycto）
+scripts/publish.sh # 预览 → 登录检查 → 发布
+```
+
+> 若发布时报 `EPERM`（npm 缓存目录里有 root 属主文件的历史 bug）：
+> 修复一次 `sudo chown -R 501:20 ~/.npm`，或临时绕过
+> `CACHE_DIR=/tmp/dsh-dock-npm-cache ./scripts/publish.sh`。
+
+> 注：`package.json` 中仓库链接请在 Gitea/GitHub 建仓后按实际地址更新。
+
+## License
+
+MIT

package/client.js

@@ -0,0 +1,115 @@
+// dsh-dock · Client 半部（浏览器 bundle，手写 lazy-CJS 工厂格式，无需构建器）
+// 面板挂载在 settings.section：设置 → 功能中枢
+// 每个功能是一个模块：FEATURES 注册表 + featureViews 视图组件 + 独立开关（内存态）。
+// planned: true 的功能为规划占位（见 README 路线图），接入后移除 planned 并提供视图即可。
+window.__ModuleLoader__.load({
+	id: "dsh-dock",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+
+		const name = "dsh-dock";
+		const inject = ["timer"];
+
+		// ---- 功能注册表：新功能在这里加一条，featureViews 里加同名视图 ----
+		const FEATURES = [
+			{ id: "heartbeat", name: "心跳监视", description: "示例功能：面板侧运行时长心跳（纯 Client）", defaultEnabled: true },
+			{ id: "theme", name: "主题信息", description: "示例功能：读取当前主题快照（纯 Client）", defaultEnabled: true },
+			{ id: "balance", name: "模型余额", description: "接入路线图 0.2.0：展示所有模型 Provider 账户余额", planned: true },
+			{ id: "tokenlog", name: "Token 用量记录", description: "接入路线图 0.3.0：记录全部 LLM API 调用并统计", planned: true },
+			{ id: "animation", name: "任务动画", description: "接入路线图 0.4.0：任务进度动画与通知", planned: true }
+		];
+
+		const CSS = [
+			".dock-root{display:flex;flex-direction:column;gap:12px;padding:4px 0;color:var(--dsw-alias-label-primary);font-size:13px;}",
+			".dock-intro{color:var(--dsw-alias-label-secondary);line-height:1.6;}",
+			".dock-card{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);border-radius:10px;padding:12px 14px;display:flex;flex-direction:column;gap:8px;}",
+			".dock-card-head{display:flex;align-items:center;gap:8px;}",
+			".dock-dot{width:8px;height:8px;border-radius:50%;background:var(--dsw-alias-label-secondary);flex:none;}",
+			".dock-dot.on{background:var(--dsw-alias-state-success-primary);}",
+			".dock-dot.err{background:var(--dsw-alias-state-error-primary);}",
+			".dock-name{font-weight:600;flex:none;}",
+			".dock-desc{color:var(--dsw-alias-label-secondary);flex:1;}",
+			".dock-switch{flex:none;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);border-radius:999px;padding:3px 10px;cursor:pointer;font-size:12px;}",
+			".dock-switch.on{color:var(--dsw-alias-state-success-primary);border-color:var(--dsw-alias-state-success-primary);}",
+			".dock-badge{flex:none;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);border-radius:999px;padding:3px 10px;font-size:12px;}",
+			".dock-body{border-top:1px solid var(--dsw-alias-border-l1);padding-top:8px;color:var(--dsw-alias-label-secondary);display:flex;flex-direction:column;gap:4px;}"
+		].join("\n");
+
+		function apply(ctx) {
+			const slots = ctx.get("slots");
+			if (slots === undefined) return;
+
+			// 开关状态：浏览器内存态，随页面生命周期
+			const state = new Map();
+			for (const f of FEATURES) state.set(f.id, { enabled: !!f.defaultEnabled, error: null });
+
+			// ---- 每个功能的客户端视图：key 与注册表 id 一致 ----
+			const featureViews = {
+				heartbeat: function HeartbeatView() {
+					const [sec, setSec] = react.useState(0);
+					react.useEffect(() => ctx.interval(() => setSec((s) => s + 1), 1000), []);
+					const m = Math.floor(sec / 60);
+					return react.createElement("div", null,
+						"面板已运行 " + (m > 0 ? m + " 分 " : "") + (sec % 60) + " 秒");
+				},
+				theme: function ThemeView() {
+					const theme = ctx.get("theme");
+					if (theme === undefined) return react.createElement("div", null, "theme 服务不可用");
+					let snap = null;
+					try { snap = theme.getTheme(); }
+					catch (err) { return react.createElement("div", null, "读取失败：" + String((err && err.message) || err)); }
+					const label = snap && typeof snap.id === "string" ? snap.id
+						: snap && typeof snap.name === "string" ? snap.name : "未知";
+					return react.createElement("div", null, "当前主题：" + label);
+				}
+			};
+
+			function DockPanel() {
+				const [, force] = react.useReducer((n) => n + 1, 0);
+				const toggle = (id) => {
+					const st = state.get(id);
+					if (!st) return;
+					st.enabled = !st.enabled;
+					force();
+				};
+				return react.createElement("div", { className: "dock-root" },
+					react.createElement("style", null, CSS),
+					react.createElement("div", { className: "dock-intro" },
+						"功能中枢（dsh-dock）· 所有小功能集中在这一个面板里管理。每个功能是独立模块：开关只影响自己，单个功能出错不影响其他功能。新功能按注册表模式追加（FEATURES + featureViews 各加一条）。"),
+					FEATURES.map((f) => {
+						const st = state.get(f.id);
+						const View = featureViews[f.id];
+						return react.createElement("div", { className: "dock-card", key: f.id },
+							react.createElement("div", { className: "dock-card-head" },
+								react.createElement("span", { className: "dock-dot" + (st.error ? " err" : st.enabled ? " on" : "") }),
+								react.createElement("span", { className: "dock-name" }, f.name),
+								react.createElement("span", { className: "dock-desc" }, f.description),
+								f.planned
+									? react.createElement("span", { className: "dock-badge" }, "规划中")
+									: react.createElement("button", {
+										className: "dock-switch" + (st.enabled ? " on" : ""),
+										onClick: () => toggle(f.id)
+									}, st.enabled ? "已启用" : "已停用")),
+							f.planned
+								? react.createElement("div", { className: "dock-body" }, "待接入：见 README 路线图")
+								: st.error ? react.createElement("div", { className: "dock-body dock-err" }, "功能出错：" + st.error) : null,
+							!f.planned && st.enabled && View
+								? react.createElement("div", { className: "dock-body" }, react.createElement(View, null))
+								: null);
+					}));
+			}
+
+			slots.inject("settings.section", () => slots.register(
+				{ name: "settings.section", id: "dsh-dock", order: 90, label: "功能中枢" },
+				() => react.createElement(DockPanel, null)));
+		}
+
+		exports.name = name;
+		exports.inject = inject;
+		exports.apply = apply;
+		return module.exports;
+	}
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-dock
+      name: dsh-dock

package/index.js

@@ -0,0 +1,89 @@
+// dsh-dock · Host 半部（Node 侧入口）
+//
+// v0.1.0 基础框架：
+//   - 功能注册表（FEATURES）：与 Client 半部注册表同构，规划中的功能已登记；
+//   - 每功能独立生命周期（hostSetups 返回 disposer，开关只影响自己）；
+//   - 函数级错误隔离：单个功能 setup 抛错只标记 error，不影响其他功能。
+//
+// 路线图：
+//   - 0.2.0 接入模型余额：在 hostSetups.balance 里实现余额拉取，
+//     Client↔Host 联通（typert）随本版本一起打通；
+//   - 0.3.0 接入 Token 用量记录：hostSetups.tokenlog 监听事件记账；
+//   - 0.4.0 接入任务动画。
+export const name = 'dsh-dock'
+
+export function apply(ctx) {
+  // ---- 功能注册表（Host 侧）----
+  // defaultEnabled 缺省为 false：v0.1.0 只有示例功能，真实功能按路线图接入后打开。
+  const FEATURES = [
+    {
+      id: 'balance',
+      name: '模型余额',
+      roadmap: '0.2.0',
+      description: '拉取所有模型 Provider 账户余额',
+    },
+    {
+      id: 'tokenlog',
+      name: 'Token 用量记录',
+      roadmap: '0.3.0',
+      description: '记录全部 LLM API 调用并统计',
+    },
+    {
+      id: 'animation',
+      name: '任务动画',
+      roadmap: '0.4.0',
+      description: '任务进度动画与通知',
+    },
+  ]
+
+  const state = new Map()
+  for (const f of FEATURES) state.set(f.id, { enabled: false, dispose: null, error: null })
+
+  // 每个功能的 Host 半部安装函数：返回 disposer，关闭功能时调用。
+  // 接入时在此实现，例如：
+  //   balance: () => {
+  //     const stop = ctx.interval(pullBalance, 60_000)
+  //     return () => stop()
+  //   },
+  const hostSetups = {}
+
+  function setEnabled(id, enabled) {
+    const st = state.get(id)
+    if (!st || st.enabled === enabled) return
+    st.enabled = enabled
+    st.error = null
+    if (enabled) {
+      const setup = hostSetups[id]
+      if (setup) {
+        try {
+          st.dispose = setup() || null
+        } catch (err) {
+          st.error = String((err && err.message) || err)
+          console.error('[dsh-dock] feature setup failed:', id, err)
+        }
+      }
+    } else if (st.dispose) {
+      try {
+        st.dispose()
+      } catch (err) {
+        console.error('[dsh-dock] feature dispose failed:', id, err)
+      }
+      st.dispose = null
+    }
+  }
+
+  console.log('[dsh-dock] host half loaded; features registered:', FEATURES.map((f) => f.id).join(', '))
+
+  // 插件卸载/更新时兜底清理仍在运行的功能
+  ctx.effect(() => () => {
+    for (const st of state.values()) {
+      if (st.dispose) {
+        try {
+          st.dispose()
+        } catch (err) {
+          /* ignore */
+        }
+      }
+    }
+  })
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "dsh-dock",
+  "version": "0.1.0",
+  "description": "DeepSeek Harness 功能中枢插件：用一张管理面板统一注册、开关所有小功能（模型余额、Token 用量记录、任务动画等）。0.1.0 为基础框架版本，功能接入路线见 README。",
+  "type": "module",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml"
+  ],
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": { "patch": "./cordis.patch.yml" },
+    "client": { "platform": "web" }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "panel",
+    "hub",
+    "feature-hub",
+    "web",
+    "dashboard"
+  ],
+  "author": "wycto",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wycto/dsh-dock.git"
+  },
+  "homepage": "https://github.com/wycto/dsh-dock",
+  "publishConfig": {
+    "access": "public"
+  }
+}