@cxxgo/fund-valuation-query 1.0.4

package/README.md

@@ -0,0 +1,88 @@
+# fund-valuation-query
+
+基金实时估值查询 CLI 工具。根据基金持仓股票的实时行情，估算基金当日的涨跌幅。
+
+## 原理
+
+1. 从东方财富获取基金的十大持仓数据（股票代码、名称、持仓占比）
+2. 从腾讯行情 API 获取持仓股票的实时涨跌幅
+3. 用持仓占比加权计算基金的预估涨跌幅
+
+## 安装
+
+```bash
+npm i @cxxgo/fund-valuation-query -g
+```
+
+## 使用
+
+### 列出所有基金估值
+
+```bash
+fund list
+```
+
+按预估涨幅降序展示。
+
+### 查看单只基金持仓详情
+
+```bash
+fund detail <基金代码>
+```
+
+展示该基金的十大持仓股票及各自涨跌幅、对基金的贡献。
+
+### Web 服务
+
+```bash
+# 启动 Web 服务，默认端口 8888
+fund serve
+
+# 指定端口
+fund serve -p 8080
+
+# 或通过环境变量
+PORT=8080 fund serve
+```
+
+启动后访问 `http://localhost:8888` 即可使用可视化界面，功能包括：
+
+- 首次访问需选择配置文件（上传 JSON 文件或粘贴内容），配置保存在浏览器 localStorage
+- 点击表头按基金代码、名称、预估涨幅排序
+- 点击基金名称，右侧抽屉展开持仓明细
+- 抽屉内支持按占比、涨跌排序
+- 手动刷新按钮 + 30 秒自动刷新
+- 切换配置按钮可重新选择配置文件
+
+### 配置文件
+
+```bash
+# 设置配置文件路径
+fund config /path/to/fund.config.json
+
+# 查看当前配置文件路径
+fund config
+```
+
+配置文件为 JSON 格式，key 为基金代码，value 为基金名称：
+
+```json
+{
+  "000001": "示例基金A",
+  "000002": "示例基金B"
+}
+```
+
+配置文件路径保存在 `~/.fundrc.json` 中。
+
+## 技术栈
+
+- **数据源**：东方财富（持仓）、腾讯行情（实时股价）
+- **CLI**：Commander.js + cli-table3 + chalk
+- **Web**：Express 内嵌 HTML/JS/CSS
+- **HTML 解析**：cheerio
+- **HTTP**：axios
+
+## License
+
+ISC

package/dist/fund.js

