仓库真实 Notes 与来源

打开决策看板 · 查看持续学习工作流

系统地图 · Magpie 生成的界面效果参考

方案一：系统地图优先。左侧模块导航，中间架构或流程图，右侧展示关联 Notes、来源与验证边界。

这是静态设计效果图，功能尚未实现。用于确认布局和交互方向，图中的文字与细节以之后的实现规格为准。

工程知识地图设计参考：模块导航、架构画布与关联 Notes 详情

对照当前真实 Notes 看板

当前示例选中“统一归属契约”：虚线与待实施标签表达规划；右侧说明选择理由、未采用路线和验收缺口。后续可从图回看 Notes，也可从 Notes 定位相关节点。

当前选定 16 篇非敏感摘要，原有文档保持权威归属。下方可以查看每篇全文、来源指纹和验证缺口。

生成时间：2026-11-06T02:02:20+00:00。包含未提交来源，以本快照指纹为准。参考 HEAD：9509fee0cc3efb3c314aa82f9fa801e4110c2b25。

仅汇总选定非敏感文档；非全量历史、非持续监控。整理日期不等于实施日期，implemented 不表示生产验收全部完成。

程序与客户资料保持明确边界

# Agent Note: 程序与客户资料保持明确边界

Status: implemented

## 问题

代码仓库承载多个工具，源资料、会话、生成报告和运行状态混入版本控制会破坏本地数据边界。

## 决策

Git 只保存程序与非敏感项目文档。客户资料、会话、索引、缓存和生成成果留在 local_data；不强制添加，不通过测试夹具或注释复制客户正文。

## 曾考虑的备选

当前约定明确不采用将生成成果强制加入 Git 的做法。没有证据说明更早讨论过其他方案，因此不补写历史备选。

## 后果

源码可独立协作和验证；资料及成果需要本地管理。测试必须使用合成样例，公开 Notes 只包含复核过的非敏感摘要。

## 验证与边界

依据 AGENTS.md 的数据边界。本次 Notes 构建不扫描资料区或对话，也不据此宣称对整个历史完成了敏感信息审计。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `AGENTS.md / 数据边界`；SHA-256：`df77321c03c88ae99539cfc71257c0cd7e51377a7f9ed5104bfc9d9d073fe25a`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。
返回索引

资料检索与可研报告生成保持模块边界

# Agent Note: 资料检索与可研报告生成保持模块边界

Status: implemented

## 问题

资料查找与报告编写承担不同职责，直接共享内部实现会让检索和编写互相耦合。

## 决策

materials 查找授权范围内的原文件；feasibility_study 管理报告工作区及生成。两者互不导入，后续可通过来源候选进入事实台账。

## 曾考虑的备选

领域映射明确禁止两模块共享实现。跨模块事实传递被记为后续能力，而不是当前已经打通的流程。

## 后果

边界清楚，模块可以独立验证；检索结果接入事实台账仍需独立契约与实现，不能因为模块都存在就宣称全链路已完成。

## 验证与边界

依据 CONTEXT-MAP.md 的 Relationships。此处整理既有边界，不重新运行报告构建或遍历客户资料。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `CONTEXT-MAP.md / Relationships`；SHA-256：`9dc3c11be2a1fad5ba6a7f0c8889f693cb1223c88a2af5f9df48c08b92d78c52`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[程序与客户资料保持明确边界](2026-11-06-local-data-boundary.md)
返回索引

验证后沉淀经验并保留决定变更理由

# Agent Note: 验证后沉淀经验并保留决定变更理由

Status: implemented

## 问题

完成任务并不自动产生可复用知识；未经验证的猜想和重复日记会增加下一次检索的噪声。

## 决策

遇到用户纠正、非直观根因、有效排障步骤或重要取舍时，先检索再更新权威位置。记录真实备选、收益代价、已做验证与缺口；重要决定翻转保留旧条件并互链。

## 曾考虑的备选

不建立按日期堆积的经验日记，不为每次小改动强制写笔记。事实原位更新，重要架构决定反转用新 ADR 关联旧记录。

## 后果

经验保持针对性并可复核；仍需要当前 agent 作出适用范围判断，不是后台训练或自动批准变更。

## 验证与边界

依据现有持续学习规则；这次只把选定来源整理为摘要，不导出项目记忆、原始聊天或未知来源结论。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `docs/agents/continuous-learning.md / 何时提炼`；SHA-256：`b468de91ebfe0cf914b0d8661c80761499eabe93100fd42f5d8a3723b2d49878`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[程序与客户资料保持明确边界](../architecture/2026-11-06-local-data-boundary.md)
返回索引

预览默认提供可信 HTTPS 在线入口

# Agent Note: 预览默认提供可信 HTTPS 在线入口

Status: implemented

## 问题

