Archive
过程资产归档
坑清单 / 验收报告 / 案例快照 / 调研报告 —— 记录决策脉络，避免重踩。
pbc-local 项目封面图不显示——模板未渲染 cover 字段
项目档案 md 里写了 cover 字段、图片也放进 public/images/projects/，但详情页和列表卡片都不显示封面——原因：自定义模板 [slug].astro 与 ProjectCard.astro 根本没渲染 cover。加 img 标签即可，无需改数据。
- AstroWind
- 模板
- cover
智能体 shell 注入 http_proxy，连通性探测出全 200 假阳性
在智能体环境里用 curl 探测 GitHub 各 IP 连通性，四个 IP 全部返回 200，看似全通；核验 %{remote_ip} 才发现连的全是 127.0.0.1（本机代理），--resolve 被完全忽略，四条都是假阳性。解法：加 --noproxy '*' 绕过代理，并强制输出 remote_ip 与目标 IP 比对，不相等即判无效。
- curl
- 代理
- 假阳性
- 网络
- 验收
agnes-ai 免费模型选型坑（2.5-flash 唯一可用）
agnes-ai 多模型试错：2.5-pro 收费、2.0-flash 429 限流、3.0-flash 带 tools 超时，免费且稳定带 tools 的只有 agnes-2.5-flash（约 2 秒响应）。
- LLM
- 模型选型
- agnes-ai
Astro Preview 端口被占自动迁移 + IPv6 监听导致 127.0.0.1 连不上
astro preview 指定端口被占时自动迁移到新端口（4321→4322），且默认只监听 ::1（IPv6）；用 curl 127.0.0.1（IPv4）会"无法连接"，实际服务是好的。解法：看 preview 日志找真实端口，用 localhost（IPv6）访问。
- Astro
- Preview
- 端口
- IPv6
Astro Preview 后台进程运行中自动退出（ERR_CONNECTION_REFUSED）与重启验证
用 Start-Process 后台启动的 astro preview 服务在运行几分钟后进程退出，浏览器/curl 报 ERR_CONNECTION_REFUSED（服务此前正常）。解法：重启前先确认端口无监听（Get-NetTCPConnection），用 Start-Process 重新拉起并轮询 HTTP 200 就绪后再继续浏览器验证，避免误判为构建产物缺失。
- Astro
- Preview
- 进程退出
- 重启验证
AI 生图自动加文字/人物——"无文字无人物"硬约束需二次编辑
概念配图（1200×630）要求无文字无人物，image_gen 首版却自动生成中央"AI"字样 + 框内人物画面，违反工单硬约束。用 image_edit 去掉文字换光环、去掉人物换园林剪影后达标。生图默认喜欢加字/加人，硬约束场景要预判二次编辑。
- 踩坑
- 生图
- 封面
- 约束
DSH 定时派单后不消费（accepted 但文件不动）+ bu 失联降级 HTTP API
用 DSH plugin-manager command API 派单返回 accepted:true 但 DSH agent 不消费（产出文件时间戳长期不变），需补发触发消息或重启 DSH 恢复；bu 打开 DSH 频繁 COMMAND_TIMEOUT，验证/派单降级 HTTP API 直调最稳。
- 派单
- DSH
- API
- bu超时
- 定时任务
iframe 嵌入 DSH 主页三重拦截坑（代理 + 本地 HTTP 双服务解法）
直播台左栏要 iframe 嵌入真实 DSH 多项目工作台，连续踩三个拦截：BrowserAuth 401（X-Frame-Options 双保险）、file:// 页面加载 http 被 Chrome 安全策略拦（ERR_CONNECTION_REFUSED）、代理不转发 WebSocket/静态资源（502）。最终用 8091 cookie 代理 + 8092 本地 HTTP 服务双服务解决。
- iframe
- 代理
- DSH
- 安全策略
- WebSocket
本地仓库没有 upstream tracking，git pull 拉了对象却不合并
非 clone 方式建的本地仓库，git pull 时 fetch 成功但报 There is no tracking information for the current branch，远端对象已落到 .git 里却不合并工作树，容易被误判为"已更新"。解法：git branch --set-upstream-to=origin/main main；合并前先看 merge-base 判断是否纯 fast-forward。
- git
- upstream
- pull
- 验收
多会话并行操作同一 git 仓库，文件被顺带提交
多个豆包会话同时往同一个仓库 add/commit/push 时，你的新文件可能被另一会话的提交"顺带"带走（git add -A 会把工作树里所有未跟踪文件一并暂存），导致提交内容不可预期（多了无关文件、或自己的文件进了别人的提交）。解法：提交前用 git status 核对暂存清单、只 git add 明确路径、push 被拒先 pull --rebase。
- git
- 并行会话
- 提交冲突
compression 错误包装原生 createServer 导致 listen 崩溃
给原生 node:http createServer 加 gzip 时误用 compression(createServer(...)) 包装，返回的不是 HTTP Server，导致 server.listen is not a function 崩溃；随后又引入多余右括号语法错误，连修 2 单。
- Node
- gzip
- compression
- 排错
PowerShell HTTP 验证中文乱码（mojibake）坑
Invoke-WebRequest 抓取页面 Content 时中文变乱码（UTF-8 字节被按 Latin-1/系统码页解码），导致 -match '中文' 全部 False；产物实际有效，需改读 dist 文件 UTF-8 取证或用浏览器 DOM 验证。
- 验证
- PowerShell
- 编码
- Astro
AI 视频 API 选型踩坑（agnes 余额/队列 vs Seedance 额度）
视频生成 API 免费"陷阱"：agnes flash 版 503 队列满、正式版 403 余额不足（$0.10 < $0.125/段）；豆包 Seedance 2.5 近 7 天额度耗尽中断。对策是工具选择器插件 + 多引擎冗余。
- 踩坑
- AI视频
- API
- 选型
AstroWind Build 失败：Waline 评论组件缺依赖
npm run build 报 Rolldown 无法解析 "@waline/client"：AstroWind 模板自带 Waline.astro 组件引用 @waline/client，但 package.json 未声明、node_modules 未安装。修复：npm install @waline/client。
- AstroWind
- Build
- 依赖
直播台持续优化 1-33 验收总结（真实 DSH 主页嵌入攻坚阶段）
视频号半无人直播台续作（DSH 直播台）优化 1-33 全部验收通过：13 插件全挂载、敏感词 156 词、TTS 多音色、watchdog 自愈、语音接力串行；左栏从模拟窗口升级为真实 DSH 主页嵌入方案（8091 代理 + 8092 HTTP + URL 输入框）；重装系统后产出分步生成指南供重建。
- 验收报告
- 直播台
- 插件化
- TTS
- 敏感词
多 AI 协同工作流 v2.5→v2.9 演化：执行方证据可信度分级（智能体操盘 PBC 仓库实战）
让 AI 智能体无人值守完成"修 GitHub 网络 → 拉私有仓库 → 内容审计 → 构建"全链路。执行方给出的 3 个中间结论在核对原始证据后全部被推翻——连通性探测全 200（假阳性）、pull 报成功但未合并、凭据存入但 token 失效。沉淀为执行方证据必须分层交付的校准规则。
- 多AI协同
- 验收
- 证据可信度
- v2.5→v2.9
- 智能体
DSH 派单通道演进（headless 最可靠）+ v3.4 闭环
派单通道三次演进：bu 侧边工作台超时发错 → DSH web 界面需 token 仅适合人看 → headless 命令行最稳；再配 _last_check.md + cron 每分钟巡检实现自动派单闭环。
- 派单
- headless
- 闭环
- DSH
免费视频 AI 工具调研对比（9 款）
为漫剧视频生成选型，全网调研 2026 年免费视频 AI 工具 9 款，按免费额度/水印/风格/时长/分辨率对比，结论是豆包 Seedance 2.5 最适合日常开发（内置免费直调）。
- 调研
- AI视频
- 选型
通用派单模板 · 装项目档案 + 配图
贴到任意项目窗口，豆包自动提炼 5 段 + 配图 + push
- 模板
- 派单
- 项目归档
豁免留痕 · PBC 项目
记录本项目手动跳流程的修复动作（误判阶段切换自行执行阶段 5 第一批，用户裁决保留并留痕）
- 豁免
- 留痕
Waline SQLite 需预置官方模板
Waline SQLite 不自动建表，0 字节空文件导致 no such table wl_Comment 500。必须下载官方带表结构的 waline.sqlite 模板替换。
- Waline
- SQLite
Astro 7 Native Fonts 依赖 jsDelivr CDN
Astro 7 Native Fonts 的 fontsource provider 强制从 cdn.jsdelivr.net 拉字体，国内网络不可达导致 dev/build 崩溃。用 @font-face 本地化解决。
- Astro
- 字体
- CDN
调研整合报告 RS-PBC-001/002
现成方案 6 问调研 + Waline on Workers 实测 + Qwen 模板视觉评估的整合报告，含三栏对照表与最终选型表。
- 调研
- 选型
夜间盯单定位"AI卡死"根因的完整诊断法
一整套可复用的"AI进程卡死"诊断路径：文件时间戳盯单→极简测试隔离AI本体→查会话内容反查执行器行为→定位真凶（执行器偷偷自动派了7字废工单→自动验收失败→自动返工→二次启动卡死）。适用于任何"看起来在跑但实际没动"的黑盒AI链路。
- 排查
- 盯单
- 执行器
- 根因分析
DSH headless 改大 HTML 必崩，只能 GUI + Edit 局部改
用 DSH headless 命令行模式修改 >100KB 单文件 HTML 时进程静默崩溃（启动后无输出直接退出），500KB 级别必触发 token 上限导致 INVALID_REPLAY_STATE 会话损坏。解法：GUI 模式 + 只允许 Edit 局部修改 + 工单拆小（一次只改一处）+ 先读文件报行号再动手。
- DSH
- 大文件
- 会话损坏
复验AI从DeepSeek切Kimi完整验收报告
单文件HTML里给复验AI换模型提供方的完整流程与坑：新增callKimi函数（SSE流式与callDeepSeek一致）、企业版Kimi没有moonshot-v1-8k权限需换kimi-k2.6、设置页测试按钮曾写死请求DeepSeek接口导致401、真实验收验证（P002复验报告非模板）。含插入行号、文件大小变化、真实调用证据。
- Kimi
- 双AI
- 验收报告
- API适配
AI 协作 JSON 回填模式（Prompt 生成 → 在线对话 → JSON 粘贴 → 自动回填）
平台内 AI 能力的统一交互模式：插件生成带 Schema 的严格 JSON Prompt → 一键打开在线 DeepSeek（或 API 直连）→ 用户把 AI 返回的 JSON 粘贴回 → 解析逐字段回填表单，人工确认生效。extract（要素提取）/ review（文书审核）均已落地。
- AI协作
- JSON
- Schema
- 回填
- 在线DeepSeek
- 本地兜底
file:// 下 localStorage opaque origin 报错与安全封装修复
插件初始化期访问 localStorage，在 file:// 协议（opaque origin）下抛 SecurityError 致控制台报错；用 _lsAvailable/_safeLsGet/_apiSafeEnabled 三安全封装降级修复，console-check 双协议 0 报错。
- localStorage
- file协议
- 安全封装
- console-check
信访工作台持续学习 4 轮迭代验收闭环（v2.0 → v2.3）
按"调研对标→设计文档→headless 派单→盯→独立验收"闭环连续 4 轮推进：办件向导/AI 要素提取/答复 AI 审核/办结归档，selftest 334→513，console-check 双协议全 PASS。
- 持续学习
- 验收闭环
- selftest
- console-check
- headless
预警卡点击筛选错乱 Bug 的发现-修复-复验闭环
v8.23 预警卡点击筛选错乱（点红卡命中1人且筛选区误显示姓名）：根因=预警卡点击误设 setFilter('search', 人名)，修复=改 setFilter('alert', 级别)+data-bus 新增 alert 筛选键+画像加 _alert 字段；复验注意 bu 与 Chrome 实例 localStorage 独立需分别清理，最终红3/橙149/黄6 全部通过。
- 预警筛选
- Bug修复
- 复验
- localStorage
派单通道 bu 经常超时/点击无反应，Edge 发送未进目标会话
豆包侧边工作台（bu）打开 DSH 多次 COMMAND_TIMEOUT、点击发送无反应；曾改用 Edge 桌面浏览器同内容发送，被证实未进入目标会话（勿再用）；可靠路径=cu/Chrome 兜底 + 发送前三重确认会话名 + 验证"输入框清空+消息流出现工单全文"。
- 派单通道
- bu超时
- 会话确认