@@ -0,0 +1,545 @@
+#!/usr/bin/env node
+import{Command as ct}from"commander";import{readFileSync as k,writeFileSync as V,existsSync as D}from"fs";import{homedir as W}from"os";import{join as X,resolve as Z}from"path";var v=X(W(),".fundrc.json");function S(){return D(v)&&JSON.parse(k(v,"utf-8")).configPath||null}function j(t){let e=Z(t);D(e)||(console.error(`\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728: ${e}`),process.exit(1));try{let n=JSON.parse(k(e,"utf-8"));(!n||typeof n!="object"||Object.keys(n).length===0)&&(console.error("\u914D\u7F6E\u6587\u4EF6\u4E3A\u7A7A\u6216\u683C\u5F0F\u9519\u8BEF"),process.exit(1))}catch{console.error("\u914D\u7F6E\u6587\u4EF6\u683C\u5F0F\u9519\u8BEF\uFF0C\u9700\u8981\u5408\u6CD5\u7684 JSON"),process.exit(1)}V(v,JSON.stringify({configPath:e},null,2)),console.log(`\u5DF2\u8BBE\u7F6E\u914D\u7F6E\u6587\u4EF6: ${e}`)}function N(){let t=S();return t||(console.error("\u672A\u8BBE\u7F6E\u914D\u7F6E\u6587\u4EF6\uFF0C\u8BF7\u8FD0\u884C: fund config <\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84>"),process.exit(1)),D(t)||(console.error(`\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728: ${t}\uFF0C\u8BF7\u91CD\u65B0\u8BBE\u7F6E: fund config <\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84>`),process.exit(1)),JSON.parse(k(t,"utf-8"))}import b from"axios";import*as I from"cheerio";function B(t){let e=I.load(t),n=[];return e("table").first().find("tbody tr, tr").each((o,r)=>{let c=e(r).find("td");if(c.length<7)return;let s=c.eq(1).find("a"),d=s.text().trim();if(!d)return;let i=(s.attr("href")||"").match(/\/r\/(\d+)\.(\w+)/),u=i?parseInt(i[1]):d.startsWith("6")?1:0,l=u>=100,g=c.eq(2).find("a").text().trim()||c.eq(2).text().trim(),h=c.eq(6).text().trim().replace("%",""),O=parseFloat(h);isNaN(O)||n.push({stockCode:d,stockName:g,holdingRatio:O,market:u,isOverseas:l})}),n}var tt={"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",Referer:"https://fund.eastmoney.com/"};async function z(t){let e=`https://fundf10.eastmoney.com/FundArchivesDatas.aspx?type=jjcc&code=${t}&topline=50`,{data:n}=await b.get(e,{responseType:"text",headers:tt}),a=n.match(/content:"([\s\S]*?)",arryear:/);return a?B(a[1]):[]}async function T(t){try{let e=`http://fundgz.1234567.com.cn/js/${t}.js`,{data:n}=await b.get(e,{responseType:"text"}),a=n.match(/jsonpgz\((.+)\)/);if(!a)return null;let o=JSON.parse(a[1]);return!o.gszzl||!o.gztime?null:{change:parseFloat(o.gszzl),time:o.gztime}}catch{return null}}async function R(t){let e=new Map;return t.length===0||await Promise.all(t.map(async({code:n,market:a})=>{try{let o=`https://push2.eastmoney.com/api/qt/stock/get?secid=${a}.${n}&fields=f170`,{data:r}=await b.get(o,{timeout:5e3});r.data&&r.data.f170!==void 0&&e.set(n,{changePercent:r.data.f170/100})}catch{}})),e}function $(t){return[t.getFullYear(),String(t.getMonth()+1).padStart(2,"0"),String(t.getDate()).padStart(2,"0")].join("")}async function P(t){let e=new Map;if(t.length===0)return e;let n=new Date,a=new Date(n);return a.setDate(a.getDate()-14),await Promise.all(t.map(async({code:o,market:r})=>{try{let c=`https://push2his.eastmoney.com/api/qt/stock/kline/get?secid=${r}.${o}&fields1=f1,f2,f3,f4,f5,f6&fields2=f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61&klt=101&fqt=1&beg=${$(a)}&end=${$(n)}`,{data:s}=await b.get(c,{timeout:5e3}),d=s?.data?.klines;if(!Array.isArray(d)||d.length===0){e.set(o,{latestDate:null,changesByDate:new Map});return}let f=new Map;for(let u of d){let l=u.split(",");if(l.length<9)continue;let g=l[0],h=parseFloat(l[8]);!g||Number.isNaN(h)||f.set(g,h)}let i=d[d.length-1]?.split(",")[0]||null;e.set(o,{latestDate:i,changesByDate:f})}catch{e.set(o,{latestDate:null,changesByDate:new Map})}})),e}async function K(t){let e=new Map;if(t.length===0)return e;let n=t.map(({code:a,market:o})=>o===1?`s_sh${a}`:`s_sz${a}`);try{let a=`https://qt.gtimg.cn/q=${n.join(",")}`,{data:o}=await b.get(a,{responseType:"arraybuffer"}),c=new TextDecoder("gbk").decode(o).trim().split(`
+`);for(let s of c){let d=s.match(/^v_[^=]+="(.+)";?$/);if(!d)continue;let f=d[1].split("~");if(f.length<6)continue;let i=f[2],u=f[1],l=parseFloat(f[5]);i&&e.set(i,{name:u,changePercent:l})}}catch{}return e}function H(t,e){return e.some(a=>a.isOverseas)||/全球|QDII|美元|港|海外|纳斯达克|标普|道琼斯/.test(t)?"\u5168\u7403":/ETF|指数/.test(t)?"\u6307\u6570":/债/.test(t)?"\u504F\u503A":"\u504F\u80A1"}function et(){let t=new Date;return[t.getFullYear(),String(t.getMonth()+1).padStart(2,"0"),String(t.getDate()).padStart(2,"0")].join("-")}function p(t){return!t||t.length<10?"":t.slice(5)}function x(t){return typeof t=="number"&&!Number.isNaN(t)}function F(t){let e=new Date(t.replace(" ","T"));return e.setDate(e.getDate()-1),p([e.getFullYear(),String(e.getMonth()+1).padStart(2,"0"),String(e.getDate()).padStart(2,"0")].join("-"))}function q(t){return t.map(e=>({code:e.stockCode,market:e.market}))}function A(t,e,n,a){let o=et(),r=[];for(let i of t){let u=a.get(i.stockCode);if(u)for(let l of u.changesByDate.keys())l<o&&r.push(l)}r.sort();let c=r[r.length-1]||null,s=t.map(i=>{let u=a.get(i.stockCode),l=c&&u?u.changesByDate.get(c)??null:null,g=i.isOverseas?u?.latestDate===o?n.get(i.stockCode)?.changePercent??null:null:e.get(i.stockCode)?.changePercent??null;return{stockCode:i.stockCode,stockName:i.stockName,holdingRatio:i.holdingRatio,todayChange:g,yesterdayChange:l,stockChange:l,contribution:x(l)?i.holdingRatio*l/100:0,isOverseas:i.isOverseas}});return{estimatedChange:s.filter(i=>x(i.yesterdayChange)).length>0?s.reduce((i,u)=>i+u.contribution,0):null,contributions:s,todayDate:o,yesterdayDate:c}}function J(t,e){let n=0,a=0,o=[];for(let r of t){let c=e.get(r.stockCode),s=c?c.changePercent:null,d=x(s)?r.holdingRatio*s/100:0;x(s)&&(n+=d,a+=1),o.push({stockCode:r.stockCode,stockName:r.stockName,holdingRatio:r.holdingRatio,stockChange:s,contribution:d})}return{estimatedChange:a>0?n:null,contributions:o}}async function M(t){let e=new Map;return await Promise.all(Object.keys(t).map(async n=>{try{e.set(n,await z(n))}catch{e.set(n,[])}})),e}function nt(t){let e=new Map;for(let[,n]of t)for(let a of n)!a.isOverseas&&!e.has(a.stockCode)&&e.set(a.stockCode,{code:a.stockCode,market:a.market});return[...e.values()]}async function L(t){return K(nt(t))}async function E(t,e,n,a){let{estimatedChange:o,contributions:r}=J(n,a),c=H(e,n);if(c==="\u5168\u7403"){let d=await T(t),f=n.filter(h=>h.isOverseas).map(h=>({code:h.stockCode,market:h.market})),[i,u]=await Promise.all([R(f),P(q(n))]),l=A(n,a,i,u),g=d?F(d.time):p(l.yesterdayDate);return{code:t,name:e,estimatedChange:d?d.change:l.estimatedChange,contributions:l.contributions,category:c,canDetail:n.length>0,detailMode:"global",todayLabel:p(l.todayDate),yesterdayLabel:p(l.yesterdayDate),estimateDateLabel:g,estimateLabel:g?` (${g})`:"",estimateSource:d?"fund-estimate":"holdings-yesterday"}}let s=await T(t);if(s!==null){let d=new Date(s.time.replace(" ","T")),i=Date.now()-d>7200*1e3?F(s.time):"";return{code:t,name:e,estimatedChange:s.change,contributions:r,category:c,canDetail:n.length>0,estimateLabel:i?` (${i})`:"",estimateDateLabel:i}}return{code:t,name:e,estimatedChange:o,contributions:r,category:c,canDetail:n.length>0}}async function C(t){let e=await M(t),n=await L(e);return Promise.all(Object.entries(t).map(([a,o])=>E(a,o,e.get(a)||[],n)))}import w from"chalk";import U from"cli-table3";function y(t){if(t==null||Number.isNaN(t))return"-";let e=parseFloat(t);return e>0?w.red(`+${e.toFixed(2)}%`):e<0?w.green(`${e.toFixed(2)}%`):`${e.toFixed(2)}%`}function Q(t){let{code:e,name:n,estimatedChange:a,contributions:o}=t,r=new U({head:t.detailMode==="global"?["\u6301\u4ED3","\u5360\u6BD4",`\u4ECA\u65E5
+${t.todayLabel||""}`,`\u6628\u65E5
+${t.yesterdayLabel||""}`]:["\u6301\u4ED3","\u5360\u6BD4","\u6DA8\u8DCC"],style:{head:["cyan"]}});for(let s of o){if(t.detailMode==="global"){r.push([`${s.stockCode} ${s.stockName}`,`${s.holdingRatio.toFixed(2)}%`,s.todayChange===null||s.todayChange===void 0?"-":y(s.todayChange),s.yesterdayChange===null||s.yesterdayChange===void 0?"-":y(s.yesterdayChange)]);continue}r.push([`${s.stockCode} ${s.stockName}`,`${s.holdingRatio.toFixed(2)}%`,y(s.stockChange)])}console.log(`
+${w.bold(e)} ${w.bold(n)}`),console.log(r.toString());let c=y(a);console.log(`\u9884\u4F30\u6DA8\u5E45: ${c}${t.estimateLabel||""}
+`)}function _(t){let e=new U({head:["\u57FA\u91D1\u4EE3\u7801","\u57FA\u91D1\u540D\u79F0","\u9884\u4F30\u6DA8\u5E45"],style:{head:["cyan"]}});for(let n of t)e.push([n.code,n.name,y(n.estimatedChange)+(n.estimateLabel||"")]);console.log(e.toString())}import G from"express";async function at(t){return C(t)}function ot(){return`
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { background: #f5f0eb; color: #4a4a4a; font-family: -apple-system, "Microsoft YaHei", sans-serif; padding: 24px; }
+  h1 { text-align: center; margin-bottom: 8px; font-size: 24px; color: #5a5a5a; }
+  .update-time { text-align: center; color: #b0a8a0; margin-bottom: 24px; font-size: 13px; }
+  table { border-collapse: collapse; width: 100%; max-width: 700px; margin: 0 auto 16px; }
+  th, td { padding: 10px 14px; text-align: center; border-bottom: 1px solid #e8e0d8; }
+  th { background: #ede6df; color: #8a7e74; font-weight: 600; }
+  tr:hover { background: #efe8e1; }
+  .up { color: #d4756b; }
+  .down { color: #6b9e78; }
+  .flat { color: #a09890; }
+  .estimate-label { display: block; font-size: 11px; color: #b0a8a0; margin-top: 2px; }
+  .fund-name { cursor: pointer; color: #6a9ec5; }
+  .fund-name:hover { text-decoration: underline; }
+  .fund-name.disabled { cursor: default; color: #4a4a4a; }
+  .fund-name.disabled:hover { text-decoration: none; }
+  .drawer-overlay {
+    display: none; position: fixed; top: 0; left: 0; width: 100%; height: 100%;
+    background: rgba(0,0,0,0.15); z-index: 999;
+  }
+  .drawer-overlay.open { display: block; animation: fadeIn 0.2s ease; }
+  .drawer {
+    position: fixed; top: 0; right: -460px; width: 460px; height: 100%;
+    background: #faf7f4; z-index: 1000;
+    box-shadow: -2px 0 16px rgba(0,0,0,0.08);
+    transition: right 0.25s ease;
+    overflow-y: auto; padding: 32px 24px;
+  }
+  .drawer.open { right: 0; }
+  .drawer-close {
+    position: absolute; top: 16px; right: 18px; font-size: 20px;
+    color: #b0a8a0; cursor: pointer; border: none; background: none;
+    line-height: 1;
+  }
+  .drawer-close:hover { color: #8a7e74; }
+  .config-close {
+    position: absolute; top: 12px; right: 14px; font-size: 20px;
+    color: #b0a8a0; cursor: pointer; border: none; background: none;
+    line-height: 1;
+  }
+  .config-close:hover { color: #8a7e74; }
+  .drawer-title { color: #6a5e54; font-size: 16px; font-weight: 600; margin-bottom: 6px; }
+  .drawer-subtitle { color: #b0a8a0; font-size: 13px; margin-bottom: 20px; }
+  .drawer table { max-width: 100%; }
+  .drawer th { background: #f0ebe5; color: #8a7e74; font-size: 13px; padding: 8px 10px; min-width: 80px; }
+  .drawer td { font-size: 13px; padding: 8px 10px; border-bottom: 1px solid #ece4dc; }
+  .refresh-btn {
+    display: inline-block; margin-left: 8px; padding: 3px 12px;
+    font-size: 13px; color: #8a7e74; background: #ede6df; border: none;
+    border-radius: 12px; cursor: pointer; vertical-align: middle;
+  }
+  .refresh-btn:hover { background: #e0d6cc; color: #6a5e54; }
+  .refresh-btn.spinning svg { animation: spin 0.6s linear infinite; }
+  @keyframes spin { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
+  th.sortable { cursor: pointer; user-select: none; vertical-align: middle; }
+  th.sortable:hover { color: #5a5a5a; }
+  th.sortable::after { content: ' \u21C5'; font-size: 11px; opacity: 0.4; }
+  th.sortable.asc::after { content: ' \u2191'; opacity: 1; }
+  th.sortable.desc::after { content: ' \u2193'; opacity: 1; }
+  .config-overlay {
+    display: flex; position: fixed; top: 0; left: 0; width: 100%; height: 100%;
+    background: rgba(0,0,0,0.15); z-index: 2000;
+    justify-content: center; align-items: center;
+  }
+  .config-overlay.hidden { display: none; }
+  .config-card {
+    background: #faf7f4; border-radius: 12px; padding: 32px 28px;
+    box-shadow: 0 4px 24px rgba(0,0,0,0.1); width: 400px; max-width: 90vw;
+    text-align: center; position: relative;
+  }
+  .config-card h2 { color: #6a5e54; font-size: 18px; margin-bottom: 8px; }
+  .config-card p { color: #b0a8a0; font-size: 13px; margin-bottom: 20px; }
+  .config-card textarea {
+    width: 100%; height: 120px; border: 1px solid #d8d0c8; border-radius: 8px;
+    padding: 10px; font-size: 13px; resize: vertical; margin-bottom: 12px;
+    font-family: monospace; background: #fff;
+  }
+  .config-card textarea:focus { outline: none; border-color: #6a9ec5; }
+  .file-btn {
+    display: inline-block; padding: 8px 20px; background: #ede6df; color: #6a5e54;
+    border: none; border-radius: 8px; cursor: pointer; font-size: 13px; margin-bottom: 12px;
+  }
+  .file-btn:hover { background: #e0d6cc; }
+  .config-card input[type="file"] { display: none; }
+  .config-card .confirm-btn {
+    display: inline-block; padding: 8px 28px; background: #6a9ec5; color: #fff;
+    border: none; border-radius: 8px; cursor: pointer; font-size: 14px; margin-top: 4px;
+  }
+  .config-card .confirm-btn:hover { background: #5a8eb5; }
+  .config-card .confirm-btn:disabled { background: #ccc; cursor: not-allowed; }
+  .config-card .error-msg { color: #d4756b; font-size: 12px; margin-top: 8px; min-height: 18px; }
+  .config-hint { color: #b0a8a0; font-size: 11px; margin-bottom: 16px; }
+  .change-config-btn {
+    display: inline-block; margin-left: 8px; padding: 2px 8px;
+    font-size: 11px; color: #8a7e74; background: #ede6df; border: none;
+    border-radius: 8px; cursor: pointer;
+  }
+  .change-config-btn:hover { background: #e0d6cc; }
+  .filter-tabs { display: flex; gap: 6px; justify-content: center; max-width: 700px; margin: 8px auto 12px; }
+  .filter-tab {
+    padding: 3px 14px; border: 1px solid #d8d0c8; border-radius: 20px;
+    background: #f5f0eb; color: #8a7e74; cursor: pointer; font-size: 12px;
+    line-height: 1.4;
+  }
+  .filter-tab:hover { background: #ede6df; }
+  .filter-tab.active { background: #6a9ec5; color: #fff; border-color: #6a9ec5; }
+`}function rt(){return`
+<h1>\u57FA\u91D1\u4F30\u503C\u67E5\u8BE2</h1>
+<div class="update-time" id="updateTime"><span id="timeText"></span><button class="refresh-btn" id="refreshBtn"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M23 4v6h-6"/><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"/></svg></button></div>
+<div class="filter-tabs" id="filterTabs">
+  <button class="filter-tab active" data-cat="" data-label="\u5168\u90E8">\u5168\u90E8 0</button>
+  <button class="filter-tab" data-cat="\u504F\u80A1" data-label="\u504F\u80A1">\u504F\u80A1 0</button>
+  <button class="filter-tab" data-cat="\u504F\u503A" data-label="\u504F\u503A">\u504F\u503A 0</button>
+  <button class="filter-tab" data-cat="\u6307\u6570" data-label="\u6307\u6570">\u6307\u6570 0</button>
+  <button class="filter-tab" data-cat="\u5168\u7403" data-label="\u5168\u7403">\u5168\u7403 0</button>
+</div>
+<table id="mainTable">
+  <thead><tr><th class="sortable" data-key="code">\u57FA\u91D1\u4EE3\u7801</th><th class="sortable" data-key="name">\u57FA\u91D1\u540D\u79F0</th><th class="sortable desc" data-key="estimatedChange">\u9884\u4F30\u6DA8\u5E45</th></tr></thead>
+  <tbody></tbody>
+</table>
+<div class="drawer-overlay" id="drawerOverlay"></div>
+<div class="drawer" id="drawer">
+  <button class="drawer-close" id="drawerClose">&times;</button>
+  <div id="drawerContent"></div>
+</div>
+
+<div class="config-overlay" id="configOverlay">
+  <div class="config-card">
+    <button class="config-close" id="configClose">&times;</button>
+    <h2>\u9009\u62E9\u914D\u7F6E\u6587\u4EF6</h2>
+    <p>\u8BF7\u4E0A\u4F20\u6216\u7C98\u8D34\u57FA\u91D1\u914D\u7F6E JSON \u6587\u4EF6</p>
+    <label class="file-btn">
+      \u9009\u62E9\u6587\u4EF6
+      <input type="file" id="fileInput" accept=".json">
+    </label>
+    <div class="config-hint">\u6216\u76F4\u63A5\u7C98\u8D34 JSON \u5185\u5BB9\uFF1A</div>
+    <textarea id="configText" placeholder='{"000001":"\u793A\u4F8B\u57FA\u91D1"}'></textarea>
+    <button class="confirm-btn" id="confirmBtn">\u786E\u8BA4</button>
+    <div class="error-msg" id="errorMsg"></div>
+  </div>
+</div>
+`}function st(){return`
+function formatDateLabel(timeStr) {
+  // "2026-05-08 04:00" -> "05-07"\uFF08\u53D6\u524D\u4E00\u5929\u65E5\u671F\uFF09
+  const d = new Date(timeStr.replace(' ', 'T'));
+  d.setDate(d.getDate() - 1);
+  return (d.getMonth() + 1).toString().padStart(2, '0') + '-' + d.getDate().toString().padStart(2, '0');
+}
+
+const state = {
+  sortKey: 'estimatedChange',
+  sortDir: 'desc',
+  currentData: [],
+  activeCategory: '',
+  drawerSortKey: '',
+  drawerSortDir: 'desc',
+  drawerFund: null,
+  fundMap: {},
+};
+
+const dom = {
+  filterTabs: document.getElementById('filterTabs'),
+  filterTabItems: () => document.querySelectorAll('.filter-tab'),
+  mainTable: document.getElementById('mainTable'),
+  mainTableHead: document.getElementById('mainTable').querySelector('thead'),
+  mainTableBody: document.querySelector('#mainTable tbody'),
+  timeText: document.getElementById('timeText'),
+  drawer: document.getElementById('drawer'),
+  drawerOverlay: document.getElementById('drawerOverlay'),
+  drawerClose: document.getElementById('drawerClose'),
+  drawerContent: document.getElementById('drawerContent'),
+  configOverlay: document.getElementById('configOverlay'),
+  configClose: document.getElementById('configClose'),
+  fileInput: document.getElementById('fileInput'),
+  configText: document.getElementById('configText'),
+  confirmBtn: document.getElementById('confirmBtn'),
+  errorMsg: document.getElementById('errorMsg'),
+  refreshBtn: document.getElementById('refreshBtn'),
+  updateTime: document.getElementById('updateTime'),
+};
+
+function renderFilteredTable() {
+  const filtered = getFilteredFunds();
+  sortData();
+  renderFilterCounts();
+  renderTable(filtered);
+}
+
+function renderFilterCounts() {
+  const counts = state.currentData.reduce((acc, fund) => {
+    acc[fund.category] = (acc[fund.category] || 0) + 1;
+    return acc;
+  }, { \u5168\u90E8: state.currentData.length });
+
+  dom.filterTabItems().forEach(tab => {
+    const cat = tab.dataset.cat;
+    const label = tab.dataset.label;
+    const count = cat ? (counts[cat] || 0) : counts['\u5168\u90E8'];
+    tab.textContent = label + ' ' + count;
+  });
+}
+
+function colorClass(val) {
+  if (val === null || val === undefined || Number.isNaN(val)) return 'flat';
+  return val > 0 ? 'up' : val < 0 ? 'down' : 'flat';
+}
+function fmtPercent(val) {
+  if (val === null || val === undefined || Number.isNaN(val)) return '-';
+  const sign = val > 0 ? '+' : '';
+  return sign + val.toFixed(2) + '%';
+}
+
+function fmtNullablePercent(val) {
+  if (val === null || val === undefined || Number.isNaN(val)) return '-';
+  return fmtPercent(val);
+}
+
+function hasDisplayableContributions(fund) {
+  if (!Array.isArray(fund.contributions) || fund.contributions.length === 0) {
+    return false;
+  }
+
+  return fund.detailMode !== 'global' || fund.contributions.some(c =>
+    (c.todayChange !== null && c.todayChange !== undefined) ||
+    (c.yesterdayChange !== null && c.yesterdayChange !== undefined)
+  );
+}
+
+function getEstimateLabelText(fund) {
+  if (fund.estimateDateLabel) return fund.estimateDateLabel;
+  if (fund.estimateLabel) return formatDateLabel(fund.estimateLabel);
+  return '';
+}
+
+function getFilteredFunds() {
+  return state.activeCategory
+    ? state.currentData.filter(f => f.category === state.activeCategory)
+    : state.currentData;
+}
+
+function sortData() {
+  state.currentData.sort((a, b) => {
+    let va = a[state.sortKey], vb = b[state.sortKey];
+    if (typeof va === 'string') {
+      va = va.localeCompare ? va : '';
+      vb = vb.localeCompare ? vb : '';
+      return state.sortDir === 'asc' ? va.localeCompare(vb) : vb.localeCompare(va);
+    }
+    if (va === null || va === undefined || Number.isNaN(va)) return 1;
+    if (vb === null || vb === undefined || Number.isNaN(vb)) return -1;
+    return state.sortDir === 'asc' ? va - vb : vb - va;
+  });
+}
+
+function buildFundNameCell(fund) {
+  const canDetail = fund.canDetail && hasDisplayableContributions(fund);
+  const nameClass = canDetail ? 'fund-name' : 'fund-name disabled';
+  const nameAttr = canDetail ? ' data-code="' + fund.code + '"' : '';
+  return '<td class="' + nameClass + '"' + nameAttr + '>' + fund.name + '</td>';
+}
+
+function buildEstimateCell(fund) {
+  const estimateLabelText = getEstimateLabelText(fund);
+  return '<td class="' + colorClass(fund.estimatedChange) + '">' +
+    fmtPercent(fund.estimatedChange) +
+    (estimateLabelText ? '<span class="estimate-label">' + estimateLabelText + '</span>' : '') +
+    '</td>';
+}
+
+function renderTable(data) {
+  dom.mainTableBody.innerHTML = data.map(fund =>
+    '<tr><td>' + fund.code + '</td>' +
+    buildFundNameCell(fund) +
+    buildEstimateCell(fund) +
+    '</tr>'
+  ).join('');
+  dom.timeText.textContent = '\u66F4\u65B0\u65F6\u95F4: ' + new Date().toLocaleString('zh-CN');
+}
+
+function showDrawer(fund) {
+  state.drawerFund = fund;
+  state.drawerSortKey = '';
+  state.drawerSortDir = 'desc';
+  renderDrawer();
+  dom.drawer.classList.add('open');
+  dom.drawerOverlay.classList.add('open');
+}
+
+function getSortedDrawerContributions(fund) {
+  const sorted = [...fund.contributions];
+  if (state.drawerSortKey) {
+    sorted.sort((a, b) => {
+      if (state.drawerSortKey === 'holdingRatio') return state.drawerSortDir === 'asc' ? a.holdingRatio - b.holdingRatio : b.holdingRatio - a.holdingRatio;
+      if (state.drawerSortKey === 'todayChange') return compareNullableNumbers(a.todayChange, b.todayChange, state.drawerSortDir);
+      if (state.drawerSortKey === 'stockChange') return compareNullableNumbers(a.stockChange, b.stockChange, state.drawerSortDir);
+      return 0;
+    });
+  }
+  return sorted;
+}
+
+function compareNullableNumbers(a, b, dir) {
+  const aMissing = a === null || a === undefined || Number.isNaN(a);
+  const bMissing = b === null || b === undefined || Number.isNaN(b);
+  if (aMissing && bMissing) return 0;
+  if (aMissing) return 1;
+  if (bMissing) return -1;
+  return dir === 'asc' ? a - b : b - a;
+}
+
+function buildGlobalDrawerTable(fund, sorted) {
+  let html = '<table><thead><tr>' +
+    '<th>\u6301\u4ED3</th>' +
+    '<th class="sortable' + (state.drawerSortKey === 'holdingRatio' ? ' ' + state.drawerSortDir : '') + '" data-dkey="holdingRatio">\u5360\u6BD4</th>' +
+    '<th class="sortable' + (state.drawerSortKey === 'todayChange' ? ' ' + state.drawerSortDir : '') + '" data-dkey="todayChange">\u4ECA\u65E5<br>' + (fund.todayLabel || '') + '</th>' +
+    '<th class="sortable' + (state.drawerSortKey === 'stockChange' ? ' ' + state.drawerSortDir : '') + '" data-dkey="stockChange">\u6628\u65E5<br>' + (fund.yesterdayLabel || '') + '</th>' +
+    '</tr></thead><tbody>';
+  for (const c of sorted) {
+    html += '<tr><td>' + c.stockCode + ' ' + c.stockName + '</td>' +
+      '<td>' + c.holdingRatio.toFixed(2) + '%</td>' +
+      '<td class="' + colorClass(c.todayChange ?? 0) + '">' + fmtNullablePercent(c.todayChange) + '</td>' +
+      '<td class="' + colorClass(c.yesterdayChange ?? 0) + '">' + fmtNullablePercent(c.yesterdayChange) + '</td></tr>';
+  }
+  return html + '</tbody></table>';
+}
+
+function buildDefaultDrawerTable(sorted) {
+  let html = '<table><thead><tr>' +
+    '<th>\u6301\u4ED3</th>' +
+    '<th class="sortable' + (state.drawerSortKey === 'holdingRatio' ? ' ' + state.drawerSortDir : '') + '" data-dkey="holdingRatio">\u5360\u6BD4</th>' +
+    '<th class="sortable' + (state.drawerSortKey === 'stockChange' ? ' ' + state.drawerSortDir : '') + '" data-dkey="stockChange">\u6DA8\u8DCC</th>' +
+    '</tr></thead><tbody>';
+  for (const c of sorted) {
+    html += '<tr><td>' + c.stockCode + ' ' + c.stockName + '</td>' +
+      '<td>' + c.holdingRatio.toFixed(2) + '%</td>' +
+      '<td class="' + colorClass(c.stockChange) + '">' + fmtPercent(c.stockChange) + '</td></tr>';
+  }
+  return html + '</tbody></table>';
+}
+
+function renderDrawer() {
+  const fund = state.drawerFund;
+  const sorted = getSortedDrawerContributions(fund);
+  let html = '<div class="drawer-title">' + fund.name + '</div>';
+  html += '<div class="drawer-subtitle">' + fund.code + ' \u6301\u4ED3\u660E\u7EC6</div>';
+  html += fund.detailMode === 'global'
+    ? buildGlobalDrawerTable(fund, sorted)
+    : buildDefaultDrawerTable(sorted);
+  dom.drawerContent.innerHTML = html;
+}
+
+function hideDrawer() {
+  dom.drawer.classList.remove('open');
+  dom.drawerOverlay.classList.remove('open');
+}
+
+function buildMap(data) {
+  state.fundMap = {};
+  for (const f of data) state.fundMap[f.code] = f;
+}
+
+function updateMainSort(key) {
+  if (state.sortKey === key) state.sortDir = state.sortDir === 'desc' ? 'asc' : 'desc';
+  else {
+    state.sortKey = key;
+    state.sortDir = 'desc';
+  }
+}
+
+function updateDrawerSort(key) {
+  if (state.drawerSortKey === key) state.drawerSortDir = state.drawerSortDir === 'desc' ? 'asc' : 'desc';
+  else {
+    state.drawerSortKey = key;
+    state.drawerSortDir = 'desc';
+  }
+}
+
+function setCurrentData(data) {
+  state.currentData = data;
+  buildMap(data);
+  sortData();
+  renderFilteredTable();
+}
+
+function setActiveCategory(tab) {
+  dom.filterTabItems().forEach(t => t.classList.remove('active'));
+  tab.classList.add('active');
+  state.activeCategory = tab.dataset.cat;
+  renderFilteredTable();
+}
+
+function handleMainSortClick(e) {
+  const th = e.target.closest('th.sortable');
+  if (!th) return;
+  updateMainSort(th.dataset.key);
+  document.querySelectorAll('#mainTable th.sortable').forEach(t => t.classList.remove('asc', 'desc'));
+  th.classList.add(state.sortDir);
+  sortData();
+  renderFilteredTable();
+}
+
+function handleFundClick(e) {
+  const el = e.target.closest('.fund-name');
+  if (!el) return;
+  const code = el.dataset.code;
+  if (!code) return;
+  if (state.fundMap[code]) showDrawer(state.fundMap[code]);
+}
+
+function handleDrawerSortClick(e) {
+  const th = e.target.closest('th.sortable');
+  if (!th) return;
+  updateDrawerSort(th.dataset.dkey);
+  renderDrawer();
+}
+
+function getStoredConfig() {
+  try {
+    const raw = localStorage.getItem('fundConfig');
+    if (!raw) return null;
+    const obj = JSON.parse(raw);
+    if (obj && typeof obj === 'object' && Object.keys(obj).length > 0) return obj;
+    return null;
+  } catch { return null; }
+}
+
+function showConfigUI() {
+  dom.configOverlay.classList.remove('hidden');
+}
+function hideConfigUI() {
+  dom.configOverlay.classList.add('hidden');
+}
+
+function validateConfig(text) {
+  let obj;
+  try { obj = JSON.parse(text); } catch { throw new Error('JSON \u683C\u5F0F\u9519\u8BEF'); }
+  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) throw new Error('\u914D\u7F6E\u683C\u5F0F\u9519\u8BEF\uFF0C\u9700\u8981\u57FA\u91D1\u4EE3\u7801\u5230\u540D\u79F0\u7684\u6620\u5C04');
+  if (Object.keys(obj).length === 0) throw new Error('\u914D\u7F6E\u4E0D\u80FD\u4E3A\u7A7A');
+  return obj;
+}
+
+function handleFileInputChange(e) {
+  const file = e.target.files[0];
+  if (!file) return;
+  const reader = new FileReader();
+  reader.onload = function(ev) {
+    dom.configText.value = ev.target.result;
+  };
+  reader.readAsText(file);
+}
+
+function handleConfirmConfig() {
+  const text = dom.configText.value.trim();
+  const errEl = dom.errorMsg;
+  if (!text) { errEl.textContent = '\u8BF7\u9009\u62E9\u6587\u4EF6\u6216\u7C98\u8D34 JSON \u5185\u5BB9'; return; }
+  try {
+    const config = validateConfig(text);
+    localStorage.setItem('fundConfig', JSON.stringify(config));
+    errEl.textContent = '';
+    hideConfigUI();
+    doRefresh();
+  } catch (e) {
+    errEl.textContent = e.message;
+  }
+}
+
+// \u5728\u66F4\u65B0\u65F6\u95F4\u533A\u57DF\u6DFB\u52A0"\u5207\u6362\u914D\u7F6E"\u6309\u94AE
+const changeBtn = document.createElement('button');
+changeBtn.className = 'change-config-btn';
+changeBtn.textContent = '\u5207\u6362\u914D\u7F6E';
+changeBtn.addEventListener('click', showConfigUI);
+dom.updateTime.appendChild(changeBtn);
+
+async function doRefresh() {
+  dom.refreshBtn.classList.add('spinning');
+  try {
+    const config = getStoredConfig();
+    if (!config) { showConfigUI(); return; }
+    const res = await fetch('/api/funds', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ funds: config })
+    });
+    if (!res.ok) throw new Error('\u8BF7\u6C42\u5931\u8D25');
+    const data = await res.json();
+    setCurrentData(data);
+  } catch {
+    state.currentData = [];
+    renderTable([]);
+  }
+  dom.refreshBtn.classList.remove('spinning');
+}
+
+function bindEvents() {
+  dom.filterTabs.addEventListener('click', function(e) {
+    const tab = e.target.closest('.filter-tab');
+    if (!tab) return;
+    setActiveCategory(tab);
+  });
+  dom.mainTableHead.addEventListener('click', handleMainSortClick);
+  dom.mainTable.addEventListener('click', handleFundClick);
+  dom.drawerOverlay.addEventListener('click', hideDrawer);
+  dom.drawerClose.addEventListener('click', hideDrawer);
+  dom.configClose.addEventListener('click', hideConfigUI);
+  dom.drawerContent.addEventListener('click', handleDrawerSortClick);
+  dom.fileInput.addEventListener('change', handleFileInputChange);
+  dom.confirmBtn.addEventListener('click', handleConfirmConfig);
+  dom.refreshBtn.addEventListener('click', doRefresh);
+}
+
+// \u521D\u59CB\u5316\uFF1A\u68C0\u67E5 localStorage\uFF0C\u6709\u914D\u7F6E\u5219\u76F4\u63A5\u52A0\u8F7D
+(function init() {
+  bindEvents();
+  const config = getStoredConfig();
+  if (config) {
+    hideConfigUI();
+    doRefresh();
+  } else {
+    showConfigUI();
+  }
+})();
+
+// \u6BCF30\u79D2\u81EA\u52A8\u5237\u65B0
+setInterval(doRefresh, 30000);
+`}function it(){return`<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>\u57FA\u91D1\u4F30\u503C\u67E5\u8BE2</title>
+<style>${ot()}</style>
+</head>
+<body>
+${rt()}
+<script>${st()}</script>
+</body>
+</html>`}async function Y(t){let e=G();e.use(G.json()),e.get("/",(a,o)=>{o.type("html").send(it())}),e.post("/api/funds",async(a,o)=>{try{let r=a.body?.funds;if(!r||typeof r!="object"||Object.keys(r).length===0)return o.status(400).json({error:"funds \u914D\u7F6E\u65E0\u6548"});let c=await at(r);o.json(c)}catch(r){o.status(500).json({error:r.message})}});let n=e.listen(t,()=>{console.log(`\u670D\u52A1\u5DF2\u542F\u52A8: http://localhost:${t}`)})}function dt(t,e){let n=t.estimatedChange===null||t.estimatedChange===void 0||Number.isNaN(t.estimatedChange),a=e.estimatedChange===null||e.estimatedChange===void 0||Number.isNaN(e.estimatedChange);return n&&a?0:n?1:a?-1:e.estimatedChange-t.estimatedChange}var m=new ct;m.name("fund").description("\u57FA\u91D1\u4F30\u503C\u67E5\u8BE2\u5DE5\u5177").version("1.0.0","-v, -V, --version");m.action(()=>{m.help()});m.command("config [path]").description("\u8BBE\u7F6E\u6216\u67E5\u770B\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").action(t=>{if(t)j(t);else{let e=S();e?console.log(e):(console.error("\u672A\u8BBE\u7F6E\u914D\u7F6E\u6587\u4EF6\uFF0C\u8BF7\u8FD0\u884C: fund config <\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84>"),process.exit(1))}});m.command("list").description("\u5217\u51FA\u6240\u6709\u914D\u7F6E\u7684\u57FA\u91D1").action(async()=>{let t=N(),e=await C(t);e.sort(dt),_(e)});m.command("detail <code>").description("\u67E5\u770B\u5355\u53EA\u57FA\u91D1\u6301\u4ED3\u8BE6\u60C5").action(async t=>{let n=N()[t];n||(console.error(`\u57FA\u91D1 ${t} \u672A\u5728\u914D\u7F6E\u6587\u4EF6\u4E2D\u914D\u7F6E`),process.exit(1));let a=await M({[t]:n}),o=await L(a),r=await E(t,n,a.get(t)||[],o);Q(r)});m.command("serve").description("\u542F\u52A8 Web \u670D\u52A1\uFF08\u7528\u4E8E\u90E8\u7F72\u5230\u670D\u52A1\u5668\uFF09").option("-p, --port <port>","\u7AEF\u53E3\u53F7",process.env.PORT||"8888").action(async t=>{let e=parseInt(t.port,10);await Y(e)});m.command("*",null,{noHelp:!0}).action(()=>{console.error(`\u672A\u77E5\u547D\u4EE4
+`),m.help()});m.parse();

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@cxxgo/fund-valuation-query",
+  "version": "1.0.4",
+  "type": "module",
+  "bin": {
+    "fund": "./dist/fund.js"
+  },
+  "scripts": {
+    "start": "node dist/fund.js serve",
+    "build": "node scripts/build.js",
+    "prepublishOnly": "npm run build",
+    "publish": "npm publish",
+    "release:patch": "npm version patch && git push && git push --tags && npm publish",
+    "release:minor": "npm version minor && git push && git push --tags && npm publish",
+    "release:major": "npm version major && git push && git push --tags && npm publish"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cxxgo/fund-valuation-query.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/cxxgo/fund-valuation-query/issues"
+  },
+  "homepage": "https://github.com/cxxgo/fund-valuation-query#readme",
+  "description": "基金实时估值查询 CLI 工具，根据持仓股票行情估算基金涨跌幅",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "esbuild": "^0.25.12"
+  },
+  "dependencies": {
+    "axios": "^1.9.0",
+    "chalk": "^5.3.0",
+    "cheerio": "^1.0.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "express": "^4.21.0"
+  }
+}