init

docs/02-计划/计划-分仓管理工具.md

@@ -0,0 +1,35 @@
+# 计划：分仓管理工具（阶段航点）
+
+> 编号：PLAN-001 ｜ 粒度：阶段航点（大粒度） ｜ 创建：2026-08-27 ｜ 状态：进行中
+> 派生自终极目标：目标-001（DSH 插件形态）、目标-008（真实交易系统接入）、目标-002（策略定义能力）
+> 依据需求：**R-002（已定稿，2026-08-27）** —— 符合入范围门槛
+
+## 目标
+
+实现「分仓管理工具」：在 DSH 中通过插件设置维护持仓策略（策略=标签，含显示/隐藏开关），在主窗口上方 tab 栏（对话/轨迹/上下文后）按设置显示策略标签，每个标签下加载对应持仓数据；QMT 提供全量真实持仓，策略分仓数据本地存储管理。
+
+## 范围
+
+**做**：
+1. 插件设置管理能力（ctx.settings 注册）：策略（标签）CRUD + 显示/隐藏开关；
+2. 主窗口上方 tab 栏扩展：在「对话/轨迹/上下文」后添加策略标签 tab，每个 tab 加载对应持仓数据；
+3. 数据处理与存储：QMT 读全量持仓；策略分仓数据本地持久化（JSON/DSH 数据目录）；
+4. 数据源抽象（QMT Bridge MCP 适配器，技术约束-001）。
+
+**不做**（本期）：
+- 网格参数管理（区间/格距/档位）—— 后续；
+- 做T 交易记录 —— 后续；
+- 风控规则引擎 —— 后续；
+- 下单交易（纯只读）；
+- 策略仓复杂聚合（市值/盈亏占比）—— 后续。
+
+## 实现方式
+- 独立插件仓库（one_divine_lot），作为**外部插件**挂载到 DSH 宿主；
+- 客户端 UI 扩展（tab 栏）需修改 DSH 宿主 composition 加载 client 插件（遵循 editing-cordis-compositions 技能）。
+
+## 验收标准（待迭代细化）
+1. DSH 设置中出现「神之一手」设置管理，可添加策略（标签）、配置显示/隐藏；
+2. 主窗口上方 tab 栏出现策略标签（在对话/轨迹/上下文后），按设置显示/隐藏；
+3. 每个标签下加载对应持仓数据（QMT 全量持仓按策略归属过滤）；
+4. 策略配置与分仓数据本地持久化，重启不丢失；
+5. QMT 全量持仓读取正常（真实数据）。

docs/02-计划/计划-分仓管理工具完善与优化.md