只有本机地址的预览不便查看和分享，重复创建隧道又会干扰已有站点或扩大公开范围。

## 决策

用户已要求自动使用 PassNAT。复用自有 dev 共享隧道、单 frpc 和持久化证书服务，静态预览只公开明确 HTML 白名单，交付前验证公网 TLS 和必要交互。

## 曾考虑的备选

优先同隧道、同域不同路径；额度不足才新建后续隧道。不把仓库或 local_data 根目录当静态站点，也不以关闭证书检查替代验证。

## 后果

交付可点击的 HTTPS 入口，既有站点保留；预览依赖本机和共享服务在线，不等于永久托管，不授权生产部署或 Git 推送。

## 验证与边界

当前站点此前已验证 TLS、页面和私有路径拒绝。新真实 Notes 看板将再次验证后发布；不把此前演示版的成功当成本轮成功。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `docs/agents/online-preview.md`；SHA-256：`0de6060d21a3c0f4cfa71c434de2df7dd8ffb38e366d3da17a23a0f40c8aa23c`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[程序与客户资料保持明确边界](../architecture/2026-11-06-local-data-boundary.md)
返回索引

从已复核摘要目录生成可追溯 Notes

# Agent Note: 从已复核摘要目录生成可追溯 Notes

Status: implemented

## 问题

希望统一浏览现有决定，同时避免维护第二套权威文档，或把演示与未经核对的历史当成事实。

## 决策

由人工核对的摘要目录引用明确来源章节及 SHA-256。构建器先检查指纹、状态和关联，再生成本地 Markdown、上游原版看板和可查看全文的来源页。

## 曾考虑的备选

不全量扫描仓库、原始会话或记忆，不把整个历史自动归纳成已验证决定；不把生成 Notes 当成权威源文档。

## 后果

摘要具有稳定编号和版本依据，原文变动会阻止旧摘要悄悄再发布；语义复核仍需要人或当前 agent，来源哈希只证明版本一致。

## 验证与边界

本轮增加独立合成测试并实际生成快照。首批日期是整理日期，implemented 不表示对应模块所有线上验收都完成；公开站点不暴露本机 manifest。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `docs/agents/notes-board.md`；SHA-256：`664cabc5e29800fb67d4f1f3e75d976ba2b17e1e3dcbd8bf1168608e20055c85`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[验证后沉淀经验并保留决定变更理由](../process/2026-11-06-verified-learning.md) · [预览默认提供可信 HTTPS 在线入口](../process/2026-11-06-online-preview-delivery.md) · [程序与客户资料保持明确边界](../architecture/2026-11-06-local-data-boundary.md)
返回索引

配置工作区沿用原生聊天与会话运行时

# Agent Note: 配置工作区沿用原生聊天与会话运行时

Status: implemented

## 问题

跨配置工作区需要草稿、会话恢复和未保存保护，但不应增加第二套会话库或取代官方聊天。

## 决策

保留官方 /chat，插件使用独立工作区路由，通过官方 gateway JSON-RPC 创建和附着原生会话。切换不修改全局默认，也不启停网关。

## 曾考虑的备选

来源明确不新增模型工具、worker 服务或第二套会话数据库。需要宿主前端适配，不能把单独复制插件称为全部生效。

## 后果

历史仍由宿主恢复，浏览器只保存作用域内位置与草稿；原生选择器和配置编辑器的适配需要单独构建及兼容验收。

## 验证与边界

README 明确已有隔离环境集成和预览部署，正式登录交互及部分兼容/权限场景仍未完整验收。本轮只整理记录，不做线上行为复验。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `plugins/profile-workspace/README.md / 已实现`；SHA-256：`eb756340300a11ac7d93f2fed827d1fcab9c0159e3ec5781798b1f53a7220d48`

- `plugins/profile-workspace/README.md / 验证范围与限制`；SHA-256：`414073c94ee56d74bd0e338468a89c46500bd9ef8b34790da0af6e432ed14124`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。
返回索引

副本复制能力与运行身份分离

# Agent Note: 副本复制能力与运行身份分离

Status: implemented

## 问题

创建能力副本需要延续插件和所选权限，但不能复制旧账号、会话、授权及运行数据。

## 决策

按选项复制插件包和权限，排除运行数据、旧身份与旧账本权限；可信创建者的只读正文授权按目标作用域处理，预登记姓名在网关接受扫码身份后才绑定。

## 曾考虑的备选

不全目录克隆运行状态，也不从缺少可信上下文的创建请求猜出原登录者或授予正文读取权。

## 后果

副本能继承能力又保留账号隔离；权限与身份写入需要不同阶段，换人扫码不能悄悄继承首次绑定者姓名。

## 验证与边界

