This repository was archived by the owner on Nov 18, 2026. It is now read-only.
Repository navigation
refactor: fork 本地改动整体提交(布局 / MCP / JSON 人格卡 / dsh 徽标) - #182
Open
codesenlin wants to merge 11 commits into
Open
codesenlin wants to merge 11 commits into
codesenlin wants to merge 11 commits into
Conversation
- 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 仓库),尺寸/配色/文案不变。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
改了什么
这是 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:npmpostinstall/prestart时如果配置不存在,从data/config.example.json自动生成,已存在不覆盖;2. 源码整理
src/下 3 个.mjs统一改成.js(项目已经是"type": "module",.js本来就是 ESM);src/根目录收进src/mcp/,文件名不变;scripts/setup/setup-dsh.mjs写入 DSH profile 的路径同步为src/mcp/...;3. 人格卡 JSON 化
qq-bridge.role/v1schema:sections[{ mode, heading, level, text }],mode为all/v1/v2;.md仍可读取;控制台读取时现场转成 JSON,保存/重命名时迁移为.json并删除旧文件;roles/小鲸鱼、roles/傲娇助手已转成.json;附一次性迁移脚本scripts/ops/convert-role-cards.mjs(支持--delete-md/--force)。4. 收尾
privacy-scan规则路径修正、ensure-config复制前创建目录;powered by dsh徽标。为什么
这些是 fork 在上游
v0.2.2-rc1之后持续维护时攒下的改动:目录职责不清,配置模板和本机配置混在一起,人格卡只有 Markdown 一种格式,MCP server 散在src/根目录。整理后目录边界更清楚,配置可自动生成,人格卡有了结构化格式且旧卡不被破坏。上游已发布日落公告(
SUNSET.md,预计 2026-11-18 归档),这个 PR 也作为 fork 改动的整体留档。如果维护者希望按模块拆分,我可以拆成 layout / src / roles / docs 几个小 PR。怎么验证的
额外实测(起桥 + 本地 DSH):
.md读取与保存迁移,全部通过;test-console实时测试通过(SnowLuma 测试发送不可达属环境问题,其余全过);test-role-card、test-role-injection-cadence(含 JSON 卡按 mode 筛选注入)全过;自查
npm run test:audit,结果写在上面npm run privacy-scan(没有新增命中)scripts/test-audit.mjs的清单state/docs/破坏性变更 / 需要使用者做什么
work/config.json;旧config/config.json、仓库根config.json仍兼容,npm install/npm start会自动生成;.json;旧.md可继续读取,控制台保存时会自动迁移;src/mcp/mcp-*.js:已装过 DSH profile 的,需要重跑node scripts/setup/setup-dsh.mjs并重启 DSH;public/console.html迁到work/console.html,桥接已同步。