@@ -0,0 +1,55 @@
+# 计划：分仓管理工具完善与优化（阶段航点）
+
+> 编号：PLAN-002 ｜ 粒度：阶段航点（大粒度） ｜ 创建：2026-08-28 ｜ 状态：待执行
+> 派生自终极目标：目标-001（DSH 插件形态）、目标-002（策略定义能力）
+> 依据需求：**R-003（已定稿，2026-08-28）** —— 符合入范围门槛
+> 设计约束：产品约束-002/003/004、技术约束-001~007
+
+## 目标
+
+对 R-002 分仓管理工具进行完善与优化：O2 策略 tab 动态化、O3 策略 CRUD 设置界面、O5 数据加载失败兜底提示+重试、O6 份额快捷操作。将「分仓管理」从写死的 3 tab 形态升级为「策略配置驱动 + 完整策略管理 + 健壮加载体验」的可用工具。
+
+## 范围
+
+**做**（对应 R-003 定稿范围）：
+1. **O2 策略 tab 动态化**：
+   - tab 由服务端策略配置驱动（进入/设置变更后重新拉取策略配置）；
+   - 隐藏策略的 tab 不显示；
+   - 策略变更后提示用户手动刷新（不做自动广播/轮询）；
+2. **O3 设置界面完善（策略 CRUD）**：
+   - 新增策略（自动生成英文 id slug）；
+   - 重命名策略（分配数据挂 id 不挂名称，改名不影响）；
+   - 删除策略（弹窗确认 + 份额回未分配，产品约束-004）；
+   - 排序（上移/下移按钮）；
+   - 预置策略（网格超市/手动做T）可删除，彻底自由；
+   - 保留显示/隐藏开关；
+3. **O5 数据加载失败兜底**：
+   - 页面/表格数据加载失败 → 显示常规失败提示（含原因）+ 重试按钮；
+   - 自动重试 2 次（间隔 2s），仍失败显示提示 + 手动重试；
+   - 超时（15s 可配置）给出提示；
+   - **非数据源状态监控**（不引入全局状态栏）；
+4. **O6 份额编辑体验**：
+   - 单票「全部移入」：该票未分配份额全部移入当前策略（行内操作）；
+   - 策略「一键清零」：当前策略内全部移出（弹窗确认）；
+   - 保留 step=100 步进 + 手动输入任意值；
+   - 操作反馈：顶部轻提示（成功绿/失败红，3s 消失）。
+
+**不做**（本期）：
+- O1 持仓信息补全（现价/市值/盈亏列展示）—— 后续评估；
+- O4 数据实时刷新（定时轮询 / WebSocket）—— 后续；
+- T-005 WebSocket 实时推送 —— 不转正，留草稿；
+- 数据池/数据集中间层 + 动态字段配置（T-006 草稿）—— 独立需求另行讨论；
+- 表格列可配置 —— T-006 落地前保持代码写死；
+- 网格参数管理、做T 记录、风控 —— 后续。
+
+## 实现方式
+- 沿用独立插件 one-divine-lot，服务端（src/index.js、api.js、settings.js、position/manager.js）+ 客户端（src/client/）改造；
+- 遵循技术约束-004（webServer 自开路由）、-005（客户端 bundle ModuleLoader 包装）、-006（slots.register 第二参数）、-007（dsh plugin add 安装）；
+- 涉及客户端 UI 改造，遵循技术约束-005/006。
+
+## 验收标准（迭代细化）
+1. 设置中增删改/隐藏策略后，主窗口 tab 栏同步更新（手动刷新提示出现）；
+2. 策略 CRUD 完整可用：新增（自动 id）、重命名、删除（弹窗确认 + 份额回未分配）、排序、显隐；
+3. 数据加载失败时显示失败提示（含原因）+ 重试按钮，重试后恢复；
+4. 份额操作支持「全部移入」（单票）与「一键清零」（弹窗确认），操作有轻提示反馈；
+5. 现有功能（全部持仓/策略持仓展示、份额分配、本地持久化）不回归。

docs/02-计划/说明.md

@@ -0,0 +1,31 @@
+# 02-计划（Plans）
+
+> 目标分解后的执行方案：接下来具体做什么、按什么顺序做。支持不同粒度 —— 从大粒度的阶段航点到可直接执行的小任务。
+
+## 角色
+
+把"终极目标"分解为可执行方案的载体。计划是开发动作的直接依据，同一目录下支持不同粒度：大粒度计划（阶段航点）与小粒度计划（可直接执行的任务）本质相同，只是范围大小不同，用粒度标记区分。
+
+## 强约束（初始定义）
+
+1. **必须从终极目标派生**：计划中的每一项内容都要能追溯到终极目标的某条条款；无源任务不允许进入计划。
+2. **范围明确**：每项任务有明确的范围描述（做什么、不做什么）。
+3. **验收标准明确**：每项任务有可验证的完成标准。
+4. **计划外不做**：计划未覆盖的事情不做；想做先进需求池走流程。
+5. **入范围门槛**：**只有确定的需求才可进入计划范围**；讨论中、未确定的需求停留在需求池，不得纳入计划。
+6. **计划可调整**：计划允许调整，但调整必须记录理由，且调整后仍满足约束 1-3。
+
+## 渐进明细（Progressive Elaboration）
+
+> 本目录支持「渐进明细」的工作方式（2026-08-27 老师确立，源自终极目标工作原则）：
+
+1. 计划允许从**周边工具**起步，在实际使用中逐渐展开为完整计划；
+2. 每个已完成的小任务都是下一轮计划细化的输入；
+3. 计划粒度标记：阶段航点（大粒度）与小任务（小粒度）并存，随实践推进细化。
+
+## 待讨论细节
+
+- [ ] 粒度的区分方式（如何标记阶段航点 vs 小任务，是否用前缀/标签/层级）
+- [ ] 验收标准的写法模板
+- [ ] 计划与迭代记录如何对应（计划如何被标记为"已执行/已记录"）
+- [ ] 计划的时效（一个计划管多久？过期怎么办？）