依据 README 的创建副本规则和记账身份约定。回归使用合成身份；本轮不读取真实用户正文或触发微信登录。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `plugins/profile-login/README.md / 创建副本：插件与权限`；SHA-256：`dfdb74237a1b6115c6d14dbfac5f60f21f199bdc0efbd39aa0f16af88dcd1ebe`

- `plugins/user-ledger/README.md / Profile 预登记记账姓名`；SHA-256：`a897d7ed0d78dd2e433e0f3e6fffa66d9a26269a1fa515a082341696b53010d1`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[用户账本区分摘要可见与正文授权](../architecture/2026-11-06-ledger-visibility.md)
返回索引

用户账本区分摘要可见与正文授权

# Agent Note: 用户账本区分摘要可见与正文授权

Status: implemented

## 问题

会话回顾需要识别用户与轨迹，但账本摘要可见不应自动等于可以读取别人的聊天正文。

## 决策

接口默认只提供不含正文的摘要。内容需要显式请求并通过渠道策略：本机 CLI 可显式读取，外部 agent 默认拒绝，仪表盘依赖可信宿主身份白名单；内容访问审计失败即拒绝。

## 曾考虑的备选

不把显示名、actor 参数或 MCP 自报名称当认证，不因摘要可见就放开正文；通配授权不代替宿主登录门禁。

## 后果

摘要与内容访问分开，但摘要没有新增按用户隔离。有内容权限也不表示只能查看自己的行，仍依赖可信部署和访问制度。

## 验证与边界

来源明确区分渠道策略与行级隔离，不能误报为每人私有账本。本次 Notes 不读取数据库、真实消息或私人偏好。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `plugins/user-ledger/README.md / 两层可见与授权`；SHA-256：`675f93d7cde2f13274f127fe4999d9b6df40c999bceb1e635bcee13035b3603b`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[程序与客户资料保持明确边界](2026-11-06-local-data-boundary.md)
返回索引

消息静默检查不等于可以重启

# Agent Note: 消息静默检查不等于可以重启

Status: implemented

## 问题

进程存活不能判断是否有人使用，最后用户消息安静也不能排除助手、工具、在途任务或扫码活动。

## 决策

CLI 与管理界面共用只读活动聚合逻辑，同时检查用户消息和任意角色活动。异常、缺失或无法确认的状态不能按安全处理。

## 曾考虑的备选

不采用只看进程、只看最后用户消息、或检查通过便自动重启的判断；检查只生成时间与计数快照，不读取正文。

## 后果

得到一致的消息静默判定，仍须人工核对在途任务和扫码状态，并保留当前重启授权；过期结果不能继续使用。

## 验证与边界

来源 README 明确聚合范围、未知状态、过期与不执行重启的边界。部分真实登录浏览器点击验收仍未完成；本轮不重启任何业务服务。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `plugins/profile-login/README.md`；SHA-256：`059449ed46e212e4893b59947d2436ac67deb0f2d996bd684f10dd08e70ef1d1`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[程序与客户资料保持明确边界](../architecture/2026-11-06-local-data-boundary.md)
返回索引

模型提出会话切换，宿主保留执行与确认

# Agent Note: 模型提出会话切换，宿主保留执行与确认

Status: implemented

## 问题

用户用自然语言选择模型时，需要理解简称和意图，但模型不能自行绕过命令权限或扩大到 Profile 默认设置。

## 决策

模型只提出候选；确认绑定当前身份、会话和短期状态，最终交回原生命令链执行，仅影响会话范围，保留宿主鉴权、忙碌与风险确认。

## 曾考虑的备选

不直接改默认模型、强制中断任务或替用户自动同意风险；无法确认的模糊意图先澄清，不猜不存在的型号。

## 后果

自然语言交互和宿主执行边界分离；确认时效、消息去重与宿主兼容必须单独处理，候选出现不证明线上可用。

## 验证与边界

摘要依据当前设计与安全边界，不把其他未提交修改或静态资源返回成功当成线上切换已验收。本轮不发送切换指令。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `plugins/semantic-model-switch/README.md / 设计与选择`；SHA-256：`0abb757f243a484699a0f64e8235c61d8f712fb227f0b36cb4568fceaa677e37`

- `plugins/semantic-model-switch/README.md / 安全边界`；SHA-256：`0a588ed414e2ab51943c5b3293dd3d576431aa5d89c370c74a552b3019a7820b`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。
返回索引

文档渲染保持只读并单列视觉验收

# Agent Note: 文档渲染保持只读并单列视觉验收

Status: implemented

## 问题

Office 转换成功或生成 PNG 并不证明版面、打印范围和业务内容正确，也不应改变客户原件。

## 决策

显式输入与新输出目录，使用独立无头转换和临时副本，验证有效输出、预算及原文件摘要；渲染结果保持待视觉检查状态。

