Skip to main content
H

dsh-connect-officeAce

hxgh776/dsh-connect-officeace

Connects a locally signed-in Huawei OfficeAce desktop account to DSH as an OpenAI-compatible chat provider that reuses the stored login instead of an API key, with streaming, reasoning and tool-call passthrough.

Install

dsh plugin --profile web add github:hxgh776/dsh-connect-officeace

README

DSH Connect OfficeAce

把本机安装并登录的 OfficeAce(中文名 华为果办)桌面端接入 DeepSeek Harness (DSH):OfficeAce 的模型出现在 DSH 模型选择器,OpenAI 兼容请求经进程内 loopback shim 转发到模型网关,bash / read / write / edit 等工具仍由 DSH 本地执行。

架构与工程约定参照 dsh-connect-trae(远端)与 dsh-connect-loomy(本机)。

不用填 Key。 插件从本机 OfficeAce 的登录态里读出模型网关地址与凭据:CredRead 读 Windows 凭据管理器里的 provider-state(manifest + 6 个分块),拼接后 base64 解码得到 JSON,取 modelInfo.model_api_url_base 与 model_api_auth_info 的 app-key 对,/v1/chat/completions 用 HTTP Basic 调用。只读、不落盘、不进日志、不进 web 路由响应。

逐条依据见 docs/protocol.md(【实测】/【参考】/【推断】)。

完成度

能力状态依据
DSH provider 注册 / 模型选择器✅ 已实现参考实现
loopback shim(随机端口 + 进程内 secret + 流式透传)✅ 有测试参考实现
pi-ai 适配 + 跨版本 context 折叠✅ 已实现参考实现
复用本机 OfficeAce 登录态(免 Key)✅ 已实现;真机解出网关与凭据实测:wincred manifest/chunks → base64 → JSON
模型网关地址与鉴权✅ 实测https://<model_api_url_base>/v1 + Basic app-key
对话:SSE / reasoning / tool_calls / usage✅ 实测 200 + 流式增量见 protocol §3
模型可用性(目录 ≠ 可用)✅ 实测:38 条目录 → 20 条 chat → 6 条真能用逐个发最小补全,14 条 404/403;默认只列这 6 条
上游端到端 probe✅ 真跑通(deepseek-v4-flash)见下方验证
设置面板(settings.section)✅ 已实现;浏览器端脚本静态校验src/client.js → lib/client.js,见「设置面板」
用量 / 积分看板❌ 未实现没有可验证的查询接口
每日签到、模型管理 UI、多区域面板❌ 不在范围无证据,不臆造

前提

  • 先安装并登录 OfficeAce 桌面端(插件不做登录,也绝不代登录)。
  • Windows x64。插件读取安装目录下的本地状态库与当前用户的 Windows 凭据管理器。
  • 运行插件的进程要能启动一个短命的 PowerShell 子进程(CredRead 的传输通道)。DSH 宿主进程满足;受限沙箱可能不满足(见「已知限制」)。

工作方式

DSH pi-ai provider (openai-completions)
  → 进程内 loopback shim(127.0.0.1 随机端口 + 进程内随机 secret)
    → https://<modelInfo.model_api_url_base>/v1/chat/completions(HTTP Basic app-key)
  • 登录态:只读 %LOCALAPPDATA%\Programs\OfficeAce\data\storage.sqlite 找到当前账号的 providerStateRef,再只读 Windows 凭据管理器里的 manifest + 分块;解码出的网关地址与 app-key 只在进程内存里。
  • 凭据来源(AccessResolver,按顺序):显式设置 apiKey → DSH_OFFICEACE_API_KEY → 本机登录态(local-session)。显式 Key 走 Bearer,本机登录态走 Basic。
  • 模型目录:GET /v1/models 发现并缓存到 ~/.dsh/dsh-connect-officeace.catalog.json;上游不可达时回落缓存。目录里混有图像/视频/embedding/rerank 模型,按 id 启发式过滤(见 protocol §4)。
  • 隔离:只读写自己的设置命名空间与 ~/.dsh/dsh-connect-officeace.*.json,不与其它插件共享账号、凭据、目录或开关。

安装

dsh plugin --profile desktop add <仓库路径>

