CarPlay for compatible BYD Android head units. Wired and wireless, with the familiar DiAuto interface. Independent app: com.shihab.diplay.

BYD support scope: These projects focus on BYD cars. They may work on other brands, but other brands are unsupported and there are no plans to add support or fix brand-specific incompatibilities.

Download & website · Release · Report a problem

0.2.8 — public preview

Install on the car, not the iPhone. No jailbreak, dongle, Mac, account or authentication server is required for use. Core CarPlay does not require ADB; optional dashboard, battery, wheel-speed and parked-video features do. Your head unit must permit APK installation. Wireless supports Wi-Fi Direct or the car’s existing hotspot; Wi-Fi Direct requires Android 10+; the APK supports Android 9+ for wired use.

• Wired USB and wireless CarPlay with local authentication.
• BYD HUD navigation with arrows, distance and street names on verified firmware.
• Car hotspot support, improved audio buffering and saved receive diagnostics.
• Automatic address discovery, fixed-channel Wi-Fi fallbacks and successful-configuration memory.
• Icon/text size, resolution and frame rate; applying a display change reconnects CarPlay.
• Local diagnostic export. Reports are sent only if you choose to share them.
• Separate installation alongside DiAuto. Run one projection app at a time.

This is not an Apple-certified product. The APK bundles an experimental accessory identity recovered from public Carlinkit firmware, not a newly provisioned MFi identity for DiPlay. A bundled private key is extractable. Acceptance after future iOS updates, reliability across head units and suitability of that identity for general distribution are unresolved. This release invites community testing; it is not a guarantee of universal compatibility.

Earlier releases were tested on the development DiLink5.1 car: live windshield guidance and street names work, Car hotspot now starts CarPlay, and Wi-Fi Direct performance is substantially improved. Occasional audio cutouts remain and are deferred to a later update. The new features were tested on a BYD Tang with DiLink 5.0 and an iPhone 15 Pro on iOS 27; wheel-speed dead reckoning in tunnels remains unverified. Broader head-unit and iOS compatibility is not guaranteed. The HUD firmware scope and cleanup limits are documented in BYD navigation.

What’s new in 0.2.8

• App interface in English, Simplified Chinese, Arabic, Russian and Spanish; synchronized Android app-language settings.
• Steering-wheel media controls and long-press Siri on supported BYD firmware while CarPlay is on screen.
• Dashboard display choices: map, turn card, or both; corrected dashboard keyframe recovery.
• Optional ADB feature on supported DiLink 5.0: pause the dashboard map stream when its display mode hides the map.
• Optional ADB battery reporting for Apple Maps, with warning threshold, charging-connector selection and a checked reconnect action.
• Wireless location reporting continues across the Bluetooth-to-Wi-Fi handoff; USB and wireless updates are limited to one per second.
• Optional ADB wheel-speed and gear reporting lets iPhone navigation estimate movement when GPS is unavailable. Tunnel use still needs validation.
• Optional iOS 27 video playback on the car screen while parked, with iPhone, touchscreen and steering-wheel controls. Playback closes when the car leaves P.
• DRM-protected video such as Apple TV+ is not supported; DiPlay is not a licensed FairPlay receiver. Netflix does not support AirPlay.

Documentation

• Install and connect
• Compatibility and troubleshooting
• Privacy and diagnostic reports
• Build from source
• Validation
• Release notes
• Credits and licenses

The website is available in English, Arabic, Russian, Spanish and Simplified Chinese. The app interface supports those same five languages. Choose the app language in Settings; on Android 13+, it stays synchronized with Android’s per-app language setting.

Source and credits

Based on xcertplay, GPL-3.0. The home/settings UI and website adapt DiAuto, AGPL-3.0; that license is included in docs/licenses. Preserve those notices when distributing modifications. CarPlay and its icon belong to Apple Inc.; no Apple or BYD affiliation or endorsement is implied.

This repository starts with a clean public source snapshot. Local research, tester reports and release-signing secrets are excluded. The complete source corresponding to the APK is provided with every release; experimental runtime identity assets are described separately in the build instructions and notices.

Local release packaging

The release APK intentionally contains the experimental accessory identity. The Git repository and source archive exclude all accessory and Android signing keys; tests generate synthetic identities at runtime. Source/CI builds omit runtime identity assets by default. Local release builds explicitly select an external asset directory. Publishing the APK makes its bundled identity extractable; building locally does not preserve that identity's confidentiality.

phone-harness · let your agent control your phone.

Connect Claude Code, Codex, or any agent to your real phone. iPhone through
the Mac's iPhone Mirroring window, Android over adb. No jailbreak, no
Xcode, nothing installed on the phone. The agent sees the screen, taps, types,
and reads the result.

  ● agent: wants to open Weather
  │
  ● find_text("Weather") → (400, 468)
  │
  ● tap(400, 468) → reads the screen → forecast is up
  ✓ done

Try Phone Harness Cloud → Hosted iPhones and Androids with stealth, real numbers, 2FA, and unlimited devices

Get started by sending the setup prompt to your
coding agent.

Demo

Task: "Buy me a Waymo to Delah Coffee from my current location."

https://github.com/user-attachments/assets/80b6d38e-0222-481c-93db-9de60d79247a

Setup

Paste into Claude Code or Codex:

Set up phone-harness for me. Clone https://github.com/ShawnPana/phone-harness into ~/.phone-harness, read `install.md` first, install it so `phone-harness` is a command on my PATH, and register it as an agent skill named phone-harness using `phone-harness skill` as the body. Then read `onboarding.md` and walk me through it.

The agent asks which phone is your default and walks you through the parts
that need your hands: pairing iPhone Mirroring and granting Accessibility and
Screen Recording, or turning on Android developer options and approving adb.
phone-harness --doctor checks the chain. Details in install.md.

Usage

phone-harness <<'PY'
open_app("Notes")
tap_text("New Note")
type_text("hello from the harness")
print([o["text"] for o in ocr()][:10])
PY

Helpers are pre-imported. SKILL.md is the agent's day-to-day
guide; helpers.py is the full list.

How it works

iPhone. iPhone Mirroring renders the phone as a Mac window and forwards
mouse and keyboard as touches. The harness captures that window, OCRs it with
Apple's Vision framework for text with tap-ready coordinates, and posts
HID-level events for taps, swipes, and typing.

Android. adb is the transport. screencap is the capture, the phone's
accessibility tree is the text source, input is the hands. Works over USB or
Wi‑Fi, no window needed.

Same helpers on both. phone-harness config set platform ios|android picks
the default.

Limits

• Unlocking the iPhone pauses mirroring; a PIN-locked Android needs the user.
• OCR sees text, not icons. Unlabeled controls need a screenshot and a
  vision-capable model.
• No multi-touch, no camera or Face ID flows. DRM video renders black.
• Connecting the phone is always the user's job.

Sponsor

phone-harness is free and maintained in my own time.
Sponsoring keeps it that way.

把手机变成 DSH 的语音遥控外设
同一局域网扫码即连（或开启内置公网隧道，任意网络可用）：语音输入 · 审批 yes/no · 选择题 · 摇杆浏览 + 实时状态小屏

DSH 网页版「掌机」插件：手机和电脑连同一个 Wi-Fi，用手机扫一个二维码，手机就变成
DSH 的外设遥控器 + 小状态屏——你坐在电脑前，手机随手一瞥就是 agent 的运行状态，
消息、审批、选择题都能在手机上直接处理。手机不在同一网络时，可在设置页开启内置
公网隧道，任意网络（4G/异地 WiFi）扫码即连，无需再装花生壳等外部服务。

✨ 功能一览

• 📡 实时状态栏：当前工作区 / 会话 / agent 状态（● 运行中 / ○ 空闲 / 待审批 /
  选择题）+ 一行总结 + 消息浏览进度（‹ 第 N/M 条 ›）。
• 🎤 语音输入：直接调用手机输入法的语音转文字，A 键 / 回车发送进当前会话。
• ✅ 审批：YES = 允许一次、NO = 拒绝，与 GUI 审批面板语义一致；有待审批时
  键位高亮闪烁提醒。
• 🔢 选择题：↑↓ 选选项、←→ 翻题，A 键发送 = 提交整组答案。
• 🎮 摇杆与按键：正常模式下 ←→ 上一条 / 下一条消息、↑↓ 滚动查看完整消息；
  B 暂停（中断运行中的 agent，等价 GUI 停止）。
• 🔀 会话管理：顶部下拉切换工作区 / 会话，＋ 新建会话 一键开新会话。
• 🖥️ GUI 设置页「掌机」：动态二维码、连接 URL、在线手机数 / 桥接状态 / 消息数实时统计。
• 🌐 公网隧道（内网穿透，可选）：设置页顶部「内网模式 / 公网模式」一键切换
  （默认内网）；内置 cloudflared（首次启用自动下载，缓存于 ~/.dsh/cache）；
  「快速隧道」零账号零配置出临时公网地址，「命名隧道」用自带域名出固定地址——
  手机在任意网络扫码即连，替代花生壳等外部服务，无需在电脑/手机上运行额外软件。
• 🔋 零运行时依赖：二维码编码器为内置实现（无任何 npm 运行时依赖）；令牌鉴权 +
  收紧 CORS；/info 仅限本机回环。

🚀 安装

前置：dsh web 能正常运行，Node.js ≥ 20、pnpm ≥ 10、git。

支持的 DSH 版本：

方式一：一条命令

dsh plugin --profile web add github:zingzheng/dsh-gb

包名写完整 git 地址也可以：dsh plugin --profile web add https://github.com/zingzheng/dsh-gb.git

这条命令会在 profile 里安装依赖，并自动把声明了 dsh.bundle 的本插件加入挂载层
（无需手动改 cordis.patch.yml）。装完 重启 dsh（插件带 host 半部，只在启动时
挂载），然后在 GUI 设置 →「掌机」扫码连接。

