ydflow · Nov 8, 2026 · Nov 8, 2026
diff --git a/.github/ISSUE_TEMPLATE/01-bug-report.yml b/.github/ISSUE_TEMPLATE/01-bug-report.yml
@@ -0,0 +1,74 @@
+name: "缺陷反馈 / Bug report"
+description: "报告可复现的运行、会话、界面或恢复问题"
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        请先搜索已有 Issue。填写最小复现，日志和截图请去除 API Key、账户、个人持仓与私人内容。
+        数据价格、财报或来源异常请使用「数据质量」表单；长期规划请使用「功能建议」或「研究提案」。
+  - type: input
+    id: version
+    attributes:
+      label: "Trail 版本或 commit"
+      placeholder: "应用版本 / git rev-parse --short HEAD"
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: "操作系统"
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - 其他（请在环境中说明）
+    validations:
+      required: true
+  - type: dropdown
+    id: runtime
+    attributes:
+      label: "Runtime"
+      options:
+        - local
+        - Pi
+        - 不确定
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: "环境与运行方式"
+      description: "说明系统版本、打包应用或源码启动、Bun/Node（如适用）、模型与数据 provider、真实或模拟数据。不要填写密钥。"
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: "最小复现步骤"
+      placeholder: |
+        1. 从哪个页面或状态开始
+        2. 做了什么操作
+        3. 在哪一步出现问题，是否稳定复现
+    validations:
+      required: true
+  - type: textarea
+    id: expected-actual
+    attributes:
+      label: "期望与实际结果"
+      description: "说明对任务或数据的影响；恢复问题请注明是否涉及重启、取消或配置变更。"
+    validations:
+      required: true
+  - type: textarea
+    id: evidence
+    attributes:
+      label: "脱敏日志、截图或最小样例"
+      description: "可粘贴错误信息或上传已脱敏截图。没有日志也请保留清楚的复现步骤。"
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: "提交前检查"
+      options:
+        - label: "我已搜索已有 Issue，并移除凭证与不宜公开的个人数据。"
+          required: true
diff --git a/.github/ISSUE_TEMPLATE/02-feature-request.yml b/.github/ISSUE_TEMPLATE/02-feature-request.yml
@@ -0,0 +1,54 @@
+name: "功能建议 / Feature request"
+description: "描述真实场景、预期价值与最小可交付范围"
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        请先查看置顶 Roadmap。欢迎补充场景与取舍；被记录为计划不等于承诺上线日期。
+  - type: dropdown
+    id: area
+    attributes:
+      label: "建议方向"
+      options:
+        - 投研工作台与数据
+        - 独立助手与会话体验
+        - 个人目标与长期任务
+        - 记忆与任务恢复
+        - 连接器与自动化
+        - 开发体验与文档
+        - 其他方向
+    validations:
+      required: true
+  - type: textarea
+    id: scenario
+    attributes:
+      label: "谁在什么场景遇到了什么问题"
+      description: "请说明现在如何完成这件事、哪里费时或容易出错。"
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: "期望结果与项目价值"
+      description: "描述用户能完成什么，以及怎样判断比现状更好。"
+    validations:
+      required: true
+  - type: textarea
+    id: minimal-scope
+    attributes:
+      label: "最小实现与替代方案"
+      description: "哪些是第一步必须有的？哪些可以留到后续？如有示意图可附上。"
+    validations:
+      required: true
+  - type: textarea
+    id: boundaries
+    attributes:
+      label: "依赖、授权与数据边界"
+      description: "是否需要新 provider、个人资料、外部写操作、付费服务或长期后台运行？不确定可写待讨论。"
+  - type: textarea
+    id: related
+    attributes:
+      label: "关联 Issue 与参与意愿"
+      description: "链接已有规划，说明是否愿意补充场景、设计、实现或验证。"
diff --git a/.github/ISSUE_TEMPLATE/03-data-quality.yml b/.github/ISSUE_TEMPLATE/03-data-quality.yml
@@ -0,0 +1,50 @@
+name: "数据质量 / Data quality"
+description: "报告行情、财报、新闻、时间戳、来源与引用异常"
+title: "[Data] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        数据问题需要对齐标的、时间与来源。请使用可公开的最小样例，避免上传账户和私人持仓。
+        尚未核实原因时，我们会先区分 provider 原始数据、适配计算、展示与模型解释。
+  - type: input
+    id: version-provider
+    attributes:
+      label: "Trail 版本与数据 provider"
+      placeholder: "版本 / provider / 真实或模拟数据 / runtime（如涉及助手）"
+    validations:
+      required: true
+  - type: input
+    id: symbol
+    attributes:
+      label: "标的、市场与数据项"
+      placeholder: "例如 AAPL.US；日线收盘价、财报字段、新闻引用"
+    validations:
+      required: true
+  - type: input
+    id: time
+    attributes:
+      label: "发生时间、数据时间与时区"
+      placeholder: "分别注明观察时间与行情/财报时间；不确定的时间请标记"
+    validations:
+      required: true
+  - type: textarea
+    id: mismatch
+    attributes:
+      label: "实际值、期望值与核对依据"
+      description: "列出单位、币种、复权/周期等口径，以及可公开来源链接；不要仅写“数据不对”。"
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: "复现步骤与脱敏样例"
+      description: "从哪个页面或工具获得？是否刷新后仍发生？原始响应可只保留最小相关字段。"
+    validations:
+      required: true
+  - type: textarea
+    id: impact
+    attributes:
+      label: "影响范围与证据"
+      description: "是展示、计算还是助手结论受影响？可附已脱敏截图或日志。"
diff --git a/.github/ISSUE_TEMPLATE/04-research-proposal.yml b/.github/ISSUE_TEMPLATE/04-research-proposal.yml
@@ -0,0 +1,52 @@
+name: "研究提案 / Research proposal"
+description: "讨论 Personal Agent、Memory、Harness²、RSI 与优化实验"
+title: "[Research] "
+labels: ["type:research", "status:research"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        欢迎宏大的方向，也请给出能被证伪的小实验。研究提案不是已实现能力或效果承诺。
+        请区分原论文、自己的适配设计与实际结果。没有结果时明确写「尚未运行」。
+  - type: textarea
+    id: hypothesis
+    attributes:
+      label: "问题、价值与可证伪假设"
+      description: "想改进什么？在什么条件下会认为假设不成立？"
+    validations:
+      required: true
+  - type: textarea
+    id: references
+    attributes:
+      label: "研究来源与创新边界"
+      description: "提供论文/代码版本链接，区分复现、工程适配和新增设计；无外部来源可写原创提案。"
+    validations:
+      required: true
+  - type: textarea
+    id: experiment
+    attributes:
+      label: "最小实验、基线与隔离评测"
+      description: "说明数据划分、任务/模型/工具权限、等预算对照、种子与重复次数，防止留出集泄漏。"
+    validations:
+      required: true
+  - type: textarea
+    id: metrics
+    attributes:
+      label: "指标、成本与停止条件"
+      description: "分别报告正确性、证据、恢复、费用、延迟和权限风险；定义无收益/退化时如何停止。"
+    validations:
+      required: true
+  - type: textarea
+    id: safety
+    attributes:
+      label: "可修改对象、授权与回滚"
+      description: "说明 prompt/skill/配置等边界、沙箱限制、候选晋升方式和凭证/个人数据处理。"
+    validations:
+      required: true
+  - type: textarea
+    id: results
+    attributes:
+      label: "当前结果、失败案例与关联任务"
+      placeholder: "尚未运行 / 已运行的命令、样本数和结果 / 关联 Issue / 准备认领的最小范围"
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: "使用与贡献入口"
+    url: "https://github.com/ydflow/Trail/issues/7"
+    about: "安装、反馈、任务认领与首次贡献说明"
+  - name: "Personal Agent Roadmap"
+    url: "https://github.com/ydflow/Trail/issues/8"
+    about: "Checkpoint × Memory、个人工作流与 Harness² × RSI 长期规划"
+  - name: "当前能力与验证边界"
+    url: "https://github.com/ydflow/Trail/issues/9"
+    about: "区分已有基础、验证范围与尚待实现的能力"
diff --git a/docs/ROADMAP.zh-CN.md b/docs/ROADMAP.zh-CN.md
@@ -0,0 +1,108 @@
+# Trail · Personal Agent Roadmap
+
+> 更新：2026-11-08。规划入口：[#8](https://github.com/ydflow/Trail/issues/8) · [贡献指南](../CONTRIBUTING.md) · [能力地图](https://github.com/ydflow/Trail/issues/9)
+
+## 愿景：从投研工作台走向真正的 Personal Agent
+
+**让每一次研究成为下一次行动的起点，让每一个长期目标拥有可持续的执行上下文。**
+
+Trail 希望成为个人与数字世界之间的长期协作层：既能理解目标与偏好，也能把任务推进到可核验的结果；既能在中断后继续，又能从经验中提炼更合适的工作方式。投研是起点，长期目标是服务个人研究、知识整理、项目推进与日常工作。
+
+我们希望形成的价值飞轮是：**可靠执行积累可信轨迹 → 轨迹沉淀可控记忆 → 记忆帮助任务适配 → 经过评测的经验改善后续执行。**
+
+> 状态：未来规划 / 研究议程。下列通用个人记忆、持久个人任务与自我改进体系尚未完整实现。阶段按验收结果推进，不承诺上线时间或必然性能提升。当前基础见能力地图。
+
+## 四个阶段
+
+| 阶段 | 希望交付的能力 | 完成信号 |
+| --- | --- | --- |
+| [M1 · Durable Personal Core](https://github.com/ydflow/Trail/milestone/1) | 参考 Pi Durable，统一任务图、checkpoint、工具重放与故障恢复 | 可重复的跨进程恢复；解释每个副作用的不确定边界 |
+| [M2 · Memory × Checkpoint](https://github.com/ydflow/Trail/milestone/2) | 进度与记忆版本联合管理；偏好、事实、经历和方法可纠正、可遗忘 | 恢复不串版本，记忆有来源，删除不因旧任务而复活 |
+| [M3 · Personal Workflows](https://github.com/ydflow/Trail/milestone/3) | 个人目标、任务收件箱、持久调度、授权连接器与每日简报 | 在真实授权场景中完成可追溯工作闭环，并记录成本和人工修订 |
+| [R1 · Harness² × RSI Research](https://github.com/ydflow/Trail/milestone/4) | 双层递归适配、离散组合评分、连续参数协方差适应与受控晋升 | 留出集、等预算基线、消融与可复现实验支持结论，负结果同样公开 |
+
+M1 是下一步优先级；M2/M3 在基础契约稳定后渐进展开。R1 的文献与离线实验可先讨论，实际融合依赖可靠执行、记忆与评测基础。
+
+## 长期架构蓝图
+
+```mermaid
+flowchart TD
+  U["个人目标与用户授权"] --> T["任务图与持久执行内核"]
+  T <--> C["Checkpoint：进度、结果、预算"]
+  C <--> M["Memory：来源、版本、偏好与经验"]
+  T --> W["个人工作流与证据产物"]
+  W --> E["脱敏轨迹与隔离评测"]
+  E --> H["Harness²：任务内适配与经验提炼"]
+  E --> R["RSI：跨任务候选与版本改进"]
+  H --> S["离散组合评分 + 连续参数协方差适应"]
+  R --> S
+  S --> G["回归验证、人工审核与回滚"]
+  G --> T
+```
+
+图中是拟议架构，不代表这些模块已全部接通。
+
+### 为什么 Checkpoint × Memory 是主线
+
+Checkpoint 回答“做到哪里、哪些结果已经提交”；Memory 回答“用户是谁、依据什么、有哪些可复用经验”。融合需要联合版本、来源引用和冲突处理，而不只是把聊天摘要附到恢复文件。目标是在应用重启、用户纠正或目标变更后，仍能清楚解释继续执行的依据。
+
+### Harness² × RSI 如何融合
+
+- **任务内层**：参考 Harness² 的 Propose–Probe–Compose，让当前任务的执行方式进行有预算的适配，并提取适用条件。
+- **跨任务层**：以受控 RSI 循环生成 prompt、skill、hook、流程或配置候选，经隔离评测、人工审核后版本化晋升。
+- **离散选择层**：研究 Skill × Tool × Workflow × Model 的组合，显式约束兼容性、权限和费用；这不是证券组合优化。
+- **连续优化层**：探索协方差矩阵适应，用于低维连续参数，如检索阈值或预算比例；类别选择仍由离散方法处理。
+- **验证层**：分别测量正确性、证据、恢复、人工纠正、费用、延迟和权限违规。组合模块必须通过消融实验说明贡献。
+
+这是 Trail 的工程研究提案。我们不会把协方差更新等同于智能递归提升，也不会把论文结果当作本项目结果。模型权重训练、无限制自改写和自动生产晋升均不属于当前研究交付。
+
+## 任务索引
+
+所有条目均为待验收工作。前置依赖、源码起点与最小贡献范围见各 Issue。
+
+### M1 · Durable Personal Core
+
+- [ ] [#10 · Pi Durable 适配：为 Personal Agent 建立持久执行内核](https://github.com/ydflow/Trail/issues/10)
+- [ ] [#11 · 统一 Goal / Project / Task / Run / Step 状态与任务图](https://github.com/ydflow/Trail/issues/11)
+- [ ] [#12 · 将 Checkpoint 扩展到普通助手与长任务](https://github.com/ydflow/Trail/issues/12)
+- [ ] [#13 · 工具副作用日志与重放策略：区分读取、幂等写入和人工确认](https://github.com/ydflow/Trail/issues/13)
+- [ ] [#14 · Durable 任务故障注入与恢复一致性测试矩阵](https://github.com/ydflow/Trail/issues/14)
+- [ ] [#15 · 会话导入导出与重启后草稿恢复](https://github.com/ydflow/Trail/issues/15)
+- [ ] [#34 · 补充开发启动与常见问题排查手册](https://github.com/ydflow/Trail/issues/34)
+- [ ] [#35 · 研迹助手键盘操作、可访问性与窄窗口审计](https://github.com/ydflow/Trail/issues/35)
+- [ ] [#36 · 建立能力与 Provider 覆盖矩阵：让项目价值有证据可查](https://github.com/ydflow/Trail/issues/36)
+
+### M2 · Memory × Checkpoint
+
+- [ ] [#16 · 个人长期记忆模型：偏好、事实、经历与方法](https://github.com/ydflow/Trail/issues/16)
+- [ ] [#17 · Checkpoint × Memory 一致性：让恢复进度与记忆版本同步](https://github.com/ydflow/Trail/issues/17)
+- [ ] [#18 · 记忆候选写入、用户确认与纠正入口](https://github.com/ydflow/Trail/issues/18)
+- [ ] [#19 · 可解释检索基线：相关性、时效、来源与上下文预算](https://github.com/ydflow/Trail/issues/19)
+- [ ] [#20 · 经历整合与经验提炼：保留原始证据的分层记忆](https://github.com/ydflow/Trail/issues/20)
+- [ ] [#21 · 记忆遗忘、导出与派生数据失效机制](https://github.com/ydflow/Trail/issues/21)
+
+### M3 · Personal Workflows
+
+- [ ] [#22 · 个人目标与任务收件箱：从单次问答走向持续协作](https://github.com/ydflow/Trail/issues/22)
+- [ ] [#23 · 持久调度：周期任务、时区与错过触发策略](https://github.com/ydflow/Trail/issues/23)
+- [ ] [#24 · 个人资料能力适配层：先从本地文件与只读日历开始](https://github.com/ydflow/Trail/issues/24)
+- [ ] [#25 · 个人每日简报：目标、待办与研究证据的统一视图](https://github.com/ydflow/Trail/issues/25)
+- [ ] [#26 · 动作审批中心：预览、确认、执行结果与撤销边界](https://github.com/ydflow/Trail/issues/26)
+- [ ] [#27 · 记忆地图与任务运行视图：看得见的个人助理状态](https://github.com/ydflow/Trail/issues/27)
+
+### R1 · Harness² × RSI Research
+
+- [ ] [#28 · 版本化任务轨迹与隔离评测集：为自我改进建立证据基座](https://github.com/ydflow/Trail/issues/28)
+- [ ] [#29 · 离散组合评分：评估 Skill × Tool × Workflow × Model 的协同配置](https://github.com/ydflow/Trail/issues/29)
+- [ ] [#30 · 协方差矩阵适应：探索连续 Harness 参数的递归优化](https://github.com/ydflow/Trail/issues/30)
+- [ ] [#31 · Harness² 双层递归：任务内 Propose–Probe–Compose 与跨任务经验](https://github.com/ydflow/Trail/issues/31)
+- [ ] [#32 · 受控 RSI 外循环：候选生成、沙箱评测、审核晋升与回滚](https://github.com/ydflow/Trail/issues/32)
+- [ ] [#33 · Harness² × RSI 融合实验：离散组合、协方差适应与长期记忆的消融验证](https://github.com/ydflow/Trail/issues/33)
+
+## 参与方式与研究来源
+
+欢迎从接口设计、故障案例、离线夹具、交互审计与文档入手。先评论说明最小范围，再使用 `/claim` 认领；前置任务未完成时，可先做设计和 PoC，不承诺完整集成。
+
+- [Pi Durable 官方文档](https://github.com/earendil-works/pi/blob/main/packages/durable/README.md)：参考持久执行设计；上游标为实验性，采用前需要固定版本并验证兼容性。其 MemoryStorage 不等于个人长期语义记忆。
+- [Harness² 原论文 v1](https://arxiv.org/abs/2610.14224v1)：参考双层递归与任务内对比式修订。Trail 的评分与工程约束是待验证适配，不冒充原论文复现结果。
+- [CMA-ES 官方资料](https://cma-es.github.io/)：连续黑盒优化方法的研究参考，是否适合 Trail 仍需对照实验。