## 曾考虑的备选

不沿用旧 PDF、不覆盖旧输出，不自动转回 GUI，也不把 mock 测试通过视为真实 LibreOffice 集成的可用性证明。

## 后果

失败时能明确拒绝发布成功，源资料保持不变；需要真实转换环境及逐页视觉检查来补足集成边界。

## 验证与边界

来源明确提供合成 PDF 与转换替身测试入口，并列出真实 Office 验证缺口。本轮 Notes 构建不启动转换或读取客户文件。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `docs/wiki/document-render.md`；SHA-256：`50374291196b41a0752d717360aadc7f34f6152db4f160f16b933c59164b28c8`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[程序与客户资料保持明确边界](../architecture/2026-11-06-local-data-boundary.md)
返回索引

报告章节依据冻结证据快照生成

# Agent Note: 报告章节依据冻结证据快照生成

Status: implemented

## 问题

章节直接跟随可变工作资料生成，会让正文和引用难以追溯到同一版本依据。

## 决策

章节工作流先校验计划、事实引用与工作区内来源，再冻结预览和证据快照，后续按读回的快照生成文档及引用对照。

## 曾考虑的备选

不把当前目录全部文件直接当作证据，不让资料检索模块负责报告章节，也不绕过就绪门槛直接 finalize。

## 后果

章节、证据和引用可以按版次核对；真实材料、OfficeCLI 及最终布局仍需各自验证，不因工具存在就宣称报告已交付。

## 验证与边界

来源为报告生成流程页。本轮不打开业务工作区或构建客户报告，记录仅说明既有工作流。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `docs/wiki/feasibility-study.md / 章节生成与证据冻结`；SHA-256：`b7ff5683a78c25841bef958683848f276010d0eb9bceb92c8d7ec83131555d0e`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[资料检索与可研报告生成保持模块边界](2026-11-06-separate-domain-modules.md) · [文档渲染保持只读并单列视觉验收](../testing/2026-11-06-readonly-document-render.md)
返回索引

待补齐：客户端使用同一网关归属契约

# Agent Note: 待补齐：客户端使用同一网关归属契约

Status: proposed

## 问题

目标由独立网关承载、桌面却向共享网关签票，会形成已复现的目标与入口不一致。

## 决策

建议两客户端分别执行相同归属解析与预检，让票据控制入口和 HTTP 请求绑定同一实例；无法确认归属时明确停止，不静默回退 default。

## 曾考虑的备选

不把当前单共享网关拓扑恢复误认为客户端路由逻辑已经修复；不另增代理服务，也不只修改票据 Profile 而继续沿用旧地址。

## 后果

预期减少共享与独立模式的入口错配；需要分别适配两个客户端及实例变化后的发现，本提案尚未实现或部署。

## 验证与边界

来源明确将建议与当前恢复方案区分。历史隔离反例不能代替新归属契约实现后的验证，本轮不修改任何网关或桌面程序。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `plugins/profile-login/GATEWAY_ARCHITECTURE.md / 建议：两端执行同一份归属规则`；SHA-256：`fa0f6b4d7c1e843d44d8ab2ff641068c869906b758165806ef48052104fe7a0e`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。

## 关联记录

[配置工作区沿用原生聊天与会话运行时](../../implemented/feature/2026-11-06-native-profile-workspace.md)
返回索引

本阶段未采用：全量迁移到第三方笔记树

# Agent Note: 本阶段未采用：全量迁移到第三方笔记树

Status: rejected

## 问题

希望得到统一浏览入口，但完整迁移现有 Wiki、复盘和记忆会引入新的归属及同步负担。

## 决策

当前吸收决策记录方法并保留原文归属，仅生成选定摘要的看板。完整技能、冻结状态机及历史迁移不是本轮采用路径。

## 曾考虑的备选

已评估直接安装或完整引入第三方体系；其目录契约、运行环境、交互约定与许可文件核验仍需处理。状态 rejected 指本阶段未采用，不表示永久否定上游项目。

## 后果

不搬迁旧记录，不维护平行权威树；集中浏览覆盖范围由当前目录明确限定，未来需要扩大时逐条复核，不称为已完成全量历史整理。

## 验证与边界

依据已写入的接入评估。上游界面与生成器只在本机忽略目录使用，没有作为源码纳入 Git，也未据此补造任何归档历史。

## 来源与复核

整理日期：2026-11-06。日期表示本次复核，不冒充历史发生时间。

- `docs/integrations/write-notes-like-deepseek-evaluation.md / 结论`；SHA-256：`b8c4955796089ed0bfe886acb1d73e3ccfdfb3bc2bfe15ba7eb656910bac0d92`

来源仅用于本次人工摘要复核；来源指纹不证明摘要语义正确，也不代替模块运行验收。
返回索引