FQGate Agent

https://github.com/zhuyifang/tonghuasun-agent
Admin
FQGate Agent 是面向 Codex、Claude Code、豆包和千问等多种 AI 工具的开源插件，通过连接本机 FQGate 网关为用户提供 A 股实时行情、K 线、Level-2...
Tokens:49,096
Snippets:278
Trust Score:8.2
License:AGPL-3.0
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### Install FQGate Python SDK

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/sdk/python/README.md

Install the SDK using pip. The base installation is sufficient for HTTP examples.

```powershell
python -m pip install .
```

--------------------------------

### Install FQGate and Qianwen skills with setup.ps1

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/AI-plugins/qianwen/README.md

Run this command after entering a Qianwen work task and extracting the Qianwen installation package. It installs and starts FQGate, then installs the Qianwen skills and connection. If the same official version already exists, it will be reused directly.

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\setup.ps1
```

--------------------------------

### I1: run component setup

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Runs the setup function of a component, handling synchronous and asynchronous results. Sets up the proxy and setup context, and handles async dependencies.

```javascript
function I1(e,t){const n=e.type;e.accessCache=Object.create(null),e.proxy=new Proxy(e.ctx,e1);const{setup:o}=n;if(o){Ln();const s=e.setupContext=o.length>1?N1(e):null,r=Vr(e),i=Dr(o,e,0,[e.props,s]),a=Og(i);if(qn(),r(),(a||e.sp)&&!os(e)&&fv(e),a){if(i.then(Pf,Pf),t)return i.then(l=>{Nr(!0);try{xf(e,l,t)}finally{Nr(!1)}}).catch(l=>{qa(l,e,0)});e.asyncDep=i}else xf(e,i)}else qv(e)}
```

--------------------------------

### xf: apply setup result

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Assigns the render function or setup state from the setup result, then calls qv to finalize the component.

```javascript
function xf(e,t,n){Oe(t)?e.type.__ssrInlineRender?e.ssrRender=t:e.render=t:We(t)&&(e.setupState=Qg(t)),qv(e)}
```

--------------------------------

### Install FQGate Python SDK with realtime extra

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/sdk/python/README.md

Install the SDK with the 'realtime' extra to enable real-time streaming support.

```powershell
python -m pip install ".[realtime]"
```

--------------------------------

### Install and configure fqgate-agent plugin

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/AI-plugins/deepseek-harness/README.md

Adds the fqgate-agent plugin, configures it with the FQGate executable path, and starts the web interface. Requires FQGate 0.1.0 or higher and a built npm package.

```powershell
dsh plugin --profile web add <fqgate-agent-deepseek-harness-1.0.0.tgz>
dsh plugin --profile web exec fqgate-agent configure --fqgate-path "<FQGate 可执行文件>" --json
dsh web
```

--------------------------------

### N1: create setup context

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Creates the setup context object with attrs proxy, slots, emit, and expose function.

```javascript
function N1(e){const t=n=>{e.exposed=n||{}};return{attrs:new Proxy(e.attrs,z1),slots:e.slots,emit:e.emit,expose:t}}
```

--------------------------------

### HTTP example using Client.discover()

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/sdk/python/README.md

Create a client via discovery and call health, search, market data, and klines endpoints.

```python
from fqgate_client import Client

client = Client.discover()
print(client.health())
print(client.search("贵州茅台"))
print(client.market_data([{"market": "USHA", "code": "600519"}]))
print(client.klines("USHA", "600519", count=30, interval="day", adjust="forward"))
```

--------------------------------

### Install FQGate via install-fqgate.ps1 scripts

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/AI-plugins/qianwen/README.md

Windows users can run the first command from the repository root to install FQGate. If using an already-extracted plugin package, run the second command. Both commands perform official version download, verification, fixed-directory installation, shortcut creation, startup, and connection check.

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\installer\runtime\install-fqgate.ps1
```

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-fqgate.ps1
```

--------------------------------

### O1: initialize component

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Initializes a component instance: sets up props, slots, and then runs setup or render. Returns the result of setup if it is a function.

```javascript
let Mr=!1;function O1(e,t=!1,n=!1){t&&Nr(t);const{props:o,children:s}=e.vnode,r=Lv(e);m1(e,o,r,t),b1(e,s,n||t);const i=r?I1(e,t):void 0;return t&&Nr(!1),i}
```

--------------------------------

### WebSocket example using RealtimeClient

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/sdk/python/README.md

Subscribe to real-time quotes via WebSocket and print each message asynchronously.

```python
import asyncio
from fqgate_client import RealtimeClient

