商时
商时提供两个独立入口：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。
- 运行
corepack enable 启用仓库声明的 pnpm 版本。
- 运行
pnpm install --frozen-lockfile 安装锁定依赖。
- 运行
pnpm run dev 从仓库根目录启动本地网页。
- 打开
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。
