Skip to content
This repository was archived by the owner on Nov 18, 2026. It is now read-only.

refactor: fork 本地改动整体提交(布局 / MCP / JSON 人格卡 / dsh 徽标) - #182

Open
codesenlin wants to merge 11 commits into
Derpyu520:devfrom
codesenlin:pr/fork-rollup
Open

codesenlin wants to merge 11 commits into
Derpyu520:devfrom
codesenlin:pr/fork-rollup

Conversation

@codesenlin

Copy link
Copy Markdown

改了什么

这是 fork codesenlin/qq-bridge 在 v0.2.2-rc1 之后积累的本地改动整体提交:9 个功能/整理提交,外加一个合并上游 main 的 merge commit(上游 781e02f 已包含在分支里)。按模块分四块:

1. 目录与配置:data / work 分离

  • 静态基线/模板集中到 data/(旧版控制台快照、旧 ID、配置模板、隐私规则模板);
  • 经常编辑/运行中的文件放 work/(控制台页面、契约基线、本机 config.json);
  • 本机配置默认路径改为 work/config.json;config-path 保留 config/config.json 与仓库根 config.json 的回退,旧部署可直接升级;
  • 新增 scripts/ensure-config.mjs:npm postinstall / prestart 时如果配置不存在,从 data/config.example.json 自动生成,已存在不覆盖;
  • 桥接、测试、控制台 fixture 的读取路径同步,隐私扫描白名单与脚本索引一并更新。

2. 源码整理

  • src/ 下 3 个 .mjs 统一改成 .js(项目已经是 "type": "module",.js 本来就是 ESM);
  • 三个 MCP server 从 src/ 根目录收进 src/mcp/,文件名不变;
  • scripts/setup/setup-dsh.mjs 写入 DSH profile 的路径同步为 src/mcp/...;
  • 审计、测试、文档里的路径引用一并更新,无行为变化。

3. 人格卡 JSON 化

  • 新增 qq-bridge.role/v1 schema:sections[{ mode, heading, level, text }],mode 为 all / v1 / v2;
  • 内部仍渲染成文本后按模式筛选注入,行为与旧 Markdown 卡一致;
  • 校验拒绝坏 JSON、未知字段、非法 mode、空节,以及「标题 + mode」完全相同的重复节(同一标题按 v1/v2 各写一份是允许的);
  • 旧 .md 仍可读取;控制台读取时现场转成 JSON,保存/重命名时迁移为 .json 并删除旧文件;
  • 现有 roles/小鲸鱼、roles/傲娇助手 已转成 .json;附一次性迁移脚本 scripts/ops/convert-role-cards.mjs(支持 --delete-md / --force)。

4. 收尾

  • 文档链接与路径修正、privacy-scan 规则路径修正、ensure-config 复制前创建目录;
  • README 顶部添加官方 powered by dsh 徽标。

为什么

这些是 fork 在上游 v0.2.2-rc1 之后持续维护时攒下的改动:目录职责不清,配置模板和本机配置混在一起,人格卡只有 Markdown 一种格式,MCP server 散在 src/ 根目录。整理后目录边界更清楚,配置可自动生成,人格卡有了结构化格式且旧卡不被破坏。

上游已发布日落公告(SUNSET.md,预计 2026-11-18 归档),这个 PR 也作为 fork 改动的整体留档。如果维护者希望按模块拆分,我可以拆成 layout / src / roles / docs 几个小 PR。

怎么验证的

npm run test:audit
→ Audit suite: 61/61 scripts passed.

npm run privacy-scan
→ 扫描文件数 206,未发现敏感信息。

额外实测(起桥 + 本地 DSH):

  • 角色 API 12 项:创建、读取、更新、重命名、删除 JSON 人格卡,以及旧 .md 读取与保存迁移,全部通过;
  • test-console 实时测试通过(SnowLuma 测试发送不可达属环境问题,其余全过);
  • test-role-card、test-role-injection-cadence(含 JSON 卡按 mode 筛选注入)全过;
  • Markdown 相对链接检查 0 处失效。

自查

  • 跑过 npm run test:audit,结果写在上面
  • 跑过 npm run privacy-scan(没有新增命中)
  • 新增行为带了回归脚本,并已加进 scripts/test-audit.mjs 的清单
  • 没有提交 token / Cookie / 真实 QQ 号 / 群号 / 本机绝对路径 / state/
  • 行为变更(配置项、工具名、端点、默认值)已同步更新 README 或 docs/
  • 没有绕过 RULES.md 的设计不变量(尤其 L6 / L7)

破坏性变更 / 需要使用者做什么

  • 本机配置默认路径变成 work/config.json;旧 config/config.json、仓库根 config.json 仍兼容,npm install / npm start 会自动生成;
  • 人格卡推荐 .json;旧 .md 可继续读取,控制台保存时会自动迁移;
  • MCP server 路径变成 src/mcp/mcp-*.js:已装过 DSH profile 的,需要重跑 node scripts/setup/setup-dsh.mjs 并重启 DSH;
  • 控制台页面从 public/console.html 迁到 work/console.html,桥接已同步。

codesenlin and others added 11 commits November 9, 2026 23:58
- QQ 文件链路(files.*):file 段识别、safeFetchBytes 抓取、落盘/复用、文本内联、
  群文件 id 回退(名字+大小)、上传到 QQ(qq_upload_file,按会话 preset 开放:
  qq-chat-tools / closed-agent 可传,纯聊天 preset 用 denyTools 屏蔽);
- qq-chat-tools 预设:read/read_image/write/edit/glob/grep + bash/pwsh,写边界靠
  DSH workspace-write;qq-agent-guard 的 denyRead/denyExec(含 sudo)与 denyTools;
