dsh-wealth 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nickszy
+
+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

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# dsh-wealth（资产账本）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness（DSH）桌面端插件：多账户、多资产、多币种的持仓与交易流水管理。
+
+## 安装
+在 DSH 桌面端插件页「添加插件」输入名称即可（npm 包名）：
+
+```
+dsh-wealth
+```
+
+或命令行（profile 里）：
+
+```
+dsh plugin --profile desktop add dsh-wealth
+```
+
+安装后重启客户端，左侧导航出现「资产」。
+
+> npm: <https://www.npmjs.com/package/dsh-wealth> · GitHub: <https://github.com/Nickszy/dsh-wealth>
+
+## 功能
+- 左侧导航「资产」入口，点开是完整资产页
+- 账户管理：券商/银行/基金/手写账本，每个账户可设币种
+- 持仓：手动录入或 CSV 导入，支持手填现价与成本
+- 流水：买入/卖出记账，自动更新持仓数量与成本
+- 多币种：CNY/HKD/USD…，汇率可手改，统一折算到本位币
+- 对话维护：`资产管家` Bot 通过 `cli.mjs` 读写同一份账本
+
+## 数据位置
+`%USERPROFILE%\.dsh\data\dsh-portfolio\ledger.json`（本机文件，自动 `.bak` 备份，不上云）
+
+## 给 AI 用（cli.mjs）
+```
+node cli.mjs state
+node cli.mjs summary
+node cli.mjs account.upsert name=华泰证券 type=broker currency=CNY
+node cli.mjs trade.add accountId=ACC_xxx symbol=600519 side=buy qty=100 price=1600
+node cli.mjs help
+```
+操作列表见 `node cli.mjs help`。PowerShell 下建议用 `key=value` 形式（JSON 里的双引号会被吞）。
+
+## 结构
+- `index.js` — 宿主半身：`/portfolio/api/*` 路由（state / op）
+- `store.mjs` — JSON 存储与操作分发（原子写、.bak 备份、多币种折算）
+- `cli.mjs` — 命令行读写入口（给 AI）
+- `client.js` — 前端页面（左侧「资产」入口 + 总览/账户/持仓/流水/录入）
+- `cordis.patch.yml` — bundle 注册补丁
+
+## License
+MIT

package/cli.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// dsh-portfolio CLI — how the AI (资产管家) reads and writes the ledger.
+// Usage:
+//   node cli.mjs state
+//   node cli.mjs summary
+//   node cli.mjs '<op-json>'          e.g. '{"op":"trade.add","accountId":"...","symbol":"600519","side":"buy","qty":100,"price":1600}'
+//   node cli.mjs help
+// Every command prints one JSON object to stdout. Nothing is interactive.
+import { load, save, applyOp, summarize, OpError, DATA_FILE, DATA_DIR } from './store.mjs'
+
+function out(obj, code = 0) {
+  process.stdout.write(JSON.stringify(obj, null, 2) + '\n')
+  process.exitCode = code
+}
+
+function help() {
+  out({
+    ok: true,
+    dataFile: DATA_FILE,
+    dataDir: DATA_DIR,
+    usage: [
+      'node cli.mjs state                          # full ledger',
+      'node cli.mjs summary                        # valued totals in base currency',
+      'node cli.mjs <op> key=value key=value ...   # run one operation',
+      'node cli.mjs \'{"op":"...",...}\'             # or pass one JSON object',
+      '',
+      'examples:',
+      '  node cli.mjs account.upsert name=华泰证券 type=broker currency=CNY',
+      '  node cli.mjs trade.add accountId=ACC_xxx symbol=600519 side=buy qty=100 price=1600',
+      '  node cli.mjs holding.upsert accountId=ACC_xxx symbol=00700 market=HK qty=200 avgCost=380',
+      '  node cli.mjs price.set instrumentId=INS_xxx price=1650',
+      '  node cli.mjs fx.set currency=HKD rate=0.92',
+    ],
+    ops: {
+      'account.upsert': '{op, account:{id?,name,type?,currency?,note?}}',
+      'account.remove': '{op, id}',
+      'instrument.upsert': '{op, instrument:{id?,symbol,name?,market?,assetClass?,currency?}}',
+      'holding.upsert': '{op, holding:{id?,accountId,symbol|instrumentId,market?,qty,avgCost,currency?,manualPrice?,note?}}',
+      'holding.remove': '{op, id}',
+      'trade.add': '{op, accountId, symbol|instrumentId, market?, side:"buy"|"sell", qty, price, fee?, currency?, date?, note?}',
+      'trade.remove': '{op, id}',
+      'price.set': '{op, holdingId?|instrumentId?, price}',
+      'fx.set': '{op, currency, rate}   # 1 unit of currency = ? base',
+      'base.set': '{op, currency}',
+      'import.holdings': '{op, rows:[holding...]}',
+      'import.trades': '{op, rows:[trade...]}',
+    },
+  })
+}
+
+function parseValue(v) {
+  if (/^-?\d+(\.\d+)?$/.test(v)) return Number(v)
+  if (v === 'true') return true
+  if (v === 'false') return false
+  return v
+}
+
+// Accepts: op <name> k=v k=v ...   OR a single JSON argument '{...}'
+function parseRequest(args) {
+  if (args[0] && args[0].trim().startsWith('{')) {
+    const req = JSON.parse(args.join(' '))
+    const op = req.op || req.operation
+    const payload = { ...req }; delete payload.op; delete payload.operation
+    return { op, payload }
+  }
+  const [op, ...rest] = args
+  const payload = {}
+  for (const token of rest) {
+    const eq = token.indexOf('=')
+    if (eq > 0) payload[token.slice(0, eq)] = parseValue(token.slice(eq + 1))
+    else if (token.startsWith('-')) { /* ignore stray flags */ }
+  }
+  return { op, payload }
+}
+
+const arg = process.argv.slice(2)
+if (arg.length === 0 || arg[0] === 'help' || arg[0] === '--help' || arg[0] === '-h') { help() }
+else if (arg[0] === 'state') {
+  const db = load()
+  out({ ok: true, ledger: db, summary: summarize(db) })
+} else if (arg[0] === 'summary') {
+  out({ ok: true, summary: summarize(load()) })
+} else {
+  let req
+  try { req = parseRequest(arg) } catch (e) { out({ ok: false, error: { code: 'bad-json', message: '参数解析失败: ' + e.message } }, 2); process.exit() }
+  const { op, payload } = req
+  if (!op) { out({ ok: false, error: { code: 'bad-request', message: '缺少 op' } }, 2); process.exit() }
+  const db = load()
+  try {
+    const result = applyOp(db, op, payload)
+    save(db)
+    out({ ok: true, op, result, summary: summarize(db) })
+  } catch (error) {
+    const code = error instanceof OpError ? error.code : 'internal'
+    out({ ok: false, op, error: { code, message: error.message } }, 1)
+  }
+}

package/client.js