如果提示「找不到 profile 目录」，先跑一次 dsh web 初始化 ~/.dsh/profiles/web 即可。

方式二：把这段话贴给 DSH（懒得敲命令）

把下面这段提示词发给任意一个 DSH 会话，让它自己装：

帮我安装 dsh-gb 插件（DSH 掌机：手机扫码变成 DSH 的 Game Boy 遥控台 + 小状态屏），步骤：
1. 执行 dsh plugin --profile web add github:zingzheng/dsh-gb
2. 完成后提醒我重启 dsh（host 半部只在启动时挂载），再硬刷新浏览器（Ctrl/Cmd+Shift+R）
3. 遇到报错先查 https://github.com/zingzheng/dsh-gb 的 README「常见问题」。

方式三：从源码安装 / 开发（可选）

git clone https://github.com/zingzheng/dsh-gb.git
cd dsh-gb
pnpm install                 # 只装测试依赖（qrcode / jsqr）
node scripts/build-client.mjs

开发挂载二选一（与「方式一」的自动挂载互斥，勿同时使用，否则会重复挂载报错）：

1. 把 ~/.dsh/profiles/web/package.json 依赖指向本地克隆：
   "dsh-gb": "link:D:/path/to/dsh-gb"（开发迭代推荐 Windows junction 连到该目录）；
2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加与插件 cordis.patch.yml 相同的行：

   - insert:
      - id: dsh-gb
        name: 'dsh-gb'

然后 pnpm install、重启 dsh、硬刷新浏览器。lib/client.js 已提交仓库（git 安装
零构建、无构建脚本审批），改动 host 半部需重启 dsh，client 半部硬刷新即可。

📱 使用注意

• 手机与电脑需同一局域网；局域网其他设备即使拿到 URL 也无法使用（页面与 API
  均要求随机令牌；令牌首次启动生成并持久化于 ~/.dsh/dsh-gb.token，重启 dsh
  不变，二维码与 URL 可收藏长期使用；设置页「重置令牌」可一键作废旧令牌）。
• 开启公网隧道后二维码即公网地址（含令牌），手机在任意网络可用；「快速隧道」地址
  在重启 dsh 后变化（重新扫码即可），「命名隧道」地址固定。隧道地址请勿外传。
• 设备间通信端口默认 7788，被占用时自动顺延至 7795。
• 审批语义为「允许一次」（与 GUI 审批面板一致）。

📌 远程访问

手机访问掌机有三条路径（按推荐顺序）：

1. 局域网直连（默认）：手机与运行 dsh 的主机在同一 Wi-Fi，扫码即用，零配置。
2. 内置公网隧道（推荐，实验性）：设置页顶部切换到「公网模式」一键开启——
   • 快速隧道：零账号、零配置，cloudflared 自动出临时公网地址
     （*.trycloudflare.com），手机在任意网络（4G/异地 WiFi）扫码即连；
     地址在 dsh 每次重启后会变化，重新扫码即可，无需任何外部服务。
   • 命名隧道：用自带域名出固定地址——在 Cloudflare 控制台创建隧道并把
     公共主机名（如 dsh.example.com）映射到 http://127.0.0.1:<掌机端口>，
     再把「隧道 Token」与主机名填入设置页；地址永久不变，书签/收藏长期有效，
     是花生壳的完全替代（免费、无流量限制、无需在电脑上另开服务）。
   • cloudflared 二进制在首次启用时自动下载（约 30-60MB，缓存于
     ~/.dsh/cache/dsh-gb/，之后复用），下载源可由环境变量
     DSH_GB_CLOUDFLARED_URL 更换（受限网络走镜像）；下载失败会在设置页
     状态区给出原因，并自动重试（进程异常退出时插件会按退避自动重启隧道）。
   • 隧道运行时，二维码与 URL 自动切换为公网地址；本地局域网直连不受影响。
   • ⚠️ 已知限制：Cloudflare 快速隧道等部分代理只透传 SSE 响应头、缓冲/丢弃数据体
     ——手机页会在 4 秒内自动降级为 /state 轮询（每 2.5s），功能完全可用
     （状态刷新略延迟约 2.5s，界面会提示「已切换轮询模式」）；局域网直连与命名隧道
     下仍为实时 SSE。若需完全实时就绪体验，建议局域网或命名隧道。
3. 自备隧道 / 组网（可选）：用你已有的任何穿透方案（花生壳、frp、SSH 反向隧道、
   Tailscale 组网等）把本机 7788 端口转发出去，手机直接打开
   https://<你的隧道地址>/?t=<令牌> 即可用（令牌从本机设置页复制；二维码此时仍是
   局域网 URL，不含你的穿透地址）。浏览器侧远程则转发 GUI 端口即可（见下方说明）。

⚠️ 隧道地址是公开的，掌机的鉴权唯一依赖 URL 里的随机令牌（页面 / SSE / API
全部要求令牌）——不要转发/截图给无关的人；令牌可在设置页一键重置（全部旧链接
立即作废）。设置「掌机」面板中的隧道配置与令牌重置仅限本机回环操作（局域网/
远程来源打开时为只读并显示提示横幅）。