@deepseek-ai/* 与 @earendil-works/pi-ai 为 peerDependencies,由 DSH 宿主提供,不打包。

设置面板

DSH 的设置页不会自动生成:registerConfigurableProviders 只把 provider 放进模型列表,左侧导航里的「设置 → 果办」由插件自己的浏览器脚本注册 settings.section slot。

  • 源码是手写的 src/client.js(CommonJS-shaped 普通脚本:window.__ModuleLoader__.load({ id, factory }),顶部不能出现 import,否则整个 web boot 会挂)。
  • 构建时由 scripts/copy-client.mjs 复制到 lib/client.js(仓库已提交 lib/,所以 git 安装无需构建;本地改完源码后仍需 npm run build)。
  • 面板内容只走三条已存在的路由:status(登录状态、脱敏账号、到期时间、凭据来源、网关 baseUrl)、catalog(模型清单)、__save(只写 enabledModelIds)。没有任何把凭据送到浏览器的字段。
  • npm run verify:client 做静态校验:CJS 形态、require 白名单、导出集合、inject = ["slots","locale"]、settings.section 注册、package.json 的 exports["./client"] 与 dsh.client、产物一致性。

从 GitHub 安装(换机器时推荐):

dsh plugin --profile desktop add github:hxgh776/dsh-connect-officeAce

⚠️ dsh plugin add 对 git 依赖不会自动把插件写进 profile 的 dsh.profile.bundles(file: / link: 会)。装完如果 dsh --profile <名称> --dump-config 里看不到 dsh-connect-officeace,请手动把它加到该 profile 的 dsh.profile.bundles,否则 DSH 会报 NO_ADAPTER: no adapter registered for provider "officeace"。

本地开发用 link: 更省事(改源码即时生效,无需重装):

dsh plugin --profile desktop add link:D:/software/dsh-plugin/dsh-connect-officeace

仓库已提交 lib/ 构建产物,所以 git 安装不需要再跑构建。

设置

设置 → 果办。登录正常时全部留空即可。

字段说明
enabledModelIds勾选的模型 id;留空=只展示本机实测可用的那几条,显式空数组=一个都不选。
apiKey可选。填写后改用 Bearer,覆盖本机登录态。
baseUrl可选。留空用本机解析出的 https://<model_api_url_base>/v1;仅在网关地址异常时覆盖。
installRoot可选。OfficeAce 安装根目录;留空自动探测。
defaultContextWindow/models 不返回上下文长度时的默认值(推断值,默认 200000)。

状态卡还展示:本机是否登录、账号(脱敏)、过期时间、凭据来源(settings/env/local-session)、网关 baseUrl、目录来源。

CLI 诊断

node lib/cli-doctor.js [--json] [--network] [--install-root <dir>] [--base-url <url>]
node lib/cli-probe.js [-p <prompt>] [-m <model>] [--tools] [--json] [--no-stream] [--timeout-ms N]
node lib/bin.js doctor | probe
  • doctor:五项只读检查(安装 / 本地库 / 登录记录 / 凭据解析 / 网关),--network 才探测 /v1/models;不消耗推理额度;退出码 0/1/2。
  • probe:真实流式对话一次(会消耗额度);退出码 0/2/3/4/5/1。

真机 doctor --network(2026-11-16,OfficeAce 1.8.1):

OK   install      找到 OfficeAce 本地状态库 data/storage.sqlite
OK   local-store  本地状态库可读(只读打开)
OK   session      已登录(provider=huawei-oauth,expiresAt=2026-11-16T15:12:35.397Z)
OK   credential   访问凭据已解析(来源:local-session,baseUrl:https://modelgw-0006.…/v1)
OK   upstream     模型网关 /v1/models 可用(38 个模型)

真机 probe --tools --json:ok:true,model:"deepseek-v4-flash",status:200,usage 含 reasoning_tokens:107。

已知限制

  • 受限沙箱里 Node 不能 spawn 子进程(spawn EPERM)。此时凭据无法解析,doctor 会明确报 powerShell_blocked;可用 DSH_OFFICEACE_PROVIDER_STATE_FILE=<已解码的 provider-state.json> 做离线诊断(仅测试用,文件含凭据,用完即删)。DSH 宿主进程/普通终端不受此限制。
  • 上下文窗口仍是假设值(见 protocol §4)。
  • 上游可用模型因账号而异。/v1/models 列出的模型不等于该账号有权限调用:本机实测目录 38 条、其中 20 条看起来是对话模型,逐个发最小补全后只有 6 条返回 200 —— deepseek-v4-flash、glm-5.3、glm-5.2、glm-5.1、deepseek-v4.1-flash-0930、deepseek-v4-flash-0731。其余 14 条返回 404(ModelArts.81009 Invalid model / 81016 not available with api url)或 403(无权限),包括 OfficeAce 自己配置里的默认模型 deepseek-v4.1-flash。所以未勾选时插件只列这 6 条;账号不同可自行在设置里勾选。

隐私

  • 只读 OfficeAce 的本地状态库与当前用户的 Windows 凭据管理器;不写回、不复制到磁盘、不密封。
  • app-key、STS token、refresh token 等只存在于进程内存;不进日志、不进错误消息、不进 web 路由响应、不进 loopback shim 响应。
  • 账号 id <orgId>:<userId> 在所有视图里脱敏为 43808e…:ce736e…。
  • web 路由先过宿主 Connection 的 requestRejection,再叠 loopback Host/Origin + sec-fetch-site 门禁;写路由额外要求 x-dsh-officeace-write 头。
  • 仓库不含任何凭据、账号、余额或截图。

开发

npm install
npm run check     # typecheck + test + build
npm run doctor
npm run e2e       # 端到端:本机登录 → 凭据 → 网关 → shim → 对话/流式/工具调用

测试:tsc -p tsconfig.test.json && node scripts/test.mjs(69 条,单进程跑,原因见 DEVELOPMENT.md)。

npm run e2e 打真实网关、会消耗少量额度(单次跑下来不到 1000 token),只在已登录 OfficeAce 的机器上跑;它不使用 DSH_OFFICEACE_PROVIDER_STATE_FILE 之类的旁路,凭据来源必须是 local-session。

License

MIT

Related plugins