@@ -0,0 +1,379 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-wealth',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+
+    // ---------- palette ----------
+    function useIsDark() {
+      const [dark, setDark] = React.useState(() => {
+        try { return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches } catch (_) { return true }
+      })
+      React.useEffect(() => {
+        let mq
+        try {
+          mq = window.matchMedia('(prefers-color-scheme: dark)')
+          const on = (e) => setDark(e.matches)
+          mq.addEventListener ? mq.addEventListener('change', on) : mq.addListener(on)
+          return () => { mq.removeEventListener ? mq.removeEventListener('change', on) : mq.removeListener(on) }
+        } catch (_) { /* ignore */ }
+      }, [])
+      return dark
+    }
+    function palette(dark) {
+      return dark
+        ? { bg: '#0f1115', panel: '#161a21', card: '#1d222b', border: '#2b323d', text: '#e6e8ee', sub: '#9aa3b2', accent: '#5b8cff', green: '#3ddc84', red: '#ff6161', input: '#12161d' }
+        : { bg: '#f6f7f9', panel: '#ffffff', card: '#ffffff', border: '#e3e6eb', text: '#1b1f27', sub: '#6b7480', accent: '#2f6fed', green: '#1f9d55', red: '#d64545', input: '#ffffff' }
+    }
+
+    // ---------- data access ----------
+    async function getState() {
+      const r = await fetch('/portfolio/api/state', { headers: { accept: 'application/json' } })
+      return r.json()
+    }
+    async function runOp(op, payload) {
+      const r = await fetch('/portfolio/api/op', {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ op, ...(payload || {}) }),
+      })
+      return r.json()
+    }
+
+    function fmtMoney(n, cur) {
+      if (n === null || n === undefined || Number.isNaN(n)) return '—'
+      const v = Math.abs(n) >= 10000 ? Math.round(n).toLocaleString('zh-CN') : (Math.round(n * 100) / 100).toLocaleString('zh-CN')
+      return (cur ? '' : '') + v + (cur ? ' ' + cur : '')
+    }
+    function fmtPct(n) { if (n === null || !Number.isFinite(n)) return '—'; return (n >= 0 ? '+' : '') + (Math.round(n * 100) / 100) + '%' }
+
+    const T = {
+      th: (c, t) => h('th', { style: { textAlign: 'left', padding: '8px 10px', fontSize: 12, color: t.sub, fontWeight: 500, borderBottom: '1px solid ' + t.border, whiteSpace: 'nowrap' } }, c),
+      td: (c, t, extra) => h('td', { style: Object.assign({ padding: '8px 10px', fontSize: 13, color: t.text, borderBottom: '1px solid ' + t.border, verticalAlign: 'middle' }, extra || {}) }, c),
+      btn: (t, active) => ({ padding: '6px 12px', fontSize: 13, borderRadius: 7, cursor: 'pointer', border: '1px solid ' + (active ? t.accent : t.border), background: active ? t.accent : t.card, color: active ? '#fff' : t.text }),
+      input: (t) => ({ padding: '7px 9px', fontSize: 13, borderRadius: 7, border: '1px solid ' + t.border, background: t.input, color: t.text, outline: 'none', width: '100%', boxSizing: 'border-box' }),
+      card: (t) => ({ background: t.card, border: '1px solid ' + t.border, borderRadius: 10, padding: 14 }),
+      label: (t) => ({ fontSize: 12, color: t.sub, marginBottom: 4, display: 'block' }),
+    }
+
+    // ---------- main page ----------
+    function PortfolioPage() {
+      const dark = useIsDark(); const t = palette(dark)
+      const [tab, setTab] = React.useState('overview')
+      const [state, setState] = React.useState(null)
+      const [err, setErr] = React.useState('')
+      const [busy, setBusy] = React.useState(false)
+
+      const reload = React.useCallback(async () => {
+        try { const s = await getState(); if (s.ok) { setState(s); setErr('') } else setErr(s.error?.message || '读取失败') }
+        catch (e) { setErr('无法连接插件服务：' + e.message) }
+      }, [])
+      React.useEffect(() => { reload() }, [reload])
+
+      const call = async (op, payload) => {
+        setBusy(true)
+        try { const r = await runOp(op, payload); if (r.ok) { setState({ ok: true, ledger: r.ledger, summary: r.summary }); setErr('') } else setErr(r.error?.message || '操作失败'); return r }
+        catch (e) { setErr('操作失败：' + e.message); return { ok: false } }
+        finally { setBusy(false) }
+      }
+
+      const tabs = [['overview', '总览'], ['accounts', '账户'], ['holdings', '持仓'], ['trades', '流水'], ['input', '录入/导入']]
+      return h('div', { style: { height: '100%', overflow: 'auto', background: t.bg, color: t.text, fontFamily: 'system-ui,-apple-system,"Segoe UI",Roboto,sans-serif' } },
+        h('div', { style: { maxWidth: 1080, margin: '0 auto', padding: '18px 20px 40px' } },
+          h('div', { style: { display: 'flex', alignItems: 'center', gap: 10, marginBottom: 14 } },
+            h('div', { style: { fontSize: 18, fontWeight: 650 } }, '资产账本'),
+            h('div', { style: { fontSize: 12, color: t.sub } }, state?.summary ? ('· 本位币 ' + state.summary.baseCurrency) : ''),
+            h('div', { style: { flex: 1 } }),
+            h('button', { style: T.btn(t, false), onClick: reload, disabled: busy }, '刷新'),
+          ),
+          h('div', { style: { display: 'flex', gap: 8, marginBottom: 14, flexWrap: 'wrap' } },
+            tabs.map(([id, name]) => h('button', { key: id, style: T.btn(t, tab === id), onClick: () => setTab(id) }, name)),
+          ),
+          err ? h('div', { role: 'alert', style: { ...T.card(t), borderColor: t.red, color: t.red, marginBottom: 12, fontSize: 13 } }, err) : null,
+          !state ? h('div', { style: { color: t.sub, fontSize: 13 } }, '加载中…') :
+            tab === 'overview' ? h(Overview, { t, state, call, busy }) :
+            tab === 'accounts' ? h(Accounts, { t, state, call, busy }) :
+            tab === 'holdings' ? h(Holdings, { t, state, call, busy }) :
+            tab === 'trades' ? h(Trades, { t, state, call, busy }) :
+            h(Input, { t, state, call, busy }),
+          h('div', { style: { marginTop: 22, fontSize: 11, color: t.sub, lineHeight: 1.7 } },
+            '数据全部保存在本机；行情取不到时可直接手填现价/成本。要用对话记账，打开左侧「资产管家」会话直接说，例如「把华泰账户买 200 股贵州茅台，价格 1600 记上」。'),
+        ),
+      )
+    }
+
+    function Overview({ t, state, call, busy }) {
+      const s = state.summary, db = state.ledger
+      const accMap = new Map(db.accounts.map((a) => [a.id, a]))
+      const cur = db.baseCurrency
+      const [baseSel, setBaseSel] = React.useState(cur)
+      React.useEffect(() => { setBaseSel(cur) }, [cur])
+      const [fxEdit, setFxEdit] = React.useState({ cur: '', rate: '' })
+      return h('div', null,
+        h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(3,minmax(0,1fr))', gap: 12, marginBottom: 14 } },
+          h('div', { style: T.card(t) }, h('div', { style: T.label(t) }, '总市值'), h('div', { style: { fontSize: 22, fontWeight: 650 } }, fmtMoney(s.totalValueBase, s.baseCurrency))),
+          h('div', { style: T.card(t) }, h('div', { style: T.label(t) }, '总成本'), h('div', { style: { fontSize: 22, fontWeight: 650 } }, fmtMoney(s.totalCostBase, s.baseCurrency))),
+          h('div', { style: T.card(t) }, h('div', { style: T.label(t) }, '浮动盈亏'), h('div', { style: { fontSize: 22, fontWeight: 650, color: s.totalPnlBase >= 0 ? t.green : t.red } }, fmtMoney(s.totalPnlBase, s.baseCurrency))),
+        ),
+        h('div', { style: { ...T.card(t), marginBottom: 14 } },
+          h('div', { style: { display: 'flex', gap: 12, alignItems: 'flex-end', flexWrap: 'wrap' } },
+            h('div', null, h('label', { style: T.label(t) }, '本位币'), h('select', { value: baseSel, onChange: (e) => setBaseSel(e.target.value), style: { ...T.input(t), width: 120 } },
+              [...new Set(['CNY', 'HKD', 'USD', ...Object.keys(db.fx)])].map((c) => h('option', { key: c, value: c }, c)))),
+            h('button', { style: T.btn(t, false), disabled: busy, onClick: () => call('base.set', { currency: baseSel }) }, '设为本位币'),
+            h('div', { style: { width: 1, height: 28, background: t.border } }),
+            h('div', null, h('label', { style: T.label(t) }, '币种'), h('input', { value: fxEdit.cur, onChange: (e) => setFxEdit({ ...fxEdit, cur: e.target.value.toUpperCase() }), placeholder: 'HKD', style: { ...T.input(t), width: 90 } })),
+            h('div', null, h('label', { style: T.label(t) }, '汇率(1单位=?' + cur + ')'), h('input', { value: fxEdit.rate, onChange: (e) => setFxEdit({ ...fxEdit, rate: e.target.value }), placeholder: '0.92', style: { ...T.input(t), width: 110 } })),
+            h('button', { style: T.btn(t, false), disabled: busy, onClick: async () => { await call('fx.set', { currency: fxEdit.cur, rate: Number(fxEdit.rate) }); setFxEdit({ cur: '', rate: '' }) } }, '保存汇率'),
+          ),
+          h('div', { style: { marginTop: 10, fontSize: 12, color: t.sub } }, '当前汇率：' + Object.entries(db.fx).map(([c, r]) => c + '→' + cur + ' ' + r).join('　')),
+        ),
+        h('div', { style: T.card(t) },
+          h('div', { style: { fontSize: 13, fontWeight: 600, marginBottom: 8 } }, '各账户'),
+          s.accounts.length === 0 ? h('div', { style: { color: t.sub, fontSize: 13 } }, '还没有账户，去「账户」页添加。') :
+          h('table', { style: { width: '100%', borderCollapse: 'collapse' } },
+            h('thead', null, h('tr', null, T.th('账户', t), T.th('持仓数', t), T.th('市值', t), T.th('成本', t), T.th('盈亏', t))),
+            h('tbody', null, s.accounts.map((a) => h('tr', { key: a.accountId },
+              T.td((accMap.get(a.accountId)?.name || a.accountId) + (accMap.get(a.accountId) ? ' · ' + accMap.get(a.accountId).currency : ''), t),
+              T.td(String(a.holdings), t),
+              T.td(fmtMoney(a.valueBase, cur), t),
+              T.td(fmtMoney(a.costBase, cur), t),
+              T.td(fmtMoney(a.pnlBase, cur), t, { color: a.pnlBase >= 0 ? t.green : t.red }),
+            ))),
+          ),
+        ),
+      )
+    }
+
+    function Accounts({ t, state, call, busy }) {
+      const db = state.ledger
+      const [form, setForm] = React.useState({ name: '', type: 'broker', currency: 'CNY', note: '' })
+      const [editId, setEditId] = React.useState(null)
+      const submit = async () => {
+        if (!form.name.trim()) return
+        await call('account.upsert', { account: { id: editId || undefined, ...form } })
+        setForm({ name: '', type: 'broker', currency: 'CNY', note: '' }); setEditId(null)
+      }
+      return h('div', null,
+        h('div', { style: { ...T.card(t), marginBottom: 14 } },
+          h('div', { style: { display: 'grid', gridTemplateColumns: '1.4fr 1fr 0.8fr 1.4fr auto', gap: 10, alignItems: 'end' } },
+            h('div', null, h('label', { style: T.label(t) }, '账户名'), h('input', { value: form.name, onChange: (e) => setForm({ ...form, name: e.target.value }), placeholder: '如 华泰证券', style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '类型'), h('select', { value: form.type, onChange: (e) => setForm({ ...form, type: e.target.value }), style: T.input(t) }, ['broker', 'bank', 'fund', 'hand'].map((x) => h('option', { key: x, value: x }, x)))),
+            h('div', null, h('label', { style: T.label(t) }, '币种'), h('input', { value: form.currency, onChange: (e) => setForm({ ...form, currency: e.target.value.toUpperCase() }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '备注'), h('input', { value: form.note, onChange: (e) => setForm({ ...form, note: e.target.value }), style: T.input(t) })),
+            h('button', { style: T.btn(t, true), disabled: busy, onClick: submit }, editId ? '保存' : '添加账户'),
+          ),
+        ),
+        h('div', { style: T.card(t) },
+          h('table', { style: { width: '100%', borderCollapse: 'collapse' } },
+            h('thead', null, h('tr', null, T.th('账户', t), T.th('类型', t), T.th('币种', t), T.th('备注', t), T.th('操作', t))),
+            h('tbody', null, db.accounts.length ? db.accounts.map((a) => h('tr', { key: a.id },
+              T.td(a.name, t), T.td(a.type, t), T.td(a.currency, t), T.td(a.note || '—', t),
+              T.td(h('span', null,
+                h('button', { style: { ...T.btn(t, false), padding: '3px 8px', marginRight: 6 }, onClick: () => { setForm({ name: a.name, type: a.type, currency: a.currency, note: a.note || '' }); setEditId(a.id) } }, '编辑'),
+                h('button', { style: { ...T.btn(t, false), padding: '3px 8px', borderColor: t.red, color: t.red }, onClick: () => { if (window.confirm('删除账户「' + a.name + '」及其全部持仓和流水？')) call('account.remove', { id: a.id }) } }, '删除'),
+              ), t),
+            )) : h('tr', null, T.td('还没有账户', t, { color: t.sub }))),
+          ),
+        ),
+      )
+    }
+
+    function Holdings({ t, state, call, busy }) {
+      const db = state.ledger
+      const accMap = new Map(db.accounts.map((a) => [a.id, a]))
+      const insMap = new Map(db.instruments.map((i) => [i.id, i]))
+      const [form, setForm] = React.useState({ accountId: db.accounts[0]?.id || '', symbol: '', name: '', market: 'CN', qty: '', avgCost: '', currency: '', manualPrice: '' })
+      const submit = async () => {
+        if (!form.accountId || !form.symbol.trim()) return
+        await call('holding.upsert', { holding: { ...form, qty: Number(form.qty) || 0, avgCost: Number(form.avgCost) || 0, manualPrice: form.manualPrice === '' ? null : Number(form.manualPrice) } })
+        setForm({ ...form, symbol: '', name: '', qty: '', avgCost: '', manualPrice: '' })
+      }
+      return h('div', null,
+        h('div', { style: { ...T.card(t), marginBottom: 14 } },
+          h('div', { style: { display: 'grid', gridTemplateColumns: '1fr 0.9fr 1fr 0.6fr 0.7fr 0.7fr 0.7fr 0.8fr auto', gap: 8, alignItems: 'end' } },
+            h('div', null, h('label', { style: T.label(t) }, '账户'), h('select', { value: form.accountId, onChange: (e) => setForm({ ...form, accountId: e.target.value }), style: T.input(t) }, db.accounts.map((a) => h('option', { key: a.id, value: a.id }, a.name)))),
+            h('div', null, h('label', { style: T.label(t) }, '代码'), h('input', { value: form.symbol, onChange: (e) => setForm({ ...form, symbol: e.target.value.trim() }), placeholder: '600519', style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '名称'), h('input', { value: form.name, onChange: (e) => setForm({ ...form, name: e.target.value }), placeholder: '贵州茅台', style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '市场'), h('select', { value: form.market, onChange: (e) => setForm({ ...form, market: e.target.value }), style: T.input(t) }, ['CN', 'HK', 'US', 'FUND'].map((x) => h('option', { key: x, value: x }, x)))),
+            h('div', null, h('label', { style: T.label(t) }, '数量'), h('input', { value: form.qty, onChange: (e) => setForm({ ...form, qty: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '成本'), h('input', { value: form.avgCost, onChange: (e) => setForm({ ...form, avgCost: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '现价(手填)'), h('input', { value: form.manualPrice, onChange: (e) => setForm({ ...form, manualPrice: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '币种'), h('input', { value: form.currency, onChange: (e) => setForm({ ...form, currency: e.target.value.toUpperCase() }), placeholder: '自动', style: T.input(t) })),
+            h('button', { style: T.btn(t, true), disabled: busy, onClick: submit }, '添加/更新'),
+          ),
+        ),
+        h('div', { style: T.card(t) },
+          h('table', { style: { width: '100%', borderCollapse: 'collapse' } },
+            h('thead', null, h('tr', null, T.th('标的', t), T.th('账户', t), T.th('数量', t), T.th('成本', t), T.th('现价', t), T.th('币种', t), T.th('市值(本位币)', t), T.th('操作', t))),
+            h('tbody', null, db.holdings.length ? db.holdings.map((ho) => {
+              const ins = insMap.get(ho.instrumentId); const acc = accMap.get(ho.accountId)
+              const price = ho.manualPrice ?? ho.avgCost ?? 0
+              const rate = db.fx[ho.currency] ?? 1
+              const mv = ho.qty * price * rate
+              return h('tr', { key: ho.id },
+                T.td((ins ? ins.name + ' ' + ins.symbol : ho.instrumentId), t),
+                T.td(acc ? acc.name : ho.accountId, t),
+                T.td(String(ho.qty), t),
+                T.td(fmtMoney(ho.avgCost), t),
+                T.td(h('input', { defaultValue: ho.manualPrice ?? '', placeholder: '手填', onBlur: (e) => { const v = e.target.value; if (v !== '' && String(ho.manualPrice ?? '') !== v) call('price.set', { holdingId: ho.id, price: Number(v) }) }, style: { ...T.input(t), width: 78 } }), t),
+                T.td(ho.currency, t),
+                T.td(fmtMoney(mv, db.baseCurrency), t),
+                T.td(h('button', { style: { ...T.btn(t, false), padding: '3px 8px', borderColor: t.red, color: t.red }, onClick: () => { if (window.confirm('删除该持仓？')) call('holding.remove', { id: ho.id }) } }, '删除'), t),
+              )
+            }) : h('tr', null, T.td('还没有持仓', t, { color: t.sub }))),
+          ),
+        ),
+      )
+    }
+
+    function Trades({ t, state, call, busy }) {
+      const db = state.ledger
+      const accMap = new Map(db.accounts.map((a) => [a.id, a]))
+      const insMap = new Map(db.instruments.map((i) => [i.id, i]))
+      const [form, setForm] = React.useState({ accountId: db.accounts[0]?.id || '', symbol: '', side: 'buy', qty: '', price: '', fee: '', date: new Date().toISOString().slice(0, 10), currency: '' })
+      const submit = async () => {
+        if (!form.accountId || !form.symbol.trim()) return
+        await call('trade.add', { trade: { ...form, qty: Number(form.qty) || 0, price: Number(form.price) || 0, fee: Number(form.fee) || 0 } })
+        setForm({ ...form, symbol: '', qty: '', price: '', fee: '' })
+      }
+      return h('div', null,
+        h('div', { style: { ...T.card(t), marginBottom: 14 } },
+          h('div', { style: { display: 'grid', gridTemplateColumns: '1fr 0.8fr 0.7fr 0.6fr 0.7fr 0.6fr 0.9fr 0.7fr auto', gap: 8, alignItems: 'end' } },
+            h('div', null, h('label', { style: T.label(t) }, '账户'), h('select', { value: form.accountId, onChange: (e) => setForm({ ...form, accountId: e.target.value }), style: T.input(t) }, db.accounts.map((a) => h('option', { key: a.id, value: a.id }, a.name)))),
+            h('div', null, h('label', { style: T.label(t) }, '代码'), h('input', { value: form.symbol, onChange: (e) => setForm({ ...form, symbol: e.target.value.trim() }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '方向'), h('select', { value: form.side, onChange: (e) => setForm({ ...form, side: e.target.value }), style: T.input(t) }, [['buy', '买入'], ['sell', '卖出']].map(([v, n]) => h('option', { key: v, value: v }, n)))),
+            h('div', null, h('label', { style: T.label(t) }, '数量'), h('input', { value: form.qty, onChange: (e) => setForm({ ...form, qty: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '价格'), h('input', { value: form.price, onChange: (e) => setForm({ ...form, price: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '费用'), h('input', { value: form.fee, onChange: (e) => setForm({ ...form, fee: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '日期'), h('input', { type: 'date', value: form.date, onChange: (e) => setForm({ ...form, date: e.target.value }), style: T.input(t) })),
+            h('div', null, h('label', { style: T.label(t) }, '币种'), h('input', { value: form.currency, onChange: (e) => setForm({ ...form, currency: e.target.value.toUpperCase() }), placeholder: '自动', style: T.input(t) })),
+            h('button', { style: T.btn(t, true), disabled: busy, onClick: submit }, '记一笔'),
+          ),
+        ),
+        h('div', { style: T.card(t) },
+          h('table', { style: { width: '100%', borderCollapse: 'collapse' } },
+            h('thead', null, h('tr', null, T.th('日期', t), T.th('账户', t), T.th('标的', t), T.th('方向', t), T.th('数量', t), T.th('价格', t), T.th('金额', t), T.th('操作', t))),
+            h('tbody', null, db.trades.length ? [...db.trades].reverse().map((tr) => {
+              const ins = insMap.get(tr.instrumentId); const acc = accMap.get(tr.accountId)
+              return h('tr', { key: tr.id },
+                T.td(tr.date, t), T.td(acc ? acc.name : tr.accountId, t), T.td(ins ? ins.name + ' ' + ins.symbol : tr.instrumentId, t),
+                T.td(tr.side === 'buy' ? '买入' : '卖出', t, { color: tr.side === 'buy' ? t.red : t.green }),
+                T.td(String(tr.qty), t), T.td(fmtMoney(tr.price), t), T.td(fmtMoney(tr.qty * tr.price), t),
+                T.td(h('button', { style: { ...T.btn(t, false), padding: '3px 8px', borderColor: t.red, color: t.red }, onClick: () => { if (window.confirm('删除这条流水？（不会自动回算持仓）')) call('trade.remove', { id: tr.id }) } }, '删除'), t),
+              )
+            }) : h('tr', null, T.td('还没有流水', t, { color: t.sub }))),
+          ),
+        ),
+      )
+    }
+
+    function Input({ t, state, call, busy }) {
+      const db = state.ledger
+      const [mode, setMode] = React.useState('holdings')
+      const [text, setText] = React.useState('')
+      const [msg, setMsg] = React.useState('')
+      const sample = mode === 'holdings'
+        ? '账户名,代码,名称,市场,数量,成本,币种\n华泰证券,600519,贵州茅台,CN,100,1600,CNY\n华泰证券,00700,腾讯控股,HK,200,380,HKD'
+        : '账户名,代码,方向,数量,价格,费用,日期,币种\n华泰证券,600519,buy,100,1600,5,2026-11-06,CNY'
+      const parse = (txt) => {
+        const lines = txt.split(/\r?\n/).map((l) => l.trim()).filter(Boolean)
+        const rows = []
+        for (let i = 0; i < lines.length; i++) {
+          const cells = lines[i].split(',').map((c) => c.trim())
+          if (i === 0 && /账户|代码|方向|数量|成本/.test(cells.join(''))) continue // header
+          rows.push(cells)
+        }
+        return rows
+      }
+      const doImport = async () => {
+        setMsg('')
+        const rows = parse(text)
+        if (!rows.length) { setMsg('没有可导入的数据行'); return }
+        const accByName = new Map(db.accounts.map((a) => [a.name, a]))
+        const payload = []
+        for (const c of rows) {
+          const acc = accByName.get(c[0]); if (!acc) { setMsg('账户不存在：' + c[0] + '（请先在「账户」页添加同名账户）'); return }
+          if (mode === 'holdings') payload.push({ accountId: acc.id, symbol: c[1], name: c[2], market: c[3] || 'CN', qty: Number(c[4]) || 0, avgCost: Number(c[5]) || 0, currency: c[6] || '' })
+          else payload.push({ accountId: acc.id, symbol: c[1], side: c[2] || 'buy', qty: Number(c[3]) || 0, price: Number(c[4]) || 0, fee: Number(c[5]) || 0, date: c[6] || undefined, currency: c[7] || '' })
+        }
+        const r = await call(mode === 'holdings' ? 'import.holdings' : 'import.trades', { rows: payload })
+        if (r.ok) { setMsg('已导入 ' + (r.result?.imported ?? payload.length) + ' 条'); setText('') }
+      }
+      return h('div', null,
+        h('div', { style: { ...T.card(t), marginBottom: 14 } },
+          h('div', { style: { display: 'flex', gap: 8, marginBottom: 10 } },
+            h('button', { style: T.btn(t, mode === 'holdings'), onClick: () => setMode('holdings') }, '导入持仓'),
+            h('button', { style: T.btn(t, mode === 'trades'), onClick: () => setMode('trades') }, '导入流水'),
+          ),
+          h('div', { style: { fontSize: 12, color: t.sub, marginBottom: 6 } }, '按 CSV 粘贴（第一行表头可留）。列顺序：'),
+          h('div', { style: { fontSize: 12, color: t.text, marginBottom: 8, fontFamily: 'monospace', whiteSpace: 'pre-wrap' } }, sample.split('\n')[0]),
+          h('textarea', { value: text, onChange: (e) => setText(e.target.value), placeholder: sample, rows: 8, style: { ...T.input(t), fontFamily: 'monospace', fontSize: 12, resize: 'vertical' } }),
+          h('div', { style: { marginTop: 10, display: 'flex', gap: 10, alignItems: 'center' } },
+            h('button', { style: T.btn(t, true), disabled: busy, onClick: doImport }, '开始导入'),
+            h('button', { style: T.btn(t, false), onClick: () => setText(sample) }, '填入示例'),
+            msg ? h('span', { style: { fontSize: 12, color: t.accent } }, msg) : null,
+          ),
+        ),
+      )
+    }
+
+    // ---------- sidebar panel takeover (same pattern as market-clock) ----------
+    let ctx = null
+    const PANEL = 'dsh-wealth'
+    let shellDispose = null
+    let panelSession = null
+
+    function closePanel() {
+      const d = shellDispose; shellDispose = null; panelSession = null
+      if (d) { try { d() } catch (_) {} }
+    }
+    function openPanel() {
+      const layout = ctx && ctx.get && ctx.get('layout')
+      if (!layout || typeof layout.selectPanel !== 'function') throw new Error('布局服务不可用，无法打开资产页。')
+      if (!shellDispose) {
+        const sidebar = ctx.get('sidebarRight')
+        panelSession = (sidebar && sidebar.mounted && sidebar.mounted.getSnapshot && sidebar.mounted.getSnapshot()) || null
+        shellDispose = ctx.slots.register({ name: 'main.conversation', priority: -10 }, NativePortfolio)
+      }
+      try { layout.selectPanel(null) } catch (e) { closePanel(); throw e }
+    }
+
+    function PortfolioIcon({ size = 20 }) {
+      return h('svg', { width: size, height: size, viewBox: '0 0 24 24', fill: 'none', 'aria-hidden': true },
+        h('path', { d: 'M4 19V5 M4 19h16', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round' }),
+        h('path', { d: 'M7 15l3-4 3 2 4-6', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round' }),
+        h('circle', { cx: 17, cy: 7, r: 1.4, fill: 'currentColor' }),
+      )
+    }
+
+    function PortfolioPanelEntry() {
+      const [error, setError] = React.useState('')
+      React.useEffect(() => { try { openPanel() } catch (e) { setError(e.message || '打开失败') } }, [])
+      return h('div', { role: 'status', style: { padding: 24 } }, error || '正在打开资产账本…')
+    }
+
+    function NativePortfolio({ sessionId }) {
+      const mounted = React.useRef(false)
+      React.useEffect(() => {
+        mounted.current = true
+        const owned = shellDispose
+        return () => { mounted.current = false; queueMicrotask(() => { if (!mounted.current && shellDispose === owned) closePanel() }) }
+      }, [])
+      React.useEffect(() => { if (panelSession && sessionId !== panelSession) closePanel() }, [sessionId])
+      return h(PortfolioPage)
+    }
+
+    return {
+      inject: ['slots'],
+      apply(c) {
+        ctx = c
+        c.effect(() => c.slots.inject('sidebar.panellist', () => c.slots.register({
+          name: 'sidebar.panellist', id: PANEL, order: 30, label: '资产',
+        }, PortfolioIcon)), 'dsh-portfolio: nav')
+        c.effect(() => c.slots.inject('main', () => c.slots.register({
+          name: 'main', key: PANEL,
+        }, PortfolioPanelEntry)), 'dsh-portfolio: panel entry')
+        c.effect(() => () => closePanel(), 'dsh-portfolio: restore shell')
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: dsh-wealth
+      name: dsh-wealth
+      config: {}

package/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none">
+  <path d="M4 19V5 M4 19h16" stroke="#5b8cff" stroke-width="1.8" stroke-linecap="round"/>
+  <path d="M7 15l3-4 3 2 4-6" stroke="#3ddc84" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="17" cy="7" r="1.5" fill="#3ddc84"/>
+</svg>

package/index.js

@@ -0,0 +1,98 @@
+/**
+ * dsh-portfolio — host half.
+ * Serves the local ledger over `/portfolio/api/*` so the plugin page (client.js)
+ * can read and edit it, and so any local script can POST operations.
+ * The AI (资产管家 / any agent) edits the same store through cli.mjs.
+ */
+import { load, save, applyOp, summarize, OpError } from './store.mjs'
+
+export const name = 'dsh-wealth'
+export const inject = ['webServer']
+
+function readBody(req, limit = 5_000_000) {
+  return new Promise((resolve, reject) => {
+    let size = 0
+    const chunks = []
+    req.on('data', (c) => {
+      size += c.length
+      if (size > limit) { reject(new Error('body too large')); req.destroy(); return }
+      chunks.push(c)
+    })
+    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    req.on('error', reject)
+  })
+}
+
+function send(res, status, obj) {
+  const body = Buffer.from(JSON.stringify(obj))
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'content-length': String(body.length), 'cache-control': 'no-store' })
+  res.end(body)
+}
+
+function isLoopback(hostname) {
+  if (hostname === 'localhost' || hostname === '[::1]' || hostname === '::1') return true
+  return /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(hostname)
+}
+
+function trusted(req, ctx) {
+  const raw = req.headers.host
+  if (!raw) return false
+  let hostUrl
+  try { hostUrl = new URL('http://' + raw) } catch { return false }
+  if (req.headers['sec-fetch-site'] === 'cross-site') return false
+  const origin = req.headers.origin
+  if (origin) {
+    try { if (new URL(origin).host !== hostUrl.host) return false } catch { return false }
+  }
+  if (isLoopback(hostUrl.hostname)) return true
+  const trustedHosts = ctx.webStartup?.trustedHosts
+  if (Array.isArray(trustedHosts)) {
+    return trustedHosts.some((entry) => {
+      try { const u = new URL(/^https?:\/\//.test(entry) ? entry : 'https://' + entry); return u.hostname === hostUrl.hostname } catch { return false }
+    })
+  }
+  return false
+}
+
+export function apply(ctx) {
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'prefix',
+    path: '/portfolio',
+    handler: async (req, res) => {
+      if (!trusted(req, ctx)) { res.writeHead(403); res.end('forbidden'); return }
+      let url
+      try { url = new URL(req.url || '/', 'http://dsh.internal') } catch { res.writeHead(400); res.end(); return }
+      const path = url.pathname.replace(/^\/portfolio\/?/, '')
+      try {
+        if (path === 'api/state' || path === 'api/summary') {
+          if (req.method !== 'GET') { res.writeHead(405); res.end(); return }
+          const db = load()
+          send(res, 200, { ok: true, ledger: db, summary: summarize(db) })
+          return
+        }
+        if (path === 'api/op') {
+          if (req.method !== 'POST') { res.writeHead(405); res.end(); return }
+          const text = await readBody(req)
+          let req2
+          try { req2 = JSON.parse(text) } catch { send(res, 400, { ok: false, error: { code: 'bad-json', message: '请求体不是合法 JSON' } }); return }
+          const op = req2.op
+          if (!op) { send(res, 400, { ok: false, error: { code: 'bad-request', message: '缺少 op' } }); return }
+          const payload = { ...req2 }; delete payload.op
+          const db = load()
+          try {
+            const result = applyOp(db, op, payload)
+            save(db)
+            send(res, 200, { ok: true, op, result, ledger: db, summary: summarize(db) })
+          } catch (error) {
+            const code = error instanceof OpError ? error.code : 'internal'
+            send(res, code === 'not-found' ? 404 : code === 'bad-request' ? 400 : 500, { ok: false, op, error: { code, message: error.message } })
+          }
+          return
+        }
+        res.writeHead(404); res.end('not found')
+      } catch (error) {
+        try { send(res, 500, { ok: false, error: { code: 'internal', message: String(error && error.message || error) } }) } catch { res.destroy() }
+      }
+    },
+  }), 'dsh-portfolio: /portfolio routes')
+}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "dsh-wealth",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "资产账本：多账户、多资产、多币种持仓与交易流水管理，支持对话维护与本机持久化 | Multi-account, multi-asset, multi-currency portfolio & trade ledger for DeepSeek Harness, with chat-based maintenance.",
+  "type": "module",
+  "main": "index.js",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "files": ["index.js", "client.js", "store.mjs", "cli.mjs", "cordis.patch.yml", "icon.svg", "README.md", "LICENSE"],
+  "keywords": ["dsh", "dsh-plugin", "deepseek-harness", "portfolio", "ledger", "assets", "投资", "持仓", "记账"],
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/Nickszy/dsh-wealth.git" },
+  "homepage": "https://github.com/Nickszy/dsh-wealth#readme",
+  "bugs": { "url": "https://github.com/Nickszy/dsh-wealth/issues" },
+  "dsh": {
+    "bundle": { "patch": "./cordis.patch.yml" },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ]
+    }
+  },
+  "engines": { "node": ">=20" }
+}

package/store.mjs

@@ -0,0 +1,298 @@
+// dsh-portfolio — shared data store (used by host plugin index.js and by cli.mjs)
+// Plain JSON file, atomic writes, keeps a .bak of the previous version.
+import { mkdirSync, readFileSync, writeFileSync, renameSync, existsSync, copyFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { randomUUID } from 'node:crypto'
+
+export const DATA_DIR = process.env.DSH_PORTFOLIO_DIR || join(homedir(), '.dsh', 'data', 'dsh-portfolio')
+export const DATA_FILE = join(DATA_DIR, 'ledger.json')
+
+const EMPTY = () => ({
+  version: 1,
+  baseCurrency: 'CNY',
+  fx: { CNY: 1, HKD: 0.92, USD: 7.15 },
+  accounts: [],
+  instruments: [],
+  holdings: [],
+  trades: [],
+  updatedAt: null,
+})
+
+function ensureDir() { mkdirSync(DATA_DIR, { recursive: true }) }
+
+export function load() {
+  ensureDir()
+  if (!existsSync(DATA_FILE)) return EMPTY()
+  try {
+    const db = JSON.parse(readFileSync(DATA_FILE, 'utf8'))
+    return { ...EMPTY(), ...db }
+  } catch (error) {
+    // keep the broken file for inspection, start clean
+    try { copyFileSync(DATA_FILE, DATA_FILE + '.corrupt-' + Date.now()) } catch { /* ignore */ }
+    return EMPTY()
+  }
+}
+
+export function save(db) {
+  ensureDir()
+  db.updatedAt = new Date().toISOString()
+  const tmp = DATA_FILE + '.tmp'
+  writeFileSync(tmp, JSON.stringify(db, null, 2), 'utf8')
+  try { if (existsSync(DATA_FILE)) copyFileSync(DATA_FILE, DATA_FILE + '.bak') } catch { /* ignore */ }
+  renameSync(tmp, DATA_FILE)
+  return db
+}
+
+const uid = (prefix) => prefix + '_' + randomUUID().slice(0, 8).toUpperCase()
+const toNum = (v) => { if (v === null || v === undefined || v === '') return null; const n = Number(v); return Number.isFinite(n) ? n : null }
+const nowISO = () => new Date().toISOString()
+
+function normCurrency(c, fallback) {
+  const v = typeof c === 'string' && c.trim() !== '' ? c.trim().toUpperCase() : fallback
+  return v || 'CNY'
+}
+
+function findAccount(db, id) { return db.accounts.find((a) => a.id === id) }
+function findInstrument(db, id) { return db.instruments.find((i) => i.id === id) }
+function findHolding(db, accountId, instrumentId) {
+  return db.holdings.find((h) => h.accountId === accountId && h.instrumentId === instrumentId)
+}
+
+// Resolve an instrument by id, or by symbol+market (creating it if allowed).
+function resolveInstrument(db, ref, { create = true } = {}) {
+  if (!ref) throw new OpError('bad-request', '缺少标的')
+  if (ref.instrumentId) {
+    const got = findInstrument(db, ref.instrumentId)
+    if (!got) throw new OpError('not-found', '标的不存在: ' + ref.instrumentId)
+    return got
+  }
+  const symbol = String(ref.symbol || '').trim()
+  if (!symbol) throw new OpError('bad-request', '缺少标的代码 symbol')
+  const market = String(ref.market || '').trim().toUpperCase()
+  const existing = db.instruments.find((i) => i.symbol === symbol && (market === '' || i.market === market))
+  if (existing) return existing
+  if (!create) throw new OpError('not-found', '标的不存在: ' + symbol)
+  const instrument = {
+    id: uid('INS'),
+    symbol,
+    name: String(ref.name || symbol).trim(),
+    market: market || 'CN',
+    assetClass: String(ref.assetClass || guessAssetClass(symbol, ref.assetClass)).trim(),
+    currency: normCurrency(ref.currency, defaultCurrencyOfMarket(market)),
+    note: String(ref.note || ''),
+    createdAt: nowISO(),
+  }
+  db.instruments.push(instrument)
+  return instrument
+}
+
+function guessAssetClass(symbol, given) {
+  if (given) return given
+  if (/^\d{6}$/.test(symbol)) return 'stock'
+  if (/^[A-Z]{1,5}$/.test(symbol)) return 'stock'
+  return 'fund'
+}
+function defaultCurrencyOfMarket(market) {
+  if (market === 'HK') return 'HKD'
+  if (market === 'US') return 'USD'
+  return 'CNY'
+}
+
+// Apply a trade to the matching holding (buy = increase qty & weighted avg cost; sell = decrease qty).
+function applyTradeToHolding(db, trade) {
+  let holding = findHolding(db, trade.accountId, trade.instrumentId)
+  const qty = toNum(trade.qty) || 0
+  const price = toNum(trade.price) || 0
+  if (!holding) {
+    holding = {
+      id: uid('POS'), accountId: trade.accountId, instrumentId: trade.instrumentId,
+      qty: 0, avgCost: 0, currency: trade.currency, manualPrice: null, note: '', updatedAt: nowISO(),
+    }
+    db.holdings.push(holding)
+  }
+  if (trade.side === 'buy') {
+    const totalQty = holding.qty + qty
+    if (totalQty > 0) holding.avgCost = ((holding.qty * holding.avgCost) + (qty * price)) / totalQty
+    holding.qty = totalQty
+  } else if (trade.side === 'sell') {
+    holding.qty = Math.max(0, holding.qty - qty)
+    if (holding.qty === 0) holding.avgCost = 0
+  }
+  holding.updatedAt = nowISO()
+  return holding
+}
+
+export class OpError extends Error {
+  constructor(code, message) { super(message); this.code = code }
+}
+
+// Single dispatcher. Each op mutates `db` and returns a plain result object.
+export function applyOp(db, op, payload = {}) {
+  switch (op) {
+    case 'state':
+      return { ledger: db }
+
+    case 'account.upsert': {
+      const p = payload.account || payload
+      if (!p.name) throw new OpError('bad-request', '账户需要 name')
+      let acc = p.id ? findAccount(db, p.id) : null
+      if (acc) {
+        acc.name = String(p.name)
+        acc.type = String(p.type || acc.type || 'broker')
+        acc.currency = normCurrency(p.currency, acc.currency)
+        if (p.note !== undefined) acc.note = String(p.note)
+      } else {
+        acc = { id: uid('ACC'), name: String(p.name), type: String(p.type || 'broker'), currency: normCurrency(p.currency, 'CNY'), note: String(p.note || ''), archived: false, createdAt: nowISO() }
+        db.accounts.push(acc)
+      }
+      return { account: acc }
+    }
+
+    case 'account.remove': {
+      const id = payload.id
+      if (!findAccount(db, id)) throw new OpError('not-found', '账户不存在: ' + id)
+      db.accounts = db.accounts.filter((a) => a.id !== id)
+      db.holdings = db.holdings.filter((h) => h.accountId !== id)
+      db.trades = db.trades.filter((t) => t.accountId !== id)
+      return { removed: id }
+    }
+
+    case 'instrument.upsert': {
+      const p = payload.instrument || payload
+      const instrument = resolveInstrument(db, { ...p, instrumentId: p.id }, { create: true })
+      return { instrument }
+    }
+
+    case 'holding.upsert': {
+      const p = payload.holding || payload
+      if (!p.accountId) throw new OpError('bad-request', '缺少 accountId')
+      if (!findAccount(db, p.accountId)) throw new OpError('not-found', '账户不存在: ' + p.accountId)
+      const instrument = resolveInstrument(db, p, { create: true })
+      let holding = p.id ? db.holdings.find((h) => h.id === p.id) : findHolding(db, p.accountId, instrument.id)
+      if (holding) {
+        if (p.qty !== undefined) holding.qty = toNum(p.qty) || 0
+        if (p.avgCost !== undefined) holding.avgCost = toNum(p.avgCost) || 0
+        if (p.manualPrice !== undefined) holding.manualPrice = toNum(p.manualPrice)
+        if (p.currency !== undefined) holding.currency = normCurrency(p.currency, holding.currency)
+        if (p.note !== undefined) holding.note = String(p.note)
+        holding.updatedAt = nowISO()
+      } else {
+        holding = {
+          id: uid('POS'), accountId: p.accountId, instrumentId: instrument.id,
+          qty: toNum(p.qty) || 0, avgCost: toNum(p.avgCost) || 0,
+          currency: normCurrency(p.currency, instrument.currency),
+          manualPrice: toNum(p.manualPrice), note: String(p.note || ''), updatedAt: nowISO(),
+        }
+        db.holdings.push(holding)
+      }
+      return { holding }
+    }
+
+    case 'holding.remove': {
+      const id = payload.id
+      if (!db.holdings.some((h) => h.id === id)) throw new OpError('not-found', '持仓不存在: ' + id)
+      db.holdings = db.holdings.filter((h) => h.id !== id)
+      return { removed: id }
+    }
+
+    case 'trade.add': {
+      const p = payload.trade || payload
+      if (!p.accountId) throw new OpError('bad-request', '缺少 accountId')
+      if (!findAccount(db, p.accountId)) throw new OpError('not-found', '账户不存在: ' + p.accountId)
+      const instrument = resolveInstrument(db, p, { create: true })
+      const side = (p.side === 'sell' ? 'sell' : 'buy')
+      const trade = {
+        id: uid('TRD'), accountId: p.accountId, instrumentId: instrument.id, side,
+        qty: toNum(p.qty) || 0, price: toNum(p.price) || 0, fee: toNum(p.fee) || 0,
+        currency: normCurrency(p.currency, instrument.currency),
+        date: String(p.date || new Date().toISOString().slice(0, 10)),
+        note: String(p.note || ''), createdAt: nowISO(),
+      }
+      db.trades.push(trade)
+      const holding = applyTradeToHolding(db, trade)
+      return { trade, holding }
+    }
+
+    case 'trade.remove': {
+      const id = payload.id
+      if (!db.trades.some((t) => t.id === id)) throw new OpError('not-found', '流水不存在: ' + id)
+      db.trades = db.trades.filter((t) => t.id !== id)
+      return { removed: id, note: '已删除流水；持仓数量未自动回算，请手动核对' }
+    }
+
+    case 'price.set': {
+      const p = payload
+      if (p.holdingId) {
+        const h = db.holdings.find((x) => x.id === p.holdingId)
+        if (!h) throw new OpError('not-found', '持仓不存在: ' + p.holdingId)
+        h.manualPrice = toNum(p.price); h.updatedAt = nowISO()
+        return { holding: h }
+      }
+      if (p.instrumentId) {
+        let n = 0
+        for (const h of db.holdings) if (h.instrumentId === p.instrumentId) { h.manualPrice = toNum(p.price); h.updatedAt = nowISO(); n++ }
+        if (n === 0) throw new OpError('not-found', '该标的没有持仓')
+        return { updated: n }
+      }
+      throw new OpError('bad-request', 'price.set 需要 holdingId 或 instrumentId')
+    }
+
+    case 'fx.set': {
+      const cur = normCurrency(payload.currency, null)
+      if (!cur) throw new OpError('bad-request', '缺少 currency')
+      const rate = toNum(payload.rate)
+      if (rate === null || rate <= 0) throw new OpError('bad-request', 'rate 必须是正数（1 单位该币种 = ? 本位币）')
+      db.fx[cur] = rate
+      return { fx: db.fx }
+    }
+
+    case 'base.set': {
+      const cur = normCurrency(payload.currency, null)
+      if (!cur) throw new OpError('bad-request', '缺少 currency')
+      db.baseCurrency = cur
+      return { baseCurrency: cur }
+    }
+
+    case 'import.holdings': {
+      const rows = Array.isArray(payload.rows) ? payload.rows : []
+      const out = []
+      for (const row of rows) out.push(applyOp(db, 'holding.upsert', { holding: row }).holding)
+      return { imported: out.length, holdings: out }
+    }
+
+    case 'import.trades': {
+      const rows = Array.isArray(payload.rows) ? payload.rows : []
+      const out = []
+      for (const row of rows) out.push(applyOp(db, 'trade.add', { trade: row }).trade)
+      return { imported: out.length, trades: out }
+    }
+
+    default:
+      throw new OpError('bad-request', '未知操作 op: ' + op)
+  }
+}
+
+// Valuation helper shared by CLI: convert every holding to base currency.
+export function summarize(db) {
+  const base = db.baseCurrency || 'CNY'
+  const fx = { ...db.fx, [base]: 1 }
+  const byAccount = new Map()
+  let totalBase = 0
+  for (const h of db.holdings) {
+    const ins = db.instruments.find((i) => i.id === h.instrumentId)
+    if (!ins) continue
+    const price = (h.manualPrice ?? h.avgCost ?? 0)
+    const cur = h.currency || ins.currency || base
+    const rate = fx[cur] ?? 1
+    const valueBase = h.qty * price * rate
+    const costBase = h.qty * (h.avgCost || 0) * rate
+    totalBase += valueBase
+    if (!byAccount.has(h.accountId)) byAccount.set(h.accountId, { accountId: h.accountId, valueBase: 0, costBase: 0, holdings: 0 })
+    const agg = byAccount.get(h.accountId)
+    agg.valueBase += valueBase; agg.costBase += costBase; agg.holdings += 1
+  }
+  const round = (n) => Math.round(n * 100) / 100
+  const accounts = [...byAccount.values()].map((a) => ({ ...a, valueBase: round(a.valueBase), costBase: round(a.costBase), pnlBase: round(a.valueBase - a.costBase) }))
+  return { baseCurrency: base, fx, totalValueBase: round(totalBase), totalCostBase: round(accounts.reduce((s, a) => s + a.costBase, 0)), totalPnlBase: round(accounts.reduce((s, a) => s + a.pnlBase, 0)), accounts }
+}