MasterBenC/shangshi-dsh

商时

商时提供两个独立入口：apps/web 是独立网页，包根目录是可安装到 DeepSeek Harness 的自包含插件。它们共享确定性奇门排盘、商务评分、未来择时推荐和方位建议。

Harness 插件

使用固定的不可变标签安装：

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:MasterBenC/shangshi-dsh

安装后重启已有的 Harness web 服务。插件会在 Harness 工作台提供本地手动计算工具；对话仍使用用户在 Harness 中配置的模型。详细的安装、更新和移除步骤见 Harness 安装指南，版本要求见 Harness 兼容性说明。

需要介绍给其他用户时，可直接使用 商时 Harness 插件推广简介。

本地运行

需要 Node.js 24。

1. 运行 corepack enable 启用仓库声明的 pnpm 版本。
2. 运行 pnpm install --frozen-lockfile 安装锁定依赖。
3. 运行 pnpm run dev 从仓库根目录启动本地网页。
4. 打开 http://127.0.0.1:3000。

验证

- pnpm run verify:web：从仓库根目录运行网页版代码规范、类型、单元测试和生产构建。
- pnpm run test:e2e:web：从仓库根目录运行网页版电脑和手机尺寸浏览器流程。

Harness 工具输入与取消约定

- shangshi_analyze 的基础参数结构由 Harness 先行校验。缺少 mode、无效 activity、或结构不完整的 dateTime 返回 Harness INVALID_ARGS。
- 参数通过基础结构校验后，再由商时按模式校验字段组合。跨模式字段、多余字段及日期语义错误返回商时 INVALID_INPUT。
- 调度前已取消的调用返回 Harness ABORTED_BEFORE_DISPATCH；调度后的本地计算在线程中执行，可被真正中断并返回商时 ANALYSIS_CANCELLED。

已完成能力

- 页面按照固定的 时家转盘拆补法 v1 生成奇门九宫盘。
- 所有计算使用北京时间；23:00 起使用次日的日柱。
- 展示四柱、节气、局数、旬首、值符值使、九星、八门、八神、天地盘干、中宫寄宫，以及空亡、驿马、门迫、击刑、入墓、伏吟/反吟、五不遇时等机械标记。
- 支持五类商务事项：合同签署、开业启用、商务谈判、客户会面、项目启动。
- 支持三种分析模式：现在分析、指定时间、未来择时。
- 未来择时默认扫描商务时段 07:00-21:00，也可以选择全天；单次最多 90 个北京时间自然日。
- 商务评分使用固定规则和硬风险上限，结果展示总分、等级、有利条件、风险提示、评分上限和逐条评分依据。
- 方位建议只提供方向类别和适合的场所类型，不提供地图、定位或路线。

版本与边界

- Harness 插件包为 shangshi@0.1.0，安装标签为 dsh-v0.1.0；核心包为 @shangshi/core@0.1.0。
- 评分引擎固定为 business-score-1.0.0。
- 奇门引擎固定为 qimen-1.0.0，规则配置为 shijia-zhuanpan-chaibu-v1。
- 历法内核固定为 calendar-1.0.0。
- 页面会显示“传统术数参考，不替代商业判断”。
- 当前版本不采集生辰信息，不使用 AI 参与排盘、评分、排序、时间选择或方位选择。
- Harness 插件的手动工作台计算在本地完成，不依赖商时服务器；插件运行时不会请求商时服务器。
- 当前版本没有地图、定位、数据持久化、案例管理、报告和正式部署。

如发现盘面或评分差异，请一并提供页面显示的排盘引擎版本和评分引擎版本；当前历法内核固定为 calendar-1.0.0。