• ✅ 浏览器侧远程（GUI 本身）：GUI 经隧道/代理访问时，bridge 与设置页走 dsh
  webServer 的同源代理（/phone-remote/*）——只需把 GUI 端口转发到本地，
  全部状态与操作即可工作（VNC / SSH 隧道场景证实可用）。

🔐 安全

• 全部接口（页面 / SSE / 动作 API）要求随机令牌（首次启动生成后持久化于
  ~/.dsh/dsh-gb.token，128 位随机，可经设置页「重置令牌」作废）；/info
  仅限本机回环访问（经 webServer 同源路由对非回环来源脱敏，不含令牌/URL）；
  动作接口收紧 CORS，仅放行同源应用。
• 服务器只监听局域网 0.0.0.0:7788+，不直接暴露公网、无外联行为；公网可达性仅在
  用户显式开启公网隧道（或自备隧道）时由出站连接建立——隧道地址公开，鉴权
  唯一依赖随机令牌；关闭隧道即回到纯局域网。
• 控制端点（隧道配置 /phone-remote/tunnel、令牌重置 /phone-remote/token/reset）
  仅限本机回环，局域网/远程来源一律 403；设置页为只读并显示提示横幅。
• 首次启用隧道时运行时下载 cloudflared 二进制（GitHub 官方 release，可用
  DSH_GB_CLOUDFLARED_URL 换源）——与「零构建 / 无 postinstall」承诺兼容：
  没有构建脚本，下载发生在运行时且可随时关闭。

🧩 架构一览

插件为 host / client 双半部，构建后零运行时依赖：

手机 ──SSE(状态)/POST(动作)──> 局域网HTTP服务器(0.0.0.0:7788+) <──POST/bridge/state── GUI客户端中继
                                    │  ^
                                    └──SSE(bridge/events: 命令)──┘

• Host 半部（lib/index.js + lib/server-core.js）：局域网 HTTP 服务器（手机页 /
  SSE / 动作 API / 令牌鉴权 / CORS），监听 agent/status 与会话事件维护运行态与
  一句话总结；send 动作直接 followup 注入当前会话；另在 dsh 自带 webServer
  注册同源 /phone-remote/info（设置页二维码数据源）。
• Client 半部（lib/client.js，由 lib/client-src.js + lib/qr.js 构建）：
  • conversation.composer.dock 会话槽挂不可见中继：推送审批 / 选择题 / 会话与工作区
    列表到服务器，并执行打开会话 / 连接工作区 / 应答（复用 GUI 同款
    PendingWait.respond）。
  • settings.section 设置页「掌机」：内置 QR 编码器（零依赖）生成动态二维码。

🛠️ 开发与测试

pnpm install                    # 测试依赖：qrcode / jsqr
node scripts/build-client.mjs   # 改 lib/client-src.js / lib/qr.js 后重新打包 client
node test/check-qr.mjs          # QR 编码器 vs node-qrcode / jsQR 交叉校验
node test/serve.mjs             # 服务器核心端到端冒烟（页面 / SSE / API / 令牌 / 导航）
node test/client-bundle.mjs     # client bundle 假装载校验

提交前建议跑 node test/check-qr.mjs && node test/serve.mjs && node test/client-bundle.mjs
三者全绿，并确保 lib/client.js 已重新构建后一起提交。

📄 License

MIT

dsh（DeepSeek Harness）的日记插件：在一个纸感信纸风的 web 页里写日记，原文先落盘、AI 评注后生成——总结失败永远不会丢你的字。

English · 使用指南（装好后页面右上角 ?，或 /diary/guide）

界面预览

日常写作（亮色）	暗色

首次使用·设置卡	内置使用指南（中/EN）

分工

快速上手

git clone https://github.com/zhm20001/dsh-diary.git
cd dsh-diary
pnpm install            # lib/ 产物随仓库提交，无需 build
dsh plugin --profile web add <本目录路径>
# 重启 dsh web，浏览器打开 http://127.0.0.1:<port>/diary

首次打开页面是设置卡：填一个日记目录（如 ~/Documents/日记，~ 会展开），保存即写入插件根 config.json，立即生效、无需重启。然后写第一篇 → 点「保存并生成总结」。

日常流程：打开页面 → 写 → 提交。原文即刻落盘；总结失败不丢原文，点「仅重试总结」补生成。草稿自动存浏览器 localStorage（按日期分键）。dsh web 侧栏底部也有「日记」入口（src/client.js，文案中英自适应）。

配置

三层优先级（高 → 低）：

自定义评注 prompt：「AI 评注模型」选择器旁的 📝 打开 prompt 卡——阅读驱动 AI 评注的系统提示词，可编辑、保存、「恢复默认」；存 config.json 的 summaryPrompt，即时生效（优先级同上表）。保存时校验输出契约：【今日关键词】【一句话总结】【评注】三个标记必须保留（【当日 emoji】行可删，删后当日格子降级绿块）；自定义只影响之后的总结，已写入日记的评注块不变。cordis patch 塞入的坏 prompt 会在总结时响亮报错（不静默回退）。

其余插件项（cordis patch 层）：provider / model（总结模型，默认 deepseek-official / deepseek-chat）、temperature（0.6）、timeoutMs（120000）、nightCutoff（6）、pagePath（/diary；改动需同步 src/client.js 里的 href）、summaryPrompt（评注 prompt 覆盖）。

隐私与数据

• 日记全文只落本地盘；唯一的外发是总结请求：当日全文发给你配置（或页面选择）的 LLM provider，换取四件套。热力图数据、meta、草稿都不出本机（草稿在浏览器 localStorage）。
• 数据自包含在日记目录：正文 YYYY-MM-DD.md，当日 emoji 在同目录隐藏文件夹 .diary-meta/YYYY.json。备份 = 整个目录复制（迁移别漏 .diary-meta/，否则 emoji 静默降级成绿块）。
• 「有没有写」永远由目录文件名当场派生（含 -后缀 文件），不落缓存：手建/手删/改名即时反映到热力图；meta 里的孤儿 emoji 会被无害忽略。

语义细节

• 30 小时制：凌晨 0 点到 nightCutoff（默认 6）之间写的算前一天，收尾时间显示 25:xx–29:xx——深夜补记不会劈成两个文件。
• 同日再提交 = 追加新条目并重新生成整天总结（旧评注块被摘除重写，其上的用户内容永远不动）。约定：不要手工编辑「## AI评注」之下的区域。
• 文件契约：<diaryDir>/YYYY-MM-DD.md，front matter 来自模板（支持空 date: 字段或 {{date}} 占位）；同日 2026-04-28-note.md 这类后缀文件也计入 4-28，同日多文件不重复计数。
• 总结失败时接口返回 stage:'summary' + hint（HTTP 502）；保存失败返回 stage:'save'。
• 热力图板：半年一帧（上=1–6月，下=7–12月），固定 27 周 × 7 格、周一起始，帧窗口从半年首日所在/之前的周一开始，相邻帧共享边缘周（冗余明确允许）。已写=当日 emoji（无则绿块）、已过未写=淡底、未到=灰、今日加描边；分母为该半年实际天数。极少数年份（7月1日逢周日，如 2018/2029）H2 窗口 190 天超出 27 周，12-31 那格不显示（计数不受影响）。
• 往期日记补评注 / 换目录迁移 / 删除某天：见页面内置指南「你的数据」一节。

本地开发

pnpm install
pnpm typecheck
pnpm test               # vitest：core 纯函数 + 路径解析 + 原子写
pnpm build              # 重新生成 lib/（CI 会校验产物与 src 无漂移）

# 冒烟：dev overlay 把插件指向 /tmp/diary-sandbox，不污染真实日记
dsh web --patch dev.patch.yml   # 浏览器访问 /diary-dev

结构：src/core.ts 纯函数（无 IO）→ src/paths.ts 路径变量（config.json 读写）→ src/service.ts 路由与编排（webServer/httpServer 双名兼容）→ src/summary.ts LLM 管线 → src/page.ts 页面 + src/guide.ts 指南。lib/ 为编译产物、随仓库提交（克隆分发免构建）；src/ 改动必须带 lib/ 一起提交。

宿主要求：dsh web 宿主（内部 harness 版暴露 ctx.webServer，npm @deepseek-ai/dsh-host-webserver rc 线暴露 ctx.httpServer——两者均兼容）。

License

MIT

DeepSeek Harness 归档会话管理器（DSH Plugin）。

在 设置 → 归档会话 中列出所有已归档会话，并支持一键恢复——恢复后会话立即回到侧边栏会话列表，无需重启。

为什么需要它

DSH 0.1.1-rc.2 的"归档会话"是单向设计：右键会话只能归档，官方没有提供取消归档 / 恢复的界面或接口。本插件补上这一块：

• 查看：列出所有归档会话（标题、创建时间、所属工作区）；
• 恢复：一键把会话移出归档名单，会话即时回到会话列表（通过宿主 domain 变更广播，无需刷新页面）。

安装

发布到 GitHub 后：

dsh plugin --profile web add git+https://github.com/zengcj-dev/dsh-archive-manager.git

本地路径 / tarball 安装：

dsh plugin --profile web add "file:E:/dsh-archive-manager/dsh-archive-manager-0.1.0.tgz"

安装完成后重启 dsh web，打开 设置 → 归档会话 即可使用。

使用

1. 进入 设置 → 归档会话，页面列出所有已归档会话；
2. 点击某会话右侧的 恢复 按钮；
3. 会话立即回到侧边栏会话列表，历史内容完整保留。

工作原理

• 插件在设置页注入一个 settings.section 分区（DSH slots 机制）；
• 服务端注册两条同源路由：
  • GET /plugins/dsh-archive-manager/list —— 读取 workspace 注册表的归档名单并附上会话元数据；
  • POST /plugins/dsh-archive-manager/unarchive —— 通过 workspace 注册表的持久化状态机把会话 id 移出归档名单（0.1.1-rc.2 未提供公开 unarchive API，此实现绑定该版本的内部接口）；
• workspace 域名变更会触发宿主广播 host/archived-sessions-changed，前端会话树即时刷新。

兼容性

⚠️ 恢复功能调用了 DSH 0.1.1-rc.2 的内部接口（workspaceRegistry.setState）。升级 DSH 后可能需要适配；若 DSH 后续版本提供官方 unarchive API，建议改用官方接口。

开发

plugin/
├── package.json        # dsh 插件清单（dsh.bundle / dsh.client）
├── cordis.patch.yml    # bundle patch：插入插件入口
├── lib/index.js        # 服务端：http 路由（list / unarchive）
└── client/client.js    # 浏览器端：设置页"归档会话"分区（手写 bundle）

无构建步骤：服务端 ESM 直接运行，浏览器 bundle 手写（__ModuleLoader__.load 格式），无需 tsdown/tsc。

许可

MIT

© 2026 zachshi-ai · 保留所有权利 · 仅限学术研究与非商业性使用,禁止任何商业用途;商业授权需作者书面许可。

一门老思想，能不能精确地解决人工智能的一个真实问题？

每个项目走同一条完整生命周期：明确谁在什么场景下的什么问题 → 定价值 → 设计 → 定验收标准 → 落地 → 自动化验证 → 文档。每个点子都是可运行、可测试的成品，不是 PPT。

项目索引

| 30 | 防川 · fangchuan | 《国语·周语上》 | Agent 吞错入码（运行期报错之口无账）：agent 写代码时为了「这单活不炸」，把报错之口一只一只堵上——加载失败 catch (e) { }、校验异常 except: pass、网络失败 .catch(() => null)、catch { return; }；测试是绿的（吞形不炸测试），任务宣告完成，代码上库——错误从「报出来」变成「咽下去」，异常状态静默累积，炸点在下游，排障时连「当时错没错、哪一行咽的」都无处问起——乡校审开发期批评通道（@ts-ignore/eslint-disable）却管不到运行期，直笔审会话流内命令记录（|| true）却管不到交付代码内容，法仪审验收器却管不到器外产物；运行期报错之口是三层的空白地（防民之口，甚于防川；川壅而溃，伤人必多，民亦如之——被吞掉的错误不会消失，只在下游以更贵的姿势爆炸） | 给 DeepSeek Harness 装上「防川」层：湮形 6 形（空捕 catch (e) { }/空还 catch { return; }/空接 .catch(() => null) 等 4 写法/单行空捕 except: pass/多行空捕 except 体全空/Ruby 空救，无册照判、开箱在岗）、导词表 12 词（体内有 console./throw/logger/print( 等即清白——决之使导，return null 降级决策不判宁纵）、码面豁免（文档与数据后缀 10 + .min. + __snapshots__/ 在立案前——讲堂不是川）、文账以末文为准（考其末文：先写吞形后改净的径是已浚注记 0 分；edit 族无文之写不改末文 gauge 注记；exec 落点文面不可见沙川注记）、川册纵列（indulge glob 免扫 best-effort 静默层，声明权在任务方，无册=全扫）、塞值分带门禁（min(60,15×湮案)，宣 0–14/淤 15–29/塞 ≥30，门 30——单湮案黄牌不咬门、两案即红）、导牌块接缝供给（湮形公示+川册公示+逐处点名 径:行:形，逐字节确定，永不携带命中行原文）；乡校审一声、防川审一川——一声一川；直笔审一笔、防川审一川——一笔一川；法仪审一器、防川审一川——一器一川；考诚考一契、防川扫一川——一契一川；知行审一知、防川审一川——一知一川；恒法审一门、防川审一川——一门一川；零 LLM、结构性零拦截 | DeepSeek Harness 防川式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 71 tests，真实 dsh-tools 管道集成验证 |
| 31 | 平准 · pingzhun | 《盐铁论》 | Agent 依赖面自便（命脉籍面改动无账）：agent 被依赖问题卡住时顺手解围——往 package.json 添一个新包（每难必附）、把 "a": "1.2.3" 松成 "^1.2.3"（去锁过关）、往 requirements 顶上加一行 -i https://某镜像（移源）、往 scripts 埋一只 postinstall（埋钩）；每一笔都让这单活变绿而籍册上库——幻名写进籍册则次次必装（名实只记装成之一次事件），供应链面静默扩大、可复现性静默漂移，而「谁在何时添了什么附、松了哪把锁、移了哪个源、埋了哪只钩、任务方授没授权」全仓无账——恒法显式让渡了杂糅文件（package.json/pyproject「既装依赖又载章程，v1 宁纵登记」），籍面正是那块空白地（盐铁者，天地之藏；浮食奇民，好欲擅山海之货——必需而外供之物，谁都能顺手多取一勺） | 给 DeepSeek Harness 装上「平准」层：籍面 22 形（npm 7 ∪ Python 6 ∪ Rust 2 ∪ Go 2 ∪ Ruby 2 ∪ PHP 2，basename 全等 + requirements 名前缀形，无册照判、开箱在岗）、四案词法（增附：npm/composer JSON 深判四节两节 ∪ requirements 行级，旧本全集所无 +15/名；去锁：同附名精确→范围或脱钉 +10/名，精确→精确递进与删附不判；越源：五族源词〔requirements 行旗标/publishConfig.registry/composer repositories/pyproject uv.index·poetry.source/Gemfile source〕×宿主非默认域〔相等或子域〕+30/处；钩入：scripts 新增 preinstall/install/postinstall/prepare +30/键，旧本已有不判——护钩）、面案取新增·递案无底本不判（旧本取流内：先前带 content 之写 ∪ observe 成功读取之正文；籍无底本/籍不成谱注记）、命籍纳籍（admit glob 免账 ∪ extra 增形，声明权在任务方，无册=全账——名山大泽不以封）、准值分带门禁（min(60,30×越)+min(60,30×钩)+min(60,15×增)+min(60,10×锁)，平 0–14/偏 15–29/倾 ≥30，门 30——单源单钩即红、两附即红、单附黄牌不咬门）、准牌块接缝供给（籍形+命籍公示+逐案点名 径:行:案别，逐字节确定，永不携带命中行原文与 spec 值）；恒法审一典、平准审一籍——一典一籍；名实记一装、平准审一籍——一装一籍；水土审一境、平准审一籍——一境一籍；知足量一写、平准审一籍——一量一籍；防川扫一川、平准审一籍——一川一籍；零 LLM、结构性零拦截 | DeepSeek Harness 平准式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 77 tests，真实 dsh-tools 管道集成验证 |
| 32 | 成事 · chengshi | 《论语》 | Agent 外发重决（已遂之施的再施无账）：agent 被授权对外行使——建档、发声、非幂等 POST——第一笔已经落地，但 agent 没看见成功（超时被记失败、循环重扫队列、断点续跑重放半途计划、「为保险再跑一遍」），第二笔照样落地：第二个 PR、第二条一模一样的评论、第二封邮件、第二笔扣款，全部是已经发生的世界事实——它们不在 git diff 里（世界在仓库之外），第二笔还往往同样「有授权」（授权层只看授没授，看不见重复），而「哪件事做了两次、第二次何以又施、第一次的完成为什么不算数」三问在所有相邻层的账本上都无处问起（成事不说，遂事不谏，既往不咎——要让已遂之事不被翻出来重做，先得有一本账记着它是遂的；幂等键是支付与网关协议的行业标准，agent 流里没有对应物） | 给 DeepSeek Harness 装上「成事」层：遂面锁死（唯 exec 族成功 ∧ 命中遂形 15 形三族〔启 7：gh 建档/评论/发版/片/标/api 显默 POST；邮 5：mail/mailx/sendmail/mutt/msmtp；单 3：curl/wget 显默 POST、httpie POST〕，无册照判、开箱在岗；isError=true 失败不遂、null 老流按已发生；发布类同版自守、terraform/PUT 收敛自愈、git push 重复是推进——排除即边界）、遂账同串并键（遂键 = 段规整命令串保原大小写，变参不入键宁漏）、判定序锁死（豁 > 消 > 承 > 重决 +30/案 cap60 > 首笔恒初遂；消据 = 消词 11 词 ∧ 成物之柄〔首笔遂 content 首个 URL 路径末段资源号〕，跨会话有效——消了再施是新决，既往不咎；末消只注记不销案——世界已双生，凭消只证知悔）、承施两通道（同会话主渠道再命：对象词元 ∨ 命词 12 词 ∧ principal 后首笔遂——新命开新决；运行时无主文照判重决出注记，终裁归线下全流审计）、遂册允列（allow glob 免案——轮询心跳类任务方明言可再施，声明权全在任务方，无册照判）、重值分带门禁（min(60,30×重决)，谐 0–29/叠 30–59/沓 ≥60，门 30——单重决即红，双生之物是已经发生的世界事实）、遂牌块接缝供给（遂形+遂册公示+逐键遂名〔形词+djb2 指纹〕清点，逐字节确定，永不携带命令原文与实参——掩码是结构性保证）；二柄一柄一遂（erbing 双跑 terraform 夹具喂本层零案——排除即边界）；有涯一费一害（写间不断罪恰是本层靶点）；九变一败一成；捭阖一出一施；定分一域一世；立诚一诺一施；论世一权一世；零 LLM、结构性零拦截 | DeepSeek Harness 成事式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 60 tests，真实 dsh-tools 管道集成验证 |
| 33 | 画水 · huashui | 《百喻经·乘船失釪喻》 | Agent 陈据覆新（落笔之鲜无账）：长会话里 agent 早段读入的文件副本是它在流动水面上作下的记号——几十步之后凭这份旧副本整卷重写，覆掉自己早先落盘的中变、或另一个会话其间写入的修复；覆写本身是合法写入，测试照跑（少的是修复不是功能）、diff 照交，全绿无声，炸点在下游，而「哪一笔写以哪份旧底落了地、其间之变还在不在、重读发生在写前还是写后」三问全仓无账（我今画水作记，舍之而去后当取之；水虽不别，汝昔失时乃在于彼，今在此觅何由可得） | 给 DeepSeek Harness 装上「画水」层：文据唯二（observe 成功 ∧ 正文非空 → 读据；write 成功 ∧ args.content 非空 → 写据；无文之写只留无文之痕隔断判定；isError 不入账；exec 黑盒；无默认形表，凡 p: 径皆受审）、三序判定（变写=陈写前最近异文写据〔等文不取〕、旧据=变写前最近异文文据〔读写皆可〕、行集差集陈线/新线）、判定序锁死（无文据静默 > 隔断陈改不判〔有变写看 m→j 窗、无变写看最后文据→j 窗〕 > 无变写无旧据静默 > 覆世 +30/案 cap60〔变写出自他会话，唯合审可见——at 归并〕 > 覆己 +15/案 cap40〔变写出自本会话，单流即判〕 > 失鲜注记〔陈线=1 新线≥1〕 > 保新线不罚〔并集式重写非覆，纯增/纯删之中变净向不罚〕）、案前曾重读随案注记不改分（明覆盲覆记入点名）、水册许复（excuse glob 立案前免账，git 词面复古天然白，声明权在任务方，无册=全账）、陈值分带门禁（min(60,30×覆世)+min(40,15×覆己)，活 0–14/滞 15–29/腐 ≥30，门 30——单覆世即红、双覆己即红、单覆己黄牌不咬门）、水牌块接缝供给（水册公示+案账清点+逐案点名径:seq:行数，逐字节确定，永不携带行原文——掩码是结构性保证）；写前重读则白（行集含新线，谓词自白——账本结构性地奖励重读）；结构性零拦截 | DeepSeek Harness 画水式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 66 tests，真实 dsh-tools 管道集成验证 |

| 34 | 约法 · yuefa | 《史记·高祖本纪》 | Agent 公共接口面收缩（读时之约无账）：agent 重构时读入模块看见全部公共导出，落笔顺手删掉两个——测试不覆盖（死代码盲区）、编译若放行则全绿上库，下游 import 当场炸开；cargo-semver-checks/api-extractor 都是构建时快照工具，对不出「这一笔写削的是它读时看见的哪几个名、削得有没有声」——知情只发生在流内那次读取上，而「削约有没有声」在任何一层的账本上都无处问起（与父老约，法三章耳：杀人者死，伤人及盗抵罪；余悉除去秦法——削法是当众明言的，没有一个旧法该「无声失效」） | 给 DeepSeek Harness 装上「约法」层：约据唯读（observe 成功 ∧ 正文非空 → 读时立约；没读过就无约可言——盲写归他层）、约形词法默认 15 形（JS/TS export 六式 ∪ Python def/class/all ∪ Go 大写 ∪ Rust 裸 pub）+ 花括号跨行形 as 取后名 + 册增形，_ 前缀 Py 不入面、pub(crate) 不收——约外不治、世据折旧（约据与落笔间最近写据之面折旧约面——他人已削不记本笔，保持者不罚）、判定序锁死（无约静默 > 间有痕约改不判 > 削名 ∅ 静默 > 弃词同行查明削：明削 0/哑削 +30/名 cap60）、约册许削（allow glob 立案前免账，声明权在任务方，无册=全账）、削值门禁（min(60,30×哑削名)，坚/渝/背，门 30——单哑削名即红）、约牌块接缝供给（逐字节确定，永不携带行原文）；记账不禁行，结构性零拦截 | DeepSeek Harness 约法式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 70 tests，真实 dsh-tools 管道集成验证 |
| 35 | 扫屋 · saowu | 《后汉书·陈蕃传》×清·刘蓉《习惯说》 | Agent 调试残迹留场（行内之垢无账）：agent 排障时撒下调试探针——console.log("DEBUG: …")、debugger;、breakpoint()、binding.pry、set -x——问题修完探针全数留场照常宣布完成；debugger; 落进生产前端浏览器当场挂死、breakpoint()（PEP 553）阻塞服务进程、带标记的打印把内部中间态写进生产日志；lint 工具链早造好了扫帚（ESLint no-console/no-debugger、RuboCop Lint/Debugger、pre-commit 官方 debug-statements hook——业界对此病的结构性招供），但规则可以被静音、可以不在器册、可以在调试发生时根本没跑，而「当时撒没撒、末卷还剩没剩」只发生在会话流内——「撒了什么、剩没剩、留得有没有名分」在任何一层的账本上都无处问起（一室之不治，何以天下家国为；久而遂安之，习之中人甚矣哉） | 给 DeepSeek Harness 装上「扫屋」层：帚账唯写（write 族成功 ∧ content 非空 → 末笔为末卷，扫末卷出案；观察不入账——读取不撒垢；isError 不入账；exec 黑盒）、垢形词法（针形默认 10 形：debugger/breakpoint(/set_trace/import pdb/binding/byebug/dbg!/set -x/console.trace ∪ 屑两路：打印原语 12 × 标记形 9 大写词界同行共现 ∪ 探针注释形 // debug: 独立在场；console.error 与 logger.* 不在原语表——与防川的清白词词面和谐）、判定序锁死（留册 retain ∪ 试验场名段正则形 10 立案前豁免 > 无末卷静默 > 扫末卷一处一行针优先 > 已扫注记〔先撒后扫净向 0 分〕> 帚账不前注记〔末卷后无文之痕，案照出账止于末卷〕）、留册许留（retain glob 立案前免账，声明权在任务方，无册=全扫——正当之留必须明言）、垢值门禁（min(60,30×遗针)+min(40,15×遗屑)，洁/蒙/垢，门 30——单针即红、双屑即红、单屑黄牌点名不咬门）、帚牌块接缝供给（留册公示+案账清点+逐处点名 径:行:形，逐字节确定，永不携带行原文）；记账不禁行，结构性零拦截 | DeepSeek Harness 巡扫式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 71 tests，真实 dsh-tools 管道集成验证 |

| 36 | 市虎 · shihu | 《战国策·魏策二》 | Agent 状态陈报虚功（交接成报无账）：会话收工写 HANDOFF.md——「- [x] 修复 src/b.js」「npm test 全绿」，下一个会话照单全收按假状态决策；「写这条声明的会话自己的流里动过手吗」一查便知，而文书与流两处从来没对过账——等炸点在下游浮现，邯郸去大梁也远于市（夫市之无虎明矣，然而三人言而成虎；王信之，因为说的人够多、文书够正式） | 给 DeepSeek Harness 装上「市虎」层：状面唯写（write 族成功 ∧ 正文非空 ∧ 径命中状面形默认 5 形〔HANDOFF 全等∪名含 handoff∪径段∪名含交接〕∪ 册 shapes 增形 → 状面入账；观察不入账——读来的状态不是写的状态）、作工面（本会话 exec 命令原文成败皆入〔试错也是始〕∪ 写径 ∪ 读径——不含正文；按会话分账）、状形词法（勾选形 [x] ∪ 中文状词 11 ∪ 英文状词 4 ∪ 里程碑形 ∪ 旗标形；未勾选与将来时不中）、判定序锁死（exempt 径免 → 引用署名掠据 0 → 状键任一词元命中作工面有据 0 → 全查无虚功 +30/条 cap60 单条即红 → 无键注记 0）、状册豁免（exempt glob 立案前免账，声明权在任务方，无册=全账）、虎值门禁（min(60,30×虚功条)，真/疑/虎，门 30——单虚功条即红）、状牌块接缝供给（径:行号:状键点名，逐字节确定，永不携带行原文）；自态自证——他会话的作工救不了本会话的虚报；记账不禁写，结构性零拦截 | DeepSeek Harness 市虎式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 66 tests，真实 dsh-tools 管道集成验证 |
| 37 | 揖盗 · yidao | 《三国志·吴志·吴主传》 | Agent 遇阻拆锁（守门开关被关无账）：agent 写 API 客户端遇 curl 报证书错误就写 verify=False、Node 报验签失败就上 rejectUnauthorized: false 或 NODE_TLS_REJECT_UNAUTHORIZED=0、fetch 被跨域拦下就 origin: "*"——证书错误消失了，这单活绿了，拆的不是障碍是防线：中间人与恶意响应畅通无阻；一行 diff 混在几百行里几乎不可分，SAST 扫得到现状却答不出「这行锁是哪一笔写、在遇到什么阻之后拆的、拆得有没有名分」——归因只发生在会话流内（况今奸宄竞逐，豺狼满道……是犹开门而揖盗，未可以为仁也——为眼前一哀开门，进来的是满道豺狼） | 给 DeepSeek Harness 装上「揖盗」层：弱锁形 12（验锁 10 ∪ 网锁 2 单行正则，一处=一行=一案，无后缀门凡写卷皆受审）∪ 阻账（exec 族逐笔全记不问 isError 旗——败相在文不在旗；exec 落盘黑盒不判）∪ 拆锁窗（尾笔前近十笔入账内阻账正文命中同族阻词 → 遇阻 +30/处 cap60 单案即红——拆锁与所遇之阻对见；否则素拆 +15/处 cap40 黄牌不咬门）∪ 复锁注记（先前写过形、尾文改净 0 分——先拆后合的门不算开的门，扶令上马有赏）∪ 校场（tests/mocks/fixtures 等 10 名段正则立案前豁免——演武之地不设门禁）∪ 锁册免拆（excuse glob，声明权全在任务方，无册照判）∪ 锁值分带门禁（min(60,30×遇阻)+min(40,15×素拆)，扃 0–14/倚 15–29/洞 ≥30，门 30）∪ 锁牌块接缝供给（锁册+形表公示+逐案点名 径:行:形 与窗内阻词，永不携带尾文行原文与败笔正文——掩码是结构性保证）；观察永不反噬 | DeepSeek Harness 揖盗式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 65 tests，真实 dsh-tools 管道集成验证 |
| 38 | 矫托 · jiaotuo | 《汉书·傅常郑甘陈段传》 | Agent 伪据虚引（落卷之引无账）：agent 写报告/交接书/commit message——「AGENTS.md 规定『X』」「Per AGENTS.md, the rule is "Y"」而所托之文里根本没有这句话；伪据比无据更毒——自带权威外观，下游对着假依据决策；法律 AI 编造判例（Mata v. Avianca 律师被法院制裁）是此病的社会级事故，multi-agent 转述凭空增发「任务要求」是家常形态；「这句引语在原文里吗」三秒可查却从来无人查，事后连「引的哪句、原文有没有、有没有人核过」都无处问起（汤独矫制发兵——矫者托也，所托之制非天子所出；上疏自劾奏矫制——托要当众核，渐不可开） | 给 DeepSeek Harness 装上「矫托」层：引形 25（文书型 16〔规定/章程/任务书/写明/明言/明确指出/条例/守则/依据 ∪ per/according to/as stated/as defined in/as noted in/as documented in/as specified〕∪ 泛型 9〔要求/明确要求/遵照/约定 ∪ as required/as mandated/required by/mandated by/as per〕，英文词界、文书型先于泛型）∪ 引语三式（中文「」『』∪ 英文双引 ∪ 单引撇号防御，原文 ≥4 字符，嵌套取内——-m "per X: require '…'" 只判内层）∪ 诏账（observe result.content ∪ write args.content 皆生诏本，后写覆盖前写；write 先判后录不以本笔自证）∪ 判定序锁死（径级豁免 → 无引形静默 → 托主注记 → 引语对〔指名诏本查无 = 矫引 +30/案 cap60 单案即红、命中 = 征引 0；指名无本 = 阙据注记；未指名全库并查〕→ 改写式〔指名词元过半查无 = 佚据 +15/案 cap40 黄牌、过半命中 = 征据；未指名 = 泛引注记〕）∪ 词元对账（CJK bigram ∪ 英文词元，总数 ≥2 方判，命中比 0.5 为界）∪ 诏册免案（excuse glob，声明权在任务方，无册照判）∪ 矫值分带门禁（min(60,30×矫引)+min(40,15×佚据)，信 0–14/疑 15–29/矫 ≥30，门 30——单矫引即红、双佚据即红、单佚据黄牌不咬门）∪ 矫牌块接缝供给（诏册公示+案账清点+径:行:案别:引语指纹，逐字节确定，永不携带引语原文与诏本正文）；观察永不反噬 | DeepSeek Harness 矫托式插件（Cordis，结构性零拦截）+ 零依赖审计 CLI + Agent Skill | ✅ 66 tests，真实 dsh-tools 管道集成验证 |

方向登记

为避免撞车，每个新项目开工前先对照此表：方向不得与已有项目重复。

选书标准

1. 思想层面：哲学 / 管理学 / 佛学 / 道家等经典；
2. 能逐条映射到 AI 领域的某个真实失败模式，映射不牵强；
3. 产出的产品可运行、可测量、可证伪。

许可

各项目目录内单独声明。zhizhi、jiebi、zhengnian、weibing、jiubian、youya、lunshi、dingfen、baihe、fayi、zhibi、yuli、duzhi、erbing、zhongshi、xiaoyan、mingshi、jiyi、xiangxiao、zhizu、shenqu、shefa、yuanyu、shuitu、kaocheng、hengfa、zhixing、fangchuan、pingzhun、chengshi、huashui、yuefa、saowu、shihu、yidao 与 jiaotuo 均采用 MIT。

English

源码仓库：yuandian-ailaw/yuandian_dsh_plugin · DeepSeek Harness

huayu-yuandian-legal-data 将元典开放平台的聚合 MCP 入口接入 DeepSeek Harness，并随包提供法规、案例、企业和证券合规 4 个官方 Skill。

当前版本：0.1.5。兼容 DeepSeek Harness >=0.1.2-rc.1 <0.2.0，要求 Node.js >=22.19.0。

项目原创代码采用 MIT License；随包 Skill 和品牌 Logo 使用单独授权，不属于 MIT License。完整边界见 LICENSES.md。

安装后，DeepSeek Harness 的设置页会出现“华宇元典法律数据”入口，并展示随包分发的品牌 Logo；内部包名继续使用 huayu-yuandian-legal-data。

能力与边界

• 默认连接 https://open.chineselaw.com/mcp，一次授权发现聚合入口的全部工具。
• 设置页提供 OAuth 与 API Key 两种认证方式；安装和首次加载不要求认证，用户选择后才发起连接。
• OAuth 采用 Authorization Code + PKCE S256，支持动态客户端注册、refresh token、RFC 8707 resource indicator 和本机 loopback 回调。
• MCP 工具以 mcp__yuandian__<原始工具名> 注册；不合规或超长名称会附加稳定哈希。
• 非本机 MCP endpoint 强制使用 HTTPS；HTTP 仅允许 loopback 开发地址。
• 支持有界工具分页、重复 cursor 检查、notifications/tools/list_changed、整代恢复、有界指数退避重连、调用超时和取消。
• 当前只桥接 MCP tools，不桥接 resources 和 prompts。
• 运行中需要重新授权时，已经失败的工具调用不会自动重放，避免重复执行有副作用的操作；连接恢复后由用户重试。

安装

从本地目录安装

dsh plugin --profile web add /absolute/path/to/huayu-yuandian-legal-data
dsh --profile web --dump-config

从 tarball 安装

作者侧生成包：

pnpm install
pnpm pack

用户侧安装：

dsh plugin --profile web add /absolute/path/to/huayu-yuandian-legal-data-0.1.5.tgz

公开仓库 CI 会在 Linux、macOS 和 Windows 上执行质量门禁，并用 pnpm pack --dry-run 校验包内容；CI 不会自动发布 npm 包或创建正式制品。正式制品只由维护者按 RELEASING.md 发布。

获得维护者发布的 .tgz 与 .sha256 后，先在两者所在目录验证摘要：

# macOS
shasum -a 256 -c huayu-yuandian-legal-data-0.1.5.tgz.sha256

# Linux
sha256sum -c huayu-yuandian-legal-data-0.1.5.tgz.sha256

从源码安装时应固定公开仓库的 commit SHA，并只对可信源码授权构建。tarball 已包含构建产物，不需要安装时构建授权。

卸载：

dsh plugin --profile web remove huayu-yuandian-legal-data

认证配置

设置页右上角的“认证配置”入口支持：

• OAuth 认证：开始授权、从 API Key 切换至 OAuth、清理现有状态后重新授权，或经二次确认取消本机授权。
• API Key：保存、替换或移除 Key；已保存的明文永不回显，也不会进入插件配置和日志。

默认 bundle 使用自动认证模式：

endpoint: https://open.chineselaw.com/mcp
serverName: yuandian
auth:
  mode: auto
  callbackPort: 1455
  openBrowser: true
  timeoutMs: 300000
httpTimeoutMs: 60000
toolCallTimeoutMs: 60000
failOnStartupError: true
reconnect:
  enabled: true
  initialDelayMs: 500
  maxDelayMs: 30000
  maxAttempts: 10

自动模式下，插件安装和首次加载时若没有任何凭证，会保持未认证待机状态：不打开浏览器、不请求 MCP，也不影响 Harness 启动。用户在设置页点击“开始 OAuth 授权”或保存 API Key 后，插件才会立即建立 MCP 连接，无需重启 Harness。已有 API Key 或可静默复用的 OAuth Token 时，后续加载会自动连接；OAuth Token 失效且无法刷新时会回到未认证待机，不会在 dsh web 启动阶段自动打开授权页。

已授权时可在 OAuth 页签选择“取消授权”。确认后插件会删除 Harness 本机凭证服务中的 YUANDIAN_MCP_OAUTH、授权完成标记和进行中的授权尝试：若另有 API Key 则切换到 API Key，否则断开 MCP、注销已发现的工具并回到未认证待机。当前元典 OAuth metadata 未公布 Token 撤销端点，因此该操作不表示服务端 Token 已立即吊销，远端 Token 可能继续有效至自身过期。

设置页会用 YUANDIAN_MCP_OAUTH_START 标识当前 OAuth 尝试；该引用不包含 Token 或其他秘密。授权完成、拒绝、失败或超时后，后端会清除它；重新发起授权会覆盖并终止旧尝试。YUANDIAN_MCP_OAUTH_AUTHORIZED 只表示 Token 已成功写入，设置页不会再把 discovery、动态客户端注册或 PKCE 中间状态误报为已授权。

OAuth 首次授权时会：

1. 发现元典 OAuth metadata 并动态注册 public client。
2. 仅在 127.0.0.1 的配置端口监听 /oauth/callback。
3. 打开系统浏览器；打开失败时在日志中输出可复制的授权地址。
4. 严格校验回调 method、path、state、OAuth error 和超时。
5. 将 client information、Token、PKCE verifier 和 discovery state 序列化到 YUANDIAN_MCP_OAUTH 凭证引用。

DSH 本地凭证提供方通常把该引用存入 $DSH_HOME/.credentials.yaml，并负责 0600 权限和原子写入。不要把该文件、Token 或浏览器回调地址提交到仓库。

修改回调端口时，端口必须为 1..65535；插件始终使用精确 redirect URI http://127.0.0.1:<port>/oauth/callback。默认授权等待 300 秒。

固定认证模式（高级配置）

如需在服务器或 CI 中强制只使用 API Key，可在 profile 的 cordis.patch.yml 中覆盖插件行。DSH patch 会整体替换该行的 config，因此需要重述完整配置：

- id: huayu-yuandian-legal-data
  config:
    endpoint: https://open.chineselaw.com/mcp
    serverName: yuandian
    auth:
      mode: api-key
      credentialRef: YUANDIAN_API_KEY
    httpTimeoutMs: 60000
    toolCallTimeoutMs: 60000
    failOnStartupError: true
    reconnect:
      enabled: true
      initialDelayMs: 500
      maxDelayMs: 30000
      maxAttempts: 10

凭证值不要写进 patch。可在启动 DSH 的环境中提供：

export YUANDIAN_API_KEY='你的元典 API Key'
dsh --profile web

插件解析该 credential 引用，并仅在 MCP HTTP 请求中发送 Authorization: Bearer <API Key>。固定 oauth 模式仍受支持，其字段与自动模式中的 OAuth 字段相同，只需将 oauthCredentialRef 改为 credentialRef。

数据、费用与隐私

• MCP 工具调用会把检索参数发送到配置的元典开放平台 endpoint；不要在查询中放入与法律检索无关的秘密或个人敏感信息。
• 元典开放平台账号、订阅、调用额度、计费和服务端数据处理受平台自身条款约束，本插件不改变这些约束。
• 插件自身不增加独立遥测；DeepSeek Harness 和运行环境的日志、网络与遥测策略仍由对应组件控制。
• 工具返回的法律数据应结合来源、时效和适用范围复核，不构成未经专业人员复核的法律意见。

内置 Skill

Skill 保留官方正文，只修复上游 ZIP 中非法 YAML frontmatter，并增加 DSH 聚合入口和工具名映射说明。同步日期、ZIP 路径和 SHA-256 记录在 skills/upstream.json。

Skill 交付边界

DeepSeek Harness 必须读取完整 Skill 正文才能发现并执行这些能力，因此 4 份 SKILL.md 会以明文进入安装包。构建转换或在客户端运行时解密都不能阻止已获得安装包的用户读取正文，本项目不把这些措施表述为 Skill 保密。

当前交付策略明确接受这一边界：经权利人确认，4 份 Skill 允许随安装包公开分发并发布到公开制品渠道。如果未来要求 Skill 正文对终端用户保密，必须停止随插件分发 Skill，并把相应流程迁移到受控服务端。

故障排查

• 回调端口已占用：修改 auth.callbackPort，重新启动后再次授权。
• 浏览器没有打开：复制日志中的授权 URL；不要把 URL 分享给他人。
• 授权被拒绝或 state 不匹配：关闭回调页并在设置页重新发起授权，无需重启插件。
• 授权等待超时：默认 300 秒；重新启动授权，必要时增加 auth.timeoutMs。
• OAuth 凭证损坏或服务端拒绝 refresh token：插件会清理失效分区并重新授权；仍失败时移除 YUANDIAN_MCP_OAUTH 凭证引用后重试。
• 取消授权后仍需使用：重新打开“认证配置”，再次发起 OAuth 授权或保存 API Key；取消授权仅清理本机 OAuth 凭据。
• API Key 未配置：在设置页保存 Key；固定 API Key 模式则确认启动环境包含与 auth.credentialRef 同名的非空值。
• 设置页显示未认证：这是首次安装的正常待机状态；选择 OAuth 或保存 API Key 即可启用数据能力。
• 401：OAuth 模式先刷新 Token，refresh 失效则重新授权；API Key 模式请检查 Key 是否有效、启用且有 MCP 权限。
• 工具列表更新失败：列表请求失败时保留上一代；注册冲突时回滚新一代并尝试恢复上一代工具。
• 连续断线：按配置有界退避重连；预算耗尽后注销工具，重启 Host 或热重载插件可重新开始。

日志使用中文诊断信息，不输出 API Key、access token、refresh token、authorization code 或 PKCE verifier。

开发与验收

pnpm install
pnpm check
pnpm test:coverage
pnpm build
pnpm verify:artifact
pnpm pack --dry-run

测试默认使用内存凭证、假 OAuth 服务和本地假 MCP HTTP 服务，不依赖真实账号。真实 OAuth 冒烟测试需要用户在浏览器登录元典并确认授权。

许可与第三方内容

• 本项目有权许可的原创代码采用 MIT License。安装包包含单独授权内容，因此 package.json 使用 SEE LICENSE IN LICENSES.md，不把整个包误标为 MIT。
• MCP 服务与 Skill 来源：元典开放平台及本地 api/frontend/public/downloads。
• MCP 工具桥接的命名、同步和连接监督语义参考 DeepSeek Harness 的 MIT 实现。
• skills/ 中的元典官方 Skill 及其他第三方内容不因本项目采用 MIT License 而自动变更许可；其权利仍归各自权利人所有。
• 完整适用边界见 LICENSES.md，详细来源与第三方许可见 THIRD_PARTY_NOTICES.md。
• 本包当前保留 private: true，不执行 npm 发布；经权利人确认，4 份元典官方 Skill 允许随本项目公开分发。

DeepSeek Harness (DSH) 代码图谱可视化插件 — 将 dsh-codegraph 与 dsh-tool-lens 数据源聚合为交互式代码关系图谱

概述

DSH CodeGraph Visualizer 是一个 DeepSeek Harness 生态插件，填补了代码关系图谱可视化领域的空白。它将 dsh-codegraph（CodeGraph CLI 封装工具）和 dsh-tool-lens（AST 代码图谱与拓扑分析）两个数据源的输出聚合、转换，并通过 Cytoscape.js 渲染为交互式代码关系图谱面板，嵌入 DSH Web UI 侧边栏。

核心能力

• 多数据源融合 — 同时接入 dsh-codegraph 与 dsh-tool-lens，自动合并去重
• 渐进式层级聚合 — 目录级 → 文件级 → 函数级 三层聚类，逐层展开
• 4 种布局引擎 — Cose（力导向）、Dagre（层次）、Circle（环形）、Grid（网格）
• 交互式分析 — 符号搜索、调用链追踪、循环依赖检测、影响分析、继承层次
• 实时增量更新 — 文件监听 + 事件驱动，代码变更后图谱自动刷新
• 导出能力 — PNG / SVG / JSON 三格式导出
• 中英双语 i18n — 完整国际化支持
• 主题切换 — 深色/浅色主题，自动适配 DSH 环境变量

安装

前置条件

• Node.js >= 22.19 或 >= 24
• pnpm >= 9
• DSH Web 环境（dsh web）

通过 DSH 插件管理安装（推荐）

# 安装插件（两种方式均可）
dsh plugin --profile web add github:xuanyuanchumo/dsh-codegraph-visualizer
dsh plugin --profile web add xuanyuanchumo/dsh-codegraph-visualizer

# 卸载插件
dsh plugin --profile web remove dsh-codegraph-visualizer

安装完成后启动 DSH Web 即可在侧边栏看到 "Code Graph" 标签页：

dsh web
# → http://localhost:3080，点击侧边栏 "Code Graph" 标签页

从源码构建（开发者）

git clone https://github.com/xuanyuanchumo/dsh-codegraph-visualizer.git
cd dsh-codegraph-visualizer
pnpm install
pnpm run build

# 将构建产物安装到 DSH
dsh plugin --profile web add /path/to/dsh-codegraph-visualizer

快速开始

开发模式

# 启动自包含的 dev server（模拟 DSH Web Shell + 模拟数据）
pnpm run dev
# → http://localhost:3080

运行测试

pnpm run test           # 单元测试（320 tests）
pnpm run test:e2e       # E2E 测试（需先启动 dev server）
pnpm run typecheck      # 类型检查
pnpm run lint           # Lint

架构

┌─────────────────────────────────────────────────────────────┐
│                     DSH Web UI Shell                        │
│  ┌───────────────────────────────────────────────────────┐  │
│  │              CodeGraph Visualizer Plugin              │  │
│  │                                                       │  │
│  │  ┌─────────────┐  ┌──────────────┐  ┌─────────────┐  │  │
│  │  │  Host Layer │  │  Data Layer  │  │ Client Layer│  │  │
│  │  │             │  │              │  │             │  │  │
│  │  │ • routes    │  │ • CodeGraph  │  │ • GraphPanel│  │  │
│  │  │ • watcher   │  │   Adapter    │  │ • Toolbar   │  │  │
│  │  │ • config    │  │ • LensAdapter│  │ • Cytoscape │  │  │
│  │  │ • security  │  │ • GraphData  │  │   Renderer  │  │  │
│  │  │ • prereqs   │  │   Merger     │  │ • Store     │  │  │
│  │  │             │  │              │  │ • i18n      │  │  │
│  │  └─────────────┘  └──────────────┘  └─────────────┘  │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

目录结构

src/
├── index.ts                  # Host 端插件入口（re-export 聚合）
├── tools.ts                  # 4 个工具定义（graph_status/data/symbol/impact）
├── types/                    # Branded 类型、GraphData、事件声明合并
├── adapters/                 # 数据源适配器
│   ├── CodeGraphAdapter.ts   #   dsh-codegraph 数据源
│   └── LensAdapter.ts        #   dsh-tool-lens 数据源
├── merger/
│   └── GraphDataMerger.ts    # 多数据源融合器（去重 + 合并）
├── host/                     # Host 端模块
│   ├── config.ts             #   配置定义与校验
│   ├── routes.ts             #   HTTP 路由注册
│   ├── watcher.ts            #   文件监听与事件监听
│   ├── security.ts           #   路径安全校验
│   └── prerequisites.ts      #   前置条件检测
├── client/                   # Client 端模块（浏览器渲染）
│   ├── index.ts              #   Client 端插件入口
│   ├── GraphPanel.tsx        #   主面板 UI 组件
│   ├── api/                  #   HTTP API helpers
│   ├── components/            #   UI 组件（Toolbar, SearchBar, ImportPanel, ...）
│   ├── renderer/             #   渲染引擎
│   │   ├── CytoscapeRenderer.ts  # Cytoscape.js 渲染器
│   │   ├── IRenderer.ts      #     渲染器接口
│   │   └── styles/           #     主题样式
│   ├── store/                #   状态管理
│   │   ├── graphStore.ts     #     Zustand 全局状态
│   │   └── cluster/          #     聚类策略模块
│   │       ├── types.ts      #       ClusterLevel/ClusterNode/ClusterEdge
│   │       ├── index.ts      #       策略注册表
│   │       ├── directoryCluster.ts  # 目录级聚类
│   │       ├── fileCluster.ts       # 文件级聚类
│   │       ├── functionCluster.ts  # 函数级（透传）
│   │       └── smartCluster.ts     # 智能聚类（标签传播）
│   ├── i18n/                 #   国际化（中/英）
│   ├── hooks/                #   React Hooks
│   └── utils/                #   工具函数
├── push/                     # 推送通知模块
└── shared/                   # Host/Client 共享模块

聚类策略

采用 策略模式（Strategy Pattern） 实现 4 级聚类：

渐进式层级展开：在目录级模式下，展开一个目录聚类节点会显示该目录下的文件级聚类节点（而非所有原始节点）。用户可以继续展开文件级聚类节点来查看函数级原始节点。

DSH 插件规范合规

本项目遵循 DSH 插件开发规范九条红线：

• [x] 插件入口 src/index.ts 使用 definePlugin() 注册
• [x] dsh.bundle.patch 指定 Cordis 补丁文件
• [x] dsh.client.platform 为 "web"
• [x] dsh.client.inject 声明运行时注入依赖
• [x] peerDependencies 声明 Cordis/DSP-Tools/React
• [x] exports 字段正确导出 host/client 入口
• [x] files 字段仅包含 dist 和 cordis.patch.yml
• [x] engines 字段声明 Node/pnpm 版本要求
• [x] packageManager 字段指定 pnpm 版本

开发

技术栈

常用命令

pnpm run build          # 完整构建（host + client）
pnpm run build:client   # 仅构建 client bundle
pnpm run dev            # 启动 dev server
pnpm run test           # 单元测试
pnpm run test:e2e       # E2E 测试
pnpm run typecheck      # 三面类型检查
pnpm run lint           # Lint
pnpm run lint:fix       # Lint 自动修复

CI/CD

项目使用两个独立的 GitHub Actions 工作流：

测试覆盖

• 320 单元测试 — 覆盖 adapters, tools, plugin, graphStore, validators, i18n, logger, pathSecurity, services, deriveName
• 53 E2E 测试 — 覆盖 J1-J14 用户旅程（5 个 skip 为 dev mode 不支持的功能）

许可证

MIT

致谢

• DeepSeek Harness (DSH) — Agent 运行时框架
• Cytoscape.js — 图可视化引擎
• dsh-codegraph — CodeGraph CLI 数据源
• dsh-tool-lens — AST 代码图谱数据源

把 OpenViking 持久记忆接入
DeepSeek Harness（DSH）的插件。
OpenViking 负责「记住」，本插件负责把记忆在合适的时候送进对话、把对话送回去沉淀。

简体中文 | English

功能特性

• 自动召回 —— 每一步开始前，用当前输入在 OpenViking 中检索相关内容并注入对话（context 模式检索，服务端完成去重与 token 预算控制）
• 会话镜像 —— 把 user / assistant（可选 tool 结果）消息实时写入 OpenViking 的 dsh-<会话id> 会话流，供后台抽取为长期记忆
• 阈值提交 —— 服务端 pending_tokens 达到阈值自动 commit（保留最近 N 条为活跃消息）；会话关闭时兜底提交
• 离线出站队列（outbox） —— OpenViking 不可达时写操作落盘持久化，下次会话启动时幂等重放（内容哈希去重、重试上限、TTL 清理）
• /memlearn 人工沉淀 —— 斜杠命令直接把一条经验写入长期记忆：不开启模型回合、原文不进会话日志；密钥先脱敏，再语义查重合并进最相近的已有记忆（OpenViking 无新建记忆文件 API，低于分数下限时诚实拒绝写入）；离线时自动进 outbox，恢复后重放
• 完整工具面 —— 自研最小 MCP 实现（stdio 服务器 + streamable-HTTP 上游，无第三方 MCP SDK），把服务器全部工具以 mcp__openviking__* 暴露；服务器工具表变化自动同步
• viking:// URI 守卫 —— 拦截本地 fs/shell 工具把 viking:// 虚拟路径当成本地文件
• 自带技能 —— 独立 skill provider 提供 ov-memory 使用指南，不污染默认技能目录
• 零运行时依赖 —— 复用 DSH 已安装的 @deepseek-ai/* peer 包，无额外 npm 依赖

环境要求

• DeepSeek Harness：@deepseek-ai/* 0.1.x（≥ 0.1.0-rc.6）release 线
• Node.js ^22.19.0 或 >=24
• 一个可访问的 OpenViking 服务器（本地 openviking-server，或远程实例）

安装

# 从 GitHub 源码安装（lib/ 已预构建提交，无需本机构建）
dsh plugin --profile <profile> add github:xiaono1/dsh-ov-memory

# 本地开发安装
dsh plugin --profile <profile> add /path/to/dsh-ov-memory

插件通过自带的 cordis.patch.yml 注册为一个隔离的 cordis group（服务命名空间 ovMemory）。

若 profile 中已存在其它占用 mcp__openviking__* 命名空间的桥接插件，请先移除再启用本插件，两者不能共存。

配置

默认连接 http://127.0.0.1:1933。凭据沿用 OpenViking 生态的统一解析顺序：
OPENVIKING_* 环境变量 → ~/.openviking/ovcli.conf → ~/.openviking/ov.conf。
如需显式覆盖，在 profile 的 cordis.patch.yml 中写入：

- insert:
    - id: ov-memory
      config:
        - id: ov-memory-runtime
          config:
            endpoint: 'http://127.0.0.1:1933'   # REST base
            apiKey: 'your-user-key'              # 留空则走 env / ovcli.conf
            account: ''
            user: ''
            recall:
              enabled: true
              budgetTokens: 2000      # 每次召回的注入预算（服务端 context 模式）
              scoreFloor: 0.35        # 相关度下限
              refreshEverySteps: 0    # >0 时按步数周期强制刷新；0=仅查询变化时
            capture:
              toolResults: false      # 是否把工具结果也镜像进记忆流
              skipSubagentSessions: false
            commit:
              thresholdTokens: 20000  # pending_tokens 达到即提交
              keepRecentCount: 10     # 提交后保留为活跃的最近消息数
            learn:
              minScore: 0.5           # /memlearn 合并进已有记忆的语义分下限

常用环境变量：

工作原理

DSH agent 钩子                    本插件（进程内）                        OpenViking 服务器
─────────────────                ─────────────────                      ──────────────────
agent/session-start ──► 建档 + outbox 重放 ───────────► POST /api/v1/sessions
agent/pre-step     ──► 召回注入（plugin user 消息）──► POST /api/v1/search/search (mode=context)
session/event      ──► 会话镜像 ──服务器不可达──► outbox(本地持久化) ──重放──► POST .../messages
turn/end           ──► pending_tokens ≥ 阈值 → commit
session/flush      ──► 兜底提交
/memlearn 命令     ──► 脱敏 → 语义查重 → append（离线进 outbox）──► POST /api/v1/search/find → POST /api/v1/content/write
工具面 mcp__openviking__* ◄── dsh-mcp-client ◄── stdio ── 自研 MCP 代理 ──► POST /mcp (streamable HTTP)

设计决策与实现说明见 docs/DESIGN.md，验证手册见 docs/E2E.md。

开发

npm ci
npm run typecheck   # tsc --noEmit
npm run build       # TypeScript → lib/（已随仓库提交）
npm test            # node --test（内置 mock OpenViking 服务器，无需真实服务）

测试不依赖真实服务器：test/*.test.mjs 用自建 node:http 模拟 OpenViking REST 与 MCP 端点，
覆盖捕获/提交/outbox/凭据链/peer 解析/MCP 会话与工具调用/URI 守卫//memlearn（脱敏、查重合并、离线入队与重放）等路径。

可选真实服务器端到端验证见 docs/E2E.md。

License

MIT

English

DeepSeek Harness 的 OpenCode Go LLM provider 插件：注册 zen-go 路由，
每次出站推理请求都携带每会话稳定的 x-opencode-session。

运行环境：适配 DeepSeek Harness 0.1.5-rc.1（peer 依赖
@deepseek-ai/dsh-* 声明为 ^0.1.5-rc.1）。

• 三端面全接：chat/completions（mimo / deepseek-v4 / glm / kimi / longcat / hy）、
  responses（grok / gpt-5.6-luna / muse-spark，含独立 response.incomplete 终态）、
  messages（Anthropic 兼容：minimax / qwen，用 x-api-key 鉴权，max_tokens 缺省 8192）。
• 会话头：x-opencode-session 取会话 id，缺失时按请求生成 UUID 兜底，保证请求一定带头。
• 客户端标识：user-agent: deepseek-harness/<版本> (+url) dsh-opencode-go/<版本>，
  三端面一致，可被运营方识别放行（绝不是 Go-http-client/1.1 那种通用串）。
• 凭证只走 seam：credentials.resolve 按“进程 env → 托管 store
  （$DSH_HOME/.credentials.yaml，热加载）→ 项目/家目录 .env”分层，
  存换 key 不用重启。无明文字段。
• 设置卡：Models 页行 + 设置侧边栏独立入口（key 录入/清除、模型勾选与全选、
  刷新实时目录、每模型自填上下文与输出上限、密钥状态点）。
• 推理档位：responses 系 Minimal/Low/Medium/High/Xhigh（落 reasoning.effort），chat 系
  Low/Medium/High（reasoning_effort 透传；deepseek-v4-flash/pro/flash-vision-exp
  另有 Max 档——上游网关实测支持，感谢 @34262315716
  真机验证并贡献，见 #1），messages 系
  无档位词汇（显式传会报错）。
  均不设默认值，Default 即不发字段。
• 多模态：vision 模型（deepseek-v4-flash-vision-exp、两个 muse-spark）声明
  ["text","image"]，图片经 attachment 服务读盘转 base64 内联
  （png/jpeg/webp/gif，单图 20MB 上限）；纯文本模型由 runtime 自动替换占位；
  未知 id 默认放行，服务端说了算。
• 用量：三端面 usage 统一换算（prompt_tokens / input_tokens 双词汇），
  输入输出总量原样保留，缓存读/写、reasoning token 分桶上报。
• 用量账本：每次调用记一条（模型/会话/实际发出的 x-opencode-session/用途/
  输入输出/缓存读写/推理/finish），落 $DSH_HOME/plugin-data/dsh-opencode-go/usage.jsonl
  （append-only，清空时归档，不出网）；卡片里「概览/模型」双标签页：大格日历热力图 +
  分模型表，可一键清空。点热力图任意一天，展开当天总计 + 按 dsh 会话 id
  分组的明细（含实际发出的 session 头）。

路由刻意叫 zen-go 而不是 opencode-go——后者是用户自建 pi-ai profile
的常用名，llm 注册表单路由独占，撞名会顶掉别人的路由；apply() 启动时
也会主动检查，撞了就报 DUPLICATE_ADAPTER 快速失败，不连累他人。

安装

dsh plugin --profile web add github xia-sc/dsh-opencode-go
# 重启 dsh web，然后在会话模型选择器里选 zen-go/<模型>

本地源码安装（dsh plugin add <目录>，pnpm link: 方式）
多一步——否则启动直接崩（见 #2）：

cd <插件源码目录>
node scripts/setup-local-deps.cjs   # 自动定位宿主依赖树，建 node_modules/@deepseek-ai 桥
dsh plugin --profile web add <插件源码目录>
# 重启 dsh web

原理一句话：link: 安装只是在 profile 里建个 junction 指回源码目录，
Node 按真实路径向上找 @deepseek-ai/* peer 包——源码盘里没有，只能
桥到宿主那份。--host <目录> 可显式指定宿主依赖树（install root /
node_modules / @deepseek-ai 本级都认），--dry-run 只探测不建链。
建桥失败（比如启动报 Cannot find package '@deepseek-ai/xxx'）就检查桥
还在不在：node_modules/@deepseek-ai 必须是 junction，不在就重跑脚本。
registry / github 安装不受影响，不用跑这步。

存 key（任选其一，存完即生效，不用重启）：

# $DSH_HOME/.credentials.yaml
version: 1
refs:
  OPENCODE_GO_API_KEY: sk-你的key

或设环境变量 OPENCODE_GO_API_KEY，或在设置卡里直接粘贴保存。

配置（layer config / llm-opencode-go settings section）

测试

node --test test/smoke.mjs
# 联网探活（花一点点额度）：
$env:OPENCODE_GO_API_KEY='<key>'; node --test test/smoke.mjs

浏览器半构建

lib/client.js 是生成物，不要手改：改 src/client/*.js
（数字前缀即拼接顺序），然后跑 npm run build:client。
构建脚本拼完会做语法门检查，坏了直接失败，不会把坏包写进 lib/。

已知限制

• responses 系推理 effort 高时容易烧光 token 预算，大 maxTokens 起步更稳。
• 官方 /v1/models 不返回上下文窗口，modelCaps 目前靠手填；
  官方补了字段即插即用。
• 价格由计费插件自己的价格表定，本插件只保证用量上报正确。

致谢

• @34262315716（Critical Natural）：真机验证上游网关
  支持 reasoning_effort=max，并贡献 deepseek-v4 三模型的 Max 档
  （#1）；本地源码 link 安装
  启动崩溃的根因分析（#2）。