- 被点名唤醒(私聊/@/名字/拍一拍/提问)改走 2s 快速窗口,关键词仍按 batchWindowMs 合并;
- probeAudio 兼容 ffprobe 4.4(没有 -o 选项,回退 stdout 捕获)。
- 配置迁到 config/(config-path resolver 兼容旧根目录 config.json),
  CONTRIBUTING/NOTICE/RULES/SECURITY 迁到 docs/,链接与脚本引用同步;
- .gitignore 改「根规则 + 目录规则」(config/docs/docs/guides/scripts/assets 各管本目录);
- QQ 文件编排从 bridge.js 拆到 src/qq-file.js(createQQFileService 依赖注入),
  bridge 净减约 360 行;新增 docs/guides/LOCAL_EXTENSIONS.md 汇总本地功能与升级清单。
- 删除 legacy-peer-deps 项目配置(npm 11 下实测无 ERESOLVE,npm ci 通过);
- SnowLuma SDK/MCP 1.14.22 → 2.4.2(纯 ESM;客户端方法与动作表实测可用,
  live 的心跳/连接/MCP write 模式通过);
- js-yaml 4.3.2 → 5.5.0(无 default export,改命名空间导入;`!!js` 自定义标签
  改用 defineScalarTag + CORE_SCHEMA.withTags,preset patch 产物逐字不变);
- R11/R12 计时断言从墙钟改为 process.cpuUsage(),高负载不再假红。
- scripts/ 按目录分类:audit / tests/offline / tests/live / probes / setup / ops /
  send / console / lib / fixtures;索引 scripts/README.md 由生成器维护并纳入 audit 防过期;
- src/ 按职责分目录:dsh / qq / media / text / web / util;入口 bridge.js、
  self-test.js 与三个 MCP server 留在根目录(DSH 按绝对路径启动);
- 移除 start.bat / restart.bat:新增 scripts/ops/bridge-launcher.mjs,提供
  npm start(守护重启)/ start:once / restart / stop;Windows 才做 ACL 收紧,
  Linux 跳过;stop-bridge-instance 补 POSIX 进程/端口枚举与 SIGTERM→SIGKILL,
  并用 state/bridge.launcher.json 证明守护进程归属;
- 两个 Windows-only 测试在非 Windows 上显式跳过,Linux test:audit 61/61。
docs: add sunset notice and archive announcement
- 静态基线/模板集中到 data/:console.before.html、console-ui-legacy-ids.json、
  config.example.json、privacy-rules.example.json;
- 经常编辑/运行中的文件放 work/:console.html、console-ui-contracts.json、
  本机 config.json(.gitignore 排除);
- 本机配置从 config/config.json 迁到 work/config.json;config-path 解析顺序
  work → config/ → 仓库根(旧部署兼容),模板仍 data/config.example.json;
- 新增 scripts/ensure-config.mjs:npm postinstall / prestart 时若
  work/config.json 不存在,从 data/config.example.json 复制并 chmod 600;
- 桥接/测试/控制台 fixture 读取路径同步;privacy-scan 白名单与索引生成器更新;
- README/DSH_SETUP/CONTRIBUTING/FOLDER_MAP 等文档同步。
- src/util/state-acl.mjs、src/core/session-router.mjs(含 .test.mjs)改成 .js:
  项目是 "type": "module",.js 本来就是 ESM;
- src/mcp-snowluma-safe.js / mcp-host-server.js / mcp-web-search-safe.js
  移入 src/mcp/,内部导入改 ../、ROOT 深度 +1;
- setup-dsh 写入 profile 的 MCP 路径、审计/测试拉起路径、文档与注释同步;
- 修正 bridge 里 state-acl 实现路径注释(src/util/)。
- PRIVACY.md 本地规则模板链接改到 data/,并写明复制到
  scripts/ops/privacy-rules.json;
- privacy-scan 日志用实际规则路径、注释改 work/.gitignore;
- README.en 安装注释残留中文改英文;
- LOCAL_EXTENSIONS 的 config.json 明确为 work/config.json;
- FOLDER_MAP 根目录说明与核对日期更新;
- ensure-config 复制前 mkdir work/。

验证:test:audit 61/61;Markdown 相对链接 0 失效;privacy-scan 无敏感信息。
- 新增 schema qq-bridge.role/v1:sections[{ mode, heading, level, text }],
  mode = all / v1 / v2;内部仍渲染成文本后按模式筛选注入;
- role-card.js 新增 JSON 解析/校验/渲染/转换函数;拒绝未知字段、坏 mode、
  空节,以及「标题 + mode」完全相同的重复节(同标题 v1/v2 各一份合法);
- bridge 支持 .json/.md(.json 优先),控制台读取旧 .md 时转 JSON、保存时
  迁移为 .json 并删旧文件;列表/摘要/统计/注入统一基于渲染文本;
- roles/小鲸鱼、傲娇助手转成 .json;新增 scripts/ops/convert-role-cards.mjs
  (--delete-md / --force);
- work/console.html 编辑器改 JSON 并加前端校验提示;预览夹具同步;
- roles/README.md 重写为 JSON 规范,RULES/FOLDER_MAP/privacy-scan 同步;
- 测试:JSON 解析/校验/往返、JSON 卡注入与 mode 筛选、控制台创建 JSON 人格。

验证:test:audit 61/61;起桥实测角色 API 12 项全过;privacy-scan 无敏感信息。
README.md 与 README.en.md 开头各加一枚官方「powered by dsh」徽标
(Shields.io 标准图 + 链接到 DeepSeek Harness 仓库),尺寸/配色/文案不变。
@github-actions
github-actions Bot changed the base branch from main to dev November 11, 2026 12:55
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants