天衍平台建设 · 开发档案
天衍平台自身建设的知行档案——项目背景 / 建设现状 / 建设纪事（大版本更迭与架构变迁总结，一段一段，不与发版日志重复）
🏛️ 项目背景与使命
项目背景：天衍平台是「人与 AI 协作体系」的实体化——以执行为入口、以事件为驱动、以能力复用为目标，践行「知行合一」理念（上行下知、互相循环促进）。
使命：基于 AI 广泛的信息面与推理能力，辅助完成各项工作；在应用 AI 技术功能的过程中，积累可复用的资产能力。
建设目的：把人与 AI 的协作经营成可积累的资产——职业上作为合规情报中枢与决策推演台，个人上作为方法论银行；本档案记录天衍自身的建设过程，建设经验持续沉淀知藏、反哺后续迭代，形成知行循环闭环。
🏗️ 建设纪事
仅记录大版本更迭 / 架构层面改变时的主要完成内容（一段一次总结，按时间倒序）
北京客厅
天衍平台能力答疑 · 记录一次关于 skill 的问答
问：天衍平台能直接使用 skill 吗？比如智慧蛊推演时能利用网页搜索 skill 吗？
现状：不能直接用。
你的推演链路是：智慧蛊输入 → 天衍 server.js → POST /v1/chat/completions（Gateway 纯文本接口）→ 单轮生成返回。
skill 是「Agent 层」的能力，而这条链路是「裸模型接口」——打个比方：skill（网页搜索）是 AI（Agent）的助手团队；天衍调用的 chat/completions 接口，相当于 只给专家打电话，专家没有助手、没有搜索工具，只能凭脑子里的知识回答。skill 的执行需要「读 SKILL.md → 决定调搜索 → 把结果喂回模型」这个 Agent 编排循环，纯文本接口不会触发它。
但完全可以做到，三条路：
方案 A（推荐）：天衍自己内置「联网推演」
· server.js 加一个搜索能力（调 Tavily/Brave 搜索 API），智慧蛊页加个「🌐 联网」开关
· 开启时：先按你的问题搜索 → 把搜索结果拼进提示词 → 再让 AI 基于真实资料推演
· 效果跟「用搜索 skill」一样，但能力属于天衍自己，不依赖 AI
· 需要：搜索 API key（Tavily 有免费额度）
方案 B：推演改走 Agent 会话
· 让 Gateway 侧以完整 Agent 身份跑推演，能用工具
· 技术可行但复杂：天衍要调 Gateway 的会话接口而不是文本接口，延迟也会从 20 秒涨到更久
方案 C：把搜索 skill 包装成 HTTP 接口给天衍调
· 相当于给天衍开一个「代搜」服务，可行但绕
建议：方案 A——先确认服务器上有 Tavily key 没，有的话 10 分钟就能演示「联网推演」：搜完再推，答案带真实来源。
枢机系统 · 中央调度器
行远产生事件，枢机判断响应，知藏提供资产，枢机再将资产调度回行远
⚖️ 协作宪法 效力高于一切规则 · 仅用户本人可改
加载中…
调度记录
规则台账：只记录规则的使用（每次检修/发版触发多少条）与规则的增删改（新增/修改/删除/升降级），只记录不干预
触发规则
按领域组织：顶部选领域，内部按 A核心 / B重要 / C一般 分维度；A=用户底线（AI只执行不提议）｜B=重要（AI提案你拍板）｜C=一般（AI自主留痕）
编译工厂
问题工作台：识别原料中的独立问题 → 勾选有价值的问题编译启示 → 确认收入避坑文档（问题与原料一对多/多对一，不强制耦合产出模块）
🛡 避坑文档 （已确认启示 · 知识库性质，防复发避坑要点）
加载中…
业务资产
凝结产出第一类：报告、方案、文档、汇报材料——可直接交付的成品
📄 业务资产清单
- 电力合规日报 / 周报（见「行远系统 → #02 电力市场与安全认证晨报」）
- 分析报告、方案文档（产出后在此登记）
数字资产
凝结产出第三类：网站源码、程序、数据、图谱和媒体素材——平台自身的技术资产
💾 数字资产清单
网站源码、程序、数据、图谱和媒体素材——平台自身的技术资产：
- 天衍源码与数据（/var/www/tianyan，SQLite logs.db 单一事实源）
- 网站备份（系统管理 → 版本更新日志 → 备份下载）
- 设计文档存档（设计图纸 → 总体设计 → 下载）
设计图纸 · 已实现
已经落地运行的功能——留档备查
总体设计 · 系统蓝图（设计意图：天衍应该是什么）
天衍平台总体设计：核心定义、使命愿景、总体架构
🎯 核心定义
「天衍」是一个以执行为入口、以事件为驱动、以能力复用为目标的个人 AI 工作操作系统。
三个关键词：
· 以执行为入口——一切资产从真实行动中来，先做事，再沉淀
· 以事件为驱动——系统靠事件流转运转（任务→复盘→编译→回流），而非靠人翻菜单
· 以能力复用为目标——沉淀的目的不是存资料，而是让第二次做同类事更快、更稳、更好
🗺 使命与愿景
· 使命：基于 AI 广泛的信息面与推理能力，辅助完成各项工作；在应用 AI 技术功能的过程中，积累可复用的资产能力
· 理念：知行合一——「行」产生「知」，「知」反哺「行」
· 验证命题：第二次做同类工作，是否比第一次更快、更稳、更好
🏛 总体架构
行远系统（行）——项目工作台：所有工作的执行场所
枢机系统（枢）——知行循环的动力装置：定义流转规则，掌控复盘/编译待办
知藏系统（知）——资产沉淀库：原始物料 → 编译工厂 → 凝结产出（业务资产 / 能力资产 / 数字资产）
系统管理（治）——治理底座：版本、备份、权限、设计图纸
设计图纸 · 已归档
当前不用、未来可能恢复——一行行检修记录，随时可复原
待实现
近期规划 + 全部待实现清单——已讨论确定、尚未落地的改造计划
📌 近期规划（V0.3.3，暂缓待启动）
· 顶栏标语：改为「知从行来，能力复用于行」，长文案挪入设计文档
· 任务状态拆两线：任务状态（进行中/已完成）与复盘状态（待复盘/已复盘）分离
· 任务分类拆两维：工作形态（探索推演/明确执行/运行维护）× 执行方式（用户主导/AI协作/AI自动/Skill）
· Wiki 可调用字段：when_to_use / when_not_to_use / recommended_action / 置信度三等级 / 调用与帮助计数
🗂 待实现清单（全部计划）
一、复盘触发器
· 四种触发器：完成（重要任务/里程碑完成）、异常（失败/返工/阻塞/重新打开/人工接管）、版本（软件/规则/Skill/文档发版）、周期（每周批量整理零散经验）
· 一级「记一笔」10 秒反馈：任意页面统一入口，自动记录上下文（当前页面/任务/项目/版本/最近一次AI操作/时间），四类标签（有效经验/出现问题/改进想法/待验证猜想）+ 一句话，存为 feedback_event 不立即整理
· 二级正式复盘：触发条件（重要任务完成/失败返工/问题多次记录/发版前/系统判断高价值）；复盘四项——目标与结果差异、值得保留、需要避免、下次改变什么具体动作（必须形成可执行变化）
· 反馈处理队列：待处理 → 纳入当前版本 / 进入后续版本 / 转为任务 / 转为知识原料 / 与已有反馈合并 / 忽略并说明原因
二、能力资产层
· Skill 注册表：版本化执行能力（身份：name/desc/version/status/domain/tags；调用条件：trigger/preconditions/exclusions/inputs/permissions；执行定义：steps/tools/prompt/output/副作用/回滚；评价：成功标准/测试用例/调用数/成功数/人工接管数/最近运行/置信度）
· Skill 生命周期：候选 → 草拟 → 试运行 → 正式 → 限制使用 → 废弃 → 归档
· 沉淀三条件：频率 × 稳定性 × 杠杆率（重复 3 次只是候选提示，不是准入标准）
· 置信度三等级：待验证 / 试用中 / 已验证（后台记录客观数据：使用/成功/失败/人工接管/最近成败原因；区分内容可信度、执行可靠度、适用可信度）
· 任务原型 Task Archetype（原任务画像）：常见输入/标准目标/常见步骤/风险/输出模板/适用Skill/强制规则——新任务进入即知道怎么规划、调什么、用什么标准验收
三、编译流程改造
· 编译重新定义：判断一份原料应如何改变现有知识，而非默认新建知识
· 流程：原料进入 → 去重与关联 → 识别主题 → 判断处理动作 → 生成知识变更提案 → 用户审核差异 → 发布
· AI 动作九选一：忽略 / 仅归档 / 关联现有知识 / 补充 / 修正 / 标记知识冲突 / 创建新页 / 生成 Skill 候选 / 生成规则候选
· 审核看差异不重读全文：原知识 vs AI 建议修改 + 新增依据 + 修改原因；动作：接受 / 修改后接受 / 拒绝 / 暂缓 / 标记冲突
· 防积压五机制：①原料状态扩展（new/queued/linked/compiled/ignored/obsolete/blocked）②按需编译（新任务时提示相关未编译原料）③编译优先级（重复次数×复用概率×出错影响×时间敏感度÷审核成本）④主题批量编译（先聚类再提案）⑤在制品上限（审核队列最多 10 条，达上限暂停生成草稿）
四、事件驱动架构
· events 事件表：统一事件流（task.created → task.completed → review.submitted → raw.created → compile.requested → knowledge.published → task.planning），含 actor/payload/source_event_id
· 枢机系统从说明页变运行时引擎：监听事件 / 判断触发条件 / 创建待处理事项 / 推动状态流转 / 记录自动化执行结果 / 异常兜底
· trajectories 作为任务事件的聚合视图（而非唯一轨迹来源）
· 一句话：枢机页面是驾驶舱，事件与规则引擎才是发动机
五、知识回流
· 两阶段召回：第一阶段确定性规则（项目一致性+任务形态+阶段+显式标签+知识状态+最近验证时间）→ 第二阶段语义排序；第一版用 SQLite 全文检索，不引向量库
· 知识在工作现场出现：规划前任务预检（发现 N 条相关历史经验，每条一句话结论+为什么推荐+上次使用）／执行中阶段提示（相关规则/踩坑，如发布检查清单）／完成后效果评价（有帮助/无帮助/不适用/过时）
· 回流闭环：推荐 → 采用 → 执行 → 评价 → 更新排序（不只是发布→标签匹配→展示链接）
六、行远运作
· 四级工作结构：项目 → 里程碑 → 任务 → 步骤（界面每次只暴露两级；任务是核心管理单位——可独立开始/暂停/完成、有明确结果、值得记录摘要）
· 项目内三视图：路线图（目标与里程碑）/ 任务板（当前执行事项）/ 项目记忆（项目知识、决策、踩坑、产物）
· 任务入口在项目页内（收件箱已确认不做）
· Artifacts 不做独立资产库，先作为项目交付物视图
七、最小核心闭环（V0.4.0 蓝图）
项目页录入 → 形成明确任务 → 执行并记录关键事件 → 10 秒反馈或正式复盘 → 原料存档 → AI 提出知识变更 → 用户审核差异 → 下一个相关任务自动收到知识提示 → 用户评价提示是否有效
闭环跑通后，Skill、规则、任务原型、自动化才有可靠数据来源；闭环不通，继续加资产层只会扩大库存
⏸ 延后 / 不做
· 延后：项目≠菜单重构（等项目多到侧栏拥挤再动）、Skill 完整生命周期、任务原型管理页、完整知识图谱、复杂向量召回基础设施、精确置信度公式、多角色审批流、Skill 市场/Skill 包分发、全自动跨项目规划、大规模 Artifacts 分类体系
· 不做：收件箱（已确认删除，任务入口在项目页内）
天衍全景
行远 · 知藏 · 系统管理——平台全貌，一眼看尽
行远系统 · 项目工作台
🛠️
#01 天衍平台建设
开发档案 · 版本迭代与经验沉淀
⏰
#02 电力市场与安全认证晨报
自动化 · 03:00 定时推送
📰 最新要情
加载中…
复盘 · 编译 · 沉淀
枢机系统
知行循环 · 动力装置
⚖️ 宪法
-
知识回流 · 指导再行
智慧蛊 #00 · 思考沙盘
给起点、终点或方向，加上约束条件，让智慧蛊为你炼出可行路径
① 起点 → 终点拆解路径
② 起点 → 方向穷举可能
③ 终点 ← 反推反推起点
已知起点 A 与终点 B，拆解可行路径
约束讲得越清楚，路径越贴合实际
智慧蛊推演中，请稍候…
我的约束画像 （长期有效，脱敏后自动附加到每次推演，越用越准）
AI资产库 · 记忆画像
四份记忆文件的实时梗概（SOUL 人格 / USER 用户画像 / AGENTS 行为纲要 / MEMORY 记忆梗概），文件变更后自动同步更新，均可一键导出 .md
版本更新日志
天衍平台每一次迭代的记录，点击条目展开/收起修改内容
💾 网站备份 （每 5 次更新自动留一份，自动最多 10 份；手动备份另算最多 3 份，共 13 槽，可下载）
加载中…
电力市场与安全认证晨报
晨报定时推送任务：每天 03:00 自动生成并推送（电力交易新规/电子认证服务/身份假冒与抵赖/数据泄露与篡改/安全认证合规），03:30 巡检兜底，04:00 送达巡检
暂无定时任务
技能管理
当前安装的全部技能，可同步刷新、下载备份；下方为编译工厂确认的「设计产出成果」
暂无技能
✨ 设计产出成果 （编译工厂确认沉淀，待落地为真技能时在对话里执行）
Agent 开发
V1.0.0 技术路线：自研 Agent（宪法先行 · 四层执行强度设计法）——开发材料、封板存档与设计产出归档处
📦 V0.3.77 全量封板包
天衍 V0.3.x 系列 94 版全量存档（8.1M）——前后端源码、logs.db（6 天对话全文 + 规则库 31 条 + 记忆画像）、seal-20260810 材料包（版本日志 95 条 / 编译问题 10 个 / 复盘材料）
迭代循环
复盘 → 沉淀 → 再出发：推演存档与资产库同源联动，每一次循环都比上一次强