async def main():
    client = RealtimeClient.discover()
    async for message in client.subscribe(kind="quote", market="USHA", code="600519"):
        print(message)

asyncio.run(main())
```

--------------------------------

### Alert component registration with install

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/login.html

Registers the alert component with a plugin install function that adds it globally using the component name prefix.

```javascript
var bl=Pe(j9,\[\["render",F9\]\]);const B9=Object.assign(bl,{install:(e,t)=>{Vt(e,t);const n=Bt(t);e.component(n+bl.name,bl)}});
```

--------------------------------

### HTTP example using client.request() for unknown endpoints

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/sdk/python/README.md

Use the generic request method to call public paths for unknown or new interfaces.

```python
document = client.request("GET", "/openapi.json")
result = client.request("POST", "/v1/market/history/intraday", {
    "market": "USHA",
    "code": "600519",
})
```

--------------------------------

### Alert component setup with prefixCls and close handlers

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/login.html

Computed properties and handlers for an alert component: prefix class, dynamic class bindings, visibility state, and close/after-close callbacks.

```javascript
o=\_e("alert"),r=se(!0),s=l=>{r.value=!1,n("close",l)},i=()=>{n("afterClose")},a=w(()=>\[o,\`${o}-${e.type}\`,{\[\`${o}-with-title\`\]:!!(e.title||t.title),\[\`${o}-banner\`\]:e.banner,\[\`${o}-center\`\]:e.center}\]);return{prefixCls:o,cls:a,visible:r,handleClose:s,handleAfterLeave:i}
```

--------------------------------

### Remove old tonghuasun-agent plugin

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/AI-plugins/deepseek-harness/README.md

Removes the old tonghuasun-agent plugin from the web profile, lists installed plugins to confirm removal, and starts the web interface. Do not load the old and new agents simultaneously.

```powershell
dsh plugin --profile web remove tonghuasun-agent-deepseek-harness
dsh plugin --profile web list
dsh web
```

--------------------------------

### Zod Check Starts With

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/login.html

Registers the $ZodCheckStartsWith check. Builds a regex that matches the prefix at the start of the value, attaches the pattern, and checks if the value starts with the prefix, pushing an 'invalid_format' issue if not.

```javascript
wv=M("$ZodCheckStartsWith",(e,t)=>{Ut.init(e,t);const n=new RegExp(\`^${ir(t.prefix)}.*\`);t.pattern??(t.pattern=n),e.\_zod.onattach.push(o=>{const r=o.\_zod.bag;r.patterns??(r.patterns=new Set),r.patterns.add(n)}),e.\_zod.check=o=>{o.value.startsWith(t.prefix)||o.issues.push({origin:"string",code:"invalid\_format",format:"starts\_with",prefix:t.prefix,input:o.value,inst:e,continue:!t.abort})}})
```

--------------------------------

### M1: get component name

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Gets the component name from a function or object, preferring displayName and name properties.

```javascript
function M1(e,t=!0){return Oe(e)?e.displayName||e.name:e.name||t&&e.__name}
```

--------------------------------

### 启动开发服务器

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/examples/trading-demo/README.md

在 examples\trading-demo 目录下安装依赖并启动开发服务器，然后访问 http://127.0.0.1:5173/。

```powershell
cd examples\trading-demo
npm install
npm run dev
```

--------------------------------

### ui/initialize

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Initializes the UI app with app information, capabilities, and protocol version.

```APIDOC
## ui/initialize

### Description
Initializes the UI app with app information, capabilities, and protocol version.

### Method
Notification

### Parameters
- **appInfo** (object) - Required - App identification (name and version).
- **appCapabilities** (object) - Required - Features and capabilities this app provides.
- **protocolVersion** (string) - Required - Protocol version this app supports.
```

--------------------------------

### PowerShell 安装 FQGate 命令

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/README.md

在 Windows 仓库根目录运行此命令，自动下载并安装 FQGate 主程序。使用已解压的插件安装包时，将脚本路径替换为 .\scripts\install-fqgate.ps1。

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\installer\runtime\install-fqgate.ps1
```

--------------------------------

### Get transform origin for placement

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/login.html

Returns CSS transform-origin values for a placement.

```javascript
C_=e=>{let t="0";["top","bottom"].includes(e)?t="50%":["left","lt","lb","tr","br"].includes(e)&&(t="100%");let n="0";return["left","right"].includes(e)?n="50%":["top","tl","tr","lb","rb"].includes(e)&&(n="100%"),`${t} ${n}`}
```

--------------------------------

### Initialize MCP App with event listeners

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Initializes the MCP app with autoResize, strict, and allowUnsafeEval options. Sets up event listeners for tool input, tool result, and host context changes, subscribes to the OpenAI bridge, and defines teardown cleanup.

```javascript
ju({name:t,version:n},{},{autoResize:!0,strict:!0,allowUnsafeEval:!1}),this.app.addEventListener("toolinput",({arguments:s})=>{this.acceptToolInput(SR(s)?s:{})}),this.app.addEventListener("toolresult",s=>{this.acceptToolResult(s)}),this.releaseOpenAiListener=this.openAiBridge.subscribe(s=>{this.acceptOpenAiSnapshot(s)}),this.acceptOpenAiSnapshot(this.openAiBridge.getSnapshot()),this.app.addEventListener("hostcontextchanged",s=>nf(s)),this.app.onteardown=async()=>(this.inputListeners.clear(),this.resultListeners.clear(),this.releaseOpenAiListener?.(),this.releaseOpenAiListener=void 0,{})}
```

--------------------------------

### x1: create component instance

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Creates a component instance object with all its reactive state and lifecycle hooks. Initializes the instance context, root, and emit function.

```javascript
const E1=_v();let P1=0;function x1(e,t,n){const o=e.type,s=(t?t.appContext:e.appContext)||E1,r={uid:P1++,vnode:e,type:o,parent:t,appContext:s,root:null,next:null,subTree:null,effect:null,update:null,job:null,scope:new tk(!0),render:null,proxy:null,exposed:null,exposeProxy:null,withProxy:null,provides:t?t.provides:Object.create(s.provides),ids:t?t.ids:["",0,0],accessCache:null,renderCache:[],components:null,directives:null,propsOptions:Ev(o,s),emitsOptions:Cv(o,s),emit:null,emitted:null,propsDefaults:Qe,inheritAttrs:o.inheritAttrs,ctx:Qe,data:Qe,props:Qe,attrs:Qe,slots:Qe,refs:Qe,setupState:Qe,setupContext:null,suspense:n,suspenseId:n?n.pendingId:0,asyncDep:null,asyncResolved:!1,isMounted:!1,isDeactivated:!1,bc:null,c:null,bm:null,m:null,bu:null,u:null,um:null,bum:null,da:null,a:null,rtg:null,rtc:null,ec:null,sp:null};return r.ctx={_:r},r.root=t?t.root:r,r.emit=c1.bind(null,r),e.ce&&e.ce(r),r}
```

--------------------------------

### 卸载旧版 tonghuasun-agent 插件

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/AI-plugins/claude-code/README.md

在 Claude Code 中依次执行这些命令以卸载旧版 tonghuasun-agent 插件并移除旧市场。如果第一条命令提示找不到默认范围中的插件，请运行 /plugin 进入 Installed 页手动卸载。

```text
/plugin uninstall tonghuasun-agent@tonghuasun-agent
/plugin marketplace remove tonghuasun-agent
/reload-plugins
```

--------------------------------

### z1: attrs proxy getter

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/information.html

Proxy handler for attrs that logs a get operation and returns the attribute value.

```javascript
const z1={get(e,t){return Lt(e,"get",""),e[t]}};
```

--------------------------------

### Vue icon components and Alert component definition

Source: https://github.com/zhuyifang/tonghuasun-agent/blob/main/fqgate/mcp-apps/releases/0.1.2/login.html

Minified JavaScript code defining Vue icon components (IconCheckCircleFill, IconExclamationCircleFill, IconCloseCircleFill) and an Alert component. It sets up SVG rendering with stroke properties, size/rotate handling, and component installation via `install` methods. The Alert component accepts props like `type`, `showIcon`, `closable`, `title`, `banner`, and `center`, and emits `close` and `afterClose` events.

```javascript
e.size&&(i.fontSize=je(e.size)?`${e.size}px`:e.size),e.rotate&&(i.transform=`rotate(${e.rotate}deg)`),i});return{cls:o,innerStyle:r,onClick:i=>{t("click",i)}}}),O9=["stroke-width","stroke-linecap","stroke-linejoin"];function L9(e,t,n,o,r,s){return q(),le("svg",{viewBox:"0 0 48 48",fill:"none",xmlns:"http://www.w3.org/2000/svg",stroke:"currentColor",class:te(e.cls),style:Ve(e.innerStyle),"stroke-width":e.strokeWidth,"stroke-linecap":e.strokeLinecap,"stroke-linejoin":e.strokeLinejoin,onClick:t[0]||(t[0]=(...i)=>e.onClick&&e.onClick(...i))},t[1]||(t[1]=[de("path",{"fill-rule":"evenodd","clip-rule":"evenodd",d:"M24 44c11.046 0 20-8.954 20-20S35.046 4 24 4 4 12.954 4 24s8.954 20 20 20Zm10.207-24.379a1 1 0 0 0 0-1.414l-1.414-1.414a1 1 0 0 0-1.414 0L22 26.172l-4.878-4.88a1 1 0 0 0-1.415 0l-1.414 1.415a1 1 0 0 0 0 1.414l7 7a1 1 0 0 0 1.414 0l11.5-11.5Z",fill:"currentColor",stroke:"none"},null,-1)]),14,O9)}var gl=Pe(P9,[["render",L9]]);const Ng=Object.assign(gl,{install:(e,t)=>{var n;const o=(n=t?.iconPrefix)!=null?n:"";e.component(o+gl.name,gl)}}),A9=fe({name:"IconExclamationCircleFill",props:{size:{type:[Number,String]},strokeWidth:{type:Number,default:4},strokeLinecap:{type:String,default:"butt",validator:e=>["butt","round","square"].includes(e)},strokeLinejoin:{type:String,default:"miter",validator:e=>["arcs","bevel","miter","miter-clip","round"].includes(e)},rotate:Number,spin:Boolean},emits:{click:e=>!0},setup(e,{emit:t}){const n=_e("icon"),o=w(()=>[n,`${n}-exclamation-circle-fill`,{[`${n}-spin`]:e.spin}]),r=w(()=>{const i={};return e.size&&(i.fontSize=je(e.size)?`${e.size}px`:e.size),e.rotate&&(i.transform=`rotate(${e.rotate}deg)`),i});return{cls:o,innerStyle:r,onClick:i=>{t("click",i)}}}),z9=["stroke-width","stroke-linecap","stroke-linejoin"];function M9(e,t,n,o,r,s){return q(),le("svg",{viewBox:"0 0 48 48",fill:"none",xmlns:"http://www.w3.org/2000/svg",stroke:"currentColor",class:te(e.cls),style:Ve(e.innerStyle),"stroke-width":e.strokeWidth,"stroke-linecap":e.strokeLinecap,"stroke-linejoin":e.strokeLinejoin,onClick:t[0]||(t[0]=(...i)=>e.onClick&&e.onClick(...i))},t[1]||(t[1]=[de("path",{"fill-rule":"evenodd","clip-rule":"evenodd",d:"M24 44c11.046 0 20-8.954 20-20S35.046 4 24 4 4 12.954 4 24s8.954 20 20 20Zm-2-11a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1h-2a1 1 0 0 0-1 1v2Zm4-18a1 1 0 0 0-1-1h-2a1 1 0 0 0-1 1v12a1 1 0 0 0 1 1h2a1 1 0 0 0 1-1V15Z",fill:"currentColor",stroke:"none"},null,-1)]),14,z9)}var vl=Pe(A9,[["render",M9]]);const qg=Object.assign(vl,{install:(e,t)=>{var n;const o=(n=t?.iconPrefix)!=null?n:"";e.component(o+vl.name,vl)}}),I9=fe({name:"IconCloseCircleFill",props:{size:{type:[Number,String]},strokeWidth:{type:Number,default:4},strokeLinecap:{type:String,default:"butt",validator:e=>["butt","round","square"].includes(e)},strokeLinejoin:{type:String,default:"miter",validator:e=>["arcs","bevel","miter","miter-clip","round"].includes(e)},rotate:Number,spin:Boolean},emits:{click:e=>!0},setup(e,{emit:t}){const n=_e("icon"),o=w(()=>[n,`${n}-close-circle-fill`,{[`${n}-spin`]:e.spin}]),r=w(()=>{const i={};return e.size&&(i.fontSize=je(e.size)?`${e.size}px`:e.size),e.rotate&&(i.transform=`rotate(${e.rotate}deg)`),i});return{cls:o,innerStyle:r,onClick:i=>{t("click",i)}}}),N9=["stroke-width","stroke-linecap","stroke-linejoin"];function q9(e,t,n,o,r,s){return q(),le("svg",{viewBox:"0 0 48 48",fill:"none",xmlns:"http://www.w3.org/2000/svg",stroke:"currentColor",class:te(e.cls),style:Ve(e.innerStyle),"stroke-width":e.strokeWidth,"stroke-linecap":e.strokeLinecap,"stroke-linejoin":e.strokeLinejoin,onClick:t[0]||(t[0]=(...i)=>e.onClick&&e.onClick(...i))},t[1]||(t[1]=[de("path",{"fill-rule":"evenodd","clip-rule":"evenodd",d:"M24 44c11.046 0 20-8.954 20-20S35.046 4 24 4 4 12.954 4 24s8.954 20 20 20Zm4.955-27.771-4.95 4.95-4.95-4.95a1 1 0 0 0-1.414 0l-1.414 1.414a1 1 0 0 0 0 1.414l4.95 4.95-4.95 4.95a1 1 0 0 0 0 1.414l1.414 1.414a1 1 0 0 0 1.414 0l4.95-4.95 4.95 4.95a1 1 0 0 0 1.414 0l1.414-1.414a1 1 0 0 0 0-1.414l-4.95-4.95 4.95-4.95a1 1 0 0 0 0-1.414l-1.414-1.414a1 1 0 0 0-1.414 0Z",fill:"currentColor",stroke:"none"},null,-1)]),14,N9)}var yl=Pe(I9,[["render",q9]]);const jg=Object.assign(yl,{install:(e,t)=>{var n;const o=(n=t?.iconPrefix)!=null?n:"";e.component(o+yl.name,yl)}}),j9=fe({name:"Alert",components:{IconHover:Qn,IconClose:ji,IconInfoCircleFill:$9,IconCheckCircleFill:Ng,IconExclamationCircleFill:qg,IconCloseCircleFill:jg},props:{type:{type:String,default:"info"},showIcon:{type:Boolean,default:!0},closable:{type:Boolean,default:!1},title:String,banner:{type:Boolean,default:!1},center:{type:Boolean,default:!1}},emits:{close:e=>!0,afterClose:()=>!0},setup(e,{slots:t,emit:n}){const 
```
Tokens:
Raw